clientコマンド

clientキーワードを指定してコマンドを使用し、Oracle Fleet Patching and Provisioningクライアントを追加、削除および管理します。

rhpctl add client
フリート・パッチ適用およびプロビジョニング・クライアントをフリート・パッチ適用およびプロビジョニング・サーバーの構成に追加します。
rhpctl delete client
特定のフリート・パッチ適用およびプロビジョニング・クライアントを構成から削除します。
rhpctl discover client
入力された内容を検証して、特定のノード上のパラメータを検出し、Oracle Clusterwareの構成に使用できるレスポンス・ファイルを生成します。
rhpctl export client
フリート・パッチ適用およびプロビジョニング・サーバー上のリポジトリからクライアント・データ・ファイルにデータをエクスポートします。
rhpctl modify client
フリート・パッチ適用およびプロビジョニング・クライアントを変更します。
rhpctl query client
特定のフリート・パッチ適用およびプロビジョニング・クライアント・クラスタの構成情報を表示します。
rhpctl update client
フリート・パッチ適用およびプロビジョニング・クライアントのイメージを更新します。
rhpctl verify client
入力された内容を検証し、Oracle Clusterwareの構成に使用できるレスポンス・ファイルを作成するか完成させ、その値を検証します。

rhpctl add client

フリート・パッチ適用およびプロビジョニング・クライアントを、フリート・パッチ適用およびプロビジョニング・サーバー構成に追加します。

構文

rhpctl add client -client cluster_name [-toclientdata path] [-targetnode node_name
  {-sudouser sudo_user_name -sudopath sudo_binary_location | -root |
  -cred cred_name} | -auth plugin_name [-arg1 name1:value1...]]
  [-maproles role=user_name[,role=user_name[,...]]]
  [-version version]

パラメータ

表A-2 rhpctl add clientコマンドのパラメータ

パラメータ	説明
`-client client_name`	クライアントを作成するクラスタの名前を指定します。
`-toclientdata path`	必要に応じて、フリート・パッチ適用およびプロビジョニング・サーバーによって作成されるXMLファイルのパスを指定できます(クライアント・クラスタ固有)。このファイルには、クライアントがサーバーとの接続を構成するために必要な情報が含まれます。
`-targetnode node_name`	必要に応じて、フリート・パッチ適用およびプロビジョニング・クライアントを持たないリモート・クラスタ内のノードの名前を指定できます。
`-sudouser sudo_user_name -sudopath sudo_binary_location \| -root \| -cred cred_name`	`-targetnode`パラメータを使用するように選択した場合は、`sudo`または`root`を選択してリモート・ノードにアクセスする必要があります。 `sudo`を選択した場合、`–sudouser`パラメータを使用して、スーパーユーザー操作を実行するユーザー名と、`sudo`バイナリの場所のパスを指定する必要があります。必要に応じて、リモート・ノードにアクセスするためのユーザーおよびパスワード資格証明を関連付ける資格証明名を指定する選択ができます。
`-auth plugin_name [-arg1 name1:value1...]`	`–sudouser`、`–root`、または`–cred`のかわりに、`–auth`を使用してリモート・ノードにアクセスする認証プラグインを指定することもできます。
`-maproles role=user_name[,...]`	組込みロールまたはユーザーが定義したロールを指定できます。また、各ロールに複数のユーザーを割り当てることができます。複数のロールおよびユーザーは、カンマを使用して区切ります。
`-version version`	必要に応じて、資格証明ファイル形式のバージョン(`18.0.0.0.0`など)を指定できます。

使用上のノート

Oracle Grid Infrastructure 12cリリース2 (12.2)以降を実行しているクラスタのみ、フリート・パッチ適用およびプロビジョニング・クライアントとして構成し、追加できます。Oracle Grid Infrastructureの以前のバージョンを実行しているクラスタ、およびOracle Grid Infrastructureを実行していないサーバーは、フリート・パッチ適用およびプロビジョニング・サーバーで直接管理できます。
このコマンドは、フリート・パッチ適用およびプロビジョニング・サーバーでのみ実行できます。

例

フリート・パッチ適用およびプロビジョニング・サーバーにクライアントを追加するには、次のコマンドを実行します。

$ rhpctl add client -client ClientCluster3 -toclientdata Grid_home/RHPserver/info

親トピック: clientコマンド

rhpctl delete client

特定のフリート・パッチ適用およびプロビジョニング・クライアントを構成から削除します。

構文

rhpctl delete client –client cluster_name [-force]

使用上のノート

構成から削除するクライアント・クラスタの名前を指定します。
このコマンドを実行する前、または-forceオプションを使用する前には、フリート・パッチ適用およびプロビジョニング・クライアントを停止する必要があります。

例

フリート・パッチ適用およびプロビジョニング・クライアントClientCluster3を削除するには、次のようにします。

$ rhpctl delete client -client ClientCluster3

親トピック: clientコマンド

rhpctl discover client

入力された内容を検証して、特定のノード上のパラメータを検出し、Oracle Clusterwareの構成に使用できるレスポンス・ファイルを生成します。

このコマンドが完了した後、次を使用してレスポンス・ファイルを検証し、Oracle Clusterwareデプロイメントのターゲット・ノードを準備します。

構文

rhpctl discover client -image image_name -generatepath response_file_path
  {-responsefile response_file_name | -clusternodes node_list -client cluster_name 
   -oraclehome oracle_home_path} {-root | -sudouser sudo_username
   -sudopath sudo_binary_path | -cred cred_name | -auth plugin_name
  [-arg1 name1:value1...]} [-user gi_user_name]
  [-scan scan_name]

パラメータ

表A-3 rhpctl discover clientコマンドのパラメータ

パラメータ	説明
`-image image_name`	結果のレスポンス・ファイルがサポートするOracle Grid Infrastructureのゴールド・イメージの名前を指定します。
`-generatepath response_file_path`	RHPCTLにより生成されたレスポンス・ファイルのコピー先のファイル・パスを指定します。RHPCTLコマンドはレスポンス・ファイルの名前を生成し、コマンドの実行中にその名前を表示します。
`-responsefile response_file_name`	不完全なレスポンス・ファイルがあり、ターゲット・ノードを参照してそれを完了させる場合は、このパラメータを使用してレスポンス・ファイル名を指定します。ノート: レスポンス・ファイルはノード・リスト、クライアント名およびOracleホーム・パスを含む必要があります。
`-clusternodes node_list`	(結果のレスポンス・ファイルを使用して)Oracle Clusterwareをプロビジョニングする予定の、カンマ区切りのノードのリストを`node_name:node_vip[:node_role][,node_name:node_vip[:node_role]...]`の形式で指定します。
`-client cluster_name`	プローブするターゲット・クラスタの名前を指定します。
`-oraclehome oracle_home_path`	Oracleホームの場所を指定します。
`-root \| -sudouser sudo_username -sudopath sudo_binary_path \| -cred cred_name \| -auth plugin_name [-arg1 name1:value1...]`	`sudo`または`root`を選択して、リモート・ノードにアクセスする必要があります。 `sudo`を選択した場合、スーパーユーザー操作を実行するユーザー名と、`sudo`バイナリの場所のパスを指定する必要があります。必要に応じて、リモート・ノードにアクセスするためのユーザーおよびパスワード資格証明を関連付ける資格証明名を指定する選択ができます。 `–sudouser`、`–root`、または`–cred`のかわりに、`–auth`を使用してリモート・ノードにアクセスする認証プラグインを指定することもできます。
`-user gi_user_name`	Oracle Grid Infrastructureインストール・ユーザーの名前を指定します。
`-scan scan_name`	SCAN名を指定します。

親トピック: clientコマンド

rhpctl export client

フリート・パッチ適用およびプロビジョニング・サーバー上のリポジトリからクライアント・データ・ファイルにデータをエクスポートします。

構文

rhpctl export client -client cluster_name -clientdata file_path

パラメータ

表A-4 rhpctl export clientコマンドのパラメータ

パラメータ	説明
`-client cluster_name`	エクスポートするクライアント・クラスタの名前を指定します。
`-clientdata file_path`	クライアント・データ・ファイルの場所のパスを指定します。

使用上のノート

このコマンドは、フリート・パッチ適用およびプロビジョニング・サーバーでのみ実行できます。

例

mjk9394というフリート・パッチ適用およびプロビジョニング・クライアントから、リポジトリ・データをクライアント・データ・ファイル/tmp/mjk9394.xmlにエクスポートするには、次のコマンドを実行します。

$ rhpctl export client -client mjk9394 -clientdata /tmp/mjk9394.xml

親トピック: clientコマンド

rhpctl modify client

フリート・パッチ適用およびプロビジョニング・クライアントを変更します。

構文

rhpctl modify client –client cluster_name [-enabled {TRUE | FALSE}]
  [-maproles role=user_name[+user_name...][,role=user_name[+user_name...],...]]] [-password]]

パラメータ

表A-5 rhpctl modify clientコマンドのパラメータ

パラメータ	説明
`-client cluster_name`	変更するクライアント・クラスタの名前を指定します。
`-enabled {TRUE \| FALSE}`	クライアントが有効かどうかを指定します。
`-maproles role=user_name[+user_name...][,...]`	組込みロールまたはユーザーが定義したロールを変更できます。また、各ロールに複数のユーザーを割り当てることができます。 `-maproles`パラメータを使用する場合は、プラス記号(`+`)を使用して、複数のユーザーを特定のロールにマップします。ロールとユーザーのペアを追加する場合はカンマで区切ります。
`-password`	必要に応じて、フリート・パッチ適用およびプロビジョニング・クライアント資格証明を再作成するためのパスワードを指定できます。

例

RHPClient001という名前のフリート・パッチ適用およびプロビジョニング・クライアントを無効にするには、次のようにします。

$ rhpctl modify client -client RHPClient001 -enabled FALSE

親トピック: clientコマンド

rhpctl query client

特定のフリート・パッチ適用およびプロビジョニング・クライアント・クラスタの構成情報を表示します。

構文

rhpctl query client [–client cluster_name]

使用上のノート

構成情報を表示するフリート・パッチ適用およびプロビジョニング・クライアントが存在しているクライアント・クラスタの名前を指定します。

例

このコマンドでは、次のような出力が表示されます。

/rhpctl query client -client mbcluster-13
Site: mbcluster-13
Fleet Patching and Provisioning Client Version: 12.2.0.1.0
Enabled: true
Host from which RHPC last registered: rhpserver01.example.com
Port number last registered by RHPC: 8896
RHP Enabled: true
Standalone: false
Managed: true

親トピック: clientコマンド

rhpctl update client

フリート・パッチ適用およびプロビジョニング・クライアントのイメージを更新します。

構文

rhpctl update client -image image_name {-targetnode node_name 
  | -batches '(node_name)'} -root

パラメータ

表A-6 rhpctl update clientコマンドのパラメータ

パラメータ	説明
`-image image_name`	更新するイメージの名前を指定します。
`-targetnode node_name`	フリート・パッチ適用およびプロビジョニング・クライアントを更新するノードの名前を指定します。
`-batches '(node_name)'`	ターゲット・ノードを指定するかわりに、ノードのバッチを指定できます。ノート: Oracle Database Applianceノードでこのパラメータを使用する場合は、コマンドを2回連続で実行し、1回目の実行で1つのOracle Database Applianceノードを指定し、2回目の実行で別のOracle Database Applianceノードを指定します。
`–root`	`–targetnode`または`–batches`パラメータを使用する場合は、このパラメータを指定する必要があります。

使用上のノート

このコマンドは、フリート・パッチ適用およびプロビジョニング・サーバーからのみ実行できます。

例

次の例では、–targetnodeパラメータを使用します。

$ rhpctl update client -image ODA1 -targetnode rac07box1 -root

次の2つの例では、–batchesパラメータを使用します。

$ rhpctl update client -image ODA1 -batches '(rac07box1)' -root
$ rhpctl update client -image ODA1 -batches '(rac07box2)' -root

親トピック: clientコマンド

rhpctl verify client

入力された内容を検証し、Oracle Clusterwareの構成に使用できるレスポンス・ファイルを作成するか完成させ、その値を検証します。

構文

rhpctl verify client -image image_name -responsefile response_file_name
  [-clusternodes node_list] {-root | -sudouser sudo_username -sudopath
   sudo_binary_path | -cred cred_name} | -auth plugin_name [-arg1 name1:value1...]
  [-user gi_user_name] [-client cluster_name] [-scan scan_name]
  [-oraclehome oracle_home_path] [-ignorewarn] [-fixup [-setupSSH]]

パラメータ

表A-7 rhpctl verify clientコマンドのパラメータ

パラメータ	説明
`-image image_name`	イメージの名前を指定します。
`-responsefile response_file_name`	Oracle Grid Infrastructureのプロビジョニングに使用されるレスポンス・ファイルを指定します。
`-clusternodes node_list`	Oracle Clusterwareをプロビジョニングするノードのカンマ区切りリストを、`node_name:node_vip[:node_role][,node_name:node_vip[:node_role]...]`の形式で指定します。
`-root \| -sudouser sudo_username -sudopath sudo_binary_path \| -cred cred_name \| -auth plugin_name [-arg1 name1:value1...]`	`sudo`または`root`を選択して、リモート・ノードにアクセスする必要があります。 `sudo`を選択した場合、スーパーユーザー操作を実行するユーザー名と、`sudo`バイナリの場所のパスを指定する必要があります。必要に応じて、リモート・ノードにアクセスするためのユーザーおよびパスワード資格証明を関連付ける資格証明名を指定する選択ができます。 `–sudouser`、`–root`、または`–cred`のかわりに、`–auth`を使用してリモート・ノードにアクセスする認証プラグインを指定することもできます。
`-user gi_user_name`	Oracle Grid Infrastructureインストール・ユーザーの名前を指定します。
`-client cluster_name`	検証するクラスタの名前を指定します。
`-scan scan_name`	SCAN名を指定します。
`-oraclehome oracle_home_path`	Oracleホームの場所を指定します。
`-ignorewarn`	検証中の警告を無視する場合は、このパラメータを使用します。
`–fixup [-setupSSH]`	このパラメータを使用して、CVUによって推奨される変更を満たすように、変更をノードに自動的に適用する修正スクリプトを実行します。必要に応じて、プロビジョニング・ユーザーのためにリモート・ノード上にパスワードなしのSSHユーザー等価を設定する場合は、`-setupSSH`パラメータを使用できます。

親トピック: clientコマンド