このページは機械翻訳したものです。

Oracle Exadata Database Service on Cloud@Customerでのdbaascliユーティリティの使用

Oracle Exadata Database Service on Cloud@Customerでdbaascliユーティリティを使用する方法について学習します。

Oracle Exadata Database Service on Cloud@Customerでのdbaascliユーティリティの使用について

dbaascliユーティリティを使用して、Oracle Databaseの作成、Oracle Databaseへのパッチの適用、プラガブル・データベース(PDB)の管理、切断モードでのCPUコア数のスケールなど、Oracle Exadata Database Service on Cloud@Customerで様々なデータベース・ライフサイクルおよび管理操作を実行できます。

リソースのスケーリングには、DBaaSコンソールまたはコマンドライン・インタフェースを使用する必要があります。dbaascliユーティリティの機能は、Oracle Cloud Infrastructureコンソール、APIまたはコマンドライン・インタフェース(CLI)とは別個のものとして追加されます。別の方法が指定されていないかぎり、すべての管理コマンドを実行するには、dbaascliへのrootアクセスが必要です。

このユーティリティを使用するには、Exadata Cloud@Customer仮想マシンに接続する必要があります。SSHを使用した仮想マシンへの接続を参照してください。

dbaascliで使用可能なコマンドを取得するには、dbaascli --helpを実行します。

コマンド固有のヘルプを取得するには、dbaascli command --helpを実行します。たとえば、dbaascli database create --helpです。

dbaascliを使用したOracle Databaseの作成

dbaascliを使用してOracle Databaseを作成するには、まず目的のバージョンのOracle Databaseホームを作成した後に、そのOracle Databaseホームにデータベースを作成します。

データベースの使用可能なソフトウェア・イメージおよびバージョンのリスト

Oracle Databaseの作成に使用できるサポート対象のバージョンのリストを取得するには、dbaascli cswlib showImagesコマンドを使用します。

  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 次のコマンドを実行します:
    dbaascli cswlib showImages

    コマンド出力に、使用可能なデータベース・ソフトウェア・イメージがリストされます。

  4. rootユーザー・コマンド・シェルを終了します:
    exit

    サポートされる拡張オプションの詳細は、dbaascli cswlib showImagesを参照してください。

例7-1 dbaascli cswlib showImages

dbaascli cswlib showImages

DBAAS CLI version MAIN Executing command cswlib showImages 
INFO : Log file => /var/opt/oracle/log/list/list_2021-05-10_10:11:00.56966610630.log 

############ List of Available DB Images #############
1.IMAGE_TAG=19.8.0.0.0
VERSION=19.8.0.0.0
DESCRIPTION=19c JUL 2020 DB Image
IMAGE_ALIASES=19000-19800,19000-JUL2020

2.IMAGE_TAG=19.8.0.0.0-NC
VERSION=19.8.0.0.0
DESCRIPTION=19c JUL 2020 Non CDB Image
IMAGE_ALIASES=19000-NC19800,19000-NCJUL2020

3.IMAGE_TAG=19.9.0.0.0
VERSION=19.9.0.0.0
DESCRIPTION=19c OCT 2020 DB Image
IMAGE_ALIASES=19000-19900,19000-OCT2020

4.IMAGE_TAG=19.9.0.0.0-NC
VERSION=19.9.0.0.0
DESCRIPTION=19c OCT 2020 Non CDB Image
IMAGE_ALIASES=19000-NC19900,19000-NCOCT2020
ノート

dbaascli cswlib showImagesコマンド出力から、dbaascli dbhome createコマンドでターゲット・バージョンを--version値として指定できます。

Oracle Databaseホームの作成

目的のバージョンのOracle Databaseホームを作成するには、dbaascli dbhome createコマンドを使用します。

ノート

指定したOracleホーム名を持つOracle Databaseホームを作成できます。指定しない場合、これは自動的に計算されます(推奨)。
  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 次のコマンドを実行します:
    dbaascli dbhome create --version Oracle Home Version --imageTag image Tag Value
    説明:
    • --versionは、Oracle Databaseバージョンを指定します
    • --imageTagは、使用するイメージのイメージ・タグを指定します
    例:
    dbaascli dbhome create --version 19.9.0.0.0
    ノート

    imageTagの指定はオプションです。イメージ・タグを表示するには、コマンドdbaascli cswlib showImagesを参照してください。イメージ・タグは通常、データベースのバージョンと同じです。ただし、同じバージョンに対して複数のイメージをリリースする必要がある場合に備えて(それぞれが特定の顧客の要件に対応します)、これはプロビジョニングとして維持されます。
  4. rootユーザー・コマンド・シェルを終了します:
    exit

    サポートされる拡張オプションの詳細は、dbaascli dbhome createを参照してください。

指定したOracle DatabaseホームでのOracle Databaseの作成

目的のバージョンの指定したOracle DatabaseホームにOracle Databaseを作成するには、dbaascli database createコマンドを使用します。

dbaascli database createコマンドを使用して、次を実行できます:
  • コンテナ・データベース(CDB)または非コンテナ・データベースの作成
  • プラガブル・データベース(PDB)を含むCDBの作成
  • 指定した文字セットでのOracle Databaseの作成
  • クラスタ・ノードのサブセットでのOracle Databaseの作成
    ノート

    ノードのサブセットで作成されたデータベースは、OCIコンソールに表示されません。
  • リリース更新JAN 2021以上が適用されたOracle Databaseバージョン12.1.0.2以上の作成。より下位のバージョンのデータベースでは、OCIコンソール・ベースのAPIを使用することをお薦めします。
  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 次のコマンドを実行します:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path
    説明:
    • --dbNameは、データベースの名前を指定します
    • --oracleHomeは、Oracleホームの場所を指定します
    CDBを作成するには、次のコマンドを実行します:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path
    非CDBを作成するには、次のコマンドを実行します:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path --createAsCDB false

    プロンプトが表示されたら、sysおよびtdeのパスワードを入力します。

  4. rootユーザー・コマンド・シェルを終了します:
    exit

    サポートされる拡張オプションの詳細は、dbaascli database createを参照してください。

Oracle Database作成前の前提条件チェックの実行

前提条件チェックを実行するには、--executePrereqsコマンド・オプションを使用します。これは、実際にOracle Databaseを作成せずに、前提条件チェックのみを実行します。

  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 次のコマンドを実行します:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path --executePrereqs
    説明:
    • --dbNameは、データベースの名前を指定します
    • --oracleHomeは、Oracleホームの場所を指定します
  4. rootユーザー・コマンド・シェルを終了します:
    exit

    サポートされる拡張オプションの詳細は、dbaascli database createを参照してください。

Oracle Database作成操作の再開または元に戻す

失敗したデータベース作成操作を再開するか元に戻すには、--resumeまたは--revertコマンド・オプションを使用します。

例:
dbaascli database create --dbName database name --oracleHome Oracle Home Path --resume
ノート

  • --resumeまたは--revertコマンド・オプションを使用する場合は、実際の作成操作フローで使用した同じノードから同じコマンドを使用してください。
  • データベース作成を再開できるのは、データベース作成後のステップに障害が発生した場合のみです。

データベース・パスワードの変更

SYSパスワードを変更するか、TDEウォレット・パスワードを変更するには、この手順を使用します。

新しいExadata Database Service on Cloud@Customerインスタンスまたはデータベースを作成するときに「データベース管理パスワード」フィールドで指定したパスワードは、SYS、SYSTEM、TDEウォレットおよびPDB管理者資格証明のパスワードとして設定されます。既存のデータベースのパスワードを変更する必要がある場合は、次の手順を使用します。

ノート

データベースでData Guardを有効にする場合、プライマリ・データベースとスタンバイ・データベースのSYSパスワードおよびTDEウォレット・パスワードはすべて同じである必要があります。
ノート

dbaascliを使用してSYSパスワードを変更すると、バックアップ/リストアの自動化によってクラスタ内のすべてのノード間でチャネルをパラレル化できます。

Exadata Database Service on Cloud@CustomerデータベースのSYSパスワードを変更するには

  1. Exadata Database Service on Cloud@Customer仮想マシンにopcとしてログオンします。
  2. 次のコマンドを実行します:
    sudo dbaascli database changepassword --dbname database_name --user SYS

Data Guard環境でデータベース・パスワードを変更するには

  1. 次のコマンドをプライマリ・データベースで実行します:
    dbaascli database changePassword —dbName <dbname> --user SYS --prepareStandbyBlob true --blobLocation <location to create the blob file>
  2. 作成されたBLOBファイルをすべてのスタンバイ・データベースにコピーし、ファイルの所有権をoracleユーザーに更新します。
  3. すべてのスタンバイ・データベースで次のコマンドを実行します:
    dbaascli database changePassword —dbName <dbname> --user SYS --standbyBlobFromPrimary <location of copies the blob file>

Exadata Database Service on Cloud@CustomerデータベースのTDEウォレット・パスワードを変更するには

  1. Exadata Database Service on Cloud@Customer仮想マシンにopcとしてログオンします。
  2. 次のコマンドを実行します:
    sudo dbaascli tde changepassword --dbname database_name

dbaascliユーティリティを使用したOracle Exadata Database Service on Cloud@Customerソフトウェア・イメージの管理

Oracle Exadata Database Service on Cloud@CustomerインスタンスでOracleデータベース・ソフトウェア・イメージをリストおよびダウンロードできます。その後、データベース・ホームのプロビジョニングに使用できます。

ノート

コンソールまたはAPIを使用して、Oracle Exadata Database Service on Cloud@Customerインスタンスのカスタム・データベース・ソフトウェア・イメージを作成できます。これらのイメージはオブジェクト・ストレージに格納され、Exadataインスタンスにデータベース・ホームをプロビジョニングするために使用できます。詳細は、Oracle Databaseソフトウェア・イメージを参照してください。

システムでソフトウェア・イメージを維持することで、Oracle Exadata Database Service on Cloud@Customerインスタンスで新しいデータベースをプロビジョニングするときにインストールされるOracleバイナリのバージョンを制御できます。Oracleにはクラウド・ソフトウェア・イメージのライブラリが用意されており、dbaascliユーティリティを使用して表示したり、インスタンスにダウンロードできます。

データベースおよびGrid Infrastructureの使用可能なソフトウェア・イメージおよびバージョンのリスト

パッチ適用に使用できるサポート対象のバージョンのリストを生成するには、dbaascli cswlib showImagesコマンドを使用します。

  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 次のコマンドを実行します:
    dbaascli cswlib showImages --product database

    コマンド出力に、使用可能なデータベース・ソフトウェア・イメージがリストされます。

    dbaascli cswlib showImages --product grid

    コマンド出力に、使用可能なグリッド・ソフトウェア・イメージがリストされます。

  4. rootユーザー・コマンド・シェルを終了します:
    exit

    サポートされる拡張オプションの詳細は、dbaascli cswlib showImagesを参照してください。

例7-2 dbaascli cswlib showImages

[root@dg11lrg1 dbhome_1]# dbaascli cswlib showImages
DBAAS CLI version <version>
Executing command cswlib
      showImagesJob id: 00e89b1a-1607-422c-a920-22f44bec1953Log file location:
      /var/opt/oracle/log/cswLib/showImages/dbaastools_2022-05-11_08-49-12-AM_46941.log

############
List of Available Database Images
#############

17.IMAGE_TAG=18.17.0.0.0  
   VERSION=18.17.0.0.0  
   DESCRIPTION=18c JAN 2022 DB Image

18.IMAGE_TAG=19.10.0.0.0  
   VERSION=19.10.0.0.0  
   DESCRIPTION=19c JAN 2021 DB Image

19.IMAGE_TAG=19.11.0.0.0  
   VERSION=19.11.0.0.0  
   DESCRIPTION=19c APR 2021 DB Image

20.IMAGE_TAG=19.12.0.0.0
  VERSION=19.12.0.0.0
  DESCRIPTION=19c JUL 2021 DB Image

21.IMAGE_TAG=19.13.0.0.0  
  VERSION=19.13.0.0.0  
  DESCRIPTION=19c OCT 2021 DB Image

Images can be downloaded using their image tags. For details, see help using 'dbaascli cswlib download --help'.
dbaascli execution completed

ソフトウェア・イメージをダウンロードするには

dbaascliユーティリティのcswlib downloadサブコマンドを使用して、使用可能なソフトウェア・イメージをOracle Exadata Database Service on Cloud@Customerインスタンス上にダウンロードできます。

  1. opcユーザーとしてコンピュート・ノードに接続します。詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。
  2. rootユーザー・コマンド・シェルを起動します:
    $ sudo -s
    #
  3. cswlib downloadサブコマンドを指定してdbaascliコマンドを実行します:
    # dbaascli cswlib download [--version <software_version>] [--imageTag <image tag
        value>]
    このコマンドは、Oracle Exadata Database Service on Cloud@Customer環境にダウンロードされるソフトウェア・イメージの場所を表示します。

    オプションのパラメータは次のとおりです:

    • version: Oracle Databaseソフトウェアのバージョンを指定します。たとえば、19.14.0.0.0です。
    • imageTag: イメージのイメージ・タグを指定します。
  4. rootユーザー・コマンド・シェルを終了します:
    # exit
    $

dbaascliを使用したOracle Grid InfrastructureおよびOracle Databaseへのパッチ適用

dbaascliユーティリティを使用して、Exadata Cloud@Customerシステム上のOracle Grid InfrastructureおよびOracle Databaseに対してパッチ適用操作を実行する方法について学習します。

dbaascliを使用したデータベースへのパッチ適用

dbaascliを使用して、Oracleホームにパッチを適用するか、目的のパッチ・レベルのOracleホームにデータベースを移動することで、データベースにパッチを適用できます。

  • Oracleホームへのパッチ適用(インプレース・パッチ適用)。これにより、Oracleホームに存在するすべてのデータベースが更新されます。
  • 目的のOracle Databaseソフトウェア・バージョンが含まれる別のOracleホームへのデータベースの移動(アウトオブプレース・パッチ適用)。
データベース・ホームへのパッチ適用(インプレース・データベース・パッチ適用)

Oracleホームにパッチを適用するには、dbaascli dbHome patchコマンドを使用します。

これにより、指定したホームで実行されているすべてのデータベースにパッチが適用され、データベースはパッチ適用が完了した後もホームに残ります。インプレース・パッチ適用操作にdbHome patchコマンドを使用する場合、次が適用されます:
  • すべてのデータベース・ノードまたはノードのサブセットにパッチを適用できます。
  • マルチノード・パッチ適用はローリング方式で行われます。
  • オプションで、ソフトウェアのみのパッチ操作を実行できます。その後、準備が完了したら、datapatchを実行してパッチ後のSQLアクションを実行できます。
  • 1つ以上のデータベースを含むOracleホームにパッチを適用できます。

Oracleホームにパッチを適用するには(dbhome):

  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 次のコマンドを実行します:
    dbaascli dbhome patch --oracleHome dbhome_path --targetVersion Oracle_Database_version
    説明:
    • --oracleHomeは、パッチを適用するOracleホームのパスを示します。
    • --targetVersionは、パッチ適用に使用するターゲットOracle Databaseバージョンを指定します。ピリオドで区切られた5つの数値セグメントとして指定します(例: 19.12.0.0.0)。
    例:
    dbaascli dbhome patch --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --targetVersion 19.9.0.0.0
  4. rootユーザー・コマンド・シェルを終了します:
    exit

    サポートされる拡張オプションの詳細は、dbaascli dbHome patchを参照してください。

別のOracleホームへのデータベースの移動(アウトオブプレース・パッチ適用)

すでに目的のパッチ・レベルにあるOracleホームにOracle Databaseを移動してパッチを適用するには、dbaascli database moveコマンドを使用します。

データベースの移動操作が完了すると、データベースは、ターゲットOracleホームのOracle Databaseソフトウェア・バージョンを使用して実行されます。

別のOracleホームにデータベースを移動してパッチを適用するには:

  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 次のコマンドを実行します:
    dbaascli database move --oracleHome path_to_target_oracle_home --dbname database_name
    説明:
    • --oracleHomeは、目的のOracle Databaseソフトウェア・バージョンを使用するターゲットOracleホームのパスを示します。database moveコマンドを使用する前に、ターゲットOracleホームがシステムに存在している必要があります。
    • --dbnameは、移動するデータベースの名前を指定します。
    例:
    dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --dbname xyz
  4. rootユーザー・コマンド・シェルを終了します:
    exit

    サポートされる拡張オプションの詳細は、dbaascli database moveを参照してください。

Oracle Grid Infrastructureへのパッチ適用

Oracle Grid Infrastructureにパッチを適用するには、grid patchコマンドを使用します。

  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 次のコマンドを実行します:
    dbaascli grid patch --targetVersion target_software_version_number

    ここで、--targetVersionは、Oracle Grid Infrastructureへのパッチ適用後のターゲット・ソフトウェア・バージョンを示します。

    例:
    dbaascli grid patch --targetVersion 19.11.0.0.0
  4. rootユーザー・コマンド・シェルを終了します:
    exit

    サポートされる拡張オプションの詳細は、dbaascli grid patchを参照してください。

GIソフトウェア・イメージを使用したOracle Grid Infrastructure (GI)へのパッチ適用

GIソフトウェア・イメージを使用してOracle Grid Infrastructure (GI)にパッチを適用するには、次の手順を使用します。

Oracle Grid Infrastructureには、最初にパッチ適用済のソフトウェア・イメージを作成し、そのイメージを使用してパッチ適用操作を実行することによってもパッチを適用できます。これにより、パッチ適用ウィンドウ外でイメージを事前に作成できるという利点が得られます。また、パッチ間に競合がある場合はイメージ作成プロセス中に明らかになるため、パッチ・ウィンドウに影響を与えずに競合を解決することもできます。

  1. パッチを適用したソフトウェア・イメージを作成します。
    dbaascli grid patch --targetVersion <target_software_version_number> --createImage
    パッチを適用したソフトウェア・イメージの作成が完了したら、そのイメージを使用してパッチ適用操作を実行できます。
  2. パッチ適用操作を実行します。
    dbaascli grid patch --targetVersion <target_software_version_number> --imageLocation <location_of_patched_software_image>

データベースおよびGrid Infrastructureの使用可能なソフトウェア・イメージおよびバージョンのリスト

パッチ適用に使用できるサポート対象のバージョンのリストを生成するには、dbaascli cswlib showImagesコマンドを使用します。

  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 次のコマンドを実行します:
    dbaascli cswlib showImages --product database

    コマンド出力に、使用可能なデータベース・ソフトウェア・イメージがリストされます。

    dbaascli cswlib showImages --product grid

    コマンド出力に、使用可能なグリッド・ソフトウェア・イメージがリストされます。

  4. rootユーザー・コマンド・シェルを終了します:
    exit

    サポートされる拡張オプションの詳細は、dbaascli cswlib showImagesを参照してください。

例7-3 dbaascli cswlib showImages

[root@dg11lrg1 dbhome_1]# dbaascli cswlib showImages
DBAAS CLI version <version>
Executing command cswlib
      showImagesJob id: 00e89b1a-1607-422c-a920-22f44bec1953Log file location:
      /var/opt/oracle/log/cswLib/showImages/dbaastools_2022-05-11_08-49-12-AM_46941.log

############
List of Available Database Images
#############

17.IMAGE_TAG=18.17.0.0.0  
   VERSION=18.17.0.0.0  
   DESCRIPTION=18c JAN 2022 DB Image

18.IMAGE_TAG=19.10.0.0.0  
   VERSION=19.10.0.0.0  
   DESCRIPTION=19c JAN 2021 DB Image

19.IMAGE_TAG=19.11.0.0.0  
   VERSION=19.11.0.0.0  
   DESCRIPTION=19c APR 2021 DB Image

20.IMAGE_TAG=19.12.0.0.0
  VERSION=19.12.0.0.0
  DESCRIPTION=19c JUL 2021 DB Image

21.IMAGE_TAG=19.13.0.0.0  
  VERSION=19.13.0.0.0  
  DESCRIPTION=19c OCT 2021 DB Image

Images can be downloaded using their image tags. For details, see help using 'dbaascli cswlib download --help'.
dbaascli execution completed

データベースおよびGrid Infrastructureへのパッチ適用前の事前チェックの実行

適用可能な事前チェック・フラグを使用して、このトピックのコマンドの前提条件チェック操作(「事前チェック」とも呼ばれる)を実行できます。

事前チェックを実行すると、実際のパッチ適用を実行せずに、パッチ適用操作の事前チェック部分のみを実行できます。Oracleでは、正常なパッチ適用を妨げる可能性のあるソフトウェアの問題を検出するために、事前チェックを実行することをお薦めします。

パッチ適用の事前チェックを実行するには、最初にrootユーザーとしてExadata Cloud@Customerインスタンスの仮想マシンに接続します。

Oracleホームのパッチ適用の事前チェック(インプレース・パッチ適用)

dbaascli dbhome patchコマンドで--executePrereqsフラグを使用します。

  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 次のコマンドを実行します:
    dbaascli dbhome patch --oracleHome dbhome_path --targetVersion Oracle_Database_version --executePrereqs
    説明:
    • --oracleHomeは、事前チェックするOracleホームのパスを示します。
    • --targetVersionは、パッチを適用するターゲットのOracle Databaseバージョンを指定します。ピリオドで区切られた5つの数値セグメントとして指定します(例: 19.12.0.0.0)。
  4. rootユーザー・コマンド・シェルを終了します:
    exit
データベース移動のパッチ適用の事前チェック(アウトオブプレース・パッチ適用)

dbaascli database moveコマンドで--executePrereqsフラグを使用します。

  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 次のコマンドを実行します:
    dbaascli database move --oracleHome path_to_target_oracle_home --dbname database_name --executePrereqs
    説明:
    • --oracleHomeは、目的のOracle Databaseソフトウェア・バージョンを使用するターゲットOracleホームのパスを示します。database moveコマンドを使用する前に、ターゲットOracleホームがシステムに存在している必要があります。
    • --dbnameは、移動するデータベースの名前を指定します
  4. rootユーザー・コマンド・シェルを終了します:
    exit
Oracle Grid Infrastructureのパッチ適用の事前チェック

dbaascli grid patchコマンドで--executePrereqsフラグを使用します。

  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 次のコマンドを実行します:
    dbaascli grid patch --targetVersion target_software_version_number --executePrereqs

    ここで、--targetVersionは、Oracle Grid Infrastructureにパッチが適用されるターゲット・ソフトウェアのバージョンを識別し、ピリオドで区切られた5つの数値セグメントとして指定します(例: 19.12.0.0.0)。

  4. rootユーザー・コマンド・シェルを終了します:
    exit

パッチ適用操作の再開またはロールバック

失敗したパッチ適用操作を再開するか元に戻すことができます。パッチを元に戻すことは、ロールバックと呼ばれます。

パッチ操作の再開

パッチ適用操作を再開するには、元のパッチ適用コマンドで--resumeフラグを使用します。

  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 元のパッチ適用コマンドを実行して、パッチ適用操作を再開します:
    例:
    dbaascli dbhome patch --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --targetVersion 19.9.0.0.0 --resume
  4. rootユーザー・コマンド・シェルを終了します:
    exit
パッチ操作のロールバック

パッチ適用操作をロールバックする(元に戻す)には、元のパッチ適用コマンドで--rollbackフラグを使用します。

  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 元のパッチ適用コマンドを実行して、パッチ適用操作をロールバック(元に戻す)します:
    例:
    dbaascli grid patch --targetVersion 19.11.0.0.0 --rollback
    ノート

    • 再開およびロールバック操作は、Oracleホームのパッチ適用、Oracle Grid Infrastructureのパッチ適用、およびデータベースの移動操作でサポートされます。
    • パッチ適用操作を再開またはロールバックする場合は、元のパッチ適用コマンドの実行に使用されたものと同じノードから再開またはロールバック・コマンドを実行する必要があり、--resumeまたは--rollbackフラグを追加して元のコマンドを実行する必要があります。
  4. rootユーザー・コマンド・シェルを終了します:
    exit

dbaascliを使用したクラウド・ツールの更新

Oracle Exadata Database Service on Cloud@Customerのクラウド・ツール・リリースを更新するには、この手順を実行します。

クラウド固有のツールは、dbaascliコマンドなどのローカル操作のためにExadata Cloud@CustomerゲストVMで使用されます。

クラウド・ツールは、新しいリリースが使用可能になると、Oracleによって自動的に更新されます。必要に応じて、次のステップに従って、VMクラスタ内のすべての仮想マシンにクラウド固有のツールの最新バージョンを用意できます。
ノート

更新されたツールを含むソフトウェア・パッケージをダウンロードして適用することで、クラウド固有のツールを更新できます。
  1. opcユーザーとして仮想マシンに接続します。

    詳細な手順は、SSHを使用した仮想マシンへの接続を参照してください。

  2. rootユーザー・コマンド・シェルを起動します:
    sudo -s
  3. 使用可能な最新のクラウド・ツール・リリースに更新するには、次のコマンドを実行します:
    dbaascli admin updateStack

    このコマンドは、クラスタのすべてのノードでクラウド・ツール・リリースの更新を処理します。

    詳細およびその他の使用可能なオプションについては、dbaascli admin updateStack --helpを参照してください。

複製データベースの作成

dbaascliを使用したクラウド・データベースの複製

dbaascliを使用して複製データベースを作成できます。この新しいデータベースは、ソース・リージョンと同じクラウド・リージョンにすることも、リージョン全体にすることもできます。次のステップでは、クラウド上に複製データベースを作成する方法について説明します。

ノート

データベースがTDE暗号化用にOCI Vaultで構成されており、データベースを複製する場合は、次の項を参照してください。

複製を準備する

次の前提条件に注意してください。

  • EZConnect文字列を介してソース・データベースにアクセスするためのネットワーク・パスが設定されていることを確認します。
  • TDEウォレット・ファイル(ewallet.p12)をターゲット・データベース・ノードにコピーします。dbaascliコマンドの実行を決定したノード。
  • 必要に応じて、ターゲット・ノードにOracleホームを作成します。Oracleホームのバージョンは、ソースまたはそれ以上のRUバージョンと同じバージョンである必要があります。

前提条件チェックを実行します

前提条件チェックを実行するには、--executePrereqsコマンド・オプションを使用します。これは、実際のOracle Database複製を実行せずに、前提条件チェックのみを実行します。

dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod FILE --tdeConfigMethod FILE --executePrereqs

データベースの複製

dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod FILE --tdeConfigMethod FILE
ノート

ソース・データベースでTDEキーストア管理にOKVを使用している場合、現在の複製データベース操作ではこの構成はサポートされません。

オンプレミス・データベースの複製

dbaascliを使用すると、オンプレミス・データベースをクラウドに複製できます。これは、dbaascli database duplicateコマンドで実行できます。このコマンドは、クラウド上に新しいデータベースを作成します。これは、オンプレミス・データベースとそのデータの複製です。このプロセスの進行中は、オンプレミス・データベースは引き続き動作しています。検証後に、アプリケーションをクラウド上の複製データベースに移行できます。

複製を準備する

移行プロセスには、次の前提条件が満たされています。
  • OCIノードからEZConnect文字列を介してオンプレミス・データベースにアクセスするためのネットワーク・パス設定があることを確認します。
  • オンプレミス・データベースがTDEで構成されている場合は、TDEウォレット・ファイル(ewallet.p12)をOCIノードにコピーし、ここでdbaascliコマンドを実行します。
  • 必要に応じて、OCIノードにOracleホームを作成します。Oracleホーム・バージョンは、ソースまたはそれ以上のRUバージョンと同じである必要があります。

必要なRPMの検証

このプロセスでは、23.3.2.0.0のdbaastools RPMバージョン以上が必要ですが、常に最新のdbaastools RPMに更新することをお薦めします。

  • 現在インストールされているバージョンを確認するには、次を実行します。
    dbaascli --version
    DBAAS CLI version 23.3.2.0.0
  • 最新のツールRPMをrootユーザーとして適用するには、次を実行します:
    # dbaascli admin updateStack

前提条件チェックを実行します。

前提条件チェックを実行するには、--executePrereqsコマンド・オプションを使用します。これは、実際のOracle Database複製を実行せずに、前提条件チェックのみを実行します。

dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --executePrereqs

データベースの複製

次のコマンドを使用してデータベースを複製します。

dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet>

例:

dbaascli database duplicate --sourceDBConnectionString xyzhost.oracle.com:1521/dbuniquename.oracle.com --dbName orcl --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_1 --sourceDBTDEWalletLocation /tmp/wallet_copy/tde --waitForCompletion false

このコマンドが正常に完了すると、データベースはクラウドに複製され、アプリケーションの使用状況の妥当性チェックの準備が整います。検証が完了すると、アプリケーション接続をクラウド・データベースに移行できます。

追加の構成オプションについては、dbaascli database duplicate –help を参照してください。

移行に関するいくつかの考慮事項

  • RMAN duplicateに複数のチャネルを割り当てる場合は、--rmanParallelism引数を指定して割り当てることができます。
  • Exadata Cloud Serviceは、データベース・メモリーを自動共有メモリー管理(ASMM)として構成します。オンプレミス・データベースが異なるメモリー管理で構成されている場合は、--sgaSizeInMBおよび--pgaSizeInMBの値を指定して、OCI側でメモリー・パラメータ値を適切に調整してください。
  • オンプレミス・データベースに非推奨または無効な初期化パラメータが含まれていないことを確認します。
  • データベース記憶域に関連するデータベース初期化パラメータ(データファイルの場所、REDOの場所、リカバリ領域の宛先、制御ファイルの多重化)は、--initParams引数を使用して変更できます。

    たとえば、複製データベースのdb_create_online_log_dest値をオーバーライドするには: --initParams db_create_online_log_dest_1=+DATAC1,db_create_online_log_dest_2=+RECOC1

データベースの複製のトラブルシューティング

  • dbaascli操作ログ・ファイルは、/var/opt/oracle/log/<dbname>/database/duplicateにあります。
  • 複製のジョブの1つは、dbcaを実行することです。そのログ・ファイルは、/u02/app/oracle/cfgtoollogs/dbcaおよび/u02/app/oracle/cfgtoollogs/dbca/<dbuniquename>にあります。

操作が失敗した場合、同じコマンドに--resume引数を指定して操作を再開するオプションがあります。または、dbaascli database delete –dbname <dbname> –forceを使用してデータベースをクリーン・アップしてから、データベース複製コマンドを再実行します。

リリース・ノート

dbaascliの様々なリリースで加えられた変更を確認します。

リリース25.1.1.0.0 (250220)

  • AHF 24.11.0を含む
  • syslens 24.4.2.0を含む
  • 様々なバグ修正および安定性の向上

リリース24.4.1.0.0 (241212)

  • AHF 24.9.1を含む
  • syslens 24.3.3.1を含む
  • 様々なバグ修正および安定性の向上

リリース24.3.2.0.0 (240912)

  • AHFバージョン24.7が含まれます
  • syslensバージョン24.3.1.0が含まれます
  • 様々なバグ修正および安定性の向上

リリース24.3.1.0.0 (240730)

  • 19cリリースへのデータベース・アップグレード時のsqlnet.oraからwallet_rootへのTDE移行
  • デフォルト・モードとしてイメージベースのパッチ適用を使用するためのグリッド・パッチのインプレース
  • AHFバージョン24.6.1が含まれます
  • syslensバージョン24.1.2.0が含まれます
  • 様々なバグ修正および安定性の向上

リリース24.2.1.0.0 (240620)

  • Oracle Database 23aiのサポートが追加されました。
  • AHFバージョン24.4.3が含まれます
  • syslensバージョン24.1.2.0が含まれます
  • 様々なバグ修正および安定性の向上。

リリース24.1.2.0.0 (240327、240424、240502)

  • AHFバージョン24.1.1が含まれます
  • syslensバージョン2.6.8.0が含まれます。
  • 様々なバグ修正および安定性の向上

リリース24.1.0.0 (240118、240219)

  • AHFバージョン23.11.1が含まれます
  • syslensバージョン2.6.4.3が含まれます。
  • 様々なバグ修正および安定性の向上
  • (240219) DBCSエージェント・バージョン21.2以前に適用可能なバグ36309260の修正: OCIコントロール・プレーンとDBCSエージェント間の通信が一部のVMでは機能しません。

リリース23.4.1.0.0 (231219)

  • AHFバージョン23.9.5が含まれます
  • syslensバージョン2.6.4.2が含まれます。
  • 様々なバグ修正および安定性の向上

リリース23.3.2.0.0 (231115)

  • プラガブル・データベース操作
    • 作成およびクローニング操作中にOCI Vaultのカスタム・キー・バージョンOCID (Bring Your Own Key - BYOK)を設定するためのサポートが追加されました。詳細は、それぞれのPDBコマンドのヘルプを参照してください。
  • Grid Infrastructure (GI)パッチ適用
    • パッチ適用ワークフローが強化され、特にデータベース数が多い環境でのパッチ適用時間が短縮されました。
    • リモート・ノードへのパッチ適用をパラレルに実行するために使用できる新しいオプション--patchInParallelが導入されました。
  • データベースのパッチ
    • クラスタの特定のノードでdatapatchを実行するオプションが用意されています。
  • AHFバージョン23.7.7が含まれます
  • syslensバージョン2.3.6.10が含まれます
  • 様々なバグ修正および安定性の向上

リリース23.3.1.0.0 (230817、231020)

  • 新しいdbaascliコマンド
    • dbaascli gridHome create - このコマンドを使用して、サポートされているバージョンのGrid Infrastructureホームを作成できます。詳細は、dbaascli gridHome create --helpを参照してください。
    • dbaascli system getGridHomes - このコマンドは、システムで使用可能なGrid Infrastructureホームの詳細を提供します。詳細は、dbaascli system getGridHomes --helpを参照してください。
  • プラガブル・データベース操作
    • リフレッシュ可能なプラガブル・データベース・ライフサイクルの分野の改善。
  • データベースのバックアップおよびリカバリ
    • Data Guard構成の場合にスタンバイ・サイトでバックアップを構成するためのサポートが追加されました。バックアップ構成はData Guardサイト固有です。つまり、ロールの変更(Data Guardスイッチオーバー操作など)は、プライマリ・サイトまたはスタンバイ・サイトでのデータベースのバックアップ操作に影響しません。バックアップは、プライマリ・サイトまたはスタンバイ・サイトで構成されている場合、ロールの変更に関係なく続行されます。
    • AHFバージョン23.5.2 - リリース23.3.1.0.0 (230817)を含む
    • AHFバージョン23.5.4 - リリース23.3.1.0.0 (231020)を含む
  • syslensバージョン2.3.6.9が含まれます
  • 様々なバグ修正および安定性の向上
  • 追加の重要な製品修正(231020)

リリース23.2.1.0.0 (230708、230724)

  • データベース・ライフサイクル関連の改善
    • 期限切れのTCPS証明書を削除するdbaascli grid removeTCPSCertが導入されました。詳細は、dbaascli grid removeTCPSCert --helpを参照してください。
    • データベースの複製中に特定のPDBを除外するオプションが追加されました。詳細は、dbaascli database duplicate --helpskipPDBs引数を参照してください。
  • データベースのバックアップおよびリカバリ
    • OSSバックアップのFILES_PER_SETのデフォルトを64に変更しました。これは、dbaascli database backup --configureを使用して変更できます。詳細は、dbaascli database backup --helpを参照してください。
    • データ・ガード環境でのロール・スイッチオーバー後も、アーカイブ・ログのバックアップはスタンバイ・サイトから続行されます。
    • Oracleで管理されていないバックアップの場合、L0およびL1バックアップのスケジュールはデフォルトでは作成されません。dbaascli database backup --configureコマンドを使用して明示的に作成する必要があります。
    • AHFバージョン23.3.4 - リリース23.2.1.0.0 (230708)を含む
    • AHFバージョン23.3.5 - リリース23.2.1.0.0 (230724)を含む
  • 様々なバグ修正および安定性の向上

リリース23.1.2.0.0 (230411、230616)

  • データベース・ライフサイクル関連の改善
    • オブジェクト・ストアにデータベース・テンプレート(DBCAテンプレート)を作成するオプションが追加されました。その後、DBCAテンプレートを使用してデータベースを作成できます。詳細は、dbaascli database createTemplate --helpを参照してください
  • プラガブル・データベース操作
    • 手動リフレッシュ・オプションを使用して作成されたプラガブル・データベースをリフレッシュするために、dbaascli pdb refreshが導入されました。詳細は、dbaascli pdb refresh --helpを参照してください。
    • リフレッシュ可能プラガブル・データベースを通常のプラガブル・データベースに変換するオプションが追加されました。詳細は、dbaascli pdb open --helpを参照してください。
    • リフレッシュ可能プラガブル・データベースを作成するには、ソース・プラガブル・データベースへのデータベース・リンクを作成するために、既存のソース・データベース・ユーザーが必要になりました。詳細は、dbaascli pdb remoteClone --helpdblinkUserName引数を参照してください。
  • AHFバージョン23.2.0が含まれます
  • 様々なバグ修正および安定性の向上

リリース23.1.1.0.1 (230302)

  • データベース・ライフサイクル関連の改善
    • 暗号化キー管理にOCIボールト・サービスを使用するソース・データベースから複製データベースを作成するためのサポートが追加されました。
  • AHFバージョン22.2.5が含まれます
  • 様々なバグ修正および安定性の向上

リリース22.4.1.0.1 (221214)

  • プラガブル・データベース操作
    • 再配置の終了時にPDBをオープンしないオプションが追加されました。詳細は、dbaascli pdb relocate --helpskipOpenPDB引数を参照してくださいこのオプションを使用した後、completePDBRelocate引数を使用してコマンドを実行すると、PDBの再配置を完了できます。
    • ソースの場所に再配置されたPDBメタデータ/サービスをクリーンアップするオプションが追加されました。詳細は、dbaascli pdb delete --helpcleanupRelocatedPDB引数を参照してください
  • 新しいdbaascliコマンド
    • dbaascli database createTemplate - このコマンドを使用すると、後でデータベースの作成に使用できるデータベース・テンプレート(DBCAテンプレート)を作成できます。DBCAテンプレートは、Oracle Databaseサーバー・ソフトウェアに付属のツールであるDBCAを使用してクローン・データベースを作成するために広く使用されています。詳細は、dbaascli database createTemplate --helpを参照してください
    • データベース暗号化のマスター・キーをローテーションするdbaascli tde rotateMasterKeyが導入されました。詳細は、dbaascli tde rotateMasterKey --helpを参照してください。コマンドdbaascli tde rotate masterkeyは現在非推奨です。
  • データベース・ライフサイクル関連の改善
    • データベース作成ワークフローでDBCAテンプレートを使用するためのサポートが追加されました。詳細は、dbaascli database create --helpdbcaTemplateFilePath引数を参照してください
    • 複製データベース作成のパフォーマンスが向上しました。複製データベースの作成方法の詳細は、dbaascli database duplicate --helpを参照してください
    • TDE暗号化されていないソース・データベースから複製データベースを作成するためのサポートが追加されました。
  • TDE管理
    • データベース暗号化のマスター・キーをローテーションするdbaascli tde rotateMasterKeyが導入されました。詳細は、dbaascli tde rotateMasterKey --helpを参照してください。コマンドdbaascli tde rotate masterkeyは現在非推奨です。
    • すべてのTDE操作のワークフローが改良されました。詳細は、dbaascli tde --helpを参照してください
  • Grid Infrastructure (GI)パッチ適用
    • ノードでのパッチ適用操作のパラレル実行を可能にするためのサポートが追加されました。このオプションを使用すると、データベースの可用性が低下するため、慎重に実行する必要があります。
  • データベースのバックアップおよびリカバリ
    • スタンドアロン・バックアップからデータベースを作成するためのワークフローが改良されました
  • AHFバージョン22.2.4の組込み
  • 様々なバグ修正および安定性の向上

リリース22.3.1.1.0 (221003)

  • 新しいdbaascliコマンド
    • dbaascli database getDetails - このコマンドは、特定のデータベースの詳細情報(dbname、ノード情報、プラガブル・データベース情報など)を表示します。詳細は、dbaascli database getDetails --helpを参照してください。
  • プラガブル・データベース操作
    • refreshablePDB引数を使用して、プラガブル・データベースをリフレッシュ可能クローンとして作成するためのサポートが追加されました。詳細は、dbaascli pdb remoteClone --helpを参照してください
  • 様々なバグ修正および安定性の向上

リリース22.3.1.0.1 (220831)

  • 新しいデータベース・ライフサイクル・コマンド
    • dbaascli database addInstance - このコマンドを使用して、データベースがまだ構成されていないクラスタのノードの1つにデータベース・インスタンスを追加できます。詳細は、dbaascli database addInstance --helpを参照してください。
    • dbaascli database deleteInstance - このコマンドを使用して、データベースが構成されているクラスタのノードの1つからデータベース・インスタンスを削除できます。詳細は、dbaascli database deleteInstance --helpを参照してください。
    • dbaascli database duplicate - このコマンドを使用して、クラスタ内、またはクラスタ間にネットワーク接続が存在する場合はクラスタ間で既存のデータベースから新しいデータベースを作成できます。詳細は、dbaascli database duplicate --helpを参照してください。
  • クラウド・ソフトウェア・ライブラリ
    • ソフトウェア・ライブラリからローカルのシステムにダウンロードされたイメージをリストするdbaascli cswlib listLocalコマンドが導入されました。詳細は、dbaascli cswlib listLocal --helpを参照してください。コマンドdbaascli dbimage listは非推奨になりました。
    • クラウド・ソフトウェア・ライブラリからダウンロードされたイメージを削除するためのdbaascli cswlib deleteLocalコマンドが導入されました。詳細は、dbaascli cswlib deleteLocal --helpを参照してください。コマンドdbaascli dbImage purgeは非推奨になりました。
  • コマンドdbaascli admin updateStackのログの場所は、他のdbaascliコマンドの規則に従って変更されました。ログは、/var/opt/oracle/log/admin/updateStackディレクトリの下にあります。前の場所は/var/opt/oracle/log/tooling/Updateでした。
  • dbaascliのヘルプはクラウド・プラットフォーム環境に対応し、動作中のクラウド環境に適用可能なコマンドの場合はヘルプ出力をリストするようになりました。
  • データガード環境でTDEパスワードを変更するためのサポートが追加されました。詳細は、dbaascli tde changePassword --helpを参照してください。このサポートは現在、11.2.0.4リリースでは使用できません。
  • AHFバージョン22.1.5が含まれます。
  • データベース・アップグレード操作のワークフローが改良されました。
  • データベース・ホーム作成操作のワークフローが改良されました。
  • 様々なバグ修正および安定性の向上

リリース22.2.1.1.0 (220713)

  • 新しいdbaascliコマンド:
    • dbaascli dbHome getDatabases - このコマンドは、特定のデータベースOracleホームから実行されているすべてのデータベースをリストします。出力はJSON形式で返されるため、自動化が容易になります。詳細は、dbaascli dbHome getDatabases --helpを参照してください。
    • dbaascli database getPDBs - このコマンドは、特定のコンテナ・データベースのすべてのプラガブル・データベースをリストします。出力はJSON形式で返されるため、自動化が容易になります。詳細は、dbaascli database getPDBs --helpを参照してください。
    • dbaascli dbHome delete - このコマンドは、特定のデータベースのOracleホームを削除します。詳細は、dbaascli dbHome delete --helpを参照してください。
    • dbaascli dataguard prepareStandbyBlob - このコマンドは、Data Guard環境のスタンバイ・サイトで必要な様々なファイルを含むBLOBファイルを生成します。詳細は、dbaascli dataguard prepareStandbyBlob --helpを参照してください。
  • Grid Infrastructure (GI)パッチ適用:
    • 最適化された新しいワークフロー
    • パッチ適用前にGrid Infrastructure (GI)ソフトウェア・イメージを作成する方法を導入しました。このGIイメージは、後でGIパッチ適用操作の実行に使用できます。この方法の利点は、イメージがすでに準備されているため、パッチ適用ウィンドウが短縮されることです。ノード上のGIスタックは、イメージを作成するために停止されません。詳細は、dbaascli grid patch --helpcreateImageオプションを参照してください
    • dbaascli grid patchコマンドのcreateImageオプションを使用して作成された、ユーザー指定のGIソフトウェア・イメージを使用してGrid Infrastructureパッチ適用を実行する方法が導入されました。詳細は、dbaascli grid patch --helpimageLocationオプションを参照してください。
  • Data Guard環境でのパスワード・サポートの変更:
    • Data Guard環境でパスワードを変更するためのサポートを追加しました。詳細は、dbaascli database changePassword --helpおよびdbaascli dataguard prepareStandbyBlob --helpを参照してください
  • Data Guard構成:
    • Data Guard自動化属性を更新するためのサポートが追加されました(/var/opt/oracle/dg/dg.confファイル内)。詳細は、dbaascli dataguard --helpを参照してください。
  • 様々なバグ修正および安定性の向上

リリース22.2.1.0.1 (220504)

  • 新しいdbaascliコマンド:
    • 顧客がダウンロードしてインストールできる最新バージョンのdbaastoolsを表示するためのdbaascli admin showLatestStackVersionが導入されました。dbaastools RPMのインストールは、コマンドdbaascli admin updateStackを使用して実行できます。詳細は、dbaascliコマンド・リファレンスの項を参照してください。
  • クラウド・ソフトウェア・ライブラリ:
    • BP (バンドル・パッチ)がRU (リリース更新)に置き換えられたため、BPのアクティブ化(dbaascli cswlib activateBP)のサポートは非推奨になりました。クラウド・デプロイメントでは、Image Tagsで識別されるソフトウェア・イメージの形式でRUを使用します。そのため、クラウド・ソフトウェア・ライブラリ(cswlib)コマンドとのインタフェースにはイメージ・タグを使用することをお薦めします。詳細は、dbaasscli cswlib download –helpを参照してください。
    • 非CDBデータベースを作成するために非CDBイメージをダウンロードする必要がなくなりました。ユーザーは、通常のイメージを使用して非CDBデータベースを作成できるようになりました。詳細は、dbaascli database create –helpcreateAsCDBオプションを参照してください。
  • 非CDBデータベースの作成:
    • 標準データベース・ソフトウェア・イメージを使用して非CDBデータベースを作成するようにデータベース作成ワークフローが拡張されました。詳細は、dbaascli database create –helpcreateAsCDBオプションを参照してください。
  • データベース・ホームのパッチ適用:
    • 最適化された新しいワークフロー
  • Grid Infrastructureのアップグレード:
    • 最適化された新しいワークフロー
  • プラガブル・データベース(PDB)の操作:
    • Data Guard環境でPDBを削除するには、追加の引数–allStandByPreparedを渡すことによって、スタンバイ・サイトで必要な操作が完了したことを示す明示的な確認が必要です。詳細は、dbaascli pdb delete --helpを参照してください。
  • データベースの再起動操作のローリング機能が提供されました。詳細は、dbaascli database bounce –helpを参照してください。
  • 様々なバグ修正および安定性の向上

リリース22.1.1.1.0 (220301)

  • 新しいdbaascliコマンド:
    • クラスタ上のすべてのデータベースOracleホームを取得するためのdbaascli system getDBHomesが導入されました。出力はJSON形式で返されるため、自動化が容易になります。
    • 特定のOracleホームの詳細情報を取得するためのdbaascli dbhome getDetailsが導入されました。出力はJSON形式で返されるため、自動化が容易になります。
  • クラウド・ソフトウェア・ライブラリ(cswlib):
    • クラウド・ソフトウェア・ライブラリのリスト操作に対するdbaascli cswlib listコマンドのサポートは非推奨になりました。新しいコマンドは、イメージをそのImageTagとともにリストするdbaascli cswlib showImagesです。クラウド・ソフトウェア・ライブラリからイメージをダウンロードするには、Image tagsを使用することをお薦めします。イメージ・タグを使用したダウンロードの詳細は、dbaascli cswlib download –helpを参照してください。
    • 様々なバグ修正および安定性の向上

リリース22.1.1.0.1 (220223)

  • Grid Infrastructureのアップグレード:
    • 最適化された新しいワークフロー
  • データベースのバックアップおよびリカバリ:
    • バックアップ・メタデータのメタデータ・リポジトリの内部更新
    • bkup_apiコマンドはdbaascliコマンドに置き換えられたため、その非推奨メッセージが導入されました。詳細は、dbaascli database backup --helpおよびdbaascli database recover –helpを参照してください
  • プラガブル・データベース(PDB)の操作:
    • PDBの再配置操作がサポートされるようになりました。詳細は、dbaascli pdb relocate –helpを参照してください。
    • 非CDBからPDBへの変換のワークフローが改良されました。詳細は、dbaascli database convertToPDB –helpを参照してください。
  • 暗号化キーの管理:
    • 透過的データ暗号化(TDE)ハートビート固有の初期化パラメータは、「顧客管理キー」のあるデータベースのクラウド推奨値に設定されます。
  • クラウド・ソフトウェア・ライブラリの管理:
    • imageTagsを介したアーティファクトのソフトウェア・ライブラリ・ダウンロードが改良されました。データベースおよびグリッド・ソフトウェア・イメージをダウンロードするには、imageTagsを使用することをお薦めします。詳細は、dbaascli cswlib showimagesおよびdbaascli cswlib download –helpを参照してください
  • AHFバージョン21.4.2が含まれます
  • 様々なバグ修正および安定性の向上

リリース21.4.1.1.0

  • dbaastoolsのこのバージョン以降で作成されるデータベースのシステム・レベル表領域(SYSTEMSYSAUXUNDOおよびTEMP)の暗号化が有効になりました。この機能は、Oracle Databaseバージョン19.6.0.0.0以上で有効です。
  • グリッドのパッチ適用:
    • gridユーザーが所有する次のファイル所有権をチェックするために前提条件が追加されました。
      • <gi_home>/suptools/tfa/release/tfa_home/jlib/jdev-rt.jar
      • <gi_home>/suptools/tfa/release/tfa_home/jlib/jewt4.jar
  • データベースのパッチ適用:
    • 同時database move操作はデフォルトで禁止されます。Oracle Databaseリリース12.2以上のデフォルト動作をオーバーライドするために使用できる新しいオプション–allowParallelDBMoveが導入されました。
    • MOUNTモードにあるスタンバイ・データベースの移動に関連する問題が修正されました。
  • データベースのバックアップおよびリカバリ:
    • データベース・バックアップの新しいコマンドライン・オプションが追加されました。詳細は、dbaascli database backupのコマンド・リファレンスを参照してください。
    • データベース・リカバリの新しいコマンドライン・オプションが追加されました。詳細は、dbaascli database recoverのコマンド・リファレンスを参照してください。
    • バックアップおよびリカバリ操作でのbkup_apiの使用は、今後は非推奨になります。
    • バックアップおよびリカバリ操作でSYSBACKUP管理権限を使用するというOracle推奨プラクティスに準拠するため、クラウド自動化によって、CDB$ROOTコンテナ・レベルでSYSBACKUPロールを持つ共通の管理ユーザーC##DBLCMUSERが作成されます。そのため、バックアップおよびリカバリ操作は、最小限必要な権限を持つユーザーを使用して実行されます。このユーザーの資格証明は、クラウド自動化によってランダムに生成され、安全に管理されます。ユーザーが見つからないか、LOCKEDおよびEXPIREDである場合、クラウド自動化によって、バックアップまたはリカバリ操作中にこのユーザーが再作成またはロック解除されます。クラウド自動化のこの変更は、dbaastoolsバージョン21.4.1.1.0以降に行われます。
  • 再開コマンドに–sessionID <value>引数を指定して前のセッションを再開するようにdbaascli resumeの機能が拡張されました。セッションIDは、dbaascli出力およびログで共有されます。
  • コマンドの使用方法を表示するようにdbaascli help出力が拡張されました。
  • dbaascliシェル(対話型セッション)の使用は非推奨になりました。これは、2022年3月より後は完全にサポート対象外になります。すべてのドキュメントの例で推奨されているとおり、コマンド・プロンプトで完全なdbaascliコマンドを実行することをお薦めします。
  • Autonomous Health Framework (AHF)バージョン21.2.8が含まれます。
  • 様々なバグ修正および安定性の向上。

リリース21.3.1.2.0

  • コントロール・プレーンのメタデータ同期ロジックの拡張により、dbaascli操作のタイミングが改善されました。
  • 関連付けられたスレッドとともにミリ秒レベルの情報を取得するようにdbaascliログが拡張されました。
  • データベース・ホームのパッチ適用およびデータベースの移動操作で、潜在的な障害シナリオを修正処理の推奨とともに取得するための追加の前提条件チェックが導入されました。
  • データベースのパッチ適用操作では、データベースの状態がパッチ適用前と同じ状態に保持されるようになりました。プラガブル・データベースでは、PDBの保存状態が適用されます。
  • 様々なバグ修正および安定性の向上。

リリース21.3.1.1.0

  • PDBの作成、localCloneまたはremoteClone操作の一部として、PDB管理ユーザー・アカウントのロック解除のサポートが追加されました。詳細は、dbaascli pdb create --helpのオプション--lockPDBAdminAccountを参照してください。
  • 既存の環境のOracle Grid Infrastructureに登録されているデータベース・リソースを、データベース名の正しい値で更新する問題が修正されました。
  • PDBライフサイクル操作が拡張されました。
  • 様々なバグ修正および安定性の向上。

リリース21.3.1.0.1

  • oracleユーザーとして実行される次のdbaascliコマンドのサポート。
    • dbaascli pdb bounce
    • dbaascli pdb close
    • dbaascli pdb connectString
    • dbaascli pdb create
    • dbaascli pdb delete
    • dbaascli pdb getDetails
    • dbaascli pdb list
    • dbaascli pdb localClone
    • dbaascli pdb open
    • dbaascli pdb remoteClone
  • データベースのアウトオブプレース・パッチ適用が改良されました。詳細は、dbaascli database move –helpを参照してください。
  • Oracle Grid Infrastructureのパッチ適用ワークフローのタイミング関連の拡張。詳細は、dbaascli grid patch –helpを参照してください。
  • パッチ適用操作のexadbcpatchmulti/dbaascli patchのサポートが非推奨になりました。データベース・ホームおよびOracle Grid Infrastructureのパッチ適用操作には、dbaascli dbhome patchおよびdbaascli grid patchコマンドが提供されます。詳細は、dbaascliを使用したOracle Grid InfrastructureおよびOracle Databaseへのパッチ適用の項を参照してください。dbaascliコマンド・リファレンスの項も参照してください。
  • dbaascliコマンド規則の一貫性を保つためにdbaascli tools patchコマンドのサポートは非推奨になりました。新しいコマンドは、dbaascli admin updateStackです。詳細は、dbaascliを使用したクラウド・ツールの更新の項を参照してください。
  • 長時間実行操作のために切断モードでdbaascliを実行する機能。--waitForCompletion falseを指定してdbaascliコマンドを実行すると、ジョブIDを取得できます。後でこれを問い合せて、操作のステータスを取得できます(dbaascli job getStatus –jobid job_idを使用)。これは、長時間実行操作でユーザーがコマンド実行の直後に制御を取り戻す場合に役立ちます。このリリースでは、このオプションはdbaascli database createコマンドでのみ使用できます。このサポートを得るために、後続のリリースでは別のコマンドも追加される予定です。これらのコマンドのヘルプ出力には、--waitForCompletionオプションのサポートが反映される予定です。
  • dbaascliシェルのサポートは非推奨になりました。すべてのドキュメントの例で推奨されているとおり、コマンド・プロンプトで完全なdbaascliコマンドを実行することをお薦めします。dbaascliシェルに入力するかわりに、dbaascliのみの実行で、その使用方法のヘルプの出力が表示されます。
  • 様々なバグ修正および安定性の向上。

リリース21.2.1.x.x

  • Oracle Grid Infrastructureのパッチ適用操作が再設計され、失敗した時点から再開する機能、ノードのサブセットに対するパッチ、インスタンス・ドレイン、およびその他の機能拡張が追加されました。詳細は、dbaascli grid patch --helpを参照してください。dbaascliを使用したOracle Grid InfrastructureおよびOracle Databaseへのパッチ適用の項も参照してください。
  • パッチ適用操作のexadbcpatchmulti/dbaascli patchのサポートが非推奨になりました。データベース・ホームおよびOracle Grid Infrastructureのパッチ適用操作には、dbaascli dbhome patchおよびdbaascli grid patchコマンドが提供されます。詳細は、dbaascliを使用したOracle Grid InfrastructureおよびOracle Databaseへのパッチ適用の項を参照してください。dbaascliコマンド・リファレンスの項も参照してください。
  • コマンド規則の一貫性を保つためにdbaascli tools patchコマンドのサポートは非推奨になりました。新しいコマンドは、dbaascli admin updateStackです。
  • 作成、ローカル・クローンおよびリモート・クローン操作のためのPDB管理APIが再設計されました。詳細は、dbaascli pdb --helpを参照してください。
  • データベース削除APIが再設計されました。詳細は、dbaascli database delete --helpを参照してください。
  • dbhomeの作成が改良されました(カスタム・ソフトウェア・イメージのサポート、スケールアウト操作)。詳細は、dbaascli dbhome create --helpを参照してください。
  • クラスタ・ノードのサブセットでのデータベース作成のサポート。詳細は、dbaascli database create --helpを参照してください。
  • 長時間実行操作のために切断モードでdbaascliを実行する機能。--waitForCompletion falseを指定してdbaascliコマンドを実行すると、ジョブIDを取得できます。後でこれを問い合せて、操作のステータスを取得できます(dbaascli job getStatus –jobid job_idを使用)。これは、長時間実行操作でユーザーがコマンド実行の直後に制御を取り戻す場合に役立ちます。このリリースでは、このオプションはdbaascli database createコマンドでのみ使用できます。このサポートを得るために、後続のリリースでは別のコマンドも追加される予定です。これらのコマンドのヘルプ出力には、--waitForCompletionオプションのサポートが反映される予定です。
  • skipPDBscontinueWithDowntimeなどの複数のオプションが導入され、dbhomeのパッチ適用の操作性が向上しました。詳細は、dbaascli dbhome patch --helpを参照してください。
  • より優れた診断収集のサポート。詳細は、dbaascli diag collect --helpを参照してください。
  • データベース・アップグレード自動化の領域の軽微な改善。
  • 様々なバグ修正および安定性の向上。

dbaascliコマンド・リファレンス

データベースを作成してクラウド自動化フレームワークと統合するには、dbaascliを使用する必要があります。

dbaascliは、DBCAテンプレートを入力として使用し、DBCAの機能をコールしてデータベースを作成してから、OCI APIをコールしてデータベースをクラウド自動化フレームワークに統合できるクラウド・ネイティブ・インタフェースです。現在スクリプトでDBCAを使用している顧客は、DBCAのかわりにdbaascliをコールするように既存のスクリプトを更新できます。DBCAの特定の機能がdbaasclで使用できないためにdbaascliを使用できない場合は、その機能をdbaascliに追加することを求めるMy Oracle Support (MOS)リクエストを開く必要があります。

管理と構成

この項では、Oracle Database環境を管理および構成するための重要なタスクについて説明します。これには、dbaastools RPMをインストールまたは更新するためのdbaascli admin updateStackや、特定のジョブのステータスをチェックするためのdbaascli job getStatusなどのコマンドが含まれます。

dbaascli admin updateStack

dbaastools RPMをインストールまたは更新するには、dbaascli admin updateStackコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

このユーティリティを使用するには、Exadata Database Service on Cloud@Customer仮想マシンに接続する必要があります。

SSHを使用した仮想マシンへの接続を参照してください。

構文

dbaascli admin updateStack 
[--resume]
[--prechecksOnly]
[--nodes]
説明:
  • --resumeは、前回の実行を再開します
  • --prechecksOnlyは、この操作の事前チェックのみを実行します
  • --nodesは、RPMをインストールするノードのカンマ区切りリストを指定します。この引数を渡さない場合、RPMはすべてのクラスタ・ノードにインストールされます

FAQ

Q: dbaascli admin updateStackコマンドは何に使用されますか。

A: dbaascli admin updateStackコマンドは、Exadata Cloud Infrastructureでdbaastools RPMをインストールまたは更新するために使用します。

Q: dbaascli admin updateStackコマンドを使用するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行し、Exadata Cloud Infrastructure仮想マシンに接続する必要があります。

Q: --resumeオプションは何を行いますか?

A: --resumeオプションは、updateStackコマンドが中断または不完全であった場合に、前回の実行を再開します。

Q: --prechecksOnlyオプションの目的は何ですか。

A: --prechecksOnlyオプションは、インストールまたは更新を実際に実行せずに、操作の事前チェックのみを実行します。

Q: --nodesパラメータの使用方法

A: --nodesパラメータは、RPMをインストールするノードのカンマ区切りリストを指定します。指定しない場合、RPMはすべてのクラスタ・ノードにインストールされます。

Q: dbaascli admin updateStackコマンドで問題が発生した場合はどうすればよいですか。

A: rootユーザーとしてコマンドを実行しており、Exadata Cloud Infrastructure仮想マシンに接続していることを確認します。特定のエラー・メッセージがあるかどうかを確認し、必要に応じてコマンド・ドキュメントまたはOracleサポートを参照してください。

Q: Exadata Cloud Infrastructure仮想マシンに接続してdbaascli admin updateStackコマンドを使用するにはどうすればよいですか。

A: 仮想マシンに接続するにはSSHを使用する必要があります。詳細な手順については、ドキュメントのSSHを使用した仮想マシンへの接続に関するセクションを参照してください。

ユースケースの例

例1: すべてのノードでのdbaastools RPMのインストールまたは更新

dbaascli admin updateStack

Exadata Cloud@Customer環境のすべてのノードでdbaastools RPMをインストールまたは更新します。

例2: RPMをインストールまたは更新する前にのみ事前チェックを実行する

dbaascli admin updateStack --prechecksOnly

実際にインストールを実行せずに、dbaastools RPM更新の事前チェックのみを実行します。更新を続行する前に、すべての前提条件が満たされていることを確認します。

例3: 以前に中断されたupdateStack操作の再開

dbaascli admin updateStack --resume

中断されたか、正常に完了しなかった以前のdbaastools RPM更新操作を再開します。

例4: 特定のノードでのdbaastoolsのインストールまたは更新

dbaascli admin updateStack --nodes node1,node2

クラスタ内の他のノードに影響を与えずに、指定されたノードnode1およびnode2にのみdbaastools RPMをインストールまたは更新します。

例5: 特定のノードでのupdateStackプロセスの再開

dbaascli admin updateStack --resume --nodes node3,node4

前の実行が中断された場合のみ、特定のノードnode3およびnode4でdbaastoolsの更新プロセスを再開します。

dbaascli job getStatus

指定したジョブのステータスを表示するには、dbaascli job getStatusコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

このユーティリティを使用するには、Exadata Cloud@Customer仮想マシンに接続する必要があります。

SSHを使用した仮想マシンへの接続を参照してください。

構文

dbaascli job getStatus --jobID
説明:
  • --jodIDは、ジョブIDを指定します

FAQ

Q: dbaascli job getStatusコマンドは何に使用されますか。

A: dbaascli job getStatusコマンドを使用してステータスを表示します。

ユースケースの例

例1: ジョブIDを使用した特定のジョブのステータス確認

dbaascli job getStatus --jobID 12345

IDが12345のジョブのステータスを確認します。出力には、ジョブの現在の状態(進行中、完了、失敗など)が表示されます。

例2: ジョブIDを使用したパッチ適用ジョブのステータス確認

dbaascli job getStatus --jobID 98765

IDが98765のパッチ適用ジョブのステータスを取得して、パッチが正常に適用されたか、まだ実行中であるかを確認します。

例3: データベース・バックアップ・ジョブのステータスを確認する

dbaascli job getStatus --jobID 45678

IDが45678のデータベース・バックアップ・ジョブのステータスを確認します。出力には、バックアップの進行状況または完了に関する詳細が表示されます。

例4: 長時間実行されるジョブの進行状況の確認

dbaascli job getStatus --jobID 23456

長時間実行ジョブ(ID 23456)の進行状況を確認して、ジョブがまだ実行中であるか終了しているかを確認します。

例5: データベース作成ジョブのステータスの表示

dbaascli job getStatus --jobID 67890

ジョブID 67890で識別されるデータベース作成ジョブのステータスを確認します。

CPUスケーリング

この項では、VMクラスタ内のCPUリソースの調整に焦点を当てます。これには、現在または過去のスケーリング・リクエストのステータスをチェックするdbaascli cpuscale get_statusや、仮想マシンに割り当てられるCPUコアの数を増減するdbaascli cpuscale updateなどのコマンドが含まれ、ワークロードの要求に基づいた柔軟なリソース管理が可能になります。

dbaascli cpuscale get_status

コントロール・プレーン・サーバーとOCIリージョン間のネットワーク接続が中断されたときに、現在または最後に実行されたスケール・リクエストのステータスを確認するには、dbaascli cpuscale get_statusコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

このユーティリティを使用するには、Exadata Cloud@Customer仮想マシンに接続する必要があります。

SSHを使用した仮想マシンへの接続を参照してください。

構文

scheduledrunningから最後のsuccessまたはfailureまで、進行状況に応じて様々なコマンド実行状態を表示します。
dbaascli cpuscale get_status

FAQ

Q: dbaascli cpuscale get_statusコマンドは何に使用されますか。

A: dbaascli cpuscale get_statusコマンドは、特にコントロール・プレーン・サーバーとOCIリージョン間のネットワーク接続が中断された場合、現在または最後のCPUスケール・リクエストのステータスを確認するために使用されます。

Q: dbaascli cpuscale get_statusコマンドを使用するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行し、Exadata Cloud@Customer仮想マシンに接続する必要があります。

Q: dbaascli cpuscale get_statusコマンドの実行中に問題が発生した場合はどうすればよいですか。

A: rootユーザーとしてコマンドを実行し、Exadata Cloud@Customer仮想マシンに接続していることを確認します。問題が続く場合は、コマンドドキュメントを参照するか、Oracleのサポートを探します。

Q: コマンドに障害のステータスが表示された場合はどうなりますか。

A: コマンドに障害ステータスが表示されている場合は、詳細なログでエラー・メッセージを確認し、特定のエラーに基づいてトラブルシューティングします。ネットワークの問題に対処したり、スケール・リクエストの詳細を確認することが必要な場合があります。

ユースケースの例

例1: 最新のCPUスケーリング操作のステータスの確認

dbaascli cpuscale get_status

現在または最後のCPUスケーリング・リクエストのステータスを確認します。スケーリングがスケジュールされているか、実行中であるか、成功または失敗で完了したかに関する情報を提供します。

例2: スケーリング・リクエストが失敗した後のステータスの確認

スケーリング操作がリクエストされましたが、コントロール・プレーン・サーバーとOCIリージョン間でネットワークの問題が発生しました。

dbaascli cpuscale get_status

スケーリング・リクエストのステータスを確認します。ネットワークの問題によりスケーリング・プロセスが失敗したため、出力には障害状態に関する詳細が表示されます。

例3: スケーリングが進行中の場合のステータスの確認

CPUスケーリング操作が進行中で、ユーザーはその進行状況を監視しようとしています。

dbaascli cpuscale get_status

現在のステータスをチェックし、スケーリング・リクエストが実行中状態であることを示します。これにより、ユーザーは操作を完了または失敗するまで追跡できます。

例4: スケーリングが正常に完了した後のステータスの確認

スケーリング操作が実行され、正常に完了しました。

dbaascli cpuscale get_status

ステータスをチェックし、スケーリング操作が正常に完了したことを確認します。最終状態は「成功」と報告されます。

dbaascli cpuscale update

コントロール・プレーン・サーバーとOCIリージョン間のネットワーク接続が中断されたときに、VMクラスタ内の仮想マシンのCPUコア数をスケール・アップまたはスケール・ダウンするには、dbaascli cpuscale updateコマンドを使用します。

前提条件

切断モードでVMクラスタのOCPUをスケール・アップまたはスケール・ダウンするには、VMクラスタ内の任意のノードからdbaascli cpuscale updateおよびdbaascli cpuscale get_statusコマンドを実行して、そのクラスタのCPUコア数を変更します。複数のVMクラスタがある場合は、スケール・アップまたはスケール・ダウンする各VMクラスタ内の任意のノードから個別のコマンドを実行します。これらのコマンドは、通常接続モード中に発行された場合は機能しないように設計されており、600秒(10分)後にタイムアウトします。

rootユーザーとしてコマンドを実行します。

このユーティリティを使用するには、Exadata Cloud@Customer仮想マシンに接続する必要があります。

SSHを使用した仮想マシンへの接続を参照してください。

構文

Oracle Cloud Infrastructure (OCI)で実行されているDBaaSコントロール・プレーンとの接続が失われた場合、Exadata Database Service on Cloud@Customerは切断モードであるとみなされます。

dbaascli cpuscale update --coreCount coreCount --message message
説明:
  • --coreCountは、クラスタ内の各VMに対してスケール・アップまたはスケール・ダウンするCPUのターゲット数を指定します
  • --messageは、オプションで参照用のメッセージを含めることができます

FAQ

Q: dbaascli cpuscale updateコマンドは何に使用されますか。

A: dbaascli cpuscale updateコマンドは、コントロール・プレーン・サーバーとOracle Cloud Infrastructure (OCI)間のネットワーク接続が中断されたときに、VMクラスタ内の仮想マシンに対するCPUコア数をスケール・アップまたはスケール・ダウンするために使用されます。

Q: dbaascli cpuscale updateコマンドを使用するための前提条件は何ですか。

A: このコマンドを使用する前に、切断モードで実行していることを確認してください。つまり、OCI上のDBaaSコントロール・プレーンとの接続が失われます。VMクラスタ内の任意のノードからコマンドを実行し、接続モードで使用した場合、600秒(10分)後にタイムアウトすることに注意してください。コマンドは、rootユーザーとして実行する必要があります。

Q: このコマンドを使用するには、仮想マシンに接続する方法を教えてください。

A: dbaascli cpuscale updateコマンドを使用するには、SSHを使用してExadata Cloud@Customer仮想マシンに接続する必要があります。詳細な手順は、「SSHを使用した仮想マシンへの接続」を参照してください。

Q: コマンドで--coreCountオプションは何を指定しますか。

A: --coreCountオプションは、クラスタ内の各VMに対してスケール・アップまたはスケール・ダウンするCPUのターゲット数を指定します。

Q: dbaascli cpuscale updateコマンドでメッセージを含めることはできますか。

A: はい、参照に--messageオプションを使用してオプションのメッセージを含めることができます。

Q: CPUスケール操作のステータスを確認するにはどうすればよいですか?

A: CPUスケール操作のステータスを確認するには、dbaascli cpuscale get_statusコマンドを使用します。これは、VMクラスタ内の任意のノードからも実行する必要があります。

Q: 接続モードでdbaascli cpuscale updateコマンドを実行するとどうなりますか。

A: このコマンドは、接続モードで動作しないよう設計されており、600秒(10分)後にタイムアウトします。切断モードでのみ使用してください。

Q: 複数のVMクラスタのCPUコアをスケーリングするにはどうすればよいですか。

A: 複数のVMクラスタがある場合は、dbaascli cpuscale updateコマンドを、スケール・アップまたはスケール・ダウンする各VMクラスタ内の任意のノードとは別に実行する必要があります。

ユースケースの例

例1: CPUコアを20にスケール・アップする

VMクラスタは16コアで実行されており、20に増やしたいと考えています。

dbaascli cpuscale update --coreCount 20 --message "Scaling up for increased demand"

CPUコア数を20までスケーリングし、参照用に「需要の増加に応じてスケール・アップ」というメッセージを含めます。

例2: CPUコアを8にスケール・ダウン

VMクラスタは現在12コアを使用していますが、リソースを保存するためにカウントを8に減らしたいと考えています。

dbaascli cpuscale update --coreCount 8 --message "Reducing CPU for maintenance period"

CPUコアの数を8に減らし、スケーリング操作が実行された理由に関する今後の参照のためのメッセージを提供します。

例3: メッセージなしでのCPUのスケーリング

CPUコアを32から24にスケーリングする必要がありますが、追加のメッセージは必要ありません。

dbaascli cpuscale update --coreCount 24

このコマンドは、メッセージなしでコア数を24にスケールダウンします。この操作は、アクションのデフォルトのロギングで実行されます。

例4: CPUのスケーリング後のステータスの確認

スケーリング・コマンドを実行した後、更新が成功したかどうかを確認します。

dbaascli cpuscale get_status

現在または最後のスケーリング・リクエストのステータスをチェックし、スケールアップまたはスケールダウン操作が成功したかどうかを確認できます。

例5: VMがすでに最大コア数に達している場合のスケーリングの試行

VMクラスタには、最大許容CPUコア(48)がすでにありますが、スケール・アップが試行されます。

dbaascli cpuscale update --coreCount 50 --message "Attempt to scale beyond limit"

VMクラスタが最大許容コア数を超えることはできないため、失敗します。ステータスには、50コアへのスケーリングを試行した後の障害が反映されます。

クラウド・ソフトウェア・ライブラリ(CSWLIB)の管理

この項では、Exadata Database Service on Cloud@Customer環境でソフトウェア・イメージを管理するためのツールを提供します。dbaascli cswlib deleteLocalなどのコマンドではローカル・イメージを削除できます。dbaascli cswlib downloadでは新しいソフトウェア・イメージをダウンロードできます。dbaascli cswlib listLocalを使用して使用可能なイメージをローカルに表示したり、dbaascli cswlib showImagesを使用して使用可能なすべてのデータベースおよびGrid Infrastructureイメージを確認することもできます。これらのコマンドは、ソフトウェアライブラリを効率的に管理および維持するのに役立ちます。

dbaascli cswlib deleteLocal

ローカル・イメージを削除するには、dbaascli cswlib deleteLocalコマンドを使用します。

rootユーザーとしてコマンドを実行します。

構文

dbaascli cswLib deleteLocal --imageTag <value>

説明:

  • --imageTagは、Oracleホーム・イメージ・タグを指定します

FAQ

Q: dbaascli cswlib deleteLocalコマンドの目的は何ですか。

A: dbaascli cswlib deleteLocalコマンドは、ローカルOracleホーム・イメージをシステムから削除するために使用します。

Q: dbaascli cswlib deleteLocalコマンドを実行するための前提条件は何ですか。

A: ローカル・イメージの削除に必要な権限が使用可能であることを確認するには、コマンドをrootユーザーとして実行する必要があります。

Q: 削除するローカル画像を指定するにはどうすればよいですか?

A: --imageTagオプションを使用して、削除するOracleホーム・イメージ・タグを指定します。

Q: コマンドで--imageTagオプションは何を表していますか。

A: --imageTagオプションは、削除するOracleホーム・イメージに関連付けられた識別子またはタグを表します。

Q: このコマンドを使用して複数のローカルイメージを一度に削除できますか?

A: いいえ。dbaascli cswlib deleteLocalコマンドでは、イメージ・タグで指定されたローカル・イメージを一度に1つのみ削除できます。

Q: --imageTagを指定せずにdbaascli cswlib deleteLocalコマンドを実行するとどうなりますか。

A: 削除するローカル・イメージを識別するために--imageTagが必要であるため、コマンドは失敗します。

Q: このコマンドで削除されたローカルイメージを復元することはできますか?

A: いいえ。dbaascli cswlib deleteLocalコマンドを使用してローカル・イメージを削除すると、リカバリできません。続行する前に、イメージ・タグを確認してください。

Q: dbaascli cswlib deleteLocalコマンドを使用する必要があるのはいつですか。

A: このコマンドは、領域を解放したり、環境をクリーン・アップするために、未使用または古いOracleホーム・イメージをローカル・システムから削除する必要がある場合に使用します。

例7-4 dbaascli cswlib deletelocal

dbaascli cswlib deletelocal --imagetag 19.15.0.0.0
DBAAS CLI version MAIN
Executing command cswlib deletelocal --imagetag 19.15.0.0.0
Job id: 8b3e71de-4b81-4832-b49c-7f892179bb4f
Log file location: /var/opt/oracle/log/cswLib/deleteLocal/dbaastools_2022-07-18_10-00-02-AM_73658.log
dbaascli execution completed
dbaascli cswlib download

使用可能なソフトウェア・イメージをダウンロードして、Exadata Database Service on Cloud@Customer環境で使用できるようにするには、dbaascli cswlib downloadコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

このユーティリティを使用するには、Exadata Database Service on Cloud@Customer仮想マシンに接続する必要があります。

SSHを使用した仮想マシンへの接続を参照してください。

構文

dbaascli cswlib download --version | --imageTag
[--product]
説明:
  • --versionは、Oracleホーム・イメージのバージョンを指定します
  • --imageTagは、イメージのイメージ・タグを指定します
  • --productは、イメージ・タイプを指定します。有効な値: databaseまたはgrid

FAQ

Q: dbaascli cswlib downloadコマンドの目的は何ですか。

A: dbaascli cswlib downloadコマンドを使用して、使用可能なソフトウェア・イメージをダウンロードし、Exadata Cloud Infrastructureで利用できるようにします。

Q: dbaascli cswlib downloadコマンドを実行するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行する必要があります。また、Exadata Cloud Infrastructure仮想マシンに接続する必要があります。

Q: このコマンドに必要な仮想マシンに接続するにはどうすればよいですか?

A: SSHを使用してExadata Cloud Infrastructure仮想マシンに接続する必要があります。詳細な手順は、「SSHを使用した仮想マシンへの接続」のドキュメントに記載されています。

Q: コマンドで--versionオプションは何を指定しますか?

A: --versionオプションは、ダウンロードするOracleホーム・イメージのバージョンを指定します。

Q: dbaascli cswlib downloadコマンドで--imageTagオプションを使用するにはどうすればよいですか。

A: --imageTagオプションは、ダウンロードするソフトウェア・イメージのイメージ・タグを指定するために使用します。

Q: コマンドの--productオプションの目的は何ですか。

A: --productオプションは、ダウンロードするイメージのタイプを指定します。有効な値はdatabaseまたはgridです。

Q: データベースとグリッドの両方のイメージを同時にダウンロードできますか?

A: いいえ、--productオプションを使用してdatabaseまたはgridのいずれかを指定する必要があります。そのため、各ダウンロード操作は1つのタイプのイメージに固有です。

Q: バージョンやイメージタグを指定しないとどうなりますか?

A: ダウンロードする特定のソフトウェア・イメージを識別するために--versionまたは--imageTagオプションが必要なため、コマンドが失敗するか、必要な情報の入力を求められる可能性があります。

Q: --versionと--imageTagの両方を同時に指定する必要がありますか?

A: いいえ。通常、ダウンロードするイメージを識別する方法に応じて--versionまたは--imageTagのいずれかを指定しますが、両方を同時に指定することはできません。

Q: dbaascli cswlib downloadコマンドはいつ使用しますか。

A: このコマンドは、Exadata Cloud Infrastructure設定でdatabaseまたはgrid環境のOracleホーム・ソフトウェア・イメージをダウンロードする必要がある場合に使用します。

例7-5 dbaascli cswlib download --product --imageTag

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

例7-6 dbaascli cswlib download --version 19.9.0.0.0

dbaascli cswlib download --product database --imageTag 19.14.0.0.0
dbaascli cswlib listLocal

ローカルで使用可能なデータベースおよびGrid Infrastructureイメージのリストを表示するには、dbaascli cswlib listLocalコマンドを使用します。

rootユーザーとしてコマンドを実行します。

構文

dbaascli cswLib listLocal [--product <value>]

説明:

  • --productは、Oracleホームの製品タイプを示します。有効な値: databaseまたはgrid

FAQ

Q: dbaascli cswlib listLocalコマンドの目的は何ですか。

A: dbaascli cswlib listLocalコマンドは、システム上のローカルで使用可能なデータベースおよびGrid Infrastructureイメージのリストを表示するために使用します。

Q: dbaascli cswlib listLocalコマンドを実行するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行し、使用可能なイメージにアクセスしてリストするために必要な権限を持っている必要があります。

Q: このコマンドを使用して、リストするイメージのタイプを指定する方法を教えてください。

A: --productオプションを使用して、リストするOracleホーム・イメージのタイプを指定します。有効な値は、databaseまたはgridです。

Q: dbaascli cswlib listLocalコマンドで、--productオプションは何を表していますか。

A: --productオプションは、Oracleホームの製品タイプを識別し、使用可能なイメージのリストをdatabaseまたはgridタイプにフィルタできます。

Q: データベースとグリッドの両方のイメージを同時にリストできますか?

A: いいえ。--productオプションを使用すると、一度にdatabaseイメージまたはgridイメージをリストできます。両方のリストを表示するには、異なる--product値でコマンドを2回実行する必要があります。

Q: コマンドで--productオプションを指定しないとどうなりますか?

A: --productオプションを指定しない場合、コマンドはローカルで使用可能なすべてのイメージをリストするか、製品タイプを指定する必要がある場合があります。動作は、環境設定によって異なる場合があります。

Q: dbaascli cswlib listLocalコマンドはどのような場合に使用しますか。

A: このコマンドは、システムで現在ローカルで使用可能なデータベースまたはGrid Infrastructureイメージを確認する場合に使用します。

Q: リスト内のデータベース・イメージとグリッド・イメージを区別するにはどうすればよいですか。

A: --productオプションを使用するとリストをフィルタできるため、databaseまたはgridを指定すると、その製品タイプに関連するイメージのみが表示されるため、区別しやすくなります。

Q: dbaascli cswlib listLocalコマンドの実行に関連するリスクはありますか。

A: いいえ、このコマンドは非破壊的で、ローカルで使用可能なイメージに関する情報のみを表示します。ファイルは変更または削除されません。

Q: このコマンドはリモートまたはクラウド保存イメージを表示しますか?

A: いいえ。dbaascli cswlib listLocalコマンドでは、リモートまたはクラウドに格納されているイメージではなく、システム上でローカルで使用可能なイメージのみが表示されます。

例7-7 dbaascli cswlib listlocal

dbaascli cswlib listlocal
DBAAS CLI version MAIN
Executing command cswlib listlocal
Job id: bc4f047c-0a34-4d4d-a1ea-21ddc2a9c627
Log file location: /var/opt/oracle/log/cswLib/listLocal/dbaastools_2022-07-18_10-29-53-AM_16077.log
############ List of Available Database Images  #############
1.IMAGE_TAG=12.2.0.1.220419
  IMAGE_SIZE=5GB
  VERSION=12.2.0.1.220419
  DESCRIPTION=12.2 APR 2022 DB Image
2.IMAGE_TAG=18.16.0.0.0
  IMAGE_SIZE=6GB
  VERSION=18.16.0.0.0
  DESCRIPTION=18c OCT 2021 DB Image
3.IMAGE_TAG=19.14.0.0.0
  IMAGE_SIZE=5GB
  VERSION=19.14.0.0.0
  DESCRIPTION=19c JAN 2022 DB Image
dbaascli execution completed
dbaascli cswlib showImages

使用可能なデータベースおよびGrid Infrastructureイメージのリストを表示するには、dbaascli cswlib showImagesコマンドを使用します。

rootユーザーとしてコマンドを実行します。

構文

dbaascli cswlib showImages 
[--product]

説明:

  • --productは、Oracleホームの製品タイプを示します。有効な値: databaseまたはgrid

FAQ

Q: dbaascli cswlib showImagesコマンドの目的は何ですか。

A: dbaascli cswlib showImagesコマンドは、Oracle Exadata Database Service環境内でダウンロードまたは管理できる、使用可能なデータベースおよびGrid Infrastructureイメージのリストを表示するために使用します。

Q: dbaascli cswlib showImagesコマンドを実行するための前提条件は何ですか。

A: 使用可能なイメージを表示するために必要な権限があることを確認するには、コマンドをrootユーザーとして実行する必要があります。

Q: このコマンドでリストされた画像をフィルタするにはどうすればよいですか?

A: databaseまたはgridのいずれかで--productオプションを指定すると、イメージをフィルタ処理して、その製品タイプに関連するイメージのみをリストできます。

Q: dbaascli cswlib showImagesコマンドで、--productオプションは何を表していますか。

A: --productオプションは、Oracleホームの製品タイプを識別し、イメージのリストをデータベースまたはグリッドのいずれかにフィルタできます。

Q: 1つのコマンド実行でデータベース・イメージとグリッド・イメージの両方を表示できますか。

A: いいえ、異なる--product値(databaseおよびgrid)を使用してコマンドを2回実行して、両方のタイプのイメージを表示する必要があります。

Q: コマンドで--productオプションを指定しないとどうなりますか?

A: --productオプションを指定しない場合、コマンドは使用可能なすべてのイメージをリストするか、環境構成に応じて製品タイプを指定するよう求める場合があります。

Q: dbaascli cswlib showImagesコマンドはどのような場合に使用しますか。

A: このコマンドは、Oracle Exadata Database Service環境でダウンロードまたはデプロイメントに使用できるデータベースまたはGrid Infrastructureイメージのリストを表示する場合に使用します。

Q: dbaascli cswlib showImagesコマンドとdbaascli cswlib listLocalコマンドに違いはありますか。

A: はい。dbaascli cswlib showImagesには、ダウンロードまたは管理できる使用可能なイメージがすべてリストされ、dbaascli cswlib listLocalには、システムでローカルにダウンロードおよび使用可能なイメージのみがリストされます。

Q: このコマンドは、クラウドに格納されているイメージを表示するために使用できますか。

A: はい。このコマンドでは、ローカルに格納されているイメージのみでなく、Oracleのリポジトリからダウンロードできるイメージを表示できます。

Q: このコマンドでどのような種類の画像を見ることができますか?

A: ExadataプラットフォームでOracleデータベースを管理および実行するために不可欠なコンポーネントであるOracle DatabaseおよびGrid Infrastructureに関連するイメージを表示できます。

例7-8 dbaascli cswlib showImages

dbaascli cswlib showImages

データベース管理

この項では、Oracle Databasesを管理するための包括的なタスクについて説明します。これには、データベースの作成(dbaascli database create)、削除(dbaascli database delete)およびアップグレード(dbaascli database upgrade)用のコマンドが含まれます。その他の主要なタスクには、インスタンスの追加と削除(dbaascli database addInstancedbaascli database deleteInstance)、バックアップの管理(dbaascli database backup)、データベース・リカバリの処理(dbaascli database recover)などがあります。データベース・パラメータの変更、プラガブル・データベースの管理、データベースへのパッチ適用、非CDBデータベースのPDBへの変換を行うこともできます。これらのコマンドにより、データベース・ライフサイクル全体を効率的に制御できます。

dbaascli database addInstance

指定したノードにデータベース・インスタンスを追加するには、dbaascli database addInstanceコマンドを使用します。

前提条件

  • rootユーザーとしてコマンドを実行します。

構文

dbaascli database addInstance --dbname <value> --node <value> [--newNodeSID <value>]
説明:
  • --dbnameは、Oracle Database名を指定します
  • --nodeは、データベース・インスタンスのノード名を指定します
    • --newNodeSIDは、新規ノードに追加するインスタンスのSIDを指定します

FAQ

Q: dbaascli database addInstanceコマンドの目的は何ですか。

A: dbaascli database addInstanceコマンドは、Oracle Exadata Database Service環境の指定したノードに新しいデータベース・インスタンスを追加するために使用します。

Q: dbaascli database addInstanceコマンドを実行するための前提条件は何ですか。

A: データベース・インスタンスを追加するために必要な権限を持つには、rootユーザーとしてコマンドを実行する必要があります。

Q: このコマンドで--dbnameオプションは何を表していますか。

A: --dbnameオプションは、新しいインスタンスを追加するOracle Databaseの名前を指定します。

Q: dbaascli database addInstanceコマンドで使用される--nodeオプションは何ですか。

A: --nodeオプションは、新しいデータベース・インスタンスが追加されるノードの名前を指定します。

Q: このコマンドの--newNodeSIDオプションの目的は何ですか。

A: --newNodeSIDオプションを使用すると、指定したノードに作成される新しいデータベース・インスタンスのSID (システム識別子)を指定できます。

Q: 新しいインスタンスを追加する場合、--newNodeSIDオプションの指定は必須ですか。

A: --newNodeSIDオプションはオプションです。指定しない場合、Oracleは新しいデータベース・インスタンスのSIDを自動的に生成します。

Q: dbaascli database addInstanceコマンドはどのような場合に使用しますか。

A: このコマンドは、マルチノードのOracle Database設定で追加ノードに新しいインスタンスを追加してデータベースをスケーリングする場合に使用します。

Q: このコマンドを使用して、複数のデータベース・インスタンスを異なるノードに追加できますか。

A: はい。適切な--nodeおよび--dbname値を指定することで、コマンドを複数回実行して、異なるノードにデータベース・インスタンスを追加できます。

Q: --nodeオプションで指定されたノードが使用できない場合はどうなりますか?

A: 指定したノードが使用できないか到達可能でない場合、コマンドは失敗します。コマンドを実行する前に、ノードが正しく構成され、アクセス可能であることを確認してください。

Q: このコマンドはData Guard環境で使用できますか。

A: はい。Data Guard環境でdbaascli database addInstanceコマンドを使用してインスタンスを追加できますが、このような構成に必要なData Guardガイドラインに従うことをお薦めします。

Q: このコマンドを実行すると、データベースの停止時間が発生しますか。

A: 通常、新しいノードにインスタンスを追加しても、既存のデータベース・インスタンスの停止時間は発生しませんが、特定の依存関係がないか環境を確認することをお薦めします。

dbaascli database backup

バックアップ・ストレージ宛先でのOracle Databaseの構成、データベース・バックアップの取得、バックアップの問合せ、およびバックアップの削除を行うには、dbaascli database backupコマンドを使用します。

前提条件

  • rootユーザーとしてコマンドを実行します。

構文

dbaascli database backup --dbname <value>
        {
            --list
                {
                    [--backupType <value>]
                    | [--json <value>]
                }
            | --start [--level0] [--level1]
                {
                    [--archival --tag <value>]
                    | [--archivelog]
                }
            | --delete --backupTag <value>
            | --status --uuid <value>
            | --getBackupReport
                {
                    --tag <value>
                    | --latest
                }
                --json <value>
            | --configure
                {
                    --configFile <value>
                    | --enableRTRT
                    | --disableRTRT
                }
            | --getConfig [--configFile <value>]
            | --validate [--untilTime <value>]
            | --showHistory [--all]
        }
説明:
--dbname: Oracle Database name.
--list | --start | --delete | --status | --getBackupReport | --configure | --getConfig
--list: Returns database backup information.
    [--json: Specify the file name for JSON output.]
--start: Begins database backup.
        [--level0 | --level1 | --archival]
        [--level0: Creates a Level-0 (full) backup. ]
        [--level1: Creates a Level-1 (incremental) backup. ]
        [--archival: Creates an Archival full backup. ]
             --tag: Specify backup tag.
--delete: Deletes Archival backup.
            --backupTag <value>
--status
            --uuid <value>
--getBackupReport: Returns backup report.
            --tag: Specify backup tag.
            --latest: Returns latest backup report (all types of database backup).
            --json: Specify the file name for JSON output.
--configure: Configures database for backup.
            --configFile | --enableRTRT | --disableRTRT
            --configFile: Specify database backup configuration file.
            --enableRTRT: Enables Real Time Redo Transport.
            --disableRTRT: Disables Real Time Redo Transport.
--getConfig: Returns database backup configuration.
            [--configFile: Specify the database backup configuration file.]
--validate: Validates that backups are complete and corruption-free.
            [--untilTime: Validates from closest Level-0 (full) backup until time provided. Input format: DD-MON-YYYY HH24:MI:SS.]
--showHistory: Displays the history of backup operations.
            [--all: Displays all backup operations.]
ノート

enableRTRTおよびdisableRTRTは、Cloud@Customer上のExadata Database ServiceのZDLRAバックアップの保存先にのみ適用できます。

FAQ

Q: dbaascli database backupコマンドの目的は何ですか。

A: dbaascli database backupコマンドは、Oracle Databaseバックアップ・ストレージ宛先の構成、バックアップの取得、バックアップの問合せ、および既存のバックアップの削除に使用されます。

Q: dbaascli database backupコマンドを実行するための前提条件は何ですか。

A: バックアップ管理に必要な権限を得るには、rootユーザーとしてコマンドを実行する必要があります。

Q: このコマンドを使用してOracle Databaseの完全バックアップを開始するにはどうすればよいですか。

A: 完全バックアップ(Level-0)を開始するには、次の構文を使用します。

dbaascli database backup --dbname <value> --start --level0

Q: dbaascli database backupコマンドを使用して増分バックアップを実行するにはどうすればよいですか。

A: レベル1の増分バックアップを実行するには、次の構文を使用します。

dbaascli database backup --dbname <value> --start --level1

Q: レベル0とレベル1のバックアップの違いは何ですか。

A: レベル0のバックアップはデータベースの完全バックアップですが、レベル1のバックアップは、最後のレベル0またはレベル1のバックアップ以降に行われた変更のみを取得する増分バックアップです。

Q: このコマンドを使用してアーカイブ・バックアップを作成できますか。

A: はい。--archivalオプションと--startコマンドを使用して、アーカイブ・バックアップを作成できます。

dbaascli database backup --dbname <value> --start --archival --tag <backup_tag>

Q: 既存のアーカイブ・バックアップを削除するにはどうすればよいですか。

A: アーカイブ・バックアップを削除するには、次の構文を使用します。

dbaascli database backup --dbname <value> --delete --backupTag <tag_value>

Q: コマンドを使用して特定のバックアップのステータスを確認するにはどうすればよいですか?

A: --statusオプションを--uuidパラメータとともに使用すると、次のようにバックアップのステータスを確認できます。

dbaascli database backup --dbname <value> --status --uuid <backup_uuid>

Q: データベースのすべてのバックアップをリストするにはどうすればよいですか。

A: 特定のデータベースで使用可能なすべてのバックアップをリストするには、--listオプションを使用します。

dbaascli database backup --dbname <value> --list

JSON出力の場合は、--jsonオプションを追加します:

dbaascli database backup --dbname <value> --list --json <file_name>

Q: バックアップレポートを取得するにはどうすればよいですか?

A: --getBackupReportオプションを使用して、特定のタグまたは最新のバックアップ用にバックアップ・レポートを取得できます。

dbaascli database backup --dbname <value> --getBackupReport --tag <backup_tag> --json <file_name>

または、最新のレポートを取得するには:

dbaascli database backup --dbname <value> --getBackupReport --latest --json <file_name>

Q: データベースのバックアップ設定はどのように設定するのですか?

A: --configureオプションを使用して、バックアップ構成ファイルを指定するか、リアルタイムREDO転送(RTRT)を有効または無効にします。

dbaascli database backup --dbname <value> --configure --configFile <config_file>

RTRTを有効にするには:

dbaascli database backup --dbname <value> --configure --enableRTRT

Q: データベースの現在のバックアップ構成はどのように確認できますか。

A: 現在のデータベース・バックアップ構成を表示するには、--getConfigオプションを使用します。

dbaascli database backup --dbname <value> --getConfig

Q: dbaascli database backupコマンドで--validateオプションは何を行いますか。

A: --validateオプションは、バックアップが完了し、破損がないかどうかをチェックします。--untilTimeオプションを使用して時間範囲を指定できます。

dbaascli database backup --dbname <value> --validate --untilTime "DD-MON-YYYY HH24:MI:SS"

Q: データベースのすべてのバックアップ操作の履歴を表示するにはどうすればよいですか。

A: --showHistoryオプションを使用して、すべてのバックアップ操作の履歴を表示します。

dbaascli database backup --dbname <value> --showHistory

すべての操作を含む完全な履歴:

dbaascli database backup --dbname <value> --showHistory --all

Q: RTRT(Real-Time Redo Transport)オプションとは何ですか?また、いつ使用すればよいですか?

A: RTRTオプション(--enableRTRTおよび--disableRTRT)は、リアルタイムREDO転送の制御に使用されます。Exadata Cloud@Customer環境のZDLRA (Zero Data Loss Recovery Appliance)バックアップの保存先にのみ適用されます。RTRTを有効にして、リアルタイムREDOログの送信を確認します。

例7-9 例

  • アーカイブ・ログの保存期間を変更するには、次のステップに従います。
    dbaascli database backup --getConfig --dbname <dbname>

    これにより、バックアップ構成ファイル.cfgが生成されます。

    この構成ファイルでbkup_archlog_fra_retention値を更新します。

    configureコマンドを実行します:

    dbaascli database backup --configure --dbname <dbname> --configfile <config file generated above>
  • データベースmyTestDBのバックアップ構成を取得するには:
    dbaascli database backup --dbName myTestDB --getConfig --configFile /tmp/configfile_1.txt
  • 構成の詳細を含む構成ファイルを変更してデータベースmyTestDBのバックアップ構成を設定するには:
    dbaascli database backup --dbName myTestDB --configure --configFile /tmp/configfile_1_modified.txt
  • データベースmyTestDBのバックアップを取得するには:
    dbaascli database backup --dbName myTestDB --start
  • uuid 58fdcae0bd1c11eb92bc020017075151で送信されたバックアップ・リクエストのステータスを問い合せるには:
    dbaascli database backup --dbName myTestDB --status --uuid 58fdcae0bd1c11eb92bc020017075151
  • データベースmyTestDBに対してRTRTを有効にするには:
    dbaascli database backup --dbName myTestDB --configure —enableRTRT
dbaascli database bounce

指定したExadata Database Service on Cloud@Customerデータベースを停止して再起動するには、dbaascli database bounceコマンドを使用します。

前提条件

oracleユーザーとしてコマンドを実行します。

構文

dbaascli database bounce
[--dbname][--rolling <value>]
説明:
  • --dbnameは、データベースの名前を指定します
  • --rollingは、ローリング方式でデータベースを再起動するかどうかについてtrueまたはfalseを指定します。デフォルト値はfalseです。

このコマンドでは、データベースの停止が即時モードで実行されます。その後、データベースが再起動され、オープンされます。Oracle Database 12c以上では、すべてのPDBもオープンされます。

FAQ

Q: dbaascli database bounceコマンドの目的は何ですか。

A: dbaascli database bounceコマンドは、Exadata Cloud InfrastructureでOracle Databaseを停止して再起動するために使用します。データベースをローリング方式で再起動できるため、中断を最小限に抑えることができます。

Q: dbaascli database bounceコマンドを実行するための前提条件は何ですか。

A: コマンドは、oracleユーザーとして実行する必要があります。このユーザーには、データベースの停止と再起動に必要な権限があります。

Q: このコマンドで--dbnameオプションは何を指定しますか。

A: --dbnameオプションでは、停止して再起動するOracle Databaseの名前を指定します。

Q: dbaascli database bounceコマンドで使用される--rollingオプションは何ですか。

A: --rollingオプションは、データベースをローリング方式でバウンス(再起動)するかどうかを指定します。trueに設定すると、データベース・インスタンスが1つずつ再起動され、停止時間が最小限に抑えられます。デフォルト値はfalseで、すべてのインスタンスを一度に再起動します。

Q: 「データベースのバウンス」とはどういう意味ですか?

A: データベースをバウンスすると、データベースを停止してから再起動することになります。この操作は、メンテナンス、変更の適用または特定のタイプの問題からのリカバリに使用できます。

Q: dbaascli database bounceコマンドは正常な停止を実行しますか。

A: はい、このコマンドは即時モードで停止を実行します。これにより、データベースがクローズされ、コミットされていないトランザクションがロールバックされ、ユーザーの切断を待たずにロールバックされます。

Q: このコマンドは、Oracle 12c以降のデータベース内のすべてのPDBを自動的にオープンしますか。

A: はい。データベースがOracle Database 12c以降を実行している場合、このコマンドはデータベースの再起動後にすべてのプラガブル・データベース(PDB)を自動的にオープンします。

Q: dbaascli database bounceコマンドは、マルチノードまたはRAC (Real Application Clusters)環境で使用できますか。

A: はい。マルチノードまたはRAC環境では、--rollingオプションを使用してデータベース・インスタンスを1つずつ再起動し、停止時間を最小限に抑えることができます。

Q:--rollingオプションを指定しないとどうなりますか?

A: --rollingオプションが指定されていない場合、またはfalseに設定されている場合、コマンドはすべてのデータベース・インスタンスを同時に停止および再起動します。これにより、停止時間が短くなる可能性があります。

Q: dbaascli database bounceコマンドで--rollingオプションのデフォルト値はありますか。

A: はい。--rollingオプションのデフォルト値はfalseです。これは、特に指定がないかぎり、データベースが非ローリング方式でバウンスされることを意味します。

Q: ローリング・モードでデータベースを再起動するにはどうすればよいですか。

A: ローリング・モードでデータベースを再起動するには、次の構文を使用します。

dbaascli database bounce --dbname <value> --rolling true

Q: アクティブ・セッション中にdbaascli database bounceコマンドを実行することは安全ですか。

A: このコマンドでは、コミットされていないトランザクションをロールバックする即時停止が使用されますが、データベースをバウンスする前に、クリティカル・セッションまたはアクティブ・セッションがないことを確認することをお薦めします。

Q: このコマンドは、マルチテナント・データベース内の特定のPDBに使用できますか。

A: いいえ、dbaascli database bounceコマンドはデータベース全体に対して動作します。Oracle 12c以降では、コンテナ・データベース(CDB)をバウンスしてすべてのPDBをオープンしますが、個々のPDBをバウンスすることはできません。

Q: データベースがバウンスした後にオンラインに戻らない場合はどうすればよいですか?

A: データベースの再起動に失敗した場合は、停止または起動プロセス中にログでエラーがないか確認します。Oracleアラート・ログを調査すると、問題の原因を把握できます。

例7-10 dbaascli database bounce

dbaascli database bounce --dbname dbname
dbaascli database changepassword

指定したOracle Databaseユーザーのパスワードを変更するには、dbaascli database changePasswordコマンドを使用します。プロンプトが表示されたら、パスワードを変更するユーザー名を入力して、パスワードを入力します。

前提条件

rootまたはoracleユーザーとしてコマンドを実行します。

構文

dbaascli database changePassword [--dbname <value>] [--user <value>]
{
  [--prepareStandbyBlob <value> [--blobLocation <value>]] | [--standbyBlobFromPrimary <value>]
}
[--resume [--sessionID <value>]]
説明:
  • --dbnameは、操作するOracle Databaseの名前を指定します
  • --userは、パスワードの変更が必要なユーザー名を指定します
  • --prepareStandbyBlobは、trueを指定して、Data Guard環境でパスワードを変更するために必要なアーティファクトを含むBLOBファイルを生成します。有効な値: true|false
  • --blobLocationは、BLOBファイルが生成されるカスタム・パスを指定します
  • --standbyBlobFromPrimaryは、スタンバイBLOBファイルを指定します。このファイルはプライマリ・データベースから作成されます
  • --resumeは、前回の実行を再開するように指定します
    • --sessionIDは、特定のセッションIDを再開するように指定します

FAQ

Q: dbaascli database changePasswordコマンドは何を行いますか。

A: dbaascli database changePasswordコマンドを使用して、指定したOracle Databaseユーザーのパスワードを変更します。ユーザー名、次に新しいパスワードを入力するように要求されます。

Q: dbaascli database changePasswordコマンドを使用するための前提条件は何ですか。

A: データベース・ユーザーのパスワードを変更するには、rootまたはoracleユーザーとしてコマンドを実行する必要があります。

Q: このコマンドを使用するときにデータベースを指定する方法は?

A: --dbnameオプションを使用して、操作するOracle Databaseの名前を指定します。例:

dbaascli database changePassword --dbname <db_name>

Q: パスワードを変更するユーザを指定する方法は?

A: --userオプションを使用して、パスワードを変更する必要があるユーザー名を指定します。例:

dbaascli database changePassword --user <username>

Q: dbaascli database changePasswordコマンドの--prepareStandbyBlobオプションの目的は何ですか。

A: --prepareStandbyBlobオプションは、Data Guard環境で、スタンバイ・データベースでのパスワード変更に必要なアーティファクトを含むBLOBファイルを生成するために使用されます。これにより、Data Guard環境間でのパスワード同期が保証されます。

Q: --blobLocationオプションは何を指定しますか。

A: --blobLocationオプションを使用すると、スタンバイBLOBファイルを生成するカスタム・パスを指定できます。指定しない場合、ファイルはデフォルトの場所に保存されます。

Q: プライマリ・データベースから生成されたBLOBを使用して、スタンバイのパスワードを変更するにはどうすればよいですか。

A: --standbyBlobFromPrimaryオプションを使用して、プライマリ・データベースから準備されたBLOBファイルを指定して、パスワード変更をスタンバイ・データベースに適用できます。例:

dbaascli database changePassword --standbyBlobFromPrimary <blob_file_path>

Q: このコマンドで使用する--resumeオプションは何ですか?

A: --resumeオプションは、以前に中断されたパスワード変更操作を再開するために使用されます。必要に応じて、--sessionIDオプションを使用してセッションIDを指定できます。

Q: dbaascli database changePasswordコマンドを使用して特定のセッションを再開できますか。

A: はい。--resumeオプションを--sessionIDとともに使用して、セッションIDを指定して特定のパスワード変更セッションを再開できます。

Q: dbaascli database changePasswordコマンドはData Guard環境に適用できますか。

A: はい、そうです。--prepareStandbyBlobオプションを使用すると、Data Guard設定でパスワード変更がスタンバイ・データベースに伝播されるようにできます。

Q: --prepareStandbyBlobの使用時に--blobLocationを指定しないとどうなりますか?

A: --blobLocationが指定されていない場合、パスワード変更アーティファクトを含むblobファイルはデフォルトの場所に保存されます。

Q: dbaascli database changePasswordを使用して再開されたセッションのステータスを確認するにはどうすればよいですか。

A: --sessionIDオプションを使用してセッションIDを指定して、特定のセッションを再開できます。システムは、パスワードの変更で中断した場所を取得します。

Q: このコマンドは、通常のデータベースとData Guard環境の両方で使用できますか。

A: はい。このコマンドは、Data Guard環境の通常のOracle Databasesとデータベースの両方に対して機能します。Data Guard環境では、--prepareStandbyBlobなどの追加オプションを使用して、プライマリ・データベースとスタンバイ・データベースの両方でパスワード変更を管理できます。

例7-11 dbaascli database changePassword

dbaascli database changepassword --dbname db19
dbaascli database convertToPDB

指定した非CDBデータベースをPDBに変換するには、dbaascli database convertToPDBコマンドを使用します。

構文

dbaascli database convertToPDB --dbname <value> [--cdbName <value>] [--executePrereqs]
        {
            [--copyDatafiles]
            | [--backupPrepared]
        }
        [--targetPDBName <value>] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
説明:
  • --dbnameは、Oracle Databaseの名前を指定します
  • --cdbNameは、PDBが作成されるターゲットCDBの名前を指定します。CDBが存在しない場合は、ソースの非CDBと同じOracleホームに作成されます
  • --executePrereqsは、変換前チェックのみを実行するように指定します
  • --copyDatafilesは、ソース・データベースのデータ・ファイルを使用するかわりに、データ・ファイルの新しいコピーを作成するように指定します
  • --backupPreparedフラグは、PDBへの変換を実行する前に、非CDBに対して適切なデータベース・バックアップが存在することを確認します
  • --targetPDBNameは、操作の一部として作成されるPDBの名前を指定します
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: true|false
  • --resumeは、前回の実行を再開するように指定します
    • --sessionIDは、特定のセッションIDを再開するように指定します

FAQ

Q: dbaascli database convertToPDBコマンドは何を行いますか。

A: dbaascli database convertToPDBコマンドは、指定した非CDB Oracle Databaseを、コンテナ・データベース(CDB)内のプラガブル・データベース(PDB)に変換します。

Q: 変換するデータベースを指定する方法は?

A: --dbnameオプションを使用して、変換する非CDB Oracle Databaseの名前を指定します。例:

dbaascli database convertToPDB --dbname <db_name>

Q: PDB変換のターゲットCDBを指定する方法を教えてください。

A: --cdbNameオプションを使用して、新しいPDBが作成されるターゲット・コンテナ・データベース(CDB)の名前を指定します。CDBが存在しない場合は、ソースの非CDBと同じOracleホームに新しいものが作成されます。

Q: --executePrereqsオプションは何を行いますか。

A: --executePrereqsオプションは、変換前チェックを実行して、データベースの変換準備が整っていることを確認します。このステップでは、データベースに対する変更は行われません。

Q: 変換中にデータファイルをコピーするにはどうすればよいですか?

A: --copyDatafilesオプションを使用して、ソース・データベースの元のファイルを使用するのではなく、データファイルの新しいコピーを作成できます。

Q: --keepSourceDBオプションの目的は何ですか。

A: --keepSourceDBオプションを使用すると、変換操作の完了後に元のソース非CDBを保持できます。このオプションを使用しない場合、ソース・データベースは変換後に削除されます。

Q: 変換前にバックアップが準備されていることを確認するにはどうすればよいですか?

A: --backupPreparedフラグを使用して、変換を実行する前に非CDBデータベースの適切なバックアップを作成したことを確認します。このステップは、データ損失を回避するために重要です。

Q: 新しいPDBのカスタム名を指定するにはどうすればよいですか。

A: --targetPDBNameオプションを使用して、変換の一部として作成される新しいPDBに特定の名前を指定します。例:

dbaascli database convertToPDB --dbname <db_name> --targetPDBName <pdb_name>

Q: バックグラウンドで変換を実行できますか?

A: はい。--waitForCompletionオプションを使用して、操作をバックグラウンドで実行するかどうかを指定できます。falseを使用してバックグラウンドで実行し、trueを使用して操作が完了するまで待機してから続行します。デフォルトはtrueです。

Q: 以前に中断した変換を再開するにはどうすればよいですか。

A: --resumeオプションを使用して、以前に中断された変換プロセスを再開できます。オプションで、--sessionIDを指定して特定のセッションを再開できます。

Q: CDB名を指定しないとどうなりますか。

A: --cdbNameオプションを指定しない場合、ソース非CDBデータベースと同じOracleホームに新しいPDBが作成されます。

Q: 中断後に、セッションIDを知らずに変換を続けることはできますか?

A: はい。セッションIDを指定せずに--resumeオプションを使用すると、最後に認識されたセッションが再開されます。特定のセッションを再開する場合は、--sessionIDを指定できます。

Q: --sessionIDオプションは何を行いますか。

A: --sessionIDオプションは、中断されたセッションが複数あった場合に、再開する特定のセッションを指定するために--resumeとともに使用されます。

Q: 非CDBをPDBに変換する前にバックアップが必要ですか。

A: --backupPreparedフラグはオプションですが、PDBへの変換を実行する前に非CDBのバックアップを取ることを強くお薦めします。これにより、変換中に問題が発生した場合にデータベースをリストアできます。

例7-12 dbaascli database convertToPDB

変換前の事前チェックを実行するには:
dbaascli database convertToPDB --dbname ndb19 --cdbname cdb19 --backupPrepared --executePrereqs
非CDBからのデータ・ファイルのコピーを使用して完全な変換を実行するには:
dbaascli database convertToPDB --dbname tst19 --cdbname cdb19 --copyDatafiles
dbaascli database create

Oracle Databaseを作成するには、dbaascli database createコマンドを使用します。プロンプトが表示されたら、sysおよびtdeのパスワードを入力します。

このコマンドを使用して、リリース更新JAN 2021以上が適用されたOracle Databaseバージョン12.1.0.2以上を作成します。より下位のバージョンのデータベースでは、OCIコンソール・ベースのAPIを使用することをお薦めします。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli database create --dbName {--oracleHome | --oracleHomeName}
[--dbUniqueName <value>]
[--dbSID <value>]
[--createAsCDB <value>]
[--pdbName <value>]
[--pdbAdminUserName <value>]
[--dbCharset <value>]
[--dbNCharset <value>]
[--dbLanguage <value>]
[--dbTerritory <value>]
[--sgaSizeInMB <value>]
[--pgaSizeInMB <value>]
[--datafileDestination <value>]
[--fraDestination <value>]
[--fraSizeInMB <value>]
[--nodeList <value>]
[--tdeConfigMethod <value>]
[--kmsKeyOCID <value>]
{
            [--resume [--sessionID <value>]]
            | [--revert [--sessionID <value>]]
        }
[--executePrereqs]
[--honorNodeNumberForInstance <value>]
[--lockPDBAdminAccount <value>]
[--dbcaTemplateFilePath <value>]
[--waitForCompletion]
説明:
  • --dbnameは、データベースの名前を指定します
  • --oracleHomeは、Oracleホームの場所を指定します
  • --oracleHomeNameは、Oracleホームの名前を指定します
  • --dbUniqueNameは、一意のデータベース名を指定します
  • --dbSIDは、データベースのSIDを指定します
  • --createAsCDBは、データベースをCDBと非CDBのどちらとして作成するかについてtrueまたはfalseを指定します
  • --pdbNameは、PDBの名前を指定します
  • --pdbAdminUserNameは、PDB管理ユーザー名を指定します
  • --dbCharsetは、データベース文字セットを指定します
  • --dbNCharsetは、データベースの各国語文字セットを指定します
  • --dbLanguageは、データベース言語を指定します
  • --dbTerritoryは、データベース地域を指定します
  • --sgaSizeInMBは、sga_target値をMB単位で指定します
  • --pgaSizeInMBは、pga_aggregate_target値をMB単位で指定します
  • --datafileDestinationは、データベースのデータファイルに使用するASMディスク・グループ名を指定します
  • --fraDestinationは、データベースの高速リカバリ領域に使用するASMディスク・グループ名を指定します
  • --fraSizeInMBは、高速リカバリ領域のサイズ値をMB単位で指定します
  • --nodeListは、データベースのノードのカンマ区切りリストを指定します
  • --tdeConfigMethodは、TDE構成メソッドを指定します。有効な値: FILEKMS
  • --kmsKeyOCIDは、TDEに使用するKMSキーOCIDを指定します。これは、KMSがTDEに選択されている場合にのみ適用できます
  • --resumeは、前回の実行を再開します
  • --revertは、前回の実行をロールバックします
  • --sessionIDは、特定のセッションIDを再開するか、特定のセッションIDに戻します。
  • --executePrereqsは、yesを指定するとこの操作の前提条件のみが実行されます。有効な値: yesまたはno
  • --honorNodeNumberForInstanceは、インスタンス名にクラスタ・ノード番号の接尾辞を付けるかどうかを示すtrueまたはfalseを指定します。デフォルト値: true
  • --lockPDBAdminAccountは、PDB管理ユーザー・アカウントをロックするかどうかについてtrueまたはfalseを指定します。デフォルト値はtrueです
  • --dbcaTemplateFilePathは、データベースを作成するためのdbcaテンプレート名の絶対パスを指定します。
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: trueまたはfalse

FAQ

Q: dbaascli database createコマンドは何を行いますか。

A: dbaascli database createコマンドを使用して、新しいOracle Databaseインスタンスを作成します。リリース更新JAN 2021以降でのOracle Databaseバージョン12.1.0.2以上の作成がサポートされています。

Q: 作成するOracle Databaseの名前を指定するにはどうすればよいですか。

A: --dbNameオプションを使用して、Oracle Databaseの名前を指定します。例:

dbaascli database create --dbName <db_name>

Q: コンテナ・データベース(CDB)を作成するにはどうすればよいですか。

A: --createAsCDBオプションを使用し、trueを指定してデータベースをCDBとして作成します。例:

dbaascli database create --dbName <db_name> --createAsCDB true

Q: データベースのOracle Homeはどのように指定するのですか。

A: --oracleHomeオプションを使用してOracleホームの場所を指定するか、--oracleHomeNameオプションを使用してOracleホームの名前を指定できます。

Q: 一意のデータベース名またはSIDを指定するにはどうすればよいですか。

A: --dbUniqueNameオプションを使用してデータベースの一意の名前を指定し、--dbSIDオプションを使用してデータベースのSIDを指定します。

Q: CDBとともにプラガブル・データベース(PDB)を作成するにはどうすればよいですか。

A: --pdbNameオプションを使用してPDBの名前を指定し、--pdbAdminUserNameオプションを使用してPDB管理ユーザー名を設定できます。例:

dbaascli database create --dbName <db_name> --createAsCDB true --pdbName <pdb_name> --pdbAdminUserName <admin_user>

Q: データベース文字セットと各国語文字セットはどのように指定できますか。

A: --dbCharsetオプションを使用してデータベース文字セットを指定し、--dbNCharsetオプションを使用して各国語文字セットを指定します。例:

dbaascli database create --dbName <db_name> --dbCharset AL32UTF8 --dbNCharset AL16UTF16

Q: データベースのメモリー設定(SGAおよびPGA)はどのように設定するのですか。

A: --sgaSizeInMBオプションを使用してSGAサイズを指定し、--pgaSizeInMBオプションを使用してPGAサイズをMB単位で指定します。

Q: データファイルおよびFast Recovery Area (FRA)の宛先を指定する方法を教えてください。

A: --datafileDestinationオプションを使用してデータファイルのASMディスク・グループを指定し、--fraDestinationオプションを使用してFRAのASMディスク・グループを指定します。--fraSizeInMBオプションを使用してFRAサイズを設定することもできます。

Q: データベースの作成時にTransparent Data Encryption (TDE)を構成できますか。

A: はい、--tdeConfigMethodオプションを使用してTDEを構成できます。有効な値は、FILE (ファイルベースの暗号化の場合)またはKMS (Oracle Key Management Serviceを使用する場合)です。KMSを使用する場合は、KMSキーOCIDに--kmsKeyOCIDオプションを指定します。

Q: ノードの特定のリストにデータベースを作成するにはどうすればよいですか?

A: --nodeListオプションを使用して、データベースを作成するノードのカンマ区切りリストを指定します。

Q: 以前のデータベース作成の試行を再開または元に戻すにはどうすればよいですか。

A: --resumeオプションを使用して前回の実行を再開するか、--revertオプションを使用して前回の実行をロールバックします。--sessionIDを指定して、特定のセッションを再開または元に戻すこともできます。

Q: --executePrereqsオプションは何を行いますか。

A: --executePrereqsオプションは、実際にデータベースを作成せずに、データベース作成操作の前提条件のみを実行します。yesまたはnoを使用して、このオプションを有効または無効にします。

Q: データベース作成用のカスタムDBCAテンプレートを指定できますか。

A: はい。--dbcaTemplateFilePathオプションを使用して、データベースの作成に使用するDBCAテンプレート・ファイルの絶対パスを指定します。

Q: バックグラウンドでデータベース作成操作を実行できますか。

A: はい、--waitForCompletionオプションを使用して、データベースの作成が完了するまでコマンドが待機するか(true)、バックグラウンドで操作を実行するか(false)を指定できます。

Q: --dbUniqueNameオプションを指定しないとどうなりますか?

A: --dbUniqueNameを使用してデータベースの一意の名前を指定しない場合、システムは指定された--dbNameに基づいて名前を自動的に生成します。

Q: CDBの作成時にPDB管理アカウントをロックできますか。

A: はい、--lockPDBAdminAccountオプションを使用してtrueに設定し、データベースの作成後にPDB管理アカウントをロックできます。デフォルトでは、この値はtrueに設定されています。

例7-13 dbaascli database create

dbaascli database create --dbName db19 --oracleHomeName myhome19 --dbSid db19sid --nodeList node1,node2 --createAsCDB true
dbaascli database createTemplate

このコマンドを使用して、後でデータベースの作成に使用できるデータベース・テンプレート(DBCAテンプレート)を作成します。

rootまたはoracleユーザーとしてコマンドを実行します。

構文

指定したデータベースから新しいDBCAテンプレートを作成します。

dbaascli database createTemplate --dbname <value>
 {
   --templateLocation <value> | --uploadToObjectStorage --objectStorageLoginUser <value> --objectStorageBucketName <value> [--objectStorageUrl <value>]
 }
 [--templateName <value>] [--rmanParallelism <value>]
説明:
  • --dbnameは、データベースの名前を指定します
  • --templateLocationは、テンプレート名を指定します
  • --uploadToObjectStorage: テンプレートをオブジェクト・ストレージにアップロードすることを指定します
    • --objectStorageLoginUser: オブジェクト・ストレージのログイン・ユーザーを指定します
    • --objectStorageBucketName: オブジェクト・ストレージ・バケット名を指定します
    • --objectStorageUrl: オブジェクト・ストレージURLを指定します
  • --templateName: テンプレートの名前を指定します
  • --rmanParallelismは、パラレル値を指定します

FAQ

Q: dbaascli database createTemplateコマンドの目的は何ですか。

A: dbaascli database createTemplateコマンドを使用して、指定したデータベースからデータベース・テンプレート(DBCAテンプレート)を作成します。このテンプレートは、後で新しいデータベースの作成に使用できます。

Q: テンプレートを作成するデータベースの名前はどのように指定するのですか。

A: --dbnameオプションを使用して、テンプレートの作成元となるOracle Databaseの名前を指定します。例:

dbaascli database createTemplate --dbname <db_name>

Q: テンプレートを保存する場所を指定する方法は?

A: --templateLocationオプションを使用して、DBCAテンプレートを保存する場所を指定します。例:

dbaascli database createTemplate --dbname <db_name> --templateLocation /path/to/template

Q: テンプレートをObject Storageに直接アップロードできますか。

A: はい。--uploadToObjectStorageオプションを使用して、DBCAテンプレートをオブジェクト・ストレージにアップロードできます。オブジェクト・ストレージのログイン・ユーザーおよびバケット名は、それぞれ--objectStorageLoginUserおよび--objectStorageBucketNameオプションを使用して指定する必要があります。

Q: テンプレートのアップロード時にObject Storageのログイン詳細を指定する方法を教えてください。

A: オブジェクト・ストレージの詳細を指定するには、次のオプションを使用します:

--objectStorageLoginUser: オブジェクト・ストレージのログイン・ユーザーを指定します

--objectStorageBucketName: オブジェクト・ストレージ・バケット名を指定します

--objectStorageUrl: (オプション)オブジェクト・ストレージのURLがデフォルトのURLと異なる場合、そのURLを指定します。

例:

dbaascli database createTemplate --dbname <db_name> --uploadToObjectStorage --objectStorageLoginUser <user> --objectStorageBucketName <bucket_name>

Q: DBCAテンプレートのカスタム名を指定するにはどうすればよいですか。

A: --templateNameオプションを使用して、DBCAテンプレートのカスタム名を指定します。例:

dbaascli database createTemplate --dbname <db_name> --templateName <template_name>

Q: --rmanParallelismオプションは何に使用されますか。

A: --rmanParallelismオプションは、テンプレート作成プロセス中のRMAN操作の並列度を指定します。例:

dbaascli database createTemplate --dbname <db_name> --rmanParallelism 4

Q: --templateLocationまたは--uploadToObjectStorageオプションを指定しないとどうなりますか。

A: --templateLocationを使用してテンプレートの場所を指定しない場合、または--uploadToObjectStorageを使用してオブジェクト・ストレージにアップロードすることを選択した場合、コマンドは、作成されたテンプレートを格納する場所を認識せず、完了に失敗します。

Q: --templateLocationと--uploadToObjectStorageの両方を同時に使用できますか?

A: いいえ、テンプレートをローカルに保存する場合は--templateLocation、オブジェクト・ストレージにアップロードする場合は--uploadToObjectStorageのいずれかを選択する必要がありますが、両方は選択できません。

Q: テンプレートをオブジェクト・ストレージにアップロードする場合、--objectStorageUrlオプションは必須ですか。

A: いいえ。--objectStorageUrlオプションはオプションです。指定しない場合、デフォルトのオブジェクト・ストレージURLが使用されます。これを指定する必要があるのは、カスタム・オブジェクト・ストレージURLを使用する場合のみです。

Q: dbaascli database createTemplateコマンドを実行するには、どのユーザー権限が必要ですか。

A: このコマンドは、rootまたはoracleユーザーとして実行する必要があります。

Q: 以前に失敗したテンプレートの作成プロセスを再開できますか?

A: いいえ。dbaascli database createTemplateコマンドは、失敗したプロセスの再開をサポートしていません。最初からコマンドを再起動する必要があります。

dbaascli database delete

Oracle Databaseを削除するには、dbaascli database deleteコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli database delete --dbname <value>
[--deleteArchiveLogs <value>]
[--deleteBackups <value>]
[--precheckOnly <value>]
[--waitForCompletion <value>]
[--force]
[--dbSID <value>]
[--resume [--sessionID <value>]]
説明:
  • --dbnameは、データベースの名前を指定します。
  • --deleteArchiveLogsは、データベース・アーカイブ・ログを削除するかどうかを示すtrueまたはfalseを指定します。
  • --deleteBackupsは、データベース・バックアップを削除するかどうかを示すtrueまたはfalseを指定します。
  • --precheckOnlyは、yesを指定するとこの操作の事前チェックのみが実行されます。有効な値: yesまたはno
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: trueまたはfalse
  • –-forceフラグは、データベースを強制的に削除します。
  • --dbSIDは、データベースSIDを指定します。
  • --resumeは、前の実行を再開します。
  • --sessionIDは、特定のセッションIDを再開します。

FAQ

Q: dbaascli database deleteコマンドの目的は何ですか。

A: dbaascli database deleteコマンドは、Exadata Cloud Infrastructure上のOracle Databaseを削除するために使用します。

Q: 削除するデータベースを指定するにはどうすればよいですか?

A: --dbnameオプションを使用して、削除するOracle Databaseの名前を指定します。例:

dbaascli database delete --dbname <db_name>

Q: データベースを削除するときにアーカイブ・ログを削除するにはどうすればよいですか。

A: --deleteArchiveLogsオプションをtrueに設定することで、アーカイブ・ログを削除できます。例:

dbaascli database delete --dbname <db_name> --deleteArchiveLogs true

Q: データベースを削除するときにバックアップを削除することもできますか?

A: はい。--deleteBackupsオプションを使用してtrueに設定し、関連付けられているすべてのバックアップを削除します。例:

dbaascli database delete --dbname <db_name> --deleteBackups true

Q: データベースを実際に削除せずに削除操作の事前チェックのみを実行するにはどうすればよいですか。

A: --precheckOnlyオプションを使用し、それをyesに設定すると、データベースを削除せずに事前チェックを実行できます。例:

dbaascli database delete --dbname <db_name> --precheckOnly yes

Q: データベースを強制的に削除するにはどうすればよいですか?

A: データベースを強制的に削除するには、--forceフラグを使用します。これにより、チェックがバイパスされ、削除プロセスが強制されます。例:

dbaascli database delete --dbname <db_name> --force

Q: バックグラウンドで削除操作を実行するにはどうすればよいですか?

A: --waitForCompletionオプションを使用してfalseに設定し、バックグラウンドで操作を実行します。例:

dbaascli database delete --dbname <db_name> --waitForCompletion false

Q: 削除するデータベースのSIDは指定できますか?

A: はい、--dbSIDオプションを使用してデータベースのSIDを指定できます。例:

dbaascli database delete --dbname <db_name> --dbSID <sid>

Q: 以前に中断された削除操作を再開するにはどうすればよいですか?

A: 以前の削除の実行を再開するには、--resumeオプションを使用します。必要に応じて、--sessionIDオプションを使用してセッションIDを指定することもできます。例:

dbaascli database delete --dbname <db_name> --resume --sessionID <session_id>

Q: dbaascli database deleteコマンドを実行するには、どのユーザー権限が必要ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: dbaascli database deleteコマンドで--precheckOnlyオプションは何を行いますか。

A: --precheckOnlyオプションを使用すると、データベースを削除せずに削除操作の事前チェックのみを実行できます。実際の削除を続行する前に、すべてのチェックが確実に通過します。

Q: 操作が完了するのを待たずにデータベースを削除することはできますか?

A: はい。--waitForCompletionオプションをfalseに設定すると、削除操作はバックグラウンドで実行され、完了するまで待機する必要はありません。

例7-14 dbaascli database delete

dbaascli database delete --dbname db19
dbaascli database deleteInstance

指定したノードのデータベース・インスタンスを削除するには、dbaascli database deleteInstanceコマンドを使用します。

前提条件

  • rootユーザーとしてコマンドを実行します。

構文

dbaascli database deleteInstance --dbname <value> --node <value> [--continueOnUnreachableNode]
説明:
  • --dbnameは、Oracle Database名を指定します
  • --nodeは、データベース・インスタンスのノード名を指定します
  • --continueOnUnreachableNodeは、ノードにアクセスできない場合でも操作を実行するように指定します

FAQ

Q: dbaascli database deleteInstanceコマンドの目的は何ですか。

A: dbaascli database deleteInstanceコマンドは、Exadata Cloud Infrastructure環境の指定したノード上の特定のOracle Databaseインスタンスを削除するために使用します。

Q: 削除するOracle Databaseインスタンスを指定するにはどうすればよいですか。

A: 削除するOracle Databaseインスタンスを指定するには、--dbnameオプションを使用してデータベース名を指定し、--nodeオプションを使用してノード名を指定します。例:

dbaascli database deleteInstance --dbname <db_name> --node <node_name>

Q: ノードにアクセスできない場合でもインスタンスを削除できますか。

A: はい。指定したノードにアクセスできない場合でも、--continueOnUnreachableNodeオプションを使用して削除を続行できます。例:

dbaascli database deleteInstance --dbname <db_name> --node <node_name> --continueOnUnreachableNode

Q: インスタンスの削除操作中に、指定したノードにアクセスできない場合はどうなりますか。

A: ノードにアクセスできず、--continueOnUnreachableNodeオプションを使用しない場合、操作は失敗します。このオプションを使用すると、ノードにアクセスできない場合でも操作は続行されます。

Q: 特定のノードからデータベース・インスタンスを削除するにはどうすればよいですか。

A: 次のコマンドを使用して、特定のノードからデータベース・インスタンスを削除します。

dbaascli database deleteInstance --dbname <db_name> --node <node_name>

Q: dbaascli database deleteInstanceコマンドを実行するには、どのユーザー権限が必要ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: ノードを指定せずにインスタンスを削除できますか。

A: いいえ。データベース・インスタンスを削除するノードを指定するには、--nodeオプションが必要です。

Q: --continueOnUnreachableNodeオプションは何を行いますか。

A: --continueOnUnreachableNodeオプションを使用すると、指定したノードに到達できない場合でも操作を続行でき、ノードが停止している可能性のあるシナリオでインスタンスの削除が続行されます。

Q: このコマンドを使用して、複数のデータベース・インスタンスを一度に削除することはできますか。

A: いいえ。dbaascli database deleteInstanceコマンドは、指定したノードの単一のデータベース・インスタンスを一度に削除するために使用します。削除するインスタンスごとに、コマンドを個別に実行する必要があります。

例7-15 database deleteinstance

database deleteinstance --node test-node
dbaascli database duplicate

アクティブなデータベースからデータベースを作成するには、dbaascli database duplicateコマンドを使用します。

前提条件

  • rootユーザーとしてコマンドを実行します。

構文

dbaascli database duplicate --dbName <value> --sourceDBConnectionString <value>
        {
            --oracleHome <value>
            | --oracleHomeName <value>
        }
[--dbSID <value>] 
[--dbUniqueName <value>] 
[--sgaSizeInMB <value>] 
[--pgaSizeInMB <value>] 
[--datafileDestination <value>] 
[--fraDestination <value>] 
[--fraSizeInMB <value>] 
[--sourceDBWalletLocation <value>] 
[--nodeList <value>]
        {
            [--resume [--sessionID <value>]]
            | [--revert [--sessionID <value>]]
        }
[--rmanParallelism <value>]
[--rmanSectionSizeInGB <value>]
[--tdeConfigMethod <value>]
[--kmsKeyOCID <value>]
[--sourceDBTdeConfigMethod <value>]
[--sourceDBKmsKeyOCID <value>]
[--executePrereqs <value>] 
[--waitForCompletion <value>]
[--skipPDBs <value>]
説明:
  • --dbNameは、Oracle Database名を指定します
  • --sourceDBConnectionStringは、ソース・データベースの接続文字列を<scan_name>:<scan_port>/<database_service_name>の形式で指定します
  • --oracleHomeは、Oracleホームの場所を指定します
  • --oracleHomeNameは、Oracleホーム名を指定します
  • --dbSIDは、データベースSIDを指定します
  • --dbUniqueNameは、一意のデータベース名を指定します
  • --sgaSizeInMBは、メガバイト単位でsga_target値を指定します
  • --pgaSizeInMBは、メガバイト単位でpga_aggregate_target値を指定します
  • --datafileDestinationは、データベース・データファイルに使用するASMディスク・グループ名を指定します
  • --fraDestinationは、データベースの高速リカバリ領域に使用するASMディスク・グループ名を指定します
  • --fraSizeInMBは、高速リカバリ領域サイズ値をメガバイト単位で指定します
  • --sourceDBWalletLocationは、ソース・データベースのTDEウォレット・ファイルの場所を指定します。これは、アクティブなデータベースからデータベースを複製するために必要です
  • --nodeListは、データベースのノードのカンマ区切りリストを指定します
  • --resumeは、前回の実行を再開するように指定します
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • --revertは、前の実行をロールバックすることを指定します。
    • --sessionIDは、特定のセッションIDをロールバックすることを指定します。
  • --rmanParallelismは、パラレル値を指定します
  • --rmanSectionSizeInGBは、RMANセクション・サイズ(GB)を指定します
  • --tdeConfigMethodは、TDE構成メソッドを指定します。使用可能な値は、FILEおよびKMSです。
  • --kmsKeyOCIDは、TDEに使用するKMSキーOCIDを指定します。これは、KMSがTDEに選択されている場合にのみ適用できます
  • --sourceDBTdeConfigMethodは、ソース・データベースのTDE構成メソッドを指定します。使用可能な値は、FILEおよびKMSです。
  • --sourceDBKmsKeyOCIDは、TDEに使用するソース・データベースのKMSキーOCIDを指定します。これは、KMSがTDEに選択されている場合にのみ適用できます
  • --executePrereqsは、yesを指定するとこの操作の前提条件のみが実行されます。有効な値: yes|no
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: true|false
  • --skipPDBsは、ソース・データベースPDB名のカンマ区切りリストを指定します。このリストは、複製データベース操作に対して除外する必要があります。例: pdb1、pdb2...

FAQ

Q: dbaascli database duplicateコマンドの目的は何ですか。

A: dbaascli database duplicateコマンドは、既存のアクティブなデータベースを複製して新しいOracle Databaseを作成するために使用します。

Q: dbaascli database duplicateコマンドを使用するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: ソース・データベースを複製用に指定するにはどうすればよいですか。

A: --sourceDBConnectionStringオプションを使用して、ソース・データベースの接続文字列を<scan_name>:<scan_port>/<database_service_name>というフォーマットで指定します。例:

--sourceDBConnectionString <scan_name>:<scan_port>/<database_service_name>

Q: 新しいデータベースのOracle Homeの場所を指定する方法を教えてください。

A: --oracleHomeオプションを使用してOracle Homeの場所を指定することも、--oracleHomeNameオプションを使用してOracle Homeの名前を指定することもできます。例:

--oracleHome <value>

または

--oracleHomeName <value>

Q: --sourceDBWalletLocationオプションの目的は何ですか。

A: --sourceDBWalletLocationオプションは、アクティブなソース・データベースからデータベースを複製するために必要なソース・データベースTDEウォレット・ファイルの場所を指定します。

Q: ソース・データベースからの特定のPDBの複製をスキップできますか。

A: はい。--skipPDBsオプションを使用して、重複操作から除外するPDB名のカンマ区切りリストを指定できます。例:

--skipPDBs pdb1,pdb2

Q: 新しいデータベースに対してTDEを構成するにはどうすればよいですか。

A: --tdeConfigMethodオプションを使用して、TDE構成メソッド(FILEまたはKMS)を指定します。KMSを選択した場合、--kmsKeyOCIDオプションを使用してKMSキーOCIDを指定できます。例:

--tdeConfigMethod FILE

または

--tdeConfigMethod KMS --kmsKeyOCID <value>

Q: --executePrereqsオプションは何を行いますか。

A: --executePrereqsオプションは、操作の前提条件チェックのみを実行するかどうかを指定します。有効な値は、前提条件のみを実行するにはyes、完全な操作を続行するにはnoです。

Q: 以前に中断された重複操作を再開するにはどうすればよいですか?

A: --resumeオプションを--sessionIDオプションとともに使用して、以前に中断された重複操作を再開します。例:

--resume --sessionID <value>

Q: --waitForCompletionオプションは何を行いますか。

A: --waitForCompletionオプションは、操作の完了を待機するかどうかを指定します。これをtrueに設定すると完了を待機し、falseではバックグラウンドで操作が実行されます。例:

--waitForCompletion true

Q: --rmanParallelismオプションの目的は何ですか。

A: --rmanParallelismオプションは、複製プロセス中のRMAN (Recovery Manager)のパラレル化値を指定します。これにより、複数のパラレル・プロセスを使用することで、複製操作の速度が向上します。

Q: 新しいデータベースのSGAおよびPGAのサイズはどのように指定しますか。

A: --sgaSizeInMBおよび--pgaSizeInMBオプションを使用して、それぞれSGA (システム・グローバル領域)およびPGA (プログラム・グローバル領域)のサイズをMB単位で指定します。例:

--sgaSizeInMB <value>

--pgaSizeInMB <value>

Q: --revertオプションは何を行いますか?

A: --revertオプションは、以前の重複操作をロールバックするために使用します。元に戻すセッションを指定するには、--sessionIDを指定する必要があります。

例7-16 dbaascli database duplicate

dbaascli database duplicate --sourceDBConnectionString test-user-scan.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521/mynew.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --dbName newdup --sourceDBWalletLocation /var/opt/oracle/dbaas_acfs/tmp/prim_wallet
dbaascli database getDetails

このコマンドは、特定のデータベースの詳細情報(dbname、ノード情報、プラガブル・データベース情報など)を表示します。

前提条件

rootユーザーまたはoracleユーザーとしてコマンドを実行します

構文

dbaascli database getDetails --dbname <value>
説明:
  • --dbname - Oracleデータベース名。

FAQ

Q: dbaascli database getDetailsコマンドの目的は何ですか。

A: dbaascli database getDetailsコマンドは、データベース名、ノード情報、プラガブル・データベース(PDB)の詳細など、指定したOracleデータベースに関する詳細情報を表示します。

Q: dbaascli database getDetailsコマンドは誰が実行できますか。

A: コマンドは、rootユーザーまたはoracleユーザーが実行できます。

Q: dbaascli database getDetailsコマンドで--dbnameオプションは何を指定しますか。

A: --dbnameオプションは、詳細情報が取得されるOracleデータベースの名前を指定します。

Q: dbaascli database getDetailsコマンドではどのような情報が提供されますか。

A: このコマンドは、データベース名、ノード情報、およびコンテナ・データベースに関連付けられたプラガブル・データベース(PDB)に関する情報などの詳細を提供します。

dbaascli database getPDBs

コンテナ・データベース内のすべてのプラガブル・データベースのリストを表示するには、dbaascli database getPDBsコマンドを使用します。

rootまたはoracleユーザーとしてコマンドを実行します。

構文

dbaascli database getPDBs --dbname <value>
説明:
  • --dbnameは、コンテナ・データベースの名前を指定します

FAQ

Q: dbaascli database getPDBsコマンドの目的は何ですか。

A: dbaascli database getPDBsコマンドは、指定したコンテナ・データベース(CDB)内のすべてのプラガブル・データベース(PDB)をリストするために使用します。

Q: getPDBsコマンドにコンテナ・データベースを指定するにはどうすればよいですか。

A: --dbnameオプションを使用して、コンテナ・データベースの名前を指定します。例:

--dbname <value>

Q: dbaascli database getPDBsコマンドを特定のユーザーとして実行する必要がありますか。

A: はい、rootユーザーまたはoracleユーザーとしてコマンドを実行する必要があります。

Q: getPDBsコマンドを使用して、非CDBデータベース内のPDBを表示できますか。

A: いいえ、getPDBsコマンドはコンテナ・データベース(CDB)にのみ適用されます。このコマンドは、非CDBデータベースには使用できません。

Q: dbaascli database getPDBsコマンドからの出力の形式は何ですか。

A: このコマンドは、指定したコンテナ・データベース内のすべてのPDBのリストを返します。出力には通常、PDB名、ステータス、および各プラガブル・データベースに関するその他の関連詳細が含まれます。

Q: このコマンドは複数のデータベースに一度に使用できますか?

A: いいえ。dbaascli database getPDBsコマンドは、--dbnameオプションで指定されている単一のコンテナ・データベースで一度に機能します。

Q: getPDBsコマンドを使用するには、データベースを停止する必要がありますか。

A: いいえ。getPDBsコマンドでは、データベースを停止する必要はありません。コンテナ・データベースが稼働している間に実行できます。

例7-17 dbaascli database getPDBs --dbname

dbaascli database getPDBs --dbname apr_db1
dbaascli database modifyParameters

Oracle Databaseの初期化パラメータを変更またはリセットするには、dbaascli database modifyParametersコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli database modifyParameters --dbname <value> 
{
--setParameters <values>[--instance <value>] [--backupPrepared] [--allowBounce]|
--resetParameters <values> [--instance <value>] [--backupPrepared] [--allowBounce]
}
--responseFile
[--backupPrepared]
[--instance]
[--allowBounce]
[--waitForCompletion]
説明:
  • --dbnameは、データベースの名前を指定します。
  • --setParametersは、新しい値で変更するパラメータのカンマ区切りリストを指定します。例: parameter1=valueA,parameter2=valueBなど空白値には、parameter1=valueA,parameter2='などを使用します。
  • --resetParametersは、対応するデフォルト値にリセットするパラメータのカンマ区切りリストを指定します。たとえば、parameter1, parameter2などです。
  • --instanceは、パラメータが処理されるインスタンスの名前を指定します。指定しない場合、操作はデータベース・レベルで実行されます。
  • --backupPreparedは、クリティカル・パラメータまたは機密パラメータを変更する前に、適切なデータベース・バックアップが存在することを確認します。
  • --allowBounceは、適用可能な静的パラメータに対する変更を反映するために、データベースを再起動する権限を付与します。
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: true|false]

FAQ

Q: dbaascli database modifyParametersコマンドの目的は何ですか。

A: dbaascli database modifyParametersコマンドは、Oracle Database初期化パラメータを変更またはリセットするために使用します。

Q: パラメータを変更するデータベースを指定する方法は?

A: パラメータを変更またはリセットするデータベースの名前を指定するには、--dbnameオプションを使用する必要があります。

Q: modifyParametersコマンドを使用してデータベース・パラメータを変更するにはどうすればよいですか。

A: --setParametersオプションに続けて、パラメータとその新しい値のカンマ区切りリストを指定します。例:

--setParameters parameter1=valueA,parameter2=valueB

Q: このコマンドを使用してパラメータをデフォルト値にリセットするにはどうすればよいですか?

A: --resetParametersオプションの後ろにカンマ区切りのパラメータ・リストを指定して、デフォルト値にリセットします。例:

--resetParameters parameter1,parameter2

Q: 応答ファイルを使用してパラメータを変更できますか?

A: はい、--responseFileオプションを使用して、レスポンスJSONファイルの絶対的な場所を指定できます。ファイルには、変更するパラメータが含まれている必要があります。

Q: パラメータを変更する前にバックアップを取る必要がありますか。

A: すべての変更で必須ではありませんが、クリティカル・パラメータまたは機密パラメータを変更する場合は、バックアップを設定することをお薦めします。--backupPreparedオプションを使用すると、バックアップが準備されたことを確認できます。

Q: 変更は、マルチインスタンス・データベースの特定のインスタンスにのみ適用できますか。

A: はい、--instanceオプションを使用してインスタンス名を指定できます。このオプションを使用しない場合、変更はデータベース・レベルで適用されます。

Q: パラメータの変更後にデータベースをバウンス(再起動)する必要がありますか。

A: 一部の静的パラメータでは、データベース・バウンスが必要です。--allowBounceオプションを使用すると、必要に応じてデータベースをバウンスする権限を付与できます。

Q: 静的パラメータの変更時にデータベースのバウンスを許可しないとどうなりますか。

A: 静的パラメータの変更時に--allowBounceオプションを使用しない場合、その変更は、次回の手動データベース再起動まで有効になりません。

Q: 以前のセッションが中断された場合、パラメータの変更を再開できますか?

A: いいえ、このコマンドはセッションの再開をサポートしていません。最初からコマンドを再実行する必要があります。

例7-18 dbaascli database modifyParameters

dbaascli database modifyParameters --dbname dbname --setParameters "log_archive_dest_state_17=ENABLE"
dbaascli database recover

データベースをリカバリするには、dbaascli database recoverコマンドを使用します。

前提条件

  • rootユーザーとしてコマンドを実行します。
  • バックアップが格納されるバックアップ・ストレージ宛先の詳細を使用してデータベースが構成されている必要があります。

構文

dbaascli database recover --dbname <value>
        {
            --start
                {
                    --untilTime <value>
                    | --untilSCN <value>
                    | --latest
                    | --tag <value>
                }
            | --status --uuid <value>
        }
説明:
--dbname: Oracle Database name.
      --start | --status
--start: Begins database recovery.
      --untilTime | --untilSCN | --latest | --tag
      --untilTime: Recovers database until time. Input format: DD-MON-YYYY HH24:MI:SS.
      --untilSCN: Recovers database until SCN.
      --latest: Recovers database to last known state.
      --tag: Recovers database to archival tag.
--status
      --uuid <value>

FAQ

Q: dbaascli database recoverコマンドの目的は何ですか。

A: dbaascli database recoverコマンドは、バックアップ記憶域の保存先に格納されているバックアップからOracle Databaseをリカバリするために使用します。

Q: リカバリするデータベースを指定する方法を教えてください。

A: --dbnameオプションに続けてデータベース名を指定して、リカバリするデータベースを指定できます。例:

--dbname <database_name>

Q: dbaascli database recoverコマンドで使用できるリカバリ・オプションは何ですか。

A: リカバリ・オプションは次のとおりです。

--untilTime: データベースを特定の時間にリカバリします。

--untilSCN: データベースを特定のシステム変更番号(SCN)にリカバリします。

--latest: データベースを最新の既知の状態にリカバリします。

--tag: アーカイブ・タグを使用してデータベースをリカバリします。

Q: データベースを特定の時間にリカバリするにはどうすればよいですか。

A: --untilTimeオプションに続けて、DD-MON-YYYY HH24:MI:SS形式の時間を使用します。例:

--untilTime 05-SEP-2024 15:30:00

Q: データベースを特定のSCNにリカバリするにはどうすればよいですか。

A: --untilSCNオプションに続けてSCN値を使用します。例:

--untilSCN 123456789

Q: データベースを最新の既知の状態にリカバリするにはどうすればよいですか。

A: --latestオプションを使用して、可能なかぎり最新の状態にデータベースをリカバリします。例:

--latest

Q: リカバリ・プロセスでの--tagオプションの使用方法は何ですか。

A: --tagオプションを使用すると、バックアップに関連付けられたアーカイブ・タグを使用してデータベースをリカバリできます。例:

--tag <backup_tag>

Q: リカバリ操作のステータスを確認するにはどうすればよいですか。

A: --statusオプションを--uuid値とともに使用して、進行中または前のリカバリ操作のステータスを確認します。例:

--status --uuid <recovery_uuid>

Q: --startオプションはリカバリ・プロセスで何を行いますか。

A: --startオプションは、選択したリカバリ方法(--untilTime--untilSCN--latestまたは--tag)に基づいてリカバリ操作を開始します。

Q: 時間やSCNを指定せずにデータベースをリカバリする方法はありますか。

A: はい。--latestオプションを使用して、データベースの最後の既知の状態にリカバリできます。このオプションは、時間やSCNを指定する必要はありません。

Q: 部分的な回復はできますか。

A: はい。--untilTimeまたは--untilSCNオプションを使用して、データベースを特定の時点またはSCNにリカバリできます。

例7-19例

  • データベースmyTestDbを最新状態にリカバリするには:
    dbaascli database recover --dbname myTestDb --start --latest
  • uuid 2508ea18be2911eb82d0020017075151で送信されたリカバリ・リクエストのステータスを問い合せるには:
    dbaascli database recover --dbname myTestDb --status --uuid 2508ea18be2911eb82d0020017075151
dbaascli database runDatapatch

Oracle Databaseにパッチを適用するには、dbaascli database runDatapatchコマンドを使用します。

前提条件

  • runDatapatch操作を実行する前に、データベースに関連付けられているすべてのデータベース・インスタンスが稼働していることを確認します。

  • rootユーザーとしてコマンドを実行します。

構文

dbaascli database runDatapatch --dbname
[--resume]
    [--sessionID]
[--skipPdbs | --pdbs]
[--executePrereqs]
[--patchList]
[--skipClosedPdbs]
[--rollback]

説明:

  • --dbnameは、データベースの名前を指定します
  • --resumeは、前回の実行を再開します
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • --skipPdbsは、指定したPDBのカンマ区切りリストに対するdatapatchの実行をスキップします。例: pdb1,pdb2...
  • --pdbsは、指定したPDBのカンマ区切りリストに対してのみデータパッチを実行します。例: pdb1,pdb2...
  • --executePrereqsは、前提条件チェックを実行します
  • --patchListは、指定したパッチのカンマ区切りリストを適用またはロールバックします。例: patch1,patch2...
  • --skipClosedPdbsは、クローズしたPDBに対するdatapatchの実行をスキップします
  • --rollbackは、適用されたパッチをロールバックします

FAQ

Q: dbaascli database runDatapatchコマンドの目的は何ですか。

A: dbaascli database runDatapatchコマンドは、Oracle Databaseにパッチを適用するために使用します。

Q: dbaascli database runDatapatchコマンドを実行する前に、何を確認する必要がありますか。

A: コマンドを実行する前に、データベースのすべてのインスタンスが稼働していることを確認します。

Q: パッチを適用するデータベースを指定するにはどうすればよいですか。

A: --dbnameオプションに続けて、データベースの名前を指定します。例:

--dbname myDatabase

Q: 以前に中断されたrunDatapatch操作を再開するにはどうすればよいですか。

A: --resumeオプションを使用して前回の実行を再開するか、--sessionIDオプションを使用して特定のセッションIDを指定します。例:

--resume

--sessionID 12345

Q: パッチの実行時に特定のPDBをスキップするにはどうすればよいですか。

A: --skipPdbsオプションに続けて、スキップするPDB名のカンマ区切りリストを指定します。例:

--skipPdbs pdb1,pdb2

Q: 特定のPDBでのみパッチを実行するにはどうすればよいですか。

A: --pdbsオプションに続けて、含めるPDB名のカンマ区切りリストを指定します。例:

--pdbs pdb1,pdb2

Q: 特定のパッチ・セットを適用またはロールバックするにはどうすればよいですか。

A: 適用またはロールバックするには、--patchListオプションに続けて、パッチ名のカンマ区切りリストを使用します。例:

--patchList patch1,patch2

Q: --rollbackオプションは何を行いますか?

A: --rollbackオプションは、パッチ適用操作中に適用されたパッチをロールバックします。

Q: パッチ適用操作中に一部のPDBがクローズされるとどうなりますか。

A: 一部のPDBがクローズされている場合は、--skipClosedPdbsオプションを使用して、それらのクローズされたPDBへのパッチ適用をスキップできます。

Q: パッチを適用する前に前提条件チェックを実行できますか。

A: はい。パッチを適用する前に、--executePrereqsオプションを使用して前提条件チェックを実行します。

Q: パッチを再開するセッションIDを確認するにはどうすればよいですか。

A: runDatapatch操作の後、セッションIDは通常ログに記録されます。--sessionIDオプションを使用して、パッチの再開時にそのIDを指定します。例:

--sessionID 67890

dbaascli database runDatapatch --dbname db19
dbaascli database start

Oracle Databaseを起動するには、dbaascli database startコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli database start
[--dbname]
[--mode]
説明:
  • --dbnameは、データベースの名前を指定します
  • --modeは、対応するモードでデータベースを起動するためにmountまたはnomountを指定します

このコマンドにより、データベースが起動され、オープンされます。Oracle Database 12c以上では、すべてのPDBもオープンされます。

FAQ

Q: dbaascli database startコマンドの目的は何ですか。

A: dbaascli database startコマンドは、Oracle Databaseを起動するために使用します。

Q: dbaascli database startコマンドを実行する前に何を行う必要がありますか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: 起動するデータベースを指定する方法は?

A: --dbnameオプションに続けて、データベースの名前を指定します。例:

--dbname myDatabase

Q: データベースを起動できるモードは何ですか。

A: --modeオプションを使用して、データベースをmountまたはnomountモードで起動できます。例:

--mode mount

Q: 指定しない場合のデフォルト・モードは何ですか。

A: モードを指定しない場合、データベースはデフォルトのopenモードで起動します。

Q: このコマンドは、Oracle Database 12c以降のすべてのPDBをオープンしますか。

A: はい。Oracle Database 12c以降でデータベースを起動すると、すべてのプラガブル・データベース(PDB)もオープンされます。

Q: Nomountモードでデータベースを起動するにはどうすればよいですか?

A: --modeオプションを使用して、nomountに設定します。例:

--mode nomount

Q: マウントモードでデータベースを起動するには?

A: --modeオプションを使用して、マウントするように設定します。例:

--mode mount

Q: dbaascli database startコマンドの実行時にデータベース名を指定することは必須ですか。

A: はい。正しいデータベースを起動するには、--dbnameオプションを使用してデータベース名を指定することをお薦めします。

例7-20 dbaascli database start

dbaascli database start --dbname dbname --mode mount
dbaascli database stop

Oracle Databaseを停止するには、dbaascli database stopコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli database stop
[-–dbname <value>]
[--mode <value>]
説明:
  • --dbnameは、停止するデータベースの名前を指定します
  • --modeは、データベースのモードを指定します。有効な値: abortimmediatenormaltransactional

このコマンドでは、データベースの停止が即時モードで実行されます。新しい接続や新しいトランザクションは許可されません。アクティブなトランザクションはロールバックされ、接続しているすべてのユーザーは切断されます。

FAQ

Q: dbaascli database stopコマンドの目的は何ですか。

A: dbaascli database stopコマンドは、Oracle Databaseの停止に使用されます。

Q: dbaascli database stopコマンドを使用するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行する必要があり、SSHを使用してExadata Cloud@Customer仮想マシンに接続する必要があります。

Q: 停止するデータベースを指定する方法は?

A: データベースを指定するには、--dbnameオプションに続けてデータベースの名前を指定します。例:

--dbname myDatabase

Q: dbaascli database stopコマンドの有効な停止モードは何ですか。

A: 有効な停止モードは次のとおりです。

abort

immediate

normal

transactional

Q: モードが指定されていない場合のデフォルトのシャットダウン・モードは何ですか。

A: モードが指定されていない場合、データベースはデフォルトでimmediateモードで停止されます。

Q: 即時停止モードではどうなりますか。

A: immediateモードでは、新しい接続やトランザクションは許可されず、アクティブなトランザクションはロールバックされ、接続しているすべてのユーザーは切断されます。

Q: データベースを中止モードで停止するにはどうすればよいですか?

A: データベースを中断モードで停止するには、--modeオプションを中断とともに使用します。例:

--mode abort

Q: データベースを停止するときに、通常モードは何を行いますか。

A: 通常モードでは、アクティブなトランザクションに影響を与えずに現在のユーザー・セッションを完了してから停止できます。

Q: dbaascli database stopコマンドで使用されるトランザクション・モードは何ですか。

A: transactionalモードでは、アクティブなトランザクションがすべて完了した後にのみデータベースが停止しますが、新しいトランザクションは許可されません。

Q: dbaascli database stopコマンドで停止モードを指定することは必須ですか。

A: いいえ。shutdownモードの指定はオプションです。指定しない場合、デフォルトの即時モードが使用されます。

例7-21 dbaascli database stop

dbaascli database stop --dbname db19
dbaascli database upgrade

Oracle Databaseをアップグレードするには、dbaascli database upgradeコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli database upgrade --dbname <value> 
{--targetHome <value> | --targetHomeName <value>}
{ [--executePrereqs | --postUpgrade | --rollback]}
{[--standBy | --allStandbyPrepared]}
{[--upgradeOptions <value>]  | [--standBy]}
[--removeGRP]
[--increaseCompatibleParameter]
[--resume [--sessionID <value>]]
[--waitForCompletion <value>]
説明:
  • --dbname (必須)は、データベースの名前を指定します。
  • --targetHomeは、ターゲットOracleホームの場所を指定します
  • --targetHomeNameは、ターゲットOracle Databaseホームの名前を指定します
  • --standByは、このオプションを使用して、Data Guard構成のスタンバイ・データベースをアップグレードします
  • --allStandbyPreparedは、Data Guard構成のプライマリ・データベースにとって必須です。プライマリ・データベースをアップグレードする前に、すべての必要な操作がスタンバイ・データベースで実行されたことを確認するフラグです
  • --removeGRPは、データベースのアップグレードが成功した場合にのみ、保証付きリストア・ポイント(GRP)バックアップを自動的に削除します
  • --increaseCompatibleParameterは、データベース・アップグレードの一部として、互換性のあるパラメータを自動的に増やします。データベースのアップグレードが成功した場合にのみ、パラメータが増加します
  • --executePrereqsは、アップグレード前のチェックのみを実行します
  • --postUpgradeは、アップグレード後に失敗し、アップグレード後のステップを再実行する必要がある場合、このオプションを使用します
  • --rollbackは、Oracle Databaseを元のOracleホームに戻します
  • --upgradeOptionsは、このオプションを使用して、DBUA固有の引数を渡し、Oracle Databaseのアップグレードを実行します。サポートされる引数とオプションについては、対応するOracleドキュメントを参照してください。

    --standby

  • --resumeは、前の実行を再開します
  • --sessionIDは、特定のセッションIDを再開します。
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値 : true|false

FAQ

Q: dbaascli database upgradeコマンドの目的は何ですか。

A: dbaascli database upgradeコマンドは、Oracle Databaseを新しいバージョンにアップグレードするために使用します。

Q: dbaascli database upgradeコマンドを使用するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行し、SSHを使用してExadata Cloud@Customer仮想マシンに接続する必要があります。

Q: アップグレードが必要なデータベースを指定する方法を教えてください。

A: --dbnameオプションに続けて、データベースの名前を指定します。例:

--dbname myDatabase

Q: アップグレードのターゲットOracleホームを指定するにはどうすればよいですか。

A: --targetHomeオプションを使用してターゲットOracleホームの場所を指定するか、--targetHomeNameオプションを使用してターゲットOracle Databaseホームの名前を指定できます。

Q: --standByオプションは何を行いますか。

A: --standByオプションは、Data Guard構成のスタンバイ・データベースをアップグレードするために使用されます。

Q: --allStandbyPreparedフラグの目的は何ですか。

A: --allStandbyPreparedフラグは、Data Guard構成でプライマリ・データベースをアップグレードする前に、スタンバイ・データベースで必要なすべての操作が実行されたことを認識します。

Q: --removeGRPオプションは何を行いますか。

A: --removeGRPオプションでは、データベースのアップグレードが成功すると、保証付きリストア・ポイント(GRP)バックアップが自動的に削除されます。

Q: --increaseCompatibleParameterオプションはどのような場合に使用しますか。

A: アップグレードが成功した場合、--increaseCompatibleParameterオプションを使用して、データベースのアップグレード中に互換性のあるパラメータを自動的に増やします。

Q: --executePrereqsオプションは何を行いますか。

A: --executePrereqsオプションは、アップグレード前のチェックのみを実行して、データベースのアップグレード準備が整っていることを確認します。

Q: アップグレード後の失敗したステップを処理するにはどうすればよいですか。

A: --postUpgradeオプションを使用して、アップグレード後の初期試行が失敗した場合にアップグレード後のステップを再実行します。

Q: --revertオプションの目的は何ですか?

A: --revertオプションは、Oracle Databaseを元のOracleホームに戻し、アップグレードを元に戻します。

Q: アップグレードのためにDBUAに固有の追加引数を渡すにはどうすればよいですか。

A: --upgradeOptionsオプションを使用して、Oracle DatabaseのアップグレードにDBUA固有の引数を渡します。サポートされる引数とオプションについては、Oracleドキュメントを参照してください。

Q: アップグレードのターゲットOracleホームの指定は必須ですか。

A: はい。アップグレードのターゲットOracleホームを示すには、--targetHomeまたは--targetHomeNameを指定する必要があります。

Q: アップグレード前チェックを実行する必要があるが、アップグレードを続行しない場合はどうすればよいですか。

A: --executePrereqsオプションを使用して、実際のアップグレードを続行せずにアップグレード前チェックのみを実行します。

例7-22 dbaascli database upgradeのアップグレード前の要件チェック

dbaascli database upgrade --dbbname dbname --targetHome Target Oracle home location --executePrereqs

Data Guard Management

この項では、Oracle Data Guardの構成および操作の管理について説明します。スタンバイ・サイトを設定するためのBLOBファイルを生成するdbaascli dataguard prepareStandbyBlobや、すべてのクラスタ・ノードでData Guard自動化属性を更新するdbaascli dataguard updateDGConfigAttributesなどのコマンドが含まれています。これらのコマンドにより、高可用性およびディザスタ・リカバリのためにData Guard環境の設定および保守が合理化されます。

dbaascli dataguard prepareStandbyBlob

データガード環境の場合にスタンバイ・サイトで必要な様々なファイルを含むBLOBファイルを生成するには、dbaascli dataguard prepareStandbyBlobコマンドを使用します。

rootまたはoracleユーザーとしてコマンドを実行します。

構文

dbaascli dataguard prepareStandbyBlob --dbname <value> --blobLocation <value>
説明:
  • --dbnameは、Oracle Database名を指定します
  • --blobLocationは、Data Guard環境でスタンバイBLOBファイルが生成されるカスタム・ディレクトリの場所を指定します

FAQ

Q: dbaascli dataguard prepareStandbyBlobコマンドの目的は何ですか。

A: dbaascli dataguard prepareStandbyBlobコマンドを使用して、Data Guard環境のスタンバイ・サイトで必要な様々なファイルを含むBLOBファイルを生成します。

Q: dbaascli dataguard prepareStandbyBlobコマンドを実行するための前提条件は何ですか。

A: rootまたはoracleユーザーとしてコマンドを実行する必要があります。

Q: スタンバイBLOBを準備するOracle Databaseの名前を指定するにはどうすればよいですか。

A: --dbnameオプションに続けて、Oracle Databaseの名前を指定します。例:

--dbname myDatabase

Q: スタンバイBLOBファイルが生成される場所を指定する方法は?

A: --blobLocationオプションを使用して、スタンバイBLOBファイルが生成されるカスタム・ディレクトリ・パスを指定します。例:

--blobLocation /path/to/standby_blob

Q: コマンドで--dbnameオプションは何を行いますか。

A: --dbnameオプションは、スタンバイBLOBファイルを準備するOracle Databaseの名前を指定します。

Q: --blobLocationオプションの目的は何ですか。

A: --blobLocationオプションは、スタンバイBLOBファイルが作成されるカスタム・ディレクトリ・パスを定義します。

Q: dbaascli dataguard prepareStandbyBlobコマンドをrootまたはoracle以外のユーザーとして実行できますか。

A: いいえ。このコマンドは、rootまたはoracleユーザーとして実行する必要があります。

Q: --blobLocationオプションに相対パスを使用できますか。

A: --blobLocationオプションの絶対パスを使用して、スタンバイBLOBファイルが正しいディレクトリに確実に作成されるようにすることをお薦めします。

Q: スタンバイBLOBファイルが生成される場所を変更する場合はどうすればよいですか?

A: --blobLocationオプションを変更して、スタンバイBLOBファイルの新しいディレクトリ・パスを指定します。

Q: スタンバイBLOBファイルを生成した後、追加のステップを実行する必要がありますか?

A: はい。スタンバイBLOBファイルを生成した後、スタンバイ・サイトに転送して、Data Guard構成に使用する必要があります。

dbaascli dataguard updateDGConfigAttributes

すべてのクラスタ・ノードにわたってData Guard自動化属性を更新するには、dbaascli dataguard updateDGConfigAttributesコマンドを使用します。

rootまたはoracleユーザーとしてコマンドを実行します。

構文

dbaascli dataguard updateDGConfigAttributes --attributes <value>
説明:
  • --attributesには、変更するData Guard自動化属性が含まれます。<attribute=value>の形式でカンマ区切りの値を受け入れます。属性は、Data Guard構成ファイルに事前定義されている必要があります。

FAQ

Q: dbaascli dataguard updateDGConfigAttributesコマンドの目的は何ですか。

A: dbaascli dataguard updateDGConfigAttributesコマンドは、すべてのクラスタ・ノードにわたってData Guard自動化属性を更新するために使用します。

Q: dbaascli dataguard updateDGConfigAttributesコマンドを実行するための前提条件は何ですか。

A: このコマンドは、rootまたはoracleユーザーとして実行する必要があります。

Q: このコマンドを使用して更新する属性を指定するにはどうすればよいですか?

A: --attributesオプションを使用し、その後に変更する属性を指定します。属性は、attribute=valueなどのカンマ区切り形式にする必要があります。例:

--attributes attribute1=value1,attribute2=value2

Q: --attributesオプションの値の形式は何ですか。

A: --attributesオプションの値は、attribute=valueとして指定された各属性のカンマ区切り形式にする必要があります。

Q: --attributesオプションで複数の属性を指定できますか?

A: はい、複数の属性をカンマで区切って指定できます。例:

--attributes attribute1=value1,attribute2=value2

Q: Data Guard構成ファイルで事前定義されていない属性を指定するとどうなりますか。

A: 事前定義されていない属性を指定した場合、コマンドは失敗するか、認識されない属性を無視する可能性があります。すべての属性がData Guard構成ファイルに事前定義されていることを確認します。

Q: Data Guard自動化属性を更新した後、サービスを再起動する必要がありますか。

A: ほとんどの場合、属性の更新後にサービスを再起動する必要はありません。ただし、特定の属性とその影響を確認して、再起動が必要かどうかを判断します。

Q: Data Guard属性が正常に更新されたかどうかを確認するにはどうすればいいですか。

A: コマンドの実行後、Data Guard構成を確認するか、設定に固有の適切な検証コマンド/ツールを使用して、更新された属性を確認できます。

Q: コマンドで属性の更新に失敗した場合はどうすればよいですか。

A: エラー・メッセージで、何が間違っているかの詳細を確認してください。正しい属性を指定し、Data Guard構成ファイルで事前定義されていることを確認します。ユーザー権限およびコマンド構文を確認します。

Q: このコマンドを使用して、特定のノードのみの属性を更新できますか。

A: いいえ。dbaascli dataguard updateDGConfigAttributesコマンドは、すべてのクラスタ・ノードの属性を更新します。特定のノードの属性を更新する必要がある場合は、異なるメソッドまたはコマンドを使用する必要があります。

データベース・ホームの管理

この項では、Oracle Databaseホームを管理するためのツールを提供します。これには、新しいOracle Databaseホームを作成するdbaascli dbhome createや、既存のホームを削除するdbaascli dbHome deleteなどのコマンドが含まれます。また、dbaascli dbHome getDetailsを使用して特定のOracleホームに関する詳細情報を表示し、dbaascli dbhome getDatabasesを使用して特定のOracleホームから実行されているデータベースを確認することもできます。これらのコマンドにより、データベース環境の効率的な管理が保証されます。

dbaascli dbhome create

目的のバージョンのOracle Databaseホームを作成するには、dbaascli dbhome createコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli dbhome create --version <value>
[--oracleHome <value>]
[--oracleHomeName <value>]
[--enableUnifiedAuditing <value>] 
[--imageTag <value>]
[--ImageLocation <value>
説明:
  • --versionは、Oracleホームのバージョンを指定します。ピリオドで区切られた5つの数値セグメントとして指定します(例: 19.12.0.0.0)。
  • --oracleHomeは、Oracleホームの場所を指定します
  • --oracleHomeNameは、ユーザー定義のOracleホーム名を指定します。指定しない場合、デフォルト名が使用されます
  • --enableUnifiedAuditingは、Oracleホームで統合監査リンク・オプションを有効または無効にするためのtrueまたはfalseを指定します
  • --imageTagは、Oracleホーム・イメージ・タグを指定します
  • --imageLocation - 使用するイメージのパス。
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: trueまたはfalse

FAQ

Q: dbaascli dbhome createコマンドの目的は何ですか。

A: dbaascli dbhome createコマンドを使用して、新しいOracle Databaseホームを目的のバージョンで作成します。

Q: dbaascli dbhome createコマンドを実行するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: 新しいOracle Homeの作成時にOracle Databaseのバージョンを指定するにはどうすればよいですか。

A: ピリオドで区切られた5つの数値セグメント(19.11.0.0.0など)の形式で、--versionオプションに続けてOracle Databaseバージョンを指定します。

Q: --oracleHomeオプションは何を指定しますか。

A: --oracleHomeオプションは、Oracle Homeをインストールする場所を指定します。指定しない場合、デフォルトの場所が使用されます。

Q: 新しいOracle Homeにカスタム名を割り当てることができますか。

A: はい。--oracleHomeNameオプションを使用して、Oracle Homeのユーザー定義名を指定できます。指定されていない場合は、デフォルト名が使用されます。

Q: 新しいOracle Homeで統合監査を有効または無効にするにはどうすればよいですか。

A: --enableUnifiedAuditingオプションを使用してtrueを指定し、Oracle Homeの統合監査を無効にするにはfalseを指定します。

Q: --imageTagオプションは何を行いますか。

A: --imageTagオプションは、Oracle Homeイメージ・タグを指定します。これは、イメージ・タグがバージョンと異なる場合に使用できます。

Q: dbaascli dbhome createコマンドをversionおよびimageタグとともに使用する例は何ですか。

A: versionタグとimageタグを使用したコマンドの例を次に示します。

dbaascli dbhome create --version 19.8.0.0.0 --imageTag 19.8.0.0.0

これにより、対応するイメージ・タグを持つバージョン19.8.0.0.0のOracle Homeが作成されます。

Q: --oracleHomeまたは--oracleHomeNameオプションを指定しないとどうなりますか。

A: --oracleHomeを指定しない場合、Oracle Homeはデフォルトの場所にインストールされます。--oracleHomeNameを指定しない場合、デフォルト名がOracle Homeに割り当てられます。

Q: Oracle Homeの作成が成功したかどうかを確認するにはどうすればよいですか。

A: コマンドの実行後、出力ログで成功メッセージまたはエラーを確認します。指定した場所に移動するか、orainstRoot.shなどのOracleツールを使用して、Oracle Homeを検証することもできます。

Q: 同じシステム上に異なるバージョンを持つ複数のOracle Homesを作成できますか。

A: はい。--versionオプションと--oracleHomeNameオプションに異なる値を指定することで、異なるバージョンで複数のOracle Homesを作成できます。

Q: Oracle Homeの作成に失敗した場合はどうすればよいですか。

A: エラー・メッセージの詳細は、出力ログを確認してください。正しいバージョン形式、必要な権限および十分なディスク領域があることを確認します。問題を修正してから、コマンドを再実行してください。

例7-23 dbaascli dbhome create

dbaascli dbhome create --version 19.11.0.0.0

または、イメージ・タグがバージョンと異なる場合はdbaascli dbhome create --version 19.8.0.0.0.0 --imageTag 19.8.0.0.0

dbaascli dbHome delete

特定のOracle Databaseホームを削除するには、dbaascli dbHome deleteコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli dbHome delete 
{ --oracleHome <value> 
| --oracleHomeName <value> } [--resume [--sessionID <value>]] 
説明:
  • --oracleHomeは、Oracleホームの場所を指定します
  • --oracleHomeNameは、Oracleホームの名前を指定します
  • --resumeは、前回の実行を再開します
    • --sessionIDは、特定のセッションIDを再開するように指定します

FAQ

Q: dbaascli dbHome deleteコマンドの目的は何ですか。

A: dbaascli dbHome deleteコマンドは、指定したOracle Databaseホームをシステムから削除するために使用します。

Q: dbaascli dbHome deleteコマンドを実行するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: 削除するOracle Homeはどのように指定するのですか。

A: 次のいずれかのオプションを使用して、削除するOracle Homeを指定できます。

--oracleHome <value>: Oracle Homeの場所の絶対パスを指定します。

--oracleHomeName <value>: Oracle Homeの名前を指定します。

Q: --oracleHomeオプションと--oracleHomeNameオプションの違いは何ですか。

A:

--oracleHomeは、削除するOracle Homeの物理的な場所またはパスを指定します。

--oracleHomeNameは、削除するOracle Homeのユーザー定義名を指定します。

Q: 以前に中断した削除プロセスを再開するにはどうすればよいですか?

A: --resumeオプションを使用して、以前の削除プロセスを再開できます。プロセスの特定のセッションIDがわかっている場合は、--sessionIDオプションを使用して含めることができます。

Q: dbaascli dbHome deleteコマンドで使用される--sessionIDオプションは何ですか。

A: --sessionIDオプションは、削除プロセス中に以前に中断または失敗した特定のセッションを再開するために使用されます。

Q: --resumeまたは--sessionIDオプションを指定しないとどうなりますか?

A: --resumeまたは --sessionIDオプションが指定されていない場合、コマンドは中断された削除プロセスを再開するのではなく、新しい削除プロセスを開始します。

Q: コマンドの実行後にOracle Homeの削除を確認する方法はありますか。

A: 出力ログで成功メッセージを確認し、Oracle Homeディレクトリが指定の場所に存在しなくなったことを確認することで、削除を確認できます。

Q: 実行中のデータベースで現在使用中のOracle Homeを削除できますか。

A: いいえ。削除プロセス中、実行中のデータベースまたはサービスでOracle Homeを使用しないでください。削除コマンドを実行する前に、関連するデータベースをすべて停止してください。

Q: dbaascli dbHome deleteコマンドが失敗した場合、どうすればよいですか。

A: 出力ログでエラー・メッセージを確認します。Oracle Homeが使用されていないことを確認し、正しいOracle Homeの場所または名前を確認し、必要な権限があることを確認します。問題を解決したら、コマンドを再実行するか、必要に応じて --resumeオプションを使用します。

Q: dbaascli dbHome deleteコマンドを使用して複数のOracle Homesを一度に削除できますか。

A: いいえ。このコマンドでは、--oracleHomeまたは--oracleHomeNameオプションのいずれかを指定して、一度に1つのOracle Homeのみを削除できます。

Q: 名前でOracle Homeを削除する例は何ですか。

A: Oracle Homeを名前で削除する例を次に示します。

dbaascli dbHome delete --oracleHomeName myOracleHome

このコマンドは、myOracleHomeという名前のOracle Homeを削除します。

Q: Oracle Homeをその場所によって削除する例は何ですか。

A: Oracle Homeの場所を指定して削除する例を次に示します。

dbaascli dbHome delete --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

このコマンドは、/u01/app/oracle/product/19.0.0/dbhome_1にあるOracle Homeを削除します。

Q: 削除プロセスは開始後にキャンセルできますか?

A: いいえ、削除プロセスが開始されると、取り消すことはできません。コマンドを実行する前に、Oracle Homeが削除の準備ができていることを確認します。

dbaascli dbhome getDatabases

特定のデータベースOracleホームから実行されているすべてのOracle Databaseに関する情報を表示するには、dbaascli dbHome getDatabasesコマンドを使用します。Oracleホームの場所またはOracleホーム名のいずれかを指定します。

rootユーザーとしてコマンドを実行します。

構文

dbaascli dbHome getDatabases
{ --oracleHomeName value | --oracleHome value }
説明:
  • --oracleHomeNameは、ユーザー定義のOracleホーム名を指定します
  • --oracleHomeは、Oracleホームの場所(パス)を指定します

FAQ

Q: dbaascli dbHome getDatabasesコマンドの目的は何ですか。

A: dbaascli dbHome getDatabasesコマンドは、指定したOracle Databaseホームから実行されているすべてのOracle Databasesに関する情報を表示するために使用します。

Q: 確認するOracle Databaseホームを指定するにはどうすればよいですか。

A: 次のいずれかのオプションを使用して、Oracle Databaseホームを指定できます。

--oracleHomeName <value>: Oracleホームのユーザー定義名を指定します。

--oracleHome <value>: Oracleホームの完全な場所(パス)を指定します。

Q: --oracleHomeNameオプションと--oracleHomeオプションの違いは何ですか。

A:

--oracleHomeNameは、Oracleホームのユーザー定義名です。

--oracleHomeは、システム上のOracleホームの物理的な場所(またはディレクトリ・パス)を示します。

Q: dbaascli dbHome getDatabasesコマンドはどのように実行するのですか。

A: コマンドを実行するには、次の構文を使用します。

dbaascli dbHome getDatabases --oracleHomeName <value>

または

dbaascli dbHome getDatabases --oracleHome <value>

rootユーザーとしてコマンドを実行してください。

Q: Oracleホーム名とOracleホームの両方の場所を同じコマンドで指定できますか。

A: いいえ、--oracleHomeNameまたは--oracleHomeは1回のコマンド実行でのみ指定できます。Oracleホームの識別方法に基づいて、1つのオプションを選択します。

Q: dbaascli dbHome getDatabasesコマンドではどのような情報が返されますか。

A: このコマンドは、指定したOracleホームから実行されているすべてのOracle Databasesに関する情報を返します。これには、データベース名やステータスなどの詳細が含まれます。

Q: Oracleホームの場所でdbaascli dbHome getDatabasesを使用する例は何ですか。

A: Oracleホームの場所を指定してコマンドを使用する例を次に示します。

dbaascli dbHome getDatabases --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

このコマンドは、/u01/app/oracle/product/19.0.0/dbhome_1にあるOracleホームから実行中のデータベースのリストを取得します。

Q: Oracleホーム名でdbaascli dbHome getDatabasesを使用する例は何ですか。

A: Oracleホーム名を指定してコマンドを使用する例を次に示します。

dbaascli dbHome getDatabases --oracleHomeName myOracleHome

このコマンドは、myOracleHomeという名前のOracleホームから実行中のデータベースのリストを取得します。

Q: このコマンドを実行するには特別な権限が必要ですか?

A: はい、rootユーザーとしてコマンドを実行して、指定したOracleホームから実行されているOracle Databasesに関する情報を表示する必要があります。

Q: dbaascli dbHome getDatabasesコマンドでデータベースが返されない場合は、何を確認する必要がありますか。

A: 正しいOracleホームの名前または場所を指定し、そのOracleホームから実行されているデータベースがあることを確認します。また、Oracleホームが正しく構成され、アクティブであることを確認します。

Q: 複数のOracleホームで一度にdbaascli dbHome getDatabasesコマンドを使用できますか。

A: いいえ、このコマンドは一度に1つのOracleホームで動作します。問い合せるOracleホームごとに、コマンドを個別に実行する必要があります。

Q: コマンドで指定されたOracleホームが正しいことを確認する方法はありますか。

A: Oracleホームを確認するには、システム内のディレクトリ構造または構成の詳細をチェックして、指定されたパスまたは名前が実際のOracleホームと一致していることを確認します。

Q: OracleホームまたはOracleホーム名を指定せずにコマンドを実行するとどうなりますか。

A: このコマンドでは、--oracleHomeまたは--oracleHomeNameオプションを指定する必要があります。どちらのオプションも指定されていない場合、コマンドの実行は失敗します。

Q: このコマンドは、現在停止しているデータベースを取得できますか?

A: はい。コマンドは、現在実行中か停止中かに関係なく、指定されたOracleホームに関連付けられているすべてのデータベースをリストします。

例7-24 dbaascli dbHome getDatabases --oracleHome

dbaascli dbHome getDatabases --oracleHome /u02/app/mar_home/
dbaascli dbHome getDetails

特定のOracleホームに関する情報を表示するには、dbaascli dbHome getDetailsコマンドを使用します。Oracleホームの場所またはOracleホーム名のいずれかを指定します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli dbHome getDetails
{ --oracleHomeName value | --oracleHome value }
説明:
  • --oracleHomeNameは、ユーザー定義のOracleホーム名を指定します
  • --oracleHomeは、Oracleホームの場所を指定します

FAQ

Q: dbaascli dbHome getDetailsコマンドの目的は何ですか。

A: dbaascli dbHome getDetailsコマンドは、システム上の特定のOracleホームに関する詳細情報を表示するために使用します。

Q: 詳細を取得するOracleホームはどのように指定するのですか。

A: 次のいずれかのオプションを使用して、Oracleホームを指定できます。

--oracleHomeName <value>: Oracleホームのユーザー定義名を指定します。

--oracleHome <value>: Oracleホームの完全な場所(パス)を指定します。

Q: --oracleHomeNameと--oracleHomeの違いは何ですか?

A:

--oracleHomeNameは、Oracleホームのユーザー定義の名前です。

--oracleHomeは、Oracleホームのある場所のフル・ディレクトリ・パスです。

Q: dbaascli dbHome getDetailsコマンドはどのように実行するのですか。

A: コマンドを実行するには、次の構文を使用します。

dbaascli dbHome getDetails --oracleHomeName <value>

または

dbaascli dbHome getDetails --oracleHome <value>

rootユーザーとしてコマンドを実行してください。

Q: 同じコマンドで--oracleHomeNameと--oracleHomeの両方を指定できますか?

A: いいえ、コマンド実行ごとに1つのオプションのみを使用できます。Oracleホームの名前またはOracleホームの場所のいずれか(両方ではなく)を指定する必要があります。

Q: dbaascli dbHome getDetailsコマンドではどのような情報が返されますか。

A: このコマンドは、指定したOracleホームの詳細情報(バージョン、ステータス、Oracleホームに関連付けられたその他の構成の詳細など)を提供します。

Q: Oracleホームの場所でdbaascli dbHome getDetailsコマンドを使用する例は何ですか。

A: 次に例を示します。

dbaascli dbHome getDetails --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

このコマンドは、/u01/app/oracle/product/19.0.0/dbhome_1にあるOracleホームに関する詳細情報を取得します。

Q: Oracleホーム名でdbaascli dbHome getDetailsコマンドを使用する例は何ですか。

A: 次に例を示します。

dbaascli dbHome getDetails --oracleHomeName myOracleHome

このコマンドは、myOracleHomeという名前のOracleホームに関する詳細情報を取得します。

Q: このコマンドを実行するには特別な権限が必要ですか?

A: はい。Oracleホームの詳細を表示するには、rootユーザーとしてコマンドを実行する必要があります。

Q: dbaascli dbHome getDetailsコマンドで情報が返されない場合はどうすればよいですか。

A: Oracleホームの名前または場所を正しく指定し、Oracleホームが適切に構成され、システムに存在することを確認します。

Q: 複数のOracleホームでdbaascli dbHome getDetailsコマンドを同時に使用できますか。

A: いいえ、このコマンドは一度に1つのOracleホームでのみ機能します。コマンドは、Oracleホームごとに個別に実行する必要があります。

Q: コマンドを実行する前にOracleホーム名を確認することはできますか。

A: はい。システムの構成ファイルを確認するか、システムで使用可能なすべてのOracleホームをリストすることで、Oracleホーム名を確認できます。

Q: コマンドにOracleホームの名前または場所を指定しないとどうなりますか。

A: このコマンドでは、--oracleHomeまたは--oracleHomeNameオプションを指定する必要があります。どちらも指定しない場合、コマンドの実行は失敗します。

Q: 現在使用されていないOracleホームに関する情報を取得できますか。

A: はい。dbaascli dbHome getDetailsコマンドは、使用中かアイドル状態かにかかわらず、Oracleホームに関する詳細を提供します。

Q: コマンドがエラーを返すかどうかを確認するべきですか?

A: Oracleホームの名前または場所が正しいこと、Oracleホームが存在すること、およびrootユーザーとしてコマンドを実行していることを確認します。入力ミスまたはパスが間違っているかどうかをダブルチェックします。

例7-25 dbaascli dbHome getDetails - Oracleホームの場所の使用

dbaascli dbHome getDetails --oracleHome /u02/app/home_db19c/

例7-26 dbaascli dbHome getDetails - Oracleホーム名の使用

dbaascli dbHome getDetails --oracleHomeName home_db19c

診断およびヘルス・チェック

この項では、Oracle Database環境での状態を維持し、問題を診断するためのツールについて説明します。dbaascli diag collectなどのコマンドは診断データの収集に使用されますが、dbaascli diag healthCheckでは、潜在的な問題を識別するためにヘルス・チェックを実行できます。これらのツールは、懸念事項を事前に監視して対処することで、システムの安定性とパフォーマンスを確保するのに役立ちます。

dbaascli diag collect

診断を収集するには、dbaascli diag collectコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli diag collect [--components <value>] [--startTime <value>] [--endTime <value>] [--nodes <value>] [--dbNames <value>]
        {
            [--objectStoreBucketUri <value>]
            | [--destLocation <value>]
        }
        [--waitForCompletion <value>]
説明:
  • --componentsは、ログ収集のコンポーネントのリストを指定します。

    有効な値:

    • db
    • gi
    • os
    • dbaastools
    • all
  • --startTimeは、ログ収集の開始時間を指定します。有効な日時フォーマット: YYYY-MM-DDTHH24:MM:SS
  • --endTimeは、ログ収集の終了時間を指定します。有効な日時フォーマット: YYYY-MM-DDTHH24:MM:SS
  • --nodesは、ログを収集するノードのカンマ区切りリストを指定します
  • --dbNamesは、ログを収集するデータベース名を指定します。データベース名は1つのみ指定できます。
  • --objectStoreBucketURIは、収集されたログのアップロードに使用されるオブジェクト・ストレージ・サービスの事前認証済リクエスト(PAR) URLを指定します。ログはゲストVMから収集されます。詳細は、事前認証済リクエストの使用を参照してください。
  • --destLocationは、ログを収集するゲストVM上の場所を指定します。デフォルト: /var/opt/oracle/dbaas_acfs
  • --waitForCompletionの値: true|false。デフォルトはtrueです。バックグラウンドで実行するには、falseを指定します。

FAQ

Q: dbaascli diag collectコマンドの目的は何ですか。

A: dbaascli diag collectコマンドは、Oracle DatabaseおよびOS、Grid Infrastructure (GI)およびDBaaSツールなどの関連コンポーネントの診断ログを収集するために使用されます。

Q: 診断を収集するコンポーネントを指定するにはどうすればよいですか。

A: --componentsオプションを使用してコンポーネントを指定できます。有効な値は:

db (データベース・ログの場合)

gi (Grid Infrastructureログの場合)

os (オペレーティング・システム・ログ用)

dbaastools (DBaaSツール・ログ用)

all (すべてのコンポーネントのログを収集する場合)

Q: 特定の時間範囲のログを収集するにはどうすればよいですか?

A: 時間範囲を指定するには、次のオプションを使用します。

--startTime <value>: ログ収集の開始時間を設定します。

--endTime <value>: ログ収集の終了時間を設定します。

時刻は、YYYY-MM-DDTHH24:MM:SSの形式にする必要があります。

Q: 開始時間と終了時間はどの形式にすればよいですか。

A: --startTime--endTimeの両方をYYYY-MM-DDTHH24:MM:SSの形式にする必要があります。たとえば、2024-09-01T15:30:00です。

Q: 診断を収集するノードを指定する方法を教えてください。

A: --nodesオプションを使用して、ノードのカンマ区切りリストを指定できます。例:

--nodes node1,node2

Q: 特定のデータベースのログはどのように収集するのですか。

A: --dbNamesオプションを使用して、ログを収集するデータベースの名前を指定します。一度に指定できるデータベース名は1つのみです。

Q: 収集されたログはどのようにObject Storageに格納できますか。

A: --objectStoreBucketUriオプションを使用して、ログがアップロードされるオブジェクト・ストレージ・バケットの事前認証済リクエスト(PAR) URLを指定します。

Q: Object Storageではなくローカル・ディレクトリにログを収集できますか。

A: はい、--destLocationオプションを使用して、ログが収集されるゲストVM上のディレクトリを指定できます。デフォルトの場所は、/var/opt/oracle/dbaas_acfsです。

Q: ログの宛先を指定しないとどうなりますか。

A: 宛先が指定されていない場合、収集されたログはゲストVMのデフォルトの場所/var/opt/oracle/dbaas_acfsに格納されます。

Q: --waitForCompletionオプションは何を行いますか。

A: --waitForCompletionオプションは、制御をユーザーに返す前にコマンドが終了するまで待機するかどうかを指定します。デフォルト値はtrueです。falseを指定すると、操作はバックグラウンドで実行されます。

Q: バックグラウンドでログ収集を実行するにはどうすればよいですか?

A: --waitForCompletionオプションをfalseに設定して、ログ収集プロセスをバックグラウンドで実行します。

dbaascli diag collect --waitForCompletion false

Q: このコマンドで以前のログ収集セッションを再開できますか?

A: いいえ。dbaascli diag collectコマンドでは、以前のセッションの再開はサポートされていません。新しいログ収集プロセスを開始する必要があります。

Q: ログがObject Storageに直接アップロードされるようにするにはどうすればよいですか。

A: 収集後にログがアップロードされる有効な--objectStoreBucketUri (オブジェクト・ストレージの事前認証済リクエストURL)を指定できます。

Q: 複数のデータベースのログを一度に収集できますか?

A: いいえ、--dbNamesオプションを使用して一度に指定できるデータベース名は1つのみです。

Q: すべてのコンポーネントで利用可能なすべてのログを収集する場合はどうすればよいですか?

A: --components allを使用して、データベース、Grid Infrastructure、オペレーティング・システム、DBaaSツールを含むすべてのコンポーネントからログを収集します。

Q: 特定の時間範囲からデータベース・コンポーネントのログを収集するコマンドの例は何ですか。

A: コマンドの例を次に示します。

dbaascli diag collect --components db --startTime 2024-09-01T12:00:00 --endTime 2024-09-01T14:00:00 --dbname orcl

Q: ログを収集してObject Storageにアップロードするコマンドの例を教えてください。

A: コマンドの例を次に示します。

dbaascli diag collect --components db --objectStoreBucketUri https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL

Q: --componentsオプションが指定されていない場合のデフォルトの動作は何ですか。

A: --componentsオプションを指定しないと、収集するログがコマンドで認識されず、失敗する可能性があります。ログを収集するコンポーネントを常に指定することをお薦めします。

Q: --objectStoreBucketUriオプションと--destLocationオプションの両方を同じコマンドに指定できますか。

A: いいえ、1つの宛先(--objectStoreBucketUriを介したオブジェクト・ストレージまたは--destLocationを介したローカル・ディレクトリ)を選択する必要があります。

Q: dbaascli diag collectコマンドの使用中にエラーが発生した場合はどうすればよいですか。

A: 有効なコンポーネント名、日時書式および宛先オプションを指定していることを再度確認します。また、rootユーザーとしてコマンドを実行していることを確認します。

dbaascli diag healthCheck

診断ヘルス・チェックを実行するには、dbaascli diag healthCheckコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli diag healthCheck
[--destLocation]
[--nodes]
[--objectStoreBucketURI]
説明:
  • --destLocationは、ログを収集するゲストVM上の場所を指定します。デフォルト: /var/opt/oracle/dbaas_acfs
  • --nodesは、ログを収集するノードのカンマ区切りリストを指定します
  • --objectStoreBucketURIは、収集されたログのアップロードに使用されるオブジェクト・ストレージ・サービスの事前認証済リクエスト(PAR) URLを指定します。ログはゲストVMから収集されます。詳細は、事前認証済リクエストの使用を参照してください。

FAQ

Q: dbaascli diag healthCheckコマンドの目的は何ですか。

A: dbaascli diag healthCheckコマンドは、Exadata Cloud@Customer環境で実行されているOracle Databaseで診断ヘルス・チェックを実行するために使用します。

Q: dbaascli diag healthCheckコマンドを使用するための前提条件は何ですか。

A: コマンドはrootユーザーとして実行する必要があり、Exadata Cloud@Customer仮想マシンに接続している必要があります。

Q: ログを収集するためのカスタムディレクトリを指定する方法を教えてください。

A: --destLocationオプションを使用して、ヘルス・チェック・ログが収集されるディレクトリを指定します。デフォルトの場所は、/var/opt/oracle/dbaas_acfsです。

Q: --destLocationを指定しない場合、ログ収集のデフォルトの場所は何ですか。

A: ログ収集のデフォルト・ディレクトリは/var/opt/oracle/dbaas_acfsです。

Q: ヘルス・チェックを実行するノードは指定できますか。

A: はい。--nodesオプションを使用して、ヘルス・チェックを実行するノードのカンマ区切りリストを指定できます。

Q: ヘルス・チェック・ログはどのようにObject Storageにアップロードするのですか。

A: --objectStoreBucketURIオプションを使用して、オブジェクト・ストレージ・サービスから事前認証済リクエスト(PAR) URLを指定します。これにより、収集されたログが指定のバケットにアップロードされます。

Q: 複数のノードからログを収集できますか?

A: はい。--nodesオプションを使用して、カンマ区切り形式で複数のノードを指定できます。たとえば: --nodes node1,node2

Q: 特定のノードでヘルス・チェックを実行するコマンドの例は何ですか。

A: 特定のノードでヘルス・チェックを実行するコマンドの例を次に示します。

dbaascli diag healthCheck --nodes node1

Q: ログは、ローカル・マシンではなくObject Storageに格納するにはどうすればよいですか。

A: --objectStoreBucketURIオプションを使用して、オブジェクト・ストレージにログを格納する事前認証済リクエスト(PAR) URLを指定できます。

Q: --destLocationと--objectStoreBucketURIの両方を同時に指定できますか?

A: はい。ローカル・ストレージには--destLocationを、オブジェクト・ストレージには--objectStoreBucketURIの両方を指定してログをアップロードできます。

Q: dbaascli diag healthCheckコマンドの実行中にエラーが発生した場合はどうすればよいですか。

A: rootユーザーとしてコマンドを実行し、--destLocation--nodesまたは--objectStoreBucketURIに有効なオプションを指定していることを確認します。指定した場合は、ノード名が正しいことを確認します。

Q: 健康診断をバックグラウンドで実行できますか?

A: dbaascli diag healthCheckコマンドには明示的なバックグラウンド・モードはありませんが、コマンドの最後に&を追加してバックグラウンドで実行できます。

Q: --nodesオプションを指定しないとどうなりますか?

A: --nodesオプションを指定しない場合、デフォルトでクラスタ内のすべてのノードでヘルス・チェックが実行されます。

Q: このコマンドを使用して、以前のヘルス・チェック・セッションを再開できますか。

A: いいえ。dbaascli diag healthCheckコマンドでは、以前のセッションの再開はサポートされていません。毎回、新しいヘルス・チェックを開始する必要があります。

Q: ヘルス・チェックを実行し、ログをObject Storageにアップロードするコマンドの例は何ですか。

A: コマンドの例を次に示します。

dbaascli diag healthCheck --objectStoreBucketURI https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL

Q: --destLocationまたは--objectStoreBucketURIを指定しない場合のデフォルトの動作は何ですか。

A: --destLocation--objectStoreBucketURIも指定されていない場合、ヘルス・チェック・ログはローカル・マシンのデフォルト・ディレクトリ/var/opt/oracle/dbaas_acfsに収集されます。

Q: ヘルス・チェックを特定のコンポーネントまたはログに制限できますか。

A: いいえ。dbaascli diag healthCheckコマンドでは、個々のコンポーネントまたはログを指定できません。システムの一般的な診断ヘルス・チェックを実行します。

Q: dbaascli diag healthCheckコマンドを実行する前に、何を確認する必要がありますか。

A: Exadata Cloud@Customer仮想マシンに接続し、rootユーザーとしてコマンドを実行していることを確認します。

Grid Infrastructureの管理

この項では、クラスタリングおよび高可用性をサポートするOracle Grid Infrastructureの管理に重点を置きます。主なタスクには、Grid Infrastructureホームの構成(dbaascli gridHome create)、Grid Infrastructureのアップグレード(dbaascli grid upgrade)およびTCPS (Transport Layer Security)証明書の構成(dbaascli grid configureTCPS)、削除(dbaascli grid removeTCPSCert)またはローテーション(dbaascli grid rotateTCPSCert)による管理が含まれます。これらのコマンドにより、Grid Infrastructureの効率的な設定、メンテナンスおよびセキュリティが確保されます。

dbaascli gridHome create

Grid Infrastructureホームを構成するには、dbaascli gridHome createコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli gridHome create --version value [--resume [--sessionID value]] [--waitForCompletion value]
説明:
  • --versionは、Gridホームのバージョンを指定します
  • --resumeは、前回の実行を再開します
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: true|false

FAQ

Q: dbaascli gridHome createコマンドの目的は何ですか。

A: dbaascli gridHome createコマンドは、Exadata Cloud@Customer環境でOracle GridインフラストラクチャのGrid Infrastructureホームを構成するために使用します。

Q: dbaascli gridHome createコマンドを実行するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: 作成するGrid Infrastructureホームのバージョンを指定するにはどうすればよいですか。

A: --versionオプションを使用して、Gridホームのバージョンを指定します。これは、Gridホームの作成時に必須のオプションです。

Q: 以前のdbaascli gridHome createセッションを再開できますか。

A: はい、--resumeオプションを使用して前のセッションを再開できます。オプションで、--sessionIDオプションを使用してセッションIDを指定して、特定のセッションを再開できます。

Q: dbaascli gridHome createコマンドで--resumeオプションは何を行いますか。

A: --resumeオプションを使用すると、以前に中断された操作または不完全な操作を再開できます。

Q: バックグラウンドで操作を実行するにはどうすればよいですか?

A: --waitForCompletionオプションをfalseに設定して、バックグラウンドで操作を実行できます。このオプションの有効な値は、true (デフォルト)またはfalseです。

Q: --waitForCompletionが指定されていない場合のデフォルトの動作は何ですか。

A: --waitForCompletionを指定しない場合、操作はフォアグラウンドで実行され、コマンドは操作が完了するまで待機してから、ユーザーに制御を戻します。

Q: --sessionIDオプションの目的は何ですか。

A: --sessionIDオプションは、操作が不完全または中断された場合、再開する前のセッションのIDを指定するために使用します。

Q: dbaascli gridHome createコマンドを使用して既存のGridホームをアップグレードできますか。

A: いいえ。このコマンドは、既存のホームをアップグレードするのではなく、新しいGrid Infrastructureホームを構成するために特に使用します。

Q: バージョン19.9.0.0.0のGridホームを作成するコマンドの例は何ですか。

A: コマンドの例を次に示します。

dbaascli gridHome create --version 19.9.0.0.0

Q: dbaascli gridHome createコマンドが中断された場合、どうすればよいですか。

A: --resumeオプションを使用して操作を再開できます。セッションIDがある場合は、--sessionIDオプションを使用して指定し、特定のセッションを再開できます。

Q: セッションIDなしで--resumeオプションを指定できますか?

A: はい。セッションIDを指定せずに--resumeオプションを使用できます。この場合、システムは最新のセッションを再開しようとします。

Q: --waitForCompletion falseを指定するとどうなりますか。

A: --waitForCompletion falseを指定すると、操作はバックグラウンドで実行され、操作の完了中にコマンドラインの使用を続行できます。

Q: バックグラウンド操作の進行状況を追跡することはできますか?

A: dbaascliコマンドでは、バックグラウンド操作を直接追跡する方法は提供されません。システム・ログまたはセッション・ステータスを手動で確認する必要がある場合があります。

Q: 無効なGridホームのバージョンは作成時に指定できますか?

A: いいえ。--versionオプションには有効なGrid Infrastructureバージョンが含まれている必要があります。無効なバージョンが指定されている場合、コマンドはエラーを返します。

Q: 作成に使用するGridホームのバージョンを確認するにはどうすればよいですか。

A: Oracleのドキュメントを参照するか、データベース管理者に問い合せて、使用している環境で使用する正しいGridホームのバージョンを判断できます。

Q: dbaascli gridHome createコマンドを実行する前に、何を確認する必要がありますか。

A: rootユーザーとしてログインしており、Grid Infrastructureに使用するバージョンが環境と互換性があることを確認します。

dbaascli grid configureTCPS

既存のクラスタにTCPSを構成するには、dbaascli grid configureTCPSコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

ノート

デフォルトでは、Oracle Exadata Database Service on Dedicated Infrastructureシステムのデータベースに対してTCPSは有効になっています。
ノート

TCPSは、Exadata Database Service on Cloud@Customerのデータベースでは有効ではありません。特定のデータベースに対してTCPSを有効にするには、すべてのデータベース・ノードでデータベース固有のsqlnet.oraファイルをWALLET_LOCATION = (SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=/var/opt/oracle/dbaas_acfs/grid/tcps_wallets)))で更新してから、データベースを再起動します。これにより、データベースに対してTCPSの使用が有効になります。ただし、TCPSを有効にすると、ZDLRA接続が失敗します。Exadata Database Service on Cloud@Customerシステムでは、ZDLRAまたはTCPS構成のいずれかを有効にできます。ZDLRAとTCPSの両方を同時に有効にすると、機能しません。
dbaascli grid configureTCPS
[--pkcs12WalletFilePath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
説明:
  • --pkcs12WalletFilePathは、証明書ファイルの絶対パス(pkcs12ウォレット形式)を指定します
  • --caCertChainは、中間CAおよびルートCA証明書を含む証明書の連結リストです
  • --precheckOnlyは、yesを指定するとこの操作の事前チェックのみが実行されます。有効な値: yesまたはno
  • --serverCertは、TCPS構成で使用またはローテーションするPEM証明書のパスを指定します。
  • --privateKeyは、証明書の秘密キー・ファイルのパスを指定します。
  • --certTypeは、Grid Infrastructureウォレットに追加する証明書のタイプです。許容される値は、SELF_SIGNED_CERTCA_SIGNED_CERTまたはPKCS12_CERTです。デフォルト: SELF_SIGNED_CERT
  • --privateKeyPasswordProtectedは、秘密キーがパスワードで保護されるかどうかを指定します。有効な値: trueまたはfalseデフォルト: true

FAQ

Q: dbaascli grid configureTCPSコマンドの目的は何ですか。

A: dbaascli grid configureTCPSコマンドは、Oracle Exadata環境の既存のクラスタに対してTransport Layer Security (TCPS)を構成するために使用します。

Q: dbaascli grid configureTCPSコマンドを実行する前提条件は何ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: Exadata Database Service on Dedicated Infrastructureシステムでは、TCPSはデフォルトで有効になっていますか。

A: はい。Oracle Exadata Database Service on Dedicated Infrastructureシステムのデータベースでは、TCPSはデフォルトで有効になっています。

Q: Exadata Database Service on Cloud@Customerシステムでは、TCPSはデフォルトで有効になっていますか。

A: いいえ。Exadata Database Service on Cloud@Customerシステムでは、TCPSはデフォルトで有効になっていません。TCPSを有効にするには、特定のデータベースのsqlnet.oraファイルを更新し、データベースを再起動する必要があります。

Q: Exadata Cloud@CustomerシステムでTCPSを有効にした結果はどうなりますか。

A: Exadata Cloud@CustomerシステムでTCPSを有効にすると、Zero Data Loss Recovery Appliance (ZDLRA)接続が失敗します。ZDLRAまたはTCPS構成のいずれかのみを有効にできますが、両方を同時に有効にすることはできません。

Q: --pkcs12WalletFilePathオプションは何を指定しますか。

A: --pkcs12WalletFilePathオプションは、TCPS構成に使用されるPKCS12ウォレット形式の証明書ファイルへの絶対パスを指定します。

Q: --caCertChainオプションは何に使用されますか。

A: --caCertChainオプションは、中間CA証明書およびルートCA証明書を含む証明書の連結リストを指定します。

Q: --precheckOnlyオプションは何を行いますか。

A: --precheckOnlyオプションは、TCPS構成操作の事前チェックのみを実行するかどうかを指定します。使用可能な値は、yesまたはnoです。

Q: --serverCertオプションは何を指定しますか。

A: --serverCertオプションは、TCPS構成に使用またはローテーションされるPEM証明書へのパスを指定します。

Q: TCPS構成の秘密キーはどのように指定するのですか。

A: --privateKeyオプションを使用して、サーバー証明書に関連付けられた秘密キー・ファイルへのパスを指定します。

Q: --certTypeオプションに使用できる値は何ですか。

A: --certTypeオプションに使用できる値は、次のとおりです:

SELF_SIGNED_CERT

CA_SIGNED_CERT

PKCS12_CERT

デフォルト値はSELF_SIGNED_CERTです。

Q: 秘密鍵のパスワードはデフォルトで保護されていますか?

A: はい、--privateKeyPasswordProtectedオプションはデフォルトでtrueに設定されており、秘密キーがパスワードで保護されていることを示します。秘密キーがパスワードで保護されていない場合は、falseに設定できます。

Q: TCPSを構成する前に事前チェックを実行できますか。

A: はい。--precheckOnlyオプションをyesに設定することで、操作の事前チェックのみを実行できます。これは、変更を行う前に環境を検証するのに役立ちます。

Q: PKCS12ウォレット・ファイルのパスが正しくない場合はどうなりますか。

A: --pkcs12WalletFilePathに不正なパスが含まれている場合、コマンドは失敗し、TCPS構成は続行されません。

Q: 秘密鍵がパスワードで保護されている場合、どうすればいいですか?

A: 秘密キーがパスワードで保護されている場合は、--privateKeyPasswordProtectedオプションがtrue (デフォルト)に設定されていることを確認します。

Q: TCPS構成に独自のCA署名証明書を指定できますか。

A: はい。--serverCertおよび--privateKeyオプションを使用して、--certTypeCA_SIGNED_CERTに設定することで、独自のCA署名証明書を指定できます。

Q: 自己署名証明書を使用してTCPSを構成するコマンドの例は何ですか。

A: 次に例を示します:

dbaascli grid configureTCPS --serverCert /path/to/self_signed_cert.pem --privateKey /path/to/private_key.pem --certType SELF_SIGNED_CERT

Q: TCPS構成にPKCS12証明書を使用できますか。

A: はい。--pkcs12WalletFilePathオプションを指定し、--certTypePKCS12_CERTに設定することで、PKCS12証明書を使用できます。

Q: dbaascli grid configureTCPSコマンドを実行する前に、何を確認する必要がありますか。

A: 正しい証明書ファイル、秘密キー・ファイルがあり、rootユーザーとしてログインしていることを確認します。また、ZDLRAをTCPSと同時に実行できないため、ZDLRAを使用している場合はその影響を理解してください。

例7-27 dbaascli grid configureTCPS

自己署名証明書を使用してグリッドを構成するには:
dbaascli grid configureTCPS
CA署名証明書を使用してグリッドを構成するには:
dbaascli grid configureTCPS --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --private_key_password_protected false
dbaascli grid removeTCPSCert

Grid Infrastructureウォレットから既存のTCPS証明書を削除するには、dbaascli grid removeTCPSCertコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli grid removeTCPSCert --subject <value>
 {
   --userCert | --trustedCert | --requestedCert
 }
 [--serialNumber <value>] [--executePrereqs] [--resume [--sessionID <value>]] [--bounceListeners]
説明:
  • --subjectは、証明書のサブジェクトを指定します。
  • ユーザー証明書を示す--userCertフラグ
  • 信頼できる証明書を示す--trustedCertフラグ
  • リクエストされた証明書を示す--requestedCertフラグ
  • --serialNumberは、証明書のシリアル番号を指定します
  • --executePrereqsは、前提条件チェックを実行し、結果をレポートします
  • --resumeは、前回の実行を再開します
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • Grid Infrastructureリスナーおよびスキャン・リスナーをバウンスする--bounceListenersフラグ

FAQ

Q: dbaascli grid removeTCPSCertコマンドの目的は何ですか。

A: dbaascli grid removeTCPSCertコマンドは、Oracle Exadata環境のGrid Infrastructureウォレットから既存のTCPS証明書を削除するために使用します。

Q: dbaascli grid removeTCPSCertコマンドを実行する前提条件は何ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: dbaascli grid removeTCPSCertコマンドで--subjectオプションは何を指定しますか。

A: --subjectオプションは、Grid Infrastructureウォレットから削除する証明書のサブジェクトを指定します。

Q: --userCertフラグの目的は何ですか。

A: --userCertフラグは、削除する証明書がユーザー証明書であることを示します。

Q: --trustedCertフラグはどのような場合に使用しますか。

A: Grid Infrastructureウォレットから信頼できる証明書を削除する場合は、--trustedCertフラグを使用します。

Q: --requestedCertフラグは何を行いますか。

A: --requestedCertフラグは、削除される証明書がリクエストされた証明書であることを示します。

Q: --serialNumberオプションは何を指定しますか。

A: --serialNumberオプションは、削除する証明書のシリアル番号を指定します。同じサブジェクトの証明書が複数ある場合に、証明書を一意に識別するのに役立ちます。

Q: --executePrereqsオプションの目的は何ですか。

A: --executePrereqsオプションは、証明書を削除する前に前提条件チェックを実行し、結果をレポートして、環境が操作に対して適切に準備されていることを確認します。

Q: --resumeオプションは何を行いますか?

A: --resumeオプションは、以前に中断された場合に削除操作を再開します。

Q: 中断された操作を再開するときにセッションIDを指定する方法を教えてください。

A: --sessionIDオプションを使用して、再開する中断された操作のセッションIDを指定します。

Q: --bounceListenersフラグは何を行いますか。

A: --bounceListenersフラグは、TCPS証明書の削除後にGrid Infrastructureリスナーを再起動し、リスナーをスキャンするために使用されます。

Q: リスナーをバウンスせずにTCPS証明書を削除できますか?

A: はい、--bounceListenersフラグはオプションです。指定しない場合、リスナーは自動的にバウンスされません。

Q: 私はいかに操作が安全に動くことを保障してもいいですか。

A: --executePrereqsオプションを使用して、コマンドを実行する前に前提条件チェックを実行し、削除プロセスの前にすべてが正しいことを確認できます。

Q: シリアル番号で特定のユーザー証明書を削除する必要がある場合はどうすればよいですか?

A: --subjectオプションを使用して証明書のサブジェクトを指定し、--userCertフラグを使用してユーザー証明書であることを示し、--serialNumberオプションを使用して証明書のシリアル番号を指定します。

Q: 一度に複数の証明書を削除することはできますか?

A: いいえ、このコマンドは、指定されたサブジェクトおよびその他のパラメータに基づいて、一度に1つの証明書を削除するように設計されています。

Q: 証明書の削除プロセスが中断されるとどうなりますか?

A: --resumeオプションと中断されたプロセスの--sessionIDを使用して、操作を再開できます。

Q: rootユーザーとしてコマンドを実行する必要がありますか?

A: はい。TCPS証明書を削除するために必要な権限を取得するには、dbaascli grid removeTCPSCertコマンドをrootユーザーとして実行する必要があります。

Q: 削除したい証明書を特定するにはどうすればよいですか?

A: 証明書はサブジェクトで識別でき、オプションでシリアル番号で識別して、削除のために正しい証明書をターゲットにしていることを確認できます。

Q: 信頼できる証明書を削除するコマンドの例は何ですか?

A: 次に例を示します:

dbaascli grid removeTCPSCert --subject "CN=example_cert" --trustedCert

dbaascli grid rotateTCPSCert

TCPS証明書をローテーションするには、dbaascli grid rotateTCPSCertコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli grid rotateTCPSCert
[--pkcs12WalletFilePath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
説明:
  • --pkcs12WalletFilePathは、証明書ファイルの絶対パス(pkcs12ウォレット形式)を指定します
  • --caCertChainは、中間CAおよびルートCA証明書を含む証明書の連結リストです
  • --precheckOnlyは、yesを指定するとこの操作の事前チェックのみが実行されます。有効な値: yesまたはno
  • --serverCertは、TCPS構成で使用またはローテーションするPEM証明書のパスを指定します。
  • --privateKeyは、証明書の秘密キー・ファイルのパスを指定します。
  • --certTypeは、Grid Infrastructureウォレットに追加する証明書のタイプです。許容される値は、SELF_SIGNED_CERTCA_SIGNED_CERTまたはPKCS12_CERTです。デフォルト: SELF_SIGNED_CERT
  • --privateKeyPasswordProtectedは、秘密キーがパスワードで保護されるかどうかを指定します。有効な値: trueまたはfalseデフォルト: true

FAQ

Q: dbaascli grid rotateTCPSCertコマンドの目的は何ですか。

A: dbaascli grid rotateTCPSCertコマンドは、Oracle Exadata環境のGrid InfrastructureウォレットでTCPS (Transport Layer Security Protocol)証明書をローテーションするために使用します。

Q: dbaascli grid rotateTCPSCertコマンドを実行する前提条件は何ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: --pkcs12WalletFilePathオプションは何を指定しますか。

A: --pkcs12WalletFilePathオプションは、TCPS構成のPKCS12ウォレット形式で証明書ファイルへの絶対パスを指定します。

Q: --caCertChainオプションの目的は何ですか。

A: --caCertChainオプションは、TCPS構成用の証明書(中間CA証明書およびルートCA証明書を含む)の連結リストを指定します。

Q: --precheckOnlyオプションは何を行いますか。

A: --precheckOnlyオプションを使用すると、実際の変更を行わずに事前チェックを実行できます。有効な値は、事前チェックのみを実行する"yes"およびローテーションを続行する"no"です。

Q: --serverCertオプションはどのように使用されますか。

A: --serverCertオプションは、TCPS構成に使用またはローテーションされるPEM (Privacy Enhanced Mail)サーバー証明書へのパスを指定します。

Q: --privateKeyオプションは何を指定しますか。

A: --privateKeyオプションは、TCPSローテーションに使用されるサーバー証明書に対応する秘密キー・ファイルへのパスを指定します。

Q: --certTypeオプションの有効な値は何ですか。

A: --certTypeオプションには、Grid Infrastructureウォレットに追加する証明書のタイプを指定するための次の値を指定できます。

SELF_SIGNED_CERT (デフォルト)

CA_SIGNED_CERT

PKCS12_CERT

Q: --privateKeyPasswordProtectedオプションは何を行いますか。

A: --privateKeyPasswordProtectedオプションは、秘密キーがパスワードで保護されているかどうかを示します。有効な値はtrue (デフォルト)とfalseです

Q: 証明書をローテーションせずにdbaascli grid rotateTCPSCertコマンドを実行できますか。

A: はい。--precheckOnly yesオプションを使用すると、証明書をローテーションせずに事前チェックのみを実行できます。

Q: PKCS12ウォレットを使用して証明書をローテーションするコマンドの例は何ですか。

A: コマンドの例を次に示します。

dbaascli grid rotateTCPSCert --pkcs12WalletFilePath /path/to/wallet.p12 --certType PKCS12_CERT

Q: CA署名証明書チェーンを使用してサーバー証明書をローテーションするにはどうすればよいですか。

A: 次に示すように、--serverCertおよび--caCertChainオプションを使用します。

dbaascli grid rotateTCPSCert --serverCert /path/to/serverCert.pem --caCertChain /path/to/caChain.pem

Q: --privateKeyPasswordProtectedを指定しないとどうなりますか?

A: --privateKeyPasswordProtectedオプションを指定しない場合、このコマンドは秘密キーがパスワードで保護されていると想定します(デフォルト: true)。

Q: 自己署名証明書をローテーションできますか?

A: はい。デフォルトの--certType SELF_SIGNED_CERTオプションを使用するか、明示的に指定することで、自己署名証明書をローテーションできます。

Q: 秘密キーを指定せずに証明書をローテーションするにはどうすればよいですか。

A: PKCS12などの特定の証明書タイプでは、ウォレットに含まれているため、個別の秘密キー・ファイルを指定する必要がない場合があります。ただし、秘密キーが必要な場合は、--privateKeyオプションを使用して指定する必要があります。

Q: 証明書をバックグラウンドでローテーションする場合はどうなりますか?

A: dbaascli grid rotateTCPSCertコマンドでは、バックグラウンド実行のための明示的なオプションは提供されません。コマンドは、バックグラウンド・セッションで直接実行できます(たとえば、nohupまたは同様のツールを使用して)。

Q: 指定しない場合、デフォルトの証明書タイプは何ですか。

A: デフォルトの証明書タイプはSELF_SIGNED_CERTです。

例7-28 dbaascli grid rotateTCPSCert

自己署名証明書を使用して証明書をローテーションするには(デフォルト・オプション):
dbaascli grid rotateTCPSCert
CA署名証明書を使用して証明書をローテーションするには:
dbaascli grid rotateTCPSCert --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --privateKeyPasswordProtected true
dbaascli grid upgrade

あるメジャー・バージョンから別のメジャー・バージョンにOracle Grid Infrastructureをアップグレードするには、dbaascli grid upgradeコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli grid upgrade --version
[--resume]
[--executePrereqs]
[--containerURL]
[--softwareOnly]
[--targetHome]
[--revert]
説明:
  • --versionは、ターゲット・バージョンを指定します
  • --resumeは、前回の実行を再開します
  • --executePrereqsは、Grid Infrastructureアップグレードの前提条件を実行します
  • --containerUrlは、Grid InfrastructureイメージをフェッチするためのカスタムURLを指定します
  • --softwareOnlyは、Grid Infrastructureソフトウェアのみをインストールします
  • --targetHomeは、既存のターゲットGridホームのパスを指定します
  • --revertは、失敗した実行を元に戻します

FAQ

Q: dbaascli grid upgradeコマンドの目的は何ですか。

A: dbaascli grid upgradeコマンドは、Exadata Cloud@Customer仮想マシン上のあるメジャー・バージョンから別のメジャー・バージョンにOracle Grid Infrastructureをアップグレードするために使用されます。

Q: dbaascli grid upgradeコマンドを実行する前提条件は何ですか。

A: コマンドはrootユーザーとして実行する必要があり、Exadata Cloud@Customer仮想マシンに接続する必要があります。

Q: --versionオプションは何を指定しますか?

A: --versionオプションは、アップグレード先のOracle Grid Infrastructureのターゲット・バージョンを指定します。

Q: --resumeオプションは何を行いますか?

A: --resumeオプションは、以前に中断または失敗したGrid Infrastructureアップグレード・プロセスを再開します。

Q: --executePrereqsオプションはどのように使用されますか。

A: --executePrereqsオプションは、実際のアップグレードを実行せずに、Grid Infrastructureのアップグレードの前提条件チェックのみを実行します。

Q: --containerURLオプションの目的は何ですか。

A: --containerURLオプションは、アップグレード用のGrid Infrastructureソフトウェア・イメージをフェッチするカスタムURLを指定します。

Q: --softwareOnlyオプションは何を行いますか。

A: --softwareOnlyオプションは、Grid環境の構成またはアップグレードを行わずに、Grid Infrastructureソフトウェアのみをインストールします。

Q: --targetHomeオプションはいつ使用しますか。

A: --targetHomeオプションは、アップグレードが実行される既存のターゲットGridホームへのパスを指定します。

Q: アップグレードが失敗した場合はどうなりますか。

A: アップグレードが失敗した場合は、--revertオプションを使用して、アップグレードを以前の状態にロールバックできます。

Q: Grid Infrastructureのアップグレードは段階的に実行できますか。

A: はい。--softwareOnlyオプションを使用すると、まずソフトウェアをインストールしてから、その後完全アップグレードを完了し、ステージングされたアップグレードが可能です。

Q: dbaascli grid upgradeコマンドを使用してソフトウェアのみをアップグレードするには、どうすればいいですか。

A: ソフトウェアのみをアップグレードするには、次の構文を使用します。

dbaascli grid upgrade --version <target_version> --softwareOnly

Q: アップグレードを行わずにアップグレードの前提条件を確認できますか?

A: はい、次のものを使用して前提条件チェックのみを実行できます。

dbaascli grid upgrade --version <target_version> --executePrereqs

Q: カスタム・コンテナURLを使用してGrid Infrastructureをアップグレードするにはどうすればよいですか。

A: Grid InfrastructureイメージをフェッチするためのURLを次のように指定できます。

dbaascli grid upgrade --version <target_version> --containerURL <custom_url>

Q: 以前に中断したアップグレードプロセスを再開するにはどうすればよいですか?

A: 以前に中断または失敗したアップグレードを再開するには、次を使用します。

dbaascli grid upgrade --version <target_version> --resume

Q: dbaascli grid upgradeコマンドで--revertオプションは何を行いますか。

A: --revertオプションは、失敗したか中断されたGrid Infrastructureアップグレードを元の状態にロールバックします。

Q: Grid Infrastructureをすぐに構成せずに完全アップグレードを実行できますか。

A: はい、最初に--softwareOnlyオプションを使用してソフトウェアのみをインストールし、後で構成できます。

Q: アップグレードが失敗し、変更を元に戻す場合はどうすればよいですか。

A: --revertオプションを使用して、失敗したアップグレードをロールバックします。

dbaascli grid upgrade --version <target_version> --revert

例7-29 dbaascli grid upgrade

daascli grid upgrade --version 19.11.0.0.0 --executePrereqs
DBAAS CLI version MAIN
Executing command grid upgrade --version 19.11.0.0.0 --executePrereqs

パッチ適用およびアップグレード

この項では、パッチ適用およびアップグレードを通じてOracle環境を更新および保守するためのツールを提供します。これには、Oracle Grid Infrastructureにパッチを適用するdbaascli grid patch、Oracleホームにパッチを適用するdbaascli dbHome patch、アップグレードまたはパッチ適用プロセス中にホーム間でデータベースを移動するdbaascli database moveなどのコマンドが含まれます。これらのコマンドは、システムの安全性、安定性、および最新の状態を維持するのに役立ちます。

dbaascli grid patch

指定したマイナー・バージョンになるようにOracle Grid Infrastructureにパッチを適用するには、dbaascli grid patchコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli grid patch
 {
            --targetVersion <value>
            | --targetHome <value>
        }
        [--executePrereqs] [--nodeList <value>] [--continueWithDbDowntime] [--drainTimeoutInSeconds <value>] [--containerURL <value>] [--imageFile <value>] [--patchInParallel]
        {
            [--resume [--sessionID <value>]]
            | [--rollback [--sessionID <value>]]
        }
        [--waitForCompletion <value>]

説明:

  • --targetVersionは、Oracleホームのターゲット・バージョンを指定します。ピリオドで区切られた5つの数値セグメントとして指定します(例: 19.12.0.0.0)。
  • --targetHomeは、ホーム外パッチ適用でのターゲットGrid Infrastructureホームの完全修飾パスを指定します
  • --containerURLは、Grid InfrastructureイメージをフェッチするためのカスタムURLを指定します
  • --executePrereqsオプションは、前提条件を実行します
  • --nodeListは、ノードのサブセットにパッチ適用を実行する必要がある場合に、ノードのカンマ区切りリストを指定します
  • --patchInParallelは、リモート・ノードへのパッチ適用をパラレルに実行することを指定します
  • --rollbackは、パッチ適用済のOracleホームをロールバックすることを指定します
  • --resumeは、前回の実行を再開します
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • --continueWithDbDowntimeは、データベースの停止時間を使用してパッチ適用を続行します。このオプションは、アクティブ・インスタンスが1つのみ稼働し、停止時間でもパッチ適用操作を続行できる環境で使用できます。
  • --drainTimeoutInSecondsは、データベースの停止中にリソース排出を完了する時間(秒)を指定します
  • --createImageは、アクティブなGridホームのコピーから、指定したターゲット・バージョンにパッチを適用してイメージを作成します
    • --createImageDirは、イメージを作成するディレクトリの完全修飾パスを指定します
  • --imageFileは、使用するイメージの完全修飾パスを指定します
  • --patchInParallelは、リモート・ノードへのパッチ適用をパラレル実行します
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: true|false

FAQ

Q: dbaascli grid patchコマンドは何をしますか。

A: dbaascli grid patchコマンドは、指定したマイナー・バージョンになるようにOracle Grid Infrastructureにパッチを適用するために使用します。

Q: dbaascli grid patchコマンドを実行するには特別な権限が必要ですか。

A: はい、rootユーザーとしてdbaascli grid patchコマンドを実行する必要があります。

Q: Oracle Grid Infrastructureにパッチを適用するときにターゲット・バージョンを指定できますか。

A: はい、--targetVersionオプションを使用してターゲット・バージョンを指定できます。

Q: パッチのターゲット・バージョンを指定するにはどうすればよいですか。

A: --targetVersionオプションに続けて、バージョン番号を19.12.0.0.0の形式で使用します。

Q: dbaascli grid patchコマンドで--containerURLオプションは何を行いますか。

A: --containerURLオプションを使用すると、Grid InfrastructureイメージをフェッチするためのカスタムURLを指定できます。

Q: --executePrereqsオプションの目的は何ですか。

A: --executePrereqsオプションは、パッチを適用する前に前提条件チェックを実行するために使用されます。

Q: dbaascli grid patchコマンドを使用してノードのサブセットにパッチを適用するにはどうすればよいですか。

A: ノードのサブセットにのみパッチを適用するには、--nodeListオプションに続けて、ノード名のカンマ区切りリストを使用します。

Q: --rollbackオプションを使用するとどうなりますか?

A: --rollbackオプションは、パッチが適用されたOracleホームを以前の状態にロールバックします。

Q: 以前のパッチ適用セッションを再開できますか。

A: はい。--resumeオプションを使用して、最後のパッチ適用セッションを再開できます。特定のセッションIDがある場合は、--sessionIDオプションでそれを指定できます。

Q: --continueWithDbDowntimeオプションは何に使用されますか。

A: --continueWithDbDowntimeオプションを使用すると、データベースの停止時間がある場合でもパッチ適用を続行できます。通常、アクティブなインスタンスが1つのみの環境で使用されます。

Q: パッチを適用したGridホームからイメージを作成するにはどうすればよいですか?

A: --createImageオプションを使用してイメージを作成します。--createImageDirオプションを使用して、イメージを作成するディレクトリを指定できます。

Q: --imageFileオプションの目的は何ですか。

A: --imageFileオプションを使用すると、パッチ適用に使用するイメージ・ファイルの完全修飾パスを指定できます。

Q: バックグラウンドでdbaascli grid patchコマンドを実行するにはどうすればよいですか。

A: falseに設定された--waitForCompletionオプションを使用して、バックグラウンドで操作を実行できます。

Q: カスタムURLを使用してパッチ・イメージをフェッチできますか。

A: はい、--containerURLオプションを使用して、Grid InfrastructureイメージをフェッチするためのカスタムURLを指定できます。

Q: すべてのノードにパッチを適用しない場合は、どのようにしてパッチを適用しますか。

A: パッチを適用するノードを指定するには、--nodeListオプションをノード名のカンマ区切りリストとともに使用します。

Q: パッチをロールバックする必要がある場合はどうすればよいですか。

A: パッチをロールバックするには、dbaascli grid patchコマンドの--rollbackオプションを使用します。

Q: 環境にアクティブなインスタンスが1つのみあり、停止時間で続行する必要がある場合、パッチ適用操作はどのように処理しますか。

A: --continueWithDbDowntimeオプションを使用して、データベースの停止時間でもパッチ適用を続行します。

Q: パッチを適用したGridホームのイメージを作成できますか?

A: はい。--createImageオプションを使用して、パッチ適用済のGridホームのイメージを作成できます。必要に応じて、--createImageDirを使用してイメージを保存するディレクトリを指定します。

Q: 中断後にパッチ適用セッションを再開する場合はどうすればよいですか。

A: パッチ適用セッションを再開するには、--resumeオプションを使用します。セッションIDがわかっている場合は、--sessionIDで指定できます。

Q: パッチ適用プロセスが途中で失敗した場合はどうなりますか。

A: パッチ適用プロセスが失敗した場合は、--resumeオプションを使用してプロセスを再起動できます。--rollbackオプションを使用して前の状態に戻すこともできます。

Q: パッチ適用前にすべての前提条件が満たされていることを確認するにはどうすればよいですか。

A: パッチを適用する前に、--executePrereqsオプションを使用してすべての前提条件チェックを実行します。

Q: ターミナルが閉まらないように、バックグラウンドでパッチ適用を実行できますか。

A: はい。--waitForCompletion falseオプションを使用して、パッチ適用プロセスをバックグラウンドで実行できます。

Q: パッチ適用後にGridホーム・イメージを作成するにはどうすればよいですか。

A: --createImageオプションを使用して、パッチが適用されたGridホームから新しいイメージを作成します。必要に応じて、--createImageDirを使用してディレクトリを指定します。

Q: パッチ適用に既存のイメージ・ファイルを使用するにはどうすればよいですか。

A: --imageFileオプションを使用して、パッチ適用に使用するイメージ・ファイルへの完全修飾パスを指定できます。

Q: パッチ適用中にデータベースの停止時間を回避するにはどうすればよいですか。

A: 使用している環境に複数のアクティブ・インスタンスが実行されていることを確認します。--continueWithDbDowntimeオプションは、アクティブなインスタンスが1つのみの環境用に使用しないようにできます。

Q: バックグラウンドで実行されているパッチの進行状況を知るにはどうすればよいですか。

A: --waitForCompletion falseを使用してパッチを実行する場合は、psなどのオペレーティング・システム・コマンドを使用してバックグラウンド・ジョブのステータスを確認するか、Gridホームにあるログを確認できます。

Q: dbaascli grid patchを使用して、より高いメジャー・バージョンにパッチを適用できますか。

A: いいえ。dbaascli grid patchでは、現在のメジャー・バージョンのマイナー・バージョンへのパッチ適用のみが許可されます。メジャー・アップグレードの場合は、別のアップグレード・プロセスに従う必要があります。

Q: パッチ適用中に特定の前提条件チェックをスキップできますか。

A: いいえ。--executePrereqsを使用すると、すべての前提条件チェックが実行されます。ただし、続行する前に、前提条件チェックの結果を確認し、問題を手動で処理できます。

Q: パッチ適用プロセスがスタックまたはハングしている場合はどうすればよいですか。

A: パッチ適用プロセスが応答しない場合は、オペレーティング・システム・コマンドを使用して停止し、--resumeオプションを使用して再開できます。動作しない場合は、--rollbackオプションを使用してパッチを元に戻してください。

Q: 複数のクラスタにわたってパッチ適用プロセスを自動化できますか。

A: はい。適切なオプションを指定したdbaascli grid patchコマンドを含むスクリプトを使用すると、様々なクラスタ間でパッチ適用を自動化できます。

Q: パッチ適用プロセスのログはどこにありますか。

A: ログは通常、Oracle Gridホームのログ・ディレクトリまたは設定時に指定されたデフォルトの場所にあります。パッチ適用プロセスの詳細は、これらのログをモニターできます。

Q: ユーザー操作なしでサイレント・パッチ・プロセスを作成できますか。

A: はい。コマンドに必要なすべてのオプションを指定し、バックグラウンド(--waitForCompletion false)で実行することで、非対話型パッチ適用プロセスを作成できます。

Q: パッチを適用する前に、使用可能なパッチ更新を確認できますか。

A: dbaascli grid patchコマンド自体には、使用可能なパッチをリストするオプションがありません。ただし、Oracle SupportなどのOracleの標準メソッドを使用して、最新のパッチを識別できます。

Q: dbaascliを使用して複数のOracle Homesにパッチを適用できますか。

A: いいえ。dbaascli grid patchコマンドは、特定のOracle Grid Infrastructureホームに一度にパッチを適用するように設計されています。各ホームに対して個別にコマンドを実行する必要があります。

Q: Grid Infrastructureへのパッチ適用時にダウンタイムを完全に防止する方法はありますか。

A: 停止時間を最小限に抑えるには、ノードごとにパッチを適用できるように、環境に複数のアクティブ・データベース・インスタンス(RAC構成)があることを確認します。この場合、--continueWithDbDowntimeオプションは使用しないでください。

Q: RAC One Node環境のパッチ適用はどのように処理するのですか。

A: RAC One Node環境では、アクティブなインスタンスが1つのみ存在する可能性があるため、--continueWithDbDowntimeオプションに注意する必要があります。RAC One Nodeの特定のパッチ適用ガイドラインについては、Oracleのドキュメントを参照してください。

Q: 以前のパッチのセッション履歴を表示できますか。

A: dbaascliユーティリティでは、セッション履歴を直接表示する方法はありません。ただし、以前のパッチ適用セッションのログはGridホームのログ・ディレクトリにあります。

ユースケースの例

例1: 基本的なグリッド・パッチ適用

dbaascli grid patch --targetVersion 19.12.0.0.0

Oracle Grid Infrastructureにバージョン19.12.0.0.0にパッチを適用します。

例2: カスタム・コンテナURLを使用したパッチ適用

dbaascli grid patch --targetVersion 19.12.0.0.0 --containerURL https://example.com/custom/url

カスタム・コンテナURLを使用してGrid Infrastructureイメージをフェッチし、Grid Infrastructureにバージョン19.12.0.0.0にパッチを適用します。

例3: 前提条件チェックを使用したパッチ適用

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs

前提条件チェックの実行後に、Grid Infrastructureにバージョン19.12.0.0.0にパッチを適用します。

例4: ノードのサブセットでのパッチ適用

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2,node3

指定したノード(node1、node2およびnode3)でGrid Infrastructureにバージョン19.12.0.0.0にパッチを適用します。

例5: パッチのロールバック

dbaascli grid patch --rollback

Oracle Grid Infrastructureで最後に適用されたパッチをロールバックします。

例6: 前のパッチ操作の再開

dbaascli grid patch --resume

前のパッチ適用操作を、停止した場所から再開します。

例7: 特定のセッションIDによるパッチ操作の再開

dbaascli grid patch --resume --sessionID 12345

セッションID 12345を使用してパッチ適用操作を再開します。

例8: 許容されるデータベース停止時間でのパッチ適用

dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime

Grid Infrastructureにバージョン19.12.0.0.0にパッチを適用し、必要に応じてデータベースの停止時間を許可します。

例9: パッチ適用済イメージの作成

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir

パッチが適用されたGridホームのイメージ(バージョン19.12.0.0.0)を作成し、指定したディレクトリに格納します。

例10: 既存のイメージ・ファイルの使用

dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /path/to/image/file.zip

/path/to/image/file.zipにある既存のイメージ・ファイルを使用して、Grid Infrastructureにバージョン19.12.0.0.0にパッチを適用します。

例11: バックグラウンドでのパッチ適用操作の実行

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false

Grid Infrastructureにバージョン19.12.0.0.0にパッチを適用し、バックグラウンドで操作を実行します。

例12: 前提条件、カスタムURLおよびノードのサブセットの組合せ

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --containerURL https://example.com/custom/url --nodeList node1,node2

Grid Infrastructureにバージョン19.12.0.0.0にパッチを適用し、前提条件チェックを実行し、イメージのカスタムURLを使用し、node1およびnode2にのみパッチを適用します。

例13: 既存のイメージ・ファイルを使用したパッチ適用済イメージの作成

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir --imageFile /path/to/existing/image.zip

パッチ適用済のイメージを作成し、パッチの既存のイメージ・ファイルを使用しているときに、指定したディレクトリに格納します。

例14: パッチ適用なしの前提条件の検証

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs

パッチを実際に適用せずに、すべての前提条件がバージョン19.12.0.0.0へのパッチ適用で満たされているかどうかを確認します。

例15: パッチの実行および前提条件の失敗の無視

dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime --executePrereqs

一部の前提条件チェックが失敗した場合でもパッチを実行します。これは、停止時間が許可され、特定の前提条件を無視できるシナリオで役立ちます。

例16: 問題のパッチ・ログの確認

tail -f /u01/app/grid/logs/grid_patch.log

パッチ適用プロセス中に問題を診断するために、パッチ・ログをリアルタイムで監視します。

例17: パラレル環境でのパッチの適用

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2 --waitForCompletion false

ノードのサブセット(node1およびnode2)でGrid Infrastructureにパッチを適用し、バックグラウンドでプロセスを実行します。

例18: 外部ソースからの特定のイメージ・ファイルの使用

dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /mnt/images/grid_patch_19.12.zip

外部ストレージ・デバイスにある事前ダウンロード済のイメージ・ファイルを使用して、Grid Infrastructureにパッチを適用します。

例19: カスタム・セッションIDを使用したパッチの実行

dbaascli grid patch --targetVersion 19.12.0.0.0 --resume --sessionID 67890

セッションID 67890を使用して、中断されたパッチ適用操作を再開します。

例20: パッチ適用を後で実行するスケジュール

echo "dbaascli grid patch --targetVersion 19.12.0.0.0" | at 02:00

Linuxのatコマンドを使用して、パッチ適用コマンドを午前2:00に実行するようにスケジュールします。

例21: 完了のタイムアウトの指定

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion true --continueWithDbDowntime --timeout 7200

停止時間を許可しながらGrid Infrastructureにパッチを適用しますが、タイムアウト前に完了するまで最大7200秒(2時間)待機します。

例22: 別の環境のカスタム・イメージの作成

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /backups/images/grid_patch

パッチが適用されたGrid Infrastructureのカスタム・イメージを作成し、他の環境で使用するために/backups/images/grid_patchディレクトリに格納します。

例23: 中断後のパッチ・リカバリ

dbaascli grid patch --resume --continueWithDbDowntime

パッチ適用プロセスが中断された場合、データベースの停止時間が許可され、リカバリして再開します。

例24: 前提条件チェックとバックグラウンド実行の組合せ

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --waitForCompletion false

前提条件を確認し、バックグラウンドでパッチを実行します。

例25: パッチ適用を高速化するためのイメージ作成のスキップ

dbaascli grid patch --targetVersion 19.12.0.0.0 --patchInParallel --continueWithDbDowntime --waitForCompletion false

Grid Infrastructureのバージョン19.12.0.0.0にノード間で並行してパッチを適用し、データベースの停止時間を許可し、イメージを作成せずにプロセスを高速化します。

例26: ログによるパッチの進行状況の監視

tail -f /u01/app/grid/logs/grid_patch_progress.log

パッチ適用の進捗状況に関するログ・ファイルをリアルタイムで監視し、パッチ適用プロセスの各ステップに関するインサイトを提供します。

例27: カスタム・ドレイン・タイムアウトを使用したパッチ適用

dbaascli grid patch --targetVersion 19.12.0.0.0 --drainTimeoutInSeconds 3600 --continueWithDbDowntime

Grid Infrastructureにパッチを適用し、1時間(3600秒)のカスタム・タイムアウトを設定して、データベースの停止時間中に正常なリソース排出を可能にします。

例28: 前提条件チェックを使用した特定のノードへのパッチの適用

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node4 --executePrereqs

ノードnode1およびnode4のみをバージョン19.12.0.0.0にパッチを適用し、前提条件チェックを事前に実行します。

例29: 完了を待機しないパッチ適用

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false

バックグラウンドでGrid Infrastructureのバージョン19.12.0.0.0へのパッチ適用を開始し、プロセスの完了を待たずに他のタスクを実行できます。

例30: 排出タイムアウトの問題後の失敗したパッチの再適用

dbaascli grid patch --resume --drainTimeoutInSeconds 7200

前のパッチ適用セッションを再開し、前の試行で時間が不足したためにリソース・ドレイン・タイムアウトを2時間(7200秒)に拡張します。

例31: 特定のセッションIDを使用したリアルタイムでのパッチ・ログの表示

tail -f /u01/app/grid/logs/grid_patch_12345.log

セッションIDが12345のパッチ適用セッションのログ・ファイルをリアルタイムで監視します。

例32: 新しいターゲット・ホームへのパッチ適用

dbaascli grid patch --targetHome /u01/app/grid_home_19c --executePrereqs

前提条件チェックを使用して、/u01/app/grid_home_19cにある新しいOracle Gridホームに対してアウトオブプレース・パッチを実行します。

例33: バックグラウンド・パッチ・ジョブの停止

ps -ef | grep dbaascli | grep patch | awk '{print $2}' | xargs kill -9

関連付けられたプロセスID (PID)を検索して強制終了することで、バックグラウンド・パッチ・ジョブを停止します。

例34: ログなしでのパッチ完了の検証

dbaascli grid status --targetVersion 19.12.0.0.0

現在のGrid Infrastructureのバージョン・ステータスをチェックして、バージョン19.12.0.0.0へのパッチが正常に適用されたかどうかを確認します。

dbaascli dbHome patch

あるパッチ・レベルから別のパッチ・レベルになるようにOracleホームにパッチを適用するには、dbaascli dbHome patchコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli dbHome patch

{
    --oracleHome <value>
    | --oracleHomeName <value>
 }
        [--imageFilePath <value>] [--executePrereqs] [--nodes <value>]
        {
            [--resume [--sessionID <value>]]
            | [--rollback [--sessionID <value>]]
        }
[--skipDatapatch] 
[--skipClosedPDBs] 
[--skipPDBs <value>] 
[--continueWithDbDowntime] 
[--skipUnreachableNodes] 
[--drainTimeoutInSeconds <value>] 
[--waitForCompletion <value>]
説明:
  • --oracleHomeは、Oracleホームのパスを指定します
  • --oracleHomeNameは、Oracleホームの名前を指定します
  • --targetVersionは、Oracleホームのターゲット・バージョンを指定します。ピリオドで区切られた5つの数値セグメントとして指定します(例: 19.12.0.0.0)。
  • --resumeは、前回の実行を再開します
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • --continueWithDbDowntimeは、データベースの停止時間を使用してパッチ適用を続行します。このオプションは、アクティブ・インスタンスが1つのみ稼働し、停止時間でもパッチ適用操作を続行できる環境で使用できます。
  • --skipUnreachableNodesは、アクセスが不可能なノードで操作をスキップします
  • --nodesは、ノードのサブセットにパッチ適用を実行する必要がある場合に、ノードのカンマ区切りリストを指定します
  • --executePrereqsは、前提条件を実行します
  • --skipDatapatchは、データベースに対するdatapatchの実行をスキップします
  • --imageFilePathは、使用するイメージ・ファイルの絶対パスを指定します
  • --skipPDBsは、指定したPDBのカンマ区切りリストに対するdatapatchの実行をスキップします。例: cdb1:pdb1,cdb2:pdb2など
  • --skipClosedPdbsは、クローズしたPDBに対するdatapatchの実行をスキップします
  • --rollbackは、パッチが適用されたOracleホームをロールバックします。
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: true|false
  • --drainTimeoutInSecondsは、データベースの停止中に、リソースの排出にかける時間(秒単位)を指定します
  • --skipUnreachableNodesは、アクセスが不可能なノードで操作をスキップします

FAQ

Q: dbaascli dbHome patchコマンドは何に使用されますか。

A: dbaascli dbHome patchコマンドは、パッチ・レベル間でOracleホームにパッチを適用するために使用します。

Q: dbaascli dbHome patchコマンドを実行するには特別な権限が必要ですか。

A: はい、rootユーザーとしてコマンドを実行する必要があります。

Q: パッチのOracleホームのパスまたは名前を指定するにはどうすればよいですか。

A: --oracleHomeオプションを使用してOracleホームのパスを指定するか、--oracleHomeNameを使用してOracleホームの名前を指定します。

Q: パッチのターゲット・バージョンを定義するにはどうすればよいですか。

A: --targetVersionオプションに続けて、バージョン番号を19.12.0.0.0の形式で使用します。

Q: --resumeオプションは何を行いますか?

A: --resumeオプションを使用すると、以前のパッチ適用セッションを再開できます。

Q: パッチを再開するときに特定のセッションIDを指定するにはどうすればよいですか。

A: --sessionIDオプションを使用して、再開するパッチ適用セッションのセッションIDを指定します。

Q: --continueWithDbDowntimeオプションは何に使用されますか。

A: --continueWithDbDowntimeオプションを使用すると、データベースの停止時間がある場合でもパッチ適用を続行できます。これは、アクティブなインスタンスが1つのみの環境で役立ちます。

Q: アクセスできないノードでのパッチ適用をスキップするにはどうすればよいですか。

A: --skipUnreachableNodesオプションを使用して、アクセスできないノードでの操作をスキップします。

Q: クラスタ内の特定のノードにのみパッチを適用するにはどうすればよいですか。

A: ノードのサブセットにパッチを適用するには、--nodesオプションに続けて、ノード名のカンマ区切りリストを使用します。

Q: --executePrereqsオプションとは何ですか。

A: --executePrereqsオプションは、パッチを適用する前に前提条件チェックを実行します。

Q: データベースでのdatapatchの実行をスキップするにはどうすればよいですか。

A: パッチ適用中にdatapatchプロセスをスキップするには、--skipDatapatchオプションを使用します。

Q: データベース・イメージのカスタムの場所を指定できますか。

A: はい。--imageLocationオプションを使用して、データベース・イメージのカスタムの場所を指定します。

Q: --skipPDBsオプションは何を行いますか。

A: --skipPDBsオプションを使用すると、プラガブル・データベース(PDB)の指定のカンマ区切りリストでのdatapatchの実行をスキップできます。

Q: クローズしたPDBでdatapatchをスキップするにはどうすればよいですか。

A: --skipClosedPDBsオプションを使用して、クローズされているPDBのdatapatchをスキップします。

Q: --rollbackオプションを使用するとどうなりますか?

A: --rollbackオプションを指定すると、パッチが適用される前の状態にOracleホームが戻されます。

Q: パッチ適用用のOracleホーム・パスはどのように指定するのですか。

A: --oracleHomeオプションに続けて、Oracleホーム・ディレクトリへのパスを指定します。

Q: パスではなく名前でOracleホームにパッチを適用するにはどうすればよいですか。

A: --oracleHomeNameオプションに続けて、Oracleホームの名前を指定します。

Q: パッチ適用操作が中断された場合、どのようにして再開しますか。

A: 特定の中断されたセッションを再開するには、--resumeオプションを--sessionIDオプションとともに使用します。

Q: データベースが停止している場合、パッチ適用プロセスを続行できますか。

A: はい。データベースが停止している場合でもパッチ適用を続行するには、--continueWithDbDowntimeオプションを使用します。

Q: パッチ適用プロセス中に一部のノードにアクセスできない場合、どうすればよいですか。

A: --skipUnreachableNodesオプションを使用して、アクセスできないノードをバイパスします。

Q: 特定のノードにのみパッチを適用するにはどうすればよいですか?

A: --nodesオプションとノード名のカンマ区切りリストを使用して、パッチを適用するノードを指定します。

Q: パッチを適用する前に前提条件を確認する方法を教えてください。

A: パッチを適用する前に、--executePrereqsオプションを使用して前提条件チェックを実行します。

Q: パッチ適用プロセス中にdatapatchを適用しないようにするにはどうすればよいですか。

A: datapatchステップをスキップするには、--skipDatapatchオプションを使用します。

Q: パッチ適用プロセスで使用されるデータベース・イメージに別の場所を指定するにはどうすればよいですか。

A: --imageLocationオプションを使用して、イメージのカスタムの場所を指定します。

Q: 特定のPDBでdatapatchをスキップする必要がある場合はどうなりますか。

A: --skipPDBsオプションを使用して、指定したPDBのカンマ区切りリストでのdatapatchをスキップします。

Q: 現在オープンしていないPDBのdatapatchはスキップできますか。

A: はい。--skipClosedPDBsオプションを使用して、クローズしたPDBでのdatapatchをスキップします。

Q: パッチ適用が途中で失敗した場合はどうすればよいですか?

A: --rollbackオプションを使用して前の状態に戻すことも、--resumeオプションを使用してパッチ適用プロセスを再開することもできます。

Q: パッチを適用する前に、すべての前提条件が満たされているかどうかを確認するにはどうすればよいですか?

A: --executePrereqsオプションを指定してpatchコマンドを実行し、すべての前提条件が満たされていることを確認します。

Q: パッチ適用操作が正常に完了せず、再試行する必要がある場合はどうなりますか。

A: --resumeオプションを使用して、停止した場所からパッチ適用操作を再試行します。必要に応じて、--sessionIDを指定して特定のセッションを再開できます。

Q: パッチが正常に適用されたかどうかを確認するにはどうすればよいですか。

A: パッチの完了後にopatch lsinventoryコマンドを使用してOracleホームのバージョンを確認することで、パッチ適用プロセスを確認できます。

Q: パッチ適用コマンドを予行演習モードで実行してアクションをプレビューできますか。

A: いいえ、dbaascli dbHome patchコマンドには予行演習機能はありません。ただし、--executePrereqsオプションを使用して、パッチを実際に適用する前に前提条件チェックを実行できます。

Q: 1回の実行で複数のパッチを適用することはできますか。

A: dbaascli dbHome patchコマンドでは、一度に1つのターゲット・バージョンのみ許可されます。このコマンドは、パッチ・バージョンごとに個別に実行する必要があります。

Q: 環境が複数のOracleホームを使用している場合は、どのようにしてパッチ適用を処理しますか。

A: パッチを適用するOracleホームは、Oracleホームのパスを指定するか名前を指定するかに応じて、--oracleHomeまたは--oracleHomeNameオプションのいずれかを使用して指定できます。

Q: 1つのコマンドでPDBとCDBの両方のデータパッチ適用をスキップできますか。

A: はい、--skipPDBsオプションと--skipDatapatchオプションを組み合せて、単一のパッチ実行でPDBとCDBの両方のデータパッチ適用をスキップできます。

Q: 問題が生じた場合、パッチを適用してすぐにロールバックすることはできますか。

A: はい。パッチの適用後、--rollbackオプションを使用して、問題が発生した場合に以前のパッチ・レベルに戻すことができます。

Q: 複数のOracleホームに同時にパッチを適用できますか。

A: いいえ、Oracleホームごとにdbaascli dbHome patchコマンドを個別に実行する必要があります。

Q: パッチ適用操作の進捗状況はどのように追跡するのですか。

A: パッチ適用プロセス中に、コマンドによって進行状況を示す出力メッセージが表示されます。ログ・ファイルで詳細を確認することもできます。

Q: クラスタ化された環境でパラレルにパッチ適用を実行できますか。

A: パッチ適用操作は、--nodesオプションを使用してノードのサブセットに適用できます。ただし、同時パッチ適用は慎重に処理する必要があり、セッションが重複しないようにする必要があります。

Q: Oracleホームで使用できるパッチはどのようにして特定できますか。

A: Oracleサポート・ポータルまたはopatch lsinventoryコマンドを実行して、使用可能なパッチを確認し、Oracleホームに適用されている現在のパッチを確認できます。

Q: パッチ適用中にデータベースを停止するときにリソースを排出するタイムアウトを指定できますか。

A: はい、--drainTimeoutInSecondsオプションを使用して、データベース停止時のリソース・ドレイン時間(秒)を指定できます。

Q: マルチノード環境のノードのいずれかでパッチが失敗した場合はどうなりますか。

A: --skipUnreachableNodesオプションを使用して、障害が発生したノードをスキップし、残りのノードでパッチ適用プロセスを続行できます。その後、障害が発生したノードで個別に問題に対処できます。

Q: パッチ適用プロセスをバックグラウンドで実行するにはどうすればよいですか。

A: --waitForCompletionオプションを値falseとともに使用して、パッチ適用プロセスをバックグラウンドで実行できるようにします。このようにして、プロセスが対話的に完了するのを待つ必要はありません。

Q: クラスタ環境内のノードのサブセットに対してロールバック操作を実行できますか。

A: はい、--nodesオプションを--rollbackオプションとともに使用して、特定のノード・セットでパッチ適用をロールバックできます。

Q: パッチ処理の開始後にイメージの場所を更新する必要がある場合はどうなりますか。

A: --resumeオプションでは、イメージの場所を変更できません。ただし、セッションを停止し、更新された--imageLocationを使用して新しいパッチ・プロセスを開始できます。

Q: パッチの再開に使用できるセッションIDを確認する方法はありますか。

A: ログ・ファイルを確認するか、Oracle Cloudツールを使用して、アクティブまたは一時停止中のパッチ適用セッションとそのセッションIDを識別できます。

Q: パッチ適用中に停止時間を制限できますか。

A: 停止時間を制限する必要がある場合は、--continueWithDbDowntimeオプションを慎重に使用してください。これにより、ダウンタイムが予想される場合でも続行できますが、サービスへの影響を最小限に抑えるための計画が必要です。

ユースケースの例

例1: Oracle Homeパスによる基本的なOracle Homeパッチ適用

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

/u01/app/oracle/product/19.0.0/dbhome_1にあるOracleホームにバージョン19.12.0.0.0にパッチを適用します。

例2: Oracle Home名によるパッチ適用

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0

DB_HOME_NAMEという名前のOracleホームにバージョン19.12.0.0.0にパッチを適用します。

例3: 前のパッチ操作の再開

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --resume

/u01/app/oracle/product/19.0.0/dbhome_1にあるOracleホームの前のパッチ適用操作を再開します。

例4: 特定のセッションIDによるパッチの再開

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --resume --sessionID 12345

セッションID 12345を使用して、OracleホームDB_HOME_NAMEのパッチ適用操作を再開します。

例5: 許容されるデータベース停止時間でのパッチ適用

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --continueWithDbDowntime

/u01/app/oracle/product/19.0.0/dbhome_1にあるOracleホームにバージョン19.12.0.0.0にパッチを適用し、データベースの停止時間を許可します。

例6: 到達できないノードのスキップ

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes

Oracleホームにバージョン19.12.0.0.0のパッチを適用し、アクセスできないノードをスキップします。

例7: ノードのサブセットへのパッチ適用

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --nodes node1,node2

Oracleホームにバージョン19.12.0.0.0 (node1およびnode2のみ)のパッチを適用します。

例8: パッチ適用前の前提条件チェックの実行

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --executePrereqs

前提条件チェックの実行後に、OracleホームDB_HOME_NAMEにバージョン19.12.0.0.0にパッチを適用します。

例9: Datapatchステップのスキップ

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch

データベースでdatapatchを実行せずに、Oracleホームにバージョン19.12.0.0.0にパッチを適用します。

例10: パッチ適用のためのイメージ・ファイルの使用

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --imageFilePath /path/to/image/file.zip

/path/to/image/file.zipにあるイメージ・ファイルを使用して、Oracleホームにバージョン19.12.0.0.0にパッチを適用します。

例11: Datapatch中の特定のPDBのスキップ

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2

Oracleホームにバージョン19.12.0.0.0にパッチを適用し、指定したPDBでのdatapatchの実行をスキップします(cdb1ではpdb1、cdb2ではpdb2)。

例12: クローズされたPDBでのDatapatchのスキップ

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipClosedPDBs

クローズされたPDBでのdatapatchの実行をスキップ中に、Oracleホームにバージョン19.12.0.0.0にパッチを適用します。

例13: Oracle Homeのロールバック

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback

DB_HOME_NAMEという名前のOracleホームで最後に適用されたパッチをロールバックします。

例14: パッチ適用と前提条件チェックおよび特定のノードの組合せ

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --executePrereqs --nodes node1,node2

Oracleホームにバージョン19.12.0.0.0にパッチを適用し、前提条件チェックを実行し、node1およびnode2にのみパッチを適用します。

例15: 到達できないノードおよび特定のPDBのスキップ

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --skipUnreachableNodes --skipPDBs cdb1:pdb1

OracleホームDB_HOME_NAMEにバージョン19.12.0.0.0にパッチを適用し、アクセスできないノードをスキップして、cdb1内のpdb1でのdatapatchの実行を回避します。

例16: パッチ適用後のOracle Homeバージョンの確認

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

opatch lsinventory

この例では、opatch lsinventoryを実行して、パッチが成功した後にOracleホームのバージョンを確認する方法を示します。

例17: 特定のセッションIDによるパッチ適用のロールバック

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --sessionID 67890

セッションID 67890のOracleホームのパッチ適用をロールバックします。

例18: 前提条件チェックをスキップしたパッチ適用

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPrereqs

Oracleホームにパッチを適用しますが、パッチを適用する前に前提条件チェックをスキップします。

例19: カスタムOracle Homeイメージへのパッチの適用

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --imageLocation /custom/location/image.zip

/custom/location/image.zipにあるカスタム・イメージ・ファイルを使用してOracleホームにパッチを適用します。

例20: 特定のノードのスキップと前提条件の実行

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes --executePrereqs

アクセスできないノードへのパッチ適用をスキップし、パッチを適用する前に前提条件チェックを実行します。

例21: 複数のCDB内のすべてのPDBでのDatapatchのスキップ

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2,cdb3:pdb3

Oracleホームにパッチを適用しますが、複数のCDB内の指定されたPDBでのdatapatchはスキップします。

例22: 複数のノードでの停止時間によるパッチ適用の続行

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --continueWithDbDowntime --nodes node3,node4

データベース・ダウンタイムが許可されたnode3およびnode4でパッチ適用を続行します。

例23: PDBおよびクローズ済PDBでのDatapatchのスキップ

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch --skipClosedPDBs

datapatchとクローズ済PDBの両方をスキップしながら、Oracleホームにパッチを適用します。

例24: パッチのロールバックおよび再適用

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

現在のパッチをロールバックしてから、Oracleホームにパッチを再適用します。

例25: 特定のノードでのDatapatchのスキップおよび停止時間の許可

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipDatapatch --continueWithDbDowntime --nodes node1

Oracleホームにバージョン19.13.0.0.0 (node1)にパッチを適用し、datapatchステップをスキップしてダウンタイムを許可します。

例26: データベース停止時のドレイン・タイムアウトの指定

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.13.0.0.0 --drainTimeoutInSeconds 300

OracleホームDB_HOME_NAMEにバージョン19.13.0.0.0にパッチを適用し、停止中にリソースを排出するための5分間のタイムアウト(300秒)を許可します。

例27: バックグラウンドでのパッチ適用の実行

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --waitForCompletion false

Oracleホームにバージョン19.13.0.0.0にパッチを適用し、完了を待たずにバックグラウンドでパッチ適用プロセスを実行します。

例28: ノードのサブセットでのパッチのロールバック

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --nodes node1,node2

指定したOracleホームについてのみ、node1およびnode2で最後に適用されたパッチをロールバックします。

例29: 前提条件のスキップと複数のノードへのパッチ適用

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipPrereqs --nodes node3,node4

前提条件チェックを実行せずに、node3およびnode4でOracleホームにバージョン19.13.0.0.0にパッチを適用します。

例30: パッチのロールバックと到達不可能なノードのスキップ

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback --skipUnreachableNodes

OracleホームDB_HOME_NAMEの最後のパッチをロールバックし、ロールバック・プロセス中に到達できないノードをスキップします。

dbaascli database move

データベースをホーム間で移動するには、dbaascli database moveコマンドを使用します。

前提条件

  • 移動操作を実行する前に、データベースに関連付けられているすべてのデータベース・インスタンスが稼働していることを確認します。
  • rootユーザーとしてコマンドを実行します。

構文

dbaascli database move
{
  --oracleHome <value> | --oracleHomeName <value>
}
--dbname <value> 
[--executePrereqs] 
[--resume [--sessionID <value>]] 
[--rollback [--sessionID <value>]] 
[--skipDatapatch] 
[--skipPDBs <value>] 
[--skipClosedPDBs] 
[--continueWithDbDowntime] 
[--allowParallelDBMove] 
[--waitForCompletion <value>] 
[--nodeList <value>]

説明:

  • --oracleHomeは、Oracleホーム・パスを指定します
  • --oracleHomeNameは、Oracleホームの名前を指定します
  • --dbnameは、データベースの名前を指定します
  • --executePrereqsは、前提条件チェックを実行し、結果をレポートします
  • --resumeは、前回の実行を再開します
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • --rollbackは、データベースを前のホームにロールバックします。
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • --skipDatapatchは、データベースに対するdatapatchの実行をスキップします
  • --skipPdbsは、指定したPDBのカンマ区切りリストに対するdatapatchの実行をスキップします。例: pdb1,pdb2...
  • --skipClosedPDBsは、クローズされたPDBへのパッチ適用をスキップします。
  • --continueWithDbDowntimeは、データベースの停止時間を使用してパッチ適用を続行します。このオプションは、アクティブ・インスタンスが1つのみ稼働し、停止時間でもパッチ適用操作を続行できる環境で使用できます。
  • --allowParallelDBMoveは、データベースをパラレルに移動できます。
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: true|false
  • --nodeListは、ノードのサブセットに対して操作を実行する必要があります。

FAQ

Q: dbaascli database moveコマンドは何に使用されますか。

A: dbaascli database moveコマンドは、あるOracleホームから別のOracleホームにデータベースを移動するために使用します。

Q: dbaascli database moveコマンドを使用するための前提条件は何ですか。

A: 移動操作を実行する前に、データベースに関連付けられているすべてのデータベース・インスタンスが稼働していることを確認します。また、このコマンドは、rootユーザーとして実行する必要があります。

Q: --oracleHomeパラメータは何を指定しますか。

A: --oracleHomeパラメータは、データベースの移動先となるOracleホームのパスを指定します。

Q: --oracleHomeNameパラメータは何を指定しますか。

A: --oracleHomeNameパラメータは、データベースの移動先となるOracleホームの名前を指定します。

Q: --dbnameパラメータの目的は何ですか。

A: --dbnameパラメータでは、移動するデータベースの名前を指定します。

Q: --executePrereqsオプションは何を行いますか。

A: --executePrereqsオプションは、前提条件チェックを実行し、結果をレポートします。

Q: --resumeオプションは何に使用されますか?

A: --resumeオプションは、以前に中断された移動操作または不完全な移動操作を再開します。

Q: --sessionIDはコマンドでどのように使用されますか。

A: --sessionIDは、前回の実行またはロールバックを再開するセッションIDを指定します。

Q: --rollbackオプションは何を行いますか?

A: --rollbackオプションは、データベースを前のOracleホームにロールバックします。

Q: --skipDatapatchオプションは何を行いますか。

A: --skipDatapatchオプションは、移動操作中にデータベースでのdatapatchの実行をスキップします。

Q: --skipPDBsオプションの機能は何ですか。

A: --skipPDBsオプションは、指定したPDBのカンマ区切りリスト(pdb1、pdb2など)に対するdatapatchの実行をスキップします。

Q: --skipClosedPDBsオプションは何を行いますか。

A: --skipClosedPDBsオプションは、クローズされたPDBのパッチ適用をスキップします。

Q: --continueWithDbDowntimeの意味は何ですか。

A: --continueWithDbDowntimeオプションを使用すると、アクティブなインスタンスが1つのみ稼働している場合でも移動操作を続行できるため、プロセス中の停止時間が発生します。

Q: --allowParallelDBMoveオプションの目的は何ですか。

A: --allowParallelDBMoveオプションを使用すると、データベースの移動をパラレルに実行できるため、プロセスが高速化される可能性があります。

Q: --waitForCompletionは何を指定しますか?

A: --waitForCompletionオプションは、操作の完了を待機するかどうかを指定します。falseに設定すると、バックグラウンドで操作が実行されます。

Q: --nodeListパラメータはどのように使用するのですか。

A: --nodeListパラメータは、移動操作が実行されるノードのカンマ区切りリストを指定します(すべてのノードに適用されない場合)。

Q: dbaascli database moveコマンドで問題が発生した場合はどうすればよいですか。

A: すべてのデータベース・インスタンスが実行されていることを確認し、rootユーザーとしてコマンドを実行していることを確認します。問題が解決しない場合は、詳細なコマンドドキュメントを参照するか、Oracleでサポートチケットを開きます。

Q: いずれかのデータベース・インスタンスが停止している場合、移動操作を実行できますか。

A: いいえ。移動操作を実行する前に、関連するすべてのデータベース・インスタンスが稼働している必要があります。

Q: 移動操作が中断された場合はどうなりますか。

A: --resumeオプションを使用すると、同じセッションを使用するか、--sessionIDを指定して、移動操作を中断した場所から続行できます。

Q: --allowParallelDBMoveオプションは何を行いますか。

A: データベースの移動をパラレルに実行できるため、特に大規模な環境での操作の完了にかかる時間を短縮できます。

Q: バックグラウンドで実行されている移動操作の進行状況を監視するにはどうすればよいですか。

A: --waitForCompletion falseを使用する場合、コマンドは操作の完了を待機しません。適切なOracleログまたはステータス・コマンドを使用して、操作のステータスを手動で確認できます。

Q: --skipClosedPDBsオプションの意味は何ですか。

A: クローズされているPDBのパッチ適用はスキップされ、パッチ適用が不要なPDBがある場合は操作時間が短縮されます。

Q: データベースの移動はいつでもロールバックできますか。

A: はい。--rollbackオプションを使用して、セッションIDを指定するか、単に前のOracleホームにロールバックすることで、移動操作をロールバックできます。

Q: マルチノード環境での--nodeListの役割は何ですか。

A: マルチノード環境では、--nodeListを使用してノード名のカンマ区切りリストを指定することで、移動操作を特定のノードに制限できます。

Q: マルチノード環境の特定のノードをスキップしながら、データベースを新しいOracleホームに移動できますか。

A: はい。--nodeListオプションを使用して、移動操作に含めるノードを指定できます。リストされていないノードはスキップされます。

Q: --nodeListパラメータで指定できるノードの最大数はいくつですか。

A: --nodeListパラメータでは、環境構成によってのみ制限される、必要な数のノードのカンマ区切りリストを指定できます。すべてのノードが有効で到達可能であることを確認します。

Q: --skipClosedPDBsオプションを使用する前に、どのPDBがクローズされているかを把握するにはどうすればよいですか。

A: v$pdbsビューを問い合せて、PDBのステータスを確認できます。ステータスがMOUNTEDまたはCLOSEDのPDBは、--skipClosedPDBsの使用時にスキップされます。

Q: ロールバックが正常に完了したかどうかを確認するにはどうすればよいですか。

A: rollbackコマンドの実行後、データベース・ログを確認するか、Oracleアラート・ログを使用して、データベースが以前のOracleホームに正常にロールバックされたことを確認できます。

Q: 前提条件が失敗した場合に、移動操作を強制的に実行する方法はありますか。

A: moveコマンドは、システムの安定性について前提条件チェックを強制します。重要な前提条件の失敗をバイパスすることはできません。移動を続行する前に、--executePrereqsオプションによって報告された問題に対処します。

ユースケースの例

例1: Oracle Homeパスによる基本的なデータベース移動

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL

データベースORCL/u01/app/oracle/product/19.0.0/dbhome_1にあるOracleホームに移動します。

例2: Oracle Home名によるデータベース移動

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL

データベースORCLDB_HOME_NAMEという名前のOracleホームに移動します。

例3: 移動前の前提条件チェックの実行

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --executePrereqs

前提条件チェックの実行中に、データベースORCLをOracleホームに移動します。

例4: 前の移動操作の再開

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --resume

ORCLデータベースの前の移動操作を再開します。

例5: 特定のセッションIDを使用した移動操作の再開

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --resume --sessionID 12345

セッションID 12345を使用して、ORCLデータベースの移動操作を再開します。

例6: 移動操作のロールバック

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --rollback

ORCLデータベースの移動操作をロールバックし、前のOracleホームにリストアします。

例7: セッションIDを使用した移動操作のロールバック

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --rollback --sessionID 67890

セッションID 67890を使用してORCLの移動操作をロールバックします。

例8: Datapatchのスキップ

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipDatapatch

データベースでdatapatchを実行せずに、データベースORCLを移動します。

例9: Datapatch中の特定のPDBのスキップ

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipPDBs pdb1,pdb2

ORCLデータベースを新しいOracleホームに移動しますが、指定したPDB (pdb1およびpdb2)でのdatapatchの実行をスキップします。

例10: クローズされたPDBでのDatapatchのスキップ

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipClosedPDBs

ORCLデータベースを移動し、クローズされたPDBでdatapatchの実行をスキップします。

例11: 移動中のデータベース停止時間の許可

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --continueWithDbDowntime

ORCLデータベースを、移動プロセス中のデータベースの停止時間を許可しながら、指定したOracleホームに移動します。

例12: パラレルでのデータベースの移動

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --allowParallelDBMove

パフォーマンス向上のために移動をパラレルで実行するオプションを指定して、データベースORCLを指定されたOracleホームに移動します。

例13: バックグラウンドでの操作の実行

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --waitForCompletion false

データベースORCLを新しいOracleホームに移動しますが、バックグラウンドで操作を実行します。

例14: 移動のノードの指定

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --nodeList node1,node2

データベースORCLを指定されたOracleホームに移動しますが、node1およびnode2でのみ操作を実行します。

例15: 移動と前提条件チェックの組合せ、特定のPDBのスキップおよび停止時間の許可

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --executePrereqs --skipPDBs pdb1 --continueWithDbDowntime

ORCLデータベースを指定されたOracleホームに移動し、前提条件チェックを実行し、pdb1でのdatapatchの実行をスキップし、操作中のデータベースの停止時間を許可します。

例16: パラレルでの移動とバックグラウンドでの実行の組合せ

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --allowParallelDBMove --waitForCompletion false

ORCLデータベースを新しいOracleホームに移動し、移動をパラレルに実行して、バックグラウンドで操作を実行します。

例17: 移動とパラレル実行およびクローズ済PDBのスキップの組合せ

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname TESTDB --allowParallelDBMove --skipClosedPDBs

操作をパラレルで実行し、クローズされたPDBでdatapatchをスキップしながら、TESTDBデータベースを新しいOracleホーム/u02/app/oracle/product/19.0.0/dbhome_2に移動します。

例18: 前提条件チェックのみの実行

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname PRODDB --executePrereqs

実際に移動を実行せずに、PRODDBデータベースを/u02/app/oracle/product/19.0.0/dbhome_2にあるOracleホームに移動するための前提条件を確認します。

例19: 特定のPDBのDatapatchのスキップ

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname HRDB --skipPDBs pdb1,pdb3

HRDBデータベースを新しいOracleホームに移動しますが、pdb1およびpdb3のdatapatchの実行をスキップします。

例20: 特定のノードでの移動の実行

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname FINDB --nodeList node1,node3

node1およびnode3でのみ、FINDBデータベースを新しいOracleホームに移動します。

例21: 停止時間が許可されたデータベースの移動

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --continueWithDbDowntime

移動操作中の停止時間を許可しながら、ORCLデータベースを指定されたOracleホームに移動します。

例22: パラレル移動とDatapatchのスキップの組合せ

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname CRMDB --allowParallelDBMove --skipDatapatch

CRMDBデータベースをパラレルに移動し、datapatchプロセスをスキップします。

例23: ノード・リストを使用したバックグラウンドでの移動操作

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname SALESDB --waitForCompletion false --nodeList node2,node3

SALESDBデータベースをバックグラウンドで指定したOracleホームに移動し、この操作はnode2およびnode3にのみ適用されます。

例24: 前提条件チェックを使用したデータベースの移動およびパラレル移動の許可

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_2 --dbname ORCL --executePrereqs --allowParallelDBMove

前提条件チェックを実行して移動操作をパラレルで実行した後、ORCLデータベースを新しいOracleホームに移動します。

例25: 移動操作のロールバックおよびクローズ済PDBのスキップ

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname DEVDB --rollback --skipClosedPDBs

DEVDBデータベースの移動操作をロールバックし、クローズされたPDBをスキップします。

例26: 特定の停止時間およびパラレル実行を使用したデータベースの移動

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname FINDB --allowParallelDBMove --continueWithDbDowntime

FINDBデータベースを指定されたOracleホームに移動し、データベースの停止時間を許可し、パラレル実行でプロセスを高速化できるようにします。

例27: 移動を実行しないデータベース移動の前提条件の確認

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname HRDB --executePrereqs

前提条件チェックを実行して、移動自体を実行せずに、指定されたOracleホームにHRDBデータベースを移動できることを検証します。

例28: データベースの移動および特定のノードのバックグラウンドでのコマンドの実行

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_3 --dbname PRODDB --waitForCompletion false --nodeList node1,node4

PRODDBデータベースを新しいOracleホームに移動し、バックグラウンドで操作を実行し、node1およびnode4にのみ適用します。

例29: 前提条件チェックの組合せ、クローズ済PDBのスキップおよびパラレル実行の許可

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname CRMDB --executePrereqs --skipClosedPDBs --allowParallelDBMove

CRMDBデータベースを新しいOracleホームに移動する前に前提条件チェックを実行し、クローズされたPDBへのパッチ適用をスキップし、高速な実行のために操作をパラレルで実行できるようにします。

例30: 特定のセッションIDでのロールバックおよびDatapatchのスキップによるデータベース移動

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname DEVDB --rollback --sessionID 45678 --skipDatapatch

セッションID 45678を使用して、DEVDBデータベースに対して以前に実行した移動操作を以前のOracleホームにロールバックし、ロールバック中にdatapatchプロセスをスキップします。

例31: パラレル実行を許可し、PDBに対するDatapatchスキップを指定したデータベースの移動

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_3 --dbname ANALYTICDB --allowParallelDBMove --skipPDBs pdb2,pdb4

ANALYTICDBデータベースを、指定したOracleホームにパラレルに移動し、pdb2およびpdb4のdatapatchプロセスをスキップします。

その他

Q: Oracle Database 11.2.0.4.0へのパッチ適用中にcatbundleの実行をスキップするにはどうすればよいですか。

A: Oracle Databaseのパッチ適用プロセス中にcatbundle実行をスキップするには、--skipDatapatchオプションをdbaascli database moveまたはdbaascli dbHome patchコマンドとともに使用します。

Q: Oracle Databaseのパッチ適用中に従うべきベスト・プラクティスは何ですか。

A: Oracleでは、パッチ適用ウィンドウを最小化するために、dbaascli database moveコマンドを使用してアウトオブプレース・パッチ適用を実行することをお薦めします。

Oracleでは、--allowParallelDBMoveオプションを使用してパラレル・パッチ適用を有効にすることをお薦めします。これにより、プロセスが迅速化されます。

Q: Oracle Databaseパッチの前提条件中に報告される警告は無視できますか。

A: パッチ適用プロセスに進む前に、前提条件チェック中に報告された警告に対処して解決することをお薦めします。警告を無視すると、実際のパッチ適用中に問題が発生する可能性があります。

Q: 1つのデータベース・インスタンスのみが稼働している場合、どのようにしてOracle Databaseのパッチ適用を続行できますか。

A: データベースの停止時間を回避するために、少なくとも2つのインスタンスを実行することをお薦めします。2つのインスタンスを実行できない場合は、--continueWithDbDowntimeオプションをdbaascli database moveまたはdbaascli dbHome patchコマンドとともに使用して、停止時間にもかかわらずパッチ適用を続行できます。

Q: Data Guard環境では、datapatchはプライマリ・データベースとスタンバイ・データベースの両方で実行されますか。

A: いいえ。Data Guard環境では、datapatchはプライマリ・データベース・パッチ適用プロセスの一部としてのみ実行されます。

Q: Exadata Cloud@Customer (ExaDB-C@C)環境のOracle Homesで、個別ソフトウェア更新(個別パッチ)または個別パッチを手動で適用できますか。

A: はい、個別パッチまたは個別パッチは、ExaDB-C@C環境のOracle Homesに手動で適用できます。ただし、より効率的でサポートされているパッチ適用プロセスには、Oracle Databaseソフトウェア・イメージ・オプションを使用することをお薦めします。

Q: 各データベースが1つのノードのみで実行されている場合、同じOracle Homeから実行されている複数のOracleデータベースにパッチを適用するにはどうすればよいですか。

A: dbaascli dbHome patchコマンドを使用して、指定したOracle Homeにパッチを適用します。これにより、そのホームから実行されているすべてのデータベースにパッチが適用されます。ダウンタイムを回避するために、複数のインスタンスを実行することをお薦めします。複数のインスタンスを実行できない場合は、--continueWithDbDowntimeオプションを使用して、停止時間にもかかわらずパッチ適用を続行できます。

プラガブル・データベース(PDB)の管理

この項では、コンテナ・データベース(CDB)内のプラガブル・データベース(PDB)の管理について説明します。これには、PDBの作成(dbaascli pdb create)、削除(dbaascli pdb delete)およびクローニング(dbaascli pdb localClonedbaascli pdb remoteClone)用のコマンドが含まれます。PDBのオープン、クローズまたはバウンス、および接続詳細の取得(dbaascli pdb getConnectString)を行うコマンドを使用して、PDBの状態を管理できます。追加のコマンドでは、PDBのバックアップ、リカバリおよび再配置がサポートされ、PDBのライフサイクルおよび操作を包括的に制御できます。

dbaascli pdb backup

プラガブル・データベース(PDB)のバックアップ、PDBバックアップの問合せ、およびPDBバックアップの削除を行うには、dbaascli pdb backupコマンドを使用します。

前提条件

  • rootユーザーとしてコマンドを実行します。

構文

dbaascli pdb backup --pdbName <value> --dbname <value>
        {
            --start
                {
                    [--level1]
                    | [--archival --tag <value>]
                }
            | --delete --backupTag <value>
            | --status --uuid <value>
            | --getBackupReport --json <value> --tag <value>
            | --list [--json <value>]
        }
説明:
--pdbName: PDB name.
--dbname: Oracle Database name.
--start | --delete | --status | --getBackupReport | --list
--start: Begins PDB backup.
      [--level1 | --archival]
      [--level1: Creates a Level-1 (incremental) backup.]
      [--archival: Creates an archival full backup.]
          --tag: Specify backup tag.
--delete: Deletes archival backup.
          --backupTag: Specify backup tag to delete.
--status
          --uuid <value>
--getBackupReport: Returns backup report.
         --json: Specify the file name for JSON output.
         --tag: Specify backup tag.
--list: Returns PDB backup information.
         [--json: Specify the file name for JSON output.]

FAQ

Q: dbaascli pdb backupコマンドの目的は何ですか。

A: dbaascli pdb backupコマンドは、Exadata Cloud@Customer環境でのプラガブル・データベース(PDB)のバックアップの作成、バックアップ・ステータスの問合せ、バックアップ・レポートの生成およびPDBバックアップの削除に使用されます。

Q: dbaascli pdb backupコマンドを使用するための前提条件は何ですか。

A: コマンドはrootユーザーとして実行する必要があり、Exadata Cloud@Customer仮想マシンに接続する必要があります。

Q: dbaascli PDB backupコマンドを使用してPDBバックアップを開始するには、どうすればいいですか。

A: --startオプションを使用してPDBバックアップを開始できます。例:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start

Q: --startフラグではどのようなオプションを使用できますか?

A: --startフラグを使用すると、次のものを指定できます。

--level1 (レベル1の増分バックアップ用)

完全アーカイブ・バックアップの場合は--archival (バックアップ・タグを指定する場合は--tagも必要)

Q: レベル1の増分PDBバックアップを作成するにはどうすればよいですか。

A: --level1フラグを--startオプションとともに使用して、レベル1の増分バックアップを作成します。

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --level1

Q: アーカイブPDBバックアップはどのようにして作成するのですか。

A: --archivalフラグを--startオプションとともに使用し、--tagを使用してバックアップ・タグを指定します。

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --archival --tag <backup_tag>

Q: 特定のPDBバックアップを削除するにはどうすればよいですか。

A: 特定のバックアップを削除するには、--deleteフラグを使用し、--backupTagを使用してバックアップ・タグを指定します。

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --delete --backupTag <backup_tag>

Q: PDBバックアップのステータスを確認するにはどうすればよいですか。

A: --statusフラグをバックアップ--uuidとともに使用して、特定のバックアップのステータスを確認します。

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --status --uuid <backup_uuid>

Q: PDBバックアップ・レポートをJSON形式で取得するにはどうすればよいですか。

A: JSON形式のバックアップ・レポートを取得するには、--getBackupReportオプションを使用し、--jsonでファイル名を指定し、バックアップ・タグに--tagを指定します。

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --getBackupReport --json <file_name> --tag <backup_tag>

Q: 特定のPDBのすべてのPDBバックアップをリストするにはどうすればよいですか。

A: --listオプションを使用して、特定のPDBのすべてのバックアップのリストを取得します。

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list

オプションで、--jsonフラグを使用してJSON形式でリストを出力できます。

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list --json <file_name>

Q: --pdbNameオプションは何を行いますか。

A: --pdbNameオプションは、バックアップのバックアップ、問合せまたは削除の対象となるプラガブル・データベース(PDB)の名前を指定します。

Q: --dbnameオプションの目的は何ですか。

A: --dbnameオプションは、PDBが属するOracle Databaseの名前を指定します。

Q: PDBバックアップのバックアップ・タグを指定するにはどうすればよいですか。

A: アーカイブ・バックアップの開始時またはバックアップ・レポートの取得時に、--tagオプションを使用してバックアップ・タグを指定します。

--tag <backup_tag>

Q: PDBバックアップはJSONモードで実行できますか。

A: はい。バックアップ・レポート(--getBackupReport)とバックアップ・リスト(--list)の両方のオプションで、JSON形式の出力がサポートされます。JSONファイル名を指定するには、--jsonオプションを使用します。

例7-30例

  • CDB myTestDb内のPDB pdb1のレベル1バックアップを取得するには:
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --start --level1
  • uuid eef16b26361411ecb13800163e8e4facで送信されたPDBバックアップ・リクエストのステータスを問い合せるには:
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --status --uuid eef16b26361411ecb13800163e8e4fac
dbaascli pdb bounce

プラガブル・データベース(PDB)を再起動するには、dbaascli pdb bounceコマンドを使用します。

前提条件

oracleユーザーとしてコマンドを実行します。

構文

dbaascli pdb bounce --dbname --pdbName | --pdbUID
[–openMode]
説明:
  • --dbnameは、PDBをホストするコンテナ・データベースの名前を指定します
  • --pdbNameは、PDBの名前を指定します
  • --pdbUIDは、PDBの識別子を指定します
  • --openModeは、PDBのターゲットOPEN MODEを指定します

FAQ

Q: dbaascli pdb bounceコマンドの目的は何ですか。

A: dbaascli pdb bounceコマンドは、Exadata Cloud@Customer環境でプラガブル・データベース(PDB)をバウンス(再起動)するために使用します。

Q: dbaascli pdb bounceコマンドを使用するための前提条件は何ですか。

A: コマンドはoracleユーザーとして実行する必要があり、Exadata Cloud@Customer仮想マシンに接続している必要があります。

Q: 名前を指定してPDBをバウンスするにはどうすればよいですか。

A: PDBの名前を指定してPDBをバウンスするには、次の構文を使用します。

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name>

Q: 一意識別子(UID)を使用してPDBをバウンスするにはどうすればよいですか。

A: 一意識別子(UID)を使用してPDBをバウンスするには、次の構文を使用します。

dbaascli pdb bounce --dbname <CDB_Name> --pdbUID <PDB_UID>

Q: --dbnameオプションは何に使用されますか?

A: --dbnameオプションは、バウンスされるプラガブル・データベース(PDB)をホストするコンテナ・データベース(CDB)の名前を指定します。

Q: --pdbNameオプションは何に使用されますか。

A: --pdbNameオプションは、バウンスするプラガブル・データベース(PDB)の名前を指定します。

Q: --pdbUIDオプションは何に使用されますか。

A: --pdbUIDオプションは、バウンスするプラガブル・データベース(PDB)の一意の識別子(UID)を指定します。

Q: PDBをバウンスするときに、PDBのターゲット・オープン・モードを指定するにはどうすればよいですか。

A: --openModeオプションを使用して、バウンス後にPDBに必要なオープン・モードを指定できます。有効な値は、READ_WRITEおよびREAD_ONLYです。例:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE

Q: PDBをバウンスした後、読取り専用モードでオープンできますか。

A: はい、--openMode READ_ONLYオプションを使用して、バウンス後にPDBを読取り専用モードでオープンできます。

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_ONLY

Q: --openModeが指定されていない場合のデフォルトのオープン・モードは何ですか。

A: --openModeを指定しない場合、PDBはデフォルトのオープン・モードでオープンされます(通常はREAD_WRITE)。

Q: 同じコマンドで--pdbNameと--pdbUIDの両方を使用できますか。

A: いいえ、同じコマンドで--pdbNameまたは--pdbUIDのいずれかを指定する必要がありますが、両方は指定しないでください。

Q: PDBを再起動し、読取り/書込みモードでオープンすることを確認するにはどうすればよいですか。

A: PDBを再起動して読取り/書込みモードでオープンするには、--openMode READ_WRITEオプションを使用します。

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE

Q: dbaascli pdb bounceコマンドを使用する場合、オープン・モードの指定は必須ですか。

A: いいえ。--openModeの指定はオプションです。指定しない場合、PDBはデフォルト・モードでオープンします。

Q: --openModeフラグを指定しないとどうなりますか?

A: --openModeフラグが指定されていない場合、PDBはデフォルト・モードでオープンされます(通常はREAD_WRITE)。

例7-31 dbaascli pdb bounce

dbaascli pdb bounce --dbname cdb_name --pdbName pdb name associated with the CDB
dbaascli pdb bounce --dbname cdb_name --pdbUID con_uid of that pdb
オプション:
  • --openMode READ_WRITE
  • --openMode READ_ONLY
dbaascli pdb close

プラガブル・データベース(PDB)をクローズするには、dbaascli pdb closeコマンドを使用します。

前提条件

oracleユーザーとしてコマンドを実行します。

構文

dbaascli pdb close --dbname --pdbName | --pdbUID
説明:
  • --dbnameは、PDBをホストするコンテナ・データベースの名前を指定します。
  • --pdbnameは、クローズするPDBの名前を指定します。
  • --pdbUIDは、PDBの識別子を指定します

このコマンドの実行が正常に完了すると、すべてのコンテナ・データベース・インスタンスでPDBがクローズされます。

FAQ

Q: dbaascli pdb closeコマンドの目的は何ですか。

A: dbaascli pdb closeコマンドは、Exadata Cloud@Customer環境のプラガブル・データベース(PDB)をクローズするために使用します。

Q: dbaascli pdb closeコマンドを使用するための前提条件は何ですか。

A: コマンドはoracleユーザーとして実行する必要があり、Exadata Cloud@Customer仮想マシンに接続している必要があります。

Q: 名前を指定してPDBをクローズするにはどうすればよいですか。

A: 名前を指定してPDBをクローズするには、次の構文を使用します。

dbaascli pdb close --dbname <CDB_Name> --pdbName <PDB_Name>

Q: 一意識別子(UID)を指定してPDBをクローズするにはどうすればよいですか。

A: 一意識別子(UID)を使用してPDBをクローズするには、次の構文を使用します。

dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>

Q: dbaascli pdb closeコマンドで--dbnameオプションは何を行いますか。

A: --dbnameオプションは、クローズするプラガブル・データベース(PDB)をホストするコンテナ・データベース(CDB)の名前を指定します。

Q: dbaascli pdb closeコマンドで--pdbNameオプションは何を行いますか。

A: --pdbNameオプションでは、クローズするプラガブル・データベース(PDB)の名前を指定します。

Q: dbaascli pdb closeコマンドの--pdbUIDオプションの目的は何ですか。

A: --pdbUIDオプションを使用すると、クローズするプラガブル・データベース(PDB)の一意の識別子(UID)を指定できます。

Q: CDBの特定のインスタンスでPDBをクローズできますか。

A: いいえ。正常に完了すると、コンテナ・データベース(CDB)のすべてのインスタンスでPDBがクローズされます。

Q: 同じコマンドで--pdbNameと--pdbUIDの両方を指定できますか?

A: いいえ、同じコマンドで--pdbNameまたは--pdbUIDのいずれかを指定できますが、両方は指定できません。

Q: dbaascli pdb closeコマンドが正常に完了するとどうなりますか。

A: コマンドが正常に完了すると、プラガブル・データベース(PDB)はコンテナ・データベース(CDB)のすべてのインスタンスでクローズされます。

Q: CDB内の特定のPDBをUIDを使用してクローズするにはどうすればよいですか。

A: 次の操作を実行して、UIDを使用して特定のPDBをクローズできます。

dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>

Q: --pdbNameまたは--pdbUIDの指定を忘れた場合、どうなりますか。

A: コマンドで--pdbNameまたは--pdbUIDを指定する必要があります。どちらも指定されていない場合、コマンドは実行されません。

Q: CDBに対してdbaascli pdb closeコマンドを直接使用できますか。

A: いいえ。このコマンドは、CDB自体ではなく、コンテナ・データベース(CDB)内のプラガブル・データベース(PDB)を閉じるように設計されています。

例7-32 dbaascli pdb close

dbaascli pdb close --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb close --dbname cdb name --pdbUID con_uid of that pdb
dbaascli pdb create

新しいプラガブル・データベース(PDB)を作成するには、dbaascli pdb createコマンドを使用します。

前提条件

oracleユーザーとしてコマンドを実行します。

構文

dbaascli pdb create --pdbName <value> --dbName <value> 
[--maxCPU <value>] 
[--maxSize <value>] 
[--pdbAdminUserName <value>] 
[--lockPDBAdminAccount <value>] 
[--resume [--sessionID <value>]] 
[--executePrereqs <value>] 
[--waitForCompletion <value>] 
[--blobLocation |--standbyBlobFromPrimary <value>]
説明:
  • --pdbNameは、作成する新しいPDBの名前を指定します
  • --dbNameは、新しいPDBをホストするコンテナ・データベースの名前を指定します
  • --maxCPUは、オプションで、PDBに対して使用できるCPUの最大数を指定します。このオプションの設定は、PDBでCPU_COUNTパラメータを設定する場合と同じ効果があります
  • --maxSizeは、オプションで、PDBに属する表領域のデータ・ファイルおよび一時ファイルの最大合計サイズを指定します。このオプションの設定は、CREATE PLUGGABLE DATABASE SQLコマンドでMAXSIZE PDBストレージ句を設定する場合と同じ効果があります。整数に続けてサイズ単位(KMGまたはT)を指定して、制限を設定できます。または、UNLIMITEDを指定して、明示的に制限なしに設定できます。
  • --pdbAdminUserNameは、新しいPDB管理ユーザー名を指定します
  • --lockPDBAdminAccountは、PDB管理ユーザー・アカウントをロックするかどうかについてtrueまたはfalseを指定します。デフォルト値はtrueです。
  • --resumeは、前回の実行を再開します
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • --executePrereqsは、yesを指定するとこの操作の前提条件のみが実行されます。有効な値: yesまたはno
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: trueまたはfalse
  • --blobLocationは、DG環境でスタンバイBLOBファイルが生成されるカスタム・ディレクトリの場所です。
  • --standbyBlobFromPrimaryは、スタンバイBLOBファイルの場所を指定します。このファイルはプライマリ・データベースから作成されます。これは、スタンバイ・データベースのPDB操作でのみ必須です。
    ノート

    パラメータblobLocationstandbyBlobFromPrimaryは相互に排他的です。

PDBの作成プロセス中に、新しいPDBの管理パスワードを指定するように求められます。

FAQ

Q: dbaascli pdb createコマンドの目的は何ですか。

A: dbaascli pdb createコマンドは、Exadata Cloud@Customer環境のコンテナ・データベース(CDB)に新しいプラガブル・データベース(PDB)を作成するために使用します。

Q: dbaascli pdb createコマンドを使用するための前提条件は何ですか。

A: コマンドはoracleユーザーとして実行する必要があり、Exadata Cloud@Customer仮想マシンに接続している必要があります。

Q: dbaascli pdb createコマンドで--pdbNameオプションは何を行いますか。

A: --pdbNameオプションでは、作成する新しいプラガブル・データベース(PDB)の名前を指定します。

Q: dbaascli pdb createコマンドで--dbNameオプションは何を行いますか。

A: --dbNameオプションは、新しいプラガブル・データベース(PDB)をホストするコンテナ・データベース(CDB)の名前を指定します。

Q: 新しいPDBのCPUリソースを制限できますか。

A: はい。--maxCPUオプションを使用して、PDBが使用できるCPUの最大数を指定できます。これは、PDBでCPU_COUNTパラメータを設定することと同じです。

Q: PDBのストレージ・サイズを制限するにはどうすればよいですか。

A: --maxSizeオプションを使用して、PDBのデータファイルおよび一時ファイルの最大合計サイズを指定できます。サイズ制限(K、M、GまたはT)を設定するか、制限なしでUNLIMITEDを指定できます。

Q: --pdbAdminUserNameオプションは何に使用されますか。

A: --pdbAdminUserNameオプションは、新しいPDBの管理ユーザーの名前を指定します。このユーザーはPDB内の管理権限を持ちます。

Q: PDBの作成中に管理ユーザー・アカウントをロックすることはできますか。

A: はい。--lockPDBAdminAccountオプションを使用して、PDB管理アカウントをロックするかどうかを指定できます。デフォルト値はtrue (ロック済)です。

Q: dbaascli pdb createコマンドで--resumeオプションは何を行いますか。

A: --resumeオプションを使用すると、以前に失敗したPDB作成プロセスを再開できます。

Q: 前回の実行を再開するためにセッションIDを指定する方法は?

A: --sessionIDオプションを使用してセッションIDを指定して、PDB作成プロセスの特定のセッションを再開できます。

Q: --executePrereqsオプションの目的は何ですか。

A: --executePrereqsオプションは、PDB作成の前提条件チェックのみを実行するかどうかを指定します。このオプションをyesまたはnoに設定できます。

Q: PDB作成プロセスをバックグラウンドで実行できますか。

A: はい。--waitForCompletionオプションを使用し、falseに設定してバックグラウンドで操作を実行できます。

Q: --standbyBlobFromPrimaryオプションは何に使用されますか。

A: --standbyBlobFromPrimaryオプションは、スタンバイBLOBファイルの場所を指定します。このファイルはプライマリ・データベースから作成されます。これは、スタンバイ・データベースのPDB操作で必須です。

Q: 作成プロセス中にPDB管理パスワードの入力を求めるプロンプトはどのように表示されますか。

A: PDBの作成プロセス中、新しいPDBの管理パスワードを指定するように求められます。

Q: dbaascli PDB createコマンドを使用してスタンバイPDBを作成できますか。

A: はい。スタンバイPDBを作成する場合は、--standbyBlobFromPrimaryオプションを使用して、プライマリ・データベースからのスタンバイBLOBファイルの場所を指定できます。

Q: --maxSizeオプションを使用しないとどうなりますか?

A: --maxSizeオプションを指定しない場合、CDBポリシーによって特に定義されていないかぎり、PDBにはストレージ・サイズ制限はありません。

Q: --pdbAdminUserNameオプションを指定しないとどうなりますか?

A: --pdbAdminUserNameオプションを指定しない場合、PDBは指定された管理ユーザーなしで作成され、作成後に管理ユーザーを手動で構成する必要があります。

Q: 失敗したPDBの作成は、プロセスのどの時点でも再開できますか。

A: はい。セッションが終了していないかぎり、--resumeおよび--sessionIDオプションを使用して、失敗したPDBの作成を再開できます。

例7-33 dbaascli pdb create

非Data Guard環境に標準データベースのシードからPDBを作成するには:
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --maxsize 5G --maxcpu 2
Data Guard環境にPDBを作成するには:
dbaascli pdb create --dbName db721 --pdbName new_pdb1
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --standbyBlobFromPrimary /tmp/send_db721.tar
dbaascli pdb delete

プラガブル・データベース(PDB)を削除するには、dbaascli pdb deleteコマンドを使用します。

前提条件

oracleユーザーとしてコマンドを実行します。

構文

dbaascli pdb delete --dbName value 
{ --pdbName value | --pdbUID value }
[--executePrereqs value]
[--waitForCompletion value]
[--resume [--sessionID value]]
[--allStandbyPrepared]
[--cleanupRelocatedPDB]
説明:
  • --dbNameは、PDBをホストするコンテナ・データベースの名前を指定します
  • --pdbNameは、削除するPDBの名前を指定します
  • --pdbUIDは、削除するPDBのUIDを指定します
  • --executePrereqsは、yesを指定するとこの操作の前提条件のみが実行されます。有効な値: yesまたはno
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: trueまたはfalse
  • --resumeは、前回の実行を再開するように指定します
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • --allStandbyPreparedは、すべてのスタンバイ・データベースで操作が正常に実行されたことを確認するように指定します
  • --cleanupRelocatedPDB - PDBの再配置後にソース・データベースをクリーンアップするオプションです。

FAQ

Q: dbaascli pdb deleteコマンドの目的は何ですか。

A: dbaascli pdb deleteコマンドは、Exadata Cloud@Customer環境のコンテナ・データベース(CDB)からプラガブル・データベース(PDB)を削除するために使用します。

Q: dbaascli pdb deleteコマンドを実行するための前提条件は何ですか。

A: コマンドはoracleユーザーとして実行する必要があり、Exadata Cloud@Customer仮想マシンに接続している必要があります。

Q: dbaascli pdb deleteコマンドで--dbNameオプションは何を指定しますか。

A: --dbNameオプションは、削除するPDBをホストするコンテナ・データベース(CDB)の名前を指定します。

Q: dbaascli PDB deleteコマンドを使用して削除するPDBを指定するにはどうすればよいですか。

A: --pdbNameオプション(PDB名を指定)または--pdbUIDオプション(PDB UIDを指定)のいずれかを使用して、削除するPDBを指定できます。

Q: PDBを実際に削除せずに前提条件チェックを実行できますか。

A: はい。--executePrereqsオプションを使用してyesに設定し、PDB削除操作の前提条件チェックのみを実行できます。

Q: PDB削除プロセスをバックグラウンドで実行するにはどうすればよいですか。

A: --waitForCompletionオプションを使用してfalseに設定し、削除プロセスをバックグラウンドで実行します。

Q: dbaascli pdb deleteコマンドで--resumeオプションは何を行いますか。

A: --resumeオプションを使用すると、以前に失敗したPDB削除プロセスを再開できます。

Q: PDBの削除について特定のセッションを再開するにはどうすればよいですか。

A: --sessionIDオプションを使用してセッションIDを指定して、PDB削除プロセスの特定のセッションを再開できます。

Q: --allStandbyPreparedオプションは何を行いますか。

A: --allStandbyPreparedオプションを使用して、プライマリPDBの削除を続行する前に、すべてのスタンバイ・データベースで削除操作が正常に実行されたことを確認します。

Q: --cleanupRelocatedPDBオプションの目的は何ですか。

A: --cleanupRelocatedPDBオプションは、PDBの再配置後にソース・データベースをクリーン・アップし、再配置後に残余が残らないようにします。

Q: すでに再配置されているPDBは削除できますか。

A: はい。--cleanupRelocatedPDBオプションを使用して、新しいCDBにすでに再配置されているPDBを削除できます。

Q: スタンバイ・データベースで削除操作が正常に実行されることを確認するにはどうすればよいですか。

A: 続行する前に、--allStandbyPreparedオプションを使用して、すべてのスタンバイ・データベースで操作が正常に実行されたことを確認します。

Q: 削除プロセスが失敗し、再開する必要がある場合はどうなりますか。

A: --resumeオプションを使用して削除プロセスを再開し、必要に応じて--sessionIDを使用してセッションIDを指定します。

Q: --waitForCompletionをfalseに設定するとどうなりますか。

A: --waitForCompletionfalseに設定すると、削除プロセスをバックグラウンドで実行できるため、操作の完了を待たずに作業を続行できます。

例: dbaascli pdb delete

非Data Guard環境の標準データベースまたはData Guard環境のスタンバイ・データベースからPDBを削除するには:

dbaascli pdb delete --dbName db721 --pdbName pdb1

Data Guard環境でプライマリ・データベースからPDBを作成するには:

dbaascli pdb create --dbName db721 --pdbName pdb1 --allStandbyPrepared
dbaascli pdb getConnectString

プラガブル・データベース(PDB)のOracle Net接続文字列情報を表示するには、dbaascli pdb getConnectStringコマンドを実行します。

前提条件

oracleユーザーとしてコマンドを実行します。

構文

dbaascli pdb getConnectString --dbname --pdbName | --pdbUID
説明:
  • --dbnameは、PDBをホストするコンテナ・データベースの名前を指定します
  • --pdbnameは、接続文字列情報を表示するPDBの名前を指定します
  • --pdbUIDは、PDBの識別子を指定します

FAQ

Q: dbaascli pdb getConnectStringコマンドの目的は何ですか。

A: dbaascli pdb getConnectStringコマンドは、Exadata Cloud@Customer環境にあるプラガブル・データベース(PDB)のOracle Net接続文字列情報を表示するために使用します。

Q: dbaascli pdb getConnectStringコマンドを使用するための前提条件は何ですか。

A: コマンドはoracleユーザーとして実行する必要があり、Exadata Cloud@Customer仮想マシンに接続している必要があります。

Q: PDBの名前を指定して接続文字列を取得するにはどうすればよいですか。

A: PDB名を指定して接続文字列を取得するには、次の構文を使用します。

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbName <PDB_Name>

Q: 一意の識別子(UID)を指定してPDBの接続文字列を取得するにはどうすればよいですか。

A: PDBの一意の識別子(UID)を使用して接続文字列を取得するには、次の構文を使用します。

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>

Q: dbaascli pdb getConnectStringコマンドで--dbnameオプションは何を行いますか。

A: --dbnameオプションは、接続文字列情報を表示するプラガブル・データベース(PDB)をホストするコンテナ・データベース(CDB)の名前を指定します。

Q: dbaascli pdb getConnectStringコマンドで--pdbNameオプションは何を行いますか。

A: --pdbNameオプションは、Oracle Net接続文字列情報を取得するプラガブル・データベース(PDB)の名前を指定します。

Q: dbaascli pdb getConnectStringコマンドの--pdbUIDオプションの目的は何ですか。

A: --pdbUIDオプションを使用すると、接続文字列を表示するプラガブル・データベース(PDB)の一意の識別子(UID)を指定できます。

Q: 同じコマンドで--pdbNameと--pdbUIDの両方を使用できますか。

A: いいえ、同じコマンドで--pdbNameまたは--pdbUIDのいずれかを使用できますが、両方は使用できません。

Q: dbaascli pdb getConnectStringコマンドによって返される情報のタイプは何ですか。

A: このコマンドは、指定されたプラガブル・データベース(PDB)のOracle Net接続文字列情報を返します。

Q: 特定のコンテナ・データベース・インスタンスでPDBの接続文字列を取得できますか。

A: いいえ、接続文字列はPDB全体に対するもので、コンテナ・データベースの特定のインスタンスに対するものではありません。

Q: PDBの一意の識別子(UID)のみがわかっている場合、接続文字列情報はどのように取得できますか。

A: 次のコマンドを実行して、PDBのUIDを使用して接続文字列を取得できます。

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>

Q:--pdbNameまたは--pdbUIDのいずれかを指定しないとどうなりますか。

A: 接続文字列を取得するには、--pdbNameまたは--pdbUIDを指定する必要があります。このコマンドは、これらのオプションなしでは実行されません。

Q: PDBの接続文字列情報は、CDBのすべてのインスタンスで常に同じですか。

A: はい。接続文字列情報は、コンテナ・データベース(CDB)のすべてのインスタンスにわたってPDBで一貫しています。

例7-34 dbaascli pdb getConnectString

dbaascli pdb getConnectString --dbname dbname --pdbName pdbName
dbaascli pdb getDetails

プラガブル・データベース(PDB)の詳細を表示するには、dbaascli pdb getDetailsコマンドを使用します。

前提条件

oracleユーザーとしてコマンドを実行します。

構文

dbaascli pdb getDetails --dbname --pdbName | --pdbUID
説明:
  • --dbnameは、PDBをホストするコンテナ・データベースの名前を指定します
  • --pdbnameは、削除するPDBの名前を指定します
  • --pdbUIDは、PDBの識別子を指定します

FAQ

Q: dbaascli pdb getDetailsコマンドの目的は何ですか。

A: dbaascli pdb getDetailsコマンドは、Exadata Cloud@Customer環境のコンテナ・データベース(CDB)でホストされているプラガブル・データベース(PDB)の詳細を表示するために使用します。

Q: dbaascli pdb getDetailsコマンドを実行するための前提条件は何ですか。

A: コマンドはoracleユーザーとして実行する必要があり、Exadata Cloud@Customer仮想マシンに接続している必要があります。

Q: dbaascli pdb getDetailsコマンドで--dbnameオプションは何を指定しますか。

A: --dbnameオプションは、詳細を表示するPDBをホストするコンテナ・データベース(CDB)の名前を指定します。

Q: 詳細を表示するPDBをどのように指定しますか。

A: PDBを指定するには、--pdbNameオプション(PDB名を指定する場合)または--pdbUIDオプション(PDB UIDを指定する場合)のいずれかを使用します。

Q: --pdbNameと--pdbUIDの違いは何ですか?

A: --pdbNameオプションはPDBの名前を使用して詳細をフェッチしますが、--pdbUIDオプションはPDBの一意識別子(UID)を使用して詳細をフェッチします。

Q: dbaascli pdb getDetailsコマンドで--pdbNameと--pdbUIDの両方を一緒に使用できますか。

A: いいえ、--pdbNameまたは--pdbUIDオプションのいずれかを指定してPDBの詳細を取得できます。ただし、両方を同時に取得することはできません。

Q: dbaascli pdb getDetailsコマンドのユースケースにはどのようなものがありますか。

A: dbaascli pdb getDetailsコマンドを使用して、次のことを実行できます。
  • CDB内の特定のPDBに関する詳細を取得します。
  • PDBの構成を確認します。
  • CDB内のPDBのステータスを確認します。

Q: PDBの名前に基づいてPDBの詳細を表示するにはどうすればよいですか。

A: 名前に基づいてPDBの詳細を表示するには、次の構文を使用します。

dbaascli pdb getDetails --dbname <CDB_Name> --pdbName <PDB_Name>

Q: UIDに基づいてPDBの詳細を表示するにはどうすればよいですか。

A: UIDに基づいてPDBの詳細を表示するには、次の構文を使用します。

dbaascli pdb getDetails --dbname <CDB_Name> --pdbUID <PDB_UID>

Q: このコマンドは、1回の実行で複数のPDBに使用できますか。

A: いいえ。このコマンドを使用すると、名前またはUIDのいずれかを指定して、一度に1つのPDBの詳細をフェッチできます。

例7-35 dbaascli pdb getDetails

dbaascli pdb getDetails--dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb getDetails--dbname cdb name --pdbUID con_uid of that pdb
dbaascli pdb list

コンテナ・データベース内のプラガブル・データベース(PDB)のリストを表示するには、dbaascli pdb listコマンドを使用します。

前提条件

oracleユーザーとしてコマンドを実行します。

構文

dbaascli pdb list --dbname
説明:
  • --dbnameは、PDBをホストするコンテナ・データベースの名前を指定します

FAQ

Q: dbaascli pdb listコマンドの目的は何ですか。

A: dbaascli pdb listコマンドは、Exadata Cloud@Customer環境の指定されたコンテナ・データベース(CDB)内のプラガブル・データベース(PDB)のリストを表示するために使用します。

Q: dbaascli pdb listコマンドを実行するための前提条件は何ですか。

A: コマンドはoracleユーザーとして実行する必要があり、Exadata Cloud@Customer仮想マシンに接続している必要があります。

Q: dbaascli pdb listコマンドで--dbnameオプションは何を指定しますか。

A: --dbnameオプションでは、リストを表示するプラガブル・データベース(PDB)をホストするコンテナ・データベース(CDB)の名前を指定します。

Q: 複数のコンテナ・データベースから一度にPDBのリストを表示できますか。

A: いいえ。dbaascli pdb listコマンドを使用すると、一度に1つのコンテナ・データベース(CDB)からのみPDBをリストできます(--dbnameオプションで指定)。

Q: 特定のコンテナ・データベース(CDB)内のPDBはどのようにしてリストするのですか。

A: 次の構文を使用して、特定のCDB内のPDBをリストできます。

dbaascli pdb list --dbname <CDB_Name>

Q: dbaascli pdb listコマンドを使用すると、どのような情報が表示されますか。

A: このコマンドは、指定されたコンテナ・データベース(CDB)内のすべてのプラガブル・データベース(PDB)のリストを返します。リストには通常、PDBの名前と、そのステータスなどのその他の詳細が含まれます。

Q: 追加オプションを使用してPDBリストをフィルタできますか。

A: いいえ。dbaascli pdb listコマンドは、追加のフィルタリング・オプションをサポートしていません。指定されたCDB内のPDBの完全なリストを返します。

Q: 指定された--dbnameが存在しない、または正しくない場合はどうなりますか?

A: 指定した--dbnameが正しくない場合、または存在しない場合、コマンドはエラーを返し、PDBリストは表示されません。

Q: dbaascli pdb listコマンドはOracleデータベース環境で使用できますか。

A: いいえ。dbaascli pdb listコマンドは、Exadata Cloud@Customer環境で使用するために特別に設計されています。

例7-36 dbaascli pdb list

dbaascli pdb list --dbname cdb name
dbaascli pdb localClone

同じコンテナ・データベース(CDB)内に既存のプラガブル・データベース(PDB)のクローンとして新しいPDBを作成するには、dbaascli pdb localCloneコマンドを使用します。

前提条件

oracleユーザーとしてコマンドを実行します。

構文

dbaascli pdb localClone --pdbName <value> --dbName <value>
[--targetPDBName <value>]
[--powerLimit <value>]
[--maxCPU <value]
[--maxSize <value>]
[--resume [--sessionID <value>]]
[--executePrereqs]
[--waitForCompletion <value>]
{[--blobLocation <value>]|[--standbyBlobFromPrimary <value>]}
[--excludeUserTablespaces <value>] 
[--excludePDBData <value>] 
[--pdbAdminUserName <value>] 
[--lockPDBAdminAccount <value>] 
[--sourcePDBServiceConvertList <value>]
説明:
  • --pdbNameは、クローニングする新しいPDBの名前を指定します
  • --dbNameは、データベースの名前を指定します
  • --targetPDBNameは、ターゲットPDB (新しいクローンPDB)の名前を指定します
  • --powerLimitは、クローン操作に使用する並列度を指定します。有効な値は、1から128までです
  • --maxCPUは、PDBに割り当てるCPUの最大数を指定します
  • --maxSizeは、新しいPDBの最大ストレージ・サイズをGB単位で指定します
  • --resumeは、前回の実行を再開します
    • --sessionID は、特定のセッションIDを再開するように指定します
  • --executePrereqsは、yesを指定するとこの操作の前提条件のみが実行されます。有効な値: yesまたはno
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: trueまたはfalse
  • --blobLocationは、DG環境でスタンバイBLOBファイルが生成されるカスタム・ディレクトリの場所です。
  • --standbyBlobFromPrimaryは、スタンバイBLOBファイルの場所を指定します。このファイルはプライマリ・データベースから作成されます。これは、スタンバイ・データベースのPDB操作でのみ必須です。
    ノート

    パラメータ--blobLocation--standbyBlobFromPrimaryは相互に排他的です。
  • ユーザー表領域をスキップする--excludeUserTablespacesオプション(例: t1,t2,t3)。
  • --excludePDBDataは、true/yesを指定して、ソースpdbからユーザー・データをスキップします。
  • --pdbAdminUserNameは、新しいPDB管理ユーザー名を指定します。
  • --lockPDBAdminAccountは、trueまたはfalseを指定してPDB管理ユーザー・アカウントをロックします。デフォルト値はtrueです。
  • --sourcePDBServiceConvertListは、変換する必要があるソース・サービス名からターゲット・サービス名のカンマ区切りリストを指定します。構文は、source_srv1:new_srv1,source_srv2:new_srv2です。

新しくクローニングされたPDBは、ソースPDBから管理パスワードを継承します。

FAQ

Q: dbaascli pdb localCloneコマンドの目的は何ですか。

A: dbaascli pdb localCloneコマンドは、Exadata Cloud@Customer環境の同じコンテナ・データベース(CDB)内に既存のPDBのクローンとして新しいプラガブル・データベース(PDB)を作成するために使用します。

Q: dbaascli pdb localCloneコマンドを実行するための前提条件は何ですか。

A: コマンドはoracleユーザーとして実行する必要があり、Exadata Cloud@Customer仮想マシンに接続している必要があります。また、ソースPDBは、指定したCDBにすでに存在している必要があります。

Q: dbaascli pdb localCloneコマンドで--dbNameオプションは何を指定しますか。

A: --dbNameオプションは、新しいPDBのクローニング元となるソースPDBをホストするコンテナ・データベース(CDB)の名前を指定します。

Q: dbaascli pdb localCloneコマンドで--pdbNameオプションは何を指定しますか。

A: --pdbNameオプションでは、同じCDB内の既存のPDBのクローンとして作成する新しいPDBの名前を指定します。

Q: dbaascli PDB localCloneコマンドを使用して、別の名前でPDBをクローニングできますか。

A: はい。--targetPDBNameオプションを使用して、クローンPDBに別の名前を指定できます。このオプションを指定しない場合、クローニングされたPDBはソースPDBの名前を継承します。

Q: dbaascli pdb localCloneコマンドで--resumeオプションは何を行いますか。

A: --resumeオプションを使用すると、以前に中断されたPDBクローニング操作を再開できます。

Q: クローニングされたPDBで使用可能なCPUリソースを制限するにはどうすればよいですか。

A: --maxCPUオプションを使用して、クローニングされたPDBのCPUリソースを制限できます。このオプションは、新しいPDBに割り当てられるCPUの最大数を指定します。

Q: PDBクローニング操作をバックグラウンドで実行できますか。

A: はい。--waitForCompletionオプションをfalseに設定することで、バックグラウンドで操作を実行できます。trueに設定すると、操作はフォアグラウンドで実行され、完了するまで待機します。

Q: dbaascli pdb localCloneコマンドの--maxSizeオプションの目的は何ですか。

A: --maxSizeオプションは、新しくクローニングされたPDBの最大ストレージ・サイズ(GB)を指定します。サイズを指定しない場合、クローンPDBはソースPDBと同じ記憶域制限を継承します。

Q: PDBクローン操作のパラレル化を制御できますか。

A: はい。--powerLimitオプションを使用して、クローニング操作の並列度を制御できます。このオプションは、並列度を定義するために1から128までの値を受け入れます。

Q: --primaryDBWalletTarオプションは何に使用されますか。

A: --primaryDBWalletTarオプションは、プライマリ・データベース・ウォレットのtarファイルの場所を指定します。このオプションは、クローニング操作にスタンバイ・データベースのPDB操作が含まれる場合にのみ必須です。

Q: クローニング操作の前提条件チェックのみを実行できますか。

A: はい。--executePrereqsオプションを使用してyesに設定することで、前提条件チェックのみを実行できます。有効な値は、yesおよびnoです。

Q: PDBのクローニング操作が失敗した場合や中断した場合はどうなりますか。

A: クローニング操作が失敗した場合、または中断した場合は、--resumeオプションを使用して、操作が停止した場所から続行することで再開できます。

例7-37 dbaascli pdb localClone

dbaascli pdb localClone --dbName db35 --pdbName PDB35 --targetPDBName local_clone1 --maxCPU 2 --maxSize 15
dbaascli pdb open

プラガブル・データベース(PDB)をオープンするには、dbaascli pdb openコマンドを使用します。

rootまたはoracleユーザーとしてコマンドを実行します。

構文

dbaascli pdb open
 {
   --pdbName <value> | --pdbUID <value>
 }
--dbname <value> [--openMode <value>] [--startServices <value>] [--waitForCompletion <value>] [--setPDBRefreshModeNone [--skipPDBRefresh] [--pdbAdminUserName <value>]]
説明:
  • --pdbNameは、オープンするPDBの名前を指定します
  • --pdbUIDは、PDBの識別子を指定します
  • --dbnameは、PDBをホストするコンテナ・データベースの名前を指定します。
  • --openModeは、PDBのターゲットOPEN MODEを指定します
  • --startServices: PDBに対応するすべてのサービスを起動またはリストすることを指定します。指定できる値は、allまたはPDBサービスのカンマ区切りリストです。
  • --waitForCompletion: falseを指定すると、操作はバックグラウンドで実行されます。有効な値: true|false
  • --setPDBRefreshModeNone: リフレッシュ可能PDBを非リフレッシュ可能PDBに変換することを指定します
    • --skipPDBRefresh: リフレッシュ可能PDBのリフレッシュをスキップすることを指定します
    • --pdbAdminUserName:は、新しいPDB管理ユーザー名を指定します

正常に完了すると、すべてのコンテナ・データベース・インスタンスでPDBがオープンされます。

FAQ

Q: dbaascli pdb openコマンドの目的は何ですか。

A: dbaascli pdb openコマンドを使用して、Exadata Cloud@Customer環境のOracleコンテナ・データベース(CDB)でプラガブル・データベース(PDB)をオープンします。

Q: dbaascli pdb openコマンドは誰が実行できますか。

A: コマンドは、rootまたはoracleユーザーとして実行できます。

Q: dbaascli pdb openコマンドで--pdbNameオプションは何を指定しますか。

A: --pdbNameオプションは、オープンするPDBの名前を指定します。

Q: dbaascli pdb openコマンドで--pdbUIDオプションは何を指定しますか。

A: --pdbUIDオプションは、オープンするPDBの一意の識別子(UID)を指定します。

Q: dbaascli pdb openコマンドで--dbnameオプションは何を指定しますか。

A: --dbnameオプションでは、PDBをホストするコンテナ・データベース(CDB)の名前を指定します。

Q: --openModeオプションの目的は何ですか。

A: --openModeオプションは、PDBをオープンするモードを指定します。有効な値は、READ_WRITEおよびREAD_ONLYです。

Q: PDBをオープンするときにサービスを開始できますか。

A: はい。--startServicesオプションを使用して、すべてを指定してPDBに関連付けられているすべてのサービスを起動するか、開始する特定のサービスのカンマ区切りリストを指定できます。

Q: --waitForCompletionオプションをfalseに設定するとどうなりますか。

A: --waitForCompletionfalseに設定されている場合、コマンドはバックグラウンドで実行され、ユーザーは操作の完了を待機する必要はありません。trueに設定すると、コマンドは完了するまで待機してから終了します。

Q: --setPDBRefreshModeNoneオプションは何を行いますか。

A: --setPDBRefreshModeNoneオプションは、リフレッシュ可能なPDB (プライマリ・データベースから定期的に更新されるPDB)をリフレッシュ不可能なPDBに変換します。

Q: --skipPDBRefreshオプションの機能は何ですか。

A: --skipPDBRefreshオプションを使用すると、リフレッシュ可能なPDBをオープンするときにリフレッシュ操作をスキップでき、その時点でPDBがプライマリ・データベースと同期しないようにできます。

Q: dbaascli pdb openコマンドで--pdbAdminUserNameオプションは何を行いますか。

A: --pdbAdminUserNameオプションを使用すると、PDBをオープンするときに新しいPDB管理ユーザー名を指定できます。

Q: dbaascli pdb openコマンドが成功するとどうなりますか。

A: 正常に完了すると、指定したPDBはコンテナ・データベース(CDB)のすべてのインスタンスでオープンされます。

Q: リフレッシュ可能なPDBに対してdbaascli PDB openコマンドを実行できますか。

A: はい。このコマンドはリフレッシュ可能なPDBに使用できます。--setPDBRefreshModeNoneオプションはPDBをリフレッシュ不可に変換し、--skipPDBRefreshオプションはオープン・プロセス中にリフレッシュ操作をスキップします。

Q: --openModeが指定されていない場合のPDBのデフォルトのオープン・モードは何ですか。

A: --openModeが指定されていない場合、PDBは通常、デフォルトでREAD_WRITEモードでオープンされます。

例7-38 dbaascli pdb open

dbaascli pdb open --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb open --dbname cdb name --pdbUID con_uid of that pdb

オプション: --openMode READ_WRITE/READ_ONLY

dbaascli pdb recover

プラガブル・データベース(PDB)をリカバリするには、dbaascli pdb recoverコマンドを使用します。

前提条件

  • rootユーザーとしてコマンドを実行します。
  • データベースは、バックアップが格納されるバックアップ・ストレージ保存先の詳細を使用して構成する必要があります。

構文

dbaascli pdb recover --pdbName <value> --dbname <value>
        {
            --start
                {
                    --untilTime <value>
                    | --untilSCN <value>
                    | --latest
                    | --tag <value>
                }
            | --status --uuid <value>
        }
説明:
--pdbName: PDB name.
--dbname: Oracle Database name.
--start | --status
--start
       --untilTime | --untilSCN | --latest | --tag
       --untilTime: Recovers PDB until time. Input format: DD-MON-YYYY HH24:MI:SS.
       --untilSCN: Recovers PDB until SCN.
       --latest: Recovers PDB to last known state.
       --tag: Recovers PDB to archival tag.
--status
       --uuid <value>

FAQ

Q: dbaascli pdb recoverコマンドの目的は何ですか。

A: dbaascli pdb recoverコマンドは、構成済のバックアップ記憶域の保存先に格納されているバックアップを使用して、プラガブル・データベース(PDB)を前の状態にリカバリするために使用します。

Q: dbaascli pdb recoverコマンドを実行できるのは誰ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: dbaascli pdb recoverコマンドを実行する前に何が必要ですか。

A: コマンドを実行する前に、バックアップが格納されるバックアップ・ストレージ宛先の詳細を使用してデータベースを構成する必要があります。

Q: dbaascli pdb recoverコマンドで--pdbNameオプションは何が指定されていますか。

A: --pdbNameオプションは、リカバリするプラガブル・データベース(PDB)の名前を指定します。

Q: dbaascli pdb recoverコマンドで--dbnameオプションは何が指定されていますか。

A: --dbnameオプションでは、PDBをホストするコンテナ・データベース(CDB)の名前を指定します。

Q: --startオプションを使用してPDBリカバリを開始するには、どのようなオプションを使用できますか。

A: 次のいずれかのオプションを使用してPDBをリカバリできます。
  • --untilTime <value>: 指定した時間(形式: DD-MON-YYYY HH24:MI)までPDBをリカバリします。
  • --untilSCN <value>: 指定したシステム変更番号(SCN)までPDBをリカバリします。
  • --latest: PDBを最新の既知の状態にリカバリします。
  • --tag <value>: PDBを特定のアーカイブ・タグにリカバリします。

Q: --untilTimeオプションで時間を指定するために必要な形式は何ですか。

A: 時刻はDD-MON-YYYY HH24:MI:SSの書式である必要があります。

Q: dbaascli PDB recoverを使用してPDBを最新の状態にリカバリするには、どうすればいいですか。

A: PDBを最新の既知の状態にリカバリするには、--latestオプションを使用します。

dbaascli pdb recover --pdbName <value> --dbname <value> --start --latest

Q: PDBを特定のアーカイブ・タグにリカバリするにはどうすればよいですか。

A: --tagオプションを使用して、PDBを特定のタグにリカバリできます。

dbaascli pdb recover --pdbName <value> --dbname <value> --start --tag <tag_value>

Q: 特定のSCNを使用してPDBをリカバリできますか。

A: はい。--untilSCNオプションを使用して、PDBを特定のSCNにリカバリできます。

dbaascli pdb recover --pdbName <value> --dbname <value> --start --untilSCN <SCN_value>

Q: dbaascli pdb recoverコマンドで--statusオプションは何を行いますか。

A: --statusオプションは、リカバリ操作のステータスを確認するために使用されます。リカバリ・セッションを指定するには、--uuidを指定する必要があります。

Q: PDBリカバリのステータスを確認するにはどうすればよいですか。

A: リカバリ操作のステータスを確認するには、リカバリ・セッションの--uuidとともに--statusオプションを使用します。

dbaascli pdb recover --pdbName <value> --dbname <value> --status --uuid <uuid_value>

Q: recoveryコマンドで--latestオプションを指定するとどうなりますか?

A: --latestオプションを指定すると、PDBはバックアップで使用可能な最新の状態にリカバリされます。

例7-39例

  • CDB myTestDb内のPDB pdb1を最新状態にリカバリするには:
    dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --start --latest
  • uuid 81a17352362011ecbc3000163e8e4facで送信されたPDBリカバリ・リクエストのステータスを問い合せるには:
    dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --status --uuid 81a17352362011ecbc3000163e8e4fac
dbaascli pdb refresh

指定したプラガブル・データベース(PDB)をリフレッシュするには、dbaascli pdb refreshコマンドを使用します。

rootまたはoracleユーザーとしてコマンドを実行します。

構文

dbaascli pdb refresh --dbname <value>
   {
      --pdbName <value> | --pdbUID <value>
    }
    [--waitForCompletion <value>]

説明:

  • --dbname:は、Oracle Databaseの名前を指定します
  • --pdbName: プラガブル・データベースの名前を指定します
  • --pdbUID: プラガブル・データベースの識別子を指定します
  • --waitForCompletion: falseを指定すると、操作はバックグラウンドで実行されます。有効な値: true|false

FAQ

Q: dbaascli pdb refreshコマンドの目的は何ですか。

A: dbaascli pdb refreshコマンドは、コンテナ・データベース(CDB)内の指定されたプラガブル・データベース(PDB)をリフレッシュするために使用します。

Q: dbaascli pdb refreshコマンドを実行するのは誰ですか。

A: rootまたはoracleのいずれかのユーザーがコマンドを実行できます。

Q: dbaascli pdb refreshコマンドで--dbnameオプションは何が指定されていますか。

A: --dbnameオプションでは、リフレッシュするプラガブル・データベース(PDB)をホストするコンテナ・データベース(CDB)の名前を指定します。

Q: dbaascli pdb refreshコマンドで--pdbNameオプションは何を指定しますか。

A: --pdbNameオプションは、リフレッシュするプラガブル・データベース(PDB)の名前を指定します。

Q: dbaascli pdb refreshコマンドで--pdbUIDオプションは何を指定しますか。

A: --pdbUIDオプションは、リフレッシュするプラガブル・データベース(PDB)の一意の識別子(UID)を指定します。

Q: dbaascli pdb refreshコマンドで--waitForCompletionオプションは何を行いますか。

A: --waitForCompletionオプションは、操作をフォアグラウンドで実行するかバックグラウンドで実行するかを指定します。trueに設定すると、操作はフォアグラウンドで実行され、完了するまで待機します。falseに設定すると、操作はバックグラウンドで実行されます。

Q: PDBをリフレッシュしてバックグラウンドで操作を実行するにはどうすればよいですか。

A: PDBをリフレッシュしてバックグラウンドで操作を実行するには、--waitForCompletion falseオプションを使用します。

dbaascli pdb refresh --dbname <value> --pdbName <value> --waitForCompletion false

Q: 一意識別子(UID)を使用してPDBをリフレッシュするにはどうすればよいですか。

A: --pdbUIDオプションを使用してPDBをリフレッシュできます。

dbaascli pdb refresh --dbname <value> --pdbUID <value>

Q: dbaascli pdb refreshコマンドで--pdbNameと--pdbUIDの両方を同時に指定できますか。

A: いいえ。PDBのリフレッシュ時には、--pdbNameまたは--pdbUIDのいずれかを指定する必要がありますが、両方は指定できません。

Q: コマンドに--waitForCompletionオプションを含めないとどうなりますか?

A: --waitForCompletionオプションを指定しない場合、デフォルトの動作では、制御をユーザーに返す前に操作の完了を待機します。

Q: データベースの実行中にPDBをリフレッシュできますか。

A: はい。適切な権限を持つユーザーによってコマンドが実行されているかぎり、データベースの実行中にPDBをリフレッシュできます。

dbaascli pdb remoteClone

別のコンテナ・データベース(CDB)内に既存のプラガブル・データベース(PDB)のクローンとして新しいPDBを作成するには、dbaascli pdb remoteCloneコマンドを使用します。

rootまたはoracleユーザーとしてコマンドを実行します。

構文

dbaascli pdb remoteClone --pdbName <value> --dbName <value> --sourceDBConnectionString <value> [--targetPDBName <value>] [--powerLimit <value>] [--maxCPU <value>] [--maxSize <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--waitForCompletion <value>] [--sourcePDBExportedTDEKeyFile <value>]
        {
            [--blobLocation <value>]
            | [--standbyBlobFromPrimary <value>]
        }
[--excludeUserTablespaces <value>] 
[--excludePDBData <value>] 
[--pdbAdminUserName <value>] 
[--lockPDBAdminAccount <value>] 
[--sourcePDBServiceConvertList <value>] 
[--refreshablePDB --refreshMode <value> [--refreshIntervalInMinutes <value>] --dblinkUsername <value> [--honorCaseSensitiveUserName]] 
[--updateDBBlockCacheSize]
説明:
  • --pdbNameは、クローニングするソースPDBの名前を指定します
  • --dbnameは、新しくクローニングされたPDBをホストするCDBの名前(DB_NAME)を指定します。
  • --sourceDBConnectionStringは、ソース・データベースの接続文字列をscan_name:scan_port/database_service_nameというフォーマットで指定します
  • --targetPDBNameは、ターゲットPDB (新しいクローンPDB)の名前を指定します
  • --powerLimitは、クローン操作に使用する並列度を指定します。有効な値は、1から128までです
  • --maxCPUは、PDBに割り当てるCPUの最大数を指定します
  • --maxSizeは、新しいPDBの最大ストレージ・サイズをGB単位で指定します
  • --resumeは、前回の実行を再開します
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • --executePrereqsは、yesを指定するとこの操作の前提条件のみが実行されます。有効な値: yesまたはno
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: trueまたはfalse
  • --sourcePDBExportedTDEKeyFileは、ソースPDBのエクスポート済キー・ファイルを指定します。この変数は、12.1データベースにのみ適用できます
  • --blobLocationは、Data Guard環境でスタンバイBLOBファイルが生成されるカスタム・パスを指定します
  • --standbyBlobFromPrimaryは、スタンバイBLOBファイルの場所を指定します。このファイルはプライマリ・データベースから作成されます。これは、スタンバイ・データベースのPDB操作でのみ必須です
    ノート

    パラメータ--blobLocation--standbyBlobFromPrimaryは相互に排他的です。
  • ユーザー表領域をスキップする--excludeUserTablespacesオプション(例: t1,t2,t3)。
  • --excludePDBDataは、true/yesを指定して、ソースPDBからユーザー・データをスキップします。
  • --pdbAdminUserNameは、新しいPDB管理ユーザー名を指定します
  • --lockPDBAdminAccountは、PDB管理ユーザー・アカウントをロックするかどうかについてtrueまたはfalseを指定します。デフォルト値はtrueです。
  • --sourcePDBServiceConvertListは、変換する必要があるソース・サービス名からターゲット・サービス名のカンマ区切りリストを指定します。構文は、source_srv1:new_srv1, source_srv2:new_srv2です。
  • --refreshablePDBは、リフレッシュ可能なPDBを作成することを指定します
    • --refreshModeは、リフレッシュ可能なPDBのリフレッシュ・モードを指定します。有効な値: AUTO|MANUAL
      • --refreshIntervalInMinutesは、refreshablePDBのリフレッシュ間隔を分単位で指定します
    • --dblinkUsernameは、リモート・データベースに接続するためのデータベース・リンクに使用される、リモート・データベースの共通ユーザーを指定します
      • --honorCaseSensitiveUserNameは、指定されたユーザー名が大/小文字を区別することを示します
  • --updateDBBlockCacheSize: 異なるブロック・サイズのデータ・コピーをサポートするために、アプリケーションでdb block cache size初期化パラメータを設定できるように指定します

プロンプトが表示されたら、ソースPDBのSYSユーザー・パスワードを指定する必要があります。新しくクローニングされたPDBは、ソースPDBから管理パスワードを継承します。クローニングされるPDBには、dbname_sourcepdbnameという形式を使用して名前が付けられますこのコマンドは、Data Guard構成がなく、Oracle Databaseバージョン12.2.0.1以上を使用しているデータベースでのみサポートされます。

FAQ

Q: dbaascli pdb remoteCloneコマンドは何に使用されますか。

A: dbaascli pdb remoteCloneコマンドを使用して、新しいプラガブル・データベース(PDB)を別のコンテナ・データベース(CDB)内に既存のPDBのクローンとして作成します。

Q: dbaascli pdb remoteCloneコマンドを実行するユーザーはどれですか。

A: コマンドは、rootまたはoracleユーザーとして実行する必要があります。

Q: dbaascli pdb remoteClone操作中にプロンプトが表示されたら、何が必要ですか。

A: ソースPDBのSYSユーザー・パスワードを指定する必要があります。

Q: --pdbNameパラメータは何を指定しますか。

A: --pdbNameパラメータでは、クローニングするソースPDBの名前を指定します。

Q: --dbNameパラメータは何を表していますか。

A: --dbNameパラメータは、新しくクローニングされたPDBをホストするCDBの名前(DB_NAME)を表します。

Q: --sourceDBConnectionStringはどのようにフォーマットしますか。

A: --sourceDBConnectionStringは、<scan_name>:<scan_port>/<database_service_name>としてフォーマットする必要があります。

Q: --targetPDBNameパラメータの目的は何ですか。

A: --targetPDBNameパラメータは、新しくクローニングされたPDBの名前を指定します。

Q: --powerLimitは何を制御しますか。

A: --powerLimitパラメータは、クローニング操作に使用される並列度を制御します。有効な値は、1から128までです。

Q: --maxCPUパラメータは何を定義しますか。

A: --maxCPUパラメータでは、PDBクローニング・プロセスに割り当てるCPUの最大数を定義します。

Q: --maxSizeの機能は何ですか?

A: --maxSizeパラメータは、新しいPDBの最大ストレージ・サイズをGB単位で指定します。

Q: --resumeパラメータは何を行いますか。

A: --resumeパラメータは、前のクローニング操作を再開します。

Q: --resumeオプションには何を指定しますか?

A: 前の操作を再開する場合は、--sessionIDを指定して特定のセッションを再開できます。

Q: --executePrereqsは何を制御しますか。

A: --executePrereqsパラメータは、クローニング操作の前提条件のみを実行するかどうかを決定します。有効な値はyesまたはnoです。

Q: --waitForCompletionは操作にどのように影響しますか。

A: --waitForCompletionパラメータは、操作の完了を待機するか、バックグラウンドで実行するかを指定します。有効な値はtrueまたはfalseです。

Q: --sourcePDBExportedTDEKeyFileパラメータによって指定されるものは何ですか。

A: --sourcePDBExportedTDEKeyFileパラメータは、ソースPDBからエクスポートされたキー・ファイルを指定します。このパラメータはOracle Databaseバージョン12.1にのみ適用されます。

Q: --blobLocationパラメータは何を定義しますか。

A: --blobLocationパラメータは、スタンバイBLOBファイルがData Guard環境で生成されるカスタム・パスを指定します。

Q: --standbyBlobFromPrimaryはいつ使用されますか。

A: --standbyBlobFromPrimaryパラメータは、スタンバイBLOBファイルの場所を指定します。これは、スタンバイ・データベースのPDB操作でのみ必須です。

Q: --blobLocationと--standbyBlobFromPrimaryは一緒に使用できますか?

A: いいえ、--blobLocation--standbyBlobFromPrimaryは相互に排他的であり、同時に使用できません。

Q: --excludeUserTablespacesオプションは何を行いますか。

A: --excludeUserTablespacesオプションを使用すると、特定のユーザー表領域のクローニングをスキップできます。たとえば、t1、t2、t3などです。

Q: --excludePDBDataの効果は何ですか?

A: --excludePDBDataオプションは、クローニング中にソースPDBからユーザー・データをスキップするかどうかを指定します。有効な値はtrueまたはyesです。

Q: --pdbAdminUserNameによって指定されるものは何ですか。

A: --pdbAdminUserNameパラメータは、クローニングされたPDBの新しい管理ユーザー名を指定します。

Q: --lockPDBAdminAccountオプションは何を制御しますか。

A: --lockPDBAdminAccountオプションは、PDB管理ユーザー・アカウントをロックするかどうかを指定します。デフォルト値はtrueです。

Q: --sourcePDBServiceConvertListは何を指定しますか?

A: --sourcePDBServiceConvertListパラメータは、ソースからターゲットへのサービス名変換のカンマ区切りリストを指定します。たとえば、source_srv1:new_srv1source_srv2:new_srv2です。

Q: --refreshablePDBの目的は何ですか。

A: --refreshablePDBパラメータは、リフレッシュ可能なPDBを作成するかどうかを指定します。

Q: --refreshModeは何を制御しますか。

A: --refreshModeパラメータは、リフレッシュ可能なPDBのリフレッシュ・モードを制御します。有効な値は、AUTOまたはMANUALです。

Q: --refreshIntervalInMinutesはどのように機能しますか。

A: --refreshIntervalInMinutesパラメータでは、リフレッシュ可能なPDBをリフレッシュする間隔を分単位で指定します。

Q: --dblinkUsernameは何のために使用されますか。

A: --dblinkUsernameパラメータは、リモート・データベースに接続するためのデータベース・リンクに使用されるリモート・データベースの共通ユーザーを指定します。

Q: --honorCaseSensitiveUserNameオプションは何を示していますか。

A: --honorCaseSensitiveUserNameオプションは、指定されたユーザー名が大文字と小文字を区別することを示します。

Q: --updateDBBlockCacheSizeの効果は何ですか?

A: --updateDBBlockCacheSizeオプションを使用すると、ブロック・サイズが異なるデータ・コピーをサポートするために、アプリケーションでDBブロック・キャッシュ・サイズの初期化パラメータを設定できます。

Q: dbaascli pdb remoteCloneコマンドでエラーが発生した場合はどうすればよいですか。

A: エラー・メッセージで詳細を確認し、すべてのパラメータが正しく指定されていることを確認し、必要な権限と資格証明があることを確認します。また、ソース・データベースとターゲット・データベースがすべての要件を満たしていることを確認します。

Q: ソースPDBのSYSユーザー・パスワードを忘れた場合はどうなりますか。

A: ソースPDBのSYSユーザー・パスワードをリセットまたはリカバリする必要があります。これがないと、クローニング操作を完了できません。

例7-40 dbaascli pdb remoteClone

dbaascli pdb remoteClone --sourceDBConnectionString test-can.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521 --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2
dbaascli pdb remoteClone --sourceDBConnectionString orcla.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2
dbaascli pdb relocate

指定したPDBをリモート・データベースからローカル・データベースに再配置するには、dbaascli pdb relocateコマンドを使用します。

前提条件

oracleユーザーとしてコマンドを実行します。プロンプトが表示されたら、ソース・データベースのSYSユーザー・パスワードを指定する必要があります。

構文

dbaascli pdb relocate --pdbName <value> --dbName <value> --sourceDBConnectionString <value> 
[--targetPDBName <value>]
[--powerLimit <value>]
[--maxCpu <value>]
[--maxSize <value>]
[--resume [--sessionID <value>]]
[--executePrereqs <value>]
[--sourcePDBServices <value>]
[--sourcePDBReadOnlyServices <value>]
[--waitForCompletion <value>]
{
    [--blobLocation <value>] | [--standbyBlobFromPrimary <value>]
}
[--upgradePDB <value>]
[--updateDBBlockCacheSize]
{
    [skipOpenPDB] | [--completePDBRelocate]
}
説明:
  • --pdbNameは、再配置するソースPDB名を指定します
  • --dbNameは、ターゲット・データベース名を指定します
  • --sourceDBConnectionStringは、ソース・データベースの接続文字列を<scan_name>:<scan_port>/<database_service_name>というフォーマットで指定します
  • --targetPDBNameは、ターゲットPDB (新しい再配置PDB)の名前を指定します
  • --powerLimitは、再配置操作に使用する並列度を指定します
  • --maxCpuは、PDBに割り当てるCPUの最大数を指定します
  • --maxSizeは、新しいPDBの最大ストレージ・サイズをGB単位で指定します
  • --resumeは、前回の実行を再開するように指定します
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • --executePrereqsは、yesを指定するとこの操作の前提条件のみが実行されます。有効な値: yes|no
  • --sourcePDBServicesは、ソースPDBサービスのカンマ区切りリストを指定します
  • --sourcePDBReadOnlyServicesは、ソースPDB読取り専用サービスのカンマ区切りリストを指定します
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: true|false
  • --blobLocationは、スタンバイBLOBファイルがData Guard環境で生成されるカスタム・ディレクトリの場所を指定します。
  • --standbyBlobFromPrimaryは、プライマリ・データベースから準備されるスタンバイBLOBファイルの場所を指定します。これは、スタンバイ操作でのみ必須です。
    ノート

    パラメータ--blobLocationは相互に排他的です。
  • --upgradePDBでは、この操作の一部としてPDBをアップグレードするためのtrueを指定します。有効な値 : true | false
  • --updateDBBlockCachesizeは、ブロック・サイズが異なるデータ・コピーをサポートするためにアプリケーションでdb block cache size初期化パラメータを設定できるようにするオプションです。
  • --skipOpenPDB - 現在の操作の終了時にPDBをオープンしないように指定します。
  • --completePDBRelocate - 2ステップ操作として実行した場合、PDBの再配置を完了します。

FAQ

Q: dbaascli pdb relocateコマンドは何に使用されますか。

A: dbaascli pdb relocateコマンドを使用して、プラガブル・データベース(PDB)をリモート・データベースからローカル・データベースに再配置します。

Q: どのユーザーがdbaascli pdb relocateコマンドを実行する必要がありますか。

A: このコマンドは、Oracleユーザーとして実行する必要があります。

Q: dbaascli pdb relocate操作中にプロンプトが表示されたら、何が必要ですか。

A: ソース・データベースのSYSユーザー・パスワードを指定する必要があります。

Q: --pdbNameパラメータは何を指定しますか。

A: --pdbNameパラメータでは、再配置するソースPDBの名前を指定します。

Q: --dbNameパラメータの目的は何ですか。

A: --dbNameパラメータでは、PDBが再配置されるターゲット・データベース名を指定します。

Q: --sourceDBConnectionStringはどのようにフォーマットしますか。

A: --sourceDBConnectionStringは、<scan_name>:<scan_port>/<database_service_name>としてフォーマットする必要があります。

Q: --targetPDBNameパラメータは何を行いますか。

A: --targetPDBNameパラメータは、再配置されたPDBの新しい名前を指定します。

Q: --powerLimitの使用法は何ですか?

A: --powerLimitパラメータは、再配置操作時に使用する並列度を指定します。

Q: --maxCpuは再配置プロセスにどのように影響しますか。

A: --maxCpuパラメータは、PDB再配置プロセスに割り当てるCPUの最大数を指定します。

Q: --maxSizeパラメータは何を定義しますか。

A: --maxSizeパラメータは、新しいPDBの最大ストレージ・サイズをGB単位で定義します。

Q: --resumeの機能は何ですか?

A: --resumeパラメータは、再配置操作が中断された場所から再開されることを示します。

Q: --resumeオプションには何を指定しますか?

A: 前の操作を再開する場合は、--sessionIDを指定して特定のセッションを再開できます。

Q: --executePrereqsパラメータは何を行いますか。

A: --executePrereqsパラメータは、操作の前提条件のみを実行するかどうかを決定します。有効な値は「はい」または「いいえ」のいずれかです。

Q: --sourcePDBServicesパラメータによって指定されるものは何ですか。

A: --sourcePDBServicesパラメータは、ソースPDBサービスのカンマ区切りリストを指定します。

Q: --sourcePDBReadOnlyServicesパラメータ・リストとは何ですか。

A: --sourcePDBReadOnlyServicesパラメータには、ソースPDB読取り専用サービスのカンマ区切りリストがリストされます。

Q: --waitForCompletionの効果は何ですか?

A: --waitForCompletionパラメータは、バックグラウンドで操作を実行するかどうかを指定します。有効な値はtrueまたはfalseです。

Q: --blobLocationパラメータは何を指定しますか。

A: --blobLocationパラメータは、スタンバイBLOBファイルがData Guard環境で生成されるカスタム・ディレクトリの場所を指定します。

Q:--standbyBlobFromPrimaryはどのような場合に使用しますか。

A: --standbyBlobFromPrimaryを使用して、スタンバイBLOBファイルの場所を指定します。このファイルはプライマリ・データベースから作成されます。これは、スタンバイ操作でのみ必須です。

Q:--blobLocationと--standbyBlobFromPrimaryを一緒に使用できますか?

A: いいえ。--blobLocationパラメータと--standbyBlobFromPrimaryパラメータは相互に排他的であり、一緒に使用することはできません。

Q: --upgradePDBは何を行いますか。

A: --upgradePDBパラメータは、再配置操作の一部としてPDBをアップグレードするかどうかを指定します。有効な値はtrueまたはfalseです。

Q: --updateDBBlockCacheSizeの目的は何ですか。

A: --updateDBBlockCacheSizeオプションを使用すると、ブロック・サイズが異なるデータ・コピーをサポートするために、アプリケーションでDBブロック・キャッシュ・サイズの初期化パラメータを設定できます。

Q: --skipOpenPDBオプションは何を行いますか。

A: --skipOpenPDBオプションは、再配置操作の最後にPDBをオープンしないことを示します。

Q:--completePDBRelocateはどのような場合に使用しますか。

A: 2ステップ操作として実行する場合は、--completePDBRelocateを使用してPDBの再配置を完了します。

Q: dbaascli pdb relocateコマンドの使用中にエラーが発生した場合はどうすればよいですか。

A: エラー・メッセージで詳細を確認し、すべてのパラメータが正しく指定されていることを確認し、必要な権限と資格証明があることを確認します。また、前提条件および構成を確認する必要がある場合もあります。

Q: ソース・データベースのSYSユーザー・パスワードを忘れた場合はどうなりますか。

A: ソース・データベースのSYSユーザー・パスワードをリセットまたはリカバリする必要があります。それがないと、再配置操作を完了できません。

例7-41 dbaascli pdb relocate

dbaascli pdb relocate --sourceDBConnectionString test-scan.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521/source_cdb_service_name --pdbName source_pdb --dbName target_db

システム管理

この項では、システム内のOracleホームの監視および管理に焦点を当てます。これには、すべてのOracle Databaseホームの詳細を表示するdbaascli system getDBHomesや、すべてのGrid Infrastructureホームの詳細をリストするdbaascli system getGridHomesなどのコマンドが含まれます。これらのコマンドは、システム環境全体を保守およびトラブルシューティングするための重要な情報を提供します。

dbaascli system getDBHomes

すべてのOracleホームに関する情報を表示するには、dbaascli system getDBHomesコマンドを使用します。

前提条件

rootまたはoracleユーザーとしてコマンドを実行します。

構文

dbaascli system getDBHomes

FAQ

Q: dbaascli system getDBHomesコマンドは何に使用されますか。

A: dbaascli system getDBHomesコマンドは、システム上のすべてのOracleホームに関する情報を表示するために使用します。

Q: どのユーザーがdbaascli system getDBHomesコマンドを実行する必要がありますか。

A: コマンドは、rootまたはoracleユーザーとして実行する必要があります。

Q: dbaascli system getDBHomesコマンドのパラメータはありますか。

A: いいえ。dbaascli system getDBHomesコマンドにはパラメータがありません。

Q: dbaascli system getDBHomesコマンドではどのような情報が提供されますか。

A: このコマンドは、システム上のすべてのOracleホームの詳細(パスおよびその他の関連情報を含む)を提供します。

Q: dbaascli system getDBHomesコマンドの出力を解釈するにはどうすればよいですか。

A: 出力には、すべてのOracleホームが、各Oracleホームの場所などの情報とともにリストされます。この情報は、Oracle環境の管理および構成に役立ちます。

Q: dbaascli system getDBHomesコマンドで出力が返されない場合はどうすればよいですか。

A: rootまたはoracleユーザーとしてコマンドを実行していることを確認し、Oracleホームがシステムに正しくインストールされていることを確認します。システムの権限と構成を確認することもできます。

Q: dbaascli system getDBHomesコマンドの実行中にエラー・メッセージが表示された場合はどうなりますか。

A: エラー・メッセージで詳細を確認し、適切な権限があることを確認し、dbaascliツールが正しくインストールおよび構成されていることを確認します。

Q: Oracle以外のシステムでdbaascliシステムgetDBHomesを実行できますか。

A: いいえ、dbaascli system getDBHomesコマンドはOracleシステムに固有であり、Oracleソフトウェアをインストールする必要があります。

例7-42 dbaascli system getDBHomes

dbaascli system getDBHomes
dbaascli system getGridHomes

すべてのGridホームの詳細をリストするには、dbaascli system getGridHomesコマンドを使用します。

前提条件

rootまたはoracleユーザーとしてコマンドを実行します。

構文

dbaascli system getGridHomes

FAQ

Q: dbaascli system getGridHomesコマンドは何に使用されますか。

A: dbaascli system getGridHomesコマンドは、システム上のすべてのGridホームの詳細をリストするために使用します。

Q: どのユーザーがdbaascli system getGridHomesコマンドを実行する必要がありますか。

A: コマンドは、rootまたはoracleユーザーとして実行する必要があります。

Q: dbaascli system getGridHomesコマンドのパラメータはありますか。

A: いいえ。dbaascli system getGridHomesコマンドにはパラメータがありません。

Q: dbaascli system getGridHomesコマンドではどのような情報が提供されますか。

A: このコマンドは、システム上のすべてのGridホームの詳細(場所およびその他の関連情報を含む)を提供します。

Q: dbaascli system getGridHomesコマンドの出力を解釈するにはどうすればよいですか。

A: 出力には、すべてのGridホームとそのパスおよび構成などの情報がリストされます。これは、Oracle Gridインフラストラクチャの管理および構成に役立ちます。

Q: dbaascli system getGridHomesコマンドで出力が返されない場合はどうすればよいですか。

A: rootまたはoracleユーザーとしてコマンドを実行し、Oracle Gridホームがシステムに正しくインストールされていることを確認します。必要に応じて、システムの権限と構成を確認します。

Q: dbaascli system getGridHomesコマンドの実行中にエラー・メッセージが表示された場合はどうなりますか。

A: エラー・メッセージで詳細を確認し、適切な権限があることを確認し、dbaascliツールが正しくインストールおよび構成されていることを確認します。

Q: Oracle Gridインフラストラクチャを持たないシステムでdbaascliシステムgetGridHomesを実行できますか。

A: いいえ、dbaascli system getGridHomesコマンドは、Oracle Gridインフラストラクチャがインストールされているシステムに固有です。Gridホームが存在しない場合、コマンドは結果を返さないことがあります。

Transparent Data Encryption (TDE)管理

この項では、データベース・データを保護するためのTransparent Data Encryption (TDE)の管理について説明します。これには、暗号化キーおよびキーストアを処理するためのコマンド(セカンダリHSMキーを追加するdbaascli tde addSecondaryHsmKey、マスター・キーをローテーションするdbaascli tde rotateMasterKey、プラガブル・データベース内の表領域を暗号化するdbaascli tde encryptTablespacesInPDBなど)が含まれます。また、FILEベースとHSMベースのTDE (dbaascli tde fileToHsmdbaascli tde hsmToFile)間の変換、キー・バージョンの管理、および様々なコマンドによるキー詳細の取得を行うこともできます。これらのツールにより、効果的な暗号化管理とデータ・セキュリティが確保されます。

dbaascli tde addSecondaryHsmKey

既存のHSM (KMS)構成にセカンダリHSM (KMS)キーを追加するには、dbaascli tde addSecondaryHsmKeyコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde addSecondaryHsmKey --dbname <value> --secondaryKmsKeyOCID <value>
[--executePrereqs]
説明:
  • --secondaryKmsKeyOCIDは、既存のHSM (KMS)構成に追加するセカンダリKMSキーを指定します
  • --dbnameは、データベースの名前を指定します
  • --executePrereqsは、前提条件チェックを実行して結果をレポートします。

FAQ

Q: dbaascli tde addSecondaryHsmKeyコマンドは何を行いますか。

A: dbaascli tde addSecondaryHsmKeyコマンドは、Exadata Cloud@Customerデータベースの既存のHSM (KMS)構成にセカンダリHSM (KMS)キーを追加します。

Q: dbaascli tde addSecondaryHsmKeyコマンドを実行するのは誰ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: dbaascli tde addSecondaryHsmKeyコマンドはどのマシンで実行しますか。

A: このコマンドを実行するには、SSHを使用してExadata Cloud@Customer仮想マシンに接続する必要があります。

Q: このコマンドを実行する仮想マシンへの接続の詳細はどこで確認できますか?

A: 接続方法については、ガイド「SSHを使用した仮想マシンへの接続」を参照してください。

Q: --secondaryKmsKeyOCIDオプションは何を指定しますか。

A: --secondaryKmsKeyOCIDオプションは、既存のHSM (KMS)構成に追加するセカンダリKMSキーのOCID (Oracle Cloud Identifier)を指定します。

Q: --dbnameオプションの機能は何ですか。

A: --dbnameオプションを使用すると、セカンダリKMSキーを追加するデータベースの名前を指定できます。これはオプションです。

Q: --precheckOnlyオプションは何を行いますか。

A: --precheckOnlyオプションは、yesに設定すると、実際の変更を行わずに操作の事前チェックを実行します。有効な値は、yesまたはnoです。

Q: 変更せずに事前チェックを実行することはできますか?

A: はい。--precheckOnly yesオプションを使用すると、変更せずに事前チェックのみを実行できます。

Q: このコマンドを実行してセカンダリHSMキーを追加する方法の例を教えてください。

A: 次に例を示します:

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example

Q: 特定のデータベースに対してコマンドを実行するにはどうすればよいですか?

A: 次のようなデータベース名を指定できます。

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --dbname mydatabase

Q: 事前チェックのみでコマンドを実行するにはどうすればよいですか?

A: 事前チェックを実行するには、次の構文を使用します。

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --precheckOnly yes

Q: コマンドが失敗した場合はどうすればよいですか?

A: rootユーザーとしてコマンドを実行し、正しいExadata Cloud@Customer仮想マシンに接続していることを確認します。また、KMSキーのOCIDを確認し、必要な権限が付与されているかどうかを確認します。

Q: セカンダリKMSキーのOCIDが正しいかどうかを確認するにはどうすればよいですか?

A: KMSキーのOCIDは、Oracle Cloud Infrastructureコンソールの「Key Management Service (KMS)」セクションから取得できます。

Q: セカンダリKMSキーを追加するために必要な権限は何ですか?

A: KMS操作には、関連するコンパートメントのKMSキーを管理する機能など、Oracle Cloud Infrastructureで適切な権限が必要です。

Q: --dbnameオプションを指定せずにdbaascli tde addSecondaryHsmKeyコマンドを使用できますか。

A: はい、--dbnameオプションはオプションです。省略した場合、このコマンドは既存のHSM (KMS)構成を使用するすべてのデータベースに適用されます。

Q: セカンダリKMSキーを追加するとどうなりますか?

A: セカンダリKMSキーが既存の構成に追加され、暗号化キー管理の冗長性レイヤーが追加されます。

Q: セカンダリKMSキーを追加したら削除できますか?

A: いいえ、セカンダリKMSキーを追加した後は削除できません。今後はキーをローテーションまたは更新することしかできません。

例7-43 dbaascli tde addSecondaryHsmKey

dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --precheckOnly yes
dbaascli tde changePassword

別名tde_ks_passwdのTDEキーストア・パスワードおよびDBウォレット・パスワードを変更するには、dbaascli tde changePasswordコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde changePassword [--dbname <value>]
  {            [--prepareStandbyBlob <value> [--blobLocation <value>]]
               | [--standbyBlobFromPrimary <value>]
  }
  [--resume [--sessionID <value>]]
説明:
  • --dbnameは、データベースの名前を指定します
  • --prepareStandbyBlob - DG環境での操作の実行に必要なアーティファクトを含むBLOBファイルを生成するには、trueを指定します。
  • --blobLocation - DG環境でスタンバイBLOBファイルが生成されるカスタム・パス。
  • --standbyBlobFromPrimary - スタンバイBLOBファイルの場所を指定します。このファイルはプライマリ・データベースから作成されます。これは、スタンバイ操作でのみ必須です。
  • --resume - 前の実行を再開します
  • --sessionID - 特定のセッションIDを再開します。

FAQ

Q: dbaascli tde changePasswordコマンドは何を行いますか。

A: dbaascli tde changePasswordコマンドは、Transparent Data Encryption (TDE)キーストア・パスワードと、別名tde_ks_passwdのデータベース・ウォレット・パスワードを変更します。

Q: dbaascli tde changePasswordコマンドを実行するのは誰ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: dbaascli tde changePasswordコマンドはどのような場合に使用しますか。

A: Exadata Cloud@CustomerデータベースのTDEキーストア・パスワードまたはDBウォレット・パスワードを変更する必要がある場合は、このコマンドを使用します。

Q: --dbnameオプションの機能は何ですか。

A: --dbnameオプションは、TDEキーストア・パスワードを変更するデータベースの名前を指定します。

Q: --pdbNameオプションは何を行いますか。

A: --pdbNameオプションは、TDEキーストア・パスワードを変更する必要があるプラガブル・データベース(PDB)の名前を指定します。このオプションは、マルチテナント・データベースに使用されます。

Q: 特定のデータベースに対してこのコマンドを実行する方法の例を教えてください。

A: 特定のデータベースのTDEキーストア・パスワードを変更する例を次に示します。

dbaascli tde changePassword --dbname mydatabase

Q: マルチテナント・データベース内の特定のPDBに対してコマンドを実行するにはどうすればよいですか。

A: 次の構文を使用してPDB名を指定できます。

dbaascli tde changePassword --dbname mydatabase --pdbName mypdb

Q: dbaascli tde changePasswordコマンドを実行するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行し、データベースが実行されているExadata Cloud@Customer仮想マシンにアクセスできる必要があります。

Q: TDEキーストア・パスワードを変更するには、データベースを停止する必要がありますか。

A: いいえ、TDEキーストア・パスワードを変更するためにデータベースを停止する必要はありません。

Q: コマンドが失敗した場合はどうすればよいですか?

A: rootユーザーとしてコマンドを実行し、データベース名(--dbname)とPDB名(該当する場合は--pdbName)が正しいことを確認します。

Q: TDEキーストア・パスワードの変更時に「無効なパスワード」エラーが発生した場合はどうなりますか。

A: 新しいパスワードがシステムのパスワードの複雑さの要件を満たしていること、およびプロンプトが表示されたら正しい古いパスワードを入力していることを確認してください。

Q: TDEキーストア・パスワードが正常に変更されたかどうかを確認するにはどうすればよいですか。

A: データベース・ログを確認するか、Oracle Database VaultおよびKey Managementビューを使用して、TDEキーストア・パスワードの変更が成功したことを確認できます。

Q: マルチテナント・データベースおよびすべてのPDBのTDEキーストア・パスワードを一度に変更できますか。

A: いいえ。複数のPDBのパスワードを変更する必要がある場合は、PDBごとにdbaascli tde changePasswordコマンドを個別に実行する必要があります。

Q: 新しいTDEキーストア・パスワードを忘れた場合はどうなりますか。

A: 新しいパスワードを忘れた場合は、設定に応じて、バックアップからキーストアをリストアするか、Oracleのリカバリ・プロセスに従ってキーストアをリセットする必要があります。

Q: TDEキーストア・パスワードを変更するプロセスを自動化できますか。

A: dbaascli tde changePasswordコマンド自体は自動化用に設計されていませんが、必要に応じて通常のデータベース・メンテナンス手順の一部としてスクリプト化できます。

Q: TDEキーストア・パスワードはどのくらいの頻度で変更する必要がありますか。

A: Oracleでは、組織のセキュリティ・ポリシーに基づいてTDEキーストア・パスワードを定期的に変更することをお薦めします。ベスト・プラクティスは、通常、暗号化キーおよびキーストアのパスワードを定期的にローテーションすることです。

Data Guard以外の環境でTDEパスワードを変更するには
dbaascli tde changepassword --dbname
      <dbname>
Data Guard環境でTDEパスワードを変更するには
  1. プライマリ・データベースのTDEパスワードを変更します。
    dbaascli tde changepassword --dbname
          <dbname> --prepareStandbyBlob true --blobLocation
          <Location where blob file has to be generated>
  2. 作成されたスタンバイBLOBをスタンバイ・データベース環境にコピーします。
  3. スタンバイ・データベースのTDEパスワードを変更します
    dbaascli tde changepassword --dbname
         <dbname> --standbyBlobFromPrimary <Location of blob generated from
        primary>

dbaascli tde enableWalletRoot

既存のデータベースのwallet_root spfileパラメータを有効にするには、dbaascli tde enableWalletRootコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde enableWalletRoot --dbname <value>
[--dbRestart <value>]
[--executePrereqs]
[--resume [--sessionID <value>]]
説明:
  • --dbnameは、Oracle Databaseの名前を指定します。
  • --dbrestartは、データベースの再起動オプションを指定します。有効な値は、rollingまたはfullです。デフォルト値: rolling

    dbrestart引数を渡さない場合、データベースはrolling方式で再起動されます。

  • --precheckOnlyは、この操作の事前チェックのみを実行します。有効な値は、yesまたはnoです
  • --resumeは、前の実行を再開します
  • --sessionIDは、特定のセッションIDを再開します。

FAQ

Q: dbaascli tde enableWalletRootコマンドは何を行いますか。

A: dbaascli tde enableWalletRootコマンドは、Exadata Cloud@Customer上の既存のOracleデータベースに対してspfilewallet_rootパラメータを有効にします。

Q: dbaascli tde enableWalletRootコマンドを実行するのは誰ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: dbaascli tde enableWalletRootコマンドはどのマシンで実行しますか。

A: このコマンドを実行するには、SSHを使用してExadata Cloud@Customer仮想マシンに接続する必要があります。

Q: 仮想マシンに接続する手順はどこにありますか?

A: 接続の手順は、ガイド「SSHを使用した仮想マシンへの接続」を参照してください。

Q: --dbRestartオプションは何を行いますか。

A: --dbRestartオプションは、wallet_rootを有効にした後でデータベースを再起動する方法を指定します。有効な値は次のとおりです。
  • rolling: ローリング方式でデータベースを再起動します(デフォルトの動作)。
  • full: データベース全体の再起動を実行します。

Q: --dbnameオプションの機能は何ですか。

A: --dbnameオプションを使用すると、wallet_rootパラメータを有効にするOracle Databaseの名前を指定できます。

Q: --precheckOnlyオプションは何を行いますか。

A: --precheckOnlyオプションは、実際の変更を行わずに操作の事前チェックを実行します。有効な値は、yesまたはnoです。

Q: --dbRestartオプションを指定しないとどうなりますか?

A: --dbRestartオプションを指定しない場合、データベースはデフォルトでローリング方式で再起動されます。

Q: 特定のデータベースに対してwallet_rootを有効にする方法の例を教えてください。

A: mydatabaseという名前のデータベースでwallet_rootを有効にする例を次に示します。

dbaascli tde enableWalletRoot --dbname mydatabase

Q: wallet_rootを有効にし、データベースの完全再起動を指定するにはどうすればよいですか。

A: 次のコマンドを使用して、データベースの完全再起動でwallet_rootを有効にできます。

dbaascli tde enableWalletRoot --dbname mydatabase --dbRestart full

Q: 事前チェックのみでコマンドを実行するにはどうすればよいですか?

A: 変更せずに事前チェックを実行するには、次の構文を使用します。

dbaascli tde enableWalletRoot --dbname mydatabase --precheckOnly yes

Q: dbaascli tde enableWalletRootコマンドを実行するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行し、正しいExadata Cloud@Customer仮想マシンに接続する必要があります。

Q: wallet_rootを有効にするには、データベースを再起動する必要がありますか。

A: はい、データベースは、選択したオプションに応じて、ローリング方式(デフォルト)または完全に再起動する必要があります。

Q: コマンドが失敗した場合はどうすればよいですか?

A: rootユーザーとしてコマンドを実行していることを確認し、データベース名(--dbname)が正しいことを確認します。--precheckOnlyを使用して実行している場合は、事前チェック・エラーを確認します。

Q: コマンドの実行後にデータベースの再起動に失敗した場合はどうなりますか。

A: 正しい再起動オプション(rollingまたはfull)が使用されたことを確認し、データベース・ログでエラーがないか確認します。自動再起動が失敗した場合、データベースの手動再起動が必要になることがあります。

Q: wallet_rootが正常に有効になったかどうかを確認するにはどうすればよいですか。

A: データベースのspfileを確認するか、Oracle SQL問合せを使用してwallet_rootパラメータが有効になっていることを確認することで、変更を検証できます。

Q: データベースを再起動せずにwallet_rootを有効にできますか。

A: いいえ。変更を有効にするには、データベースを再起動する必要があります。ローリング再起動または完全再起動のいずれかを選択できます。

Q: データベースのローリング再起動と完全再起動の違いは何ですか。

A: ローリング再起動では、一度に1つのインスタンスでデータベースを再起動し、操作中にデータベースを部分的に使用可能にします。完全再起動では、データベース全体が停止して再起動されるため、完全な停止時間が発生します。

Q: 複数のデータベースに対してこのコマンドを同時に実行できますか?

A: wallet_rootを有効にするデータベースごとに、dbaascli tde enableWalletRootコマンドを個別に実行する必要があります。

Q: wallet_rootを有効にすると、既存のTDEキーストア構成にどのように影響しますか。

A: wallet_rootを有効にすると、TDEキーストアの場所が新しいウォレット・ルート・ディレクトリに更新され、Oracleデータベース内の複数のキーストアおよびウォレットの管理が容易になります。

例7-44 dbaascli tde enableWalletRoot

dbaascli tde enableWalletRoot --dbname db name --dbrestart rolling|full
dbaascli tde enableWalletRoot --dbname orcl
dbaascli tde enableWalletRoot --dbname orcl--dbrestart full
dbaascli tde encryptTablespacesInPDB

指定したPDB内のすべての表領域を暗号化するには、dbaascli tde encryptTablespacesInPDBコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde encryptTablespacesInPDB --dbname <value> --pdbName <value>
[--executePrereqs]
説明:
  • --pdbNameは、すべての表領域を暗号化するPDBの名前を指定します。
  • --dbnameは、Oracle Databaseの名前を指定します。
  • --executePrereqsは、前提条件チェックを実行して結果をレポートします。

FAQ

Q: dbaascli tde encryptTablespacesInPDBコマンドは何を行いますか。

A: dbaascli tde encryptTablespacesInPDBコマンドは、Exadata Cloud@Customer上のOracle Databaseについて、指定されたプラガブル・データベース(PDB)内のすべての表領域を暗号化します。

Q: dbaascli tde encryptTablespacesInPDBコマンドを実行するのは誰ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: dbaascli tde encryptTablespacesInPDBコマンドはどのマシンで実行しますか。

A: このコマンドを実行するには、SSHを使用してExadata Cloud@Customer仮想マシンに接続する必要があります。

Q: 仮想マシンに接続するための手順はどこにありますか?

A: 接続手順については、ガイド「SSHを使用した仮想マシンへの接続」を参照してください。

Q: --pdbNameオプションは何を指定しますか。

A: --pdbNameオプションは、表領域を暗号化する必要があるプラガブル・データベース(PDB)の名前を指定します。

Q: --dbnameオプションの機能は何ですか。

A: --dbnameオプションを使用すると、PDBが属するOracle Databaseの名前を指定できます。

Q: --precheckOnlyオプションは何を行いますか。

A: --precheckOnlyオプションは、実際の変更を行わずに暗号化操作の事前チェックを実行します。有効な値はyesまたはnoです。

Q: --useSysdbaCredentialオプションは何を行いますか。

A: --useSysdbaCredentialオプションは、操作にSYSDBA資格証明を使用するかどうかを指定します。有効な値はtrueとfalseです。

Q: 特定のPDBの表領域を暗号化する方法の例を教えてください。

A: mypdbという名前のPDB内のすべての表領域を暗号化する例を次に示します。

dbaascli tde encryptTablespacesInPDB --pdbName mypdb

Q: データベース内の特定のPDBの表領域はどのように暗号化するのですか。

A: 次のコマンドを使用して、PDBとデータベースの両方を指定します。

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --dbname mydatabase

Q: 暗号化を実行せずに事前チェックを実行するにはどうすればよいですか?

A: 事前チェックは、次の構文でのみ実行できます。

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --precheckOnly yes

Q: SYSDBA資格証明を使用して表領域を暗号化するにはどうすればよいですか。

A: SYSDBA資格証明を使用するには、--useSysdbaCredential trueオプションを追加します。

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --useSysdbaCredential true

Q: dbaascli tde encryptTablespacesInPDBコマンドを実行するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行し、Exadata Cloud@Customer仮想マシンにアクセスできる必要があります。

Q: 表領域を暗号化するには、データベースを再起動する必要がありますか。

A: いいえ、このコマンドではデータベースの再起動は必要ありません。暗号化は、データベースがオンラインの間実行されます。

Q: 表領域を暗号化するにはSYSDBA資格証明が必要ですか。

A: --useSysdbaCredentialオプションを使用して指定した場合、この操作にSYSDBA資格証明が必要になることがあります。

Q: コマンドが失敗した場合はどうすればよいですか?

A: rootユーザーとしてコマンドを実行していることを確認し、PDB名(--pdbName)とデータベース名(--dbname)が正しいことを確認します。完全な暗号化を実行する前に、--precheckOnly yesを指定してコマンドを実行して問題を確認することもできます。

Q: 表領域の暗号化に失敗した場合はどうすればよいですか。

A: データベース・ログを確認し、暗号化を実行するために必要な権限とリソースがあることを確認します。また、暗号化プロセスを処理するのに十分な領域があることを確認する必要がある場合もあります。

Q: PDBの表領域が暗号化されているかどうかを確認するにはどうすればよいですか。

A: 暗号化に関連するデータベース・ビュー(V$ENCRYPTED_TABLESPACESなど)を問い合せて、表領域が正常に暗号化されているかどうかを確認できます。

Q: 事前チェックが成功したかどうかを確認するにはどうすればよいですか?

A: --precheckOnly yesを指定してコマンドを実行した場合は、暗号化プロセスの潜在的な問題を示す警告またはエラーを出力で確認できます。

Q: 複数のPDBの表領域を同時に暗号化できますか。

A: いいえ、dbaascli tde encryptTablespacesInPDBコマンドはPDBごとに別々に実行する必要があります。

Q: PDBの一部の表領域は部分的に暗号化できますか。

A: いいえ。このコマンドは、指定したPDB内のすべての表領域を暗号化します。部分暗号化では、異なるデータベース管理コマンドを使用する必要があります。

Q: 表領域の暗号化はデータベースのパフォーマンスに影響しますか。

A: 表領域の暗号化は、暗号化プロセス中に一時的なパフォーマンスに影響する可能性があります。ただし、暗号化が完了したら、影響は最小限に抑える必要があります。

Q: 表領域の暗号化は元に戻せますか。

A: いいえ。表領域が暗号化されると、暗号化を元に戻すことはできません。必要に応じて、キーのみをローテーションまたは再暗号化できます。

Q: 暗号化プロセス中に操作が中断されるとどうなりますか。

A: 操作が中断された場合、コマンドの再実行が必要になることがあります。暗号化が中断された場所から再開され、データベース・ビューを使用してステータスを確認できます。

例7-45 dbaascli tde encryptTablespacesInPDB

dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb
dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb --executePrereqs 
dbaascli tde fileToHsm

ファイル・ベースのTDEをHSM (KMS/OKV)ベースのTDEに変換するには、dbaascli tde fileToHsmコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde fileToHsm --kmsKeyOCID <value> --dbname <value> 
[--skipPatchCheck <value>] 
[--executePrereqs ] 
[--primarySuc <value>]
{
    [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]]
}
[--waitForCompletion <value>]
説明:
  • --kmsKeyOCIDは、TDEに使用するKMSキーOCIDを指定します。これは、KMSがTDEに選択されている場合にのみ適用できます
  • --dbnameは、データベースの名前を指定します
  • --skipPatchCheckは、この引数に渡された値がtrueの場合、必要なパッチの検証チェックをスキップします。有効な値: trueまたはfalse
  • --executePrereqsは、前提条件チェックを実行して結果をレポートします。
  • --primarySucは、コマンドがプライマリ・データベースで正常に実行されると、Data Guard環境のスタンバイ・データベースでこのプロパティを指定します
  • --resumeは、前回の実行を再開するように指定します
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • --revertは、前の実行をロールバックすることを指定します
    • --sessionIDは、特定のセッションIDをロールバックすることを指定します。
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値 : true|false

FAQ

Q: dbaascli tde fileToHsmコマンドの目的は何ですか。

A: dbaascli tde fileToHsmコマンドは、Oracle Database Cloud Service環境で、FILEベースのTransparent Data Encryption (TDE)をハードウェア・セキュリティ・モジュール(HSM)ベースのTDE (KMSやOKVなど)に変換するために使用されます。

Q: dbaascli tde fileToHsmコマンドは誰が実行できますか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: --kmsKeyOCIDパラメータの目的は何ですか。

A: --kmsKeyOCIDパラメータは、ファイルベースからHSMベースのTDEに移行する際にTDE暗号化に使用されるKMSキーOCIDを指定します。

Q: --dbnameパラメータは何を行いますか。

A: --dbnameパラメータは、TDEをファイルベースからHSMベースに変換するデータベースの名前を指定します。

Q: TDEの変換中にパッチ検証チェックをスキップできますか。

A: はい。--skipPatchCheckパラメータを値trueとともに使用すると、必要なパッチの検証チェックをスキップできます。

Q: --executePrereqsパラメータは何に使用されますか。

A: --executePrereqsパラメータでは、実際の変換を実行せずに、TDE変換プロセスの事前チェックのみを実行できます。有効な値はyesまたはnoです。

Q: Data Guard設定で--primarySucパラメータは何を行いますか。

A: --primarySucパラメータは、コマンドがプライマリ・データベースで正常に実行されたことを示すData Guard環境で使用されます。これは、プライマリ変換の完了後にスタンバイ・データベースで指定する必要があります。

Q: 以前のTDE変換を再開するにはどうすればよいですか。

A: --resumeパラメータを使用して、以前に不完全なTDE変換を再開できます。オプションで、--sessionIDを使用して特定のセッションIDを指定できます。

Q: TDE変換を元に戻すにはどうすればよいですか。

A: 以前のTDE変換を元に戻すには、--revertパラメータを使用します。--sessionIDを使用して、元に戻す特定のセッションIDを指定することもできます。

Q: TDE変換を再開または元に戻す際にセッションIDを指定するにはどうすればよいですか。

A: --sessionIDパラメータを使用して、再開または元に戻すセッションのIDを指定できます。例: --resume --sessionID <ID>または--revert --sessionID <ID>

Q: --waitForCompletionをfalseに設定するとどうなりますか。

A: --waitForCompletionfalseに設定すると、TDE変換プロセスはバックグラウンドで実行され、コマンド・プロンプトはすぐに返されます。trueに設定すると、コマンドはプロセスの終了を待機してからユーザーに制御を戻します。

Q: --waitForCompletionパラメータの有効な値は何ですか。

A: 有効な値はtrueまたはfalseです。trueに設定すると、コマンドはプロセスが完了するまで待機します。falseに設定すると、バックグラウンドでプロセスが実行されます。

Q: TDEをすぐに変換せずにdbaascli TDE fileToHsmを実行できますか。

A: はい、--executePrereqs yesパラメータを使用して、TDEに変更を加えることなく、変換の事前チェックのみを実行できます。

Q: Data Guard環境では、プライマリでTDEを変換した後、スタンバイ・データベースをどのように処理しますか。

A: プライマリ・データベースで変換を正常に実行した後、スタンバイ・データベースでコマンドを実行するときに--primarySucを指定する必要があります。

Q: TDE変換プロセスが失敗した場合はどうすればよいですか。

A: プロセスが失敗した場合は、--resumeパラメータを使用して、中断した場所から再開を試すことができます。必要に応じて、--revertパラメータを使用して、失敗したセッション中に行われた変更をロールバックできます。

例7-46 dbaascli tde fileToHsm --kmsKeyOCID

dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs 
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --resume
dbaascli tde getHsmKeys

TDEアクティブ・キーの詳細を取得するには、dbaascli tde getHsmKeysコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde getHsmKeys
[--dbname]
[--infoFile]
説明:
  • --dbnameは、データベースの名前を指定します
  • --infoFileは、OCIDのリストが保存されるファイル・パスを指定します。出力はJSON形式です

FAQ

Q: dbaascli tde getHsmKeysコマンドは何を行いますか。

A: dbaascli tde getHsmKeysコマンドは、指定されたデータベースのハードウェア・セキュリティ・モジュール(HSM)からアクティブなTransparent Data Encryption (TDE)キーの詳細を取得します。

Q: dbaascli tde getHsmKeysコマンドを実行するのは誰ですか。

A: rootユーザーとしてコマンドを実行する必要があります。

Q: dbaascli tde getHsmKeysコマンドはどのマシンで実行しますか。

A: このコマンドを実行するには、SSHを使用してExadata Cloud@Customer仮想マシンに接続する必要があります。

Q: 仮想マシンに接続するための手順はどこにありますか?

A: 接続の手順は、ガイド「SSHを使用した仮想マシンへの接続」を参照してください。

Q: --dbnameオプションの機能は何ですか。

A: --dbnameオプションを使用すると、TDEキーの詳細を取得するOracle Databaseの名前を指定できます。

Q: --infoFileオプションは何を行いますか。

A: --infoFileオプションは、キーOCIDs (Oracle Cloud識別子)のリストが保存されるファイル・パスを指定します。出力はJSON形式です

Q: 特定のデータベースのTDEキーの詳細を取得する方法の例を教えてください。

A: mydatabaseという名前のデータベースのTDEキーの詳細を取得する例を次に示します:

dbaascli tde getHsmKeys --dbname mydatabase

Q: TDEキーの詳細をファイルに保存するにはどうすればよいですか。

A: --infoFileオプションを使用してファイル・パスを指定し、出力をJSON形式で保存できます。

dbaascli tde getHsmKeys --dbname mydatabase --infoFile /path/to/output.json

Q: dbaascli tde getHsmKeysコマンドを実行するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行し、Exadata Cloud@Customer仮想マシンに接続する必要があります。

Q: TDEキーの詳細を取得するには、SYSDBA資格証明が必要ですか。

A: いいえ。dbaascli tde getHsmKeysコマンドを実行するためにSYSDBA資格証明は必要ありません。

Q: --infoFileオプションを使用すると、TDEキー情報はどの形式で保存されますか。

A: 出力はJSON形式で保存されます。

Q: TDEキーの詳細にはどのような情報が含まれていますか。

A: 詳細には、指定されたデータベースのHSMに格納されているアクティブな暗号化キーに関するキーOCIDsおよびその他のメタデータが含まれます。

Q: コマンドでキーの詳細の取得に失敗した場合はどうすればよいですか?

A: rootユーザーとしてコマンドを実行し、データベース名(--dbname)が正しいことを確認します。Exadata Cloud@Customer仮想マシンへの接続を確認します。

Q: 出力ファイルが正常に作成されたかどうかを確認する方法は?

A: 出力JSONファイルの指定されたファイル・パスを確認できます。ファイルが欠落している場合は、ファイル・パスが正しいこと、およびディレクトリへの書込み権限があることを確認します。

Q: 出力ファイルが空の場合はどうすればいいですか?

A: 指定したデータベースにアクティブなTDEキーが含まれ、--dbnameパラメータが正しいことを確認します。また、データベース・ログにエラーがあるかどうかを確認する必要がある場合もあります。

Q: 複数のデータベースのTDEキーの詳細を一度に取得できますか。

A: いいえ、データベースごとにdbaascli tde getHsmKeysコマンドを個別に実行する必要があります。

Q: --infoFileオプションの出力ファイルを他の操作で使用するにはどうすればよいですか?

A: 出力はJSON形式であるため、ファイルをプログラムで解析するか、他のデータベースまたは暗号化管理タスクの入力として使用できます。

Q: このコマンドを使用してTDEキーの詳細履歴を取得できますか。

A: いいえ。このコマンドは、HSMで現在アクティブなキーの詳細のみを取得します。

Q: 取得したキーが正しいことを確認するにはどうすればよいですか?

A: Oracle Cloud Infrastructure (OCI)コンソールでキーを相互参照するか、暗号化管理に関連するデータベース・ビューを使用してキーを検証できます。

例7-47 dbaascli tde getHsmKeys

dbaascli tde getHsmkeys --dbname dbname
dbaascli tde getHsmkeys --dbname dbname --infoFile infoFilePath
dbaascli tde getMkidForKeyVersionOCID

KMSキー・バージョンOCIDに関連付けられたマスター・キーIDを取得するには、dbaascli tde getMkidForKeyVersionOCIDコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde getMkidForKeyVersionOCID --kmsKeyVersionOCID <value>
[--dbname <value>]
[--waitForCompletion <value>]
説明:
  • --kmsKeyVersionOCIDは、設定するKMSキー・バージョンOCIDを指定します
  • --dbnameは、データベースの名前を指定します
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値 : true|false

FAQ

Q: dbaascli tde getMkidForKeyVersionOCIDコマンドの目的は何ですか。

A: dbaascli tde getMkidForKeyVersionOCIDコマンドは、Oracle Database Cloud Service環境で特定のKMSキー・バージョンOCIDに関連付けられたマスター・キーID (MKID)を取得します。

Q: dbaascli tde getMkidForKeyVersionOCIDコマンドを実行するための前提条件は何ですか。

A: 次の必要があります。
  • rootユーザーとしてコマンドを実行します。
  • SSHを介してExadata Cloud@Customer仮想マシンに接続します。

Q: dbaascli tde getMkidForKeyVersionOCIDコマンドは誰が実行できますか。

A: rootユーザーのみがこのコマンドを実行できます。

Q: --kmsKeyVersionOCIDパラメータは何を指定しますか。

A: --kmsKeyVersionOCIDパラメータは、関連付けられたマスター・キーID (MKID)を取得するKMSキー・バージョンOCIDを指定します。

Q: --dbnameパラメータは何を指定しますか。

A: --dbnameパラメータは、KMSキー・バージョンOCIDを問い合せるデータベースの名前を指定します。

Q: --dbnameパラメータは必須ですか。

A: いいえ。--dbnameパラメータはオプションです。データベース名を指定しない場合、このコマンドはシステム上のデフォルト・データベースのMKIDを取得します。

Q: KMSキー・バージョンのOCIDがわからない場合はどうすればよいですか。

A: このコマンドを使用する前に、KMS管理コンソールまたはサービス・プロバイダからKMSキー・バージョンOCIDを取得する必要があります。それがないと、コマンドはマスター鍵ID (MKID)を取得できません。

Q: このコマンドはExadata Cloud@Customer以外の環境で実行できますか。

A: いいえ。このコマンドは特にExadata Cloud@Customer環境で使用するため、SSHを使用して仮想マシンに接続して実行する必要があります。

Q: --dbnameを使用してデータベース名を指定せずにコマンドを実行するとどうなりますか?

A: --dbnameパラメータが指定されていない場合、このコマンドはシステムで構成されているデフォルト・データベースのMKIDの取得を試みます。

Q: MKIDの取得中にエラーが発生した場合はどうすればよいですか?

A: 次のことを確認します。
  • rootユーザーとしてコマンドを実行しています。
  • Exadata Cloud@Customer仮想マシンに正しく接続されています。
  • 指定したKMSキー・バージョンOCIDは有効です。エラーが解決しない場合は、システム・ログで詳細を確認してください。

Q: Exadata Cloud@Customer仮想マシンに接続するにはどうすればよいですか。

A: SSH経由で仮想マシンに接続できます。セキュアに接続する方法のステップは、Exadata Cloud@Customerのドキュメントを参照してください。

例7-48 dbaascli tde getMkidForKeyVersionOCID

dbaascli tde getMkidForKeyVersionOCID --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
dbaascli tde getPrimaryHsmKey

既存のHSM (KMS)構成からプライマリHSM (KMS)キーを取得するには、dbaascli tde getPrimaryHsmKeyコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde getPrimaryHsmKey
[--dbname]
説明:
  • --dbnameは、データベースの名前を指定します

FAQ

Q: dbaascli tde getPrimaryHsmKeyコマンドの目的は何ですか。

A: dbaascli tde getPrimaryHsmKeyコマンドは、Oracle Database環境の既存のHSM (KMS)構成から主要なハードウェア・セキュリティ・モジュール(HSM)キーを取得します。

Q: dbaascli tde getPrimaryHsmKeyコマンドを実行するための前提条件は何ですか。

A: 次の必要があります。
  • rootユーザーとしてコマンドを実行します。
  • SSHを介してExadata Cloud@Customer仮想マシンに接続します。

Q: dbaascli tde getPrimaryHsmKeyコマンドは誰が実行できますか。

A: このコマンドを実行できるのは、rootユーザーのみです。

Q: このコマンドで--dbnameパラメータは何を指定しますか。

A: --dbnameパラメータは、プライマリHSMキーを取得するデータベースの名前を指定します。

Q: --dbnameパラメータは必須ですか。

A: いいえ。--dbnameパラメータはオプションです。指定しない場合、コマンドはシステム上のデフォルト・データベースのプライマリHSMキーを取得します。

Q: --dbnameでデータベース名を指定しない場合はどうすればよいですか?

A: --dbnameパラメータが指定されていない場合、このコマンドは、システムで構成されているデフォルト・データベースのプライマリHSMキーの取得を試みます。

Q: このコマンドはExadata Cloud@Customer以外の環境で実行できますか。

A: いいえ、このコマンドはExadata Cloud@Customer環境での使用専用に設計されており、実行するにはSSHを使用して仮想マシンに接続する必要があります。

Q: Exadata Cloud@Customer仮想マシンに接続してコマンドを実行するにはどうすればよいですか。

A: SSH経由で仮想マシンに接続できます。セキュアに接続する方法の手順については、Exadata Cloud@Customerのドキュメントを参照してください。

Q: プライマリHSMキーの取得中にエラーが発生した場合は、何を確認する必要がありますか。

A: エラーが発生する場合は、次のことを確認してください。
  • rootユーザーとしてコマンドを実行しています。
  • Exadata Cloud@Customer仮想マシンに正しく接続されています。
  • データベース名(指定されている場合)は有効です。問題が解決しない場合は、システムログまたはエラーメッセージで詳細を確認してください。

Q: dbaascli tde getPrimaryHsmKeyコマンドを実行するには、データベースを停止する必要がありますか。

A: いいえ、このコマンドを実行するためにデータベースを停止する必要はありません。データベースの実行時に実行できます。

Q: プライマリHSMキーを取得する目的は何ですか。

A: プライマリHSMキーを取得すると、データベースの既存のHSM (KMS)構成で暗号化に使用されている現在のHSMキーを識別できます。

例7-49 dbaascli tde getPrimaryHsmKey

dbaascli tde getPrimaryHsmKey --dbname dbname
dbaascli tde hsmToFile

HSM (KMS/OKV)ベースのTDEをファイル・ベースのTDEに変換するには、dbaascli tde hsmToFileコマンドを使用します。

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde hsmToFile 
[--dbname <value>] 
{
    [--prepareStandbyBlob <value> [--blobLocation <value>]
   | [--standbyBlobFromPrimary <value>]
}
] 
[--skipPatchCheck <value>] 
[--executePrereqs ] 
[--primarySuc <value>] 
{
     [--resume [--sessionID <value>]] |
     [--revert [--sessionID <value>]]
} 
[--waitForCompletion <value>]
説明:
  • --dbnameは、データベースの名前を指定します
  • --prepareStandbyBlobは、DG環境での操作の実行に必要なアーティファクトを含むBLOBファイルを生成するには、trueを指定します。
  • --blobLocationは、DG環境でスタンバイBLOBファイルが生成されるカスタム・ディレクトリの場所です。
  • --standbyBlobFromPrimaryは、スタンバイBLOBファイルの場所を指定します。このファイルはプライマリ・データベースから作成されます。これは、スタンバイ操作でのみ必須です。
  • --skipPatchCheckは、この引数に渡された値がtrueの場合、必要なパッチの検証チェックをスキップします。有効な値: trueまたはfalse
  • --executePrereqsは、前提条件チェックを実行して結果をレポートします。
  • --primarySucは、コマンドがプライマリ・データベースで正常に実行されると、Data Guard環境のスタンバイ・データベースでこのプロパティを指定します
  • --resumeは、前回の実行を再開します
    • --sessionIDは、特定のセッションIDを再開するように指定します
  • --revertは、前回の実行をロールバックするように指定します
    • --sessionIDは、特定のセッションIDをロールバックすることを指定します。
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: true|false

FAQ

Q: dbaascli tde hsmToFileコマンドの目的は何ですか。

A: dbaascli tde hsmToFileコマンドは、ハードウェア・セキュリティ・モジュール(HSM)ベースのTransparent Data Encryption (TDE)を、Oracle Database Cloud Service環境でファイルベースのTDEに変換するために使用されます。

Q: dbaascli tde hsmToFileコマンドを実行するための前提条件は何ですか。

A: 次の必要があります。
  • rootユーザーとしてコマンドを実行します。
  • データベース環境に必要な権限および構成が設定されていることを確認します。

Q: --dbnameパラメータは何を指定しますか。

A: --dbnameパラメータは、TDEをHSMベースからファイルベースに変換するデータベースの名前を指定します。

Q: --primaryDBWalletTarパラメータはいつ必要ですか。

A: --primaryDBWalletTarパラメータは、スタンバイ・データベースでhsmToFile変換を実行する場合にのみ必要です。プライマリ・データベースのウォレットのtarファイルを指定します。

Q: --skipPatchCheckパラメータの目的は何ですか。

A: --skipPatchCheckパラメータを使用すると、必要なパッチの検証チェックをスキップできます。チェックをスキップする場合はtrue、強制する場合はfalseに設定します。

Q: 実際の変換を実行せずに、変換プロセスの事前チェックのみを実行するにはどうすればよいですか。

A: --executePrereqsパラメータを使用してyesに設定し、事前チェックのみを実行できます。完全変換を実行するには、noに設定します。

Q: Data Guard環境で--primarySucパラメータは何を行いますか。

A: --primarySucパラメータは、変換がプライマリ・データベースで正常に実行されたことを示すData Guard設定で使用されます。スタンバイ・データベースで変換を実行するときに使用します。

Q: 前のhsmToFile変換を再開するにはどうすればよいですか。

A: --resumeパラメータを使用して、以前の変換を再開できます。オプションで、--sessionIDを使用して前回の実行のセッションIDを指定できます。

Q: --revertパラメータの目的は何ですか。

A: --revertパラメータは、障害が発生した場合、または操作を元に戻す必要がある場合に、以前に開始した変換プロセスをロールバックするために使用されます。

Q: --waitForCompletionをfalseに設定するとどうなりますか。

A: --waitForCompletionfalseに設定すると、操作はバックグラウンドで実行され、他のタスクを続行できます。trueに設定すると、コマンドはプロセスの完了を待機してからユーザーに制御を戻します。

Q: Data Guard設定でスタンバイ・データベースでTDEを変換する必要がある場合はどうすればよいですか。

A: Data Guardの設定では、プライマリ・データベースでTDEを変換した後、--primaryDBWalletTarパラメータを使用してスタンバイ・データベースでコマンドを実行し、プライマリ・データベースからウォレットtarファイルを指定し、--primarySucを含める必要があります。

Q: 変換中に必要なパッチのチェックをスキップする場合はどうすればよいですか。

A: --skipPatchCheckパラメータを使用してパッチ・チェックをスキップし、trueに設定できます。

Q: 変更を行わずにシステムがhsmToFile変換の準備ができているかどうかを確認するにはどうすればよいですか。

A: --executePrereqsパラメータを使用してyesに設定することで、事前チェックのみを実行できます。

Q: 変換プロセスが中断された場合、どうすればいいですか?

A: --resumeパラメータを使用して、停止したプロセスを再起動できます。必要に応じて、--sessionIDで特定のセッションIDを指定できます。

Q: 変換プロセスが失敗した場合はどうすればよいですか?

A: 変換に失敗した場合は、--revertパラメータを使用してプロセスをロールバックできます。さらに、エラー・メッセージを確認し、システム・ログで詳細を確認してください。

Q: Exadata以外の環境でdbaascli tde hsmToFileコマンドを実行できますか。

A: このコマンドは、Exadata Cloud@Customer環境で使用するように設計されています。Exadataを使用していない場合は、コマンドが正常に機能するために、サポートされている環境にいることを確認してください。

例7-50 dbaascli tde hsmToFile

dbaascli tde hsmToFile --dbname dbname
dbaascli tde hsmToFile --dbname dbname --executePrereqs
dbaascli tde hsmToFile --dbname dbname --resume
dbaascli tde listKeys

TDEマスター・キーをリストするには、dbaascli tde listKeysコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde listKeys
[--dbname <value>]
[--infoFilePath <value>]
説明:
  • --dbnameは、データベースの名前を指定します
  • --infoFilePathは、結果を保存するファイルの絶対パスを指定します。

FAQ

Q: dbaascli tde listKeysコマンドの目的は何ですか。

A: dbaascli tde listKeysコマンドは、Oracle Database環境で指定したデータベースのすべてのTransparent Data Encryption (TDE)マスター・キーをリストするために使用します。

Q: dbaascli tde listKeysコマンドを実行するための前提条件は何ですか。

A: 次の必要があります。
  • rootユーザーとしてコマンドを実行します。
  • SSHを使用してExadata Cloud@Customer仮想マシンに接続します。

Q: dbaascli tde listKeysコマンドで--fileパラメータは何を行いますか。

A: --fileパラメータは、TDEマスター・キーのリストを保存するファイル・パスを指定します。このパラメータを指定しない場合、結果は端末に直接表示されます。

Q: --dbnameパラメータは何を指定しますか。

A: --dbnameパラメータは、TDEマスター・キーをリストするデータベースの名前を指定します。

Q: --fileパラメータは必須ですか?

A: いいえ。--fileパラメータはオプションです。指定しない場合、ファイルに保存されるのではなく、端末出力にTDEキーのリストが表示されます。

Q: --dbnameパラメータは必須ですか。

A: いいえ。--dbnameパラメータはオプションです。指定しない場合、このコマンドはシステムに構成されているデフォルト・データベースのTDEマスター・キーをリストします。

Q: キーのリストをファイルに保存するにはどうすればいいですか?

A: --fileパラメータを目的のファイル・パスとともに指定する必要があります。例:

dbaascli tde listKeys --file /path/to/output.txt

Q: --dbnameでデータベース名を指定しないとどうなりますか?

A: --dbnameパラメータが指定されていない場合、このコマンドはシステム上のデフォルト・データベースのTDEマスター・キーをリストします。

Q: このコマンドはExadata Cloud@Customer以外の環境で使用できますか。

A: このコマンドは、Exadata Cloud@Customer環境専用に設計されています。適切な仮想マシンに接続して実行していることを確認します。

Q: コマンドがキーのリストに失敗した場合はどうすればよいですか?

A: 次のことを確認します。
  • rootユーザーとしてコマンドを実行しています。
  • Exadata Cloud@Customer仮想マシンに接続しています。
  • データベース名(指定されている場合)は正しいです。失敗の詳細はエラー・メッセージおよびログを確認してください。

Q: データベースの実行中にdbaascli tde listKeysコマンドを実行できますか。

A: はい。データベースの実行中にコマンドを実行できます。TDEマスター・キーをリストするだけで、データベースの状態は変更されません。

Q: このコマンドを実行するには特別な権限が必要ですか?

A: rootユーザーとしてこのコマンドを実行する必要があります。root権限がないと、コマンドを実行できません。

Q: TDEマスター・キーをリストする目的は何ですか。

A: TDEマスター・キーをリストすると、データベースのデータの保護に使用される暗号化キーを確認できます。暗号化設定の監視および管理に不可欠です。

Q: Exadata Cloud@Customer仮想マシンに接続してコマンドを実行するにはどうすればよいですか。

A: SSHを使用して仮想マシンに接続できます。セキュアな接続を確立する方法の手順については、Exadata Cloud@Customerのドキュメントを参照してください。

例7-51 dbaascli tde listKeys

dbaascli tde listKeys --dbname dbname
dbaascli tde listKeys --dbname dbname --infoFilePath infoFilePath
dbaascli tde removeSecondaryHsmKey

既存のHSM (KMS)構成からセカンダリHSM (KMS)キーを削除するには、dbaascli tde removeSecondaryHsmKeyコマンドを使用します。

前提条件

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde removeSecondaryHsmKey --dbname <value>
[--confirmDeletion]
[--secondaryKmsKeyOCID]
[--executePrereqs]
説明:
  • --dbnameは、データベースの名前を指定します
  • --confirmDeletionは、指定しない場合、既存のすべてのHSM (KMS)キーの削除中にプロンプトが表示されます。
  • --secondaryKmsKeyOCIDは、既存のHSM (KMS)構成から削除するセカンダリKMSキーです。指定しない場合、すべてのセカンダリKMSキーが削除されます。
  • --executePrereqsは、前提条件チェックを実行して結果をレポートします。

FAQ

Q: dbaascli tde removeSecondaryHsmKeyコマンドの目的は何ですか。

A: dbaascli tde removeSecondaryHsmKeyコマンドは、Oracle Database環境の既存のHSM (KMS)構成からセカンダリ・ハードウェア・セキュリティ・モジュール(HSM)キーを削除するために使用します。

Q: dbaascli tde removeSecondaryHsmKeyコマンドを実行するための前提条件は何ですか。

A: 次の必要があります。
  • rootユーザーとしてコマンドを実行します。
  • SSHを使用してExadata Cloud@Customer仮想マシンに接続します。

Q: dbaascli tde removeSecondaryHsmKeyコマンドで--forceパラメータは何を行いますか。

A: --forceパラメータを使用すると、ユーザーに確認を求めることなく、セカンダリHSMキーを削除できます。指定しない場合、コマンドはキーを削除する前にユーザーにプロンプトを表示します。

Q: --secondaryKmsKeyOCIDパラメータは何を指定しますか。

A: --secondaryKmsKeyOCIDパラメータは、既存のHSM構成から削除するセカンダリKMSキーのOCID (Oracle Cloud Identifier)を指定します。

Q: --dbnameパラメータは何を行いますか。

A: --dbnameパラメータは、セカンダリHSMキーが削除されるデータベースの名前を指定します。

Q: --precheckOnlyパラメータの目的は何ですか。

A: --precheckOnlyパラメータをyesに設定すると、2次HSMキーを実際に削除せずに、削除操作の準備状況を検証する事前チェックのみが実行されます。noに設定すると、完全な削除操作が実行されます。

Q: --forceパラメータは必須ですか。

A: いいえ。--forceパラメータはオプションです。指定しない場合、キーの削除に進む前に確認を求められます。

Q: --secondaryKmsKeyOCIDパラメータは必須ですか。

A: はい、--secondaryKmsKeyOCIDを指定して、構成から削除する特定のセカンダリHSMキーを識別する必要があります。

Q: --dbnameパラメータは必須ですか。

A: いいえ。--dbnameパラメータはオプションです。指定しない場合、コマンドはシステムのデフォルト・データベースからセカンダリHSMキーを削除しようとします。

Q: ユーザー・プロンプトなしでセカンダリHSMキーを削除する場合はどうすればよいですか。

A: --forceパラメータを使用して確認プロンプトをバイパスし、セカンダリHSMキーを直接削除する必要があります。

dbaascli tde removeSecondaryHsmKey --force --secondaryKmsKeyOCID <value>

Q: 実際に削除せずにセカンダリHSMキーを削除する準備ができているかどうかをテストするにはどうすればよいですか?

A: yesに設定された--precheckOnlyパラメータを使用して、事前チェックを実行できます。

dbaascli tde removeSecondaryHsmKey --precheckOnly yes --secondaryKmsKeyOCID <value>

Q: --dbnameでデータベース名を指定しないとどうなりますか?

A: --dbnameパラメータが指定されていない場合、このコマンドは、システムに構成されているデフォルト・データベースからセカンダリHSMキーを削除しようとします。

Q: コマンドでセカンダリHSMキーの削除に失敗した場合は、何を確認する必要がありますか。

A: 次のことを確認します。
  • rootユーザーとしてコマンドを実行しています。
  • Exadata Cloud@Customer仮想マシンに接続しています。
  • 正しい--secondaryKmsKeyOCIDおよび--dbname値が指定されています。失敗の詳細はエラー・メッセージおよびログを確認してください。

Q: 取り外し操作が部分的に失敗した場合はどうすればよいですか?

A: 操作が失敗した場合は、エラー・ログを確認し、--precheckOnlyを指定してコマンドを実行して、システムの操作準備が整っていることを確認します。必要に応じて、再試行する前に問題を修正します。

Q: データベースの実行中にdbaascli tde removeSecondaryHsmKeyコマンドを実行できますか。

A: はい、データベースの実行中にコマンドを実行できます。データベースの停止は不要です。

Q: セカンダリHSMキーを削除する目的は何ですか。

A: セカンダリHSMキーの削除は、通常、キーが不要になった場合、またはTDE (Transparent Data Encryption)構成で使用される暗号化キーを管理する場合に実行されます。

Q: Exadata Cloud@Customer仮想マシンに接続してコマンドを実行するにはどうすればよいですか。

A: SSHを使用して仮想マシンに接続できます。セキュアな接続を確立する手順は、Exadata Cloud@Customerのドキュメントを参照してください。

例7-52 dbaascli tde removeSecondaryHsmKey

dbaascli tde removeSecondaryHsmKey --dbname dbname
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs 
dbaascli tde rotateMasterKey

データベース暗号化用にマスター・キーをローテーションするには、dbaascli tde rotateMasterKeyコマンドを使用します。

前提条件:

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde rotateMasterKey --dbname <value> 
[--rotateMasterKeyOnAllPDBs] 
[--pdbName <value>] 
[--executePrereqs] 
[--resume [--sessionID <value>]]
{
     [--prepareStandbyBlob <value> [--blobLocation <value>]]
     | [--standbyBlobFromPrimary <value>]
 }
説明:
  • --dbnameは、Oracle Databaseの名前を指定します
  • --rotateMasterKeyOnAllPDBsでは、CDB内のすべてのPDBのマスター・キーをローテーションするtrueを指定します。有効な値: true|false
  • --pdbNameは、PDBの名前を指定します
  • --executePrereqsは、前提条件チェックを実行し、結果をレポートします
  • --resumeは、前回の実行を再開することを指定します
  • --sessionIDは、特定のセッションIDを再開するように指定します
  • --prepareStandbyBlobは、Data Guard環境で操作を実行するために必要なアーティファクトを含むBLOBファイルを生成するtrueを指定します
  • --blobLocationは、スタンバイBLOBファイルがData Guard環境で生成されるカスタム・ディレクトリの場所を指定します
  • --standbyBlobFromPrimaryは、プライマリ・データベースから準備されるスタンバイBLOBファイルの場所を指定します。これは、スタンバイ操作でのみ必須です。

FAQ

Q: dbaascli tde rotateMasterKeyコマンドの目的は何ですか。

A: dbaascli tde rotateMasterKeyコマンドは、Oracle DatabaseでTransparent Data Encryption (TDE)に使用されるマスター・キーをローテーションするために使用します。このプロセスにより、セキュリティを強化するために暗号化キーが更新されます。

Q: dbaascli tde rotateMasterKeyコマンドを実行するための前提条件は何ですか。

A: 次の必要があります。
  • rootユーザーとしてコマンドを実行します。
  • データベースがTDE用に正しく構成されていることを確認します。

Q: --dbnameパラメータは何を指定しますか。

A: --dbnameパラメータは、マスター暗号化キーをローテーションするOracle Databaseの名前を指定します。

Q: --rotateMasterKeyOnAllPDBsパラメータの目的は何ですか。

A: --rotateMasterKeyOnAllPDBsパラメータは、コンテナ・データベース(CDB)内のすべてのプラガブル・データベース(PDB)のマスター・キーをローテーションするかどうかを指定します。有効な値はtrueとfalseです。

Q: --pdbNameパラメータは何を行いますか。

A: --pdbNameパラメータは、すべてのPDBではなく特定のPDBのマスター・キーをローテーションする場合に、特定のプラガブル・データベース(PDB)の名前を指定します。

Q: --executePrereqsパラメータは何を行いますか。

A: --executePrereqsパラメータでは、前提条件チェックを実行して、実際のローテーションを実行せずに環境がマスター・キー・ローテーションの準備ができているかどうかを検証します。

Q: --resumeパラメータは何を指定しますか?

A: --resumeパラメータを使用して、以前に開始した操作を再開します。--sessionIDを使用して特定のセッションIDを指定して、特定のセッションを再開することもできます。

Q: --prepareStandbyBlobパラメータの目的は何ですか。

A: --prepareStandbyBlobパラメータをtrueに設定すると、Data Guard環境でマスター・キー・ローテーションを実行するために必要なアーティファクトを含むBLOBファイルが生成されます。

Q: --blobLocationパラメータは何を行いますか。

A: --blobLocationパラメータは、スタンバイBLOBファイルが生成されるカスタム・ディレクトリ・パスを指定します。これは、--prepareStandbyBlobtrueに設定されている場合に適用されます。

Q: --standbyBlobFromPrimaryパラメータは何を指定しますか。

A: --standbyBlobFromPrimaryパラメータは、プライマリ・データベースから生成されたスタンバイBLOBファイルの場所を指定します。このパラメータは、Data Guard環境のスタンバイ・データベースでマスター・キー・ローテーションを実行するときに使用されます。

Q: --rotateMasterKeyOnAllPDBsパラメータは必須ですか。

A: いいえ。--rotateMasterKeyOnAllPDBsパラメータはオプションです。指定しない場合、マスター・キーは、--dbnameまたは--pdbNameパラメータで指定されたデータベース(または特定のPDB)に対してのみローテーションされます。

Q: CDBのキーをローテーションする場合、--pdbNameパラメータは必要ですか。

A: いいえ。--pdbNameパラメータは、特定のプラガブル・データベース(PDB)のマスター・キーをローテーションする場合にのみ必要です。CDB全体のキーをローテーションする場合はオプションです。

Q: スタンドアロン・データベースには--prepareStandbyBlobおよび--standbyBlobFromPrimaryパラメータを使用する必要がありますか。

A: いいえ。これらのパラメータは、スタンバイ・データベースが含まれるData Guard環境でのみ関連します。

Q: CDB内のすべてのPDBのマスター・キーはどのようにローテーションできますか。

A: --rotateMasterKeyOnAllPDBsパラメータをtrueに設定して、CDB内のすべてのPDBのマスター・キーをローテーションする必要があります。例:

dbaascli tde rotateMasterKey --dbname CDB_NAME --rotateMasterKeyOnAllPDBs true

Q: 実際の操作を実行せずにシステムがマスター・キー・ローテーションの準備ができていることを検証するためにチェックを実行するにはどうすればよいですか。

A: --executePrereqsパラメータを使用して、前提条件チェックを実行できます。これにより、マスター鍵のローテーションを妨げる可能性のある問題が報告されます。

dbaascli tde rotateMasterKey --dbname DB_NAME --executePrereqs

Q: 操作が中断され、再開する場合はどうすればよいですか?

A: --resumeパラメータを使用して、以前に中断した操作を再開できます。セッションIDがある場合は、--sessionIDパラメータを指定します。

dbaascli tde rotateMasterKey --dbname DB_NAME --resume --sessionID <value>

Q: Data Guard環境でキー・ローテーションを準備するにはどうすればいいですか。

A: --prepareStandbyBlobパラメータを使用して、スタンバイ環境でマスター・キーをローテーションするために必要なアーティファクトを含むBLOBファイルを生成する必要があります。

dbaascli tde rotateMasterKey --dbname DB_NAME --prepareStandbyBlob true --blobLocation /path/to/blob

Q: スタンバイ・データベースでキーをローテーションするときに、プライマリ・データベースからスタンバイBLOBファイルを適用するにはどうすればよいですか。

A: --standbyBlobFromPrimaryパラメータを使用して、プライマリ・データベースで準備されたBLOBファイルの場所を指定します。

dbaascli tde rotateMasterKey --dbname DB_NAME --standbyBlobFromPrimary /path/to/blob

Q: マスターキーのローテーションが失敗するかどうかを確認するべきですか?

A: 次のことを確認します。
  • rootユーザーとしてコマンドを実行しています。
  • データベース名(--dbname)が正しい。
  • 前提条件チェックは、準備状況を確認するために--executePrereqsを使用して実行されました。エラー・ログで、失敗の詳細情報を確認します。

Q: Data Guard環境で操作が正常に完了しない場合はどうすればよいですか。

A: プライマリ・データベースのBLOBファイルが--prepareStandbyBlobを使用して正しく準備されていることを確認してから、--standbyBlobFromPrimaryを使用してスタンバイ・データベースに適用します。

Q: データベースの実行中にdbaascli tde rotateMasterKeyコマンドを実行できますか。

A: はい。データベースの実行中にコマンドを実行できます。ただし、--executePrereqsオプションを使用して前提条件チェックを事前に実行することをお薦めします。

Q: なぜマスターキーを回転させることが重要なのですか?

A: マスター・キーをローテーションすると、データ保護に使用される暗号化キーが定期的に更新され、キーが危険にさらされるリスクが軽減されるため、データベースのセキュリティが向上します。

Q: マスターキーのローテーション後にデータベースを再起動する必要がありますか?

A: いいえ、マスター・キーのローテーション後にデータベースを再起動する必要はありません。キーのローテーションは、サービスを中断することなく即時に有効になります。

dbaascli tde setKeyVersion

DB/CDBまたはPDBで使用する主キーのバージョンを設定するには、dbaascli tde setKeyVersionコマンドを使用します。

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <value>
[--pdbName <value>]
[--masterKeyID <value>]
[--standbySuc]
[--executePrereqs]
[--waitForCompletion <value>]
説明:
  • --kmsKeyVersionOCIDは、設定するKMSキー・バージョンOCIDを指定します。
  • --dbnameは、データベースの名前を指定します。
  • --pdbName キー・バージョンOCIDを使用するPDBの名前。
  • --masterKeyIDは、指定したキー・バージョンOCIDのマスター・キーIDを指定します。これは、Data Guard環境に適用されます。
  • --standbySucは、コマンドがスタンバイ・データベースで正常に実行されると、Data Guard環境のプライマリ・データベースでこのプロパティを指定します
  • --executePrereqsは、前提条件チェックを実行して結果をレポートします。
  • --waitForCompletionは、falseを指定するとバックグラウンドで操作が実行されます。有効な値: true|false

FAQ

Q: dbaascli tde setKeyVersionコマンドの目的は何ですか。

A: dbaascli tde setKeyVersionコマンドは、データベースまたはプラガブル・データベース(PDB)のTransparent Data Encryption (TDE)に使用される主キーのバージョンを設定するために使用します。これにより、特定のバージョンのKMSキーをデータベースに割り当てることができます。

Q: dbaascli tde setKeyVersionコマンドを使用するための前提条件は何ですか。

A: rootユーザーとしてコマンドを実行し、Exadata Cloud@Customer仮想マシンに接続していることを確認する必要があります。

Q: --kmsKeyVersionOCIDパラメータは何を指定しますか。

A: --kmsKeyVersionOCIDパラメータは、データベースまたはPDBに設定するKMSキー・バージョンOCID (Oracle Cloud Identifier)を指定します。

Q: --dbnameパラメータは何を指定しますか。

A: --dbnameパラメータは、キー・バージョンが設定されるOracle Databaseの名前を指定します。

Q: --pdbNameパラメータの目的は何ですか。

A: --pdbNameパラメータは、特定のKMSキー・バージョンを設定するコンテナ・データベース(CDB)内のプラガブル・データベース(PDB)の名前を指定します。

Q: --masterKeyIDパラメータは何に使用されますか。

A: --masterKeyIDパラメータは、指定したKMSキー・バージョンOCIDに関連付けられているマスター・キーIDを指定します。これは、Data Guard環境で特に重要です。

Q: --standbySucパラメータのロールは何ですか。

A: --standbySucパラメータは、Data Guard環境で使用されます。スタンバイ・データベースでコマンドを正常に実行した後、このプロパティをプライマリ・データベースに設定することを指定します。

Q: --executePrereqsパラメータは何を行いますか。

A: --executePrereqsパラメータは、操作を実行する前に前提条件チェックを実行するかどうかを指定します。有効な値はyesまたはnoです。

Q: --waitForCompletionパラメータは何を制御しますか。

A: --waitForCompletionパラメータは、操作を同期(完了を待機中)で実行するか、非同期(バックグラウンド)で実行するかを決定します。有効な値はtrueまたはfalseです。

Q: CDBのキー・バージョンを設定する場合、--pdbNameパラメータは必要ですか。

A: いいえ。--pdbNameパラメータは、特定のプラガブル・データベース(PDB)のキー・バージョンを設定する場合にのみ必要です。コンテナ・データベース(CDB)全体のキー・バージョンを設定する場合はオプションです。

Q: Data Guard以外の環境では--masterKeyIDパラメータは必要ですか。

A: いいえ。--masterKeyIDパラメータは、通常、Data Guard環境でのみ使用されます。スタンドアロン・データベースの場合、このパラメータは必要ありません。

Q: データベースのキーバージョンを設定するにはどうすればよいですか?

A: 次を実行して、データベースのキー・バージョンを設定できます。

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME>

Q: 特定のPDBのキー・バージョンを設定するにはどうすればよいですか。

A: 特定のプラガブル・データベース(PDB)のキー・バージョンを設定するには、--pdbNameパラメータをデータベース名とともに使用します。

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME> --pdbName <PDB_NAME>

Q: キーバージョンを設定する前に、すべての前提条件が満たされていることを確認するにはどうすればよいですか?

A: --executePrereqsパラメータを使用して、前提条件チェックを実行できます。

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --executePrereqs yes

Q: Data Guard環境でキー・バージョンを設定するにはどうすればよいですか。

A: Data Guard環境では、次のことが必要です。
  • スタンバイ・データベースでコマンドを実行します。

    dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --masterKeyID <keyID> --dbname <DB_NAME>

  • スタンバイ・データベースでコマンドを正常に実行した後、--standbySucパラメータを使用してプライマリ・データベースでコマンドを実行します。

    dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME> --standbySuc yes

Q: 操作が完了するのを待たずにバックグラウンドで実行するにはどうすればよいですか?

A: --waitForCompletionfalseに設定することで、操作を非同期で実行できます。

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --waitForCompletion false

Q: キーバージョンの設定に失敗した場合はどうすればよいですか?

A: 次のことを確認します。
  • rootユーザーとしてコマンドを実行しています。
  • KMSキー・バージョンOCIDが正しい。
  • 前提条件チェックは、準備状況を確認するために--executePrereqsを使用して実行されました。エラー・ログで特定の詳細を確認し、必要に応じて操作を再実行します。

Q: Data Guard環境で操作が正常に完了しない場合は、何を確認する必要がありますか。

A: スタンバイ・データベースでコマンドを実行するときに、--masterKeyIDパラメータが正しく指定されていることを確認します。スタンバイで完了したら、プライマリ・データベースでコマンドを実行するときに--standbySucパラメータを使用する必要があります。

Q: データベースの実行中にdbaascli tde setKeyVersionコマンドを実行できますか。

A: はい。データベースの実行中にコマンドを実行できます。ただし、--executePrereqsを使用して事前に前提条件チェックを実行することをお薦めします。

Q: データベースに正しいKMSキー・バージョンを設定することが重要なのはなぜですか。

A: 正しいKMSキー・バージョンを設定すると、データベースがTDEに適切な暗号化キー・バージョンを使用していることが保証されます。これは、データのセキュリティと組織ポリシーへの準拠の維持に役立ちます。

Q: 間違ったKMSキー・バージョンのOCIDを使用するとどうなりますか。

A: 不正なKMSキー・バージョンOCIDが使用されている場合、暗号化が失敗し、データベースで暗号化操作に不正なキーを使用できないことがあります。正しいキー・バージョンOCIDが指定されていることを確認する必要があります。

Q: キーバージョンの設定後にデータベースを再起動する必要がありますか?

A: いいえ、キー・バージョンの設定後にデータベースを再起動する必要はありません。新しい鍵バージョンは、再起動しなくてもすぐに有効になります。

例7-53 dbaascli tde setKeyVersion

dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha --executePrereqs
dbaascli tde setKeyVersion --dbname dbname --pdbName pdb --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
dbaascli tde setPrimaryHsmKey

既存のHSM (KMS)構成のプライマリHSM (KMS)キーを変更するには、dbaascli tde setPrimaryHsmKeyコマンドを使用します。

rootユーザーとしてコマンドを実行します。

構文

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <value> --dbname <value>
[--allStandbyPrepared]
[--bounceDatabase]
[--executePrereqs]
[--resume [--sessionID <value>]]
説明:
  • --primaryKmsKeyOCIDは、設定するプライマリKMSキーを指定します
  • --dbnameは、データベースの名前を指定します
  • --allStandbyPreparedは、すべてのスタンバイ・データベースで操作が正常に実行されたことを確認するように指定します。
  • --bounceDatabase この操作に対してローリング・データベース・バウンスを実行するには、このフラグを指定します
  • --executePrereqsは、前提条件チェックを実行して結果をレポートします。
  • --resumeは、前の実行を再開します
  • --sessionIDは、特定のセッションIDを再開します。

FAQ

Q: dbaascli tde setPrimaryHsmKeyコマンドの目的は何ですか。

A: dbaascli tde setPrimaryHsmKeyコマンドは、Transparent Data Encryption (TDE)の既存のHSM/KMS構成のプライマリHSM (ハードウェア・セキュリティ・モジュール)またはKMS (キー管理サービス)キーを変更するために使用します。

Q: dbaascli tde setPrimaryHsmKeyコマンドを実行するための前提条件は何ですか。

A: コマンドはrootユーザーとして実行する必要があり、環境はExadata Cloud@Customer仮想マシンである必要があります。

Q: --primaryKmsKeyOCIDパラメータは何を指定しますか。

A: --primaryKmsKeyOCIDパラメータは、TDE環境に設定するプライマリKMSキーのOCID (Oracle Cloud Identifier)を指定します。

Q: --dbnameパラメータの機能は何ですか?

A: --dbnameパラメータは、プライマリHSM/KMSキーを設定するOracle Databaseの名前を指定します。

Q: --standbySucパラメータは何を行いますか。

A: --standbySucパラメータは、Data Guard環境で使用されます。コマンドをスタンバイ・データベースで正常に実行した後、プライマリ・データベースで実行するように指定します。

Q: --precheckOnlyパラメータの目的は何ですか。

A: --precheckOnlyパラメータでは、この操作の事前チェックのみを実行できます。これは、実際の変更を行わずに環境を検証します。有効な値はyesまたはnoです。

Q: --bounceDatabaseパラメータは何を制御しますか。

A: --bounceDatabaseパラメータは、操作の一部としてデータベースをローリング方式でバウンス(再起動)するかどうかを指定します。これにより、データベースの一部を1つずつ再起動することで、停止時間が最小限に抑えられます。

Q: データベースのプライマリKMSキーを設定するにはどうすればよいですか?

A: プライマリKMSキーを設定するには、次のコマンドを実行します:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME>

Q: 操作を問題なく実行できるようにするにはどうすればよいですか?

A: --precheckOnlyパラメータを指定して操作を実行し、すべての前提条件が満たされていることを確認します。

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --precheckOnly yes

Q: Data Guard環境でプライマリKMSキーを設定するにはどうすればよいですか。

A: まず、スタンバイ・データベースでコマンドを実行します。

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME>

次に、--standbySucパラメータを使用して、プライマリ・データベースでコマンドを実行します。

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME> --standbySuc yes

Q: プライマリKMSキーの変更中にダウンタイムを最小限に抑えるにはどうすればよいですか?

A: --bounceDatabaseパラメータを使用してローリング再起動を実行し、停止時間を最小限に抑えることができます。

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --bounceDatabase

Q: --dbnameパラメータはすべてのデータベースに必要ですか。

A: はい、--dbnameパラメータを指定して、プライマリKMSキーを設定するターゲット・データベースを指定する必要があります。

Q: Data Guard環境で--standbySucパラメータを使用することは必須ですか。

A: はい。スタンバイ・データベースでコマンドを正常に実行した後、プライマリ・データベースでコマンドを実行する場合は、--standbySucパラメータを使用する必要があります。

Q: データベースのバウンス操作はスキップできますか。

A: はい。--bounceDatabaseパラメータを指定しない場合、データベースは操作の一部としてバウンス(再起動)されません。

Q: 実行中にコマンドが失敗した場合はどうすればよいですか?

A: コマンドが失敗した場合は、次のことを確認してください。
  • rootユーザーとして実行しています。
  • 正しい--primaryKmsKeyOCIDおよび--dbname値が指定されています。
  • 環境は、すべての前提条件チェックに合格します(--precheckOnlyで実行)。

Q: Data Guard環境で操作が失敗した場合はどうなりますか。

A: コマンドがスタンバイ・データベースで正常に実行されていることを確認してから、プライマリで実行してください。ログにエラーがないか確認し、正しいパラメータを指定して操作を再実行します。

Q: ライブ・データベースでdbaascli tde setPrimaryHsmKeyコマンドを実行できますか。

A: はい、データベースが稼働している間はコマンドを実行できます。ただし、--bounceDatabaseパラメータを使用すると、影響を最小限に抑えるローリング方式でデータベースを再起動します。

Q: 完全な停止時間を回避するために、ローリング方式でコマンドを実行するにはどうすればよいですか。

A: --bounceDatabaseパラメータを使用して、プライマリKMSキーの変更中にデータベースのローリング再起動を実行します。

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --bounceDatabase

Q: 主キーを変更する意味は何ですか?

A: プライマリKMSキーを変更すると、データベースではTransparent Data Encryption (TDE)に更新された暗号化キーまたは異なる暗号化キーが使用されます。これは、セキュリティまたはコンプライアンス上の理由から必要になる場合があります。

Q: どのくらいの頻度でプライマリKMSキーをローテーションまたは変更する必要がありますか?

A: 厳密なルールはありませんが、組織はキー・ローテーション間隔やコンプライアンス要件などのセキュリティ・ポリシーに基づいてプライマリKMSキーをローテーションできます。

Q: プライマリKMSキーが正しく設定されていない場合はどうなりますか。

A: 不正なキーOCIDが設定されている場合、データベース暗号化操作が失敗し、正しいキーに戻すか、正しいKMSキーOCIDを設定して構成を修正する必要がある場合があります。

Q: プライマリKMSキーを変更した後、データベースを再起動する必要がありますか。

A: いいえ、--bounceDatabaseパラメータを使用することを選択しないかぎり、データベースを再起動する必要はありません。これにより、変更を適用するためにデータベースが自動的に再起動されます。

例7-54 dbaascli tde setPrimaryHsmKey

dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs
dbaascli tde status

指定したデータベースのキーストアに関する情報を表示するには、dbaascli tde statusコマンドを使用します。

前提条件

oracleユーザーとしてコマンドを実行します。

構文

dbaascli tde status --dbname dbname
説明:
  • --dbnameは、確認するデータベースの名前を指定します。

このコマンドからの出力には、キーストアのタイプおよびキーストアのステータスが含まれます。

FAQ

Q: dbaascli tde statusコマンドは何を行いますか。

A: dbaascli tde statusコマンドは、指定したデータベースのキーストアに関する情報を表示します。これには、キーストアのタイプとそのステータスに関する詳細が含まれます。

Q: dbaascli tde statusコマンドを実行するのは誰ですか。

A: このコマンドは、oracleユーザーとして実行する必要があります。

Q: dbaascli tde statusコマンドはどこで実行しますか。

A: コマンドはExadata Cloud@Customer仮想マシンで実行する必要があります。ユーティリティを実行するには、SSHを介して仮想マシンに接続する必要があります。

Q: --dbnameパラメータの機能は何ですか?

A: --dbnameパラメータは、TDEキーストア・ステータスがチェックされるデータベースの名前を指定します。

Q: dbaascli tde statusコマンドによって返される情報は何ですか。

A: コマンドの出力には、キーストアのタイプ(HSMベースやファイルベースなど)と、キーストアの現在のステータス(オープン、クローズ、その他の状態など)が含まれます。

Q: dbaascli tde statusコマンドを使用してキーストアが開いているか閉じているかを確認するにはどうすればよいですか。

A: キーストアのステータス(開いているか閉じているかなど)は、dbaascli tde statusコマンドによって返される出力の一部です。

Q: 特定のデータベースのTDEキーストアのステータスを確認するにはどうすればよいですか。

A: 特定のデータベースのTDEキーストア・ステータスを確認するには、次を実行します。

dbaascli tde status --dbname <DB_NAME>

Q: 複数のデータベースのキーストアのステータスを確認できますか。

A: はい。ただし、--dbnameパラメータを使用して名前を指定して、データベースごとにコマンドを個別に実行する必要があります。

Q: dbaascli tde statusコマンドはrootユーザーとして実行できますか。

A: いいえ、コマンドはrootユーザーではなく、oracleユーザーとして実行する必要があります。

Q: dbaascli tde statusコマンドを実行するには特別な権限が必要ですか。

A: はい。コマンドを実行するには、oracleユーザー権限を持ち、Exadata Cloud@Customer仮想マシンに接続している必要があります。

Q: dbaascli tde statusコマンドの実行時にエラーが発生した場合はどうすればよいですか。

A: oracleユーザーとしてコマンドを実行していることを確認し、必要な権限があり、正しい仮想マシンに接続されていることを確認します。

Q: データベースが使用しているキーストアのタイプを知るにはどうすればよいですか。

A: ファイルベースかHSM/KMSベースかなど、キーストアのタイプは、dbaascli tde statusコマンドの出力に表示されます。

Q: キーストアが閉じている場合はどうすればよいですか。

A: キーストアが閉じている場合は、実行しようとしている操作に応じて、キーストアを手動で開く必要がある場合があります。正確なプロセスは、キーストア・タイプおよび環境によって異なります。

Q: CDB (コンテナ・データベース)またはPDB (プラガブル・データベース)のキーストア・ステータスを表示できますか。

A: はい。--dbnameパラメータを使用して適切なデータベース名を指定すると、CDBとPDBの両方のキーストア・ステータスを表示できます。

Q: このコマンドがデータベース接続に関するエラーを返した場合、どういう意味ですか。

A: これは、データベースへの接続の問題または環境の問題を示している可能性があります。データベースが実行中でアクセス可能であることを確認し、Exadata Cloud@Customer仮想マシンへのSSH接続を確認します。

Q: データベース名が正しくない場合はどうなりますか?

A: --dbnameパラメータで正しくないデータベースまたは存在しないデータベースが指定されている場合、コマンドは失敗し、問題を示すエラー・メッセージが表示されます。

Q: キーストアのステータスが予期しない状態を示しているかどうかをトラブルシューティングするにはどうすればよいですか。

A: キーストアのステータスが予期しない状態を示している場合は、データベース・ログで詳細を確認し、キーストアの構成を確認して適切に設定されていることを確認してください。

Q: 監視目的でキーストア・ステータスのチェックを自動化できますか。

A: はい、dbaascli tde statusコマンドをスクリプト化して、キーストア・ステータスを定期的に確認するか、データベース監視ツールに統合できます。

Q: Transparent Data Encryption (TDE)が正しく有効になっていることを確認するにはどうすればよいですか。

A: dbaascli tde statusコマンドを使用してキーストアのステータスを確認することで、TDEが正しく有効になっていることを確認できます。有効なオープン・キーストアは、TDEが適切に構成されていることを示します。

例7-55 dbaascli tde status

dbaascli tde status --dbname dbname

非推奨になったdbaascliコマンド

dbaascli patch db prereqおよびdbaascli patch db applyコマンドは、dbaascliリリース21.2.1.2.0で非推奨になり、dbaascli grid patchdbaascli dbhome patchおよびdbaascli database moveコマンドに置き換えられました。

dbaascli patch db apply
ノート

dbaascli patch db prereqおよびdbaascli patch db applyコマンドは、dbaascliリリース21.2.1.2.0で非推奨になり、dbaascli grid patchdbaascli dbhome patchおよびdbaascli database moveコマンドに置き換えられました。
詳細は、次を参照してください:
  • dbaascli grid patch
  • dbaascli dbhome patch
  • dbaascli database move
  • dbaascliを使用したOracle Grid InfrastructureおよびOracle Databaseへのパッチ適用
dbaascli patch db prereq

ノート

dbaascli patch db prereqおよびdbaascli patch db applyコマンドは、dbaascliリリース21.2.1.2.0で非推奨になり、dbaascli grid patchdbaascli dbhome patchおよびdbaascli database moveコマンドに置き換えられました。
詳細は、次を参照してください:
  • dbaascli grid patch
  • dbaascli dbhome patch
  • dbaascli database move
  • dbaascliを使用したOracle Grid InfrastructureおよびOracle Databaseへのパッチ適用
dbaascli tde status

指定したデータベースのキーストアに関する情報を表示するには、dbaascli tde statusコマンドを使用します。

前提条件

oracleユーザーとしてコマンドを実行します。

構文

dbaascli tde status --dbname dbname
説明:
  • --dbnameは、確認するデータベースの名前を指定します。

このコマンドからの出力には、キーストアのタイプおよびキーストアのステータスが含まれます。

FAQ

Q: dbaascli tde statusコマンドは何を行いますか。

A: dbaascli tde statusコマンドは、指定したデータベースのキーストアに関する情報を表示します。これには、キーストアのタイプとそのステータスに関する詳細が含まれます。

Q: dbaascli tde statusコマンドを実行するのは誰ですか。

A: このコマンドは、oracleユーザーとして実行する必要があります。

Q: dbaascli tde statusコマンドはどこで実行しますか。

A: コマンドはExadata Cloud@Customer仮想マシンで実行する必要があります。ユーティリティを実行するには、SSHを介して仮想マシンに接続する必要があります。

Q: --dbnameパラメータの機能は何ですか?

A: --dbnameパラメータは、TDEキーストア・ステータスがチェックされるデータベースの名前を指定します。

Q: dbaascli tde statusコマンドによって返される情報は何ですか。

A: コマンドの出力には、キーストアのタイプ(HSMベースやファイルベースなど)と、キーストアの現在のステータス(オープン、クローズ、その他の状態など)が含まれます。

Q: dbaascli tde statusコマンドを使用してキーストアが開いているか閉じているかを確認するにはどうすればよいですか。

A: キーストアのステータス(開いているか閉じているかなど)は、dbaascli tde statusコマンドによって返される出力の一部です。

Q: 特定のデータベースのTDEキーストアのステータスを確認するにはどうすればよいですか。

A: 特定のデータベースのTDEキーストア・ステータスを確認するには、次を実行します。

dbaascli tde status --dbname <DB_NAME>

Q: 複数のデータベースのキーストアのステータスを確認できますか。

A: はい。ただし、--dbnameパラメータを使用して名前を指定して、データベースごとにコマンドを個別に実行する必要があります。

Q: dbaascli tde statusコマンドはrootユーザーとして実行できますか。

A: いいえ、コマンドはrootユーザーではなく、oracleユーザーとして実行する必要があります。

Q: dbaascli tde statusコマンドを実行するには特別な権限が必要ですか。

A: はい。コマンドを実行するには、oracleユーザー権限を持ち、Exadata Cloud@Customer仮想マシンに接続している必要があります。

Q: dbaascli tde statusコマンドの実行時にエラーが発生した場合はどうすればよいですか。

A: oracleユーザーとしてコマンドを実行していることを確認し、必要な権限があり、正しい仮想マシンに接続されていることを確認します。

Q: データベースが使用しているキーストアのタイプを知るにはどうすればよいですか。

A: ファイルベースかHSM/KMSベースかなど、キーストアのタイプは、dbaascli tde statusコマンドの出力に表示されます。

Q: キーストアが閉じている場合はどうすればよいですか。

A: キーストアが閉じている場合は、実行しようとしている操作に応じて、キーストアを手動で開く必要がある場合があります。正確なプロセスは、キーストア・タイプおよび環境によって異なります。

Q: CDB (コンテナ・データベース)またはPDB (プラガブル・データベース)のキーストア・ステータスを表示できますか。

A: はい。--dbnameパラメータを使用して適切なデータベース名を指定すると、CDBとPDBの両方のキーストア・ステータスを表示できます。

Q: このコマンドがデータベース接続に関するエラーを返した場合、どういう意味ですか。

A: これは、データベースへの接続の問題または環境の問題を示している可能性があります。データベースが実行中でアクセス可能であることを確認し、Exadata Cloud@Customer仮想マシンへのSSH接続を確認します。

Q: データベース名が正しくない場合はどうなりますか?

A: --dbnameパラメータで正しくないデータベースまたは存在しないデータベースが指定されている場合、コマンドは失敗し、問題を示すエラー・メッセージが表示されます。

Q: キーストアのステータスが予期しない状態を示しているかどうかをトラブルシューティングするにはどうすればよいですか。

A: キーストアのステータスが予期しない状態を示している場合は、データベース・ログで詳細を確認し、キーストアの構成を確認して適切に設定されていることを確認してください。

Q: 監視目的でキーストア・ステータスのチェックを自動化できますか。

A: はい、dbaascli tde statusコマンドをスクリプト化して、キーストア・ステータスを定期的に確認するか、データベース監視ツールに統合できます。

Q: Transparent Data Encryption (TDE)が正しく有効になっていることを確認するにはどうすればよいですか。

A: dbaascli tde statusコマンドを使用してキーストアのステータスを確認することで、TDEが正しく有効になっていることを確認できます。有効なオープン・キーストアは、TDEが適切に構成されていることを示します。

例7-56 dbaascli tde status

dbaascli tde status --dbname dbname