Utilisation de l'utilitaire dbaascli avec Oracle Exadata Database Service on Cloud@Customer

Découvrez comment utiliser l'utilitaire dbaascli sur Oracle Exadata Database Service on Cloud@Customer.

A propos de l'utilisation de l'utilitaire dbaascli sur Oracle Exadata Database Service on Cloud@Customer

L'utilitaire dbaascli permet d'effectuer plusieurs opérations d'administration et de cycle de vie de base de données sur Oracle Exadata Database Service on Cloud@Customer, telles que la création d'une base de données Oracle Database, l'application de patches à Oracle Database, la gestion des bases de données pluggables, le redimensionnement du nombre de coeurs de processeur en mode déconnecté, etc.

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

Pour vous servir de l'utilitaire, vous devez être connecté à une machine virtuelle Exadata Cloud@Customer. Reportez-vous à Connexion à une machine virtuelle avec SSH.

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

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

Création d'une base de données Oracle à l'aide de dbaascli

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

Liste des versions et des images logicielles disponibles pour Database

Afin d'obtenir la liste des versions prises en charge disponibles pour la création d'une base de données Oracle, utilisez la commande dbaascli cswlib showImages.

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

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

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

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

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

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

Exemple 7-1 dbaascli cswlib showImages

dbaascli cswlib showImages

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

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

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

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

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

Vous pouvez indiquer la version cible dans la commande dbaascli dbhome create en tant que valeur --version à partir de la sortie de la commande dbaascli cswlib showImages.

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

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

Remarque

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Modification des mots de passe de base de données

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

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

Remarque

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

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

Procédure de modification du mot de passe SYS pour une base de données Exadata Database Service on Cloud@Customer

  1. Connectez-vous à la machine virtuelle Exadata Database Service on Cloud@Customer en tant que opc.
  2. Exécutez la commande suivante :
    sudo dbaascli database changepassword --dbname database_name --user SYS

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

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

Procédure de modification du mot de passe du portefeuille TDE pour une base de données Exadata Database Service on Cloud@Customer

  1. Connectez-vous à la machine virtuelle Exadata Database Service on Cloud@Customer en tant que opc.
  2. Exécutez la commande suivante :
    sudo dbaascli tde changepassword --dbname database_name

Gestion des images logicielles Oracle Exadata Database Service on Cloud@Customer à l'aide de l'utilitaire dbaascli

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

Remarque

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

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

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

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

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

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

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

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

    dbaascli cswlib showImages --product grid

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

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

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

Exemple 7-2 dbaascli cswlib showImages

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

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

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

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

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

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

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

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

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

Vous pouvez télécharger les images logicielles disponibles sur votre instance Oracle Exadata Database Service on Cloud@Customer à l'aide de la sous-commande cswlib download de l'utilitaire dbaascli.

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

    Les paramètres facultatifs sont les suivants :

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Application de patches à Oracle Grid Infrastructure

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    dbaascli cswlib showImages --product grid

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

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

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

Exemple 7-3 dbaascli cswlib showImages

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Reprise d'une opération de patch

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Remarque

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

Préparer la duplication

Assurez-vous que les conditions suivantes sont remplies :

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

Exécuter les vérifications de prérequis

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

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

Dupliquer la base de données

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

Si la base de données source utilise OKV pour la gestion du fichier de clés TDE, l'opération de base de données dupliquée en cours ne prend pas en charge cette configuration.

Dupliquer une base de données sur site

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

Préparer la duplication

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

Vérifier les RPM nécessaires

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

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

Exécuter les vérifications de prérequis

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

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

Dupliquer la base de données

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

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

Par exemple :

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

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

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

Quelques points à prendre en compte pour la migration

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

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

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

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

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

Notes sur la version

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

Version 25.2.1.0.0 (250612)

  • Comprend AHF 25.2.4
  • Inclut syslens 25.1.4.0
  • Diverses corrections de bug et améliorations en matière de stabilité.

Version 25.1.2.0.0 (250505)

  • Comprend AHF 25.2.4
  • Inclut syslens 25.1.1.0
  • Diverses corrections de bug et améliorations en matière de stabilité.

Version 25.1.1.0.0 (250220)

  • Comprend AHF 24.11.0
  • Inclut les symboles syslens 24.4.2.0
  • Diverses corrections de bug et améliorations en matière de stabilité.

Version 24.4.1.0.0 (241212)

  • Comprend AHF 24.9.1
  • Inclut les symboles syslens 24.3.3.1
  • Diverses corrections de bug et améliorations en matière de stabilité.

Version 24.3.2.0.0 (240912)

  • AHF version 24.7 inclus
  • Inclut syslens version 24.3.1.0
  • Diverses corrections de bug et améliorations en matière de stabilité.

Version 24.3.1.0.0 (240730)

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

Version 24.2.2.1.0.0 (240620)

  • Ajout de la prise en charge d'Oracle Database 23ai.
  • AHF version 24.4.3 inclus
  • Inclut syslens version 24.1.2.0
  • Diverses corrections de bug et améliorations en matière de stabilité.

Version 24.1.2.0.0 (240327, 240424, 240502)

  • AHF version 24.1.1 inclus.
  • Inclut syslens version 2.6.8.0.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Version 24.1.0.0 (240118, 240219)

  • AHF version 23.11.1 inclus.
  • Inclut syslens version 2.6.4.3.
  • Diverses corrections de bug et améliorations en matière de stabilité.
  • (240219) Correction du bogue 36309260 applicable à l'agent DBCS version 21.2 ou antérieure : la communication entre le plan de contrôle OCI et l'agent DBCS ne fonctionne pas dans certaines machines virtuelles.

Version 23.4.1.1.0.0 (231219)

  • AHF version 23.9.5 inclus.
  • Inclut syslens version 2.6.4.2.
  • Diverses corrections de bug et améliorations en matière de stabilité.

Version 23.3.2.0.0 (231115)

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

Version 23.3.1.0.0 (230817, 231020)

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

Version 23.2.1.0.0 (230708, 2307224)

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

Version 23.1.2.0.0 (230411, 230616)

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

Version 23.1.1.0.1 (230302)

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

Version 22.4.1.0.1 (221214)

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

Version 22.3.1.1.0 (221003)

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

Version 22.3.1.0.1 (220831)

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

Version 22.2.1.1.0 (220713)

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

Version 22.2.1.0.1 (220504)

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

Version 22.1.1.1.0 (220301)

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

Version 22.1.1.0.1 (220223)

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

Version 21.4.1.1.0

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

Version 21.3.1.2.0

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

Version 21.3.1.1.0

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

Version 21.3.1.0.1

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

Version 21.2.1.x.x

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

Référence des commandes dbaascli

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

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

Administration et configuration

Cette section décrit les tâches essentielles de gestion et de configuration des environnements Oracle Database. Il inclut des commandes telles que dbaascli admin updateStack pour l'installation ou la mise à jour du RPM dbaastools et dbaascli job getStatus pour la vérification du statut de travaux spécifiques.

dbaascli admin updateStack

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

Prérequis

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

Pour employer l'utilitaire, vous devez vous connecter à une machine virtuelle Exadata Database Service on Cloud@Customer.

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

Syntaxe

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

FAQ

Q : A quoi sert la commande dbaascli admin updateStack ?

R : la commande dbaascli admin updateStack est utilisée pour installer ou mettre à jour un RPM dbaastools sur Exadata Cloud Infrastructure.

Q : Quels sont les prérequis pour utiliser la commande dbaascli admin updateStack ?

R : Vous devez exécuter la commande en tant qu'utilisateur root et vous connecter à une machine virtuelle Exadata Cloud Infrastructure.

Q : Que fait l'option --resume ?

R : L'option --resume reprend l'exécution précédente de la commande updateStack si elle a été interrompue ou incomplète.

Q : Quel est le but de l'option --prechecksOnly ?

R : L'option --prechecksOnly exécute uniquement les prévérifications pour l'opération sans effectuer réellement l'installation ou la mise à jour.

Q : Comment le paramètre --nodes est-il utilisé ?

R : Le paramètre --nodes indique une liste de noeuds séparés par des virgules sur lesquels le RPM doit être installé. S'il n'est pas indiqué, le RPM sera installé sur tous les noeuds du cluster.

Q : Que dois-je faire en cas de problème avec la commande dbaascli admin updateStack ?

R : Assurez-vous que vous exécutez la commande en tant qu'utilisateur root et que vous êtes connecté à une machine virtuelle Exadata Cloud Infrastructure. Vérifiez s'il existe des messages d'erreur spécifiques et consultez la documentation relative aux commandes ou le support technique Oracle si nécessaire.

Q : Comment me connecter à une machine virtuelle Exadata Cloud Infrastructure pour utiliser la commande dbaascli admin updateStack ?

R : Vous devez utiliser SSH pour vous connecter à la machine virtuelle. Reportez-vous à la section "Connexion à une machine virtuelle avec SSH" de la documentation pour obtenir des instructions détaillées.

Exemples de cas d'emploi

Exemple 1 : installation ou mise à jour du RPM dbaastools sur tous les noeuds

dbaascli admin updateStack

Installe ou met à jour le RPM dbaastools sur tous les noeuds de l'environnement Exadata Cloud@Customer.

Exemple 2 : exécution de prévérifications uniquement avant l'installation ou la mise à jour du RPM

dbaascli admin updateStack --prechecksOnly

Exécute uniquement les prévérifications pour la mise à jour RPM dbaastools, sans effectuer réellement l'installation. Il garantit que tous les prérequis sont satisfaits avant de procéder à la mise à jour.

Exemple 3 : reprise d'une opération updateStack interrompue précédemment

dbaascli admin updateStack --resume

Reprend une précédente opération de mise à jour du RPM dbaastools qui a été interrompue ou qui ne s'est pas terminée correctement.

Exemple 4 : installation ou mise à jour de dbaastools sur des noeuds spécifiques

dbaascli admin updateStack --nodes node1,node2

Installe ou met à jour le RPM dbaastools sur les noeuds spécifiés node1 et node2 uniquement, sans affecter les autres noeuds du cluster.

Exemple 5 : reprise du processus updateStack sur des noeuds spécifiques

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

Reprend le processus de mise à jour pour dbaastools sur les noeuds spécifiques node3 et node4 uniquement si l'exécution précédente a été interrompue.

dbaascli job getStatus

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

Prérequis

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

Pour employer l'utilitaire, vous devez vous connecter à une machine virtuelle Exadata Database Service on Cloud@Customer.

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

Syntaxe

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

FAQ

Q : A quoi sert la commande dbaascli job getStatus ?

R : La commande dbaascli job getStatus permet d'afficher le statut.

Exemples de cas d'emploi

Exemple 1 : vérification du statut d'un travail spécifique à l'aide de l'ID de travail

dbaascli job getStatus --jobID 12345

Vérifie le statut du travail avec l'ID 12345. La sortie affiche l'état actuel du travail (par exemple, En cours, Terminé ou Echec).

Exemple 2 : vérification du statut d'un travail d'application de patches à l'aide de l'ID de travail

dbaascli job getStatus --jobID 98765

Extrait le statut d'un travail d'application de patches portant l'ID 98765 pour voir si le patch a été appliqué ou s'il est toujours en cours d'exécution.

Exemple 3 : vérification du statut d'un travail de sauvegarde de base de données

dbaascli job getStatus --jobID 45678

Vérifie le statut d'un travail de sauvegarde de base de données avec l'ID 45678. La sortie fournit des détails sur la progression ou l'achèvement de la sauvegarde.

Exemple 4 : vérification de la progression d'un travail à longue durée d'exécution

dbaascli job getStatus --jobID 23456

Vérifiez la progression d'un travail à longue durée d'exécution (ID 23456) pour voir s'il est toujours en cours d'exécution ou s'il est terminé.

Exemple 5 : affichage du statut d'un travail de création de base de données

dbaascli job getStatus --jobID 67890

Vérifie le statut d'un travail de création de base de données identifié par l'ID de travail 67890.

Redimensionnement de l'UC

Cette section se concentre sur l'ajustement des ressources de CPU dans un cluster de machines virtuelles. Elle inclut des commandes telles que dbaascli cpuscale get_status pour vérifier le statut des demandes de redimensionnement en cours ou passées, et dbaascli cpuscale update pour augmenter ou réduire le nombre de coeurs de processeur alloués à une machine virtuelle, ce qui permet une gestion flexible des ressources en fonction des demandes de charge globale.

dbaascli cpuscale get_status

Pour vérifier le statut de la demande de redimensionnement en cours ou de la dernière effectuée lorsque la connectivité réseau entre le serveur de plan de contrôle et la région OCI est interrompue, utilisez la commande dbaascli cpuscale get_status.

Prérequis

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

Pour employer l'utilitaire, vous devez vous connecter à une machine virtuelle Exadata Database Service on Cloud@Customer.

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

Syntaxe

Affiche différents états d'exécution de commande au fur et à mesure de la progression : scheduled, running et enfin success ou failure.
dbaascli cpuscale get_status

FAQ

Q : A quoi sert la commande dbaascli cpuscale get_status ?

R : la commande dbaascli cpuscale get_status est utilisée pour vérifier le statut de la demande de redimensionnement de l'UC en cours ou de la dernière, en particulier lorsque la connectivité réseau entre le serveur de plan de contrôle et la région OCI est interrompue.

Q : Quels sont les prérequis pour utiliser la commande dbaascli cpuscale get_status ?

R : vous devez exécuter la commande en tant qu'utilisateur root et vous connecter à une machine virtuelle Exadata Cloud@Customer.

Q : Que dois-je faire en cas de problème lors de l'exécution de la commande dbaascli cpuscale get_status ?

R : assurez-vous que vous exécutez la commande en tant qu'utilisateur root et que vous êtes connecté à une machine virtuelle Exadata Cloud@Customer. Si le problème persiste, consultez la documentation relative aux commandes ou demandez l'assistance d'Oracle.

Q : Que se passe-t-il si la commande affiche un statut d'échec ?

R : Si la commande affiche un statut d'échec, consultez les journaux détaillés pour connaître les messages d'erreur et effectuez un dépannage en fonction de l'erreur spécifique. Vous devrez peut-être résoudre les problèmes réseau ou vérifier les détails de la demande de redimensionnement.

Exemples de cas d'emploi

Exemple 1 : vérification du statut de l'opération de redimensionnement de l'UC la plus récente

dbaascli cpuscale get_status

Vérifie le statut de la demande de redimensionnement de l'UC en cours ou de la dernière. Elle indique si la mise à l'échelle est planifiée, en cours d'exécution ou s'est terminée avec succès ou en échec.

Exemple 2 : vérification du statut après l'échec d'une demande de redimensionnement

Une opération de redimensionnement a été demandée mais a rencontré des problèmes réseau entre le serveur de plan de contrôle et la région OCI.

dbaascli cpuscale get_status

Vérifie le statut de la demande de redimensionnement. Etant donné que le processus de redimensionnement a échoué en raison de problèmes réseau, la sortie fournit des détails sur l'état de l'échec.

Exemple 3 : vérification du statut lorsque le redimensionnement est en cours

Une opération de redimensionnement de l'UC est en cours et l'utilisateur souhaite surveiller sa progression.

dbaascli cpuscale get_status

Vérifie le statut actuel, ce qui indique que la demande de mise à l'échelle est en cours d'exécution. Il permet à l'utilisateur de suivre l'opération jusqu'à ce qu'elle se termine ou échoue.

Exemple 4 : vérification du statut après l'achèvement du redimensionnement

Une opération de redimensionnement a été effectuée et s'est terminée avec succès.

dbaascli cpuscale get_status

Vérifie le statut et confirme que l'opération de redimensionnement s'est terminée avec succès. Il signale l'état final comme "succès".

dbaascli cpuscale update

Pour augmenter ou réduire le nombre de coeurs de processeur d'une machine virtuelle dans un cluster de machines virtuelles lorsque la connectivité réseau entre le serveur de plan de contrôle et la région OCI est interrompue, utilisez la commande dbaascli cpuscale update.

Prérequis

Pour augmenter ou réduire le nombre d'OCPU dans un cluster de machines virtuelles en mode déconnecté, exécutez les commandes dbaascli cpuscale update et dbaascli cpuscale get_status à partir de n'importe quel noeud du cluster afin de modifier le nombre de coeurs de processeur de ce cluster. Si vous disposez de plusieurs clusters de machines virtuelles, exécutez une commande distincte à partir de n'importe quel noeud dans chaque cluster à augmenter ou à réduire. Ces commandes sont conçues pour ne pas fonctionner si elles sont émises pendant le mode connecté normal. Elles expirent au bout de 600 secondes (10 minutes).

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

Pour employer l'utilitaire, vous devez vous connecter à une machine virtuelle Exadata Database Service on Cloud@Customer.

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

Syntaxe

Exadata Database Service on Cloud@Customer est considéré comme étant en mode déconnecté en cas de perte de connectivité avec le plan de contrôle DBaaS exécuté sur Oracle Cloud Infrastructure (OCI).

dbaascli cpuscale update --coreCount coreCount --message message
Où :
  • --coreCount indique le nombre cible d'UC à augmenter ou à réduire pour chaque machine virtuelle du cluster.
  • --message permet d'inclure un message pour référence (facultatif).

FAQ

Q : A quoi sert la commande dbaascli cpuscale update ?

R : la commande dbaascli cpuscale update permet d'augmenter ou de réduire le nombre de cœurs de processeur d'une machine virtuelle dans un cluster de machines virtuelles lorsque la connectivité réseau entre le serveur de plan de contrôle et Oracle Cloud Infrastructure (OCI) est interrompue.

Q : Quels sont les prérequis pour utiliser la commande dbaascli cpuscale update ?

R : Avant d'utiliser cette commande, assurez-vous que vous l'exécutez en mode déconnecté, ce qui signifie qu'il y a une perte de connectivité avec le plan de contrôle DBaaS sur OCI. Exécutez la commande à partir de n'importe quel noeud du cluster de machines virtuelles et notez qu'elle expire au bout de 600 secondes (10 minutes) si elle est utilisée en mode connecté. La commande doit être exécutée en tant qu'utilisateur root.

Q : Comment puis-je me connecter à une machine virtuelle pour utiliser cette commande ?

R : pour utiliser la commande dbaascli cpuscale update, vous devez vous connecter à une machine virtuelle Exadata Cloud@Customer à l'aide de SSH. Pour plus d'informations, reportez-vous à la section "Connecting to a Virtual Machine with SSH".

Q : Que spécifie l'option --coreCount dans la commande ?

R : l'option --coreCount indique le nombre cible d'UC à augmenter ou à réduire pour chaque machine virtuelle du cluster.

Q : Puis-je inclure un message avec la commande dbaascli cpuscale update ?

R : Oui. Vous pouvez inclure un message facultatif à l'aide de l'option --message pour référence.

Q : Comment vérifier le statut d'une opération de redimensionnement de CPU ?

R : pour vérifier le statut d'une opération de redimensionnement de l'UC, utilisez la commande dbaascli cpuscale get_status. Elle doit également être exécutée à partir de n'importe quel noeud du cluster de machines virtuelles.

Q : Que se passe-t-il si j'exécute la commande dbaascli cpuscale update en mode connecté ?

R : La commande est conçue pour ne pas fonctionner en mode connecté et expirera au bout de 600 secondes (10 minutes). Il ne doit être utilisé qu'en mode déconnecté.

Q : Comment redimensionner les coeurs de processeur pour plusieurs clusters de machines virtuelles ?

R : si vous disposez de plus d'un cluster de machines virtuelles, vous devez exécuter la commande dbaascli cpuscale update séparément de tout noeud dans chaque cluster à augmenter ou à réduire.

Exemples de cas d'emploi

Exemple 1 : augmentation des coeurs de processeur à 20

Le cluster de machines virtuelles est en cours d'exécution avec 16 coeurs et vous voulez l'augmenter à 20.

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

Met à l'échelle le nombre de coeurs de CPU jusqu'à 20, et inclut un message "Augmentation pour une demande accrue" pour référence.

Exemple 2 : réduction des coeurs de processeur à 8

Le cluster de machines virtuelles utilise actuellement 12 coeurs, mais vous voulez réduire le nombre à 8 pour économiser des ressources.

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

Réduit le nombre de coeurs de processeur à 8 et fournit un message pour référence ultérieure sur la raison pour laquelle l'opération de redimensionnement a été effectuée.

Exemple 3 : mise à l'échelle de la CPU sans message

Vous devez faire passer les coeurs de CPU de 32 à 24, mais aucun message supplémentaire n'est nécessaire.

dbaascli cpuscale update --coreCount 24

Cette commande réduit le nombre de coeurs à 24 sans aucun message. L'opération sera effectuée avec la journalisation par défaut des actions.

Exemple 4 : vérification du statut après le redimensionnement de la CPU

Après avoir exécuté la commande de redimensionnement, vous voulez vérifier si la mise à jour a réussi.

dbaascli cpuscale get_status

Vérifie le statut de la demande de redimensionnement en cours ou de la dernière demande, ce qui vous permet de vérifier si l'opération d'augmentation ou de réduction a réussi.

Exemple 5 : tentative de redimensionnement lorsque la machine virtuelle est déjà à un nombre maximal de coeurs

Le cluster de machines virtuelles dispose déjà du nombre maximal de coeurs de processeur autorisés (48), mais une tentative d'augmentation est effectuée.

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

Echec car le cluster de machines virtuelles ne peut pas dépasser le nombre maximal de coeurs autorisés. Le statut reflète l'échec après une tentative de redimensionnement à 50 coeurs.

Gestion de la bibliothèque de logiciels cloud (CSWLIB)

Cette section fournit des outils permettant de gérer les images logicielles dans les environnements Exadata Database Service on Cloud@Customer. Des commandes telles que dbaascli cswlib deleteLocal permettent la suppression des images locales, tandis que dbaascli cswlib download permet le téléchargement de nouvelles images logicielles. Vous pouvez également visualiser les images disponibles en local avec dbaascli cswlib listLocal ou vérifier toutes les images Database et Grid Infrastructure disponibles à l'aide de dbaascli cswlib showImages. Ces commandes permettent de gérer et de gérer efficacement les bibliothèques de logiciels.

dbaascli cswlib deleteLocal

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

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

Syntaxe

dbaascli cswLib deleteLocal --imageTag <value>

Où :

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

FAQ

Q : Quel est le but de la commande dbaascli cswlib deleteLocal ?

R : La commande dbaascli cswlib deleteLocal permet de supprimer une image de répertoire de base Oracle local du système.

Q : Quels sont les prérequis pour exécuter la commande dbaascli cswlib deleteLocal ?

R : la commande doit être exécutée en tant qu'utilisateur root pour garantir que les droits d'accès nécessaires sont disponibles pour supprimer l'image locale.

Q : Comment spécifier l'image locale à supprimer ?

R : Utilisez l'option --imageTag pour indiquer la balise d'image de répertoire de base Oracle à supprimer.

Q : Que représente l'option --imageTag dans la commande ?

R : L'option --imageTag représente l'identificateur ou la balise associé à l'image de répertoire de base Oracle à supprimer.

Q : Puis-je supprimer plusieurs images locales à la fois à l'aide de cette commande ?

R : Non. La commande dbaascli cswlib deleteLocal vous permet de supprimer une seule image locale à la fois, indiquée par sa balise d'image.

Q : Que se passe-t-il si j'exécute la commande dbaascli cswlib deleteLocal sans spécifier --imageTag ?

R : la commande échoue car --imageTag est requis pour identifier l'image locale à supprimer.

Q : Est-il possible de récupérer une image locale après qu'elle a été supprimée à l'aide de cette commande ?

R : Non. Une fois l'image locale supprimée à l'aide de la commande dbaascli cswlib deleteLocal, elle ne peut pas être récupérée. Assurez-vous de vérifier la balise d'image avant de continuer.

Q : Quand dois-je utiliser la commande dbaascli cswlib deleteLocal ?

R : Utilisez cette commande lorsque vous devez enlever du système local une image de répertoire de base Oracle inutilisée ou obsolète pour libérer de l'espace ou nettoyer votre environnement.

Exemple 7-4 dbaascli cswlib deletelocal

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

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

Prérequis

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

Pour employer l'utilitaire, vous devez vous connecter à une machine virtuelle Exadata Database Service on Cloud@Customer.

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande de téléchargement dbaascli cswlib ?

R : La commande dbaascli cswlib download permet de télécharger les images logicielles disponibles et de les mettre à disposition dans Exadata Cloud Infrastructure.

Q : Quels sont les prérequis pour exécuter la commande de téléchargement dbaascli cswlib ?

R : vous devez exécuter la commande en tant qu'utilisateur root. De plus, vous devez être connecté à une machine virtuelle Exadata Cloud Infrastructure.

Q : Comment puis-je me connecter à la machine virtuelle requise pour cette commande ?

R : Vous devez utiliser SSH pour vous connecter à la machine virtuelle Exadata Cloud Infrastructure. Des instructions détaillées sont disponibles dans la documentation sous Connexion à une machine virtuelle avec SSH.

Q : Que spécifie l'option --version dans la commande ?

R : L'option --version indique la version d'image de répertoire de base Oracle à télécharger.

Q : Comment utiliser l'option --imageTag dans la commande de téléchargement dbaascli cswlib ?

R : L'option --imageTag permet de spécifier la balise d'image de l'image logicielle à télécharger.

Q : Quel est le but de l'option --product dans la commande ?

R : L'option --product indique le type d'image à télécharger. Les valeurs valides sont database ou grid.

Q : Puis-je télécharger des images de base de données et de grille simultanément ?

R : Non. Vous devez indiquer database ou grid à l'aide de l'option --product, de sorte que chaque opération de téléchargement est spécifique à un type d'image.

Q : Que se passe-t-il si je ne spécifie pas de balise de version ou d'image ?

R : La commande échouera probablement ou vous invitera à fournir les informations requises car les options --version ou --imageTag sont nécessaires pour identifier l'image logicielle spécifique à télécharger.

Q : Est-il nécessaire de spécifier à la fois --version et --imageTag ?

R : Non, vous indiquez généralement --version ou --imageTag en fonction de la façon dont vous voulez identifier l'image à télécharger, mais pas les deux en même temps.

Q : Quand utiliserais-je la commande de téléchargement dbaascli cswlib ?

R : utilisez cette commande lorsque vous devez télécharger des images logicielles de répertoire de base Oracle pour les environnements database ou grid dans votre configuration Exadata Cloud Infrastructure.

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

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

Exemple 7-6 dbaascli cswlib download --version 19.9.0.0.0

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

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

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

Syntaxe

dbaascli cswLib listLocal [--product <value>]

Où :

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

FAQ

Q : Quel est le but de la commande dbaascli cswlib listLocal ?

R : La commande dbaascli cswlib listLocal permet d'afficher la liste des images Database et Grid Infrastructure disponibles en local sur votre système.

Q : Quels sont les prérequis pour exécuter la commande dbaascli cswlib listLocal ?

R : la commande doit être exécutée en tant qu'utilisateur root pour disposer des droits d'accès nécessaires et répertorier les images disponibles.

Q : Comment spécifier le type d'image à répertorier à l'aide de cette commande ?

R : Utilisez l'option --product pour indiquer le type d'images de répertoire de base Oracle à répertorier. Les valeurs valides sont database ou grid.

Q : Que représente l'option --product dans la commande dbaascli cswlib listLocal ?

R : L'option --product identifie le type de produit de répertoire de base Oracle, ce qui vous permet de filtrer la liste des images disponibles sur les types database ou grid.

Q : Puis-je répertorier les images de base de données et de grille simultanément ?

R : Non, l'option --product vous permet de répertorier les images database ou grid à la fois. Vous devez exécuter la commande deux fois avec des valeurs --product différentes pour afficher les deux listes.

Q : Que se passe-t-il si je ne spécifie pas l'option --product dans la commande ?

R : Si l'option --product n'est pas spécifiée, la commande peut répertorier toutes les images disponibles localement ou vous demander de spécifier le type de produit. Le comportement peut dépendre de la configuration de votre environnement.

Q : Quand dois-je utiliser la commande dbaascli cswlib listLocal ?

R : Vous devez utiliser cette commande pour vérifier quelles images Database ou Grid Infrastructure sont actuellement disponibles localement sur votre système.

Q : Comment faire la distinction entre les images de base de données et de grille dans la liste ?

R : L'option --product vous permet de filtrer la liste. Par conséquent, en spécifiant database ou grid, vous ne verrez que les images pertinentes pour ce type de produit, ce qui facilite la différenciation.

Q : Y a-t-il un risque associé à l'exécution de la commande dbaascli cswlib listLocal ?

R : Non, cette commande n'est pas destructive et affiche uniquement des informations sur les images disponibles localement. Il ne modifie ni ne supprime aucun fichier.

Q : Cette commande affiche-t-elle des images distantes ou stockées dans le cloud ?

R : Non. La commande dbaascli cswlib listLocal affiche uniquement les images disponibles localement sur votre système, et non celles stockées à distance ou dans le cloud.

Exemple 7-7 dbaascli cswlib listlocal

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

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

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

Syntaxe

dbaascli cswlib showImages 
[--product]

Où :

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

FAQ

Q : Quel est le but de la commande dbaascli cswlib showImages ?

R : La commande dbaascli cswlib showImages permet de visualiser la liste des images Database et Grid Infrastructure disponibles qui peuvent être téléchargées ou gérées dans votre environnement Oracle Exadata Database Service.

Q : Quels sont les prérequis pour exécuter la commande dbaascli cswlib showImages ?

R : la commande doit être exécutée en tant qu'utilisateur root pour vous assurer que vous disposez des droits d'accès nécessaires pour visualiser les images disponibles.

Q : Comment filtrer les images répertoriées par cette commande ?

R : Vous pouvez filtrer les images en indiquant l'option --product avec database ou grid pour répertorier uniquement les images associées à ce type de produit.

Q : Que représente l'option --product dans la commande dbaascli cswlib showImages ?

R : L'option --product identifie le type de produit du répertoire de base Oracle, ce qui vous permet de filtrer la liste des images dans la base de données ou la grille.

Q : Puis-je afficher les images de base de données et de grille dans une seule exécution de commande ?

R : Non. Vous devez exécuter la commande deux fois avec des valeurs --product différentes (database et grid) pour visualiser les deux types d'image.

Q : Que se passe-t-il si je ne spécifie pas l'option --product dans la commande ?

R : Si l'option --product n'est pas spécifiée, la commande peut répertorier toutes les images disponibles ou vous inviter à indiquer le type de produit, en fonction de la configuration de votre environnement.

Q : Quand dois-je utiliser la commande dbaascli cswlib showImages ?

R : Utilisez cette commande lorsque vous voulez afficher la liste des images Database ou Grid Infrastructure disponibles pour téléchargement ou déploiement dans votre environnement Oracle Exadata Database Service.

Q : Existe-t-il une différence entre les commandes dbaascli cswlib showImages et dbaascli cswlib listLocal ?

R : Oui, dbaascli cswlib showImages répertorie toutes les images disponibles que vous pouvez télécharger ou gérer, tandis que dbaascli cswlib listLocal répertorie uniquement les images déjà téléchargées et disponibles localement sur votre système.

Q : Cette commande peut-elle être utilisée pour afficher les images stockées dans le cloud ?

R : Oui. Cette commande peut afficher les images qui peuvent être téléchargées à partir des référentiels Oracle, et pas uniquement celles qui sont stockées localement.

Q : Quel type d'image puis-je espérer voir avec cette commande ?

R : Vous pouvez vous attendre à voir des images liées à Oracle Database et Grid Infrastructure, qui sont des composants essentiels pour gérer et exécuter des bases de données Oracle sur des plates-formes Exadata.

Exemple 7-8 dbaascli cswlib showImages

dbaascli cswlib showImages

Gestion de base de données

Cette section décrit les tâches complètes de gestion des bases de données Oracle. Il inclut des commandes permettant de créer (dbaascli database create), de supprimer (dbaascli database delete) et de mettre à niveau des bases de données (dbaascli database upgrade). Les autres tâches clés incluent l'ajout et la suppression d'instances (dbaascli database addInstance, dbaascli database deleteInstance), la gestion des sauvegardes (dbaascli database backup) et la gestion de la récupération de base de données (dbaascli database recover). Vous pouvez également modifier les paramètres de base de données, gérer les bases de données pluggables, appliquer des patches aux bases de données et convertir des bases de données non Conteneur en bases de données pluggables. Ces commandes assurent un contrôle efficace sur l'ensemble du cycle de vie de la base de données.

dbaascli database addInstance

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli database addInstance ?

R : La commande dbaascli database addInstance permet d'ajouter une nouvelle instance de base de données à un noeud indiqué dans un environnement Oracle Exadata Database Service.

Q : Quels sont les prérequis pour l'exécution de la commande dbaascli database addInstance ?

R : la commande doit être exécutée en tant qu'utilisateur root pour disposer des droits d'accès nécessaires à l'ajout d'une instance de base de données.

Q : Que représente l'option --dbname dans cette commande ?

R : L'option --dbname indique le nom de l'instance Oracle Database pour laquelle ajouter une nouvelle instance.

Q : A quoi sert l'option --node dans la commande dbaascli database addInstance ?

R : L'option --node indique le nom du noeud où la nouvelle instance de base de données sera ajoutée.

Q : Quel est le but de l'option --newNodeSID dans cette commande ?

R : L'option --newNodeSID vous permet d'indiquer le SID (identificateur système) de la nouvelle instance de base de données qui sera créée sur le noeud spécifié.

Q : Est-il obligatoire de spécifier l'option --newNodeSID lors de l'ajout d'une nouvelle instance ?

R : L'option --newNodeSID est facultative. S'il n'est pas indiqué, Oracle génère automatiquement un SID pour la nouvelle instance de base de données.

Q : Quand dois-je utiliser la commande dbaascli database addInstance ?

R : Utilisez cette commande pour redimensionner la base de données en ajoutant une nouvelle instance à un noeud supplémentaire dans une configuration Oracle Database à plusieurs noeuds.

Q : Puis-je ajouter plusieurs instances de base de données à différents noeuds à l'aide de cette commande ?

R : Oui. Vous pouvez exécuter la commande plusieurs fois pour ajouter des instances de base de données à différents noeuds en indiquant les valeurs --node et --dbname appropriées.

Q : Que se passe-t-il si le noeud spécifié dans l'option --node n'est pas disponible ?

R : La commande échoue si le noeud spécifié n'est pas disponible ou accessible. Assurez-vous que le noeud est correctement configuré et accessible avant d'exécuter la commande.

Q : Cette commande peut-elle être utilisée dans un environnement Data Guard ?

R : Oui. Vous pouvez utiliser la commande dbaascli database addInstance dans un environnement Data Guard pour ajouter des instances, mais il est recommandé de suivre les instructions Data Guard nécessaires pour ces configurations.

Q : Cette commande entraînera-t-elle un temps d'arrêt de la base de données ?

R : L'ajout d'une instance à un nouveau noeud n'entraîne généralement pas de temps d'inactivité pour les instances de base de données existantes, mais il est recommandé de vérifier la présence de dépendances spécifiques dans votre environnement.

dbaascli database backup

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

Prérequis

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

Syntaxe

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

Où :

--dbname specifies Oracle Database name         
--list returns database backup information
            [--backupType | --json]
            [--backupType specifies backupType (REGULAR-L0 | REGULAR-L1 | ARCHIVELOG | LONGTERM). ]
            [--json specifies file Name for JSON output. ]        
--start begins database backup.
            [--level0 creates a Level-0 (full) backup. ]
            [--level1 creates a Level-1 (incremental) backup. ]
            [--archival | --archivelog]
            [--archival creates an archival full backup. ]
                --tag specifies backup tag. 
            [--archivelog ]       
--delete deletes Archival backup. 
            --backupTag specifies backup tag to delete.        
--status displays the details about a backup job process. 
            --uuid unique identifier of the backup operation. Input format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
                [--json specifies file Name for JSON output. ]       
--getBackupReport returns BackupReport. 
            --tag | --latest
            --tag specifies backup tag. 
            --latest returns latest backup report (all types of database backup). 
            --json specifies file Name for JSON output.         
--configure configures database for backup. 
            --configFile | --enableRTRT | --disableRTRT | --disableCatalog | --deleteImmutableConfiguration
            --configFile specifies database backup configuration file. 
            --enableRTRT enables Real Time Redo Transport. 
            --disableRTRT disables Real Time Redo Transport. 
            --disableCatalog disables recovery catalog. 
            --deleteImmutableConfiguration         
--getConfig returns database backup configuration. 
            [--configFile | --showOldParams]
            [--configFile specifies database backup configuration file. ]
            [--showOldParams returns old parameter names of backup configuration. ]        
--validate validates that backups are complete and corruption-free. 
            [--untilTime validates from closest Level-0 (full) backup until time provided. Input format: DD-MON-YYYY HH24:MI:SS.]        
--showHistory displays history of backup operations.
            [--all displays all backup operations. ]        
--getSchedules returns all backup schedules for a given database.
Remarque

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

FAQ

Q : Quel est le but de la commande de sauvegarde de base de données dbaascli ?

R : La commande dbaascli database backup permet de configurer des destinations de stockage de sauvegarde Oracle Database, de réaliser des sauvegardes, d'interroger des sauvegardes et de supprimer des sauvegardes existantes.

Q : Quels sont les prérequis pour exécuter la commande dbaascli database backup ?

R : la commande doit être exécutée en tant qu'utilisateur root pour disposer des droits d'accès nécessaires à la gestion des sauvegardes.

Q : Comment démarrer une sauvegarde complète d'Oracle Database à l'aide de cette commande ?

R : Pour démarrer une sauvegarde complète (niveau 0), utilisez la syntaxe suivante :

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

Q : Comment effectuer une sauvegarde incrémentielle à l'aide de la commande dbaascli database backup ?

R : Pour effectuer une sauvegarde incrémentielle de niveau 1, utilisez la syntaxe suivante :

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

Q : Quelle est la différence entre les sauvegardes de niveau 0 et de niveau 1 ?

R : Une sauvegarde de niveau 0 est une sauvegarde complète de la base de données, tandis qu'une sauvegarde de niveau 1 est une sauvegarde incrémentielle qui capture uniquement les modifications apportées depuis la dernière sauvegarde de niveau 0 ou 1.

Q : Puis-je effectuer une sauvegarde d'archivage à l'aide de cette commande ?

R : Oui. Vous pouvez créer une sauvegarde d'archivage à l'aide de l'option --archival et de la commande --start :

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

Q : Comment supprimer une sauvegarde d'archivage existante ?

R : Pour supprimer une sauvegarde d'archivage, utilisez la syntaxe suivante :

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

Q : Comment puis-je vérifier le statut d'une sauvegarde spécifique à l'aide de la commande ?

R : Vous pouvez vérifier le statut d'une sauvegarde à l'aide de l'option --status avec le paramètre --uuid, comme suit :

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

Q : Comment répertorier toutes les sauvegardes d'une base de données ?

R : Pour répertorier toutes les sauvegardes disponibles pour une base de données spécifique, utilisez l'option --list :

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

Pour la sortie JSON, ajoutez l'option --json :

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

Q : Comment puis-je récupérer un rapport de sauvegarde ?

R : Vous pouvez obtenir un rapport de sauvegarde à l'aide de l'option --getBackupReport, soit pour une balise spécifique, soit pour la dernière sauvegarde :

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

Ou pour récupérer le dernier rapport :

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

Q : Comment configurer les paramètres de sauvegarde de la base de données ?

R : Utilisez l'option --configure pour indiquer le fichier de configuration de sauvegarde ou pour activer/désactiver le transport des informations de journalisation en temps réel (RTRT) :

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

Pour activer RTRT :

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

Q : Comment vérifier la configuration de sauvegarde actuelle de ma base de données ?

R : Pour afficher la configuration de sauvegarde de base de données en cours, utilisez l'option --getConfig :

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

Q : Que fait l'option --validate dans la commande dbaascli database backup ?

R : L'option --validate vérifie si les sauvegardes sont terminées et qu'elles ne sont pas endommagées. Vous pouvez spécifier une période à l'aide de l'option --untilTime :

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

Q : Comment afficher l'historique de toutes les opérations de sauvegarde d'une base de données ?

R : Utilisez l'option --showHistory pour afficher l'historique de toutes les opérations de sauvegarde :

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

Pour un historique complet, y compris toutes les opérations :

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

Q : Quelles sont les options RTRT (Real-Time Redo Transport) et quand dois-je les utiliser ?

R : Les options RTRT (--enableRTRT et --disableRTRT) sont utilisées pour contrôler le transport des informations de journalisation en temps réel, applicable uniquement aux destinations de sauvegarde ZDLRA (Zero Data Loss Recovery Appliance) dans les environnements Exadata Cloud@Customer. Activez RTRT pour garantir l'expédition en temps réel des fichiers de journalisation.

Exemple 7-9 Exemples

  • Pour modifier la période de conservation des fichiers de journalisation archivés, procédez comme suit :
    dbaascli database backup --getConfig --dbname <dbname>

    Cela générera un fichier de configuration de sauvegarde .cfg.

    Mettez à jour la valeur bkup_archlog_fra_retention dans ce fichier de configuration.

    Exécutez la commande configure :

    dbaascli database backup --configure --dbname <dbname> --configfile <config file generated above>
  • Afin d'obtenir la configuration de sauvegarde pour une base de données myTestDB, exécutez la commande suivante :
    dbaascli database backup --dbName myTestDB --getConfig --configFile /tmp/configfile_1.txt
  • Afin de définir la configuration de sauvegarde pour une base de données myTestDB en modifiant le fichier de configuration avec les détails de configuration, exécutez la commande suivante :
    dbaascli database backup --dbName myTestDB --configure --configFile /tmp/configfile_1_modified.txt
  • Pour effectuer la sauvegarde de la base de données myTestDB, exécutez la commande suivante :
    dbaascli database backup --dbName myTestDB --start
  • Pour interroger le statut de la demande de sauvegarde soumise avec l'uuid 58fdcae0bd1c11eb92bc020017075151, exécutez la commande suivante :
    dbaascli database backup --dbName myTestDB --status --uuid 58fdcae0bd1c11eb92bc020017075151
  • Afin d'activer le mode Redo Transport en temps réel pour la base de données myTestDB, exécutez la commande suivante :
    dbaascli database backup --dbName myTestDB --configure —enableRTRT
dbaascli database bounce

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

Prérequis

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

Syntaxe

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

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

FAQ

Q : Quel est le but de la commande dbaascli database bounce ?

R : La commande dbaascli database bounce permet d'arrêter et de redémarrer une base de données Oracle Database dans Exadata Cloud Infrastructure. Il prend en charge le redémarrage non simultané de la base de données, garantissant ainsi un minimum de perturbations.

Q : Quels sont les prérequis pour exécuter la commande dbaascli database bounce ?

R : la commande doit être exécutée en tant qu'utilisateur oracle, qui dispose des privilèges requis pour arrêter et redémarrer la base de données.

Q : Que spécifie l'option --dbname dans cette commande ?

R : L'option --dbname indique le nom de l'instance Oracle Database à arrêter et à redémarrer.

Q : A quoi sert l'option --rolling dans la commande dbaascli database bounce ?

R : L'option --rolling indique s'il faut redémarrer (redémarrer) la base de données de manière non simultanée. Si la valeur est True, les instances de base de données sont redémarrées une par une, ce qui garantit un temps d'inactivité minimal. La valeur par défaut est false, qui redémarre toutes les instances à la fois.

Q : Que signifie "rebondir la base de données" ?

R : Le redémarrage de la base de données consiste à l'arrêter, puis à la redémarrer. Cette opération peut être utilisée pour la maintenance, l'application de modifications ou la récupération suite à certains types de problème.

Q : La commande dbaascli database bounce effectue-t-elle un arrêt progressif ?

R : Oui, la commande effectue un arrêt en mode "immédiat", ce qui ferme la base de données et annule les transactions non validées sans attendre que les utilisateurs se déconnectent.

Q : Cette commande ouvrira-t-elle automatiquement toutes les bases de données pluggables d'une base de données Oracle 12c ou ultérieure ?

R : Oui. Si la base de données exécute Oracle Database 12c ou une version ultérieure, la commande ouvre automatiquement toutes les bases de données pluggables après le redémarrage de la base de données.

Q : La commande dbaascli database bounce peut-elle être utilisée dans un environnement à plusieurs noeuds ou RAC (Real Application Clusters) ?

R : Oui. Dans un environnement à plusieurs noeuds ou RAC, vous pouvez utiliser l'option --rolling pour redémarrer les instances de base de données une par une, ce qui réduit les temps d'inactivité.

Q : Que se passe-t-il si je ne spécifie pas l'option --rolling ?

R : Si l'option --rolling n'est pas indiquée ou si elle est définie sur False, la commande arrête et redémarre toutes les instances de base de données en même temps, ce qui peut entraîner un bref temps d'inactivité.

Q : Existe-t-il une valeur par défaut pour l'option --rolling dans la commande dbaascli database bounce ?

R : Oui, la valeur par défaut de l'option --rolling est false, ce qui signifie que la base de données sera rebondie de manière non simultanée, sauf indication contraire.

Q : Comment redémarrer une base de données en mode non simultané ?

R : Pour redémarrer la base de données en mode non simultané, utilisez la syntaxe suivante :

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

Q : Est-il sûr d'exécuter la commande dbaascli database bounce pendant les sessions actives ?

R : Bien que la commande utilise un arrêt immédiat, qui annule les transactions non validées, il est toujours recommandé de s'assurer qu'il n'y a pas de sessions critiques ou actives avant de redémarrer la base de données.

Q : Cette commande peut-elle être utilisée pour des bases de données pluggables spécifiques dans une base de données colocative ?

R : Non, la commande dbaascli database bounce fonctionne sur l'ensemble de la base de données. Dans Oracle 12c ou une version ultérieure, il redémarrera la base de données Conteneur et ouvrira toutes les bases de données pluggables, mais il n'autorise pas le redémarrage de bases de données pluggables individuelles.

Q : Que dois-je faire si la base de données ne revient pas en ligne après l'avoir rebondie ?

R : Si le redémarrage de la base de données échoue, recherchez les erreurs éventuelles dans les journaux lors du processus d'arrêt ou de démarrage. L'examen des journaux d'alertes Oracle peut fournir des informations sur la cause du problème.

Exemple 7-10 dbaascli database bounce

dbaascli database bounce --dbname dbname
dbaascli database changepassword

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

Prérequis

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

Syntaxe

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

FAQ

Q : Que fait la commande dbaascli database changePassword ?

R : La commande dbaascli database changePassword permet de modifier le mot de passe d'un utilisateur Oracle Database spécifié. Vous serez invité à saisir le nom d'utilisateur, puis le nouveau mot de passe.

Q : Quels sont les prérequis pour utiliser la commande dbaascli database changePassword ?

R : Vous devez exécuter la commande en tant qu'utilisateur root ou oracle pour modifier le mot de passe d'un utilisateur de base de données.

Q : Comment spécifier la base de données lors de l'utilisation de cette commande ?

R : Utilisez l'option --dbname pour indiquer le nom de l'instance Oracle Database sur laquelle vous souhaitez agir. Par exemple :

dbaascli database changePassword --dbname <db_name>

Q : Comment spécifier l'utilisateur dont je souhaite modifier le mot de passe ?

R : Utilisez l'option --user pour indiquer le nom utilisateur dont le mot de passe doit être modifié. Par exemple :

dbaascli database changePassword --user <username>

Q : Quel est le but de l'option --prepareStandbyBlob dans la commande dbaascli database changePassword ?

R : L'option --prepareStandbyBlob est utilisée dans les environnements Data Guard pour générer un fichier BLOB contenant les artefacts requis pour la modification du mot de passe sur la base de données de secours. Cela garantit la synchronisation des mots de passe dans l'environnement Data Guard.

Q : Que précise l'option --blobLocation ?

R : L'option --blobLocation vous permet de spécifier un chemin personnalisé où le fichier BLOB de secours doit être généré. S'il n'est pas indiqué, le fichier est enregistré à l'emplacement par défaut.

Q : Comment utiliser le blob généré à partir de la base de données principale pour modifier le mot de passe sur la base de données de secours ?

R : Vous pouvez utiliser l'option --standbyBlobFromPrimary pour indiquer le fichier BLOB préparé à partir de la base de données principale pour appliquer la modification de mot de passe à la base de données de secours. Par exemple :

dbaascli database changePassword --standbyBlobFromPrimary <blob_file_path>

Q : A quoi sert l'option --resume dans cette commande ?

R : L'option --resume est utilisée pour reprendre une opération de modification de mot de passe interrompue précédemment. Vous pouvez spécifier l'ID de session si nécessaire à l'aide de l'option --sessionID.

Q : Puis-je reprendre une session spécifique à l'aide de la commande dbaascli database changePassword ?

R : Oui. Vous pouvez utiliser l'option --resume avec --sessionID pour reprendre une session de modification de mot de passe spécifique en indiquant l'ID de session.

Q : La commande dbaascli database changePassword est-elle applicable dans un environnement Data Guard ?

R : Oui, c'est le cas. L'option --prepareStandbyBlob peut être utilisée pour garantir que les modifications de mot de passe sont propagées vers la base de données de secours dans une configuration Data Guard.

Q : Que se passe-t-il si je ne fournis pas --blobLocation lors de l'utilisation de --prepareStandbyBlob ?

R : Si aucun élément --blobLocation n'est fourni, le fichier BLOB contenant les artefacts de modification de mot de passe sera enregistré à l'emplacement par défaut.

Q : Comment vérifier le statut d'une session reprise à l'aide de dbaascli database changePassword ?

R : Vous pouvez indiquer l'ID de session à l'aide de l'option --sessionID pour reprendre une session spécifique. Le système reprendra là où il s'est arrêté en modifiant le mot de passe.

Q : Cette commande peut-elle être utilisée à la fois pour les bases de données standard et celles d'un environnement Data Guard ?

R : Oui. La commande fonctionne à la fois pour les bases de données Oracle standard et pour les bases de données d'un environnement Data Guard. Dans les environnements Data Guard, des options supplémentaires telles que --prepareStandbyBlob peuvent être utilisées pour gérer les modifications de mot de passe sur les bases de données principale et de secours.

Exemple 7-11 dbaascli database changePassword

dbaascli database changepassword --dbname db19
dbaascli database convertToPDB

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

Syntaxe

dbaascli database convertToPDB --dbname <value> [--cdbName <value>] [--executePrereqs]
        {
            [--copyDatafiles]
            | [--backupPrepared]
        }
        [--targetPDBName <value>] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Où :
  • --dbname indique le nom de la base de données Oracle.
  • --cdbName indique le nom de la base de données Conteneur cible dans laquelle la base de données pluggable sera créée. Si la base de données Conteneur n'existe pas, elle sera créée dans le même répertoire de base Oracle que la base de données non Conteneur source.
  • --executePrereqs indique d'exécuter uniquement les vérifications de préconversion.
  • --copyDatafiles indique de créer une copie des fichiers de données au lieu d'utiliser ceux de la base de données source.
  • --backupPrepared est un indicateur permettant de confirmer qu'une sauvegarde de base de données appropriée est en place pour la base de données non Conteneur avant d'effectuer la conversion en base de données pluggable.
  • --targetPDBName indique le nom de la base de données pluggable qui sera créée dans le cadre de l'opération.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.
  • --resume indique de reprendre l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.

FAQ

Q : Que fait la commande dbaascli database convertToPDB ?

R : la commande dbaascli database convertToPDB convertit une base de données non Conteneur Oracle Database indiquée en base de données pluggable au sein d'une base de données Conteneur.

Q : Comment spécifier la base de données à convertir ?

R : Utilisez l'option --dbname pour indiquer le nom de la base de données non Conteneur Oracle Database à convertir. Par exemple :

dbaascli database convertToPDB --dbname <db_name>

Q : Comment indiquer la base de données Conteneur cible pour la conversion de la base de données pluggable ?

R : Utilisez l'option --cdbName pour indiquer le nom de la base de données Conteneur cible dans laquelle la base de données pluggable sera créée. Si la base de données Conteneur n'existe pas, elle sera créée dans le même répertoire de base Oracle que la base de données non Conteneur source.

Q : Que fait l'option --executePrereqs ?

R : L'option --executePrereqs exécute des vérifications avant conversion pour s'assurer que la base de données est prête à être convertie. Aucune modification ne sera apportée à la base de données au cours de cette étape.

Q : Comment puis-je copier les fichiers de données pendant la conversion ?

R : Vous pouvez utiliser l'option --copyDatafiles pour créer une copie des fichiers de données plutôt que d'utiliser les fichiers d'origine de la base de données source.

Q : Quel est le but de l'option --keepSourceDB ?

R : L'option --keepSourceDB vous permet de conserver la base de données non Conteneur source d'origine une fois l'opération de conversion terminée. Si vous n'utilisez pas cette option, la base de données source sera supprimée après la conversion.

Q : Comment puis-je confirmer qu'une sauvegarde est préparée avant la conversion ?

R : Utilisez l'indicateur --backupPrepared pour confirmer que vous avez effectué une sauvegarde correcte de la base de données non Conteneur avant d'effectuer la conversion. Cette étape est cruciale pour éviter la perte de données.

Q : Comment indiquer un nom personnalisé pour la nouvelle base de données pluggable ?

R : Utilisez l'option --targetPDBName pour fournir un nom spécifique à la nouvelle base de données pluggable qui sera créée dans le cadre de la conversion. Par exemple :

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

Q : Puis-je exécuter la conversion en arrière-plan ?

R : Oui. Vous pouvez utiliser l'option --waitForCompletion pour indiquer si l'opération doit être exécutée en arrière-plan. Utilisez false pour une exécution en arrière-plan et true pour attendre la fin de l'opération avant de continuer. La valeur par défaut est true.

Q : Comment puis-je reprendre une conversion précédemment interrompue ?

R : Vous pouvez utiliser l'option --resume pour reprendre un processus de conversion précédemment interrompu. Vous pouvez éventuellement indiquer --sessionID pour reprendre une session spécifique.

Q : Que se passe-t-il si je n'indique pas de nom de base de données Conteneur ?

R : Si l'option --cdbName n'est pas fournie, le système crée la nouvelle base de données pluggable dans le même répertoire de base Oracle que la base de données non Conteneur source.

Q : Puis-je poursuivre la conversion après une interruption sans connaître l'ID de session ?

R : Oui. Si vous utilisez l'option --resume sans indiquer d'ID de session, la dernière session connue reprendra. Si vous voulez reprendre une session spécifique, vous pouvez indiquer --sessionID.

Q : Que fait l'option --sessionID ?

R : L'option --sessionID est utilisée conjointement avec --resume pour indiquer une session particulière à reprendre, au cas où il y aurait eu plusieurs sessions interrompues.

Q : Est-il obligatoire d'avoir une sauvegarde avant de convertir une base de données non Conteneur en base de données pluggable ?

R : Bien que l'indicateur --backupPrepared soit facultatif, il est fortement recommandé d'effectuer une sauvegarde de la base de données non Conteneur avant d'effectuer la conversion en base de données pluggable. Cela garantit que vous pouvez restaurer la base de données en cas de problème lors de la conversion.

Exemple 7-12 dbaascli database convertToPDB

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

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

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

Prérequis

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

Syntaxe

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

FAQ

Q : Que fait la commande dbaascli database create ?

R : La commande dbaascli database create permet de créer une instance Oracle Database. Il prend en charge la création d'Oracle Database version 12.1.0.2 ou supérieure avec la mise à jour de version JAN 2021 ou supérieure.

Q : Comment indiquer le nom d'Oracle Database à créer ?

R : Utilisez l'option --dbName pour indiquer le nom d'Oracle Database. Par exemple :

dbaascli database create --dbName <db_name>

Q : Comment créer une base de données Conteneur ?

R : Utilisez l'option --createAsCDB et indiquez True pour créer la base de données en tant que base de données Conteneur. Par exemple :

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

Q : Comment indiquer le répertoire de base Oracle pour la base de données ?

R : Vous pouvez utiliser l'option --oracleHome pour indiquer l'emplacement du répertoire de base Oracle ou l'option --oracleHomeName pour indiquer le nom du répertoire de base Oracle.

Q : Comment spécifier un nom de base de données ou un SID unique ?

R : Utilisez l'option --dbUniqueName pour indiquer un nom unique pour la base de données et l'option --dbSID pour indiquer le SID de la base de données.

Q : Comment créer une base de données pluggable avec une base de données Conteneur ?

R : Vous pouvez utiliser l'option --pdbName pour indiquer le nom de la base de données pluggable et l'option --pdbAdminUserName pour définir le nom utilisateur de l'administrateur de la base de données pluggable. Par exemple :

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

Q : Comment spécifier le jeu de caractères de la base de données et le jeu de caractères national ?

R : Utilisez l'option --dbCharset pour indiquer le jeu de caractères de la base de données et l'option --dbNCharset pour indiquer le jeu de caractères national. Par exemple :

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

Q : Comment définir les paramètres de mémoire (SGA et PGA) pour la base de données ?

R : Utilisez l'option --sgaSizeInMB pour indiquer la taille de la mémoire SGA et l'option --pgaSizeInMB pour indiquer la taille de la mémoire PGA, en mégaoctets.

Q : Comment indiquer la destination des fichiers de données et de la zone de récupération rapide (FRA) ?

R : Utilisez l'option --datafileDestination pour indiquer le groupe de disques ASM pour les fichiers de données et l'option --fraDestination pour indiquer le groupe de disques ASM pour FRA. Vous pouvez également définir la taille FRA avec l'option --fraSizeInMB.

Q : Puis-je configurer le cryptage transparent des données (TDE) lors de la création de la base de données ?

R : Oui. Vous pouvez configurer TDE à l'aide de l'option --tdeConfigMethod. Les valeurs valides sont FILE (pour le cryptage basé sur des fichiers) ou KMS (pour Oracle Key Management Service). Si vous utilisez KMS, indiquez l'OCID de clé KMS avec l'option --kmsKeyOCID.

Q : Comment créer la base de données sur une liste spécifique de noeuds ?

R : Utilisez l'option --nodeList pour indiquer une liste de noeuds séparés par des virgules sur lesquels la base de données doit être créée.

Q : Comment reprendre ou rétablir une précédente tentative de création de base de données ?

R : utilisez l'option --resume pour reprendre l'exécution précédente ou l'option --revert pour annuler l'exécution précédente. Vous pouvez également indiquer un élément --sessionID pour reprendre ou rétablir une session spécifique.

Q : Que fait l'option --executePrereqs ?

R : L'option --executePrereqs exécute uniquement les prérequis pour l'opération de création de base de données, sans créer réellement la base de données. Utilisez yes ou no pour activer ou désactiver cette option.

Q : Puis-je spécifier un modèle DBCA personnalisé pour la création de la base de données ?

R : Oui, utilisez l'option --dbcaTemplateFilePath pour fournir le chemin absolu du fichier de modèle DBCA à utiliser pour créer la base de données.

Q : Puis-je exécuter l'opération de création de base de données en arrière-plan ?

R : Oui. Vous pouvez utiliser l'option --waitForCompletion pour indiquer si la commande doit attendre la fin de la création de la base de données (true) ou exécuter l'opération en arrière-plan (false).

Q : Que se passe-t-il si je ne spécifie pas l'option --dbUniqueName ?

R : si vous n'indiquez pas de nom unique pour la base de données à l'aide de --dbUniqueName, le système en générera automatiquement un en fonction de --dbName fourni.

Q : Puis-je verrouiller le compte d'administrateur de base de données pluggable lors de la création d'une base de données Conteneur ?

R : Oui. Vous pouvez utiliser l'option --lockPDBAdminAccount et la définir sur True pour verrouiller le compte d'administrateur de base de données pluggable après la création de la base de données. Par défaut, cette valeur est définie sur true.

Exemple 7-13 dbaascli database create

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

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

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

Syntaxe

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

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

FAQ

Q : Quel est le but de la commande dbaascli database createTemplate ?

R : La commande dbaascli database createTemplate permet de créer des modèles de base de données (modèles DBCA) à partir d'une base de données spécifiée, qui peuvent ensuite être utilisés pour créer des bases de données.

Q : Comment spécifier le nom de la base de données pour laquelle je veux créer un modèle ?

R : Utilisez l'option --dbname pour indiquer le nom de l'instance Oracle Database à partir de laquelle le modèle sera créé. Par exemple :

dbaascli database createTemplate --dbname <db_name>

Q : Comment spécifier où le modèle doit être enregistré ?

R : Utilisez l'option --templateLocation pour indiquer l'emplacement où le modèle DBCA sera enregistré. Par exemple :

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

Q : Puis-je télécharger le modèle vers Object Storage directement ?

R : Oui. Vous pouvez utiliser l'option --uploadToObjectStorage pour télécharger le modèle DBCA vers Object Storage. Vous devez indiquer l'utilisateur de connexion à Object Storage et le nom de bucket avec les options --objectStorageLoginUser et --objectStorageBucketName, respectivement.

Q : Comment spécifier les détails de connexion à Object Storage lors du téléchargement du modèle ?

R : Utilisez les options suivantes pour indiquer les détails Object Storage :

--objectStorageLoginUser : indique l'utilisateur de connexion à Object Storage.

--objectStorageBucketName : indique le nom de bucket Object Storage.

--objectStorageUrl : (facultatif) indique l'URL d'Object Storage si elle est différente de celle par défaut.

Par exemple :

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

Q : Comment spécifier un nom personnalisé pour le modèle DBCA ?

R : Utilisez l'option --templateName pour indiquer un nom personnalisé pour le modèle DBCA. Par exemple :

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

Q : A quoi sert l'option --rmanParallelism ?

R : L'option --rmanParallelism indique le niveau de parallélisme des opérations RMAN lors du processus de création du modèle. Par exemple :

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

Q : Que se passe-t-il si je ne spécifie pas les options --templateLocation ou --uploadToObjectStorage ?

R : Si vous n'indiquez pas d'emplacement de modèle à l'aide de --templateLocation ou que vous choisissez de le télécharger vers Object Storage à l'aide de --uploadToObjectStorage, la commande ne saura pas où stocker le modèle créé et son exécution échouera.

Q : Puis-je utiliser à la fois --templateLocation et --uploadToObjectStorage ?

R : Non. Choisissez --templateLocation pour enregistrer le modèle en local ou --uploadToObjectStorage pour le télécharger vers Object Storage, mais pas les deux.

Q : L'option --objectStorageUrl est-elle obligatoire lors du téléchargement du modèle vers Object Storage ?

R : Non, l'option --objectStorageUrl est facultative. Si aucune valeur n'est indiquée, l'URL Object Storage par défaut est utilisée. Vous devez uniquement indiquer cette option si vous utilisez une URL Object Storage personnalisée.

Q : Quels sont les privilèges utilisateur requis pour exécuter la commande dbaascli database createTemplate ?

R : la commande doit être exécutée en tant qu'utilisateur root ou oracle.

Q : Puis-je reprendre un processus de création de modèle précédemment échoué ?

R : Non, la commande dbaascli database createTemplate ne prend pas en charge la reprise d'un processus ayant échoué. Vous devrez redémarrer la commande dès le début.

dbaascli database delete

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli database delete ?

R : La commande dbaascli database delete permet de supprimer une base de données Oracle Database sur Exadata Cloud Infrastructure.

Q : Comment spécifier la base de données à supprimer ?

R : Utilisez l'option --dbname pour indiquer le nom de l'instance Oracle Database à supprimer. Par exemple :

dbaascli database delete --dbname <db_name>

Q : Comment supprimer les fichiers de journalisation archivés lors de la suppression d'une base de données ?

R : Vous pouvez supprimer les fichiers de journalisation archivés en définissant l'option --deleteArchiveLogs sur true. Par exemple :

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

Q : Puis-je également supprimer des sauvegardes lors de la suppression de la base de données ?

R : Oui, utilisez l'option --deleteBackups et définissez-la sur True pour supprimer toutes les sauvegardes associées. Par exemple :

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

Q : Comment exécuter uniquement les prévérifications pour l'opération de suppression sans supprimer réellement la base de données ?

R : Vous pouvez utiliser l'option --precheckOnly et la définir sur Oui pour exécuter les prévérifications sans supprimer la base de données. Par exemple :

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

Q : Comment forcer la suppression d'une base de données ?

R : Pour forcer la suppression d'une base de données, utilisez l'indicateur --force. Cela contourne les contrôles et force le processus de suppression. Par exemple :

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

Q : Comment exécuter l'opération de suppression en arrière-plan ?

R : Utilisez l'option --waitForCompletion et définissez-la sur false pour exécuter l'opération en arrière-plan. Par exemple :

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

Q : Puis-je spécifier le SID de la base de données à supprimer ?

R : Oui. Vous pouvez indiquer le SID de la base de données à l'aide de l'option --dbSID. Par exemple :

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

Q : Comment puis-je reprendre une opération de suppression précédemment interrompue ?

R : Pour reprendre une exécution de suppression précédente, utilisez l'option --resume. Vous pouvez également spécifier un ID de session à l'aide de l'option --sessionID si nécessaire. Par exemple :

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

Q : Quels sont les privilèges utilisateur requis pour exécuter la commande dbaascli database delete ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Que fait l'option --precheckOnly dans la commande dbaascli database delete ?

R : L'option --precheckOnly vous permet d'exécuter uniquement les prévérifications pour l'opération de suppression sans supprimer réellement la base de données. Il garantit que toutes les vérifications réussissent avant de procéder à la suppression réelle.

Q : Puis-je supprimer une base de données sans attendre la fin de l'opération ?

R : Oui. Si vous définissez l'option --waitForCompletion sur False, l'opération de suppression sera exécutée en arrière-plan et vous n'aurez pas à attendre qu'elle se termine.

Exemple 7-14 dbaascli database delete

dbaascli database delete --dbname db19
dbaascli database deleteInstance

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli database deleteInstance ?

R : La commande dbaascli database deleteInstance permet de supprimer une instance Oracle Database spécifique sur un noeud indiqué dans un environnement Exadata Cloud Infrastructure.

Q : Comment indiquer l'instance Oracle Database à supprimer ?

R : Vous pouvez indiquer l'instance Oracle Database à supprimer à l'aide de l'option --dbname pour fournir le nom de la base de données et de l'option --node pour fournir le nom du noeud. Par exemple :

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

Q : Puis-je supprimer l'instance même si le noeud est inaccessible ?

R : Oui, vous pouvez utiliser l'option --continueOnUnreachableNode pour poursuivre la suppression, même si le noeud indiqué est inaccessible. Par exemple :

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

Q : Que se passe-t-il si le noeud indiqué est inaccessible pendant l'opération de suppression d'instance ?

R : Si le noeud est inaccessible et que l'option --continueOnUnreachableNode n'est pas utilisée, l'opération échoue. Si l'option est utilisée, l'opération se poursuit même si le noeud n'est pas accessible.

Q : Comment supprimer une instance de base de données d'un noeud spécifique ?

R : Utilisez la commande suivante pour supprimer une instance de base de données d'un noeud spécifique :

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

Q : Quels sont les privilèges utilisateur requis pour exécuter la commande dbaascli database deleteInstance ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Puis-je supprimer une instance sans spécifier le noeud ?

R : Non. L'option --node est requise pour indiquer le noeud duquel l'instance de base de données doit être supprimée.

Q : Que fait l'option --continueOnUnreachableNode ?

R : L'option --continueOnUnreachableNode permet à l'opération de continuer même si le noeud indiqué n'est pas accessible, ce qui garantit que la suppression de l'instance se poursuit dans les scénarios où le noeud peut être arrêté.

Q : Est-il possible de supprimer plusieurs instances de base de données à la fois à l'aide de cette commande ?

R : Non. La commande dbaascli database deleteInstance permet de supprimer une seule instance de base de données à la fois sur un noeud indiqué. Vous devez exécuter la commande séparément pour chaque instance à supprimer.

Exemple 7-15 database deleteinstance

database deleteinstance --node test-node
dbaascli database duplicate

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli database duplicate ?

R : La commande dbaascli database duplicate permet de créer une base de données Oracle Database en dupliquant une base de données active existante.

Q : Quels sont les prérequis pour utiliser la commande dbaascli database duplicate ?

R : vous devez exécuter la commande en tant qu'utilisateur root.

Q : Comment spécifier la base de données source pour la duplication ?

R : Utilisez l'option --sourceDBConnectionString pour fournir la chaîne de connexion à la base de données source au format <scan_name>:<scan_port>/<database_service_name>. Par exemple :

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

Q : Comment indiquer l'emplacement du répertoire de base Oracle pour la nouvelle base de données ?

R : Vous pouvez indiquer l'emplacement du répertoire de base Oracle à l'aide de l'option --oracleHome ou du nom du répertoire de base Oracle à l'aide de l'option --oracleHomeName. Par exemple :

--oracleHome <value>

ou

--oracleHomeName <value>

Q : Quel est le but de l'option --sourceDBWalletLocation ?

R : L'option --sourceDBWalletLocation indique l'emplacement du fichier de portefeuille TDE de base de données source, requis pour dupliquer la base de données à partir d'une base de données source active.

Q : Puis-je ignorer la duplication de bases pluggables spécifiques à partir de la base de données source ?

R : Oui. Vous pouvez utiliser l'option --skipPDBs pour indiquer une liste de noms de base de données pluggable séparés par des virgules qui doivent être exclus de l'opération de duplication. Par exemple :

--skipPDBs pdb1,pdb2

Q : Comment configurer TDE pour la nouvelle base de données ?

R : Utilisez l'option --tdeConfigMethod pour indiquer la méthode de configuration TDE (FILE ou KMS). Si vous choisissez KMS, vous pouvez fournir l'OCID de clé KMS à l'aide de l'option --kmsKeyOCID. Par exemple :

--tdeConfigMethod FILE

ou

--tdeConfigMethod KMS --kmsKeyOCID <value>

Q : Que fait l'option --executePrereqs ?

R : L'option --executePrereqs indique si seules les vérifications de prérequis doivent être exécutées pour l'opération. Les valeurs valides sont yes pour exécuter uniquement les prérequis ou no pour poursuivre l'opération complète.

Q : Comment puis-je reprendre une opération de duplication précédemment interrompue ?

R : Utilisez l'option --resume avec l'option --sessionID pour reprendre une opération de duplication interrompue précédemment. Par exemple :

--resume --sessionID <value>

Q : Que fait l'option --waitForCompletion ?

R : L'option --waitForCompletion indique s'il faut attendre la fin de l'opération. La définition de ce paramètre sur true attend la fin, tandis que false exécute l'opération en arrière-plan. Par exemple :

--waitForCompletion true

Q : Quel est le but de l'option --rmanParallelism ?

R : L'option --rmanParallelism indique la valeur de parallélisme pour RMAN (Recovery Manager) lors du processus de duplication. Cela peut améliorer la vitesse de l'opération de duplication en utilisant plusieurs processus parallèles.

Q : Comment indiquer la taille de la mémoire SGA et de la mémoire PGA pour la nouvelle base de données ?

R : Utilisez les options --sgaSizeInMB et --pgaSizeInMB pour indiquer la taille de la mémoire SGA (System Global Area) et de la mémoire PGA (Program Global Area) en mégaoctets, respectivement. Par exemple :

--sgaSizeInMB <value>

--pgaSizeInMB <value>

Q : Que fait l'option --revert ?

R : L'option --revert est utilisée pour annuler une opération de duplication précédente. Vous devez indiquer --sessionID pour indiquer la session à rétablir.

Exemple 7-16 dbaascli database duplicate

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

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli database getDetails ?

R : la commande dbaascli database getDetails affiche des informations détaillées sur une base de données Oracle indiquée, notamment le nom de la base de données, les informations de noeud et les détails de la base de données pluggable.

Q : Qui peut exécuter la commande dbaascli database getDetails ?

R : La commande peut être exécutée par l'utilisateur root ou l'utilisateur oracle.

Q : Que spécifie l'option --dbname dans la commande dbaascli database getDetails ?

R : L'option --dbname indique le nom de la base de données Oracle pour laquelle des informations détaillées sont extraites.

Q : Quels types d'informations la commande dbaascli database getDetails fournit-elle ?

R : La commande fournit des détails tels que le nom de la base de données, les informations de noeud et les informations sur les bases de données pluggables associées à la base de données Conteneur.

dbaascli database getPDBs

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

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli database getPDBs ?

R : la commande dbaascli database getPDBs permet de répertorier toutes les bases de données pluggables au sein d'une base de données Conteneur indiquée.

Q : Comment spécifier la base de données Conteneur pour la commande getPDBs ?

R : Vous utilisez l'option --dbname pour indiquer le nom de la base de données Conteneur. Par exemple :

--dbname <value>

Q : Dois-je exécuter la commande dbaascli database getPDBs en tant qu'utilisateur spécifique ?

R : Oui. Vous devez exécuter la commande en tant qu'utilisateur root ou oracle.

Q : Puis-je afficher les bases de données pluggables d'une base de données non Conteneur à l'aide de la commande getPDBs ?

R : Non. La commande getPDBs s'applique uniquement aux bases de données Conteneur. Vous ne pouvez pas utiliser cette commande pour les bases de données non Conteneur.

Q : Quel est le format de la sortie de la commande dbaascli database getPDBs ?

R : La commande renvoie la liste de toutes les bases de données pluggables de la base de données Conteneur indiquée. La sortie inclut généralement les noms de base de données pluggable, les statuts et d'autres détails pertinents sur chaque base de données pluggable.

Q : Cette commande peut-elle être utilisée pour plusieurs bases de données à la fois ?

R : Non, la commande dbaascli database getPDBs fonctionne avec une seule base de données Conteneur à la fois, indiquée par l'option --dbname.

Q : Est-il nécessaire d'arrêter la base de données pour utiliser la commande getPDBs ?

R : Non. La commande getPDBs ne nécessite pas l'arrêt de la base de données. Il peut être exécuté pendant que la base de données Conteneur est opérationnelle.

Exemple 7-17 dbaascli database getPDBs --dbname

dbaascli database getPDBs --dbname apr_db1
dbaascli database modifyParameters

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli database modifyParameters ?

R : La commande dbaascli database modifyParameters permet de modifier ou de réinitialiser les paramètres d'initialisation d'Oracle Database.

Q : Comment spécifier la base de données pour laquelle je veux modifier les paramètres ?

R : Vous devez utiliser l'option --dbname pour indiquer le nom de la base de données pour laquelle vous voulez modifier ou réinitialiser les paramètres.

Q : Comment modifier les paramètres de base de données à l'aide de la commande modifyParameters ?

R : utilisez l'option --setParameters suivie d'une liste de paramètres séparés par des virgules et de leurs nouvelles valeurs. Par exemple :

--setParameters parameter1=valueA,parameter2=valueB

Q : Comment réinitialiser les paramètres à leurs valeurs par défaut à l'aide de cette commande ?

R : utilisez l'option --resetParameters suivie d'une liste de paramètres séparés par des virgules pour rétablir leurs valeurs par défaut. Par exemple :

--resetParameters parameter1,parameter2

Q : Puis-je modifier des paramètres à l'aide d'un fichier de réponses ?

R : Oui. Vous pouvez indiquer l'emplacement absolu d'un fichier JSON de réponse à l'aide de l'option --responseFile. Le fichier doit contenir les paramètres que vous voulez modifier.

Q : Est-il nécessaire d'effectuer une sauvegarde avant de modifier les paramètres ?

R : Bien que cela ne soit pas obligatoire pour toutes les modifications, si vous modifiez des paramètres critiques ou sensibles, il est recommandé d'avoir une sauvegarde en place. Vous pouvez utiliser l'option --backupPrepared pour confirmer qu'une sauvegarde a été préparée.

Q : Puis-je appliquer des modifications uniquement à une instance spécifique d'une base de données multi-instances ?

R : Oui. Vous pouvez indiquer le nom de l'instance à l'aide de l'option --instance. Si cette option n'est pas utilisée, les modifications seront appliquées au niveau de la base de données.

Q : La base de données devra-t-elle être redémarrée (redémarrée) après la modification des paramètres ?

R : Pour certains paramètres statiques, un redémarrage de base de données est requis. Vous pouvez utiliser l'option --allowBounce pour accorder à la base de données le droit de redémarrer si nécessaire.

Q : Que se passe-t-il si je n'autorise pas le redémarrage de la base de données lors de la modification des paramètres statiques ?

R : Si vous n'utilisez pas l'option --allowBounce lors de la modification des paramètres statiques, les modifications ne prendront effet qu'au prochain redémarrage manuel de la base de données.

Q : Puis-je reprendre la modification des paramètres si une session antérieure a été interrompue ?

R : Non, cette commande ne prend pas en charge la reprise de session. Vous devrez réexécuter la commande dès le début.

Exemple 7-18 dbaascli database modifyParameters

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

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

Prérequis

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

Syntaxe

dbaascli database recover --dbname <value>
        {
            --start
                {
                    --untilTime <value>
                    | --untilSCN <value>
                    | --latest
                    | --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>

FAQ

Q : Quel est le but de la commande dbaascli database recover ?

R : La commande dbaascli database recover permet de récupérer une base de données Oracle Database à partir de sauvegardes stockées dans une destination de stockage de sauvegarde.

Q : Comment spécifier la base de données à récupérer ?

R : Vous pouvez indiquer la base de données à récupérer à l'aide de l'option --dbname suivie du nom de la base de données. Par exemple :

--dbname <database_name>

Q : Quelles sont les options de récupération disponibles avec la commande dbaascli database recover ?

R : Les options de récupération sont les suivantes :

--untilTime : permet de récupérer la base de données à une heure spécifique.

--untilSCN : permet de récupérer la base de données vers un SCN spécifique.

--latest : récupère la base de données dans le dernier état connu.

--tag : récupère la base de données à l'aide d'une balise d'archivage.

Q : Comment puis-je récupérer la base de données à une heure spécifique ?

R : utilisez l'option --untilTime suivie de l'heure au format DD-MON-YYYY HH24:MI:SS. Par exemple :

--untilTime 05-SEP-2024 15:30:00

Q : Comment récupérer la base de données sur un SCN spécifique ?

R : utilisez l'option --untilSCN suivie de la valeur SCN. Par exemple :

--untilSCN 123456789

Q : Comment puis-je récupérer la base de données dans le dernier état connu ?

R : utilisez l'option --latest pour récupérer la base de données à l'état le plus récent possible. Par exemple :

--latest

Q : Quelle est l'utilisation de l'option --tag dans le processus de récupération ?

R : L'option --tag vous permet de récupérer la base de données à l'aide d'une balise d'archivage associée aux sauvegardes. Par exemple :

--tag <backup_tag>

Q : Comment puis-je vérifier le statut d'une opération de récupération ?

R : utilisez l'option --status avec la valeur --uuid pour vérifier le statut d'une opération de récupération en cours ou précédente. Par exemple :

--status --uuid <recovery_uuid>

Q : Que fait l'option --start dans le processus de récupération ?

R : L'option --start lance l'opération de récupération en fonction de la méthode de récupération sélectionnée (--untilTime, --untilSCN, --latest ou --tag).

Q : Existe-t-il un moyen de récupérer la base de données sans indiquer d'heure ou de numéro SCN ?

R : Oui. Vous pouvez restaurer le dernier état connu de la base de données à l'aide de l'option --latest, qui ne nécessite pas de spécifier d'heure ou de numéro SCN.

Q : Puis-je effectuer une récupération partielle ?

R : Oui. Vous pouvez récupérer la base de données jusqu'à un point dans le temps ou un SCN spécifique à l'aide des options --untilTime ou --untilSCN, respectivement.

Exemple 7-19 Exemples

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

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

Prérequis

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

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

Syntaxe

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

Où :

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

FAQ

Q : Quel est le but de la commande dbaascli database runDatapatch ?

R : La commande dbaascli database runDatapatch est utilisée pour appliquer des patches à une base de données Oracle Database.

Q : Qu'est-ce qui doit être garanti avant d'exécuter la commande dbaascli database runDatapatch ?

R : Avant d'exécuter la commande, assurez-vous que toutes les instances de la base de données sont en fonctionnement.

Q : Comment spécifier la base de données à corriger ?

R : utilisez l'option --dbname suivie du nom de la base de données. Par exemple :

--dbname myDatabase

Q : Comment reprendre une opération runDatapatch précédemment interrompue ?

R : utilisez l'option --resume pour reprendre l'exécution précédente ou l'option --sessionID pour spécifier un ID de session spécifique. Par exemple :

--resume

--sessionID 12345

Q : Comment ignorer certaines bases de données pluggables lors de l'exécution du patch ?

R : utilisez l'option --skipPdbs suivie d'une liste de noms de base de données pluggable séparés par des virgules à ignorer. Par exemple :

--skipPdbs pdb1,pdb2

Q : Comment exécuter le patch uniquement sur certaines bases de données pluggables ?

R : utilisez l'option --pdbs suivie d'une liste de noms de base de données pluggable séparés par des virgules à inclure. Par exemple :

--pdbs pdb1,pdb2

Q : Comment appliquer ou annuler un ensemble spécifique de patches ?

R : utilisez l'option --patchList suivie d'une liste de noms de patch séparés par des virgules à appliquer ou à annuler. Par exemple :

--patchList patch1,patch2

Q : Que fait l'option --rollback ?

R : L'option --rollback annule (rollback) les patches appliqués lors de l'opération d'application de patches.

Q : Que se passe-t-il si certaines bases de données pluggables sont fermées pendant l'opération d'application de patches ?

R : Si certaines bases de données pluggables sont fermées, vous pouvez utiliser l'option --skipClosedPdbs pour ignorer l'application de patches à ces bases de données pluggables fermées.

Q : Puis-je exécuter des vérifications de prérequis avant d'appliquer des patches ?

R : Oui, utilisez l'option --executePrereqs pour exécuter les vérifications de prérequis avant d'appliquer le patch.

Q : Comment trouver l'ID de session pour reprendre un patch ?

R : Après une opération runDatapatch, l'ID de session est généralement journalisé. Utilisez l'option --sessionID pour spécifier cet ID lors de la reprise d'un patch. Par exemple :

--sessionID 67890

dbaascli database runDatapatch --dbname db19
dbaascli database start

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

Prérequis

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

Syntaxe

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

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

FAQ

Q : Quel est le but de la commande dbaascli database start ?

R : La commande dbaascli database start permet de démarrer une instance Oracle Database.

Q : Que doit-on faire avant d'exécuter la commande dbaascli database start ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Comment spécifier la base de données que je veux démarrer ?

R : utilisez l'option --dbname suivie du nom de la base de données. Par exemple :

--dbname myDatabase

Q : Quels sont les modes possibles dans lesquels je peux démarrer la base de données ?

R : Vous pouvez démarrer la base de données en mode mount ou nomount à l'aide de l'option --mode. Par exemple :

--mode mount

Q : Quel est le mode par défaut si je n'en spécifie pas un ?

R : Si vous n'indiquez pas de mode, la base de données démarre en mode open par défaut.

Q : Cette commande ouvrira-t-elle toutes les bases de données pluggables dans Oracle Database 12c ou version ultérieure ?

R : Oui. Lors du démarrage de la base de données dans Oracle Database 12c ou une version ultérieure, toutes les bases de données pluggables sont également ouvertes.

Q : Comment démarrer une base de données en mode nomount ?

R : utilisez l'option --mode et définissez-la sur nomount. Par exemple :

--mode nomount

Q : Comment démarrer une base de données en mode montage ?

R : utilisez l'option --mode et définissez-la sur Montage. Par exemple :

--mode mount

Q : Est-il obligatoire d'indiquer un nom de base de données lors de l'exécution de la commande dbaascli database start ?

R : Oui. Il est recommandé d'indiquer le nom de la base de données à l'aide de l'option --dbname pour vous assurer que la base de données correcte est démarrée.

Exemple 7-20 dbaascli database start

dbaascli database start --dbname dbname --mode mount
dbaascli database stop

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

Prérequis

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

Syntaxe

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

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

FAQ

Q : Quel est le but de la commande dbaascli database stop ?

R : La commande dbaascli database stop est utilisée pour arrêter une base de données Oracle Database.

Q : Quels sont les prérequis pour utiliser la commande dbaascli database stop ?

R : Vous devez exécuter la commande en tant qu'utilisateur root et vous connecter à une machine virtuelle Exadata Cloud@Customer à l'aide de SSH.

Q : Comment spécifier la base de données à arrêter ?

R : Vous pouvez indiquer la base de données à l'aide de l'option --dbname, suivie du nom de la base de données. Par exemple :

--dbname myDatabase

Q : Quels sont les modes d'arrêt valides pour la commande dbaascli database stop ?

R : Les modes d'arrêt valides sont les suivants :

abort

immediate

normal

transactional

Q : Quel est le mode d'arrêt par défaut si aucun mode n'est spécifié ?

R : Si aucun mode n'est spécifié, la base de données sera arrêtée en mode immediate par défaut.

Q : Que se passe-t-il en mode d'arrêt immédiat ?

R : En mode immediate, aucune nouvelle connexion ou transaction n'est autorisée, les transactions actives sont annulées et tous les utilisateurs connectés sont déconnectés.

Q : Comment puis-je arrêter la base de données en mode d'abandon ?

R : Pour arrêter la base de données en mode Abandon, utilisez l'option --mode avec Abandon. Par exemple :

--mode abort

Q : Que fait le mode normal lors de l'arrêt de la base de données ?

R : En mode normal, la base de données permet aux sessions utilisateur en cours de se terminer, puis s'arrête sans affecter les transactions actives.

Q : A quoi sert le mode transactionnel dans la commande dbaascli database stop ?

R : En mode transactional, la base de données ne s'arrête qu'une fois toutes les transactions actives terminées, mais aucune nouvelle transaction n'est autorisée.

Q : Est-il obligatoire d'indiquer le mode d'arrêt dans la commande dbaascli database stop ?

R : Non. La spécification d'un mode shutdown est facultative. S'il n'est pas indiqué, le mode immédiat par défaut est utilisé.

Exemple 7-21 dbaascli database stop

dbaascli database stop --dbname db19
dbaascli database upgrade

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

Prérequis

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

Syntaxe

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

    --standby

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

FAQ

Q : Quel est le but de la commande dbaascli database upgrade ?

R : La commande dbaascli database upgrade permet de mettre à niveau Oracle Database vers une nouvelle version.

Q : Quels sont les prérequis pour utiliser la commande dbaascli database upgrade ?

R : vous devez exécuter la commande en tant qu'utilisateur root et vous connecter à une machine virtuelle Exadata Cloud@Customer à l'aide de SSH.

Q : Comment spécifier la base de données à mettre à niveau ?

R : utilisez l'option --dbname suivie du nom de la base de données. Par exemple :

--dbname myDatabase

Q : Comment indiquer le répertoire de base Oracle cible pour la mise à niveau ?

R : Vous pouvez indiquer l'emplacement du répertoire de base Oracle cible avec l'option --targetHome ou le nom du répertoire de base Oracle Database cible avec l'option --targetHomeName.

Q : Que fait l'option --standBy ?

R : L'option --standBy permet de mettre à niveau les bases de données de secours dans les configurations Data Guard.

Q : Quel est le but de l'indicateur --allStandbyPrepared ?

R : l'indicateur --allStandbyPrepared reconnaît que toutes les opérations requises sur les bases de données de secours ont été effectuées avant la mise à niveau de la base de données principale dans une configuration Data Guard.

Q : Que fait l'option --removeGRP ?

R : L'option --removeGRP enlève automatiquement la sauvegarde du point de restauration garanti si la base de données a été mise à niveau.

Q : Quand dois-je utiliser l'option --increaseCompatibleParameter ?

R : utilisez l'option --increaseCompatibleParameter pour augmenter automatiquement le paramètre compatible lors de la mise à niveau de la base de données, à condition que la mise à niveau réussisse.

Q : Que fait l'option --executePrereqs ?

R : L'option --executePrereqs exécute uniquement les vérifications préalables à la mise à niveau pour s'assurer que la base de données est prête pour la mise à niveau.

Q : Comment gérer une étape post-mise à niveau ayant échoué ?

R : Utilisez l'option --postUpgrade pour réexécuter les étapes postérieures à la mise à niveau en cas d'échec de la tentative initiale après la mise à niveau.

Q : Quel est le but de l'option --revert ?

R : L'option --revert rétablit le répertoire de base Oracle d'origine d'Oracle Database, ce qui annule la mise à niveau.

Q : Comment transmettre des arguments supplémentaires propres à DBUA pour la mise à niveau ?

R : Utilisez l'option --upgradeOptions pour transmettre des arguments propres à DBUA pour la mise à niveau d'Oracle Database. Reportez-vous à la documentation Oracle pour connaître les options et arguments pris en charge.

Q : Est-il obligatoire d'indiquer le répertoire de base Oracle cible pour la mise à niveau ?

R : Oui. Vous devez indiquer --targetHome ou --targetHomeName pour indiquer le répertoire de base Oracle cible pour la mise à niveau.

Q : Que dois-je faire si je dois effectuer une vérification avant la mise à niveau sans procéder à la mise à niveau ?

R : Utilisez l'option --executePrereqs pour effectuer uniquement les vérifications préalables à la mise à niveau sans poursuivre la mise à niveau réelle.

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

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

Gestion de Data Guard

Cette section traite de la gestion des configurations et des opérations Oracle Data Guard. Elle inclut des commandes telles que dbaascli dataguard prepareStandbyBlob pour générer un fichier BLOB afin de configurer un site de secours et dbaascli dataguard updateDGConfigAttributes pour mettre à jour les attributs d'automatisation Data Guard sur tous les noeuds de cluster. Ces commandes rationalisent la configuration et la maintenance des environnements Data Guard à des fins de haute disponibilité et de récupération après sinistre.

dbaascli dataguard prepareStandbyBlob

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

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli dataguard prepareStandbyBlob ?

R : la commande dbaascli dataguard prepareStandbyBlob permet de générer un fichier BLOB contenant divers fichiers requis sur le site de secours dans un environnement Data Guard.

Q : Quels sont les prérequis pour exécuter la commande dbaascli dataguard prepareStandbyBlob ?

R : la commande doit être exécutée en tant qu'utilisateur root ou oracle.

Q : Comment indiquer le nom de l'instance Oracle Database pour laquelle je veux préparer le blob de secours ?

R : utilisez l'option --dbname suivie du nom d'Oracle Database. Par exemple :

--dbname myDatabase

Q : Comment spécifier l'emplacement où le fichier BLOB de secours sera généré ?

R : Utilisez l'option --blobLocation pour indiquer le chemin du répertoire personnalisé où le fichier BLOB de secours sera généré. Par exemple :

--blobLocation /path/to/standby_blob

Q : Que fait l'option --dbname dans la commande ?

R : L'option --dbname indique le nom de l'instance Oracle Database pour laquelle le fichier BLOB de secours est en cours de préparation.

Q : Quel est le but de l'option --blobLocation ?

R : L'option --blobLocation définit le chemin du répertoire personnalisé dans lequel le fichier BLOB de secours sera créé.

Q : Puis-je exécuter la commande dbaascli dataguard prepareStandbyBlob en tant qu'utilisateur autre que root ou oracle ?

R : Non, la commande doit être exécutée en tant qu'utilisateur root ou oracle.

Q : Est-il possible d'utiliser un chemin relatif pour l'option --blobLocation ?

R : Il est recommandé d'utiliser un chemin absolu pour l'option --blobLocation afin de garantir que le fichier BLOB de secours est créé dans le répertoire approprié.

Q : Que dois-je faire si je veux changer l'emplacement où le fichier BLOB de secours est généré ?

R : Modifiez l'option --blobLocation pour indiquer un nouveau chemin de répertoire pour le fichier BLOB de secours.

Q : Dois-je effectuer des étapes supplémentaires après avoir généré le fichier BLOB de secours ?

R : Oui. Après avoir généré le fichier BLOB de secours, vous devez le transférer vers le site de secours et l'utiliser pour la configuration Data Guard.

dbaascli dataguard updateDGConfigAttributes

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

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli dataguard updateDGConfigAttributes ?

R : la commande dbaascli dataguard updateDGConfigAttributes est utilisée pour mettre à jour les attributs d'automatisation Data Guard sur tous les noeuds de cluster.

Q : Quels sont les prérequis pour exécuter la commande dbaascli dataguard updateDGConfigAttributes ?

R : la commande doit être exécutée en tant qu'utilisateur root ou oracle.

Q : Comment spécifier les attributs que je veux mettre à jour à l'aide de cette commande ?

R : Utilisez l'option --attributes suivie des attributs à modifier. Les attributs doivent être au format délimité par des virgules, par exemple attribute=value. Par exemple :

--attributes attribute1=value1,attribute2=value2

Q : Dans quel format les valeurs de l'option --attributes doivent-elles être présentes ?

R : Les valeurs de l'option --attributes doivent être au format délimité par des virgules, chaque attribut étant indiqué comme attribute=value.

Q : Puis-je spécifier plusieurs attributs dans l'option --attributes ?

R : Oui, vous pouvez spécifier plusieurs attributs en les séparant par des virgules. Par exemple :

--attributes attribute1=value1,attribute2=value2

Q : Que se passe-t-il si je fournis un attribut qui n'est pas prédéfini dans le fichier de configuration Data Guard ?

R : Si vous fournissez un attribut qui n'est pas prédéfini, la commande peut échouer ou ignorer l'attribut non reconnu. Assurez-vous que tous les attributs sont prédéfinis dans le fichier de configuration Data Guard.

Q : Dois-je redémarrer des services après avoir mis à jour les attributs d'automatisation Data Guard ?

R : Dans la plupart des cas, vous n'avez pas besoin de redémarrer les services après avoir mis à jour les attributs. Cependant, vérifiez les attributs spécifiques et leur impact pour déterminer si un redémarrage est nécessaire.

Q : Comment vérifier si les attributs Data Guard ont été mis à jour ?

R : Après avoir exécuté la commande, vous pouvez vérifier les attributs mis à jour en vérifiant la configuration Data Guard ou en utilisant les commandes/outils de vérification appropriés propres à votre configuration.

Q : Que dois-je faire si la commande ne parvient pas à mettre à jour les attributs ?

R : Vérifiez les messages d'erreur pour plus de détails sur ce qui s'est passé. Assurez-vous que vous avez indiqué les attributs corrects et qu'ils sont prédéfinis dans le fichier de configuration Data Guard. Vérifiez les autorisations utilisateur et la syntaxe des commandes.

Q : Est-il possible de mettre à jour les attributs uniquement pour des noeuds spécifiques à l'aide de cette commande ?

R : Non. La commande dbaascli dataguard updateDGConfigAttributes met à jour les attributs sur tous les noeuds de cluster. Si vous devez mettre à jour des attributs pour des noeuds spécifiques, vous devrez peut-être utiliser différentes méthodes ou commandes.

basculement dbaascli dataguard

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

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

Syntaxe

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

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

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

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

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

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

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

Syntaxe

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

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

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

  • Sur le nouveau cluster principal :

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

  • Sur l'ancien cluster principal :

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

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

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

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

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

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

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

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

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

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

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

Syntaxe

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

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

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

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

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

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

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

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

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

Remarque

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

Syntaxe

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

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

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

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

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

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

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

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

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

Syntaxe

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

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

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

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

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

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

dbaascli dataguard registerStandby

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

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

Syntaxe

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

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

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

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

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

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

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

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

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

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

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

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

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

Syntaxe

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

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

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

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

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

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

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

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

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

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

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

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

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

Syntaxe

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

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

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

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

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

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

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

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

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

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

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

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

dbaascli dataguard updateConfiguration

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

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

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

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

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

Syntaxe

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

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

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

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

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

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

Gestion de répertoire de base de base de données

Cette section fournit des outils permettant de gérer les répertoires de base Oracle Database. Elle inclut des commandes telles que dbaascli dbhome create pour créer un répertoire de base Oracle Database et dbaascli dbHome delete pour en enlever un existant. Vous pouvez également visualiser des informations détaillées sur un répertoire de base Oracle spécifique avec dbaascli dbHome getDetails et vérifier quelles bases de données sont exécutées à partir d'un répertoire de base Oracle donné à l'aide de dbaascli dbhome getDatabases. Ces commandes assurent une gestion efficace des environnements de base de données.

dbaascli dbhome create

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli dbhome create ?

R : La commande dbaascli dbhome create permet de créer un répertoire de base Oracle Database avec la version souhaitée.

Q : Quels sont les prérequis pour exécuter la commande dbaascli dbhome create ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Comment indiquer la version d'Oracle Database lors de la création d'un répertoire de base Oracle ?

R : Utilisez l'option --version suivie de la version d'Oracle Database au format de cinq segments numériques séparés par des points, tels que 19.11.0.0.0.

Q : Que précise l'option --oracleHome ?

R : L'option --oracleHome indique l'emplacement où vous souhaitez installer le répertoire de base Oracle. S'il n'est pas fourni, l'emplacement par défaut est utilisé.

Q : Puis-je affecter un nom personnalisé au nouveau répertoire de base Oracle ?

R : Oui. Vous pouvez utiliser l'option --oracleHomeName pour indiquer un nom défini par l'utilisateur pour le répertoire de base Oracle. S'il n'est pas indiqué, un nom par défaut est utilisé.

Q : Comment activer ou désactiver l'audit unifié dans le nouveau répertoire de base Oracle ?

R : utilisez l'option --enableUnifiedAuditing et indiquez true pour activer ou false pour désactiver l'audit unifié pour le répertoire de base Oracle.

Q : Que fait l'option --imageTag ?

R : L'option --imageTag indique la balise d'image du répertoire de base Oracle, qui peut être utilisée dans les cas où la balise d'image diffère de la version.

Q : Quel est un exemple d'utilisation de la commande dbaascli dbhome create avec la balise version et image ?

R : Exemple de commande avec une balise de version et d'image :

dbaascli dbhome create --version 19.8.0.0.0 --imageTag 19.8.0.0.0

Cela crée un répertoire de base Oracle pour la version 19.8.0.0.0 avec la balise d'image correspondante.

Q : Que se passe-t-il si je ne fournis pas les options --oracleHome ou --oracleHomeName ?

R : Si --oracleHome n'est pas fourni, le répertoire de base Oracle sera installé à l'emplacement par défaut. Si --oracleHomeName n'est pas indiqué, un nom par défaut est affecté au répertoire de base Oracle.

Q : Comment vérifier si la création du répertoire de base Oracle a réussi ?

R : Après avoir exécuté la commande, vérifiez les messages de succès ou les erreurs dans les journaux de sortie. Vous pouvez également vérifier le répertoire de base Oracle en accédant à l'emplacement indiqué ou à l'aide d'outils Oracle tels que orainstRoot.sh.

Q : Est-il possible de créer plusieurs répertoires de base Oracle avec différentes versions sur le même système ?

R : Oui. Vous pouvez créer plusieurs répertoires de base Oracle avec des versions différentes en indiquant des valeurs différentes pour les options --version et --oracleHomeName.

Q : Que dois-je faire en cas d'échec de la création du répertoire de base Oracle ?

R : Pour obtenir des messages d'erreur détaillés, consultez les journaux de sortie. Vérifiez que vous disposez du format de version correct, des droits d'accès requis et d'un espace disque suffisant. Corrigez tout problème et réessayez d'exécuter la commande.

Exemple 7-23 dbaascli dbhome create

dbaascli dbhome create --version 19.11.0.0.0

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

dbaascli dbHome delete

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli dbHome delete ?

R : La commande dbaascli dbHome delete permet de supprimer un répertoire de base Oracle Database indiqué du système.

Q : Quels sont les prérequis pour l'exécution de la commande dbaascli dbHome delete ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Comment indiquer le répertoire de base Oracle à supprimer ?

R : Vous pouvez indiquer le répertoire de base Oracle à supprimer à l'aide de l'une des options suivantes :

--oracleHome <value> pour fournir le chemin absolu de l'emplacement du répertoire de base Oracle.

--oracleHomeName <value> pour fournir le nom du répertoire de base Oracle.

Q : Quelle est la différence entre les options --oracleHome et --oracleHomeName ?

A :

--oracleHome indique l'emplacement physique ou le chemin du répertoire de base Oracle à supprimer.

--oracleHomeName indique le nom défini par l'utilisateur du répertoire de base Oracle à supprimer.

Q : Comment puis-je reprendre un processus de suppression précédemment interrompu ?

R : Vous pouvez utiliser l'option --resume pour reprendre un processus de suppression précédent. Si vous connaissez l'ID de session spécifique du processus, vous pouvez l'inclure avec l'option --sessionID.

Q : A quoi sert l'option --sessionID dans la commande dbaascli dbHome delete ?

R : L'option --sessionID est utilisée pour reprendre une session spécifique qui a été interrompue ou qui a échoué au cours du processus de suppression.

Q : Que se passe-t-il si je ne fournis pas les options --resume ou --sessionID ?

R : si les options --resume ou --sessionID ne sont pas fournies, la commande lance un nouveau processus de suppression au lieu de reprendre un processus interrompu.

Q : Existe-t-il un moyen de confirmer la suppression du répertoire de base Oracle après l'exécution de la commande ?

R : Vous pouvez vérifier la suppression en vérifiant les messages de succès dans les journaux de sortie et en vous assurant que le répertoire de base Oracle n'est plus présent à l'emplacement indiqué.

Q : Puis-je supprimer un répertoire de base Oracle actuellement utilisé par une base de données en cours d'exécution ?

R : Non. Le répertoire de base Oracle ne doit être utilisé par aucune base de données ou aucun service en cours d'exécution pendant le processus de suppression. Veillez à arrêter les bases de données associées avant d'exécuter la commande delete.

Q : Que dois-je faire en cas d'échec de la commande dbaascli dbHome delete ?

R : Consultez les journaux de sortie pour connaître les messages d'erreur. Assurez-vous que le répertoire de base Oracle n'est pas utilisé, vérifiez l'emplacement ou le nom correct du répertoire de base Oracle et vérifiez que vous disposez des droits d'accès nécessaires. Après avoir résolu les problèmes, réexécutez la commande ou utilisez l'option --resume si nécessaire.

Q : Puis-je supprimer plusieurs répertoires de base Oracle à la fois à l'aide de la commande dbaascli dbHome delete ?

R : Non. La commande vous permet uniquement de supprimer un répertoire de base Oracle à la fois en indiquant l'option --oracleHome ou --oracleHomeName.

Q : Quel est l'exemple de suppression d'un répertoire de base Oracle par son nom ?

R : Voici un exemple de suppression d'un répertoire de base Oracle par son nom :

dbaascli dbHome delete --oracleHomeName myOracleHome

Cette commande supprime le répertoire de base Oracle nommé myOracleHome.

Q : Quel est l'exemple de suppression d'un répertoire de base Oracle par son emplacement ?

R : Voici un exemple de suppression d'un répertoire de base Oracle en indiquant son emplacement :

dbaascli dbHome delete --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

Cette commande supprime le répertoire de base Oracle situé dans /u01/app/oracle/product/19.0.0/dbhome_1.

Q : Puis-je annuler le processus de suppression une fois qu'il a commencé ?

R : Non, une fois que le processus de suppression a commencé, il ne peut pas être annulé. Assurez-vous que le répertoire de base Oracle est prêt à être supprimé avant d'exécuter la commande.

dbaascli dbhome getDatabases

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

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli dbHome getDatabases ?

R : La commande dbaascli dbHome getDatabases permet de visualiser des informations sur toutes les bases de données Oracle exécutées à partir d'un répertoire de base Oracle Database spécifique.

Q : Comment indiquer le répertoire de base Oracle Database à vérifier ?

R : Vous pouvez indiquer le répertoire de base Oracle Database à l'aide de l'une des options suivantes :

--oracleHomeName <value> permet d'indiquer le nom défini par l'utilisateur du répertoire de base Oracle.

--oracleHome <value> pour indiquer l'emplacement complet (chemin) du répertoire de base Oracle.

Q : Quelle est la différence entre les options --oracleHomeName et --oracleHome ?

A :

--oracleHomeName fait référence à un nom défini par l'utilisateur pour le répertoire de base Oracle.

--oracleHome fait référence à l'emplacement physique (ou au chemin de répertoire) du répertoire de base Oracle sur le système.

Q : Comment exécuter la commande dbaascli dbHome getDatabases ?

R : Pour exécuter la commande, utilisez la syntaxe suivante :

dbaascli dbHome getDatabases --oracleHomeName <value>

ou

dbaascli dbHome getDatabases --oracleHome <value>

Assurez-vous d'exécuter la commande en tant qu'utilisateur root.

Q : Puis-je indiquer à la fois le nom du répertoire de base Oracle et l'emplacement du répertoire de base Oracle dans la même commande ?

R : Non. Vous ne pouvez indiquer --oracleHomeName ou --oracleHome que dans une seule exécution de commande. Choisissez une option en fonction de l'identification du répertoire de base Oracle.

Q : Quel type d'informations la commande dbaascli dbHome getDatabases renvoie-t-elle ?

R : La commande renvoie des informations sur toutes les bases de données Oracle exécutées à partir du répertoire de base Oracle indiqué. Cela inclut des détails tels que les noms et les statuts de base de données.

Q : Quel est l'exemple d'utilisation de dbaascli dbHome getDatabases avec l'emplacement du répertoire de base Oracle ?

R : Voici un exemple d'utilisation de la commande avec l'emplacement du répertoire de base Oracle :

dbaascli dbHome getDatabases --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

Cette commande extrait la liste des bases de données exécutées à partir du répertoire de base Oracle situé à l'emplacement /u01/app/oracle/product/19.0.0/dbhome_1.

Q : Quel est l'exemple d'utilisation de dbaascli dbHome getDatabases avec le nom du répertoire de base Oracle ?

R : Voici un exemple d'utilisation de la commande avec le nom du répertoire de base Oracle :

dbaascli dbHome getDatabases --oracleHomeName myOracleHome

Cette commande extrait la liste des bases de données exécutées à partir du répertoire de base Oracle nommé myOracleHome.

Q : Ai-je besoin d'autorisations spéciales pour exécuter cette commande ?

R : Oui. Vous devez exécuter la commande en tant qu'utilisateur root pour visualiser les informations sur les bases de données Oracle exécutées à partir d'un répertoire de base Oracle indiqué.

Q : Que dois-je vérifier si la commande dbaascli dbHome getDatabases ne renvoie aucune base de données ?

R : Assurez-vous que vous avez indiqué le nom ou l'emplacement correct du répertoire de base Oracle et que des bases de données sont exécutées à partir de ce répertoire de base Oracle. Vérifiez également que le répertoire de base Oracle est correctement configuré et actif.

Q : Puis-je utiliser la commande dbaascli dbHome getDatabases sur plusieurs répertoires de base Oracle à la fois ?

R : Non, la commande fonctionne sur un seul répertoire de base Oracle à la fois. Vous devez exécuter la commande séparément pour chaque répertoire de base Oracle à interroger.

Q : Existe-t-il un moyen de vérifier que le répertoire de base Oracle indiqué dans la commande est correct ?

R : Vous pouvez vérifier le répertoire de base Oracle en consultant la structure de répertoires ou les détails de configuration de votre système pour vous assurer que le chemin ou le nom fourni correspond au répertoire de base Oracle réel.

Q : Que se passe-t-il si j'exécute la commande sans indiquer de nom de répertoire de base Oracle ou Oracle ?

R : La commande requiert la spécification de l'option --oracleHome ou --oracleHomeName. Si aucune option n'est fournie, l'exécution de la commande échoue.

Q : Cette commande peut-elle extraire les bases de données actuellement arrêtées ?

R : Oui. La commande répertorie toutes les bases de données associées au répertoire de base Oracle indiqué, qu'elles soient en cours d'exécution ou arrêtées.

Exemple 7-24 dbaascli dbHome getDatabases --oracleHome

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

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli dbHome getDetails ?

R : La commande dbaascli dbHome getDetails permet d'afficher des informations détaillées sur un répertoire de base Oracle spécifique sur le système.

Q : Comment indiquer le répertoire de base Oracle pour lequel obtenir des détails ?

R : Vous pouvez indiquer le répertoire de base Oracle à l'aide de l'une des options suivantes :

--oracleHomeName <value> permet d'indiquer le nom défini par l'utilisateur du répertoire de base Oracle.

--oracleHome <value> pour indiquer l'emplacement complet (chemin) du répertoire de base Oracle.

Q : Quelle est la différence entre --oracleHomeName et --oracleHome ?

A :

--oracleHomeName est le nom défini par l'utilisateur d'un répertoire de base Oracle.

--oracleHome fait référence au chemin complet du répertoire dans lequel se trouve le répertoire de base Oracle.

Q : Comment exécuter la commande dbaascli dbHome getDetails ?

R : Pour exécuter la commande, utilisez la syntaxe suivante :

dbaascli dbHome getDetails --oracleHomeName <value>

ou

dbaascli dbHome getDetails --oracleHome <value>

Veillez à exécuter la commande en tant qu'utilisateur root.

Q : Puis-je spécifier --oracleHomeName et --oracleHome dans la même commande ?

R : Non, vous ne pouvez utiliser qu'une seule option par exécution de commande. Vous devez indiquer le nom du répertoire de base Oracle ou son emplacement, pas les deux.

Q : Quelles informations la commande dbaascli dbHome getDetails renvoie-t-elle ?

R : La commande fournit des informations détaillées sur le répertoire de base Oracle indiqué, telles que sa version, son statut et tout autre détail de configuration associé au répertoire de base Oracle.

Q : Quel est l'exemple d'utilisation de la commande dbaascli dbHome getDetails avec un emplacement de répertoire de base Oracle ?

R : Voici un exemple :

dbaascli dbHome getDetails --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

Cette commande extrait des informations détaillées sur le répertoire de base Oracle situé à l'emplacement /u01/app/oracle/product/19.0.0/dbhome_1.

Q : Quel est l'exemple d'utilisation de la commande dbaascli dbHome getDetails avec un nom de répertoire de base Oracle ?

R : Voici un exemple :

dbaascli dbHome getDetails --oracleHomeName myOracleHome

Cette commande extrait des informations détaillées sur le répertoire de base Oracle nommé myOracleHome.

Q : Ai-je besoin d'autorisations spéciales pour exécuter cette commande ?

R : Oui. Vous devez exécuter la commande en tant qu'utilisateur root pour visualiser les détails du répertoire de base Oracle.

Q : Que dois-je faire si la commande dbaascli dbHome getDetails ne renvoie aucune information ?

R : Assurez-vous que vous avez correctement indiqué le nom ou l'emplacement du répertoire de base Oracle et que le répertoire de base Oracle est correctement configuré et existe sur le système.

Q : Puis-je utiliser la commande dbaascli dbHome getDetails sur plusieurs répertoires de base Oracle simultanément ?

R : Non. La commande ne fonctionne que sur un seul répertoire de base Oracle à la fois. Vous devez exécuter la commande séparément pour chaque répertoire de base Oracle.

Q : Est-il possible de vérifier le nom du répertoire de base Oracle avant d'exécuter la commande ?

R : Oui. Vous pouvez vérifier le nom du répertoire de base Oracle en vérifiant les fichiers de configuration de votre système ou en répertoriant tous les répertoires de base Oracle disponibles sur votre système.

Q : Que se passe-t-il si je n'indique pas de nom ou d'emplacement de répertoire de base Oracle dans la commande ?

R : La commande requiert la spécification de l'option --oracleHome ou --oracleHomeName. Si aucune des deux n'est fournie, l'exécution de la commande échoue.

Q : Puis-je extraire des informations sur les répertoires de base Oracle qui ne sont pas utilisés actuellement ?

R : Oui. La commande dbaascli dbHome getDetails fournit des détails sur les répertoires de base Oracle, qu'ils soient en cours d'utilisation ou inactifs.

Q : Que dois-je vérifier si la commande renvoie une erreur ?

R : assurez-vous que le nom ou l'emplacement du répertoire de base Oracle est correct, que le répertoire de base Oracle existe et que vous exécutez la commande en tant qu'utilisateur root. Vérifiez à nouveau les fautes de frappe ou les chemins incorrects.

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

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

Exemple 7-26 dbaascli dbHome getDetails : utilisation du nom du répertoire de base Oracle

dbaascli dbHome getDetails --oracleHomeName home_db19c

Diagnostics et vérifications de l'état

Cette section présente les outils permettant de maintenir l'état et de diagnostiquer les problèmes dans les environnements Oracle Database. Des commandes telles que dbaascli diag collect sont utilisées pour collecter des données de diagnostic, tandis que dbaascli diag healthCheck vous permet d'exécuter des vérifications de l'état pour identifier les problèmes potentiels. Ces outils contribuent à assurer la stabilité et les performances du système en surveillant et en répondant de manière proactive aux préoccupations.

dbaascli diag collect

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

Prérequis

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

Syntaxe

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

    Valeurs valides :

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

FAQ

Q : Quel est le but de la commande dbaascli diag collect ?

R : La commande dbaascli diag collect est utilisée pour collecter les journaux de diagnostic pour Oracle Database et les composants associés tels que le système d'exploitation, Grid Infrastructure (GI) et les outils DBaaS.

Q : Comment spécifier les composants pour lesquels collecter des diagnostics ?

R : Vous pouvez spécifier les composants à l'aide de l'option --components. Valeurs valides :

db (pour les journaux de base de données)

gi (pour les journaux Grid Infrastructure)

os (pour les journaux du système d'exploitation)

dbaastools (pour les journaux des outils DBaaS)

all (pour collecter les journaux de tous les composants)

Q : Comment puis-je collecter des journaux pour une période spécifique ?

R : Utilisez les options suivantes pour spécifier une période :

--startTime <value> permet de définir l'heure de début de la collecte de journaux.

--endTime <value> permet de définir l'heure de fin de la collecte de journaux.

L'heure doit être au format suivant : YYYY-MM-DDTHH24:MM:SS.

Q : Dans quel format les heures de début et de fin doivent-elles être ?

R : --startTime et --endTime doivent tous deux être au format YYYY-MM-DDTHH24:MM:SS. Par exemple, 2024-09-01T15:30:00.

Q : Comment spécifier les noeuds à partir desquels collecter les diagnostics ?

R : Vous pouvez utiliser l'option --nodes pour indiquer une liste de noeuds séparés par des virgules. Par exemple :

--nodes node1,node2

Q : Comment collecter des journaux pour une base de données spécifique ?

R : Utilisez l'option --dbNames pour indiquer le nom de la base de données pour laquelle collecter des journaux. Un seul nom de base de données peut être indiqué à la fois.

Q : Comment stocker les journaux collectés dans Object Storage ?

R : utilisez l'option --objectStoreBucketUri afin d'indiquer l'URL de demande pré-authentifiée pour le bucket Object Storage dans lequel les journaux seront téléchargés.

Q : Puis-je collecter des journaux vers un répertoire local au lieu d'Object Storage ?

R : Oui, vous pouvez utiliser l'option --destLocation pour indiquer un répertoire sur la machine virtuelle invitée où les journaux seront collectés. L'emplacement par défaut est /var/opt/oracle/dbaas_acfs.

Q : Que se passe-t-il si je ne spécifie pas de destination pour les journaux ?

R : si aucune destination n'est indiquée, les journaux collectés sont stockés à l'emplacement par défaut /var/opt/oracle/dbaas_acfs sur la machine virtuelle invitée.

Q : Que fait l'option --waitForCompletion ?

R : L'option --waitForCompletion indique s'il faut attendre la fin de la commande avant de renvoyer le contrôle à l'utilisateur. Valeur par défaut : true. Si vous indiquez false, l'opération est exécutée en arrière-plan.

Q : Comment puis-je exécuter la collection de journaux en arrière-plan ?

R : Définissez l'option --waitForCompletion sur false pour exécuter le processus de collecte de journaux en arrière-plan :

dbaascli diag collect --waitForCompletion false

Q : Puis-je reprendre une session de collecte de journaux précédente avec cette commande ?

R : Non, la commande dbaascli diag collect ne prend pas en charge la reprise des sessions précédentes. Vous devrez démarrer un nouveau processus de collecte de journaux.

Q : Comment puis-je m'assurer que les journaux sont téléchargés directement vers Object Storage ?

R : Vous pouvez indiquer une adresse --objectStoreBucketUri valide (URL de demande pré-authentifiée Object Storage) dans laquelle les journaux seront téléchargés après la collecte.

Q : Puis-je collecter des journaux pour plusieurs bases de données à la fois ?

R : Non. Vous ne pouvez indiquer qu'un seul nom de base de données à la fois à l'aide de l'option --dbNames.

Q : Que dois-je faire si je veux collecter tous les journaux disponibles pour tous les composants ?

R : utilisez --components pour collecter les journaux de tous les composants, y compris la base de données, Grid Infrastructure, le système d'exploitation et les outils DBaaS.

Q : Quel est un exemple de commande permettant de collecter des journaux pour le composant de base de données à partir d'une période spécifique ?

R : Voici un exemple de commande :

dbaascli diag collect --components db --startTime 2024-09-01T12:00:00 --endTime 2024-09-01T14:00:00 --dbname orcl

Q : Quel est un exemple de commande permettant de collecter des journaux et de les télécharger vers Object Storage ?

R : Voici un exemple de commande :

dbaascli diag collect --components db --objectStoreBucketUri https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL

Q : Quel est le comportement par défaut si l'option --components n'est pas spécifiée ?

R : Si vous ne spécifiez pas l'option --components, la commande risque de ne pas savoir quels journaux collecter et d'échouer. Il est recommandé de toujours spécifier les composants à partir desquels collecter les journaux.

Q : Puis-je spécifier à la fois les options --objectStoreBucketUri et --destLocation dans la même commande ?

R : Non. Vous devez choisir une destination, soit Object Storage via --objectStoreBucketUri, soit un répertoire local via --destLocation.

Q : Que dois-je faire en cas d'erreur lors de l'utilisation de la commande dbaascli diag collect ?

R : Vérifiez à nouveau que vous avez fourni des noms de composant, des formats de date/heure et des options de destination valides. Assurez-vous également que vous exécutez la commande en tant qu'utilisateur root.

dbaascli diag healthCheck

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli diag healthCheck ?

R : La commande dbaascli diag healthCheck est utilisée pour effectuer des vérifications de l'état de diagnostic sur une base de données Oracle Database exécutée dans un environnement Exadata Cloud@Customer.

Q : Quels sont les prérequis pour utiliser la commande dbaascli diag healthCheck ?

R : la commande doit être exécutée en tant qu'utilisateur root et vous devez être connecté à une machine virtuelle Exadata Cloud@Customer.

Q : Comment spécifier un répertoire personnalisé pour la collecte des journaux ?

R : utilisez l'option --destLocation pour indiquer le répertoire dans lequel les journaux de vérification de l'état seront collectés. L'emplacement par défaut est /var/opt/oracle/dbaas_acfs.

Q : Quel est l'emplacement par défaut pour la collecte de journaux si je ne spécifie pas --destLocation ?

R : Le répertoire par défaut pour la collecte de journaux est /var/opt/oracle/dbaas_acfs.

Q : Puis-je spécifier les noeuds sur lesquels exécuter la vérification de l'état ?

R : Oui. Vous pouvez utiliser l'option --nodes pour indiquer une liste de noeuds séparés par des virgules sur lesquels la vérification de l'état doit être exécutée.

Q : Comment télécharger les journaux de vérification de l'état vers Object Storage ?

R : utilisez l'option --objectStoreBucketURI pour fournir une URL de demande pré-authentifiée à partir du service Object Storage. Cette opération télécharge les journaux collectés vers le bucket indiqué.

Q : Puis-je collecter des journaux à partir de plusieurs nœuds ?

R : Oui. Vous pouvez indiquer plusieurs noeuds à l'aide de l'option --nodes dans un format délimité par des virgules. Par exemple : --nodes node1,node2.

Q : Quel est un exemple de commande permettant d'exécuter une vérification de l'état sur un noeud spécifique ?

R : Voici un exemple de commande permettant d'exécuter la vérification de l'état sur un noeud spécifique :

dbaascli diag healthCheck --nodes node1

Q : Comment stocker les journaux dans Object Storage plutôt que sur l'ordinateur local ?

R : vous pouvez fournir une URL de demande pré-authentifiée à l'aide de l'option --objectStoreBucketURI pour stocker les journaux dans Object Storage.

Q : Puis-je spécifier à la fois --destLocation et --objectStoreBucketURI ?

R : Oui. Vous pouvez indiquer --destLocation pour le stockage local et --objectStoreBucketURI pour télécharger des journaux vers Object Storage.

Q : Que dois-je faire en cas d'erreur lors de l'exécution de la commande dbaascli diag healthCheck ?

R : assurez-vous que vous exécutez la commande en tant qu'utilisateur root et que vous avez fourni des options valides pour --destLocation, --nodes ou --objectStoreBucketURI. Vérifiez que les noms de noeud sont corrects, le cas échéant.

Q : Puis-je exécuter la vérification de l'état en arrière-plan ?

R : La commande dbaascli diag healthCheck n'a pas de mode d'arrière-plan explicite, mais vous pouvez l'exécuter en arrière-plan en ajoutant & à la fin de la commande.

Q : Que se passe-t-il si je ne fournis pas l'option --nodes ?

R : Si l'option --nodes n'est pas fournie, la vérification de l'état sera effectuée sur tous les noeuds du cluster par défaut.

Q : Puis-je reprendre une session de vérification de l'état précédente à l'aide de cette commande ?

R : Non, la commande dbaascli diag healthCheck ne prend pas en charge la reprise des sessions précédentes. Vous devez lancer une nouvelle vérification de l'état à chaque fois.

Q : Quel est un exemple de commande permettant d'exécuter une vérification de l'état et de télécharger des journaux vers Object Storage ?

R : Voici un exemple de commande :

dbaascli diag healthCheck --objectStoreBucketURI https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL

Q : Quel est le comportement par défaut si je ne spécifie pas --destLocation ou --objectStoreBucketURI ?

R : si ni --destLocation ni --objectStoreBucketURI n'est indiqué, les journaux de vérification de l'état sont collectés dans le répertoire par défaut /var/opt/oracle/dbaas_acfs sur l'ordinateur local.

Q : Puis-je limiter la vérification de l'état à des composants ou des journaux spécifiques ?

R : Non. La commande dbaascli diag healthCheck ne vous permet pas d'indiquer des composants ou des journaux individuels. Il effectue un diagnostic général de l'état du système.

Q : Que dois-je vérifier avant d'exécuter la commande dbaascli diag healthCheck ?

R : assurez-vous que vous êtes connecté à une machine virtuelle Exadata Cloud@Customer et exécutez la commande en tant qu'utilisateur root.

Gestion de Grid Infrastructure

Cette section se concentre sur la gestion d'Oracle Grid Infrastructure, qui prend en charge le clustering et la haute disponibilité. Les tâches clés incluent la configuration d'un répertoire de base Grid Infrastructure (dbaascli gridHome create), la mise à niveau de Grid Infrastructure (dbaascli grid upgrade) et la gestion des certificats TCPS (Transport Layer Security) en configurant (dbaascli grid configureTCPS), en supprimant (dbaascli grid removeTCPSCert) ou en effectuant une rotation (dbaascli grid rotateTCPSCert). Ces commandes assurent une configuration, une maintenance et une sécurité efficaces de Grid Infrastructure.

dbaascli gridHome create

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli gridHome create ?

R : La commande dbaascli gridHome create permet de configurer un répertoire de base Grid Infrastructure pour Oracle Grid Infrastructure dans un environnement Exadata Cloud@Customer.

Q : Quel est le prérequis pour l'exécution de la commande dbaascli gridHome create ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Comment indiquer la version du répertoire de base Grid Infrastructure à créer ?

R : Utilisez l'option --version pour indiquer la version du répertoire de base Grid. Cette option est obligatoire lors de la création du répertoire de base Grid.

Q : Puis-je reprendre une session de création de dbaascli gridHome précédente ?

R : Oui, vous pouvez utiliser l'option --resume pour reprendre une session précédente. Vous pouvez éventuellement indiquer l'ID de session à l'aide de l'option --sessionID pour reprendre une session spécifique.

Q : Que fait l'option --resume dans la commande dbaascli gridHome create ?

R : L'option --resume vous permet de reprendre une opération interrompue ou incomplète.

Q : Comment exécuter l'opération en arrière-plan ?

R : Vous pouvez définir l'option --waitForCompletion sur False pour exécuter l'opération en arrière-plan. Les valeurs valides pour cette option sont true (par défaut) ou false.

Q : Quel est le comportement par défaut si --waitForCompletion n'est pas spécifié ?

R : Si --waitForCompletion n'est pas spécifié, l'opération est exécutée au premier plan et la commande attend la fin de l'opération avant de renvoyer le contrôle à l'utilisateur.

Q : Quel est le but de l'option --sessionID ?

R : L'option --sessionID permet de spécifier l'ID d'une session précédente que vous souhaitez reprendre, en cas d'opération incomplète ou interrompue.

Q : Puis-je utiliser la commande dbaascli gridHome create pour mettre à niveau un répertoire de base Grid existant ?

R : Non. Cette commande est utilisée spécifiquement pour configurer un nouveau répertoire de base Grid Infrastructure et non pour mettre à niveau un répertoire de base existant.

Q : Quel est un exemple de commande permettant de créer un répertoire de base Grid avec la version 19.9.0.0.0 ?

R : Voici un exemple de commande :

dbaascli gridHome create --version 19.9.0.0.0

Q : Que dois-je faire si la commande dbaascli gridHome create est interrompue ?

R : Vous pouvez reprendre l'opération à l'aide de l'option --resume. Si vous disposez de l'ID de session, vous pouvez le fournir à l'aide de l'option --sessionID pour reprendre une session spécifique.

Q : Puis-je spécifier l'option --resume sans ID de session ?

R : Oui, vous pouvez utiliser l'option --resume sans indiquer d'ID de session. Dans ce cas, le système tente de reprendre la session la plus récente.

Q : Que se passe-t-il si je spécifie --waitForCompletion false ?

R : Si vous indiquez --waitForCompletion false, l'opération est exécutée en arrière-plan, ce qui vous permet de continuer à utiliser la ligne de commande pendant la fin de l'opération.

Q : Est-il possible de suivre la progression d'une opération en arrière-plan ?

R : La commande dbaascli ne fournit pas de moyen direct de suivre les opérations en arrière-plan. Vous devrez peut-être vérifier manuellement les journaux système ou le statut de la session.

Q : Puis-je spécifier une version de répertoire de base Grid non valide lors de sa création ?

R : Non, l'option --version doit contenir une version de Grid Infrastructure valide. Si une version non valide est fournie, la commande renvoie une erreur.

Q : Comment déterminer la version de répertoire de base Grid à utiliser pour la création ?

R : Vous pouvez vous reporter à la documentation d'Oracle ou consulter l'administrateur de base de données pour déterminer la version de répertoire de base Grid appropriée à utiliser pour votre environnement.

Q : Que dois-je vérifier avant d'exécuter la commande dbaascli gridHome create ?

R : assurez-vous que vous êtes connecté en tant qu'utilisateur root et que la version à utiliser pour Grid Infrastructure est compatible avec votre environnement.

dbaascli grid configureTCPS

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

Prérequis

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

Syntaxe

Remarque

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

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

FAQ

Q : Quel est le but de la commande dbaascli grid configureTCPS ?

R : La commande dbaascli grid configureTCPS permet de configurer TCPS (Transport Layer Security) pour le cluster existant dans un environnement Oracle Exadata.

Q : Quel est le prérequis pour l'exécution de la commande dbaascli grid configureTCPS ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : TCPS est-il activé par défaut sur les systèmes Exadata Database Service on Dedicated Infrastructure ?

R : Oui. TCPS est activé par défaut pour les bases de données sur des systèmes Oracle Exadata Database Service on Dedicated Infrastructure.

Q : TCPS est-il activé par défaut sur les systèmes Exadata Database Service on Cloud@Customer ?

R : Non. TCPS n'est pas activé par défaut sur les systèmes Exadata Database Service on Cloud@Customer. Pour activer TCPS, vous devez mettre à jour le fichier sqlnet.ora pour la base de données spécifique et redémarrer la base de données.

Q : Quelle est la conséquence de l'activation de TCPS sur les systèmes Exadata Cloud@Customer ?

R : L'activation de TCPS sur les systèmes Exadata Cloud@Customer entraînera l'échec des connexions Zero Data Loss Recovery Appliance (ZDLRA). Vous pouvez uniquement activer la configuration ZDLRA ou TCPS, mais pas les deux simultanément.

Q : Que précise l'option --pkcs12WalletFilePath ?

R : l'option --pkcs12WalletFilePath indique le chemin absolu du fichier de certificat au format de portefeuille PKCS12, utilisé pour la configuration TCPS.

Q : A quoi sert l'option --caCertChain ?

R : L'option --caCertChain indique une liste concaténée de certificats contenant les certificats d'autorité de certification intermédiaire et le certificat d'autorité de certification racine.

Q : Que fait l'option --precheckOnly ?

R : L'option --precheckOnly indique s'il faut exécuter uniquement les prévérifications pour l'opération de configuration TCPS. Les valeurs acceptées sont yes ou no.

Q : Que précise l'option --serverCert ?

R : L'option --serverCert spécifie le chemin d'accès au certificat PEM qui sera utilisé ou fait l'objet d'une rotation pour la configuration TCPS.

Q : Comment spécifier la clé privée pour la configuration TCPS ?

R : Utilisez l'option --privateKey pour indiquer le chemin d'accès au fichier de clés privées associé au certificat de serveur.

Q : Quelles sont les valeurs acceptées pour l'option --certType ?

R : Les valeurs acceptées pour l'option --certType sont les suivantes :

SELF_SIGNED_CERT

CA_SIGNED_CERT

PKCS12_CERT

La valeur par défaut est SELF_SIGNED_CERT.

Q : Le mot de passe de la clé privée est-il protégé par défaut ?

R : Oui, l'option --privateKeyPasswordProtected est définie sur true par défaut, ce qui indique que la clé privée est protégée par mot de passe. Vous pouvez la définir sur false si la clé privée n'est pas protégée par mot de passe.

Q : Puis-je exécuter une prévérification avant de configurer TCPS ?

R : Oui, vous pouvez exécuter uniquement les prévérifications pour l'opération en définissant l'option --precheckOnly sur Oui. Cela permet de valider l'environnement avant d'apporter des modifications.

Q : Que se passe-t-il si je fournis un chemin incorrect pour le fichier de portefeuille PKCS12 ?

R : Si --pkcs12WalletFilePath contient un chemin incorrect, la commande échoue et la configuration TCPS ne se poursuit pas.

Q : Que dois-je faire si la clé privée est protégée par mot de passe ?

R : Si la clé privée est protégée par mot de passe, assurez-vous que l'option --privateKeyPasswordProtected est définie sur true (valeur par défaut).

Q : Puis-je spécifier mon propre certificat signé par une autorité de certification pour la configuration TCPS ?

R : Oui. Vous pouvez indiquer votre propre certificat signé par une autorité de certification à l'aide des options --serverCert et --privateKey, et en définissant --certType sur CA_SIGNED_CERT.

Q : Quel est un exemple de commande pour configurer TCPS à l'aide d'un certificat auto-signé ?

R : Voici un exemple :

dbaascli grid configureTCPS --serverCert /path/to/self_signed_cert.pem --privateKey /path/to/private_key.pem --certType SELF_SIGNED_CERT

Q : Puis-je utiliser un certificat PKCS12 pour la configuration TCPS ?

R : Oui. Vous pouvez utiliser un certificat PKCS12 en indiquant l'option --pkcs12WalletFilePath et en définissant --certType sur PKCS12_CERT.

Q : Que dois-je vérifier avant d'exécuter la commande dbaascli grid configureTCPS ?

R : Vérifiez que vous disposez des fichiers de certificat et de clé privée corrects et que vous êtes connecté en tant qu'utilisateur root. En outre, assurez-vous de comprendre les implications si vous utilisez ZDLRA car il ne peut pas fonctionner simultanément avec TCPS.

Exemple 7-27 dbaascli grid configureTCPS

Pour configurer une grille à l'aide d'un certificat auto-signé, exécutez la commande suivante :
dbaascli grid configureTCPS
Pour configurer une grille à l'aide d'un certificat signé par une autorité de certification, exécutez la commande suivante :
dbaascli grid configureTCPS --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --private_key_password_protected false
dbaascli grid removeTCPSCert

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli grid removeTCPSCert ?

R : La commande dbaascli grid removeTCPSCert permet d'enlever les certificats TCPS existants du portefeuille Grid Infrastructure dans un environnement Oracle Exadata.

Q : Quel est le prérequis pour l'exécution de la commande dbaascli grid removeTCPSCert ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Que spécifie l'option --subject dans la commande dbaascli grid removeTCPSCert ?

R : L'option --subject indique l'objet du certificat à enlever du portefeuille Grid Infrastructure.

Q : Quel est le but de l'indicateur --userCert ?

R : L'indicateur --userCert indique que le certificat à enlever est un certificat utilisateur.

Q : Quand dois-je utiliser l'indicateur --trustedCert ?

R : utilisez l'indicateur --trustedCert lors de la suppression d'un certificat sécurisé du portefeuille Grid Infrastructure.

Q : Que fait l'indicateur --requestedCert ?

R : L'indicateur --requestedCert indique que le certificat en cours de suppression est un certificat demandé.

Q : Que précise l'option --serialNumber ?

R : L'option --serialNumber indique le numéro de série du certificat à supprimer. Il est utile pour identifier de manière unique un certificat lorsqu'il existe plusieurs certificats ayant le même sujet.

Q : Quel est le but de l'option --executePrereqs ?

R : L'option --executePrereqs exécute des vérifications de prérequis avant d'enlever le certificat et signale les résultats, en veillant à ce que l'environnement soit correctement préparé pour l'opération.

Q : Que fait l'option --resume ?

R : L'option --resume reprend l'opération de suppression si elle a été interrompue précédemment.

Q : Comment spécifier un ID de session lors de la reprise d'une opération interrompue ?

R : Utilisez l'option --sessionID pour indiquer l'ID de session de l'opération interrompue à reprendre.

Q : Que fait l'indicateur --bounceListeners ?

R : L'indicateur --bounceListeners est utilisé pour redémarrer le processus d'écoute Grid Infrastructure et analyser le processus d'écoute après la suppression du certificat TCPS.

Q : Puis-je supprimer un certificat TCPS sans rebondir les auditeurs ?

R : Oui, l'indicateur --bounceListeners est facultatif. Si vous ne l'indiquez pas, les processus d'écoute ne seront pas automatiquement redémarrés.

Q : Comment puis-je m'assurer que l'opération fonctionnera en toute sécurité ?

R : Vous pouvez utiliser l'option --executePrereqs pour effectuer des vérifications de prérequis avant d'exécuter la commande, en vous assurant que tout est en ordre avant le processus de suppression.

Q : Que dois-je faire si je dois supprimer un certificat utilisateur spécifique par numéro de série ?

R : utilisez l'option --subject pour indiquer l'objet du certificat, l'indicateur --userCert pour indiquer qu'il s'agit d'un certificat utilisateur et l'option --serialNumber pour indiquer le numéro de série du certificat.

Q : Puis-je supprimer plusieurs certificats à la fois ?

R : Non, la commande est conçue pour supprimer un seul certificat à la fois en fonction du sujet fourni et d'autres paramètres.

Q : Que se passe-t-il si le processus de suppression du certificat est interrompu ?

R : Vous pouvez reprendre l'opération à l'aide de l'option --resume et de l'option --sessionID du processus interrompu.

Q : Dois-je exécuter la commande en tant qu'utilisateur root ?

R : Oui, la commande dbaascli grid removeTCPSCert doit être exécutée en tant qu'utilisateur root pour disposer des privilèges nécessaires à la suppression des certificats TCPS.

Q : Comment puis-je identifier le certificat que je veux supprimer ?

R : Vous pouvez identifier le certificat par son sujet, et éventuellement par son numéro de série pour vous assurer que vous ciblez le certificat correct pour suppression.

Q : Quel est un exemple de commande permettant de supprimer un certificat sécurisé ?

R : Voici un exemple :

dbaascli grid removeTCPSCert --subject "CN=example_cert" --trustedCert

dbaascli grid rotateTCPSCert

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli grid rotateTCPSCert ?

R : La commande dbaascli grid rotateTCPSCert est utilisée pour effectuer la rotation des certificats TCPS (protocole Transport Layer Security) dans le portefeuille Grid Infrastructure dans les environnements Oracle Exadata.

Q : Quel est le prérequis pour l'exécution de la commande dbaascli grid rotateTCPSCert ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Que précise l'option --pkcs12WalletFilePath ?

R : l'option --pkcs12WalletFilePath indique le chemin absolu du fichier de certificat au format de portefeuille PKCS12 pour la configuration TCPS.

Q : Quel est le but de l'option --caCertChain ?

R : L'option --caCertChain spécifie une liste concaténée de certificats, y compris les certificats d'autorité de certification intermédiaire et racine, pour la configuration TCPS.

Q : Que fait l'option --precheckOnly ?

R : L'option --precheckOnly vous permet d'exécuter des prévérifications sans apporter de modifications réelles. Les valeurs valides sont "yes" pour exécuter uniquement les prévérifications et "no" pour poursuivre la rotation.

Q : Comment l'option --serverCert est-elle utilisée ?

R : L'option --serverCert spécifie le chemin d'accès au certificat de serveur PEM (Privacy Enhanced Mail) utilisé ou faisant l'objet d'une rotation pour la configuration TCPS.

Q : Que précise l'option --privateKey ?

R : L'option --privateKey indique le chemin d'accès au fichier de clés privées correspondant au certificat de serveur utilisé pour la rotation TCPS.

Q : Quelles sont les valeurs valides pour l'option --certType ?

R : L'option --certType accepte les valeurs suivantes pour indiquer le type de certificat à ajouter au portefeuille Grid Infrastructure :

SELF_SIGNED_CERT (valeur par défaut)

CA_SIGNED_CERT

PKCS12_CERT

Q : Que fait l'option --privateKeyPasswordProtected ?

R : L'option --privateKeyPasswordProtected indique si la clé privée est protégée par mot de passe. Valeurs valides : true (par défaut) ou false

Q : Puis-je exécuter la commande dbaascli grid rotateTCPSCert sans effectuer de rotation des certificats ?

R : Oui, à l'aide de l'option --precheckOnly yes, vous pouvez exécuter uniquement les prévérifications sans effectuer de rotation des certificats.

Q : Quel est l'exemple d'une commande permettant de faire pivoter un certificat à l'aide d'un portefeuille PKCS12 ?

R : Voici un exemple de commande :

dbaascli grid rotateTCPSCert --pkcs12WalletFilePath /path/to/wallet.p12 --certType PKCS12_CERT

Q : Comment faire pivoter un certificat de serveur avec une chaîne de certificats signée par une autorité de certification ?

R : Utilisez les options --serverCert et --caCertChain comme indiqué ci-dessous :

dbaascli grid rotateTCPSCert --serverCert /path/to/serverCert.pem --caCertChain /path/to/caChain.pem

Q : Que se passe-t-il si je ne spécifie pas --privateKeyPasswordProtected ?

R : Si vous n'indiquez pas l'option --privateKeyPasswordProtected, la commande suppose que la clé privée est protégée par mot de passe (par défaut : true).

Q : Puis-je faire pivoter un certificat auto-signé ?

R : Oui. Vous pouvez effectuer la rotation d'un certificat autosigné à l'aide de l'option --certType SELF_SIGNED_CERT par défaut ou en le spécifiant explicitement.

Q : Comment effectuer la rotation d'un certificat sans fournir de clé privée ?

R : Pour certains types de certificat, comme PKCS12, vous n'avez peut-être pas besoin de fournir un fichier de clé privée distinct, car il est inclus dans le portefeuille. Toutefois, si une clé privée est requise, elle doit être fournie à l'aide de l'option --privateKey.

Q : Que faire si je veux faire pivoter un certificat en arrière-plan ?

R : La commande dbaascli grid rotateTCPSCert ne fournit pas d'option explicite pour l'exécution en arrière-plan. Vous pouvez exécuter la commande directement dans une session en arrière-plan (par exemple, à l'aide de nohup ou d'outils similaires).

Q : Quel est le type de certificat par défaut s'il n'est pas spécifié ?

R : Le type de certificat par défaut est SELF_SIGNED_CERT.

Exemple 7-28 dbaascli grid rotateTCPSCert

Pour effectuer la rotation d'un certificat auto-signé (option par défaut), exécutez la commande suivante :
dbaascli grid rotateTCPSCert
Pour effectuer la rotation d'un certificat signé par une autorité de certification, exécutez la commande suivante :
dbaascli grid rotateTCPSCert --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --privateKeyPasswordProtected true
dbaascli grid upgrade

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli grid upgrade ?

R : La commande dbaascli grid upgrade permet de mettre à niveau Oracle Grid Infrastructure d'une version majeure vers une autre sur une machine virtuelle Exadata Cloud@Customer.

Q : Quelle est la condition préalable à l'exécution de la commande dbaascli grid upgrade ?

R : la commande doit être exécutée en tant qu'utilisateur root et vous devez être connecté à une machine virtuelle Exadata Cloud@Customer.

Q : Que précise l'option --version ?

R : L'option --version indique la version cible d'Oracle Grid Infrastructure vers laquelle effectuer la mise à niveau.

Q : Que fait l'option --resume ?

R : L'option --resume reprend un processus de mise à niveau de Grid Infrastructure interrompu ou ayant échoué.

Q : Comment l'option --executePrereqs est-elle utilisée ?

R : L'option --executePrereqs exécute uniquement les vérifications de prérequis pour la mise à niveau de Grid Infrastructure sans effectuer la mise à niveau réelle.

Q : Quel est le but de l'option --containerURL ?

R : L'option --containerURL indique une URL personnalisée pour extraire l'image logicielle Grid Infrastructure pour la mise à niveau.

Q : Que fait l'option --softwareOnly ?

R : L'option --softwareOnly installe uniquement le logiciel Grid Infrastructure sans configurer ni mettre à niveau l'environnement Grid.

Q : Quand utiliseriez-vous l'option --targetHome ?

R : L'option --targetHome indique le chemin du répertoire de base Grid cible existant où la mise à niveau sera effectuée.

Q : Que se passe-t-il si la mise à niveau échoue ?

R : Si la mise à niveau échoue, vous pouvez utiliser l'option --revert pour restaurer l'état précédent de la mise à niveau.

Q : Puis-je effectuer une mise à niveau de Grid Infrastructure par étapes ?

R : Oui, à l'aide de l'option --softwareOnly, vous pouvez d'abord installer le logiciel, puis terminer la mise à niveau complète, ce qui permet des mises à niveau intermédiaires.

Q : Comment utiliser la commande dbaascli grid upgrade pour mettre à niveau uniquement le logiciel ?

R : Utilisez la syntaxe suivante pour mettre à niveau uniquement le logiciel :

dbaascli grid upgrade --version <target_version> --softwareOnly

Q : Puis-je vérifier les prérequis de mise à niveau sans effectuer la mise à niveau ?

R : Oui, vous pouvez uniquement exécuter les vérifications de prérequis à l'aide des éléments suivants :

dbaascli grid upgrade --version <target_version> --executePrereqs

Q : Comment mettre à niveau Grid Infrastructure à l'aide d'une URL de conteneur personnalisée ?

R : Vous pouvez indiquer l'URL d'extraction de l'image Grid Infrastructure comme suit :

dbaascli grid upgrade --version <target_version> --containerURL <custom_url>

Q : Comment puis-je reprendre un processus de mise à niveau précédemment interrompu ?

R : Pour reprendre une mise à niveau précédemment interrompue ou ayant échoué, utilisez :

dbaascli grid upgrade --version <target_version> --resume

Q : Que fait l'option --revert dans la commande dbaascli grid upgrade ?

R : L'option --revert annule l'état d'origine d'une mise à niveau de Grid Infrastructure ayant échoué ou interrompue.

Q : Puis-je effectuer une mise à niveau complète sans configurer Grid Infrastructure immédiatement ?

R : Oui, vous pouvez d'abord installer uniquement le logiciel à l'aide de l'option --softwareOnly, puis le configurer ultérieurement.

Q : Que dois-je faire si une mise à niveau échoue et que je veux annuler les modifications ?

R : Utilisez l'option --revert pour annuler la mise à niveau ayant échoué :

dbaascli grid upgrade --version <target_version> --revert

Exemple 7-29 dbaascli grid upgrade

daascli grid upgrade --version 19.11.0.0.0 --executePrereqs
DBAAS CLI version MAIN
Executing command grid upgrade --version 19.11.0.0.0 --executePrereqs

Application de patches et mise à niveau

Cette section fournit des outils de mise à jour et de maintenance des environnements Oracle via l'application de patches et de mises à niveau. Elle inclut des commandes telles que dbaascli grid patch pour appliquer des patches à Oracle Grid Infrastructure, dbaascli dbHome patch pour appliquer des patches à des répertoires de base Oracle et dbaascli database move pour déplacer des bases de données entre les répertoires de base lors des mises à niveau ou des processus d'application de patches. Ces commandes permettent de garantir la sécurité, la stabilité et la mise à jour des systèmes.

dbaascli grid patch

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

Prérequis

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

Syntaxe

dbaascli grid patch
 {
            --targetVersion <value>
            | --targetHome <value>
        }
        [--executePrereqs] [--nodeList <value>] [--continueWithDbDowntime] [--drainTimeoutInSeconds <value>] [--containerURL <value>] [--imageFile <value>] [--patchInParallel]
        {
            [--resume [--sessionID <value>]]
            | [--rollback [--sessionID <value>]]
        }
        [--waitForCompletion <value>]

Où :

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

FAQ

Q : Que fait la commande dbaascli grid patch ?

R : La commande dbaascli grid patch est utilisée pour appliquer les patches d'une version mineure indiquée à Oracle Grid Infrastructure.

Q : Ai-je besoin de droits d'accès spéciaux pour exécuter la commande dbaascli grid patch ?

R : Oui. Vous devez exécuter la commande dbaascli grid patch en tant qu'utilisateur root.

Q : Puis-je indiquer une version cible lors de l'application de patches à Oracle Grid Infrastructure ?

R : Oui. Vous pouvez indiquer la version cible à l'aide de l'option --targetVersion.

Q : Comment spécifier la version cible du patch ?

R : utilisez l'option --targetVersion suivie du numéro de version au format 19.12.0.0.0.

Q : Que fait l'option --containerURL dans la commande dbaascli grid patch ?

R : L'option --containerURL vous permet d'indiquer une URL personnalisée pour l'extraction de l'image Grid Infrastructure.

Q : Quel est le but de l'option --executePrereqs ?

R : L'option --executePrereqs est utilisée pour exécuter les vérifications de prérequis avant d'appliquer le patch.

Q : Comment appliquer des patches à un sous-ensemble de noeuds à l'aide de la commande dbaascli grid patch ?

R : utilisez l'option --nodeList suivie d'une liste de noms de noeud séparés par des virgules pour appliquer des patches uniquement à un sous-ensemble de noeuds.

Q : Que se passe-t-il si j'utilise l'option --rollback ?

R : L'option --rollback annule l'état précédent du répertoire de base Oracle auquel des patches ont été appliqués.

Q : Puis-je reprendre une session d'application de patches précédente ?

R : Oui. Vous pouvez utiliser l'option --resume pour reprendre la dernière session d'application de patches. Si vous disposez d'un ID de session spécifique, vous pouvez le spécifier avec l'option --sessionID.

Q : A quoi sert l'option --continueWithDbDowntime ?

R : L'option --continueWithDbDowntime vous permet de poursuivre l'application de patches même en cas de temps d'inactivité de la base de données, généralement utilisé dans les environnements où il n'y a qu'une seule instance active.

Q : Comment créer une image à partir d'un répertoire de base Grid auquel des patches ont été appliqués ?

R : Utilisez l'option --createImage pour créer une image. Vous pouvez indiquer le répertoire dans lequel l'image doit être créée à l'aide de l'option --createImageDir.

Q : Quel est le but de l'option --imageFile ?

R : L'option --imageFile vous permet de spécifier le chemin qualifié complet du fichier image à utiliser pour l'application de patches.

Q : Comment exécuter la commande dbaascli grid patch en arrière-plan ?

R : Vous pouvez utiliser l'option --waitForCompletion définie sur false pour exécuter l'opération en arrière-plan.

Q : Puis-je utiliser une URL personnalisée pour extraire l'image du patch ?

R : Oui. Vous pouvez utiliser l'option --containerURL pour indiquer une URL personnalisée pour l'extraction de l'image Grid Infrastructure.

Q : Comment spécifier les noeuds à appliquer si je ne veux pas appliquer de patches à tous ?

R : Vous pouvez indiquer les noeuds à appliquer à l'aide de l'option --nodeList avec une liste de noms de noeud séparés par des virgules.

Q : Que dois-je faire si je dois annuler un patch ?

R : utilisez l'option --rollback dans la commande dbaascli grid patch pour annuler le patch.

Q : Comment gérer une opération d'application de patches si mon environnement ne dispose que d'une seule instance active et que je dois continuer avec un temps d'inactivité ?

R : Utilisez l'option --continueWithDbDowntime pour poursuivre l'application de patches même en cas de temps d'inactivité de la base de données.

Q : Puis-je créer une image du répertoire de base Grid auquel des patches ont été appliqués ?

R : Oui. Vous pouvez utiliser l'option --createImage pour créer une image du répertoire de base Grid auquel des patches ont été appliqués. Si nécessaire, indiquez le répertoire dans lequel l'image doit être enregistrée à l'aide de --createImageDir.

Q : Que dois-je faire si je veux reprendre une session d'application de patches après une interruption ?

R : utilisez l'option --resume pour reprendre la session d'application de patches. Si vous connaissez l'ID de session, vous pouvez le spécifier avec --sessionID.

Q : Que se passe-t-il si le processus d'application de patches échoue à mi-parcours ?

R : Si le processus d'application de patches échoue, vous pouvez utiliser l'option --resume pour redémarrer le processus. Vous pouvez également utiliser l'option --rollback pour revenir à l'état précédent.

Q : Comment puis-je m'assurer que tous les prérequis sont respectés avant l'application de patches ?

R : Utilisez l'option --executePrereqs pour exécuter toutes les vérifications de prérequis avant d'appliquer le patch.

Q : Puis-je appliquer des patches en arrière-plan pour éviter de bloquer le terminal ?

R : Oui. Vous pouvez utiliser l'option --waitForCompletion false pour exécuter le processus d'application de patches en arrière-plan.

Q : Comment créer une image de répertoire de base Grid après l'application de patches ?

R : Utilisez l'option --createImage pour créer une image à partir du répertoire de base Grid auquel des patches ont été appliqués. Indiquez le répertoire à l'aide de --createImageDir si nécessaire.

Q : Comment utiliser un fichier image existant pour l'application de patches ?

R : Vous pouvez utiliser l'option --imageFile pour indiquer le chemin qualifié complet du fichier image à utiliser pour l'application de patches.

Q : Que dois-je faire si je veux éviter les temps d'arrêt de la base de données lors de l'application de patches ?

R : Assurez-vous que votre environnement comporte plusieurs instances actives en cours d'exécution. Vous pouvez éviter d'utiliser l'option --continueWithDbDowntime, qui est destinée aux environnements avec une seule instance active.

Q : Comment puis-je connaître la progression d'un patch exécuté en arrière-plan ?

R : Si vous exécutez le patch avec --waitForCompletion false, vous pouvez vérifier le statut du travail en arrière-plan à l'aide de commandes du système d'exploitation telles que ps ou vérifier les journaux situés dans le répertoire de base Grid.

Q : Est-il possible d'appliquer un patch à une version majeure supérieure à l'aide de dbaascli grid patch ?

R : Non. dbaascli grid patch autorise uniquement l'application de patches à une version mineure de la version majeure en cours. Pour les mises à niveau majeures, vous devrez suivre un processus de mise à niveau différent.

Q : Puis-je ignorer des vérifications de prérequis spécifiques lors de l'application de patches ?

R : Non. Lorsque vous utilisez --executePrereqs, toutes les vérifications de prérequis sont exécutées. Toutefois, vous pouvez consulter les résultats des vérifications de prérequis et gérer manuellement les problèmes avant de continuer.

Q : Que dois-je faire si le processus d'application de patches est bloqué ou suspendu ?

R : Si le processus d'application de patches ne répond pas, vous pouvez l'arrêter à l'aide de commandes du système d'exploitation, puis le reprendre à l'aide de l'option --resume. Si cela ne fonctionne pas, essayez d'utiliser l'option --rollback pour rétablir le patch.

Q : Puis-je automatiser le processus d'application de patches sur plusieurs clusters ?

R : Oui. Si vous utilisez des scripts qui incluent la commande dbaascli grid patch avec les options appropriées, vous pouvez automatiser l'application de patches sur différents clusters.

Q : Où puis-je trouver les journaux pour le processus d'application de patches ?

R : Les journaux se trouvent généralement dans le répertoire de base des journaux Oracle Grid ou à l'emplacement par défaut indiqué lors de la configuration. Vous pouvez surveiller ces journaux pour obtenir des détails sur le processus d'application de patches.

Q : Est-il possible de créer un processus de patch silencieux sans interaction utilisateur ?

R : Oui. En spécifiant toutes les options nécessaires dans la commande et en l'exécutant en arrière-plan (--waitForCompletion false), vous pouvez créer un processus d'application de patches non interactif.

Q : Puis-je vérifier les mises à jour de patch disponibles avant d'appliquer un patch ?

R : La commande dbaascli grid patch elle-même n'a pas la possibilité de répertorier les patches disponibles. Toutefois, vous pouvez utiliser les méthodes standard d'Oracle, telles que le support technique Oracle, pour identifier les derniers patches.

Q : Puis-je utiliser dbaascli pour appliquer des patches à plusieurs répertoires de base Oracle ?

R : Non. La commande dbaascli grid patch est conçue pour appliquer des patches à un répertoire de base Oracle Grid Infrastructure spécifique à la fois. Vous devez exécuter la commande séparément pour chaque répertoire de base.

Q : Existe-t-il un moyen d'éviter complètement les temps d'arrêt lors de l'application de patches à Grid Infrastructure ?

R : Pour réduire les temps d'inactivité, assurez-vous que votre environnement dispose de plusieurs instances de base de données actives (configuration RAC) afin que l'application de patches puisse être effectuée noeud par noeud. L'option --continueWithDbDowntime ne doit pas être utilisée dans ce cas.

Q : Comment gérer l'application de patches aux environnements RAC One Node ?

R : Dans les environnements RAC One Node, vous devez faire preuve de prudence avec l'option --continueWithDbDowntime, car il ne peut y avoir qu'une seule instance active. Consultez la documentation Oracle pour connaître les instructions d'application de patches spécifiques à RAC One Node.

Q : Puis-je consulter l'historique des sessions des patches précédents ?

R : L'utilitaire dbaascli ne fournit pas de moyen direct d'afficher l'historique des sessions. Toutefois, les journaux des sessions d'application de patches précédentes se trouvent dans le répertoire de base des journaux Grid.

Exemples de cas d'emploi

Exemple 1 : Application de patches de base à une grille

dbaascli grid patch --targetVersion 19.12.0.0.0

Applique des patches à Oracle Grid Infrastructure vers la version 19.12.0.0.0.

Exemple 2 : application de patches avec une URL de conteneur personnalisée

dbaascli grid patch --targetVersion 19.12.0.0.0 --containerURL https://example.com/custom/url

Applique des patches à Grid Infrastructure vers la version 19.12.0.0.0, à l'aide d'une URL de conteneur personnalisée pour extraire l'image Grid Infrastructure.

Exemple 3 : application de patches avec des vérifications de prérequis

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs

Applique des patches à Grid Infrastructure vers la version 19.12.0.0.0 après l'exécution des vérifications de prérequis.

Exemple 4 : application de patches à un sous-ensemble de noeuds

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2,node3

Applique des patches à Grid Infrastructure vers la version 19.12.0.0.0 sur les noeuds indiqués (node1, node2 et node3).

Exemple 5 : annulation du patch

dbaascli grid patch --rollback

Annule (rollback) le dernier patch appliqué sur Oracle Grid Infrastructure.

Exemple 6 : reprise d'une opération de patch précédente

dbaascli grid patch --resume

Reprend l'opération d'application de patches précédente à partir de laquelle elle a été arrêtée.

Exemple 7 : reprise d'une opération de patch avec un ID de session spécifique

dbaascli grid patch --resume --sessionID 12345

Reprend l'opération d'application de patches à l'aide de l'ID de session 12345.

Exemple 8 : application de patches avec temps d'inactivité de base de données autorisé

dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime

Applique des patches à Grid Infrastructure vers la version 19.12.0.0.0 tout en autorisant le temps d'inactivité de la base de données, si nécessaire.

Exemple 9 : création d'une image patchée

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir

Crée une image du répertoire de base Grid auquel des patches ont été appliqués (version 19.12.0.0.0) et la stocke dans le répertoire indiqué.

Exemple 10 : utilisation d'un fichier image existant

dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /path/to/image/file.zip

Applique des patches à Grid Infrastructure vers la version 19.12.0.0.0 à l'aide d'un fichier image existant situé dans /path/to/image/file.zip.

Exemple 11 : exécution de l'opération d'application de patches en arrière-plan

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false

Applique des patches à Grid Infrastructure vers la version 19.12.0.0.0 et exécute l'opération en arrière-plan.

Exemple 12 : combinaison de prérequis, d'URL personnalisée et de sous-ensemble de noeuds

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --containerURL https://example.com/custom/url --nodeList node1,node2

Applique des patches à Grid Infrastructure vers la version 19.12.0.0.0, exécute des vérifications de prérequis, utilise une URL personnalisée pour l'image et applique le patch uniquement sur node1 et node2.

Exemple 13 : Création d'une image corrigée avec un fichier image existant

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir --imageFile /path/to/existing/image.zip

Crée une image corrigée et la stocke dans le répertoire indiqué tout en utilisant un fichier image existant pour le patch.

Exemple 14 : vérification des prérequis sans application de patches

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs

Vérifie si tous les prérequis sont respectés pour l'application de patches à la version 19.12.0.0.0 sans appliquer réellement le patch.

Exemple 15 : exécution de patches et ignorage des échecs de prérequis

dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime --executePrereqs

Exécute le patch même en cas d'échec de certaines vérifications de prérequis. Cela est utile dans les scénarios où le temps d'arrêt est autorisé et où certains prérequis peuvent être ignorés.

Exemple 16 : vérification des problèmes dans les journaux de patches

tail -f /u01/app/grid/logs/grid_patch.log

Surveille le journal des patches en temps réel pour diagnostiquer tout problème au cours du processus d'application de patches.

Exemple 17 : application du patch dans un environnement parallèle

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2 --waitForCompletion false

Applique des patches à Grid Infrastructure sur un sous-ensemble de noeuds (node1 et node2) et exécute le processus en arrière-plan.

Exemple 18 : utilisation d'un fichier image spécifique à partir d'une source externe

dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /mnt/images/grid_patch_19.12.zip

Applique des patches à Grid Infrastructure à l'aide d'un fichier image pré-téléchargé situé sur un périphérique de stockage externe.

Exemple 19 : exécution d'un patch avec un ID de session personnalisé

dbaascli grid patch --targetVersion 19.12.0.0.0 --resume --sessionID 67890

Reprend une opération d'application de patches interrompue à l'aide de l'ID de session 67890.

Exemple 20 : Programmation de l'exécution ultérieure de l'application de patches

echo "dbaascli grid patch --targetVersion 19.12.0.0.0" | at 02:00

Planifie l'exécution de la commande d'application de patches à 2 h 00 à l'aide de la commande at sous Linux.

Exemple 21 : spécification du délai d'expiration pour l'achèvement

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion true --continueWithDbDowntime --timeout 7200

Applique des patches à Grid Infrastructure tout en autorisant le temps d'inactivité, mais attend jusqu'à 7200 secondes (2 heures) avant d'expirer.

Exemple 22 : création d'une image personnalisée pour un autre environnement

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /backups/images/grid_patch

Crée une image personnalisée de Grid Infrastructure avec patches à stocker dans le répertoire /backups/images/grid_patch pour une utilisation dans d'autres environnements.

Exemple 23 : récupération de patch après interruption

dbaascli grid patch --resume --continueWithDbDowntime

Récupère et reprend le processus d'application de patches s'il a été interrompu, avec un temps d'inactivité de base de données autorisé.

Exemple 24 : combinaison de la vérification des prérequis et de l'exécution en arrière-plan

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --waitForCompletion false

Vérifie les prérequis et exécute le patch en arrière-plan.

Exemple 25 : ignorer la création d'images pour une application plus rapide des patches

dbaascli grid patch --targetVersion 19.12.0.0.0 --patchInParallel --continueWithDbDowntime --waitForCompletion false

Applique des patches à Grid Infrastructure vers la version 19.12.0.0.0 en parallèle entre les noeuds, avec un temps d'inactivité de base de données autorisé et sans créer d'image pour accélérer le processus.

Exemple 26 : Surveillance de la progression des patches via les journaux

tail -f /u01/app/grid/logs/grid_patch_progress.log

Surveille la progression de l'application de patches dans le fichier journal en temps réel, ce qui fournit des informations sur chaque étape du processus d'application de patches.

Exemple 27 : application de patches avec un délai d'expiration de purge personnalisé

dbaascli grid patch --targetVersion 19.12.0.0.0 --drainTimeoutInSeconds 3600 --continueWithDbDowntime

Applique des patches à Grid Infrastructure et définit un délai d'expiration personnalisé de 1 heure (3600 secondes) pour permettre la purge progressive des ressources pendant le temps d'inactivité de la base de données.

Exemple 28 : application d'un patch à des noeuds spécifiques à l'aide de vérifications de prérequis

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node4 --executePrereqs

Applique des patches uniquement aux noeuds node1 et node4 vers la version 19.12.0.0.0 et exécute au préalable les vérifications de prérequis.

Exemple 29 : application de patches sans attente d'achèvement

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false

Lance l'application de patches à Grid Infrastructure vers la version 19.12.0.0.0 en arrière-plan, ce qui permet d'effectuer d'autres tâches sans attendre la fin du processus.

Exemple 30 : réapplication d'un patch ayant échoué après un délai d'expiration de purge

dbaascli grid patch --resume --drainTimeoutInSeconds 7200

Reprend la session d'application de patches précédente et étend le délai d'expiration de purge des ressources à 2 heures (7200 secondes) en cas d'échec en raison d'un temps insuffisant lors de la tentative précédente.

Exemple 31 : affichage des journaux de patches en temps réel avec un ID de session spécifique

tail -f /u01/app/grid/logs/grid_patch_12345.log

Surveille le fichier journal de la session d'application de patches avec l'ID de session 12345 en temps réel.

Exemple 32 : application de patches à un nouveau répertoire de base cible

dbaascli grid patch --targetHome /u01/app/grid_home_19c --executePrereqs

Effectue un patch "out-of-place" vers un nouveau répertoire de base Oracle Grid situé dans /u01/app/grid_home_19c, avec des vérifications de prérequis.

Exemple 33 : arrêt d'un travail de patch en arrière-plan

ps -ef | grep dbaascli | grep patch | awk '{print $2}' | xargs kill -9

Arrête une tâche de patch en arrière-plan en recherchant et en fermant l'ID de processus (PID) associé.

Exemple 34 : vérification de l'exécution des patches sans journaux

dbaascli grid status --targetVersion 19.12.0.0.0

Vérifie si le patch de la version 19.12.0.0.0 a été appliqué en vérifiant le statut de la version en cours de Grid Infrastructure.

dbaascli dbHome patch

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

Prérequis

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

Syntaxe

dbaascli dbHome patch

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

FAQ

Q : A quoi sert la commande de patch dbaascli dbHome ?

R : La commande dbaascli dbHome patch permet d'appliquer des patches à un répertoire de base Oracle d'un niveau de patch vers un autre.

Q : Ai-je besoin de droits d'accès spéciaux pour exécuter la commande de patch dbaascli dbHome ?

R : Oui, vous devez exécuter la commande en tant qu'utilisateur root.

Q : Comment indiquer le chemin ou le nom du répertoire de base Oracle pour le patch ?

R : utilisez l'option --oracleHome pour indiquer le chemin du répertoire de base Oracle ou --oracleHomeName pour indiquer le nom du répertoire de base Oracle.

Q : Comment définir la version cible du patch ?

R : utilisez l'option --targetVersion suivie du numéro de version au format 19.12.0.0.0.

Q : Que fait l'option --resume ?

R : L'option --resume vous permet de reprendre une session d'application de patches précédente.

Q : Comment spécifier un ID de session particulier lors de la reprise d'un patch ?

R : Utilisez l'option --sessionID pour indiquer l'ID de session de la session d'application de patches à reprendre.

Q : A quoi sert l'option --continueWithDbDowntime ?

R : L'option --continueWithDbDowntime permet de poursuivre l'application de patches même en cas de temps d'inactivité de la base de données, ce qui est utile dans les environnements avec une seule instance active.

Q : Comment puis-je ignorer l'application de patches sur des noeuds inaccessibles ?

R : Utilisez l'option --skipUnreachableNodes pour ignorer les opérations sur les noeuds inaccessibles.

Q : Comment appliquer des patches uniquement à des noeuds spécifiques d'un cluster ?

R : utilisez l'option --nodes suivie d'une liste de noms de noeud séparés par des virgules pour appliquer des patches à un sous-ensemble de noeuds.

Q : A quoi sert l'option --executePrereqs ?

R : L'option --executePrereqs exécute les vérifications de prérequis avant d'appliquer le patch.

Q : Comment ignorer l'exécution de datapatch sur les bases de données ?

R : Utilisez l'option --skipDatapatch pour ignorer le processus datapatch lors de l'application de patches.

Q : Puis-je indiquer un emplacement personnalisé pour l'image de base de données ?

R : Oui, utilisez l'option --imageLocation pour indiquer un emplacement personnalisé pour l'image de base de données.

Q : Que fait l'option --skipPDBs ?

R : L'option --skipPDBs vous permet d'ignorer l'exécution de datapatch sur une liste de bases de données pluggables (PDB) délimitée par des virgules indiquée.

Q : Comment ignorer datapatch sur des bases pluggables fermées ?

R : Utilisez l'option --skipClosedPDBs pour ignorer le patch de données sur les bases de données pluggables fermées.

Q : Que se passe-t-il si j'utilise l'option --rollback ?

R : L'option --rollback rétablit l'état précédent du répertoire de base Oracle avant l'application du patch.

Q : Comment indiquer le chemin du répertoire de base Oracle pour l'application de patches ?

R : utilisez l'option --oracleHome suivie du chemin d'accès au répertoire de base Oracle.

Q : Comment puis-je appliquer des patches à un répertoire de base Oracle par son nom plutôt que par le chemin ?

R : utilisez l'option --oracleHomeName suivie du nom du répertoire de base Oracle.

Q : Comment puis-je reprendre une opération d'application de patches si elle a été interrompue ?

R : Utilisez l'option --resume avec l'option --sessionID pour reprendre une session interrompue spécifique.

Q : Puis-je poursuivre le processus d'application de patches si la base de données est arrêtée ?

R : Oui, utilisez l'option --continueWithDbDowntime pour continuer l'application de patches même si la base de données est arrêtée.

Q : Que dois-je faire si certains noeuds sont inaccessibles pendant le processus d'application de patches ?

R : utilisez l'option --skipUnreachableNodes pour ignorer les noeuds inaccessibles.

Q : Comment appliquer le patch à certains noeuds uniquement ?

R : indiquez les noeuds à appliquer à l'aide de l'option --nodes avec une liste de noms de noeud séparés par des virgules.

Q : Comment vérifier les prérequis avant d'appliquer le patch ?

R : Utilisez l'option --executePrereqs pour exécuter les vérifications de prérequis avant d'appliquer le patch.

Q : Que dois-je faire si je veux éviter l'application de datapatch pendant le processus d'application de patches ?

R : Utilisez l'option --skipDatapatch pour ignorer l'étape datapatch.

Q : Comment indiquer un emplacement différent pour l'image de base de données utilisée dans le processus d'application de patches ?

R : Utilisez l'option --imageLocation pour indiquer un emplacement personnalisé pour l'image.

Q : Que faire si je dois ignorer datapatch sur certaines bases pluggables ?

R : Utilisez l'option --skipPDBs pour ignorer datapatch sur une liste de bases de données pluggables séparées par des virgules indiquée.

Q : Puis-je ignorer datapatch sur les bases pluggables qui ne sont pas ouvertes actuellement ?

R : Oui, utilisez l'option --skipClosedPDBs pour ignorer datapatch sur les bases de données pluggables fermées.

Q : Que dois-je faire si l'application de correctifs échoue à mi-parcours ?

R : Vous pouvez utiliser l'option --rollback pour revenir à l'état précédent ou essayer de reprendre le processus d'application de patches avec l'option --resume.

Q : Comment puis-je vérifier si tous les prérequis sont respectés avant d'appliquer le patch ?

R : exécutez la commande de patch avec l'option --executePrereqs pour vous assurer que tous les prérequis sont satisfaits.

Q : Que se passe-t-il si l'opération d'application de patches ne se termine pas correctement et que je dois réessayer ?

R : Utilisez l'option --resume pour réessayer l'opération d'application de patches à l'endroit où elle s'est arrêtée. Si nécessaire, vous pouvez indiquer --sessionID pour reprendre une session spécifique.

Q : Comment puis-je vérifier si le patch a été appliqué ?

R : Vous pouvez vérifier le processus d'application de patches en vérifiant la version du répertoire de base Oracle à l'aide de la commande opatch lsinventory une fois le patch terminé.

Q : Puis-je exécuter la commande d'application de patches en mode d'exécution à sec pour prévisualiser les actions ?

R : Non, la commande dbaascli dbHome patch ne dispose pas d'une fonctionnalité d'exécution à sec. Toutefois, vous pouvez utiliser l'option --executePrereqs pour exécuter des vérifications de prérequis avant d'appliquer réellement le patch.

Q : Est-il possible d'appliquer plusieurs patches en une seule exécution ?

R : La commande dbaascli dbHome patch autorise uniquement une version cible à la fois. Vous devez exécuter la commande séparément pour chaque version de patch.

Q : Comment gérer l'application de patches si l'environnement utilise plusieurs répertoires de base Oracle ?

R : Vous pouvez indiquer le répertoire de base Oracle auquel appliquer des patches à l'aide des options --oracleHome ou --oracleHomeName, selon que vous indiquez le chemin ou le nom du répertoire de base Oracle.

Q : Puis-je ignorer l'application de patches de données de base de données pluggable et de base de données Conteneur en une seule commande ?

R : Oui. Vous pouvez combiner les options --skipPDBs et --skipDatapatch pour ignorer l'application de patches aux bases de données pluggables et à la base de données Conteneur en une seule exécution de patch.

Q : Puis-je appliquer un patch et l'annuler immédiatement en cas de problème ?

R : Oui. Après avoir appliqué un patch, vous pouvez utiliser l'option --rollback pour revenir au niveau de patch précédent en cas de problème.

Q : Puis-je appliquer des patches à plusieurs répertoires de base Oracle simultanément ?

R : Non. Vous devez exécuter la commande dbaascli dbHome patch individuellement pour chaque répertoire de base Oracle.

Q : Comment suivre la progression de l'opération d'application de patches ?

R : Au cours du processus d'application de patches, la commande fournit des messages de sortie qui indiquent la progression. Vous pouvez également consulter les fichiers journaux pour obtenir des informations détaillées.

Q : Puis-je exécuter l'application de patches en parallèle sur un environnement clusterisé ?

R : Les opérations d'application de patches peuvent être appliquées à un sous-ensemble de noeuds à l'aide de l'option --nodes. Toutefois, l'application simultanée de patches doit être traitée avec soin et vous devez vous assurer qu'aucune session ne se chevauche.

Q : Comment identifier les patches disponibles pour mon répertoire de base Oracle ?

R : Vous pouvez vérifier les patches disponibles via le portail de support technique Oracle ou en exécutant la commande opatch lsinventory pour voir les patches en cours appliqués à votre répertoire de base Oracle.

Q : Puis-je indiquer un délai d'expiration pour la purge des ressources lors de l'arrêt de la base de données lors de l'application de patches ?

R : Oui. Vous pouvez utiliser l'option --drainTimeoutInSeconds pour indiquer la durée en secondes de purge des ressources lors de l'arrêt de la base de données.

Q : Que se passe-t-il si le patch échoue sur l'un des noeuds d'un environnement multinoeud ?

R : Vous pouvez utiliser l'option --skipUnreachableNodes pour ignorer le noeud en échec et poursuivre le processus d'application de patches sur les noeuds restants. Vous pouvez ensuite résoudre le problème sur le noeud défaillant séparément.

Q : Comment puis-je exécuter le processus d'application de patches en arrière-plan ?

R : Utilisez l'option --waitForCompletion avec la valeur false pour permettre au processus d'application de patches de s'exécuter en arrière-plan. De cette façon, vous n'avez pas besoin d'attendre que le processus se termine de manière interactive.

Q : Puis-je effectuer une opération d'annulation (rollback) sur un sous-ensemble de noeuds dans un environnement clusterisé ?

R : Oui. Vous pouvez utiliser l'option --nodes avec l'option --rollback pour annuler l'application de patches sur un ensemble de noeuds spécifique.

Q : Que faire si je dois mettre à jour l'emplacement de l'image après avoir lancé le processus de patch ?

R : L'option --resume ne permet pas de modifier l'emplacement de l'image. Cependant, vous pouvez arrêter la session et démarrer un nouveau processus de patch avec le fichier --imageLocation mis à jour.

Q : Existe-t-il un moyen de vérifier quels ID de session sont disponibles pour la reprise d'un patch ?

R : Vous pouvez consulter les fichiers journaux ou utiliser les outils Oracle Cloud pour identifier les sessions d'application de patches actives ou en pause et leurs ID de session.

Q : Puis-je limiter le temps d'arrêt pendant l'application de patches ?

R : Si vous devez limiter le temps d'arrêt, utilisez soigneusement l'option --continueWithDbDowntime. Cela vous permet de continuer même lorsque le temps d'arrêt est attendu, mais nécessite une planification pour un impact de service minimal.

Exemples de cas d'emploi

Exemple 1 : application de patches de base au répertoire de base Oracle par chemin de répertoire de base Oracle

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

Applique des patches au répertoire de base Oracle situé dans /u01/app/oracle/product/19.0.0/dbhome_1 vers la version 19.12.0.0.0.

Exemple 2 : application de patches par nom de répertoire de base Oracle

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0

Applique des patches au répertoire de base Oracle nommé DB_HOME_NAME vers la version 19.12.0.0.0.

Exemple 3 : reprise d'une opération de patch précédente

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --resume

Reprend l'opération d'application de patches précédente pour le répertoire de base Oracle situé dans /u01/app/oracle/product/19.0.0/dbhome_1.

Exemple 4 : reprise d'un patch avec un ID de session spécifique

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --resume --sessionID 12345

Reprend l'opération d'application de patches pour le répertoire de base Oracle DB_HOME_NAME à l'aide de l'ID de session 12345.

Exemple 5 : application de patches avec temps d'inactivité de base de données autorisé

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --continueWithDbDowntime

Applique des patches au répertoire de base Oracle situé dans /u01/app/oracle/product/19.0.0/dbhome_1 vers la version 19.12.0.0.0 tout en autorisant le temps d'inactivité de la base de données.

Exemple 6 : ignorer les noeuds inaccessibles

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes

Applique des patches au répertoire de base Oracle vers la version 19.12.0.0.0 tout en ignorant les noeuds inaccessibles.

Exemple 7 : application de patches à un sous-ensemble de noeuds

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --nodes node1,node2

Applique des patches au répertoire de base Oracle vers la version 19.12.0.0.0 sur node1 et node2 uniquement.

Exemple 8 : exécution de vérifications de prérequis avant l'application de patches

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --executePrereqs

Applique des patches au répertoire de base Oracle DB_HOME_NAME vers la version 19.12.0.0.0 après l'exécution des vérifications de prérequis.

Exemple 9 : ignorer l'étape Datapatch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch

Applique des patches au répertoire de base Oracle version 19.12.0.0.0 sans exécuter datapatch sur les bases de données.

Exemple 10 : Utilisation d'un fichier image pour l'application de patches

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --imageFilePath /path/to/image/file.zip

Applique des patches au répertoire de base Oracle vers la version 19.12.0.0.0 à l'aide d'un fichier image situé dans /path/to/image/file.zip.

Exemple 11 : ignorer des bases pluggables spécifiques pendant Datapatch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2

Applique des patches au répertoire de base Oracle vers la version 19.12.0.0.0 et ignore l'exécution de datapatch sur les bases de données pluggables indiquées (pdb1 dans cdb1 et pdb2 dans cdb2).

Exemple 12 : ignorer Datapatch sur les bases pluggables fermées

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipClosedPDBs

Applique des patches au répertoire de base Oracle vers la version 19.12.0.0.0 tout en ignorant l'exécution de datapatch sur les bases de données pluggables fermées.

Exemple 13 : annulation (rollback) du répertoire de base Oracle

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback

Annule le dernier patch appliqué sur le répertoire de base Oracle nommé DB_HOME_NAME.

Exemple 14 : combinaison de l'application de patches avec des vérifications de prérequis et des noeuds spécifiques

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --executePrereqs --nodes node1,node2

Applique des patches au répertoire de base Oracle vers la version 19.12.0.0.0, exécute des vérifications de prérequis et applique le patch uniquement sur node1 et node2.

Exemple 15 : ignorer les noeuds inaccessibles et les bases de données pluggables spécifiques

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --skipUnreachableNodes --skipPDBs cdb1:pdb1

Applique des patches au répertoire de base Oracle DB_HOME_NAME vers la version 19.12.0.0.0 tout en ignorant les noeuds inaccessibles et en évitant l'exécution de datapatch sur pdb1 dans cdb1.

Exemple 16 : Vérification de la version du répertoire de base Oracle après application du patch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

opatch lsinventory

Cet exemple montre comment vérifier la version du répertoire de base Oracle après la réussite d'un patch en exécutant opatch lsinventory.

Exemple 17 : annulation (rollback) de l'application de patches avec un ID de session spécifique

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --sessionID 67890

Annule l'application de patches au répertoire de base Oracle pour un ID de session 67890.

Exemple 18 : application de patches sans vérification des prérequis

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPrereqs

Applique des patches au répertoire de base Oracle, mais ignore les vérifications de prérequis avant d'appliquer le patch.

Exemple 19 : application d'un patch à une image de répertoire de base Oracle personnalisée

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --imageLocation /custom/location/image.zip

Applique des patches au répertoire de base Oracle à l'aide d'un fichier image personnalisé situé dans /custom/location/image.zip.

Exemple 20 : ignorer des noeuds spécifiques et exécuter des prérequis

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes --executePrereqs

Ignore l'application de patches aux noeuds inaccessibles et exécute les vérifications de prérequis avant d'appliquer le patch.

Exemple 21 : ignorer Datapatch sur toutes les bases pluggables de plusieurs bases Conteneur

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2,cdb3:pdb3

Applique des patches au répertoire de base Oracle mais ignore le patch de données sur les bases de données pluggables indiquées dans plusieurs bases de données Conteneur.

Exemple 22 : poursuite de l'application de patches avec temps d'inactivité sur plusieurs noeuds

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --continueWithDbDowntime --nodes node3,node4

Poursuit l'application de patches sur node3 et node4 avec un temps d'inactivité de base de données autorisé.

Exemple 23 : ignorer Datapatch sur les bases pluggables et les bases pluggables fermées

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch --skipClosedPDBs

Applique des patches au répertoire de base Oracle tout en ignorant les bases de données pluggables datapatch et fermées.

Exemple 24 : annulation (rollback) et réapplication du patch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

Annule le patch en cours, puis le réapplique au répertoire de base Oracle.

Exemple 25 : ignorer Datapatch et autoriser le temps d'arrêt sur un noeud spécifique

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipDatapatch --continueWithDbDowntime --nodes node1

Applique des patches au répertoire de base Oracle vers la version 19.13.0.0.0 sur node1, en ignorant l'étape datapatch et en autorisant les temps d'inactivité.

Exemple 26 : spécification du délai d'expiration de purge lors de l'arrêt de la base de données

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.13.0.0.0 --drainTimeoutInSeconds 300

Applique des patches au répertoire de base Oracle DB_HOME_NAME vers la version 19.13.0.0.0 et autorise un délai d'expiration de 5 minutes (300 secondes) pour purger les ressources lors de l'arrêt.

Exemple 27 : exécution de l'application de patches en arrière-plan

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --waitForCompletion false

Applique des patches au répertoire de base Oracle version 19.13.0.0.0 et exécute le processus d'application de patches en arrière-plan sans attendre la fin.

Exemple 28 : annulation (rollback) du patch sur un sous-ensemble de noeuds

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --nodes node1,node2

Annule (rollback) le dernier patch appliqué sur node1 et node2 uniquement pour le répertoire de base Oracle indiqué.

Exemple 29 : ignorer les prérequis et appliquer des patches à plusieurs noeuds

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipPrereqs --nodes node3,node4

Applique des patches au répertoire de base Oracle vers la version 19.13.0.0.0 sur node3 et node4 sans exécuter de vérifications de prérequis.

Exemple 30 : annulation (rollback) du patch et ignorage des noeuds inaccessibles

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback --skipUnreachableNodes

Annule le dernier patch sur le répertoire de base Oracle DB_HOME_NAME et ignore les noeuds inaccessibles lors du processus d'annulation.

dbaascli database move

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

Prérequis

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

Syntaxe

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

Où :

  • --oracleHome indique le chemin du répertoire de base Oracle.
  • --oracleHomeName indique le nom du répertoire de base Oracle.
  • --dbname indique le nom de la base de données.
  • --executePrereqs exécute les vérifications de prérequis et signale les résultats.
  • --resume reprend l'exécution précédente.
    • --sessionID indique de reprendre un ID de session spécifique.
  • --rollback restaure la base de données vers le répertoire de base précédent
    • --sessionID indique de reprendre un ID de session spécifique.
  • --skipDatapatch ignore l'exécution de datapatch sur les bases de données.
  • --skipPdbs ignore l'exécution de datapatch sur la liste de bases de données pluggables séparées par des virgules qui est indiquée. Par exemple : pdb1,pdb2...
  • --skipClosedPDBs ignore l'application de patches aux bases de données pluggables fermées
  • --continueWithDbDowntime poursuit l'application des patches avec un temps d'inactivité de la base de données. Cette option peut être utilisée dans des environnements dans lesquels une seule instance active est démarrée et dans lesquels l'opération d'application de patches peut être poursuivie même avec un temps d'inactivité.
  • --allowParallelDBMove permet le déplacement de la base de données en parallèle.
  • --waitForCompletion indique false pour exécuter l'opération en arrière-plan. Valeurs valides : true|false.
  • --nodeList indique une liste de noeuds séparés par des virgules si l'opération doit être exécutée sur un sous-ensemble de noeuds.

FAQ

Q : A quoi sert la commande dbaascli database move ?

R : La commande dbaascli database move permet de déplacer une base de données d'un répertoire de base Oracle vers un autre.

Q : Quels sont les prérequis pour utiliser la commande dbaascli database move ?

R : Avant d'effectuer un déplacement, vérifiez que toutes les instances de base de données associées à la base de données sont en fonctionnement. En outre, la commande doit être exécutée en tant qu'utilisateur root.

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

R : Le paramètre --oracleHome indique le chemin du répertoire de base Oracle vers lequel la base de données sera déplacée.

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

R : Le paramètre --oracleHomeName indique le nom du répertoire de base Oracle vers lequel la base de données sera déplacée.

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

R : Le paramètre --dbname indique le nom de la base de données à déplacer.

Q : Que fait l'option --executePrereqs ?

R : L'option --executePrereqs exécute les vérifications de prérequis et signale les résultats.

Q : Dans quel cas l'option --resume est-elle utilisée ?

R : L'option --resume reprend une opération de déplacement interrompue ou incomplète.

Q : Comment --sessionID est-il utilisé dans la commande ?

R : --sessionID indique l'ID de session pour reprendre une exécution ou une annulation précédente.

Q : Que fait l'option --rollback ?

R : L'option --rollback rétablit le répertoire de base Oracle précédent de la base de données.

Q : Que fait l'option --skipDatapatch ?

R : L'option --skipDatapatch ignore l'exécution de datapatch sur les bases de données pendant l'opération de déplacement.

Q : Quelle est la fonction de l'option --skipPDBs ?

R : L'option --skipPDBs ignore l'exécution de datapatch sur la liste de bases de données pluggables séparées par des virgules (par exemple, pdb1, pdb2).

Q : Que fait l'option --skipClosedPDBs ?

R : L'option --skipClosedPDBs ignore l'application de patches aux bases de données pluggables fermées.

Q : Que signifie --continueWithDbDowntime ?

R : L'option --continueWithDbDowntime permet à l'opération de déplacement de continuer même s'il n'y a qu'une seule instance active en fonctionnement, ce qui permet un temps d'inactivité pendant le processus.

Q : Quel est le but de l'option --allowParallelDBMove ?

R : L'option --allowParallelDBMove permet d'effectuer le déplacement de la base de données en parallèle, ce qui peut accélérer le processus.

Q : Que précise --waitForCompletion ?

R : L'option --waitForCompletion indique s'il faut attendre la fin de l'opération. Si vous lui affectez la valeur False, l'opération est exécutée en arrière-plan.

Q : Comment utiliser le paramètre --nodeList ?

R : Le paramètre --nodeList indique une liste de noeuds séparés par des virgules sur lesquels l'opération de déplacement sera effectuée, si elle ne doit pas être appliquée à tous les noeuds.

Q : Que dois-je faire en cas de problème avec la commande dbaascli database move ?

R : assurez-vous que toutes les instances de base de données sont en cours d'exécution et vérifiez que vous exécutez la commande en tant qu'utilisateur root. Si le problème persiste, consultez la documentation détaillée des commandes ou ouvrez un ticket d'assistance auprès d'Oracle.

Q : Puis-je effectuer une opération de déplacement si l'une des instances de base de données est arrêtée ?

R : Non. Toutes les instances de base de données associées doivent être en fonctionnement avant d'effectuer le déplacement.

Q : Que se passe-t-il si l'opération de déplacement est interrompue ?

R : Vous pouvez utiliser l'option --resume pour poursuivre l'opération de déplacement à partir de l'endroit où elle s'est arrêtée en utilisant la même session ou en spécifiant --sessionID.

Q : Que fait l'option --allowParallelDBMove ?

R : Il permet d'effectuer le déplacement de la base de données en parallèle, ce qui peut réduire le temps nécessaire pour terminer l'opération, en particulier dans les environnements plus volumineux.

Q : Comment surveiller la progression d'une opération de déplacement en cours d'exécution en arrière-plan ?

R : lors de l'utilisation de --waitForCompletion false, la commande n'attend pas la fin de l'opération. Vous pouvez vérifier le statut de l'opération manuellement à l'aide des journaux Oracle ou des commandes de statut appropriées.

Q : Quelle est la signification de l'option --skipClosedPDBs ?

R : L'application de patches aux bases de données pluggables fermées est ignorée, ce qui réduit le temps de fonctionnement si des bases de données pluggables n'ont pas besoin d'être appliquées.

Q : Le déplacement de la base de données peut-il être annulé (rollback) à tout moment ?

R : Oui, l'opération de déplacement peut être annulée à l'aide de l'option --rollback, soit en indiquant l'ID de session, soit simplement en revenant au répertoire de base Oracle précédent.

Q : Quel est le rôle de --nodeList dans un environnement multinoeud ?

R : Dans un environnement multinoeud, vous pouvez limiter l'opération de déplacement à des noeuds spécifiques en fournissant une liste de noms de noeud séparés par des virgules avec --nodeList.

Q : Puis-je déplacer la base de données vers un nouveau répertoire de base Oracle tout en ignorant des noeuds spécifiques dans un environnement à plusieurs noeuds ?

R : Oui. Vous pouvez utiliser l'option --nodeList pour indiquer les noeuds à inclure dans l'opération de déplacement. Tous les noeuds non répertoriés seront ignorés.

Q : Quel est le nombre maximal de noeuds que je peux spécifier avec le paramètre --nodeList ?

R : Le paramètre --nodeList vous permet d'indiquer une liste délimitée par des virgules d'autant de noeuds que nécessaire, limitée uniquement par votre configuration d'environnement. Assurez-vous que tous les noeuds sont valides et accessibles.

Q : Comment savoir quelles bases de données pluggables sont fermées avant d'utiliser l'option --skipClosedPDBs ?

R : Vous pouvez interroger la vue v$pdbs pour vérifier le statut des bases de données pluggables. Toutes les bases de données pluggables dont le statut est "MOUNTED" ou "CLOSED" sont ignorées lors de l'utilisation de --skipClosedPDBs.

Q : Comment puis-je vérifier si une restauration s'est terminée avec succès ?

R : Après avoir exécuté la commande d'annulation, vous pouvez consulter les journaux de base de données ou utiliser les journaux d'alertes Oracle pour vérifier que la base de données a été restaurée vers son précédent répertoire de base Oracle.

Q : Existe-t-il un moyen de forcer l'opération de déplacement en cas d'échec de certains prérequis ?

R : La commande move applique les vérifications de prérequis pour la stabilité du système. Vous ne pouvez pas ignorer les échecs de prérequis critiques. Résolvez les problèmes signalés par l'option --executePrereqs avant de poursuivre le déplacement.

Exemples de cas d'emploi

Exemple 1 : déplacement de base de données par chemin de répertoire de base Oracle

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL

Déplace la base de données ORCL vers le répertoire de base Oracle situé à l'emplacement /u01/app/oracle/product/19.0.0/dbhome_1.

Exemple 2 : déplacement de base de données par nom de répertoire de base Oracle

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL

Déplace la base de données ORCL vers le répertoire de base Oracle nommé DB_HOME_NAME.

Exemple 3 : exécution de vérifications de prérequis avant le déplacement

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --executePrereqs

Déplace la base de données ORCL vers le répertoire de base Oracle tout en exécutant au préalable les vérifications de prérequis.

Exemple 4 : reprise d'une opération de déplacement précédente

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --resume

Reprend une opération de déplacement précédente pour la base de données ORCL.

Exemple 5 : reprise d'une opération de déplacement avec un ID de session spécifique

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --resume --sessionID 12345

Reprend l'opération de déplacement pour la base de données ORCL à l'aide de l'ID de session 12345.

Exemple 6 : annulation (rollback) d'une opération Move

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --rollback

Annule l'opération de déplacement de la base de données ORCL et la restaure dans le répertoire de base Oracle précédent.

Exemple 7 : annulation d'une opération de déplacement avec un ID de session

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --rollback --sessionID 67890

Annule l'opération de déplacement pour ORCL à l'aide de l'ID de session 67890.

Exemple 8 : ignorer Datapatch

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipDatapatch

Déplace la base de données ORCL sans exécuter datapatch sur les bases de données.

Exemple 9 : ignorer des bases pluggables spécifiques pendant Datapatch

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipPDBs pdb1,pdb2

Déplace la base de données ORCL vers un nouveau répertoire de base Oracle, mais ignore l'exécution de datapatch sur les bases de données pluggables indiquées (pdb1 et pdb2).

Exemple 10 : ignorer Datapatch sur les bases pluggables fermées

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipClosedPDBs

Déplace la base de données ORCL et ignore l'exécution de datapatch sur les bases de données pluggables fermées.

Exemple 11 : autorisation du temps d'inactivité de la base de données lors du déplacement

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --continueWithDbDowntime

Déplace la base de données ORCL vers le répertoire de base Oracle indiqué tout en autorisant le temps d'inactivité de la base de données pendant le processus de déplacement.

Exemple 12 : Déplacer la base de données en parallèle

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --allowParallelDBMove

Déplace la base de données ORCL vers le répertoire de base Oracle indiqué avec la possibilité d'exécuter le déplacement en parallèle pour de meilleures performances.

Exemple 13 : exécution de l'opération en arrière-plan

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --waitForCompletion false

Déplace la base de données ORCL vers un nouveau répertoire de base Oracle, mais exécute l'opération en arrière-plan.

Exemple 14 : spécification des noeuds pour le déplacement

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --nodeList node1,node2

Déplace la base de données ORCL vers le répertoire de base Oracle indiqué, mais effectue l'opération uniquement sur node1 et node2.

Exemple 15 : combinaison du déplacement et des vérifications de prérequis, ignorer des bases de données pluggables spécifiques et autoriser le temps d'inactivité

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --executePrereqs --skipPDBs pdb1 --continueWithDbDowntime

Déplace la base de données ORCL vers le répertoire de base Oracle indiqué, exécute les vérifications de prérequis, ignore l'exécution de datapatch sur pdb1 et autorise le temps d'inactivité de la base de données pendant l'opération.

Exemple 16 : combinaison de déplacement en parallèle et d'exécution en arrière-plan

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --allowParallelDBMove --waitForCompletion false

Déplace la base de données ORCL vers un nouveau répertoire de base Oracle, exécute le déplacement en parallèle et exécute l'opération en arrière-plan.

Exemple 17 : combinaison de Move avec l'exécution en parallèle et ignorer les bases pluggables fermées

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname TESTDB --allowParallelDBMove --skipClosedPDBs

Déplace la base de données TESTDB vers le nouveau répertoire de base Oracle /u02/app/oracle/product/19.0.0/dbhome_2, tout en exécutant l'opération en parallèle et en ignorant datapatch sur les bases de données pluggables fermées.

Exemple 18 : exécution de la vérification des prérequis uniquement

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname PRODDB --executePrereqs

Vérifie les prérequis pour déplacer la base de données PRODDB vers le répertoire de base Oracle situé à l'emplacement /u02/app/oracle/product/19.0.0/dbhome_2 sans effectuer réellement le déplacement.

Exemple 19 : ignorer Datapatch pour des bases pluggables spécifiques

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname HRDB --skipPDBs pdb1,pdb3

Déplace la base de données HRDB vers le nouveau répertoire de base Oracle, mais ignore l'exécution de datapatch pour pdb1 et pdb3.

Exemple 20 : exécution du déplacement sur des noeuds spécifiques

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname FINDB --nodeList node1,node3

Déplace la base de données FINDB vers le nouveau répertoire de base Oracle uniquement sur node1 et node3.

Exemple 21 : déplacement de base de données avec temps d'arrêt autorisé

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --continueWithDbDowntime

Déplace la base de données ORCL vers le répertoire de base Oracle indiqué tout en autorisant le temps d'inactivité pendant l'opération de déplacement.

Exemple 22 : combinaison du déplacement parallèle et du saut de Datapatch

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname CRMDB --allowParallelDBMove --skipDatapatch

Déplace la base de données CRMDB en parallèle, en ignorant le processus datapatch.

Exemple 23 : opération de déplacement en arrière-plan avec une liste de noeuds

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname SALESDB --waitForCompletion false --nodeList node2,node3

Déplace la base de données SALESDB vers le répertoire de base Oracle indiqué en arrière-plan. L'opération est appliquée uniquement à node2 et node3.

Exemple 24 : déplacement de base de données avec vérification des prérequis et autorisation de déplacement en parallèle

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_2 --dbname ORCL --executePrereqs --allowParallelDBMove

Déplace la base de données ORCL vers le nouveau répertoire de base Oracle après avoir effectué les vérifications de prérequis et exécuté l'opération de déplacement en parallèle.

Exemple 25 : annulation (rollback) d'une opération de déplacement et ignorage des bases pluggables fermées

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname DEVDB --rollback --skipClosedPDBs

Annule l'opération de déplacement pour la base de données DEVDB, en ignorant les bases de données pluggables fermées.

Exemple 26 : Déplacement de la base de données avec un temps d'arrêt et une exécution en parallèle spécifiques

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname FINDB --allowParallelDBMove --continueWithDbDowntime

Déplace la base de données FINDB vers le répertoire de base Oracle indiqué tout en autorisant le temps d'inactivité de la base de données et l'exécution en parallèle pour accélérer le processus.

Exemple 27 : Vérifier les prérequis de déplacement de base de données sans exécuter le déplacement

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname HRDB --executePrereqs

Exécute des vérifications de prérequis pour vérifier que la base de données HRDB peut être déplacée vers le répertoire de base Oracle indiqué sans exécuter le déplacement lui-même.

Exemple 28 : déplacement de la base de données et exécution de la commande en arrière-plan sur des noeuds spécifiques

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_3 --dbname PRODDB --waitForCompletion false --nodeList node1,node4

Déplace la base de données PRODDB vers un nouveau répertoire de base Oracle, exécute l'opération en arrière-plan et l'applique uniquement à node1 et node4.

Exemple 29 : combiner des vérifications de prérequis, ignorer des bases pluggables fermées et autoriser l'exécution en parallèle

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname CRMDB --executePrereqs --skipClosedPDBs --allowParallelDBMove

Effectue des vérifications de prérequis avant de déplacer la base de données CRMDB vers le nouveau répertoire de base Oracle, ignore l'application de patches aux bases de données pluggables fermées et permet à l'opération d'être exécutée en parallèle pour une exécution plus rapide.

Exemple 30 : déplacement de base de données avec annulation sur un ID de session spécifique et ignorer Datapatch

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname DEVDB --rollback --sessionID 45678 --skipDatapatch

Annule (rollback) une opération de déplacement précédemment exécutée pour la base de données DEVDB vers son répertoire de base Oracle précédent à l'aide de l'ID de session 45678, en ignorant le processus datapatch lors de l'annulation.

Exemple 31 : déplacement de la base de données avec l'option Autoriser l'exécution en parallèle et spécification de Datapatch ignorée pour les bases pluggables

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_3 --dbname ANALYTICDB --allowParallelDBMove --skipPDBs pdb2,pdb4

Déplace la base de données ANALYTICDB en parallèle vers le répertoire de base Oracle indiqué et ignore le processus datapatch pour pdb2 et pdb4.

Divers

Q : Comment ignorer l'exécution du groupe de chat lors de l'application de patches à Oracle Database 11.2.0.4.0 ?

R : pour ignorer l'exécution de catbundle lors du processus d'application de patches Oracle Database, utilisez l'option --skipDatapatch avec la commande dbaascli database move ou dbaascli dbHome patch.

Q : Quelles sont les meilleures pratiques à suivre lors de l'application de patches à Oracle Database ?

R : Oracle recommande d'appliquer des patches sans réutilisation de la mémoire à l'aide de la commande dbaascli database move afin de réduire la fenêtre d'application de patches.

Oracle recommande d'utiliser l'option --allowParallelDBMove pour activer l'application de patches en parallèle, ce qui peut accélérer le processus.

Q : Les avertissements signalés lors des prérequis de patch Oracle Database peuvent-ils être ignorés ?

R : Il est conseillé de traiter et de résoudre les avertissements signalés lors de la vérification des prérequis avant de poursuivre le processus d'application de patches. Le fait d'ignorer les avertissements peut entraîner des problèmes lors de l'application de patches.

Q : Comment puis-je poursuivre l'application de patches à Oracle Database si une seule instance de base de données est en cours d'exécution ?

R : Il est recommandé d'exécuter au moins deux instances pour éviter tout temps d'inactivité de la base de données. Si l'exécution de deux instances n'est pas possible, vous pouvez utiliser l'option --continueWithDbDowntime avec la commande dbaascli database move ou dbaascli dbHome patch pour poursuivre l'application de patches malgré le temps d'inactivité.

Q : Dans un environnement Data Guard, datapatch est-il exécuté sur les bases de données principale et de secours ?

R : Non. Dans un environnement Data Guard, datapatch est exécuté uniquement dans le cadre du processus d'application de patches à la base de données principale.

Q : Les mises à jour logicielles provisoires (correctifs exceptionnels) ou les patches individuels peuvent-ils être appliqués manuellement sur les répertoires de base Oracle dans les environnements Exadata Cloud@Customer (ExaDB-C@C) ?

R : Oui. Des patches exceptionnels ou des patches individuels peuvent être appliqués manuellement aux répertoires de base Oracle dans les environnements ExaDB-C@C. Toutefois, il est recommandé d'utiliser l'option Image logicielle d'Oracle Database pour un processus d'application de patches plus rationalisé et pris en charge.

Q : Comment appliquer des patches à plusieurs bases de données Oracle exécutées à partir du même répertoire de base Oracle lorsque chaque base de données est exécutée sur un seul noeud ?

R : utilisez la commande dbaascli dbHome patch pour appliquer des patches au répertoire de base Oracle indiqué, qui les appliquera à toutes les bases de données exécutées à partir de ce répertoire de base. Il est recommandé d'exécuter plusieurs instances pour éviter tout temps d'inactivité. Si l'exécution de plusieurs instances n'est pas possible, vous pouvez utiliser l'option --continueWithDbDowntime pour poursuivre l'application de patches malgré le temps d'inactivité.

Gestion de base de données pluggable

Cette section traite de la gestion des bases de données pluggables au sein d'une base de données Conteneur. Il inclut des commandes permettant de créer (dbaascli pdb create), de supprimer (dbaascli pdb delete) et de cloner des bases de données pluggables (dbaascli pdb localClone, dbaascli pdb remoteClone). Vous pouvez gérer les états de base de données pluggable à l'aide de commandes permettant d'ouvrir, de fermer ou de redémarrer des bases de données pluggables, et d'extraire les détails de connexion (dbaascli pdb getConnectString). Des commandes supplémentaires prennent en charge la sauvegarde, la récupération et le transfert des bases pluggables, ce qui garantit un contrôle complet sur le cycle de vie et les opérations des bases pluggables.

dbaascli pdb backup

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

Prérequis

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

Syntaxe

dbaascli pdb backup --pdbName <value> --dbname <value>
        {
            --start
                {
                    [--level1]
                    | [--archival --tag <value>]
                }
            | --delete --backupTag <value>
            | --status --uuid <value>
            | --getBackupReport --json <value> --tag <value>
            | --list [--json <value>]
        }
Où :
--pdbName: PDB name.
--dbname: Oracle Database name.
--start | --delete | --status | --getBackupReport | --list
--start: Begins PDB backup.
      [--level1 | --archival]
      [--level1: Creates a Level-1 (incremental) backup.]
      [--archival: Creates an archival full backup.]
          --tag: Specify backup tag.
--delete: Deletes archival backup.
          --backupTag: Specify backup tag to delete.
--status
          --uuid <value>
--getBackupReport: Returns backup report.
         --json: Specify the file name for JSON output.
         --tag: Specify backup tag.
--list: Returns PDB backup information.
         [--json: Specify the file name for JSON output.]

FAQ

Q : Quel est le but de la commande de sauvegarde dbaascli pdb ?

R : La commande dbaascli pdb backup permet de créer des sauvegardes pour une base de données pluggable, d'interroger le statut de la sauvegarde, de générer des rapports de sauvegarde et de supprimer des sauvegardes de base de données pluggable dans un environnement Exadata Cloud@Customer.

Q : Quel est le prérequis pour utiliser la commande de sauvegarde dbaascli pdb ?

R : la commande doit être exécutée en tant qu'utilisateur root et vous devez être connecté à une machine virtuelle Exadata Cloud@Customer.

Q : Comment démarrer une sauvegarde de base de données pluggable à l'aide de la commande dbaascli PDB backup ?

R : Vous pouvez démarrer une sauvegarde de base de données pluggable à l'aide de l'option --start. Par exemple :

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start

Q : Quelles options peuvent être utilisées avec l'indicateur --start ?

R : Avec l'indicateur --start, vous pouvez indiquer les éléments suivants :

--level1 pour une sauvegarde incrémentielle de niveau 1

--archival pour une sauvegarde d'archivage complète (qui nécessite également --tag pour indiquer la balise de sauvegarde)

Q : Comment créer une sauvegarde de base de données pluggable incrémentielle de niveau 1 ?

R : Utilisez l'indicateur --level1 avec l'option --start pour créer une sauvegarde incrémentielle de niveau 1 :

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --level1

Q : Comment créer une sauvegarde de base de données pluggable d'archivage ?

R : utilisez l'indicateur --archival avec l'option --start et indiquez une balise de sauvegarde à l'aide de --tag :

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --archival --tag <backup_tag>

Q : Comment supprimer une sauvegarde de base de données pluggable spécifique ?

R : Pour supprimer une sauvegarde spécifique, utilisez l'indicateur --delete et indiquez la balise de sauvegarde à l'aide de --backupTag :

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --delete --backupTag <backup_tag>

Q : Comment vérifier le statut d'une sauvegarde de base de données pluggable ?

R : utilisez l'indicateur --status avec la sauvegarde --uuid pour vérifier le statut d'une sauvegarde spécifique :

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --status --uuid <backup_uuid>

Q : Comment extraire un rapport de sauvegarde de base de données pluggable au format JSON ?

R : Pour obtenir un rapport de sauvegarde au format JSON, utilisez l'option --getBackupReport, indiquez le nom de fichier avec --json et fournissez la balise de sauvegarde avec --tag :

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --getBackupReport --json <file_name> --tag <backup_tag>

Q : Comment répertorier toutes les sauvegardes de base de données pluggable pour une base de données pluggable spécifique ?

R : Utilisez l'option --list pour obtenir la liste de toutes les sauvegardes pour une base de données pluggable donnée :

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list

Vous pouvez éventuellement générer la liste au format JSON à l'aide de l'indicateur --json :

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list --json <file_name>

Q : Que fait l'option --pdbName ?

R : L'option --pdbName indique le nom de la base de données pluggable pour laquelle sauvegarder, interroger ou supprimer des sauvegardes.

Q : Quel est le but de l'option --dbname ?

R : L'option --dbname indique le nom de l'instance Oracle Database à laquelle la base de données pluggable appartient.

Q : Comment spécifier une balise de sauvegarde pour une sauvegarde de base de données pluggable ?

R : Vous indiquez une balise de sauvegarde à l'aide de l'option --tag lors du démarrage d'une sauvegarde d'archivage ou de l'extraction d'un rapport de sauvegarde :

--tag <backup_tag>

Q : Puis-je exécuter des sauvegardes de base de données pluggable en mode JSON ?

R : Oui. Les options de rapport de sauvegarde (--getBackupReport) et de liste de sauvegarde (--list) prennent en charge la sortie au format JSON. Vous indiquez un nom de fichier JSON à l'aide de l'option --json.

Exemple 7-30 Exemples

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

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

Prérequis

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

Syntaxe

dbaascli pdb bounce --dbname --pdbName | --pdbUID
[–openMode]
Où :
  • --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable.
  • --pdbName indique le nom de la base de données pluggable.
  • --pdbUID indique l'identificateur de la base de données pluggable.
  • --openMode indique le paramètre OPEN MODE cible de la base de données pluggable.

FAQ

Q : Quel est le rôle de la commande dbaascli pdb bounce ?

R : la commande dbaascli pdb bounce permet de redémarrer (redémarrer) une base de données pluggable dans un environnement Exadata Cloud@Customer.

Q : Quels sont les prérequis pour utiliser la commande dbaascli pdb bounce ?

R : la commande doit être exécutée en tant qu'utilisateur oracle et vous devez être connecté à une machine virtuelle Exadata Cloud@Customer.

Q : Comment puis-je redémarrer une base de données pluggable en indiquant son nom ?

R : Pour redémarrer une base de données pluggable en indiquant son nom, utilisez la syntaxe suivante :

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name>

Q : Comment redémarrer une base de données pluggable à l'aide de son identificateur unique (UID) ?

R : Pour redémarrer une base pluggable à l'aide de son identificateur unique (UID), utilisez la syntaxe suivante :

dbaascli pdb bounce --dbname <CDB_Name> --pdbUID <PDB_UID>

Q : A quoi sert l'option --dbname ?

R : L'option --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable en cours de redémarrage.

Q : A quoi sert l'option --pdbName ?

R : L'option --pdbName indique le nom de la base de données pluggable à redémarrer.

Q : A quoi sert l'option --pdbUID ?

R : L'option --pdbUID indique l'identificateur unique (UID) de la base de données pluggable à redémarrer.

Q : Comment indiquer le mode d'ouverture cible pour la base de données pluggable lors de son redémarrage ?

R : Vous pouvez utiliser l'option --openMode pour indiquer le mode d'ouverture souhaité pour la base de données pluggable après un redémarrage. Les valeurs valides sont READ_WRITE et READ_ONLY. Par exemple :

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE

Q : Puis-je ouvrir la base de données pluggable en mode lecture seule après l'avoir rebondie ?

R : Oui. Vous pouvez utiliser l'option --openMode READ_ONLY pour ouvrir la base de données pluggable en mode lecture seule après un redémarrage :

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_ONLY

Q : Quel est le mode d'ouverture par défaut si --openMode n'est pas spécifié ?

R : Si --openMode n'est pas indiqué, la base de données pluggable est ouverte dans son mode d'ouverture par défaut, qui est généralement READ_WRITE.

Q : Puis-je utiliser --pdbName et --pdbUID dans la même commande ?

R : Non. Vous devez indiquer --pdbName ou --pdbUID, mais pas les deux dans la même commande.

Q : Comment puis-je redémarrer une base de données pluggable et m'assurer qu'elle s'ouvre en mode lecture/écriture ?

R : Pour redémarrer une base de données pluggable et vous assurer qu'elle s'ouvre en mode lecture/écriture, utilisez l'option --openMode READ_WRITE :

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE

Q : Est-il obligatoire d'indiquer le mode d'ouverture lors de l'utilisation de la commande dbaascli pdb bounce ?

R : Non, la spécification de --openMode est facultative. S'il n'est pas indiqué, la base de données pluggable s'ouvre dans son mode par défaut.

Q : Que se passe-t-il si je ne spécifie pas l'indicateur --openMode ?

R : Si l'indicateur --openMode n'est pas indiqué, la base de données pluggable est ouverte dans son mode par défaut, qui est généralement READ_WRITE.

Exemple 7-31 dbaascli pdb bounce

dbaascli pdb bounce --dbname cdb_name --pdbName pdb name associated with the CDB
dbaascli pdb bounce --dbname cdb_name --pdbUID con_uid of that pdb
Facultatif :
  • --openMode READ_WRITE
  • --openMode READ_ONLY
dbaascli pdb close

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

Prérequis

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

Syntaxe

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

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

FAQ

Q : Quel est le rôle de la commande dbaascli pdb close ?

R : la commande dbaascli pdb close permet de fermer une base de données pluggable dans un environnement Exadata Cloud@Customer.

Q : Quels sont les prérequis pour utiliser la commande dbaascli pdb close ?

R : la commande doit être exécutée en tant qu'utilisateur oracle et vous devez être connecté à une machine virtuelle Exadata Cloud@Customer.

Q : Comment fermer une base de données pluggable en indiquant son nom ?

R : Pour fermer une base pluggable en indiquant son nom, utilisez la syntaxe suivante :

dbaascli pdb close --dbname <CDB_Name> --pdbName <PDB_Name>

Q : Comment fermer une base de données pluggable en indiquant son identificateur unique (UID) ?

R : Pour fermer une base pluggable à l'aide de son identificateur unique (UID), utilisez la syntaxe suivante :

dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>

Q : Que fait l'option --dbname dans la commande dbaascli pdb close ?

R : L'option --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable à fermer.

Q : Que fait l'option --pdbName dans la commande dbaascli pdb close ?

R : L'option --pdbName indique le nom de la base de données pluggable à fermer.

Q : Quel est le but de l'option --pdbUID dans la commande dbaascli pdb close ?

R : L'option --pdbUID vous permet d'indiquer l'identificateur unique (UID) de la base de données pluggable à fermer.

Q : Puis-je fermer la base de données pluggable sur une instance spécifique de la base de données Conteneur ?

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

Q : Est-il possible de spécifier --pdbName et --pdbUID dans la même commande ?

R : Non. Vous pouvez indiquer --pdbName ou --pdbUID, mais pas les deux dans la même commande.

Q : Que se passe-t-il lorsque la commande dbaascli pdb close aboutit ?

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

Q : Comment fermer une base de données pluggable spécifique au sein d'une base de données Conteneur à l'aide de son UID ?

R : Vous pouvez fermer une base de données pluggable spécifique à l'aide de son UID en exécutant :

dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>

Q : Que se passe-t-il si j'oublie de spécifier --pdbName ou --pdbUID ?

R : Vous devez indiquer --pdbName ou --pdbUID dans la commande. Si aucune des deux n'est fournie, la commande ne sera pas exécutée.

Q : Puis-je utiliser directement la commande dbaascli pdb close pour une base de données Conteneur ?

R : Non. La commande est conçue pour fermer une base de données pluggable au sein d'une base de données Conteneur, et non la base de données Conteneur elle-même.

Exemple 7-32 dbaascli pdb close

dbaascli pdb close --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb close --dbname cdb name --pdbUID con_uid of that pdb
dbaascli pdb create

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

Prérequis

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

Syntaxe

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

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

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

FAQ

Q : Quel est le rôle de la commande dbaascli pdb create ?

R : la commande dbaascli pdb create permet de créer une base de données pluggable dans une base de données Conteneur dans un environnement Exadata Cloud@Customer.

Q : Quels sont les prérequis pour utiliser la commande dbaascli pdb create ?

R : la commande doit être exécutée en tant qu'utilisateur oracle et vous devez être connecté à une machine virtuelle Exadata Cloud@Customer.

Q : Que fait l'option --pdbName dans la commande dbaascli pdb create ?

R : L'option --pdbName indique le nom de la base de données pluggable à créer.

Q : Que fait l'option --dbName dans la commande dbaascli pdb create ?

R : L'option --dbName indique le nom de la base de données Conteneur qui hébergera la nouvelle base de données pluggable.

Q : Puis-je limiter les ressources d'UC de la nouvelle base de données pluggable ?

R : Oui. Vous pouvez utiliser l'option --maxCPU pour indiquer le nombre maximal d'UC que la base de données pluggable peut utiliser. Cela équivaut à définir le paramètre CPU_COUNT dans la base de données pluggable.

Q : Comment limiter la taille de stockage d'une base de données pluggable ?

R : Vous pouvez utiliser l'option --maxSize pour indiquer la taille totale maximale des fichiers de données et des fichiers temporaires pour la base de données pluggable. Vous pouvez définir une limite de taille (en K, M, G ou T) ou indiquer UNLIMITED sans limite.

Q : A quoi sert l'option --pdbAdminUserName ?

R : L'option --pdbAdminUserName indique le nom de l'administrateur de la nouvelle base de données pluggable. Cet utilisateur disposera de privilèges d'administration au sein de la base de données pluggable.

Q : Est-il possible de verrouiller le compte d'administrateur lors de la création de la base de données pluggable ?

R : Oui. Vous pouvez utiliser l'option --lockPDBAdminAccount pour indiquer si le compte d'administrateur de base de données pluggable doit être verrouillé. Valeur par défaut : true (verrouillé).

Q : Que fait l'option --resume dans la commande dbaascli pdb create ?

R : L'option --resume vous permet de reprendre un processus de création de base de données pluggable ayant échoué précédemment.

Q : Comment spécifier un ID de session pour reprendre une exécution précédente ?

R : Vous pouvez indiquer un ID de session à l'aide de l'option --sessionID pour reprendre une session spécifique du processus de création de base de données pluggable.

Q : Quel est le but de l'option --executePrereqs ?

R : L'option --executePrereqs indique s'il faut exécuter uniquement les vérifications de prérequis pour la création de base de données pluggable. Vous pouvez définir cette option sur yes ou no.

Q : Puis-je exécuter le processus de création de base de données pluggable en arrière-plan ?

R : Oui, vous pouvez utiliser l'option --waitForCompletion et la définir sur False pour exécuter l'opération en arrière-plan.

Q : A quoi sert l'option --standbyBlobFromPrimary ?

R : L'option --standbyBlobFromPrimary indique l'emplacement du fichierlob de secours, préparé à partir de la base de données principale. Requis pour les opérations de base de données pluggable de la base de secours.

Q : Comment le mot de passe d'administrateur de base de données pluggable sera-t-il demandé lors du processus de création ?

R : Pendant le processus de création de la base pluggable, vous serez invité à indiquer le mot de passe d'administration pour la nouvelle base pluggable.

Q : Puis-je créer une base de données pluggable de secours à l'aide de la commande dbaascli PDB create ?

R : Oui. Si vous créez une base de données pluggable de secours, vous pouvez utiliser l'option --standbyBlobFromPrimary pour indiquer l'emplacement du fichier BLOB de secours à partir de la base de données principale.

Q : Que se passe-t-il si je n'utilise pas l'option --maxSize ?

R : Si vous n'indiquez pas l'option --maxSize, la base de données pluggable n'aura pas de limite de taille de stockage, sauf définition contraire par les stratégies de base de données Conteneur.

Q : Que se passe-t-il si je ne fournis pas l'option --pdbAdminUserName ?

R : Si vous n'indiquez pas l'option --pdbAdminUserName, la base de données pluggable sera créée sans administrateur indiqué et vous devrez la configurer manuellement après sa création.

Q : Puis-je reprendre la création d'une base de données pluggable ayant échoué à tout moment du processus ?

R : Oui. Tant que la session n'a pas pris fin, vous pouvez reprendre la création d'une base de données pluggable ayant échoué à l'aide des options --resume et --sessionID.

Exemple 7-33 dbaascli pdb create

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

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli pdb delete ?

R : la commande dbaascli pdb delete permet de supprimer une base de données pluggable d'une base de données Conteneur dans un environnement Exadata Cloud@Customer.

Q : Quels sont les prérequis pour exécuter la commande dbaascli pdb delete ?

R : la commande doit être exécutée en tant qu'utilisateur oracle et vous devez être connecté à une machine virtuelle Exadata Cloud@Customer.

Q : Que spécifie l'option --dbName dans la commande dbaascli pdb delete ?

R : L'option --dbName indique le nom de la base de données Conteneur qui héberge la base de données pluggable à supprimer.

Q : Comment spécifier la base de données pluggable à supprimer à l'aide de la commande dbaascli PDB delete ?

R : Vous pouvez indiquer la base de données pluggable à supprimer à l'aide de l'option --pdbName (indique le nom de la base de données pluggable) ou de l'option --pdbUID (indique l'UID de la base de données pluggable).

Q : Puis-je exécuter les vérifications de prérequis sans supprimer réellement la base de données pluggable ?

R : Oui. Vous pouvez utiliser l'option --executePrereqs et la définir sur yes afin d'exécuter uniquement les vérifications de prérequis pour l'opération de suppression de base de données pluggable.

Q : Comment exécuter le processus de suppression de base de données pluggable en arrière-plan ?

R : Utilisez l'option --waitForCompletion et définissez-la sur false pour exécuter le processus de suppression en arrière-plan.

Q : Que fait l'option --resume dans la commande dbaascli pdb delete ?

R : L'option --resume vous permet de reprendre un processus de suppression de base de données pluggable ayant précédemment échoué.

Q : Comment reprendre une session spécifique pour la suppression d'une base de données pluggable ?

R : Vous pouvez indiquer un ID de session à l'aide de l'option --sessionID afin de reprendre une session spécifique pour le processus de suppression de base de données pluggable.

Q : Que fait l'option --allStandbyPrepared ?

R : L'option --allStandbyPrepared est utilisée pour confirmer que l'opération de suppression a été exécutée sur toutes les bases de données de secours avant de poursuivre la suppression de la base de données pluggable principale.

Q : Quel est le but de l'option --cleanupRelocatedPDB ?

R : L'option --cleanupRelocatedPDB nettoie la base de données source après le déplacement d'une base de données pluggable, ce qui garantit qu'aucun résidu n'est laissé après le déplacement.

Q : Puis-je supprimer une base de données pluggable qui a déjà été transférée ?

R : Oui. Vous pouvez utiliser l'option --cleanupRelocatedPDB pour supprimer une base de données pluggable qui a déjà été transférée vers une nouvelle base de données Conteneur.

Q : Comment puis-je m'assurer que l'opération de suppression s'exécute correctement sur les bases de données de secours ?

R : Utilisez l'option --allStandbyPrepared pour vérifier que l'opération a été exécutée sur toutes les bases de données de secours avant de continuer.

Q : Que se passe-t-il si le processus de suppression échoue et doit être repris ?

R : Vous pouvez reprendre le processus de suppression à l'aide de l'option --resume et, si nécessaire, indiquer l'ID de session avec --sessionID.

Q : Que fait la définition de --waitForCompletion sur false ?

R : La définition de --waitForCompletion sur false permet au processus de suppression de s'exécuter en arrière-plan, ce qui vous permet de continuer à travailler sans attendre la fin de l'opération.

Exemple : dbaascli pdb delete

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

dbaascli pdb delete --dbName db721 --pdbName pdb1

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

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

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le rôle de la commande dbaascli pdb getConnectString ?

R : La commande dbaascli pdb getConnectString permet d'afficher les informations de chaîne de connexion Oracle Net pour une base de données pluggable dans un environnement Exadata Cloud@Customer.

Q : Quels sont les prérequis pour utiliser la commande dbaascli pdb getConnectString ?

R : la commande doit être exécutée en tant qu'utilisateur oracle et vous devez être connecté à une machine virtuelle Exadata Cloud@Customer.

Q : Comment extraire la chaîne de connexion d'une base de données pluggable en indiquant son nom ?

R : Pour extraire la chaîne de connexion en indiquant le nom de la base de données pluggable, utilisez la syntaxe suivante :

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbName <PDB_Name>

Q : Comment extraire la chaîne de connexion d'une base de données pluggable en indiquant son identificateur unique (UID) ?

R : Pour extraire la chaîne de connexion à l'aide de l'identificateur unique (UID) de la base de données pluggable, utilisez la syntaxe suivante :

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>

Q : Que fait l'option --dbname dans la commande dbaascli pdb getConnectString ?

R : L'option --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable pour laquelle afficher les informations de chaîne de connexion.

Q : Que fait l'option --pdbName dans la commande dbaascli pdb getConnectString ?

R : L'option --pdbName indique le nom de la base de données pluggable pour laquelle vous voulez extraire les informations de chaîne de connexion Oracle Net.

Q : Quel est le but de l'option --pdbUID dans la commande dbaascli pdb getConnectString ?

R : L'option --pdbUID vous permet d'indiquer l'identificateur unique (UID) de la base de données pluggable pour laquelle afficher la chaîne de connexion.

Q : Puis-je utiliser --pdbName et --pdbUID dans la même commande ?

R : Non. Vous pouvez utiliser --pdbName ou --pdbUID, mais pas les deux dans la même commande.

Q : Quel type d'informations la commande dbaascli pdb getConnectString renvoie-t-elle ?

R : La commande renvoie les informations de chaîne de connexion Oracle Net pour la base de données pluggable indiquée.

Q : Puis-je extraire la chaîne de connexion d'une base de données pluggable sur une instance de base de données Conteneur spécifique ?

R : Non. La chaîne de connexion concerne l'ensemble de la base de données pluggable et non une instance spécifique de la base de données Conteneur.

Q : Comment obtenir les informations de chaîne de connexion si je connais uniquement l'identificateur unique (UID) de la base de données pluggable ?

R : Vous pouvez extraire la chaîne de connexion à l'aide de l'UID de la base de données pluggable en exécutant la commande suivante :

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>

Q : Que se passe-t-il si je n'ai pas fourni --pdbName ou --pdbUID ?

R : Vous devez indiquer --pdbName ou --pdbUID pour extraire la chaîne de connexion. La commande ne sera pas exécutée sans l'une de ces options.

Q : Les informations de chaîne de connexion pour la base de données pluggable sont-elles toujours les mêmes sur toutes les instances de la base de données Conteneur ?

R : Oui. Les informations de chaîne de connexion sont cohérentes pour la base de données pluggable dans toutes les instances de la base de données Conteneur.

Exemple 7-34 dbaascli pdb getConnectString

dbaascli pdb getConnectString --dbname dbname --pdbName pdbName
dbaascli pdb getDetails

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le rôle de la commande dbaascli pdb getDetails ?

R : la commande dbaascli pdb getDetails permet de visualiser les détails d'une base de données pluggable hébergée dans une base de données Conteneur dans un environnement Exadata Cloud@Customer.

Q : Quels sont les prérequis pour l'exécution de la commande dbaascli pdb getDetails ?

R : la commande doit être exécutée en tant qu'utilisateur oracle et vous devez être connecté à une machine virtuelle Exadata Cloud@Customer.

Q : Que spécifie l'option --dbname dans la commande dbaascli pdb getDetails ?

R : L'option --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable pour laquelle visualiser les détails.

Q : Comment indiquez-vous la base de données pluggable pour laquelle visualiser les détails ?

R : Vous pouvez indiquer la base de données pluggable à l'aide de l'option --pdbName (pour fournir le nom de la base de données pluggable) ou de l'option --pdbUID (pour fournir l'UID de la base de données pluggable).

Q : Quelle est la différence entre --pdbName et --pdbUID ?

R : L'option --pdbName utilise le nom de la base de données pluggable pour extraire les détails, tandis que l'option --pdbUID utilise l'identificateur unique (UID) de la base de données pluggable pour extraire ses détails.

Q : Puis-je utiliser les commandes --pdbName et --pdbUID ensemble dans la commande dbaascli pdb getDetails ?

R : Non. Vous pouvez indiquer l'option --pdbName ou --pdbUID pour obtenir les détails de la base de données pluggable, mais pas les deux en même temps.

Q : Quels sont les cas d'emploi de la commande dbaascli pdb getDetails ?

R : Vous pouvez utiliser la commande dbaascli pdb getDetails pour :
  • Extraire les détails d'une base de données pluggable spécifique dans une base de données Conteneur.
  • Vérifier la configuration d'une base pluggable.
  • Vérifiez le statut d'une base de données pluggable au sein d'une base de données Conteneur.

Q : Comment afficher les détails d'une base de données pluggable en fonction de son nom ?

R : Pour visualiser les détails d'une base de données pluggable en fonction de son nom, utilisez la syntaxe suivante :

dbaascli pdb getDetails --dbname <CDB_Name> --pdbName <PDB_Name>

Q : Comment afficher les détails d'une base de données pluggable en fonction de son UID ?

R : Pour visualiser les détails d'une base de données pluggable en fonction de son UID, utilisez la syntaxe suivante :

dbaascli pdb getDetails --dbname <CDB_Name> --pdbUID <PDB_UID>

Q : Cette commande peut-elle être utilisée pour plusieurs bases de données pluggables en une seule exécution ?

R : Non. La commande peut être utilisée pour extraire les détails d'une base de données pluggable à la fois en indiquant son nom ou son UID.

Exemple 7-35 dbaascli pdb getDetails

dbaascli pdb getDetails--dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb getDetails--dbname cdb name --pdbUID con_uid of that pdb
dbaascli pdb list

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

Prérequis

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

Syntaxe

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

FAQ

Q : Quel est le but de la commande dbaascli pdb list ?

R : la commande dbaascli pdb list permet de visualiser la liste des bases de données pluggables dans une base de données Conteneur indiquée dans un environnement Exadata Cloud@Customer.

Q : Quels sont les prérequis pour exécuter la commande dbaascli pdb list ?

R : la commande doit être exécutée en tant qu'utilisateur oracle et vous devez être connecté à une machine virtuelle Exadata Cloud@Customer.

Q : Que spécifie l'option --dbname dans la commande dbaascli pdb list ?

R : L'option --dbname indique le nom de la base de données Conteneur qui héberge les bases de données pluggables pour lesquelles vous voulez visualiser la liste.

Q : Puis-je afficher la liste des bases de données pluggables de plusieurs bases de données Conteneur à la fois ?

R : Non. La commande dbaascli pdb list vous permet de répertorier les bases de données pluggables à partir d'une seule base de données Conteneur à la fois, indiquée par l'option --dbname.

Q : Comment répertorier les bases de données pluggables dans une base de données Conteneur spécifique ?

R : Vous pouvez répertorier les bases de données pluggables d'une base de données Conteneur spécifique à l'aide de la syntaxe suivante :

dbaascli pdb list --dbname <CDB_Name>

Q : Quelles informations sont affichées lors de l'utilisation de la commande dbaascli pdb list ?

R : la commande renvoie la liste de toutes les bases de données pluggables au sein de la base de données Conteneur indiquée. La liste inclut généralement les noms des bases de données pluggables et éventuellement d'autres détails, tels que leur statut.

Q : Puis-je filtrer la liste des bases de données pluggables à l'aide d'options supplémentaires ?

R : Non, la commande dbaascli pdb list ne prend pas en charge les options de filtrage supplémentaires. Il renvoie simplement la liste complète des bases de données pluggables au sein de la base de données Conteneur indiquée.

Q : Que se passe-t-il si --dbname spécifié n'existe pas ou est incorrect ?

R : si la valeur --dbname indiquée est incorrecte ou n'existe pas, la commande renvoie une erreur et aucune liste de bases de données pluggables n'est affichée.

Q : La commande dbaascli pdb list peut-elle être utilisée pour n'importe quel environnement de base de données Oracle ?

R : Non. La commande dbaascli pdb list est spécialement conçue pour être utilisée dans les environnements Exadata Cloud@Customer.

Exemple 7-36 dbaascli pdb list

dbaascli pdb list --dbname cdb name
dbaascli pdb localClone

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

Prérequis

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

Syntaxe

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

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

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

FAQ

Q : Quel est le rôle de la commande dbaascli pdb localClone ?

R : la commande dbaascli pdb localClone permet de créer une base de données pluggable en tant que clone d'une base de données pluggable existante dans la même base de données Conteneur dans un environnement Exadata Cloud@Customer.

Q : Quels sont les prérequis pour l'exécution de la commande dbaascli pdb localClone ?

R : la commande doit être exécutée en tant qu'utilisateur oracle et vous devez être connecté à une machine virtuelle Exadata Cloud@Customer. En outre, la base de données pluggable source doit déjà exister dans la base de données Conteneur indiquée.

Q : Que précise l'option --dbName dans la commande dbaascli pdb localClone ?

R : L'option --dbName indique le nom de la base de données Conteneur qui héberge la base de données pluggable source à partir de laquelle la nouvelle base de données pluggable sera clonée.

Q : Que précise l'option --pdbName dans la commande dbaascli pdb localClone ?

R : L'option --pdbName indique le nom de la base de données pluggable à créer en tant que clone de la base de données pluggable existante dans la même base de données Conteneur.

Q : Puis-je cloner une base de données pluggable portant un nom différent à l'aide de la commande dbaascli PDB localClone ?

R : Oui. Vous pouvez indiquer un autre nom pour la base de données pluggable clonée à l'aide de l'option --targetPDBName. Si cette option n'est pas fournie, la base de données pluggable clonée hérite du nom de la base de données pluggable source.

Q : Que fait l'option --resume dans la commande dbaascli pdb localClone ?

R : L'option --resume vous permet de reprendre une opération de clonage de base de données pluggable précédemment interrompue.

Q : Comment limiter les ressources d'UC disponibles pour la base de données pluggable clonée ?

R : Vous pouvez limiter les ressources d'UC pour la base de données pluggable clonée à l'aide de l'option --maxCPU, qui indique le nombre maximal d'UC qui seront allouées à la nouvelle base de données pluggable.

Q : Puis-je exécuter l'opération de clonage de base de données pluggable en arrière-plan ?

R : Oui. Vous pouvez exécuter l'opération en arrière-plan en définissant l'option --waitForCompletion sur false. Si vous la définissez sur true, l'opération est exécutée au premier plan et attend sa fin.

Q : Quel est le but de l'option --maxSize dans la commande dbaascli pdb localClone ?

R : L'option --maxSize indique la taille de stockage maximale (en Go) de la base de données pluggable nouvellement clonée. Si aucune taille n'est indiquée, la base de données pluggable clonée hérite des mêmes limites de stockage que la base de données pluggable source.

Q : Puis-je contrôler le parallélisme de l'opération de clonage de base de données pluggable ?

R : Oui, vous pouvez contrôler le degré de parallélisme de l'opération de clonage à l'aide de l'option --powerLimit. Cette option accepte des valeurs comprises entre 1 et 128 pour définir le degré de parallélisme.

Q : A quoi sert l'option --primaryDBWalletTar ?

R : L'option --primaryDBWalletTar indique l'emplacement du fichier tar du portefeuille de la base de données principale. Cette option n'est requise que si l'opération de clonage implique des opérations de base de données pluggable de la base de données de secours.

Q : Puis-je exécuter uniquement les vérifications de prérequis pour l'opération de clonage ?

R : Oui. Vous pouvez uniquement exécuter les vérifications de prérequis à l'aide de l'option --executePrereqs et la définir sur yes. Les valeurs valides sont yes et no.

Q : Que se passe-t-il si l'opération de clonage de base de données pluggable échoue ou est interrompue ?

R : Si l'opération de clonage échoue ou est interrompue, vous pouvez la reprendre en utilisant l'option --resume pour continuer à partir de l'endroit où l'opération s'est arrêtée.

Exemple 7-37 dbaascli pdb localClone

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

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

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

Syntaxe

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

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

FAQ

Q : Quel est le rôle de la commande dbaascli pdb open ?

R : la commande dbaascli pdb open permet d'ouvrir une base de données pluggable dans une base de données Conteneur Oracle dans un environnement Exadata Cloud@Customer.

Q : Qui peut exécuter la commande dbaascli pdb open ?

R : la commande peut être exécutée en tant qu'utilisateur root ou oracle.

Q : Que spécifie l'option --pdbName dans la commande dbaascli pdb open ?

R : L'option --pdbName indique le nom de la base de données pluggable à ouvrir.

Q : Que spécifie l'option --pdbUID dans la commande dbaascli pdb open ?

R : L'option --pdbUID indique l'identificateur unique (UID) de la base de données pluggable à ouvrir.

Q : Que spécifie l'option --dbname dans la commande dbaascli pdb open ?

R : L'option --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable.

Q : Quel est le but de l'option --openMode ?

R : L'option --openMode indique le mode dans lequel la base de données pluggable sera ouverte. Les valeurs valides sont READ_WRITE et READ_ONLY.

Q : Puis-je démarrer des services lors de l'ouverture de la base de données pluggable ?

R : Oui. Vous pouvez utiliser l'option --startServices pour démarrer tous les services associés à la base de données pluggable en indiquant tous les services ou fournir une liste de services spécifiques à démarrer, séparés par des virgules.

Q : Que se passe-t-il si j'affecte la valeur False à l'option --waitForCompletion ?

R : Si --waitForCompletion est défini sur false, la commande est exécutée en arrière-plan et l'utilisateur n'a pas besoin d'attendre la fin de l'opération. Si la valeur est true, la commande attend la fin avant de quitter.

Q : Que fait l'option --setPDBRefreshModeNone ?

R : L'option --setPDBRefreshModeNone convertit une base de données pluggable actualisable (qui est régulièrement mise à jour à partir d'une base de données principale) en une base de données pluggable non actualisable.

Q : Quelle est la fonction de l'option --skipPDBRefresh ?

R : L'option --skipPDBRefresh vous permet d'ignorer l'opération d'actualisation lors de l'ouverture d'une base de données pluggable actualisable, empêchant ainsi la synchronisation avec la base de données principale à ce moment-là.

Q : Que fait l'option --pdbAdminUserName dans la commande dbaascli pdb open ?

R : L'option --pdbAdminUserName vous permet d'indiquer un nouveau nom utilisateur d'administrateur de base de données pluggable lors de l'ouverture de la base de données pluggable.

Q : Que se passe-t-il si la commande dbaascli pdb open aboutit ?

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

Q : Est-il possible d'exécuter la commande dbaascli PDB open pour une base de données pluggable actualisable ?

R : Oui. La commande peut être utilisée pour les bases de données pluggables actualisables. L'option --setPDBRefreshModeNone convertit la base de données pluggable en base de données non actualisable et l'option --skipPDBRefresh ignore l'opération d'actualisation pendant le processus d'ouverture.

Q : Quel est le mode d'ouverture par défaut pour une base de données pluggable si aucun --openMode n'est spécifié ?

R : Si aucune valeur --openMode n'est indiquée, la base de données pluggable est généralement ouverte en mode READ_WRITE par défaut.

Exemple 7-38 dbaascli pdb open

dbaascli pdb open --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb open --dbname cdb name --pdbUID con_uid of that pdb

Facultatif : --openMode READ_WRITE/READ_ONLY.

dbaascli pdb recover

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

Prérequis

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

Syntaxe

dbaascli pdb recover --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>

FAQ

Q : Quel est le rôle de la commande dbaascli pdb recover ?

R : la commande dbaascli pdb recover permet de récupérer une base de données pluggable jusqu'à un état précédent à l'aide de sauvegardes stockées dans une destination de stockage de sauvegarde configurée.

Q : Qui peut exécuter la commande dbaascli pdb recover ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Que faut-il faire avant d'exécuter la commande dbaascli pdb recover ?

R : Avant d'exécuter la commande, la base de données doit être configurée avec des détails de destination de stockage de sauvegarde pour l'emplacement de stockage des sauvegardes.

Q : Que précise l'option --pdbName dans la commande dbaascli pdb recover ?

R : L'option --pdbName indique le nom de la base de données pluggable à récupérer.

Q : Que spécifie l'option --dbname dans la commande dbaascli pdb recover ?

R : L'option --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable.

Q : Quelles sont les options possibles pour démarrer une récupération de base de données pluggable à l'aide de l'option --start ?

R : Vous pouvez récupérer la base de données pluggable à l'aide de l'une des options suivantes :
  • --untilTime <value> : récupère la base de données pluggable jusqu'à l'heure indiquée (format : DD-MON-YYYY HH24:MI).
  • --untilSCN <value> : récupère la base de données pluggable jusqu'à un numéro SCN (System Change Number) spécifié.
  • --latest : récupère la base de données pluggable dans le dernier état connu.
  • --tag <value> : récupère la base de données pluggable vers une balise d'archivage spécifique.

Q : Quel est le format requis pour spécifier l'heure dans l'option --untilTime ?

R : L'heure doit être au format DD-MON-YYYY HH24:MI:SS.

Q : Comment puis-je récupérer une base de données pluggable à l'état le plus récent à l'aide de dbaascli PDB recover ?

R : Pour rétablir la base de données pluggable dans le dernier état connu, utilisez l'option --latest :

dbaascli pdb recover --pdbName <value> --dbname <value> --start --latest

Q : Comment récupérer une base de données pluggable vers une balise d'archivage spécifique ?

R : Vous pouvez récupérer la base de données pluggable vers une balise spécifique à l'aide de l'option --tag :

dbaascli pdb recover --pdbName <value> --dbname <value> --start --tag <tag_value>

Q : Puis-je récupérer une base de données pluggable à l'aide d'un SCN spécifique ?

R : Oui. Vous pouvez récupérer la base de données pluggable sur un SCN spécifique à l'aide de l'option --untilSCN :

dbaascli pdb recover --pdbName <value> --dbname <value> --start --untilSCN <SCN_value>

Q : Que fait l'option --status dans la commande dbaascli pdb recover ?

R : L'option --status permet de vérifier le statut d'une opération de récupération. Vous devez indiquer --uuid pour indiquer la session de récupération.

Q : Comment vérifier le statut d'une récupération de base de données pluggable ?

R : Pour vérifier le statut d'une opération de récupération, utilisez l'option --status avec la valeur --uuid de la session de récupération :

dbaascli pdb recover --pdbName <value> --dbname <value> --status --uuid <uuid_value>

Q : Que se passe-t-il si je spécifie l'option --latest dans la commande recovery ?

R : Si vous indiquez l'option --latest, la base de données pluggable sera récupérée dans l'état le plus récent disponible dans la sauvegarde.

Exemple 7-39 Exemples

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

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

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

Syntaxe

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

Où :

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

FAQ

Q : Quel est le but de la commande dbaascli pdb refresh ?

R : la commande dbaascli pdb refresh permet d'actualiser une base de données pluggable dans une base de données Conteneur.

Q : Qui peut exécuter la commande dbaascli pdb refresh ?

R : la commande peut être exécutée par l'utilisateur root ou oracle.

Q : Que spécifie l'option --dbname dans la commande dbaascli pdb refresh ?

R : L'option --dbname indique le nom de la base de données Conteneur qui héberge la base de données pluggable à actualiser.

Q : Que précise l'option --pdbName dans la commande dbaascli pdb refresh ?

R : L'option --pdbName indique le nom de la base de données pluggable à actualiser.

Q : Que précise l'option --pdbUID dans la commande dbaascli pdb refresh ?

R : L'option --pdbUID indique l'identificateur unique (UID) de la base de données pluggable à actualiser.

Q : Que fait l'option --waitForCompletion dans la commande dbaascli pdb refresh ?

R : L'option --waitForCompletion indique si l'opération doit être exécutée au premier plan ou en arrière-plan. Si la valeur est True, l'opération est exécutée au premier plan et attend la fin. Si la valeur est False, l'opération est exécutée en arrière-plan.

Q : Comment actualiser une base de données pluggable et exécuter l'opération en arrière-plan ?

R : Pour actualiser une base de données pluggable et exécuter l'opération en arrière-plan, utilisez l'option --waitForCompletion false :

dbaascli pdb refresh --dbname <value> --pdbName <value> --waitForCompletion false

Q : Comment actualiser une base de données pluggable à l'aide de son identificateur unique (UID) ?

R : Vous pouvez actualiser la base de données pluggable à l'aide de l'option --pdbUID :

dbaascli pdb refresh --dbname <value> --pdbUID <value>

Q : Puis-je indiquer --pdbName et --pdbUID ensemble dans la commande dbaascli pdb refresh ?

R : Non. Vous devez indiquer --pdbName ou --pdbUID, mais pas les deux, lors de l'actualisation d'une base de données pluggable.

Q : Que se passe-t-il si je n'inclus pas l'option --waitForCompletion dans la commande ?

R : Si vous n'indiquez pas l'option --waitForCompletion, le comportement par défaut est d'attendre la fin de l'opération avant de renvoyer le contrôle à l'utilisateur.

Q : Puis-je actualiser une base de données pluggable pendant que la base de données est en cours d'exécution ?

R : Oui. Vous pouvez actualiser une base de données pluggable pendant que la base de données est en cours d'exécution, à condition que la commande soit exécutée par un utilisateur disposant des privilèges appropriés.

dbaascli pdb remoteClone

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

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

Syntaxe

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

    Les paramètres --blobLocation et --standbyBlobFromPrimary s'excluent mutuellement.
  • --excludeUserTablespaces est une option permettant d'ignorer les tablespaces utilisateur (par exemple, t1,t2,t3).
  • --excludePDBData indique true/yes pour ignorer les données utilisateur de la base de données pluggable source.
  • --pdbAdminUserName indique le nouveau nom de l'administrateur de la base de données pluggable.
  • --lockPDBAdminAccount indique true ou false pour le verrouillage du compte de l'administrateur de la base de données pluggable. La valeur par défaut est True.
  • --sourcePDBServiceConvertList indique la liste des noms de service, séparés par des virgules, qui doivent être convertis de la source vers la cible. La syntaxe est la suivante : source_srv1:new_srv1, source_srv2:new_srv2.
  • --refreshablePDB indique qu'une base de données pluggable actualisable doit être créée.
    • --refreshMode indique le mode d'actualisation pour la base de données pluggable actualisable. Valeurs valides : AUTO|MANUAL
      • --refreshIntervalInMinutes indique l'intervalle d'actualisation pour refreshablePDB en minutes.
    • --dblinkUsername indique l'utilisateur commun d'une base de données distante, permettant au lien de base de données de se connecter à la base de données distante.
      • --honorCaseSensitiveUserName indique que le nom utilisateur spécifié fait la distinction entre les majuscules et les minuscules.
  • --updateDBBlockCacheSize indique de permettre à l'application de définir les paramètres d'initialisation db block cache size afin de prendre en charge la copie de données avec une taille de bloc différente.

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

FAQ

Q : A quoi sert la commande dbaascli pdb remoteClone ?

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

Q : Quel utilisateur doit exécuter la commande dbaascli pdb remoteClone ?

R : la commande doit être exécutée en tant qu'utilisateur root ou oracle.

Q : Qu'est-ce qui est requis lorsque vous y êtes invité lors de l'opération dbaascli pdb remoteClone ?

R : Vous devez fournir le mot de passe utilisateur SYS pour la base de données pluggable source.

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

R : le paramètre --pdbName indique le nom de la base de données pluggable source à cloner.

Q : Que représente le paramètre --dbName ?

R : Le paramètre --dbName représente le nom (DB_NAME) de la base de données Conteneur qui hébergera la base de données pluggable nouvellement clonée.

Q : Comment le --sourceDBConnectionString doit-il être formaté ?

R : Le format de --sourceDBConnectionString doit être <scan_name> :<scan_port>/<database_service_name>.

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

R : Le paramètre --targetPDBName indique le nom de la base de données pluggable nouvellement clonée.

Q : Que contrôle --powerLimit ?

R : Le paramètre --powerLimit contrôle le degré de parallélisme utilisé pour l'opération de clonage. La valeur valide est comprise entre 1 et 128.

Q : Que définit le paramètre --maxCPU ?

R : le paramètre --maxCPU définit le nombre maximal d'UC à allouer au processus de clonage de base de données pluggable.

Q : Quelle est la fonction de --maxSize ?

R : le paramètre --maxSize indique la taille de stockage maximale en Go pour la nouvelle base de données pluggable.

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

R : Le paramètre --resume reprend l'opération de clonage précédente.

Q : Que devez-vous fournir avec l'option --resume ?

R : Vous pouvez indiquer --sessionID pour reprendre une session spécifique si vous reprenez une opération précédente.

Q : Que contrôle --executePrereqs ?

R : Le paramètre --executePrereqs détermine si seuls les prérequis de l'opération de clonage doivent être exécutés. Les valeurs valides sont yes et no.

Q : Quel est l'impact de --waitForCompletion sur l'opération ?

R : Le paramètre --waitForCompletion indique s'il faut attendre la fin de l'opération ou l'exécuter en arrière-plan. Les valeurs valides sont true ou false.

Q : Qu'est-ce qui est spécifié par le paramètre --sourcePDBExportedTDEKeyFile ?

R : le paramètre --sourcePDBExportedTDEKeyFile indique le fichier de clés exporté à partir de la base de données pluggable source. Ce paramètre est applicable uniquement à Oracle Database version 12.1.

Q : Que définit le paramètre --blobLocation ?

R : le paramètre --blobLocation indique le chemin personnalisé où le fichier BLOB de secours sera généré dans un environnement Data Guard.

Q : Quand --standbyBlobFromPrimary est-il utilisé ?

R : le paramètre --standbyBlobFromPrimary indique l'emplacement du fichier BLOB de secours préparé à partir de la base de données principale. Requis uniquement pour les opérations de base de données pluggable de la base de données de secours.

Q : --blobLocation et --standbyBlobFromPrimary peuvent-ils être utilisés ensemble ?

R : Non, --blobLocation et --standbyBlobFromPrimary s'excluent mutuellement et ne peuvent pas être utilisés ensemble.

Q : Que fait l'option --excludeUserTablespaces ?

R : L'option --excludeUserTablespaces vous permet d'ignorer le clonage de tablespaces utilisateur spécifiques. Par exemple, t1,t2,t3.

Q : Quel est l'effet de --excludePDBData ?

R : L'option --excludePDBData indique si les données utilisateur de la base de données pluggable source doivent être ignorées lors du clonage. Les valeurs valides sont true ou yes.

Q : Qu'est-ce qui est spécifié par --pdbAdminUserName ?

R : Le paramètre --pdbAdminUserName indique le nouveau nom de l'administrateur de la base de données pluggable clonée.

Q : Que contrôle l'option --lockPDBAdminAccount ?

R : L'option --lockPDBAdminAccount indique si le compte d'administrateur de base de données pluggable doit être verrouillé. Valeur par défaut : true.

Q : Que précise --sourcePDBServiceConvertList ?

R : Le paramètre --sourcePDBServiceConvertList indique une liste de conversions de nom de service source/cible séparées par des virgules. Par exemple, source_srv1 :new_srv1,source_srv2 :new_srv2.

Q : Quel est le but de --refreshablePDB ?

R : Le paramètre --refreshablePDB indique s'il faut créer une base de données pluggable actualisable.

Q : Que contrôle --refreshMode ?

R : Le paramètre --refreshMode contrôle le mode d'actualisation d'une base de données pluggable actualisable. Les valeurs valides sont AUTO ou MANUAL.

Q : Comment fonctionne --refreshIntervalInMinutes ?

R : Le paramètre --refreshIntervalInMinutes indique l'intervalle (en minutes) d'actualisation de la base de données pluggable actualisable.

Q : Dans quel cas --dblinkUsername est-il utilisé ?

R : le paramètre --dblinkUsername indique l'utilisateur commun d'une base de données distante, permettant au lien de base de données de se connecter à la base de données distante.

Q : Que signifie l'option --honorCaseSensitiveUserName ?

R : L'option --honorCaseSensitiveUserName indique que le nom utilisateur spécifié fait la distinction entre les majuscules et les minuscules.

Q : Quel est l'effet de --updateDBBlockCacheSize ?

R : L'option --updateDBBlockCacheSize permet à l'application de définir les paramètres d'initialisation de taille de cache de bloc de base de données afin de prendre en charge la copie de données avec une taille de bloc différente.

Q : Que dois-je faire en cas d'erreur avec la commande dbaascli pdb remoteClone ?

R : Consultez le message d'erreur pour plus de détails, assurez-vous que tous les paramètres sont correctement spécifiés et vérifiez que vous disposez des autorisations et des informations d'identification nécessaires. En outre, vérifiez que les bases de données source et cible répondent à toutes les exigences.

Q : Que faire si j'oublie le mot de passe utilisateur SYS pour la base de données pluggable source ?

R : Vous devrez réinitialiser ou récupérer le mot de passe utilisateur SYS pour la base de données pluggable source. Sans elle, l'opération de clonage ne peut pas être terminée.

Exemple 7-40 dbaascli pdb remoteClone

dbaascli pdb remoteClone --sourceDBConnectionString test-can.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521 --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2
dbaascli pdb remoteClone --sourceDBConnectionString orcla.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2
dbaascli pdb relocate

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

Prérequis

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

Syntaxe

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

    Les paramètres --blobLocation et --standbyBlobFromPrimary s'excluent mutuellement.
  • --upgradePDB indique true pour mettre à niveau la base de données pluggable dans le cadre de cette opération. Valeurs valides : true | false.
  • --updateDBBlockCachesize est une option permettant à l'application de définir les paramètres d'initialisation db block cache size afin de prendre en charge la copie de données avec une taille de bloc différente.
  • --skipOpenPDB indique que la base de données pluggable ne doit pas être ouverte à la fin de l'opération en cours.
  • --completePDBRelocate permet d'effectuer l'opération de transfert de la base de données pluggable si elle est réalisée en deux étapes.

FAQ

Q : A quoi sert la commande dbaascli pdb relocate ?

R : la commande dbaascli pdb relocate permet de transférer une base de données pluggable d'une base de données distante vers une base de données locale.

Q : Quel utilisateur doit exécuter la commande dbaascli pdb relocate ?

R : la commande doit être exécutée en tant qu'utilisateur Oracle.

Q : Qu'est-ce qui est requis lorsque vous y êtes invité lors de l'opération de transfert de base de données pluggable dbaascli ?

R : Vous devez fournir le mot de passe de l'utilisateur SYS pour la base de données source.

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

R : Le paramètre --pdbName indique le nom de la base de données pluggable source à transférer.

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

R : Le paramètre --dbName indique le nom de la base de données cible où la base de données pluggable sera transférée.

Q : Comment le --sourceDBConnectionString doit-il être formaté ?

R : Le format de --sourceDBConnectionString doit être <scan_name> :<scan_port>/<database_service_name>.

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

R : Le paramètre --targetPDBName indique un nouveau nom pour la base de données pluggable transférée.

Q : Quelle est l'utilisation de --powerLimit ?

R : Le paramètre --powerLimit indique le degré de parallélisme à utiliser lors de l'opération de transfert.

Q : Comment --maxCpu affecte-t-il le processus de relocalisation ?

R : le paramètre --maxCpu indique le nombre maximal d'UC à affecter pour le processus de transfert de base de données pluggable.

Q : Que définit le paramètre --maxSize ?

R : Le paramètre --maxSize définit la taille de stockage maximale en Go pour la nouvelle base de données pluggable.

Q : Quelle est la fonction de --resume ?

R : Le paramètre --resume indique que l'opération de transfert doit reprendre là où elle s'est arrêtée.

Q : Que dois-je fournir avec l'option --resume ?

R : Vous pouvez indiquer --sessionID pour reprendre une session spécifique si vous reprenez une opération précédente.

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

R : Le paramètre --executePrereqs détermine si seuls les prérequis de l'opération doivent être exécutés. Les valeurs valides sont Oui et Non.

Q : Qu'est-ce qui est spécifié par le paramètre --sourcePDBServices ?

R : Le paramètre --sourcePDBServices indique la liste des services de la base de données pluggable source, séparés par des virgules.

Q : Que fait la liste des paramètres --sourcePDBReadOnlyServices ?

R : Le paramètre --sourcePDBReadOnlyServices répertorie la liste des services en lecture seule de la base de données pluggable source, séparés par des virgules.

Q : Quel est l'effet de --waitForCompletion ?

R : Le paramètre --waitForCompletion indique si l'opération doit être exécutée en arrière-plan. Les valeurs valides sont true ou false.

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

R : le paramètre --blobLocation indique l'emplacement d'un répertoire personnalisé où le fichier BLOB de secours sera généré dans un environnement Data Guard.

Q : Quand dois-je utiliser --standbyBlobFromPrimary ?

R : utilisez --standbyBlobFromPrimary pour indiquer l'emplacement du fichier BLOB de secours, préparé à partir de la base de données principale. Requis uniquement pour les opérations de base de données secours.

Q : Puis-je utiliser --blobLocation et --standbyBlobFromPrimary ensemble ?

R : Non. Les paramètres --blobLocation et --standbyBlobFromPrimary s'excluent mutuellement et ne peuvent pas être utilisés ensemble.

Q : Que fait --upgradePDB ?

R : Le paramètre --upgradePDB indique si la base de données pluggable doit être mise à niveau dans le cadre de l'opération de transfert. Les valeurs valides sont true ou false.

Q : Quel est le but de --updateDBBlockCacheSize ?

R : L'option --updateDBBlockCacheSize permet à l'application de définir les paramètres d'initialisation de taille de cache de bloc de base de données afin de prendre en charge la copie de données avec une taille de bloc différente.

Q : Que fait l'option --skipOpenPDB ?

R : L'option --skipOpenPDB indique que la base de données pluggable ne doit pas être ouverte à la fin de l'opération de transfert.

Q : Quand dois-je utiliser --completePDBRelocate ?

R : Utilisez --completePDBRelocate pour terminer le transfert de la base de données pluggable s'il s'agit d'une opération en deux étapes.

Q : Que dois-je faire en cas d'erreur lors de l'utilisation de la commande dbaascli pdb relocate ?

R : Vérifiez le message d'erreur pour plus de détails, assurez-vous que tous les paramètres sont correctement spécifiés et vérifiez que vous disposez des autorisations et des informations d'identification nécessaires. Vous devrez peut-être également passer en revue les prérequis et les configurations.

Q : Que faire si j'oublie le mot de passe utilisateur SYS pour la base de données source ?

R : Vous devrez réinitialiser ou récupérer le mot de passe utilisateur SYS pour la base de données source. Sans elle, vous ne pouvez pas terminer l'opération de transfert.

Exemple 7-41 dbaascli pdb relocate

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

Gestion du système

Cette section se concentre sur la supervision et la gestion des répertoires de base Oracle dans le système. Elle inclut des commandes telles que dbaascli system getDBHomes pour visualiser les détails de tous les répertoires de base Oracle Database et dbaascli system getGridHomes pour répertorier les détails de tous les répertoires de base Grid Infrastructure. Ces commandes fournissent des informations essentielles pour la maintenance et le dépannage de l'environnement système global.

dbaascli system getDBHomes

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

Prérequis

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

Syntaxe

dbaascli system getDBHomes

FAQ

Q : A quoi sert la commande dbaascli system getDBHomes ?

R : La commande dbaascli system getDBHomes permet d'afficher les informations relatives à tous les répertoires de base Oracle d'un système.

Q : Quel utilisateur doit exécuter la commande dbaascli system getDBHomes ?

R : la commande doit être exécutée en tant qu'utilisateur root ou oracle.

Q : Existe-t-il des paramètres pour la commande dbaascli system getDBHomes ?

R : Non, la commande dbaascli system getDBHomes ne comporte aucun paramètre.

Q : Quel type d'informations la commande dbaascli system getDBHomes fournit-elle ?

R : La commande fournit des détails sur tous les répertoires de base Oracle du système, y compris leurs chemins et d'autres informations pertinentes.

Q : Comment interpréter la sortie de la commande dbaascli system getDBHomes ?

R : La sortie répertorie tous les répertoires de base Oracle avec des informations telles que l'emplacement de chaque répertoire de base Oracle. Ces informations peuvent aider à gérer et à configurer les environnements Oracle.

Q : Que dois-je faire si la commande dbaascli system getDBHomes ne renvoie aucune sortie ?

R : assurez-vous que vous exécutez la commande en tant qu'utilisateur root ou oracle et vérifiez que les répertoires de base Oracle sont correctement installés sur le système. Vous pouvez également vérifier les autorisations et les configurations système.

Q : Que se passe-t-il si je reçois un message d'erreur lors de l'exécution de la commande dbaascli system getDBHomes ?

R : consultez le message d'erreur pour obtenir des détails spécifiques, vérifiez que vous disposez des droits d'accès appropriés et assurez-vous que l'outil dbaascli est correctement installé et configuré.

Q : Puis-je exécuter dbaascli system getDBHomes sur un système non Oracle ?

R : Non. La commande dbaascli system getDBHomes est spécifique aux systèmes Oracle et requiert l'installation du logiciel Oracle.

Exemple 7-42 dbaascli system getDBHomes

dbaascli system getDBHomes
dbaascli system getGridHomes

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

Prérequis

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

Syntaxe

dbaascli system getGridHomes

FAQ

Q : A quoi sert la commande dbaascli system getGridHomes ?

R : La commande dbaascli system getGridHomes permet de répertorier les détails de tous les répertoires de base Grid d'un système.

Q : Quel utilisateur doit exécuter la commande dbaascli system getGridHomes ?

R : la commande doit être exécutée en tant qu'utilisateur root ou oracle.

Q : Existe-t-il des paramètres pour la commande dbaascli system getGridHomes ?

R : Non, la commande dbaascli system getGridHomes ne comporte aucun paramètre.

Q : Quel type d'informations la commande dbaascli system getGridHomes fournit-elle ?

R : La commande fournit des détails sur tous les répertoires de base Grid du système, y compris leur emplacement et d'autres informations pertinentes.

Q : Comment interpréter la sortie de la commande dbaascli system getGridHomes ?

R : La sortie répertorie tous les répertoires de base Grid avec des informations telles que leurs chemins et leurs configurations. Cela facilite la gestion et la configuration d'Oracle Grid Infrastructure.

Q : Que dois-je faire si la commande dbaascli system getGridHomes ne renvoie aucune sortie ?

R : assurez-vous que vous exécutez la commande en tant qu'utilisateur root ou oracle et vérifiez que les répertoires de base Oracle Grid sont correctement installés sur le système. Vérifiez les autorisations et les configurations système si nécessaire.

Q : Que se passe-t-il si je reçois un message d'erreur lors de l'exécution de la commande dbaascli system getGridHomes ?

R : consultez le message d'erreur pour obtenir des détails spécifiques, assurez-vous que vous disposez des droits d'accès appropriés et vérifiez que l'outil dbaascli est correctement installé et configuré.

Q : Puis-je exécuter dbaascli system getGridHomes sur un système sans Oracle Grid Infrastructure ?

R : Non. La commande dbaascli system getGridHomes est propre aux systèmes sur lesquels Oracle Grid Infrastructure est installé. Si aucun répertoire de base Grid n'est présent, la commande peut ne renvoyer aucun résultat.

Gestion du cryptage transparent des données

Cette section traite de la gestion du cryptage transparent des données (TDE) pour la sécurisation des données de base de données. Il inclut des commandes permettant de gérer les clés de cryptage et les fichiers de clés, telles que dbaascli tde addSecondaryHsmKey pour ajouter des clés HSM secondaires, dbaascli tde rotateMasterKey pour effectuer la rotation de la clé maître et dbaascli tde encryptTablespacesInPDB pour crypter les tablespaces au sein d'une base de données pluggable. Vous pouvez également effectuer la conversion entre FILE et TDE basé sur HSM (dbaascli tde fileToHsm, dbaascli tde hsmToFile), gérer les versions de clé et extraire les détails de clé à l'aide de diverses commandes. Ces outils assurent une gestion efficace du chiffrement et la sécurité des données.

dbaascli tde addSecondaryHsmKey

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

Prérequis

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

Syntaxe

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

FAQ

Q : Que fait la commande dbaascli tde addSecondaryHsmKey ?

R : la commande dbaascli tde addSecondaryHsmKey ajoute une clé HSM (KMS) secondaire à la configuration HSM (KMS) existante pour une base de données Exadata Cloud@Customer.

Q : Qui doit exécuter la commande dbaascli tde addSecondaryHsmKey ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Sur quel ordinateur dois-je exécuter la commande dbaascli tde addSecondaryHsmKey ?

R : Vous devez vous connecter à une machine virtuelle Exadata Cloud@Customer à l'aide de SSH pour exécuter cette commande.

Q : Où puis-je trouver plus de détails sur la connexion à une machine virtuelle pour exécuter cette commande ?

R : Pour obtenir des instructions sur la connexion à une machine virtuelle avec SSH, reportez-vous au guide "Connexion à une machine virtuelle avec SSH".

Q : Que précise l'option --secondaryKmsKeyOCID ?

R : L'option --secondaryKmsKeyOCID indique l'OCID (identificateur Oracle Cloud) de la clé KMS secondaire à ajouter à la configuration HSM (KMS) existante.

Q : Que fait l'option --dbname ?

R : L'option --dbname vous permet d'indiquer le nom de la base de données pour laquelle la clé KMS secondaire doit être ajoutée. Il est facultatif.

Q : Que fait l'option --precheckOnly ?

R : L'option --precheckOnly, lorsqu'elle est définie sur yes, exécute une prévérification de l'opération sans apporter de modifications réelles. Les valeurs valides sont yes ou no.

Q : Puis-je exécuter la prévérification uniquement sans apporter de modifications ?

R : Oui, vous pouvez utiliser l'option --precheckOnly yes pour exécuter uniquement la prévérification sans apporter de modifications.

Q : Pouvez-vous donner un exemple d'exécution de cette commande pour ajouter une clé HSM secondaire ?

R : Voici un exemple :

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example

Q : Comment exécuter la commande pour une base de données spécifique ?

R : Vous pouvez indiquer le nom de la base de données comme suit :

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --dbname mydatabase

Q : Comment exécuter la commande avec une prévérification uniquement ?

R : Pour exécuter la prévérification, utilisez la syntaxe suivante :

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --precheckOnly yes

Q : Que faire en cas d'échec de la commande ?

R : assurez-vous que vous exécutez la commande en tant qu'utilisateur root et que vous êtes connecté à la machine virtuelle Exadata Cloud@Customer appropriée. Vérifiez également l'OCID de la clé KMS et vérifiez si les droits d'accès requis sont accordés.

Q : Comment puis-je vérifier si j'ai l'OCID correct pour la clé KMS secondaire ?

R : Vous pouvez extraire l'OCID de la clé KMS à partir de la console Oracle Cloud Infrastructure, sous la section Key Management Service (KMS).

Q : Quelles sont les autorisations requises pour ajouter une clé KMS secondaire ?

R : Vous avez besoin des droits d'accès appropriés dans Oracle Cloud Infrastructure pour les opérations KMS, y compris la possibilité de gérer les clés KMS pour le compartiment approprié.

Q : Puis-je utiliser la commande dbaascli tde addSecondaryHsmKey sans spécifier l'option --dbname ?

R : Oui, l'option --dbname est facultative. Si elle est omise, la commande s'applique à toutes les bases de données utilisant la configuration HSM (KMS) existante.

Q : Que se passe-t-il si j'ajoute une clé KMS secondaire ?

R : La clé KMS secondaire sera ajoutée à la configuration existante, fournissant une couche supplémentaire de redondance de gestion des clés de chiffrement.

Q : Puis-je supprimer une clé KMS secondaire une fois qu'elle est ajoutée ?

R : Non, une fois qu'une clé KMS secondaire est ajoutée, elle ne peut pas être supprimée. Vous pouvez uniquement effectuer une rotation ou mettre à jour les clés à l'avenir.

Exemple 7-43 dbaascli tde addSecondaryHsmKey

dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --precheckOnly yes
dbaascli tde changePassword

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

Prérequis

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

Syntaxe

dbaascli tde changePassword [--dbname <value>]
  {            [--prepareStandbyBlob <value> [--blobLocation <value>]]
               | [--standbyBlobFromPrimary <value>]
  }
  [--resume [--sessionID <value>]]
Où :
  • --dbname indique le nom de la base de données.
  • --prepareStandbyBlob indique true pour générer un fichier BLOB contenant les artefacts nécessaires à l'exécution de l'opération dans un environnement DG.
  • --blobLocation indique le chemin personnalisé où le fichier BLOB de secours sera généré dans un environnement DG.
  • --standbyBlobFromPrimary indique l'emplacement du fichier BLOB de secours, préparé à partir de la base de données principale. Requis uniquement pour les opérations de base de données secours.
  • --resume indique de reprendre l'exécution précédente.
  • --sessionID indique de reprendre un ID de session spécifique.

FAQ

Q : Que fait la commande dbaascli tde changePassword ?

R : La commande dbaascli tde changePassword modifie le mot de passe du fichier de clés TDE (Transparent Data Encryption) ainsi que le mot de passe du portefeuille de base de données pour l'alias tde_ks_passwd.

Q : Qui doit exécuter la commande dbaascli tde changePassword ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Quand dois-je utiliser la commande dbaascli tde changePassword ?

R : utilisez cette commande lorsque vous devez modifier le mot de passe du fichier de clés TDE ou le mot de passe du portefeuille de base de données pour une base de données Exadata Cloud@Customer.

Q : Que fait l'option --dbname ?

R : L'option --dbname indique le nom de la base de données pour laquelle vous voulez modifier le mot de passe du fichier de clés TDE.

Q : Que fait l'option --pdbName ?

R : L'option --pdbName indique le nom de la base de données pluggable pour laquelle le mot de passe du fichier de clés TDE doit être modifié. Cette option est utilisée pour les bases de données colocatives.

Q : Pouvez-vous donner un exemple d'exécution de cette commande pour une base de données spécifique ?

R : Voici un exemple de modification du mot de passe du fichier de clés TDE pour une base de données spécifique :

dbaascli tde changePassword --dbname mydatabase

Q : Comment exécuter la commande pour une base de données pluggable spécifique au sein d'une base de données colocative ?

R : Vous pouvez indiquer le nom de la base de données pluggable à l'aide de la syntaxe suivante :

dbaascli tde changePassword --dbname mydatabase --pdbName mypdb

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

R : Vous devez exécuter la commande en tant qu'utilisateur root et avoir accès à la machine virtuelle Exadata Cloud@Customer sur laquelle la base de données est exécutée.

Q : Dois-je arrêter la base de données pour modifier le mot de passe du fichier de clés TDE ?

R : Non. La base de données n'a pas besoin d'être arrêtée pour modifier le mot de passe du fichier de clés TDE.

Q : Que faire en cas d'échec de la commande ?

R : Assurez-vous que vous exécutez la commande en tant qu'utilisateur root et que le nom de la base de données (--dbname) et le nom de la base de données pluggable (--pdbName, le cas échéant) sont corrects.

Q : Que se passe-t-il si je reçois une erreur "mot de passe non valide" lors de la modification du mot de passe du fichier de clés TDE ?

R : Assurez-vous que le nouveau mot de passe répond aux exigences de complexité du mot de passe de votre système et que vous saisissez l'ancien mot de passe correct si vous y êtes invité.

Q : Comment vérifier si le mot de passe du fichier de clés TDE a été modifié ?

R : Vous pouvez consulter les journaux de base de données ou utiliser les vues Oracle Database Vault et Key Management pour vérifier que la modification du mot de passe du fichier de clés TDE a réussi.

Q : Puis-je modifier le mot de passe du fichier de clés TDE pour une base de données colocative et toutes les bases de données pluggables en même temps ?

R : Non. La commande dbaascli tde changePassword doit être exécutée individuellement pour chaque base de données pluggable si vous devez modifier le mot de passe de plusieurs bases de données pluggables.

Q : Que se passe-t-il si j'oublie le nouveau mot de passe du fichier de clés TDE ?

R : Si le nouveau mot de passe est oublié, vous devrez peut-être restaurer le fichier de clés à partir d'une sauvegarde ou suivre le processus de récupération d'Oracle pour le réinitialiser, en fonction de votre configuration.

Q : Puis-je automatiser le processus de modification du mot de passe du fichier de clés TDE ?

R : Bien que la commande dbaascli tde changePassword elle-même ne soit pas conçue pour l'automatisation, vous pouvez la créer dans le cadre des procédures de maintenance de base de données standard, si nécessaire.

Q : À quelle fréquence dois-je modifier le mot de passe du fichier de clés TDE ?

R : Oracle recommande de modifier régulièrement le mot de passe du fichier de clés TDE en fonction des stratégies de sécurité de votre organisation. Les meilleures pratiques impliquent généralement la rotation régulière des clés de cryptage et des mots de passe de fichier de clés.

Pour modifier le mot de passe TDE dans un environnement non Data Guard :
dbaascli tde changepassword --dbname
      <dbname>
Pour modifier le mot de passe TDE dans un environnement Data Guard, procédez comme suit :
  1. Modifiez le mot de passe TDE dans la base de données principale.
    dbaascli tde changepassword --dbname
          <dbname> --prepareStandbyBlob true --blobLocation
          <Location where blob file has to be generated>
  2. Copiez le fichier BLOB de secours créé vers l'environnement de base de données de secours.
  3. Modifiez le mot de passe TDE dans la base de données de secours.
    dbaascli tde changepassword --dbname
         <dbname> --standbyBlobFromPrimary <Location of blob generated from
        primary>

dbaascli tde enableWalletRoot

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

Prérequis

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

Syntaxe

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

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

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

FAQ

Q : Que fait la commande dbaascli tde enableWalletRoot ?

R : la commande dbaascli tde enableWalletRoot active le paramètre wallet_root dans spfile pour une base de données Oracle existante sur Exadata Cloud@Customer.

Q : Qui doit exécuter la commande dbaascli tde enableWalletRoot ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Sur quel ordinateur dois-je exécuter la commande dbaascli tde enableWalletRoot ?

R : Vous devez vous connecter à une machine virtuelle Exadata Cloud@Customer à l'aide de SSH pour exécuter cette commande.

Q : Où puis-je trouver des instructions pour me connecter à la machine virtuelle ?

R : Vous pouvez vous référer au guide "Connexion à une machine virtuelle avec SSH" pour obtenir des instructions sur la connexion.

Q : Que fait l'option --dbRestart ?

R : L'option --dbRestart indique comment la base de données doit être redémarrée après l'activation de wallet_root. Les valeurs valides sont les suivantes :
  • rolling : redémarre la base de données de manière non simultanée (comportement par défaut).
  • full : effectue un redémarrage complet de la base de données.

Q : Que fait l'option --dbname ?

R : L'option --dbname vous permet d'indiquer le nom de l'instance Oracle Database pour laquelle le paramètre wallet_root doit être activé.

Q : Que fait l'option --precheckOnly ?

R : L'option --precheckOnly exécute une prévérification de l'opération sans apporter de modifications réelles. Les valeurs valides sont yes ou no.

Q : Que se passe-t-il si je ne spécifie pas l'option --dbRestart ?

R : Si vous n'indiquez pas l'option --dbRestart, la base de données redémarre de manière non simultanée par défaut.

Q : Pouvez-vous donner un exemple d'activation de wallet_root pour une base de données spécifique ?

R : Voici un exemple d'activation de wallet_root pour une base de données nommée mydatabase :

dbaascli tde enableWalletRoot --dbname mydatabase

Q : Comment activer wallet_root et indiquer un redémarrage complet de la base de données ?

R : Vous pouvez activer wallet_root avec un redémarrage complet de la base de données à l'aide de la commande suivante :

dbaascli tde enableWalletRoot --dbname mydatabase --dbRestart full

Q : Comment exécuter la commande avec une prévérification uniquement ?

R : Pour effectuer une prévérification sans apporter de modifications, utilisez la syntaxe suivante :

dbaascli tde enableWalletRoot --dbname mydatabase --precheckOnly yes

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

R : Vous devez exécuter la commande en tant qu'utilisateur root et être connecté à la machine virtuelle Exadata Cloud@Customer appropriée.

Q : Dois-je redémarrer la base de données pour activer wallet_root ?

R : Oui, la base de données devra être redémarrée de manière non simultanée (par défaut) ou entièrement, selon l'option que vous choisissez.

Q : Que faire en cas d'échec de la commande ?

R : Assurez-vous que vous exécutez la commande en tant qu'utilisateur root et que le nom de la base de données (--dbname) est correct. Vérifiez la présence d'erreurs de prévérification si vous exécutez --precheckOnly.

Q : Que se passe-t-il si la base de données ne parvient pas à redémarrer après l'exécution de la commande ?

R : Vérifiez que l'option de redémarrage correcte a été utilisée (rolling ou full) et recherchez les erreurs éventuelles dans les journaux de base de données. Vous devrez peut-être redémarrer manuellement la base de données en cas d'échec du redémarrage automatique.

Q : Comment vérifier si wallet_root a été activé ?

R : Vous pouvez vérifier la modification en vérifiant le paramètre spfile de la base de données ou en utilisant des requêtes SQL Oracle pour vérifier que le paramètre wallet_root est activé.

Q : Puis-je activer wallet_root sans redémarrer la base de données ?

R : Non, la base de données doit être redémarrée pour que la modification prenne effet. Vous pouvez choisir entre un redémarrage non simultané ou un redémarrage complet.

Q : Quelle est la différence entre un redémarrage non simultané et un redémarrage complet de la base de données ?

R : Un redémarrage non simultané redémarre la base de données une instance à la fois, ce qui permet à la base de données de rester partiellement disponible pendant l'opération. Un redémarrage complet arrête et redémarre l'ensemble de la base de données, ce qui entraîne un temps d'inactivité complet.

Q : Puis-je exécuter cette commande pour plusieurs bases de données simultanément ?

R : Vous devez exécuter la commande dbaascli tde enableWalletRoot séparément pour chaque base de données sur laquelle activer wallet_root.

Q : Comment l'activation de wallet_root affecte-t-elle la configuration de fichier de clés TDE existante ?

R : L'activation de wallet_root met à jour l'emplacement du fichier de clés TDE vers le nouveau répertoire racine de portefeuille, ce qui facilite la gestion de plusieurs fichiers de clés et portefeuilles dans les bases de données Oracle.

Exemple 7-44 dbaascli tde enableWalletRoot

dbaascli tde enableWalletRoot --dbname db name --dbrestart rolling|full
dbaascli tde enableWalletRoot --dbname orcl
dbaascli tde enableWalletRoot --dbname orcl--dbrestart full
dbaascli tde encryptTablespacesInPDB

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

Prérequis

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

Syntaxe

dbaascli tde encryptTablespacesInPDB --dbname <value> --pdbName <value>
[--executePrereqs]
Où :
  • --pdbName indique le nom de la base de données pluggable pour le cryptage de tous les tablespaces.
  • --dbname indique le nom de la base de données Oracle.
  • --executePrereqs exécute les vérifications de prérequis et signale les résultats.

FAQ

Q : Que fait la commande dbaascli tde encryptTablespacesInPDB ?

R : la commande dbaascli tde encryptTablespacesInPDB crypte tous les tablespaces de la base de données pluggable indiquée pour une instance Oracle Database sur Exadata Cloud@Customer.

Q : Qui doit exécuter la commande dbaascli tde encryptTablespacesInPDB ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Sur quel ordinateur dois-je exécuter la commande dbaascli tde encryptTablespacesInPDB ?

R : Vous devez vous connecter à une machine virtuelle Exadata Cloud@Customer à l'aide de SSH pour exécuter cette commande.

Q : Où puis-je trouver des instructions pour me connecter à la machine virtuelle ?

R : Pour obtenir des instructions de connexion, reportez-vous au guide "Connexion à une machine virtuelle avec SSH".

Q : Que précise l'option --pdbName ?

R : L'option --pdbName indique le nom de la base de données pluggable dont les tablespaces doivent être cryptés.

Q : Que fait l'option --dbname ?

R : L'option --dbname vous permet d'indiquer le nom de l'instance Oracle Database à laquelle la base de données pluggable appartient.

Q : Que fait l'option --precheckOnly ?

R : L'option --precheckOnly exécute une prévérification de l'opération de cryptage sans apporter de modifications réelles. Les valeurs valides sont yes et no.

Q : Que fait l'option --useSysdbaCredential ?

R : L'option --useSysdbaCredential indique si les informations d'identification SYSDBA doivent être utilisées pour l'opération. Les valeurs valides sont True ou False.

Q : Pouvez-vous donner un exemple de cryptage des tablespaces dans une base pluggable spécifique ?

R : Voici un exemple de cryptage de tous les tablespaces d'une base de données pluggable nommée mypdb :

dbaascli tde encryptTablespacesInPDB --pdbName mypdb

Q : Comment crypter les tablespaces dans une base de données pluggable spécifique au sein d'une base de données ?

R : Utilisez la commande suivante pour indiquer à la fois la base de données pluggable et la base de données :

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --dbname mydatabase

Q : Comment exécuter une prévérification sans effectuer le chiffrement ?

R : Vous pouvez exécuter une prévérification uniquement à l'aide de la syntaxe suivante :

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --precheckOnly yes

Q : Comment utiliser les informations d'identification SYSDBA pour crypter les tablespaces ?

R : Vous pouvez utiliser les informations d'identification SYSDBA en ajoutant l'option --useSysdbaCredential true :

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --useSysdbaCredential true

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

R : vous devez exécuter la commande en tant qu'utilisateur root et avoir accès à la machine virtuelle Exadata Cloud@Customer.

Q : Dois-je redémarrer la base de données pour crypter les tablespaces ?

R : Non, la commande ne nécessite pas de redémarrage de la base de données. Le cryptage est effectué lorsque la base de données est en ligne.

Q : Ai-je besoin d'informations d'identification SYSDBA pour crypter les tablespaces ?

R : Vous pouvez avoir besoin d'informations d'identification SYSDBA pour cette opération si elle est indiquée à l'aide de l'option --useSysdbaCredential.

Q : Que faire en cas d'échec de la commande ?

R : Assurez-vous que vous exécutez la commande en tant qu'utilisateur root et vérifiez que le nom de la base de données pluggable (--pdbName) et le nom de la base de données (--dbname) sont corrects. Vous pouvez également exécuter la commande avec --precheckOnly yes pour rechercher les problèmes avant d'exécuter le cryptage complet.

Q : Que dois-je faire en cas d'échec du cryptage des tablespaces ?

R : Consultez les journaux de base de données et assurez-vous que vous disposez des privilèges et des ressources nécessaires pour effectuer le cryptage. Vous devrez peut-être également vérifier qu'il y a suffisamment d'espace pour gérer le processus de chiffrement.

Q : Comment vérifier si les tablespaces d'une base de données pluggable sont cryptés ?

R : Vous pouvez interroger les vues de base de données liées au cryptage, telles que V$ENCRYPTED_TABLESPACES, afin de vérifier si les tablespaces ont été cryptés.

Q : Comment puis-je vérifier si la prévérification a réussi ?

R : Si vous avez exécuté la commande avec --precheckOnly yes, vous pouvez rechercher dans la sortie tous les avertissements ou erreurs indiquant des problèmes potentiels avec le processus de cryptage.

Q : Puis-je crypter simultanément les tablespaces pour plusieurs bases pluggables ?

R : Non. Vous devez exécuter la commande dbaascli tde encryptTablespacesInPDB séparément pour chaque base de données pluggable.

Q : Puis-je crypter partiellement certains tablespaces d'une base pluggable ?

R : Non. Cette commande crypte tous les tablespaces au sein de la base de données pluggable indiquée. Pour le cryptage partiel, vous devez utiliser différentes commandes de gestion de base de données.

Q : Le cryptage des tablespaces a-t-il une incidence sur les performances de la base de données ?

R : Le cryptage des tablespaces peut avoir un impact temporaire sur les performances lors du processus de cryptage. Cependant, l'impact doit être minime une fois le chiffrement terminé.

Q : Puis-je annuler le cryptage des tablespaces ?

R : Non. Une fois les tablespaces cryptés, le cryptage ne peut pas être annulé. Vous pouvez uniquement effectuer une rotation ou recrypter les clés si nécessaire.

Q : Que se passe-t-il si l'opération est interrompue pendant le processus de chiffrement ?

R : Si l'opération est interrompue, vous devrez peut-être réexécuter la commande. Le système reprend le chiffrement là où il s'est arrêté et vous pouvez vérifier le statut à l'aide des vues de base de données.

Exemple 7-45 dbaascli tde encryptTablespacesInPDB

dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb
dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb --executePrereqs 
dbaascli tde fileToHsm

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

Prérequis

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

Syntaxe

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

FAQ

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

R : La commande dbaascli tde fileToHsm permet de convertir un cryptage transparent des données (TDE) basé sur un fichier en cryptage transparent des données basé sur un module de sécurité matériel (HSM), tel que KMS ou OKV, dans un environnement Oracle Database Cloud Service.

Q : Qui peut exécuter la commande dbaascli tde fileToHsm ?

R : La commande doit être exécutée en tant qu'utilisateur root.

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

R : Le paramètre --kmsKeyOCID indique l'OCID de clé KMS qui sera utilisé pour le cryptage TDE lors du passage d'un cryptage TDE basé sur des fichiers à un cryptage TDE basé sur HSM.

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

R : Le paramètre --dbname indique le nom de la base de données pour laquelle vous convertissez le cryptage transparent des données de type fichier vers HSM.

Q : Puis-je ignorer la vérification de validation de patch lors de la conversion de TDE ?

R : Oui. En utilisant le paramètre --skipPatchCheck avec la valeur true, vous pouvez ignorer la vérification de validation pour les patches requis.

Q : A quoi sert le paramètre --executePrereqs ?

R : Le paramètre --executePrereqs vous permet d'exécuter uniquement les prévérifications pour le processus de conversion TDE sans effectuer la conversion réelle. Les valeurs valides sont yes et no.

Q : Que fait le paramètre --primarySuc dans une configuration Data Guard ?

R : Le paramètre --primarySuc est utilisé dans un environnement Data Guard pour indiquer que la commande a été exécutée sur la base de données principale. Elle doit être indiquée sur la base de données de secours une fois la conversion principale terminée.

Q : Comment reprendre une conversion TDE précédente ?

R : Vous pouvez reprendre une conversion TDE précédemment incomplète à l'aide du paramètre --resume. Vous pouvez éventuellement indiquer un ID de session spécifique avec --sessionID.

Q : Comment rétablir une conversion TDE ?

R : Pour rétablir une conversion TDE précédente, utilisez le paramètre --revert. Vous pouvez également indiquer l'ID de session spécifique à rétablir à l'aide de --sessionID.

Q : Comment spécifier un ID de session lors de la reprise ou de l'annulation d'une conversion TDE ?

R : Vous pouvez utiliser le paramètre --sessionID pour indiquer l'ID de la session à reprendre ou à rétablir. Exemple : --resume --sessionID <ID> ou --revert --sessionID <ID>.

Q : Que se passe-t-il si j'affecte la valeur False à --waitForCompletion ?

R : Si vous définissez --waitForCompletion sur false, le processus de conversion TDE est exécuté en arrière-plan et l'invite de commande est renvoyée immédiatement. Si elle est définie sur true, la commande attend la fin du processus avant de renvoyer le contrôle à l'utilisateur.

Q : Quelles sont les valeurs valides pour le paramètre --waitForCompletion ?

R : Les valeurs valides sont true ou false. Si vous lui affectez la valeur True, la commande attend la fin du processus. Si vous lui affectez la valeur false, le processus est exécuté en arrière-plan.

Q : Puis-je exécuter dbaascli TDE fileToHsm sans convertir le cryptage transparent des données immédiatement ?

R : Oui. Vous pouvez utiliser le paramètre --executePrereqs yes pour effectuer uniquement les prévérifications de la conversion, sans apporter de modification au cryptage transparent des données.

Q : Dans un environnement Data Guard, comment gérer la base de données de secours après la conversion de TDE sur la base principale ?

R : une fois la conversion exécutée sur la base de données principale, vous devez indiquer --primarySuc lors de l'exécution de la commande sur la base de données de secours.

Q : Que dois-je faire en cas d'échec du processus de conversion TDE ?

R : Si le processus échoue, vous pouvez utiliser le paramètre --resume pour essayer de reprendre là où il s'est arrêté. Si nécessaire, vous pouvez utiliser le paramètre --revert pour annuler les modifications apportées au cours de la session ayant échoué.

Exemple 7-46 dbaascli tde fileToHsm --kmsKeyOCID

dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs 
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --resume
dbaascli tde getHsmKeys

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

Prérequis

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

Syntaxe

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

FAQ

Q : Que fait la commande dbaascli tde getHsmKeys ?

R : La commande dbaascli tde getHsmKeys extrait les détails des clés TDE (Transparent Data Encryption) actives à partir du module de sécurité HSM (Hardware Security Module) pour une base de données spécifiée.

Q : Qui doit exécuter la commande dbaascli tde getHsmKeys ?

R : La commande doit être exécutée en tant qu'utilisateur root.

Q : Sur quel ordinateur dois-je exécuter la commande dbaascli tde getHsmKeys ?

R : Vous devez vous connecter à une machine virtuelle Exadata Cloud@Customer à l'aide de SSH pour exécuter cette commande.

Q : Où puis-je trouver des instructions pour me connecter à la machine virtuelle ?

R : Pour obtenir des instructions sur la connexion, reportez-vous au guide "Connecting to a Virtual Machine with SSH".

Q : Que fait l'option --dbname ?

R : L'option --dbname vous permet d'indiquer le nom de l'instance Oracle Database pour laquelle extraire les détails de clé TDE.

Q : Que fait l'option --infoFile ?

R : L'option --infoFile indique le chemin du fichier dans lequel la liste des OCID de clé (identificateurs Oracle Cloud) sera enregistrée. La sortie est au format JSON.

Q : Pouvez-vous donner un exemple d'extraction des détails de clé TDE pour une base de données spécifique ?

R : Voici un exemple d'obtention des détails de clé TDE pour une base de données nommée mydatabase :

dbaascli tde getHsmKeys --dbname mydatabase

Q : Comment enregistrer les détails de la clé TDE dans un fichier ?

R : Vous pouvez indiquer un chemin de fichier à l'aide de l'option --infoFile pour enregistrer la sortie au format JSON :

dbaascli tde getHsmKeys --dbname mydatabase --infoFile /path/to/output.json

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

R : Vous devez exécuter la commande en tant qu'utilisateur root et être connecté à la machine virtuelle Exadata Cloud@Customer.

Q : Ai-je besoin d'informations d'identification SYSDBA pour extraire les détails de clé TDE ?

R : Non. Les informations d'identification SYSDBA ne sont pas requises pour exécuter la commande dbaascli tde getHsmKeys.

Q : Dans quel format les informations de clé TDE sont-elles enregistrées lors de l'utilisation de l'option --infoFile ?

R : La sortie est enregistrée au format JSON.

Q : Quelles informations sont incluses dans les détails de clé TDE ?

R : Les détails incluent les OCID de clé et d'autres métadonnées sur les clés de cryptage actives stockées dans le module HSM pour la base de données indiquée.

Q : Que dois-je faire si la commande ne parvient pas à récupérer les détails de la clé ?

R : Assurez-vous que vous exécutez la commande en tant qu'utilisateur root et que le nom de la base de données (--dbname) est correct. Vérifiez votre connexion à la machine virtuelle Exadata Cloud@Customer.

Q : Comment puis-je vérifier si le fichier de sortie a été créé avec succès ?

R : Vous pouvez vérifier le chemin de fichier indiqué pour le fichier JSON de sortie. Si le fichier est manquant, vérifiez que le chemin du fichier est correct et que vous disposez des droits d'accès en écriture sur le répertoire.

Q : Que dois-je faire si le fichier de sortie est vide ?

R : assurez-vous que la base de données indiquée contient des clés TDE actives et que le paramètre --dbname est correct. Vous devrez peut-être également vérifier s'il existe des erreurs dans les journaux de base de données.

Q : Puis-je extraire les détails de clé TDE pour plusieurs bases de données à la fois ?

R : Non. Vous devez exécuter la commande dbaascli tde getHsmKeys séparément pour chaque base de données.

Q : Comment puis-je utiliser le fichier de sortie de l'option --infoFile dans d'autres opérations ?

R : Comme la sortie est au format JSON, vous pouvez analyser le fichier par programmation ou l'utiliser comme entrée pour d'autres tâches de gestion de base de données ou de cryptage.

Q : Puis-je obtenir des détails de clé TDE historiques à l'aide de cette commande ?

R : Non, la commande extrait uniquement les détails des clés actuellement actives dans le HSM.

Q : Comment puis-je vérifier que les clés récupérées sont correctes ?

R : Vous pouvez vérifier les clés en les référençant à l'aide de la console Oracle Cloud Infrastructure (OCI) ou à l'aide de vues de base de données liées à la gestion du cryptage.

Exemple 7-47 dbaascli tde getHsmKeys

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

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

Prérequis

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

Syntaxe

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

FAQ

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

R : La commande dbaascli tde getMkidForKeyVersionOCID extrait l'ID de clé maître (MKID) associé à un OCID de version de clé KMS spécifique dans les environnements Oracle Database Cloud Service.

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

A : Vous devez :
  • Exécutez la commande en tant qu'utilisateur root.
  • Connectez-vous à une machine virtuelle Exadata Cloud@Customer via SSH.

Q : Qui peut exécuter la commande dbaascli tde getMkidForKeyVersionOCID ?

R : seul l'utilisateur root peut exécuter cette commande.

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

R : Le paramètre --kmsKeyVersionOCID indique l'OCID de version de clé KMS pour lequel vous voulez extraire l'ID de clé maître (MKID) associé.

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

R : Le paramètre --dbname indique le nom de la base de données pour laquelle l'OCID de version de clé KMS est interrogé.

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

R : Non, le paramètre --dbname est facultatif. Si vous n'indiquez pas de nom de base de données, la commande extrait le MKID de la base de données par défaut sur le système.

Q : Que dois-je faire si je ne connais pas l'OCID de version de clé KMS ?

R : Vous devez extraire l'OCID de version de clé KMS à partir de votre console de gestion KMS ou de votre fournisseur de services avant d'utiliser cette commande. Sans elle, la commande ne peut pas récupérer l'ID de clé maître (MKID).

Q : Puis-je exécuter cette commande sur un environnement non Exadata Cloud@Customer ?

R : Non. Cette commande est spécifiquement destinée à être utilisée dans un environnement Exadata Cloud@Customer et vous devez vous connecter à une machine virtuelle à l'aide de SSH pour l'exécuter.

Q : Que se passe-t-il si j'exécute la commande sans indiquer de nom de base de données à l'aide de --dbname ?

R : Si le paramètre --dbname n'est pas fourni, la commande tente d'extraire le MKID de la base de données par défaut configurée sur le système.

Q : Que dois-je faire en cas d'erreur lors de la récupération du MKID ?

A : Assurez-vous que :
  • Vous exécutez la commande en tant qu'utilisateur root.
  • Vous êtes correctement connecté à la machine virtuelle Exadata Cloud@Customer.
  • L'OCID de version de clé KMS que vous avez indiqué est valide. Si l'erreur persiste, consultez les journaux système pour plus de détails.

Q : Comment me connecter à la machine virtuelle Exadata Cloud@Customer ?

R : Vous pouvez vous connecter à la machine virtuelle via SSH. Reportez-vous à la documentation Exadata Cloud@Customer pour connaître les étapes de connexion sécurisée.

Exemple 7-48 dbaascli tde getMkidForKeyVersionOCID

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

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

Prérequis

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

Syntaxe

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

FAQ

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

R : La commande dbaascli tde getPrimaryHsmKey extrait la clé du module de sécurité matériel (HSM) principal de la configuration HSM (KMS) existante dans un environnement Oracle Database.

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

A : Vous devez :
  • Exécutez la commande en tant qu'utilisateur root.
  • Connectez-vous à une machine virtuelle Exadata Cloud@Customer via SSH.

Q : Qui peut exécuter la commande dbaascli tde getPrimaryHsmKey ?

R : seul l'utilisateur root peut exécuter cette commande.

Q : Que spécifie le paramètre --dbname dans cette commande ?

R : Le paramètre --dbname indique le nom de la base de données pour laquelle vous voulez extraire la clé HSM principale.

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

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

Q : Que dois-je faire si je ne spécifie pas de nom de base de données avec --dbname ?

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

Q : Puis-je exécuter cette commande sur un environnement non Exadata Cloud@Customer ?

R : Non. Cette commande est conçue spécifiquement pour être utilisée dans un environnement Exadata Cloud@Customer et vous devez être connecté à la machine virtuelle à l'aide de SSH pour l'exécuter.

Q : Comment puis-je me connecter à la machine virtuelle Exadata Cloud@Customer pour exécuter la commande ?

R : Vous pouvez vous connecter à la machine virtuelle via SSH. Pour obtenir des instructions sur la connexion sécurisée, reportez-vous à la documentation Exadata Cloud@Customer.

Q : Que dois-je vérifier si une erreur s'est produite lors de l'extraction de la clé HSM principale ?

R : Si vous rencontrez une erreur, assurez-vous que :
  • Vous exécutez la commande en tant qu'utilisateur root.
  • Vous êtes correctement connecté à la machine virtuelle Exadata Cloud@Customer.
  • Le nom de la base de données (le cas échéant) est valide. Si le problème persiste, consultez les journaux système ou les messages d'erreur pour plus de détails.

Q : Dois-je arrêter la base de données pour exécuter la commande dbaascli tde getPrimaryHsmKey ?

R : Non, la base de données n'a pas besoin d'être arrêtée pour exécuter cette commande. Vous pouvez l'exécuter pendant que la base de données s'exécute.

Q : Quel est le but de l'extraction de la clé HSM principale ?

R : L'extraction de la clé HSM principale vous permet d'identifier la clé HSM actuelle utilisée pour le chiffrement dans la configuration HSM (KMS) existante de la base de données.

Exemple 7-49 dbaascli tde getPrimaryHsmKey

dbaascli tde getPrimaryHsmKey --dbname dbname
dbaascli tde hsmToFile

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

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

Syntaxe

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

FAQ

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

R : La commande dbaascli tde hsmToFile permet de convertir un cryptage transparent des données (TDE) basé sur un module de sécurité HSM en cryptage transparent des données basé sur des fichiers dans les environnements Oracle Database Cloud Service.

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

A : Vous devez :
  • Exécutez la commande en tant qu'utilisateur root.
  • Assurez-vous que vous disposez des droits d'accès et des configurations nécessaires définis dans l'environnement de base de données.

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

R : Le paramètre --dbname indique le nom de la base de données pour laquelle vous convertissez TDE de HSM en fichier.

Q : Quand le paramètre --primaryDBWalletTar est-il requis ?

R : le paramètre --primaryDBWalletTar est requis uniquement lors de l'exécution de la conversion hsmToFile sur une base de données de secours. Il indique le fichier tar du portefeuille de la base de données principale.

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

R : Le paramètre --skipPatchCheck vous permet d'ignorer la vérification de validation pour les patches requis. Définissez cette option sur true pour ignorer la vérification ou sur false pour l'appliquer.

Q : Comment exécuter uniquement des pré-vérifications pour le processus de conversion sans effectuer la conversion réelle ?

R : Vous pouvez utiliser le paramètre --executePrereqs et le définir sur yes pour exécuter uniquement les prévérifications. Définissez-le sur no pour effectuer la conversion complète.

Q : Que fait le paramètre --primarySuc dans un environnement Data Guard ?

R : Le paramètre --primarySuc est utilisé dans une configuration Data Guard pour indiquer que la conversion a été exécutée avec succès sur la base de données principale. Il doit être utilisé lors de l'exécution de la conversion sur la base de données de secours.

Q : Comment puis-je reprendre une conversion hsmToFile précédente ?

R : Vous pouvez reprendre une conversion précédente à l'aide du paramètre --resume. Vous pouvez éventuellement indiquer l'ID de session de l'exécution précédente avec --sessionID.

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

R : Le paramètre --revert est utilisé pour annuler un processus de conversion lancé précédemment en cas d'échec ou si vous devez annuler l'opération.

Q : Que se passe-t-il si j'affecte la valeur False à --waitForCompletion ?

R : Si vous définissez --waitForCompletion sur false, l'opération sera exécutée en arrière-plan, ce qui vous permettra de poursuivre d'autres tâches. Si elle est définie sur true, la commande attend la fin du processus avant de renvoyer le contrôle à l'utilisateur.

Q : Que dois-je faire si je dois convertir le cryptage transparent des données dans une base de données de secours dans une configuration Data Guard ?

R : dans une configuration Data Guard, après la conversion du cryptage transparent des données sur la base de données principale, vous devez exécuter la commande sur la base de données de secours à l'aide du paramètre --primaryDBWalletTar, en indiquant le fichier tar de portefeuille à partir de la base de données principale et en incluant --primarySuc.

Q : Que dois-je faire si je veux ignorer la vérification des patches requis pendant la conversion ?

R : Vous pouvez ignorer la vérification de patch en utilisant le paramètre --skipPatchCheck et en le définissant sur true.

Q : Comment vérifier si le système est prêt pour la conversion hsmToFile sans apporter de modifications ?

R : Vous pouvez effectuer uniquement les prévérifications à l'aide du paramètre --executePrereqs et en le définissant sur yes.

Q : Que dois-je faire si le processus de conversion est interrompu ?

R : Vous pouvez utiliser le paramètre --resume pour redémarrer le processus là où il s'est arrêté. Vous pouvez éventuellement indiquer un ID de session particulier avec --sessionID.

Q : Que dois-je faire si le processus de conversion échoue ?

R : Si la conversion échoue, vous pouvez annuler le processus à l'aide du paramètre --revert. En outre, consultez les messages d'erreur et consultez les journaux système pour plus de détails.

Q : Puis-je exécuter la commande dbaascli tde hsmToFile sur un environnement non Exadata ?

R : Cette commande est conçue pour être utilisée dans les environnements Exadata Cloud@Customer. Si vous n'utilisez pas Exadata, assurez-vous que vous êtes dans un environnement pris en charge pour que la commande fonctionne correctement.

Exemple 7-50 dbaascli tde hsmToFile

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

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

Prérequis

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

Syntaxe

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

FAQ

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

R : La commande dbaascli tde listKeys permet de répertorier toutes les clés maître de cryptage transparent des données (TDE) pour une base de données indiquée dans un environnement Oracle Database.

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

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

Q : Que fait le paramètre --file dans la commande dbaascli tde listKeys ?

R : Le paramètre --file indique le chemin du fichier dans lequel la liste des clés maître TDE doit être enregistrée. Si ce paramètre n'est pas fourni, les résultats seront affichés directement dans le terminal.

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

R : Le paramètre --dbname indique le nom de la base de données pour laquelle vous voulez répertorier les clés maître TDE.

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

R : Non, le paramètre --file est facultatif. Si elle n'est pas fournie, la liste des clés TDE sera affichée dans la sortie du terminal au lieu d'être enregistrée dans un fichier.

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

R : Non, le paramètre --dbname est facultatif. Si elle n'est pas indiquée, la commande répertorie les clés maître TDE pour la base de données par défaut configurée sur le système.

Q : Que dois-je faire si je veux enregistrer la liste des clés dans un fichier ?

R : Vous devez fournir le paramètre --file avec le chemin de fichier souhaité. Par exemple :

dbaascli tde listKeys --file /path/to/output.txt

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

R : si le paramètre --dbname n'est pas fourni, la commande répertorie les clés maître TDE pour la base de données par défaut sur le système.

Q : Puis-je utiliser cette commande dans des environnements autres qu'Exadata Cloud@Customer ?

R : Cette commande est conçue spécifiquement pour les environnements Exadata Cloud@Customer. Assurez-vous que vous êtes connecté à la machine virtuelle appropriée pour l'exécuter.

Q : Que dois-je faire si la commande ne parvient pas à répertorier les clés ?

A : Assurez-vous que :
  • Vous exécutez la commande en tant qu'utilisateur root.
  • Vous êtes connecté à la machine virtuelle Exadata Cloud@Customer.
  • Le nom de base de données (le cas échéant) est correct. Consultez les messages d'erreur et les journaux pour plus de détails sur l'échec.

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

R : Oui, la commande peut être exécutée pendant l'exécution de la base de données. Il répertorie simplement les clés maître TDE et ne modifie pas l'état de la base de données.

Q : Ai-je besoin d'autorisations spéciales pour exécuter cette commande ?

R : vous devez exécuter cette commande en tant qu'utilisateur root. Sans les autorisations root, vous ne pourrez pas exécuter la commande.

Q : A quoi sert la liste des clés maître TDE ?

R : La liste des clés maître TDE vous permet de vérifier les clés de cryptage utilisées pour protéger les données de votre base de données. Il est essentiel pour surveiller et gérer les paramètres de chiffrement.

Q : Comment puis-je me connecter à la machine virtuelle Exadata Cloud@Customer pour exécuter la commande ?

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

Exemple 7-51 dbaascli tde listKeys

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

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

Prérequis

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

Syntaxe

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

FAQ

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

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

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

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

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

R : Le paramètre --force permet de supprimer la clé HSM secondaire sans inviter l'utilisateur à confirmer. S'il n'est pas spécifié, la commande invite l'utilisateur avant de supprimer des clés.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Q : Comment puis-je me connecter à la machine virtuelle Exadata Cloud@Customer pour exécuter la commande ?

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

Exemple 7-52 dbaascli tde removeSecondaryHsmKey

dbaascli tde removeSecondaryHsmKey --dbname dbname
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs 
dbaascli tde rotateMasterKey

Afin d'effectuer la rotation de la clé maître pour le cryptage de base de données, utilisez la commande dbaascli tde rotateMasterKey.

Prérequis :

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

Syntaxe

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

FAQ

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

R : La commande dbaascli tde rotateMasterKey est utilisée pour effectuer la rotation de la clé maître utilisée pour le cryptage transparent des données (TDE) dans Oracle Database. Ce processus garantit que les clés de cryptage sont mises à jour pour une meilleure sécurité.

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

A : Vous devez :
  • Exécutez la commande en tant qu'utilisateur root.
  • Assurez-vous que la base de données est configurée correctement pour TDE.

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

R : le paramètre --dbname indique le nom de l'instance Oracle Database pour laquelle vous voulez effectuer la rotation de la clé de cryptage maître.

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

R : le paramètre --rotateMasterKeyOnAllPDBs indique s'il faut effectuer la rotation de la clé maître pour toutes les bases de données pluggables dans une base de données Conteneur. Les valeurs valides sont True ou False.

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

R : Le paramètre --pdbName indique le nom d'une base de données pluggable spécifique si vous voulez effectuer une rotation de la clé maître pour une base de données pluggable spécifique plutôt que pour toutes les bases de données pluggables.

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

R : Le paramètre --executePrereqs exécute des vérifications de prérequis pour vérifier que l'environnement est prêt pour la rotation de la clé maître sans effectuer la rotation réelle.

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

R : Le paramètre --resume est utilisé pour reprendre une opération précédemment démarrée. Vous pouvez également fournir un ID de session spécifique à l'aide de --sessionID pour reprendre une session particulière.

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

R : Le paramètre --prepareStandbyBlob, s'il est défini sur True, génère un fichier BLOB contenant les artefacts nécessaires à la rotation de la clé maître dans un environnement Data Guard.

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

R : Le paramètre --blobLocation indique un chemin de répertoire personnalisé où le fichier BLOB de secours sera généré. Cela est applicable lorsque --prepareStandbyBlob est défini sur true.

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

R : le paramètre --standbyBlobFromPrimary indique l'emplacement du fichier BLOB de secours généré à partir de la base de données principale. Ce paramètre est utilisé lors de la rotation de la clé maître sur une base de données de secours dans un environnement Data Guard.

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

R : Non, le paramètre --rotateMasterKeyOnAllPDBs est facultatif. S'il n'est pas indiqué, la clé maître est modifiée uniquement pour la base de données (ou pour une base de données pluggable spécifique) fournie dans les paramètres --dbname ou --pdbName.

Q : Le paramètre --pdbName est-il requis si je fais tourner des clés pour une base de données Conteneur ?

R : Non. Le paramètre --pdbName est requis uniquement si vous voulez effectuer la rotation de la clé maître pour une base de données pluggable spécifique. Elle est facultative lors de la rotation de la clé pour l'ensemble de la base de données Conteneur.

Q : Dois-je utiliser les paramètres --prepareStandbyBlob et --standbyBlobFromPrimary pour les bases de données autonomes ?

R : Non. Ces paramètres ne sont pertinents que dans un environnement Data Guard dans lequel une base de données de secours est impliquée.

Q : Comment effectuer la rotation de la clé maître pour toutes les bases de données pluggables d'une base de données Conteneur ?

R : Vous devez utiliser le paramètre --rotateMasterKeyOnAllPDBs défini sur True pour effectuer la rotation de la clé maître pour toutes les bases de données pluggables de la base de données Conteneur. Par exemple :

dbaascli tde rotateMasterKey --dbname CDB_NAME --rotateMasterKeyOnAllPDBs true

Q : Comment exécuter une vérification pour vérifier que le système est prêt pour la rotation de la clé principale sans effectuer l'opération réelle ?

R : Vous pouvez utiliser le paramètre --executePrereqs pour exécuter les vérifications de prérequis. Cela permet de signaler tout problème susceptible d'empêcher la rotation de la clé principale :

dbaascli tde rotateMasterKey --dbname DB_NAME --executePrereqs

Q : Que dois-je faire si l'opération a été interrompue et que je veux la reprendre ?

R : Vous pouvez utiliser le paramètre --resume pour reprendre l'opération interrompue précédemment. Si vous disposez d'un ID de session, indiquez-lui le paramètre --sessionID :

dbaascli tde rotateMasterKey --dbname DB_NAME --resume --sessionID <value>

Q : Comment préparer la rotation des clés dans un environnement Data Guard ?

R : Vous devez utiliser le paramètre --prepareStandbyBlob pour générer un fichier BLOB contenant les artefacts requis pour la rotation de la clé maître dans un environnement de secours :

dbaascli tde rotateMasterKey --dbname DB_NAME --prepareStandbyBlob true --blobLocation /path/to/blob

Q : Comment appliquer le fichier BLOB de secours à partir de la base de données principale lors de la rotation de clés sur une base de données de secours ?

R : Utilisez le paramètre --standbyBlobFromPrimary pour indiquer l'emplacement du fichier BLOB préparé sur la base de données principale :

dbaascli tde rotateMasterKey --dbname DB_NAME --standbyBlobFromPrimary /path/to/blob

Q : Que dois-je vérifier si la rotation de la clé principale échoue ?

A : Assurez-vous que :
  • Vous exécutez la commande en tant qu'utilisateur root.
  • Le nom de la base de données (--dbname) est correct.
  • Toutes les vérifications de prérequis ont été exécutées à l'aide de --executePrereqs pour garantir la préparation. Consultez les journaux d'erreurs pour obtenir des informations plus détaillées sur l'échec.

Q : Que dois-je faire en cas d'échec de l'opération dans un environnement Data Guard ?

R : assurez-vous que le fichier BLOB de la base de données principale a été préparé correctement à l'aide de --prepareStandbyBlob, puis utilisez --standbyBlobFromPrimary pour l'appliquer à la base de données de secours.

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

R : Oui, la commande peut être exécutée pendant l'exécution de la base de données. Toutefois, il est recommandé d'exécuter les vérifications de prérequis au préalable à l'aide de l'option --executePrereqs.

Q : Pourquoi la rotation de la clé principale est-elle importante ?

R : La rotation de la clé maître améliore la sécurité de la base de données en veillant à ce que les clés de cryptage utilisées pour la protection des données soient régulièrement mises à jour, ce qui réduit le risque de compromission de la clé.

Q : Dois-je redémarrer la base de données après la rotation de la clé maître ?

R : Non. Le redémarrage de la base de données n'est pas nécessaire après la rotation de la clé maître. La rotation des clés prendra effet immédiatement sans interruption de service.

dbaascli tde setKeyVersion

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

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

Syntaxe

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

FAQ

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

R : la commande dbaascli tde setKeyVersion permet de définir la version de la clé de cryptage principale à utiliser pour le cryptage transparent des données (TDE) dans une base de données ou une base de données pluggable. Cela permet d'affecter la version spécifique d'une clé KMS à la base de données.

Q : Quels sont les prérequis pour utiliser la commande dbaascli tde setKeyVersion ?

R : Vous devez exécuter la commande en tant qu'utilisateur root et vous assurer que vous êtes connecté à une machine virtuelle Exadata Cloud@Customer.

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

R : Le paramètre --kmsKeyVersionOCID indique l'OCID de version de clé KMS (identificateur Oracle Cloud) à définir pour la base de données ou la base de données pluggable.

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

R : Le paramètre --dbname indique le nom de l'instance Oracle Database pour laquelle la version de clé sera définie.

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

R : Le paramètre --pdbName indique le nom de la base de données pluggable dans une base de données Conteneur où définir la version de clé KMS spécifique.

Q : A quoi sert le paramètre --masterKeyID ?

R : le paramètre --masterKeyID indique l'ID de clé maître associé à l'OCID de version de clé KMS donné. Cela est particulièrement important dans un environnement Data Guard.

Q : Quel est le rôle du paramètre --standbySuc ?

R : Le paramètre --standbySuc est utilisé dans un environnement Data Guard. Elle indique que cette propriété doit être définie sur la base de données principale une fois la commande exécutée sur la base de données de secours.

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

R : Le paramètre --executePrereqs indique si les vérifications de prérequis doivent être exécutées avant l'opération. Les valeurs valides sont yes et no.

Q : Que contrôle le paramètre --waitForCompletion ?

R : Le paramètre --waitForCompletion détermine si l'opération sera exécutée de manière synchrone (en attente de finalisation) ou asynchrone (en arrière-plan). Les valeurs valides sont true ou false.

Q : Le paramètre --pdbName est-il requis si vous définissez la version de clé d'une base de données Conteneur ?

R : Non. Le paramètre --pdbName est requis uniquement si vous définissez la version de clé d'une base de données pluggable spécifique. Elle est facultative si vous définissez la version de clé pour l'ensemble de la base de données Conteneur.

Q : Le paramètre --masterKeyID est-il nécessaire pour les environnements non Data Guard ?

R : Non. Le paramètre --masterKeyID est généralement utilisé uniquement dans les environnements Data Guard. Pour les bases de données autonomes, ce paramètre n'est pas requis.

Q : Comment définir la version de clé d'une base de données ?

R : Vous pouvez définir la version de clé d'une base de données en exécutant :

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME>

Q : Comment définir la version de clé d'une base de données pluggable spécifique ?

R : Pour définir la version de clé d'une base de données pluggable spécifique, utilisez le paramètre --pdbName avec le nom de la base de données :

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME> --pdbName <PDB_NAME>

Q : Comment puis-je m'assurer que tous les prérequis sont respectés avant de définir la version de clé ?

R : Vous pouvez exécuter les vérifications de prérequis à l'aide du paramètre --executePrereqs :

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --executePrereqs yes

Q : Comment définir la version de clé dans un environnement Data Guard ?

R : Dans un environnement Data Guard, vous devez :
  • Exécutez la commande sur la base de données de secours :

    dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --masterKeyID <keyID> --dbname <DB_NAME>

  • Une fois la commande exécutée sur la base de données de secours, exécutez-la sur la base de données principale à l'aide du paramètre --standbySuc :

    dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME> --standbySuc yes

Q : Comment puis-je exécuter l'opération en arrière-plan sans attendre qu'elle se termine ?

R : Vous pouvez exécuter l'opération de manière asynchrone en définissant --waitForCompletion sur false :

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --waitForCompletion false

Q : Que dois-je faire si la version de clé ne parvient pas à être définie ?

A : Assurez-vous que :
  • Vous exécutez la commande en tant qu'utilisateur root.
  • L'OCID de version de clé KMS est correct.
  • Toutes les vérifications de prérequis ont été exécutées à l'aide de --executePrereqs pour garantir la préparation. Consultez les journaux d'erreurs pour obtenir des détails spécifiques et réexécutez l'opération si nécessaire.

Q : Que dois-je vérifier si l'opération ne se termine pas correctement dans un environnement Data Guard ?

R : assurez-vous que le paramètre --masterKeyID est correctement indiqué lors de l'exécution de la commande sur la base de données de secours. Une fois terminé sur la base de données de secours, le paramètre --standbySuc doit être utilisé lors de l'exécution de la commande sur la base de données principale.

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

R : Oui, la commande peut être exécutée pendant l'exécution de la base de données. Toutefois, il est recommandé d'exécuter au préalable les vérifications de prérequis à l'aide de --executePrereqs.

Q : Pourquoi est-il important de définir la version de clé KMS correcte pour une base de données ?

R : La définition de la bonne version de clé KMS garantit que la base de données utilise la version de clé de cryptage appropriée pour TDE, ce qui permet de maintenir la sécurité des données et la conformité avec les stratégies organisationnelles.

Q : Que se passe-t-il si j'utilise le mauvais OCID de version de clé KMS ?

R : Si un OCID de version de clé KMS incorrect est utilisé, le cryptage peut échouer et la base de données ne pourra pas utiliser la clé incorrecte pour les opérations de cryptage. Vous devez vous assurer que l'OCID de version de clé correct est fourni.

Q : Dois-je redémarrer la base de données après avoir défini la version de la clé ?

R : Non. Le redémarrage de la base de données n'est pas nécessaire après la définition de la version de clé. La nouvelle version de clé prendra effet immédiatement sans nécessiter de redémarrage.

Exemple 7-53 dbaascli tde setKeyVersion

dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha --executePrereqs
dbaascli tde setKeyVersion --dbname dbname --pdbName pdb --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
dbaascli tde setPrimaryHsmKey

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

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

Syntaxe

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

FAQ

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

R : La commande dbaascli tde setPrimaryHsmKey permet de modifier la clé HSM (Hardware Security Module) ou KMS (Key Management Service) principale dans une configuration HSM/KMS existante pour le cryptage transparent des données (TDE).

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

R : la commande doit être exécutée en tant qu'utilisateur root et l'environnement doit être une machine virtuelle Exadata Cloud@Customer.

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

R : Le paramètre --primaryKmsKeyOCID indique l'OCID (identificateur Oracle Cloud) de la clé KMS principale à définir pour l'environnement TDE.

Q : Quelle est la fonction du paramètre --dbname ?

R : Le paramètre --dbname indique le nom de l'instance Oracle Database pour laquelle la clé HSM/KMS principale sera définie.

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

R : Le paramètre --standbySuc est utilisé dans un environnement Data Guard. Elle indique que la commande doit être exécutée sur la base de données principale après son exécution sur la base de données de secours.

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

R : Le paramètre --precheckOnly vous permet d'exécuter uniquement les prévérifications pour cette opération. Il valide l'environnement sans apporter de modifications réelles. Les valeurs valides sont yes et no.

Q : Que contrôle le paramètre --bounceDatabase ?

R : Le paramètre --bounceDatabase indique si la base de données doit être redémarrée (redémarrée) de manière non simultanée dans le cadre de l'opération. Cela garantit un temps d'inactivité minimal en redémarrant des parties de la base de données une par une.

Q : Comment définir la clé KMS principale de ma base de données ?

R : Pour définir la clé KMS principale, exécutez la commande suivante :

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME>

Q : Comment puis-je m'assurer que l'opération peut être exécutée sans aucun problème ?

R : exécutez l'opération avec le paramètre --precheckOnly pour vérifier que tous les prérequis sont respectés :

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --precheckOnly yes

Q : Comment définir la clé KMS principale dans un environnement Data Guard ?

R : Commencez par exécuter la commande sur la base de données de secours :

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME>

Exécutez ensuite la commande sur la base de données principale avec le paramètre --standbySuc :

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME> --standbySuc yes

Q : Comment réduire les temps d'arrêt lors de la modification de la clé KMS principale ?

R : Vous pouvez utiliser le paramètre --bounceDatabase pour effectuer un redémarrage non simultané, réduisant ainsi le temps d'inactivité :

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --bounceDatabase

Q : Le paramètre --dbname est-il requis pour toutes les bases de données ?

R : Oui. Vous devez indiquer le paramètre --dbname pour indiquer la base de données cible pour laquelle la clé KMS principale doit être définie.

Q : Est-il obligatoire d'utiliser le paramètre --standbySuc dans un environnement Data Guard ?

R : Oui. Le paramètre --standbySuc doit être utilisé lors de l'exécution de la commande sur la base de données principale après son exécution sur la base de données de secours.

Q : Puis-je ignorer l'opération de redémarrage pour la base de données ?

R : Oui. Si vous n'indiquez pas le paramètre --bounceDatabase, la base de données ne sera pas redémarrée (redémarrée) dans le cadre de l'opération.

Q : Que dois-je faire si la commande échoue pendant l'exécution ?

R : Si la commande échoue, assurez-vous :
  • Vous l'exécutez en tant qu'utilisateur root.
  • Les valeurs --primaryKmsKeyOCID et --dbname correctes sont fournies.
  • L'environnement réussit toutes les vérifications de prérequis (exécutées avec --precheckOnly).

Q : Que se passe-t-il si l'opération échoue dans un environnement Data Guard ?

R : Assurez-vous que la commande a bien été exécutée sur la base de données de secours avant de l'exécuter sur la base principale. Recherchez les erreurs dans les journaux et réexécutez l'opération avec les paramètres corrects.

Q : Puis-je exécuter la commande dbaascli tde setPrimaryHsmKey sur une base de données active ?

R : Oui, la commande peut être exécutée pendant que la base de données est active. Cependant, l'utilisation du paramètre --bounceDatabase redémarre la base de données de manière non simultanée, ce qui réduit l'impact.

Q : Comment exécuter la commande de manière non simultanée pour éviter un temps d'arrêt complet ?

R : Utilisez le paramètre --bounceDatabase pour effectuer un redémarrage non simultané de la base de données lors de la modification de la clé KMS principale :

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --bounceDatabase

Q : Quelle est la signification de la modification de la clé KMS principale ?

R : La modification de la clé KMS principale garantit que la base de données utilise une clé de cryptage TDE (Transparent Data Encryption) mise à jour ou différente. Cela peut être nécessaire pour des raisons de sécurité ou de conformité.

Q : À quelle fréquence la clé KMS principale doit-elle faire l'objet d'une rotation ou d'une modification ?

R : Bien qu'il n'existe pas de règle stricte, les organisations peuvent effectuer une rotation de la clé KMS principale en fonction des stratégies de sécurité, telles que les intervalles de rotation des clés ou les exigences de conformité.

Q : Que se passe-t-il si la clé KMS principale n'est pas correctement définie ?

R : Si l'OCID de clé incorrect est défini, les opérations de cryptage de base de données peuvent échouer et vous devrez peut-être rétablir la clé correcte ou rectifier la configuration en définissant l'OCID de clé KMS correct.

Q : Dois-je redémarrer la base de données après avoir modifié la clé KMS principale ?

R : Non. Vous n'avez pas besoin de redémarrer la base de données, sauf si vous choisissez d'utiliser le paramètre --bounceDatabase, qui redémarrera automatiquement la base de données pour appliquer la modification.

Exemple 7-54 dbaascli tde setPrimaryHsmKey

dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs
dbaascli tde status

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

Prérequis

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

Syntaxe

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

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

FAQ

Q : Que fait la commande dbaascli tde status ?

R : la commande dbaascli tde status affiche des informations sur le fichier de clés d'une base de données spécifiée. Cela inclut des détails sur le type de fichier de clés et son statut.

Q : Qui doit exécuter la commande dbaascli tde status ?

R : la commande doit être exécutée en tant qu'utilisateur oracle.

Q : Où la commande dbaascli tde status doit-elle être exécutée ?

R : la commande doit être exécutée sur une machine virtuelle Exadata Cloud@Customer. Vous devez vous connecter à la machine virtuelle via SSH pour exécuter l'utilitaire.

Q : Quelle est la fonction du paramètre --dbname ?

R : Le paramètre --dbname indique le nom de la base de données pour laquelle le statut du fichier de clés TDE sera vérifié.

Q : Quelles informations la commande dbaascli tde status renvoie-t-elle ?

R : La sortie de la commande inclut le type de fichier de clés (par exemple, basé sur HSM ou sur un fichier) et l'état actuel du fichier de clés, par exemple s'il est ouvert, fermé ou dans un autre état.

Q : Comment savoir si le fichier de clés d'accès est ouvert ou fermé à l'aide de la commande dbaascli tde status ?

R : le statut du fichier de clés, qu'il soit ouvert ou fermé, fait partie de la sortie renvoyée par la commande dbaascli tde status.

Q : Comment vérifier le statut du fichier de clés TDE pour une base de données spécifique ?

R : Pour vérifier le statut du fichier de clés TDE pour une base de données spécifique, exécutez la commande suivante :

dbaascli tde status --dbname <DB_NAME>

Q : Puis-je vérifier le statut du fichier de clés pour plusieurs bases de données ?

R : Oui, mais vous devez exécuter la commande séparément pour chaque base de données, en indiquant son nom à l'aide du paramètre --dbname.

Q : La commande dbaascli tde status peut-elle être exécutée en tant qu'utilisateur root ?

R : Non. La commande doit être exécutée en tant qu'utilisateur oracle, et non en tant qu'utilisateur root.

Q : Ai-je besoin de droits d'accès spéciaux pour exécuter la commande dbaascli tde status ?

R : Oui. Vous devez disposer des privilèges utilisateur oracle et être connecté à une machine virtuelle Exadata Cloud@Customer pour exécuter la commande.

Q : Que dois-je faire en cas d'erreur lors de l'exécution de la commande dbaascli tde status ?

R : assurez-vous que vous exécutez la commande en tant qu'utilisateur oracle, que vous disposez des droits d'accès nécessaires et que vous êtes connecté à la machine virtuelle appropriée.

Q : Comment savoir quel type de fichier de clés ma base de données utilise ?

R : Le type de fichier de clés, par exemple s'il est basé sur un fichier ou sur HSM/KMS, est affiché dans la sortie de la commande dbaascli tde status.

Q : Que faire si le keystore est fermé ?

R : Si le fichier de clés d'accès est fermé, vous devrez peut-être l'ouvrir manuellement, en fonction de l'opération que vous essayez d'effectuer. Le processus exact dépendra du type de fichier de clés et de votre environnement.

Q : Puis-je afficher le statut du fichier de clés pour une base de données Conteneur ou pluggable ?

R : Oui. En indiquant le nom de base de données approprié à l'aide du paramètre --dbname, vous pouvez visualiser le statut du fichier de clés pour les bases de données Conteneur et les bases de données pluggables.

Q : Qu'est-ce que cela signifie si la commande renvoie une erreur concernant la connectivité de la base de données ?

R : Cela peut indiquer un problème avec la connexion à la base de données ou un problème avec votre environnement. Assurez-vous que la base de données est en cours d'exécution et accessible, et vérifiez votre connexion SSH à la machine virtuelle Exadata Cloud@Customer.

Q : Que se passe-t-il si le nom de la base de données est incorrect ?

R : Si le paramètre --dbname indique une base de données incorrecte ou inexistante, la commande échoue et vous recevez un message d'erreur indiquant le problème.

Q : Comment puis-je dépanner si le statut du fichier de clés indique un état inattendu ?

R : Si le statut du fichier de clés indique un état inattendu, consultez les journaux de la base de données pour plus de détails et vérifiez la configuration du fichier de clés pour vous assurer qu'il est correctement configuré.

Q : Puis-je automatiser la vérification du statut du fichier de clés à des fins de surveillance ?

R : Oui. Vous pouvez scripter la commande dbaascli tde status pour vérifier périodiquement le statut du fichier de clés ou l'intégrer à vos outils de surveillance de base de données.

Q : Comment puis-je vérifier que le cryptage transparent des données (TDE) est correctement activé ?

R : Vous pouvez vérifier que TDE est correctement activé en vérifiant le statut du fichier de clés à l'aide de la commande dbaascli tde status. Un fichier de clés d'accès valide et ouvert indique que TDE est correctement configuré.

Exemple 7-55 dbaascli tde status

dbaascli tde status --dbname dbname

Commandes dbaascli en phase d'abandon

Les commandes dbaascli patch db prereq et dbaascli patch db apply sont en phase d'abandon dans dbaascli version 21.2.1.2.0, et remplacées par les commandes dbaascli grid patch, dbaascli dbhome patch et dbaascli database move.

dbaascli patch db apply
Remarque

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

Remarque

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

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

Prérequis

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

Syntaxe

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

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

FAQ

Q : Que fait la commande dbaascli tde status ?

R : la commande dbaascli tde status affiche des informations sur le fichier de clés d'une base de données spécifiée. Cela inclut des détails sur le type de fichier de clés et son statut.

Q : Qui doit exécuter la commande dbaascli tde status ?

R : la commande doit être exécutée en tant qu'utilisateur oracle.

Q : Où la commande dbaascli tde status doit-elle être exécutée ?

R : la commande doit être exécutée sur une machine virtuelle Exadata Cloud@Customer. Vous devez vous connecter à la machine virtuelle via SSH pour exécuter l'utilitaire.

Q : Quelle est la fonction du paramètre --dbname ?

R : Le paramètre --dbname indique le nom de la base de données pour laquelle le statut du fichier de clés TDE sera vérifié.

Q : Quelles informations la commande dbaascli tde status renvoie-t-elle ?

R : La sortie de la commande inclut le type de fichier de clés (par exemple, basé sur HSM ou sur un fichier) et l'état actuel du fichier de clés, par exemple s'il est ouvert, fermé ou dans un autre état.

Q : Comment savoir si le fichier de clés d'accès est ouvert ou fermé à l'aide de la commande dbaascli tde status ?

R : le statut du fichier de clés, qu'il soit ouvert ou fermé, fait partie de la sortie renvoyée par la commande dbaascli tde status.

Q : Comment vérifier le statut du fichier de clés TDE pour une base de données spécifique ?

R : Pour vérifier le statut du fichier de clés TDE pour une base de données spécifique, exécutez la commande suivante :

dbaascli tde status --dbname <DB_NAME>

Q : Puis-je vérifier le statut du fichier de clés pour plusieurs bases de données ?

R : Oui, mais vous devez exécuter la commande séparément pour chaque base de données, en indiquant son nom à l'aide du paramètre --dbname.

Q : La commande dbaascli tde status peut-elle être exécutée en tant qu'utilisateur root ?

R : Non. La commande doit être exécutée en tant qu'utilisateur oracle, et non en tant qu'utilisateur root.

Q : Ai-je besoin de droits d'accès spéciaux pour exécuter la commande dbaascli tde status ?

R : Oui. Vous devez disposer des privilèges utilisateur oracle et être connecté à une machine virtuelle Exadata Cloud@Customer pour exécuter la commande.

Q : Que dois-je faire en cas d'erreur lors de l'exécution de la commande dbaascli tde status ?

R : assurez-vous que vous exécutez la commande en tant qu'utilisateur oracle, que vous disposez des droits d'accès nécessaires et que vous êtes connecté à la machine virtuelle appropriée.

Q : Comment savoir quel type de fichier de clés ma base de données utilise ?

R : Le type de fichier de clés, par exemple s'il est basé sur un fichier ou sur HSM/KMS, est affiché dans la sortie de la commande dbaascli tde status.

Q : Que faire si le keystore est fermé ?

R : Si le fichier de clés d'accès est fermé, vous devrez peut-être l'ouvrir manuellement, en fonction de l'opération que vous essayez d'effectuer. Le processus exact dépendra du type de fichier de clés et de votre environnement.

Q : Puis-je afficher le statut du fichier de clés pour une base de données Conteneur ou pluggable ?

R : Oui. En indiquant le nom de base de données approprié à l'aide du paramètre --dbname, vous pouvez visualiser le statut du fichier de clés pour les bases de données Conteneur et les bases de données pluggables.

Q : Qu'est-ce que cela signifie si la commande renvoie une erreur concernant la connectivité de la base de données ?

R : Cela peut indiquer un problème avec la connexion à la base de données ou un problème avec votre environnement. Assurez-vous que la base de données est en cours d'exécution et accessible, et vérifiez votre connexion SSH à la machine virtuelle Exadata Cloud@Customer.

Q : Que se passe-t-il si le nom de la base de données est incorrect ?

R : Si le paramètre --dbname indique une base de données incorrecte ou inexistante, la commande échoue et vous recevez un message d'erreur indiquant le problème.

Q : Comment puis-je dépanner si le statut du fichier de clés indique un état inattendu ?

R : Si le statut du fichier de clés indique un état inattendu, consultez les journaux de la base de données pour plus de détails et vérifiez la configuration du fichier de clés pour vous assurer qu'il est correctement configuré.

Q : Puis-je automatiser la vérification du statut du fichier de clés à des fins de surveillance ?

R : Oui. Vous pouvez scripter la commande dbaascli tde status pour vérifier périodiquement le statut du fichier de clés ou l'intégrer à vos outils de surveillance de base de données.

Q : Comment puis-je vérifier que le cryptage transparent des données (TDE) est correctement activé ?

R : Vous pouvez vérifier que TDE est correctement activé en vérifiant le statut du fichier de clés à l'aide de la commande dbaascli tde status. Un fichier de clés d'accès valide et ouvert indique que TDE est correctement configuré.

Exemple 7-56 dbaascli tde status

dbaascli tde status --dbname dbname