Uso della utility dbaascli nell'infrastruttura Exadata Cloud

Impara a utilizzare la utility dbaascli nell'infrastruttura Exadata Cloud.

Informazioni sull'uso della utility dbaascli nell'infrastruttura Exadata Cloud

È possibile utilizzare la utility dbaascli per eseguire varie operazioni di amministrazione e ciclo di vita del database nell'infrastruttura Exadata Cloud, ad esempio modificare la password di un utente del database, avviare un database, gestire i pluggable database (PDB) e molto altro ancora.

Per ridimensionare le risorse, devi utilizzare la console o l'interfaccia della riga di comando di Oracle Cloud Infrastructure. Le funzionalità della utility dbaascli si aggiungono e sono separate dalla console, dall'API o dall'interfaccia della riga di comando (CLI, Command-Line Interface). Se non diversamente specificato, per eseguire tutti i comandi di amministrazione è necessario disporre dell'accesso root a dbaascli.

Per utilizzare la utility, è necessario essere connessi a una virtual machine dell'infrastruttura Exadata Cloud. Per istruzioni dettagliate, vedere Connessione a un'istanza dell'infrastruttura Exadata Cloud.

Per ottenere i possibili comandi disponibili con dbaascli, eseguire dbaascli --help.

Per ottenere la Guida specifica del comando, eseguire dbaascli command --help. Ad esempio, dbaascli database create --help.

Per informazioni sui comandi e sulle informazioni specifiche dei comandi, vedere dbasscli Command Reference nel documento.

Creazione di database mediante dbaascli

Utilizzando dbaascli, è possibile creare un Oracle Database creando prima una home Oracle Database della versione desiderata, quindi creando un database nella home Oracle Database.

Visualizzazione delle immagini e delle versioni software disponibili per Database e Grid Infrastructure

Per produrre un elenco delle versioni supportate disponibili per l'applicazione delle patch, utilizzare il comando dbaascli cswlib showImages.

  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando riportato di seguito:
    dbaascli cswlib showImages --product database

    L'output del comando elenca le immagini software del database disponibili.

    dbaascli cswlib showImages --product grid

    L'output del comando elenca le immagini del software Grid disponibili.

  4. Uscire dalla shell del comando utente root:
    exit

    Per ulteriori dettagli sulle opzioni supportate avanzate, vedere dbaascli cswlib showImages.

Esempio 6-1 dbaascli cswlib showImages

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

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

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

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

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

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

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

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

Creazione della home Oracle Database

Per creare una home Oracle Database della versione desiderata, utilizzare il comando dbaascli dbhome create.

Nota

È possibile creare una Oracle Database home con un nome di Oracle home specificato. Se non si specifica, il calcolo viene eseguito automaticamente (consigliato).
  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando riportato di seguito:
    dbaascli dbhome create --version Oracle Home Version --imageTag image Tag Value
    Dove:
    • --version specifica la versione di Oracle Database
    • --imageTag specifica la tag immagine dell'immagine da utilizzare
    Ad esempio:
    dbaascli dbhome create --version 19.9.0.0.0
    Nota

    La specifica di imageTag è facoltativa. Per visualizzare le tag immagine, fare riferimento al comando dbaascli cswlib showImages. Le tag immagine sono in genere uguali alla versione del database. Tuttavia, viene mantenuto come una disposizione per i casi in cui potrebbe essere necessario rilasciare più immagini per la stessa versione, ciascuna rispondente a specifiche esigenze del cliente.
  4. Uscire dalla shell del comando utente root:
    exit

    Per ulteriori dettagli sulle opzioni supportate avanzate, vedere dbaascli dbhome create.

Creazione di Oracle Database nella Oracle Database home specificata

Per creare un Oracle Database nella home Oracle Database specificata della versione desiderata, utilizzare il comando dbaascli database create.

È possibile utilizzare il comando dbaascli database create per:
  • Creare un container database (CDB) o un database non di tipo container
  • Creare un CDB con pluggable database (PDB)
  • Creare un Oracle Database con il set di caratteri specificato
  • Creare database Oracle su un subset di nodi cluster
    Nota

    I database creati su un subset di nodi non verranno visualizzati nella console OCI.
  • Creare Oracle Database versione 12.1.0.2 o successiva con l'aggiornamento della release JAN 2021 o successiva. Per i database con versioni inferiori, si consiglia di utilizzare l'API basata su OCI Console.
  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando riportato di seguito:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path
    Dove:
    • --dbName specifica il nome del database
    • --oracleHome specifica la posizione della Oracle home
    Per creare un CDB, eseguire il comando seguente:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path
    Per creare un database non CDB, eseguire il comando seguente:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path --createAsCDB false

    Quando richiesto, immettere le password sys e tde.

  4. Uscire dalla shell del comando utente root:
    exit

    Per ulteriori dettagli sulle opzioni supportate avanzate, vedere dbaascli database create.

Esecuzione dei controlli dei prerequisiti prima della creazione di Oracle Database

Per eseguire i controlli dei prerequisiti, utilizzare l'opzione del comando --executePrereqs. Verranno eseguiti solo i controlli dei prerequisiti senza eseguire l'effettiva creazione di Oracle Database.

  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando riportato di seguito:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path --executePrereqs
    Dove:
    • --dbName specifica il nome del database
    • --oracleHome specifica la posizione della Oracle home
  4. Uscire dalla shell del comando utente root:
    exit

    Per ulteriori dettagli sulle opzioni supportate avanzate, vedere dbaascli database create.

Ripresa o ripristino dell'operazione di creazione di Oracle Database

Per riprendere o ripristinare un'operazione di creazione del database non riuscita, utilizzare l'opzione dei comandi --resume o --revert.

Ad esempio:
dbaascli database create --dbName database name --oracleHome Oracle Home Path --resume
Nota

  • Durante l'utilizzo delle opzioni del comando --resume o --revert, assicurarsi di utilizzare lo stesso comando dello stesso nodo utilizzato per il flusso effettivo dell'operazione di creazione.
  • È possibile riprendere la creazione del database solo se si verifica un errore nel passo successivo alla creazione del database.

Modifica delle password per i database

Per modificare la password SYS o la password del wallet TDE, utilizzare questa procedura.

La password specificata nel campo Password amministratore database quando si crea una nuova istanza o un nuovo database dell'infrastruttura Exadata Cloud viene impostata come password per le credenziali amministratore SYS, SYSTEM, wallet TDE e PDB. Per modificare le password di un database esistente, attenersi alle procedure riportate di seguito.

Nota

se si abilita Data Guard per un database, la password SYS e la password del wallet TDE dei database primario e in standby devono essere tutte uguali.
Nota

L'uso di dbaascli per modificare la password SYS garantisce che l'automazione del backup/ripristino possa parallelizzare i canali in tutti i nodi del cluster.

Per modificare la password SYS per un database dell'infrastruttura Exadata Cloud

  1. Eseguire il login alla virtual machine dell'infrastruttura Exadata Cloud come opc.
  2. Eseguire il comando riportato di seguito:
    sudo dbaascli database changepassword --dbname database_name --user SYS

Per modificare le password del database in un ambiente Data Guard

  1. Eseguire il comando riportato di seguito sul database primario.
    dbaascli database changePassword —dbName <dbname> --user SYS --prepareStandbyBlob true --blobLocation <location to create the blob file>
  2. Copiare il file dell'oggetto BLOB creato in tutti i database di standby e aggiornare la proprietà del file all'utente oracle.
  3. Eseguire il comando riportato di seguito su tutti i database in standby.
    dbaascli database changePassword —dbName <dbname> --user SYS --standbyBlobFromPrimary <location of copies the blob file>

Per modificare la password del wallet TDE per un database dell'infrastruttura Exadata Cloud

  1. Eseguire il login alla virtual machine dell'infrastruttura Exadata Cloud come opc.
  2. Eseguire il comando riportato di seguito:
    sudo dbaascli tde changepassword --dbname database_name

Gestione delle immagini software dell'infrastruttura Exadata Cloud mediante la utility Dbaascli

È possibile elencare e scaricare le immagini software del database Oracle in un'istanza dell'infrastruttura Exadata Cloud, che può quindi essere utilizzata per il provisioning di una home del database.

Nota

È possibile creare immagini software di database personalizzate per le istanze dell'infrastruttura Exadata Cloud utilizzando la console o l'API. Queste immagini vengono memorizzate nello storage degli oggetti e possono essere utilizzate per eseguire il provisioning di una home del database nell'istanza Exadata. Per ulteriori informazioni, vedere Immagini software Oracle Database.

Puoi controllare la versione dei file binari Oracle installata quando esegui il provisioning di un nuovo database su un'istanza dell'infrastruttura Exadata Cloud gestendo le immagini software nel sistema. Oracle fornisce una libreria di immagini software cloud che è possibile visualizzare e scaricare nell'istanza utilizzando la utility dbaascli.

Visualizzazione delle immagini e delle versioni software disponibili per Database e Grid Infrastructure

Per produrre un elenco delle versioni supportate disponibili per l'applicazione delle patch, utilizzare il comando dbaascli cswlib showImages.

  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando riportato di seguito:
    dbaascli cswlib showImages --product database

    L'output del comando elenca le immagini software del database disponibili.

    dbaascli cswlib showImages --product grid

    L'output del comando elenca le immagini del software Grid disponibili.

  4. Uscire dalla shell del comando utente root:
    exit

    Per ulteriori dettagli sulle opzioni supportate avanzate, vedere dbaascli cswlib showImages.

Esempio 6-2 dbaascli cswlib showImages

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

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

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

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

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

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

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

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

Per scaricare un'immagine software

È possibile scaricare le immagini software disponibili nell'istanza dell'infrastruttura Exadata Cloud utilizzando il comando secondario cswlib download della utility dbaascli.

  1. Connettersi a un nodo di calcolo come istruzioni dettagliate opc user.For. Vedere Connessione a una virtual machine con SSH.
  2. Avviare una shell di comandi utente root:
    $ sudo -s
    #
  3. Eseguire il comando dbaascli con il comando secondario cswlib download:
    # dbaascli cswlib download [--version <software_version>] [--imageTag <image tag
        value>]
    Il comando visualizza la posizione delle immagini software scaricate nell'ambiente dell'infrastruttura Exadata Cloud.

    I parametri opzionali sono:

    • versione: specifica una versione del software Oracle Database. ad esempio 19.14.0.0.0.0.
    • imageTag: specifica il tag immagine dell'immagine.
  4. Uscire dalla shell dei comandi utente root:
    # exit
    $

Applicazione di patch ai database Oracle Grid Infrastructure e Oracle mediante dbaascli

Impara a utilizzare la utility dbaascli per eseguire operazioni di applicazione delle patch per Oracle Grid Infrastructure e Oracle Database su un sistema Exadata Cloud Infrastructure.

Applicazione di patch ai database mediante dbaascli

Utilizzando dbaascli, è possibile scegliere di applicare patch a un database applicando patch alla Oracle home oppure spostando il database in una Oracle home con il livello di patch desiderato.

  • Applicazione patch a una Oracle home (applicazione patch in loco). In questo modo vengono aggiornati tutti i database che si trovano nella Oracle home.
  • Spostamento di un database in un'altra Oracle home con la versione del software Oracle Database desiderata (applicazione di patch non in loco).
Applicazione di patch a una home del database (applicazione di patch al database in loco)

Per applicare le patch a una Oracle home, utilizzare il comando dbaascli dbHome patch.

Questa operazione applicherà le patch a tutti i database in esecuzione nella home specificata e i database rimarranno nella home al termine dell'applicazione delle patch. Di seguito si applica all'uso del comando dbHome patch per le operazioni di applicazione patch in loco:
  • È possibile applicare patch a tutti i nodi del database o a un subset di nodi.
  • L'applicazione di patch a più nodi viene eseguita in sequenza.
  • Facoltativamente, è possibile eseguire un'operazione sulle patch solo software. Quando si è pronti, è possibile eseguire datapatch per eseguire azioni SQL successive alla patch.
  • È possibile applicare le patch a una Oracle home contenente uno o più database.

Per applicare le patch a una Oracle home (dbhome):

  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando riportato di seguito:
    dbaascli dbhome patch --oracleHome dbhome_path --targetVersion Oracle_Database_version
    Dove:
    • --oracleHome identifica il percorso della Oracle home a cui applicare le patch.
    • --targetVersion specifica la versione di Oracle Database di destinazione da utilizzare per l'applicazione delle patch, ovvero cinque segmenti numerici separati da punti (ad esempio 19.12.0.0.0).
    Ad esempio:
    dbaascli dbhome patch --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --targetVersion 19.9.0.0.0
  4. Uscire dalla shell del comando utente root:
    exit

    Per ulteriori dettagli sulle opzioni supportate avanzate, vedere dbaascli dbHome patch.

Spostamento di un database in una Oracle home diversa (applicazione di patch non in loco)

Per applicare le patch a un Oracle Database spostandolo in una Oracle home che si trova già al livello di patch desiderato, utilizzare il comando dbaascli database move.

Al termine dell'operazione di spostamento del database, il database viene eseguito utilizzando la versione del software Oracle Database della Oracle home di destinazione.

Per applicare le patch a un database spostandolo in una Oracle home diversa:

  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando riportato di seguito:
    dbaascli database move --oracleHome path_to_target_oracle_home --dbname database_name
    Dove:
    • --oracleHome identifica il percorso della Oracle home di destinazione che utilizza la versione del software Oracle Database desiderata. Tenere presente che la Oracle home di destinazione deve esistere nel sistema prima di utilizzare il comando database move.
    • --dbname specifica il nome del database da spostare.
    Ad esempio:
    dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --dbname xyz
  4. Uscire dalla shell del comando utente root:
    exit

    Per ulteriori dettagli sulle opzioni supportate avanzate, vedere dbaascli database move.

Applicazione di patch a Oracle Grid Infrastructure

Per applicare una patch a Oracle Grid Infrastructure, utilizzare il comando grid patch.

  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando riportato di seguito:
    dbaascli grid patch --targetVersion target_software_version_number

    Dove --targetVersion identifica la versione del software di destinazione a cui verrà applicata la patch a Oracle Grid Infrastructure.

    Ad esempio:
    dbaascli grid patch --targetVersion 19.11.0.0.0
  4. Uscire dalla shell del comando utente root:
    exit

    Per ulteriori dettagli sulle opzioni supportate avanzate, vedere dbaascli grid patch.

Applicazione di patch a Oracle Grid Infrastructure (GI) mediante l'immagine software GI

Per applicare le patch a Oracle Grid Infrastructure (GI) utilizzando l'immagine software GI, attenersi alla procedura riportata di seguito.

È inoltre possibile applicare le patch a Oracle Grid Infrastructure creando prima un'immagine software a cui sono state applicate le patch e quindi utilizzando l'immagine per eseguire l'operazione di applicazione delle patch. Ciò offre il vantaggio di poter creare un'immagine in anticipo al di fuori della finestra di applicazione delle patch. Aiuta anche nella risoluzione dei conflitti poiché eventuali conflitti tra le patch vengono evidenziati durante il processo di creazione dell'immagine senza influire sulla finestra di applicazione delle patch.

  1. Creare un'immagine software a cui sono state applicate patch.
    dbaascli grid patch --targetVersion <target_software_version_number> --createImage
    Una volta completata la creazione dell'immagine software a cui sono state applicate le patch, è possibile utilizzare l'immagine per eseguire l'operazione di applicazione delle patch.
  2. Eseguire l'operazione di applicazione delle patch.
    dbaascli grid patch --targetVersion <target_software_version_number> --imageLocation <location_of_patched_software_image>

Visualizzazione delle immagini e delle versioni software disponibili per Database e Grid Infrastructure

Per produrre un elenco delle versioni supportate disponibili per l'applicazione delle patch, utilizzare il comando dbaascli cswlib showImages.

  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando riportato di seguito:
    dbaascli cswlib showImages --product database

    L'output del comando elenca le immagini software del database disponibili.

    dbaascli cswlib showImages --product grid

    L'output del comando elenca le immagini del software Grid disponibili.

  4. Uscire dalla shell del comando utente root:
    exit

    Per ulteriori dettagli sulle opzioni supportate avanzate, vedere dbaascli cswlib showImages.

Esempio 6-3 dbaascli cswlib showImages

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

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

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

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

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

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

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

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

Esecuzione di un controllo preliminare prima dell'applicazione di patch ai database e a Grid Infrastructure

È possibile eseguire un'operazione di controllo dei prerequisiti (detta anche "controllo preliminare") per i comandi in questo argomento utilizzando il flag di controllo preliminare applicabile.

L'esecuzione dei controlli preliminari consente di eseguire solo la parte di controllo preliminare dell'operazione di applicazione delle patch senza eseguire l'applicazione effettiva delle patch. Oracle consiglia di eseguire controlli preliminari per rilevare problemi software che potrebbero impedire la corretta applicazione delle patch.

Per eseguire i controlli preliminari dell'applicazione delle patch, innanzitutto connettersi a una virtual machine nell'istanza dell'infrastruttura Exadata Cloud come utente root.

Controllo preliminare per l'applicazione di patch alla Oracle home (applicazione di patch in loco)

Usare il flag --executePrereqs con il comando dbaascli dbhome patch.

  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando riportato di seguito:
    dbaascli dbhome patch --oracleHome dbhome_path --targetVersion Oracle_Database_version --executePrereqs
    Dove:
    • --oracleHome identifica il percorso della Oracle home da sottoporre a controllo preliminare.
    • --targetVersion specifica la versione di Oracle Database di destinazione per la quale applicare le patch, costituita da cinque segmenti numerici separati da punti (ad esempio 19.12.0.0.0).
  4. Uscire dalla shell del comando utente root:
    exit
Controllo preliminare dell'applicazione delle patch di spostamento del database (applicazione delle patch non in loco)

Usare il flag --executePrereqs con il comando dbaascli database move.

  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando riportato di seguito:
    dbaascli database move --oracleHome path_to_target_oracle_home --dbname database_name --executePrereqs
    Dove:
    • --oracleHome identifica il percorso della Oracle home di destinazione che utilizza la versione del software Oracle Database desiderata. Tenere presente che la Oracle home di destinazione deve esistere nel sistema prima di utilizzare il comando database move.
    • --dbname specifica il nome del database da spostare
  4. Uscire dalla shell del comando utente root:
    exit
Controllo preliminare per l'applicazione di patch a Oracle Grid Infrastructure

Usare il flag --executePrereqs con il comando dbaascli grid patch.

  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando riportato di seguito:
    dbaascli grid patch --targetVersion target_software_version_number --executePrereqs

    Dove --targetVersion identifica la versione del software di destinazione a cui verrà applicata la patch a Oracle Grid Infrastructure, specificato come cinque segmenti numerici separati da punti, ad esempio 19.12.0.0.0

  4. Uscire dalla shell del comando utente root:
    exit

Ripristino o rollback di un'operazione di applicazione patch

È possibile riprendere o annullare un'operazione di applicazione delle patch non riuscita. Il ripristino di una patch viene definito rollback.

Ripristino di un'operazione patch

Per riprendere un'operazione di applicazione delle patch, utilizzare il flag --resume con il comando di applicazione delle patch originale.

  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando di applicazione delle patch originale per riprendere un'operazione di applicazione delle patch:
    Ad esempio:
    dbaascli dbhome patch --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --targetVersion 19.9.0.0.0 --resume
  4. Uscire dalla shell del comando utente root:
    exit
Rollback di un'operazione di patch

Utilizzare il flag --rollback con il comando di applicazione delle patch originale per eseguire il rollback (ripristinare) di un'operazione di applicazione delle patch.

  1. Connettersi alla virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Eseguire il comando di applicazione delle patch originale per eseguire il rollback (ripristinare) di un'operazione di applicazione delle patch:
    Ad esempio:
    dbaascli grid patch --targetVersion 19.11.0.0.0 --rollback
    Nota

    • Le operazioni di ripresa e rollback sono supportate per l'applicazione di patch alla Oracle home, l'applicazione di patch a Oracle Grid Infrastructure e le operazioni di spostamento del database.
    • Quando si riprende o si esegue il rollback di un'operazione di applicazione delle patch, è necessario eseguire il comando resume o rollback dallo stesso nodo utilizzato per eseguire il comando di applicazione delle patch originale ed è necessario eseguire il comando originale con l'aggiunta del flag --resume o --rollback.
  4. Uscire dalla shell del comando utente root:
    exit

Raccogliere i log di Cloud Tooling ed eseguire un controllo dello stato di Cloud Tooling utilizzando dbaascli

L'uso del comando dbaascli diag consente di raccogliere i log degli strumenti della VM guest dbaas per i sistemi Exadata Database Service on Dedicated Infrastructure ed Exadata Database Service on Cloud@Customer. È possibile utilizzare questi log per risolvere i problemi relativi agli strumenti dbaas.

È possibile utilizzare il comando diag per raccogliere i log dbaastools ed eseguire un controllo dello stato su tutti i nodi di un cluster Exadata. Si noti che le opzioni --waitForCompletion sono supportate a partire dalla versione 22.4.1
Nota

  • i comandi diag dbaascli devono essere eseguiti come utente root
  • L'esecuzione del comando dbaascli diag collect su un singolo nodo raccoglierà i dati di log per tutti i nodi
  • Si consiglia di eseguire i comandi documentati in questo argomento utilizzando l'opzione --waitForCompletion per i comandi con tempi di esecuzione lunghi. Fare riferimento agli esempi per l'uso di esempio.

Per informazioni sull'aggiornamento di Exadata Cloud Tooling, vedere Amministratore dbaascli updateStack.

Raccolta di esempi di dati di log degli strumenti

Il comando dbaascli dbaascli diag collect utilizza la sintassi riportata di seguito per raccogliere i dati di log degli strumenti:

Per informazioni dettagliate sulla sintassi, vedere dbaascli diag collect nel manuale dbaascli Command Reference.

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

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

Esecuzione di esempi di controllo dello stato

Utilizzare il comando dbaascli dbaascli diag healthcheck per eseguire un controllo dello stato su tutti i nodi del sistema.

Per i dettagli sulla sintassi nel riferimento dei comandi dbaascli, vedere dbaascli diag healthcheck.

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

Aggiornamento di Cloud Tooling mediante dbaascli

Per aggiornare la release degli strumenti cloud per Oracle Exadata Database Service on Dedicated Infrastructure, completare questa procedura.

Gli strumenti specifici per il cloud vengono utilizzati nelle VM guest dell'infrastruttura Exadata Cloud per le operazioni locali, inclusi i comandi dbaascli.

Gli strumenti cloud vengono aggiornati automaticamente da Oracle quando vengono rese disponibili nuove release. Se necessario, puoi seguire i passi riportati di seguito per assicurarti di avere la versione più recente degli strumenti specifici del cloud su tutte le virtual machine nel cluster VM.
Nota

È possibile aggiornare gli strumenti specifici del cloud scaricando e applicando un pacchetto software contenente gli strumenti aggiornati.
  1. Connettersi a una virtual machine come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una Virtual Machine con SSH.

  2. Avviare una shell del comando utente root:
    sudo -s
  3. Per eseguire l'aggiornamento alla release più recente degli strumenti cloud disponibili, eseguire il comando seguente:
    dbaascli admin updateStack

    Il comando si occupa di aggiornare la release degli strumenti cloud su tutti i nodi del cluster.

    Per ulteriori dettagli e altre opzioni disponibili, fare riferimento a dbaascli admin updateStack --help.

Creazione di un database duplicato

Uso di dbaascli per duplicare un database cloud

È possibile creare un database duplicato utilizzando dbaascli. Questo nuovo database può trovarsi nella stessa area cloud dell'area di origine o in tutte le aree. La procedura riportata di seguito descrive come creare un database duplicato nel cloud.

Nota

Se un database è configurato con OCI Vault per la cifratura TDE e si desidera duplicare un database, fare riferimento alle sezioni seguenti.

Preparati per la duplicazione

Assicurarsi che siano disponibili i prerequisiti riportati di seguito.

  • Assicurarsi che sia presente un'impostazione del percorso di rete per accedere al database di origine tramite la stringa EZConnect.
  • Copiare il file wallet TDE (ewallet.p12) nel nodo del database di destinazione. Il nodo in cui si decide di eseguire il comando dbaascli.
  • Creare una Oracle home nel nodo di destinazione, se necessario. La versione della Oracle home deve essere uguale a quella dell'origine o di una versione RU successiva.

Eseguire i controlli dei prerequisiti

Per eseguire i controlli dei prerequisiti, utilizzare l'opzione del comando --executePrereqs. Verranno eseguiti solo i controlli dei prerequisiti senza eseguire la duplicazione effettiva di Oracle Database.

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

Duplica il database

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

Considerazioni sull'uso di OCI Vault per la gestione delle chiavi

Questa sezione è applicabile solo nel caso in cui il database sia configurato con OCI Vault per la cifratura TDE e si desidera duplicare un database.

Duplicazione di un database all'interno della stessa area

  • Passi obbligatori aggiuntivi

    Assicurarsi di impostare i criteri di accesso al vault OCI per i nodi del database di destinazione. I nodi del database di destinazione devono essere in grado di accedere a entrambi i vault di chiavi OCI del database di origine insieme al nuovo vault di chiavi (se si decide di utilizzare un vault di chiavi separato).

  • Eseguire i controlli dei prerequisiti
    dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID> --executePrereqs
  • Duplica il database
    dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID>

    Al completamento del comando, il database viene duplicato.

Duplicazione di un database in più aree

  • Passi obbligatori aggiuntivi
    • Impostare un nuovo vault OCI per il database di destinazione nell'area corrispondente seguendo i passi descritti nella sezione Preparazione all'uso delle chiavi gestite dal cliente nel servizio vault. Completare i task da 1 a 3.
    • Imposta la replica di OCI Vault dall'area di origine all'area di destinazione. Per ulteriori informazioni, vedere Replica di vault e chiavi.
    • Aggiornare il criterio del gruppo dinamico, creato nel passo 2 per consentire l'accesso alla chiave del vault OCI replicata.
  • Eseguire i controlli dei prerequisiti
    dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID> --executePrereqs
  • Duplica il database
    dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID>

    Al completamento del comando, il database viene duplicato.

Duplica un database in locale

dbaascli consente di duplicare un database in locale nel cloud. Questa operazione può essere eseguita con il comando dbaascli database duplicate. Questo comando crea un nuovo database nel cloud, che è un duplicato di un database in locale insieme ai relativi dati. Mentre questo processo è in corso, il database on-premise rimane ancora operativo. Puoi eseguire la migrazione delle tue applicazioni al database duplicato nel cloud dopo la dovuta verifica.

Preparati per la duplicazione

Il processo di migrazione include i seguenti prerequisiti da soddisfare.
  • Assicurarsi che sia presente un'impostazione del percorso di rete per accedere a un database in locale dal nodo OCI tramite la stringa EZConnect.
  • Se un database in locale è configurato con TDE, copiare il file wallet TDE (ewallet.p12 ) nel nodo OCI, dove si decide di eseguire il comando dbaascli.
  • Creare una Oracle home nel nodo OCI, se necessario. La versione della Oracle home deve essere uguale all'origine o a una versione RU successiva.

Verificare gli RPM necessari

Questo processo richiede una versione minima di dbaastools RPM della versione 23.3.2.0.0, ma si consiglia sempre di eseguire l'aggiornamento alla versione più recente di dbaastools RPM.

  • Per controllare la versione attualmente installata, eseguire:
    dbaascli --version
    DBAAS CLI version 23.3.2.0.0
  • Per applicare l'RPM degli strumenti più recenti, come utente root, eseguire:
    # dbaascli admin updateStack

Esegui i controlli dei prerequisiti

Per eseguire i controlli dei prerequisiti, utilizzare l'opzione di comando --executePrereqs. Verranno eseguiti solo i controlli dei prerequisiti senza eseguire la duplicazione effettiva di Oracle Database.

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

Duplica il database

Duplicare il database utilizzando il seguente comando:

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

Ad esempio:

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

Al completamento di questo comando, il database viene duplicato nel cloud e pronto per i controlli di integrità per l'uso dell'applicazione. Una volta eseguita la verifica, è possibile eseguire la migrazione delle connessioni dell'applicazione al database cloud.

Per ulteriori opzioni di configurazione, vedere dbaascli database duplicate –help.

Poche considerazioni per la migrazione

  • Se si preferisce allocare più canali per il duplicato RMAN, è possibile eseguire questa operazione specificando l'argomento --rmanParallelism.
  • Exadata Cloud Service configura la memoria del database come ASM (Automatic Shared Memory Management). Se il database in locale è configurato con una gestione della memoria diversa, assicurarsi di regolare i valori dei parametri di memoria di conseguenza sul lato OCI fornendo i valori per --sgaSizeInMB e --pgaSizeInMB.
  • Verificare che il database in locale non contenga parametri di inizializzazione non più validi o non validi.
  • I parametri di inizializzazione del database correlati alla memorizzazione del database (posizione del file di dati, posizione del redo, destinazione dell'area di recupero, multiplexing del control file) possono essere modificati utilizzando l'argomento --initParams.

    Ad esempio, per sostituire il valore db_create_online_log_dest per il database duplicato: --initParams db_create_online_log_dest_1=+DATAC1,db_create_online_log_dest_2=+RECOC1

Risoluzione dei problemi relativi alla duplicazione del database

  • Il file di log delle operazioni dbaascli è disponibile in /var/opt/oracle/log/<dbname>/database/duplicate
  • Uno dei job del duplicato consiste nell'esecuzione di dbca. Il file di log è disponibile sotto /u02/app/oracle/cfgtoollogs/dbca e /u02/app/oracle/cfgtoollogs/dbca/<dbuniquename>.

Se l'operazione non riesce, è possibile riprendere l'operazione fornendo l'argomento --resume allo stesso comando. In alternativa, eseguire il cleanup del database utilizzando dbaascli database delete –dbname <dbname> –force, quindi rieseguire il comando di duplicazione del database.

Note di rilascio

Esaminare le modifiche apportate in varie release di dbaascli.

Release 25.2.1.0.0 (250522)

  • Varie correzioni di bug e miglioramenti della stabilità

Release 25.1.2.0.0 (250325)

  • Varie correzioni di bug e miglioramenti della stabilità

Release 25.1.1.0.0 (250107)

  • Varie correzioni di bug e miglioramenti della stabilità

Release 24.4.1.0.0 (241104)

  • dbaascli database getDetails migliorato per includere i dettagli tde encryption. Il comando dbaascli tde status non è più valido.
  • Varie correzioni di bug e miglioramenti della stabilità

Release 24.3.2.0.0 (240828)

  • Varie correzioni di bug e miglioramenti della stabilità

Release 24.3.1.0.0 (240711)

  • Migrazione TDE da sqlnet.ora a wallet_root sull'aggiornamento del database alla release 19c
  • Patch Grid in loco per l'utilizzo dell'applicazione di patch basata sulle immagini come modalità predefinita
  • Varie correzioni di bug e miglioramenti della stabilità

Release 24.2.1.0.0 (240530)

  • Aggiunto il supporto per Oracle Database 23ai.
  • Miglioramenti nell'area di backup e ripristino con Zero Data Loss Autonomous Recovery Service (ZRCV) come destinazione di backup.
  • Varie correzioni di bug e miglioramenti della stabilità.

Release 24.1.2.0.0 (240306)

  • Introdotto un nuovo flusso di lavoro ottimizzato per le operazioni Data Guard
  • Varie correzioni di bug e miglioramenti della stabilità

Release 24.1.1.0.0 (231219)

  • Varie correzioni di bug e miglioramenti della stabilità

Release 23.4.1.0.0 (231102)

  • Backup e recupero: la finestra di recupero del backup minimo è stata modificata in 7 giorni. Mentre l'obsolescenza dell'automazione dei backup piece considera la finestra di ripristino come 7 giorni se rileva un valore inferiore a 7 dal sistema.
  • Varie correzioni di bug e miglioramenti della stabilità

Release 23.3.2.0.0 (230921)

  • Operazioni di pluggable database
    • Aggiunto supporto per impostare l'OCID della versione della chiave personalizzata (Bring Your Own Key - BYOK) del vault OCI durante le operazioni di creazione e duplicazione. Per ulteriori informazioni, vedere la Guida relativa ai comandi PDB.
  • Applicazione di patch a Grid Infrastructure (GI)
    • Ha migliorato il flusso di lavoro di applicazione delle patch per migliorare i tempi di applicazione delle patch, soprattutto negli ambienti con un numero elevato di database.
    • Viene introdotta una nuova opzione --patchInParallel che può essere utilizzata per eseguire in parallelo l'applicazione di patch ai nodi remoti.
  • Applicazione patch database
    • Opzione fornita per eseguire DataPatch su un nodo specifico del cluster.
  • Varie correzioni di bug e miglioramenti della stabilità

Release 23.3.1.0.0 (230712)

  • Nuovi comandi dbaascli
    • dbaascli gridHome create: questo comando può essere utilizzato per creare una home Grid Infrastructure di una versione supportata. Per ulteriori informazioni, vedere dbaascli gridHome create --help.
    • dbaascli system getGridHomes: questo comando fornisce dettagli sulle home Grid Infrastructure disponibili nel sistema. Per ulteriori informazioni, vedere dbaascli system getGridHomes --help.
    • dbaascli admin updateAHF: questo comando può essere utilizzato per aggiornare AHF a una versione cloud certificata specificata della release AHF. Si consiglia tuttavia di gestire implicitamente gli aggiornamenti AHF tramite l'automazione cloud. Per ulteriori informazioni, vedere dbaascli admin updateAHF --help.
  • Operazioni di pluggable database
    • Miglioramenti nell'area del ciclo di vita dei pluggagble database aggiornabili.
  • Backup e recupero del database
    • Aggiunto il supporto per configurare i backup sui siti in standby in caso di configurazioni Data Guard. La configurazione dei backup è specifica del sito di Data Guard, ovvero la modifica dei ruoli (ad esempio, con l'operazione di switchover di Data Guard) non influirà sulle operazioni di backup del database sui siti primari o in standby. I backup, se configurati nel sito principale o in standby, continueranno indipendentemente dalla modifica del ruolo.
  • Varie correzioni di bug e miglioramenti della stabilità

Release 23.2.1.0.0 (230503)

  • Miglioramenti correlati al ciclo di vita del database
    • È stato introdotto dbaascli grid removeTCPSCert per rimuovere i certificati TCPS scaduti. Per ulteriori informazioni, vedere dbaascli grid removeTCPSCert --help.
    • Aggiunta l'opzione per escludere PDB specifici durante la duplicazione del database. Per informazioni dettagliate, vedere l'argomento skipPDBs in dbaascli database duplicate --help.
  • Backup e recupero del database
    • È stata modificata l'impostazione predefinita per FILES_PER_SET su 64 per i backup OSS. Questo può essere modificato con dbaascli database backup --configure. Per ulteriori informazioni, vedere dbaascli database backup --help.
    • I backup dei log di archivio continuano dal sito in standby dopo lo switchover del ruolo negli ambienti Data Guard.
    • Per i backup non gestiti da Oracle, le pianificazioni per i backup L0 e L1 non vengono create per impostazione predefinita. Questi devono essere creati in modo esplicito utilizzando il comando dbaascli database backup --configure.
  • sysLens

    Un framework che raccoglie, analizza e segnala i dati delle risorse di sistema per le flotte ExaDB-D è incluso nella 23.2.1.0.0 (235503). Per ulteriori informazioni, vedere Gestire sysLens.

  • Varie correzioni di bug e miglioramenti della stabilità

Release 23.1.2.0.0 (230305)

  • Miglioramenti correlati al ciclo di vita del database
    • Aggiunta l'opzione per creare modelli di database (DBCA temapltes) nell'area di memorizzazione degli oggetti. I modelli DBCA possono essere successivamente utilizzati per creare i database. Per ulteriori informazioni, vedere dbaascli database createTemplate --help.
  • Operazioni di pluggable database
    • È stato introdotto dbaascli pdb refresh per aggiornare un pluggable database creato utilizzando l'opzione di aggiornamento manuale. Per ulteriori informazioni, vedere dbaascli pdb refresh --help.
    • Aggiunta dell'opzione per convertire il pluggable database aggiornabile in un normale pluggable database. Per ulteriori informazioni, vedere dbaascli pdb open --help.
    • La creazione di un pluggable database aggiornabile ora richiede l'utente del database di origine esistente per la creazione del database link al pluggable database di origine. Per informazioni dettagliate, vedere l'argomento dblinkUserName in dbaascli pdb remoteClone --help.
  • Varie correzioni di bug e miglioramenti della stabilità

Release 23.1.1.0.1 (230113)

  • Miglioramenti correlati al ciclo di vita del database
    • Aggiunto il supporto per creare un database duplicato da un database di origine che utilizza i servizi Vault OCI per la gestione delle chiavi di cifratura.
  • Varie correzioni di bug e miglioramenti della stabilità

Release 22.4.1.0.1 (221122)

  • Operazioni di pluggable database
    • Aggiunta l'opzione per non aprire il PDB alla fine del riposizionamento. Per informazioni dettagliate, vedere l'argomento skipOpenPDB in dbaascli pdb relocate --help. Dopo aver utilizzato questa opzione, il riposizionamento del PDB può essere completato eseguendo il comando utilizzando l'argomento completePDBRelocate.
    • Aggiunta l'opzione per eseguire il cleanup dei metadati/servizi PDB riposizionati nella posizione di origine. Per informazioni dettagliate, vedere l'argomento cleanupRelocatedPDB in dbaascli pdb delete --help
  • Nuovi comandi dbaascli
    • dbaascli database createTemplate: questo comando può essere utilizzato per creare modelli di database (modelli DBCA) che possono essere successivamente utilizzati per creare i database. I modelli DBCA sono ampiamente utilizzati per creare un database clone con DBCA, uno strumento fornito con il software server Oracle Database. Per i dettagli, vedere dbaascli database createTemplate --help
    • È stato introdotto dbaascli tde rotateMasterKey per ruotare la chiave master per la cifratura del database. Per ulteriori informazioni, vedere dbaascli tde rotateMasterKey --help. Il comando dbaascli tde rotate masterkey non è più valido.
  • Miglioramenti correlati al ciclo di vita del database
    • Aggiunto il supporto per l'utilizzo dei modelli dbca nei flussi di lavoro di creazione del database. Per informazioni dettagliate, vedere l'argomento dbcaTemplateFilePath in dbaascli database create --help
    • Prestazioni migliorate per la creazione di database duplicati. Per informazioni dettagliate sulla creazione di un database duplicato, vedere dbaascli database duplicate --help
    • Aggiunto il supporto per creare un database duplicato da un database di origine non cifrato con TDE.
  • Gestione TDE
    • È stato introdotto dbaascli tde rotateMasterKey per ruotare la chiave master per la cifratura del database. Per ulteriori informazioni, vedere dbaascli tde rotateMasterKey --help. Il comando dbaascli tde rotate masterkey non è più valido.
    • Flusso di lavoro rinnovato per tutte le operazioni TDE. Per i dettagli, vedere dbaascli tde --help
  • Applicazione di patch a Grid Infrastructure (GI)
    • Aggiunto supporto per consentire l'esecuzione parallela dell'operazione di applicazione delle patch sui nodi. Questa opzione deve essere esercitata con attenzione in quanto si traduce in una ridotta disponibilità del database.
  • Backup e recupero del database
    • Workflow rinnovato per la creazione del database da backup standalone
  • Include AHF versione 22.2.4
  • Varie correzioni di bug e miglioramenti della stabilità

Release 22.3.1.1.0 (221003)

  • Nuovi comandi dbaascli
    • dbaascli database getDetails: questo comando mostra le informazioni dettagliate di un determinato database, ad esempio dbname, informazioni sul nodo, informazioni sui pluggable database e così via. Per ulteriori informazioni, vedere dbaascli database getDetails --help.
  • Operazioni di pluggable database
    • Aggiunto il supporto per la creazione di pluggable database come copia aggiornabile utilizzando l'argomento refreshablePDB. Per i dettagli, vedere dbaascli pdb remoteClone --help
  • Varie correzioni di bug e miglioramenti della stabilità

Release 22.3.1.0.1 (220721)

  • Nuovi comandi del ciclo di vita del database
    • dbaascli database addInstance: questo comando può essere utilizzato per aggiungere un'istanza di database a uno dei nodi del cluster in cui il database non è già configurato. Per ulteriori informazioni, vedere dbaascli database addInstance --help.
    • dbaascli database deleteInstance: questo comando può essere utilizzato per eliminare un'istanza di database da uno dei nodi del cluster in cui è configurato il database. Per ulteriori informazioni, vedere dbaascli database deleteInstance --help.
    • dbaascli database duplicate: questo comando può essere utilizzato per creare un nuovo database da un database già esistente all'interno di un cluster o tra cluster, a condizione che esista una connessione di rete tra i cluster. Per ulteriori informazioni, vedere dbaascli database duplicate --help.
  • Libreria software cloud
    • Comando dbaascli cswlib listLocal introdotto per elencare le immagini scaricate dalla libreria software in locale sul sistema. Per ulteriori informazioni, vedere dbaascli cswlib listLocal --help Il comando dbaascli dbimage list è ora deprecato.
    • Comando dbaascli cswlib deleteLocal introdotto per eliminare le immagini scaricate dalla libreria software cloud. Per ulteriori informazioni, vedere dbaascli cswlib deleteLocal --help Il comando dbaascli dbImage purge è ora deprecato.
  • La posizione del log per il comando dbaascli admin updateStack è stata modificata in modo da seguire la convenzione di altri comandi dbaascli. I log possono essere trovati facilmente nella directory /var/opt/oracle/log/admin/updateStack. La posizione precedente era /var/opt/oracle/log/tooling/Update.
  • dbaascli help ora è consapevole che elenca l'output della Guida per i comandi applicabili all'ambiente cloud su cui opera.
  • Aggiunto il supporto per la modifica della password TDE negli ambienti Data Guard. Per ulteriori informazioni, vedere dbaascli tde changePassword --help. Questo supporto non è attualmente disponibile per la release 11.2.0.4.
  • Incluso AHF versione 22.1.5.
  • Flusso di lavoro rinnovato per l'operazione di aggiornamento del database.
  • Workflow rinnovato per l'operazione di creazione della home del database.
  • Varie correzioni di bug e miglioramenti della stabilità

Release 22.2.1.1.0 (220623)

  • Incluso AHF versione 22.1.1
  • Risolto un problema per cui l'aggiornamento di dbaastools rpm sul sistema poteva aver causato tempi di inattività del database con errore ORA-600
  • Varie correzioni di bug e miglioramenti della stabilità

Release 22.2.1.1.0 (220609)

  • Nuovi comandi dbaascli:
    • dbaascli dbHome getDatabases: questo comando elenca tutti i database in esecuzione da una determinata Oracle home del database. L'output viene restituito in formato JSON per facilitare l'automazione. Per ulteriori informazioni, vedere dbaascli dbHome getDatabases --help.
    • dbaascli database getPDBs: questo comando elenca tutti i pluggable database di un determinato container database. L'output viene restituito in formato JSON per facilitare l'automazione. Per ulteriori informazioni, vedere dbaascli database getPDBs --help.
    • dbaascli dbHome delete: questo comando elimina una determinata Oracle home del database. Per ulteriori informazioni, vedere dbaascli dbHome delete --help.
    • dbaascli dataguard prepareStandbyBlob: questo comando genera un file BLOB contenente vari file necessari nel sito in standby per un ambiente Data Guard. Per ulteriori informazioni, vedere dbaascli dataguard prepareStandbyBlob --help.
  • Applicazione di patch a Grid Infrastructure (GI):
    • Nuovo workflow ottimizzato
    • È stato introdotto un modo per creare l'immagine software di Grid Infrastructure (GI) prima dell'applicazione delle patch. Questa immagine GI può essere successivamente utilizzata per eseguire l'operazione di applicazione delle patch GI. Il vantaggio di questo approccio è che si traduce in una finestra di applicazione delle patch ridotta poiché l'immagine è già preparata. Lo stack GI sul nodo non viene ridotto per creare l'immagine. Per maggiori dettagli, vedere l'opzione createImage in dbaascli grid patch --help
    • È stato introdotto un modo per eseguire l'applicazione delle patch a Grid Infrastructure mediante l'uso dell'immagine software GI specificata dall'utente, creata utilizzando l'opzione createImage del comando dbaascli grid patch. Per maggiori dettagli, vedere l'opzione imageLocation in dbaascli grid patch --help.
  • Modifica del supporto Password nell'ambiente Data Guard:
    • Aggiunto supporto per la modifica della password negli ambienti Data Guard. Per ulteriori informazioni, vedere dbaascli database changePassword --help e dbaascli dataguard prepareStandbyBlob --help
  • Configurazione Data Guard:
    • Aggiunto il supporto per l'aggiornamento degli attributi di automazione Data Guard (nel file /var/opt/oracle/dg/dg.conf). Per i dettagli, vedere dbaascli dataguard --help.
  • Varie correzioni di bug e miglioramenti della stabilità

Release 22.2.1.0.1 (220423)

  • Nuovi comandi dbaascli
    • È stata introdotta l'amministratore dbaascli showLatestStackVersion per mostrare la versione più recente di dbaastools disponibile per il download e l'installazione da parte dei clienti. L'installazione di dbaastools rpm può essere eseguita utilizzando il comando dbaascli admin updateStack. Per ulteriori informazioni, vedere la sezione "Riferimento al comando dbaascli".
  • Libreria software cloud
    • Non più valido il supporto per l'attivazione della BP (dbaascli cswlib activateBP) poiché i processi aziendali (patch di bundle) sono ora sostituiti con le RU ("Aggiornamenti di release"). L'implementazione cloud utilizza le RU sotto forma di immagini software, identificate con "tag immagine". Si consiglia pertanto di utilizzare i tag immagine durante l'interfaccia con i comandi della libreria software cloud (cswlib). Per ulteriori informazioni, vedere dbaasscli cswlib download -help.
    • Ha eliminato la necessità di scaricare immagini non CDB per creare database nonCDB. Ora gli utenti possono creare il database nonCDB utilizzando immagini normali. Per ulteriori informazioni, vedere l'opzione createAsCDB in dbaascli database create -help.
  • Creazione di database non CDB
    • Workflow di creazione del database migliorato per creare un database nonCDB utilizzando l'immagine software del database standard. Per ulteriori informazioni, vedere l'opzione createAsCDB in dbaascli database create -help.
  • Applicazione patch home database
    • Nuovo workflow ottimizzato
  • Upgrade di Grid Infrastructure
    • Nuovo workflow ottimizzato
  • Operazioni plugin (PDB)
    • L'eliminazione del PDB negli ambienti DataGuard richiede una conferma esplicita per indicare che le operazioni necessarie sul sito in standby sono state completate passando l'argomento aggiuntivo -allStandByPrepared. Per informazioni dettagliate, vedere dbaascli pdb delete --help
  • Funzionalità in sequenza fornita per l'operazione di mancato recapito del database. Per informazioni dettagliate, vedere dbaascli database bounce -help.
  • Varie correzioni di bug e miglioramenti della stabilità

Release 22.1.1.2.0 (220405)

  • Aggiunto il supporto per ExaDB-D X9M
  • Varie correzioni di bug e miglioramenti della stabilità

Release 22.1.1.1.0 (220317)

  • Nuovi comandi dbaascli:
    • È stato introdotto dbaascli system getDBHomes per ottenere tutte le Oracle home del database nel cluster. L'output viene restituito in formato JSON per facilitare l'automazione.
    • È stato introdotto dbaascli dbhome getDetails per ottenere informazioni dettagliate su una Oracle home specifica. L'output viene restituito in formato JSON per facilitare l'automazione.
  • Libreria software cloud (cswlib):
    • Supporto per il comando dbaascli cswlib list non più valido per le operazioni di elenco della libreria software cloud. Il nuovo comando è dbaascli cswlib showImages che elenca le immagini insieme al relativo comando ImageTag. Si consiglia di utilizzare Image tags per scaricare le immagini dalla libreria software cloud. Per i dettagli sui download che utilizzano tag immagine, vedere dbaascli cswlib download –help.
    • Varie correzioni di bug e miglioramenti della stabilità

Release 22.1.0.1 (220223)

  • Upgrade di Grid Infrastructure
    • Nuovo workflow ottimizzato
  • Backup e recupero del database
    • Aggiornamento interno al repository di metadati per i metadati di backup
    • Sono stati introdotti messaggi di deprezzamento per i comandi bkup_api poiché ora vengono sostituiti con i comandi dbaascli. Per i dettagli, vedere 'dbaascli database backup --help' e 'dbaascli database recover -help'
  • Operazioni plugin (PDB)
    • L'operazione di riposizionamento del PDB è ora supportata. Per ulteriori informazioni, vedere 'dbaascli pdb relocate -help'.
    • Workflow rinnovato per la conversione da nonCDB a PDB. Per ulteriori informazioni, vedere 'dbaascli database convertToPDB -help'.
  • Gestione delle chiavi di cifratura
    • I parametri di inizializzazione specifici dell'heartbeat TDE (Transparent Data Encryption) sono impostati sui valori consigliati dal cloud per i database con 'Chiavi gestite dal cliente'.
  • Gestione della libreria software cloud
    • Download aggiornato della libreria software degli artifact tramite imageTags. Si consiglia di utilizzare imageTags per scaricare le immagini del database e del software Grid. Per i dettagli, vedere 'dbaascli cswlib showimages' e 'dbaascli cswlib download -help'
  • Incluso AHF versione 21.4.2
  • Varie correzioni di bug e miglioramenti della stabilità

Release 21.4.1.1.0 (220209)

  • Incluso AHF versione 21.4.1
  • Correzioni di bug e miglioramenti della stabilità

Release 21.4.1.1.0

  • Cifratura abilitata delle tablespace a livello di sistema (SYSTEM, SYSAUX, UNDO e TEMP) per i database che verranno creati con questa versione di dbaastools in poi. Questa funzione è abilitata per Oracle Database versione 19.6.0.0.0 e successive.
  • Applicazione delle patch Grid:
    • Condizione del prerequisito aggiunta per verificare che la proprietà del file seguente sia di proprietà dell'utente grid.
      • <gi_home>/suptools/tfa/release/tfa_home/jlib/jdev-rt.jar
      • <gi_home>/suptools/tfa/release/tfa_home/jlib/jewt4.jar
  • Applicazione patch database:
    • L'operazione database move simultanea non è consentita per impostazione predefinita. Viene introdotta una nuova opzione –allowParallelDBMove che può essere utilizzata per eseguire l'override del comportamento predefinito per Oracle Database release 12.2 e successive.
    • Risolti i problemi relativi allo spostamento dei database in standby in modalità MOUNT.
  • Backup e recupero del database:
    • Aggiunte nuove opzioni della riga di comando per il backup del database. Per ulteriori informazioni, vedere il riferimento al comando dbaascli database backup.
    • Aggiunte nuove opzioni della riga di comando per il recupero del database. Per ulteriori informazioni, vedere il riferimento al comando dbaascli database recover.
    • L'uso di bkup_api per le operazioni di backup e recupero non sarà più valido in futuro.
    • Per allinearsi alla procedura consigliata da Oracle di utilizzo del privilegio amministrativo SYSBACKUP per le operazioni di backup e recupero, l'automazione cloud crea un utente amministrativo comune C##DBLCMUSER con il ruolo SYSBACKUP a livello di contenitore CDB$ROOT. Le operazioni di backup e recupero vengono pertanto eseguite con l'utente che dispone dei privilegi minimi necessari. Le credenziali per questo utente vengono generate in modo casuale e gestite in modo sicuro dall'automazione cloud. Se l'utente non viene trovato o è LOCKED e EXPIRED, l'automazione cloud ricreerà o sbloccherà questo utente durante l'operazione di backup o recupero. Questo cambiamento nell'automazione cloud avviene a partire da dbaastools versione 21.4.1.1.0.
  • Funzionalità dbaascli resume migliorata per riprendere qualsiasi sessione precedente specificando l'argomento –sessionID <value> nel comando di ripresa. L'ID sessione viene condiviso sia nell'output dbaascli che nei log.
  • Output dbaascli help migliorato per mostrare l'uso del comando.
  • Uso della shell dbaascli (sessione interattiva) non più valido. Questo sarà completamente non supportato dopo marzo 2022. Si consiglia di eseguire comandi dbaascli completi sul prompt dei comandi, come suggerito in tutti gli esempi di documenti.
  • Autonomous Health Framework (AHF) versione 21.2.8 incluso.
  • Varie correzioni di bug e miglioramenti della stabilità.

Release 21.3.1.2.0

  • Ha migliorato la tempistica delle operazioni dbaascli con una logica di sincronizzazione avanzata dei metadati del piano di controllo.
  • Log dbaascli migliorati per avere informazioni di livello millisecondo insieme al thread associato.
  • Sono stati introdotti ulteriori controlli dei prerequisiti nell'applicazione di patch alla home del database e nelle operazioni di spostamento del database per rilevare potenziali scenari di errori con suggerimenti per azioni correttive.
  • Le operazioni di applicazione delle patch al database ora mantengono lo stato dei database uguale a quello precedente all'applicazione delle patch. Per i pluggable database, viene mantenuto lo stato salvato del PDB.
  • Varie correzioni di bug e miglioramenti della stabilità.

Release 21.3.1.1.0

  • Aggiunto il supporto per sbloccare l'account utente amministratore PDB nell'ambito della creazione del PDB, dell'operazione localClone o remoteClone. Per maggiori dettagli, vedere l'opzione --lockPDBAdminAccount in dbaascli pdb create --help.
  • Risolto un problema che aggiornava la risorsa di database registrata con Oracle Grid Infrastructure negli ambienti esistenti con il valore corretto del nome del database.
  • Operazioni del ciclo di vita PDB avanzate.
  • Varie correzioni di bug e miglioramenti della stabilità.

Release 21.3.1.0.1

  • Supporto per i seguenti comandi dbaascli da eseguire come utente oracle.
    • dbaascli pdb bounce
    • dbaascli pdb close
    • dbaascli pdb connectString
    • dbaascli pdb create
    • dbaascli pdb delete
    • dbaascli pdb getDetails
    • dbaascli pdb list
    • dbaascli pdb localClone
    • dbaascli pdb open
    • dbaascli pdb remoteClone
  • Applicazione patch non in loco rinnovata del database. Per ulteriori informazioni, vedere dbaascli database move –help.
  • Tempificazione dei miglioramenti correlati nel flusso di lavoro di applicazione delle patch di Oracle Grid Infrastructure. Per ulteriori informazioni, vedere dbaascli grid patch –help.
  • Supporto per exadbcpatchmulti/dbaascli patch non più valido per le operazioni di applicazione delle patch. Vengono forniti i comandi dbaascli dbhome patch e dbaascli grid patch per l'operazione di applicazione delle patch per le home del database e Oracle Grid Infrastructure. Per i dettagli, fare riferimento alle sezioni Applicazione di patch a Oracle Grid Infrastructure e Oracle Database Using dbaascli. Vedere anche la sezione Riferimento al comando dbaascli.
  • Supporto del comando patch degli strumenti dbaascli non più valido per garantire la coerenza nelle convenzioni dei comandi dbaascli. Il nuovo comando è dbaascli admin updateStack. Per i dettagli, vedere la sezione Aggiornamento degli strumenti cloud mediante dbaascli.
  • Possibilità di eseguire dbaascli in modalità disconnessa per operazioni con tempi di esecuzione lunghi. L'esecuzione del comando dbaascli con --waitForCompletion false consente di ottenere un ID job che può essere sottoposto a query in un secondo momento per ottenere lo stato dell'operazione, utilizzando dbaascli job getStatus –jobid job_id. Ciò è utile per le operazioni con tempi di esecuzione lunghi in cui gli utenti potrebbero voler recuperare il controllo immediatamente dopo l'esecuzione del comando. In questa release questa opzione è disponibile solo per il comando dbaascli database create. Nelle release successive verranno aggiunti altri comandi per usufruire di questo supporto. L'output della Guida per tali comandi rifletterà il supporto dell'opzione --waitForCompletion.
  • Supporto per la shell dbaascli non più valido. Si consiglia di eseguire i comandi dbaascli completi sul prompt dei comandi come suggerito in tutti gli esempi di documento. L'esecuzione di soli dbaascli mostrerà l'output della relativa Guida all'uso invece di entrare in una shell dbaascli.
  • Varie correzioni di bug e miglioramenti della stabilità.

Versione 21.2.1.x.x

  • Operazione di applicazione delle patch di Oracle Grid Infrastructure ridisegnata e aggiunta la possibilità di riprendere da un punto non riuscito, applicare patch al subset di nodi, eliminare istanze e altri miglioramenti. Per ulteriori informazioni, vedere dbaascli grid patch --help. Fare riferimento anche alla sezione Applicazione di patch a Oracle Grid Infrastructure e Oracle Database mediante dbaascli.
  • Supporto per exadbcpatchmulti/dbaascli patch non più valido per le operazioni di applicazione delle patch. I comandi dbaascli dbhome patch e dbaascli grid patch vengono forniti per l'operazione di applicazione delle patch per le home del database e Oracle Grid Infrastructure. Per i dettagli, fare riferimento alla sezione Applicazione di patch a Oracle Grid Infrastructure e Oracle Database mediante dbaascli. Vedere anche la sezione Riferimento al comando dbaascli.
  • Supporto per il comando dbaascli tools patch non più valido per garantire la coerenza nelle convenzioni dei comandi. Il nuovo comando è dbaascli admin updateStack.
  • API di gestione PDB ridisegnate per le operazioni di creazione, copia locale e copia remota. Per ulteriori informazioni, vedere dbaascli pdb --help.
  • API di eliminazione del database ridisegnata. Per ulteriori informazioni, vedere dbaascli database delete --help.
  • Creazione di dbhome rinnovata (supporto per immagini software personalizzate, operazione di scale-out). Per ulteriori informazioni, vedere dbaascli dbhome create --help.
  • Supporto per la creazione del database nel subset dei nodi cluster. Per ulteriori informazioni, vedere dbaascli database create --help.
  • Possibilità di eseguire dbaascli in modalità disconnessa per operazioni con tempi di esecuzione lunghi. L'esecuzione del comando dbaascli con --waitForCompletion false consente di ottenere un ID job che può essere sottoposto a query in un secondo momento per ottenere lo stato dell'operazione, utilizzando dbaascli job getStatus –jobid job_id. Ciò è utile per le operazioni con tempi di esecuzione lunghi in cui gli utenti potrebbero voler recuperare il controllo immediatamente dopo l'esecuzione del comando. In questa release questa opzione è disponibile solo per il comando dbaascli database create. Nelle release successive verranno aggiunti altri comandi per usufruire di questo supporto. L'output della Guida per tali comandi rifletterà il supporto dell'opzione --waitForCompletion.
  • Migliorata l'esperienza di applicazione delle patch dbhome con l'introduzione di più opzioni come skipPDBs, continueWithDowntime e così via. Per ulteriori informazioni, vedere dbaascli dbhome patch --help.
  • Supporto per una migliore raccolta diagnostica. Per ulteriori informazioni, vedere dbaascli diag collect --help.
  • Minori miglioramenti nell'area dell'automazione degli aggiornamenti del database.
  • Varie correzioni di bug e miglioramenti della stabilità.

Guida di riferimento ai comandi dbaascli

È necessario utilizzare dbaascli per creare i database e integrarli con il framework di automazione del cloud.

dbaascli è un'interfaccia cloud nativa che può prendere i modelli DBCA come input, chiama la funzionalità di DBCA per creare i database e quindi chiama le API OCI per integrare il database nel framework di automazione del cloud. I clienti che utilizzano DBCA negli script di oggi possono aggiornare gli script esistenti per chiamare dbaascli anziché DBCA. Se non è possibile utilizzare dbaascli a causa della non disponibilità di una determinata funzione di DBCA in dbaascl, i clienti devono aprire una richiesta MOS (My Oracle Support) per aggiungere tale funzionalità a dbaascli.

Per utilizzare la utility dbaascli, è necessario essere connessi a un nodo di calcolo dell'infrastruttura Exadata Cloud. Per istruzioni, vedere Connessione a un'istanza dell'infrastruttura Exadata Cloud.

Alcuni comandi dbaascli possono essere eseguiti come utente oracle o opc, ma molti comandi richiedono privilegi di amministratore root. Fare riferimento a ciascun comando per requisiti specifici.

amministratore dbaascli updateAHF

Per installare o aggiornare Autonomous Health Framework (AHF), utilizzare il comando dbaascli admin updateAHF.

Prerequisiti

Eseguire il comando come utente root.

Sintassi

dbaascli admin updateAHF
 {
   --targetVersion value | --imageTag value
}
[--resume [--sessionID value]] [--executePrereqs]
Dove:
  • --targetVersion specifica la versione di destinazione alla quale eseguire l'aggiornamento di AHF
  • --imageTag specifica la tag immagine dell'artifact AHF da installare
  • --resume riprende l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --executePrereqs esegue i controlli dei prerequisiti e segnala i risultati

amministratore dbaascli updateStack

Per installare o aggiornare un RPM dbaastools, utilizzare il comando dbaascli admin updateStack.

Prerequisiti

Eseguire il comando come utente root.

Per utilizzare la utility, è necessario connettersi a una virtual machine dell'infrastruttura Exadata Cloud.

Vedere Connessione a una Virtual Machine con SSH.

Sintassi

dbaascli admin updateStack 
[--resume]
[--prechecksOnly]
[--nodes]
Dove:
  • --resume riprende l'esecuzione precedente
  • --prechecksOnly esegue solo i controlli preliminari per questa operazione
  • --nodes specifica una lista delimitata da virgole di nodi su cui installare l'RPM. Se non si passa questo argomento, l'RPM verrà installato su tutti i nodi del cluster

dbaascli cswlib deleteLocal

Per eliminare l'immagine locale, utilizzare il comando dbaascli cswlib deleteLocal.

Eseguire il comando come utente root.

Sintassi

dbaascli cswLib deleteLocal --imageTag <value>

Dove:

  • --imageTag specifica la tag immagine della Oracle home

Esempio 6-4 dbaascli cswlib deleteelocal

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

dbaascli cswlib scaricare

Per scaricare le immagini software disponibili e renderle disponibili nell'ambiente dell'infrastruttura Exadata Cloud, utilizzare il comando dbaascli cswlib download.

Prerequisiti

Eseguire il comando come utente root.

Per utilizzare la utility, è necessario connettersi a una virtual machine dell'infrastruttura Exadata Cloud.

Vedere Connessione a una Virtual Machine con SSH.

Sintassi

dbaascli cswlib download --version | --imageTag
[--product]
Dove:
  • --version specifica una versione dell'immagine della Oracle home
  • --imageTag specifica il tag immagine dell'immagine
  • --product specifica il tipo di immagine. Valori validi: database o grid

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

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

Esempio 6-6 dbaascli cswlib download --versione 19.9.0.0.0

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

dbaascli cswlib listLocal

Per visualizzare la lista delle immagini di database e Grid Infrastructure disponibili localmente, utilizzare il comando dbaascli cswlib listLocal.

Eseguire il comando come utente root.

Sintassi

dbaascli cswLib listLocal [--product <value>]

Dove:

  • --product identifica il tipo di prodotto della Oracle home. Valori validi: database o grid.

Esempio 6-7 dbaascli cswlib listlocal

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

dbaascli cswlib showImages

Per visualizzare la lista delle immagini di database e Grid Infrastructure disponibili, utilizzare il comando dbaascli cswlib showImages.

Eseguire il comando come utente root.

Sintassi

dbaascli cswlib showImages 
[--product]

Dove:

  • --product identifica il tipo di prodotto della Oracle home. Valori validi: database o grid.

Esempio 6-8 dbaascli cswlib showImages

dbaascli cswlib showImages

database dbaascli addInstance

Per aggiungere l'istanza di database sul nodo specificato, utilizzare il comando dbaascli database addInstance.

Prerequisito

  • Eseguire il comando come utente root.

Sintassi

dbaascli database addInstance --dbname <value> --node <value> [--newNodeSID <value>]
Dove:
  • --dbname specifica il nome di Oracle Database
  • --node specifica il nome del nodo per l'istanza di database
    • --newNodeSID specifica il SID per l'istanza da aggiungere nel nuovo nodo

backup del database dbaascli

Per configurare Oracle Database con una destinazione di storage di backup, eseguire backup del database, eseguire query sui backup ed eliminare un backup, utilizzare il comando dbaascli database backup.

Prerequisito

  • Eseguire il comando come utente root.

Sintassi

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

Dove:

  • --dbname specifica il nome di Oracle Database
  • --list restituisce le informazioni di backup del database

    [--backupType | --json]

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

    [--json specifica il nome file per l'output JSON ]

  • --start avvia il backup del database

    [--level0 crea un backup di livello 0 (intero)]

    [--level1 crea un backup di livello 1 (incrementale) ]

    [--archival | --archivelog]

    [--archival crea un backup completo di archiviazione]

    --tag specifica la tag di backup

    [--archivelog ]

  • --delete elimina il backup di archiviazione

    --backupTag specifica la tag di backup da eliminare

  • --status visualizza i dettagli di elaborazione del job di backup

    Identificativo univoco --uuid dell'operazione di backup. Formato di input: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

    [--json specifica il nome file per l'output JSON]

  • --getBackupReport restituisce BackupReport

    --tag | --latest

    --tag specifica la tag di backup

    --latest restituisce il report di backup più recente ( tutti i tipi di backup del database)

    --json specifica il nome file per l'output JSON

  • --configure configura il database per il backup

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

    --configFile specifica il file di configurazione del backup del database

    --enableRTRT abilita il trasporto di redo in tempo reale

    --disableRTRT disabilita il trasporto di redo in tempo reale

    --disableCatalog disabilita il Recovery Catalog

    --deleteImmutableConfiguration elimina la configurazione non modificabile

  • --getConfig restituisce la configurazione di backup del database

    [--configFile | --showOldParams]

    [--configFile specifica il file di configurazione del backup del database]

    [--showOldParams restituisce i vecchi nomi dei parametri della configurazione di backup.]

  • --validate convalida i backup completi e non danneggiati

    [--untilTime convalida il backup di livello 0 (completo) più vicino fino al momento fornito. Formato di input: DD-MON-YYYY HH24:MI:SS]

  • --showHistory visualizza la cronologia delle operazioni di backup.

    [--all visualizza tutte le operazioni di backup]

  • --getSchedules restituisce tutte le pianificazioni di backup per il database specificato
Nota

I parametri enableRTRT e disableRTRT sono applicabili solo per la destinazione di backup ZDLRA in Exadata Database Service on Cloud@Customer.

mancato recapito del database dbaascli

Per arrestare e riavviare un database dell'infrastruttura Exadata Cloud specificato, utilizzare il comando dbaascli database bounce.

Prerequisiti

Eseguire il comando come utente oracle.

Sintassi

dbaascli database bounce
[--dbname][--rolling <value>]
Dove:
  • --dbname specifica il nome del database
  • --rolling specifica true o false per riavviare il database in sequenza. Il valore predefinito è false.

Il comando esegue la chiusura del database in modalità immediata. Il database viene quindi riavviato e aperto. In Oracle Database 12c o versione successiva vengono aperti anche tutti i PDB.

Esempio di mancato recapito del database dbaascli 6-9

dbaascli database bounce --dbname dbname

changepassword database dbaascli

Per modificare la password di un utente di Oracle Database specificato, utilizzare il comando dbaascli database changePassword. Quando viene richiesto, immettere il nome utente per il quale si desidera modificare la password, quindi immettere la password.

Prerequisiti

Eseguire il comando come utente root o oracle.

Sintassi

dbaascli database changePassword [--dbname <value>] [--user <value>]
{
  [--prepareStandbyBlob <value> [--blobLocation <value>]] | [--standbyBlobFromPrimary <value>]
}
[--resume [--sessionID <value>]]
Dove:
  • --dbname specifica il nome dell'Oracle Database su cui si desidera agire
  • --user specifica il nome utente di cui è richiesta la modifica della password.
  • --prepareStandbyBlob specifica true per generare un file BLOB contenente gli artifact necessari per modificare la password in un ambiente Data Guard. Valori validi: true|false
  • --blobLocation specifica il percorso personalizzato in cui verrà generato il file blob
  • --standbyBlobFromPrimary specifica il file dell'lob di standby, preparato dal database primario
  • --resume specifica di riprendere l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico

Esempio di database dbaascli 6-10 changePassword

dbaascli database changepassword --dbname db19

database dbaascli convertToPDB

Per convertire il database non CDB specificato in PDB, utilizzare il comando dbaascli database convertToPDB.

Sintassi

dbaascli database convertToPDB --dbname <value> [--cdbName <value>] [--executePrereqs]
        {
            [--copyDatafiles [--keepSourceDB]]|[backupPrepared]
        }
        [--targetPDBName <value>] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Dove:
  • --dbname specifica il nome di Oracle Database
  • --cdbName specifica il nome del CDB di destinazione in cui verrà creato il PDB. Se il CDB non esiste, verrà creato nella stessa Oracle home del database non CDB di origine
  • --executePrereqs specifica di eseguire solo i controlli precedenti alla conversione
  • --copyDatafiles specifica di creare una nuova copia dei file di dati invece di utilizzare quelli del database di origine

    --keepSourceDB: consente di conservare il database di origine dopo il completamento dell'operazione.

  • --backupPrepared: flag per confermare la disponibilità di un backup di database appropriato per un database non CDB prima di eseguire la conversione in PDB.
  • Flag --backupPrepared per confermare la disponibilità di un backup di database appropriato per un database non CDB prima di eseguire la conversione in PDB
  • --targetPDBName specifica il nome del PDB che verrà creato nell'ambito dell'operazione
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valori validi: true|false
  • --resume specifica di riprendere l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico

Esempio di database dbaascli 6-11 convertToPDB

Per eseguire i controlli preliminari alla conversione:
dbaascli database convertToPDB --dbname ndb19 --cdbname cdb19 --backupPrepared --executePrereqs
Per eseguire una conversione completa con una copia dei file di dati dal database non CDB:
dbaascli database convertToPDB --dbname tst19 --cdbname cdb19 --copyDatafiles

creazione database dbaascli

Per creare Oracle Database, utilizzare il comando dbaascli database create. Quando richiesto, immettere le password sys e tde.

Utilizzare questo comando per creare Oracle Database versione 12.1.0.2 o successiva con l'aggiornamento della release JAN 2021 o successiva. Per i database con versioni inferiori, si consiglia di utilizzare l'API basata su OCI Console.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli database create --dbName {--oracleHome | --oracleHomeName}
[--dbUniqueName <value>]
[--dbSID <value>]
[--createAsCDB <value>]
[--pdbName <value>]
[--pdbAdminUserName <value>]
[--dbCharset <value>]
[--dbNCharset <value>]
[--dbLanguage <value>]
[--dbTerritory <value>]
[--sgaSizeInMB <value>]
[--pgaSizeInMB <value>]
[--datafileDestination <value>]
[--fraDestination <value>]
[--fraSizeInMB <value>]
[--nodeList <value>]
[--tdeConfigMethod <value>]
[--kmsKeyOCID <value>]
{
            [--resume [--sessionID <value>]]
            | [--revert [--sessionID <value>]]
        }
[--executePrereqs]
[--honorNodeNumberForInstance <value>]
[--lockPDBAdminAccount <value>]
[--dbcaTemplateFilePath <value>]
[--waitForCompletion]
Dove:
  • --dbname specifica il nome del database
  • --oracleHome specifica la posizione della Oracle home
  • --oracleHomeName specifica il nome della Oracle home.
  • --dbUniqueName specifica un nome database univoco
  • --dbSID specifica il SID del database.
  • --createAsCDB: specificare true o false per creare un database come CDB o non CDB
  • --pdbName specifica il nome PDB
  • --pdbAdminUserName specifica il nome dell'utente amministratore del PDB
  • --dbCharset specifica il set di caratteri del database
  • --dbNCharset specifica il set di caratteri nazionali del database.
  • --dbLanguage specifica la lingua del database
  • --dbTerritory specifica il territorio del database.
  • --sgaSizeInMB specifica il valore sga_target nell'unità megabyte
  • --pgaSizeInMB specifica il valore pga_aggregate_target nell'unità megabyte
  • --datafileDestination specifica il nome del gruppo di dischi ASM da utilizzare per i file di dati del database.
  • --fraDestination specifica il nome del gruppo di dischi ASM da utilizzare per l'area di recupero rapido del database.
  • --fraSizeInMB specifica il valore della dimensione dell'area di recupero rapido in megabyte.
  • --nodeList specifica una lista delimitata da virgole di nodi per il database
  • --tdeConfigMethod specifica il metodo di configurazione TDE. Valori validi: FILE, KMS
  • --kmsKeyOCID specifica l'OCID della chiave KMS da utilizzare per la funzione TDE. Applicabile solo se KMS è selezionato per TDE
  • --resume riprende l'esecuzione precedente
  • --revert esegue il rollback dell'esecuzione precedente
  • --sessionID per riprendere o ripristinare un ID sessione specifico.
  • --executePrereqs specifica yes per eseguire solo i prerequisiti per questa operazione. Valori validi: yes o no
  • --honorNodeNumberForInstance specifica true o false per indicare il nome di istanza al quale aggiungere il suffisso dei numeri di nodo del cluster. Valore predefinito: true
  • --lockPDBAdminAccount specificare true o false per bloccare l'account utente amministratore del PDB. Il valore predefinito è true
  • --dbcaTemplateFilePath: specificare il percorso assoluto del nome del modello dbca per la creazione del database.
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valore valido: true o false

Esempio di creazione del database dbaascli 6-12

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

eliminazione del database dbaascli

Per eliminare un Oracle Database, utilizzare il comando dbaascli database delete.

Requisito

Eseguire il comando come utente root.

Sintassi

dbaascli database delete --dbname <value>
[--deleteArchiveLogs <value>]
[--deleteBackups <value>]
[--precheckOnly <value>]
[--waitForCompletion <value>]
[--force]
[--dbSID <value>]
[--resume [--sessionID <value>]]
Dove:
  • --dbname specifica il nome del database.
  • --deleteArchiveLogs specifica true o false per indicare l'eliminazione dei log di archivio del database.
  • --deleteBackups specifica true o false per indicare l'eliminazione dei backup del database.
  • --precheckOnly specifica yes per eseguire solo i controlli preliminari per questa operazione. Valori validi: yes o no.
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valore valido: true o false.
  • Flag –-force per l'eliminazione forzata del database.
  • --dbSID specifica il SID di database.
  • --resume per riprendere l'esecuzione precedente.
  • --sessionID per riprendere un ID sessione specifico.

Esempio di eliminazione del database dbaascli 6-13

dbaascli database delete --dbname db19

database dbaascli deleteInstance

Per eliminare l'istanza di database sul nodo specificato, utilizzare il comando dbaascli database deleteInstance.

Requisito

  • Eseguire il comando come utente root.

Sintassi

dbaascli database deleteInstance --dbname <value> --node <value> [--continueOnUnreachableNode]
Dove:
  • --dbname specifica il nome di Oracle Database
  • --node specifica il nome del nodo per un'istanza di database
  • --continueOnUnreachableNode specifica di eseguire l'operazione anche se il nodo è non raggiungibile

Esempio 6-14 deleteinstance del database

database deleteinstance --node test-node

duplicato database dbaascli

Per creare un database da un database attivo, utilizzare il comando dbaascli database duplicate.

Prerequisito

  • Eseguire il comando come utente root.

Sintassi

dbaascli database duplicate --dbName <value> --sourceDBConnectionString <value>
        {
            --oracleHome <value>
            | --oracleHomeName <value>
        }
[--dbSID <value>] 
[--dbUniqueName <value>] 
[--sgaSizeInMB <value>] 
[--pgaSizeInMB <value>] 
[--datafileDestination <value>] 
[--fraDestination <value>] 
[--fraSizeInMB <value>] 
[--sourceDBWalletLocation <value>] 
[--nodeList <value>]
        {
            [--resume [--sessionID <value>]]
            | [--revert [--sessionID <value>]]
        }
[--rmanParallelism <value>]
[--rmanSectionSizeInGB <value>]
[--tdeConfigMethod <value>]
[--kmsKeyOCID <value>]
[--sourceDBTdeConfigMethod <value>]
[--sourceDBKmsKeyOCID <value>]
[--executePrereqs <value>] 
[--waitForCompletion <value>]
[--skipPDBs <value>]
Dove:
  • --dbName specifica il nome di Oracle Database
  • --sourceDBConnectionString specifica la stringa di connessione al database di origine nel formato <scan_name>:<scan_port>/<database_service_name>
  • --oracleHome specifica la posizione della Oracle home
  • --oracleHomeName specifica il nome della Oracle home.
  • --dbSID specifica il SID del database.
  • --dbUniqueName specifica un nome database univoco
  • --sgaSizeInMB specifica il valore sga_target in megabyte.
  • --pgaSizeInMB specifica il valore pga_aggregate_target in mega byte unit
  • --datafileDestination specifica il nome del gruppo di dischi ASM da utilizzare per i file di dati del database.
  • --fraDestination specifica il nome del gruppo di dischi ASM da utilizzare per l'area di recupero rapido del database.
  • --fraSizeInMB specifica il valore della dimensione dell'area di recupero rapido in megabyte.
  • --sourceDBWalletLocation specifica la posizione del file wallet TDE del database di origine. Obbligatorio per duplicare un database da un database attivo
  • --nodeList specifica una lista delimitata da virgole di nodi per il database
  • --resume specifica di riprendere l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --revert specifica di eseguire il rollback dell'esecuzione precedente
    • --sessionID specifica di eseguire il rollback di un ID sessione specifico
  • --rmanParallelism specifica il valore del parallelismo.
  • --rmanSectionSizeInGB specifica la dimensione della sezione RMAN in GB.
  • --tdeConfigMethod specifica il metodo di configurazione TDE. I valori consentiti sono FILE e KMS.
  • --kmsKeyOCID specifica l'OCID della chiave KMS da utilizzare per la funzione TDE. È applicabile solo se il valore KMS è selezionato per la funzione TDE.
  • --sourceDBTdeConfigMethod specifica il metodo di configurazione TDE del database di origine. I valori consentiti sono FILE e KMS.
  • --sourceDBKmsKeyOCID specifica l'OCID della chiave KMS del database di origine da utilizzare per la funzione TDE. È applicabile solo se il valore KMS è selezionato per la funzione TDE.
  • --executePrereqs specifica yes per eseguire solo i prerequisiti per questa operazione. Valori validi: yes|no
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valori validi: true|false
  • --skipPDBs specifica una lista delimitata da virgole dei nomi dei PDB del database di origine, che deve essere esclusa per l'operazione di duplicazione del database. Esempio: pdb1,pdb2...

Esempio di duplicato del database dbaascli 6-15

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

database dbaascli getDetails

Questo comando mostra le informazioni dettagliate di un determinato database, ad esempio dbname, informazioni sul nodo, informazioni sui pluggable database e così via.

Prerequisiti

Eseguire il comando come utente root o oracle

Sintassi

dbaascli database getDetails --dbname <value>
dove :
  • --dbname: nome del database Oracle.

database dbaascli getPDBs

Per visualizzare la lista di tutti i pluggable database in un container database, utilizzare il comando dbaascli database getPDBs.

Eseguire il comando come utente root o oracle.

Sintassi

dbaascli database getPDBs --dbname <value>
Dove:
  • --dbname specifica il nome del container database

Esempio di database dbaascli 6-16 getPDBs --dbname

dbaascli database getPDBs --dbname apr_db1

database dbaascli modifyParameters

Per modificare o reimpostare i parametri di inizializzazione per un Oracle Database, utilizzare il comando dbaascli database modifyParameters.

Requisito

Eseguire il comando come utente root.

Sintassi

dbaascli database modifyParameters --dbname <value> --setParameters <values>| --resetParameters <values> | --responseFile
[--backupPrepared]
[--instance]
[--allowBounce]
Dove:
  • --dbname specifica il nome del database.
  • --setParameters specifica una lista delimitata da virgole di parametri da modificare con nuovi valori. Ad esempio: parameter1=valueA,parameter2=valueB e così via. Per i valori vuoti utilizzare parameter1=valueA,parameter2='', e così via.
  • --resetParameters specifica un elenco delimitato da virgole di parametri da reimpostare sui valori predefiniti corrispondenti. Ad esempio, parameter1,parameter2 e così via.
  • --responseFile specifica la posizione assoluta del file JSON di risposta per modificare i parametri del database
  • --backupPrepared conferma la disponibilità di un backup del database prima di modificare i parametri critici o riservati.
  • --instance specifica il nome dell'istanza in cui verranno elaborati i parametri. Se non viene specificato, l'operazione verrà eseguita a livello di database.
  • --allowBounce concede l'autorizzazione per il riavvio del database al fine di riflettere le modifiche apportate ai parametri statici applicabili.

Esempio di database dbaascli 6-17 modifyParameters

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

spostamento del database dbaascli

Per spostare il database da una home a un'altra, utilizzare il comando dbaascli database move.

Prerequisiti

  • Prima di eseguire un'operazione di spostamento, assicurarsi che tutte le istanze di database associate al database siano attive e in esecuzione.
  • Eseguire il comando come utente root.

Sintassi

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

Dove:

  • --oracleHome specifica il percorso della Oracle home
  • --oracleHomeName specifica il nome della Oracle home.
  • --dbname specifica il nome del database
  • --executePrereqs esegue i controlli dei prerequisiti e segnala i risultati
  • --nonRolling sposta il database su tutti i nodi in parallelo.

    Si noti che ciò causerebbe tempi di inattività del database.

  • --resume riprende l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --rollback esegue il rollback del database nella home precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --skipDatapatch salta l'esecuzione della patch dati sui database
  • --skipPdbs salta l'esecuzione della patch dati in una lista delimitata da virgole specificata di PDB.

    Ad esempio: pdb1,pdb2...

  • --skipClosedPDBs salta l'applicazione delle patch ai PDB chiusi
  • --continueWithDbDowntime continua l'applicazione delle patch con i tempi di inattività del database.

    Questa opzione può essere utilizzata in ambienti in cui è attiva una sola istanza attiva e l'operazione di applicazione delle patch può essere continuata anche con un tempo di inattività.

  • --drainTimeoutInSeconds specifica il tempo (in secondi) per il completamento dell'estrazione della risorsa durante l'arresto del database
  • --allowParallelDBMove consente lo spostamento del database in parallelo.
  • --waitForCompletion specifica false per eseguire l'operazione in background.

    Valori validi: true|false

  • --nodeList specifica una lista di nodi delimitata da virgole se l'operazione deve essere eseguita su un subset di nodi

Esempio di spostamento del database dbaascli 6-18

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

recupero database dbaascli

Per recuperare un database, utilizzare il comando dbaascli database recover.

Requisito

  • Eseguire il comando come utente root.
  • Il database deve essere stato configurato con i dettagli di destinazione dello storage di backup in cui sono memorizzati i backup.

Sintassi

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

Esempi di esempio 6-19

  • Per recuperare il database myTestDb alla versione più recente:
    dbaascli database recover --dbname myTestDb --start --latest
  • Per eseguire una query sullo stato della richiesta di recupero sottomessa con uuid 2508ea18be2911eb82d0020017075151:
    dbaascli database recover --dbname myTestDb --status --uuid 2508ea18be2911eb82d0020017075151

database dbaascli runDatapatch

Per applicare le patch a un Oracle Database, utilizzare il comando dbaascli database runDatapatch.

Prerequisiti

  • Prima di eseguire un'operazione runDatapatch, assicurarsi che tutte le istanze di database associate al database siano attive e in esecuzione.

  • Eseguire il comando come utente root.

Sintassi

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

Dove:

  • --dbname specifica il nome del database
  • --resume riprende l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --skipPdbs salta l'esecuzione della patch dati in una lista delimitata da virgole specificata di PDB. Ad esempio: pdb1,pdb2...
  • --pdbs esegue la patch dati solo in una lista di PDB delimitati da virgole specificata. Ad esempio: pdb1,pdb2...
  • --executePrereqs esegue i controlli dei prerequisiti
  • --patchList applica o esegue il rollback della lista di patch delimitata da virgole specificata. Ad esempio: patch1,patch2...
  • --skipClosedPdbs salta l'esecuzione della patch dati nei PDB chiusi
  • --rollback esegue il rollback delle patch applicate
dbaascli database runDatapatch --dbname db19

database dbaascli createTemplate

Utilizzare questo comando per creare modelli di database (modelli DBCA) che possono essere successivamente utilizzati per creare i database.

Eseguire il comando come utente root o oracle.

Sintassi

Creare un nuovo modello DBCA dal database specificato.

dbaascli database createTemplate --dbname <value>
 {
   --templateLocation <value> | --uploadToObjectStorage --objectStorageLoginUser <value> --objectStorageBucketName <value> [--objectStorageUrl <value>]
 }
 [--templateName <value>] [--rmanParallelism <value>]
Dove:
  • --dbname specifica il nome del database
  • --templateLocation specifica il nome del modello.
  • --uploadToObjectStorage: specifica di caricare il modello nello storage degli oggetti.
    • --objectStorageLoginUser: specifica l'utente di login dello storage degli oggetti.
    • --objectStorageBucketName: specifica il nome del bucket dello storage degli oggetti.
    • --objectStorageUrl: specifica l'URL dello storage degli oggetti.
  • --templateName: specifica il nome del modello
  • --rmanParallelism specifica il valore del parallelismo.

avvio del database dbaascli

Per avviare un Oracle Database, utilizzare il comando dbaascli database start.

Prerequisiti

Eseguire il comando come utente root.

Sintassi

dbaascli database start
[--dbname]
[--mode]
Dove:
  • --dbname specifica il nome del database
  • --mode specifica il MOUNT o il MOUNT per avviare il database nella modalità corrispondente

Il comando avvia e apre il database. In Oracle Database 12c o versione successiva vengono aperti anche tutti i PDB.

Esempio di avvio del database dbaascli da 6 a 20

dbaascli database start --dbname dbname --mode mount

stato database dbaascli

Per controllare lo stato di un Oracle Database, utilizzare il comando dbaascli database status.

Prerequisiti

Eseguire il comando come utente root.

Sintassi

dbaascli database status
[--service][--dbname] 
[--user]
[--password]
Dove:
  • --service specifica il nome del servizio
  • --dbname specifica il nome del database
  • --user specifica il nome utente del servizio
  • --password specifica la password dell'utente

L'output del comando include la modalità di apertura del database, la release e l'edizione del software del database e la versione della release di altri componenti software.

Esempio di stato del database dbaascli 6-21

dbaascli database status --dbname db19

arresto del database dbaascli

Per arrestare un Oracle Database, utilizzare il comando dbaascli database stop.

Prerequisiti

Eseguire il comando come utente root.

Sintassi

dbaascli database stop
[-–dbname <value>]
[--mode <value>]
Dove:
  • --dbname specifica il nome del database che si desidera arrestare
  • --mode specifica la modalità del database. Valori validi: abort, immediate, normal, transactional

Il comando esegue la chiusura del database in modalità immediata. Non sono consentite nuove connessioni o nuove transazioni. Viene eseguito il rollback delle transazioni attive e tutti gli utenti connessi vengono scollegati.

Esempio di arresto del database dbaascli 6-22

dbaascli database stop --dbname db19

aggiornamento del database dbaascli

Per aggiornare un Oracle Database, utilizzare il comando dbaascli database upgrade.

Requisito

Eseguire il comando come utente root.

Sintassi

dbaascli database upgrade --dbname <value> 
{--targetHome <value> | --targetHomeName <value>}
{ [--executePrereqs | --postUpgrade | --rollback]}
{[--standBy | --allStandbyPrepared]}
{[--upgradeOptions <value>]  | [--standBy]}
[--removeGRP]
[--increaseCompatibleParameter]
[--resume [--sessionID <value>]]
[--waitForCompletion <value>]
Dove:
  • --dbname (obbligatorio) specifica il nome del database.
  • --targetHome specifica la posizione della Oracle home di destinazione
  • --targetHomeName specifica il nome della Oracle Database home di destinazione.
  • --standBy utilizzare questa opzione per eseguire l'upgrade dei database di standby nelle configurazioni Data Guard
  • --allStandbyPrepared richiesto per i database primari configurati da Data Guard. Flag per confermare che tutte le operazioni necessarie vengono eseguite sui database di standby prima dell'upgrade del database primario
  • --removeGRP rimuove automaticamente il backup del punto di ripristino garantito (GRP) solo se l'upgrade del database è riuscito
  • --increaseCompatibleParameter aumenta automaticamente il parametro compatibile nell'ambito dell'aggiornamento del database. Il parametro viene aumentato solo se l'upgrade del database è riuscito
  • --executePrereqs esegue solo i controlli precedenti all'upgrade
  • --postUpgrade utilizzare questa opzione se dopo l'upgrade non riesce e deve rieseguire i passi successivi all'upgrade
  • --rollback ripristina un Oracle Database nella relativa Oracle home originale
  • --upgradeOptions utilizzare questa opzione per passare argomenti specifici di DBUA per eseguire l'upgrade di Oracle Database. Fare riferimento alla documentazione Oracle corrispondente per conoscere le opzioni e gli argomenti supportati.

    --standby

  • --resume per riprendere l'esecuzione precedente
  • --sessionID per riprendere un ID sessione specifico.
  • --waitForCompletion: specificare false per eseguire l'operazione in background. Valori validi : true|false.

Esempio 6-23 controlli dei requisiti di aggiornamento del database dbaascli precedenti all'aggiornamento

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

Data Guard dbaascli prepareStandbyBlob

Per generare un file BLOB contenente vari file necessari nel sito in standby in caso di ambiente Data Guard, utilizzare il comando dbaascli dataguard prepareStandbyBlob.

Eseguire il comando come utente root o oracle.

Sintassi

dbaascli dataguard prepareStandbyBlob --dbname <value> --blobLocation <value>
Dove:
  • --dbname specifica il nome di Oracle Database
  • --blobLocation specifica la posizione della directory personalizzata in cui verrà generato il file dell'oggetto BLOB di standby in un ambiente Data Guard

Data Guard dbaascli updateDGConfigAttributes

Per aggiornare gli attributi di automazione Data Guard in tutti i nodi del cluster, utilizzare il comando dbaascli dataguard updateDGConfigAttributes.

Eseguire il comando come utente root o oracle.

Sintassi

dbaascli dataguard updateDGConfigAttributes --attributes <value>
Dove:
  • --attributes contiene gli attributi di automazione Data Guard da modificare. Accetta valori delimitati da virgole nel formato <attribute=value>. Gli attributi devono essere predefiniti nel file di configurazione Data Guard.

failover dataguard dbaascli

Per eseguire un failover manuale sul database in standby, utilizzare il comando dataguard failover.

Eseguire questo comando come utente oracle nel database di standby di destinazione.

Sintassi

dbaascli dataguard failover --dbname <value> [--useImmediateFailover] [--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Dove:
  • --dbname specifica il nome di Oracle Database.
  • --useImmediateFailover utilizza questo flag quando la configurazione di Oracle Data Guard è in stato di avvertenza o errore.
  • --executePrereqs esegue i controlli dei prerequisiti e restituisce i risultati.
  • --waitForCompletion specifica se attendere il completamento dell'operazione. Impostare su false per eseguire l'operazione in background. Valori validi: true|false.
  • --resume riprende l'operazione precedente.
  • --sessionID riprende una sessione specifica in base al relativo ID.
Esecuzione di un'operazione di failover manuale mediante la utility dbaascli

Per eseguire un failover manuale sul database in standby, utilizzare il comando dataguard failover.

  1. Connettersi alla virtual machine nella configurazione di Oracle Data Guard che ospiterà il nuovo database primario come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una virtual machine con SSH.

  2. Avviare una shell del comando dell'utente root e passare all'utente oracle:
    $ sudo -s
    # su - oracle
    $
  3. Avviare il failover al database di standby.
    $ dbaascli dataguard failover --dbname <db-name>
  4. Torna a essere utente root.
    $ exit
    #
  5. Uscire dalla shell dei comandi utente root e disconnettersi dalla virtual machine.
    # exit
    $ exit

dbaascli dataguard reintegrato

Per ripristinare un database non riuscito come database di standby dopo un failover, utilizzare il comando dataguard reinstate.

Eseguire questo comando come utente oracle in cui è richiesta la reintegrazione (database di standby non riuscito).

Sintassi

dbaascli dataguard reinstate --dbname <value> [--primaryDBUniqueName <value>] [--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Dove:
  • --dbname specifica il nome di Oracle Database.
  • --primaryDBUniqueName specifica il nome univoco del database primario corrente nell'impostazione di Oracle Data Guard.
  • --executePrereqs esegue i controlli dei prerequisiti e restituisce i risultati.
  • --waitForCompletion specifica se attendere il completamento dell'operazione. Impostare su false per eseguire l'operazione in background. Valori validi: true|false.
  • --resume riprende l'operazione precedente.
  • --sessionID riprende una sessione specifica in base al relativo ID.

Per determinare quando un membro deve essere reintegrato in una configurazione Data Guard (DG):

Monitorare l'output dgmgrl show database per individuare i seguenti errori ORA:

  • Nel nuovo cluster primario:

    ORA-16661: è necessario ricreare un'istanza di database di standby

  • Nel cluster primario precedente:

    ORA-16623: Il membro ha rilevato una modifica dei ruoli

Questi messaggi indicano che si è verificato un failover. Per ripristinare la sincronizzazione completa all'interno della configurazione Data Guard, è necessario ripristinare il precedente primario.

Ripristino di un database primario non riuscito mediante la utility dbaascli

Per ripristinare un database primario non riuscito dopo un failover, utilizzare il comando dataguard reinstate.

  1. Connettersi a una delle virtual machine nella configurazione di Oracle Data Guard come utente oracle.

    Per istruzioni dettagliate, vedere Connessione a una virtual machine con SSH.

  2. Avvia il ripristino del database primario non riuscito.
    $ dbaascli dataguard reinstate --dbname <db-name>

    In un'impostazione di più standby (gruppo Data Guard), si consiglia di specificare l'argomento --primaryDBUniqueName.

    dbaascli dataguard reinstate --dbname <db-name> --primaryDBUniqueName <primary-DB-unique-name>
  3. Disconnessione dalla virtual machine.
    $ exit

switchover dataguard dbaascli

Per eseguire uno switchover al database in standby, utilizzare il comando dataguard switchover.

Eseguire il comando come utente oracle.

Sintassi

dbaascli dataguard switchover --dbname <value> [--targetStandbyDBUniqueName <value>] [--executePrereqs] [--enableDGDebug] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Dove:
  • --dbname specifica il nome di Oracle Database.
  • --targetStandbyDBUniqueName specifica il nome univoco dell'istanza di database in standby per modificare il ruolo da standby a database primario.
  • --executePrereqs esegue i controlli dei prerequisiti e restituisce i risultati.
  • --enableDGDebug abilita i trace durante l'esecuzione dell'operazione.
  • --waitForCompletion specifica se attendere il completamento dell'operazione. Impostare su false per eseguire l'operazione in background. Valori validi: true|false.
  • --resume riprende l'operazione precedente.
  • --sessionID riprende una sessione specifica in base al relativo ID.
Esecuzione di un'operazione di switchover mediante la utility dbaascli

Per eseguire uno switchover al database in standby, utilizzare il comando dataguard switchover.

  1. Connettersi alla virtual machine nella configurazione di Oracle Data Guard che ospiterà il nuovo database primario come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una virtual machine con SSH.

  2. Avviare una shell del comando dell'utente root e passare all'utente oracle.
    $ sudo -s
    # su - oracle
    $
  3. Avviare lo switchover al database di standby.
    $ dbaascli dataguard switchover --dbname <db-name>

    In un'impostazione di più standby (gruppo Data Guard), si consiglia di specificare l'argomento --targetStandbyDBUniqueName.

    dbaascli dataguard switchover --dbname <db-name> --targetStandbyDBUniqueName <target-standby-DB-unique-name>
  4. Torna a essere utente root.
    $ exit
    #
  5. Uscire dalla shell dei comandi utente root e disconnettersi dalla virtual machine.
    # exit
    $ exit

Data Guard dbaascli prepareForStandby

Per creare un database in standby Oracle, utilizzare il comando dbaascli dataguard prepareForStandby come primo passo.

Eseguire questo comando come utente root nel database primario. Alla fine dell'esecuzione del comando, viene creato un file BLOB di standby. È necessario copiare questo file nel sistema di database in standby per procedere con il passo configureStandby.

Nota

Per le configurazioni di Disaster Recovery (DR) su Exadata Cloud@Customer (ExaDB-C@C), è necessario utilizzare la console di Oracle Cloud Infrastructure (OCI) o l'SDK OCI per impostare Data Guard. La utility dbaascli non è supportata per questo caso d'uso e non deve essere utilizzata.

Sintassi

dbaascli dataguard prepareForStandby --dbname <value> --standbyDBUniqueName <value>  --standbyDBDomain | --noDBDomain  --standbyScanIPAddresses <Standby SCAN IP Addresses> [ --standbyScanPort ] [ --standbyServiceName ] [  -- primaryScanIPAddresses ] [ --primaryScanPort ] [--executePrereqs] [--resume [--sessionID <value>]] [--revert [--sessionID <value>]] [--waitForCompletion] [--skipDRConfiguration]
Dove:
  • --dbname specifica il nome di Oracle Database.
  • --standbyDBUniqueName specifica il nome univoco della base dati di standby per il quale verrà configurato la base dati primaria.
  • --standbyDBDomain specifica il dominio di database in standby per il quale verrà configurato un database primario.
  • --noDBDomain specifica di non utilizzare il nome del dominio del database per un database di standby.
  • --standbyScanIPAddresses specifica una lista separata da virgole di indirizzi IP corrispondenti al listener SCAN del database in standby o il nome SCAN del database in standby.
  • --standbyScanPort specifica il numero di porta SCAN corrispondente del database in standby.
  • --standbyServiceName specifica il nome del servizio del database in standby per il quale verrà configurato un database primario.
  • --primaryScanIPAddresses specifica una lista separata da virgole di indirizzi IP corrispondenti al listener SCAN di database primario o il nome SCAN del database primario.
  • --primaryScanPort specifica il numero di porta SCAN corrispondente del database primario.
  • --executePrereqs esegue i controlli dei prerequisiti e restituisce i risultati.
  • --resume riprende l'operazione precedente.
  • --sessionID riprende una sessione specifica in base al relativo ID.
  • --revert esegue il rollback dell'operazione precedente.
  • --waitForCompletion specifica se attendere il completamento dell'operazione. Impostare su false per eseguire l'operazione in background. Valori validi: true|false.
  • --skipDRConfiguration specifica se saltare la configurazione DR (Disaster Recovery) nell'ambito dell'impostazione del database di standby. Valori validi: true (saltare la configurazione DR) o false (configurare DR).
Esecuzione dell'operazione PrepareForStandby mediante la utility dbaascli

Per preparare il database primario per la creazione di un nuovo database di standby, utilizzare il comando dbaascli dataguard prepareForStandby.

  1. Connettersi alla Virtual Machine in cui si desidera ospitare il database primario come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una virtual machine con SSH.

  2. Avviare una shell del comando dell'utente root.
    $ sudo -s
  3. Eseguire il comando prepareForStandby. Quando richiesto, immettere la password SYS.
    dbaascli dataguard prepareForStandby --dbName <db name> --standbyDBUniqueName <standby db unique name> --standbyDBDomain <standby db domain> --standbyScanIPAddresses  <comma-delimieted list of standby SCAN IP addresses> --primaryScanIPAddresses <comma-delimited list of primary SCAN IP addresses> --standbyScanPort <standby SCAN listener port>

    Al termine, il comando visualizza la posizione in cui viene creato il file BLOB di standby.

  4. Uscire dalla shell dei comandi utente root e disconnettersi dalla virtual machine.
    #  exit

Data Guard dbaascli configureStandby

Per creare un nuovo database in standby, utilizzare il comando dbaascli dataguard configureStandby come secondo passo dopo il passo prepareForStandby.

Eseguire questa operazione come utente root nel cluster in standby.

Sintassi

dbaascli dataguard configureStandby --dbname <value>  --oracleHome <value> | --oracleHomeName <value> --standbyDBUniqueName <value> [--standbyDBDomain <value>] | [--noDBDomain] --primaryScanIPAddresses <value> --primaryScanPort <value> --primaryServiceName <value> --protectionMode <value> --transportType <value> --activeDG <value> [--standbyBlobFromPrimary <value>] | [--standbyDBInfoJsonLocation <value>] [--standbyScanIPAddresses <value>] [--standbyScanPort <value>] [--standbySID <value>] [--nodeList <value>] [--skipAWRConfiguration] [--primaryDBOCID <value>] [--sgaSizeInMB <value>] [--pgaSizeInMB <value>] [--datafileDestination <value>] [--fraDestination <value>] [--redoLogDestination <value>] [--fraSizeInMB <value>] [--tdeKeyStoreType <value> [--tdeKeyOCID <value>]] [--tdeKeyOCID <value>] [--executePrereqs]  [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]] --waitForCompletion <value>] [--enableFIPS <value>] [--skipDRConfiguration] [--okvServer <value> --okvAdminUserName <value> [--okvServerRestPort <value>]] [--okvWalletName <value>]
Dove:
  • --dbname specifica il nome di Oracle Database.
  • --oracleHome specifica il percorso della Oracle home.
  • --oracleHomeName specifica il nome della Oracle home.
  • --standbyDBUniqueName specifica il nome univoco del database per il database di standby.
  • --standbyDBDomain specifica il dominio di database in standby per il quale verrà configurato un database primario.
  • --noDBDomain specifica di non utilizzare il nome del dominio del database per un database di standby.
  • --primaryScanIPAddresses specifica una lista separata da virgole di indirizzi IP corrispondenti al listener SCAN di database primario o il nome SCAN del database primario.
  • --primaryScanPort specifica il numero di porta SCAN corrispondente del servizio del database primario.
  • --primaryServiceName specifica il nome del servizio del database primario per il quale verrà configurato i database in standby.
  • --protectionMode specifica la modalità di protezione Data Guard da impostare durante la configurazione del database di standby. Valori validi: MAX_PERFORMANCE|MAX_AVAILABILITY.
  • --transportType specifica il tipo di trasporto Data Guard da impostare durante la configurazione del database in standby. Valori validi: ASYNC|SYNC.
  • --activeDG specifica se la configurazione Data Guard sarà attiva o meno. Valori validi: true|false.
  • --standbyBlobFromPrimary specifica la posizione del file BLOB di standby preparato dal database primario. Questa operazione è obbligatoria solo per le operazioni in standby.
  • --standbyDBInfoJsonLocation specifica la posizione del file di informazioni generato dal database primario per l'esportazione di metadati aggiuntivi. Questa opzione è obbligatoria solo per le operazioni in standby.
  • --standbyScanIPAddresses specifica una lista separata da virgole di indirizzi IP corrispondenti al listener SCAN del database in standby o il nome SCAN del database in standby.
  • --standbyScanPort specifica il numero di porta SCAN corrispondente del database in standby.
  • --standbySID specifica il SID di database in standby per le configurazioni in standby.
  • --nodeList specifica una lista di nodi in cui è prevista l'esecuzione del database di standby, inclusi i nodi già in esecuzione o configurati.
  • --skipAWRConfiguration specifica se saltare la configurazione di Oracle AWR nell'ambito dell'impostazione del database di standby. Valori validi: true (salta configurazione AWR) o false (configura AWR).
  • --primaryDBOCID specifica il valore OCID risorsa corrispondente al database primario.
  • --sgaSizeInMB specifica il valore sga_target in MB.
  • --pgaSizeInMB specifica il valore pga_aggregate_target in MB.
  • --datafileDestination specifica la posizione di memorizzazione da utilizzare per i file di dati del database.
  • --fraDestination specifica la posizione di memorizzazione da utilizzare per l'area di recupero rapido del database.
  • --redoLogDestination specifica la posizione di memorizzazione da utilizzare per i redo log file.
  • --fraSizeInMB specifica il valore della dimensione dell'area di recupero rapido in MB.
  • --tdeKeyStoreType specifica il tipo di keystore TDE. Valori validi: FILE|KMS|AZURE|GOOGLE|AWS|OKV
  • --tdeKeyOCID specifica l'OCID della chiave KMS/AZURE/GOOGLE/AWS da utilizzare per TDE. Questa opzione è applicabile solo se per il tipo di keystore TDE è selezionata l'opzione KMS/AZURE/GOOGLE/AWS.
  • --executePrereqs esegue i controlli dei prerequisiti e restituisce i risultati.
  • --resume riprende l'operazione precedente.
  • --sessionID riprende una sessione specifica in base al relativo ID.
  • --revert esegue il rollback dell'operazione precedente.
  • --waitForCompletion specifica se attendere il completamento dell'operazione. Impostare su false per eseguire l'operazione in background. Valori validi: true|false.
  • --enableFIPS specifica se abilitare FIPS. Impostare su false per disabilitarlo. Valori validi: true|false.
  • --skipDRConfiguration specifica se saltare la configurazione DR (Disaster Recovery) nell'ambito dell'impostazione del database di standby. Valori validi: true (saltare la configurazione DR) o false (configurare DR).
  • --okvServer specifica il server Oracle Key Vault. Lista delimitata da virgole di più indirizzi IP.
  • --okvAdminUserName specifica il nome utente dell'amministratore di Oracle Key Vault.
  • --okvServerRestPort specifica il numero di porta REST per Oracle Key Vault.
  • --okvWalletName specifica il nome di wallet di Oracle Key Vault.
Esecuzione dell'operazione configureStandby mediante la utility dbaascli

Per creare un database in standby, utilizzare il comando dbaascli dataguard configureStandby.

  1. Connettersi alla virtual machine in cui si desidera ospitare il database in standby come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una virtual machine con SSH.

  2. Avviare una shell del comando dell'utente root.
    $ sudo -s
  3. Eseguire il comando configureStandby.
    dbaascli dataguard configureStandby --standbySID <standby SID> --activeDG <true|false> --dbName <db name> --standbyDBUniqueName <standby db unique name> --standbyScanName <comma-delimited list of standby SCAN IP addresses> --protectionMode <MAX_PERFORMANCE|MAX_AVAILABILITY> --standbyScanPort <standby SCAN port> --oracleHome <oracle home path> --standbyDBDomain <standby db domain name>. --primaryServiceName <primary db service name> --transportType <ASYNC|SYNC> --primaryScanPort <primary db SCAN port> --primaryScanIPAddresses <comma-delimited list primary db SCAN IP addresses> --standbyBlobFromPrimary <standby BLOB from primary>
  4. Quando richiesto, immettere le password SYS, TDE e AWR del database primario.

    Una volta completato correttamente il comando, il database di standby viene avviato e diventa operativo.

Data Guard dbaascli registerStandby

Per registrare un database di standby appena creato con tutti i database di standby esistenti e nel database primario, utilizzare il comando dbaascli dataguard registerStandby come terzo passo dopo il passo configureStandby.

Eseguire questo comando come utente root nel cluster primario. Inoltre, in un'impostazione in standby multiplo, eseguire il comando su tutti i cluster in standby ad eccezione del cluster di database in standby appena creato.

Sintassi

dbaascli dataguard registerStandby --dbname <value> --standbyDBUniqueName <value>  --standbyDBDomain <value> | --noDBDomain --standbyScanIPAddresses <value> [--standbyScanPort <value>] [--standbyServiceName <value>] [--executePrereqs] [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]] [--waitForCompletion <value>]
Dove:
  • --dbname specifica il nome di Oracle Database.
  • --standbyDBUniqueName specifica il nome univoco del database di standby da registrare con la configurazione del Broker Oracle Data Guard.
  • --standbyDBDomain specifica il dominio di database in standby per il quale verrà configurato un database primario.
  • --noDBDomain specifica di non utilizzare il nome del dominio del database per un database di standby.
  • --standbyScanIPAddresses specifica una lista separata da virgole di indirizzi IP corrispondenti al listener SCAN del database in standby o il nome SCAN del database in standby.
  • --standbyScanPort specifica il numero di porta SCAN corrispondente del database in standby.
  • --standbyServiceName specifica il nome del servizio del database in standby per il quale verrà configurato un database primario.
  • --executePrereqs esegue i controlli dei prerequisiti e restituisce i risultati.
  • --resume riprende l'operazione precedente.
  • --sessionID riprende una sessione specifica in base al relativo ID.
  • --revert esegue il rollback dell'operazione precedente.
  • --waitForCompletion specifica se attendere il completamento dell'operazione. Impostare su false per eseguire l'operazione in background. Valori validi: true|false.
Esecuzione dell'operazione registerStandby mediante la utility dbaascli

Per registrare il database di standby specificato con la configurazione di Oracle Data Guard Broker, utilizzare il comando dbaascli dataguard registerStandby.

Per i singoli casi d'uso in standby, il comando registerStandby deve essere eseguito solo sul cluster primario, in quanto esiste un'associazione uno a uno tra il primario e lo standby.

Tuttavia, nelle configurazioni con più database in standby, è necessario eseguire il comando registerStandby sia sul cluster primario che su tutti i cluster in standby esistenti, escludendo il nuovo database in standby aggiunto.

Si consideri ad esempio un'impostazione con due database in standby: stdby1 e stdby2, dove stdby2 è il nuovo database in standby da registrare. In questo caso, eseguire il comando registerStandby sul cluster primario e su stdby1, ma non su stdby2.

In sintesi, quando si aggiunge un nuovo database di standby a una configurazione Oracle Data Guard esistente, eseguire il comando registerStandby sul database primario e su tutti gli altri cluster di standby registrati in precedenza, ad eccezione del nuovo standby aggiunto.

  1. Connettersi al cluster primario della configurazione Data Guard come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una virtual machine con SSH.

  2. Avviare una shell del comando dell'utente root.
    $ sudo -s
  3. Eseguire il comando registerStandby.
    dbaascli dataguard registerStandby --dbname <db-name> --standbyDBUniqueName <standby-DB-unique-name> --standbyDBDomain <standby-DB-domain>

    Al completamento del comando, il database di standby specificato verrà registrato con la configurazione di Oracle Data Guard Broker.

  4. Ripetere i passi da 1 a 3, come eseguito sul cluster primario, su tutti i cluster di standby esistenti nella configurazione di Oracle Data Guard Broker, ad eccezione di quello registrato.

Data Guard dbaascli deregisterStandby

Durante l'eliminazione in standby, eseguire il comando dbaascli dataguard deregisterStandby prima di eliminare il database nel cluster in standby per annullare la registrazione del database in standby dalla configurazione di Oracle Data Guard Broker.

Eseguire questo comando come utente root nel cluster primario. Tuttavia, nel contesto di più database in standby, questo comando deve essere eseguito su tutti i cluster in standby ad eccezione dello standby di destinazione.

Sintassi

dbaascli dataguard deregisterStandby --dbname <value> --standbyDBUniqueName <value> [--executePrereqs] [--resume [--sessionID <value>]] [--waitForCompletion <value>]
Dove:
  • --dbname specifica il nome di Oracle Database.
  • --standbyDBUniqueName specifica il nome univoco del database di standby di cui annullare la registrazione dalla configurazione di Oracle Data Guard Broker.
  • --executePrereqs esegue i controlli dei prerequisiti e restituisce i risultati.
  • --resume riprende l'operazione precedente.
  • --sessionID riprende una sessione specifica in base al relativo ID.
  • --waitForCompletion specifica se attendere il completamento dell'operazione. Impostare su false per eseguire l'operazione in background. Valori validi: true|false.
Esecuzione dell'operazione deregisterStandby mediante la utility dbaascli

Durante l'eliminazione in standby, eseguire il comando dbaascli dataguard deregisterStandby prima di eliminare il database nel cluster in standby per annullare la registrazione del database in standby dalla configurazione di Oracle Data Guard Broker.

Per i singoli casi d'uso in standby, il comando deregisterStandby deve essere eseguito solo sul cluster primario, in quanto esiste un'associazione uno a uno tra il primario e lo standby.

Tuttavia, nelle configurazioni con più database in standby, è necessario eseguire il comando deregisterStandby sia sul cluster primario che su tutti i cluster in standby esistenti, escludendo il database in standby che viene attualmente annullato.

Ad esempio, prendere in considerazione un'impostazione con due database in standby: stdby1 e stdby2, dove la registrazione di stdby2 deve essere annullata. In questo caso, eseguire il comando deregisterStandby sul cluster primario e su stdby1, ma non su stdby2.

In sintesi, durante l'eliminazione di un database in standby da una configurazione Oracle Data Guard esistente, eseguire il comando deregisterStandby sul cluster primario e su tutti gli altri cluster in standby esistenti prima dell'operazione di eliminazione del database sul cluster in standby desiderato.

  1. Connettersi al cluster primario della configurazione Oracle Data Guard come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una virtual machine con SSH.

  2. Avviare una shell del comando dell'utente root.
    $ sudo -s
  3. Eseguire il comando deregisterStandby.
    dbaascli dataguard deregisterStandby --dbname <db-name> --standbyDBUniqueName <standby-DB-unique-name>

    Una volta completato correttamente il comando, il database di standby specificato verrà annullato dalla registrazione (rimossa) della configurazione di Oracle Data Guard Broker.

  4. Ripetere i passi da 1 a 3, eseguiti sul cluster primario, su tutti i cluster di standby esistenti nella configurazione di Oracle Data Guard Broker, ad eccezione di quello di cui viene annullata la registrazione.

Data Guard dbaascli configureAWR

Per abilitare o disabilitare la configurazione AWR (Automatic Workload Repository) nel database di standby Active Data Guard, utilizzare il comando dbaascli dataguard configureAWR.

Eseguire questo comando come utente root nel cluster di standby Active Data Guard in cui si desidera abilitare o disabilitare la configurazione AWR. Utilizzare questo comando se AWR non è stato configurato durante il processo di aggiunta in standby.

Sintassi

dbaascli dataguard configureAWR --dbname <value> { --action <value> | --enable | --disable } [--executePrereqs] [--resume [--sessionID <value>]]
Dove:
  • --dbname specifica il nome di Oracle Database.
  • --action specifica se abilitare o disabilitare AWR. Utilizzare --action enable per abilitare AWR e --action disable per disabilitarlo.

    L'argomento --action viene mantenuto per la compatibilità con le versioni precedenti. Tuttavia, si consiglia di utilizzare --enable o --disable, poiché forniscono le stesse funzionalità ma sono più esplicite

  • --executePrereqs esegue i controlli dei prerequisiti e restituisce i risultati.
  • --resume riprende l'operazione precedente.
  • --sessionID riprende una sessione specifica in base al relativo ID.
Esecuzione dell'operazione configureAWR mediante la utility dbaascli

Per configurare AWR in un database di standby ADG, utilizzare il comando dbaascli dataguard configureAWR.

  1. Connettersi alla virtual machine in cui è ospitato il database di standby ADG come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una virtual machine con SSH.

  2. Avviare una shell del comando dell'utente root.
    $ sudo -s
  3. Eseguire il comando configureAWR.

    Per abilitare AWR, eseguire:

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

    Per disabilitare AWR, eseguire le operazioni riportate di seguito.

    $ dbaascli dataguard configureAWR --dbname <db-name> --disable
  4. Quando richiesto, immettere le password SYS e AWR.

    Al completamento del comando, il database di standby ADG sarebbe stato configurato con AWR

Data Guard dbaascli updateConfiguration

Per aggiornare la modalità di trasporto o la modalità di protezione o entrambi i parametri di un ambiente Data Guard, utilizzare il comando dbaascli dataguard updateConfiguration.

Eseguire il comando come utente root.

Quando il comando Aggiorna modalità di trasporto viene eseguito sul database primario, viene aggiornata solo la modalità di trasporto del database primario. Per aggiornare la modalità di trasporto di un database in standby, il comando deve essere eseguito separatamente in tale standby.

Al contrario, quando il comando della modalità di protezione dell'aggiornamento viene eseguito sul database primario, la modalità di protezione viene aggiornata sia per il database primario che per quello in standby. La modalità di protezione può anche essere aggiornata dal lato standby, nel qual caso vengono aggiornati sia i database primari che quelli in standby.

Quando si aggiorna la modalità di trasporto o protezione dal database primario, il sistema controlla le modalità correnti nei database primario e in standby e procede con l'aggiornamento solo se vengono soddisfatte tutte le condizioni richieste.

Sintassi

dbaascli dataguard updateConfiguration --dbname <value> [--protectionMode <value>] [--transportType <value>] [--standbyDGType <value>] [--executePrereqs] [--resume [--sessionID <value>]] [--waitForCompletion <value>]
Dove:
  • --dbname specifica il nome di Oracle Database.
  • --protectionMode specifica la modalità di protezione Data Guard da impostare durante la configurazione del database di standby. Valori validi: MAX_PERFORMANCE|MAX_AVAILABILITY.
  • --transportType specifica il tipo di trasporto Data Guard da impostare durante la configurazione del database in standby. Valori validi: ASYNC|SYNC.
  • --standbyDGType specifica il tipo Data Guard del database di standby da impostare. Valori validi: ADG|DG.
  • --executePrereqs esegue i controlli dei prerequisiti e restituisce i risultati.
  • --resume riprende l'operazione precedente.
  • --sessionID riprende una sessione specifica in base al relativo ID.
  • --waitForCompletion specifica se attendere il completamento dell'operazione. Impostare su false per eseguire l'operazione in background. Valori validi: true|false.
Esecuzione dell'operazione updateConfiguration mediante la utility dbaascli

Per aggiornare la modalità di trasporto e la modalità di protezione o entrambi i parametri, utilizzare il comando dbaascli dataguard updateConfiguration.

  1. Connettersi alla virtual machine in cui è ospitato il database di standby ADG come utente opc.

    Per istruzioni dettagliate, vedere Connessione a una virtual machine con SSH.

  2. Avviare una shell del comando dell'utente root.
    $ sudo -s
  3. Eseguire il comando updateConfiguration.
    $ dbaascli dataguard updateConfiguration --dbname <db-name> --protectionMode MAX_PERFORMANCE|MAX_AVAILABILITY --transportType ASYNC|SYNC --standbyDGType ADG|DG.

    Al completamento del comando, Data Guard specificato verrà configurato con la modalità di trasporto o la modalità di protezione specificata.

dbaascli dbhome create

Per creare una home Oracle Database della versione desiderata, utilizzare il comando dbaascli dbhome create.

Requisito

Eseguire il comando come utente root.

Sintassi

dbaascli dbhome create --version <value>
[--oracleHome <value>]
[--oracleHomeName <value>]
[--enableUnifiedAuditing <value>] 
[--imageTag <value>]
[--ImageLocation <value>
Dove:
  • --version specifica la versione della Oracle home specificata come cinque segmenti numerici separati da punti, ad esempio 19.12.0.0.0.0.
  • --oracleHome specifica la posizione della Oracle home
  • --oracleHomeName specifica il nome della Oracle home definita dall'utente. Se non viene specificato, verrà utilizzato il nome predefinito
  • --enableUnifiedAuditing specifica true o false per abilitare o disabilitare l'opzione di collegamento dell'audit unificato nella Oracle home
  • --imageTag specifica la tag immagine della Oracle home
  • --imageLocation: il percorso dell'immagine da utilizzare.
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valore valido: true o false.

Esempio 6-24 dbaascli dbhome create

dbaascli dbhome create --version 19.11.0.0.0

In alternativa, dbaascli dbhome create --version 19.8.0.0.0.0 --imageTag 19.8.0.0.0 per i casi in cui i tag immagine sono diversi dalla versione.

dbaascli dbHome elimina

Per eliminare una determinata home di Oracle Database, utilizzare il comando dbaascli dbHome delete.

Requisito

Eseguire il comando come utente root.

Sintassi

dbaascli dbHome delete 
{ --oracleHome <value> 
| --oracleHomeName <value> } [--resume [--sessionID <value>]] 
Dove:
  • --oracleHome specifica la posizione della Oracle home
  • --oracleHomeName specifica il nome della Oracle home.
  • --resume riprende l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico

dbaascli dbhome getDatabases

Per visualizzare le informazioni su tutti i database Oracle in esecuzione da una determinata Oracle home del database, utilizzare il comando dbaascli dbHome getDatabases. Specificare la posizione della Oracle home o il nome della Oracle home.

Eseguire il comando come utente root.

Sintassi

dbaascli dbHome getDatabases
{ --oracleHomeName value | --oracleHome value }
Dove:
  • --oracleHomeName specifica il nome della Oracle home definita dall'utente
  • --oracleHome specifica la posizione (percorso) della Oracle home

Esempio 6-25 dbaascli dbHome getDatabases --oracleHome

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

dbaascli dbHome getDetails

Per visualizzare informazioni su una Oracle home specifica, utilizzare il comando dbaascli dbHome getDetails. Specificare la posizione della Oracle home o il nome della Oracle home.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli dbHome getDetails
{ --oracleHomeName value | --oracleHome value }
Dove:
  • --oracleHomeName specifica il nome della Oracle home definita dall'utente
  • --oracleHome specifica la posizione della Oracle home

Esempio 6-26 dbaascli dbHome getDetails - utilizzo della posizione della Oracle home

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

Esempio 6-27 dbaascli dbHome getDetails - utilizzo del nome della Oracle home

dbaascli dbHome getDetails --oracleHomeName home_db19c

patch dbHome dbaascli

Per applicare le patch alla Oracle home da un livello di patch a un altro, utilizzare il comando dbaascli dbHome patch.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli dbHome patch

{
    --oracleHome <value>
    | --oracleHomeName <value>
 }
        [--imageFilePath <value>] [--executePrereqs] [--nodes <value>]
        {
            [--resume [--sessionID <value>]]
            | [--rollback [--sessionID <value>]]
        }
[--skipDatapatch] 
[--skipClosedPDBs] 
[--skipPDBs <value>] 
[--continueWithDbDowntime] 
[--skipUnreachableNodes] 
[--drainTimeoutInSeconds <value>] 
[--waitForCompletion <value>]
Dove:
  • --oracleHome specifica il percorso della Oracle home
  • --oracleHomeName specifica il nome della Oracle home.
  • --targetVersion specifica la versione di destinazione della Oracle home, costituita da cinque segmenti numerici separati da punti, ad esempio 19.12.0.0.0.0.
  • --resume riprende l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --continueWithDbDowntime continua l'applicazione delle patch con i tempi di inattività del database. Questa opzione può essere utilizzata in ambienti in cui è attiva una sola istanza attiva e l'operazione di applicazione delle patch può essere continuata anche con un tempo di inattività.
  • --skipUnreachableNodes salta l'operazione sui nodi irraggiungibili
  • --nodes specifica una lista di nodi delimitata da virgole se l'applicazione delle patch deve essere eseguita su un subset di nodi
  • --executePrereqs esegue i prerequisiti
  • --skipDatapatch salta l'esecuzione di datapatch sui database
  • --imageFilePath specifica il percorso assoluto del file immagine da utilizzare
  • --skipPDBs salta l'esecuzione della patch dati in una lista delimitata da virgole specificata di PDB. Ad esempio: cdb1:pdb1,cdb2:pdb2 e così via
  • --skipClosedPdbs salta l'esecuzione di datapatch nei PDB chiusi
  • --rollback esegue il rollback della Oracle home a cui sono state applicate le patch.
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valori validi: true|false
  • --drainTimeoutInSeconds specifica il tempo (in secondi) per il completamento dell'estrazione della risorsa durante l'arresto del database
  • --skipUnreachableNodes salta l'operazione sui nodi irraggiungibili

Esempio di patch dbhome dbaascli 6-28

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

rimozione dbimage dbaascli

Il comando dbimage purge rimuove l'immagine software specificata dall'ambiente dell'infrastruttura Exadata Cloud.

Connettersi al nodo di calcolo come utente opc ed eseguire questo comando come utente root.

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

Nel comando precedente:

  • software_version: specifica la versione del software Oracle Database. Ad esempio, 11204, 12102, 12201, 18000, 19000.

  • software_bp: identifica la release della patch bundle. Ad esempio, APR2018, JAN2019, OCT2019 e così via.

  • --cdb: facoltativamente specifica se rimuovere l'immagine software che supporta l'architettura multi-tenant Oracle. L'impostazione predefinita è yes. Se si specifica --cdb no, l'immagine software che contiene i file binari per supportare i database non di tipo container (non CDB) viene rimossa.

Se il comando rimuove un'immagine software attualmente non disponibile nella libreria di immagini software e pertanto non può essere scaricata di nuovo, il comando viene sospeso e viene richiesto di confermare.

Non è possibile rimuovere l'immagine software predefinita corrente per nessuna versione del software. Per evitare questa limitazione, è necessario impostare un'altra immagine software come predefinita corrente.

dbaascli diag colli

Per raccogliere i dati diagnostici, utilizzare il comando dbaascli diag collect.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli diag collect [--components <value>] [--startTime <value>] [--endTime <value>] [--nodes <value>] [--dbNames <value>]
        {
            [--objectStoreBucketUri <value>]
            | [--destLocation <value>]
        }
        [--waitForCompletion <value>]
Dove:
  • --components specifica una lista di componenti per la raccolta dei log.

    Valori validi:

    • db
    • gi
    • os
    • dbaastools
    • all
  • --startTime specifica l'ora di inizio per la raccolta dei log. Formato data e ora valido: YYYY-MM-DDTHH24:MM:SS
  • --endTime specifica l'ora di fine per la raccolta dei log. Formato data e ora valido: YYYY-MM-DDTHH24:MM:SS
  • --nodes specifica una lista delimitata da virgole di nodi per la raccolta dei log.
  • --dbNames specifica il nome del database per il quale raccogliere i log. È possibile specificare un solo nome di database.
  • --objectStoreBucketURI specifica un URL di richiesta (PAR) preautenticata del servizio di storage degli oggetti utilizzato per caricare i log raccolti. I log vengono raccolti dalla VM guest. Per ulteriori informazioni, vedere Utilizzo di richieste pre-autenticazione.
  • --destLocation specifica la posizione nella VM guest per la raccolta dei log. Impostazione predefinita: /var/opt/oracle/dbaas_acfs
  • --waitForCompletion Valori: true|false. Valore predefinito true. Specificare false da eseguire in background.

diag dbaascli healthCheck

Per eseguire i controlli dello stato diagnostico, utilizzare il comando dbaascli diag healthCheck.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli diag healthCheck
[--destLocation]
[--nodes]
[--objectStoreBucketURI]
Dove:
  • --destLocation specifica la posizione nella VM guest per la raccolta dei log. Impostazione predefinita: /var/opt/oracle/dbaas_acfs
  • --nodes specifica una lista delimitata da virgole di nodi per la raccolta dei log.
  • --objectStoreBucketURI specifica un URL di richiesta (PAR) preautenticata del servizio di storage degli oggetti utilizzato per caricare i log raccolti. I log vengono raccolti dalla VM guest. Per ulteriori informazioni, vedere Utilizzo di richieste pre-autenticazione.

dbaascli gridHome crea

Per configurare la home di Grid Infrastructure, utilizzare il comando dbaascli gridHome create.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli gridHome create --version value [--resume [--sessionID value]] [--waitForCompletion value]
Dove:
  • --version specifica la versione della home Grid
  • --resume riprende l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valori validi: true|false

griglia dbaascli configureTCPS

Per configurare TCPS per il cluster esistente, utilizzare il comando dbaascli grid configureTCPS.

Requisito

Eseguire il comando come utente root.

Sintassi

Nota

Per impostazione predefinita, TCPS è abilitato per i database sui sistemi Oracle Exadata Database Service on Dedicated Infrastructure.
Nota

TCPS non è abilitato per i database nei sistemi Exadata Database Service on Cloud@Customer. Per abilitare TCPS per un determinato database, aggiornare il file sqlnet.ora specifico del database con WALLET_LOCATION = (SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=/var/opt/oracle/dbaas_acfs/grid/tcps_wallets))) su tutti i nodi del database, quindi riavviare il database. In questo modo verrà abilitato l'uso TCPS per il database. Tuttavia, l'abilitazione di TCPS comporterà il mancato completamento della connessione ZDLRA. Nei sistemi Exadata Database Service on Cloud@Customer, è possibile abilitare la configurazione ZDLRA o TCPS. L'abilitazione simultanea di ZDLRA e TCPS non funzionerà.
dbaascli grid configureTCPS
[--pkcs12WalletPath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Dove:
  • --pkcs12WalletPath specifica il percorso del certificato, che si trova nel formato del wallet pkcs12
  • Lista concatenata di certificati --caCertChain, contenente le CA intermedie e i certificati CA root
  • --precheckOnly specifica yes per eseguire solo i controlli preliminari per questa operazione. Valori validi: yes o no.
  • --serverCert specifica il percorso del certificato PEM da utilizzare o ruotare per la configurazione TCPS.
  • --privateKey specifica il percorso del file della chiave privata del certificato.
  • Tipo --certType del certificato da aggiungere al wallet di Grid Infrastructure. I valori accettati sono: SELF_SIGNED_CERT, CA_SIGNED_CERT o PKCS12_CERT. Impostazione predefinita: SELF_SIGNED_CERT
  • --privateKeyPasswordProtected specifica se la chiave privata è o meno protetta con una password. Valore valido: true o false. Valore predefinito: true.

Esempio 6-29 griglia dbaascli configureTCPS

Per configurare Grid utilizzando un certificato con firma automatica, effettuare le operazioni riportate di seguito.
dbaascli grid configureTCPS
Per configurare Grid utilizzando un certificato firmato da CA:
dbaascli grid configureTCPS --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --private_key_password_protected false

patch griglia dbaascli

Per applicare le patch a Oracle Grid Infrastructure alla versione secondaria specificata, utilizzare il comando dbaascli grid patch.

Prerequisiti

Eseguire il comando come utente root.

Sintassi

dbaascli grid patch
 {
            --targetVersion <value>
            | --targetHome <value>
        }
        [--executePrereqs] [--nodeList <value>] [--continueWithDbDowntime] [--drainTimeoutInSeconds <value>] [--containerURL <value>] [--imageFile <value>] [--patchInParallel]
        {
            [--resume [--sessionID <value>]]
            | [--rollback [--sessionID <value>]]
        }
        [--waitForCompletion <value>]

Dove:

  • --targetVersion specifica la versione di destinazione della Oracle home, costituita da cinque segmenti numerici separati da punti (ad esempio 19.12.0.0.0).
  • --targetHome specifica il percorso completamente qualificato della home di Grid Infrastructure di destinazione per l'applicazione delle patch non in loco
  • --containerURL specifica un URL personalizzato per il recupero dell'immagine di Grid Infrastructure
  • opzione --executePrereqs per eseguire i prerequisiti
  • --nodeList specifica una lista di nodi delimitata da virgole se l'applicazione delle patch deve essere eseguita su un subset di nodi
  • --patchInParallel specifica di eseguire l'applicazione delle patch ai nodi remoti in parallelo
  • --rollback specifica di eseguire il rollback della Oracle home a cui sono state applicate le patch
  • --resume riprende l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --continueWithDbDowntime continua l'applicazione delle patch con i tempi di inattività del database. Questa opzione può essere utilizzata in ambienti in cui è attiva solo 1 istanza attiva e l'operazione di applicazione delle patch può essere continuata anche con un tempo di inattività.
  • --drainTimeoutInSeconds specifica il tempo (in secondi) per il completamento dell'estrazione della risorsa durante l'arresto del database
  • --createImage crea un'immagine da una copia della home Grid attiva, aggiornata alla versione di destinazione specificata
    • --createImageDir specifica il percorso completamente qualificato della directory in cui deve essere creata l'immagine
  • --imageFile specifica il percorso completamente qualificato dell'immagine da utilizzare
  • --patchInParallel esegue l'applicazione delle patch dei nodi remoti in parallelo
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valori validi: true|false

Esempio di patch griglia dbaascli 6-30

dbaascli grid patch --targetVersion 19.12.0.0.0

griglia dbaascli removeTCPSCert

Per rimuovere i certificati TCPS esistenti dal wallet di Grid Infrastructure, utilizzare il comando dbaascli grid removeTCPSCert.

Requisito

Eseguire il comando come utente root.

Sintassi

dbaascli grid removeTCPSCert --subject <value>
 {
   --userCert | --trustedCert | --requestedCert
 }
 [--serialNumber <value>] [--executePrereqs] [--resume [--sessionID <value>]] [--bounceListeners]
Dove:
  • --subject specifica l'oggetto del certificato.
  • Flag --userCert per indicare il certificato utente
  • Flag --trustedCert per indicare il certificato protetto
  • Flag --requestedCert per indicare il certificato richiesto
  • --serialNumber specifica il numero di serie del certificato
  • --executePrereqs esegue i controlli dei prerequisiti e segnala i risultati
  • --resume riprende l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • Flag --bounceListeners per riavviare il listener Grid Infrastructure e il listener SCAN

griglia dbaascli rotateTCPSCert

Per ruotare i certificati TCPS, utilizzare il comando rotateTCPSCert della griglia dbaascli.

Requisito

Eseguire il comando come utente root.

Sintassi

dbaascli grid rotateTCPSCert
[--pkcs12WalletPath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Dove:
  • --pkcs12WalletPath specifica il percorso del certificato, che si trova nel formato del wallet pkcs12
  • Lista concatenata di certificati --caCertChain, contenente le CA intermedie e i certificati CA root
  • --precheckOnly specifica yes per eseguire solo i controlli preliminari per questa operazione. Valori validi: yes o no.
  • --serverCert specifica il percorso del certificato PEM da utilizzare o ruotare per la configurazione TCPS.
  • --privateKey specifica il percorso del file della chiave privata del certificato.
  • Tipo --certType del certificato da aggiungere al wallet di Grid Infrastructure. I valori accettati sono: SELF_SIGNED_CERT, CA_SIGNED_CERT o PKCS12_CERT. Impostazione predefinita: SELF_SIGNED_CERT
  • --privateKeyPasswordProtected specifica se la chiave privata è o meno protetta con una password. Valore valido: true o false. Valore predefinito: true.

Esempio 6-31 griglia dbaascli rotateTCPSCert

Per ruotare il certificato utilizzando il certificato autofirmato (opzione predefinita):
dbaascli grid rotateTCPSCert
Per ruotare il certificato utilizzando il certificato firmato da CA:
dbaascli grid rotateTCPSCert --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --privateKeyPasswordProtected true

aggiornamento griglia dbaascli

Per eseguire l'upgrade di Oracle Grid Infrastrucure da una versione principale a un'altra, utilizzare il comando dbaascli grid upgrade.

Requisito

Eseguire il comando come utente root.

Sintassi

dbaascli grid upgrade --version
[--resume]
[--executePrereqs]
[--containerURL]
[--softwareOnly]
[--targetHome]
[--revert]
Dove:
  • --version specifica la versione di destinazione
  • --resume riprende l'esecuzione precedente
  • --executePrereqs esegue i prerequisiti per l'aggiornamento di Grid Infrastrucure
  • --containerUrl specifica l'URL personalizzato per il recupero dell'immagine Grid Infrastrucure
  • --softwareOnly installa solo il software di Grid Infrastructure
  • --targetHome specifica il percorso della home Grid di destinazione esistente
  • --revert ripristina l'esecuzione non riuscita

Esempio di aggiornamento della griglia dbaascli da 6 a 32

daascli grid upgrade --version 19.11.0.0.0 --executePrereqs
DBAAS CLI version MAIN
Executing command grid upgrade --version 19.11.0.0.0 --executePrereqs

job dbaascli getStatus

Per visualizzare lo stato di un job specificato, utilizzare il comando dbaascli job getStatus.

Requisito

Eseguire il comando come utente root.

Sintassi

dbaascli job getStatus --jobID
Dove:
  • --jodID specifica l'ID job

Esempio di job dbaascli 6-33 getStatus

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

applicazione db patch dbaascli

Nota

I comandi dbaascli patch db prereq e dbaascli patch db apply non sono più validi nella release dbaascli 21.2.1.2.0 e sono stati sostituiti con i comandi dbaascli grid patch, dbaascli dbhome patch e dbaascli database move.
Per ulteriori informazioni, fare riferimento agli argomenti sotto riportati.
  • dbaascli grid patch
  • dbaascli dbhome patch
  • dbaascli database move
  • Applicazione di patch ai database Oracle Grid Infrastructure e Oracle mediante dbaascli

patch db prereq dbaascli

Nota

I comandi dbaascli patch db prereq e dbaascli patch db apply non sono più validi nella release dbaascli 21.2.1.2.0 e sono stati sostituiti con i comandi dbaascli grid patch, dbaascli dbhome patch e dbaascli database move.
Per ulteriori informazioni, fare riferimento agli argomenti sotto riportati.
  • dbaascli grid patch
  • dbaascli dbhome patch
  • dbaascli database move
  • Applicazione di patch ai database Oracle Grid Infrastructure e Oracle mediante dbaascli

backup del PDB dbaascli

Per eseguire il backup di un pluggable database (PDB), eseguire una query sui backup dei PDB ed eliminare un backup del PDB, utilizzare il comando dbaascli pdb backup.

Prerequisito

  • Eseguire il comando come utente root.

Sintassi

dbaascli pdb backup --pdbName <value> --dbname <value>
        {
            --start
                {
                    [--level1]
                    | [--archival --tag <value>]
                }
            | --delete --backupTag <value>
            | --status --uuid <value>
            | --getBackupReport --json <value> --tag <value>
            | --list [--json <value>]
        }
Dove:
--pdbName: PDB name.
--dbname: Oracle Database name.
--start | --delete | --status | --getBackupReport | --list
--start: Begins PDB backup.
      [--level1 | --archival]
      [--level1: Creates a Level-1 (incremental) backup.]
      [--archival: Creates an archival full backup.]
          --tag: Specify backup tag.
--delete: Deletes archival backup.
          --backupTag: Specify backup tag to delete.
--status
          --uuid <value>
--getBackupReport: Returns backup report.
         --json: Specify the file name for JSON output.
         --tag: Specify backup tag.
--list: Returns PDB backup information.
         [--json: Specify the file name for JSON output.]

Esempio 6-34 Esempi

  • Per eseguire il backup level1 per un PDB pdb1 in un CDB myTestDb:
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --start --level1
  • Per eseguire una query sullo stato della richiesta di backup del PDB sottomessa con uuid eef16b26361411ecb13800163e8e4fac:
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --status --uuid eef16b26361411ecb13800163e8e4fac

mancato recapito del PDB dbaascli

Per riavviare un pluggable database (PDB), utilizzare il comando dbaascli pdb bounce.

Requisito

Eseguire il comando come utente oracle.

Sintassi

dbaascli pdb bounce --dbname --pdbName | --pdbUID
[–openMode]
Dove:
  • --dbname specifica il nome del container database che ospita il PDB.
  • --pdbName specifica il nome del PDB.
  • --pdbUID specifica l'identificativo del PDB
  • --openMode specifica la destinazione OPEN MODE del PDB

Esempio di mancato recapito del pdb dbaascli da 6 a 35

dbaascli pdb bounce --dbname cdb_name --pdbName pdb name associated with the CDB
dbaascli pdb bounce --dbname cdb_name --pdbUID con_uid of that pdb
Facoltativo:
  • --openMode READ_WRITE
  • --openMode READ_ONLY

pdb dbaascli vicino

Per chiudere un pluggable database (PDB), utilizzare il comando dbaascli pdb close.

Requisito

Eseguire il comando come utente oracle.

Sintassi

dbaascli pdb close --dbname --pdbName | --pdbUID
Dove:
  • --dbname specifica il nome del container database che ospita il PDB.
  • --pdbname specifica il nome del PDB che si desidera chiudere.
  • --pdbUID specifica l'identificativo del PDB

Al termine dell'esecuzione di questo comando, il PDB viene chiuso in tutte le istanze del container database.

Esempio 6-36 dbaascli pdb close

dbaascli pdb close --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb close --dbname cdb name --pdbUID con_uid of that pdb

pdb dbaascli getConnectString

Per visualizzare le informazioni sulla stringa di connessione di Oracle Net per un pluggable database (PDB), eseguire il comando dbaascli pdb getConnectString.

Prerequisito

Eseguire il comando come utente oracle.

Sintassi

dbaascli pdb getConnectString --dbname --pdbName | --pdbUID
Dove:
  • --dbname specifica il nome del container database che ospita il PDB.
  • --pdbname specifica il nome del PDB per il quale si desidera visualizzare le informazioni sulla stringa di connessione
  • --pdbUID specifica l'identificativo del PDB

Esempio 6-37 dbaascli pdb getConnectString

dbaascli pdb getConnectString --dbname dbname --pdbName pdbName

creazione pdb dbaascli

Per creare un nuovo pluggable database (PDB), utilizzare il comando dbaascli pdb create.

Prerequisito

Eseguire il comando come utente oracle.

Sintassi

dbaascli pdb create --pdbName <value> --dbName <value> 
[--maxCPU <value>] 
[--maxSize <value>] 
[--pdbAdminUserName <value>] 
[--lockPDBAdminAccount <value>] 
[--resume [--sessionID <value>]] 
[--executePrereqs <value>] 
[--waitForCompletion <value>] 
[--blobLocation |--standbyBlobFromPrimary <value>]
Dove:
  • --pdbName specifica il nome del nuovo PDB che si desidera creare
  • --dbName specifica il nome del container database che ospita il nuovo PDB.
  • --maxCPU specifica facoltativamente il numero massimo di CPU disponibili per il PDB. L'impostazione di questa opzione equivale effettivamente all'impostazione del parametro CPU_COUNT nel PDB
  • --maxSize specifica facoltativamente la dimensione totale massima dei file di dati e dei file temporanei per le tablespace appartenenti al PDB. L'impostazione di questa opzione equivale all'impostazione della clausola di memorizzazione MAXSIZE PDB nel comando SQL CREATE PLUGGABLE DATABASE. È possibile imporre un limite specificando un numero intero seguito da un'unità di dimensione (K, M, G o T) oppure è possibile specificare UNLIMITED per non applicare alcun limite in modo esplicito.
  • --pdbAdminUserName specifica il nome del nuovo utente amministratore del PDB
  • --lockPDBAdminAccount specifica true o false per bloccare l'account utente dell'amministratore del PDB. Il valore predefinito è true.
  • --resume riprende l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --executePrereqs specifica yes per eseguire solo i prerequisiti per questa operazione. Valori validi: yes o no
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valore valido: true o false
  • Posizione di directory personalizzata --blobLocation in cui verrà generato il file dell'lob di standby in un ambiente Data Guard.
  • --standbyBlobFromPrimary specifica la posizione del file dell'lob di standby, preparato dal database primario. Questa operazione è necessaria solo per le operazioni del PDB del database di standby.
    Nota

    i parametri blobLocation e standbyBlobFromPrimary si escludono a vicenda.

Durante il processo di creazione del PDB, viene richiesto di specificare la password di amministrazione per il nuovo PDB.

Esempio 6-38 dbaascli pdb create

Per creare un PDB da seed in un database standard in un ambiente non Data Guard, effettuare le operazioni riportate di seguito.
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --maxsize 5G --maxcpu 2
Per creare un PDB nell'ambiente Data Guard, effettuare le operazioni riportate di seguito.
dbaascli pdb create --dbName db721 --pdbName new_pdb1
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --standbyBlobFromPrimary /tmp/send_db721.tar

eliminazione del PDB dbaascli

Per eliminare un pluggable database (PDB), eseguire il comando dbaascli pdb delete.

Requisito

Eseguire il comando come utente oracle.

Sintassi

dbaascli pdb delete --dbName value 
{ --pdbName value | --pdbUID value }
[--executePrereqs value]
[--waitForCompletion value]
[--resume [--sessionID value]]
[--allStandbyPrepared]
[--cleanupRelocatedPDB]
Dove:
  • --dbName specifica il nome del container database che ospita il PDB.
  • --pdbName specifica il nome del PDB che si desidera eliminare
  • --pdbUID specifica l'UID del PDB che si desidera eliminare
  • --executePrereqs specifica yes per eseguire solo i prerequisiti per questa operazione. Valori validi: yes o no
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valore valido: true o false
  • --resume specifica di riprendere l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --allStandbyPrepared specifica di confermare che l'esecuzione dell'operazione è riuscita in tutti i database di standby
  • --cleanupRelocatedPDB: opzione per il cleanup del database di origine dopo il riposizionamento di un PDB.
Esempio: eliminazione del pdb dbaascli

Per eliminare un PDB da un database standard in un ambiente non Data Guard o da un database in standby nell'ambiente Data Guard.

dbaascli pdb delete --dbName db721 --pdbName pdb1

Per creare un PDB dal database primario nell'ambiente Data Guard, effettuare le operazioni riportate di seguito.

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

pdb dbaascli getDetails

Per visualizzare i dettagli di un pluggable database (PDB), utilizzare il comando dbaascli pdb getDetails.

Requisito

Eseguire il comando come utente oracle.

Sintassi

dbaascli pdb getDetails --dbname --pdbName | --pdbUID
Dove:
  • --dbname specifica il nome del container database che ospita il PDB.
  • --pdbname specifica il nome del PDB che si desidera eliminare
  • --pdbUID specifica l'identificativo del PDB

Esempio 6-39 dbaascli pdb getDetails

dbaascli pdb getDetails--dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb getDetails--dbname cdb name --pdbUID con_uid of that pdb

lista pdb dbaascli

Per visualizzare la lista dei pluggable database (PDB) in un container database, utilizzare il comando dbaascli pdb list.

Requisito

Eseguire il comando come utente oracle.

Sintassi

dbaascli pdb list --dbname
Dove:
  • --dbname specifica il nome del container database che ospita il PDB.

Esempio di lista pdb dbaascli da 6 a 40

dbaascli pdb list --dbname cdb name

pdb dbaascli localClone

Per creare un nuovo pluggable database (PDB) come copia di un PDB esistente nello stesso container database (CDB), utilizzare il comando dbaascli pdb localClone.

Requisito

Eseguire il comando come utente oracle.

Sintassi

dbaascli pdb localClone --pdbName <value> --dbName <value>
[--targetPDBName <value>]
[--powerLimit <value>]
[--maxCPU <value]
[--maxSize <value>]
[--resume [--sessionID <value>]]
[--executePrereqs]
[--waitForCompletion <value>]
{[--blobLocation <value>]|[--standbyBlobFromPrimary <value>]}
[--excludeUserTablespaces <value>] 
[--excludePDBData <value>] 
[--pdbAdminUserName <value>] 
[--lockPDBAdminAccount <value>] 
[--sourcePDBServiceConvertList <value>]
Dove:
  • --pdbName specifica il nome del nuovo PDB che si desidera duplicare
  • --dbName specifica il nome del database
  • --targetPDBName specifica il nome per il PDB di destinazione (nuovo PDB duplicato)
  • --powerLimit specifica il grado di parallelismo da utilizzare per l'operazione di copia. Il valore valido è compreso tra 1 e 128
  • --maxCPU specifica il numero massimo di CPU da allocare per il PDB
  • --maxSize specifica la dimensione massima di storage in GB per il nuovo PDB
  • --resume riprende l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --executePrereqs specifica yes per eseguire solo i prerequisiti per questa operazione. Valori validi: yes o no
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valore valido: true o false
  • Posizione di directory personalizzata --blobLocation in cui verrà generato il file dell'lob di standby in un ambiente Data Guard.
  • --standbyBlobFromPrimary specifica la posizione del file dell'lob di standby preparato dal database primario. Questa operazione è necessaria solo per le operazioni del PDB del database di standby.
    Nota

    I parametri --blobLocation e --standbyBlobFromPrimary si escludono a vicenda.
  • Opzione --excludeUserTablespaces per saltare le tablespace utente. Esempio: t1,t2,t3.
  • --excludePDBData : specificare true/yes per saltare i dati utente provenienti dal PDB di origine.
  • --pdbAdminUserName: specificare il nuovo nome dell'utente amministratore del PDB.
  • --lockPDBAdminAccount: specificare true o false per bloccare l'account utente amministratore del PDB. Il valore predefinito è true.
  • --sourcePDBServiceConvertList: specificare la lista separata da virgole dei nomi dei servizi da origine a destinazione da convertire. La sintassi è source_srv1:new_srv1,source_srv2:new_srv2.

Il PDB appena duplicato eredita le password di amministrazione dal PDB di origine.

Esempio 6-41 dbaascli pdb localClone

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

pdb dbaascli aperto

Per aprire un pluggable database (PDB), utilizzare il comando dbaascli pdb open.

Eseguire il comando come utente root o oracle.

Sintassi

dbaascli pdb open
 {
   --pdbName <value> | --pdbUID <value>
 }
--dbname <value> [--openMode <value>] [--startServices <value>] [--waitForCompletion <value>] [--setPDBRefreshModeNone [--skipPDBRefresh] [--pdbAdminUserName <value>]]
Dove:
  • --pdbName specifica il nome del PDB che si desidera aprire
  • --pdbUID specifica l'identificativo del PDB
  • --dbname specifica il nome del container database che ospita il PDB.
  • --openMode specifica la modalità OPEN di destinazione del PDB
  • --startServices: specifica di avviare tutti i servizi o la lista di tutti i servizi corrispondenti a un PDB. I valori accettati sono all o una lista delimitata da virgole di servizi PDB.
  • --waitForCompletion: specificare false per eseguire l'operazione in background. Valori validi: true|false
  • --setPDBRefreshModeNone: specifica di convertire un PDB aggiornabile in PDB non aggiornabile.
    • --skipPDBRefresh: specifica di saltare l'aggiornamento di un PDB aggiornabile.
    • --pdbAdminUserName: specifica il nome del nuovo utente amministratore del PDB

Al completamento, il PDB viene aperto in tutte le istanze del container database.

Esempio 6-42 dbaascli pdb open

dbaascli pdb open --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb open --dbname cdb name --pdbUID con_uid of that pdb

Facoltativo: --openMode READ_WRITE/READ_ONLY

recupero pdb dbaascli

Per recuperare un pluggable database (PDB), utilizzare il comando dbaascli pdb recover.

Prerequisito

  • Eseguire il comando come utente root.
  • Il database deve essere configurato con i dettagli di destinazione dello storage di backup in cui sono memorizzati i backup.

Sintassi

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

Esempio 6-43 Esempi

  • Per recuperare un PDB pdb1 in un CDB myTestDb alla versione più recente:
    dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --start --latest
  • Per eseguire una query sullo stato della richiesta di recupero del PDB sottomessa con uuid 81a17352362011ecbc3000163e8e4fac:
    dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --status --uuid 81a17352362011ecbc3000163e8e4fac

aggiornamento del PDB dbaascli

Per aggiornare un pluggable database (PDB) specificato, utilizzare il comando dbaascli pdb refresh.

Eseguire il comando come utente root o oracle.

Sintassi

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

Dove:

  • --dbname: specifica il nome di Oracle Database
  • --pdbName: specifica il nome del pluggable database.
  • --pdbUID: specifica l'identificativo del pluggable database
  • --waitForCompletion: specificare false per eseguire l'operazione in background. Valori validi: true|false

riposizionamento del PDB dbaascli

Per riposizionare il PDB specificato dal database remoto nel database locale, utilizzare il comando dbaascli pdb relocate.

Requisito

Eseguire il comando come utente oracle. Quando richiesto, è necessario fornire la password utente SYS per il database di origine.

Sintassi

dbaascli pdb relocate --pdbName <value> --dbName <value> --sourceDBConnectionString <value> 
[--targetPDBName <value>]
[--powerLimit <value>]
[--maxCpu <value>]
[--maxSize <value>]
[--resume [--sessionID <value>]]
[--executePrereqs <value>]
[--sourcePDBServices <value>]
[--sourcePDBReadOnlyServices <value>]
[--waitForCompletion <value>]
{
    [--blobLocation <value>] | [--standbyBlobFromPrimary <value>]
}
[--upgradePDB <value>]
[--updateDBBlockCacheSize]
{
    [skipOpenPDB] | [--completePDBRelocate]
}
Dove:
  • --pdbName specifica il nome del PDB di origine da riposizionare
  • --dbName specifica il nome del database di destinazione
  • --sourceDBConnectionString specifica la stringa di connessione al database di origine nel formato <scan_name>:<scan_port>/<database_service_name>
  • --targetPDBName specifica un nome per il PDB di destinazione (nuovo PDB riposizionato)
  • --powerLimit specifica il grado di parallelismo da utilizzare per l'operazione di riposizionamento
  • --maxCpu specifica il numero massimo di CPU da allocare per il PDB
  • --maxSize specifica la dimensione massima di storage in GB per il nuovo PDB
  • --resume specifica di riprendere l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --executePrereqs specifica yes per eseguire solo i prerequisiti per questa operazione. Valori validi: yes|no
  • --sourcePDBServices specifica una lista di servizi PDB di origine delimitati da virgole
  • --sourcePDBReadOnlyServices specifica una lista delimitata da virgole dei servizi di sola lettura del PDB di origine.
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valori validi: true|false
  • Posizione di directory personalizzata --blobLocation in cui verrà generato il file dell'lob di standby in un ambiente Data Guard.
  • --standbyBlobFromPrimary specifica la posizione del file dell'oggetto BLOB di standby preparato dal database primario. Questa operazione è necessaria solo per le operazioni in standby.
    Nota

    I parametri --blobLocation si escludono a vicenda.
  • --upgradePDB: specificare true per aggiornare il PDB nell'ambito di questa operazione. Valori validi: true | false.
  • Opzione --updateDBBlockCachesize che consente all'applicazione di impostare i parametri di inizializzazione della dimensione della cache dei blocchi del database per supportare la copia di dati con dimensioni blocco diverse.
  • --skipOpenPDB: consente di indicare che il PDB non deve essere aperto alla fine dell'operazione corrente.
  • --completePDBRelocate: completa il riposizionamento del PDB se eseguito come operazione a due passi.

Riposizionamento del pdb dbaascli 6-44 di esempio

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

pdb dbaascli remoteClone

Per creare un nuovo pluggable database (PDB) come copia di un PDB esistente in un altro container database (CDB), utilizzare il comando dbaascli pdb remoteClone.

Eseguire il comando come utente root o oracle.

Sintassi

dbaascli pdb remoteClone --pdbName <value> --dbName <value> --sourceDBConnectionString <value> [--targetPDBName <value>] [--powerLimit <value>] [--maxCPU <value>] [--maxSize <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--waitForCompletion <value>] [--sourcePDBExportedTDEKeyFile <value>]
        {
            [--blobLocation <value>]
            | [--standbyBlobFromPrimary <value>]
        }
[--excludeUserTablespaces <value>] 
[--excludePDBData <value>] 
[--pdbAdminUserName <value>] 
[--lockPDBAdminAccount <value>] 
[--sourcePDBServiceConvertList <value>] 
[--refreshablePDB --refreshMode <value> [--refreshIntervalInMinutes <value>] --dblinkUsername <value> [--honorCaseSensitiveUserName]] 
[--updateDBBlockCacheSize]
Dove:
  • --pdbName specifica il nome del PDB di origine che si desidera duplicare
  • --dbname specifica il nome (DB_NAME) del CDB che ospita il PDB appena duplicato
  • --sourceDBConnectionString specifica la stringa di connessione al database di origine nel formato scan_name:scan_port/database_service_name
  • --targetPDBName specifica il nome per il PDB di destinazione (nuovo PDB duplicato)
  • --powerLimit specifica il grado di parallelismo da utilizzare per l'operazione di copia. Il valore valido è compreso tra 1 e 128
  • --maxCPU specifica il numero massimo di CPU da allocare per il PDB
  • --maxSize specifica la dimensione massima di storage in GB per il nuovo PDB
  • --resume riprende l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --executePrereqs specifica yes per eseguire solo i prerequisiti per questa operazione. Valori validi: yes o no
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valore valido: true o false
  • --sourcePDBExportedTDEKeyFile specifica il file di chiavi esportato dal PDB di origine. Questa variabile è applicabile solo al database 12.1.
  • --blobLocation specifica il percorso personalizzato in cui verrà generato il file dell'oggetto BLOB di standby in un ambiente Data Guard
  • --standbyBlobFromPrimary specifica la posizione del file dell'oggetto BLOB di standby, preparato dal database primario. Questa operazione è necessaria solo per le operazioni del PDB del database di standby.
    Nota

    I parametri --blobLocation e --standbyBlobFromPrimary si escludono a vicenda.
  • Opzione --excludeUserTablespaces per saltare le tablespace utente. Esempio: t1,t2,t3.
  • --excludePDBData: specificare true/yes per saltare i dati utente provenienti dal PDB di origine.
  • --pdbAdminUserName specifica il nome del nuovo utente amministratore del PDB
  • --lockPDBAdminAccount specificare true o false per bloccare l'account utente amministratore del PDB. Il valore predefinito è true.
  • --sourcePDBServiceConvertList: specificare una lista delimitata da virgole dei nomi dei servizi da origine a destinazione, che devono essere convertiti. La sintassi è source_srv1:new_srv1, source_srv2:new_srv2.
  • --refreshablePDB specifica di creare un PDB aggiornabile
    • --refreshMode specifica la modalità di aggiornamento per il PDB aggiornabile. Valori validi: AUTO|MANUAL
      • --refreshIntervalInMinutes specifica in minuti l'intervallo di aggiornamento per refreshablePDB
    • --dblinkUsername specifica un utente comune di un database remoto utilizzato dal database link per la connessione al database remoto
      • --honorCaseSensitiveUserName indica che il nome utente specificato fa distinzione tra maiuscole e minuscole
  • --updateDBBlockCacheSize: specifica di consentire all'applicazione di impostare i parametri di inizializzazione db block cache size per supportare la copia di dati con una dimensione blocco diversa

Quando si esegue l'avanzamento, è necessario fornire la password utente SYS per il PDB di origine. Il PDB appena duplicato eredita le password di amministrazione dal PDB di origine. Il nome del PDB duplicato viene assegnato nel seguente formato: dbname_sourcepdbname. Questo comando è supportato solo per i database non presenti in una configurazione Data Guard e che utilizzano Oracle Database versione 12.2.0.1 o successiva.

Esempio 6-45 dbaascli pdb remoteClone

dbaascli pdb remoteClone --sourceDBConnectionString test-can.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521 --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2
dbaascli pdb remoteClone --sourceDBConnectionString orcla.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2

sistema dbaascli getDBHomes

Per visualizzare le informazioni su tutte le Oracle home, utilizzare il comando dbaascli system getDBHomes.

Prerequisito

Eseguire il comando come utente root o oracle.

Sintassi

dbaascli system getDBHomes

Esempio 6-46 sistema dbaascli getDBHomes

dbaascli system getDBHomes

sistema dbaascli getGridHomes

Per elencare i dettagli di tutte le home Grid, utilizzare il comando dbaascli system getGridHomes.

Prerequisito

Eseguire il comando come utente root o oracle.

Sintassi

dbaascli system getGridHomes

dbaascli tde changePassword

Per modificare la password del keystore TDE nonché la password del wallet DB per l'alias tde_ks_passwd, utilizzare il comando dbaascli tde changePassword.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli tde changePassword [--dbname <value>]
  {            [--prepareStandbyBlob <value> [--blobLocation <value>]]
               | [--standbyBlobFromPrimary <value>]
  }
  [--resume [--sessionID <value>]]
Dove:
  • --dbname specifica il nome del database
  • --prepareStandbyBlob: specificare true per generare un file di oggetto BLOB che contenga gli artifact necessari per eseguire l'operazione in un ambiente Data Guard.
  • --blobLocation: percorso personalizzato in cui verrà generato il file dell'lob di standby in un ambiente Data Guard.
  • --standbyBlobFromPrimary: specifica la posizione del file dell'oggetto BLOB di standby preparato dal database primario. Questa operazione è necessaria solo per le operazioni in standby.
  • --resume: per riprendere l'esecuzione precedente
  • --sessionID: consente di riprendere un ID sessione specifico.
Per modificare la password TDE in un ambiente non Data Guard
dbaascli tde changepassword --dbname
      <dbname>
Per modificare la password TDE in un ambiente Data Guard
  1. Modificare la password TDE nel database primario.
    dbaascli tde changepassword --dbname
          <dbname> --prepareStandbyBlob true --blobLocation
          <Location where blob file has to be generated>
  2. Copiare l'oggetto BLOB di standby creato nell'ambiente del database di standby.
  3. Modificare la password TDE nel database di standby
    dbaascli tde changepassword --dbname
         <dbname> --standbyBlobFromPrimary <Location of blob generated from
        primary>

dbaascli tde addSecondaryHsmKey

Per aggiungere una chiave HSM (KMS) secondaria alla configurazione HSM (KMS) esistente, utilizzare il comando dbaascli tde addSecondaryHsmKey.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli tde addSecondaryHsmKey --dbname <value> --secondaryKmsKeyOCID <value>
[--executePrereqs]
Dove:
  • --secondaryKmsKeyOCID specifica la chiave KMS secondaria da aggiungere alla configurazione HSM (KMS) esistente.
  • --dbname specifica il nome del database
  • --executePrereqs sexecute i controlli dei prerequisiti e segnalare i risultati.

Esempio 6-47 dbaascli tde addSecondaryHsmKey

dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --precheckOnly yes

dbaascli tde enableWalletRoot

Per abilitare il parametro spfile wallet_root per il database esistente, utilizzare il comando dbaascli tde enableWalletRoot.

Requisito

Eseguire il comando come utente root.

Sintassi

dbaascli tde enableWalletRoot --dbname <value>
[--dbRestart <value>]
[--executePrereqs]
[--resume [--sessionID <value>]]
Dove:
  • --dbname specifica il nome di Oracle Database.
  • --dbrestart specifica l'opzione di riavvio del database. I valori validi sono: rolling o full. Valore predefinito: rolling

    Se non si passa l'argomento dbrestart, il database viene riavviato in modo rolling.

  • --precheckOnly esegue solo il controllo preliminare per questa operazione. I valori validi sono: yes e no
  • --resume per riprendere l'esecuzione precedente
  • --sessionID per riprendere un ID sessione specifico.

Esempio 6-48 dbaascli tde enableWalletRoot

dbaascli tde enableWalletRoot --dbname db name --dbrestart rolling|full
dbaascli tde enableWalletRoot --dbname orcl
dbaascli tde enableWalletRoot --dbname orcl--dbrestart full

dbaascli tde encryptTablespacesInPDB

Per cifrare tutte le tablespace nel PDB specificato, utilizzare il comando dbaascli tde encryptTablespacesInPDB.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli tde encryptTablespacesInPDB --pdbName
[--dbname]
[--precheckOnly]
[--useSysdbaCredential]
Dove:
  • --pdbName specifica il nome del PDB per la cifratura di tutte le tablespace.
  • --dbname specifica il nome di Oracle Database.
  • --precheckOnly esegue solo il controllo preliminare per questa operazione. Valori validi: yes o no
  • --useSysdbaCredential utilizza le credenziali SYSDBA per questa operazione se il valore passato è true. Valore valido: true o false

Esempio 6-49 dbaascli tde encryptTablespacesInPDB

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

dbaascli tde fileToHsm

Per convertire la cifratura TDE basata su FILE in cifratura TDE basata su HSM (KMS/OKV), utilizzare il comando dbaascli tde fileToHsm.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli tde fileToHsm --kmsKeyOCID <value> --dbname <value> 
[--skipPatchCheck <value>] 
[--executePrereqs ] 
[--primarySuc <value>]
{
    [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]]
}
[--waitForCompletion <value>]
Dove:
  • --kmsKeyOCID specifica l'OCID della chiave KMS da utilizzare per la funzione TDE. Applicabile solo se KMS è selezionato per TDE
  • --dbname specifica il nome del database
  • --skipPatchCheck salta il controllo di convalida per le patch richieste se il valore passato per questo argomento è true. Valore valido: true o false
  • --executePrereqs sexecute i controlli dei prerequisiti e segnalare i risultati.
  • --primarySuc specificare questa proprietà nel database di standby dell'ambiente Data Guard dopo l'esecuzione riuscita del comando nel database primario
  • --resume specifica di riprendere l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --revert specifica di eseguire il rollback dell'esecuzione precedente
    • --sessionID specifica di eseguire il rollback di un ID sessione specifico
  • --waitForCompletion: specificare false per eseguire l'operazione in background. Valori validi : true|false.

Esempio 6-50 dbaascli tde fileToHsm --kmsKeyOCID

dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs 
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --resume

dbaascli tde getHsmKeys

Per ottenere i dettagli della chiave attiva TDE, utilizzare il comando dbaascli tde getHsmKeys.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli tde getHsmKeys
[--dbname]
[--infoFile]
Dove:
  • --dbname specifica il nome del database
  • --infoFile specifica il percorso del file in cui verrà salvata la lista di OCID. L'output è in formato JSON

Esempio 6-51 dbaascli tde getHsmKeys

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

dbaascli tde getMkidForKeyVersionOCID

Per ottenere l'ID della chiave master associato all'OCID della versione della chiave KMS, utilizzare il comando dbaascli tde getMkidForKeyVersionOCID.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli tde getMkidForKeyVersionOCID --kmsKeyVersionOCID <value>
[--dbname <value>]
[--waitForCompletion <value>]
Posizione:
  • --kmsKeyVersionOCID specifica l'OCID della versione della chiave KMS da impostare
  • --dbname specifica il nome del database
  • --waitForCompletion: specificare false per eseguire l'operazione in background. Valori validi: true|false.

Esempio 6-52 dbaascli tde getMkidForKeyVersionOCID

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

dbaascli tde getPrimaryHsmKey

Per ottenere la chiave HSM (KMS) primaria da una configurazione KMS (HSM) esistente, utilizzare il comando dbaascli tde getPrimaryHsmKey.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli tde getPrimaryHsmKey
[--dbname]
Posizione:
  • --dbname specifica il nome del database

Esempio 6-53 dbaascli tde getPrimaryHsmKey

dbaascli tde getPrimaryHsmKey --dbname dbname

dbaascli tde hsmToFile

Per convertire la cifratura TDE basata su HSM (KMS/OKV) in cifratura TDE basata su FILE, utilizzare il comando dbaascli tde hsmToFile.

Eseguire il comando come utente root.

Sintassi

dbaascli tde hsmToFile 
[--dbname <value>] 
{
    [--prepareStandbyBlob <value> [--blobLocation <value>]
   | [--standbyBlobFromPrimary <value>]
}
] 
[--skipPatchCheck <value>] 
[--executePrereqs ] 
[--primarySuc <value>] 
{
     [--resume [--sessionID <value>]] |
     [--revert [--sessionID <value>]]
} 
[--waitForCompletion <value>]
Posizione:
  • --dbname specifica il nome del database
  • --prepareStandbyBlob: specificare true per generare un file di oggetto BLOB che contenga gli artifact necessari per eseguire l'operazione in un ambiente Data Guard.
  • Posizione di directory personalizzata --blobLocation in cui verrà generato il file dell'lob di standby in un ambiente Data Guard.
  • --standbyBlobFromPrimary specifica la posizione del file dell'oggetto BLOB di standby preparato dal database primario. Questo è necessario solo per le operazioni in standby. ]
  • --skipPatchCheck salta il controllo di convalida per le patch richieste se il valore passato per questo argomento è true. Valore valido: true o false
  • --executePrereqs esegue i controlli dei prerequisiti e restituisce i risultati.
  • --primarySuc specificare questa proprietà nel database di standby dell'ambiente Data Guard dopo l'esecuzione riuscita del comando nel database primario
  • --resume riprende l'esecuzione precedente
    • --sessionID specifica di riprendere un ID sessione specifico
  • --revert specifica di eseguire il rollback dell'esecuzione precedente
    • --sessionID specifica di eseguire il rollback di un ID sessione specifico
  • --waitForCompletion specifica false per eseguire l'operazione in background. Valori validi: true|false

Esempio 6-54 dbaascli tde hsmToFile

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

dbaascli tde listKeys

Per elencare le chiavi principali TDE, utilizzare il comando dbaascli tde listKeys.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli tde listKeys
[--dbname <value>]
[--infoFilePath <value>]
Posizione:
  • --dbname specifica il nome del database
  • --infoFilePath: specificare il percorso assoluto del file in cui verranno salvati i risultati.

Esempio 6-55 dbaascli tde listKeys

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

dbaascli tde removeSecondaryHsmKey

Per rimuovere la chiave HSM (KMS) secondaria dalla configurazione HSM (KMS) esistente, utilizzare il comando dbaascli tde removeSecondaryHsmKey.

Prerequisito

Eseguire il comando come utente root.

Sintassi

dbaascli tde removeSecondaryHsmKey --dbname <value>
[--confirmDeletion]
[--secondaryKmsKeyOCID]
[--executePrereqs]
Posizione:
  • --dbname specifica il nome del database
  • --confirmDeletion se non specificato, l'utente riceverà un messaggio durante l'eliminazione di tutte le chiavi HSM (KMS) esistenti.
  • Chiave KMS secondaria --secondaryKmsKeyOCID da rimuovere dalla configurazione HSM (KMS) esistente. Se non vengono specificate tutte le chiavi KMS secondarie verranno rimosse.
  • --executePrereqs esegue i controlli dei prerequisiti e restituisce i risultati.

Domande più frequenti

D: Qual è lo scopo del comando dbaascli tde removeSecondaryHsmKey?

A: il comando dbaascli tde removeSecondaryHsmKey viene utilizzato per rimuovere una chiave HSM (Hardware Security Module) secondaria dalla configurazione HSM (KMS) esistente in un ambiente Oracle Database.

D: Quali sono i prerequisiti per l'esecuzione del comando dbaascli tde removeSecondaryHsmKey?

A: È necessario:
  • Eseguire il comando come utente root.
  • Essere connessi a una virtual machine dell'infrastruttura Exadata Cloud utilizzando SSH.

D: Cosa fa il parametro --force nel comando dbaascli tde removeSecondaryHsmKey?

R: Il parametro --force consente la rimozione della chiave HSM secondaria senza richiedere conferma all'utente. Se non specificato, il comando chiederà all'utente prima di eliminare eventuali chiavi.

D: Cosa specifica il parametro --secondaryKmsKeyOCID?

R: il parametro --secondaryKmsKeyOCID specifica l'OCID (Oracle Cloud Identifier) della chiave KMS secondaria che si desidera rimuovere dalla configurazione HSM esistente.

D: Che cosa fa il parametro --dbname?

R: Il parametro --dbname specifica il nome del database per il quale viene rimossa la chiave HSM secondaria.

D: Qual è lo scopo del parametro --precheckOnly?

R: Il parametro --precheckOnly, se impostato su yes, eseguirà solo i controlli preliminari per convalidare la prontezza per l'operazione di rimozione senza rimuovere effettivamente la chiave HSM secondaria. Se impostato su no, viene eseguita l'operazione di rimozione completa.

D: Il parametro --force è obbligatorio?

R: No, il parametro --force è facoltativo. Se non viene specificato, il sistema richiederà una conferma all'utente prima di procedere con la rimozione della chiave.

D: Il parametro --secondaryKmsKeyOCID è obbligatorio?

R: Sì, è necessario fornire --secondaryKmsKeyOCID per identificare la chiave HSM secondaria specifica che si desidera rimuovere dalla configurazione.

D: Il parametro --dbname è obbligatorio?

R: No, il parametro --dbname è facoltativo. Se non viene specificato, il comando tenterà di rimuovere la chiave HSM secondaria dal database predefinito nel sistema.

D: Cosa devo fare se voglio rimuovere la chiave HSM secondaria senza alcun prompt utente?

A: È necessario utilizzare il parametro --force per ignorare il prompt di conferma e rimuovere direttamente la chiave HSM secondaria:

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

D: Come posso verificare se il sistema è pronto a rimuovere la chiave HSM secondaria senza rimuoverla effettivamente?

R: È possibile utilizzare il parametro --precheckOnly impostato su Sì per eseguire un controllo preliminare:

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

D: Cosa succede se non si fornisce un nome di database con --dbname?

R: Se il parametro --dbname non viene specificato, il comando tenterà di rimuovere la chiave HSM secondaria dal database predefinito configurato nel sistema.

D: Cosa devo controllare se il comando non riesce a rimuovere la chiave HSM secondaria?

A: Assicurarsi che:
  • Si sta eseguendo il comando come utente root.
  • Si è connessi alla virtual machine dell'infrastruttura Exadata Cloud.
  • Vengono forniti i valori --secondaryKmsKeyOCID e --dbname corretti. Controllare i messaggi di errore e i log per ulteriori dettagli sull'errore.

D: Cosa devo fare se l'operazione di rimozione fallisce in parte?

R: Se l'operazione non riesce, esaminare i log degli errori e provare a eseguire il comando con --precheckOnly per assicurarsi che il sistema sia pronto per l'operazione. Se necessario, risolvere eventuali problemi prima di riprovare.

D: Posso eseguire il comando dbaascli tde removeSecondaryHsmKey mentre il database è in esecuzione?

R: Sì, il comando può essere eseguito mentre il database è in esecuzione, in quanto non richiede l'arresto del database.

D: Qual è lo scopo di rimuovere una chiave HSM secondaria?

R: La rimozione di una chiave HSM secondaria viene in genere eseguita quando la chiave non è più necessaria o quando si desidera gestire le chiavi di cifratura utilizzate nella configurazione TDE (Transparent Data Encryption).

D: Come connettersi alla virtual machine dell'infrastruttura Exadata Cloud per eseguire il comando?

R: È possibile connettersi alla virtual machine utilizzando SSH. Fare riferimento alla documentazione dell'infrastruttura Exadata Cloud per istruzioni su come stabilire una connessione sicura.

Esempio 6-56 dbaascli tde removeSecondaryHsmKey

dbaascli tde removeSecondaryHsmKey --dbname dbname
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs 

dbaascli tde rotateMasterKey

Ruotare la chiave master per la cifratura del database.

Prerequisiti:

Eseguire il comando come utente root.

Sintassi

(Facoltativo) <Immettere qui le informazioni sulla sintassi.>

dbaascli tde rotateMasterKey --dbname <value> 
[--rotateMasterKeyOnAllPDBs] 
[--pdbName <value>] 
[--executePrereqs] 
[--resume [--sessionID <value>]]
{
     [--prepareStandbyBlob <value> [--blobLocation <value>]]
     | [--standbyBlobFromPrimary <value>]
 }
Posizione:
  • --dbname: nome del database Oracle.
  • --rotateMasterKeyOnAllPDBs: specificare true per ruotare la chiave master di tutti i PDB nel CDB. Valori validi: true|false
  • --pdbName: specificare il nome PDB.
  • --executePrereqs: esegue i controlli dei prerequisiti e restituisce i risultati.
  • --resume: per riprendere l'esecuzione precedente
  • --sessionID: consente di riprendere un ID sessione specifico.
  • --prepareStandbyBlob | --standbyBlobFromPrimary]
  • --prepareStandbyBlob: specificare true per generare un file di oggetto BLOB che contenga gli artifact necessari per eseguire l'operazione in un ambiente Data Guard.
  • --blobLocation: posizione di directory personalizzata in cui verrà generato il file dell'lob di standby in un ambiente Data Guard.
  • --standbyBlobFromPrimary: specifica la posizione del file dell'oggetto BLOB di standby preparato dal database primario. Ciò è necessario solo per le operazioni in standby

dbaascli tde setKeyVersion

Per impostare la versione della chiave primaria da utilizzare in DB/CDB o PDB, utilizzare il comando dbaascli tde setKeyVersion.

Eseguire il comando come utente root.

Sintassi

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <value>
[--pdbName <value>]
[--masterKeyID <value>]
[--standbySuc]
[--executePrereqs]
[--waitForCompletion <value>]
Posizione:
  • --kmsKeyVersionOCID specifica l'OCID della versione della chiave KMS da impostare.
  • --dbname specifica il nome del database.
  • Nome --pdbName del PDB per l'utilizzo dell'OCID della versione della chiave.
  • --masterKeyID specifica l'ID chiave principale dell'OCID della versione della chiave specificata. Questa opzione è applicabile all'ambiente Data Guard.
  • --standbySuc specificare questa proprietà nel database primario dell'ambiente Data Guard dopo l'esecuzione riuscita del comando nel database di standby
  • --executePrereqs esegue i controlli dei prerequisiti e restituisce i risultati.
  • --waitForCompletion: specificare false per eseguire l'operazione in background. Valori validi: true|false

Esempio 6-57 dbaascli tde setKeyVersion

dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha --executePrereqs
dbaascli tde setKeyVersion --dbname dbname --pdbName pdb --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha

dbaascli tde setPrimaryHsmKey

Per modificare la chiave HSM (KMS) primaria per la configurazione KMS (HSM) esistente, utilizzare il comando dbaascli tde setPrimaryHsmKey.

Eseguire il comando come utente root.

Sintassi

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <value> --dbname <value>
[--allStandbyPrepared]
[--bounceDatabase]
[--executePrereqs]
[--resume [--sessionID <value>]]
Posizione:
  • --primaryKmsKeyOCID specifica la chiave KMS primaria da impostare
  • --dbname specifica il nome del database
  • --allStandbyPrepared specificare per confermare che l'esecuzione dell'operazione è riuscita in tutti i database di standby.
  • --bounceDatabase: specificare questo flag per eseguire il riavvio in sequenza del database per questa operazione
  • --executePrereqs esegue i controlli dei prerequisiti e restituisce i risultati.
  • --resume per riprendere l'esecuzione precedente
  • --sessionID per riprendere un ID sessione specifico.

Esempio 6-58 dbaascli tde setPrimaryHsmKey

dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs

stato tde dbaascli

Per visualizzare informazioni sul keystore per il database specificato, utilizzare il comando dbaascli tde status.

Requisito

Nota

Il comando dbaascli tde status non è più valido nella release 24.4.1.0.0 di dbaascli. In alternativa, Oracle consiglia di utilizzare il comando dbaascli database getDetails.

Eseguire il comando come utente oracle.

Sintassi

dbaascli tde status --dbname dbname
Posizione:
  • --dbname specifica il nome del database che si desidera controllare.

L'output del comando include il tipo di keystore e lo stato del keystore.

Esempio 6-59 dbaascli tde status

dbaascli tde status --dbname dbname

Argomenti correlati