applysoftware

請使用 applysoftware 指令將系統更新至新的程式碼層次。

語法


>>-applysoftware--+---------+----------------------------------->
                  '- -force-'   

>--+- -file--filename_arg--+---------+--+-------+--+------------+--+-----------+-+-><
   |                       '- -pause-'  '- -all-'  '- -continue-'  '- -prepare-' |   
   +- -abort---------------------------------------------------------------------+   
   +- -complete--+------------------+--------------------------------------------+   
   |             +- -paced----------+                                            |   
   |             '- -delay--minutes-'                                            |   
   +- -resume--+------------------+----------------------------------------------+   
   |           +- -paced----------+                                              |   
   |           '- -delay--minutes-'                                              |   
   '- -pacednext-----------------------------------------------------------------'

參數

-force

（選用）指定即使系統中缺少備援，更新或中斷程序也必須繼續進行。停用備援檢查可能會導致資料遺失，或無法存取資料。如果有一或多個節點離線，使用 force 參數時，請搭配 abort 參數。

重要：使用 force 參數，可能導致無法存取。僅在 IBM® 支援中心的指導下使用。

-file filename_arg

（必要）指定安裝更新套件的檔名。執行 applysoftware 指令之前，請先將更新套件複製到配置節點。

註： file 參數不能與 abort 參數搭配使用。

-pause

（選用）指定節點的並行升級在中途暫停。這個參數必須與 -file 一起指定。

-all

（選用）指定讓節點離線來進行升級之前，將節點的並行升級暫停。這個參數必須與 -file 一起指定。

-continue

（選用）指定繼續並行升級。

-prepare

（選用）準備系統，以進行手動程式碼層次更新。

註：您可以：

將 prepare 參數與 file 參數搭配使用
prepare 參數不能與 abort 參數搭配使用
不能將 force 參數與 prepare 參數搭配使用，來進入「已備妥」狀態

-abort

（停止更新時必要）指定要停止已停滯或已備妥的更新，讓系統回到原始的程式碼層次。

註： abort 參數可與 force 參數搭配使用，但不能與 file 或 prepare 參數搭配使用。

當 lsupdate 指令報告下列狀態時，也可以使用 abort 參數：

prepare_failed
prepared（如果所有節點都在線上）

-complete

（完成更新時必要）指定更新完成程序已啟動。指定 -paced，以定速執行更新完成程序。（此程序為自動或定速。）

-resume

（回復更新時必要）重試已停滯的步驟，以回復停滯的自動更新、更新取消或更新完成程序。指定 -paced，以定速執行更新程序。

-paced

（選用）指定更新完成為定速。系統不會自動讓任何節點離線 - 您必須指定 -pacednext，指出要更新定速更新的下一個節點。指定 -resume，則會回復更新程序。

-pacednext

（如果指定 -paced 且想要更新下一個節點，則為必要）指定要更新定速更新之內的下一個節點。

-delay minutes

（選用）指定客戶可以在 CCU 的中途改寫預設的 30 分鐘延遲。

說明

這個指令會啟動將系統更新到新程式碼層次的程序。applysoftware 指令會將程式碼層次套用至節點作為服務動作（定速更新）來更新特定的節點，或是作為自動更新程序來更新系統上的所有節點。

applysoftware 指令無法在服務狀態下使用，也就是說，系統必須正在執行，才能使用指令並執行成功。這個指令是同步的，因此會報告成功或失敗。

檔名所指定的程式碼套件，必須先複製到 /home/admin/update 目錄中的現行配置節點；請使用 PuTTy 安全複製 (scp) 應用程式來複製檔案。

如果 applysoftware 指令成功，lsupdate 指令會報告狀態是「已備妥」。如果 applysoftware 指令失敗，lsupdate 指令會報告狀態是「非作用中」。

若有指定，prepare 參數必須成功，才能順利更新。在準備期間，建議使用與實際更新相同的套件。可以使用 abort 參數來取消 prepare 參數（即使在系統處於「已備妥」狀態之後也可以），但前提是 lsupdate 指令報告狀態為「已備妥」。

重要： prepare 參數可能逾時。如果發生逾時，prepare 參數會造成非同步狀況，lsupdate 指令會將準備狀態報告為 preparing。如果發生此情況，請等待 lsupdate 將更新報告為 prepared 之後，再繼續執行手動更新程序。

只要更新程序成功，指令即告完成。在下列情況下，指令會失敗並刪除更新套件：

由於毀損，指定的套件的完整性檢查失敗。
系統中有任一節點的硬體類型是新程式碼所不支援的。
新的程式碼層次不支援從目前安裝的程式碼來更新。
遠端系統的程式碼層次與新的程式碼不相容。
有相依於節點狀態的磁區。
註：如果您已準備好在更新期間無法存取資料，您可以利用 force 參數來置換這些實務。繼續之前，請使用 lsdependentvdisks 指令加上 node 參數，列出執行指令時的節點相依磁區。如果指令傳回錯誤，請將仲裁磁碟移至所有節點都能存取的 MDisk。請重新執行指令，直到沒有傳回任何錯誤。

No feedback

呼叫範例

applysoftware -resume -delay 20

結果輸出：

No feedback