Informations de référence sur l'interface de ligne de commande d'Oracle Database

L'interface de ligne de commande Database (dbcli) est disponible pour le service de base de données de base. Une fois connecté au système de base de données dans le service de base de données de base, vous pouvez utiliser dbcli pour effectuer des tâches telles que la création des répertoires de base et des bases de données Oracle.

Notes sur l'utilisation

  • Vous devez exécuter les commandes de l'interface de ligne de commande de base de données en tant qu'utilisateur racine.

  • dbcli se trouve dans le répertoire /opt/oracle/dcs/bin/.

    Ce répertoire se trouve dans le chemin de l'environnement de l'utilisateur racine.

  • Oracle Database conserve les journaux de sortie de la commande dbcli dans les fichiers dcscli.log et dcs-agent.log du répertoire /opt/oracle/dcs/log/.

  • Les commandes de l'interface de ligne de commande de base de données et la plupart des paramètres sont sensibles à la casse et doivent être entrées comme indiqué. Certains paramètres ne sont pas sensibles à la casse, comme l'indique leur description, et peuvent être entrés en majuscule ou en minuscule.

Syntaxe

Les commandes de l'interface de ligne de commande de base de données utilisent la syntaxe suivante :

dbcli command [parameters]

Où :

  • command est une combinaison de verbe et d'objet, par exemple create-database.
  • parameters permet d'ajouter des options supplémentaires à la commande. La plupart des noms de paramètre sont précédés de deux tirets, par exemple --help. Les noms de paramètre abrégés sont précédés d'un tiret, par exemple -h.
  • Les valeurs de paramètre spécifiées par l'utilisateur sont affichées en rouge entre crochets, par exemple <db_home_id>. N'ajoutez pas les crochets lorsque vous spécifiez ces valeurs.
  • Le paramètre d'aide (help) est disponible pour chaque commande.

Le reste de cette rubrique décrit la syntaxe des commandes et fournit d'autres détails sur celles-ci.

Commande de mise à jour de l'interface de ligne de commande

De nouvelles commandes sont parfois ajoutées à l'interface de ligne de commande de base de données et d'autres sont mises à jour pour assurer la prise en charge de nouvelles fonctions. Vous pouvez utiliser la commande suivante pour mettre à jour l'interface de ligne de commande de base de données :

cliadm update-dbcli

Utilisez la commande cliadm update-dbcli pour mettre à jour l'interface de ligne de commande avec les nouvelles commandes et les commandes mises à jour.

Note :

Sur les systèmes de base de données RAC, exécutez la commande cliadm update-dbcli sur chaque noeud de la grappe.

Syntaxe

cliadm update-dbcli [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante met à jour l'interface de ligne de commande de base de données (dbcli) : 

cliadm update-dbcli
Sortie :
{
  "jobId" : "dc9ce73d-ed71-4473-99cd-9663b9d79bfd",
  "status" : "Created",
  "message" : "Dcs cli will be updated",
  "reports" : [ ],
  "createTimestamp" : "January 18, 2017 10:19:34 AM PST",
  "resourceList" : [ ],
  "description" : "dbcli patching",
  "updatedTime" : "January 18, 2017 10:19:34 AM PST"
}

Commandes d'agent

La commande suivante permet de gérer les agents : 

  • dbcli ping-agent

dbcli ping-agent

Utilisez la commande dbcli ping-agent pour tester l'accessibilité d'un agent.

Syntaxe

dbcli ping-agent [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes autologcleanpolicy

Les commandes suivantes permettent de gérer les politiques de nettoyage (épuration) automatique des journaux.

  • dbcli create-autoLogCleanPolicy
  • dbcli list-autoLogCleanPolicy

dbcli create-autoLogCleanPolicy

Utilisez la commande dbcli create-autoLogCleanPolicy pour créer des politiques de nettoyage (épuration) automatique des journaux.

Syntaxe

dbcli create-autoLogCleanPolicy 
  [-c {gi|database|dcs}] 
  [-f <number>] 
  [-o <number>] 
  [-u {Day|Hour|Minute}] 
  [-uMB <number>] 
  [-uPer <number>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-c --components (Facultatif) Composants à épurer. Les valeurs possibles sont gi, database et dcs. Séparez les valeurs multiples par des virgules. Exemple : gi,dcs
-f --freeSpaceBelowPercentage (Facultatif) Épure les journaux lorsque l'espace disque libre est inférieur au pourcentage indiqué de la taille de partition totale. Intervalle valide : 20 à 50. Valeur par défaut : 20.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-o --olderthan (Facultatif) Durée de l'intervalle. Valeur par défaut : 30. Nettoie les journaux antérieurs à l'intervalle de temps spécifié (-o et -u).
-u --olderThanUnit (Facultatif) Unité de l'intervalle. Valeurs possibles : Day, Hour ou Minute. Valeur par défaut : Day. Nettoie les journaux antérieurs à l'intervalle de temps spécifié (-o et -u).
-uMB --usageOverMB (Facultatif) Épure les journaux lorsque leur utilisation dépasse le nombre indiqué de mégaoctets (Mo). Intervalle valide : 10 à 50 % de la taille de partition totale.
-uPer --usageOverPercentage (Facultatif) Épure les journaux lorsque leur utilisation dépasse le pourcentage indiqué de la taille de partition totale. Intervalle valide : 10 à 50.

dbcli list-autoLogCleanPolicy

Utilisez la commande dbcli list-autoLogCleanPolicy pour lister les politiques de nettoyage automatique des journaux.

Syntaxe

dbcli list-autoLogCleanPolicy 
  [-c {gi|database|dcs}] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-c --components (Facultatif) Composants. Les valeurs possibles sont gi, database et dcs. Séparez les valeurs multiples par des virgules. Exemple : gi,dcs
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes de sauvegarde

Les commandes suivantes sont disponibles pour sauvegarder des bases de données :

  • dbcli create-backup
  • dbcli getstatus-backup
  • dbcli schedule-backup

Note :

Au lieu de dbcli, vous pouvez utiliser la console ou l'API pour gérer la sauvegarde des bases de données du système de base de données dans le stockage d'objets. Toutefois, si vous utilisez dbcli et que vous passez aux sauvegardes gérées, une nouvelle configuration de sauvegarde est créée et associée à votre base de données. Les sauvegardes créées au moyen de dbcli ne sont plus accessibles à partir des interfaces de sauvegarde gérée. Pour plus d'informations sur les sauvegardes gérées, voir Sécurité et récupération dans le service de base de données de base.

Avant de sauvegarder une base de données à l'aide de la commande dbcli create-backup, vous devez effectuer les opérations suivantes :

  1. Créer une configuration de sauvegarde à l'aide de la commande dbcli create-backupconfig.
  2. Associer la configuration de sauvegarde à la base de données à l'aide de la commande dbcli update-database.

Une fois une base de données associée à une configuration de sauvegarde, vous pouvez utiliser la commande dbcli create-backup dans une tâche cron pour exécuter automatiquement les sauvegardes. Un utilitaire cron tel que CronMaker peut vous aider à créer des expressions. Pour plus d'informations, voir CronMaker.

dbcli create-backup

Utilisez la commande dbcli create-backup pour créer une sauvegarde d'une base de données.

Syntaxe

dbcli create-backup 
  -in <db_name> 
  -i <db_id> 
  [-bt {Regular-L0|Regular-L1|Longterm|ArchiveLog}] 
  [-c {Database|TdeWallet}] 
  [-k <n>] 
  [-t <tag>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-bt --backupType

(Facultatif) Type de sauvegarde. Les valeurs possibles sont Regular-L0, Regular-L1, Longterm et ArchiveLog. Regular-L0 et Standard L1 correspondent aux sauvegardes incrémentielles L0 et L1. Longterm correspond à une sauvegarde complète. ArchiveLog correspond à une sauvegarde des fichiers de journalisation archivés. La valeur par défaut est Regular-L1. Les valeurs ne sont pas sensibles à la casse. En cas d'omission, la valeur par défaut est utilisée.

-c --component

(Facultatif) Composant. Les valeurs possibles sont Database et TdeWallet. La valeur par défaut est Database. La valeur TdeWallet sauvegarde les portefeuilles de chiffrement transparent des données. Les valeurs ne sont pas sensibles à la casse. En cas d'omission, la valeur par défaut est utilisée.

Notez que les portefeuilles TDE sont sauvegardés automatiquement dans les situations suivantes :
  • Une base de données est créée avec une configuration de sauvegarde dans le stockage d'objets.
  • Une base de données dotée d'une configuration de sauvegarde dans le stockage d'objets est mise à jour.
  • Une configuration de sauvegarde dans le stockage d'objets est mise à jour.
  • Une sauvegarde de type Longterm est créée.
  • Une rotation de la clé TDE d'une base de données est effectuée.
  • Une base de données est sauvegardée et il n'existe pas encore de sauvegarde du portefeuille TDE.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --dbid ID de la base de données à sauvegarder. Utilisez la commande dbcli list-databases pour obtenir l'ID de la base de données.
-in --dbName Nom de la base de données à sauvegarder. Utilisez la commande dbcli list-databases pour obtenir le nom de la base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-k --keepDays

(Facultatif) Spécifie la durée pendant laquelle la sauvegarde ou la copie doit être conservée. Passé ce délai, la sauvegarde est considérée comme obsolète, quels que soient les paramètres de la politique de conservation des sauvegardes. S'applique au type de sauvegarde Longterm uniquement.

-t --tag

(Obligatoire pour le type de sauvegarde Longterm) Indique un nom de marqueur spécifié par l'utilisateur pour un jeu de sauvegarde et applique ce marqueur aux fichiers de sortie générés par la commande. Cette valeur n'est pas sensible à la casse. Nombre de caractères valide : 1 à 30. Seuls sont autorisés les caractères autorisés pour les noms de fichier dans le système de fichiers cible. Par exemple, ASM ne prend pas en charge les traits d'union (-) dans les noms de fichier utilisés en interne. Par conséquent, le nom de marqueur weekly-incremental n'est pas valide pour les sauvegardes dans les groupes de disques ASM. Les variables d'environnement ne sont pas valides dans le paramètre TAG.

Exemples

La commande suivante crée une sauvegarde de la base de données spécifiée à l'aide de l'ID base de données.

dbcli create-backup -i 573cadb2-0cc2-4c1c-9c31-595ab8963d5b

La commande suivante crée une sauvegarde de la base de données spécifiée à l'aide du nom de base de données ("mydb").

dbcli create-backup -in mydb

dbcli getstatus-backup

Utilisez la commande dbcli getstatus-backup pour afficher le statut d'une sauvegarde.

Syntaxe

dbcli getstatus-backup 
  -t <backup_type> 
  [i <id>] 
  [-in <name>] 
  [-l] [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --dbId (Facultatif) ID de la ressource de base de données.
-in --dbName (Facultatif) Nom de la ressource de base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-l --isLatestBackupReport (Facultatif) Dernier rapport de sauvegarde. Valeur par défaut : Vrai.
-t --backupType Type de sauvegarde.

dbcli schedule-backup

Utilisez la commande dbcli schedule-backup pour programmer une sauvegarde d'une base de données.

Syntaxe

dbcli schedule-backup 
  -t <backup_type> 
  -f <number> 
  [i <id>] 
  [-in <name>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-f --frequency Fréquence en minutes.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --dbId (Facultatif) ID de la ressource de base de données.
-in --dbName (Facultatif) Nom de la ressource de base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-t --backupType Type de sauvegarde.

Commandes backupconfig

Une configuration de sauvegarde détermine la destination et la fenêtre de récupération des sauvegardes de base de données. Vous créez la configuration de sauvegarde, puis vous l'associez à une base de données à l'aide de la commande dbcli update-database.

Note :

Les sauvegardes configurées à l'aide de la console peuvent devenir inutilisables si vous effectuez des modifications à l'aide de ces commandes. Pour les sauvegardes configurées à l'aide de la console, n'utilisez ces commandes qu'avec une assistance technique.

Note :

Au lieu de dbcli, vous pouvez utiliser la console ou l'API pour gérer la sauvegarde des bases de données du système de base de données dans le stockage d'objets. Pour plus d'informations sur les sauvegardes gérées, voir Sécurité et récupération dans le service de base de données de base.

Une fois une base de données associée à une configuration de sauvegarde, vous pouvez utiliser la commande dbcli create-backup dans une tâche cron pour exécuter automatiquement les sauvegardes. Un utilitaire cron tel que CronMaker peut vous aider à créer des expressions. Pour plus d'informations, voir CronMaker.

Les commandes suivantes permettent de gérer les configurations de sauvegarde :

  • dbcli create-backupconfig
  • dbcli list-backupconfigs
  • dbcli describe-backupconfig
  • dbcli update-backupconfig
  • dbcli delete-backupconfig

dbcli create-backupconfig

Utilisez la commande dbcli create-backupconfig pour créer une configuration de sauvegarde qui définit la destination et les fenêtres de récupération des sauvegardes.

Syntaxe

dbcli create-backupconfig 
  -d {DISK|OBJECTSTORE|NONE} 
  -c <bucket>  
  -o <object_store_swift_id> 
  -on <object_store_swift_name> 
  -w <n> 
  -n <name> 
  [-cr|-no-cr] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-c --container

Nom d'un seau existant dans le service de stockage d'objets pour Oracle Cloud Infrastructure. Vous pouvez utiliser la console ou l'API de stockage d'objets pour créer le seau. Pour plus d'informations, voir Gestion des seaux.

Vous devez également spécifier --backupdestination objectstore et le paramètre --objectstoreswiftId.

-cr

-no-cr

--crosscheck

--no-crosscheck

(Facultatif) Indique si l'opération crosscheck doit être activée. Cette opération détermine si les fichiers sur le disque ou dans le catalogue de gestion des médias correspondent aux données du référentiel RMAN. En cas d'omission, le paramètre par défaut est utilisé (l'opération crosscheck est activée par défaut).

-d --backupdestination

Destination de la sauvegarde. Les valeurs possibles sont les suivantes (ces valeurs ne sont pas sensibles à la casse) :

DISK - Zone de récupération rapide locale.

OBJECTSTORE - Service de stockage d'objets pour Oracle Cloud Infrastructure. Vous devez également spécifier les paramètres --container et --objectstoreswiftId.

NONE - Désactive la sauvegarde.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-n --name Nom de la configuration de sauvegarde.
-o --objectstoreswiftId

ID du magasin d'objets qui contient le point d'extrémité et les données d'identification du service de stockage d'objets pour Oracle Cloud Infrastructure. Utilisez la commande dbcli list-objectstoreswifts pour obtenir l'ID du magasin d'objets. Utilisez la commande dbcli create-objectstoreswift pour créer un magasin d'objets.

Vous devez également spécifier les paramètres --backupdestination objectstore et --container.

-on --objectstoreswiftName

Nom du magasin d'objets qui contient le point d'extrémité et les données d'identification du service de stockage d'objets pour Oracle Cloud Infrastructure.

Utilisez la commande dbcli list-objectstoreswifts pour obtenir l'ID du magasin d'objets. Utilisez la commande dbcli create-objectstoreswift pour créer un magasin d'objets.

Vous devez également spécifier les paramètres --backupdestination objectstore et --container.

-w --recoverywindow

Nombre de jours pendant lesquels les sauvegardes et les fichiers de journalisation archivés sont conservés. Pour calculer l'intervalle, partez de l'heure courante et remontez en arrière du nombre de jours spécifié.

Pour une destination de sauvegarde DISK, indiquez 1 à 14 jours.

Pour une destination de sauvegarde OBJECTSTORE, entrez 1 à 30 jours.

Exemple

La commande suivante crée une configuration de sauvegarde nommée 'dbbkcfg1' :

dbcli create-backupconfig -d Disk -w 7 -n dbbkcfg1
Sortie :
{
  "jobId" : "4e0e6011-db53-4142-82ef-eb561658a0a9",
  "status" : "Success",
  "message" : null,
  "reports" : [ {
    "taskId" : "TaskParallel_919",
    "taskName" : "persisting backup config metadata",
    "taskResult" : "Success",
    "startTime" : "November 18, 2016 20:21:25 PM UTC",
    "endTime" : "November 18, 2016 20:21:25 PM UTC",
    "status" : "Success",
    "taskDescription" : null,
    "parentTaskId" : "TaskSequential_915",
    "jobId" : "4e0e6011-db53-4142-82ef-eb561658a0a9",
    "tags" : [ ],
    "reportLevel" : "Info",
    "updatedTime" : "November 18, 2016 20:21:25 PM UTC"
  } ],
  "createTimestamp" : "November 18, 2016 20:21:25 PM UTC",
  "description" : "create backup config:dbbkcfg1",
  "updatedTime" : "November 18, 2016 20:21:25 PM UTC"
}

dbcli list-backupconfigs

Utilisez la commande dbcli list-backupconfigs pour lister toutes les configurations de sauvegarde du système de base de données.

Syntaxe

dbcli list-backupconfigs [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante liste une configuration de sauvegarde :

dbcli list-backupconfigs
Sortie :
ID                                       Name                 RecoveryWindow     BackupDestination CreateTime
---------------------------------------- -------------------- ------------------ ----------------- -----------------------------
ccdd56fe-a40b-4e82-b38d-5f76c265282d     dbbkcfg1             7                  Disk              July 10, 2016 12:24:08 PM UTC

dbcli describe-backupconfig

Utilisez la commande dbcli describe-backupconfig pour afficher les détails d'une configuration de sauvegarde spécifique.

Syntaxe

dbcli describe-backupconfig -i <id> -in <name> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --backupconfigid ID de la configuration de sauvegarde. Utilisez la commande dbcli list-backupconfigs pour obtenir l'ID.
-in --backupconfigname Nom de la configuration de sauvegarde. Utilisez la commande dbcli list-backupconfigs pour obtenir le nom.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche les détails d'une configuration de sauvegarde :

dbcli describe-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282d
Sortie :
Backup Config details
----------------------------------------------------------------
                     ID: ccdd56fe-a40b-4e82-b38d-5f76c265282d
                   Name: dbbkcfg1
         RecoveryWindow: 7
      BackupDestination: Disk
            CreatedTime: July 10, 2016 12:24:08 PM UTC
            UpdatedTime: July 10, 2016 12:24:08 PM UTC

dbcli update-backupconfig

Utilisez la commande dbcli update-backupconfig pour mettre à jour une configuration de sauvegarde existante.

Syntaxe

dbcli update-backupconfig 
  -i <id> 
  -in <name> 
  -w <n> 
  -d {DISK|OBJECTSTORE|NONE} 
  -c <bucket> 
  -o <object_store_swift_id> 
  -on <object_store_swift_name> 
  [-cr|-no-cr] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-c --container

Nom d'un seau existant dans le service de stockage d'objets pour Oracle Cloud Infrastructure. Vous pouvez utiliser la console ou l'API de stockage d'objets pour créer le seau. Pour plus d'informations, voir Gestion des seaux.

Vous devez également spécifier --backupdestination objectstore et le paramètre --objectstoreswiftId.

-cr

-no-cr

--crosscheck

--no-crosscheck

(Facultatif) Indique si l'opération crosscheck doit être activée. Cette opération détermine si les fichiers sur le disque ou dans le catalogue de gestion des médias correspondent aux données du référentiel RMAN. En cas d'omission, le paramètre par défaut est utilisé (l'opération crosscheck est activée par défaut).

-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --backupconfigid ID de la configuration de sauvegarde à mettre à jour. Utilisez la commande dbcli list-backupconfigs pour obtenir l'ID.
-in --backupconfigname Nom de la configuration de sauvegarde à mettre à jour. Utilisez la commande dbcli list-backupconfigs pour obtenir le nom.
-j --json (Facultatif) Affiche la sortie JSON.
-o --objectstoreswiftId

ID du magasin d'objets qui contient le point d'extrémité et les données d'identification du service de stockage d'objets pour Oracle Cloud Infrastructure. Utilisez la commande dbcli list-objectstoreswifts pour obtenir l'ID du magasin d'objets. Utilisez la commande dbcli create-objectstoreswift pour créer un magasin d'objets.

Vous devez également spécifier les paramètres --backupdestination objectstore et --container.

-on --objectstoreswiftname

Nom du magasin d'objets qui contient le point d'extrémité et les données d'identification du service de stockage d'objets pour Oracle Cloud Infrastructure. Utilisez la commande dbcli list-objectstoreswifts pour obtenir l'ID du magasin d'objets. Utilisez la commande dbcli create-objectstoreswift pour créer un magasin d'objets.

Vous devez également spécifier les paramètres --backupdestination objectstore et --container.

-w --recoverywindow

Nouvelle fenêtre de récupération sur disque.

Pour une destination de sauvegarde DISK, indiquez 1 à 14 jours.

Pour une destination de sauvegarde OBJECTSTORE, entrez 1 à 30 jours.

Exemple

La commande suivante met à jour la fenêtre de récupération d'une configuration de sauvegarde :

dbcli update-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282d -w 5
Sortie :
{
  "jobId" : "0e849291-e1e1-4c7a-8dd2-62b522b9b807",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1468153731699,
  "description" : "update backup config: dbbkcfg1",
  "updatedTime" : 1468153731700
}

dbcli delete-backupconfig

Utilisez la commande dbcli delete-backupconfig pour supprimer une configuration de sauvegarde.

Syntaxe

dbcli delete-backupconfig -i <id> -in <name> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --id ID de la configuration de sauvegarde à supprimer. Utilisez la commande dbcli list-backupconfigs pour obtenir l'ID.
-in --backupconfigname Nom de la configuration de sauvegarde à supprimer. Utilisez la commande dbcli list-backupconfigs pour obtenir le nom.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante supprime la configuration de sauvegarde spécifiée :

dbcli delete-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282d

Commande component

dbcli describe-component

Votre système de base de données ne comporte peut-être pas cette commande récente. En cas de difficulté à l'exécuter, utilisez la commande de mise à jour de l'interface de ligne de commande pour mettre à jour l'interface de ligne de commande de base de données et réessayez.

Note :

La commande dbcli describe-component n'est pas disponible sur les systèmes de base de données RAC à 2 noeuds. L'application de correctifs à partir du service de stockage d'objets sur des systèmes à 2 noeuds n'est pas prise en charge.

Utilisez la commande dbcli describe-component pour afficher les versions de correctif installées et disponibles pour les composants de serveur, de stockage ou du répertoire de base du système de base de données.

Cette commande requiert une configuration valide des données d'identification du service de stockage d'objets. Si la configuration est absente ou non valide, la commande échoue avec l'erreur : Failed to connect to the object store. Please provide valid details.

Pour plus d'informations sur la mise à jour de l'interface de ligne de commande, la création de la configuration des données d'identification et l'application de correctifs, voir Mettre à jour un système de base de données.

Syntaxe

dbcli describe-component 
  [-s <server_group>] 
  [-d <db_group>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-d --dbhomes (Facultatif) Liste les versions de correctif installées et disponibles pour les composants du répertoire de base uniquement.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-s --server (Facultatif) Liste les versions de correctif installées et disponibles uniquement pour les composants de serveur.

Exemple

Utilisez la commande suivante pour afficher les versions courantes des composants et les versions des correctifs disponibles dans le magasin d'objets :

dbcli describe-component
Sortie :
System Version
---------------
12.1.2.10.0

Component                                Installed Version    Available Version
---------------------------------------- -------------------- --------------------
OAK                                      12.1.2.10.0          up-to-date
GI                                       12.1.0.2.161018      up-to-date
ORADB12102_HOME1                         12.1.0.2.161018      up-to-date  
ORADB12102_HOME2, ORADB12102_HOME3       12.1.0.2.160719      12.1.0.2.161018

Commandes de base de données

Les commandes suivantes permettent de gérer les bases de données :

  • dbcli clone-database
  • dbcli describe-database
  • dbcli list-databases
  • dbcli modify-database
  • dbcli recover-database
  • dbcli register-database
  • dbcli update-database

dbcli clone-database

Utilisez la commande dbcli clone-database pour cloner une base de données.

Syntaxe

dbcli clone-database 
  -f <name> 
  -u <name> 
  -n <name> 
  [-s <shape>] 
  [-t <type>] 
  [m <sys_password>] 
  [-p <tde_password>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-f --sourcedbname Nom de la base de données source.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-m --syspassword (Facultatif) Mot de passe de l'utilisateur SYS.
-n --dbname Nom de la base de données.
-p --tdepassword (Facultatif) Mot de passe du portefeuille TDE source.
-s --dbshape (Facultatif) Forme de la base de données. Exemples : odb1, odb2.
-t --dbtype (Facultatif) Type de base de données : SI
-u --databaseUniqueName Nom unique de la base de données.

dbcli describe-database

Utilisez la commande dbcli describe-database pour afficher les détails de la base de données.

Syntaxe

dbcli describe-database 
  -i <db_id> 
  -in <db_name> 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --dbid ID de la base de données à afficher. Utilisez la commande dbcli list-databases pour obtenir l'ID de la base de données.
-in --dbName Nom de la base de données à afficher. Utilisez la commande dbcli list-databases pour obtenir le nom de la base de données.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche des informations sur une base de données nommée b727bf80-c99e-4846-ac1f-28a81a725df6 :

dbcli describe-dbhome -i b727bf80-c99e-4846-ac1f-28a81a725df6
Sortie :
DB Home details
----------------------------------------------------------------
                      ID: b727bf80-c99e-4846-ac1f-28a81a725df6
                    Name: OraDB12102_home1
                 Version: 12.1.0.2
           Home Location: /u01/app/orauser/product/12.1.0.2/dbhome_1
                 Created: Jun 2, 2016 10:19:23 AM

dbcli list-databases

Utilisez la commande dbcli list-databases pour lister toutes les bases de données du système de base de données.

Syntaxe

dbcli  list-databases [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche une liste de bases de données :

dbcli  list-databases
Sortie :
ID                                       DB Name    DB Version           CDB        Class    Shape    Storage    Status
---------------------------------------- ---------- -------------------- ---------- -------- -------- ---------- ----------
80ad855a-5145-4f8f-a08f-406c5e4684ff     dbst       12.1.0.2             true       OLTP     odb2     ACFS       Configured
6f4e36ae-120b-4436-b0bf-d0c4aef9f7c9     db11tsta   11.2.0.4             false      OLTP     odb1     ACFS       Configured
d8e31790-84e6-479c-beb0-ef97207091a2     db11tstb   11.2.0.4             false      OLTP     odb1     ACFS       Configured
cce096c7-737b-447a-baa1-f4c2a330c030     pdbtst     12.1.0.2             true       OLTP     odb1     ACFS       Configured

La commande suivante affiche la sortie JSON pour une base de données :

dbcli list-databases -j
Sortie :
[ {
  "id" : "80ad855a-5145-4f8f-a08f-406c5e4684ff",
  "name" : "dbtst",
  "dbName" : "dbtst",
  "databaseUniqueName" : "dbtst_phx1cs",
  "dbVersion" : "12.1.0.2",
  "dbHomeId" : "2efe7af7-0b70-4e9b-ba8b-71f11c6fe287",
  "instanceOnly" : false,
  "registerOnly" : false,
  "dbId" : "167525515",
  "isCdb" : true,
  "pdBName" : "pdb1",
  "pdbAdminUserName" : "pdbuser",
  "enableTDE" : true,
  "dbType" : "SI",
  "dbTargetNodeNumber" : "0",
  "dbClass" : "OLTP",
  "dbShape" : "odb2",
  "dbStorage" : "ACFS",
  "dbCharacterSet" : {
    "characterSet" : "US7ASCII",
    "nlsCharacterset" : "AL16UTF16",
    "dbTerritory" : "AMERICA",
    "dbLanguage" : "AMERICAN"
  },
  "dbConsoleEnable" : false,
  "backupConfigId" : null,
  "backupDestination" : "NONE",
  "cloudStorageContainer" : null,
  "state" : {
    "status" : "CONFIGURED"
  },
  "createTime" : "November 09, 2016 17:23:05 PM UTC",
  "updatedTime" : "November 09, 2016 18:00:47 PM UTC"
}

dbcli modify-database

Utilisez la commande dbcli modify-database pour modifier une base de données.

Syntaxe

dbcli modify-database 
  -i <db_id> 
  -dh <destination_db_home_id> 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-dh --destdbhomeid ID du répertoire de base de destination.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --databaseid ID base de données.
-j --json (Facultatif) Affiche la sortie JSON.

dbcli recover-database

Utilisez la commande dbcli recover-database pour récupérer une base de données.

Syntaxe

dbcli recover-database 
  [-br <json>] 
  [-in <db_name>] 
  [-i <db_id>] 
  [-r <time>] 
  [-t {Latest|PITR|SCN}] 
  [-s] 
  [-l <location>] 
  [-tp <tde_password>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-br --backupReport (Facultatif) Entrée JSON pour le rapport de sauvegarde.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --dbid (Facultatif) ID de la ressource de base de données.
-in --dbName (Facultatif) Nom de la base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-l --tdeWalletLocation (Facultatif) Emplacement de sauvegarde du portefeuille TDE. Le portefeuille TDE doit être sauvegardé au format tar.gz.
-r --recoveryTimeStamp (Obligatoire lorsque le type de récupération est PITR) Horodatage de récupération au format mm/jj/aaaa hh:mi:ss. Valeur par défaut : [ ]
-s --scn (Obligatoire lorsque le type de récupération est SCN) Numéro SCN.
-t --recoverytype (Obligatoire lorsque le rapport de sauvegarde est fourni) Type de récupération. Les valeurs possibles sont Latest, PITR et SCN.
-tp --tdeWalletPassword (Facultatif) Mot de passe du portefeuille TDE.

dbcli register-database

Utilisez la commande dbcli register-database pour enregistrer une base de données migrée vers Oracle Cloud Infrastructure. Cette commande enregistre la base de données auprès de l'agent dcs-agent afin qu'elle soit gérée par la pile dcs-agent.

Note :

La commande dbcli register-database n'est pas disponible sur les systèmes de base de données RAC à 2 noeuds.

Syntaxe

dbcli  register-database 
  -bi <bkup_config_id> 
  -c {OLTP|DSS|IMDB} 
  [-co|-no-co] 
  -s {odb1|odb2|...} 
  -t SI 
  [-o <db_host_name>] 
  [-tp <password>] 
  -sn <service_name> 
  -p 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-bi --backupconfigid Définit l'ID configuration de la sauvegarde. Utilisez la commande dbcli list-backupconfigs pour obtenir l'ID.
-c --dbclass Définit la classe de la base de données. Les options sont OLTP, DSS ou IMDB. La valeur par défaut est OLTP. Pour les éditions Enterprise, les trois classes sont prises en charge. Pour l'édition Standard, seule la classe OLTP est prise en charge.

-co

-no-co

--dbconsole

--no-dbconsole

(Facultatif) Indique si la console de base de données est activée ou non. En cas d'omission, la console n'est pas activée.

-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-o --hostname (Facultatif) Définit le nom d'hôte de la base de données. La valeur par défaut est Local host name.
-p --syspassword

Définit un mot de passe fort pour SYS. Indiquez -p sans mot de passe. Vous serez invité à entrer le mot de passe.

Si vous devez fournir le mot de passe dans la commande, par exemple dans un script, utilisez -hp <password> au lieu de -p.

-s --dbshape Définit le modèle de dimensionnement à utiliser pour la base de données. Par exemple, odb1, odb2 et odb3.
-sn --servicename Définit le nom du service de base de données utilisé pour créer la chaîne EZCONNECT pour la connexion à la base de données. Le format de chaîne de connexion est hostname:port/servicename.
-t --dbtype (Facultatif) Définit le type de base de données SI (un seul noeud). La valeur par défaut est SI.
-tp --tdeWalletPassword

(Facultatif) Mot de passe du portefeuille TDE. Obligatoire si le chiffrement transparent des données est activé pour la base de données migrée.

Exemple

La commande suivante enregistre la base de données avec la classe, le nom de service et le modèle de dimensionnement de base de données spécifiés.

dbcli register-database -c OLTP -s odb1 -sn crmdb.example.com -p
Sortie :
Password for SYS:
{
  "jobId" : "317b430f-ad5f-42ae-bb07-13f053d266e2",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : "August 08, 2016 05:55:49 AM EDT",
  "description" : "Database service registration with db service name: crmdb.example.com",
  "updatedTime" : "August 08, 2016 05:55:49 AM EDT"
}

dbcli update-database

Utilisez la commande dbcli update-database pour associer une configuration de sauvegarde à une base de données.

Syntaxe

dbcli update-database 
  -i <db_id> 
  -bi <bkup_config_id> 
  -bin <bkup_config_name>;
  [-id <id>] 
  -in <name> 
  [-no-ab] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-bi --backupconfigid Définit l'ID configuration de la sauvegarde. Utilisez la commande dbcli list-backupconfigs pour obtenir l'ID.
-bin --backupconfigname Définit le nom de la configuration de sauvegarde pour une utilisation ultérieure. Utilisez la commande dbcli list-backupconfigs pour obtenir le nom.
-id --databaseid

(Facultatif.) Spécifie le DBID, un numéro d'identification unique à 32 bits calculé lors de la création de la base de données. RMAN affiche le DBID lors de la connexion à la base de données cible. Vous pouvez obtenir le DBID en interrogeant la vue V$DATABASE ou les vues de catalogue de récupération RC_DATABASE et RC_DATABASE_INCARNATION.
-in --dbName

Définit le nom de la base de données à mettre à jour. Utilisez la commande dbcli list-databases pour obtenir le nom de la base de données.

-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --dbid Définit l'ID de la base de données à mettre à jour. Utilisez la commande dbcli list-databases pour obtenir l'ID de la base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-no-ab --noautobackup

(Facultatif) Désactive les sauvegardes automatiques pour la base de données spécifiée.

Notez qu'une fois désactivée, la sauvegarde automatique ne peut pas être réactivée au moyen de l'interface de ligne de commande. Pour réactiver la sauvegarde automatique, vous devez utiliser la console.

Exemple

La commande suivante associe un fichier de configuration de sauvegarde à une base de données :

dbcli update-database -bi 78a2a5f0-72b1-448f-bd86-cf41b30b64ee -i 71ec8335-113a-46e3-b81f-235f4d1b6fde
Sortie :
{
  "jobId" : "2b104028-a0a4-4855-b32a-b97a37f5f9c5",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1467775842977,
  "description" : "update database id:71ec8335-113a-46e3-b81f-235f4d1b6fde",
  "updatedTime" : 1467775842978
}

Commandes dbhome

Les commandes suivantes servent à gérer les répertoires de base de base de données :

  • dbcli create-dbhome
  • dbcli describe-dbhome
  • dbcli delete-dbhome
  • dbcli list-dbhomes
  • dbcli update-dbhome

dbcli create-dbhome

Utilisez la commande dbcli create-dbhome pour créer un répertoire de base Oracle Database.

Syntaxe

dbcli create-dbhome -v <version> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-v --version Définit la version du répertoire de base Oracle Database.

Exemple

La commande suivante crée un répertoire de base Oracle Database version 12.1.0.2 :

dbcli create-dbhome -v 12.1.0.2

dbcli describe-dbhome

Utilisez la commande dbcli describe-dbhome pour afficher les détails du répertoire de base Oracle Database.

Syntaxe

dbcli describe-dbhome -i <db_home_id> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --dbhomeid Identifie l'ID du répertoire de base de la base de données. Utilisez la commande dbcli list-dbhomes pour obtenir l'ID.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

L'exemple suivant illustre la sortie de la commande d'affichage des détails du répertoire de base Oracle Database.

dbcli describe-dbhome -i 52850389-228d-4397-bbe6-102fda65922b
Sortie :
DB Home details
----------------------------------------------------------------
                     ID: 52850389-228d-4397-bbe6-102fda65922b
                   Name: OraDB12102_home1
                Version: 12.1.0.2
          Home Location: /u01/app/oracle/product/12.1.0.2/dbhome_1
                Created: June 29, 2016 4:36:31 AM UTC

dbcli delete-dbhome

Utilisez la commande dbcli delete-dbhome pour supprimer un répertoire de base de base de données du système de base de données.

Syntaxe

dbcli delete-dbhome -i <db_home_id> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --dbhomeid ID du répertoire de base de base de données à supprimer. Utilisez la commande dbcli list-dbhomes pour obtenir l'ID.
-j --json (Facultatif) Affiche la sortie JSON.

dbcli list-dbhomes

Utilisez la commande dbcli list-dbhomes pour afficher une liste des répertoires de base Oracle.

Syntaxe

dbcli list-dbhomes [-h] [-j]

Paramètre

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche une liste des répertoires de base Oracle.

dbcli  list-dbhomes
Sortie :
ID                                   Name               DB Version Home Location
------------------------------------ -----------------  ---------- ------------------------------------------
b727bf80-c99e-4846-ac1f-28a81a725df6 OraDB12102_home1	 12.1.0.2  /u01/app/orauser/product/12.1.0.2/dbhome_1

dbcli update-dbhome

Note :

Votre système de base de données ne comporte peut-être pas cette commande récente. En cas de difficulté à l'exécuter, utilisez la commande de mise à jour de l'interface de ligne de commande pour mettre à jour l'interface de ligne de commande de base de données et réessayez.

Utilisez la commande dbcli update-dbhome pour appliquer le correctif d'ensemble DBBP à un répertoire de base de base de données. Pour plus d'informations sur l'application de correctifs, voir Mettre à jour un système de base de données.

Syntaxe

dbcli update-dbhome 
  -i <db_home_id> 
  -n <node> 
  [--local] 
  [--precheck] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --dbhomeid ID du répertoire de base de base de données. Utilisez la commande dbcli list-dbhomes pour obtenir l'ID.
-j --json (Facultatif) Affiche la sortie JSON.
-n --node

(Facultatif) Numéro du noeud à mettre à jour. Utilisez la commande dbcli list-nodes pour obtenir le numéro du noeud.

 -l --local

(Facultatif) Effectue l'opération sur le noeud local d'un système à haute disponibilité à plusieurs noeuds. Ce paramètre n'est pas nécessaire pour effectuer l'opération sur un système à un seul noeud.

 -p --precheck

(Facultatif) Exécute des opérations de vérification des préalables.

Exemple

Les commandes suivantes mettent à jour le répertoire de base Oracle et affichent la sortie de la tâche de mise à jour :

dbcli update-dbhome -i e1877dac-a69a-40a1-b65a-d5e190e671e6
Sortie :
{
  "jobId" : "493e703b-46ef-4a3f-909d-bbd123469bea",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : "January 19, 2017 10:03:21 AM PST",
  "resourceList" : [ ],
  "description" : "DB Home Patching: Home Id is e1877dac-a69a-40a1-b65a-d5e190e671e6",
  "updatedTime" : "January 19, 2017 10:03:21 AM PST"
}
dbcli describe-job -i 493e703b-46ef-4a3f-909d-bbd123469bea
Sortie :
Job details
----------------------------------------------------------------
                     ID:  493e703b-46ef-4a3f-909d-bbd123469bea
            Description:  DB Home Patching: Home Id is e1877dac-a69a-40a1-b65a-d5e190e671e6
                 Status:  Running
                Created:  January 19, 2017 10:03:21 AM PST
                Message:

Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------
Create Patching Repository Directories   January 19, 2017 10:03:21 AM PST    January 19, 2017 10:03:21 AM PST    Success
Download latest patch metadata           January 19, 2017 10:03:21 AM PST    January 19, 2017 10:03:21 AM PST    Success
Update System version                    January 19, 2017 10:03:21 AM PST    January 19, 2017 10:03:21 AM PST    Success
Update Patching Repository               January 19, 2017 10:03:21 AM PST    January 19, 2017 10:03:31 AM PST    Success
Opatch updation                          January 19, 2017 10:03:31 AM PST    January 19, 2017 10:03:31 AM PST    Success
Patch conflict check                     January 19, 2017 10:03:31 AM PST    January 19, 2017 10:03:31 AM PST    Running

Commandes dbstorage

Les commandes suivantes servent à gérer le stockage de base de données :

  • dbcli list-dbstorages
  • dbcli describe-dbstorage

dbcli list-dbstorages

Utilisez la commande dbcli list-dbstorages pour lister le stockage de base de données du système de base de données.

Syntaxe

dbcli list-dbstorages [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche les détails relatifs au stockage de base de données :

dbcli list-dbstorages
Sortie :
ID                                       Type   DBUnique Name        Status
---------------------------------------- ------ -------------------- ----------
afb4a1ce-d54d-4993-a149-0f28c9fb33a4     Acfs   db1_2e56b3a9b815     Configured
d81e8013-4551-4d10-880b-d1a796bca1bc     Acfs   db11xp               Configured

dbcli describe-dbstorage

Utilisez la commande dbcli describe-dbstorage pour afficher des informations détaillées sur une ressource de stockage de base de données spécifique.

Syntaxe

dbcli describe-dbstorage -i <db_storage_id> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --id Définit l'ID stockage de la base de données. Utilisez la commande dbcli list-dbstorages pour obtenir l'ID stockage de la base de données.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche les détails du stockage de base de données pour 105a2db2-625a-45ba-8bdd-ee46da0fd83a :

dbcli describe-dbstorage -i 105a2db2-625a-45ba-8bdd-ee46da0fd83a
Sortie :
DBStorage details
----------------------------------------------------------------

                     ID: 105a2db2-625a-45ba-8bdd-ee46da0fd83a
                DB Name: db1
          DBUnique Name: db1
         DB Resource ID: 439e7bd7-f717-447a-8046-08b5f6493df0
           Storage Type:
          DATA Location: /u02/app/oracle/oradata/db1
          RECO Location: /u03/app/oracle/fast_recovery_area/
          REDO Location: /u03/app/oracle/redo/
                  State: ResourceState(status=Configured)
                Created: July 3, 2016 4:19:21 AM UTC
            UpdatedTime: July 3, 2016 4:41:29 AM UTC

Commandes dgconfig

dbcli list-dgconfigs

Utilisez la commande dbcli list-dgconfigs pour lister les configurations DG.

Syntaxe

dbcli list-dgconfigs [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes job

Les commandes suivantes permettent de gérer les tâches :

  • dbcli describe-job
  • dbcli list-jobs

dbcli describe-job

Utilisez la commande dbcli describe-job pour afficher les détails d'une tâche spécifique.

Syntaxe

dbcli describe-job -i <job_id> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --jobid Identifie la tâche. Utilisez la commande dbcli list-jobs pour obtenir l'ID tâche.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche les détails relatifs à l'ID tâche spécifié :

dbcli describe-job -i 74731897-fb6b-4379-9a37-246912025c17
Sortie :
Job details
----------------------------------------------------------------
                     ID:  74731897-fb6b-4379-9a37-246912025c17
            Description:  Backup service creation with db name: dbtst
                 Status:  Success
                Created:  November 18, 2016 8:33:04 PM UTC
                Message:

Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------
Backup Validations                       November 18, 2016 8:33:04 PM UTC    November 18, 2016 8:33:13 PM UTC    Success
validate recovery window                 November 18, 2016 8:33:13 PM UTC    November 18, 2016 8:33:17 PM UTC    Success
Db cross check                           November 18, 2016 8:33:17 PM UTC    November 18, 2016 8:33:23 PM UTC    Success
Database Backup                          November 18, 2016 8:33:23 PM UTC    November 18, 2016 8:34:22 PM UTC    Success
Backup metadata                          November 18, 2016 8:34:22 PM UTC    November 18, 2016 8:34:22 PM UTC    Success

dbcli list-jobs

Utilisez la commande dbcli list-jobs pour afficher une liste de tâches avec leur ID et leur statut.

La date et l'horodatage de création de la tâche s'affichent également.

Syntaxe

dbcli list-jobs [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche une liste de tâches :

dbcli list-jobs
Sortie :
ID                                       Description                                                                 Created                             Status
---------------------------------------- --------------------------------------------------------------------------- ----------------------------------- ----------
0a362dac-0339-41b5-9c9c-4d229e363eaa     Database service creation with db name: db11                                November 10, 2016 11:37:54 AM UTC   Success
9157cc78-b487-4ee9-9f46-0159f10236e4     Database service creation with db name: jhfpdb                              November 17, 2016 7:19:59 PM UTC    Success
013c408d-37ca-4f58-a053-02d4efdc42d0     create backup config:myBackupConfig                                         November 18, 2016 8:28:14 PM UTC    Success
921a54e3-c359-4aea-9efc-6ae7346cb0c2     update database id:80ad855a-5145-4f8f-a08f-406c5e4684ff                     November 18, 2016 8:32:16 PM UTC    Success
74731897-fb6b-4379-9a37-246912025c17     Backup service creation with db name: dbtst                                 November 18, 2016 8:33:04 PM UTC    Success
40a227b1-8c47-46b9-a116-48cc1476fc12     Creating a report for database 80ad855a-5145-4f8f-a08f-406c5e4684ff         November 18, 2016 8:41:39 PM UTC    Success

Commande latestpatch

dbcli describe-latestpatch

Note :

  • Votre système de base de données ne comporte peut-être pas cette commande récente. En cas de difficulté à l'exécuter, utilisez la commande de mise à jour de l'interface de ligne de commande pour mettre à jour l'interface de ligne de commande de base de données et réessayez.
  • La commande dbcli describe-latestpatch n'est pas disponible sur les systèmes de base de données RAC à 2 noeuds. L'application de correctifs à partir du service de stockage d'objets sur des systèmes à 2 noeuds n'est pas prise en charge.

Utilisez la commande dbcli describe-latestpatch pour afficher les derniers correctifs applicables au système de base de données et disponibles dans le service de stockage d'objets pour Oracle Cloud Infrastructure.

Cette commande requiert une configuration valide des données d'identification du service de stockage d'objets. Si la configuration est absente ou non valide, la commande échoue avec l'erreur : Failed to connect to the object store. Please provide valid details.

Pour plus d'informations sur la mise à jour de l'interface de ligne de commande, la création de la configuration des données d'identification et l'application de correctifs, voir Mettre à jour un système de base de données.

Syntaxe

dbcli describe-latestpatch [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche les correctifs disponibles dans le magasin d'objets :

dbcli describe-latestpatch
Sortie :
componentType   availableVersion
--------------- --------------------
gi              12.1.0.2.161018
db              11.2.0.4.161018
db              12.1.0.2.161018
oak             12.1.2.10.0

Commandes logcleanjob

Les commandes suivantes servent à gérer les tâches de nettoyage de journaux :

  • dbcli create-logCleanJob
  • dbcli describe-logCleanJob
  • dbcli list-logCleanJobs

dbcli create-logCleanJob

Utilisez la commande dbcli create-logCleanJob pour créer une tâche de nettoyage de journal.

Syntaxe

dbcli create-logCleanJob 
  [-c {gi|database|dcs}] 
  [-o <number>] 
  [u {Day|Hour|Minute}] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-c --components (Facultatif) Composants. Les valeurs possibles sont gi, database et dcs. Séparez les valeurs multiples par des virgules.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-o --olderThan (Facultatif) Durée de l'intervalle. Valeur par défaut : 30. Nettoie les journaux antérieurs à l'intervalle de temps spécifié (-o et -u).
-u --unit (Facultatif) Unité de l'intervalle. Valeurs possibles : Day, Hour ou Minute. Valeur par défaut : Day. Nettoie les journaux antérieurs à l'intervalle de temps spécifié (-o et -u).

dbcli describe-logCleanJob

Utilisez la commande dbcli describe-logCleanJob pour afficher le sommaire d'une tâche de nettoyage de journaux.

Syntaxe

dbcli describe-logCleanJob 
  -i <job_id> 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --jobid ID de la tâche de nettoyage dont le sommaire doit être affiché.
-j --json (Facultatif) Affiche la sortie JSON.

dbcli list-logCleanJobs

Utilisez la commande dbcli list-logCleanJobs pour lister les tâches de nettoyage de journal.

Syntaxe

dbcli list-logCleanJobs [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes netsecurity

Les commandes suivantes permettent de gérer le chiffrement de réseau dans le système de base de données :

  • dbcli describe-netsecurity
  • dbcli update-netsecurity

dbcli describe-netsecurity

Utilisez la commande dbcli describe-netsecurity pour afficher le paramètre de chiffrement de réseau courant pour un répertoire de base Oracle.

Syntaxe

dbcli describe-netsecurity -H <db_home_id> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-H --dbHomeId Définit l'ID répertoire de base Oracle. Utilisez la commande dbcli list-dbhomes pour obtenir la valeur de dbhomeid.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche le paramètre de chiffrement du répertoire de base spécifié :

dbcli describe-netsecurity -H 16c96a9c-f579-4a4c-a645-8d4d22d6889d
Sortie :
NetSecurity Rules
----------------------------------------------------------------
         DatabaseHomeID: 16c96a9c-f579-4a4c-a645-8d4d22d6889d

                   Role: Server
   EncryptionAlgorithms: AES256 AES192 AES128
    IntegrityAlgorithms: SHA1
         ConnectionType: Required

                   Role: Client
   EncryptionAlgorithms: AES256 AES192 AES128
    IntegrityAlgorithms: SHA1
         ConnectionType: Required

dbcli update-netsecurity

Utilisez la commande dbcli update-netsecurity pour mettre à jour la configuration de la sécurité d'Oracle Net dans le système de base de données.

Syntaxe

dbcli update-netsecurity 
  {-c|-s} 
  -t {REJECTED|ACCEPTED|REQUESTED|REQUIRED} 
  -H <db_home_id> 
  -e {AES256|AES192|AES128} 
  -i {SHA1|SHA512|SHA384|SHA256} 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-c --client

Indique que la configuration du chiffrement ou de l'intégrité des données spécifiée est propre au client. (--client et --server s'excluent mutuellement.)

-e -- encryptionAlgorithms Définit l'algorithme de chiffrement à utiliser. Spécifiez AES256, AES192 ou AES128.
-H --dbHomeId Définit l'ID répertoire de base Oracle. Utilisez la commande dbcli list-dbhomes pour obtenir la valeur de dbHomeId.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --integrityAlgorithms Définit l'algorithme d'intégrité à utiliser. Spécifiez SHA1, SHA512, SHA384 ou SHA256. Pour Oracle Database 11g, la seule valeur acceptée est SHA1.
-j --json (Facultatif) Affiche la sortie JSON.
-s --server Indique que la configuration du chiffrement ou de l'intégrité des données spécifiée est propre au serveur. (--client et --server s'excluent mutuellement.)
-t --connectionType

Indique le mode de négociation du chiffrement ou de l'intégrité des données Oracle Net Services avec les clients. Les valeurs suivantes sont listées par ordre croissant de sécurité :

REJECTED - N'active pas le chiffrement ni l'intégrité des données, même s'ils sont requis par le client.

ACCEPTED - Active le chiffrement ou l'intégrité des données si le client l'exige ou le demande.

REQUESTED - Active le chiffrement ou l'intégrité des données si le client le permet.

REQUIRED - Active le chiffrement ou l'intégrité des données, ou empêcher la connexion.

Exemple

La commande suivante met à jour le type de connexion à ACCEPTED :

dbcli update-netsecurity -H a2ffbb07-c9c0-4467-a458-bce4d3b76cd5 -t ACCEPTED

Commandes objectstoreswift

Vous pouvez sauvegarder une base de données dans un seau existant du service de stockage d'objets pour Oracle Cloud Infrastructure à l'aide de la commande dbcli create-backup, mais vous devrez d'abord :

  1. Créer, dans le système de base de données, un magasin d'objets qui contient le point d'extrémité et les données d'identification permettant d'accéder au service de stockage d'objets, à l'aide de la commande dbcli create-objectstoreswift.
  2. Créer une configuration de sauvegarde qui référence l'ID magasin d'objets et le nom du seau à l'aide de la commande dbcli create-backupconfig.
  3. Associer la configuration de sauvegarde à la base de données à l'aide de la commande dbcli update-database.

Les commandes suivantes permettent de gérer les magasins d'objets.

  • dbcli create-objectstoreswift
  • dbcli describe-objectstoreswift
  • dbcli list-objectstoreswifts

dbcli create-objectstoreswift

Utilisez la commande dbcli create-objectstoreswift pour créer un magasin d'objets.

Syntaxe

dbcli create-objectstoreswift 
  -n <object_store_name> 
  -t <object_storage_namespace> 
  -u <user_name> 
  -e https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 
  -p <password>
  [-h] [-j]

où <object_storage_namespace> est l'espace de noms du stockage d'objets de votre location.

Paramètres

Paramètre Nom complet Description
-e --endpointurl

URL de point d'extrémité suivante : https://swiftobjectstorage.<region_name>.oraclecloud.com/v1
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-n --name

Nom du magasin d'objets à créer.

-p --swiftpassword

Jeton d'authentification généré à l'aide de la console ou de l'API GIA. Pour plus d'informations sur la génération d'un jeton d'authentification à utiliser avec Swift, voir Gestion des données d'identification des utilisateurs.

Il ne s'agit pas du mot de passe de l'utilisateur Oracle Cloud Infrastructure.

Indiquez -p (sans mot de passe) pour afficher l'invite.

Indiquez -hp "<password>" entre guillemets pour fournir le mot de passe (jeton d'authentification) dans la commande.

-t --tenantname Espace de noms du stockage d'objets de votre location.
-u --username Nom d'utilisateur du compte d'utilisateur Oracle Cloud Infrastructure, par exemple : -u djones@example.com

Il s'agit du nom d'utilisateur que vous utilisez pour vous connecter à la console.

Le nom d'utilisateur doit avoir accès au stockage d'objets au niveau location. La méthode la plus simple consiste à ajouter ce nom d'utilisateur au groupe d'administrateurs. Toutefois, elle accorde l'accès à tous les services en nuage. Il est préférable qu'un administrateur crée une politique accordant l'accès au niveau location au stockage d'objets uniquement. L'exemple suivant illustre une telle politique. 

Allow group DBAdmins to manage buckets in tenancy
Allow group DBAdmins to manage objects in tenancy

Pour plus d'informations sur l'ajout d'un utilisateur à un groupe, voir Gestion des groupes. Pour plus d'informations, voir Introduction aux politiques.

Exemple

La commande suivante crée un magasin d'objets et demande le mot de passe Swift :

dbcli create-objectstoreswift -n r2swift -t MyObjectStorageNamespace -u djones@example.com -e https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 -p
Sortie :
Password for Swift:
{
  "jobId" : "c565bb71-f67b-4fab-9d6f-a34eae36feb7",
  "status" : "Created",
  "message" : "Create object store swift",
  "reports" : [ ],
  "createTimestamp" : "January 19, 2017 11:11:33 AM PST",
  "resourceList" : [ {
    "resourceId" : "8a0fe039-f5d4-426a-8707-256c612b3a30",
    "resourceType" : "ObjectStoreSwift",
    "jobId" : "c565bb71-f67b-4fab-9d6f-a34eae36feb7",
    "updatedTime" : "January 19, 2017 11:11:33 AM PST"
  } ],
  "description" : "create object store:biyanr2swift",
  "updatedTime" : "January 19, 2017 11:11:33 AM PST"
}

dbcli describe-objectstoreswift

Utilisez la commande dbcli describe-objectstoreswift pour afficher les détails d'un magasin d'objets.

Syntaxe

dbcli describe-objectstoreswift 
  -i <object_store_swift_id> 
  -in <object_store_swift_name> 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --objectstoreswiftid ID du magasin d'objets. Utilisez la commande dbcli list-objectstoreswifts pour obtenir l'ID.
-in --objectstoreswiftName Nom du magasin d'objets. Utilisez la commande dbcli list-objectstoreswifts pour obtenir le nom.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche des informations détaillées sur un magasin d'objets :

dbcli describe-objectstoreswift -i 910e9e2d-25b4-49b4-b88e-ff0332f7df87
Sortie :
Object Store details
----------------------------------------------------------------
                     ID: 910e9e2d-25b4-49b4-b88e-ff0332f7df87
                   Name: objstrswift15
               UserName: djones@example.com
             TenantName: CompanyABC
           endpoint URL: https://swiftobjectstorage.<region_name>.oraclecloud.com/v1
            CreatedTime: November 16, 2016 11:25:34 PM UTC
            UpdatedTime: November 16, 2016 11:25:34 PM UTC

dbcli list-objectstoreswifts

Utilisez la commande dbcli list-objectstoreswifts pour lister les magasins d'objets d'un système de base de données.

Syntaxe

dbcli list-objectstoreswifts [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante liste les magasins d'objets du système de base de données :

dbcli list-objectstoreswifts
Sortie :
ID                                       Name                 UserName              TenantName     Url                                                         createTime
---------------------------------------- -------------------- --------------------  -------------- ------ ---------------------------------------------------- -----------------------------------
2915bc6a-6866-436a-a38c-32302c7c4d8b     swiftobjstr1         djones@example.com    LargeComputers https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 November 10, 2016 8:42:18 PM UTC
910e9e2d-25b4-49b4-b88e-ff0332f7df87     objstrswift15        djones@example.com    LargeComputers https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 November 16, 2016 11:25:34 PM UTC

Commande pendingjob

dbcli list-pendingjobs

Utilisez la commande dbcli list-pendingjobs pour afficher une liste des tâches en attente.

Syntaxe

dbcli list-pendingjobs [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes rmanbackupreport

Les commandes suivantes permettent de gérer les rapports de sauvegarde RMAN :

  • dbcli create-rmanbackupreport
  • dbcli delete-rmanbackupreport
  • dbcli describe-rmanbackupreport
  • dbcli list-rmanbackupreports

dbcli create-rmanbackupreport

Utilisez la commande dbcli create-rmanbackupreport pour créer un rapport de sauvegarde RMAN.

Syntaxe

dbcli create-rmanbackupreport 
  -w {summary|detailed} 
  -rn <name> 
  [-i <db_id>] 
  [-in <db_name>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --dbid (Facultatif) ID de la ressource de base de données.
-in --dbname (Facultatif) Nom de la ressource de base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-rn --rptname Nom du rapport de sauvegarde RMAN. Nombre maximal de caractères : 30. Si des caractères spéciaux sont utilisés, indiquez le nom entre apostrophes.
-w --reporttype Type de rapport de sauvegarde RMAN. Valeurs possibles : summary ou detailed.

dbcli delete-rmanbackupreport

Utilisez la commande dbcli delete-rmanbackupreport pour supprimer un rapport de sauvegarde RMAN.

Syntaxe

dbcli delete-rmanbackupreport 
  [-d <db_id>] 
  [-dn <db_name>] 
  [-n <number>] 
  [-i <rpt_id>] 
  [-in <rpt_name>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-d --dbid (Facultatif) ID de la ressource de base de données.
-dn --dbname (Facultatif) Nom de la ressource de base de données.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --reportid (Facultatif) ID rapport de sauvegarde RMAN.
-in --rptname (Facultatif) Nom du rapport de sauvegarde RMAN.
-j --json (Facultatif) Affiche la sortie JSON.
-n --numofday (Facultatif) Nombre de jours depuis la création (fourni avec l'ID/le nom de la base de données)

dbcli describe-rmanbackupreport

Utilisez la commande dbcli describe-rmanbackupreport pour

Syntaxe

dbcli describe-rmanbackupreport 
  [-i <rpt_id>] 
  [-in <rpt_name>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --id (Facultatif) ID rapport de sauvegarde RMAN.
-in --name (Facultatif) Nom du rapport de sauvegarde RMAN.
-j --json (Facultatif) Affiche la sortie JSON.

dbcli list-rmanbackupreports

Utilisez la commande dbcli list-rmanbackupreports pour

Syntaxe

dbcli list-rmanbackupreports 
  [-i <db_id>] 
  [-in <db_name>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --dbid (Facultatif) ID de la ressource de base de données.
-in --dbName (Facultatif) Nom de la ressource de base de données.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes schedule

Les commandes suivantes permettent de gérer les programmes :

  • dbcli describe-schedule
  • dbcli list-schedules
  • dbcli update-schedule

dbcli describe-schedule

Utilisez la commande dbcli describe-schedule pour décrire un programme.

Syntaxe

dbcli describe-schedule -i <id> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --scheduleid ID programme.
-j --json (Facultatif) Affiche la sortie JSON.

dbcli list-schedules

Utilisez la commande dbcli list-schedules pour lister les programmes.

Syntaxe

dbcli list-schedules [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

dbcli update-schedule

Utilisez la commande dbcli update-schedule pour mettre à jour un programme.

Syntaxe

dbcli update-schedule 
  -i <id> 
  [-x <expression>] 
  [-t <description>] 
  [-d] 
  [-e] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-d --disable (Facultatif) Désactive le programme.
-e --enable (Facultatif) Active le programme.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --scheduleid ID programme.
-j --json (Facultatif) Affiche la sortie JSON.
-t --description (Facultatif) Description.
-x --cronExpression (Facultatif) Expression cron. Utilisez cronmaker.com pour générer une expression cron valide.

Commande scheduledexecution

dbcli list-scheduledExecutions

Utilisez la commande dbcli list-scheduledExecutions pour lister les exécutions programmées.

Syntaxe

dbcli list-scheduledExecutions 
  [-e <execution_id>] 
  [-i <schedule_id>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-e --executionid (Facultatif) ID exécution.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --scheduleid (Facultatif) ID programme.
-j --json (Facultatif) Affiche la sortie JSON.

Commande server

dbcli update-server

Note :

Votre système de base de données ne comporte peut-être pas cette commande récente. En cas de difficulté à l'exécuter, utilisez la commande de mise à jour de l'interface de ligne de commande pour mettre à jour l'interface de ligne de commande de base de données et réessayez.

Utilisez la commande dbcli update-server pour appliquer des correctifs aux composants de serveur du système de base de données. Pour plus d'informations sur l'application de correctifs, voir Mettre à jour un système de base de données.

Syntaxe

dbcli update-server 
  [-n <number>] 
  [--local] 
  [--precheck] 
  [-v]
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-l --local

(Facultatif) Effectue l'opération sur le noeud local d'un système à haute disponibilité à plusieurs noeuds. Ce paramètre n'est pas nécessaire pour effectuer l'opération sur un système à un seul noeud.

-n --node

(Facultatif) Numéro du noeud à mettre à jour. Utilisez la commande dbcli list-nodes pour obtenir le numéro du noeud.

-p --precheck

(Facultatif) Exécute des opérations de vérification des préalables.

-v --version (Facultatif) Version à mettre à jour.

Exemples

Les commandes suivantes mettent à jour le serveur et affichent la sortie de la tâche de mise à jour :

dbcli update-server
Sortie :
{
  "jobId" : "9a02d111-e902-4e94-bc6b-9b820ddf6ed8",
  "status" : "Created",
  "reports" : [ ],
  "createTimestamp" : "January 19, 2017 09:37:11 AM PST",
  "resourceList" : [ ],
  "description" : "Server Patching",
  "updatedTime" : "January 19, 2017 09:37:11 AM PST"
}
dbcli describe-job -i 9a02d111-e902-4e94-bc6b-9b820ddf6ed8
Sortie :
Job details
----------------------------------------------------------------
                     ID:  9a02d111-e902-4e94-bc6b-9b820ddf6ed8
            Description:  Server Patching
                 Status:  Running
                Created:  January 19, 2017 9:37:11 AM PST
                Message:

Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------
Create Patching Repository Directories   January 19, 2017 9:37:11 AM PST     January 19, 2017 9:37:11 AM PST     Success
Download latest patch metadata           January 19, 2017 9:37:11 AM PST     January 19, 2017 9:37:11 AM PST     Success
Update System version                    January 19, 2017 9:37:11 AM PST     January 19, 2017 9:37:11 AM PST     Success
Update Patching Repository               January 19, 2017 9:37:11 AM PST     January 19, 2017 9:38:35 AM PST     Success
oda-hw-mgmt upgrade                      January 19, 2017 9:38:35 AM PST     January 19, 2017 9:38:58 AM PST     Success
Opatch updation                          January 19, 2017 9:38:58 AM PST     January 19, 2017 9:38:58 AM PST     Success
Patch conflict check                     January 19, 2017 9:38:58 AM PST     January 19, 2017 9:42:06 AM PST     Success
apply clusterware patch                  January 19, 2017 9:42:06 AM PST     January 19, 2017 10:02:32 AM PST    Success
Updating GiHome version                  January 19, 2017 10:02:32 AM PST    January 19, 2017 10:02:38 AM PST    Success

La commande suivante ne met à jour que le noeud 0 du serveur, avec vérification préalable :

dbcli update-server -n 0 -p
Sortie :
{
  "jobId" : "3e2a1e3c-83d3-4101-86b8-4d525f3f8c18",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : "April 26, 2019 06:07:27 AM UTC",
  "resourceList" : [ ],
  "description" : "Server Patching Prechecks",
  "updatedTime" : "April 26, 2019 06:07:27 AM UTC"
}

Commande system

dbcli describe-system

Utilisez la commande dbcli describe-system pour afficher des informations détaillées sur le système. Dans un système de base de données RAC à 2 noeuds, cette commande fournit des informations sur le noeud local.

Syntaxe

dbcli describe-system [-b] [-d] [-h] [-j]

Paramètres

Paramètre Nom complet Description
-b --bom (Facultatif) Affiche des informations sur la nomenclature.

-d

--details

 (Facultatif) Affiche des informations supplémentaires sur le système de base de données, notamment la version de l'interface CLI et de l'agent dcs.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes TDE

Les commandes suivantes servent à gérer les éléments liés au chiffrement transparent des données (rapports de sauvegarde, clés et portefeuilles) :

  • dbcli list-tdebackupreports
  • dbcli update-tdekey
  • dbcli recover-tdewallet

dbcli list-tdebackupreports

Utilisez la commande dbcli list-tdebackupreports pour lister les rapports de sauvegarde des portefeuille TDE.

Syntaxe

dbcli  list-tdebackupreports 
  [-i <db_id>] 
  [-in <db_name>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-i --dbResid (Facultatif) Affiche les rapports de sauvegarde de portefeuille TDE pour l'ID ressource de base de données spécifié. Utilisez la commande dbcli list-databases pour obtenir l'ID ressource de base de données.
-in --dbResname (Facultatif) Affiche les rapports de sauvegarde de portefeuille TDE pour le nom de ressource de base de données spécifié. Utilisez la commande dbcli list-databases pour obtenir le nom de la ressource de base de données.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante liste les rapports de sauvegarde des portefeuilles TDE :

dbcli list-tdebackupreports
Sortie :
DbResID 			            	OraDbId			BackupLocation
--------------------------------------- --------------------	----------------------------------------
538ca5b1-654d-4418-8ce1-f49b6c987a60	1257156075 		https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/dbaasimage/backuptest/host724007/tdewallet/Testdb5/1257156075/2017-08-17/TDEWALLET_BMC60_2017-08-17_10-58-17.0990.tar.gz
538ca5b1-9fb2-4245-b157-6e25d7c988c5 	704287483 		https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/dbaasimage/backuptest/host724007/tdewallet/Testdb1/704287483/2017-08-17/TDEWALLET_AUTO_2017-08-17_11-03-25.0953.tar.gz
538ca5b1-9fb2-4245-b157-6e25d7c988c5 	704287483 		https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/dbaasimage/backuptest/host724007/tdewallet/Testdb1/704287483/2017-08-17/TDEWALLET_BMC62_2017-08-17_11-04-41.0264.tar.gz
19714ffa-de1b-4433-9188-c0592887e609 	1157116855 		https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/dbaasimage/backuptest/host724007/tdewallet/Testdb7/1157116855/2017-08-17/TDEWALLET_AUTO_2017-08-17_11-57-47.0605.tar.gz

dbcli update-tdekey

Utilisez la commande dbcli update-tdekey pour mettre à jour la clé de chiffrement TDE dans le portefeuille TDE. Vous pouvez mettre à jour la clé de chiffrement des bases de données enfichables (si -pdbNames est spécifié) ou de la base de données conteneur (si -rootDatabase est spécifié).

Syntaxe

dbcli update-tdekey 
  -i <db_id> 
  -p [-all] 
  -n <pdbname1,pdbname2> 
  [-r|-no-r] 
  -t <tag_name> 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-all --allPdbNames

(Facultatif) Indicateur de rotation (mise à jour) de tous les noms de base de données enfichable. Pour mettre à jour tous les noms de base de données enfichable, au lieu des noms spécifiés seulement, utilisez ce paramètre à la place de -n. Valeur par défaut : false.

-i --databaseId

Définit l'ID base de données pour lequel mettre à jour la clé.
-p --password

Définit le mot de passe du portefeuille de l'administrateur TDE Indiquez -p sans mot de passe. Vous serez invité à entrer le mot de passe.

Si vous devez fournir le mot de passe dans la commande, par exemple dans un script, utilisez -hp <password> au lieu de -p.

-n --pdbNames Définit les noms de base de données enfichable devant faire l'objet d'une rotation (mise à jour).

-r

-no-r

--rootDatabase

--no-rootDatabase

 Indique si la rotation de la clé de la base de données racine doit être effectuée s'il s'agit d'une base de données conteneur.
-t -tagName Définit la valeur TagName utilisée pour sauvegarder le portefeuille. La valeur par défaut est OdaRotateKey.
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante met à jour la clé de pdb1 et de pdb2 uniquement :

dbcli update-tdekey -dbid ee3eaab6-a45b-4e61-a218-c4ba665503d9 -p -n pdb1,pdb2
Sortie :
TDE Admin wallet password:
{
  "jobId" : "08e5edb1-42e1-4d16-a47f-783c0afa4778",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1467876407035,
  "description" : "TDE update",
  "updatedTime" : 1467876407035
}

La commande suivante met à jour pdb1, pdb2 et la base de données conteneur :

dbcli update-tdekey -dbid ee3eaab6-a45b-4e61-a218-c4ba665503d9 -p -n pdb1,pdb2 -r
Sortie :
TDE Admin wallet password:
{
  "jobId" : "c72385f0-cd81-42df-a8e8-3a1e7cab1278",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1467876433783,
  "description" : "TDE update",
  "updatedTime" : 1467876433783
}

dbcli recover-tdewallet

Utilisez la commande dbcli recover-tdewallet pour récupérer un portefeuille TDE.

Syntaxe

dbcli recover-tdewallet 
  -in <db_name> 
  -tp <password> 
  [-l <location>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide sur l'utilisation de la commande.
-in --dbName Nom de la base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-l --tdeWalletBackuplocation (Facultatif) Emplacement de sauvegarde du portefeuille TDE. Le portefeuille TDE doit être sauvegardé au format tar.gz.
-tp --tdeWalletPassword

Définit le mot de passe du portefeuille de l'administrateur TDE