lsupdate

請使用 lsupdate 指令來顯示系統的機器碼(程式碼)升級狀態。

語法

讀取語法圖表略過語法圖表
>>-lsupdate--+---------+--+--------------------+---------------><
             '- -nohdr-'  '- -delim--delimiter-'   

參數

-nohdr
(選用)依預設,會在簡要樣式視圖中顯示每個資料直欄的標題,以及在詳細樣式視圖中顯示每個資料項目的標題。-nohdr 參數會暫停顯示這些標題。
註: 如果沒有要顯示的資料,就不會顯示標題。
-delim delimiter
(選用)依預設,簡要視圖中的所有資料直欄都以空格區隔。每個直欄的寬度都會設為各資料項目的最大寬度。在詳細視圖中,每個資料項目本身都有一列,如果顯示標頭,會用空格來區隔資料與標頭。-delim 參數會置換此行為。-delim 參數的有效輸入為一個單位元組字元。如果您在指令行輸入 -delim :,則會用冒號字元 (:) 來區隔簡要視圖中的所有資料項目;例如,直欄不會出現間距。在詳細視圖中,會用指定的定界字元來區隔資料與其標頭。

說明

applysoftware 指令用於更新系統程式碼。以下是 lsupdate 指令報告的升級狀態:
狀態
指示系統的整體更新相關狀態。值如下:
  • success,指示所有的更新活動已完成。
  • system_preparing,指示系統正在準備手動更新。
  • system_prepared,指示系統已準備好開始手動更新。
  • system_prepare_failed,指示系統無法開始手動更新。
    註: 檢查事件日誌。
  • system_initializing,指示系統正在準備節點以進行更新。
  • system_updating,指示正在更新節點。
  • system_updating_pausing,指示系統在繼續更新節點之前先暫停。
    註: 如果指定 applysoftware -continue,狀態將變更為 system_updating
  • system_committing,指示所有節點都已更新且系統正在準備新程式碼。
  • system_stalled,指出因為非預期的節點問題,更新已停滯。
  • system_stalled_non_redundant,指出由於相依磁區,更新已停滯。
  • system_restoring,指示使用者已取消停滯的更新。
    註: 正在還原先前的程式碼版本。
  • system_restoring_pausing,指示系統在繼續還原節點之前先暫停。
    註: 如果指定 applysoftware -continue,狀態將變更為 system_updating_restoring
  • system_restoring_stalled_non_redundant,指示更新已取消,然後又因為相依磁區而停滯了。
  • system_manual_update,指示正在進行手動更新。
  • system_completion_required,指示所有節點都已更新,且可使用管理功能,但是需要進一步的系統變更才能完成更新。
    註: 檢查事件日誌。
  • system_completing,指示正在進行自動更新完成。
  • system_completing_pausing,指示自動更新完成已暫停。
  • system_completing_paced,指示正在進行定速更新完成。
  • system_completing_stalled指示因為非預期的問題,自動更新完成已停滯。
  • enclosures,指示正在更新機箱韌體。
  • enclosures_stalled,指示因為非預期的問題或機箱缺少備援,機箱韌體更新已停滯。
  • enclosures_restoring,指出使用者已取消停滯的更新。正在將先前的程式碼版本還原至機箱機匣。
  • drives,指示正在更新磁帶機韌體。
event_sequence_number
指示一個事件來說明程式碼更新的任何現行問題。值必須是十進位格式的數值字串(或空白)。
progress
指示現行更新活動的完成百分比,採用已更新的物件數表示(而不是經歷時間)。值必須是 0 - 100 範圍內的數值字串(十進位)。
estimated_completion_time
指示現行更新活動的預估完成時間。只有在現行更新活動為自動且未停滯的情況下才有效。 值的格式必須是 YYMMDDHHMMSS(或空白)。
suggested_action
指示幫助更新進度的動作。值必須是:
  • complete,指示系統更新已完成,且必須發出更新完成。節點為線上。
  • continue,指示並行升級已暫停,您必須指定 applysoftware -continue 才能繼續並行升級。
  • fix,指示因為發生問題而無法繼續執行更新。檢查事件日誌,尤其是 event_sequence_number 輸出。節點為離線。
  • manual,指示正在進行手動更新。
  • pacednext,指示正在進行定速更新,必須排定下一個節點進行更新。節點為線上。
  • resume_cancel,指示更新已停滯,但可以回復或取消。節點為線上。
  • resume,指示更新完成已停滯,但可以回復。節點為線上。
  • start,指示系統已準備好啟動新的更新。沒有進行中或準備好的更新,且所有節點均為線上。
  • wait,指示系統正忙(不需要任何動作),因為正在進行更新。
system_new_code_level
指示正在更新程式碼的新層次。值必須是建置版本(如果未更新或還原系統,則為空白)。
system_forced
指示強制模式中的任何現行節點相關活動(忽略相依磁區)。值為 yesno
system_next_node_status
指示現行節點相關更新活動中的下一個節點的狀態。值如下:
  • none,指示沒有要更新的節點。
  • paused,指示現行節點在並行升級期間已暫停,您必須指定 applysoftware -continue 才能繼續並行升級。
  • waiting,指示節點準備更新且系統正在等待(一般是為了進行多重路徑失效接手)。
  • ready,指示節點準備進行更新,且更新活動為定速。您必須手動啟動更新。
  • updating,指示節點正在更新。
  • stalled,指示接下來即將更新節點,但是更新已停滯。
system_next_node_time
指示將啟動下一個節點更新的時間。只有當 system_next_node_statuswaiting 時,它才有效。該值的格式必須為 YYMMDDHHMMSS x(或空白)。
system_next_node_id
指示現行節點相關更新中的下一個節點的 ID。值必須是數值字串(或空白)。
system_next_node_name
指示現行節點相關更新中的下一個節點名稱。值必須是英數字串(或空白)。

更新的呼叫範例

lsupdate

結果輸出:

status system_updating
event_sequence_number
progress 50
estimated_completion_time 140522093020
suggested_action wait
system_new_code_level 7.4.0.1 (build 99.2.141022001)
system_forced no
system_next_node_status updating
system_next_node_time
system_next_node_id 2
system_next_node_name node2

定速更新的呼叫範例

lsupdate

結果輸出:

status system_completing_paced
event_sequence_number
progress 75
estimated_completion_time
suggested_action pacednext
system_new_code_level
system_forced no
system_next_node_status ready
system_next_node_time
system_next_node_id 4
system_next_node_name node4