imageコマンド
image
キーワードを指定してコマンドを使用し、ゴールド・イメージを追加、削除、インポートおよび管理します。
- rhpctl add image
既存の作業用コピーからイメージを作成して、フリート・パッチ適用およびプロビジョニング・サーバー構成の既存イメージのリストに追加するには、rhpctl add image
コマンドを使用します。 - rhpctl allow image
ユーザーまたはロールによるイメージへのアクセスを許可します。 - rhpctl delete image
特定のイメージを削除します。 - rhpctl deploy image
クライアント・クラスタ内の特定のノードにイメージをデプロイします。 - rhpctl disallow image
ユーザーまたはロールによるイメージへのアクセスを禁止します。 - rhpctl import image
フリート・パッチ適用およびプロビジョニング・サーバーにイメージを作成します。 - rhpctl instantiate image
ピア・フリート・パッチ適用およびプロビジョニング・サーバーからのゴールド・イメージのコピーを要求します。 - rhpctl modify image
イメージの構成詳細を変更します。 - rhpctl query image
既存のイメージの構成を表示します。 - rhpctl promote image
イメージをプロモートします。 - rhpctl register image
Oracle FPPリポジトリにイメージ・メタデータを登録します。 - rhpctl uninstantiate image
前に要求したピア・フリート・パッチ適用およびプロビジョニング・サーバーからのイメージの更新を停止します。
親トピック: RHPCTLのコマンド・リファレンス
rhpctl add image
既存の作業用コピーからイメージを作成して、フリート・パッチ適用およびプロビジョニング・サーバー構成上の既存イメージのリストに追加するには、rhpctl add image
コマンドを使用します。
構文
rhpctl add image -image image_name -workingcopy working_copy_name
[-imagetype image_type] [-series series_name] [-state {TESTABLE | RESTRICTED | PUBLISHED}]
パラメータ
表A-34 rhpctl add imageコマンドのパラメータ
コマンド・オプション | 説明 |
---|---|
-image image_name |
追加するイメージの名前を指定します。 |
-workingcopy working_copy_name |
イメージを作成する作業用コピーの名前を指定します。 ノート: このコマンドが機能するには、作業コピーがACFSストレージに格納されている必要があります。作業用コピーがローカル・ストレージ・デバイスに格納されている場合、Oracle FPPはエラーを返します。 |
-imagetype image_type |
ソフトウェア・タイプを指定します。Oracle Databaseソフトウェアの場合は |
-series series_name |
イメージをイメージ・シリーズに追加する場合は、イメージ・シリーズの名前を指定します。 |
-state {TESTABLE | RESTRICTED | PUBLISHED} |
イメージの状態を指定します。 |
使用上のノート
関連項目:
パッチが適用されたOracle Databaseソフトウェア・ホームを作成するためのワークフローでこのコマンドを使用する方法の詳細は、Oracle Databaseへのパッチ適用を参照してください。例
次に、このコマンドの例を示します。
$ rhpctl add image -image DB12201_PATCH -workingcopy temp_wcpy_db12201_patch
親トピック: imageコマンド
rhpctl allow image
構文
rhpctl allow image -image image_name {-user user_name [-client cluster_name]
| -role role_name}
パラメータ
表A-35 rhpctl allow imageコマンドのパラメータ
パラメータ | 説明 |
---|---|
-image image_name |
アクセスを許可するイメージの名前を指定します。 |
-user user_name [-client cluster_name | -role role_name |
次のいずれかを指定します。
|
例
$ rhpctl allow image -image PRODIMAGE -user mjk -client GHC1
親トピック: imageコマンド
rhpctl delete image
特定のイメージを削除します。
構文
rhpctl delete image -image image_name [-schedule {timer_value | NOW | PAUSE}] [-tag tag_name]
[-client cluster_name | -server server_cluster_name | -local] [-archive archive_path]
使用上のノート
-
削除するイメージの名前を指定します
-
必要に応じて、次の例に示すように
-schedule
パラメータを使用すれば、この操作を実行する時間をISO-8601形式でスケジュールできます。2018-07-25T19:13:17+05
このパラメータを使用する場合は、フリート・パッチ適用およびプロビジョニング・サーバーでこのコマンドを実行する必要があります。
NOW
を指定すると、ジョブは即時にスケジュールされます。PAUSE
を指定すると、ジョブは一時停止状態で起動するため、rhpctl resume job -jobid job_id
コマンドを使用してジョブを再開する必要があります。 - オプションで、ユーザー定義タグをスケジュール済ジョブに関連付けることができます。
-
イメージが1つ以上のシリーズに属する場合、このコマンドは失敗します。
-
このイメージに基づいたプロビジョニング済作業用コピーが存在する場合、このコマンドは失敗します。
- 必要に応じて、イメージを完全に削除するかわりに、
-archive
パラメータを使用し、指定した場所にイメージをアーカイブできます。
例
次の例では、PRODIMAGEV0という名前のイメージが削除されます。
$ rhpctl delete image -image PRODIMAGEV0 -archive /scratch/imagearchive
親トピック: imageコマンド
rhpctl deploy image
クライアント・クラスタ内の特定のノードにイメージをデプロイします。
構文
rhpctl deploy image -image image_name -path path_to_dir [-targetnode node_name {-root
| -cred cred_name | -sudouser sudo_username -sudopath path_to_sudo_binary | -auth plugin_name
[-arg1 name1:value1 [-arg2 name2:value2 ...]]}] [-client cluster_name]
パラメータ
表A-36 rhpctl deploy imageコマンドのパラメータ
パラメータ | 説明 |
---|---|
-image image_name |
デプロイするイメージの名前を指定します。 |
-path |
イメージをデプロイする絶対的な場所を指定します。 |
-targetnode node_name |
必要に応じて、イメージをデプロイするノードの名前を指定できます。このパラメータは、ホームをホストしているノードがフリート・パッチ適用およびプロビジョニング・クライアントでない場合に必要です。 |
-root | -cred cred_name | -sudouser sudo_user_name -sudopath sudo_binary_location | -auth plugin_name plugin_args |
スーパーユーザー操作を |
-client |
必要に応じて、クライアント・クラスタの名前を指定できます。 |
使用上のノート
このコマンドは、フリート・パッチ適用およびプロビジョニング・サーバーからのみ実行できます。
例
次の例では、Oracle Database Applianceイメージをノードにデプロイします。
$ rhpctl deploy image -image ODA1 -path /u01/app/dbusr/product/21.0.0/db21c -targetnode racgbox1 -root
親トピック: imageコマンド
rhpctl disallow image
構文
rhpctl disallow image -image image_name {-user user_name [-client client_name]
| -role role_name}
パラメータ
表A-37 rhpctl disallow imageコマンドのパラメータ
パラメータ | 説明 |
---|---|
-image image_name |
アクセスを禁止するイメージの名前を指定します。 |
-user user_name [-client client_name | -role role_name |
次のいずれかを指定します。
|
例
$ rhpctl disallow image -image PRODIMAGE -user mjk -client GHC1
親トピック: imageコマンド
rhpctl import image
フリート・パッチ適用およびプロビジョニング・サーバーにイメージを作成します。
指定されたパスのソフトウェアの内容すべてをOracle Fleet Patching and Provisioningサーバーにコピーして、イメージを作成するには、rhpctl import image
コマンドを使用します。
構文
rhpctl import image -image image_name {-path path | -zip zipped_home_path
| -store_as_zip | -location zipped_home_path | -notify [-cc user_list]}
[-imagetype image_type] [-pathowner user_name] [-version software_version]
[-state {TESTABLE | RESTRICTED | PUBLISHED}] [-location zipped_home_path] [-client cluster_name]
[-targetnode node_name [-sudouser sudo_user_name -sudopath sudo_binary_path |
-root | cred cred_name | -auth plugin_name [-arg1 name1:value1 [-arg2 name2:value2 ... ]]]]
[-useractiondata user_action_data] [] [-series series_name]
パラメータ
表A-38 rhpctl import imageコマンドのパラメータ
パラメータ | 説明 |
---|---|
-image image_name |
追加するイメージの名前を指定します。 |
-path path |
インポートするソフトウェア・ホームの絶対パスの場所を指定します。Oracle Databaseイメージの場合、これは ノート: IBM AIXサーバーでOracle Grid Infrastructureイメージをインポートする場合は、リンクされたOracle Grid Infrastructureホームからイメージをインポートしないでください。 |
-zip zipped_home_path |
インポートする圧縮ソフトウェア・ホーム(ZIPまたはTARファイル)の絶対パスを指定します。 ノート: 別のプラットフォームからイメージをインポートする場合は、このオプションを使用しないでください。このオプションは同じプラットフォームでのみ機能し、たとえば、Linuxプラットフォームを使用している場合は、-zip オプションを使用して別のLinuxシステムからのみイメージをインポートできます。
|
-store_as_zip |
圧縮されたOracleホームをzipファイルとして格納するには、このオプションを指定します。このオプションは、イメージをzipファイルとしてインポートする場合にのみ機能します。 |
-location zipped_home_path |
宛先クラスタ上の圧縮されたイメージ・ファイルの場所を指定します。 |
-notify [-cc users_list] |
電子メール通知を送信します。 (作業用コピーの所有者に加えて)電子メール通知を送信するユーザーのリストを指定します。 |
-imagetype image_type |
ソフトウェア・タイプを指定します。Oracleデータベース・ソフトウェアの場合は ノート: IBM AIXサーバーでOracle Grid Infrastructureイメージをインポートする場合は、SOFTWARE イメージ・タイプを指定します。
|
-version software_version |
必要に応じて、インポートするソフトウェアのバージョンを指定できます。 |
-pathowner user_name |
指定したパスにあるファイルやディレクトリへのアクセス権を持つユーザーを指定します。 ノート: このパラメータはOracleデータベース以外のソフトウェア・ホームのみに適用されます。 |
-state {TESTABLE | RESTRICTED | PUBLISHED} |
イメージの状態が、テスト可能、制限または公開済のいずれであるかを指定します。 |
-location zipped_home_path |
宛先クラスタ上の圧縮されたイメージ・ファイルの場所。 |
-client cluster_name |
クライアント・クラスタの名前を指定します。 |
-targetnode node_name |
イメージのインポート元のノードの名前を指定します。このパラメータは、ホームをホストしているノードが |
-sudouser sudo_user_name -sudopath sudo_binary_path | -root] |
|
-auth plugin-name [-arg1 name1:value1 [-arg2 name2:value2 ...]] |
認証プラグインを使用してリモート・ノードにアクセスします。 オプションで、プラグインに引数のリストを提供することもできます。 |
-useractiondata user_action_data |
必要に応じて、ユーザー・アクション・スクリプトの |
-series series_name |
シリーズの名前。 |
使用上のノート
-
このコマンドは、フリート・パッチ適用およびプロビジョニング・サーバーでのみ実行できます。
-
Oracle DatabaseまたはOracle Grid Infrastructureソフトウェア・ホームをインポートするとき、ホームのバージョンは、フリート・パッチ適用およびプロビジョニングによってプロビジョニングおよびパッチ適用がサポートされるバージョンのいずれかである必要があります。
例
次の例では、イメージがインポートされます。
$ rhpctl import image -image PRODIMAGEV1 -path /u01/app/product/12.1.0/dbhome -pathowner orcl
次の例では、エンジニアド・システム・イメージがインポートされます。
$ rhpctl import image -image ODA1 -imagetype ODAPATCHSOFTWARE -path /tmp/ODAPatchBundle -version 12.1.2.8.0
親トピック: imageコマンド
rhpctl instantiate image
構文
rhpctl instantiate image -server server_cluster_name {-image image_name
| -series series_name | -imagetype image_type | -all}
パラメータ
表A-39 rhpctl instantiate imageコマンドのパラメータ
パラメータ | 説明 |
---|---|
-server server_cluster_name |
イメージをリクエストするフリート・パッチ適用およびプロビジョニング・サーバー・クラスタを指定します。 |
-image image_name | -series series_name | -imagetype image_type | -all |
イメージ名、系列名、またはイメージ・タイプを指定することで、ピア・フリート・パッチ適用およびプロビジョニング・サーバーからのゴールド・イメージのコピーを要求できます。また、 イメージ・タイプによってイメージを要求する場合、Oracle Databaseソフトウェアの場合は |
使用上のノート
-
コピー対象のイメージに関連付けられているユーザー・アクションはコピーされません。
-
ゴールド・イメージのグループ構成は、ピアに送信されるコピーでレプリケートされます。
-
ゴールド・イメージのコピーは、PUBLISHED状態になります。
親トピック: imageコマンド
rhpctl modify image
構文
rhpctl modify image -image image_name -imagetype image_type
パラメータ
表A-40 rhpctl modify imageコマンドのパラメータ
パラメータ | 説明 |
---|---|
-image image_name |
変更するイメージの名前を指定します。 |
-imagetype image_type |
ソフトウェア・タイプを変更できます。Oracle Databaseソフトウェアの場合は |
親トピック: imageコマンド
rhpctl query image
既存のイメージの構成を表示します。
構文
rhpctl query image {[[-image image_name [-dbtemplate]] | [[-imagetype image_type]
[-version version] [-platform platform] [-complete]]]
[-server server_cluster_name | -client client_name | -local] | -drift}
[-rhpserver rhps_regex]
パラメータ
表A-41 rhpctl query imageコマンドのパラメータ
パラメータ | 説明 |
---|---|
-image image_name [-dbtemplate] |
問い合せるイメージの名前を指定します。 必要に応じて、 |
-imagetype image_type |
ソフトウェア・タイプを指定します。Oracle Databaseソフトウェアの場合は |
–version version |
問い合せるイメージ・ソフトウェアのバージョンを指定します。 |
-platform platform |
イメージに対応するオペレーティング・システム・プラットフォームを指定します。 |
-complete |
このパラメータを使用して、イメージ補完がTRUE に設定されているイメージをすべてリストします。
|
-server server_cluster_name |
イメージに対応するサーバー・クラスタの名前を指定します。 |
-client client_name |
このパラメータが |
-local |
現在のクライアントに格納されているイメージをリストします。 |
-drift |
ゴールド・イメージに含まれていないバグ修正をリストします。 |
-rhpserver rhps_regex |
操作を実行する必要があるサーバーのクラスタ名と一致する正規表現を指定します。 |
使用上のノート
-version
パラメータを使用する場合、バージョンには5つのフィールドが必要です(12.1.0.2.4など)。
-platform
パラメータを使用する場合は、Linux_AMD64
、Linux_S390
、Linux_PPC
、IBM_AIX_PPC64
、HP_IA64
、Linux_Itanium
、Solaris_SPARC64
、Linux_LOP
およびIntel_Solaris_AMD64
を使用できます。
-rhpserver
パラメータは操作の実行場所を示し、-server
パラメータは操作の実行内容を示します。-rhpserver
を使用すると、指定した正規表現と名前が一致するサーバーでコマンドが実行されます。-server
が使用されている場合、コマンドは指定されたサーバーに関するものです。たとえば:
-
次のコマンドはローカルで実行され、
peerA
にレプリケートされたイメージをリストしますrhpctl query image -server peerA
-
次のコマンドは、
peerA
で実行され、peerA
に構成されているイメージをリストしますrhpctl query image -rhpserver peerA
-
次のコマンドは、すべてのサーバーで実行され、各サーバーが
peerA
にレプリケートしたイメージをリストしますrhpctl query image -server peerA -rhpserver .+'
-rhpserver
オプションを使用してピア・サーバーに対するコマンドを発行する場合、コマンドを実行するユーザーはピア・サーバーの既存のユーザーであり、必要なロールを持っている必要があります。ピア・サーバーのユーザーがローカル・サーバーでコマンドを実行できるようにするには、rhpctl
grant
role
コマンドを実行して必要なロールをピア・サーバー・ユーザーに付与し、ユーザーが属しているピア・サーバーのクラスタ名を指定する必要があります。たとえば:
$ rhpctl grant role -role role_name -user user_name -client cluster_name
複数のユーザーを追加するには、次のコマンドを実行します。
$ rhpctl grant role -client cluster_name -maproles role=user_name[+user_name...][,role=user_name[+user_name...]...]
RHPCTLを使用してロールを付与する詳細は、rhpctl grant roleを参照してください
親トピック: imageコマンド
rhpctl promote image
構文
rhpctl promote image -image image_name -state {TESTABLE | RESTRICTED | PUBLISHED}
パラメータ
表A-42 rhpctl promote imageコマンドのパラメータ
パラメータ | 説明 |
---|---|
-image image_name |
プロモートするイメージの名前を指定します。 |
-state {TESTABLE | RESTRICTED | PUBLISHED} |
イメージの状態の名前として次のいずれかを指定します。
|
例
$ rhpctl promote image -image PRODIMAGE -state RESTRICTED
親トピック: imageコマンド
rhpctl register image
イメージのメタデータをOracle FPPリポジトリに登録します。
構文
rhpctl register image -image image_name
{-path home_path | -zip zipped_home_path} [-imagetype image_type] [-pathowner username]
[-state {TESTABLE| RESTRICTED|PUBLISHED}] [-client cluster_name] [-targetnode target_node_name [-sudouser sudo_username
-sudopath path_to_sudo_binary | -root | -cred cred_name]] [-useractiondata user_action_data]
パラメータ
表A-43 rhpctl register imageコマンドのパラメータ
パラメータ | 説明 |
---|---|
-image image_name |
作業用コピーの登録元の構成済イメージの名前、または作業用コピーの追加時にRHPCTLが最新のイメージを取得するイメージ・シリーズの名前を指定します。 |
-path home_path |
ソフトウェア・ホームをプロビジョニングするための絶対パスを指定します。Oracle Databaseイメージの場合、これが |
-zip zipped_home_path |
インポートする圧縮ソフトウェア・ホーム(ZIPまたはTARファイル)の絶対パスを指定します。 |
-imagetype image_type |
ソフトウェア・タイプを指定します。Oracleデータベース・ソフトウェアの場合は |
-pathowner user_name |
指定したパスにあるファイルやディレクトリへのアクセス権を持つユーザーを指定します。 ノート: このパラメータはOracleデータベース以外のソフトウェア・ホームのみに適用されます。 |
-state {TESTABLE | RESTRICTED | PUBLISHED} |
イメージの状態が、テスト可能、制限または公開済のいずれであるかを指定します。 |
-client cluster_name |
クライアント・クラスタの名前を指定します。 |
-targetnode target_node_name |
|
-sudouser sudo_user_name -sudopath sudo_binary_path | -root | -cred cred_name |
|
-useractiondata user_action_data |
必要に応じて、ユーザー・アクション・スクリプトの |
例
- Oracle Databaseのイメージを登録するには:
$ rhpctl register image -image PRODIMAGEV1 -path /u01/app/product/23.5.0/dbhome_1 -pathowner orcl
親トピック: imageコマンド
rhpctl uninstantiate image
構文
rhpctl uninstantiate image -server server_cluster_name {-image image_name
| -series series_name | -imagetype image_type | -all}
パラメータ
表A-44 rhpctl uninstantiate imageコマンドのパラメータ
パラメータ | 説明 |
---|---|
-server server_cluster_name |
更新を停止するフリート・パッチ適用およびプロビジョニング・サーバー・クラスタを指定します。 |
-image image_name | -series series_name | -imagetype image_type | -all |
イメージ名、系列名、またはイメージ・タイプを指定して、ピア・フリート・パッチ適用およびプロビジョニング・サーバーから更新を取得できます。また、 イメージ・タイプによって更新を停止する場合、Oracle Databaseソフトウェアの場合は |
親トピック: imageコマンド