CLI コマンド

オンライン編集

IBM® Power ® Virtualization Center は、特に問題のトラブルシューティングに役立つ、ユーザー・インターフェースの機能を丸めるコマンド・ライン・インターフェースを提供します。

PowerVC コマンドにアクセスするには、 PowerVC がインストールされているオペレーティング・システムに対してコマンド・ラインを開きます。

コマンドとその説明を以下に示します。 コマンドの使用方法については、コマンド行を開いて、コマンド名と --help を入力します。 例えば、 powervc-audit-export --helpなどです。 一部のコマンドは、 /opt/ibm/powervc/log directoryにあるログ・ファイルに出力します。

表 1. PowerVC コマンドおよび説明
コマンド 説明
powervc-audit-export 以前に収集された監査データをエクスポートできます。
powervc-opsmgr backup 重要な PowerVC データをバックアップして、データ破損や災害が発生した場合に作業状態に復元できるようにします。

詳しくは、 バックアップを参照してください。
powervc-cloud-config 管理者が、プロジェクト、ポリシー、および仮想マシンを操作できるようにします。 例えば、このコマンドを使用して、ポリシーの作成および変更や、仮想マシンの所有者の変更を行うことができます。
powervc-config PowerVC 管理サーバーを構成します。 このコマンドの使用は、 PowerVC 構成ファイルを変更するためにサポートされている唯一の方法です。 使用可能な powervc-config サブコマンドのリストについては、 表 2を参照してください。
powervc-diag PowerVC インストール済み環境から診断データを収集します。
powervc-encrypt ユーザーにストリングの入力を求め、そのストリングを暗号化して返します。 このコマンドは、 PowerVCによって保管されるパスワード、トークン、およびストリングを暗号化するために使用します。
powervc-opsmgr install -c <clustername> -s サブコマンドを実行して、 PowerVC Operations Manager ユーティリティーをインストールします。
openstack OpenStack サービスとのコミュニケーションを支援します。 このコマンドは OpenStack コミュニティーによって開発されたものです。 PowerVC は、このコマンドの全機能のサブセットをサポートします。 詳しくは、 表 3を参照してください。
注:
  • このコマンドのヘルプは翻訳されていません。
  • 以下のコマンドは非推奨になりました。 これらの機能を実行するには、ユーザー・インターフェースにアクセスしてください。
powervc-log PowerVCのデバッグ・ログ・レベルを有効または無効にします。 現行設定を表示するには、このコマンドをオプションなしで実行します。

このコマンドを使用すれば、サービスを再始動することなくデバッグ・レベルを有効にできます。 このコマンドは、進行中の操作が中断されるリスクなしに、ログ内の詳細な診断情報を取り込むために役立ちます。
powervc-ログ管理 PowerVCのログ管理の設定を表示および変更できます。 デフォルト・アクションは現行設定の表示です。
powervc-register OpenStack でサポートされるストレージ・プロバイダー またはファブリックを登録します。
powervc-opsmgr restore 以前にバックアップされた PowerVC データをリカバリーします。 このコマンドは、サービスを使用不可にするために powervc-services コマンドが使用されるとブロックされます。
powervc-opsmgr 再同期 マルチノード環境では、このコマンドを使用して、計算プレーン間またはコントローラー・ノード間で conf ファイルを同期化します。
フォーマットの例: powervc-opsmgr resync_node -s <source_host> -d <dest_host>
例: powervc-opsmgr resync_node -s 9.x.x.x -d 9.x.x.x
PowerVC-リソース・マネージャー インスタンス・スナップショット、グループ、グループ・スナップショット、およびボリュームに関連付けられたリソースなどの PowerVC リソースを管理できます。 このコマンドは、以下の目的で使用します。
障害が発生したか、断続的な状態のままになっているリソースをクリーンアップします。
リソースに関連付けられているすべての対応するエンティティー/リソースを表示します。
指定されたリソースの状況をリセットします。
powervc-services PowerVC サービスを停止、開始、再始動、有効化、または無効化できます。 PowerVC サービスを開始および再始動する CLI コマンドを実行するには、サービスを有効にする必要があります。
注: デフォルトでは、このコマンドの効果は、管理サーバー、ネットワーク・ノード、およびすべてのリモート・ホストに適用されます。 --local オプションを使用すると、効果は管理サーバーにのみ及びます。

powervc-services status を使用して、結果を表形式で表示します。 古い形式で結果を表示するには、 powervc-services status --rawを実行します。

powervc-services restart --advanced を使用して、コンポーネント、ノード、または特定のホスト (inventory_hostname) を再始動します。 例えば、 powervc-services restart --advanced node コマンドは、最初にノード上のすべてのサービスを再始動します。 次に、他のノードでサービスが再始動されます。

注: PowerVC 2.1.1.1を開始すると、 powervc-services コマンドは追加の状況を表示します。
  • NoHeartbeat -この状況は、サービスが RabbitMQ サービスと通信できないことを示します。 サービスが 15 分を超えてこの状態で持続する場合は、 RabbitMQ 通信の問題がないか確認してください。
  • NoResponse -この状況は、API が 15 秒以内に応答しない場合に API サービスに対して表示されます。
  • NotAvailable -この状況は、API がエラー・コードを返したときに API サービスに対して表示されます。
powervc-opsmgr uninstall PowerVC OpsMgr を管理サーバーまたはホストからアンインストールします。
powervc-validate ご使用の環境が特定のハードウェア要件およびソフトウェア要件を満たしていることを妥当性検査します。
powervc-volume-image-import ストレージ・プロバイダーによってすでにホストされている 1 つ以上のボリュームを使用して、デプロイ可能イメージを作成します。
powervc-image このコマンドには以下のサブコマンドがあります。
powervc-image config - コマンド構成プロパティーを表示または変更します。
powervc-image import - uncompressesed デプロイ可能イメージを OVA から PowerVCにインポートします。
powervc-image export -デプロイ可能イメージを PowerVC からローカル OVA にエクスポートします。
powervc-image list - PowerVCによって管理されているデプロイ可能イメージをリストします。
powervc-tape-reg

このコマンドは、 PowerVCにファイバー・チャネル・テープ・ドライバーを登録するために使用します。 このドライバーにより、デプロイ時に NPIV を使用する仮想マシンに対してテープ・ライブラリーをゾーニングできます。 新規 cinder-volume サービスを構成するには、名前とターゲット WWPN を指定します。
powervc-edit-scg このコマンドは、管理対象仮想マシン (VM) に割り当てられているストレージ接続グループを更新するために使用します。 VM を管理解除する前にイニシエーター・ポート・グループ (IPG) が VM に関連付けられている場合は、管理対象仮想マシンのストレージ接続グループを設定するときに、 --include-ipg フラグを使用して IPG にデータを再設定します。
powervc-ipg-info このコマンドは、仮想マシンに接続されているブート・ボリュームおよびデータ・ボリュームに関する追加の IPG 情報を取得するために使用します。
powervc-scale-config 管理ノードおよび NovaLink ノードにスケール・チューニング・パラメーターを適用します。 このような設定は大規模な環境を対象としています。
注:
  • 単一ノード環境およびマルチノード環境の NovaLink および HMC でサポートされます。
  • マルチノード環境でスケール設定を適用するには、 /etc/oslo/scale_multi_node.conf 構成ファイルを更新してから、 powervc-scale-config --apply コマンドを実行します。
  • 単一ノード環境でスケール設定を適用するには、 /etc/oslo/scale_single_node.conf 構成ファイルを更新してから、 powervc-scale-config --apply コマンドを実行します。
一部の powervc-config サブコマンドは、構成ファイルの変更に関与し、自動サービス再始動を実行する場合があります。 以下のいずれかのコマンドについて詳しくは、 powervc-config subcommand child_subcommand -hを実行してください。
注:
  • いずれかの PowerVC 操作の進行中に powervc-config サブコマンドを実行すると、サービス可用性が一時的に中断する可能性があります。
  • PowerVC 2.1.1以降、 powervc-scale-config --list サブコマンドは、 Oslo_Conf Value 列および System_Conf Value 列とともに値を表形式で表示します。 Oslo_Conf Value はスケール構成値であり、 System_Conf Value はシステム内で構成されている属性値です。
表 2. サポートされる powervc-config サブコマンド
サブコマンド 子サブコマンド 説明
イベント add-type 指定したタイプのイベントを保管します。 複数のタイプはスペースで区切ります。 例: event_type1 event_type2
監査 イベント・サービスの監査設定を構成します。 サービスごとに監査を有効または無効にでき、無視する操作を指定することもできます。
list-types 保管するイベント・タイプをリストします。
remove-type 指定したイベント・タイプを、保管するイベントのリストから削除します。 複数のタイプはスペースで区切ります。 例: event_type1 event_type2
消去 このコマンドは、Panko データベースに保管されているすべてのイベントおよび特性を削除するために使用します。
概要 監査 一般サービスの監査設定を構成します。
識別 token-expiration ID トークンの有効期限間隔を構成します。
token-rotation fernet トークン・キー・ローテーション間隔を構成します。
リポジトリー 認証資格情報のリポジトリー (LDAP サーバーなど) を構成します
イメージ 監査 イメージ・サービスの監査設定を構成します。
image-size-cap PowerVC 管理ノードを介してアップロードできる最大イメージ・サイズを構成します。
user-storage-quota ユーザーに許可されているイメージ・ストレージの最大量を構成します。
ストレージ 監査 ストレージ・サービスの監査設定を構成します。
clone-name-prefix これは、ボリューム複製の優先複製名プレフィックスを設定します。
使用方法：
powervc-config storage clone-name-prefix [-h] [--prefix Prefix]
[--restart]
ds8000 特定のIBM System Storage DS8000®Cinder およびストレージテンプレートの構成オプションを設定します。

--cg-lss - 整合性グループと整合性スナップショットで使用する論理サブシステム ID の範囲。 例えば、LSS ID の範囲は 00 から 0F です。 整合性グループに追加されたボリュームは、この範囲内の LSS の 1 つにマイグレーションされます。 ストレージ・テンプレートでのボリューム作成用の LSS 範囲の設定は推奨されません。
--storage-template <ID> --lss - ボリューム作成時にストレージ・テンプレートで使用する論理サブシステム ID のリスト。 例えば、00、01 などがあります。
--storage-template <ID> --pools - ボリューム作成時にストレージ・テンプレートで使用するプール ID のリスト。 例えば、P1、P2 などがあります。
delete-check PowerVCの外部で削除された可能性があるボリュームを検出する機能を構成します。
fc-zone zone_by_stg_provider 有効にすると、initiator モードおよび initiator-vfc モードのストレージ・プロバイダーごとにゾーンを作成します。

詳しくは、 PowerVCを参照してください。
fc-zone zone-masking --blacklist 仮想マシンのソース NPIV WWN でゾーニングしないターゲット (ストレージ・プロバイダー) WWPN のリストを作成します。 ブラックリストにデータを取り込むには、コマンドの後に WWPN を追加します。 例: powervc-config storage fc-zone zone-masking --blacklist twwpn1 twwpn3 twwpn4
fc-zone zone-masking --whitelist ゾーニングするターゲット (ストレージ・プロバイダー) WWPN のリストを作成します。 ホワイトリストにデータを取り込むには、コマンドの後に WWPN を追加します。 例: powervc-config storage fc-zone zone-masking --whitelist twwpn1 twwpn3 twwpn4
fc-zone zone-name-prefix ゾーン名の作成時に使用されるプレフィックスを設定します。
fc-zone zone-name-template

このコマンドは、 PowerVCの zone-name-template 設定を表示または構成するために使用します。 zone-name-template は、新規ゾーンの命名方法を指定するストリングです。 これは、NPIVボリューム添付用に作成されるゾーン名に挿入される情報の断片を表す 静的テキストと動的置換変数を含む。 置換変数の例としては、仮想マシン名、イニシエータWWPN、ストレージホスト名などがあります。

例: powervc-config storage fc-zone zone-name-template -t "powervc_%(vm_name)20s_%(initiator_wwpn)s_%(storage_hostname)10s" --restart

有効な値を判別するには、powervc-config storage fc-zone zone-name-template -h を実行します。

注： zone-name -template に storage_display_name パラメーターがある場合は、切り捨てられない。 また、ゾーン名全体の長さが64文字を超える場合、ゾーンの作成は失敗する。
fc-zone zone-one-target これを有効にすると、ゾーン作成用に、イニシエーターごとに 1 つのターゲットのみが使用されます。 zone-one-target を無効にすると、ゾーンの作成時にすべてのターゲットが使用されます。 デフォルト値は trueです。
注: このプロパティーは、 IBM Storwize ® コントローラーでは使用されません。 Storwize コントローラーの場合、追加仕様プロパティー drivers:multipath によって、すべてのターゲットをゾーニングするかどうか、または入出力グループ内の各ノードから 1 つのターゲットをゾーニングするかどうかが決まります。
hiHitachi group-name-format バックエンドで Hitachi HostGroup 名を作成するときに使用される命名形式を設定します。 デフォルト値: HBSD-{wwn}。
注: このコマンドは、NPIV を使用して接続されているボリュームにのみ適用できます。
hitachi array-ports 指定された Hitachi プロバイダーを、リストされた Hitachi アレイ・ポートを使用して構成します。
hitachi thin-pool カスケード・シン・イメージ・クローンおよびスナップショットに使われる日立コントローラー・プールを設定します。 コマンドは推奨されません。 この機能を実行するには、ユーザー・インターフェースにアクセスしてください。
hitachi-thinpool カスケード・シン・イメージの複製およびスナップショットと一緒に使用されるように Hitachi コントローラー・プールを設定します。 このコマンドは推奨されません。 代わりに hitachi thin-pool を使用してください。
host-name-format

PowerMax ストレージ・プロバイダーのショート・ホスト名カスタマイズ用のテンプレートを設定します。
onboard-voltype PowerVCに追加されたストレージ・プロバイダーのボリューム・タイプを構成します。 このコマンドは推奨されません。 代わりにpowervc-config storage set-templateを使用してください。
portgroup 自動構成オプションを含め、EMC VMAX 候補ポート・グループ・リストを構成します。 このコマンドは推奨されません。
portgroup-format PowerMax ストレージ・プロバイダーのポート・グループ・カスタマイズ用のテンプレートを設定します。
レプリケーション VMAX ストレージ・プロバイダーが SRDF 複製グループを使用できるようになります。 このコマンドは推奨されません。
set-template これは、ボリュームのストレージ・テンプレートを設定します。 既存のボリュームが管理されている場合、そのボリュームに関連付けられているストレージ・テンプレートはありません。 このため、ストレージ・テンプレートを必要とする何らかの機能 (整合性グループ) に関する問題が発生します。
Storwize IBM Storwize デバイスの PowerVC Cinder 構成を設定します。 特定の Storwize プロバイダーの場合は、以下の引数を使用します。
  • use-one-iogrp -仮想マシンのボリュームを単一の入出力グループに統合します。
  • flashcopy-rate -フラッシュ・コピー速度を構成します。
  • clean-rate -クリーン・レートを構成します。
  • ratelimit -レート制限を構成します。
  • volume_pool -ボリューム・プールを構成します。
  • snapshot_child_pools -スナップショットの子プールを構成します。
スナップショットの使用法 スナップショット使用の間隔を表示または構成します。
timeouts ストレージ・タイムアウト/間隔設定を構成します。
vol-name-format

このコマンドは、 PowerVCのボリューム名テンプレートを表示または構成するために使用します。 このテンプレートは新規ボリュームの命名方法を指定します。 これには、ボリューム名に挿入される情報の一部を表す静的テキストと動的置換変数が含まれます。

有効な値を判別するには、vol-name-format -h を実行します。
zone-name-prefix PowerVC がゾーンを作成するときに使用する接頭部を指定します。 このコマンドは推奨されません。 代わりにfc-zone zone-name-prefixを使用してください。
backup-service swift 指定された認証プロパティーを、リモートおよびローカルのバックアップ・ノードに対してシングル・ユーザー・モードで使用して、cinder swift バックアップ・ドライバーを有効にします。 --backup-node を使用して、構成する必要があるバックアップ・ノードを指定します。 --help オプションで構成可能な属性の詳細を表示します。 Keystone v3 認証システムのみがサポートされます。
backup-service posix デフォルト POSIX を、リモートおよびローカルのバックアップ・ノード用のバックアップ・サービスとして有効にします。 --backup-node を使用して、構成する必要があるバックアップ・ノードを指定します。 構成可能なプロパティーの詳細を表示するには、 --help オプションを使用します。
svc-retain-aux-vol これは、グローバル・ミラー・ボリュームがタイプ変更または削除されるときに 2 次ストレージ上でボリュームが削除されるというデフォルト動作を変更します。
cisco_wait_retry これは、Cisco ファブリック再試行タイムアウトを設定します。 Cisco スイッチへの呼び出しは、この構成で指定された時間に対して指数関数的に増加する間隔で再試行されます。
purestorage スナップショット間隔 複製対応の Pure Storage デバイス用に PowerVC cinder 構成を設定します。 この引数は、Pure Storage プロバイダーのスナップショット複製間隔 (秒) を構成します。
purestorage snapshot-保存-短 複製対応の Pure Storage デバイス用に PowerVC cinder 構成を設定します。 この引数は、Pure Storage プロバイダーのターゲットでのスナップショット保存時間を秒単位で構成します。
purestorage snapshot-retention-perday 複製対応の Pure Storage デバイス用に PowerVC cinder 構成を設定します。 この引数は、Pure Storage プロバイダーで 1 日に保持されるスナップショットの数を構成します。
purestorage snapshot-retention-long 複製対応の Pure Storage デバイス用に PowerVC cinder 構成を設定します。 この引数は、Pure Storage プロバイダーのターゲットでスナップショットを 1 日当たりに保持できる日数を構成します。
ネットワーク 監査 ネットワーク・サービスの監査設定を構成します。
tunneling-ip トンネリング IP アドレスを表示または設定します。 このアドレスを使用すれば、nova-compute プロセスと直接通信できます。
計算 allow-dup-net 重複する VLAN ネットワークを作成する機能を構成してください。
arr-host-maint 自動リモート再始動後にホストを保守モードに移行するかどうかを構成します。
監査 計算サービスの監査設定を構成します。
auto-pvmvlan-clnup これが有効になっている場合、 PowerVC は、仮想マシンのマイグレーション後に VLAN を削除します。 -host パラメーターを使用してホスト名を指定すると、このアクションはそのホストに対してのみ行われます。 ホストを指定しない場合、このアクションはすべての登録済みホストに対して行われます。
fabric-sync このコマンドは、ファブリック同期間隔 (分) を変更する場合に使用します。 この間隔が経過すると、次に PowerVM® ホストが環境内のトポロジー情報をデータベース内のトポロジー情報と調整するときに、登録されているすべてのファブリックに接続し、どのホスト・ポートがどのファブリックにログインしているかを判別します。 これは、登録済みホストごとに行われます。

この同期アクティビティーは、新しいファブリックが管理または管理解除されるたびに自動的に行われます。 ただし、ファイバー・チャネルの物理ケーブル接続が変更され、 PowerVC がそれを認識しない場合、この同期間隔により、 PowerVC がその情報を更新して、ストレージ接続グループの要件を満たすホストに対して仮想マシンのデプロイメントが正確にスケジュールされるようにします。

デフォルトのファブリック同期間隔は、120 分に、0 から 30 のランダムな分数を加算した値です。 ランダムな追加の分数は、すべての計算ホストが同時にファイバー・チャネル・ファブリックに接続し、それらが照会によって過負荷になることを防ぎます。
インスタンス・タスク状態のリセット 仮想マシンが長時間断続的な状態になっている場合は、仮想マシンのタスク状態を強制的にリセットします。
フォーマットの例:
powervc-config compute reset-instance-task-state --instance_id <vm_uuid1, vm_uuid2, etc.>
live-capture 稼働中の仮想マシンを取り込む機能を設定します。
maint-migr-timeout ホストが保守モードに移行する場合の仮想マシン・マイグレーションのタイムアウト値を構成します。 仮想マシンのマイグレーションにかかる時間がこの値を超えると、ホストは保守エラー状態になります。
mover-service-par このコマンドは、ライブ区画マイグレーションのためのムーバー・サービス区画として使用するように VIOS IP アドレスのコンマ区切りリストを構成する場合に使用します。

VIOS 上に複数のネットワーク・アダプターがあり、マイグレーションをより高速なネットワークで実行したい場合は、この値を高速なネットワークの IP アドレスに設定してください。 複数 VIOS 環境では、すべての VIOS の MSP IP をリストすることが可能であり、そのうちの 2 つがライブ区画マイグレーション操作時に冗長 MSP に対してランダムに選択されます。
avoid-msp-validation このコマンドを使用して、mover-service-parコマンドでMSPIPの検証を回避します。
server-domain 仮想マシンのデフォルト・ドメイン・ネームを表示または設定します。
vfc-over-commit NPIV ポートのオーバーコミット割り振りを行うかどうかを構成します。
storage_hostname_template このコマンドは、NPIV 仮想マシンのデプロイ中にバックエンド・ストレージでホスト名をカスタマイズする場合に使用します。 このコマンドは、SVC ストレージ・タイプに適用できます。

storage_hostname_template には、プレフィックス、サフィックス、仮想マシンがデプロイされる host、および仮想マシン名に使用する vm_display_name を指定できます。 プレフィックスとサフィックスはオプションですが、host または vm_display_name の指定は必須です。

storage_hostname_template の設定例は次のとおりです。

powervc-config compute storage_hostname_template --host V7R2_20 --set "powervc_%(host)s_%(vm_display_name)s_<storagetype>" --restart
デフォルトでは、ホスト名と vm_display_name の切り捨ての長さはそれぞれ 20 文字です。
  • ホスト名がこれはPowerVCHostであり、長さが長いです、PowerVCホスト名を切り捨てるthisIsAPowerVCHostAn 。
  • もしvm_display_nameはこれはPowerVCVMの表示名であり、長さが長いです、PowerVC名前を切り捨てるthisIsAPowerVCVMDisp。

ただし、 PowerVC CLI でカスタム切り捨て長を指定することもできます。 詳しくは、powervc-config compute storage_hostname_template --help を実行してください。
use_vios_from_scg_for_sriov_vnic SR-IOV デプロイメント中に vNIC サーバーを作成するために、インスタンス SCG に基づく VIOS 選択を有効にする nova conf file のデフォルト・セクションに新規プロパティーを構成します。

例:

# powervc-config compute use_vios_from_scg_for_sriov_vnic --enable/--disable --host HOSTNAME --restart
計量 list-meters PowerVC でサポートされるメーターを表示します。 --enabledで、有効なメーターを取得します。
enable-meters 新規メーターを追加して、そのデータ (メトリック) を収集します。
disable-meters 特定のメトリック収集を、対応するメーターを使用不可にすることで停止します。
ウェブ inactivity-timeout ユーザーが指示に従ってログアウトするまで、ユーザー・インターフェースがアイドル状態でいられる時間の長さ。 タイマーを無効にするには、0 以下の値を指定してください。
reauth-warn-time トークンの期限が切れて、ユーザーにパスワードを要求するまでの時間の長さ。 パスワードを入力することによって、新規トークンが取得されます。 タイマーを無効にするには、0 以下の値を指定してください。
セルフサービスで 監査 セルフサービス・サービスの監査設定を構成します。
妥当性検査 監査 妥当性検査サービスの監査設定を構成します。
表 3. サポートされる openstack サブコマンド
コマンド 説明
openstack token issue 新規トークンを発行します。
openstack token revoke 既存のトークンを取り消します。
openstack port list ポートをリストします。
openstack port delete ポートを削除します。