Documentation sur Oracle Cloud Infrastructure

Utilisation de l'utilitaire dbaascli sur Exadata Cloud Infrastructure

Voyez comment utiliser l'utilitaire dbaascli sur Exadata Cloud Infrastructure.

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

À propos de l'utilisation de l'utilitaire dbaascli sur Exadata Cloud Infrastructure

L'utilitaire dbaascli vous permet d'effectuer différentes opérations de cycle de vie et d'administration 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 enfichables, etc.

Vous devez utiliser la console ou l'interface de ligne de commande Oracle Cloud Infrastructure pour ajuster les ressources. Les fonctions de l'utilitaire dbaascli complètent et se distinguent de celles de la console, de l'API ou de l'interface de ligne de commande. Sauf indication contraire, vous devez disposer de l'accès root à dbaascli pour exécuter toutes les commandes d'administration.

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

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

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

Voir Informations de référence sur les commandes dbasscli dans la documentation pour obtenir des commandes et des informations spécifiques sur les commandes.

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

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

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

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

Pour produire une liste des versions prises en charge disponibles pour l'application de correctifs, utilisez la commande dbaascli cswlib showImages.

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

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

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli cswlib showImages --product database

    La sortie de commande répertorie les images logicielles disponibles pour Oracle Database.

    dbaascli cswlib showImages --product grid

    La sortie de commande répertorie les images logicielles disponibles pour Oracle Grid Infrastructure.

  4. Quittez l'interpréteur de commandes de l'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, voir 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 du répertoire de base Oracle Database

Pour créer un répertoire de base Oracle Database avec la version voulue, utilisez la commande dbaascli dbhome create.

Note

Vous pouvez créer un répertoire de base de base de données Oracle avec un nom de répertoire de base Oracle spécifié. Si vous ne spécifiez pas de valeur, cela est calculé automatiquement (recommandé).
  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

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

  2. Démarrez un interpréteur de commandes en tant qu'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 spécifie le marqueur d'image de l'image à utiliser
    Par exemple :
    dbaascli dbhome create --version 19.9.0.0.0
    Note

    La spécification de imageTag est facultative. Pour voir les marqueurs d'image, consultez la commande dbaascli cswlib showImages. Les marqueurs d'image sont généralement identiques à la version de la base de données. Toutefois, cette disposition est prévue 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 l'interpréteur de commandes de l'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, voir dbaascli dbhome create.

Création d'une base de données Oracle dans le répertoire de base Oracle Database spécifié

Pour créer une base de données Oracle Database dans le répertoire de base Oracle Database spécifié, 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 enfichables
  • Créer une base de données Oracle avec le jeu de caractères spécifié
  • Créer des bases de données Oracle dans un sous-ensemble de noeuds de grappe
    Note

    Les bases de données créées sur un sous-ensemble de noeuds ne seront pas affichées dans la console OCI.
  • Créez la version 12.1.0.2 ou une version supérieure d'Oracle Database avec la version JAN 2021 ou une version supérieure. Pour les bases de données avec des versions inférieures, il est recommandé d'utiliser l'API basée sur la console OCI.
  1. Connectez-vous à la machine virtuelle en tant qu'utilisateur opc.

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

  2. Démarrez un interpréteur de commandes en tant qu'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

    À l'invite, entrez les mots de passe sys et tde.

  4. Quittez l'interpréteur de commandes de l'utilisateur root :
    exit

    Pour plus de détails sur les options prises en charge avancées, voir dbaascli database create.

Rubriques connexes

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

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

Pour exécuter les vérifications des préalables, utilisez l'option de commande --executePrereqs. Cela n'effectuera que les vérifications préalables sans effectuer la création réelle de la base de données Oracle.

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

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

  2. Démarrez un interpréteur de commandes en tant qu'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 l'interpréteur de commandes de l'utilisateur root :
    exit

    Pour plus de détails sur les options prises en charge avancées, voir dbaascli database create.

Reprise ou annulation de l'opération de création d'une 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
Note

  • Lors de l'utilisation des options de commande --resume ou --revert, assurez-vous d'utiliser la même commande à partir du même noeud qui a été utilisé pour le flux d'opération de création réel.
  • Vous ne pouvez reprendre la création de la base de données que si l'étape de post-création a échoué.

Modification des mots de passe de base de données

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

Le mot de passe que vous avez spécifié dans le champ Mot de passe de l'administrateur de base de données lors de la création d'une nouvelle instance ou base de données Exadata Cloud Infrastructure est défini en tant que mot de passe pour les données d'identification d'administrateur SYS, SYSTEM, de portefeuille TDE et de base de données enfichable. Utilisez les procédures suivantes si vous devez modifier les mots de passe d'une base de données existante.

Note

Si vous activez Data Guard pour une base de données, les mots de passe SYS et portefeuille TDE des bases de données principale et de secours doivent tous être identiques.
Note

L'utilisation de dbaascli pour modifier le mot de passe SYS garantira que l'automatisation de la sauvegarde/restauration peut paralléliser les canaux sur tous les noeuds de la grappe.

Pour modifier le 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'opc.
  2. Exécutez la commande suivante :
    sudo dbaascli database changepassword --dbname database_name --user SYS

Pour modifier les 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éé dans toutes les bases de données de secours et mettez à jour la propriété de fichier à 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>

Pour modifier le 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'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 lister et télécharger les images logicielles de base de données Oracle dans une instance Exadata Cloud Infrastructure, qui peuvent ensuite être utilisées pour provisionner un répertoire de base de base de données.

Note

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 le service de stockage d'objets et peuvent être utilisées pour provisionner un répertoire de base de base de données dans votre instance Exadata. Voir Images logicielles Oracle Database pour plus d'informations.

Vous pouvez contrôler la version des binaires Oracle installés lorsque vous provisionnez une nouvelle base de données sur une instance Exadata Cloud Infrastructure en conservant les images logicielles dans le système. Oracle fournit une bibliothèque d'images logicielles en nuage que vous pouvez voir 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 images logicielles et des versions disponibles pour Oracle Database et Oracle Grid Infrastructure

Pour produire une liste des versions prises en charge disponibles pour l'application de correctifs, utilisez la commande dbaascli cswlib showImages.

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

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

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli cswlib showImages --product database

    La sortie de commande répertorie les images logicielles disponibles pour Oracle Database.

    dbaascli cswlib showImages --product grid

    La sortie de commande répertorie les images logicielles disponibles pour Oracle Grid Infrastructure.

  4. Quittez l'interpréteur de commandes de l'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, voir 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

Pour télécharger une image logicielle

Vous pouvez télécharger les images logicielles disponibles dans 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 des instructions détaillées, voir Connexion à une machine virtuelle avec SSH.
  2. Démarrez un interpréteur de commandes en tant qu'utilisateur racine :
    $ 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 dans votre environnement Exadata Cloud Infrastructure.

    Les paramètres facultatifs sont les suivants :

    • version : spécifie une version du logiciel Oracle Database. Par exemple, 19.14.0.0.0.
    • imageTag : spécifie le marqueur d'image de l'image.
  4. Quittez l'interpréteur de commandes :
    # exit
$

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

Voyez comment utiliser l'utilitaire dbaascli pour effectuer des opérations d'application de correctifs pour Oracle Grid Infrastructure et Oracle Database sur un système Exadata Cloud Infrastructure.

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

Application de correctifs aux bases de données à l'aide de dbaascli

À l'aide de dbaascli, vous pouvez choisir d'appliquer des correctifs à une base de données en appliquant un correctif au répertoire de base Oracle ou en déplaçant la base de données vers un répertoire de base Oracle ayant le niveau de correctif souhaité.

  • Application de correctifs à un répertoire de base Oracle (application de correctifs sur place). Cette action 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 ayant la version souhaitée du logiciel Oracle Database (application de correctifs dans un emplacement différent).

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

Application de correctifs à un répertoire de base de base de données (application de correctifs sur place)

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

Cette action applique des correctifs à toutes les bases de données s'exécutant dans le répertoire de base spécifié. Les bases de données resteront dans le répertoire de base une fois l'application de correctifs terminée. Les éléments suivants s'appliquent à l'utilisation de la commande dbHome patch pour les opérations d'application de correctifs sur place :
  • Vous pouvez appliquer des correctifs à tous vos noeuds de base de données ou à un sous-ensemble de noeuds.
  • L'application de correctifs multinoeuds se fait de manière continue.
  • Facultativement, vous pouvez effectuer une opération de correctif logiciel uniquement. Ensuite, lorsque vous êtes prêt, vous pouvez exécuter datapatch pour effectuer des actions SQL post-application de correctifs.
  • Vous pouvez appliquer des correctifs à un répertoire de base Oracle contenant une ou plusieurs bases de données.

Pour appliquer des correctifs à 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, voir Connexion à une machine virtuelle avec SSH.

  2. Démarrez un interpréteur de commandes en tant qu'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 à corriger.
    • --targetVersion indique la version Oracle Database cible à utiliser pour l'application de correctifs, spécifiée 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 l'interpréteur de commandes de l'utilisateur root :
    exit

    Pour plus de détails sur les options prises en charge avancées, voir dbaascli dbHome patch.

Déplacement d'une base de données vers un autre répertoire de base Oracle (application de correctifs dans un emplacement différent)

Pour appliquer des correctifs à 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 correctif souhaité, utilisez la commande dbaascli database move.

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

Pour appliquer un correctif à 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, voir Connexion à une machine virtuelle avec SSH.

  2. Démarrez un interpréteur de commandes en tant qu'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 souhaitée. Notez que 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 l'interpréteur de commandes de l'utilisateur root :
    exit

    Pour plus de détails sur les options prises en charge avancées, voir dbaascli database move.

Application de correctifs à Oracle Grid Infrastructure

Pour appliquer un correctif à 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, voir Connexion à une machine virtuelle avec SSH.

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli grid patch --targetVersion target_software_version_number

    Où --targetVersion identifie la version du logiciel cible pour laquelle un correctif sera appliqué à Oracle Grid Infrastructure.

    Par exemple :
    dbaascli grid patch --targetVersion 19.11.0.0.0
  4. Quittez l'interpréteur de commandes de l'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, voir dbaascli grid patch.

Application de correctifs à Oracle Grid Infrastructure (GI) à l'aide de l'image logicielle GI

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

Il est également possible d'appliquer des correctifs à Oracle Grid Infrastructure en créant d'abord une image logicielle corrigée, puis en utilisant cette image pour effectuer l'opération d'application de correctifs. Cela offre l'avantage qu'une image peut être créée à l'avance en dehors de la fenêtre d'application de correctifs. Cela facilite également la résolution des conflits, car tous les conflits entre les correctifs sont mis en évidence lors du processus de création d'image, sans incidence sur la fenêtre d'application de correctifs.

  1. Créez une image logicielle corrigée.
    dbaascli grid patch --targetVersion <target_software_version_number> --createImage
    Une fois la création de l'image logicielle corrigée terminée, l'image peut ensuite être utilisée pour effectuer l'application de correctifs.
  2. Effectuez l'opération d'application de correctifs.
    dbaascli grid patch --targetVersion <target_software_version_number> --imageLocation <location_of_patched_software_image>

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

Pour produire une liste des versions prises en charge disponibles pour l'application de correctifs, utilisez la commande dbaascli cswlib showImages.

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

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

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli cswlib showImages --product database

    La sortie de commande répertorie les images logicielles disponibles pour Oracle Database.

    dbaascli cswlib showImages --product grid

    La sortie de commande répertorie les images logicielles disponibles pour Oracle Grid Infrastructure.

  4. Quittez l'interpréteur de commandes de l'utilisateur root :
    exit

    Pour plus de détails sur les options avancées prises en charge, voir 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 vérification préalable avant l'application de correctifs à Oracle Grid Infrastructure et aux bases de données Oracle

Vous pouvez effectuer une opération de vérification des préalables (également appelée vérification préalable) pour les commandes de cette rubrique à l'aide de l'indicateur de vérification préalable applicable.

L'exécution des vérifications préalables vous permet d'exécuter uniquement la partie vérification préalable de l'opération d'application de correctifs sans effectuer d'application de correctifs réelle. Oracle recommande d'exécuter des vérifications préalables pour détecter les problèmes logiciels qui pourraient empêcher l'application de correctifs.

Pour effectuer des vérifications préalables d'application de correctifs, connectez-vous d'abord à une machine virtuelle dans votre instance Exadata Cloud Infrastructure en tant qu'utilisateur root.

Vérification préalable de l'application de correctifs au répertoire de base Oracle (application de correctifs sur place)

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, voir Connexion à une machine virtuelle avec SSH.

  2. Démarrez un interpréteur de commandes en tant qu'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 à vérifier au préalable.
    • --targetVersion indique la version Oracle Database cible à laquelle appliquer des correctifs, spécifiée sous la forme de cinq segments numériques séparés par des points (par exemple 19.12.0.0.0).
  4. Quittez l'interpréteur de commandes de l'utilisateur root :
    exit
Vérification préalable à l'application de correctifs de déplacement de base de données (application de correctifs dans un emplacement différent)

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, voir Connexion à une machine virtuelle avec SSH.

  2. Démarrez un interpréteur de commandes en tant qu'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 souhaitée. Notez que 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 l'interpréteur de commandes de l'utilisateur root :
    exit
Vérification préalable à l'application de correctifs à 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, voir Connexion à une machine virtuelle avec SSH.

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur root :
    sudo -s
  3. Exécutez la commande suivante :
    dbaascli grid patch --targetVersion target_software_version_number --executePrereqs

    Où --targetVersion identifie la version du logiciel cible pour laquelle un correctif sera appliqué à Oracle Grid Infrastructure, spécifiée sous la forme de cinq segments numériques séparés par des points, par exemple 19.12.0.0.0

  4. Quittez l'interpréteur de commandes de l'utilisateur root :
    exit

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

Vous pouvez reprendre ou annuler une opération d'application de correctifs qui a échoué. L'annulation d'un correctif est appelée repositionnement.

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

Reprise d'une opération d'application de correctifs

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

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

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

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur root :
    sudo -s
  3. Exécutez la commande d'application de correctifs initiale pour reprendre une opération d'application de correctifs :
    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 l'interpréteur de commandes de l'utilisateur root :
    exit
Annulation de l'application d'un correctif

Utilisez l'indicateur --rollback avec la commande d'application de correctifs initiale pour repositionner (rétablir) une opération d'application de correctifs.

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

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

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur root :
    sudo -s
  3. Exécutez la commande d'application de correctifs initiale pour repositionner (annuler) une opération d'application de correctifs :
    Par exemple :
    dbaascli grid patch --targetVersion 19.11.0.0.0 --rollback
    Note

    • Les opérations de reprise et de repositionnement sont prises en charge pour les opérations d'application de correctifs au répertoire de base Oracle, d'application de correctifs à Oracle Grid Infrastructure et de déplacement de base de données.
    • Lors de la reprise ou du repositionnement d'une opération d'application de correctifs, vous devez exécuter la commande de reprise ou de repositionnement à partir du même noeud que celui qui a été utilisé pour exécuter la commande d'application de correctifs initiale. Vous devez exécuter la commande initiale en ajoutant l'indicateur --resume ou --rollback.
  4. Quittez l'interpréteur de commandes de l'utilisateur root :
    exit

Collecter des journaux d'outils en nuage et effectuer une vérification d'état des outils en nuage à l'aide de dbaascli

L'utilisation de la commande dbaascli diag vous permet de collecter les journaux d'outils dbaas de la machine virtuelle invitée pour le service Exadata Database sur une infrastructure dédiée et le service Exadata Database sur des systèmes Cloud@Customer. Vous pouvez utiliser ces journaux pour résoudre les problèmes liés aux outils dbaas.

Vous pouvez utiliser la commande diag pour collecter les journaux dbaastools et effectuer une vérification de l'état de tous les noeuds d'une grappe Exadata. Notez que l'option --waitForCompletion est prise en charge à partir de la version 22.4.1
Note

  • 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 noeud unique collectera des données de journal pour tous les noeuds.
  • Nous vous recommandons d'exécuter les commandes documentées dans cette rubrique en utilisant l'option --waitForCompletion pour les commandes de longue durée. Reportez-vous aux exemples d'utilisation.

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

Rubriques connexes

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

Collecte des données du journal d'outils - Exemples

La commande dbaascli dbaascli diag collect utilise la syntaxe indiquée ci-dessous pour collecter les données du journal d'outils :

Voir dbaascli diag collect dans Informations de référence sur les commandes dbaascli pour plus de détails sur la syntaxe. 

# 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.
Note

Utilisez la commande de statut de tâche pour surveiller l'avancement. 
# 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

Effectuer une vérification de l'état - Exemples

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

Voir dbaascli diag healthcheck dans les informations de référence sur la commande dbaascli pour plus de détails 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 en nuage à l'aide de dbaascli

Pour mettre à jour la version des outils en nuage pour le service Oracle Exadata Database sur une infrastructure dédiée, suivez cette procédure.

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

Les outils en nuage 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 nuage sur toutes les machines virtuelles de la grappe de machines virtuelles.
Note

Vous pouvez mettre à jour les outils propres au nuage en téléchargeant un ensemble de logiciels contenant les outils mis à jour.
  1. Connectez-vous à une machine virtuelle en tant qu'utilisateur opc.

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

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur root :
    sudo -s
  3. Pour effectuer une mise à jour aux derniers outils en nuage disponibles, exécutez la commande suivante : 
    dbaascli admin updateStack

    La commande prend en charge la mise à jour de la version des outils en nuage sur tous les noeuds de la grappe.

    Pour plus de détails et d'autres options disponibles, consultez dbaascli admin updateStack --help.

Créer une base de données en double

Utilisation de dbaascli pour dupliquer une base de données en nuage

Vous pouvez créer une base de données en double à l'aide de dbaascli. Cette nouvelle base de données peut se trouver dans la même région en nuage que la région source ou dans toutes les régions. Les étapes suivantes décrivent comment créer une base de données en double dans le nuage.

Note

Si une base de données est configurée avec le service de chambre forte OCI pour le chiffrement TDE et que vous voulez dupliquer une base de données, consultez les sections suivantes.

Préparer pour la duplication

Assurez-vous que les conditions préalables suivantes sont remplies :

  • Assurez-vous qu'un chemin réseau est configuré pour accéder à la base de données source au moyen de 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.
  • Créez un répertoire de base Oracle sur le noeud cible, si nécessaire. La version du répertoire de base d'Oracle doit être identique à la version source ou à la version supérieure de l'UR.

Exécuter les vérifications des préalables

Pour exécuter les vérifications des préalables, utilisez l'option de commande --executePrereqs. Cette opération n'effectuera que les vérifications préalables 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

Base de données en double

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

Considérations relatives à l'utilisation de la chambre forte OCI pour la gestion des clés

Cette section s'applique uniquement dans le cas où la base de données est configurée avec la chambre forte OCI pour le chiffrement TDE et que vous souhaitez dupliquer une base de données.

Duplication d'une base de données dans la même région

  • Étapes préalables supplémentaires

    Assurez-vous de configurer les politiques d'accès au service de chambre forte OCI pour les noeuds de base de données cible. Les noeuds de base de données cible doivent pouvoir accéder à la fois à la chambre forte de clés OCI de la base de données source et à sa nouvelle chambre forte de clés (s'il est décidé d'utiliser une chambre forte de clés distincte).

  • Exécuter les vérifications des préalables
    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
  • Base de données en double
    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 terminée, la base de données est dupliquée.

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

  • Étapes préalables supplémentaires
  • Exécuter les vérifications des préalables
    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
  • Base de données en double
    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 terminée, la base de données est dupliquée.

Dupliquer une base de données sur place

À l'aide de dbaascli, vous pouvez dupliquer une base de données sur place dans le nuage. Cela peut être fait avec la commande dbaascli database duplicate. Cette commande crée une nouvelle base de données dans le nuage, qui est un double d'une base de données sur place et de ses données. Pendant ce processus, la base de données sur place reste opérationnelle. Vous pouvez migrer vos applications vers la base de données en double dans le nuage après une vérification appropriée.

Préparer pour la duplication

Le processus de migration comprend les préalables suivants à respecter.
  • Assurez-vous qu'un chemin réseau est configuré pour accéder à une base de données sur place à partir du noeud OCI au moyen de la chaîne EZConnect.
  • Si une base de données sur place est configurée avec TDE, copiez le fichier de portefeuille TDE (ewallet.p12) vers le noeud OCI, où vous décidez d'exécuter la commande dbaascli.
  • Créez un répertoire de base Oracle sur le noeud OCI, si nécessaire. La version du répertoire de base Oracle doit être identique à la source ou à une version d'UR 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 une mise à jour vers la dernière version de dbaastools RPM est toujours recommandée.

  • Pour vérifier la version actuellement installée, exécutez :
    dbaascli --version
DBAAS CLI version 23.3.2.0.0
  • Pour appliquer le RPM des outils les plus récents, en tant qu'utilisateur root, exécutez :
    # dbaascli admin updateStack

Exécuter les vérifications préalables

Pour exécuter les vérifications des préalables, utilisez l'option de commande --executePrereqs. Cette opération n'effectuera que les vérifications préalables 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

Base de données en double

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 terminée, la base de données est dupliquée dans le nuage et prête pour les vérifications d'intégrité pour 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 en nuage.

Reportez-vous à dbaascli database duplicate –help pour obtenir des options de configuration supplémentaires.

Peu de considérations pour la migration

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

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

Dépannage de la duplication de la base de données

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

Si l'opération échoue, vous avez la possibilité de reprendre l'opération 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 la base de données.

Notes de version

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

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

Retirer 25.2.1.0.0 (250522)

  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

Retirer 25.1.2.0.0 (250325)

  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

Retirer 25.1.1.0.0 (250107)

  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

version 24.4.1.0.0 (241104)

  • Amélioration de dbaascli database getDetails pour inclure les détails de tde encryption. La commande dbaascli tde status est maintenant obsolète.
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

version 24.3.2.0.0 (240828)

  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de 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
  • Correctif de grille sur place pour utiliser l'application de correctifs basée sur une image en mode par défaut
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

version 24.2.1.0.0 (240530)

  • Ajout de la prise en charge d'Oracle Database 23ai.
  • Améliorations dans la zone de sauvegarde et de récupération avec le service ZRCV (Zero Data Loss Autonomous Recovery Service) comme destination de sauvegarde.
  • Correctifs de bogues divers et améliorations de stabilité.

Rubrique parent : Notes de version

version 24.1.2.0.0 (240306)

  • Présentation d'un nouveau flux de travail optimisé pour les opérations Data Guard
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

version 24.1.1.0.0 (231219)

  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de 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. Lors de l'automatisation des éléments de sauvegarde obsolètes, la fenêtre de récupération est de 7 jours si elle découvre une valeur inférieure à 7 du système.
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

version 23.3.2.0.0 (230921)

  • Opérations de base de données enfichable
    • Ajout de la prise en charge de la définition de l'OCID de la version de clé personnalisée (Utilisation de votre propre clé - BYOK) de la chambre forte OCI lors des opérations de création et de clonage. Pour plus de détails, voir l'aide relative aux commandes de base de données enfichable respectives.
  • Application de correctifs à Grid Infrastructure (GI)
    • Améliorez le flux de travail d'application de correctifs afin d'améliorer le temps d'application de correctifs, en particulier dans les environnements où le nombre de bases de données est élevé.
    • Une nouvelle option --patchInParallel peut être utilisée pour appliquer des correctifs aux noeuds distants en parallèle.
  • Application de correctifs à une base de données
    • Option fournie pour exécuter le correctif de données sur un noeud spécifique de la grappe.
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de 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 plus de détails, voir 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, voir dbaascli system getGridHomes --help.
    • dbaascli admin updateAHF - Cette commande peut être utilisée pour mettre à jour le format AHF vers une version certifiée Cloud spécifiée de la version AHF. Il est toutefois recommandé que les mises à jour AHF soient traitées implicitement par l'automatisation du nuage. Pour plus de détails, voir dbaascli admin updateAHF --help.
  • Opérations de base de données enfichable
    • Améliorations dans le domaine du cycle de vie de la base de données enfichable actualisable.
  • 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 configurations dataguard. La configuration des sauvegardes est propre au site Data Guard, c'est-à-dire que la modification des rôles (par exemple, avec l'opération de permutation de Data Guard) n'aura pas d'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, se poursuivent indépendamment de la modification de rôle.
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

version 23.2.1.0.0 (230503)

  • Améliorations liées au cycle de vie de la base de données
    • Introduit dbaascli grid removeTCPSCert pour supprimer les certificats TCPS expirés. Pour plus de détails, voir dbaascli grid removeTCPSCert --help.
    • Option ajoutée pour exclure des bases de données enfichables spécifiques lors de la duplication de la base de données. Pour plus de détails, voir l'argument skipPDBs dans dbaascli database duplicate --help.
  • Sauvegarde et récupération de base de données
    • La valeur par défaut pour FILES_PER_SET a été modifiée à 64 pour les sauvegardes OSS. Cela peut être modifié avec dbaascli database backup --configure. Pour plus de détails, voir dbaascli database backup --help.
    • Les sauvegardes des journaux d'archives se poursuivent à 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 programmes des sauvegardes L0 et L1 ne sont pas créés 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 signale 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, voir Gérer sysLens.

  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

Version 23.1.2.0.0 (230305)

  • Améliorations liées au cycle de vie de la base de données
    • Ajout de l'option de création de modèles de base de données (modèles DBCA) dans le magasin d'objets. Les modèles DBCA peuvent ensuite être utilisés pour créer des bases de données. Pour plus de détails, voir dbaascli database createTemplate --help.
  • Opérations de base de données enfichable
    • Présentation de dbaascli pdb refresh pour actualiser une base de données enfichable créée à l'aide de l'option d'actualisation manuelle. Pour plus de détails, voir dbaascli pdb refresh --help.
    • Ajout de l'option de conversion d'une base de données enfichable actualisable en base de données enfichable standard. Pour plus de détails, voir dbaascli pdb open --help.
    • La création d'une base de données enfichable actualisable requiert maintenant 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 enfichable source. Pour plus de détails, voir l'argument dblinkUserName dans dbaascli pdb remoteClone --help.
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

Version 23.1.1.0.1 (230113)

  • Améliorations liées au cycle de vie de la base de données
    • Ajout de la prise en charge de la création d'une base de données en double à partir d'une base de données source qui utilise les services de chambre forte OCI pour la gestion des clés de chiffrement.
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

Version 22.4.1.0.1 (221122)

  • Opérations de base de données enfichable
    • Ajout de l'option pour ne pas ouvrir la base de données enfichable à la fin du déplacement. Pour plus de détails, voir l'argument skipOpenPDB dans dbaascli pdb relocate --help. Après l'utilisation de cette option, le déplacement de la base de données enfichable peut être effectué en exécutant la commande à l'aide de l'argument completePDBRelocate.
    • Ajout de l'option de nettoyage des métadonnées/services de la base de données enfichable déplacée à l'emplacement source. Pour plus de détails, voir 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 servir à créer des bases de données. Les modèles DBCA sont largement utilisés pour créer une base de données clone à l'aide de DBCA, un outil fourni avec le logiciel de serveur Oracle Database. Pour plus de détails, voir dbaascli database createTemplate --help.
    • Introduction de dbaascli tde rotateMasterKey pour effectuer la rotation de la clé principale de chiffrement de base de données. Pour plus de détails, voir dbaascli tde rotateMasterKey --help. La commande dbaascli tde rotate masterkey est maintenant obsolète.
  • Améliorations liées au cycle de vie de la base de données
    • Ajout de la prise en charge de l'utilisation des modèles dbca dans les flux de travail de création de base de données. Pour plus de détails, voir l'argument dbcaTemplateFilePath dans dbaascli database create --help.
    • Amélioration de la performance de la création de bases de données en double. Pour plus de détails sur la création d'une base de données en double, voir dbaascli database duplicate --help.
    • Ajout de la prise en charge de la création d'une base de données en double à partir d'une base de données source qui n'est pas chiffrée TDE.
  • Gestion TDE
    • Introduction de dbaascli tde rotateMasterKey pour effectuer la rotation de la clé principale de chiffrement de base de données. Pour plus de détails, voir dbaascli tde rotateMasterKey --help. La commande dbaascli tde rotate masterkey est maintenant obsolète.
    • Flux de travail réorganisé pour toutes les opérations TDE. Pour plus de détails, voir dbaascli tde --help.
  • Application de correctifs à Grid Infrastructure (GI)
    • Ajout de la prise en charge pour permettre l'exécution en parallèle de l'opération d'application de correctifs sur les noeuds. Cette option doit être utilisée avec précaution, 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
    • Flux de travail réorganisé pour la création d'une base de données à partir de sauvegardes autonomes.
  • AHF version 22.2.4 inclus
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de 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 indiquée, par exemple le paramètre dbname, les informations sur le noeud, les informations sur les bases de données enfichables, etc. Pour plus de détails, voir dbaascli database getDetails --help.
  • Opérations de base de données enfichable
    • Ajout de la prise en charge de la création de bases de données enfichables en tant que clone actualisable à l'aide de l'argument refreshablePDB. Pour plus de détails, voir dbaascli pdb remoteClone --help
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de 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 à un des noeuds de la grappe où la base de données n'est pas déjà configurée. Pour plus de détails, voir 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 de la grappe où la base de données est configurée. Pour plus de détails, voir dbaascli database deleteInstance --help.
    • dbaascli database duplicate - Cette commande peut être utilisée pour créer une nouvelle base de données à partir d'une base de données existante dans une grappe ou entre des grappes, si une connexion réseau existe entre les grappes. Pour plus de détails, voir dbaascli database duplicate --help.
  • Bibliothèque d'images logicielles en nuage
    • Une commande dbaascli cswlib listLocal a été introduite pour lister les images téléchargées localement à partir d'une bibliothèque d'images logicielles sur le système. Pour plus de détails, voir dbaascli cswlib listLocal --help La commande dbaascli dbimage list est maintenant obsolète.
    • Lancez la commande dbaascli cswlib deleteLocal pour supprimer des images téléchargées à partir de la bibliothèque d'images logicielles en nuage. Pour plus de détails, voir dbaascli cswlib deleteLocal --help La commande dbaascli dbImage purge est maintenant obsolète.
  • L'emplacement du journal pour la commande dbaascli admin updateStack a été modifié pour respecter la convention des autres commandes dbaascli. Les journaux peuvent être trouvés facilement sous le répertoire /var/opt/oracle/log/admin/updateStack. L'emplacement précédent était /var/opt/oracle/log/tooling/Update.
  • L'aide dbaascli est maintenant adaptée à la plate-forme en nuage, dans la mesure où elle liste les sorties pour les commandes applicables à l'environnement en nuage sur lequel elle fonctionne.
  • Ajout de la prise en charge de la modification des mots de passe TDE dans les environnements Data Guard. Pour plus de détails, voir dbaascli tde changePassword --help. Cette prise en charge n'est pas disponible actuellement pour la version 11.2.0.4.
  • AHF version 22.1.5 inclus
  • Flux de travail réorganisé pour l'opération de mise à niveau de la base de données.
  • Flux de travail réorganisé pour l'opération de création d'un répertoire de base de base de données.
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

Version 22.2.1.1.0 (220623)

  • AHF version 22.1.1 inclus
  • Correction d'un problème où la mise à jour de dbaastools rpm sur le système peut avoir entraîné un temps d'arrêt de la base de données avec l'erreur ORA-600
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

Version 22.2.1.1.0 (220609)

  • Nouvelles commandes dbaascli :
    • dbaascli dbHome getDatabases - Cette commande liste toutes les bases de données s'exécutant à partir d'un répertoire de base Oracle indiqué. La sortie est retournée dans le format JSON pour faciliter l'automatisation. Pour plus de détails, voir dbaascli dbHome getDatabases --help.
    • dbaascli database getPDBs - Cette commande liste toutes les bases de données enfichables d'une base de données conteneur indiquée. La sortie est retournée dans le format JSON pour faciliter l'automatisation. Pour plus de détails, voir dbaascli database getPDBs --help.
    • dbaascli dbHome delete - Cette commande supprime un répertoire de base Oracle de base de données indiqué. Pour plus de détails, voir dbaascli dbHome delete --help.
    • dbaascli dataguard prepareStandbyBlob - Cette commande génère un fichier blob contenant divers fichiers qui sont requis sur le site de secours pour un environnement Data Guard. Pour plus de détails, voir dbaascli dataguard prepareStandbyBlob --help.
  • Application de correctifs à Grid Infrastructure (GI) :
    • Nouveau flux de travail optimisé
    • Présentation d'un moyen de créer l'image logicielle Grid Infrastructure (GI) avant l'application de correctifs. Cette image GI peut ensuite être utilisée pour effectuer l'opération d'application de correctifs à GI. L'avantage de cette approche est qu'elle réduit la fenêtre d'application de correctifs car l'image est déjà préparée. La pile GI sur le noeud n'est pas réduite pour créer l'image. Pour plus de détails, voir l'option createImage dans dbaascli grid patch --help
    • Voyez comment effectuer l'application de correctifs à Grid Infrastructure à l'aide de l'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, voir l'option imageLocation dans dbaascli grid patch --help.
  • Prise en charge de la modification des mots de passe dans un environnement Data Guard :
    • Ajout de la prise en charge de la modification des mots de passe dans les environnements Data Guard. Pour plus de détails, voir dbaascli database changePassword --help et dbaascli dataguard prepareStandbyBlob --help
  • Configuration de 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, voir dbaascli dataguard --help.
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

Version 22.2.1.0.1 (220423)

  • Nouvelles commandes dbaascli
    • Introduction de la commande dbaascli admin showLatestStackVersion pour afficher la dernière version de dbaastools disponible pour le téléchargement et l'installation. L'installation de dbaastools rpm peut être effectuée à l'aide de la commande dbaascli admin updateStack. Pour plus de détails, voir la section Informations de référence sur les commandes dbaascli.
  • Bibliothèque d'images logicielles en nuage
    • Obsolète : Prise en charge de l'activation BP (dbaascli cswlib activateBP), car les correctifs d'ensemble sont maintenant remplacés par des mises à jour de version. Le déploiement en nuage utilise des versions RU sous forme d'images logicielles, identifiées par des "marqueurs d'image". Il est donc recommandé d'utiliser des marqueurs d'image lors de l'interfaçage avec les commandes Cloud Software Library (cswlib). Pour plus de détails, voir 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. Maintenant, les utilisateurs peuvent créer la base de données non conteneur à l'aide d'images standard. Pour plus de détails, voir l'option createAsCDB dans dbaascli database create –help.
  • Création de base de données non conteneur
    • Flux de travail de création de base de données amélioré 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, voir l'option createAsCDB dans dbaascli database create –help.
  • Application de correctifs aux répertoires de base de base de données
    • Nouveau flux de travail optimisé
  • Mise à niveau d'Oracle Grid Infrastructure
    • Nouveau flux de travail optimisé
  • Opérations de base de données enfichable
    • La suppression de la base de données enfichable dans les environnements Data Guard nécessite un accusé de réception explicite pour indiquer que les opérations nécessaires sur le site de secours sont terminées, en transmettant l'argument –allStandByPrepared supplémentaire. Pour plus de détails, voir dbaascli pdb delete --help
  • Fonctionnalité continue pour l'opération de redémarrage de base de données. Pour plus de détails, voir dbaascli database bounce –help.
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

Version 22.1.1.2.0 (220405)

  • Ajout de la prise en charge pour ExaDB-D X9M
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

Version 22.1.1.1.0 (220317)

  • Nouvelles commandes dbaascli :
    • Introduit dbaascli system getDBHomes pour obtenir tous les répertoires de base Oracle de base de données dans la grappe. La sortie est retournée dans le format JSON pour faciliter l'automatisation.
    • Introduit dbaascli dbhome getDetails pour obtenir des informations détaillées sur un répertoire de base Oracle spécifique. La sortie est retournée dans le format JSON pour faciliter l'automatisation.
  • Bibliothèque d'images logicielles en nuage (cswlib) :
    • Fin de la prise en charge de la commande dbaascli cswlib list pour les opérations de liste de la bibliothèque d'images logicielles en nuage. La nouvelle commande est dbaascli cswlib showImages qui répertorie les images et leur ImageTag. Il est recommandé d'utiliser Image tags pour télécharger les images de la bibliothèque d'images logicielles en nuage. Pour plus de détails sur les téléchargements à l'aide de marqueurs d'image, voir dbaascli cswlib download –help.
    • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

Version 22.1.1.0.1 (220223)

  • Mise à niveau d'Oracle Grid Infrastructure
    • Nouveau flux de travail 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
    • Des messages d'abandon ont été introduits pour les commandes bkup_api, car elles sont maintenant remplacées par des commandes dbaascli. Pour plus de détails, voir dbaascli database backup --help et dbaascli database recover –help
  • Opérations de base de données enfichable
    • L'opération de déplacement de la base de données enfichable est maintenant prise en charge. Pour plus de détails, voir dbaascli pdb relocate –help.
    • Flux de travail réorganisé pour la conversion de base de données non conteneur en base de données enfichable. Pour plus de détails, voir dbaascli database convertToPDB –help.
  • Gestion des clés de chiffrement
    • Les paramètres d'initialisation propres à la pulsation du chiffrement transparent des données (TDE) sont réglés aux valeurs recommandées dans le nuage pour les bases de données avec des clés gérées par le client.
  • Gestion de la bibliothèque d'images logicielles en nuage
    • Téléchargement amélioré des artefacts de la bibliothèque d'images logicielles au moyen des imageTags. Il est recommandé d'utiliser imageTags pour télécharger les images logicielles pour Oracle Database et Oracle Grid Infrastructure. Pour plus de détails, voir dbaascli cswlib showimages et dbaascli cswlib download –help
  • AHF version 21.4.2 inclus
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

Version 21.4.1.1.0 (220209)

  • AHF version 21.4.1 inclus
  • Correctifs de bogue et améliorations de la stabilité

Rubrique parent : Notes de version

Version 21.4.1.1.0

  • Chiffrement activé des espaces-tables au niveau du système (SYSTEM, SYSAUX, UNDO et TEMP) pour les bases de données qui seront créées avec cette version de dbaastools. Cette fonction est activée pour Oracle Database version 19.6.0.0.0 et supérieure.
  • Application de correctifs à Grid Infrastructure :
    • Condition préalable ajoutée pour vérifier que le fichier suivant appartient à l'utilisateur grid. 
      • <gi_home>/suptools/tfa/release/tfa_home/jlib/jdev-rt.jar
      • <gi_home>/suptools/tfa/release/tfa_home/jlib/jewt4.jar
  • Application de correctifs à une base de données :
    • L'opération simultanée database move n'est pas autorisée par défaut. La nouvelle option –allowParallelDBMove peut être utilisée pour modifier le comportement par défaut pour les versions 12.2 et ultérieures d'Oracle Database.
    • Correction des problèmes liés au déplacement de 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, consultez les informations de référence sur 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, consultez les informations de référence sur la commande dbaascli database restaur.
    • L'utilisation de bkup_api pour les opérations de sauvegarde et de récupération sera obsolète à l'avenir.
    • Pour s'aligner avec la pratique recommandée par Oracle d'utiliser le privilège d'administration SYSBACKUP pour les opérations de sauvegarde et de récupération, l'automatisation du nuage 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 effectuées avec l'utilisateur disposant du privilège minimal Les données d'identification de cet utilisateur sont générées aléatoirement et gérées de manière sécurisée par l'automatisation du nuage. Si l'utilisateur est introuvable ou a le statut LOCKED ou EXPIRED, l'automatisation du nuage recrée ou déverrouille cet utilisateur lors de l'opération de sauvegarde ou de récupération. Ce changement dans l'automatisation du nuage commence à compter de dbaastools version 21.4.1.1.0.
  • Amélioration de la fonctionnalité dbaascli resume pour reprendre toute session précédente en spécifiant l'argument –sessionID <value> pour la commande de reprise. L'ID session est partagé dans la sortie dbaascli ainsi que dans les journaux.
  • Sortie dbaascli help améliorée pour afficher de l'aide sur l'utilisation de la commande.
  • Utilisation obsolète de l'interpréteur de commandes dbaascli (session interactive). La prise en charge s'arrête définitivement après mars 2022. Il est recommandé d'exécuter des commandes dbaascli complètes à l'invite de commande, comme suggéré dans tous les exemples de ce document.
  • Inclusion de Autonomous Health Framework (AHF) version 21.2.8.
  • Correctifs de bogues divers et améliorations de stabilité.

Rubrique parent : Notes de version

Version 21.3.1.2.0

  • La synchronisation des opérations dbaascli a été améliorée avec la logique de synchronisation des métadonnées du plan de contrôle.
  • Journaux dbaascli améliorés pour contenir des informations de niveau milliseconde ainsi que l'unité d'exécution associée.
  • Introduction de vérifications préalables supplémentaires dans les opérations d'application de correctifs au répertoire de base de base de données et de déplacement de base de données pour détecter les défaillances potentielles et fournir des suggestions de mesure corrective.
  • Les opérations d'application de correctifs de base de données conservent maintenant l'état des bases de données pour qu'il soit identique à celui des bases de données antérieures à l'application de correctifs. Pour les bases de données enfichables, l'état enregistré de la base de données enfichable est respecté.
  • Correctifs de bogues divers et améliorations de stabilité.

Rubrique parent : Notes de version

Version 21.3.1.1.0

  • Ajout de la prise en charge pour déverrouiller le compte d'utilisateur administrateur de la base de données enfichable dans le cadre de l'opération de création de la base de données enfichable, localClone ou remoteClone. Pour plus de détails, voir l'option --lockPDBAdminAccount dans dbaascli pdb create --help.
  • Correction d'un problème qui met à jour la ressource de base de données enregistrée avec Oracle Grid Infrastructure dans des environnements existants avec la valeur correcte du nom de base de données.
  • Améliorations apportées aux opérations de cycle de vie de la base de données enfichable.
  • Correctifs de bogues divers et améliorations de stabilité.

Rubrique parent : Notes de 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
  • Application de correctifs dans un emplacement différent de la base de données. Pour plus de détails, voir dbaascli database move –help.
  • Améliorations liées à la durée dans le flux de travail d'application de correctifs à Oracle Grid Infrastructure. Pour plus de détails, voir dbaascli grid patch –help.
  • Fin de la prise en charge des commandes exadbcpatchmulti/dbaascli patch pour les opérations d'application de correctifs. Les commandes dbaascli dbhome patch et dbaascli grid patch sont fournies pour l'application de correctifs aux répertoires de base de données et à Oracle Grid Infrastructure. Pour plus de détails, voir la section Application de correctifs aux bases de données Oracle Grid Infrastructure etOracle à l'aide de dbaascli. Voir aussi la section Informations de référence sur les commandes dbaascli.
  • Fin de la prise en charge des commandes d'application de correctifs pour les outils dbaascli pour assurer la cohérence dans les conventions de commande dbaascli. La nouvelle commande est dbaascli admin updateStack. Pour plus de détails, voir la section Mise à jour des outils en nuage à l'aide de dbaascli.
  • Permet d'exécuter dbaascli en mode déconnecté pour des opérations de longue durée. L'exécution de la commande dbaascli avec --waitForCompletion false permet d'obtenir un ID tâche qui peut être interrogé plus tard pour obtenir le statut de l'opération, à l'aide de dbaascli job getStatus –jobid job_id. Cela est utile pour les opérations de longue durée où les utilisateurs peuvent vouloir 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 pour ces commandes reflète la prise en charge de l'option --waitForCompletion.
  • Fin de la prise en charge de l'interpréteur de commandes dbaascli. Il est recommandé aux utilisateurs d'exécuter les commandes dbaascli complètes à l'invite de commande, comme indiqué dans tous les exemples de ce document. L'exécution de dbaascli seulement affiche la sortie de l'aide sur son utilisation au lieu d'avoir à afficher un interpréteur de commandes dbaascli.
  • Correctifs de bogues divers et améliorations de stabilité.

Rubrique parent : Notes de version

Version 21.2.1.x.x

  • Nouvelle conception de l'application de correctifs à Oracle Grid Infrastructure et possibilité de reprendre à partir d'un point d'échec, d'un correctif sur un sous-ensemble de noeuds, d'un drainage d'instance et d'autres améliorations. Pour plus de détails, voir dbaascli grid patch --help. Consultez également la section Application de correctifs à Oracle Grid Infrastructure et à Oracle Database à l'aide de dbaascli.
  • Fin de la prise en charge des commandes exadbcpatchmulti/dbaascli patch pour les opérations d'application de correctifs. Les commandes dbaascli dbhome patch et dbaascli grid patch sont fournies pour l'application de correctifs aux répertoires de base de base de données et à Oracle Grid Infrastructure. Pour plus de détails, consultez la section Application de correctifs à Oracle Grid Infrastructure et à Oracle Database à l'aide de dbaascli. Voir aussi la section Informations de référence sur les commandes dbaascli.
  • La prise en charge de la commande dbaascli tools patch est obsolète pour assurer la cohérence dans les conventions de commande. La nouvelle commande est dbaascli admin updateStack.
  • Nouvelle conception des API de gestion des bases de données enfichables pour les opérations de création, de clonage local et de clonage distant. Pour plus de détails, voir dbaascli pdb --help.
  • Nouvelle conception de l'API de suppression de base de données. Pour plus de détails, voir dbaascli database delete --help.
  • Amélioration apportée à la création d'un répertoire de base de base de données (prise en charge de l'image logicielle personnalisée, opération d'agrandissement). Pour plus de détails, voir dbaascli dbhome create --help.
  • Prise en charge de la création de base de données sur un sous-ensemble de noeuds de grappe. Pour plus de détails, voir dbaascli database create --help.
  • Permet d'exécuter dbaascli en mode déconnecté pour des opérations de longue durée. L'exécution de la commande dbaascli avec --waitForCompletion false permet d'obtenir un ID tâche qui peut être interrogé plus tard pour obtenir le statut de l'opération, à l'aide de dbaascli job getStatus –jobid job_id. Cela est utile pour les opérations de longue durée où les utilisateurs peuvent vouloir 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 pour ces commandes reflète la prise en charge de l'option --waitForCompletion.
  • Expérience améliorée de l'application de correctifs sur dbhome avec l'introduction de plusieurs options telles que skipPDBs, continueWithDowntime, etc. Pour plus de détails, voir dbaascli dbhome patch --help.
  • Prise en charge d'une meilleure collecte de diagnostics. Pour plus de détails, voir dbaascli diag collect --help.
  • Améliorations mineures dans le domaine de l'automatisation des mises à niveau de base de données.
  • Correctifs de bogues divers et améliorations de stabilité.

Rubrique parent : Notes de version

Informations de référence sur les commandes dbaascli

Vous devez utiliser dbaascli pour créer des bases de données et les intégrer au cadre d'automatisation du nuage.

dbaascli est une interface native en nuage qui peut utiliser les modèles DBCA en tant qu'entrées, 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 au cadre d'automatisation du nuage. Les clients qui utilisent 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 fonction particulière de DBCA n'est pas disponible dans cette commande, les clients doivent ouvrir une demande My Oracle Support (MOS) pour ajouter cette fonctionnalité à dbaascli.

Pour utiliser l'utilitaire dbaascli, vous devez être connecté à un noeud de calcul Exadata Cloud Infrastructure. Pour obtenir des instructions, voir 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 exigent des privilèges d'administrateur root. Consultez chaque commande pour connaître les 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 voir la liste des images de base de données et Grid Infrastructure disponibles, utilisez la commande dbaascli cswlib listLocal.
  • dbaascli cswlib showImages
    Pour voir la liste des images de base de données et Grid Infrastructure disponibles, utilisez la commande dbaascli cswlib showImages.
  • dbaascli database addInstance
    Pour ajouter l'instance de base de données sur le noeud spécifié, 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. À l'invite, entrez le nom d'utilisateur pour lequel vous souhaitez modifier le mot de passe, puis entrez le mot de passe.
  • dbaascli database convertToPDB
    Pour convertir la base de données non conteneur spécifiée en base de données enfichable, utilisez la commande dbaascli database convertToPDB.
  • dbaascli database create
    Pour créer une base de données Oracle, utilisez la commande dbaascli database create. À l'invite, entrez 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 spécifié, 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 indiquée, par exemple le paramètre dbname, les informations sur le noeud, les informations sur les bases de données enfichables, etc.
  • dbaascli database getPDBs
    Pour voir la liste de toutes les bases de données enfichables d'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 à 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 correctifs à une base de données Oracle, utilisez la commande dbaascli database runDatapatch.
  • dbaascli database createTemplate
    Utilisez cette commande pour créer des modèles de base de données (modèles DBCA) qui peuvent ensuite servir à créer des bases de données.
  • 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 update
    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 de Data Guard sur tous les noeuds de la grappe, 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 comme première étape.
  • dbaascli dataguard configureStandby
    Pour créer une nouvelle 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 enregistrer une nouvelle base de données de secours avec toutes les bases de données de secours existantes et dans la base de données principale, utilisez la commande dbaascli dataguard registerStandby comme 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 de la grappe de secours pour annuler l'enregistrement de la base de données de secours de la configuration Oracle Data Guard Broker.
  • dbaascli dataguard configureAWR
    Pour activer ou désactiver la configuration du référentiel AWR (Automatic Workload Repository) sur votre 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 le mode de protection, ou les deux 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 avec la version souhaitée, utilisez la commande dbaascli dbhome create.
  • dbaascli dbHome delete
    Pour supprimer un répertoire de base Oracle Database indiqué, utilisez la commande dbaascli dbHome delete.
  • dbaascli dbhome getDatabases
    Pour voir les informations sur toutes les bases de données Oracle s'exécutant à partir d'un répertoire de base Oracle de base de données indiqué, utilisez la commande dbaascli dbHome getDatabases. Indiquez l'emplacement du répertoire de base Oracle ou le nom du répertoire de base Oracle.
  • dbaascli dbHome getDetails
    Pour voir des informations sur un répertoire de base Oracle spécifique, utilisez la commande dbaascli dbHome getDetails. Indiquez l'emplacement du répertoire de base Oracle ou le nom du répertoire de base Oracle.
  • correctif dbHome dbaascli
    Pour appliquer des correctifs au répertoire de base Oracle d'un niveau de correctif à un autre, utilisez la commande dbaascli dbHome patch.
  • dbaascli dbimage purge
    La commande dbimage purge supprime l'image logicielle spécifiée de votre 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 d'état de diagnostic, utilisez la commande dbaascli diag healthCheck.
  • dbaascli gridHome create
    Pour configurer le répertoire de base de Grid Infrastructure, utilisez la commande dbaascli gridHome create.
  • dbaascli grid configureTCPS
    Pour configurer TCPS pour la grappe existante, utilisez la commande dbaascli grid configureTCPS.
  • dbaascli grid patch
    Pour appliquer des correctifs à Oracle Grid Infrastructure pour la version mineure spécifiée, utilisez la commande dbaascli grid patch.
  • dbaascli grid removeTCPSCert
    Pour supprimer 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 update
    Pour mettre à niveau Oracle Grid Infrastructure d'une version majeure à une autre, utilisez la commande dbaascli grid upgrade.
  • tâche dbaascli getStatus
    Pour voir le statut d'une tâche spécifiée, utilisez la commande dbaascli job getStatus.
  • dbaascli patch db apply
  • dbaascli patch db prereq
  • dbaascli pdb backup
    Pour sauvegarder une base de données enfichable, interroger des sauvegardes de base de données enfichable et supprimer une sauvegarde de base de données enfichable, utilisez la commande dbaascli pdb backup.
  • dbaascli pdb bounce
    Pour redémarrer une base de données enfichable, utilisez la commande dbaascli pdb bounce.
  • dbaascli pdb close
    Pour fermer une base de données enfichable, utilisez la commande dbaascli pdb close.
  • dbaascli pdb getConnectString
    Pour afficher les informations de chaîne de connexion Oracle Net pour une base de données enfichable, exécutez la commande dbaascli pdb getConnectString.
  • dbaascli pdb create
    Pour créer une nouvelle base de données enfichable, exécutez la commande dbaascli pdb create.
  • dbaascli pdb delete
    Pour supprimer une base de données enfichable, exécutez la commande dbaascli pdb delete.
  • dbaascli pdb getDetails
    Pour voir les détails d'une base de données enfichable, utilisez la commande dbaascli pdb getDetails.
  • dbaascli pdb list
    Pour voir la liste des bases de données enfichables dans une base de données conteneur, utilisez la commande dbaascli pdb list.
  • dbaascli pdb localClone
    Pour créer une nouvelle base de données enfichable en tant que clone d'une base enfichable existante dans la même base de données conteneur, exécutez la commande dbaascli pdb localClone.
  • dbaascli pdb open
    Pour ouvrir une base de données enfichable, exécutez la commande dbaascli pdb open.
  • dbaascli pdb recover
    Pour récupérer une base de données enfichable, utilisez la commande dbaascli pdb recover.
  • dbaascli pdb refresh
    Pour actualiser une base de données enfichable spécifiée, utilisez la commande dbaascli pdb refresh.
  • dbaascli pdb relocate
    Pour déplacer la base de données enfichable spécifié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 nouvelle base de données enfichable en tant que clone d'une base de données enfichable existante dans une autre base de données conteneur, exécutez la commande dbaascli pdb remoteClone.
  • dbaascli system getDBHomes
    Pour voir des informations sur tous les répertoires de base Oracle, utilisez la commande dbaascli system getDBHomes.
  • dbaascli system getGridHomes
    Pour lister les détails de tous les répertoires de base de Grid Infrastructure, utilisez la commande dbaascli system getGridHomes.
  • dbaascli tde changePassword
    Pour modifier le mot de passe du magasin 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é secondaire du module de sécurité matériel (KMS) à la configuration existante, utilisez la commande dbaascli tde addSecondaryHsmKey.
  • dbaascli tde enableWalletRoot
    Pour activer le paramètre spfile wallet_root pour la base de données existante, utilisez la commande dbaascli tde enableWalletRoot.
  • dbaascli tde encryptTablespacesInPDB
    Pour chiffrer tous les espaces-tables de la base de données enfichable spécifiée, utilisez la commande dbaascli tde encryptTablespacesInPDB.
  • dbaascli tde fileToHsm
    Pour convertir le TDE basé sur FILE en TDE basé sur le module de sécurité matériel (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 clé principale associé à l'OCID de version de clé KMS, utilisez la commande dbaascli tde getMkidForKeyVersionOCID.
  • dbaascli tde getPrimaryHsmKey
    Pour obtenir la clé principale du module de sécurité matériel (KMS) à partir de la configuration existante, utilisez la commande dbaascli tde getPrimaryHsmKey.
  • dbaascli tde hsmToFile
    Pour convertir le TDE basé sur le module de sécurité matériel (KMS/OKV) en TDE basé sur FILE, utilisez la commande dbaascli tde hsmToFile.
  • dbaascli tde listKeys
    Pour lister les clés principales TDE, utilisez la commande dbaascli tde listKeys.
  • dbaascli tde removeSecondaryHsmKey
    Pour supprimer la clé principale du module de sécurité matériel (KMS) de la configuration existante, utilisez la commande dbaascli tde removeSecondaryHsmKey.
  • dbaascli tde rotateMasterKey
    Permet d'effectuer la rotation de la clé principale de chiffrement de base de données.
  • dbaascli tde setKeyVersion
    Pour définir la version de la clé primaire à utiliser dans la base de données/base de données conteneur ou la base de données enfichable, utilisez la commande dbaascli tde setKeyVersion.
  • dbaascli tde setPrimaryHsmKey
    Pour modifier la clé principale du module de sécurité matériel (KMS) pour la configuration existante, utilisez la commande dbaascli tde setPrimaryHsmKey.
  • dbaascli tde status
    Pour afficher des informations sur le magasin de clés pour la base de données spécifiée, exécutez la commande dbaascli tde status.

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

administrateur dbaascli updateAHF

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

Préalables

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

Syntaxe

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

dbaascli admin updateStack

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

Préalables

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

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

Voir 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 vérifications préalables pour cette opération.
  • --nodes indique une liste délimitée par des virgules de noeuds sur lesquels installer le RPM. Si vous ne transmettez pas cet argument, le RPM sera installé sur tous les noeuds de la grappe.

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 spécifie le marqueur 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éalables

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

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

Voir Connexion à une machine virtuelle avec SSH.

Syntaxe

dbaascli cswlib download --version | --imageTag
[--product]
Où :
  • --version indique la version de l'image du répertoire de base Oracle.
  • --imageTag spécifie le marqueur d'image 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 voir la liste des images de base de données et Grid Infrastructure disponibles localement, 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 voir 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

Pour ajouter l'instance de base de données sur le noeud spécifié, utilisez la commande dbaascli database addInstance.

Préalable

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

Syntaxe

dbaascli database addInstance --dbname <value> --node <value> [--newNodeSID <value>]
Où :
  • --dbname spécifie le nom de la base de données Oracle
  • --node indique le nom du noeud pour l'instance de base de données
    • --newNodeSID indique l'IDS de l'instance à ajouter au 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éalable

  • 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 spécifie le nom de la base de données Oracle
  • --list retourne les informations sur la sauvegarde de la base de données

    [--backupType | --json]

    [--backupType spécifie backupType (REGULAR-L0 | REGULAR-L1 | ARCHIVELOG | LONGTERM) ]

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

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

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

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

    [--archival | --archivelog]

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

    --tag spécifie le marqueur de sauvegarde

    [--archivelog ]

  • --delete supprime la sauvegarde d'archivage

    --backupTag spécifie le marqueur de sauvegarde à supprimer

  • --status affiche les détails d'un processus de tâche de sauvegarde

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

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

  • --getBackupReport retourne BackupReport

    --tag | --latest

    --tag spécifie le marqueur de sauvegarde

    --latest retourne le dernier rapport de sauvegarde (tous les types de sauvegarde de base de données)

    --json indique le nom du fichier pour la sortie JSON.

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

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

    --configFile spécifie le fichier de configuration de la sauvegarde de base de données

    --enableRTRT active le transport des informations de journalisation en temps réel

    --disableRTRT désactive le transport des informations de journalisation en temps réel

    --disableCatalog désactive le catalogue de restauration

    --deleteImmutableConfiguration supprime la configuration non mutable

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

    [--configFile | --showOldParams]

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

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

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

    [--untilTime valide à partir de la sauvegarde complète de niveau 0 la plus proche jusqu'au moment indiqué. 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 retourne tous les programmes de sauvegarde pour une base de données indiquée
Note

Les paramètres enableRTRT et disableRTRT ne sont applicables que pour la destination de sauvegarde ZDLRA sur le service Exadata Database sur 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éalables

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 spécifie true ou false pour arrêter et redémarrer la base de données de manière continue. Valeur par défaut : false.

La commande effectue une fermeture de 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 une version ultérieure, toutes les bases de données enfichables 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 de base de données spécifié, utilisez la commande dbaascli database changePassword. À l'invite, entrez le nom d'utilisateur pour lequel vous souhaitez modifier le mot de passe, puis entrez le mot de passe.

Préalables

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 faisant l'objet de l'action
  • --user indique le nom d'utilisateur dont le mot de passe doit être modifié
  • --prepareStandbyBlob indique true pour générer un fichier blob contenant les artefacts nécessaires pour modifier le 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 le fichier BLOB de secours, qui est préparé à partir de la base de données principale
  • --resume indique de reprendre l'exécution précédente
    • --sessionID spécifie de reprendre un ID 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 spécifiée en base de données enfichable, 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 enfichable 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 celui de la base de données non conteneur source.
  • --executePrereqs spécifie d'exécuter uniquement les vérifications de préconversion
  • --copyDatafiles spécifie de créer une nouvelle copie des fichiers de données au lieu de les utiliser à partir de la base de données source

    --keepSourceDB - Pour conserver la base de données source après l'exécution de l'opération.

  • Indicateur --backupPrepared 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 enfichable.
  • Indicateur --backupPrepared 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 enfichable
  • --targetPDBName indique le nom de la base de données enfichable qui sera créée dans le cadre de l'opération
  • --waitForCompletion spécifie 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 spécifie de reprendre un ID session spécifique

Exemple 6-11 : dbaascli database convertToPDB

Pour exécuter des vérifications préalables à la conversion :
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 :
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. À l'invite, entrez les mots de passe sys et tde.

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

Préalable

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 spécifie l'IDS de la base de données.
  • --createAsCDB spécifie true ou false pour créer la 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 enfichable.
  • --pdbAdminUserName indique le nouveau nom d'utilisateur administrateur de la base de données enfichable.
  • --dbCharset spécifie un jeu de caractères de base de données.
  • --dbNCharset spécifie le jeu de caractères national de la base de données.
  • --dbLanguage spécifie la langue de la base de données.
  • --dbTerritory spécifie le territoire de la base de données.
  • --sgaSizeInMB spécifie la valeur sga_target en mégaoctet.
  • --pgaSizeInMB spécifie la valeur pga_aggregate_target en mégaoctet.
  • --datafileDestination indique le nom du groupe de disques ASM à utiliser pour les fichiers de données de base de données.
  • --fraDestination spécifie le nom du groupe de disques ASM à utiliser pour la zone de récupération rapide de la base de données.
  • --fraSizeInMB spécifie la valeur de taille de la zone de récupération rapide en mégaoctet.
  • --nodeList spécifie une liste de noeuds délimités par des virgules pour la base de données.
  • --tdeConfigMethod spécifie la méthode de configuration TDE. Valeurs valides : FILE, KMS
  • --kmsKeyOCID spécifie l'OCID de la clé KMS à utiliser pour TDE. Cela s'applique uniquement si KMS est sélectionné pour TDE
  • --resume reprend l'exécution précédente.
  • --revert repositionne l'exécution précédente
  • --sessionID Pour reprendre ou rétablir un ID session spécifique.
  • --executePrereqs spécifie yes pour exécuter uniquement les préalables pour cette opération. Valeurs valides : yes ou no
  • --honorNodeNumberForInstance spécifie true ou false pour indiquer si les numéros de noeud de grappe doivent être ajoutés en tant que suffixe au nom de l'instance. Valeur par défaut : true
  • --lockPDBAdminAccount spécifie true ou false pour verrouiller le compte d'utilisateur administrateur de la base de données enfichable. Valeur par défaut : true
  • --dbcaTemplateFilePath spécifie le chemin absolu du nom du modèle dbca pour créer la base de données.
  • --waitForCompletion spécifie 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éalable

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 spécifie true ou false pour indiquer la suppression des journaux d'archivage de base de données.
  • --deleteBackups spécifie true ou false pour indiquer la suppression des sauvegardes de base de données.
  • --precheckOnly indique yes pour exécuter uniquement les vérifications préalables pour cette opération. Valeurs valides : yes ou no.
  • --waitForCompletion spécifie false pour exécuter l'opération en arrière-plan. Valeurs valides : true ou false.
  • Indicateur –-force pour forcer la suppression de la base de données.
  • --dbSID spécifie l'IDS de base de données.
  • --resume Pour reprendre l'exécution précédente.
  • --sessionID Pour reprendre un ID 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 spécifié, utilisez la commande dbaascli database deleteInstance.

Préalable

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

Syntaxe

dbaascli database deleteInstance --dbname <value> --node <value> [--continueOnUnreachableNode]
Où :
  • --dbname spécifie le nom de la base de données Oracle
  • --node indique le nom du noeud pour l'instance de base de données
  • --continueOnUnreachableNode spécifie d'effectuer l'opération 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éalable

  • 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 spécifie le nom de la base de données Oracle
  • --sourceDBConnectionString spécifie la chaîne de connexion à la base de données source dans le format <scan_name>:<scan_port>/<database_service_name>
  • --oracleHome indique l'emplacement du répertoire de base Oracle.
  • --oracleHomeName indique le nom du répertoire de base Oracle
  • --dbSID spécifie l'IDS de base de données
  • --dbUniqueName indique le nom unique de la base de données.
  • --sgaSizeInMB spécifie la valeur sga_target en mégaoctets
  • --pgaSizeInMB spécifie la valeur pga_aggregate_target en mégaoctets
  • --datafileDestination indique le nom du groupe de disques ASM à utiliser pour les fichiers de données de base de données
  • --fraDestination spécifie le nom du groupe de disques ASM à utiliser pour la zone de récupération rapide de la base de données
  • --fraSizeInMB spécifie la valeur de taille de la zone de récupération rapide en mégaoctet
  • --sourceDBWalletLocation indique l'emplacement du fichier de portefeuille TDE de la base de données source. Requis pour dupliquer la base de données à partir de la base de données active
  • --nodeList spécifie une liste de noeuds délimités par des virgules pour la base de données.
  • --resume indique de reprendre l'exécution précédente
    • --sessionID spécifie de reprendre un ID session spécifique
  • --revert spécifie de repositionner l'exécution précédente
    • --sessionID indique de repositionner un ID session spécifique
  • --rmanParallelism indique la valeur de parallèle.
  • --rmanSectionSizeInGB spécifie la taille de la section RMAN en Go.
  • --tdeConfigMethod spécifie la méthode de configuration TDE. Les valeurs autorisées sont FILE et KMS.
  • --kmsKeyOCID spécifie l'OCID de la clé KMS à utiliser pour TDE. Cela s'applique uniquement si KMS est sélectionné pour TDE.
  • --sourceDBTdeConfigMethod indique la méthode de configuration TDE de la base de données source. Les valeurs autorisées sont FILE et KMS.
  • --sourceDBKmsKeyOCID spécifie l'OCID de la clé KMS de la base de données source à utiliser pour TDE. Cela s'applique uniquement si KMS est sélectionné pour TDE.
  • --executePrereqs spécifie yes pour exécuter uniquement les préalables pour cette opération. Valeurs valides : yes|no
  • --waitForCompletion spécifie false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false
  • --skipPDBs spécifie une liste de noms de base de données enfichable de base de données source séparés par des virgules, qui doit être exclue pour l'opération de base de données en double. 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 indiquée, par exemple le paramètre dbname, les informations sur le noeud, les informations sur les bases de données enfichables, etc.

Préalables

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

Syntaxe

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

dbaascli database getPDBs

Pour voir la liste des bases de données enfichables 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éalable

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 une liste délimitée par des virgules de paramètres à modifier avec de nouvelles valeurs. Par exemple, parameter1=valueA,parameter2=valueB, etc. Pour les valeurs vides, utilisez parameter1=valueA,parameter2='', etc.
  • --resetParameters indique une liste délimitée par des virgules de paramètres à réinitialiser aux valeurs par défaut correspondantes. Par exemple, parameter1,parameter2, etc.
  • --responseFile spécifie l'emplacement absolu du fichier JSON de réponse pour modifier les paramètres de la base de données.
  • --backupPrepared reconnaît qu'une sauvegarde de base de données appropriée est en place avant la modification des paramètres critiques ou sensibles.
  • --instance indique le nom de l'instance sur laquelle les paramètres seront traités. Si elle n'est pas spécifiée, l'opération sera effectuée au niveau de la base de données.
  • --allowBounce octroie l'autorisation de redémarrer la base de données afin de refléter les modifications apportées aux 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 à un autre, utilisez la commande dbaascli database move.

Préalables

  • Avant d'effectuer une opération de déplacement, assurez-vous que toutes les instances de base de données associées à cette base sont actives.
  • 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 d'accès au 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 des préalables 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'arrêt de la base de données.

  • --resume reprend l'exécution précédente
    • --sessionID spécifie de reprendre un ID session spécifique
  • --rollback repositionne la base de données dans le répertoire de base précédent
    • --sessionID spécifie de reprendre un ID session spécifique
  • --skipDatapatch ignore l'exécution du correctif de données sur les bases de données.
  • --skipPdbs ignore l'exécution du correctif de données sur une liste spécifiée de bases de données enfichables délimitées par des virgules.

    Par exemple : pdb1,pdb2...

  • --skipClosedPDBs ignore l'application de correctifs aux bases de données enfichables fermées
  • --continueWithDbDowntime continue l'application de correctifs avec le temps d'arrêt de la base de données.

    Cette option peut être utilisée dans des environnements où une seule instance est active et où l'application de correctifs peut être poursuivie même avec un temps d'arrêt.

  • --drainTimeoutInSeconds indique le délai (en secondes) pour terminer le drainage des ressources 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 spécifie false pour exécuter l'opération en arrière-plan.

    Valeurs valides : true|false

  • --nodeList spécifie une liste de noeuds délimités par des virgules si l'opération doit être effectuée sur un sous-jeu 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éalable

  • Exécutez la commande en tant qu'utilisateur root.
  • La base de données doit avoir été configurée avec les détails de destination du stockage de sauvegarde où les sauvegardes sont stockées.

Syntaxe

dbaascli database recover --dbname <value>
        {
            --start
                {
                    --untilTime <value>
                    | --untilSCN <value>
                    | --latest
                    | --tag <value>
                }
            | --status --uuid <value>
        }
Où :
--dbname: Oracle Database name.
      --start | --status
--start: Begins database recovery.
      --untilTime | --untilSCN | --latest | --tag
      --untilTime: Recovers database until time. Input format: DD-MON-YYYY HH24:MI:SS.
      --untilSCN: Recovers database until SCN.
      --latest: Recovers database to last known state.
      --tag: Recovers database to archival tag.
--status
      --uuid <value>

Exemple 6-19 : Exemples

  • Pour récupérer la base de données myTestDb au point le plus récent :
    dbaascli database recover --dbname myTestDb --start --latest
  • Pour interroger le statut de la demande de récupération soumise avec uuid 2508ea18be2911eb82d0020017075151 :
    dbaascli database recover --dbname myTestDb --status --uuid 2508ea18be2911eb82d0020017075151

dbaascli database runDatapatch

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

Préalables

  • Avant d'effectuer une opération runDatapatch, assurez-vous que toutes les instances de base de données associées à cette base sont actives.

  • 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 spécifie de reprendre un ID session spécifique
  • --skipPdbs ignore l'exécution du correctif de données sur une liste spécifiée de bases de données enfichables délimitées par des virgules. Par exemple : pdb1,pdb2...
  • --pdbs exécute le correctif de données uniquement sur une liste spécifiée de bases de données enfichables, délimitées par des virgules. Par exemple : pdb1,pdb2...
  • --executePrereqs exécute les vérifications des préalables.
  • --patchList applique ou annule la liste des correctifs délimités par des virgules spécifiée. Par exemple : patch1,patch2...
  • --skipClosedPdbs ignore l'exécution de datapatch sur les bases de données enfichables fermées.
  • --rollback annule l'application des correctifs. 
dbaascli database runDatapatch --dbname db19

dbaascli database createTemplate

Utilisez cette commande pour créer des modèles de base de données (modèles DBCA) qui peuvent ensuite servir à créer des bases de données.

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 spécifié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 charger le modèle dans le stockage d'objets
    • --objectStorageLoginUser : Indique le nom d'utilisateur de connexion au stockage d'objets
    • --objectStorageBucketName : Indique le nom du seau de stockage d'objets
    • --objectStorageUrl : Indique l'URL du stockage d'objets
  • --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éalables

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 spécifie mount ou nomount pour démarrer la base de données en mode correspondant

La commande démarre et ouvre la base de données. Dans Oracle Database 12c ou une version ultérieure, toutes les bases de données enfichables 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éalables

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 d'utilisateur du service.
  • --password indique le mot de passe de l'utilisateur.

La sortie de la commande comprend le mode d'ouverture de la base de données, la version et l'édition du logiciel de la base de données, ainsi que la version d'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éalables

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 effectue une fermeture de base de données en mode immédiat. Aucune nouvelle connexion ni transaction n'est autorisée. Les transactions actives sont repositionné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éalable

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) spécifie 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 Oracle Database cible
  • --standBy : Utilisez cette option pour mettre à niveau les bases de données de secours dans des configurations Data Guard.
  • --allStandbyPrepared est requis pour les bases de données principales configurées par Data Guard. Indicateurs spécifiant 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 supprime automatiquement la sauvegarde de point de restauration garanti uniquement si la mise à niveau de la base de données a réussi.
  • --increaseCompatibleParameter augmente automatiquement le paramètre compatible dans le cadre de la mise à niveau de la base de données. Le paramètre ne sera augmenté que si la mise à niveau de la base de données a réussi
  • --executePrereqs exécute uniquement les vérifications de pré-mise à niveau.
  • --postUpgrade : Utilisez cette option si la post-mise à niveau échoue et doit réexécuter les étapes après la mise à niveau.
  • --rollback rétablit une base de données Oracle dans son répertoire de base Oracle initial
  • --upgradeOptions : Utilisez cette option pour transmettre des arguments propres à DBUA pour effectuer la mise à niveau d'Oracle Database. Reportez-vous à la documentation Oracle correspondante pour connaître les arguments et les options pris en charge.

    --standby

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

Exemple 6-23 : Vérifications préalables à la mise à niveau d'une base de données avec dbaascli

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 du 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 la grappe, 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 dans le format <attribute=value>. 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 de la base de données Oracle.
  • --useImmediateFailover utilise cet indicateur lorsque la configuration Oracle Data Guard est à l'état d'avertissement ou d'erreur.
  • --executePrereqs exécute les vérifications des préalables et signale les résultats.
  • --waitForCompletion indique s'il faut attendre la fin de l'opération. Réglez à false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.

Rubrique parent : Informations de référence sur les commandes dbaascli

Effectuer une opération manuelle de basculement à 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, voir Connexion à une machine virtuelle avec SSH.

  2. Démarrez un interpréteur de commandes d'utilisateur racine, 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. Retournez à l'utilisateur root.
    $ exit
#
  5. Fermez l'interpréteur de commandes de l'utilisateur racine et déconnectez-vous de la machine virtuelle.
    # exit
$ exit

Rubrique parent : dbaascli dataguard failover

dbaascli dataguard rétabli

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 une remise en service est requise (c'est-à-dire une 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 de la base de données Oracle.
  • --primaryDBUniqueName indique le nom unique de la base de données principale courante dans la configuration d'Oracle Data Guard.
  • --executePrereqs exécute les vérifications des préalables et signale les résultats.
  • --waitForCompletion indique s'il faut attendre la fin de l'opération. Réglez à false pour exécuter l'opération en arrière-plan. Valeurs valides : 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 remis en service dans une configuration Data Guard (DG) :

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'ancienne grappe principale :

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

Ces messages indiquent qu'un basculement a eu lieu. Pour restaurer la synchronisation complète au sein de la configuration Data Guard, l'ancienne base principale doit être rétablie.

Rubrique parent : Informations de référence sur les commandes dbaascli

Rétablir une base de données principale ayant échoué à 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, voir Connexion à une machine virtuelle avec SSH.

  2. Lancer la remise en service de la base de données principale en échec.
    $ dbaascli dataguard reinstate --dbname <db-name>

    Dans une configuration de base de données de secours multiple (groupe Data Guard), il est recommandé de spécifier l'argument --primaryDBUniqueName. 

    dbaascli dataguard reinstate --dbname <db-name> --primaryDBUniqueName <primary-DB-unique-name>
  3. Déconnectez-vous de la machine virtuelle.
    $ exit

Rubrique parent : dbaascli dataguard reinstate

dbaascli dataguard permutation

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 de la base de données Oracle.
  • --targetStandbyDBUniqueName indique le nom unique de la base de données de secours pour faire passer le rôle de base de données de secours à base de données principale.
  • --executePrereqs exécute les vérifications des préalables et signale les résultats.
  • --enableDGDebug active les traces lors de l'exécution de l'opération.
  • --waitForCompletion indique s'il faut attendre la fin de l'opération. Réglez à false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.

Rubrique parent : Informations de référence sur les commandes dbaascli

Effectuer 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, voir Connexion à une machine virtuelle avec SSH.

  2. Démarrez un interpréteur de commandes d'utilisateur racine, puis passez à l'utilisateur oracle.
    $ sudo -s
# su - oracle
$
  3. Lancez la migration vers la base de données de secours.
    $ dbaascli dataguard switchover --dbname <db-name>

    Dans une configuration de base de données de secours multiple (groupe Data Guard), il est recommandé de spécifier l'argument --targetStandbyDBUniqueName. 

    dbaascli dataguard switchover --dbname <db-name> --targetStandbyDBUniqueName <target-standby-DB-unique-name>
  4. Retournez à l'utilisateur root.
    $ exit
#
  5. Fermez l'interpréteur de commandes de l'utilisateur racine et déconnectez-vous de la machine virtuelle.
    # exit
$ exit

Rubrique parent : dbaascli dataguard switchover

dbaascli dataguard prepareForStandby

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

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

Note

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 la trousse 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 de la base de données Oracle.
  • --standbyDBUniqueName indique le nom unique de la base de données de secours pour laquelle la base de données principale sera configurée.
  • --standbyDBDomain indique le domaine de la base de données de secours pour lequel 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élimitée par des virgules d'adresses IP correspondant au module d'écoute SCAN de la base de données de secours ou au nom SCAN de la base de données de secours.
  • --standbyScanPort indique le numéro de port SCAN correspondant de la base de données de secours.
  • --standbyServiceName indique 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élimitée par des virgules d'adresses IP correspondant au module d'écoute SCAN de la base de données principale ou au nom SCAN de la base de données principale.
  • --primaryScanPort indique le numéro de port SCAN correspondant de la base de données principale.
  • --executePrereqs exécute les vérifications des préalables et signale les résultats.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.
  • --revert restaure l'opération précédente.
  • --waitForCompletion indique s'il faut attendre la fin de l'opération. Réglez à false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.
  • --skipDRConfiguration indique si la configuration de 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 DR) ou false (configurer DR).

Rubrique parent : Informations de référence sur les 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 nouvelle base de données de secours, utilisez la commande dbaascli dataguard prepareForStandby.

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

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

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur racine .
    $ sudo -s
  3. Exécutez la commande prepareForStandby. Entrez le mot de passe SYS à l'invite.
    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>

    Une fois l'opération terminée, la commande affiche l'emplacement de création du fichier BLOB de secours.

  4. Fermez l'interpréteur de commandes de l'utilisateur racine et déconnectez-vous de la machine virtuelle.
    #  exit

dbaascli dataguard configureStandby

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

Exécutez ceci en tant qu'utilisateur root sur la grappe 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 de la base de données Oracle.
  • --oracleHome indique le chemin du répertoire de base Oracle.
  • --oracleHomeName indique le nom du répertoire de base Oracle.
  • --standbyDBUniqueName indique le nom unique de la base de données de secours.
  • --standbyDBDomain indique le domaine de la base de données de secours pour lequel 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élimitée par des virgules d'adresses IP correspondant au module d'écoute SCAN de la base de données principale ou au nom SCAN de la base de données principale.
  • --primaryScanPort indique le numéro de port SCAN correspondant du service de base de données principale.
  • --primaryServiceName indique 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 de transport Data Guard à définir lors de la configuration de la base de données de secours. Valeurs valides : ASYNC|SYNC.
  • --activeDG indique si la configuration Data Guard sera active ou non. Valeurs valides : true|false.
  • --standbyBlobFromPrimary indique l'emplacement du fichier BLOB de secours, qui est préparé à partir de la base de données principale. Cette opération n'est requise que pour les opérations de secours.
  • --standbyDBInfoJsonLocation indique l'emplacement du fichier d'informations généré à partir de la base de données principale pour l'exportation de métadonnées supplémentaires. Cette option n'est requise que pour les opérations de secours.
  • --standbyScanIPAddresses indique une liste délimitée par des virgules d'adresses IP correspondant au module d'écoute SCAN de la base de données de secours ou au nom SCAN de la base de données de secours.
  • --standbyScanPort indique le numéro de port SCAN correspondant de la base de données de secours.
  • --standbySID indique l'IDS de la base de données de secours pour la configuration de la base de données de secours.
  • --nodeList indique la liste des noeuds sur lesquels la base de données de secours doit s'exécuter, y compris les noeuds qui sont déjà en cours d'exécution ou configurés.
  • --skipAWRConfiguration indique si la configuration du référentiel AWR Oracle doit être ignorée dans le cadre de la configuration de la base de données de secours. Valeurs valides : true (ignorer la configuration AWR) ou false (configurer AWR).
  • --primaryDBOCID indique la valeur de l'OCID de la ressource correspondant à la base de données principale.
  • --sgaSizeInMB indique la valeur sga_target en Mo.
  • --pgaSizeInMB spécifie 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 la base de données.
  • --redoLogDestination indique l'emplacement de stockage à utiliser pour les fichiers de journalisation.
  • --fraSizeInMB spécifie la valeur de taille de la zone de récupération rapide en Mo.
  • --tdeKeyStoreType indique le type de magasin de clés TDE. Valeurs valides : FILE|KMS|AZURE|GOOGLE|AWS|OKV
  • --tdeKeyOCID spécifie l'OCID de la clé KMS/AZURE/GOOGLE/AWS à utiliser pour TDE. Cela s'applique uniquement si KMS/AZURE/GOOGLE/AWS est sélectionné pour le type de magasin de clés TDE.
  • --executePrereqs exécute les vérifications des préalables et signale les résultats.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.
  • --revert restaure l'opération précédente.
  • --waitForCompletion indique s'il faut attendre la fin de l'opération. Réglez à false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.
  • --enableFIPS indique si FIPS doit être activé. Réglez à false pour la désactiver. Valeurs valides : true|false.
  • --skipDRConfiguration indique si la configuration de 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 DR) ou false (configurer DR).
  • --okvServer indique le serveur Oracle Key Vault. Liste séparée par des virgules de plusieurs adresses IP.
  • --okvAdminUserName indique le nom d'utilisateur de l'administrateur Oracle Key Vault.
  • --okvServerRestPort indique le numéro de port REST pour Oracle Key Vault.
  • --okvWalletName indique le nom du portefeuille Oracle Key Vault.

Rubrique parent : Informations de référence sur les 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 sur laquelle vous souhaitez héberger la base de données de secours en tant qu'utilisateur opc.

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

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur racine .
    $ 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 de la base de données principale SYS, TDE et AWR à l'invite.

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

dbaascli dataguard registerStandby

Pour enregistrer une nouvelle base de données de secours avec toutes les bases de données de secours existantes et dans 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 la grappe principale. En outre, dans une configuration à plusieurs bases de données de secours, exécutez la commande sur tous les grappes de secours, à l'exception de la nouvelle grappe de bases de données de secours créée.

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 de la base de données Oracle.
  • --standbyDBUniqueName indique le nom unique de la base de données de secours à enregistrer dans la configuration d'Oracle Data Guard Broker.
  • --standbyDBDomain indique le domaine de la base de données de secours pour lequel 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élimitée par des virgules d'adresses IP correspondant au module d'écoute SCAN de la base de données de secours ou au nom SCAN de la base de données de secours.
  • --standbyScanPort indique le numéro de port SCAN correspondant de la base de données de secours.
  • --standbyServiceName indique 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 des préalables et signale les résultats.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.
  • --revert restaure l'opération précédente.
  • --waitForCompletion indique s'il faut attendre la fin de l'opération. Réglez à false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.

Rubrique parent : Informations de référence sur les commandes dbaascli

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

Pour enregistrer la base de données de secours spécifiée dans la configuration d'Oracle Data Guard Broker, utilisez la commande dbaascli dataguard registerStandby.

Pour les cas d'utilisation de base de données de secours unique, la commande registerStandby doit être exécutée uniquement sur la grappe principale, 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 la grappe principale et sur toutes les grappes de secours existantes, à l'exclusion de l'ajout de la nouvelle base de données de secours.

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 à enregistrer. Dans ce cas, exécutez la commande registerStandby sur la grappe principale 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 de données principale et sur toutes les autres grappes de secours enregistrées précédemment, à l'exception de la nouvelle base de données de secours ajoutée.

  1. Connectez-vous à la grappe principale de la configuration Data Guard en tant qu'utilisateur opc.

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

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur racine .
    $ 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 terminée, la base de données de secours spécifiée sera enregistrée dans la configuration d'Oracle Data Guard Broker.

  4. Répétez les étapes 1 à 3, telles qu'elles ont été effectuées sur la grappe principale, sur toutes les grappes de secours existantes dans la configuration Oracle Data Guard Broker, à l'exception de celle qui est enregistrée.

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 de la grappe de secours pour annuler l'enregistrement de la base de données de secours dans la configuration d'Oracle Data Guard Broker.

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

Syntaxe

dbaascli dataguard deregisterStandby --dbname <value> --standbyDBUniqueName <value> [--executePrereqs] [--resume [--sessionID <value>]] [--waitForCompletion <value>]
Où :
  • --dbname indique le nom de la base de données Oracle.
  • --standbyDBUniqueName indique le nom unique de la base de données de secours à annuler de la configuration d'Oracle Data Guard Broker.
  • --executePrereqs exécute les vérifications des préalables et signale les résultats.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.
  • --waitForCompletion indique s'il faut attendre la fin de l'opération. Réglez à false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.

Rubrique parent : Informations de référence sur les 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 de la grappe de secours pour annuler l'enregistrement de la base de données de secours dans la configuration d'Oracle Data Guard Broker.

Pour les cas d'utilisation de base de données de secours unique, la commande deregisterStandby doit être exécutée uniquement sur la grappe principale, 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 la grappe principale et sur toutes les grappes de secours existantes, à l'exclusion de la base de données de secours actuellement en cours d'annulation d'enregistrement.

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 la grappe principale 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 la grappe principale et sur toutes les autres grappes de secours existantes avant l'opération de suppression de base de données sur la grappe de secours souhaitée.

  1. Connectez-vous à la grappe principale de la configuration Oracle Data Guard en tant qu'utilisateur opc.

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

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur racine .
    $ 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 spécifiée sera désenregistrée (supprimée) de la configuration d'Oracle Data Guard Broker.

  4. Répétez les étapes 1 à 3, telles qu'elles ont été effectuées sur la grappe principale, sur toutes les grappes de secours existantes de la configuration Oracle Data Guard Broker, à l'exception de celle qui est annulée.

dbaascli dataguard configureAWR

Pour activer ou désactiver la configuration du référentiel AWR (Automatic Workload Repository) sur votre 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 la grappe de secours Active Data Guard où vous voulez 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 la base de secours.

Syntaxe

dbaascli dataguard configureAWR --dbname <value> { --action <value> | --enable | --disable } [--executePrereqs] [--resume [--sessionID <value>]]
Où :
  • --dbname indique le nom de la base de données Oracle.
  • --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. Toutefois, 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 des préalables et signale les résultats.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.

Rubrique parent : Informations de référence sur les 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 sur laquelle votre base de données de secours ADG est hébergée en tant qu'utilisateur opc.

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

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur racine .
    $ 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 à l'invite.

    Une fois la commande terminé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, le mode de protection ou les deux paramètres d'un environnement Data Guard, utilisez la commande dbaascli dataguard updateConfiguration.

Exécutez ceci en tant qu'utilisateur root.

Lorsque la commande de mise à jour du 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 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 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 principale, le système vérifie les modes courants 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 de la base de données Oracle.
  • --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 de transport Data Guard à définir lors de la configuration 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 des préalables et signale les résultats.
  • --resume reprend l'opération précédente.
  • --sessionID reprend une session spécifique par son ID.
  • --waitForCompletion indique s'il faut attendre la fin de l'opération. Réglez à false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.

Rubrique parent : Informations de référence sur les 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 paramètres, utilisez la commande dbaascli dataguard updateConfiguration.

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

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

  2. Démarrez un interpréteur de commandes en tant qu'utilisateur racine .
    $ 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 terminée, Data Guard spécifié sera configuré avec le mode de transport ou le mode de protection spécifié.

dbaascli dbhome create

Pour créer un répertoire de base Oracle Database avec la version voulue, utilisez la commande dbaascli dbhome create.

Préalable

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 spécifiée 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 indiqué, le nom par défaut sera utilisé
  • --enableUnifiedAuditing spécifie true ou false pour activer ou désactiver l'option de lien de vérification unifiée dans le répertoire de base Oracle.
  • --imageTag spécifie le marqueur d'image du répertoire de base Oracle.
  • --imageLocation - Chemin de l'image à utiliser.
  • --waitForCompletion spécifie 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 marqueurs d'image sont différents de la version.

dbaascli dbHome delete

Pour supprimer un répertoire de base Oracle Database indiqué, utilisez la commande dbaascli dbHome delete.

Préalable

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 spécifie de reprendre un ID session spécifique

dbaascli dbhome getDatabases

Pour voir les informations sur toutes les bases de données Oracle s'exécutant à partir d'un répertoire de base Oracle de base de données indiqué, utilisez la commande dbaascli dbHome getDatabases. Indiquez l'emplacement du répertoire de base Oracle 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 de 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 voir des informations sur un répertoire de base Oracle spécifique, utilisez la commande dbaascli dbHome getDetails. Indiquez l'emplacement du répertoire de base Oracle ou le nom du répertoire de base Oracle.

Préalable

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

Syntaxe

dbaascli dbHome getDetails
{ --oracleHomeName value | --oracleHome value }
Où :
  • --oracleHomeName indique le nom de 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 de répertoire de base Oracle

dbaascli dbHome getDetails --oracleHomeName home_db19c

dbaascli dbHome patch

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

Préalable

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>]
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 du répertoire de base Oracle spécifiée 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 spécifie de reprendre un ID session spécifique
  • --continueWithDbDowntime continue l'application de correctifs avec le temps d'arrêt de la base de données. Cette option peut être utilisée dans des environnements où une seule instance est active et où l'application de correctifs peut être poursuivie même avec un temps d'arrêt.
  • --skipUnreachableNodes ignore l'opération sur les noeuds inaccessibles.
  • --nodes spécifie une liste de noeuds délimités par des virgules si l'application de correctifs doit être effectuée sur un sous-jeu de noeuds.
  • --executePrereqs exécute les préalables
  • --skipDatapatch ignore l'exécution de datapatch sur les bases de données.
  • --imageFilePath indique le chemin absolu du fichier d'image à utiliser
  • --skipPDBs ignore l'exécution du correctif de données sur une liste spécifiée de bases de données enfichables délimitées par des virgules. Par exemple : cdb1:pdb1,cdb2:pdb2, etc.
  • --skipClosedPdbs ignore l'exécution de datapatch sur les bases de données enfichables fermées
  • --rollback annule l'application de correctifs 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 le délai (en secondes) pour terminer le drainage des ressources lors de l'arrêt de la base de données
  • --skipUnreachableNodes ignore l'opération sur les noeuds inaccessibles.

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 supprime l'image logicielle spécifiée de votre 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 — Spécifie la version du logiciel Oracle Database. Par exemple, 11204, 12102, 12201, 18000, 19000.

  • software_bp — Identifie la version du correctif d'ensemble. Par exemple, APR2018, JAN2019, OCT2019, etc.

  • --cdb — Indique éventuellement s'il faut supprimer l'image logicielle prenant en charge l'architecture multilocataire Oracle. La valeur par défaut est yes. Si vous spécifiez --cdb no, l'image logicielle qui contient des binaires pour prendre en charge les bases de données non conteneur est supprimée.

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

Vous ne pouvez pas supprimer l'image logicielle courante par défaut d'une version de logiciel. Pour éviter cette restriction, vous devez définir une autre image logicielle en tant qu'image par défaut courante.

dbaascli diag collect

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

Préalable

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 une liste de 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 une liste de noeuds délimités par des virgules pour collecter les journaux.
  • --dbNames indique le nom de la base de données pour laquelle collecter les journaux. Vous ne pouvez spécifier qu'un nom de base de données.
  • --objectStoreBucketURI indique une URL de demande préauthentifiée du service de stockage d'objets utilisée pour charger les journaux collectés. Les journaux sont collectés à partir de la machine virtuelle invitée. Pour plus d'informations, voir Utilisation de demandes préauthentifiées.
  • --destLocation spécifie l'emplacement sur la machine virtuelle invitée pour collecter les journaux. Valeur par défaut : /var/opt/oracle/dbaas_acfs
  • Valeurs --waitForCompletion : true|false. Valeur par défaut : true. Spécifiez false pour une exécution en arrière-plan.

dbaascli diag healthCheck

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

Préalable

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

Syntaxe

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

dbaascli gridHome créer

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

Préalable

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 de la grille.
  • --resume reprend l'exécution précédente
    • --sessionID spécifie de reprendre un ID session spécifique
  • --waitForCompletion spécifie false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false

dbaascli grid configureTCPS

Pour configurer TCPS pour la grappe existante, utilisez la commande dbaascli grid configureTCPS.

Préalable

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

Syntaxe

Note

Par défaut, TCPS est activé pour les bases de données du service Oracle Exadata Database sur des systèmes dotés d'une infrastructure dédiée.
Note

TCPS n'est pas activé pour les bases de données du service Exadata Database sur les systèmes Cloud@Customer. Pour activer TCPS pour une base de données indiquée, 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. Cela activera l'utilisation de TCPS pour la base de données. Toutefois, l'activation de TCPS entraînera l'échec de la connexion ZDLRA. Dans le service Exadata Database sur les systèmes Cloud@Customer, vous pouvez activer la configuration ZDLRA ou TCPS. L'activation simultanée de ZDLRA et de TCPS ne fonctionnera pas. 
dbaascli grid configureTCPS
[--pkcs12WalletPath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Où :
  • --pkcs12WalletPath indique le chemin du certificat, qui est au format de portefeuille pkcs12.
  • --caCertChain indique la liste concaténée des certificats contenant des certificats intermédiaires et des certificats racines de l'autorité de certification.
  • --precheckOnly indique yes pour exécuter uniquement les vérifications préalables pour cette opération. Valeurs valides : yes ou no.
  • --serverCert indique le chemin du certificat PEM à utiliser ou sur lequel effectuer la rotation pour la configuration TCPS.
  • --privateKey indique le chemin d'accès au fichier de clé privée du certificat.
  • Type --certType 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 ou non par un mot de passe. Valeurs valides : true ou false. Valeur par défaut : true.

Exemple 6-29 : dbaascli grid configureTCPS

Pour configurer Grid Infrastructure à l'aide d'un certificat auto-signé :
dbaascli grid configureTCPS
Pour configurer Grid Infrastructure à l'aide d'un certificat signé par l'autorité de certification :
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 des correctifs à Oracle Grid Infrastructure pour la version mineure spécifiée, utilisez la commande dbaascli grid patch.

Préalables

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, spécifiée 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 d'accès complet du répertoire de base Grid Infrastructure cible pour l'application de correctifs dans un emplacement différent
  • --containerURL spécifie l'URL personnalisée pour l'extraction de l'image Grid Infrastructure.
  • --executePrereqs - Option permettant d'exécuter les préalables.
  • --nodeList spécifie une liste de noeuds délimités par des virgules si l'application de correctifs doit être effectuée sur un sous-jeu de noeuds.
  • --patchInParallel indique d'exécuter l'application de correctifs aux noeuds distants en parallèle
  • --rollback indique d'annuler l'application de correctifs au répertoire de base Oracle.
  • --resume reprend l'exécution précédente
    • --sessionID spécifie de reprendre un ID session spécifique
  • --continueWithDbDowntime continue l'application de correctifs avec le temps d'arrêt de la base de données. Cette option peut être utilisée dans des environnements où seule 1 instance est active et où l'application de correctifs peut être poursuivie même avec un temps d'arrêt.
  • --drainTimeoutInSeconds indique le délai (en secondes) pour terminer le drainage des ressources 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 Infrastructure actif, corrigée à la version cible spécifiée
    • --createImageDir indique le chemin d'accès complet au répertoire où l'image doit être créée
  • --imageFile spécifie le chemin d'accès complet à l'image à utiliser
  • --patchInParallel effectue l'application de correctifs aux noeuds distants en parallèle
  • --waitForCompletion spécifie 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

grille dbaascli removeTCPSCert

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

Préalable

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 spécifie l'objet du certificat
  • Indicateur --userCert pour indiquer le certificat d'utilisateur
  • Indicateur --trustedCert pour indiquer un certificat approuvé
  • Indicateur --requestedCert pour indiquer le certificat demandé
  • --serialNumber indique le numéro de série du certificat
  • --executePrereqs exécute les vérifications des préalables et signale les résultats.
  • --resume reprend l'exécution précédente
    • --sessionID spécifie de reprendre un ID session spécifique
  • Indicateur --bounceListeners pour arrêter/redémarrer le module d'écoute Grid Infrastructure et balayer le module d'écoute

dbaascli grid rotateTCPSCert

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

Préalable

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, qui est au format de portefeuille pkcs12.
  • --caCertChain indique la liste concaténée des certificats contenant des certificats intermédiaires et des certificats racines de l'autorité de certification.
  • --precheckOnly indique yes pour exécuter uniquement les vérifications préalables pour cette opération. Valeurs valides : yes ou no.
  • --serverCert indique le chemin du certificat PEM à utiliser ou sur lequel effectuer la rotation pour la configuration TCPS.
  • --privateKey indique le chemin d'accès au fichier de clé privée du certificat.
  • Type --certType 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 ou non par un mot de passe. Valeurs valides : true ou false. Valeur par défaut : true.

Exemple 6-31 : dbaascli grid rotateTCPSCert

Pour effectuer la rotation des certificats à l'aide d'un certificat auto-signé (option par défaut) :
dbaascli grid rotateTCPSCert
Pour effectuer la rotation des certificats à l'aide d'un certificat signé par l'autorité de certification :
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 à une autre, utilisez la commande dbaascli grid upgrade.

Préalable

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 des préalables pour la mise à niveau de Grid Infrastructure.
  • --containerUrl spécifie l'URL personnalisée pour l'extraction de l'image Grid Infrastructure.
  • --softwareOnly installe uniquement le logiciel Grid Infrastructure.
  • --targetHome indique le chemin d'accès au répertoire de base Grid Infrastructure existant.
  • --revert annule l'échec de l'exécution.

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 voir le statut d'une tâche spécifiée, utilisez la commande dbaascli job getStatus.

Préalable

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

Syntaxe

dbaascli job getStatus --jobID
Où :
  • --jodID indique l'ID tâche.

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

Note

Les commandes dbaascli patch db prereq et dbaascli patch db apply sont obsolètes dans la version dbaascli 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, voir :
  • dbaascli grid patch
  • dbaascli dbhome patch
  • dbaascli database move
  • Application de correctifs à Oracle Grid Infrastructure et aux bases de données Oracle à l'aide de dbaascli

dbaascli patch db prereq

Note

Les commandes dbaascli patch db prereq et dbaascli patch db apply sont obsolètes dans la version dbaascli 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, voir :
  • dbaascli grid patch
  • dbaascli dbhome patch
  • dbaascli database move
  • Application de correctifs à Oracle Grid Infrastructure et aux bases de données Oracle à l'aide de dbaascli

dbaascli pdb backup

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

Préalable

  • 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 level1 pour une base de données enfichable pdb1 dans une base de données conteneur myTestDb :
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --start --level1
  • Pour interroger le statut de la demande de sauvegarde de base de données enfichable soumise avec uuid eef16b26361411ecb13800163e8e4fac :
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --status --uuid eef16b26361411ecb13800163e8e4fac

dbaascli pdb bounce

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

Préalable

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

Syntaxe

dbaascli pdb bounce --dbname --pdbName | --pdbUID
[–openMode]
Où :
  • --dbname indique le nom de la base de données conteneur qui héberge la base de données enfichable.
  • --pdbName indique le nom de la base de données enfichable.
  • --pdbUID indique l'identificateur de la base de données enfichable
  • --openMode indique le mode d'ouverture (OPEN MODE) cible de la base de données enfichable.

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 enfichable, exécutez la commande dbaascli pdb close.

Préalable

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

Syntaxe

dbaascli pdb close --dbname --pdbName | --pdbUID
Où :
  • --dbname indique le nom de la base de données conteneur qui héberge la base de données enfichable.
  • --pdbname indique le nom de la base de données enfichable à fermer.
  • --pdbUID indique l'identificateur de la base de données enfichable

Une fois la commande exécutée, la base de données enfichable est fermée sur toutes les instances de 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

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

Préalable

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

Syntaxe

dbaascli pdb getConnectString --dbname --pdbName | --pdbUID
Où :
  • --dbname indique le nom de la base de données conteneur qui héberge la base de données enfichable.
  • --pdbname indique le nom de la base de données enfichable pour laquelle vous voulez afficher les informations de chaîne de connexion.
  • --pdbUID indique l'identificateur de la base de données enfichable

Exemple 6-37 : dbaascli pdb getConnectString

dbaascli pdb getConnectString --dbname dbname --pdbName pdbName

dbaascli pdb create

Pour créer une nouvelle base de données enfichable, exécutez la commande dbaascli pdb create.

Préalable

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 <value>] 
[--waitForCompletion <value>] 
[--blobLocation |--standbyBlobFromPrimary <value>]
Où :
  • --pdbName indique le nom de la nouvelle base de données enfichable que vous voulez créer.
  • --dbName indique le nom de la base de données conteneur hébergeant la nouvelle base de données enfichable.
  • --maxCPU spécifie facultativement le nombre maximum d'UC disponibles pour la base de données enfichable. La définition de cette option équivaut à configurer le paramètre CPU_COUNT dans la base de données enfichable
  • --maxSize spécifie éventuellement la taille totale maximum des fichiers de données et des fichiers temporaires pour les espaces-tables appartenant à la base de données enfichable. La définition de cette option équivaut à configurer la clause de stockage de la base de données enfichable MAXSIZE dans la commande SQL CREATE PLUGGABLE DATABASE. Vous pouvez imposer une limite en spécifiant un entier suivi d'une unité de taille (K, M, G ou T), ou vous pouvez spécifier UNLIMITED pour n'appliquer explicitement aucune limite.
  • --pdbAdminUserName indique le nouveau nom d'utilisateur administrateur de la base de données enfichable
  • --lockPDBAdminAccount spécifie true ou false pour verrouiller le compte d'utilisateur administrateur de la base de données enfichable. Valeur par défaut : true.
  • --resume reprend l'exécution précédente
    • --sessionID spécifie de reprendre un ID session spécifique
  • --executePrereqs spécifie yes pour exécuter uniquement les préalables pour cette opération. Valeurs valides : yes ou no
  • --waitForCompletion spécifie false pour exécuter l'opération en arrière-plan. Valeurs valides : true ou false
  • --blobLocation Emplacement de 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, qui est préparé à partir de la base de données principale. Cette opération n'est requise que pour les opérations de base de données enfichable de secours.
    Note

    Les paramètresblobLocation et standbyBlobFromPrimary s'excluent mutuellement.

Lors du processus de création de la base de données enfichable, vous êtes invité à spécifier son mot de passe d'administration.

Exemple 6-38 : dbaascli pdb create

Pour créer une base de données enfichable à partir d'une base de données prédéfinie dans un environnement non Data Guard :
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --maxsize 5G --maxcpu 2
Pour créer une base de données enfichable dans l'environnement Data Guard :
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 enfichable, exécutez la commande dbaascli pdb delete.

Préalable

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

Syntaxe

dbaascli pdb delete --dbName value 
{ --pdbName value | --pdbUID value }
[--executePrereqs value]
[--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 enfichable.
  • --pdbName indique le nom de la base de données enfichable à supprimer
  • --pdbUID indique l'UID de la base de données enfichable à supprimer
  • --executePrereqs spécifie yes pour exécuter uniquement les préalables pour cette opération. Valeurs valides : yes ou no
  • --waitForCompletion spécifie 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 spécifie de reprendre un ID session spécifique
  • --allStandbyPrepared indique de confirmer que l'opération a été exécutée avec succès sur toutes les bases de données de secours
  • --cleanupRelocatedPDB - Option permettant de nettoyer la base de données source après le déplacement d'une base de données enfichable.
Exemple : dbaascli pdb delete

Pour supprimer une base de données enfichable d'une base de données standard dans un environnement non Data Guard ou de la 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 enfichable à partir de la base de données principale dans l'environnement Data Guard : 

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

dbaascli pdb getDetails

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

Préalable

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

Syntaxe

dbaascli pdb getDetails --dbname --pdbName | --pdbUID
Où :
  • --dbname indique le nom de la base de données conteneur qui héberge la base de données enfichable.
  • --pdbname indique le nom de la base de données enfichable à supprimer.
  • --pdbUID indique l'identificateur de la base de données enfichable

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 voir la liste des bases de données enfichables dans une base de données conteneur, utilisez la commande dbaascli pdb list.

Préalable

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 enfichable.

Exemple 6-40 : dbaascli pdb list

dbaascli pdb list --dbname cdb name

dbaascli pdb localClone

Pour créer une nouvelle base de données enfichable en tant que clone d'une base de données enfichable existante dans la même base de données conteneur, exécutez la commande dbaascli pdb localClone.

Préalable

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>]
Où :
  • --pdbName indique le nom de la nouvelle base de données enfichable que vous voulez cloner.
  • --dbName indique le nom de la base de données
  • --targetPDBName indique le nom de la base de données enfichable cible (nouvelle base de données enfichable 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 spécifie le nombre maximum d'UC à affecter pour la base de données enfichable
  • --maxSize indique la taille de stockage maximale en Go pour la nouvelle base de données enfichable
  • --resume reprend l'exécution précédente
    • --sessionID spécifie de reprendre un ID session spécifique
  • --executePrereqs spécifie yes pour exécuter uniquement les préalables pour cette opération. Valeurs valides : yes ou no
  • --waitForCompletion spécifie false pour exécuter l'opération en arrière-plan. Valeurs valides : true ou false
  • --blobLocation Emplacement de 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, qui est préparé à partir de la base de données principale. Cette opération n'est requise que pour les opérations de base de données enfichable de secours.
    Note

    Les paramètres --blobLocation et --standbyBlobFromPrimary s'excluent mutuellement.
  • Option --excludeUserTablespaces pour ignorer les espaces-tables utilisateur, par exemple t1,t2,t3.
  • --excludePDBData spécifie true/yes pour ignorer les données d'utilisateur de la base de données enfichable source.
  • --pdbAdminUserName indique le nouveau nom d'utilisateur administrateur de la base de données enfichable.
  • --lockPDBAdminAccount spécifie true ou false pour verrouiller le compte d'utilisateur administrateur de la base de données enfichable. Valeur par défaut : true.
  • --sourcePDBServiceConvertList spécifie une liste de noms de service source à cible, séparés par des virgules, à convertir. La syntaxe est source_srv1:new_srv1,source_srv2:new_srv2.

La nouvelle base de données clonée hérite des mots de passe d'administration de la base de données enfichable 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 enfichable, exécutez 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>]]
Où :
  • --pdbName indique le nom de la base de données enfichable que vous voulez ouvrir.
  • --pdbUID indique l'identificateur de la base de données enfichable
  • --dbname indique le nom de la base de données conteneur qui héberge la base de données enfichable.
  • --openMode indique le mode d'ouverture cible de la base de données enfichable
  • --startServices : Indique de démarrer ou lister tous les services correspondant à une base de données enfichable. Les valeurs acceptées sont all ou une liste délimitée par des virgules de services de base de données enfichable.
  • --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 enfichable actualisable en base de données enfichable non actualisable
    • --skipPDBRefresh : Indique d'ignorer l'actualisation de la base de données enfichable actualisable
    • --pdbAdminUserName : indique le nouveau nom d'utilisateur administrateur de la base de données enfichable

Une fois la commande exécutée, la base de données enfichable est ouverte sur toutes les instances de 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 enfichable, utilisez la commande dbaascli pdb recover.

Préalable

  • Exécutez la commande en tant qu'utilisateur root.
  • La base de données doit être configurée avec les détails de destination du stockage de sauvegarde où les sauvegardes sont stockées.

Syntaxe

dbaascli pdb recover --pdbName <value> --dbname <value>
        {
            --start
                {
                    --untilTime <value>
                    | --untilSCN <value>
                    | --latest
                    | --tag <value>
                }
            | --status --uuid <value>
        }
Où :
--pdbName: PDB name.
--dbname: Oracle Database name.
--start | --status
--start
       --untilTime | --untilSCN | --latest | --tag
       --untilTime: Recovers PDB until time. Input format: DD-MON-YYYY HH24:MI:SS.
       --untilSCN: Recovers PDB until SCN.
       --latest: Recovers PDB to last known state.
       --tag: Recovers PDB to archival tag.
--status
       --uuid <value>

Exemple 6-43 : Exemples

  • Pour récupérer une base de données enfichable pdb1 dans une base de données conteneur myTestDb au point le plus récent :
    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 enfichable soumise avec uuid 81a17352362011ecbc3000163e8e4fac :
    dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --status --uuid 81a17352362011ecbc3000163e8e4fac

dbaascli pdb refresh

Pour actualiser une base de données enfichable spécifiée, 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 enfichable
  • --pdbUID : Indique l'identificateur de la base de données enfichable
  • --waitForCompletion : Indiquez false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false

dbaascli pdb relocate

Pour déplacer la base de données enfichable spécifiée de la base de données distante vers la base de données locale, utilisez la commande dbaascli pdb relocate.

Préalable

Exécutez la commande en tant qu'utilisateur oracle. À l'invite, 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 <value>]
[--sourcePDBServices <value>]
[--sourcePDBReadOnlyServices <value>]
[--waitForCompletion <value>]
{
    [--blobLocation <value>] | [--standbyBlobFromPrimary <value>]
}
[--upgradePDB <value>]
[--updateDBBlockCacheSize]
{
    [skipOpenPDB] | [--completePDBRelocate]
}
Où :
  • --pdbName indique le nom de la base de données enfichable source à déplacer
  • --dbName indique le nom de la base de données cible
  • --sourceDBConnectionString spécifie la chaîne de connexion à la base de données source dans le format <scan_name>:<scan_port>/<database_service_name>
  • --targetPDBName spécifie un nom pour la base de données enfichable cible (nouvelle base de données enfichable déplacée)
  • --powerLimit indique le degré de parallélisme à utiliser pour l'opération de déplacement
  • --maxCpu spécifie le nombre maximum d'UC à affecter pour la base de données enfichable
  • --maxSize indique la taille de stockage maximale en Go pour la nouvelle base de données enfichable
  • --resume indique de reprendre l'exécution précédente
    • --sessionID spécifie de reprendre un ID session spécifique
  • --executePrereqs spécifie yes pour exécuter uniquement les préalables pour cette opération. Valeurs valides : yes|no
  • --sourcePDBServices indique une liste de services de base de données enfichable source délimités par des virgules
  • --sourcePDBReadOnlyServices spécifie une liste délimitée par des virgules de services en lecture seule de la base de données enfichable source.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false
  • --blobLocation Emplacement de 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, qui est préparé à partir de la base de données principale. Cette opération n'est requise que pour les opérations de secours.
    Note

    Les paramètres --blobLocation et s'excluent mutuellement.
  • --upgradePDB Spécifie true pour mettre à niveau la base de données enfichable dans le cadre de cette opération. Valeurs valides : true | false.
  • --updateDBBlockCachesize - Option permettant à l'application de définir les paramètres d'initialisation de la taille de la mémoire cache de blocs de base de données afin de prendre en charge la copie de données avec une taille de bloc différente.
  • --skipOpenPDB - Permet d'indiquer que la base de données enfichable ne doit pas être ouverte à la fin de l'opération courante.
  • --completePDBRelocate - Permet de terminer le déplacement de la base de données enfichable si cette opération comprend deux étapes.

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 enfichable en tant que clone d'une base de données enfichable existante dans une autre base de données conteneur, exécutez 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>] 
[--refreshablePDB --refreshMode <value> [--refreshIntervalInMinutes <value>] --dblinkUsername <value> [--honorCaseSensitiveUserName]] 
[--updateDBBlockCacheSize]
Où :
  • --pdbName indique le nom de la base de données enfichable source à cloner
  • --dbname spécifie le nom (DB_NAME) de la base de données conteneur hébergeant la base de données enfichable nouvellement clonée
  • --sourceDBConnectionString spécifie la chaîne de connexion à la base de données source dans le format scan_name:scan_port/database_service_name
  • --targetPDBName indique le nom de la base de données enfichable cible (nouvelle base de données enfichable 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 spécifie le nombre maximum d'UC à affecter pour la base de données enfichable
  • --maxSize indique la taille de stockage maximale en Go pour la nouvelle base de données enfichable
  • --resume reprend l'exécution précédente
    • --sessionID spécifie de reprendre un ID session spécifique
  • --executePrereqs spécifie yes pour exécuter uniquement les préalables pour cette opération. Valeurs valides : yes ou no
  • --waitForCompletion spécifie false pour exécuter l'opération en arrière-plan. Valeurs valides : true ou false
  • --sourcePDBExportedTDEKeyFile indique le fichier de clé exporté de la base de données enfichable source. Cette variable s'applique uniquement à la base de données 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, qui est préparé à partir de la base de données principale. Obligatoire uniquement pour les opérations de base de données de secours
    Note

    Les paramètres --blobLocation et --standbyBlobFromPrimary s'excluent mutuellement.
  • --excludeUserTablespaces Option permettant d'ignorer les espaces-tables utilisateur, par exemple t1,t2,t3.
  • --excludePDBData spécifie true/yes pour ignorer les données d'utilisateur de la base de données enfichable source.
  • --pdbAdminUserName indique le nouveau nom d'utilisateur administrateur de la base de données enfichable
  • --lockPDBAdminAccount spécifie true ou false pour verrouiller le compte d'utilisateur administrateur de la base de données enfichable. Valeur par défaut : true.
  • --sourcePDBServiceConvertList spécifie une liste de noms de service source à cible, délimités par des virgules, à convertir. La syntaxe est source_srv1:new_srv1, source_srv2:new_srv2.
  • --refreshablePDB indique de créer une base de données enfichable actualisable
    • --refreshMode indique le mode d'actualisation pour la base de données enfichable actualisable. Valeurs valides : AUTO|MANUAL
      • --refreshIntervalInMinutes : Indique l'intervalle d'actualisation pour refreshablePDB en minutes
    • --dblinkUsername spécifie l'utilisateur commun d'une base de données distante, utilisé comme lien de base de données pour la connexion à la base de données distante.
      • --honorCaseSensitiveUserName indique que le nom d'utilisateur spécifié est sensible à la casse
  • --updateDBBlockCacheSize : Indique de permettre à l'application de définir les paramètres d'initialisation db block cache size pour prendre en charge la copie de données avec une taille de bloc différente

À l'invite, vous devez fournir le mot de passe de l'utilisateur SYS pour la base de données enfichable source. La nouvelle base de données clonée hérite des mots de passe d'administration de la base de données enfichable source. La base de données clonée est nommée à l'aide du 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 utilisent la version Oracle Database 12.2.0.1, ou une version 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 voir les informations sur tous les répertoires de base Oracle, utilisez la commande dbaascli system getDBHomes.

Préalable

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

Syntaxe

dbaascli system getDBHomes

Exemple 6-46 : dbaascli system getDBHomes

dbaascli system getDBHomes

système dbaascli getGridHomes

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

Préalable

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

Syntaxe

dbaascli system getGridHomes

dbaascli tde changePassword

Pour modifier le mot de passe du magasin de clés TDE ainsi que le mot de passe du portefeuille de base de données pour l'alias tde_ks_passwd, utilisez la commande dbaascli tde changePassword.

Préalable

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 - Spécifiez Vrai pour générer un fichier blob contenant les artefacts nécessaires pour effectuer l'opération dans un environnement Data Guard.
  • --blobLocation - 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, qui est préparé à partir de la base de données principale. Cette opération n'est requise que pour les opérations de secours.
  • --resume - Pour reprendre l'exécution précédente
  • --sessionID Pour reprendre un ID 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
  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 blob de secours créé dans l'environnement de la 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é secondaire du module de sécurité matériel (KMS) à la configuration existante, utilisez la commande dbaascli tde addSecondaryHsmKey.

Préalable

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

Syntaxe

dbaascli tde addSecondaryHsmKey --dbname <value> --secondaryKmsKeyOCID <value>
[--executePrereqs]
Où :
  • --secondaryKmsKeyOCID spécifie la clé KMS secondaire à ajouter à la configuration du module de sécurité matériel (KMS) existante
  • --dbname indique le nom de la base de données
  • --executePrereqs exécute les vérifications des préalables 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

Pour activer le paramètre spfile wallet_root pour la base de données existante, utilisez la commande dbaascli tde enableWalletRoot.

Préalable

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 spécifie l'option de redémarrage de la base de données. Les valeurs valides sont les suivantes : rolling ou full. Valeur par défaut : rolling

    Si vous ne transmettez pas l'argument dbrestart, la base de données redémarre de manière continue (rolling).

  • --precheckOnly exécute uniquement la vérification préalable pour cette opération. Valeurs valides : yes ou no
  • --resume Pour reprendre l'exécution précédente.
  • --sessionID Pour reprendre un ID 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 chiffrer tous les espaces-tables de la base de données enfichable spécifiée, utilisez la commande dbaascli tde encryptTablespacesInPDB.

Préalable

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

Syntaxe

dbaascli tde encryptTablespacesInPDB --pdbName
[--dbname]
[--precheckOnly]
[--useSysdbaCredential]
Où :
  • --pdbName spécifie le nom de la base de données enfichable pour chiffrer tous les espaces-tables.
  • --dbname indique le nom de la base de données Oracle.
  • --precheckOnly exécute uniquement la vérification préalable pour cette opération. Valeurs valides : yes ou no
  • --useSysdbaCredential utilise les données 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 le TDE basé sur FILE en TDE basé sur le module de sécurité matériel (KMS/OKV), utilisez la commande dbaascli tde fileToHsm.

Préalable

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 spécifie l'OCID de la clé KMS à utiliser pour TDE. Cela s'applique uniquement si KMS est sélectionné pour TDE
  • --dbname indique le nom de la base de données
  • --skipPatchCheck ignore la vérification de validation des correctifs requis si la valeur transmise pour cet argument est true. Valeurs valides : true ou false
  • --executePrereqs exécute les vérifications des préalables et signale les résultats.
  • --primarySuc spécifie cette propriété dans la base de données de secours de l'environnement Data Guard une fois la commande exécutée sur la base de données principale
  • --resume indique de reprendre l'exécution précédente
    • --sessionID spécifie de reprendre un ID session spécifique
  • --revert indique de repositionner l'exécution précédente
    • --sessionID indique de repositionner un ID session spécifique
  • --waitForCompletion spécifie 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éalable

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 d'accès au fichier où la liste des OCID sera enregistrée. La sortie est dans le 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 clé principale associé à l'OCID de version de clé KMS, utilisez la commande dbaascli tde getMkidForKeyVersionOCID.

Préalable

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

Syntaxe

dbaascli tde getMkidForKeyVersionOCID --kmsKeyVersionOCID <value>
[--dbname <value>]
[--waitForCompletion <value>]
Où :
  • --kmsKeyVersionOCID spécifie l'OCID de version de clé du service de gestion des clés à définir
  • --dbname indique le nom de la base de données
  • --waitForCompletion spécifie 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é principale du module de sécurité matériel (KMS) à partir de la configuration existante, utilisez la commande dbaascli tde getPrimaryHsmKey.

Préalable

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 le TDE basé sur le module de sécurité matériel (KMS/OKV) en TDE 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 Spécifier true pour générer un fichier blob contenant les artefacts nécessaires pour effectuer l'opération dans un environnement Data Guard.
  • --blobLocation Emplacement de 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, qui est préparé à partir de la base de données principale. Cette opération n'est requise que pour les opérations de secours. ]
  • --skipPatchCheck ignore la vérification de validation des correctifs requis si la valeur transmise pour cet argument est true. Valeurs valides : true ou false
  • --executePrereqs exécute les vérifications des préalables et signale les résultats.
  • --primarySuc spécifie cette propriété dans la base de données de secours de l'environnement Data Guard une fois la commande exécutée sur la base de données principale
  • --resume reprend l'exécution précédente
    • --sessionID spécifie de reprendre un ID session spécifique
  • --revert indique de repositionner l'exécution précédente
    • --sessionID indique de repositionner un ID session spécifique
  • --waitForCompletion spécifie 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 lister les clés principales TDE, utilisez la commande dbaascli tde listKeys.

Préalable

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 spécifie le chemin absolu du fichier dans lequel les résultats seront enregistrés.

Exemple 6-55 : dbaascli tde listKeys

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

dbaascli tde removeSecondaryHsmKey

Pour supprimer la clé principale du module de sécurité matériel (KMS) de la configuration existante, utilisez la commande dbaascli tde removeSecondaryHsmKey.

Préalable

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 cette option n'est pas spécifiée, l'utilisateur sera invité à supprimer toutes les clés du module de sécurité matériel (KMS) existantes.
  • --secondaryKmsKeyOCID Clé KMS secondaire à supprimer de la configuration du module de sécurité matériel (KMS) existante. Si cette option n'est pas spécifiée, toutes les clés KMS secondaires seront supprimées.
  • --executePrereqs exécute les vérifications des préalables et signale les résultats.

Foire aux questions

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

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

Q : Quelles sont les conditions requises pour exécuter la commande dbaascli tde removeSecondaryHsmKey?

R : Vous devez :
  • Exécutez la commande en tant qu'utilisateur root.
  • Être connecté à 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é de module de sécurité matériel secondaire sans inviter l'utilisateur à confirmer. Si elle n'est pas spécifiée, la commande invite l'utilisateur avant de supprimer des clés.

Q : Que spécifie le paramètre --secondaryKmsKeyOCID?

R : Le paramètre --secondaryKmsKeyOCID spécifie l'OCID (identificateur Oracle Cloud) de la clé KMS secondaire à supprimer de la configuration de module de sécurité matériel existante.

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

R : Le paramètre --dbname spécifie le nom de la base de données pour laquelle la clé de module de sécurité matériel secondaire est en cours de suppression.

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

R : Le paramètre --precheckOnly, s'il est réglé à yes, exécutera uniquement les vérifications préalables pour valider la préparation de l'opération de suppression sans supprimer réellement la clé de module de sécurité matériel secondaire. Si la valeur est réglée à 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 procéder à la suppression de la clé.

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

R : Oui, vous devez fournir --secondaryKmsKeyOCID pour identifier la clé de module de sécurité matériel secondaire spécifique que vous voulez supprimer de la configuration.

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

R : Non, le paramètre --dbname est facultatif. Si elle n'est pas spécifiée, 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 souhaite supprimer la clé du module de sécurité matériel secondaire sans invite d'utilisateur?

R : Vous devez utiliser le paramètre --force pour ignorer l'invite de confirmation et supprimer directement la clé de module de sécurité matériel 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 réglé à Oui pour effectuer une vérification préalable :

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

Q : Que se passe-t-il si je ne fournit 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é de module de sécurité matériel 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 partiellement?

R : Si l'opération échoue, vérifiez 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 problèmes avant de réessayer.

Q : Puis-je exécuter la commande dbaascli tde removeSecondaryHsmKey pendant l'exécution de la base de données?

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

Q : Quel est l'objectif de la suppression d'une clé HSM secondaire?

R : La suppression d'une clé de module de sécurité matériel 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 chiffrement utilisées dans votre configuration TDE (Transparent Data Encryption).

Q : Comment puis-je 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. Reportez-vous à la documentation sur Exadata Cloud Infrastructure pour obtenir des instructions sur l'établissement d'une connexion sécurisée.

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 la rotation de la clé principale de chiffrement de base de données.

Préalables :

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

Syntaxe

(Facultatif) <Entrez les informations sur la syntaxe ici.>

dbaascli tde rotateMasterKey --dbname <value> 
[--rotateMasterKeyOnAllPDBs] 
[--pdbName <value>] 
[--executePrereqs] 
[--resume [--sessionID <value>]]
{
     [--prepareStandbyBlob <value> [--blobLocation <value>]]
     | [--standbyBlobFromPrimary <value>]
 }
Où :
  • --dbname - Nom de la base de données Oracle.
  • --rotateMasterKeyOnAllPDBs - Spécifier true pour effectuer la rotation de la clé principale de toutes les bases de données enfichables dans la base de données conteneur. Valeurs valides : true|false
  • --pdbName - Spécifier le nom de la base de données enfichable.
  • --executePrereqs exécute les vérifications des préalables et signale les résultats.
  • --resume - Pour reprendre l'exécution précédente
  • --sessionID Pour reprendre un ID session spécifique.
  • --prepareStandbyBlob | --standbyBlobFromPrimary]
  • --prepareStandbyBlob - Spécifiez Vrai pour générer un fichier blob contenant les artefacts nécessaires pour effectuer l'opération dans un environnement Data Guard.
  • --blobLocation - Emplacement de 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, qui est préparé à partir de la base de données principale. Cette opération n'est requise que pour les opérations de secours

dbaascli tde setKeyVersion

Pour définir la version de la clé primaire à utiliser dans la base de données/base de données conteneur ou la base de données enfichable, 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 spécifie l'OCID de version de clé du service de gestion des clés à définir.
  • --dbname indique le nom de la base de données.
  • --pdbName est le nom de la base de données enfichable pour utiliser l'OCID de la version de clé.
  • --masterKeyID indique l'ID clé principale de l'OCID de version de clé indiqué. Cela s'applique à l'environnement Data Guard.
  • --standbySuc spécifie cette propriété dans la base de données principale de l'environnement Data Guard une fois la commande exécutée sur la base de données de secours
  • --executePrereqs exécute les vérifications des préalables et signale les résultats.
  • --waitForCompletion spécifie 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é principale du module de sécurité matériel (KMS) pour la configuration 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 spécifie la clé KMS principale à définir
  • --dbname indique le nom de la base de données
  • --allStandbyPrepared - Spécifier pour confirmer que l'opération a été exécutée avec succès sur toutes les bases de données de secours.
  • --bounceDatabase spécifiez cet indicateur pour effectuer une non-transmission continue de base de données pour cette opération
  • --executePrereqs exécute les vérifications des préalables et signale les résultats.
  • --resume Pour reprendre l'exécution précédente.
  • --sessionID Pour reprendre un ID 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

Pour afficher des informations sur le magasin de clés pour la base de données spécifiée, exécutez la commande dbaascli tde status.

Préalable

Note

La commande dbaascli tde status est obsolète dans la version dbaascli 24.4.1.0.0. Oracle recommande plutôt d'utiliser la commande dbaascli database getDetails.

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 comprend le type et le statut du magasin de clés.

Exemple 6-59 : dbaascli tde status

dbaascli tde status --dbname dbname