Riferimento all'interfaccia CLI di Oracle Database

L'interfaccia CLI del database (dbcli) è un'interfaccia della riga di comando disponibile per Base Database Service. Dopo aver eseguito la connessione al sistema DB in Base Database Service, è possibile utilizzare dbcli per eseguire task quali la creazione di home e database Oracle.

Note operative

  • I comandi CLI del database devono essere eseguiti come utente root.

  • dbcli si trova nella directory /opt/oracle/dcs/bin/.

    Questa directory è inclusa nel percorso dell'ambiente dell'utente root.

  • Oracle Database gestisce i log dell'output del comando dbcli nei file dcscli.log e dcs-agent.log nella directory /opt/oracle/dcs/log/.

  • I comandi CLI del database e la maggior parte dei parametri fanno distinzione tra maiuscole e minuscole e devono essere digitati come indicato. Alcuni parametri non fanno distinzione tra maiuscole e minuscole, come indicato nelle descrizioni dei parametri, e possono essere digitati in maiuscolo o minuscolo.

Sintassi

I comandi CLI del database utilizzano la sintassi indicata di seguito.

dbcli command [parameters]

dove:

  • command è una combinazione verbo-oggetto, ad esempio create-database.
  • parameters include altre opzioni per il comando. La maggior parte dei nomi dei parametri sono preceduti da due trattini, ad esempio --help. I nomi dei parametri abbreviati sono preceduti da un trattino, ad esempio -h.
  • I valori dei parametri specificati dall'utente vengono visualizzati in rosso tra parentesi angolari, ad esempio <db_home_id>. Omettere le parentesi angolari quando si specificano questi valori.
  • Il parametro della Guida è disponibile con ogni comando.

Il resto di questo argomento contiene la sintassi e altri dettagli sui comandi.

Comando di aggiornamento CLI

Occasionalmente, nuovi comandi vengono aggiunti all'interfaccia CLI del database e altri comandi vengono aggiornati per supportare nuove funzioni. Per aggiornare l'interfaccia CLI del database, è possibile utilizzare il comando riportato di seguito.

cliadm update-dbcli

Utilizzare il comando cliadm update-dbcli per aggiornare l'interfaccia CLI del database con i comandi nuovi e aggiornati più recenti.

Nota

Nei sistemi DB RAC, eseguire il comando cliadm update-dbcli su ciascun nodo del cluster.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il seguente comando aggiorna dbcli: 

cliadm update-dbcli
Output:
{
  "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"
}

Comandi agente

Per gestire gli agenti è disponibile il comando seguente:

  • dbcli ping-agent

dbcli ping-agent

Utilizzare il comando dbcli ping-agent per verificare la raggiungibilità di un agente.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Comandi Autologcleanpolicy

Sono disponibili i comandi riportati di seguito per gestire i criteri di pulizia automatica (rimozione) dei log.

  • dbcli create-autoLogCleanPolicy
  • dbcli list-autoLogCleanPolicy

dbcli create-autoLogCleanPolicy

Utilizzare il comando dbcli create-autoLogCleanPolicy per creare criteri per la pulizia automatica (rimozione) dei log.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-c --components (Facoltativo) Componenti da rimuovere. I valori possibili sono gi, database e dcs. Utilizzare le virgole per separare più valori. Esempio: gi,dcs
-f --freeSpaceBelowPercentage (Facoltativo) Rimuove i log quando lo spazio libero su disco è inferiore alla percentuale specificata della dimensione totale della partizione. Intervallo valido: 20-50. Valore predefinito: 20.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.
-o --anziano (Facoltativo) Parte quantità dell'intervallo di tempo. Valore predefinito: 30. Esegue la pulizia dei log più vecchi dell'intervallo di tempo specificato (-o e -u).
-u --olderThanUnit (Facoltativo) Parte dell'intervallo di tempo dell'unità. Valori possibili: Giorno, Ora o Minuto. Impostazione predefinita: Giorno. Esegue la pulizia dei log più vecchi dell'intervallo di tempo specificato (-o e -u).
-UMB --usageOverMB (Facoltativo) Rimuove i log quando l'uso dei log supera il numero specificato di MegaBytes (MB). Intervallo valido: dal 10 al 50% della dimensione totale della partizione.
-uPer --usageOverPercentage (Facoltativo) Rimuove i log quando l'uso del log supera la percentuale specificata della dimensione totale della partizione. Intervallo valido: 10-50.

lista dbcli-autoLogCleanPolicy

Utilizzare il comando dbcli list-autoLogCleanPolicy per elencare i criteri per la pulizia automatica dei log.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-c --components (Opzionale) Componenti. I valori possibili sono gi, database e dcs. Utilizzare le virgole per separare più valori. Esempio: gi,dcs
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Comandi di backup

Per eseguire il backup dei database sono disponibili i seguenti comandi:

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

Nota

Anziché utilizzare dbcli, puoi utilizzare la console o l'API per gestire il backup dei database del sistema DB nello storage degli oggetti. Tuttavia, se si passa dall'uso di dbcli all'uso dei backup gestiti, viene creata una nuova configurazione di backup associata al database e i backup creati utilizzando dbcli non saranno accessibili dalle interfacce di backup gestite. Per informazioni sui backup gestiti, vedere Backup e recupero in Base Database Service.

Prima di eseguire il backup di un database utilizzando il comando dbcli create-backup, è necessario effettuare le operazioni riportate di seguito.

  1. Creare una configurazione di backup utilizzando il comando dbcli create-backupconfig.
  2. Associare la configurazione di backup al database utilizzando il comando dbcli update-database.

Dopo aver associato un database a una configurazione di backup, è possibile utilizzare il comando dbcli create-backup in un job cron per eseguire i backup automaticamente. È possibile utilizzare una utility Cron, ad esempio CronMaker, per creare espressioni. Per ulteriori informazioni, vedere CronMaker.

creazione-backup dbcli

Utilizzare il comando dbcli create-backup per creare un backup di un database.

Sintassi

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]

Parametri

Parametro Nome completo Descrizione
-bt --backupType

(Facoltativo) Tipo di backup. I valori possibili sono Regolare-L0, Regolare-L1, Lungo termine e ArchiveLog. Regolare: L0 e regolare: L1 corrispondono ai backup incrementali L0 e L1. A lungo termine corrisponde al backup completo. ArchiveLog corrisponde al backup dei redo log archiviati. Il valore predefinito è Regular-L1. Per i valori non viene fatta distinzione tra casi. Se omesso, verrà utilizzato il valore predefinito.

-c --component

(Facoltativo) Componente. I valori possibili sono Database e TdeWallet. Il valore predefinito è Database. Il valore TdeWallet esegue il backup dei wallet TDE. Per i valori non viene fatta distinzione tra casi. Se omesso, verrà utilizzato il valore predefinito.

Tenere presente che il backup dei wallet TDE viene eseguito automaticamente nelle situazioni riportate di seguito.
  • Viene creato un database con una configurazione di backup dello storage degli oggetti.
  • Viene aggiornato un database con una configurazione di backup dello storage degli oggetti.
  • Una configurazione di backup dello storage degli oggetti viene aggiornata.
  • Viene creato un backup di tipo Longterm.
  • La chiave TDE per un database viene ruotata.
  • Viene eseguito il backup di un database e non esistono ancora backup del wallet TDE.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --dbid L'ID del database di cui eseguire il backup. Utilizzare il comando dbcli list-databases per ottenere l'ID del database.
-nella --dbName Il nome del database di cui eseguire il backup. Utilizzare il comando dbcli list-databases per ottenere il nome del database.
-j --json (Facoltativo) Visualizza l'output JSON.
-k --keepDays

(Facoltativo) Specifica il periodo di tempo fino al quale è necessario conservare il backup o la copia. Dopo questo periodo, il backup è obsoleto, indipendentemente dalle impostazioni dei criteri di conservazione del backup. Solo per il tipo di backup a lungo termine.

-t --tag

(Obbligatorio per il tipo di backup a lungo termine) Specifica un nome tag specificato dall'utente per un backup set e applica questo tag ai file di output generati dal comando. Questo valore non fa riferimento a casi. Numero di caratteri valido: da 1 a 30. I caratteri sono limitati ai caratteri validi nei nomi file nel file system di destinazione. Ad esempio, ASM non supporta l'uso del trattino (-) nei nomi file utilizzati internamente, pertanto Weekly-incremental non è un nome tag valido per i backup nei gruppi di dischi ASM. Variabili di ambiente non valide nel parametro TAG.

Esempi

Il comando seguente crea un backup del database specificato utilizzando l'ID del database.

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

Il comando seguente crea un backup del database specificato utilizzando il nome del database ("mydb").

dbcli create-backup -in mydb

getstatus-backup dbcli

Utilizzare il comando dbcli getstatus-backup per visualizzare lo stato di un backup.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --dbId (Facoltativo) ID risorsa di database.
-nella --dbName (Facoltativo) Nome risorsa di database.
-j --json (Facoltativo) Visualizza l'output JSON.
-l --isLatestBackupReport (Facoltativo) Report di backup più recente. Impostazione predefinita: true.
-t --backupType Tipo di backup.

pianificazione dbcli - backup

Utilizzare il comando dbcli schedule-backup per pianificare un backup di un database.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-f --frequenza Frequenza in minuti.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --dbId (Facoltativo) ID risorsa di database.
-nella --dbName (Facoltativo) Nome risorsa di database.
-j --json (Facoltativo) Visualizza l'output JSON.
-t --backupType Tipo di backup.

Comandi Backupconfig

Una configurazione di backup determina la destinazione del backup e la finestra di recupero per i backup del database. È possibile creare la configurazione di backup e quindi associarla a un database utilizzando il comando dbcli update-database.

Nota

I backup configurati utilizzando la console potrebbero diventare inutilizzabili se si apportano modifiche utilizzando questi comandi. Per i backup configurati mediante la console, utilizzare questi comandi solo con istruzioni di supporto.

Nota

Anziché utilizzare dbcli, puoi utilizzare la console o l'API per gestire il backup dei database nel tuo sistema DB nello storage degli oggetti. Per informazioni sui backup gestiti, vedere Backup e recupero in Base Database Service.

Dopo aver associato un database a una configurazione di backup, è possibile utilizzare il comando dbcli create-backup in un job cron per eseguire i backup automaticamente. È possibile utilizzare una utility Cron, ad esempio CronMaker, per creare espressioni. Per ulteriori informazioni, vedere CronMaker.

Per gestire le configurazioni di backup, sono disponibili i comandi riportati di seguito.

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

creazione-backupconfig dbcli

Utilizzare il comando dbcli create-backupconfig per creare una configurazione di backup che definisca la destinazione del backup e le finestre di recupero.

Sintassi

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]

Parametri

Parametro Nome completo Descrizione
-c --contenitore

Nome di un bucket esistente nel servizio Oracle Cloud Infrastructure Object Storage. Puoi usare la console o l'API di storage degli oggetti per creare il bucket. Per ulteriori informazioni, vedere Gestione dei bucket.

È inoltre necessario specificare --backupdestination objectstore e il parametro --objectstoreswiftId.

-cr

-no-cr

--crosscheck

--nessun controllo incrociato

(Facoltativo) Indica se abilitare l'operazione di controllo incrociato. Questa operazione determina se i file nel disco o nel catalogo di gestione dei supporti corrispondono ai dati nel repository RMAN. Se omesso, viene utilizzata l'impostazione predefinita (il controllo incrociato è abilitato per impostazione predefinita).

-d --destinazione backup

La destinazione di backup è una delle seguenti (questi valori non fanno distinzione tra maiuscole e minuscole):

DISK - L'area locale di recupero rapido.

OBJECTSTORE - Il servizio Oracle Cloud Infrastructure Object Storage. È inoltre necessario specificare i parametri --container e --objectstoreswiftId.

NONE - Disabilita il backup.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.
-n --name Il nome della configurazione di backup.
-o --objectstoreswiftId

ID dell'area di memorizzazione degli oggetti contenente l'endpoint e le credenziali per il servizio Oracle Cloud Infrastructure Object Storage. Utilizzare il comando dbcli list-objectstoreswifts per ottenere l'ID dell'area di memorizzazione degli oggetti. Utilizzare il comando dbcli create-objectstoreswift per creare un'area di memorizzazione degli oggetti.

È inoltre necessario specificare --backupdestination objectstore e il parametro --container.

-attivo --objectstoreswiftName

Nome dell'area di memorizzazione degli oggetti che contiene l'endpoint e le credenziali per il servizio Oracle Cloud Infrastructure Object Storage.

Utilizzare il comando dbcli list-objectstoreswifts per ottenere l'ID dell'area di memorizzazione degli oggetti. Utilizzare il comando dbcli create-objectstoreswift per creare un'area di memorizzazione degli oggetti.

È inoltre necessario specificare --backupdestination objectstore e il parametro --container.

-a --finestra di recupero

Numero di giorni durante i quali vengono gestiti i backup e i redo log archiviati. L'intervallo termina sempre con l'ora corrente e si estende a ritroso per il numero di giorni specificato.

Per una destinazione di backup DISK, specificare da 1 a 14 giorni.

Per una destinazione di backup OBJECTSTORE, specificare da 1 a 30 giorni.

Esempio

Il comando seguente crea una configurazione di backup denominata 'dbbkcfg1':

dbcli create-backupconfig -d Disk -w 7 -n dbbkcfg1
Output:
{
  "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"
}

list-backupconfig dbcli

Utilizzare il comando dbcli list-backupconfigs per elencare tutte le configurazioni di backup nel sistema DB.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente elenca una configurazione di backup:

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

dbcli description-backupconfig

Utilizzare il comando dbcli describe-backupconfig per visualizzare i dettagli relativi a una configurazione di backup specifica.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --backupconfigid L'ID di configurazione del backup. Utilizzare il comando dbcli list-backupconfigs per ottenere l'ID.
-nella --backupconfigname Il nome della configurazione di backup. Utilizzare il comando dbcli list-backupconfigs per ottenere il nome.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente visualizza i dettagli relativi a una configurazione di backup:

dbcli describe-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282d
Output:
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

update-backupconfig dbcli

Utilizzare il comando dbcli update-backupconfig per aggiornare una configurazione di backup esistente.

Sintassi

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]

Parametri

Parametro Nome completo Descrizione
-c --contenitore

Nome di un bucket esistente nel servizio Oracle Cloud Infrastructure Object Storage. Puoi usare la console o l'API di storage degli oggetti per creare il bucket. Per ulteriori informazioni, vedere Gestione dei bucket.

È inoltre necessario specificare --backupdestination objectstore e il parametro --objectstoreswiftId.

-cr

-no-cr

--crosscheck

--nessun controllo incrociato

(Facoltativo) Indica se abilitare l'operazione di controllo incrociato. Questa operazione determina se i file sul disco nel catalogo di gestione dei supporti corrispondono ai dati nel repository RMAN. Se omesso, viene utilizzata l'impostazione predefinita (il controllo incrociato è abilitato per impostazione predefinita).

-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --backupconfigid L'ID della configurazione di backup da aggiornare. Utilizzare il comando dbcli list-backupconfigs per ottenere l'ID.
-nella --backupconfigname Il nome della configurazione di backup da aggiornare. Utilizzare il comando dbcli list-backupconfigs per ottenere il nome.
-j --json (Facoltativo) Visualizza l'output JSON.
-o --objectstoreswiftId

ID dell'area di memorizzazione degli oggetti contenente l'endpoint e le credenziali per il servizio Oracle Cloud Infrastructure Object Storage. Utilizzare il comando dbcli list-objectstoreswifts per ottenere l'ID dell'area di memorizzazione degli oggetti. Utilizzare il comando dbcli create-objectstoreswift per creare un'area di memorizzazione degli oggetti.

È inoltre necessario specificare --backupdestination objectstore e il parametro --container.

-attivo --nome rapido oggetto

Nome dell'area di memorizzazione degli oggetti che contiene l'endpoint e le credenziali per il servizio Oracle Cloud Infrastructure Object Storage. Utilizzare il comando dbcli list-objectstoreswifts per ottenere l'ID dell'area di memorizzazione degli oggetti. Utilizzare il comando dbcli create-objectstoreswift per creare un'area di memorizzazione degli oggetti.

È inoltre necessario specificare --backupdestination objectstore e il parametro --container.

-a --finestra di recupero

La nuova finestra di recupero del disco.

Per una destinazione di backup DISK, specificare da 1 a 14 giorni.

Per una destinazione di backup OBJECTSTORE, specificare da 1 a 30 giorni.

Esempio

Il comando seguente aggiorna la finestra di recupero per una configurazione di backup:

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

delete-backupconfig dbcli

Utilizzare il comando dbcli delete-backupconfig per eliminare una configurazione di backup.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --ID L'ID di configurazione di backup da eliminare. Utilizzare il comando dbcli list-backupconfigs per ottenere l'ID.
-nella --backupconfigname Il nome della configurazione di backup da eliminare. Utilizzare il comando dbcli list-backupconfigs per ottenere il nome.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente elimina la configurazione di backup specificata:

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

Comando componente

descrizione-componente dbcli

Il sistema DB potrebbe non includere questo comando più recente. In caso di problemi durante l'esecuzione del comando, utilizzare il comando CLI Update Command per aggiornare l'interfaccia CLI del database, quindi riprovare a eseguire il comando.

Nota

Il comando dbcli describe-component non è disponibile nei sistemi DB RAC a 2 nodi. L'applicazione di patch ai sistemi a 2 nodi dallo storage degli oggetti non è supportata.

Utilizzare il comando dbcli describe-component per mostrare le versioni di patch installate e disponibili per i componenti server, storage e/o home del database nel sistema DB.

Questo comando richiede una configurazione di credenziali di storage degli oggetti valida. Se la configurazione risulta mancante o non valida, il comando non riesce e restituisce l'errore: Failed to connect to the object store. Please provide valid details.

Per ulteriori informazioni sull'aggiornamento dell'interfaccia CLI, sulla creazione della configurazione delle credenziali e sull'applicazione di patch, vedere Aggiornare un sistema DB.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-d --dbhomes (Facoltativo) Elenca le versioni di patch installate e disponibili solo per i componenti home del database.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.
-s server -- (Facoltativo) Elenca le versioni di patch installate e disponibili solo per i componenti del server.

Esempio

Il comando seguente per mostrare le versioni correnti del componente e le versioni patch disponibili nell'area di memorizzazione degli oggetti:

dbcli describe-component
Output:
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

Comandi del database

Per la gestione dei database sono disponibili i comandi riportati di seguito.

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

clone-database dbcli

Utilizzare il comando dbcli clone-database per duplicare un database.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-f --nome origine Nome database di origine.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.
-m --syspassword (Facoltativo) Password per SYS.
-n --dbname Nome database.
-p --tdepassword (Facoltativo) Password per il wallet TDE di origine.
-s --dbshape (Facoltativo) Forma database. Esempi: odb1, odb2.
-t --dbtype (Facoltativo) Tipo di database: SI
-u --databaseUniqueName Nome univoco del database.

descrizione database dbcli

Utilizzare il comando dbcli describe-database per visualizzare i dettagli del database.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --dbid L'ID del database da visualizzare. Utilizzare il comando dbcli list-databases per ottenere l'ID del database.
-nella --dbName Nome del database da visualizzare. Utilizzare il comando dbcli list-databases per ottenere il nome del database.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente visualizza informazioni per un database denominato b727bf80-c99e-4846-ac1f-28a81a725df6:

dbcli describe-dbhome -i b727bf80-c99e-4846-ac1f-28a81a725df6
Output:
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

lista di database dbcli

Utilizzare il comando dbcli list-databases per elencare tutti i database nel sistema DB.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente visualizza un elenco di database.

dbcli  list-databases
Output:
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

Il comando seguente visualizza l'output JSON per un database:

dbcli list-databases -j
Output:
[ {
  "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"
}

modifica database dbcli

Utilizzare il comando dbcli modify-database per modificare un database.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
- dh --destdbhomeid ID home del database di destinazione.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --databaseid ID database.
-j --json (Facoltativo) Visualizza l'output JSON.

recupero database dbcli

Utilizzare il comando dbcli recover-database per recuperare un database.

Sintassi

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]

Parametri

Parametro Nome completo Descrizione
-br --backupReport (Facoltativo) Input JSON per il report di backup.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --dbid (Facoltativo) ID risorsa di database.
-nella --dbName (Facoltativo) Nome del database.
-j --json (Facoltativo) Visualizza l'output JSON.
-l --tdeWalletLocation (Facoltativo) Posizione del backup del wallet TDE. Il backup del wallet TDE deve essere eseguito in formato tar.gz.
-r --recoveryTimeStamp (Obbligatorio quando il tipo di recupero è PITR) Indicatore orario di recupero nel formato mm/dd/yyyy hh:mi:ss. Predefinita: [ ]
-s --scn (Obbligatorio quando il tipo di recupero è SCN) SCN.
-t --tipo di recupero (Obbligatorio quando viene fornito il report di backup) Tipo di recupero. I valori possibili sono Ultimo, PITR e SCN.
-tp --tdeWalletPassword (Facoltativo) Password del wallet TDE.

registro dbcli - database

Utilizzare il comando dbcli register-database per registrare un database di cui è stata eseguita la migrazione a Oracle Cloud Infrastructure. Il comando registra il database in dcs-agent in modo che possa essere gestito dallo stack dcs-agent.

Nota

Il comando dbcli register-database non è disponibile nei sistemi DB RAC a 2 nodi.

Sintassi

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]

Parametri

Parametro Nome completo Descrizione
-bi --backupconfigid Definisce l'ID di configurazione del backup. Utilizzare il comando dbcli list-backupconfigs per ottenere l'ID.
-c --classe db Definisce la classe di database. Le opzioni disponibili sono OLTP, DSS o IMDB. L'impostazione predefinita è OLTP. Per le edizioni Enterprise sono supportate tutte e tre le classi. Per la Standard Edition è supportato solo OLTP.

-co

-no-co

--dbconsole

--no-dbconsole

(Facoltativo) Indica se la console del database è abilitata o meno. Se omessa, la console non è abilitata.

-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.
-o --hostname (Opzionale) Definisce il nome host del database. L'impostazione predefinita è Local host name.
-p --syspassword

Definisce una password sicura per SYS. Specificare -p senza password. Verrà richiesto di immettere la password.

Se è necessario fornire la password nel comando, ad esempio in uno script, utilizzare -hp <password> anziché -p.

-s --dbshape Definisce il modello di dimensionamento del database da utilizzare per il database. Ad esempio, odb1, odb2 e odb3.
-sn --servicename Definisce il nome del servizio di database utilizzato per creare la stringa EZCONNECT per la connessione al database. Il formato della stringa di connessione è hostname:port/servicename.
-t --dbtype (Facoltativo) Definisce il tipo di database come nodo singolo (SI). Il valore predefinito è SI.
-tp --tdeWalletPassword

(Facoltativo) Password per il wallet TDE. Obbligatorio se TDE è abilitato nel database di cui è stata eseguita la migrazione.

Esempio

Il comando seguente registra il database con la classe di database, il nome del servizio e il modello di dimensionamento del database specificati.

dbcli register-database -c OLTP -s odb1 -sn crmdb.example.com -p
Output:
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"
}

aggiornamento dbcli - database

Utilizzare il comando dbcli update-database per associare una configurazione di backup a un database.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-bi --backupconfigid Definisce l'ID di configurazione del backup. Utilizzare il comando dbcli list-backupconfigs per ottenere l'ID.
-cesto --backupconfigname Definisce il nome della configurazione di backup per uso futuro. Utilizzare il comando dbcli list-backupconfigs per ottenere il nome.
-id --databaseid

Questa colonna è facoltativa. Specifica il DBID, che è un numero di identificazione univoco a 32 bit calcolato al momento della creazione del database. RMAN visualizza il DBID al momento della connessione al database di destinazione. È possibile ottenere il DBID eseguendo una query sulla vista V$DATABASE o sulle viste del Recovery Catalog RC_DATABASE e RC_DATABASE_INCARNATION.
-nella --dbName

Definisce il nome del database da aggiornare. Utilizzare il comando dbcli list-databases per ottenere il nome del database.

-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --dbid Definisce l'ID del database da aggiornare. Utilizzare il comando dbcli list-databases per ottenere l'ID del database.
-j --json (Facoltativo) Visualizza l'output JSON.
-senza ab --nessun backup automatico

(Facoltativo) Disabilita i backup automatici per il database specificato.

Una volta disabilitato, il backup automatico non può essere riabilitato utilizzando l'interfaccia CLI. Per riabilitare il backup automatico, utilizzare la console.

Esempio

Il comando seguente associa un file di configurazione di backup a un database:

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

Comandi Dbhome

Per gestire le home del database sono disponibili i comandi riportati di seguito.

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

dbcli create-dbhome

Utilizzare il comando dbcli create-dbhome per creare una home Oracle Database.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.
-v --version Definisce la versione della home database.

Esempio

Il comando seguente crea una Oracle Database home versione 12.1.0.2:

dbcli create-dbhome -v 12.1.0.2

descrizione dbcli - dbhome

Utilizzare il comando dbcli describe-dbhome per visualizzare i dettagli della home di Oracle Database.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --dbhomeid Identifica l'ID home del database. Utilizzare il comando dbcli list-dbhomes per ottenere l'ID.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

L'output riportato di seguito è un esempio di utilizzo del comando Visualizza dettagli della home di Oracle Database.

dbcli describe-dbhome -i 52850389-228d-4397-bbe6-102fda65922b
Output:
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

Utilizzare il comando dbcli delete-dbhome per eliminare una home del database dal sistema DB.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --dbhomeid Identifica l'ID home del database da eliminare. Utilizzare il comando dbcli list-dbhomes per ottenere l'ID.
-j --json (Facoltativo) Visualizza l'output JSON.

elenco-dbhomes dbcli

Utilizzare il comando dbcli list-dbhomes per visualizzare una lista delle directory della Oracle home.

Sintassi

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

Parametro

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente visualizza un elenco di directory Oracle home.

dbcli  list-dbhomes
Output:
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

Nota

Il sistema DB potrebbe non includere questo comando più recente. In caso di problemi durante l'esecuzione del comando, utilizzare il comando CLI Update per aggiornare l'interfaccia CLI del database, quindi riprovare a eseguire il comando.

Utilizzare il comando dbcli update-dbhome per applicare la patch del bundle DBBP a una home del database. Per ulteriori informazioni sull'applicazione delle patch, vedere Aggiornare un sistema DB.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --dbhomeid ID della home del database. Utilizzare il comando dbcli list-dbhomes per ottenere l'ID.
-j --json (Facoltativo) Visualizza l'output JSON.
-n --node

(Facoltativo) Numero di nodo da aggiornare. Utilizzare il comando dbcli list-nodes per ottenere il numero di nodo.

 -l --locale

(Facoltativo) Esegue l'operazione sul nodo locale di un sistema HA (High Availability) multi-nodo. Questo parametro non è necessario per eseguire l'operazione su un sistema a nodo singolo.

 -p --controllo preliminare

(Facoltativo) Esegue le operazioni di controllo preliminare per controllare i prerequisiti.

Esempio

I comandi seguenti aggiornano la home del database e mostrano l'output del job di aggiornamento:

dbcli update-dbhome -i e1877dac-a69a-40a1-b65a-d5e190e671e6
Output:
{
  "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
Output:
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

Comandi di Dbstorage

Per gestire lo storage del database sono disponibili i comandi riportati di seguito.

  • dbcli list-dbstorages
  • dbcli describe-dbstorage

list-dbstorages dbcli

Utilizzare il comando dbcli list-dbstorages per elencare lo storage del database nel sistema DB.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente visualizza i dettagli relativi allo storage del database:

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

descrizione dbcli - dbstorage

Utilizzare il comando dbcli describe-dbstorage per visualizzare informazioni dettagliate su una risorsa di memorizzazione del database specifica.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --ID Definisce l'ID di storage del database. Utilizzare il comando dbcli list-dbstorages per ottenere l'ID di memorizzazione del database.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente visualizza i dettagli di memorizzazione del database per 105a2db2-625a-45ba-8bdd-ee46da0fd83a:

dbcli describe-dbstorage -i 105a2db2-625a-45ba-8bdd-ee46da0fd83a
Output:
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

Comandi Dgconfig

elenco-dgconfig dbcli

Utilizzare il comando dbcli list-dgconfigs per elencare le configurazioni DG.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Comandi job

Per gestire i job sono disponibili i comandi riportati di seguito.

  • dbcli describe-job
  • dbcli list-jobs

job di descrizione dbcli

Utilizzare il comando dbcli describe-job per visualizzare i dettagli relativi a un job specifico.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --jobid Identifica la mansione. Utilizzare il comando dbcli list-jobs per ottenere l'ID job.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente visualizza i dettagli relativi all'ID job specificato:

dbcli describe-job -i 74731897-fb6b-4379-9a37-246912025c17
Output:
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

list-job dbcli

Utilizzare il comando dbcli list-jobs per visualizzare una lista di job, inclusi gli ID, lo stato e il job

data e ora di creazione.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente visualizza un elenco di job.

dbcli list-jobs
Output:
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

Comando Latestpatch

descrizione dbcli - patch più recente

Nota

  • Il sistema DB potrebbe non includere questo comando più recente. In caso di problemi durante l'esecuzione del comando, utilizzare il comando CLI Update per aggiornare l'interfaccia CLI del database, quindi riprovare a eseguire il comando.
  • Il comando dbcli describe-latestpatch non è disponibile nei sistemi DB RAC a 2 nodi. L'applicazione di patch ai sistemi a 2 nodi dallo storage degli oggetti non è supportata.

Utilizzare il comando dbcli describe-latestpatch per visualizzare le patch più recenti applicabili al sistema DB e disponibili in Oracle Cloud Infrastructure Object Storage.

Questo comando richiede una configurazione di credenziali di storage degli oggetti valida. Se la configurazione risulta mancante o non valida, il comando non riesce e restituisce l'errore: Failed to connect to the object store. Please provide valid details.

Per ulteriori informazioni sull'aggiornamento dell'interfaccia CLI, sulla creazione della configurazione delle credenziali e sull'applicazione di patch, vedere Aggiornare un sistema DB.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente visualizza le patch disponibili nell'area di memorizzazione degli oggetti:

dbcli describe-latestpatch
Output:
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

Comandi Logcleanjob

Sono disponibili i comandi riportati di seguito per gestire i job di pulizia dei log.

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

dbcli create-logCleanJob

Utilizzare il comando dbcli create-logCleanJob per creare un job di pulizia dei log.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-c --components (Opzionale) Componenti. I valori possibili sono gi, database e dcs. Separare più valori mediante virgole.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.
-o --olderThan (Facoltativo) Parte quantità dell'intervallo di tempo. Valore predefinito: 30. Esegue la pulizia dei log più vecchi dell'intervallo di tempo specificato (-o e -u).
-u --unità (Facoltativo) Parte dell'intervallo di tempo dell'unità. Valori possibili: Giorno, Ora o Minuto. Impostazione predefinita: Giorno. Esegue la pulizia dei log più vecchi dell'intervallo di tempo specificato (-o e -u).

descrizione dbcli-logCleanJob

Utilizzare il comando dbcli describe-logCleanJob per visualizzare il riepilogo di un job di pulizia dei log.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --jobid ID del job di pulizia del log per il quale visualizzare il riepilogo.
-j --json (Facoltativo) Visualizza l'output JSON.

lista dbcli-logCleanJobs

Utilizzare il comando dbcli list-logCleanJobs per elencare i job di pulizia dei log.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Comandi di Netsecurity

Per gestire la cifratura di rete nel sistema DB sono disponibili i comandi riportati di seguito.

  • dbcli describe-netsecurity
  • dbcli update-netsecurity

dbcli description-netsecurity

Utilizzare il comando dbcli describe-netsecurity per visualizzare l'impostazione di cifratura di rete corrente per una home del database.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --dbHomeId Definisce l'ID home del database. Utilizzare il comando dbcli list-dbhomes per ottenere il dbhomeid.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente visualizza l'impostazione di cifratura per la home del database specificata:

dbcli describe-netsecurity -H 16c96a9c-f579-4a4c-a645-8d4d22d6889d
Output:
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

Utilizzare il comando dbcli update-netsecurity per aggiornare la configurazione di sicurezza di Oracle Net nel sistema DB.

Sintassi

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]

Parametri

Parametro Nome completo Descrizione
-c --client

Indica che la cifratura dei dati o la configurazione di integrità dei dati specificata si riferiscono al client (--client e --server si escludono a vicenda).

-e -- encryptionAlgorithms Definisce l'algoritmo da utilizzare per la cifratura. Specificare AES256, AES192 o AES128.
-H --dbHomeId Definisce l'ID home del database. Utilizzare il comando dbcli list-dbhomes per ottenere il comando dbHomeId.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --integrityAlgorithms Definisce l'algoritmo da utilizzare per l'integrità. Specificare SHA1, SHA512, SHA384 o SHA256. Per Oracle Database 11g, l'unico valore accettato è SHA1.
-j --json (Facoltativo) Visualizza l'output JSON.
-s server -- Indica che la cifratura dei dati o la configurazione di integrità dei dati specificata è per il server. (--client e --server si escludono a vicenda).
-t --connectionType

Specifica le modalità di negoziazione della cifratura o dell'integrità dei dati di Oracle Net Services con i client. I valori elencati di seguito sono elencati in ordine di maggiore sicurezza.

RIFIUTATO - Non abilitare la cifratura dei dati o l'integrità dei dati, anche se richiesto dal client.

ACCETTATO - Abilita la cifratura dei dati o l'integrità dei dati se richiesto o richiesto dal client.

RICHIESTA - Abilitare la crittografia dei dati o l'integrità dei dati se il client lo consente.

OBBLIGATORIO - Abilita la crittografia dei dati o l'integrità dei dati o preclude la connessione.

Esempio

Il comando seguente aggiorna il tipo di connessione su ACCEPTED:

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

Comandi Objectstoreswift

Puoi eseguire il backup di un database in un bucket esistente nel servizio Oracle Cloud Infrastructure Object Storage utilizzando il comando dbcli create-backup, ma prima dovrai:

  1. Creare un'area di memorizzazione degli oggetti nel sistema DB contenente l'endpoint e le credenziali per accedere allo storage degli oggetti utilizzando il comando dbcli create-objectstoreswift.
  2. Creare una configurazione di backup che faccia riferimento all'ID dell'area di memorizzazione degli oggetti e al nome del bucket utilizzando il comando dbcli create-backupconfig.
  3. Associare la configurazione di backup al database utilizzando il comando dbcli update-database.

Per gestire le aree di memorizzazione degli oggetti sono disponibili i comandi riportati di seguito.

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

dbcli create-objectstoreswift

Utilizzare il comando dbcli create-objectstoreswift per creare un'area di memorizzazione degli oggetti.

Sintassi

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]

dove <object_storage_namespace> è lo spazio di nomi dello storage degli oggetti della tenancy.

Parametri

Parametro Nome completo Descrizione
-e --endpointurl

URL endpoint seguente. https://swiftobjectstorage.<region_name>.oraclecloud.com/v1
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.
-n --name

Nome dell'area di memorizzazione degli oggetti da creare.

-p --password di spostamento

Token di autenticazione generato mediante la console o l'API IAM. Per informazioni sulla generazione di un token di autenticazione da utilizzare con Swift, vedere Gestione delle credenziali utente.

Questa non è la password per l'utente di Oracle Cloud Infrastructure.

Specificare -p (senza password) da richiedere.

Specificare -hp "<password> " tra virgolette per fornire la password (token di autenticazione) nel comando.

-t --nome tenant Spazio di nomi dello storage degli oggetti della tenancy.
-u --username Nome utente per l'account utente di Oracle Cloud Infrastructure, ad esempio: -u djones@example.com

Questo è il nome utente utilizzato per collegarsi alla console.

Il nome utente deve disporre dell'accesso a livello di tenancy allo storage degli oggetti. Un modo semplice per farlo è aggiungere il nome utente al gruppo Administrators. Tuttavia, ciò consente l'accesso a tutti i servizi cloud. Un amministratore può invece creare un criterio che consenta l'accesso a livello di tenancy solo allo storage degli oggetti. Di seguito è riportato un esempio di tale politica. 

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

Per ulteriori informazioni sull'aggiunta di un utente a un gruppo, vedere Gestione dei gruppi. Per ulteriori informazioni sui criteri, consulta la Guida introduttiva ai criteri.

Esempio

Il comando seguente crea un'area di memorizzazione degli oggetti e richiede la password Swift:

dbcli create-objectstoreswift -n r2swift -t MyObjectStorageNamespace -u djones@example.com -e https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 -p
Output:
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 description-objectstoreswift

Utilizzare il comando dbcli describe-objectstoreswift per visualizzare i dettagli di un'area di memorizzazione degli oggetti.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --oggettostoreswiftid L'ID dell'area di memorizzazione degli oggetti. Utilizzare il comando dbcli list-objectstoreswifts per ottenere l'ID.
-nella --objectstoreswiftName Nome dell'area di memorizzazione degli oggetti. Utilizzare il comando dbcli list-objectstoreswifts per ottenere il nome.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente visualizza i dettagli di un'area di memorizzazione degli oggetti:

dbcli describe-objectstoreswift -i 910e9e2d-25b4-49b4-b88e-ff0332f7df87
Output:
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

Utilizzare il comando dbcli list-objectstoreswifts per elencare le aree di memorizzazione degli oggetti in un sistema DB.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando riportato di seguito elenca le aree di memorizzazione degli oggetti nel sistema DB.

dbcli list-objectstoreswifts
Output:
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

Comando job in sospeso

list-pendingjobs dbcli

Utilizzare il comando dbcli list-pendingjobs per visualizzare una lista di job in sospeso.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Comandi Rmanbackupreport

Per gestire i report di backup RMAN sono disponibili i comandi riportati di seguito.

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

creazione-rmanbackupreport dbcli

Utilizzare il comando dbcli create-rmanbackupreport per creare un report di backup RMAN.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --dbid (Facoltativo) ID risorsa di database.
-nella --dbname (Facoltativo) Nome risorsa di database.
-j --json (Facoltativo) Visualizza l'output JSON.
-rn --nome reparto Nome del report di backup RMAN. Numero massimo di caratteri: 30. A capo nome racchiuso tra apici quando si utilizzano caratteri speciali.
-a --tipo di report Tipo di report di backup RMAN. Valori possibili: sintetico o dettagliato.

delete-rmanbackupreport dbcli

Utilizzare il comando dbcli delete-rmanbackupreport per eliminare un report di backup RMAN.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-d --dbid (Facoltativo) ID risorsa di database.
-dn --dbname (Facoltativo) Nome risorsa di database.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --ammortizzato (Facoltativo) ID report backup RMAN
-nella --nome reparto (Facoltativo) Nome del report di backup RMAN
-j --json (Facoltativo) Visualizza l'output JSON.
-n --numofday (Facoltativo) Numero di giorni dalla creazione (fornito con ID database/nome database)

descrizione dbcli-rmanbackupreport

Utilizzare il comando dbcli describe-rmanbackupreport per

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --ID (Facoltativo) ID report backup RMAN
-nella --name (Facoltativo) Nome del report di backup RMAN
-j --json (Facoltativo) Visualizza l'output JSON.

elenco-rmanbackupreport dbcli

Utilizzare il comando dbcli list-rmanbackupreports per

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --dbid (Facoltativo) ID risorsa di database.
-nella --dbName (Facoltativo) Nome risorsa di database.
-j --json (Facoltativo) Visualizza l'output JSON.

Pianifica comandi

Per gestire le pianificazioni sono disponibili i seguenti comandi:

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

descrizione-schedulazione dbcli

Usare il comando dbcli describe-schedule per descrivere una pianificazione.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --scheduleid ID schedulazione.
-j --json (Facoltativo) Visualizza l'output JSON.

lista-schedulazioni dbcli

Utilizzare il comando dbcli list-schedules per elencare le pianificazioni.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

aggiornamento-schedulazione dbcli

Utilizzare il comando dbcli update-schedule per aggiornare una pianificazione.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-d --disabilita (Facoltativo) Disabilita la pianificazione.
-e --abilita (Facoltativo) Abilita la pianificazione.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --scheduleid ID schedulazione.
-j --json (Facoltativo) Visualizza l'output JSON.
-t --description (Facoltativo) Descrizione
-x --cronExpression (Facoltativo) Espressione cronologica. Usare cronmaker.com per generare un'espressione Cron valida.

Comando Scheduledexecution

lista dbcli-scheduledExecutions

Utilizzare il comando dbcli list-scheduledExecutions per elencare le esecuzioni pianificate.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-e --executionid (Facoltativo) ID esecuzione.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --scheduleid (Facoltativo) ID schedulazione.
-j --json (Facoltativo) Visualizza l'output JSON.

Comando server

update-server dbcli

Nota

Il sistema DB potrebbe non includere questo comando più recente. In caso di problemi durante l'esecuzione del comando, utilizzare il comando CLI Update per aggiornare l'interfaccia CLI del database, quindi riprovare a eseguire il comando.

Utilizzare il comando dbcli update-server per applicare le patch ai componenti server nel sistema DB. Per ulteriori informazioni sull'applicazione delle patch, vedere Aggiornare un sistema DB.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.
-l --locale

(Facoltativo) Esegue l'operazione sul nodo locale di un sistema HA (High Availability) multi-nodo. Questo parametro non è necessario per eseguire l'operazione su un sistema a nodo singolo.

-n --node

(Facoltativo) Numero di nodo da aggiornare. Utilizzare il comando dbcli list-nodes per ottenere il numero di nodo.

-p --controllo preliminare

(Facoltativo) Esegue le operazioni di controllo preliminare per controllare i prerequisiti.

-v --version (Facoltativo) Versione da aggiornare.

Esempi

I seguenti comandi aggiornano il server e mostrano l'output del job di aggiornamento:

dbcli update-server
Output:
{
  "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
Output:
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

Il comando seguente aggiorna solo il nodo 0 del server, con il controllo preliminare:

dbcli update-server -n 0 -p
Output:
{
  "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"
}

Comando di sistema

sistema di descrizione dbcli

Utilizzare il comando dbcli describe-system per visualizzare i dettagli sul sistema. In un sistema DB RAC a 2 nodi, il comando fornisce informazioni sul nodo locale.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-b --mamma (Facoltativo) Visualizza informazioni sulla BOM.

-d

--dettagli

 (Facoltativo) Visualizza informazioni aggiuntive sul sistema DB, incluse le informazioni sull'interfaccia CLI dcs e sulla versione dell'agente.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Comandi TDE

Per gestire gli elementi correlati alla funzione TDE (report di backup, chiavi e wallet), sono disponibili i comandi riportati di seguito.

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

elenco-tdebackupreport dbcli

Utilizzare il comando dbcli list-tdebackupreports per elencare i report di backup per i wallet TDE.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-i --dbResid (Facoltativo) Visualizza i report di backup del wallet TDE per l'ID risorsa di database specificato. Utilizzare il comando dbcli list-databases per ottenere l'ID risorsa del database.
-nella --dbResname (Facoltativo) Visualizza i report di backup del wallet TDE per il nome risorsa di database specificato. Utilizzare il comando dbcli list-databases per ottenere il nome della risorsa di database.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando riportato di seguito elenca i report di backup per i wallet TDE.

dbcli list-tdebackupreports
Output:
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

Utilizzare il comando dbcli update-tdekey per aggiornare la chiave di cifratura TDE all'interno del wallet TDE. È possibile aggiornare la chiave di cifratura per i pluggable database (se si specifica l'opzione -pdbNames) e/o il container database (se si specifica l'opzione -rootDatabase).

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-all --allPdbNames

(Facoltativo) Flag per ruotare (aggiornare) tutti i nomi PDB. Per aggiornare tutti i nomi dei PDB anziché quelli specificati, utilizzare questo parametro anziché -n. Impostazione predefinita: false.

-i --databaseId

Definisce l'ID del database per il quale aggiornare la chiave.
-p --password

Definisce la password del wallet dell'amministratore TDE. Specificare -p senza password. Verrà richiesto di immettere la password.

Se è necessario fornire la password nel comando, ad esempio in uno script, utilizzare -hp <password> anziché -p.

-n --pdbNames Definisce i nomi dei PDB da ruotare (aggiornati).

-r

-no-r

--rootDatabase

--no-rootDatabase

 Indica se ruotare la chiave per il database radice se si tratta di un container database.
-t -tagName Definisce il file TagName utilizzato per eseguire il backup del wallet. L'impostazione predefinita è OdaRotateKey.
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-j --json (Facoltativo) Visualizza l'output JSON.

Esempio

Il comando seguente aggiorna la chiave solo per pdb1 e pdb2:

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

Il comando seguente aggiorna pdb1, pdb2 e il container database:

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

recovery-tdewallet dbcli

Utilizzare il comando dbcli recover-tdewallet per recuperare un wallet TDE.

Sintassi

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

Parametri

Parametro Nome completo Descrizione
-H --help (Facoltativo) Visualizza la Guida relativa all'uso del comando.
-nella --dbName Nome database.
-j --json (Facoltativo) Visualizza l'output JSON.
-l --tdeWalletBackuplocation (Facoltativo) Posizione del backup del wallet TDE. Il wallet TDE deve essere sottoposto a backup in formato tar.gz.
-tp --tdeWalletPassword

Definisce la password del wallet dell'amministratore TDE.