wsadmin ツールを使用して、管理対象セット内のアプライアンスのファームウェアを更新します。製造者が提供するファームウェア・バージョン・ファイルは、各機能のデバイス・タイプ、モデル・タイプ、およびライブラリーに固有のものです。
始める前に
始める前に、アプライアンスと管理対象セットを追加および構成して、DataPower® アプライアンス・マネージャーをセットアップします。
このタスクについて
このトピックでは、管理対象セット内で DataPower アプライアンス・マネージャーが管理する複数アプライアンスのファームウェアの更新例を示します。対象のアプライアンスは、testSet 管理対象セットのメンバーです。複数のアプライアンスを管理する管理対象セットのファームウェアを更新する場合、システムはまず、ファームウェア・バージョンをマスター・アプライアンスにデプロイし、続いてその管理対象セットの各アプライアンスにデプロイします。
このトピックで説明するコマンドの追加情報と例を表示するには、AdminTask オブジェクトの dpManagerCommands コマンド・グループに関する文書を参照してください。
手順
- wsadmin スクリプト・ツールを開始します。
- 管理対象セットの ID を判別します。
以下の例に示すように、dpGetAllManagedSetIDs コマンドを使用して、DataPower アプライアンス・マネージャー構成の各管理対象セットの ID を表示します。
AdminTask.dpGetAllManagedSetIds()
以下の例に示すように、dpGetManagedSet コマンドをオプションとして使用し、指定された特定の管理対象セット ID の属性を表示します。
AdminTask.dpGetManagedSet('-managedSetId testSet')
- 各管理対象セットにデプロイするファームウェア・バージョンを判別します。
DataPower アプライアンス・マネージャーを使用して、ご使用の環境に新規のファームウェア・バージョンをデプロイするか、またはご使用の構成内に存在する以前のファームウェア・バージョンに戻すことができます。
- システムによって新規のファームウェア・バージョンが DataPower アプライアンス・マネージャーに追加されたことを確認します。
以下の例に示すように、getTask コマンドを使用してタスクが完了しているかどうかを判別します。
AdminTask.dpGetTask('-taskId '+addFirmwareTask)
このコマンドは、対象の非同期タスクに関する情報を戻します。isComplete 属性は、タスクが完了している場合に値 true を表示します。完了していない場合は、taskStatus 属性の値に注目してください。戻り値が 0 の場合は、タスクがキューに入っており、システムはまだそのタスクを開始していません。戻り値が 1 の場合は、タスクの処理が進行中です。戻り値が 2 の場合は、タスクが正常に実行され、完了しています。戻り値が 3 の場合は、タスクで例外が発生しています。
- ファームウェア・バージョンをデプロイします。
システムによりファームウェア・バージョンが DataPower アプライアンス・マネージャーに追加されたら、dpSetManagedSet コマンドを使用して、そのファームウェア・バージョンを管理対象セットに追加します。次の例では、新規にダウンロードしたファームウェア・バージョンをテスト環境の管理対象セットに割り当てます。
FVTask=AdminTask.dpSetManagedSet('-managedSetId testSet -desiredFirmwareVersionId '+testFirmwareVersionID)
このコマンドは、タスクを DataPower アプライアンス・マネージャーにサブミットし、タスク ID を対応する変数に割り当てます。ファームウェアのデプロイには数分の時間を要する場合があり、新規ファームウェア・バージョンを実行するためにアプライアンスが再始動されます。
- システムによって新規ファームウェア・バージョンが管理対象セットに正常に割り当てられたことを確認します。
以下の例に示すように、getTask コマンドを使用してタスクが完了しているかどうかを判別します。
AdminTask.dpGetTask('-taskId '+FVTask)
このコマンドは、対象の非同期タスクに関する情報を戻します。isComplete 属性は、タスクが完了している場合に値 true を表示します。完了していない場合は、taskStatus 属性の値に注目してください。戻り値が 0 の場合は、タスクがキューに入っており、システムはまだそのタスクを開始していません。戻り値が 1 の場合は、タスクの処理が進行中です。戻り値が 2 の場合は、タスクが正常に実行され、完了しています。戻り値が 3 の場合は、タスクで例外が発生しています。
- オプション: システムが置き換えたファームウェア・バージョンを DataPower アプライアンス・マネージャーから除去します。
以前のファームウェア・バージョンのコピーを DataPower アプライアンス・マネージャーに保持しない場合は、そのファームウェア・バージョンを構成から除去します。前のバージョンに戻す必要がある場合のために、前のファームウェア・バージョンを 2 つ残すことができます。
dpRemoveFirmwareVersion コマンドを使用して、管理対象セットでもう使用しなくなったファームウェア・バージョンを除去します。管理対象セットに割り当てられているファームウェア・バージョンを除去することはできません。次の例では、DataPower アプライアンス・マネージャーからファームウェア・バージョンを除去します。
AdminTask.dpRemoveFirmwareVersion('-firmwareVersionId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.13"')
タスクの結果
管理対象セットは新規のファームウェア・バージョンを使用します。
次のタスク
wsadmin ツールを使用して、アプライアンス、ファームウェア、ドメイン、管理対象セット、およびアプライアンス固有の設定を管理することができます。さらにシステムは、複数のバージョンのドメイン、ファームウェア、およびアプライアンス固有の設定を作成します。wsadmin ツールを使用して、現行バージョンを変更するか、または前のバージョンのドメイン、ファームウェア、およびアプライアンス固有の設定に戻すことができます。