Documentation Oracle Cloud Infrastructure

Utilisation de l'utilitaire dbaascli sur Exadata Cloud Infrastructure

Découvrez comment utiliser l'utilitaire dbaascli sur Exadata Cloud Infrastructure.

Rubrique parent : Guides de référence pour Exadata Cloud Infrastructure

A propos du recours à l'utilitaire dbaascli sur Exadata Cloud Infrastructure

L'utilitaire dbaascli permet d'effectuer plusieurs opérations d'administration et de cycle de vie de base de données sur Exadata Cloud Infrastructure, telles que la modification du mot de passe d'un utilisateur de base de données, le démarrage d'une base de données, la gestion des bases de données pluggables, etc.

Vous devez utiliser l'interface de ligne de commande ou la console Oracle Cloud Infrastructure pour redimensionner les ressources. Les fonctionnalités de l'utilitaire dbaascli sont complémentaires et distinctes de l'interface de ligne de commande, de l'API ou de la console. Sauf indication contraire, vous devez disposer d'un accès root à dbaascli pour exécuter toutes les commandes d'administration.

Pour vous servir de l'utilitaire, vous devez être connecté à une machine virtuelle Exadata Cloud Infrastructure. Pour obtenir des instructions détaillées, reportez-vous à Connexion à une instance Exadata Cloud Infrastructure.

Pour obtenir les commandes possibles disponibles avec dbaascli, exécutez dbaascli --help.

Pour obtenir de l'aide relative à une commande, exécutez dbaascli commande --help. Par exemple, dbaascli database create --help.

Reportez-vous à Référence des commandes dbaascli dans le document pour découvrir les commandes et obtenir des informations spécifiques sur celles-ci.

Création de bases de données à l'aide de dbaascli

A l'aide de dbaascli, vous pouvez créer une base de données Oracle en créant d'abord un répertoire de base de base de données Oracle de la version de votre choix, puis en créant une base de données dans ce répertoire de base de base de données Oracle

Rubrique parent : Utilisation de l'utilitaire dbaascli sur Exadata Cloud Infrastructure

Liste des versions et des images logicielles disponibles pour Database et Grid Infrastructure

Afin de générer la liste des versions prises en charge disponibles pour l'application de patches, utilisez la commande dbaascli cswlib showImages.

  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli cswlib showImages --product database

    La sortie de la commande répertorie les images logicielles de base de données disponibles.

    dbaascli cswlib showImages --product grid

    La sortie de la commande répertorie les images logicielles de grille disponibles.

  4. Quittez le shell de commande d'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, reportez-vous à dbaascli cswlib showImages.

Exemple 6-1 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

Création d'un répertoire de base de base de données Oracle

Pour créer un répertoire de base de base de données Oracle de la version de votre choix, utilisez la commande dbaascli dbhome create.

Remarque

Vous pouvez créer un répertoire de base de base de données Oracle en indiquant un nom de répertoire de base Oracle. Si vous n'indiquez aucun nom, il est défini automatiquement (recommandé).
  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante : 
    dbaascli dbhome create --version Oracle Home Version --imageTag image Tag Value
    Où :
    • --version indique la version d'Oracle Database.
    • --imageTag indique la balise de l'image à utiliser.
    Par exemple :
    dbaascli dbhome create --version 19.9.0.0.0
    Remarque

    La spécification de imageTag est facultative. Pour afficher les balises d'image, reportez-vous à la commande dbaascli cswlib showImages. Les balises d'image sont généralement identiques à la version de la base de données. Toutefois, elles sont conservées comme alternative pour les cas où plusieurs images doivent être publiées pour la même version, chacune répondant à une exigence spécifique du client.
  4. Quittez le shell de commande d'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, reportez-vous à dbaascli dbhome create.

Création d'une base de données Oracle dans le répertoire de base de base de données Oracle indiqué

Pour créer une base de données Oracle dans le répertoire de base de base de données Oracle indiqué de la version de votre choix, utilisez la commande dbaascli database create.

Vous pouvez utiliser la commande dbaascli database create pour :
  • créer une base de données Conteneur ou non Conteneur,
  • créer une base de données Conteneur avec des bases de données pluggables,
  • créer une base de données Oracle avec le jeu de caractères indiqué,
  • créer des bases de données Oracle sur un sous-ensemble de noeuds de cluster.
    Remarque

    Les bases de données créées sur un sous-ensemble de noeuds ne sont pas affichées dans la console OCI.
  • créer une base de données Oracle version 12.1.0.2 ou supérieure avec la mise à jour de version JAN 2021 ou supérieure. Pour les bases de données de version inférieure, il est recommandé d'utiliser l'API reposant sur la console OCI.
  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli database create --dbName database name --oracleHome Oracle Home Path
    Où :
    • --dbName indique le nom de la base de données.
    • --oracleHome indique l'emplacement du répertoire de base Oracle.
    Pour créer une base de données Conteneur, exécutez la commande suivante :
    dbaascli database create --dbName database name --oracleHome Oracle Home Path
    Pour créer une base de données non Conteneur, exécutez la commande suivante :
    dbaascli database create --dbName database name --oracleHome Oracle Home Path --createAsCDB false

    Lorsque vous y êtes invité, saisissez les mots de passe sys et tde.

  4. Quittez le shell de commande d'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, reportez-vous à dbaascli database create.

Rubriques connexes

Rubrique parent : Création de bases de données à l'aide de dbaascli

Exécution de vérifications de prérequis avant la création d'une base de données Oracle

Pour exécuter des vérifications de prérequis, utilisez l'option de commande --executePrereqs. Elle exécute uniquement les vérifications de prérequis, sans créer la base de données Oracle.

  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli database create --dbName database name --oracleHome Oracle Home Path --executePrereqs
    Où :
    • --dbName indique le nom de la base de données.
    • --oracleHome indique l'emplacement du répertoire de base Oracle.
  4. Quittez le shell de commande d'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, reportez-vous à dbaascli database create.

Reprise ou annulation d'une opération de création de base de données Oracle

Pour reprendre ou annuler une opération de création de base de données ayant échoué, utilisez l'option de commande --resume ou --revert.

Par exemple :
dbaascli database create --dbName database name --oracleHome Oracle Home Path --resume
Remarque

  • Lors de l'utilisation de l'option de commande --resume ou --revert, veillez à utiliser la même commande à partir du même noeud que celui utilisé pour le flux réel de l'opération de création.
  • Vous ne pouvez reprendre la création d'une base de données que si l'étape à effectuer après la création de la base de données a échoué.

Modification des mots de passe de base de données

Pour modifier le mot de passe SYS ou le mot de passe du portefeuille TDE, suivez cette procédure.

Le mot de passe que vous indiquez dans le champ Mot de passe d'administrateur de base de données lorsque vous créez une base de données ou une instance Exadata Cloud Infrastructure est défini comme mot de passe pour les informations d'identification SYS, SYSTEM, de portefeuille TDE et d'administrateur de base de données pluggable. Suivez les procédures ci-dessous si vous devez modifier les mots de passe d'une base de données existante.

Remarque

Si vous activez Data Guard pour une base de données, le mot de passe SYS et le mot de passe du portefeuille TDE des bases de données principale et de secours doivent être identiques.
Remarque

L'utilisation de dbaascli pour modifier le mot de passe SYS garantit la possibilité pour l'automatisation de la sauvegarde/restauration de traiter les canaux en parallèle sur tous les noeuds du cluster.

Procédure de modification du mot de passe SYS pour une base de données Exadata Cloud Infrastructure

  1. Connectez-vous à la machine virtuelle Exadata Cloud Infrastructure en tant qu'utilisateur opc.
  2. Exécutez la commande suivante :
    sudo dbaascli database changepassword --dbname database_name --user SYS

Procédure de modification des mots de passe de base de données dans un environnement Data Guard

  1. Exécutez la commande suivante sur la base de données principale :
    dbaascli database changePassword —dbName <dbname> --user SYS --prepareStandbyBlob true --blobLocation <location to create the blob file>
  2. Copiez le fichier BLOB créé vers toutes les bases de données de secours et mettez à jour la propriété du fichier pour la définir sur l'utilisateur oracle.
  3. Exécutez la commande suivante sur toutes les bases de données de secours :
    dbaascli database changePassword —dbName <dbname> --user SYS --standbyBlobFromPrimary <location of copies the blob file>

Procédure de modification du mot de passe du portefeuille TDE pour une base de données Exadata Cloud Infrastructure

  1. Connectez-vous à la machine virtuelle Exadata Cloud Infrastructure en tant qu'utilisateur opc.
  2. Exécutez la commande suivante :
    sudo dbaascli tde changepassword --dbname database_name

Gestion des images logicielles Exadata Cloud Infrastructure à l'aide de l'utilitaire dbaascli

Vous pouvez répertorier et télécharger les images logicielles de base de données Oracle sur une instance Exadata Cloud Infrastructure. Elles peuvent ensuite être utilisées pour provisionner un répertoire de base de base de données.

Remarque

Vous pouvez créer des images logicielles de base de données personnalisées pour vos instances Exadata Cloud Infrastructure à l'aide de la console ou de l'API. Ces images sont stockées dans Object Storage et peuvent être utilisées pour provisionner un répertoire de base de base de données dans votre instance Exadata. Pour plus d'informations, reportez-vous à Images logicielles de base de données Oracle.

Vous pouvez contrôler la version des fichiers binaires Oracle installés lors du provisionnement d'une nouvelle base de données sur une instance Exadata Cloud Infrastructure en tenant à jour les images logicielles sur le système. Oracle fournit une bibliothèque d'images logicielles cloud que vous pouvez visualiser et télécharger sur votre instance à l'aide de l'utilitaire dbaascli.

Rubrique parent : Utilisation de l'utilitaire dbaascli sur Exadata Cloud Infrastructure

Liste des versions et des images logicielles disponibles pour Database et Grid Infrastructure

Afin de générer la liste des versions prises en charge disponibles pour l'application de patches, utilisez la commande dbaascli cswlib showImages.

  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli cswlib showImages --product database

    La sortie de la commande répertorie les images logicielles de base de données disponibles.

    dbaascli cswlib showImages --product grid

    La sortie de la commande répertorie les images logicielles de grille disponibles.

  4. Quittez le shell de commande d'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, reportez-vous à dbaascli cswlib showImages.

Exemple 6-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

Procédure de téléchargement d'une image logicielle

Vous pouvez télécharger les images logicielles disponibles vers votre instance Exadata Cloud Infrastructure à l'aide de la sous-commande cswlib download de l'utilitaire dbaascli.

  1. Connectez-vous à un noeud de calcul en tant qu'utilisateur opc. Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.
  2. Démarrez un shell de commande root-user :
    $ sudo -s
#
  3. Exécutez la commande dbaascli avec la sous-commande cswlib download :
    # dbaascli cswlib download [--version <software_version>] [--imageTag <image tag
    value>]
    La commande affiche l'emplacement des images logicielles téléchargées vers votre environnement Exadata Cloud Infrastructure.

    Les paramètres facultatifs sont les suivants :

    • version : indique la version du logiciel Oracle Database. Par exemple : 19.14.0.0.0.
    • imageTag : indique la balise de l'image.
  4. Quittez le shell de commande root-user :
    # exit
$

Application de patches à Oracle Grid Infrastructure et aux bases de données Oracle à l'aide de dbaascli

Découvrez comment utiliser l'utilitaire dbaascli afin d'effectuer des opérations d'application de patches pour Oracle Grid Infrastructure et les bases de données Oracle sur un système Exadata Cloud Infrastructure.

Rubrique parent : Utilisation de l'utilitaire dbaascli sur Exadata Cloud Infrastructure

Application de patches à des bases de données à l'aide de dbaascli

A l'aide de dbaascli, vous pouvez choisir d'appliquer des patches à une base de données en appliquant des patches au répertoire de base Oracle ou en déplaçant la base de données vers un répertoire de base Oracle avec le niveau de patch voulu.

  • Application de patches à un répertoire de base Oracle (application de patches avec réutilisation de la mémoire). Cette opération met à jour toutes les bases de données situées dans le répertoire de base Oracle.
  • Déplacement d'une base de données vers un autre répertoire de base Oracle disposant de la version du logiciel Oracle Database souhaitée (application de patches sans réutilisation de la mémoire).

Rubrique parent : Application de patches à Oracle Grid Infrastructure et aux bases de données Oracle à l'aide de dbaascli

Application de patches à un répertoire de base de base de données (application de patches à une base de données avec réutilisation de la mémoire)

Pour appliquer des patches à un répertoire de base Oracle, utilisez la commande dbaascli dbHome patch.

Cette opération applique des patches à toutes les bases de données exécutées dans le répertoire de base indiqué et les bases de données restent dans le répertoire de base une fois l'application de patches terminée. Les points suivants s'appliquent lors de l'utilisation de la commande dbHome patch pour les opérations d'application de patches avec réutilisation de la mémoire :
  • Vous pouvez appliquer des patches à l'ensemble des noeuds de base de données ou à un sous-ensemble de noeuds.
  • L'application de patches à plusieurs noeuds s'effectue en mode non simultané.
  • Vous pouvez éventuellement effectuer une opération de patch uniquement pour les logiciels. Ensuite, lorsque vous êtes prêt, vous pouvez exécuter datapatch pour effectuer les actions SQL à exécuter après l'application de patches.
  • Vous pouvez appliquer des patches à un répertoire de base Oracle contenant des bases de données.

Application de patches à un répertoire de base Oracle (dbhome) :

  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli dbhome patch --oracleHome dbhome_path --targetVersion Oracle_Database_version
    Où :
    • --oracleHome identifie le chemin du répertoire de base Oracle auquel appliquer les patches.
    • --targetVersion indique la version cible d'Oracle Database à utiliser pour l'application de patches, sous la forme de cinq segments numériques séparés par des points (par exemple : 19.12.0.0.0).
    Par exemple :
    dbaascli dbhome patch --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --targetVersion 19.9.0.0.0
  4. Quittez le shell de commande d'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, reportez-vous à dbaascli dbHome patch.

Déplacement d'une base de données vers un autre répertoire de base Oracle (application de patches sans réutilisation de la mémoire)

Pour appliquer des patches à une base de données Oracle en la déplaçant vers un répertoire de base Oracle qui est déjà au niveau de patch souhaité, utilisez la commande dbaascli database move.

Une fois l'opération de déplacement de base de données terminée, la base de données est exécutée en utilisant la version du logiciel Oracle Database du répertoire de base Oracle cible.

Application de patches à une base de données en la déplaçant vers un autre répertoire de base Oracle :

  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli database move --oracleHome path_to_target_oracle_home --dbname database_name
    Où :
    • --oracleHome identifie le chemin du répertoire de base Oracle cible qui utilise la version du logiciel Oracle Database voulue. Le répertoire de base Oracle cible doit exister dans votre système avant d'utiliser la commande database move.
    • --dbname indique le nom de la base de données en cours de déplacement.
    Par exemple :
    dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --dbname xyz
  4. Quittez le shell de commande d'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, reportez-vous à dbaascli database move.

Application de patches à Oracle Grid Infrastructure

Pour appliquer un patch à Oracle Grid Infrastructure, utilisez la commande grid patch.

  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli grid patch --targetVersion target_software_version_number

    Où --targetVersion identifie la version cible du logiciel pour les patches à appliquer à Oracle Grid Infrastructure.

    Par exemple :
    dbaascli grid patch --targetVersion 19.11.0.0.0
  4. Quittez le shell de commande d'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, reportez-vous à dbaascli grid patch.

Application de patches à Oracle Grid Infrastructure (GI) à l'aide d'une image logicielle GI

Pour appliquer des patches à Oracle Grid Infrastructure (GI) à l'aide d'une image logicielle GI, suivez cette procédure.

Vous pouvez également appliquer des patches à Oracle Grid Infrastructure en créant d'abord une image logicielle à laquelle les patches ont été appliqués, puis en utilisant cette image pour effectuer l'opération d'application des patches. Cette pratique vous donne l'avantage de pouvoir créer une image à l'avance en dehors de la fenêtre d'application des patches. Elle permet également de résoudre les conflits entre les patches qui sont mis en évidence lors du processus de création d'image sans incidence sur la fenêtre d'application des patches.

  1. Créez une image logicielle à laquelle les patches ont été appliqués.
    dbaascli grid patch --targetVersion <target_software_version_number> --createImage
    Une fois que la création de l'image logicielle à laquelle les patches ont été appliqués est terminée, cette image peut être utilisée pour effectuer l'opération d'application des patches.
  2. Effectuez l'opération d'application des patches.
    dbaascli grid patch --targetVersion <target_software_version_number> --imageLocation <location_of_patched_software_image>

Liste des versions et des images logicielles disponibles pour Database et Grid Infrastructure

Afin de générer la liste des versions prises en charge disponibles pour l'application de patches, utilisez la commande dbaascli cswlib showImages.

  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli cswlib showImages --product database

    La sortie de la commande répertorie les images logicielles de base de données disponibles.

    dbaascli cswlib showImages --product grid

    La sortie de la commande répertorie les images logicielles de grille disponibles.

  4. Quittez le shell de commande d'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, reportez-vous à dbaascli cswlib showImages.

Exemple 6-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

Exécution d'une prévérification avant l'application de patches à des bases de données et à Grid Infrastructure

Vous pouvez effectuer une opération de vérification de prérequis (également appelée prévérification) pour les commandes de cette rubrique en utilisant l'indicateur de prévérification applicable.

L'exécution de prévérifications vous permet d'exécuter uniquement la partie de prévérification de l'opération d'application de patches sans effectuer l'application de patches. Oracle recommande d'exécuter des prévérifications pour repérer les problèmes logiciels susceptibles d'empêcher l'application de patches.

Pour effectuer des prévérifications d'application de patches, commencez par vous connecter à une machine virtuelle dans votre instance Exadata Cloud Infrastructure en tant qu'utilisateur root.

Prévérification pour l'application de patches à un répertoire de base Oracle (application de patches avec réutilisation de la mémoire)

Utilisez l'indicateur --executePrereqs avec la commande dbaascli dbhome patch.

  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli dbhome patch --oracleHome dbhome_path --targetVersion Oracle_Database_version --executePrereqs
    Où :
    • --oracleHome identifie le chemin du répertoire de base Oracle à prévérifier.
    • --targetVersion indique la version cible d'Oracle Database à laquelle appliquer les patches, sous la forme de cinq segments numériques séparés par des points (par exemple : 19.12.0.0.0).
  4. Quittez le shell de commande d'utilisateur root :
    exit
Prévérification pour l'application de patches avec déplacement de base de données (application de patches sans réutilisation de la mémoire)

Utilisez l'indicateur --executePrereqs avec la commande dbaascli database move.

  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli database move --oracleHome path_to_target_oracle_home --dbname database_name --executePrereqs
    Où :
    • --oracleHome identifie le chemin du répertoire de base Oracle cible qui utilise la version du logiciel Oracle Database voulue. Le répertoire de base Oracle cible doit exister dans votre système avant d'utiliser la commande database move.
    • --dbname indique le nom de la base de données en cours de déplacement.
  4. Quittez le shell de commande d'utilisateur root :
    exit
Prévérification pour l'application de patches à Oracle Grid Infrastructure

Utilisez l'indicateur --executePrereqs avec la commande dbaascli grid patch.

  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli grid patch --targetVersion target_software_version_number --executePrereqs

    Où --targetVersion identifie la version logicielle cible d'Oracle Grid Infrastructure à laquelle les patches seront appliqués, sous la forme de cinq segments numériques séparés par des points, par exemple 19.12.0.0.0.

  4. Quittez le shell de commande d'utilisateur root :
    exit

Reprise ou annulation d'une opération d'application de patches

Vous pouvez reprendre ou annuler une opération d'application de patches ayant échoué. L'annulation d'un patch permet de revenir en arrière.

Rubrique parent : Application de patches à Oracle Grid Infrastructure et aux bases de données Oracle à l'aide de dbaascli

Reprise d'une opération de patch

Pour reprendre une opération d'application de patches, utilisez l'indicateur --resume avec la commande d'application de patches d'origine.

  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande d'application de patches d'origine pour reprendre une opération d'application de patches.
    Par exemple :
    dbaascli dbhome patch --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --targetVersion 19.9.0.0.0 --resume
  4. Quittez le shell de commande d'utilisateur root :
    exit
Annulation d'une opération d'application de patches

Utilisez l'indicateur --rollback avec la commande d'application de patches d'origine pour annuler une opération d'application de patches.

  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Exécutez la commande d'application de patches d'origine pour annuler une opération d'application de patches.
    Par exemple :
    dbaascli grid patch --targetVersion 19.11.0.0.0 --rollback
    Remarque

    • Les opérations de reprise et d'annulation sont prises en charge pour les opérations d'application de patches à un répertoire de base Oracle, d'application de patches à Oracle Grid Infrastructure et de déplacement de base de données.
    • Lors de la reprise ou de l'annulation d'une opération d'application de patches, vous devez exécuter la commande de reprise ou d'annulation à partir du même noeud que celui utilisé pour exécuter la commande d'application de patches d'origine, et exécuter la commande d'origine en ajoutant l'indicateur --resume ou --rollback.
  4. Quittez le shell de commande d'utilisateur root :
    exit

Collecte des journaux d'outils cloud et exécution d'une vérification de l'état des outils cloud à l'aide de dbaascli

La commande dbaascli diag vous permet de collecter les journaux d'outils dbaas de machine virtuelle invitée pour les systèmes Exadata Database Service on Dedicated Infrastructure et Exadata Database Service on Cloud@Customer. Vous pouvez vous servir de ces journaux pour résoudre les problèmes liés aux outils dbaas.

Vous pouvez utiliser la commande diag pour collecter les journaux de dbaastools et effectuer une vérification de l'état de tous les noeuds d'un cluster Exadata. Les options --waitForCompletion sont prises en charge à partir de la version 22.4.1.
Remarque

  • Les commandes dbaascli diag doivent être exécutées en tant qu'utilisateur root
  • L'exécution de la commande dbaascli diag collect sur un seul noeud entraîne la collecte des données de journal pour tous les noeuds.
  • Il est recommandé d'exécuter les commandes décrites dans cette rubrique avec l'option --waitForCompletion pour les commandes à longue durée d'exécution. Reportez-vous aux exemples d'utilisation.

Pour plus d'informations sur la mise à jour des outils Exadata Cloud, reportez-vous à dbaascli admin updateStack.

Rubriques connexes

Rubrique parent : Utilisation de l'utilitaire dbaascli sur Exadata Cloud Infrastructure

Exemples de collecte des données des journaux d'outils

La commande dbaascli diag collect utilise la syntaxe ci-dessous pour collecter les données des journaux d'outils.

Pour plus d'informations sur la syntaxe, reportez-vous à dbaascli diag collect dans Référence des commandes dbaascli. 

# dbaascli diag collect
DBAAS CLI version 24.1.1.0.0
Executing command diag collect
Job id: 92f33125-aa70-4ce2-94fb-64d8f1cbdc93
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_07-20-44-PM_83383.log
Loading PILOT...
Session ID of the current execution is: 10
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_07-20-48-PM_83856
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-1920/diag_cloudlogs_20231214-1920_node1.zip=a0d049b87ab9e9cec2ab7d95ded4903bac818c81c8b6a46d295e1e75f4630e19}"
}
dbaascli execution completed
# dbaascli diag collect --waitForCompletion false
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --waitForCompletion false
Job id: 5b556976-dba1-4be9-a4fe-4b58e69c1d96
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_07-23-26-PM_98107.log
Job accepted. Use "dbaascli job getStatus --jobID 5b556976-dba1-4be9-a4fe-4b58e69c1d96" to check the job status.
Remarque

Utilisez la commande de statut de travail pour surveiller la progression. 
# dbaascli diag collect --dbnames myOracleDatabase19cName
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --dbnames myOracleDatabase19cName
Job id: 8e1d2667-4649-4384-8610-b6348d6548ac
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_08-41-41-PM_88831.log
Loading PILOT...
Session ID of the current execution is: 12
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_08-41-45-PM_89361
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2041/diag_cloudlogs_20231214-2041_node1.zip=9e50500089a74ca7cd8ae08550c06868e26e1cd9c52e808194256594f63397e4}"
}
dbaascli execution completed
# dbaascli diag collect --destLocation /tmp/test/
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --destLocation /tmp/test/
Job id: f992afdf-415e-4b58-ab5b-9e38f8c2079d
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-42-54-PM_16270.log
Loading PILOT...
Session ID of the current execution is: 14
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-42-58-PM_16777
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/tmp/test/diag_collect/artifacts_diag_cloudlogs_20231214-2143/diag_cloudlogs_20231214-2143_node1.zip=8a26cffcfdd72c261660d4f736c615981856e357749d90751b94f3eda19a9a70}"
}
dbaascli execution completed
# dbaascli diag collect --startTime 2023-12-05T10:00:00 --endTime 2023-12-05T11:00:00
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --startTime 2023-12-05T10:00:00 --endTime 2023-12-05T11:00:00
Job id: 70b03e50-98cc-4c2b-9684-1f82070bac88
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-45-17-PM_42856.log
Loading PILOT...
Session ID of the current execution is: 15
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-45-21-PM_43526
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2145/diag_cloudlogs_20231214-2145_node1.zip=b44cf3bfca1ab7a1629dd83098a7772790ab949e50dbb3950f0017e427d7bd05}"
}
dbaascli execution completed
# dbaascli diag collect --nodes node1,node2
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --nodes node1,node2
Job id: fa70da09-3de6-4cc8-854c-a739b4fc2ceb
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-46-58-PM_55884.log
Loading PILOT...
Session ID of the current execution is: 16
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-47-02-PM_56418
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2147/diag_cloudlogs_20231214-2147_node1.zip=de2805c9c6c2af2d602395a84d37747935327b73a6c73052282665a8410eb41f}"
}
# dbaascli diag collect --components dbaastools
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --components dbaastools
Job id: da941d3c-5191-4ced-b1bb-9b083fa75865
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-47-23-PM_68256.log
Loading PILOT...
Session ID of the current execution is: 17
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-47-27-PM_68729
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2147/diag_cloudlogs_20231214-2147_node1.zip=d1f290fb42c981935e1142ec059c2dbba8be2e0a9ffebc9eea83a6336abe2eed}"
}
dbaascli execution completed
# dbaascli diag collect --objectStoreBucketUri https://objectstorage.us-phoenix-1.oraclecloud.com/p/aL-IbIKQ1j6lWNftJc2rLoLh6o9bJgbZm8z0S--BeVuXaipSEEMISrSCfFrVEolG/n/intexadatateam/b/diag_collect_test/o/
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --objectStoreBucketUri https://objectstorage.us-phoenix-1.oraclecloud.com/p/aL-IbIKQ1j6lWNftJc2rLoLh6o9bJgbZm8z0S--BeVuXaipSEEMISrSCfFrVEolG/n/intexadatateam/b/diag_collect_test/o/
Job id: 028151b7-cbc4-409a-9ec6-69affe10f3bb
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-51-36-PM_2963.log
Loading PILOT...
Session ID of the current execution is: 20
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-51-40-PM_3555
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2151/diag_cloudlogs_20231214-2151_node1.zip=71633e13ccd06de15cb26850bb0266cf0d869e259550515c5b1fb734c487b470}"
}
dbaascli execution completed

Exemples d'exécution de la vérification de l'état

Utilisez la commande dbaascli diag healthcheck pour effectuer une vérification de l'état de tous les noeuds système.

Reportez-vous à dbaascli diag healthcheck dans la référence des commandes dbaascli pour plus d'informations sur la syntaxe. 

# dbaascli diag healthcheck                
DBAAS CLI version MAIN
Executing command diag healthcheck
INFO: Starting diag healthcheck
INFO: Collected diag logs at: /var/opt/oracle/dbaas_acfs/diag_cloudlogs_20210322-2246.tar.gz
# dbaascli diag healthcheck --destLocation /tmp/test
DBAAS CLI version MAIN
Executing command diag healthcheck --destLocation /tmp/test
INFO: Starting diag healthcheck
INFO: Collected diag logs at: /tmp/test/diag_cloudlogs_20210322-2250.tar.gz
# dbaascli diag healthcheck --nodes rbcl1,rbcl2                   
DBAAS CLI version MAIN
Executing command diag healthcheck --nodes rbcl1,rbcl2
INFO: Starting diag healthcheck
INFO: Collected diag logs at: /var/opt/oracle/dbaas_acfs/diag_cloudlogs_20210421-1915.tar.gz
# dbaascli diag healthcheck --objectStoreBucketUri https://objectstorage.us-phoenix-1.oraclecloud.com/p/t0Z-kRV5pSmFzqnf-y5XhaAbM4LS82epeBnulKnCr31IeHVjxI9tOkntLF2kq7fP/n/MyNamespace/b/MyParBucket/o/
DBAAS CLI version MAIN
Executing command diag healthcheck --objectStoreBucketUri https://objectstorage.us-phoenix-1.oraclecloud.com/p/t0Z-kRV5pSmFzqnf-y5XhaAbM4LS82epeBnulKnCr31IeHVjxI9tOkntLF2kq7fP/n/MyNamespace/b/MyParBucket/o/
INFO: Collected diag logs at: https://objectstorage.us-phoenix-1.oraclecloud.com/p/t0Z-kRV5pSmFzqnf-y5XhaAbM4LS82epeBnulKnCr31IeHVjxI9tOkntLF2kq7fP/n/MyNamespace/b/MyParBucket/o/diag_cloudlogs_20210421-1839.tar.gz

Mise à jour des outils cloud à l'aide de dbaascli

Afin de mettre à jour la version des outils cloud pour Oracle Exadata Database Service on Dedicated Infrastructure, suivez cette procédure.

Les outils propres au cloud sont utilisés sur les machines virtuelles invitées Exadata Cloud Infrastructure pour les opérations locales, y compris les commandes dbaascli.

Les outils cloud sont automatiquement mis à jour par Oracle lorsque de nouvelles versions sont disponibles. Si nécessaire, vous pouvez suivre les étapes ci-dessous pour vous assurer que vous disposez de la dernière version des outils propres au cloud sur toutes les machines virtuelles du cluster de machines virtuelles.
Remarque

Pour mettre à jour les outils propres au cloud, vous pouvez télécharger et appliquer un package logiciel contenant les outils mis à jour.
  1. Connectez-vous à une machine virtuelle en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande d'utilisateur root :
    sudo -s
  3. Pour effectuer une mise à jour vers la dernière version disponible des outils cloud, exécutez la commande suivante : 
    dbaascli admin updateStack

    La commande se charge de mettre à jour la version des outils cloud sur tous les noeuds du cluster.

    Pour connaître les autres options disponibles et obtenir plus de détails, reportez-vous à dbaascli admin updateStack --help.

Créer une base de données dupliquée

Utilisation de dbaascli pour dupliquer une base de données cloud

Vous pouvez créer une base de données dupliquée à l'aide de dbaascli. Cette nouvelle base de données peut se trouver dans la même région cloud que la région source ou entre les régions. Les étapes suivantes expliquent comment créer une base de données dupliquée sur le cloud.

Remarque

Si une base de données est configurée avec OCI Vault pour le cryptage TDE et que vous voulez dupliquer une base de données, reportez-vous aux sections suivantes.

Préparer la duplication

Assurez-vous que les conditions suivantes sont remplies :

  • Assurez-vous qu'un chemin réseau est configuré pour accéder à la base de données source via la chaîne EZConnect.
  • Copiez le fichier de portefeuille TDE (ewallet.p12) vers le noeud de base de données cible. Noeud sur lequel vous décidez d'exécuter la commande dbaascli.
  • Si nécessaire, créez un répertoire de base Oracle sur le noeud cible. La version du répertoire de base Oracle doit être identique à la version source ou supérieure de la RU.

Exécuter les vérifications de prérequis

Pour exécuter des vérifications de prérequis, utilisez l'option de commande --executePrereqs. Cette opération n'effectue que les vérifications de prérequis sans effectuer la duplication réelle d'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

Dupliquer la base de données

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

Remarques concernant l'utilisation d'OCI Vault pour la gestion des clés

Cette section n'est applicable que si la base de données est configurée avec OCI Vault pour le cryptage TDE et que vous souhaitez dupliquer une base de données.

Dupliquer une base de données dans la même région

  • Autres étapes préalables

    Veillez à configurer des stratégies d'accès OCI Vault pour les noeuds de base de données cible. Les noeuds de base de données cible doivent pouvoir accéder à la fois au coffre de clés OCI de la base de données source et à son nouveau coffre de clés (s'il est décidé d'utiliser un coffre de clés distinct).

  • Exécuter les vérifications de prérequis
    dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID> --executePrereqs
  • Dupliquer la base de données
    dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID>

    Une fois cette commande exécutée, la base de données est dupliquée.

Duplication d'une base de données entre les régions

  • Autres étapes préalables
  • Exécuter les vérifications de prérequis
    dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID> --executePrereqs
  • Dupliquer la base de données
    dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID>

    Une fois cette commande exécutée, la base de données est dupliquée.

Dupliquer une base de données sur site

A l'aide de dbaascli, vous pouvez dupliquer une base de données sur site sur le cloud. Pour ce faire, utilisez la commande dbaascli database duplicate. Cette commande crée une base de données sur le cloud, qui est un doublon d'une base de données sur site avec ses données. Pendant ce processus, la base de données sur site reste opérationnelle. Vous pouvez migrer vos applications vers la base de données dupliquée sur le cloud après vérification.

Préparer la duplication

Le processus de migration comprend les prérequis suivants à remplir.
  • Assurez-vous qu'un chemin réseau est configuré pour accéder à une base de données sur site à partir du noeud OCI via la chaîne EZConnect.
  • Si une base de données sur site est configurée avec TDE, copiez le fichier de portefeuille TDE (ewallet.p12) sur le noeud OCI, où vous décidez d'exécuter la commande dbaascli.
  • Si nécessaire, créez un répertoire de base Oracle sur le noeud OCI. La version du répertoire de base Oracle doit être identique à celle de la source ou d'une version de RU supérieure.

Vérifier les RPM nécessaires

Ce processus nécessite une version minimale de dbaastools RPM de 23.3.2.0.0, mais la mise à jour vers la dernière version de dbaastools RPM est toujours recommandée.

  • Pour vérifier la version actuellement installée, exécutez la commande suivante :
    dbaascli --version
DBAAS CLI version 23.3.2.0.0
  • Pour appliquer le dernier RPM d'outils, en tant qu'utilisateur root, exécutez la commande suivante :
    # dbaascli admin updateStack

Exécuter les vérifications de prérequis

Pour exécuter les vérifications de prérequis, utilisez l'option de commande --executePrereqs. Cette opération n'effectue que les vérifications de prérequis sans effectuer la duplication réelle d'Oracle Database.

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

Dupliquer la base de données

Dupliquez la base de données à l'aide de la commande suivante :

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

Par exemple :

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

Une fois cette commande exécutée avec succès, la base de données est dupliquée dans le cloud et prête pour les vérifications de validité de l'utilisation de l'application. Une fois la vérification effectuée, les connexions d'application peuvent être migrées vers la base de données Cloud.

Reportez-vous à dbaascli database duplicate –help pour plus d'options de configuration.

Quelques points à prendre en compte pour la migration

  • Si vous préférez allouer plusieurs canaux pour la duplication RMAN, vous pouvez le faire en indiquant l'argument --rmanParallelism.
  • Exadata Cloud Service configure la mémoire de base de données en tant qu'ASMM (Automatic Shared Memory Management). Si votre base de données sur site est configurée avec une gestion de mémoire différente, veillez à ajuster les valeurs de paramètre de mémoire en conséquence côté OCI en fournissant des valeurs pour --sgaSizeInMB et --pgaSizeInMB.
  • Vérifiez que la base de données sur site ne contient aucun paramètre d'initialisation en phase d'abandon ou non valide.
  • Les paramètres d'initialisation de la base de données liés au stockage de la base de données (emplacement des fichiers de données, emplacement des informations de journalisation, destination de la zone de récupération, multiplexage des fichiers de contrôle) peuvent être modifiés à l'aide de l'argument --initParams.

    Par exemple, pour remplacer la valeur db_create_online_log_dest de la base de données dupliquée : --initParams db_create_online_log_dest_1=+DATAC1,db_create_online_log_dest_2=+RECOC1

Résoudre les problèmes de duplication de base de données

  • Le fichier journal des opérations dbaascli se trouve sous /var/opt/oracle/log/<dbname>/database/duplicate
  • L'un des travaux du doublon consiste à exécuter dbca. Son fichier journal se trouve sous /u02/app/oracle/cfgtoollogs/dbca et /u02/app/oracle/cfgtoollogs/dbca/<dbuniquename>.

En cas d'échec de l'opération, vous pouvez la reprendre en fournissant l'argument --resume à la même commande. Vous pouvez également nettoyer la base de données à l'aide de dbaascli database delete –dbname <dbname> –force, puis réexécuter la commande de duplication de base de données.

Notes sur la version

Passez en revue les modifications apportées dans les différentes versions de dbaascli.

Rubrique parent : Utilisation de l'utilitaire dbaascli sur Exadata Cloud Infrastructure

Version 26.2.1.0.0 (260408)

Cette version comprend :

  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 26.1.1.0.0 (260209)

  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 25.4.1.0.0 (251107)

  • Multicloud : AWS — Prise en charge de la création de bases de données inter-région à partir de sauvegardes d'irestore dans Amazon S3 (Simple Storage Service).
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 25.3.1.0.0 (250826)

  • Comprend AHF 25.6.2
  • Inclut syslens 25.2.3.0
  • Inclut exacs-configs-release-master_25-3-1
  • La commande dbaascli dbhome patch inclut désormais l'option skipDBForDatapatch.

    Objectif : permet d'indiquer la liste des bases de données sur lesquelles l'étape de patch de données sera ignorée lors de l'application de patches au répertoire de base de base de données sur place.

  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 25.2.1.0.0 (250522)

  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 25.1.2.0.0 (250325)

  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 25.1.1.0.0 (250107)

  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 24.4.1.0.0 (241104)

  • Amélioration de dbaascli database getDetails pour inclure les détails tde encryption. La commande dbaascli tde status est désormais abandonnée.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 24.3.2.0 (240828)

  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 24.3.1.0.0 (240711)

  • Migration TDE de sqlnet.ora vers wallet_root lors de la mise à niveau de la base de données vers la version 19c
  • Application de patches à l'emplacement de grille pour utiliser l'application de patches basée sur une image comme mode par défaut
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 24.2.2.1.0.0 (240530)

  • Ajout de la prise en charge d'Oracle AI Database 26ai.
  • Améliorations de la zone de sauvegarde et de récupération avec Zero Data Loss Autonomous Recovery Service (ZRCV) comme destination de sauvegarde.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 24.1.2.0.0 (240306)

  • Présentation d'un nouveau workflow optimisé pour les opérations Data Guard
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 24.1.1.0.0 (231219)

  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 23.4.1.0.0 (231102)

  • Sauvegarde et récupération : la fenêtre de récupération de sauvegarde minimale a été remplacée par 7 jours. L'automatisation des éléments de sauvegarde considère que la fenêtre de récupération est de 7 jours si elle détecte une valeur inférieure à 7 dans le système.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 23.3.2.0.0 (230921)

  • Opérations de base de données pluggable
    • Ajout de la prise en charge de la définition de l'OCID de version de clé personnalisée (Utilisation de votre propre clé - BYOK) d'OCI Vault lors des opérations de création et de clonage. Pour obtenir des détails, reportez-vous à l'aide des commandes de base de données pluggable respectives.
  • Application de patches à Grid Infrastructure (GI)
    • Amélioration du workflow d'application de patches pour améliorer le temps d'application de patches, en particulier dans les environnements où le nombre de bases de données est élevé.
    • Une nouvelle option --patchInParallel est introduite et peut être utilisée pour appliquer des patches aux noeuds distants en parallèle.
  • Patch de base de données
    • Option fournie pour exécuter datapatch sur un noeud spécifique du cluster.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 23.3.1.0.0 (230712)

  • Nouvelles commandes dbaascli
    • dbaascli gridHome create : cette commande peut être utilisée pour créer un répertoire de base Grid Infrastructure d'une version prise en charge. Pour obtenir des détails, reportez-vous à dbaascli gridHome create --help.
    • dbaascli system getGridHomes : cette commande fournit des détails sur les répertoires de base Grid Infrastructure disponibles sur le système. Pour plus de détails, reportez-vous à dbaascli system getGridHomes --help.
    • dbaascli admin updateAHF : cette commande peut être utilisée pour mettre à jour AHF vers une version cloud certifiée spécifiée de la version AHF. Il est toutefois recommandé de gérer implicitement les mises à jour AHF par l'automatisation du cloud. Pour plus de détails, reportez-vous à dbaascli admin updateAHF --help.
  • Opérations de base de données pluggable
    • Améliorations dans le domaine du cycle de vie des bases de données pluggagble actualisables.
  • Sauvegarde et récupération de base de données
    • Ajout de la prise en charge de la configuration des sauvegardes sur les sites de secours en cas de configuration Data Guard. La configuration des sauvegardes est propre à un site Data Guard, c'est-à-dire que la modification des rôles (par exemple, avec l'opération de permutation Data Guard) n'a aucune incidence sur les opérations de sauvegarde de la base de données sur les sites principal ou de secours. Les sauvegardes, si elles sont configurées sur le site principal ou le site de secours, continueront indépendamment du changement de rôle.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 23.2.1.0.0 (230503)

  • Améliorations liées au cycle de vie de base de données
    • Introduction de dbaascli grid removeTCPSCert pour supprimer les certificats TCPS expirés. Pour plus de détails, reportez-vous à dbaascli grid removeTCPSCert --help.
    • Option ajoutée pour exclure des bases de données pluggables spécifiques lors de la duplication de la base de données. Pour plus de détails, reportez-vous à l'argument skipPDBs dans dbaascli database duplicate --help.
  • Sauvegarde et récupération de base de données
    • La valeur par défaut de FILES_PER_SET a été remplacée par 64 pour les sauvegardes OSS. Vous pouvez modifier cette valeur avec dbaascli database backup --configure. Pour plus de détails, reportez-vous à dbaascli database backup --help.
    • Les sauvegardes de journal d'archivage continuent à partir du site de secours après la permutation de rôle dans les environnements Data Guard.
    • Pour les sauvegardes qui ne sont pas gérées par Oracle, les programmations des sauvegardes L0 et L1 ne sont pas créées par défaut. Ils doivent être créés explicitement à l'aide de la commande dbaascli database backup --configure.
  • sysLens

    Un cadre qui collecte, analyse et génère des rapports sur les données de ressources système pour les flottes ExaDB-D est inclus dans la version 23.2.1.0.0 (235503). Pour plus d'informations, reportez-vous à Gérer sysLens.

  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 23.1.2.0.0 (230305)

  • Améliorations liées au cycle de vie de base de données
    • Option ajoutée pour créer des modèles de base de données (modèles DBCA) dans la banque d'objets. Les modèles DBCA peuvent ensuite être utilisés pour créer des bases de données. Pour plus de détails, reportez-vous à dbaascli database createTemplate --help.
  • Opérations de base de données pluggable
    • Introduction de la commande dbaascli pdb refresh pour actualiser une base de données pluggable créée à l'aide de l'option d'actualisation manuelle. Pour plus de détails, reportez-vous à dbaascli pdb refresh --help.
    • Option ajoutée pour convertir une base de données pluggable actualisable en base de données pluggable standard. Pour plus de détails, reportez-vous à dbaascli pdb open --help.
    • La création d'une base de données pluggable actualisable requiert désormais un utilisateur de base de données source existant pour la création d'un lien de base de données vers la base de données pluggable source. Pour plus de détails, reportez-vous à l'argument dblinkUserName dans dbaascli pdb remoteClone --help.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 23.1.1.0.1 (230113)

  • Améliorations liées au cycle de vie de base de données
    • Ajout de la prise en charge de la création d'une base de données dupliquée à partir d'une base de données source qui utilise les services OCI Vault pour la gestion des clés de cryptage.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 22.4.1.0.1 (221122)

  • Opérations de base de données pluggable
    • Ajout d'une option permettant de ne pas ouvrir la base de données pluggable à la fin de l'opération relocate. Pour plus d'informations, reportez-vous à l'argument skipOpenPDB dans dbaascli pdb relocate --help. Après avoir utilisé cette option, l'opération pdb relocate peut être effectuée en exécutant la commande à l'aide de l'argument completePDBRelocate.
    • Ajout d'une option permettant de nettoyer les services/métadonnées de la base de données pluggable transférée à l'emplacement source. Pour plus d'informations, reportez-vous à l'argument cleanupRelocatedPDB dans dbaascli pdb delete --help.
  • Nouvelles commandes dbaascli
    • dbaascli database createTemplate : cette commande peut être utilisée pour créer des modèles de base de données (modèles DBCA), qui peuvent ensuite être employés afin de créer des bases de données. Les modèles DBCA sont couramment utilisés pour créer une base de données clone avec DBCA, un outil fourni avec le logiciel de serveur de base de données Oracle. Pour plus de détails, reportez-vous à dbaascli database createTemplate --help
    • Introduction de dbaascli tde rotateMasterKey, qui permet d'effectuer la rotation de la clé maître pour le cryptage de base de données. Pour plus de détails, reportez-vous à dbaascli tde rotateMasterKey --help. La commande dbaascli tde rotate masterkey est désormais en phase d'abandon.
  • Améliorations liées au cycle de vie de base de données
    • Ajout de la prise en charge de l'utilisation des modèles DBCA dans les workflows de création de base de données. Pour plus d'informations, reportez-vous à l'argument dbcaTemplateFilePath dans dbaascli database create --help.
    • Amélioration des performances pour la création de bases de données dupliquées. Pour plus d'informations sur la création d'une base de données dupliquée, reportez-vous à dbaascli database duplicate --help.
    • Ajout de la prise en charge de la création d'une base de données dupliquée à partir d'une base de données source qui n'est pas cryptée par TDE.
  • Gestion du TDE
    • Introduction de dbaascli tde rotateMasterKey, qui permet d'effectuer la rotation de la clé maître pour le cryptage de base de données. Pour plus de détails, reportez-vous à dbaascli tde rotateMasterKey --help. La commande dbaascli tde rotate masterkey est désormais en phase d'abandon.
    • Workflow repensé pour toutes les opérations TDE. Pour plus de détails, reportez-vous à dbaascli tde --help
  • Application de patches à Grid Infrastructure (GI)
    • Ajout de la prise en charge permettant l'exécution parallèle de l'opération d'application de patches sur les noeuds. Cette option doit être soigneusement employée car elle entraîne une réduction de la disponibilité de la base de données.
  • Sauvegarde et récupération de base de données
    • Workflow repensé pour la création d'une base de données à partir d'une sauvegarde autonome.
  • AHF version 22.2.4 inclus
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 22.3.1.1.0 (221003)

  • Nouvelles commandes dbaascli
    • dbaascli database getDetails : cette commande affiche les informations détaillées d'une base de données spécifique, comme son nom, les informations de noeud, les informations de base de données pluggable, etc. Pour plus de détails, reportez-vous à dbaascli database getDetails --help.
  • Opérations de base de données pluggable
    • Ajout de la prise en charge de la création de bases de données pluggables en tant que clones actualisables à l'aide de l'argument refreshablePDB. Pour plus de détails, reportez-vous à dbaascli pdb remoteClone --help.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 22.3.1.0.1 (220721)

  • Nouvelles commandes de cycle de vie de base de données
    • dbaascli database addInstance : cette commande peut être utilisée pour ajouter une instance de base de données à l'un des noeuds du cluster où la base de données n'est pas encore configurée. Pour plus de détails, reportez-vous à dbaascli database addInstance --help.
    • dbaascli database deleteInstance : cette commande peut être utilisée pour supprimer une instance de base de données de l'un des noeuds du cluster où la base de données est configurée. Pour plus de détails, reportez-vous à dbaascli database deleteInstance --help.
    • dbaascli database duplicate : cette commande peut être utilisée pour créer une base de données à partir d'une base de données existante au sein d'un cluster, ou entre deux clusters à condition qu'il existe une connexion réseau entre ces clusters. Pour plus de détails, reportez-vous à dbaascli database duplicate --help.
  • Bibliothèque de logiciels cloud
    • Introduction de la commande dbaascli cswlib listLocal pour répertorier les images téléchargées à partir de la bibliothèque de logiciels en local sur le système. Pour plus de détails, reportez-vous à dbaascli cswlib listLocal --help. La commande dbaascli dbimage list est désormais en phase d'abandon.
    • Introduction de la commande dbaascli cswlib deleteLocal pour supprimer les images téléchargées à partir de la bibliothèque de logiciels cloud. Pour plus de détails, reportez-vous à dbaascli cswlib deleteLocal --help. La commande dbaascli dbImage purge est désormais en phase d'abandon.
  • Modification de l'emplacement de journal pour la commande dbaascli admin updateStack afin de respecter la convention des autres commandes dbaascli. Pour plus de simplicité, les journaux se trouvent dans le répertoire /var/opt/oracle/log/admin/updateStack. L'emplacement précédent était /var/opt/oracle/log/tooling/Update.
  • Reconnaissance de la plate-forme cloud par l'aide dbaascli : elle répertorie les sorties d'aide pour les commandes applicables à l'environnement cloud sur lequel elle est exécutée.
  • Ajout de la prise en charge de la modification du mot de passe TDE dans les environnements Data Guard. Pour plus de détails, reportez-vous à dbaascli tde changePassword --help. Cette prise en charge n'est actuellement pas disponible pour la version 11.2.0.4.
  • AHF version 22.1.5 inclus.
  • Workflow repensé pour l'opération de mise à niveau de base de données.
  • Workflow repensé pour l'opération de création de répertoire de base de base de données.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 22.2.1.1.0 (220623)

  • AHF version 22.1.1 inclus.
  • Correction du problème où la mise à jour du RPM dbaastools sur le système pouvait entraîner un temps d'inactivité de la base de données avec l'erreur ORA-600.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 22.2.1.1.0 (220609)

  • Nouvelles commandes dbaascli :
    • dbaascli dbHome getDatabases : cette commande répertorie toutes les bases de données exécutées à partir d'un répertoire de base Oracle de base de données particulier. La sortie est renvoyée au format JSON pour faciliter l'automatisation. Pour plus de détails, reportez-vous à dbaascli dbHome getDatabases --help.
    • dbaascli database getPDBs : cette commande répertorie toutes les bases de données pluggables d'une base de données Conteneur particulière. La sortie est renvoyée au format JSON pour faciliter l'automatisation. Pour plus de détails, reportez-vous à dbaascli database getPDBs --help.
    • dbaascli dbHome delete : cette commande supprime un répertoire de base de base de données Oracle particulier. Pour plus de détails, reportez-vous à dbaascli dbHome delete --help.
    • dbaascli dataguard prepareStandbyBlob : cette commande génère un fichier BLOB contenant divers fichiers requis sur le site de secours pour un environnement Data Guard. Pour plus de détails, reportez-vous à dbaascli dataguard prepareStandbyBlob --help.
  • Application de patches à Grid Infrastructure (GI) :
    • Nouveau workflow optimisé.
    • Introduction d'un moyen de créer l'image logicielle Grid Infrastructure (GI) avant l'application des patches. Cette image GI peut ensuite être utilisée pour effectuer l'opération d'application des patches à GI. L'avantage de cette approche est qu'elle se traduit par une fenêtre d'application des patches réduite car l'image est déjà préparée. La pile GI sur le noeud n'est pas arrêtée pour créer l'image. Pour plus de détails, reportez-vous à l'option createImage dans dbaascli grid patch --help.
    • Introduction d'un moyen d'appliquer des patches à Grid Infrastructure via le recours à une image logicielle GI spécifiée par l'utilisateur, créée à l'aide de l'option createImage de la commande dbaascli grid patch. Pour plus de détails, reportez-vous à l'option imageLocation dans dbaascli grid patch --help.
  • Prise en charge de la modification du mot de passe dans un environnement Data Guard :
    • Ajout de la prise en charge de la modification du mot de passe dans les environnements Data Guard. Pour plus de détails, reportez-vous à dbaascli database changePassword --help et à dbaascli dataguard prepareStandbyBlob --help.
  • Configuration Data Guard :
    • Ajout de la prise en charge de la mise à jour des attributs d'automatisation Data Guard (dans le fichier /var/opt/oracle/dg/dg.conf). Pour plus de détails, reportez-vous à dbaascli dataguard --help.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 22.2.1.0.1 (220423)

  • Nouvelles commandes dbaascli
    • Introduction de dbaascli admin showLatestStackVersion pour afficher la dernière version de dbaastools que les clients peuvent télécharger et installer. L'installation du RPM dbaastools peut être effectuée à l'aide de la commande dbaascli admin updateStack. Pour plus de détails, reportez-vous à Référence des commandes dbaascli.
  • Bibliothèque de logiciels cloud
    • Abandon en cours de la prise en charge de l'activation de groupe de patches (dbaascli cswlib activateBP) car les groupes de patches sont désormais remplacés par les RU (mises à jour de version). Le déploiement cloud utilise des mises à jour de version sous forme d'images logicielles, identifiées par des balises d'image. Il est donc recommandé d'utiliser des balises d'image lors de la communication avec les commandes de la bibliothèque de logiciels cloud (cswlib). Pour plus de détails, reportez-vous à dbaasscli cswlib download –help.
    • Suppression de la nécessité de télécharger des images de base de données non Conteneur pour créer des bases de données non Conteneur. Désormais, les utilisateurs peuvent créer la base de données non Conteneur à l'aide d'images standard. Pour plus de détails, reportez-vous à l'option createAsCDB dans dbaascli database create –help.
  • Création d'une base de données non Conteneur
    • Amélioration du workflow de création de base de données pour créer une base de données non Conteneur à l'aide d'une image logicielle de base de données standard. Pour plus de détails, reportez-vous à l'option createAsCDB dans dbaascli database create –help.
  • Application de patches au répertoire de base de base de données
    • Nouveau workflow optimisé.
  • Mise à niveau de Grid Infrastructure
    • Nouveau workflow optimisé.
  • Opérations de base de données pluggable
    • La suppression d'une base de données pluggable dans les environnements Data Guard nécessite une confirmation explicite pour indiquer que les opérations nécessaires sur le site de secours sont terminées, en transmettant l'argument supplémentaire –allStandByPrepared. Pour plus de détails, reportez-vous à dbaascli pdb delete --help.
  • Mode non simultané disponible pour l'opération de redémarrage de base de données. Pour plus de détails, reportez-vous à dbaascli database bounce –help.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 22.1.1.2.0 (220405)

  • Ajout de la prise en charge d'ExaDB-D X9M.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 22.1.1.1.0 (220317)

  • Nouvelles commandes dbaascli :
    • Introduction de dbaascli system getDBHomes pour obtenir tous les répertoires de base de base de données Oracle sur le cluster. La sortie est renvoyée au format JSON pour faciliter l'automatisation.
    • Introduction de dbaascli dbhome getDetails pour obtenir des informations détaillées sur un répertoire de base Oracle spécifique. La sortie est renvoyée au format JSON pour faciliter l'automatisation.
  • Bibliothèque de logiciels cloud (cswlib) :
    • Abandon en cours de la prise en charge de la commande dbaascli cswlib list pour les opérations de liste de la bibliothèque de logiciels cloud. La nouvelle commande est dbaascli cswlib showImages, qui répertorie les images avec leur balise d'image (ImageTag). Il est recommandé d'utiliser des balises d'image pour télécharger les images à partir de la bibliothèque de logiciels cloud. Pour plus de détails sur les téléchargements à l'aide de balises d'image, reportez-vous à dbaascli cswlib download –help.
    • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 22.1.1.0.1 (220223)

  • Mise à niveau de Grid Infrastructure
    • Nouveau workflow optimisé.
  • Sauvegarde et récupération de base de données
    • Mise à jour interne du référentiel de métadonnées pour les métadonnées de sauvegarde.
    • Introduction de messages d'abandon pour les commandes bkup_api car elles sont désormais remplacées par des commandes dbaascli. Pour plus de détails, reportez-vous à "dbaascli database backup --help" et à "dbaascli database recover –help".
  • Opérations de base de données pluggable
    • Prise en charge de l'opération de transfert de base de données pluggable. Pour plus de détails, reportez-vous à "dbaascli pdb relocate –help".
    • Réorganisation du workflow de conversion d'une base de données non Conteneur en base de données pluggable. Pour plus de détails, reportez-vous à "dbaascli database convertToPDB –help".
  • Gestion des clés de cryptage
    • Définition des paramètres d'initialisation propres au signal d'activité du cryptage transparent des données (TDE) sur les valeurs recommandées dans le cloud pour les bases de données avec des clés gérées par le client.
  • Gestion de la bibliothèque de logiciels cloud
    • Réorganisation du téléchargement d'artefacts à partir de la bibliothèque de logiciels via imageTags. Il est recommandé d'utiliser imageTags pour télécharger les images logicielles de grille et de base de données. Pour plus de détails, reportez-vous à "dbaascli cswlib showimages" et à "dbaascli cswlib download –help".
  • AHF version 21.4.2 inclus.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 21.4.1.1.0 (220209)

  • AHF version 21.4.1 inclus.
  • Corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 21.4.1.1.0

  • Activation du cryptage des tablespaces de niveau système (SYSTEM, SYSAUX, UNDO et TEMP) pour les bases de données qui seront créées à partir de cette version de dbaastools. Cette fonctionnalité est activée pour Oracle Database version 19.6.0.0.0 et versions supérieures.
  • Application de patches à une grille :
    • Ajout d'une condition de prérequis pour vérifier que l'utilisateur grid est propriétaire du fichier suivant. 
      • <gi_home>/suptools/tfa/release/tfa_home/jlib/jdev-rt.jar
      • <gi_home>/suptools/tfa/release/tfa_home/jlib/jewt4.jar
  • Application de patches à une base de données :
    • Interdiction par défaut de l'opération database move simultanée. Introduction d'une nouvelle option –allowParallelDBMove pouvant être utilisée pour remplacer le comportement par défaut des versions 12.2 et supérieures d'Oracle Database.
    • Correction des problèmes liés au déplacement des bases de données de secours en mode MOUNT.
  • Sauvegarde et récupération de base de données :
    • Ajout de nouvelles options de ligne de commande pour la sauvegarde de base de données. Pour plus de détails, reportez-vous à la référence de la commande dbaascli database backup.
    • Ajout de nouvelles options de ligne de commande pour la récupération de base de données. Pour plus de détails, reportez-vous à la référence de la commande dbaascli database recover.
    • Futur abandon de l'utilisation de bkup_api pour les opérations de sauvegarde et de récupération.
    • Afin d'être en adéquation avec la pratique recommandée par Oracle qui consiste à utiliser le privilège d'administration SYSBACKUP pour les opérations de sauvegarde et de récupération, l'automatisation du cloud crée un utilisateur d'administration commun C##DBLCMUSER avec le rôle SYSBACKUP au niveau du conteneur CDB$ROOT. Les opérations de sauvegarde et de récupération sont donc exécutées avec l'utilisateur doté des moindres privilèges requis. Les informations d'identification de cet utilisateur sont générées de manière aléatoire et gérées en toute sécurité par l'automatisation du cloud. Si l'utilisateur est introuvable ou s'il est à l'état LOCKED et EXPIRED, l'automatisation du cloud recrée ou déverrouille cet utilisateur lors de l'opération de sauvegarde ou de récupération. Cette modification de l'automatisation du cloud est apportée à partir de dbaastools version 21.4.1.1.0.
  • Amélioration de la fonctionnalité dbaascli resume pour reprendre toute session précédente en indiquant l'argument –sessionID <valeur> dans la commande de reprise. L'ID de session est partagé dans la sortie de dbaascli ainsi que dans les journaux.
  • Amélioration de la sortie de dbaascli help pour afficher la syntaxe de la commande.
  • Utilisation du shell dbaascli (session interactive) en phase d'abandon. Elle ne sera plus du tout prise en charge après mars 2022. Il est recommandé d'exécuter des commandes dbaascli complètes sur l'invite de commande comme suggéré dans tous les exemples du document.
  • Autonomous Health Framework (AHF) version 21.2.8. inclus.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 21.3.1.2.0

  • Amélioration du déroulement des opérations dbaascli avec une logique de synchronisation des métadonnées du plan de contrôle améliorée.
  • Amélioration des journaux dbaascli pour disposer d'informations d'une précision à la milliseconde avec le thread associé.
  • Introduction de vérifications de prérequis supplémentaires pour les opérations d'application de patches à un répertoire de base de base de données et de déplacement de base de données afin de détecter les scénarios d'échecs potentiels avec des suggestions d'action corrective.
  • Conservation par les opérations d'application de patches à une base de données de l'état des bases de données avant l'application des patches. Pour les bases de données pluggables, l'état enregistré est respecté.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 21.3.1.1.0

  • Ajout de la prise en charge du déverrouillage du compte d'administrateur de base de données pluggable dans le cadre des opérations de création de base de données pluggable, localClone ou remoteClone. Pour obtenir des détails, reportez-vous à l'option --lockPDBAdminAccount dans dbaascli pdb create --help.
  • Correction d'un problème qui met à jour la ressource de base de données inscrite auprès d'Oracle Grid Infrastructure dans les environnements existants avec la valeur correcte du nom de base de données.
  • Amélioration des opérations de cycle de vie de base de données pluggable.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 21.3.1.0.1

  • Prise en charge des commandes dbaascli suivantes à exécuter en tant qu'utilisateur oracle.
    • 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
  • Réorganisation de l'application de patches sans réutilisation de la mémoire à une base de données. Pour obtenir des détails, reportez-vous à dbaascli database move –help.
  • Améliorations concernant le déroulement du workflow d'application de patches à Oracle Grid Infrastructure. Pour obtenir des détails, reportez-vous à dbaascli grid patch –help.
  • Abandon en cours de la prise en charge de exadbcpatchmulti / dbaascli patch pour les opérations d'application de patches. Les commandes dbaascli dbhome patch et dbaascli grid patch permettent d'appliquer des patches à des répertoires de base de base de données et à Oracle Grid Infrastructure. Pour obtenir des détails, reportez-vous à Application de patches à Oracle Grid Infrastructure et aux bases de données Oracle à l'aide de dbaascli. Reportez-vous également à Référence des commandes dbaascli.
  • Abandon en cours de la prise en charge de la commande dbaascli tools patch pour assurer la cohérence des conventions de commande dbaascli. La nouvelle commande est dbaascli admin updateStack. Pour obtenir des détails, reportez-vous à Mise à jour des outils cloud à l'aide de dbaascli.
  • Possibilité d'exécuter dbaascli en mode déconnecté pour les opérations à longue durée d'exécution. L'exécution d'une commande dbaascli avec --waitForCompletion false vous donne un ID de travail qui peut faire l'objet d'une requête ultérieurement pour obtenir le statut de l'opération, à l'aide de dbaascli job getStatus –jobid job_id. Cela est utile pour les opérations à longue durée d'exécution où les utilisateurs veulent récupérer le contrôle immédiatement après l'exécution de la commande. Dans cette version, cette option est disponible uniquement pour la commande dbaascli database create. D'autres commandes seront ajoutées dans les versions suivantes pour bénéficier de cette prise en charge. La sortie d'aide de ces commandes reflétera la prise en charge de l'option --waitForCompletion.
  • Abandon en cours de la prise en charge du shell dbaascli. Il est recommandé aux utilisateurs d'exécuter des commandes dbaascli complètes sur l'invite de commande comme suggéré dans tous les exemples du document. L'exécution de dbaascli uniquement affiche la sortie de son aide relative à la syntaxe au lieu d'accéder à un shell dbaascli.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Version 21.2.1.x.x

  • Reconception de l'opération d'application de patches à Oracle Grid Infrastructure, et ajout de la possibilité d'effectuer une reprise à partir d'un point d'échec, d'appliquer des patches sur un sous-ensemble de noeuds, de purger une instance, ainsi que d'autres améliorations. Pour obtenir des détails, reportez-vous à dbaascli grid patch --help. Reportez-vous également à Application de patches à Oracle Grid Infrastructure et aux bases de données Oracle à l'aide de dbaascli.
  • Abandon en cours de la prise en charge de exadbcpatchmulti / dbaascli patch pour les opérations d'application de patches. Les commandes dbaascli dbhome patch et dbaascli grid patch permettent d'appliquer des patches à des répertoires de base de base de données et à Oracle Grid Infrastructure. Pour obtenir des détails, reportez-vous à Application de patches à Oracle Grid Infrastructure et aux bases de données Oracle à l'aide de dbaascli. Reportez-vous également à Référence des commandes dbaascli.
  • Abandon en cours de la prise en charge de la commande dbaascli tools patch pour assurer la cohérence des conventions de commande. La nouvelle commande est dbaascli admin updateStack.
  • Reconception des API de gestion de base de données pluggable pour les opérations de création, de clonage local et de clonage à distance. Pour obtenir des détails, reportez-vous à dbaascli pdb --help.
  • Reconception de l'API de suppression de base de données. Pour obtenir des détails, reportez-vous à dbaascli database delete --help.
  • Réorganisation de la création d'un répertoire de base de base de données (prise en charge de l'image logicielle personnalisée et de l'opération d'augmentation du matériel). Pour obtenir des détails, reportez-vous à dbaascli dbhome create --help.
  • Prise en charge de la création de base de données sur un sous-ensemble de noeuds de cluster. Pour obtenir des détails, reportez-vous à dbaascli database create --help.
  • Possibilité d'exécuter dbaascli en mode déconnecté pour les opérations à longue durée d'exécution. L'exécution d'une commande dbaascli avec --waitForCompletion false vous donne un ID de travail qui peut faire l'objet d'une requête ultérieurement pour obtenir le statut de l'opération, à l'aide de dbaascli job getStatus –jobid job_id. Cela est utile pour les opérations à longue durée d'exécution où les utilisateurs veulent récupérer le contrôle immédiatement après l'exécution de la commande. Dans cette version, cette option est disponible uniquement pour la commande dbaascli database create. D'autres commandes seront ajoutées dans les versions suivantes pour bénéficier de cette prise en charge. La sortie d'aide de ces commandes reflétera la prise en charge de l'option --waitForCompletion.
  • Amélioration de l'expérience d'application de patches à un répertoire de base de base de données avec l'introduction de plusieurs options telles que skipPDBs, continueWithDowntime, etc. Pour obtenir des détails, reportez-vous à dbaascli dbhome patch --help.
  • Prise en charge d'une meilleure collecte de diagnostics. Pour obtenir des détails, reportez-vous à dbaascli diag collect --help.
  • Améliorations mineures apportées à l'automatisation des mises à niveau de base de données.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Rubrique parent : Notes sur la version

Référence des commandes dbaascli

Vous devez utiliser dbaascli pour créer des bases de données et les intégrer à la structure d'automatisation du cloud.

dbaascli est une interface native cloud qui accepte comme entrées les modèles DBCA, appelle la fonctionnalité de DBCA pour créer des bases de données, puis appelle les API OCI pour intégrer la base de données à la structure d'automatisation du cloud. Les clients qui utilisent actuellement DBCA dans des scripts peuvent mettre à jour leurs scripts existants pour appeler dbaascli au lieu de DBCA. Si dbaascli ne peut pas être utilisé car une fonctionnalité particulière de DBCA n'est pas disponible dans dbaascl, les clients doivent ouvrir une demande My Oracle Support (MOS) pour ajouter cette fonctionnalité à dbaascli.

Pour vous servir de l'utilitaire dbaascli, vous devez être connecté à un noeud de calcul Exadata Cloud Infrastructure. Pour obtenir des instructions, reportez-vous à Connexion à une instance Exadata Cloud Infrastructure.

Certaines commandes dbaascli peuvent être exécutées en tant qu'utilisateur oracle ou opc, mais de nombreuses commandes requièrent des privilèges d'administrateur root. Reportez-vous à chaque commande pour connaître ses exigences spécifiques.

  • dbaascli admin updateAHF
    Pour installer ou mettre à jour Autonomous Health Framework (AHF), utilisez la commande dbaascli admin updateAHF.
  • dbaascli admin updateStack
    Pour installer ou mettre à jour un RPM dbaastools, utilisez la commande dbaascli admin updateStack.
  • dbaascli cswlib deleteLocal
    Pour supprimer l'image locale, utilisez la commande dbaascli cswlib deleteLocal.
  • dbaascli cswlib download
    Pour télécharger les images logicielles disponibles et les mettre à disposition dans votre environnement Exadata Cloud Infrastructure, utilisez la commande dbaascli cswlib download.
  • dbaascli cswlib listLocal
    Pour afficher la liste des images Database et Grid Infrastructure disponibles en local, utilisez la commande dbaascli cswlib listLocal.
  • dbaascli cswlib showImages
    Pour afficher la liste des images de base de données et Grid Infrastructure disponibles, utilisez la commande dbaascli cswlib showImages.
  • dbaascli database addInstance
    Afin d'ajouter l'instance de base de données sur le noeud indiqué, utilisez la commande dbaascli database addInstance.
  • dbaascli database backup
    Pour configurer Oracle Database avec une destination de stockage de sauvegarde, effectuer des sauvegardes de base de données, interroger des sauvegardes et supprimer une sauvegarde, utilisez la commande dbaascli database backup.
  • dbaascli database bounce
    Pour arrêter et redémarrer une base de données Exadata Cloud Infrastructure spécifiée, utilisez la commande dbaascli database bounce.
  • dbaascli database changepassword
    Pour modifier le mot de passe d'un utilisateur Oracle Database spécifié, utilisez la commande dbaascli database changePassword. Lorsque vous y êtes invité, saisissez le nom utilisateur pour lequel vous voulez modifier le mot de passe, puis saisissez le mot de passe.
  • dbaascli database convertToPDB
    Pour convertir la base de données non Conteneur indiquée en base de données pluggable, utilisez la commande dbaascli database convertToPDB.
  • dbaascli database create
    Pour créer une base de données Oracle, utilisez la commande dbaascli database create. Lorsque vous y êtes invité, saisissez les mots de passe sys et tde.
  • dbaascli database delete
    Pour supprimer une base de données Oracle, utilisez la commande dbaascli database delete.
  • dbaascli database deleteInstance
    Pour supprimer l'instance de base de données sur le noeud indiqué, utilisez la commande dbaascli database deleteInstance.
  • dbaascli database Duplicate
    Pour créer une base de données à partir d'une base de données active, utilisez la commande dbaascli database duplicate.
  • dbaascli database getDetails
    Cette commande affiche les informations détaillées d'une base de données spécifique, comme son nom, les informations de noeud, les informations des bases de données pluggables, etc.
  • dbaascli database getPDBs
    Pour afficher la liste de toutes les bases de données pluggables dans une base de données Conteneur, utilisez la commande dbaascli database getPDBs.
  • dbaascli database modifyParameters
    Pour modifier ou réinitialiser les paramètres d'initialisation d'une base de données Oracle, utilisez la commande dbaascli database modifyParameters.
  • dbaascli database move
    Pour déplacer la base de données d'un répertoire de base vers un autre, utilisez la commande dbaascli database move.
  • dbaascli database recover
    Pour récupérer une base de données, utilisez la commande dbaascli database recover.
  • dbaascli database runDatapatch
    Pour appliquer des patches à une base de données Oracle, utilisez la commande dbaascli database runDatapatch.
  • dbaascli database createTemplate
    Pour créer des modèles de base de données (modèles DBCA), qui peuvent ensuite être employés afin de créer des bases de données, utilisez cette commande.
  • dbaascli database start
    Pour démarrer une base de données Oracle, utilisez la commande dbaascli database start.
  • dbaascli database status
    Pour vérifier le statut d'une base de données Oracle, utilisez la commande dbaascli database status.
  • dbaascli database stop
    Pour arrêter une base de données Oracle, utilisez la commande dbaascli database stop.
  • dbaascli database upgrade
    Pour mettre à niveau une base de données Oracle, utilisez la commande dbaascli database upgrade.
  • dbaascli dataguard prepareStandbyBlob
    Pour générer un fichier BLOB contenant divers fichiers requis sur le site de secours dans le cas d'un environnement Data Guard, utilisez la commande dbaascli dataguard prepareStandbyBlob.
  • dbaascli dataguard updateDGConfigAttributes
    Pour mettre à jour les attributs d'automatisation Data Guard sur tous les noeuds de cluster, utilisez la commande dbaascli dataguard updateDGConfigAttributes.
  • dbaascli dataguard failover
    Pour effectuer un basculement manuel vers la base de données de secours, utilisez la commande dataguard failover.
  • dbaascli dataguard reinstate
    Pour rétablir une base de données en échec en tant que base de données de secours après un basculement, utilisez la commande dataguard reinstate.
  • dbaascli dataguard switchover
    Pour effectuer une permutation vers la base de données de secours, utilisez la commande dataguard switchover.
  • dbaascli dataguard prepareForStandby
    Pour créer une base de données de secours Oracle, utilisez la commande dbaascli dataguard prepareForStandby en tant que première étape.
  • dbaascli dataguard configureStandby
    Pour créer une base de données de secours, utilisez la commande dbaascli dataguard configureStandby comme deuxième étape après l'étape prepareForStandby.
  • dbaascli dataguard registerStandby
    Pour inscrire une base de données de secours nouvellement créée auprès de toutes les bases de données de secours existantes et de la base de données principale, utilisez la commande dbaascli dataguard registerStandby en tant que troisième étape après l'étape configureStandby.
  • dbaascli dataguard deregisterStandby
    Lors de la suppression de la base de données de secours, exécutez la commande dbaascli dataguard deregisterStandby avant de supprimer la base de données sur le cluster de secours pour annuler l'inscription de la base de données de secours dans la configuration du broker Oracle Data Guard.
  • dbaascli dataguard configureAWR
    Pour activer ou désactiver la configuration du référentiel AWR (Automatic Workload Repository) sur la base de données de secours Active Data Guard, utilisez la commande dbaascli dataguard configureAWR.
  • dbaascli dataguard updateConfiguration
    Pour mettre à jour le mode de transport ou de protection, ou les deux, les paramètres d'un environnement Data Guard, utilisez la commande dbaascli dataguard updateConfiguration.
  • dbaascli dbhome create
    Pour créer un répertoire de base de base de données Oracle de la version de votre choix, utilisez la commande dbaascli dbhome create.
  • dbaascli dbHome delete
    Pour supprimer un répertoire de base de base de données Oracle particulier, utilisez la commande dbaascli dbHome delete.
  • dbaascli dbhome getDatabases
    Pour visualiser des informations sur toutes les bases de données Oracle exécutées à partir d'un répertoire de base de base de données Oracle particulier, utilisez la commande dbaascli dbHome getDatabases. Indiquez l'emplacement ou le nom du répertoire de base Oracle.
  • dbaascli dbHome getDetails
    Pour afficher les informations relatives à un répertoire de base Oracle spécifique, utilisez la commande dbaascli dbHome getDetails. Indiquez l'emplacement ou le nom du répertoire de base Oracle.
  • dbaascli dbHome patch
    Pour appliquer des patches à un répertoire de base Oracle d'un niveau de patch vers un autre, utilisez la commande dbaascli dbHome patch.
  • dbaascli dbimage purge
    La commande dbimage purge enlève l'image logicielle indiquée de l'environnement Exadata Cloud Infrastructure.
  • dbaascli diag collect
    Pour collecter des diagnostics, utilisez la commande dbaascli diag collect.
  • dbaascli diag healthCheck
    Pour exécuter des vérifications de l'état de diagnostic, utilisez la commande dbaascli diag healthCheck.
  • dbaascli gridHome create
    Pour configurer le répertoire de base Grid Infrastructure, utilisez la commande dbaascli gridHome create.
  • dbaascli grid configureTCPS
    Afin de configurer TCPS pour le cluster existant, utilisez la commande dbaascli grid configureTCPS.
  • dbaascli grid patch
    Pour appliquer les patches de la version mineure indiquée à Oracle Grid Infrastructure, utilisez la commande dbaascli grid patch.
  • dbaascli grid removeTCPSCert
    Pour enlever des certificats TCPS existants du portefeuille Grid Infrastructure, utilisez la commande dbaascli grid removeTCPSCert.
  • dbaascli grid rotateTCPSCert
    Pour effectuer la rotation des certificats TCPS, utilisez la commande dbaascli grid rotateTCPSCert.
  • dbaascli grid upgrade
    Pour mettre à niveau Oracle Grid Infrastructure d'une version majeure vers une autre, utilisez la commande dbaascli grid upgrade.
  • dbaascli job getStatus
    Pour afficher le statut d'un travail indiqué, utilisez la commande dbaascli job getStatus.
  • dbaascli patch db apply
  • dbaascli patch db prereq
  • dbaascli pdb backup
    Pour sauvegarder une base de données pluggable, interroger des sauvegardes de base de données pluggable et supprimer une sauvegarde de base de données pluggable, utilisez la commande dbaascli pdb backup.
  • dbaascli pdb bounce
    Pour redémarrer une base de données pluggable, utilisez la commande dbaascli PDB bounce.
  • dbaascli pdb close
    Pour fermer une base de données pluggable, utilisez la commande dbaascli pdb close.
  • dbaascli pdb getConnectString
    Afin d'afficher les informations de chaîne de connexion Oracle Net pour une base de données pluggable, exécutez la commande dbaascli pdb getConnectString.
  • dbaascli pdb create
    Pour créer une base de données pluggable, utilisez la commande dbaascli pdb create.
  • dbaascli pdb delete
    Pour supprimer une base de données pluggable, exécutez la commande dbaascli pdb delete.
  • dbaascli pdb getDetails
    Pour afficher les détails d'une base de données pluggable, utilisez la commande dbaascli pdb getDetails.
  • dbaascli pdb list
    Pour afficher la liste des bases de données pluggables dans une base de données Conteneur, utilisez la commande dbaascli pdb list.
  • dbaascli pdb localClone
    Pour créer une base de données pluggable en tant que clone d'une base de données pluggable existante dans la même base de données Conteneur, utilisez la commande dbaascli pdb localClone.
  • dbaascli pdb open
    Pour ouvrir une base de données pluggable, utilisez la commande dbaascli pdb open.
  • dbaascli pdb recover
    Pour récupérer une base de données pluggable, utilisez la commande dbaascli pdb recover.
  • dbaascli pdb refresh
    Pour actualiser une base de données pluggable spécifique, utilisez la commande dbaascli pdb refresh.
  • dbaascli pdb relocate
    Pour transférer la base de données pluggable indiquée de la base de données distante vers la base de données locale, utilisez la commande dbaascli pdb relocate.
  • dbaascli pdb remoteClone
    Pour créer une base de données pluggable en tant que clone d'une base de données pluggable existante dans une autre base de données Conteneur, utilisez la commande dbaascli pdb remoteClone.
  • dbaascli system getDBHomes
    Pour afficher les informations relatives à tous les répertoires de base Oracle, utilisez la commande dbaascli system getDBHomes.
  • dbaascli system getGridHomes
    Pour répertorier les détails de tous les répertoires de base Grid, utilisez la commande dbaascli system getGridHomes.
  • dbaascli tde changePassword
    Afin de modifier le mot de passe du fichier de clés TDE et le mot de passe du portefeuille de base de données pour l'alias tde_ks_passwd, utilisez la commande dbaascli tde changePassword.
  • dbaascli tde addSecondaryHsmKey
    Pour ajouter une clé HSM (KMS) secondaire à la configuration HSM (KMS) existante, utilisez la commande dbaascli tde addSecondaryHsmKey.
  • dbaascli tde enableWalletRoot
    Afin d'activer le paramètre SPFILE wallet_root pour la base de données existante, utilisez la commande dbaascli tde enableWalletRoot.
  • dbaascli tde encryptTablespacesInPDB
    Pour crypter tous les tablespaces dans la base de données pluggable indiquée, utilisez la commande dbaascli tde encryptTablespacesInPDB.
  • dbaascli tde fileToHsm
    Pour convertir un cryptage transparent des données basé sur FILE en cryptage transparent des données basé sur HSM (KMS/OKV), utilisez la commande dbaascli tde fileToHsm.
  • dbaascli tde getHsmKeys
    Pour obtenir les détails de la clé active TDE, utilisez la commande dbaascli tde getHsmKeys.
  • dbaascli tde getMkidForKeyVersionOCID
    Pour obtenir l'ID de clé maître associé à l'OCID de version de clé KMS, utilisez la commande dbaascli tde getMkidForKeyVersionOCID.
  • dbaascli tde getPrimaryHsmKey
    Pour obtenir la clé HSM (KMS) primaire de la configuration HSM (KMS) existante, utilisez la commande dbaascli tde getPrimaryHsmKey.
  • dbaascli tde hsmToFile
    Pour convertir un cryptage transparent des données basé sur HSM (KMS/OKV) en cryptage transparent des données basé sur FILE, utilisez la commande dbaascli tde hsmToFile.
  • dbaascli tde listKeys
    Pour répertorier les clés maître TDE, utilisez la commande dbaascli tde listKeys.
  • dbaascli tde removeSecondaryHsmKey
    Pour enlever une clé HSM (KMS) secondaire de la configuration HSM (KMS) existante, utilisez la commande dbaascli tde removeSecondaryHsmKey.
  • dbaascli tde rotateMasterKey
    Permet d'effectuer une rotation de la clé maître pour le cryptage de base de données.
  • dbaascli tde setKeyVersion
    Pour définir la version de la clé primaire à utiliser dans la base de données, la base de données Conteneur ou la base de données pluggable, utilisez la commande dbaascli tde setKeyVersion.
  • dbaascli tde setPrimaryHsmKey
    Pour modifier la clé HSM (KMS) primaire de la configuration HSM (KMS) existante, utilisez la commande dbaascli tde setPrimaryHsmKey.
  • dbaascli tde status
    Afin d'afficher les informations relatives au fichier de clés pour la base de données spécifiée, utilisez la commande dbaascli tde status.

Rubrique parent : Utilisation de l'utilitaire dbaascli sur Exadata Cloud Infrastructure

dbaascli admin updateAHF

Pour installer ou mettre à jour Autonomous Health Framework (AHF), utilisez la commande dbaascli admin updateAHF.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli admin updateAHF
 {
   --targetVersion value | --imageTag value
}
[--resume [--sessionID value]] [--executePrereqs]
Où :
  • --targetVersion indique la version cible vers laquelle mettre AHF à jour
  • --imageTag indique la balise d'image de l'artefact AHF à installer.
  • --resume reprend l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --executePrereqs exécute les vérifications de prérequis et signale les résultats.

dbaascli admin updateStack

Pour installer ou mettre à jour un RPM dbaastools, utilisez la commande dbaascli admin updateStack.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Pour vous servir de l'utilitaire, vous devez vous connecter à une machine virtuelle Exadata Cloud Infrastructure.

Reportez-vous à Connexion à une machine virtuelle avec SSH.

Syntaxe

dbaascli admin updateStack 
[--resume]
[--prechecksOnly]
[--nodes]
Où :
  • --resume reprend l'exécution précédente.
  • --prechecksOnly exécute uniquement les prévérifications pour cette opération.
  • --nodes indique la liste des noeuds, séparés par des virgules, sur lesquels installer le RPM. Si vous ne transmettez pas cet argument, le RPM est installé sur tous les noeuds du cluster.

dbaascli cswlib deleteLocal

Pour supprimer l'image locale, utilisez la commande dbaascli cswlib deleteLocal.

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli cswLib deleteLocal --imageTag <value>

Où :

  • --imageTag indique la balise d'image du répertoire de base Oracle.

Exemple 6-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

Pour télécharger les images logicielles disponibles et les mettre à disposition dans votre environnement Exadata Cloud Infrastructure, utilisez la commande dbaascli cswlib download.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Pour vous servir de l'utilitaire, vous devez vous connecter à une machine virtuelle Exadata Cloud Infrastructure.

Reportez-vous à Connexion à une machine virtuelle avec SSH.

Syntaxe

dbaascli cswlib download --version | --imageTag
[--product]
Où :
  • --version indique une version d'image de répertoire de base Oracle.
  • --imageTag indique la balise de l'image.
  • --product indique le type d'image. Valeurs valides : database ou grid.

Exemple 6-5 dbaascli cswlib download --product --imageTag

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

Exemple 6-6 dbaascli cswlib download --version 19.9.0.0.0

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

dbaascli cswlib listLocal

Pour afficher la liste des images Database et Grid Infrastructure disponibles en local, utilisez la commande dbaascli cswlib listLocal.

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli cswLib listLocal [--product <value>]

Où :

  • --product identifie le type de produit du répertoire de base Oracle. Valeurs valides : database ou grid.

Exemple 6-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

Pour afficher la liste des images de base de données et Grid Infrastructure disponibles, utilisez la commande dbaascli cswlib showImages.

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli cswlib showImages 
[--product]

Où :

  • --product identifie le type de produit du répertoire de base Oracle. Valeurs valides : database ou grid.

Exemple 6-8 dbaascli cswlib showImages

dbaascli cswlib showImages

dbaascli database addInstance

Afin d'ajouter l'instance de base de données sur le noeud indiqué, utilisez la commande dbaascli database addInstance.

Prérequis

  • Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli database addInstance --dbname <value> --node <value> [--newNodeSID <value>]
Où :
  • --dbname indique le nom de la base de données Oracle.
  • --node indique le nom de noeud pour l'instance de base de données.
    • --newNodeSID indique le SID de l'instance à ajouter dans le nouveau noeud.

dbaascli database backup

Pour configurer Oracle Database avec une destination de stockage de sauvegarde, effectuer des sauvegardes de base de données, interroger des sauvegardes et supprimer une sauvegarde, utilisez la commande dbaascli database backup.

Prérequis

  • Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli database backup --dbname <value>
        {
            --list
                {
                    [--backupType <value>]
                    | [--json <value>]
                }
            | --start [--level0] [--level1]
                {
                    [--archival --tag <value>]
                    | [--archivelog]
                }
            | --delete --backupTag <value>
            | --status --uuid <value> [--json <value>]
            | --getBackupReport
                {
                    --tag <value>
                    | --latest
                }
                --json <value>
            | --configure
                {
                    --configFile <value>
                    | --enableRTRT
                    | --disableRTRT
                    | --disableCatalog
                    | --deleteImmutableConfiguration
                }
            | --getConfig
                {
                    [--configFile <value>]
                    | [--showOldParams]
                }
            | --validate [--untilTime <value>]
            | --showHistory [--all]
            | --getSchedules
        }

Où :

  • --dbname indique le nom de la base de données Oracle.
  • --list renvoie les informations de sauvegarde de base de données

    [--backupType | --json]

    [--backupType indique backupType (REGULAR-L0 | REGULAR-L1 | ARCHIVELOG | LONGTERM) ]

    [--json indique le nom de fichier pour la sortie JSON ]

  • --start démarre la sauvegarde de base de données

    [--level0 crée une sauvegarde complète de niveau 0]

    [--level1 crée une sauvegarde de niveau 1 (incrémentielle) ]

    [--archival | --archivelog]

    [--archival crée une sauvegarde complète d'archivage]

    --tag indique une balise de sauvegarde

    [--archivelog ]

  • --delete supprime la sauvegarde d'archivage

    --backupTag indique la balise de sauvegarde à supprimer.

  • --status affiche les détails d'un processus de travail de sauvegarde.

    Identificateur unique --uuid de l'opération de sauvegarde. Format d'entrée : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

    [--json indique le nom de fichier pour la sortie JSON]

  • --getBackupReport renvoie BackupReport

    --tag | --latest

    --tag indique une balise de sauvegarde

    --latest renvoie le rapport de sauvegarde le plus récent (tous les types de sauvegarde de base de données)

    --json indique le nom de fichier de la sortie JSON.

  • --configure configure la base de données pour la sauvegarde

    --configFile | --enableRTRT | --disableRTRT | --disableCatalog | --deleteImmutableConfiguration

    --configFile indique le fichier de configuration de sauvegarde de base de données.

    --enableRTRT active Real Time Redo Transport

    --disableRTRT désactive Real Time Redo Transport

    --disableCatalog désactive le catalogue de restauration

    --deleteImmutableConfiguration supprime une configuration non mutable

  • --getConfig renvoie la configuration de la sauvegarde de base de données

    [--configFile | --showOldParams]

    [--configFile indique le fichier de configuration de sauvegarde de base de données]

    [--showOldParams renvoie les anciens noms de paramètre de la configuration de sauvegarde.]

  • --validate vérifie que les sauvegardes sont complètes et intactes

    [--untilTime valide à partir de la sauvegarde de niveau 0 (complète) la plus proche jusqu'à la date indiquée. Format d'entrée : DD-MON-YYYY HH24:MI:SS]

  • --showHistory affiche l'historique des opérations de sauvegarde.

    [--all affiche toutes les opérations de sauvegarde]

  • --getSchedules renvoie toutes les programmations de sauvegarde pour une base de données.
Remarque

Les paramètres enableRTRT et disableRTRT sont applicables uniquement pour la destination de sauvegarde ZDLRA sur Exadata Database Service on Cloud@Customer.

dbaascli database bounce

Pour arrêter et redémarrer une base de données Exadata Cloud Infrastructure spécifiée, utilisez la commande dbaascli database bounce.

Prérequis

Exécutez la commande en tant qu'utilisateur oracle.

Syntaxe

dbaascli database bounce
[--dbname][--rolling <value>]
Où :
  • --dbname indique le nom de la base de données.
  • --rolling indique true ou false pour le redémarrage de la base de données en mode non simultané. La valeur par défaut est false.

La commande arrête la base de données en mode immédiat. La base de données est ensuite redémarrée et ouverte. Dans Oracle Database 12c ou version ultérieure, toutes les bases de données pluggables sont également ouvertes.

Exemple 6-9 dbaascli database bounce

dbaascli database bounce --dbname dbname

dbaascli database changepassword

Pour modifier le mot de passe d'un utilisateur Oracle Database spécifié, utilisez la commande dbaascli database changePassword. Lorsque vous y êtes invité, saisissez le nom utilisateur pour lequel vous voulez modifier le mot de passe, puis saisissez le mot de passe.

Prérequis

Exécutez la commande en tant qu'utilisateur root ou oracle.

Syntaxe

dbaascli database changePassword [--dbname <value>] [--user <value>]
{
  [--prepareStandbyBlob <value> [--blobLocation <value>]] | [--standbyBlobFromPrimary <value>]
}
[--resume [--sessionID <value>]]
Où :
  • --dbname indique le nom de la base de données Oracle sur laquelle effectuer une opération.
  • --user indique le nom utilisateur pour lequel la modification du mot de passe est requise.
  • --prepareStandbyBlob indique true pour générer un fichier BLOB contenant les artefacts nécessaires à la modification du mot de passe dans un environnement Data Guard. Valeurs valides : true|false.
  • --blobLocation indique le chemin personnalisé où le fichier BLOB sera généré.
  • --standbyBlobFromPrimary indique l'emplacement du fichier BLOB de secours, préparé à partir de la base de données principale.
  • --resume indique de reprendre l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.

Exemple 6-10 dbaascli database changePassword

dbaascli database changepassword --dbname db19

dbaascli database convertToPDB

Pour convertir la base de données non Conteneur indiquée en base de données pluggable, utilisez la commande dbaascli database convertToPDB.

Syntaxe

dbaascli database convertToPDB --dbname <value> [--cdbName <value>] [--executePrereqs]
        {
            [--copyDatafiles [--keepSourceDB]]|[backupPrepared]
        }
        [--targetPDBName <value>] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Où :
  • --dbname indique le nom de la base de données Oracle.
  • --cdbName indique le nom de la base de données Conteneur cible dans laquelle la base de données pluggable sera créée. Si la base de données Conteneur n'existe pas, elle sera créée dans le même répertoire de base Oracle que la base de données non Conteneur source.
  • --executePrereqs indique d'exécuter uniquement les vérifications de préconversion.
  • --copyDatafiles indique de créer une copie des fichiers de données au lieu d'utiliser ceux de la base de données source.

    --keepSourceDB indique de conserver la base de données source une fois l'opération terminée.

  • --backupPrepared est un indicateur permettant de confirmer qu'une sauvegarde de base de données appropriée est en place pour la base de données non Conteneur avant d'effectuer la conversion en base de données pluggable.
  • --backupPrepared est un indicateur permettant de confirmer qu'une sauvegarde de base de données appropriée est en place pour la base de données non Conteneur avant d'effectuer la conversion en base de données pluggable.
  • --targetPDBName indique le nom de la base de données pluggable qui sera créée dans le cadre de l'opération.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.
  • --resume indique de reprendre l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.

Exemple 6-11 dbaascli database convertToPDB

Pour exécuter des prévérifications de préconversion, exécutez la commande suivante :
dbaascli database convertToPDB --dbname ndb19 --cdbname cdb19 --backupPrepared --executePrereqs
Pour exécuter une conversion complète avec une copie des fichiers de données de la base de données non Conteneur, exécutez la commande suivante :
dbaascli database convertToPDB --dbname tst19 --cdbname cdb19 --copyDatafiles

dbaascli database create

Pour créer une base de données Oracle, utilisez la commande dbaascli database create. Lorsque vous y êtes invité, saisissez les mots de passe sys et tde.

Utilisez cette commande pour créer une base de données Oracle version 12.1.0.2 ou supérieure avec la mise à jour de version JAN 2021 ou supérieure. Pour les bases de données de version inférieure, il est recommandé d'utiliser l'API reposant sur la console OCI.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

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]
Où :
  • --dbname indique le nom de la base de données.
  • --oracleHome indique l'emplacement du répertoire de base Oracle.
  • --oracleHomeName indique le nom du répertoire de base Oracle.
  • --dbUniqueName indique le nom unique de la base de données.
  • --dbSID indique le SID de la base de données.
  • --createAsCDB indique true ou false pour créer une base de données en tant que base de données Conteneur ou non Conteneur.
  • --pdbName indique le nom de la base de données pluggable.
  • --pdbAdminUserName indique le nom de l'administrateur de la base de données pluggable.
  • --dbCharset indique le jeu de caractères de la base de données.
  • --dbNCharset indique le jeu de caractères national de la base de données.
  • --dbLanguage indique la langue de la base de données.
  • --dbTerritory indique le territoire de la base de données.
  • --sgaSizeInMB indique la valeur sga_target en méga-octets.
  • --pgaSizeInMB indique la valeur pga_aggregate_target en méga-octets.
  • --datafileDestination indique le nom du groupe de disques ASM à utiliser pour les fichiers de données de la base de données.
  • --fraDestination indique le nom du groupe de disques ASM à utiliser pour la zone de récupération rapide de la base de données.
  • --fraSizeInMB indique la valeur de taille de la zone de récupération rapide en méga-octets.
  • --nodeList indique la liste des noeuds, séparés par des virgules, pour la base de données.
  • --tdeConfigMethod indique la méthode de configuration du cryptage transparent des données. Valeurs valides : FILE, KMS.
  • --kmsKeyOCID indique l'OCID de clé KMS à utiliser pour le cryptage transparent des données. Applicable uniquement si KMS est sélectionné pour le cryptage transparent des données.
  • --resume reprend l'exécution précédente.
  • --revert annule l'exécution précédente.
  • --sessionID indique de reprendre ou d'annuler un ID de session spécifique.
  • --executePrereqs indique yes afin d'exécuter uniquement les prérequis pour cette opération. Valeurs valides : yes ou no.
  • --honorNodeNumberForInstance indique true ou false pour indiquer si les numéros de noeud de cluster doivent être ajoutés en tant que suffixe au nom de l'instance. Valeur par défaut : true
  • --lockPDBAdminAccount indique true ou false pour le verrouillage du compte de l'administrateur de la base de données pluggable. La valeur par défaut est True
  • --dbcaTemplateFilePath indique le chemin absolu du nom du modèle DBCA pour la création de la base de données.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true ou false.

Exemple 6-12 dbaascli database create

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

dbaascli database delete

Pour supprimer une base de données Oracle, utilisez la commande dbaascli database delete.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli database delete --dbname <value>
[--deleteArchiveLogs <value>]
[--deleteBackups <value>]
[--precheckOnly <value>]
[--waitForCompletion <value>]
[--force]
[--dbSID <value>]
[--resume [--sessionID <value>]]
Où :
  • --dbname indique le nom de la base de données.
  • --deleteArchiveLogs indique true ou false pour déterminer la suppression des journaux d'archivage de la base de données.
  • --deleteBackups indique true ou false pour déterminer la suppression des sauvegardes de base de données.
  • --precheckOnly indique yes afin d'exécuter uniquement les prévérifications pour cette opération. Valeurs valides : yes ou no.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true ou false.
  • --force est un indicateur permettant de forcer la suppression de la base de données.
  • --dbSID indique le SID de la base de données.
  • --resume permet de reprendre l'exécution précédente.
  • --sessionID indique de reprendre un ID de session spécifique.

Exemple 6-13 dbaascli database delete

dbaascli database delete --dbname db19

dbaascli database deleteInstance

Pour supprimer l'instance de base de données sur le noeud indiqué, utilisez la commande dbaascli database deleteInstance.

Prérequis

  • Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli database deleteInstance --dbname <value> --node <value> [--continueOnUnreachableNode]
Où :
  • --dbname indique le nom de la base de données Oracle.
  • --node indique le nom de noeud pour l'instance de base de données.
  • --continueOnUnreachableNode indique que l'opération doit être effectuée même si le noeud est inaccessible.

Exemple 6-14 database deleteinstance

database deleteinstance --node test-node

dbaascli database duplicate

Pour créer une base de données à partir d'une base de données active, utilisez la commande dbaascli database duplicate.

Prérequis

  • Exécutez la commande en tant qu'utilisateur root.

Syntaxe

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>]
Où :
  • --dbName indique le nom de la base de données Oracle.
  • --sourceDBConnectionString indique la chaîne de connexion à la base de données source au format <nom_scan>:<port_scan>/<nom_service_de_base_de_données>.
  • --oracleHome indique l'emplacement du répertoire de base Oracle.
  • --oracleHomeName indique le nom du répertoire de base Oracle.
  • --dbSID indique le SID de la base de données.
  • --dbUniqueName indique le nom unique de la base de données.
  • --sgaSizeInMB indique la valeur sga_target en méga-octets.
  • --pgaSizeInMB indique la valeur pga_aggregate_target en méga-octets.
  • --datafileDestination indique le nom du groupe de disques ASM à utiliser pour les fichiers de données de la base de données.
  • --fraDestination indique le nom du groupe de disques ASM à utiliser pour la zone de récupération rapide de la base de données.
  • --fraSizeInMB indique la valeur de taille de la zone de récupération rapide en méga-octets.
  • --sourceDBWalletLocation indique l'emplacement du fichier de portefeuille TDE de la base de données source. Il est requis pour dupliquer la base de données à partir de la base de données active.
  • --nodeList indique la liste des noeuds, séparés par des virgules, pour la base de données.
  • --resume indique de reprendre l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --revert indique que l'exécution précédente doit être annulée.
    • --sessionID indique qu'un ID de session spécifique doit être annulé.
  • --rmanParallelism indique une valeur de parallèle.
  • --rmanSectionSizeInGB indique la taille de section RMAN en Go.
  • --tdeConfigMethod indique la méthode de configuration du cryptage transparent des données. Les valeurs autorisées sont FILE et KMS.
  • --kmsKeyOCID indique l'OCID de clé KMS à utiliser pour le cryptage transparent des données. Applicable uniquement si KMS est sélectionné pour le cryptage transparent des données.
  • --sourceDBTdeConfigMethod indique la méthode de configuration TDE de la base de données source. Les valeurs autorisées sont FILE et KMS.
  • --sourceDBKmsKeyOCID indique l'OCID de clé KMS de la base de données source à utiliser pour le cryptage transparent des données. Applicable uniquement si KMS est sélectionné pour le cryptage transparent des données.
  • --executePrereqs indique yes afin d'exécuter uniquement les prérequis pour cette opération. Valeurs valides : yes|no.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.
  • --skipPDBs indique la liste délimitée par des virgules des noms de base de données pluggable de la base de données source, qui doit être exclue pour l'opération de duplication de base de données. Exemple : pdb1,pdb2...

Exemple 6-15 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

Cette commande affiche les informations détaillées d'une base de données spécifique, comme son nom, les informations de noeud, les informations des bases de données pluggables, etc.

Prérequis

Exécutez la commande en tant qu'utilisateur root ou oracle.

Syntaxe

dbaascli database getDetails --dbname <value>
Où :
  • --dbname est le nom de la base de données Oracle.

dbaascli database getPDBs

Pour afficher la liste de toutes les bases de données pluggables dans une base de données Conteneur, utilisez la commande dbaascli database getPDBs.

Exécutez la commande en tant qu'utilisateur root ou oracle.

Syntaxe

dbaascli database getPDBs --dbname <value>
Où :
  • --dbname indique le nom de la base de données Conteneur.

Exemple 6-16 dbaascli database getPDBs --dbname

dbaascli database getPDBs --dbname apr_db1

dbaascli database modifyParameters

Pour modifier ou réinitialiser les paramètres d'initialisation d'une base de données Oracle, utilisez la commande dbaascli database modifyParameters.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli database modifyParameters --dbname <value> --setParameters <values>| --resetParameters <values> | --responseFile
[--backupPrepared]
[--instance]
[--allowBounce]
Où :
  • --dbname indique le nom de la base de données.
  • --setParameters indique la liste des paramètres, séparés par des virgules, à remplacer par de nouvelles valeurs. Par exemple : parameter1=valueA,parameter2=valueB, etc. Pour les valeurs vides, utilisez parameter1=valueA,parameter2='',etc.
  • --resetParameters indique la liste des paramètres, séparés par des virgules, à réinitialiser sur leur valeur par défaut. Par exemple : parameter1,parameter2, etc.
  • --responseFile indique l'emplacement absolu du fichier JSON de réponses pour modifier les paramètres de base de données.
  • --backupPrepared confirme qu'une sauvegarde de base de données appropriée est en place avant de modifier les paramètres confidentiels ou critiques.
  • --instance indique le nom de l'instance sur laquelle les paramètres seront traités. Si le nom n'est pas indiqué, l'opération sera effectuée au niveau de la base de données.
  • --allowBounce accorde le droit de redémarrer la base de données afin de refléter les modifications sur les paramètres statiques applicables.

Exemple 6-17 dbaascli database modifyParameters

dbaascli database modifyParameters --dbname dbname --setParameters "log_archive_dest_state_17=ENABLE"

dbaascli database move

Pour déplacer la base de données d'un répertoire de base vers un autre, utilisez la commande dbaascli database move.

Prérequis

  • Avant d'effectuer un déplacement, vérifiez que toutes les instances de base de données associées à la base de données sont en fonctionnement.
  • Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli database move
        {
            --oracleHome <value>
            | --oracleHomeName <value>
        }
        --dbname <value>
        {
            [--resume [--sessionID <value>]]
            | [--rollback [--sessionID <value>]]
        }
[--executePrereqs]
[--nonRolling]
[--skipDatapatch]
[--skipPDBs <value>]
[--skipClosedPDBs]
[--continueWithDbDowntime]
[--drainTimeoutInSeconds <value>]
[--allowParallelDBMove]
[--waitForCompletion <value>]
[--nodeList <value>]

Où :

  • --oracleHome indique le chemin du répertoire de base Oracle.
  • --oracleHomeName indique le nom du répertoire de base Oracle.
  • --dbname indique le nom de la base de données.
  • --executePrereqs exécute les vérifications de prérequis et signale les résultats.
  • --nonRolling déplace la base de données sur tous les noeuds en parallèle.

    Notez que cela entraînerait un temps d'inactivité de la base de données.

  • --resume reprend l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --rollback restaure la base de données vers le répertoire de base précédent
    • --sessionID indique de reprendre un ID de session spécifique.
  • --skipDatapatch ignore l'exécution de datapatch sur les bases de données.
  • --skipPdbs ignore l'exécution de datapatch sur la liste de bases de données pluggables séparées par des virgules qui est indiquée.

    Par exemple : pdb1,pdb2...

  • --skipClosedPDBs ignore l'application de patches aux bases de données pluggables fermées
  • --continueWithDbDowntime poursuit l'application des patches avec un temps d'inactivité de la base de données.

    Cette option peut être utilisée dans des environnements dans lesquels une seule instance active est démarrée et dans lesquels l'opération d'application de patches peut être poursuivie même avec un temps d'inactivité.

  • --drainTimeoutInSeconds indique la durée (en secondes) nécessaire à la purge de ressource lors de l'arrêt de la base de données.
  • --allowParallelDBMove permet le déplacement de la base de données en parallèle.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan.

    Valeurs valides : true|false.

  • --nodeList indique une liste de noeuds séparés par des virgules si l'opération doit être exécutée sur un sous-ensemble de noeuds.

Exemple 6-18 dbaascli database move

dbaascli database move --dbname testdb1 --oracleHome /u02/app/oracle/product/12.1.0/dbhome_2

dbaascli database recover

Pour récupérer une base de données, utilisez la commande dbaascli database recover.

Prérequis

  • Exécutez la commande en tant qu'utilisateur root.
  • La base de données doit avoir été configurée avec des détails de destination de stockage de sauvegarde pour l'emplacement de stockage des sauvegardes.

Syntaxe

dbaascli database recover --dbname <value>
        {
            --start
                {
                    --untilTime <value>
                    | --untilSCN <value>
                    | --latest
                }
            | --status --uuid <value>
        }
Où :
--dbname: Oracle Database name.
      --start | --status
--start: Begins database recovery.
      --untilTime | --untilSCN | --latest
      --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.
--status
      --uuid <value>

Exemple 6-19 Exemples

  • Pour récupérer la base de données myTestDb à son dernier état connu, exécutez la commande suivante :
    dbaascli database recover --dbname myTestDb --start --latest
  • Pour interroger le statut de la demande de récupération soumise avec l'uuid 2508ea18be2911eb82d0020017075151, exécutez la commande suivante :
    dbaascli database recover --dbname myTestDb --status --uuid 2508ea18be2911eb82d0020017075151

dbaascli database runDatapatch

Pour appliquer des patches à une base de données Oracle, utilisez la commande dbaascli database runDatapatch.

Prérequis

  • Avant d'effectuer une opération runDatapatch, vérifiez que toutes les instances de base de données associées à la base de données sont en fonctionnement.

  • Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli database runDatapatch --dbname
[--resume]
    [--sessionID]
[--skipPdbs | --pdbs]
[--executePrereqs]
[--patchList]
[--skipClosedPdbs]
[--rollback]

Où :

  • --dbname indique le nom de la base de données.
  • --resume reprend l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --skipPdbs ignore l'exécution de datapatch sur la liste de bases de données pluggables séparées par des virgules qui est indiquée. Par exemple : pdb1,pdb2...
  • --pdbs exécute datapatch uniquement sur la liste de bases de données pluggables séparées par des virgules qui est indiquée. Par exemple : pdb1,pdb2...
  • --executePrereqs exécute les vérifications de prérequis.
  • --patchList applique ou annule la liste de patches séparés par des virgules qui est indiquée. Par exemple : patch1,patch2...
  • --skipClosedPdbs ignore l'exécution de datapatch sur les bases de données pluggables fermées.
  • --rollback annule les patches appliqués. 
dbaascli database runDatapatch --dbname db19

dbaascli database createTemplate

Pour créer des modèles de base de données (modèles DBCA), qui peuvent ensuite être employés afin de créer des bases de données, utilisez cette commande.

Exécutez la commande en tant qu'utilisateur root ou oracle.

Syntaxe

Créez un modèle DBCA à partir de la base de données indiquée.

dbaascli database createTemplate --dbname <value>
 {
   --templateLocation <value> | --uploadToObjectStorage --objectStorageLoginUser <value> --objectStorageBucketName <value> [--objectStorageUrl <value>]
 }
 [--templateName <value>] [--rmanParallelism <value>]
Où :
  • --dbname indique le nom de la base de données.
  • --templateLocation indique le nom du modèle
  • --uploadToObjectStorage indique de télécharger le modèle vers Object Storage
    • --objectStorageLoginUser indique l'utilisateur de connexion à Object Storage
    • --objectStorageBucketName indique le nom de bucket Object Storage
    • --objectStorageUrl indique l'URL Object Storage
  • --templateName indique le nom du modèle
  • --rmanParallelism indique la valeur de parallélisme

dbaascli database start

Pour démarrer une base de données Oracle, utilisez la commande dbaascli database start.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli database start
[--dbname]
[--mode]
Où :
  • --dbname indique le nom de la base de données.
  • --mode indique mount ou nomount pour démarrer la base de données dans le mode correspondant.

La commande démarre et ouvre la base de données. Dans Oracle Database 12c ou version ultérieure, toutes les bases de données pluggables sont également ouvertes.

Exemple 6-20 dbaascli database start

dbaascli database start --dbname dbname --mode mount

dbaascli database status

Pour vérifier le statut d'une base de données Oracle, utilisez la commande dbaascli database status.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli database status
[--service][--dbname] 
[--user]
[--password]
Où :
  • --service indique le nom du service.
  • --dbname indique le nom de la base de données.
  • --user indique le nom de l'utilisateur du service.
  • --password indique le mot de passe de l'utilisateur.

La sortie de la commande inclut le mode d'ouverture, la version logicielle et l'édition de la base de données, ainsi que la version (release) des autres composants logiciels.

Exemple 6-21 dbaascli database status

dbaascli database status --dbname db19

dbaascli database stop

Pour arrêter une base de données Oracle, utilisez la commande dbaascli database stop.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli database stop
[-–dbname <value>]
[--mode <value>]
Où :
  • --dbname indique le nom de la base de données à arrêter.
  • --mode indique le mode de la base de données. Valeurs valides : abort, immediate, normal, transactional.

La commande arrête la base de données en mode immédiat. Les nouvelles connexions ou transactions ne sont pas autorisées. Les transactions actives sont annulées et tous les utilisateurs connectés sont déconnectés.

Exemple 6-22 dbaascli database stop

dbaascli database stop --dbname db19

dbaascli database upgrade

Pour mettre à niveau une base de données Oracle, utilisez la commande dbaascli database upgrade.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli database upgrade --dbname <value> 
{--targetHome <value> | --targetHomeName <value>}
{ [--executePrereqs | --postUpgrade | --rollback]}
{[--standBy | --allStandbyPrepared]}
{[--upgradeOptions <value>]  | [--standBy]}
[--removeGRP]
[--increaseCompatibleParameter]
[--resume [--sessionID <value>]]
[--waitForCompletion <value>]
Où :
  • --dbname (obligatoire) indique le nom de la base de données.
  • --targetHome indique l'emplacement du répertoire de base Oracle cible.
  • --targetHomeName indique le nom du répertoire de base de base de données Oracle cible.
  • --standBy permet de mettre à niveau les bases de données de secours dans les configurations Data Guard.
  • --allStandbyPrepared est requis pour les bases de données principales configurées avec Data Guard. Il s'agit d'un indicateur confirmant que toutes les opérations requises sont effectuées sur les bases de données de secours avant la mise à niveau de la base de données principale.
  • --removeGRP enlève automatiquement la sauvegarde du point de restauration garanti uniquement si la mise à niveau de la base de données a été effectuée.
  • --increaseCompatibleParameter augmente automatiquement le paramètre compatible dans le cadre de la mise à niveau de la base de données. Le paramètre n'est augmenté que si la mise à niveau de la base de données a été effectuée.
  • --executePrereqs exécute uniquement les vérifications à effectuer avant la mise à niveau.
  • --postUpgrade permet de réexécuter les étapes à effectuer après la mise à niveau si celles-ci ont échoué.
  • --rollback rétablit une base de données Oracle dans son répertoire de base Oracle d'origine.
  • --upgradeOptions permet de transmettre des arguments propres à l'assistant de mise à niveau de base de données (DBUA) pour effectuer la mise à niveau de la base de données Oracle. Reportez-vous à la documentation Oracle correspondante pour connaître les options et arguments pris en charge.

    --standby

  • --resume permet de reprendre l'exécution précédente.
  • --sessionID indique de reprendre un ID de session spécifique.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.

Exemple 6-23 Vérifications des prérequis avant mise à niveau avec dbaascli database upgrade

dbaascli database upgrade --dbbname dbname --targetHome Target Oracle home location --executePrereqs

dbaascli dataguard prepareStandbyBlob

Pour générer un fichier BLOB contenant divers fichiers requis sur le site de secours dans le cas d'un environnement Data Guard, utilisez la commande dbaascli dataguard prepareStandbyBlob.

Exécutez la commande en tant qu'utilisateur root ou oracle.

Syntaxe

dbaascli dataguard prepareStandbyBlob --dbname <value> --blobLocation <value>
Où :
  • --dbname indique le nom de la base de données Oracle.
  • --blobLocation indique l'emplacement de répertoire personnalisé où le fichier BLOB de secours sera généré dans un environnement Data Guard.

dbaascli dataguard updateDGConfigAttributes

Pour mettre à jour les attributs d'automatisation Data Guard sur tous les noeuds de cluster, utilisez la commande dbaascli dataguard updateDGConfigAttributes.

Exécutez la commande en tant qu'utilisateur root ou oracle.

Syntaxe

dbaascli dataguard updateDGConfigAttributes --attributes <value>
Où :
  • --attributes contient les attributs d'automatisation Data Guard à modifier. Accepte les valeurs séparées par des virgules au format <attribut=valeur>. Les attributs doivent être prédéfinis dans le fichier de configuration Data Guard.

basculement dbaascli dataguard

Pour effectuer un basculement manuel vers la base de données de secours, utilisez la commande dataguard failover.

Exécutez cette commande en tant qu'utilisateur oracle sur la base de données de secours cible.

Syntaxe

dbaascli dataguard failover --dbname <value> [--useImmediateFailover] [--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Où :
  • --dbname indique le nom d'Oracle Database.
  • --useImmediateFailover utilise cet indicateur lorsque la configuration Oracle Data Guard présente un état d'avertissement ou d'erreur.
  • --executePrereqs exécute les vérifications de pré-requis et signale les résultats.
  • --waitForCompletion indique si l'opération doit attendre sa fin. Définissez la valeur sur false pour exécuter l'opération en arrière-plan. Les valeurs valides sont true|false.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.

Rubrique parent : Référence des commandes dbaascli

Exécution d'une opération de basculement manuel à l'aide de l'utilitaire dbaascli

Pour effectuer un basculement manuel vers la base de données de secours, utilisez la commande dataguard failover.

  1. Connectez-vous à la machine virtuelle dans la configuration Oracle Data Guard qui hébergera la nouvelle base de données principale en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande root-user, puis passez à l'utilisateur oracle :
    $ sudo -s
# su - oracle
$
  3. Lancez le basculement vers la base de données de secours.
    $ dbaascli dataguard failover --dbname <db-name>
  4. Revenez en tant qu'utilisateur root.
    $ exit
#
  5. Quittez l'interpréteur de commandes root-user et déconnectez-le de la machine virtuelle.
    # exit
$ exit

Rubrique parent : bascli dataguard failover

rétablissement dbaascli dataguard

Pour rétablir une base de données en échec en tant que base de données de secours après un basculement, utilisez la commande dataguard reinstate.

Exécutez cette commande en tant qu'utilisateur oracle sur lequel le rétablissement est requis (c'est-à-dire la base de données de secours en échec).

Syntaxe

dbaascli dataguard reinstate --dbname <value> [--primaryDBUniqueName <value>] [--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Où :
  • --dbname indique le nom d'Oracle Database.
  • --primaryDBUniqueName indique le nom unique de la base de données principale en cours dans la configuration Oracle Data Guard.
  • --executePrereqs exécute les vérifications de pré-requis et signale les résultats.
  • --waitForCompletion indique si l'opération doit attendre sa fin. Définissez la valeur sur false pour exécuter l'opération en arrière-plan. Les valeurs valides sont true|false.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.

Pour déterminer quand un membre doit être rétabli dans une configuration Data Guard :

Surveillez la sortie dgmgrl show database pour détecter les erreurs ORA suivantes :

  • Sur le nouveau cluster principal :

    ORA-16661 : La base de données de secours doit être rétablie

  • Sur l'ancien cluster principal :

    ORA-16623 : Le membre a détecté un changement de rôle

Ces messages indiquent qu'un basculement s'est produit. Pour restaurer la synchronisation complète au sein de la configuration Data Guard, l'ancienne instance principale doit être rétablie.

Rubrique parent : Référence des commandes dbaascli

Rétablissement d'une base de données principale en échec à l'aide de l'utilitaire dbaascli

Pour rétablir une base de données principale en échec après un basculement, utilisez la commande dataguard reinstate.

  1. Connectez-vous à l'une des machines virtuelles de la configuration Oracle Data Guard en tant qu'utilisateur oracle.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Lancez le rétablissement de la base de données principale en échec.
    $ dbaascli dataguard reinstate --dbname <db-name>

    Dans une configuration de secours multiple (groupe Data Guard), il est recommandé d'indiquer l'argument --primaryDBUniqueName. 

    dbaascli dataguard reinstate --dbname <db-name> --primaryDBUniqueName <primary-DB-unique-name>
  3. Se déconnecter de la machine virtuelle.
    $ exit

permutation Data Guard de dbaascli

Pour effectuer une permutation vers la base de données de secours, utilisez la commande dataguard switchover.

Exécutez cette commande en tant qu'utilisateur oracle.

Syntaxe

dbaascli dataguard switchover --dbname <value> [--targetStandbyDBUniqueName <value>] [--executePrereqs] [--enableDGDebug] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Où :
  • --dbname indique le nom d'Oracle Database.
  • --targetStandbyDBUniqueName permet d'indiquer le nom unique de l'instance de secours pour remplacer le rôle d'instance de secours par celui d'instance principale.
  • --executePrereqs exécute les vérifications de pré-requis et signale les résultats.
  • --enableDGDebug active les traces pendant l'exécution de l'opération.
  • --waitForCompletion indique si l'opération doit attendre sa fin. Définissez la valeur sur false pour exécuter l'opération en arrière-plan. Les valeurs valides sont true|false.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.

Rubrique parent : Référence des commandes dbaascli

Exécution d'une opération de permutation à l'aide de l'utilitaire dbaascli

Pour effectuer une permutation vers la base de données de secours, utilisez la commande dataguard switchover.

  1. Connectez-vous à la machine virtuelle dans la configuration Oracle Data Guard qui hébergera la nouvelle base de données principale en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande root-user, puis passez à l'utilisateur oracle.
    $ sudo -s
# su - oracle
$
  3. Lancez la permutation vers la base des données de réserve.
    $ dbaascli dataguard switchover --dbname <db-name>

    Dans une configuration de secours multiple (groupe Data Guard), il est recommandé d'indiquer l'argument --targetStandbyDBUniqueName. 

    dbaascli dataguard switchover --dbname <db-name> --targetStandbyDBUniqueName <target-standby-DB-unique-name>
  4. Revenez en tant qu'utilisateur root.
    $ exit
#
  5. Quittez l'interpréteur de commande root-user et déconnectez-le de la machine virtuelle.
    # exit
$ exit

dbaascli dataguard prepareForStandby

Pour créer une base de données de secours Oracle, utilisez la commande dbaascli dataguard prepareForStandby en tant que première étape.

Exécutez cette commande en tant qu'utilisateur root sur la base de données principale. A la fin de l'exécution de la commande, un fichier BLOB de secours est créé. Vous devez copier ce fichier vers le système de base de données de secours pour poursuivre l'étape configureStandby.

Remarque

Pour les configurations de récupération après sinistre sur Exadata Cloud@Customer (ExaDB-C@C), vous devez utiliser la console Oracle Cloud Infrastructure (OCI) ou le kit SDK OCI pour configurer Data Guard. L'utilitaire dbaascli n'est pas pris en charge pour ce cas d'utilisation et ne doit pas être utilisé.

Syntaxe

dbaascli dataguard prepareForStandby --dbname <value> --standbyDBUniqueName <value>  --standbyDBDomain | --noDBDomain  --standbyScanIPAddresses <Standby SCAN IP Addresses> [ --standbyScanPort ] [ --standbyServiceName ] [  -- primaryScanIPAddresses ] [ --primaryScanPort ] [--executePrereqs] [--resume [--sessionID <value>]] [--revert [--sessionID <value>]] [--waitForCompletion] [--skipDRConfiguration]
Où :
  • --dbname indique le nom d'Oracle Database.
  • --standbyDBUniqueName permet d'indiquer le nom unique de l'instance de secours pour laquelle la base de données principale sera configurée.
  • --standbyDBDomain permet d'indiquer le domaine de l'instance de secours pour laquelle la base de données principale sera configurée.
  • --noDBDomain indique de ne pas utiliser le nom de domaine de base de données pour la base de données de secours.
  • --standbyScanIPAddresses indique une liste d'adresses IP séparées par des virgules correspondant au listener SCAN de base de données de secours ou au nom SCAN de la base de données de secours.
  • --standbyScanPort permet d'indiquer le numéro de port SCAN correspondant de la base de données de secours.
  • --standbyServiceName permet d'indiquer le nom du service de base de données de secours pour lequel la base de données principale sera configurée.
  • --primaryScanIPAddresses indique une liste d'adresses IP séparées par des virgules correspondant au listener SCAN de base de données principale ou au nom SCAN de la base de données principale.
  • --primaryScanPort permet d'indiquer le numéro de port SCAN correspondant de la base de données principale.
  • --executePrereqs exécute les vérifications de pré-requis et signale les résultats.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.
  • --revert annule l'opération précédente.
  • --waitForCompletion indique si l'opération doit attendre sa fin. Définissez la valeur sur false pour exécuter l'opération en arrière-plan. Les valeurs valides sont true|false.
  • --skipDRConfiguration indique si la configuration de la récupération après sinistre doit être ignorée dans le cadre de la configuration de la base de données de secours. Valeurs valides : true (ignorer la configuration de récupération après sinistre) ou false (configurer la récupération après sinistre).

Rubrique parent : Référence des commandes dbaascli

Exécution de l'opération PrepareForStandby à l'aide de l'utilitaire dbaascli

Pour préparer la base de données principale à la création d'une base de données de secours, utilisez la commande dbaascli dataguard prepareForStandby.

  1. Connectez-vous à la machine virtuelle sur laquelle vous souhaitez héberger la base de données principale en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande root-user .
    $ sudo -s
  3. Exécutez la commande prepareForStandby. Lorsque vous y êtes invité, entrez le mot du passe SYS.
    dbaascli dataguard prepareForStandby --dbName <db name> --standbyDBUniqueName <standby db unique name> --standbyDBDomain <standby db domain> --standbyScanIPAddresses  <comma-delimieted list of standby SCAN IP addresses> --primaryScanIPAddresses <comma-delimited list of primary SCAN IP addresses> --standbyScanPort <standby SCAN listener port>

    Lorsque vous avez terminé, la commande affiche l'emplacement où le fichier BLOB de secours est créé.

  4. Quittez l'interpréteur de commandes root-user et déconnectez-le de la machine virtuelle.
    #  exit

dbaascli dataguard configureStandby

Pour créer une base de données de secours, utilisez la commande dbaascli dataguard configureStandby comme deuxième étape après l'étape prepareForStandby.

Exécutez-le en tant qu'utilisateur root sur le cluster de secours.

Syntaxe

dbaascli dataguard configureStandby --dbname <value>  --oracleHome <value> | --oracleHomeName <value> --standbyDBUniqueName <value> [--standbyDBDomain <value>] | [--noDBDomain] --primaryScanIPAddresses <value> --primaryScanPort <value> --primaryServiceName <value> --protectionMode <value> --transportType <value> --activeDG <value> [--standbyBlobFromPrimary <value>] | [--standbyDBInfoJsonLocation <value>] [--standbyScanIPAddresses <value>] [--standbyScanPort <value>] [--standbySID <value>] [--nodeList <value>] [--skipAWRConfiguration] [--primaryDBOCID <value>] [--sgaSizeInMB <value>] [--pgaSizeInMB <value>] [--datafileDestination <value>] [--fraDestination <value>] [--redoLogDestination <value>] [--fraSizeInMB <value>] [--tdeKeyStoreType <value> [--tdeKeyOCID <value>]] [--tdeKeyOCID <value>] [--executePrereqs]  [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]] --waitForCompletion <value>] [--enableFIPS <value>] [--skipDRConfiguration] [--okvServer <value> --okvAdminUserName <value> [--okvServerRestPort <value>]] [--okvWalletName <value>]
Où :
  • --dbname indique le nom d'Oracle Database.
  • --oracleHome indique le chemin d'accès au répertoire Oracle Home.
  • --oracleHomeName indique le nom de répertoire de base Oracle.
  • --standbyDBUniqueName indique le nom unique de la base de données de secours.
  • --standbyDBDomain permet d'indiquer le domaine de l'instance de secours pour laquelle la base de données principale sera configurée.
  • --noDBDomain indique de ne pas utiliser le nom de domaine de base de données pour la base de données de secours.
  • --primaryScanIPAddresses indique une liste d'adresses IP séparées par des virgules correspondant au listener SCAN de base de données principale ou au nom SCAN de la base de données principale.
  • --primaryScanPort permet d'indiquer le numéro de port SCAN correspondant du service d'une base de données principale.
  • --primaryServiceName permet d'indiquer le nom du service de base de données principale pour lequel la base de données de secours sera configurée.
  • --protectionMode indique le mode De protection Data Guard à définir lors de la configuration de La base de données de secours. Valeurs valides : MAX_PERFORMANCE|MAX_AVAILABILITY.
  • --transportType indique le type du transport Data Guard à définir lors de l'installation de la base de données de secours. Valeurs valides : ASYNC|SYNC.
  • --activeDG permet d'indiquer si la configuration Data Guard sera active. Les valeurs valides sont true|false.
  • --standbyBlobFromPrimary indique l'emplacement du fichier BLOB de la base de données de secours, préparé à partir de la base de données principale. Requis uniquement pour les opérations de base de données secours.
  • --standbyDBInfoJsonLocation indique l'emplacement du fichier d'informations généré à partir de la base de données principale pour l'export de métadonnées supplémentaires. Cette option est obligatoire uniquement pour les opérations de base de données de secours.
  • --standbyScanIPAddresses indique une liste d'adresses IP séparées par des virgules correspondant au listener SCAN de base de données de secours ou au nom SCAN de la base de données de secours.
  • --standbyScanPort permet d'indiquer le numéro de port SCAN correspondant de la base de données de secours.
  • --standbySID permet d'indiquer le SID de base de données de secours pour la configuration de secours.
  • --nodeList indique la liste des noeuds sur lesquels la base de données de secours doit être exécutée, y compris les noeuds déjà en cours d'exécution ou configurés.
  • --skipAWRConfiguration indique si la configuration Oracle AWR doit être ignorée dans le cadre de la configuration de la base de données de secours. Valeurs valides : true (ignorer la configuration du référentiel AWR) ou false (configurer le référentiel AWR).
  • --primaryDBOCID indique la valeur de l'OCID de ressource correspondant à la base de données principale.
  • --sgaSizeInMB indique la valeur sga_target en Mo.
  • --pgaSizeInMB indique la valeur pga_aggregate_target en Mo.
  • --datafileDestination indique l'emplacement de stockage à utiliser pour les fichiers de données de base de données.
  • --fraDestination indique l'emplacement de stockage à utiliser pour la zone de récupération rapide de base de données.
  • --redoLogDestination indique l'emplacement de stockage à utiliser pour les fichiers de journalisation.
  • --fraSizeInMB indique le nombre de Mo de la taille de la zone.
  • --tdeKeyStoreType indique le type de fichier de clés TDE. Valeurs valides : FILE|KMS|AZURE|GOOGLE|AWS|OKV
  • --tdeKeyOCID indique l'OCID de clé KMS/AZURE/GOOGLE/AWS à utiliser pour TDE. Applicable uniquement si KMS/AZURE/GOOGLE/AWS est sélectionné pour le type de fichier de clés TDE.
  • --executePrereqs exécute les vérifications de pré-requis et signale les résultats.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.
  • --revert annule l'opération précédente.
  • --waitForCompletion indique si l'opération doit attendre sa fin. Définissez la valeur sur false pour exécuter l'opération en arrière-plan. Les valeurs valides sont true|false.
  • --enableFIPS indique si FIPS doit être activé. Définissez cette option sur false pour la désactiver. Les valeurs valides sont true|false.
  • --skipDRConfiguration indique si la configuration de la récupération après sinistre doit être ignorée dans le cadre de la configuration de la base de données de secours. Valeurs valides : true (ignorer la configuration de récupération après sinistre) ou false (configurer la récupération après sinistre).
  • --okvServer indique le serveur Oracle Key Vault. Liste de plusieurs adresses IP séparées par des virgules.
  • --okvAdminUserName indique le nom utilisateur de l'administrateur d'Oracle Key Vault.
  • --okvServerRestPort indique le numéro de port REST pour Oracle Key Vault.
  • --okvWalletName indique le nom de portefeuille Oracle Key Vault.

Rubrique parent : Référence des commandes dbaascli

Exécution de l'opération configureStandby à l'aide de l'utilitaire dbaascli

Pour créer une base de données de secours, utilisez la commande dbaascli dataguard configureStandby.

  1. Connectez-vous à la machine virtuelle où vous souhaitez héberger la base de données de secours en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande root-user .
    $ sudo -s
  3. Exécutez la commande configureStandby.
    dbaascli dataguard configureStandby --standbySID <standby SID> --activeDG <true|false> --dbName <db name> --standbyDBUniqueName <standby db unique name> --standbyScanName <comma-delimited list of standby SCAN IP addresses> --protectionMode <MAX_PERFORMANCE|MAX_AVAILABILITY> --standbyScanPort <standby SCAN port> --oracleHome <oracle home path> --standbyDBDomain <standby db domain name>. --primaryServiceName <primary db service name> --transportType <ASYNC|SYNC> --primaryScanPort <primary db SCAN port> --primaryScanIPAddresses <comma-delimited list primary db SCAN IP addresses> --standbyBlobFromPrimary <standby BLOB from primary>
  4. Entrez les mots de passe SYS, TDE et AWR de la base de données principale lorsque vous y êtes invité.

    Une fois la commande exécutée, la base de données de secours démarre et devient opérationnelle.

dbaascli dataguard registerStandby

Pour inscrire une base de données de secours nouvellement créée auprès de toutes les bases de données de secours existantes et de la base de données principale, utilisez la commande dbaascli dataguard registerStandby comme troisième étape après l'étape configureStandby.

Exécutez cette commande en tant qu'utilisateur root sur le cluster principal. En outre, dans une configuration de plusieurs bases de secours, exécutez la commande sur tous les clusters de secours, à l'exception du cluster de base de données de secours nouvellement créé.

Syntaxe

dbaascli dataguard registerStandby --dbname <value> --standbyDBUniqueName <value>  --standbyDBDomain <value> | --noDBDomain --standbyScanIPAddresses <value> [--standbyScanPort <value>] [--standbyServiceName <value>] [--executePrereqs] [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]] [--waitForCompletion <value>]
Où :
  • --dbname indique le nom d'Oracle Database.
  • --standbyDBUniqueName indique le nom unique d'une base de données de secours à inscrire auprès de la configuration du Broker Oracle Data Guard.
  • --standbyDBDomain permet d'indiquer le domaine de l'instance de secours pour laquelle la base de données principale sera configurée.
  • --noDBDomain indique de ne pas utiliser le nom de domaine de base de données pour la base de données de secours.
  • --standbyScanIPAddresses indique une liste d'adresses IP séparées par des virgules correspondant au listener SCAN de base de données de secours ou au nom SCAN de la base de données de secours.
  • --standbyScanPort permet d'indiquer le numéro de port SCAN correspondant de la base de données de secours.
  • --standbyServiceName permet d'indiquer le nom du service de base de données de secours pour lequel la base de données principale sera configurée.
  • --executePrereqs exécute les vérifications de pré-requis et signale les résultats.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.
  • --revert annule l'opération précédente.
  • --waitForCompletion indique si l'opération doit attendre sa fin. Définissez la valeur sur false pour exécuter l'opération en arrière-plan. Les valeurs valides sont true|false.

Rubrique parent : Référence des commandes dbaascli

Exécution de l'opération registerStandby à l'aide de l'utilitaire dbaascli

Pour inscrire la base de données de secours indiquée auprès de la configuration du broker Oracle Data Guard, utilisez la commande dbaascli dataguard registerStandby.

Dans les cas d'utilisation d'une base de données de secours unique, la commande registerStandby doit être exécutée uniquement sur le cluster principal, car il existe une association un-à-un entre la base de données principale et la base de données de secours.

Toutefois, dans les configurations comportant plusieurs bases de données de secours, vous devez exécuter la commande registerStandby sur le cluster principal et tous les clusters de secours existants, à l'exclusion de la nouvelle base de données de secours en cours d'ajout.

Par exemple, envisagez une configuration avec deux bases de données de secours : stdby1 et stdby2, où stdby2 est la nouvelle base de données de secours à inscrire. Dans ce cas, exécutez la commande registerStandby sur le cluster principal et sur stdby1, mais pas sur stdby2.

En résumé, lors de l'ajout d'une nouvelle base de données de secours à une configuration Oracle Data Guard existante, exécutez la commande registerStandby sur la base principale et sur tous les autres clusters de secours précédemment inscrits, à l'exception de la nouvelle base de données de secours en cours d'ajout.

  1. Connectez-vous au cluster principal de la configuration Data Guard en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande root-user .
    $ sudo -s
  3. Exécutez la commande registerStandby.
    dbaascli dataguard registerStandby --dbname <db-name> --standbyDBUniqueName <standby-DB-unique-name> --standbyDBDomain <standby-DB-domain>

    Une fois la commande exécutée, la base de données de secours indiquée est inscrite auprès de la configuration du broker Oracle Data Guard.

  4. Répétez les étapes 1 à 3, telles qu'elles sont effectuées sur le cluster principal, sur tous les clusters de secours existants de la configuration Oracle Data Guard Broker, à l'exception de celui en cours d'inscription.

dbaascli dataguard deregisterStandby

Lors de la suppression de la base de données de secours, exécutez la commande dbaascli dataguard deregisterStandby avant de supprimer la base de données sur le cluster de secours pour annuler l'inscription de la base de données de secours dans la configuration du broker Oracle Data Guard.

Exécutez cette commande en tant qu'utilisateur root sur le cluster principal. Toutefois, dans le contexte de plusieurs bases de données de secours, cette commande doit être exécutée sur tous les clusters de secours, à l'exception de la base de données de secours cible.

Syntaxe

dbaascli dataguard deregisterStandby --dbname <value> --standbyDBUniqueName <value> [--executePrereqs] [--resume [--sessionID <value>]] [--waitForCompletion <value>]
Où :
  • --dbname indique le nom d'Oracle Database.
  • --standbyDBUniqueName indique le nom unique d'une base de données de secours à désinscrire de la configuration du courtier Oracle Data Guard.
  • --executePrereqs exécute les vérifications de pré-requis et signale les résultats.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.
  • --waitForCompletion indique si l'opération doit attendre sa fin. Définissez la valeur sur false pour exécuter l'opération en arrière-plan. Les valeurs valides sont true|false.

Rubrique parent : Référence des commandes dbaascli

Exécution de l'opération deregisterStandby à l'aide de l'utilitaire dbaascli

Lors de la suppression de la base de données de secours, exécutez la commande dbaascli dataguard deregisterStandby avant de supprimer la base de données sur le cluster de secours pour annuler l'inscription de la base de données de secours dans la configuration du broker Oracle Data Guard.

Dans les cas d'utilisation d'une base de données de secours unique, la commande deregisterStandby doit être exécutée uniquement sur le cluster principal, car il existe une association un-à-un entre la base de données principale et la base de données de secours.

Toutefois, dans les configurations comportant plusieurs bases de données de secours, vous devez exécuter la commande deregisterStandby à la fois sur le cluster principal et sur tous les clusters de secours existants, à l'exception de la base de données de secours en cours de désinscription.

Par exemple, envisagez une configuration avec deux bases de données de secours : stdby1 et stdby2, où stdby2 doit être désinscrit. Dans ce cas, exécutez la commande deregisterStandby sur le cluster principal et sur stdby1, mais pas sur stdby2.

En résumé, lors de la suppression d'une base de données de secours d'une configuration Oracle Data Guard existante, exécutez la commande deregisterStandby sur le cluster de secours principal et sur tous les autres clusters de secours existants avant de supprimer l'opération de base de données sur le cluster de secours souhaité.

  1. Connectez-vous au cluster principal de la configuration Oracle Data Guard en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande root-user .
    $ sudo -s
  3. Exécutez la commande deregisterStandby.
    dbaascli dataguard deregisterStandby --dbname <db-name> --standbyDBUniqueName <standby-DB-unique-name>

    Une fois la commande terminée, la base de données de secours indiquée est désinscrite (supprimée) de la configuration Oracle Data Guard Broker.

  4. Répétez les étapes 1 à 3, telles qu'elles sont effectuées sur le cluster principal, sur tous les clusters de secours existants de la configuration Oracle Data Guard Broker, à l'exception de celui en cours de désinscription.

dbaascli dataguard configureAWR

Pour activer ou désactiver la configuration du référentiel AWR sur la base de données de secours Active Data Guard, utilisez la commande dbaascli dataguard configureAWR.

Exécutez cette commande en tant qu'utilisateur root sur le cluster de secours Active Data Guard où vous souhaitez activer ou désactiver la configuration AWR. Utilisez cette commande si le référentiel AWR n'a pas été configuré pendant le processus d'ajout de secours.

Syntaxe

dbaascli dataguard configureAWR --dbname <value> { --action <value> | --enable | --disable } [--executePrereqs] [--resume [--sessionID <value>]]
Où :
  • --dbname indique le nom d'Oracle Database.
  • --action indique si le référentiel AWR doit être activé ou désactivé. Utilisez --action enable pour activer le référentiel AWR et --action disable pour le désactiver.

    L'argument --action est conservé à des fins de compatibilité descendante. Cependant, il est recommandé d'utiliser --enable ou --disable, car ils fournissent la même fonctionnalité mais sont plus explicites.

  • --executePrereqs exécute les vérifications de pré-requis et signale les résultats.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.

Rubrique parent : Référence des commandes dbaascli

Exécution de l'opération configureAWR à l'aide de l'utilitaire dbaascli

Pour configurer le référentiel AWR sur une base de données de secours ADG, utilisez la commande dbaascli dataguard configureAWR.

  1. Connectez-vous à la machine virtuelle où votre base de données de secours ADG est hébergée en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande root-user .
    $ sudo -s
  3. Exécutez la commande configureAWR.

    Pour activer le référentiel AWR, exécutez :

    $ dbaascli dataguard configureAWR --dbname <db-name> --enable

    Pour désactiver le référentiel AWR, exécutez :

    $ dbaascli dataguard configureAWR --dbname <db-name> --disable
  4. Entrez les mots de passe SYS et AWR lorsque vous y êtes invité.

    Une fois la commande exécutée, la base de données de secours ADG aurait été configurée avec le référentiel AWR

dbaascli dataguard updateConfiguration

Pour mettre à jour le mode de transport ou de protection, ou les deux, paramètres d'un environnement Data Guard, utilisez la commande dbaascli dataguard updateConfiguration.

Exécutez cette opération en tant qu'utilisateur root.

Lorsque la commande Mettre à jour le mode de transport est exécutée sur la base principale, seul le mode de transport de la base principale est mis à jour. Pour mettre à jour le mode de transport d'une base de données de secours, la commande doit être exécutée séparément sur cette base.

En revanche, lorsque la commande de mise à jour du mode de protection est exécutée sur la base de données principale, le mode de protection est mis à jour pour les bases de données principale et de secours. Le mode de protection peut également être mis à jour du côté de la base de données de secours, auquel cas les bases de données principale et de secours sont mises à jour.

Lors de la mise à jour du mode de transport ou de protection à partir de la base de données principale, le système vérifie les modes en cours sur les bases de données principale et de secours et procède à la mise à jour uniquement si toutes les conditions requises sont remplies.

Syntaxe

dbaascli dataguard updateConfiguration --dbname <value> [--protectionMode <value>] [--transportType <value>] [--standbyDGType <value>] [--executePrereqs] [--resume [--sessionID <value>]] [--waitForCompletion <value>]
Où :
  • --dbname indique le nom d'Oracle Database.
  • --protectionMode indique le mode De protection Data Guard à définir lors de la configuration de La base de données de secours. Valeurs valides : MAX_PERFORMANCE|MAX_AVAILABILITY.
  • --transportType indique le type du transport Data Guard à définir lors de l'installation de la base de données de secours. Valeurs valides : ASYNC|SYNC.
  • --standbyDGType indique le type Data Guard de la base de données de secours à définir. Valeurs valides : ADG|DG.
  • --executePrereqs exécute les vérifications de pré-requis et signale les résultats.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.
  • --waitForCompletion indique si l'opération doit attendre sa fin. Définissez la valeur sur false pour exécuter l'opération en arrière-plan. Les valeurs valides sont true|false.

Rubrique parent : Référence des commandes dbaascli

Exécution de l'opération updateConfiguration à l'aide de l'utilitaire dbaascli

Pour mettre à jour le mode de transport et le mode de protection, ou les deux, utilisez la commande dbaascli dataguard updateConfiguration.

  1. Connectez-vous à la machine virtuelle où votre base de données de secours ADG est hébergée en tant qu'utilisateur opc.

    Pour obtenir des instructions détaillées, reportez-vous à Connexion à une machine virtuelle avec SSH.

  2. Démarrez un shell de commande root-user .
    $ sudo -s
  3. Exécutez la commande updateConfiguration.
    $ dbaascli dataguard updateConfiguration --dbname <db-name> --protectionMode MAX_PERFORMANCE|MAX_AVAILABILITY --transportType ASYNC|SYNC --standbyDGType ADG|DG.

    Une fois la commande exécutée, Data Guard indiqué est configuré avec le mode de transport ou de protection indiqué.

dbaascli dbhome create

Pour créer un répertoire de base de base de données Oracle de la version de votre choix, utilisez la commande dbaascli dbhome create.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli dbhome create --version <value>
[--oracleHome <value>]
[--oracleHomeName <value>]
[--enableUnifiedAuditing <value>] 
[--imageTag <value>]
[--ImageLocation <value>
Où :
  • --version indique la version du répertoire de base Oracle sous la forme de cinq segments numériques séparés par des points. Par exemple : 19.12.0.0.0.
  • --oracleHome indique l'emplacement du répertoire de base Oracle.
  • --oracleHomeName indique le nom du répertoire de base Oracle défini par l'utilisateur. S'il n'est pas fourni, le nom par défaut est utilisé.
  • --enableUnifiedAuditing indique true ou false pour activer ou désactiver l'option de lien d'audit unifié dans le répertoire de base Oracle.
  • --imageTag indique la balise d'image du répertoire de base Oracle.
  • --imageLocation indique le chemin de l'image à utiliser.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true ou false.

Exemple 6-24 dbaascli dbhome create

dbaascli dbhome create --version 19.11.0.0.0

Vous pouvez également utiliser dbaascli dbhome create --version 19.8.0.0.0.0 --imageTag 19.8.0.0.0 pour les cas où les balises d'image sont différentes de la version.

dbaascli dbHome delete

Pour supprimer un répertoire de base de base de données Oracle particulier, utilisez la commande dbaascli dbHome delete.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli dbHome delete 
{ --oracleHome <value> 
| --oracleHomeName <value> } [--resume [--sessionID <value>]]
Où :
  • --oracleHome indique l'emplacement du répertoire de base Oracle.
  • --oracleHomeName indique le nom du répertoire de base Oracle.
  • --resume reprend l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.

dbaascli dbhome getDatabases

Pour visualiser des informations sur toutes les bases de données Oracle exécutées à partir d'un répertoire de base de base de données Oracle particulier, utilisez la commande dbaascli dbHome getDatabases. Indiquez l'emplacement ou le nom du répertoire de base Oracle.

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli dbHome getDatabases
{ --oracleHomeName value | --oracleHome value }
Où :
  • --oracleHomeName indique le nom du répertoire de base Oracle défini par l'utilisateur.
  • --oracleHome indique l'emplacement (chemin) du répertoire de base Oracle.

Exemple 6-25 dbaascli dbHome getDatabases --oracleHome

dbaascli dbHome getDatabases --oracleHome /u02/app/mar_home/

dbaascli dbHome getDetails

Pour afficher les informations relatives à un répertoire de base Oracle spécifique, utilisez la commande dbaascli dbHome getDetails. Indiquez l'emplacement ou le nom du répertoire de base Oracle.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli dbHome getDetails
{ --oracleHomeName value | --oracleHome value }
Où :
  • --oracleHomeName indique le nom du répertoire de base Oracle défini par l'utilisateur.
  • --oracleHome indique l'emplacement du répertoire de base Oracle.

Exemple 6-26 dbaascli dbHome getDetails : utilisation de l'emplacement du répertoire de base Oracle

dbaascli dbHome getDetails --oracleHome /u02/app/home_db19c/

Exemple 6-27 dbaascli dbHome getDetails : utilisation du nom du répertoire de base Oracle

dbaascli dbHome getDetails --oracleHomeName home_db19c

dbaascli dbHome patch

Pour appliquer des patches à un répertoire de base Oracle d'un niveau de patch vers un autre, utilisez la commande dbaascli dbHome patch.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

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>]
[--nonRolling] 
[--skipDatapatchForDB <value>]
Où :
  • --oracleHome indique le chemin du répertoire de base Oracle.
  • --oracleHomeName indique le nom du répertoire de base Oracle.
  • --targetVersion indique la version cible du répertoire de base Oracle sous la forme de cinq segments numériques séparés par des points. Par exemple : 19.12.0.0.0.
  • --resume reprend l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --continueWithDbDowntime poursuit l'application des patches avec un temps d'inactivité de la base de données. Cette option peut être utilisée dans des environnements dans lesquels une seule instance active est démarrée et dans lesquels l'opération d'application de patches peut être poursuivie même avec un temps d'inactivité.
  • --skipUnreachableNodes ignore l'opération sur les noeuds inaccessibles.
  • --nodes indique une liste de noeuds séparés par des virgules si l'application de patches doit être effectuée sur un sous-ensemble de noeuds.
  • --executePrereqs exécute les prérequis.
  • --skipDatapatch ignore l'exécution de datapatch sur les bases de données.
  • --imageFilePath indique le chemin absolu du fichier image à utiliser.
  • --skipPDBs ignore l'exécution de datapatch sur la liste de bases de données pluggables séparées par des virgules qui est indiquée. Par exemple : cdb1:pdb1,cdb2:pdb2, etc.
  • --skipClosedPdbs ignore l'exécution de datapatch sur les bases de données pluggables fermées.
  • --rollback annule l'application des patches au répertoire de base Oracle.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.
  • --drainTimeoutInSeconds indique la durée (en secondes) nécessaire à la purge de ressource lors de l'arrêt de la base de données
  • --skipUnreachableNodes ignore l'opération sur les noeuds inaccessibles.
  • [--nonRolling] applique des patches au répertoire de base de base de données sur tous les noeuds en parallèle. Notez que cela entraînerait un temps d'arrêt dans la base de données.
  • [--skipDatapatchForDB <value>] ignore l'exécution de datapatch sur la liste de bases de données séparées par des virgules indiquée. Exemple : db1,db2,db3...

Exemple 6-28 dbaascli dbhome patch

dbaascli dbhome patch --targetVersion 19.10.0.0.0 --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2

dbaascli dbimage purge

La commande dbimage purge enlève l'image logicielle indiquée de l'environnement Exadata Cloud Infrastructure.

Connectez-vous au noeud de calcul en tant qu'utilisateur opc et exécutez cette commande en tant qu'utilisateur root. 

# dbaascli dbimage purge --version software_version --bp software_bp [--cdb ( yes | no )]

Dans la commande précédente :

  • software_version indique la version du logiciel Oracle Database. Par exemple : 11204, 12102, 12201, 18000, 19000.

  • software_bp identifie la version du package de patches. Par exemple, APR2018, JAN2019, OCT2019, etc.

  • --cdb indique au besoin si une image logicielle prenant en charge l'architecture colocative Oracle doit être enlevée. La valeur par défaut est yes. Si vous spécifiez --cdb no, l'image logicielle qui contient des fichiers binaires pour la prise en charge des bases de données non Conteneur est enlevée.

Si la commande doit enlever une image logicielle qui n'est pas disponible pour l'instant dans la bibliothèque d'images logicielles et ne peut donc pas être téléchargée à nouveau, elle met l'opération en pause et vous invite à la confirmer.

Vous ne pouvez enlever l'image logicielle par défaut en cours d'aucune version logicielle. Pour éviter cette restriction, vous devez définir une autre image logicielle comme image par défaut.

dbaascli diag collect

Pour collecter des diagnostics, utilisez la commande dbaascli diag collect.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli diag collect [--components <value>] [--startTime <value>] [--endTime <value>] [--nodes <value>] [--dbNames <value>]
        {
            [--objectStoreBucketUri <value>]
            | [--destLocation <value>]
        }
        [--waitForCompletion <value>]
Où :
  • --components indique la liste des composants pour la collecte de journaux.

    Valeurs valides :

    • db
    • gi
    • os
    • dbaastools
    • all
  • --startTime indique l'heure de début de la collecte de journaux. Format de date et d'heure valide : YYYY-MM-DDTHH24:MM:SS.
  • --endTime indique l'heure de fin de la collecte de journaux. Format de date et d'heure valide : YYYY-MM-DDTHH24:MM:SS.
  • --nodes indique la liste des noeuds, séparés par des virgules, pour la collecte des journaux.
  • --dbNames indique le nom de la base de données pour laquelle collecter les journaux. Vous ne pouvez indiquer qu'un seul nom de base de données.
  • --objectStoreBucketURI indique une URL de demande préauthentifiée de service Object Storage utilisée pour télécharger les journaux collectés. Les journaux sont collectés à partir de la machine virtuelle invitée. Pour plus d'informations, reportez-vous à Utilisation de demandes pré-authentifiées.
  • --destLocation indique l'emplacement sur la machine virtuelle invitée pour collecter les journaux. Valeur par défaut : /var/opt/oracle/dbaas_acfs.
  • --waitForCompletion. Valeurs : true|false. Valeur par défaut : true. Indiquez false pour exécuter la commande en arrière-plan.

dbaascli diag healthCheck

Pour exécuter des vérifications de l'état de diagnostic, utilisez la commande dbaascli diag healthCheck.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli diag healthCheck
[--destLocation]
[--nodes]
[--objectStoreBucketURI]
Où :
  • --destLocation indique l'emplacement sur la machine virtuelle invitée pour collecter les journaux. Valeur par défaut : /var/opt/oracle/dbaas_acfs.
  • --nodes indique la liste des noeuds, séparés par des virgules, pour la collecte des journaux.
  • --objectStoreBucketURI indique une URL de demande préauthentifiée de service Object Storage utilisée pour télécharger les journaux collectés. Les journaux sont collectés à partir de la machine virtuelle invitée. Pour plus d'informations, reportez-vous à Utilisation de demandes pré-authentifiées.

dbaascli gridHome create

Pour configurer le répertoire de base Grid Infrastructure, utilisez la commande dbaascli gridHome create.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli gridHome create --version value [--resume [--sessionID value]] [--waitForCompletion value]
Où :
  • --version indique la version du répertoire de base Grid.
  • --resume reprend l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.

dbaascli grid configureTCPS

Afin de configurer TCPS pour le cluster existant, utilisez la commande dbaascli grid configureTCPS.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

Remarque

Par défaut, TCPS est activé pour les bases de données sur des systèmes Oracle Exadata Database Service on Dedicated Infrastructure.
Remarque

TCPS n'est pas activé pour les bases de données sur des systèmes Exadata Database Service on Cloud@Customer. Afin d'activer TCPS pour une base de données en particulier, mettez à jour le fichier sqlnet.ora propre à la base de données avec WALLET_LOCATION = (SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=/var/opt/oracle/dbaas_acfs/grid/tcps_wallets))) sur tous les noeuds de la base de données, puis redémarrez la base de données. Cette opération active l'utilisation de TCPS pour la base de données. Toutefois, l'activation de TCPS entraîne l'échec de la connexion à ZDLRA. Sur les systèmes Exadata Database Service on Cloud@Customer, vous pouvez activer soit la configuration ZDLRA, soit la configuration TCPS. L'activation simultanée de ZDLRA et de TCPS ne fonctionne pas. 
dbaascli grid configureTCPS
[--pkcs12WalletPath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Où :
  • --pkcs12WalletPath indique le chemin du certificat, au format de portefeuille pkcs12.
  • --caCertChain est la liste concaténée de certificats contenant les certificats d'autorité de certification intermédiaires et racine.
  • --precheckOnly indique yes afin d'exécuter uniquement les prévérifications pour cette opération. Valeurs valides : yes ou no.
  • --serverCert indique le chemin du certificat PEM à utiliser ou devant fait l'objet d'une rotation pour la configuration TCPS.
  • --privateKey indique le chemin du fichier de clés privées du certificat.
  • --certType indique le type du certificat à ajouter au portefeuille Grid Infrastructure. Les valeurs acceptées sont : SELF_SIGNED_CERT, CA_SIGNED_CERT ou PKCS12_CERT. Valeur par défaut : SELF_SIGNED_CERT.
  • --privateKeyPasswordProtected indique si la clé privée est protégée par un mot de passe ou non. Valeurs valides : true ou false. Valeur par défaut : true.

Exemple 6-29 dbaascli grid configureTCPS

Pour configurer une grille à l'aide d'un certificat auto-signé, exécutez la commande suivante :
dbaascli grid configureTCPS
Pour configurer une grille à l'aide d'un certificat signé par une autorité de certification, exécutez la commande suivante :
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 patch

Pour appliquer les patches de la version mineure indiquée à Oracle Grid Infrastructure, utilisez la commande dbaascli grid patch.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

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>]

Où :

  • --targetVersion indique la version cible du répertoire de base Oracle sous la forme de cinq segments numériques séparés par des points (par exemple : 19.12.0.0.0).
  • --targetHome indique le chemin qualifié complet du répertoire de base Grid Infrastructure cible pour l'application de patches sans réutilisation de la mémoire.
  • --containerURL indique l'URL personnalisée pour l'extraction de l'image Grid Infrastructure.
  • --executePrereqs est une option permettant d'exécuter les prérequis.
  • --nodeList indique une liste de noeuds séparés par des virgules si l'application de patches doit être effectuée sur un sous-ensemble de noeuds.
  • --patchInParallel indique d'appliquer des patches aux noeuds distants en parallèle
  • --rollback indique que l'application des patches au répertoire de base Oracle doit être annulée.
  • --resume reprend l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --continueWithDbDowntime poursuit l'application des patches avec un temps d'inactivité de la base de données. Cette option peut être utilisée dans des environnements dans lesquels une seule instance active est démarrée et dans lesquels l'opération d'application de patches peut être poursuivie même avec un temps d'inactivité.
  • --drainTimeoutInSeconds indique la durée (en secondes) nécessaire à la purge de ressource lors de l'arrêt de la base de données.
  • --createImage crée une image à partir d'une copie du répertoire de base Grid actif, à laquelle les patches de la version cible spécifiée ont été appliqués.
    • --createImageDir indique le chemin qualifié complet du répertoire dans lequel l'image doit être créée.
  • --imageFile indique le chemin qualifié complet de l'image à utiliser.
  • --patchInParallel effectue l'application de patches aux noeuds distants en parallèle
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.

Exemple 6-30 dbaascli grid patch

dbaascli grid patch --targetVersion 19.12.0.0.0

dbaascli grid removeTCPSCert

Pour enlever des certificats TCPS existants du portefeuille Grid Infrastructure, utilisez la commande dbaascli grid removeTCPSCert.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli grid removeTCPSCert --subject <value>
 {
   --userCert | --trustedCert | --requestedCert
 }
 [--serialNumber <value>] [--executePrereqs] [--resume [--sessionID <value>]] [--bounceListeners]
Où :
  • --subject indique le sujet du certificat.
  • Indicateur --userCert permettant d'indiquer le certificat utilisateur
  • Indicateur --trustedCert permettant d'indiquer le certificat sécurisé
  • Indicateur --requestedCert permettant d'indiquer le certificat demandé
  • --serialNumber indique le numéro de série du certificat.
  • --executePrereqs exécute les vérifications de prérequis et signale les résultats.
  • --resume reprend l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • Indicateur --bounceListeners permettant d'arrêter et de redémarrer le listener et le listener d'analyse Grid Infrastructure

dbaascli grid rotateTCPSCert

Pour effectuer la rotation des certificats TCPS, utilisez la commande dbaascli grid rotateTCPSCert.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli grid rotateTCPSCert
[--pkcs12WalletPath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Où :
  • --pkcs12WalletPath indique le chemin du certificat, au format de portefeuille pkcs12.
  • --caCertChain est la liste concaténée de certificats contenant les certificats d'autorité de certification intermédiaires et racine.
  • --precheckOnly indique yes afin d'exécuter uniquement les prévérifications pour cette opération. Valeurs valides : yes ou no.
  • --serverCert indique le chemin du certificat PEM à utiliser ou devant fait l'objet d'une rotation pour la configuration TCPS.
  • --privateKey indique le chemin du fichier de clés privées du certificat.
  • --certType indique le type du certificat à ajouter au portefeuille Grid Infrastructure. Les valeurs acceptées sont : SELF_SIGNED_CERT, CA_SIGNED_CERT ou PKCS12_CERT. Valeur par défaut : SELF_SIGNED_CERT.
  • --privateKeyPasswordProtected indique si la clé privée est protégée par un mot de passe ou non. Valeurs valides : true ou false. Valeur par défaut : true.

Exemple 6-31 dbaascli grid rotateTCPSCert

Pour effectuer la rotation d'un certificat auto-signé (option par défaut), exécutez la commande suivante :
dbaascli grid rotateTCPSCert
Pour effectuer la rotation d'un certificat signé par une autorité de certification, exécutez la commande suivante :
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

Pour mettre à niveau Oracle Grid Infrastructure d'une version majeure vers une autre, utilisez la commande dbaascli grid upgrade.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli grid upgrade --version
[--resume]
[--executePrereqs]
[--containerURL]
[--softwareOnly]
[--targetHome]
[--revert]
Où :
  • --version indique la version cible.
  • --resume reprend l'exécution précédente.
  • --executePrereqs exécute les prérequis pour la mise à niveau de Grid Infrastructure.
  • --containerUrl indique l'URL personnalisée pour l'extraction de l'image Grid Infrastructure.
  • --softwareOnly installe uniquement le logiciel Grid Infrastructure.
  • --targetHome indique le chemin du répertoire de base Grid cible existant.
  • --revert annule une exécution ayant échoué.

Exemple 6-32 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

dbaascli job getStatus

Pour afficher le statut d'un travail indiqué, utilisez la commande dbaascli job getStatus.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli job getStatus --jobID
Où :
  • --jodID indique l'ID du travail.

Exemple 6-33 dbaascli job getStatus

dbaascli job getStatus --jobID 13c82031-f202-41b7-9aef-f4a71df0f551
DBAAS CLI version MAIN
Executing command job getStatus --jobID 13c82031-f202-41b7-9aef-f4a71df0f551
{
  "jobId" : "13c82031-f202-41b7-9aef-f4a71df0f551",
  "status" : "Success",
  "message" : "database create job: Success",
  "createTimestamp" : 1628095442431,
  "updatedTime" : 1628095633660,
  "description" : "Service job report for operation database create",
  "appMessages" : {
    "schema" : [ ],
    "errorAction" : "SUCCEED_AND_SHOW"
  },
  "resourceList" : [ ],
  "pct_complete" : "100"
}

dbaascli patch db apply

Remarque

Les commandes dbaascli patch db prereq et dbaascli patch db apply sont en phase d'abandon dans dbaascli version 21.2.1.2.0, et remplacées par les commandes dbaascli grid patch, dbaascli dbhome patch et dbaascli database move.
Pour plus d'informations, reportez-vous à :
  • dbaascli grid patch
  • dbaascli dbhome patch
  • dbaascli database move
  • Application de patches à Oracle Grid Infrastructure et aux bases de données Oracle à l'aide de dbaascli

dbaascli patch db prereq

Remarque

Les commandes dbaascli patch db prereq et dbaascli patch db apply sont en phase d'abandon dans dbaascli version 21.2.1.2.0, et remplacées par les commandes dbaascli grid patch, dbaascli dbhome patch et dbaascli database move.
Pour plus d'informations, reportez-vous à :
  • dbaascli grid patch
  • dbaascli dbhome patch
  • dbaascli database move
  • Application de patches à Oracle Grid Infrastructure et aux bases de données Oracle à l'aide de dbaascli

dbaascli pdb backup

Pour sauvegarder une base de données pluggable, interroger des sauvegardes de base de données pluggable et supprimer une sauvegarde de base de données pluggable, utilisez la commande dbaascli pdb backup.

Prérequis

  • Exécutez la commande en tant qu'utilisateur root.

Syntaxe

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>]
        }
Où :
--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.]

Exemple 6-34 Exemples

  • Pour effectuer une sauvegarde de niveau 1 d'une base de données pluggable pdb1 dans une base de données Conteneur myTestDb, exécutez la commande suivante :
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --start --level1
  • Pour interroger le statut de la demande de sauvegarde de base de données pluggable soumise avec l'uuid eef16b26361411ecb13800163e8e4fac, exécutez la commande suivante :
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --status --uuid eef16b26361411ecb13800163e8e4fac

dbaascli pdb bounce

Pour redémarrer une base de données pluggable, utilisez la commande dbaascli pdb bounce.

Prérequis

Exécutez la commande en tant qu'utilisateur oracle.

Syntaxe

dbaascli pdb bounce
	{
            --pdbName <value>
            | --pdbUID <value>
        }
        --dbname <value> [--openMode <value>] [--startServices <value>] [--waitForCompletion <value>]
Où :
  • --pdbName indique le nom de la base de données pluggable.
  • --pdbUID indique l'identificateur de la base de données pluggable.
  • --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable.
  • --openMode indique le paramètre OPEN MODE cible de la base de données pluggable.
  • --startServices indique de démarrer tous les services correspondant à une base pluggable ou d'en répertorier tous. Les valeurs acceptées sont all et une liste de services de base de données pluggable séparés par des virgules.
  • --waitForCompletion indique d'exécuter l'opération au premier plan ou en arrière-plan. Valeurs valides : true|false.

Exemple 6-35 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
Facultatif :
  • --openMode READ_WRITE
  • --openMode READ_ONLY

dbaascli pdb close

Pour fermer une base de données pluggable, utilisez la commande dbaascli pdb close.

Prérequis

Exécutez la commande en tant qu'utilisateur oracle.

Syntaxe

dbaascli pdb close
        {
            --pdbName <value>
            | --pdbUID <value>
        }
        --dbname <value> [--waitForCompletion <value>]
Où :
  • --pdbname indique le nom de la base de données pluggable à fermer.
  • --pdbUID indique l'identificateur de la base de données pluggable.
  • --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable.
  • --waitForCompletion indique d'exécuter l'opération au premier plan ou en arrière-plan. Valeurs valides : true|false.

Une fois la commande exécutée, la base de données pluggable est fermée sur toutes les instances de la base de données Conteneur.

Exemple 6-36 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 getConnectString

Afin d'afficher les informations de chaîne de connexion Oracle Net pour une base de données pluggable, exécutez la commande dbaascli pdb getConnectString.

Prérequis

Exécutez la commande en tant qu'utilisateur oracle.

Syntaxe

dbaascli pdb getConnectString --dbname <value>
        {
            --pdbName <value>
            | --pdbUID <value>
        }
Où :
  • --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable.
  • --pdbname indique le nom de la base de données pluggable pour laquelle afficher les informations de chaîne de connexion.
  • --pdbUID indique l'identificateur de la base de données pluggable.

Exemple 6-37 dbaascli pdb getConnectString

dbaascli pdb getConnectString --dbname dbname --pdbName pdbName

dbaascli pdb create

Pour créer une base de données pluggable, utilisez la commande dbaascli pdb create.

Prérequis

Exécutez la commande en tant qu'utilisateur oracle.

Syntaxe

dbaascli pdb create --pdbName <value> --dbName <value> [--maxCPU <value>] [--maxSize <value>] [--pdbAdminUserName <value>] [--lockPDBAdminAccount <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--waitForCompletion <value>]
        {
            [--blobLocation <value>]
            | [--standbyBlobFromPrimary <value>]
        }
        [--pdbTdeKeyVersionOCID <value>]
Où :
  • --pdbName indique le nom de la base de données pluggable à créer.
  • --dbName indique le nom de la base de données Conteneur hébergeant la nouvelle base de données pluggable.
  • --maxCPU (facultatif) indique le nombre maximal d'UC disponibles pour la base de données pluggable. Définir cette option équivaut à définir le paramètre CPU_COUNT dans la base de données pluggable
  • --maxSize (facultatif) indique la taille totale maximale des fichiers de données et des fichiers temporaires pour les tablespaces appartenant à la base de données pluggable. Définir cette option équivaut à définir la clause de stockage MAXSIZE PDB dans la commande SQL CREATE PLUGGABLE DATABASE. Pour imposer une limite, vous pouvez indiquer un entier suivi d'une unité de taille (K, M, G ou T). Vous pouvez aussi indiquer UNLIMITED afin de n'imposer aucune limite.
  • --pdbAdminUserName indique le nouveau nom de l'administrateur de la base de données pluggable.
  • --lockPDBAdminAccount indique true ou false pour le verrouillage du compte de l'administrateur de la base de données pluggable. La valeur par défaut est True.
  • --resume reprend l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --executePrereqs indique yes afin d'exécuter uniquement les prérequis pour cette opération. Valeurs valides : yes ou no.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true ou false.
  • --blobLocation indique l'emplacement du répertoire personnalisé où le fichier BLOB de secours sera généré dans un environnement DG.
  • --standbyBlobFromPrimary indique l'emplacement du fichier BLOB de secours, préparé à partir de la base de données principale. Requis uniquement pour les opérations de base de données pluggable de la base de données de secours.
    Remarque

    Les paramètres blobLocation et standbyBlobFromPrimary s'excluent mutuellement.
  • --pdbTdeKeyVersionOCID

Pendant le processus de création de la base de données pluggable, vous êtes invité à indiquer le mot de passe d'administration relatif à la nouvelle base de données pluggable.

Exemple 6-38 dbaascli pdb create

Pour créer une base de données pluggable à partir d'une valeur prédéfinie dans une base de données standard dans un environnement non Data Guard, exécutez la commande suivante :
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --maxsize 5G --maxcpu 2
Pour créer une base de données pluggable dans un environnement Data Guard, exécutez la commande suivante :
dbaascli pdb create --dbName db721 --pdbName new_pdb1
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --standbyBlobFromPrimary /tmp/send_db721.tar

dbaascli pdb delete

Pour supprimer une base de données pluggable, exécutez la commande dbaascli pdb delete.

Prérequis

Exécutez la commande en tant qu'utilisateur oracle.

Syntaxe

dbaascli pdb delete --dbName <value>
        {
            --pdbName <value>
            | --pdbUID <value>
        }
        [--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]] [--allStandbyPrepared] [--cleanupRelocatedPDB]
Où :
  • --dbName indique le nom de la base de données Conteneur qui héberge la base de données pluggable.
  • --pdbName indique le nom de la base de données pluggable à supprimer.
  • --pdbUID indique l'UID de la base de données pluggable à supprimer.
  • --executePrereqs indique yes afin d'exécuter uniquement les prérequis pour cette opération. Valeurs valides : yes ou no.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true ou false.
  • --resume indique de reprendre l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --allStandbyPrepared indique que l'opération a été exécutée sur toutes les bases de données de secours.
  • --cleanupRelocatedPDB est uneoption permettant de nettoyer la base de donnés source après un transfert d'une base de donnée pluggable.
Exemple : dbaascli pdb delete

Pour supprimer une base de données pluggable d'une base de données standard dans un environnement non Data Guard ou d'une base de données de secours dans un environnement Data Guard : 

dbaascli pdb delete --dbName db721 --pdbName pdb1

Pour créer une base de données pluggable à partir de la base de données principale dans un environnement Data Guard : 

dbaascli pdb create --dbName db721 --pdbName pdb1 --allStandbyPrepared

dbaascli pdb getDetails

Pour afficher les détails d'une base de données pluggable, utilisez la commande dbaascli pdb getDetails.

Prérequis

Exécutez la commande en tant qu'utilisateur oracle.

Syntaxe

dbaascli pdb getDetails --dbname <value>
        {
            --pdbName <value>
            | --pdbUID <value>
        }
Où :
  • --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable.
  • --pdbname indique le nom de la base de données pluggable à supprimer.
  • --pdbUID indique l'identificateur de la base de données pluggable.

Exemple 6-39 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

Pour afficher la liste des bases de données pluggables dans une base de données Conteneur, utilisez la commande dbaascli pdb list.

Prérequis

Exécutez la commande en tant qu'utilisateur oracle.

Syntaxe

dbaascli pdb list --dbname
Où :
  • --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable.

Exemple 6-40 dbaascli pdb list

dbaascli pdb list --dbname cdb name

dbaascli pdb localClone

Pour créer une base de données pluggable en tant que clone d'une base de données pluggable existante dans la même base de données Conteneur, utilisez la commande dbaascli pdb localClone.

Prérequis

Exécutez la commande en tant qu'utilisateur oracle.

Syntaxe

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>]
    {
      [--createFromSnapshot
        {
          --snapshotName <value>
          | --snapshotUID <value>
        }
        [--copyDataFiles]]
      | [--snapshot]
    }
Où :
  • --pdbName indique le nom de la base de données pluggable à cloner.
  • --dbName indique le nom de la base de données.
  • --targetPDBName indique le nom de la base de données pluggable cible (nouvelle base de données pluggable clonée).
  • --powerLimit indique le degré de parallélisme à utiliser pour l'opération de clonage. La valeur valide est comprise entre 1 et 128.
  • --maxCPU indique le nombre maximal d'UC à allouer pour la base de données pluggable.
  • --maxSize indique la taille de stockage maximale en Go pour la nouvelle base de données pluggable.
  • --resume reprend l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --executePrereqs indique yes afin d'exécuter uniquement les prérequis pour cette opération. Valeurs valides : yes ou no.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true ou false.
  • --blobLocation indique l'emplacement du répertoire personnalisé où le fichier BLOB de secours sera généré dans un environnement DG
  • --standbyBlobFromPrimary indique l'emplacement du fichier BLOB de secours, préparé à partir de la base de données principale. Requis uniquement pour les opérations de base de données pluggable de la base de données de secours.
    Remarque

    Les paramètres --blobLocation et --standbyBlobFromPrimary s'excluent mutuellement.
  • --excludeUserTablespaces est l'option permettant d'ignorer les tablespaces utilisateur (par exemple, t1,t2,t3).
  • --excludePDBData indique true/yes pour ignorer les données utilisateur de la bases de données pluggable source.
  • --pdbAdminUserName indique le nouveau nom de l'administrateur de la base de données pluggable.
  • --lockPDBAdminAccount indique true ou false pour le verrouillage du compte de l'administrateur de la base de données pluggable. La valeur par défaut est True.
  • --sourcePDBServiceConvertList indique la liste des noms de service source vers la cible, séparés par des virgules, qui doivent être convertis. La syntaxe est source_srv1:new_srv1,source_srv2:new_srv2.
  • --createFromSnapshot | --snapshot
    • --createFromSnapshot permet de créer une base Conteneur à partir d'un cliché de base pluggable

      --snapshotName | --snapshotUID

      • --snapshotName indique le nom de cliché pour créer une base pluggable à partir d'une base de données pluggable.
      • --snapshotUID indique l'UID de cliché pour créer une base pluggable à partir d'une base de données pluggable.

      --copyDataFiles permet d'ignorer la copie de cliché.

    • --snapshot permet de créer une base de données pluggable avec une copie de cliché.

La base de données pluggable récemment clonée hérite des mots de passe d'administration de la base de données pluggable source.

Exemple 6-41 dbaascli pdb localClone

dbaascli pdb localClone --dbName db35 --pdbName PDB35 --targetPDBName local_clone1 --maxCPU 2 --maxSize 15

dbaascli pdb open

Pour ouvrir une base de données pluggable, utilisez la commande dbaascli pdb open.

Exécutez la commande en tant qu'utilisateur root ou oracle.

Syntaxe

dbaascli pdb open
        {
            --pdbName <value>
            | --pdbUID <value>
        }
        --dbname <value> [--openMode <value>] [--startServices <value>] [--waitForCompletion <value>] [--setPDBRefreshModeNone [--skipPDBRefresh] [--pdbAdminUserName <value>]] [--executePrereqs] [--resume [--sessionID <value>]] [--blobLocation <value>]
Où :
  • --pdbName indique le nom de la base de données pluggable à ouvrir.
  • --pdbUID indique l'identificateur de la base de données pluggable.
  • --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable.
  • --openMode indique le paramètre OPEN MODE cible de la base de données pluggable.
  • --startServices indique de démarrer ou de répertorier tous les services correspondant à une base de données pluggable. Les valeurs acceptées sont all et une liste de services de base de données pluggable séparés par des virgules.
  • --waitForCompletion : indiquez false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.
  • --setPDBRefreshModeNone indique de convertir une base de données pluggable actualisable en base de données pluggable non actualisable.
    • --skipPDBRefresh indique d'ignorer l'actualisation de base de données pluggable actualisable.
    • --pdbAdminUserName: indique le nouveau nom de l'administrateur de la base de données pluggable.
  • --executePrereqs indique d'exécuter les vérifications de prérequis et de rapporter les résultats.
  • --resume reprend l'opération précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --blobLocation indique l'emplacement de répertoire personnalisé où le fichier BLOB de secours sera généré dans un environnement Data Guard.

Une fois la commande exécutée, la base de données pluggable est ouverte sur toutes les instances de la base de données Conteneur.

Exemple 6-42 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

Facultatif : --openMode READ_WRITE/READ_ONLY.

dbaascli pdb recover

Pour récupérer une base de données pluggable, utilisez la commande dbaascli pdb recover.

Prérequis

  • Exécutez la commande en tant qu'utilisateur root.
  • La base de données doit être configurée avec des détails de destination de stockage de sauvegarde pour l'emplacement de stockage des sauvegardes.

Syntaxe

dbaascli pdb recover --dbname <value> --pdbName <value>
        {
            --start
                {
                    --untilTime <value> [--nonUTC]
                    | --untilSCN <value>
                    | --latest
                    | --tag <value>
                }
            | --status --uuid <value>
        }

Où :

  • --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable.
  • --pdbName indique le nom de la base de données pluggable à récupérer.
  • --start permet de commencer la récupération d'une base pluggable.
    • --untilTime récupère la base de données pluggable jusqu'à ce que le temps soit écoulé. format d'entrée : DD-MON-YYYY HH24:MI:SS ;
    • --untilSCN permet de récupérer la base de données pluggable jusqu'au numéro SCN
    • --latest permet de récupérer le dernier état connu de la base pluggable
    • --tag récupère la base de données pluggable vers la balise d'archivage
  • --status affiche les détails d'un processus d'un travail de récupération d'une base de données pluggable
    • --uuid identificateur unique de l'opération de récupération de base de données pluggable. Format d'entrée : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx,

Exemple 6-43 Exemples

  • Pour récupérer une base de données pluggable pdb1 dans une base de données Conteneur myTestDb à son dernier état connu, exécutez la commande suivante :
    dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --start --latest
  • Pour interroger le statut de la demande de récupération de base de données pluggable soumise avec l'uuid 81a17352362011ecbc3000163e8e4fac, exécutez la commande suivante :
    dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --status --uuid 81a17352362011ecbc3000163e8e4fac

dbaascli pdb refresh

Pour actualiser une base de données pluggable, utilisez la commande dbaascli pdb refresh.

Exécutez la commande en tant qu'utilisateur root ou oracle.

Syntaxe

dbaascli pdb refresh --dbname <value>
        {
            --pdbName <value>
            | --pdbUID <value>
        }
        [--waitForCompletion <value>]

Où :

  • --dbname: indique le nom de la base de données Oracle
  • --pdbName : indique le nom de la base de données pluggable
  • --pdbUID : indique l'identificateur de la base de données pluggable
  • --waitForCompletion : indiquez false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.

dbaascli pdb relocate

Pour transférer la base de données pluggable indiquée de la base de données distante vers la base de données locale, utilisez la commande dbaascli pdb relocate.

Prérequis

Exécutez la commande en tant qu'utilisateur oracle. Lorsque vous y êtes invité, vous devez fournir le mot de passe de l'utilisateur SYS pour la base de données source.

Syntaxe

dbaascli pdb relocate --pdbName <value> --dbName <value> --sourceDBConnectionString <value> [--targetPDBName <value>] [--powerLimit <value>] [--maxCpu <value>] [--maxSize <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--sourcePDBServices <value>] [--sourcePDBReadOnlyServices <value>] [--relocateAvailabilityType <value>] [--waitForCompletion <value>]
        {
            [--blobLocation <value>]
            | [--standbyBlobFromPrimary <value>]
        }
        [--upgradePDB] [--updateDBBlockCacheSize]
        {
            [--skipOpenPDB [--enableRefreshMode --refreshMode <value> [--refreshIntervalInMinutes <value>]]]
            | [--completePDBRelocate]
        }
        {
            [--dblinkUsername <value> [--honorCaseSensitiveUserName]]
            | [--dbLinkName <value>]
        }
Où :
  • --pdbName indique le nom de la base de données pluggable source à transférer.
  • --dbName indique le nom de la base de données cible.
  • --sourceDBConnectionString indique la chaîne de connexion à la base de données source au format <nom_scan>:<port_scan>/<nom_service_de_base_de_données>.
  • --targetPDBName indique le nom de la base de données pluggable cible (nouvelle base de données pluggable transférée).
  • --powerLimit indique le degré de parallélisme à utiliser pour l'opération de transfert.
  • --maxCpu indique le nombre maximal d'UC à allouer pour la base de données pluggable.
  • --maxSize indique la taille de stockage maximale en Go pour la nouvelle base de données pluggable.
  • --resume indique de reprendre l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --executePrereqs indique yes afin d'exécuter uniquement les prérequis pour cette opération. Valeurs valides : yes|no.
  • --sourcePDBServices indique la liste des services de la base de données pluggable source, séparés par des virgules.
  • --sourcePDBReadOnlyServices indique la liste des services en lecture seule de la base de données pluggable source, séparés par des virgules.
  • --relocateAvailabilityType indique la disponibilité MAX|NORMAL pour activer la transmission des connexions du processus d'écoute.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.
  • --blobLocation indique le répertoire personnalisé où le fichier BLOB de secours sera généré dans un environnement DG.
  • --standbyBlobFromPrimary indique l'emplacement du fichier BLOB de la base de données de secours, préparé à partir de la base de données principale. Requis uniquement pour les opérations de base de données secours.
    Remarque

    Les paramètres --blobLocation et --standbyBlobFromPrimary s'excluent mutuellement.
  • --upgradePDB indique true pour mettre à niveau la base de données pluggable dans le cadre de cette opération. Valeurs valides : true | false.
  • --updateDBBlockCachesize indique que l'application peut définir les paramètres d'initialisation db block cache size afin de prendre en charge la copie des données avec des tailles de bloc différentes.
  • --skipOpenPDB indique que la base de données pluggable ne doit pas être ouverte à la fin de l'opération en cours.
    • --enableRefreshMode indique d'activer la prise en charge de l'actualisation de base de données pluggable dans la première étape de transfert de base de données pluggable.
      • --refreshMode indique le mode d'actualisation pour la base pluggable actualisable. Valeurs valides : AUTO|MANUAL
        • --refreshIntervalInMinutes indique l'intervalle d'actualisation pour refreshablePDB en minutes.
  • --completePDBRelocate permet d'effectuer l'opération de transfert de la Base de données pluggable si cette opération est réalisée en deux phases.

Exemple 6-44 dbaascli pdb relocate

dbaascli pdb relocate --sourceDBConnectionString test-scan.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521/source_cdb_service_name --pdbName source_pdb --dbName target_db

dbaascli pdb remoteClone

Pour créer une base de données pluggable en tant que clone d'une base de données pluggable existante dans une autre base de données Conteneur, utilisez la commande dbaascli pdb remoteClone.

Exécutez la commande en tant qu'utilisateur root ou oracle.

Syntaxe

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>] [--upgradePDB]
        {
            [--createFromSnapshot --snapshotName <value> [--copyDataFiles]]
            | [--snapshot]
        }
        [--refreshablePDB --refreshMode <value> [--refreshIntervalInMinutes <value>]] [--updateDBBlockCacheSize]
        {
            [--dblinkUsername <value> [--honorCaseSensitiveUserName]]
            | [--dbLinkName <value>]
        }
        [--keepSourceDBServices <value>]
Où :
  • --pdbName indique le nom de la base de données pluggable source à cloner.
  • --dbname indique le nom (DB_NAME) de la base de données Conteneur qui héberge la base de données pluggable récemment clonée.
  • --sourceDBConnectionString indique la chaîne de connexion à la base de données source au format nom_scan:port_scan/nom_service_de_base_de_données
  • --targetPDBName indique le nom de la base de données pluggable cible (nouvelle base de données pluggable clonée).
  • --powerLimit indique le degré de parallélisme à utiliser pour l'opération de clonage. La valeur valide est comprise entre 1 et 128.
  • --maxCPU indique le nombre maximal d'UC à allouer pour la base de données pluggable.
  • --maxSize indique la taille de stockage maximale en Go pour la nouvelle base de données pluggable.
  • --resume reprend l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --executePrereqs indique yes afin d'exécuter uniquement les prérequis pour cette opération. Valeurs valides : yes ou no.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true ou false.
  • --sourcePDBExportedTDEKeyFile indique le fichier de clés exporté de la base de données pluggable source. Cette variable est applicable uniquement aux bases de données de version 12.1.
  • --blobLocation indique le chemin personnalisé où le fichier BLOB de secours sera généré dans un environnement Data Guard.
  • --standbyBlobFromPrimary indique l'emplacement du fichier BLOB de secours, préparé à partir de la base de données principale. Requis uniquement pour les opérations de base de données pluggable de la base de données de secours.
    Remarque

    Les paramètres --blobLocation et --standbyBlobFromPrimary s'excluent mutuellement.
  • --excludeUserTablespaces est une option permettant d'ignorer les tablespaces utilisateur (par exemple, t1,t2,t3).
  • --excludePDBData indique true/yes pour ignorer les données utilisateur de la base de données pluggable source.
  • --pdbAdminUserName indique le nouveau nom de l'administrateur de la base de données pluggable.
  • --lockPDBAdminAccount indique true ou false pour le verrouillage du compte de l'administrateur de la base de données pluggable. La valeur par défaut est True.
  • --sourcePDBServiceConvertList indique la liste des noms de service, séparés par des virgules, qui doivent être convertis de la source vers la cible. La syntaxe est la suivante : source_srv1:new_srv1, source_srv2:new_srv2.
  • --upgradePDB indique que la base de données pluggable doit être mise à niveau pour cette opération
  • --createFromSnapshot | --snapshot
    • --createFromSnapshot permet de créer une base Conteneur à partir d'un cliché de base pluggable
      • --snapshotName indique le nom de cliché pour créer une base pluggable à partir d'une base de données pluggable.

      --copyDataFiles permet d'ignorer la copie de cliché.

    • --snapshot permet de créer une base de données pluggable avec une copie de cliché.
  • --refreshablePDB indique qu'une base de données pluggable actualisable doit être créée.
    • --refreshMode indique le mode d'actualisation pour la base de données pluggable actualisable. Valeurs valides : AUTO|MANUAL
      • --refreshIntervalInMinutes indique l'intervalle d'actualisation pour refreshablePDB en minutes.
    • --dblinkUsername indique l'utilisateur commun d'une base de données distante, permettant au lien de base de données de se connecter à la base de données distante.
      • --honorCaseSensitiveUserName indique que le nom utilisateur spécifié fait la distinction entre les majuscules et les minuscules.
  • --dbLinkName indique le nom d'un lien de base de données existant dans la base de données cible, qui pointe vers la base de données distante

Lorsque vous y êtes invité, vous devez fournir le mot de passe utilisateur SYS pour la base de données pluggable source. La base de données pluggable récemment clonée hérite des mots de passe d'administration de la base de données pluggable source. La base de données pluggable clonée est nommée selon le format suivant : dbname_sourcepdbname. Cette commande est prise en charge uniquement pour les bases de données qui ne sont pas dans une configuration Data Guard et qui utilisent Oracle Database version 12.2.0.1 ou ultérieure.

Exemple 6-45 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 system getDBHomes

Pour afficher les informations relatives à tous les répertoires de base Oracle, utilisez la commande dbaascli system getDBHomes.

Prérequis

Exécutez la commande en tant qu'utilisateur root ou oracle.

Syntaxe

dbaascli system getDBHomes

Exemple 6-46 dbaascli system getDBHomes

dbaascli system getDBHomes

dbaascli system getGridHomes

Pour répertorier les détails de tous les répertoires de base Grid, utilisez la commande dbaascli system getGridHomes.

Prérequis

Exécutez la commande en tant qu'utilisateur root ou oracle.

Syntaxe

dbaascli system getGridHomes

dbaascli tde changePassword

Afin de modifier le mot de passe du fichier de clés TDE et le mot de passe du portefeuille de base de données pour l'alias tde_ks_passwd, utilisez la commande dbaascli tde changePassword.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli tde changePassword [--dbname <value>]
  {            [--prepareStandbyBlob <value> [--blobLocation <value>]]
               | [--standbyBlobFromPrimary <value>]
  }
  [--resume [--sessionID <value>]]
Où :
  • --dbname indique le nom de la base de données.
  • --prepareStandbyBlob indique true pour générer un fichier BLOB contenant les artefacts nécessaires à l'exécution de l'opération dans un environnement DG.
  • --blobLocation indique le chemin personnalisé où le fichier BLOB de secours sera généré dans un environnement DG.
  • --standbyBlobFromPrimary indique l'emplacement du fichier BLOB de secours, préparé à partir de la base de données principale. Requis uniquement pour les opérations de base de données secours.
  • --resume indique de reprendre l'exécution précédente.
  • --sessionID indique de reprendre un ID de session spécifique.
Pour modifier le mot de passe TDE dans un environnement non Data Guard :
dbaascli tde changepassword --dbname
      <dbname>
Pour modifier le mot de passe TDE dans un environnement Data Guard, procédez comme suit :
  1. Modifiez le mot de passe TDE dans la base de données principale.
    dbaascli tde changepassword --dbname
      <dbname> --prepareStandbyBlob true --blobLocation
      <Location where blob file has to be generated>
  2. Copiez le fichier BLOB de secours créé vers l'environnement de base de données de secours.
  3. Modifiez le mot de passe TDE dans la base de données de secours.
    dbaascli tde changepassword --dbname
     <dbname> --standbyBlobFromPrimary <Location of blob generated from
    primary>

dbaascli tde addSecondaryHsmKey

Pour ajouter une clé HSM (KMS) secondaire à la configuration HSM (KMS) existante, utilisez la commande dbaascli tde addSecondaryHsmKey.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli tde addSecondaryHsmKey --dbname <value> --secondaryKmsKeyOCID <value>
[--executePrereqs]
Où :
  • --secondaryKmsKeyOCID indique la clé KMS secondaire à ajouter à la configuration HSM (KMS) existante.
  • --dbname indique le nom de la base de données.
  • --executePrereqs exécute les vérifications de prérequis et signale les résultats.

Exemple 6-47 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 enableWalletRoot

Afin d'activer le paramètre SPFILE wallet_root pour la base de données existante, utilisez la commande dbaascli tde enableWalletRoot.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli tde enableWalletRoot --dbname <value>
[--dbRestart <value>]
[--executePrereqs]
[--resume [--sessionID <value>]]
Où :
  • --dbname indique le nom de la base de données Oracle.
  • --dbrestart indique l'option de redémarrage de la base de données. Valeurs valides : rolling ou full. Valeur par défaut : rolling

    Si vous ne transmettez pas l'argument dbrestart, la base de données redémarre en mode non simultané (rolling).

  • --precheckOnly exécute uniquement la prévérification pour cette opération. Valeurs valides : yes ou no.
  • --resume permet de reprendre l'exécution précédente.
  • --sessionID indique de reprendre un ID de session spécifique.

Exemple 6-48 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

Pour crypter tous les tablespaces dans la base de données pluggable indiquée, utilisez la commande dbaascli tde encryptTablespacesInPDB.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli tde encryptTablespacesInPDB --pdbName
[--dbname]
[--precheckOnly]
[--useSysdbaCredential]
Où :
  • --pdbName indique le nom de la base de données pluggable pour le cryptage de tous les tablespaces.
  • --dbname indique le nom de la base de données Oracle.
  • --precheckOnly exécute uniquement la prévérification pour cette opération. Valeurs valides : yes ou no.
  • --useSysdbaCredential utilise les informations d'identification SYSDBA pour cette opération si la valeur transmise est true. Valeurs valides : true ou false.

Exemple 6-49 dbaascli tde encryptTablespacesInPDB

dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb
dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb --precheckOnly yes
dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb --useSysdbaCredential true

dbaascli tde fileToHsm

Pour convertir un cryptage transparent des données basé sur FILE en cryptage transparent des données basé sur HSM (KMS/OKV), utilisez la commande dbaascli tde fileToHsm.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli tde fileToHsm --kmsKeyOCID <value> --dbname <value> 
[--skipPatchCheck <value>] 
[--executePrereqs ] 
[--primarySuc <value>]
{
    [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]]
}
[--waitForCompletion <value>]
Où :
  • --kmsKeyOCID indique l'OCID de clé KMS à utiliser pour le cryptage transparent des données. Applicable uniquement si KMS est sélectionné pour le cryptage transparent des données.
  • --dbname indique le nom de la base de données.
  • --skipPatchCheck ignore la vérification de validation pour les patches requis si la valeur transmise pour cet argument est true. Valeurs valides : true ou false.
  • --executePrereqs exécute les vérifications de prérequis et signale les résultats.
  • --primarySuc est la propriété à indiquer dans la base de données de secours de l'environnement Data Guard une fois que la commande a été exécutée sur la base de données principale.
  • --resume indique de reprendre l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --revert indique d'annuler l'exécution précédente.
    • --sessionID indique qu'un ID de session spécifique doit être annulé.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.

Exemple 6-50 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

Pour obtenir les détails de la clé active TDE, utilisez la commande dbaascli tde getHsmKeys.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli tde getHsmKeys
[--dbname]
[--infoFile]
Où :
  • --dbname indique le nom de la base de données.
  • --infoFile indique le chemin du fichier dans lequel la liste des OCID sera enregistrée. La sortie est au format JSON.

Exemple 6-51 dbaascli tde getHsmKeys

dbaascli tde getHsmkeys --dbname dbname
dbaascli tde getHsmkeys --dbname dbname --infoFile infoFilePath

dbaascli tde getMkidForKeyVersionOCID

Pour obtenir l'ID de clé maître associé à l'OCID de version de clé KMS, utilisez la commande dbaascli tde getMkidForKeyVersionOCID.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli tde getMkidForKeyVersionOCID --kmsKeyVersionOCID <value>
[--dbname <value>]
[--waitForCompletion <value>]
Où :
  • --kmsKeyVersionOCID indique l'OCID de version de clé KMS à définir.
  • --dbname indique le nom de la base de données.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.

Exemple 6-52 dbaascli tde getMkidForKeyVersionOCID

dbaascli tde getMkidForKeyVersionOCID --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha

dbaascli tde getPrimaryHsmKey

Pour obtenir la clé HSM (KMS) primaire de la configuration HSM (KMS) existante, utilisez la commande dbaascli tde getPrimaryHsmKey.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli tde getPrimaryHsmKey
[--dbname]
Où :
  • --dbname indique le nom de la base de données.

Exemple 6-53 dbaascli tde getPrimaryHsmKey

dbaascli tde getPrimaryHsmKey --dbname dbname

dbaascli tde hsmToFile

Pour convertir un cryptage transparent des données basé sur HSM (KMS/OKV) en cryptage transparent des données basé sur FILE, utilisez la commande dbaascli tde hsmToFile.

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli tde hsmToFile 
[--dbname <value>] 
{
    [--prepareStandbyBlob <value> [--blobLocation <value>]
   | [--standbyBlobFromPrimary <value>]
}
] 
[--skipPatchCheck <value>] 
[--executePrereqs ] 
[--primarySuc <value>] 
{
     [--resume [--sessionID <value>]] |
     [--revert [--sessionID <value>]]
} 
[--waitForCompletion <value>]
Où :
  • --dbname indique le nom de la base de données.
  • --prepareStandbyBlob indique true pour générer un fichier BLOB contenant les artefacts nécessaires à l'exécution de l'opération dans un environnement DG.
  • --blobLocation indique l'emplacement du répertoire personnalisé où le fichier BLOB de secours sera généré dans un environnement DG
  • --standbyBlobFromPrimary indique l'emplacement du fichier BLOB de secours, préparé à partir de la base de données principale. Requis uniquement pour les opérations de base de données de secours.
  • --skipPatchCheck ignore la vérification de validation pour les patches requis si la valeur transmise pour cet argument est true. Valeurs valides : true ou false.
  • --executePrereqs exécute les vérifications de prérequis et signale les résultats.
  • --primarySuc est la propriété à indiquer dans la base de données de secours de l'environnement Data Guard une fois que la commande a été exécutée sur la base de données principale.
  • --resume reprend l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --revert indique d'annuler l'exécution précédente.
    • --sessionID indique qu'un ID de session spécifique doit être annulé.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.

Exemple 6-54 dbaascli tde hsmToFile

dbaascli tde hsmToFile --dbname dbname
dbaascli tde hsmToFile --dbname dbname --executePrereqs
dbaascli tde hsmToFile --dbname dbname --resume

dbaascli tde listKeys

Pour répertorier les clés maître TDE, utilisez la commande dbaascli tde listKeys.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli tde listKeys
[--dbname <value>]
[--infoFilePath <value>]
Où :
  • --dbname indique le nom de la base de données.
  • --infoFilePath indique le chemin absolu du fichier dans lequel les résultats sont enregistrés.

Exemple 6-55 dbaascli tde listKeys

dbaascli tde listKeys --dbname dbname
dbaascli tde listKeys --dbname dbname --infoFilePath infoFilePath

dbaascli tde removeSecondaryHsmKey

Pour enlever une clé HSM (KMS) secondaire de la configuration HSM (KMS) existante, utilisez la commande dbaascli tde removeSecondaryHsmKey.

Prérequis

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli tde removeSecondaryHsmKey --dbname <value>
[--confirmDeletion]
[--secondaryKmsKeyOCID]
[--executePrereqs]
Où :
  • --dbname indique le nom de la base de données.
  • --confirmDeletion : si non indiqué, l'utilisateur sera invité à effectuer une action lors de la suppression de toutes les clés HSM(KMS) existantes.
  • --secondaryKmsKeyOCID indique la clé KMS secondaire à enlever de la configuration HSM (KMS) existante. Si aucune valeur n'est indiquée, toutes les clés KMS secondaires sont enlevées.
  • --executePrereqs exécute les vérifications de prérequis et signale les résultats.

FAQ

Q : Quel est le but de la commande dbaascli tde removeSecondaryHsmKey ?

R : La commande dbaascli tde removeSecondaryHsmKey permet de supprimer une clé de module de sécurité matériel (HSM) secondaire de la configuration HSM (KMS) existante dans un environnement Oracle Database.

Q : Quels sont les prérequis pour exécuter la commande dbaascli tde removeSecondaryHsmKey ?

R : Vous devez :
  • Exécutez la commande en tant qu'utilisateur root.
  • Connectez-vous à une machine virtuelle Exadata Cloud Infrastructure à l'aide de SSH.

Q : Que fait le paramètre --force dans la commande dbaascli tde removeSecondaryHsmKey ?

R : Le paramètre --force permet de supprimer la clé HSM secondaire sans inviter l'utilisateur à confirmer. S'il n'est pas indiqué, la commande invitera l'utilisateur à le supprimer.

Q : Que précise le paramètre --secondaryKmsKeyOCID ?

R : Le paramètre --secondaryKmsKeyOCID indique l'OCID (identificateur Oracle Cloud) de la clé KMS secondaire à enlever de la configuration HSM existante.

Q : Que fait le paramètre --dbname ?

R : Le paramètre --dbname indique le nom de la base de données pour laquelle la clé HSM secondaire est en cours de suppression.

Q : Quel est le but du paramètre --precheckOnly ?

R : Le paramètre --precheckOnly, s'il est défini sur yes, exécute uniquement les prévérifications pour valider la préparation de l'opération de suppression sans enlever réellement la clé HSM secondaire. Si elle est définie sur no, l'opération de suppression complète est effectuée.

Q : Le paramètre --force est-il obligatoire ?

R : Non, le paramètre --force est facultatif. S'il n'est pas spécifié, le système invite l'utilisateur à confirmer avant de poursuivre la suppression de la clé.

Q : Le paramètre --secondaryKmsKeyOCID est-il obligatoire ?

R : Oui, vous devez fournir --secondaryKmsKeyOCID pour identifier la clé HSM secondaire spécifique à enlever de la configuration.

Q : Le paramètre --dbname est-il obligatoire ?

R : Non, le paramètre --dbname est facultatif. S'il n'est pas spécifié, la commande tente de supprimer la clé HSM secondaire de la base de données par défaut sur le système.

Q : Que dois-je faire si je veux supprimer la clé HSM secondaire sans invite utilisateur ?

R : Vous devez utiliser le paramètre --force pour ignorer l'invite de confirmation et enlever directement la clé HSM secondaire :

dbaascli tde removeSecondaryHsmKey --force --secondaryKmsKeyOCID <value>

Q : Comment puis-je tester si le système est prêt à supprimer la clé HSM secondaire sans la supprimer réellement ?

R : Vous pouvez utiliser le paramètre --precheckOnly défini sur Oui pour effectuer une prévérification :

dbaascli tde removeSecondaryHsmKey --precheckOnly yes --secondaryKmsKeyOCID <value>

Q : Que se passe-t-il si je ne fournis pas de nom de base de données avec --dbname ?

R : si le paramètre --dbname n'est pas spécifié, la commande tente de supprimer la clé HSM secondaire de la base de données par défaut configurée sur le système.

Q : Que dois-je vérifier si la commande ne parvient pas à supprimer la clé HSM secondaire ?

A : Assurez-vous que :
  • Vous exécutez la commande en tant qu'utilisateur root.
  • Vous êtes connecté à la machine virtuelle Exadata Cloud Infrastructure.
  • Les valeurs --secondaryKmsKeyOCID et --dbname correctes sont fournies. Pour plus de détails sur l'échec, consultez les messages d'erreur et les journaux.

Q : Que dois-je faire si l'opération de retrait échoue en partie ?

R : Si l'opération échoue, consultez les journaux d'erreurs et essayez d'exécuter la commande avec --precheckOnly pour vous assurer que le système est prêt pour l'opération. Si nécessaire, corrigez les éventuels problèmes avant de réessayer.

Q : Puis-je exécuter la commande dbaascli tde removeSecondaryHsmKey pendant que la base de données est en cours d'exécution ?

R : Oui, la commande peut être exécutée pendant que la base de données est en cours d'exécution, car elle ne nécessite pas l'arrêt de la base de données.

Q : Quel est le but de la suppression d'une clé HSM secondaire ?

R : La suppression d'une clé HSM secondaire est généralement effectuée lorsque la clé n'est plus nécessaire ou lorsque vous souhaitez gérer les clés de cryptage utilisées dans votre configuration TDE (Transparent Data Encryption).

Q : Comment me connecter à la machine virtuelle Exadata Cloud Infrastructure pour exécuter la commande ?

R : Vous pouvez vous connecter à la machine virtuelle à l'aide de SSH. Pour obtenir des instructions sur l'établissement d'une connexion sécurisée, reportez-vous à la documentation sur Exadata Cloud Infrastructure.

Exemple 6-56 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

Permet d'effectuer une rotation de la clé maître pour le cryptage de base de données.

Prérequis :

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

(Facultatif) <Saisissez les informations de syntaxe ici.>

dbaascli tde rotateMasterKey --dbname <value> 
[--rotateMasterKeyOnAllPDBs] 
[--pdbName <value>] 
[--executePrereqs] 
[--resume [--sessionID <value>]]
{
     [--prepareStandbyBlob <value> [--blobLocation <value>]]
     | [--standbyBlobFromPrimary <value>]
 }
Où :
  • --dbname est le nom de la base de données Oracle.
  • --rotateMasterKeyOnAllPDBs indique true pour effectuer la rotation de la clé maître de toutes les bases de données pluggables de la base de données Conteneur. Valeurs valides : true|false.
  • --pdbName indique le nom de la base de données pluggable.
  • --executePrereqs exécute les vérifications de prérequis et signale les résultats.
  • --resume indique de reprendre l'exécution précédente.
  • --sessionID indique de reprendre un ID de session spécifique.
  • --prepareStandbyBlob | --standbyBlobFromPrimary]
  • --prepareStandbyBlob indique true pour générer un fichier BLOB contenant les artefacts nécessaires à l'exécution de l'opération dans un environnement DG.
  • --blobLocation indique l'emplacement du répertoire personnalisé où le fichier BLOB de secours sera généré dans un environnement DG.
  • --standbyBlobFromPrimary indique l'emplacement du fichier BLOB de secours, préparé à partir de la base de données principale. Requis uniquement pour les opérations de base de données secours

dbaascli tde setKeyVersion

Pour définir la version de la clé primaire à utiliser dans la base de données, la base de données Conteneur ou la base de données pluggable, utilisez la commande dbaascli tde setKeyVersion.

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <value>
[--pdbName <value>]
[--masterKeyID <value>]
[--standbySuc]
[--executePrereqs]
[--waitForCompletion <value>]
Où :
  • --kmsKeyVersionOCID indique l'OCID de version de clé KMS à définir.
  • --dbname indique le nom de la base de données.
  • --pdbName indique le nom de la base de données pluggable devant utiliser l'OCID de version de clé.
  • --masterKeyID indique l'ID de clé maître de l'OCID de version de clé donné. Applicable à l'environnement Data Guard.
  • --standbySuc est la propriété à indiquer dans la base de données principale de l'environnement Data Guard une fois que la commande a été exécutée sur la base de données de secours.
  • --executePrereqs exécute les vérifications de prérequis et signale les résultats.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.

Exemple 6-57 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

Pour modifier la clé HSM (KMS) primaire de la configuration HSM (KMS) existante, utilisez la commande dbaascli tde setPrimaryHsmKey.

Exécutez la commande en tant qu'utilisateur root.

Syntaxe

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <value> --dbname <value>
[--allStandbyPrepared]
[--bounceDatabase]
[--executePrereqs]
[--resume [--sessionID <value>]]
Où :
  • --primaryKmsKeyOCID indique la clé KMS primaire à définir.
  • --dbname indique le nom de la base de données.
  • --allStandbyPrepared indique que l'opération a été exécutée sur toutes les bases de données de secours.
  • --bounceDatabase est un indicateur spécifiant d'effectuer un redémarrage de la base de données en mode non simultané pour cette opération.
  • --executePrereqs exécute les vérifications de prérequis et signale les résultats.
  • --resume permet de reprendre l'exécution précédente.
  • --sessionID indique de reprendre un ID de session spécifique.

Exemple 6-58 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

Afin d'afficher les informations relatives au fichier de clés pour la base de données spécifiée, utilisez la commande dbaascli tde status.

Prérequis

Remarque

La commande dbaascli tde status est en phase d'abandon dans dbaascli version 24.4.1.0.0. Oracle recommande d'utiliser la commande dbaascli database getDetails à la place.

Exécutez la commande en tant qu'utilisateur oracle.

Syntaxe

dbaascli tde status --dbname dbname
Où :
  • --dbname indique le nom de la base de données à vérifier.

La sortie de la commande inclut le type et le statut du fichier de clés.

Exemple 6-59 dbaascli tde status

dbaascli tde status --dbname dbname