1.2 移行作業内容（API利用版）¶
- 動作確認バージョン
NetScaler VPX Version13.1 Standard Edition, NetScaler VPX Version14.1 Standard Edition
Contents
1.2.2 前提条件¶
旧バージョンである12.0-53.13においてはプラン変更による移行を実施できません。異なるバージョン間の切替 を参照し、新環境に最新バージョンのロードバランサーを構築して切り替えてください。
設備更改における共通のガイドラインおよび注意事項については`こちら <https://sdpf.ntt.com/quick-start-guide/infrarenewal/>`_ の特設サイトを確認してください。
注釈
旧バージョンである12.1-55.18 Standard Editionにおいてはプラン変更による移行が可能です。
1.2.4 移行作業内容¶
1.2.4.1 API利用のための準備
1.2.4.2 利用しているロードバランサー 一覧の取得
1.2.4.3 利用しているロードバランサーのプラン詳細情報を順番に取得
1.2.4.4 移行先プランの選定
1.2.4.5 移行対象ロードバランサーのプラン変更
1.2.4.6 移行完了の確認
1.2.4.1 API利用のための準備¶
以下URLのページを参考に 3. トークン（Token）の取得 までの手順を実施し、トークンを取得してください。
以下URLのページを参考に、お使いのリージョンでの エンドポイントURL を把握してください。
ロードバランサーのエンドポイントURLは、通常 network-[Region Name]-ecl.api.ntt.com です。
これらの変数を設定してください。
$ token=取得したトークン
$ endpoint=ロードバランサーのエンドポイントURL
1.2.4.2 利用しているロードバランサー 一覧の取得¶
以下のコマンドで、利用しているロードバランサーの一覧を取得します。
$ curl -X GET -H "Content-Type: application/json" -H "X-Auth-Token: ${token}" \
https://${endpoint}/v2.0/load_balancers
以下のようなレスポンスが返ってきます。お使いのすべての"load_balancer_plan_id"をメモしてください。今回の例では、"fc916849-9d43-48ce-9884-db2b62bdcbfb"のプランIDを対象とします。
{
"load_balancers": [
{
"admin_username": "user-admin",
"availability_zone": "zone1-groupa",
"default_gateway": null,
"description": "{description of your load balancer}",
"id": "{uuid of your load balancer}",
"load_balancer_plan_id": "fc916849-9d43-48ce-9884-db2b62bdcbfb",
"name": "{name of load balancer}",
"status": "ACTIVE",
"tenant_id": "{your tenant_id}",
"user_username": "user-read"
}
]
}
1.2.4.3 利用しているロードバランサーのプラン詳細情報を順番に取得¶
以下のコマンドで、利用しているロードバランサーのプラン詳細情報を順番に取得します。今回の例では、"fc916849-9d43-48ce-9884-db2b62bdcbfb"です。
$ load_balancer_plan_id=fc916849-9d43-48ce-9884-db2b62bdcbfb
$ curl -X GET -H "Content-Type: application/json" -H "X-Auth-Token: ${token}" \
https://${endpoint}/v2.0/load_balancer_plans/${load_balancer_plan_id}
以下のようなレスポンスが返ってきます。
**"name"に"MIGRATION_NEEDED"が含まれるプランを採用しているロードバランサーは、新プランへ移行が必要**です。該当プランを用いている**ロードバランサーのID**をすべてリストアップしてください。
{
"load_balancer_plan": {
"description": "Citrix_NetScaler_VPX_13.1-33.52_Standard_Edition_50Mbps_2CPU-8GB-4IF",
"enabled": true,
"id": "fc916849-9d43-48ce-9884-db2b62bdcbfb",
"maximum_syslog_servers": 8,
"model": {
"edition": "Platinum",
"size": "50"
},
"name": "MIGRATION_NEEDED_Citrix_NetScaler_VPX_13.1-33.52_Standard_Edition_50Mbps_2CPU-8GB-4IF",
"update_enabled": false,
"vendor": "citrix",
"version": "13.1-33.52"
}
}
1.2.4.4 移行先プランの選定¶
以下のコマンドで、ロードバランサーのプラン一覧を取得します。
$ curl -X GET -H "Content-Type: application/json" -H "X-Auth-Token: ${token}" \
https://${endpoint}/v2.0/load_balancer_plans?update_enabled=true
以下のようなレスポンスが返ってきます。
**"name"に"MIGRATION_NEEDED"を含まない**プランを選定し、idを控えてください。今回の例では、"id"が"a2e6de45-0e01-4741-b08f-891b9bd9a271"のプランを用います。
{
"load_balancer_plans": [
{
"description": "Citrix_NetScaler_VPX_13.1-52.19_Standard_Edition_50Mbps_2CPU-8GB-4IF",
"enabled": true,
"id": "a2e6de45-0e01-4741-b08f-891b9bd9a271",
"maximum_syslog_servers": 8,
"model": {
"edition": "Platinum",
"size": "50"
},
"name": "Citrix_NetScaler_VPX_13.1-52.19_Standard_Edition_50Mbps_2CPU-8GB-4IF",
"update_enabled": true,
"vendor": "citrix",
"version": "13.1-52.19"
},
]
}
1.2.4.5 移行対象ロードバランサーのプラン変更¶
移行先プランIDを変数に指定します。今回の例では、"a2e6de45-0e01-4741-b08f-891b9bd9a271"です。
$ load_balancer_plan_id=a2e6de45-0e01-4741-b08f-891b9bd9a271
プラン移行が必要なすべてのロードバランサーについて、以下の手順を実施します。プラン移行が必要なロードバランサーのIDを変数に指定します。
$ load_balancer_id={uuid of your load balancer}
次のコマンドを実行します。
$ curl -X PUT -H "Content-Type: application/json" -H "X-Auth-Token: ${token}" \
https://${endpoint}/v2.0/load_balancers/${load_balancer_id} \
-d "{
\"load_balancer\": {
\"load_balancer_plan_id\": \"${load_balancer_plan_id}\"
}
}"
レスポンス（長いため省略）の"status"が"PENDING_UPDATE"になっていることを確認してください。
ロードバランサーのプラン変更に伴い、ロードバランサーの再起動が発生します。
注釈
再起動は処理完了まで通常10分ほど掛かります。
1.2.4.6 移行完了の確認¶
プラン移行を実施したロードバランサーのIDを変数に指定します。
$ load_balancer_id={uuid of your load balancer}
次のコマンドを実行します。
$ curl -X GET -H "Content-Type: application/json" -H "X-Auth-Token: ${token}" \
https://${endpoint}/v2.0/load_balancers/${load_balancer_id}
確認ポイント
レスポンス（長いため省略）の"status"が"ACTIVE"になっていることを確認してください。
レスポンスの"load_balancer_plan_id"が指定したプランIDになっていることを確認してください。
実施が必要な手順は以上となります。
1.2.5 切り戻し方法¶
切り戻しの機能は提供していません。
1.2.6 手順通り進まない場合の対処方法¶
下記既知の問題に記載のとおり、プラン変更時にオペレーションステータスが稀に「エラー」となる事象が確認されています。本設備更改におけるプラン変更実施時に事象が発生した場合は、復旧可能なケースがあるため、お手数ですがチケットにて問い合わせてください。