14.2.18 UpdateSLBConfiguration (サーバロードバランサーの設定変更)

名前

【Windowsマネージャー】
インストールフォルダー\RCXCFMG\bin\UpdateSLBConfiguration - サーバロードバランサーの設定変更

【Linuxマネージャー】
/opt/FJSVcfmg/bin/UpdateSLBConfiguration.sh - サーバロードバランサーの設定変更

形式

【Windowsマネージャー】

UpdateSLBConfiguration -version バージョンID -locale 言語コード -userId ユーザーID -password パスワード -orgId テナント名 -lplatformId L-Platform ID -xml XMLファイルのパス

【Linuxマネージャー】

UpdateSLBConfiguration.sh -version バージョンID -locale 言語コード -userId ユーザーID -password パスワード -orgId テナント名 -lplatformId L-Platform ID -xml XMLファイルのパス

機能説明

サーバロードバランサーの設定を変更します。

本コマンドは、非同期で実行されます。本コマンドの実行に成功すると、処理の実行中はL-Platformの状態が構成変更中(RECONFIG_ING)に遷移し、処理が完了するとL-Platformの状態が正常稼働中(NORMAL)に戻ります。
L-Platformの状態が構成変更中の場合は、L-Platformに対する操作ができません。
L-Platformの状態をGetLPlatformStatusで監視し、正常稼働中に遷移するのを待ってから次の操作を行ってください。

本コマンドでは、ルールセットを使用しないSLBに対する設定は変更できません。

オプション

-version: L-Platform APIのバージョンIDを指定します。

-locale: L-Platform APIと通信するための言語を指定します。

-userId: L-Platform APIを実行するユーザーIDを指定します。

-password: L-Platform APIを実行するユーザーIDのパスワードを指定します。

-orgId: L-Platform APIを実行するユーザーのテナント名を指定します。

-lplatformId: L-Platform IDを指定します。

-xml

サーバロードバランサーの設定変更について定義したXMLファイルのパスを指定します。

<<XML>>

<slb>
 <name>[サーバロードバランサー名]</name>
  <ruleset>
   <parameters>
    <parameter>
     <name>[パラメーター名]</name>
     <value>[パラメーターの値]</value>
    </parameter>
    …
   </parameters>
  </ruleset>
</slb>

タグ名	型	設定範囲	必須	説明
slb	-	-	×	サーバロードバランサーを指定します。
name	String ASCII	1Byte以上	○	設定変更するサーバロードバランサーの名前を指定します。
ruleset	-	-	×	サーバロードバランサーのルールセットを指定します。
parameters	-	-	×	ルールセットのパラメーターを指定します。
parameter	-	1個以上	×	パラメーターの数分指定します。
name	String ASCII	1Byte以上	○	変更するパラメーターの名前を指定します。 GetLPlatformConfigurationで取得した対象のサーバロードバランサー配下にある、パラメーターの名前を指定します。
value	String ASCII	0Byte以上	△	変更後のパラメーターの値を指定します。

必須欄の記号は、以下を意味しています。
○：タグを指定した場合は、必ず値を指定してください。
△：値は省略可能です。
×：値の設定は不要です。タグだけの指定です。

必要な権限・実行環境

権限: OSの管理者権限をもつユーザー

実行環境: 管理サーバ

使用例

【Windowsマネージャー】

> UpdateSLBConfiguration -version 2.0 -locale ja -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -xml C:\sample.xml
<?xml version="1.0" encoding="UTF-8"?>
<UpdateSLBConfigurationResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
</UpdateSLBConfigurationResponse>

【Linuxマネージャー】

# UpdateSLBConfiguration.sh -version 2.0 -locale ja -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -xml /XML/sample.xml
<?xml version="1.0" encoding="UTF-8"?>
<UpdateSLBConfigurationResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
</UpdateSLBConfigurationResponse>

終了ステータス

以下の終了ステータスが返されます。

0: 正常に処理されました。

0以外: エラーが発生しました。