Usando o Utilitário dbaascli no Oracle Exadata Database Service na Infraestrutura do Exascale

Aprenda a usar o utilitário dbaascli no Oracle Exadata Database Service na Infraestrutura do Exascale.

Sobre o Uso do Utilitário dbaascli no Oracle Exadata Database Service na Infraestrutura do Exascale

Você pode usar o utilitário dbaascli para executar várias operações de ciclo de vida e administração do banco de dados no Oracle Exadata Database Service no Exascale Infrastructure

Por exemplo, com dbaascli, você pode alterar a senha de um usuário do banco de dados, iniciar um banco de dados ou gerenciar bancos de dados plugáveis (PDBs) e muito mais.

Use a console ou a interface de linha de comando do Oracle Cloud Infrastructure para dimensionar recursos. Os recursos do utilitário dbaascli são adicionais e distintos na Console, na API ou na interface de linha de comando (CLI). A menos que especificado de forma diferente, você precisará de acesso root ao dbaascli para executar todos os comandos de administração.

Para usar o utilitário, você deve estar conectado a uma máquina virtual do Oracle Exadata Database Service no Exascale Infrastructure.

Para obter os comandos possíveis disponíveis com o dbaascli, execute dbaascli --help.

Para obter ajuda específica do comando, execute dbaascli command --help. Por exemplo, dbaascli database create --help.

Consulte Referência de Comando do dbasscli no documento para obter comandos e informações específicas do comando.

Criando Bancos de Dados com o dbaascli

Usando o dbaascli, você pode criar um Banco de Dados Oracle criando primeiramente um home de banco de dados Oracle da versão desejada, seguido pela criação de um banco de dados nesse home

Listando Imagens e Versões de Software Disponíveis para o Banco de Dados e o Grid Infrastructure

Para produzir uma lista de versões suportadas disponíveis para aplicação de patch, use o comando dbaascli cswlib showImages.

  1. Conecte-se à máquina virtual como usuário opc.

    Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.

  2. Inicie um shell de comando do usuário root:
    sudo -s
  3. Execute o seguinte comando:
    dbaascli cswlib showImages --product database

    A saída do comando lista as imagens de software de banco de dados disponíveis.

    dbaascli cswlib showImages --product grid

    A saída do comando lista as imagens de software de grade disponíveis.

  4. Saia do shell de comando do usuário root:
    exit

    Para obter mais detalhes sobre opções avançadas suportadas, consulte dbaascli cswlib showImages.

Exemplo 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

Criando o Home do Banco de Dados Oracle

Para criar um home do Banco de Dados Oracle da versão desejada, use o comando dbaascli dbhome create.

Observação

Você pode criar um home de Banco de Dados Oracle com um nome especificado do Oracle home. Se você não especificar, isso será calculado automaticamente (recomendado).
  1. Conecte-se à máquina virtual como usuário opc.

    Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.

  2. Inicie um shell de comando do usuário root:
    sudo -s
  3. Execute o seguinte comando:
    dbaascli dbhome create --version Oracle Home Version --imageTag image Tag Value
    Em que:
    • --version especifica a versão do Oracle Database
    • --imageTag especifica a Tag da Imagem a ser usada
    Por exemplo:
    dbaascli dbhome create --version 19.9.0.0.0
    Observação

    A especificação de imageTag é opcional. Para exibir as Tags de Imagem, consulte o comando dbaascli cswlib showImages. As Tags de Imagem normalmente são iguais à versão do banco de dados. No entanto, é mantido como provisão para casos em que várias imagens podem precisar ser liberadas para a mesma versão - cada uma atendendo a um requisito específico do cliente.
  4. Saia do shell de comando do usuário root:
    exit

    Para obter mais detalhes sobre opções avançadas suportadas, consulte dbaascli dbhome create.

Criando o Banco de Dados Oracle no Home Especificado

Para criar um Banco de Dados Oracle no home especificado, da versão desejada, use o comando dbaascli database create.

Você pode usar o comando dbaascli database create para:
  • Criar um Banco de Dados Contêiner (CDB) ou um Banco de Dados não Contêiner
  • Criar um CDB com bancos de dados plugáveis (PDBs)
  • Criar um Banco de Dados Oracle com o Conjunto de Caracteres especificado
  • Criar Bancos de Dados Oracle em um subconjunto de nós de cluster
    Observação

    Os bancos de dados criados em um subconjunto de nós não serão exibidos na console do OCI.
  • Crie o Oracle Database versão 12.1.0.2 ou superior com a atualização de release JAN 2021 ou superior. Para bancos de dados com versões inferiores, recomenda-se usar a API baseada na Console do OCI.
  1. Conecte-se à máquina virtual como usuário opc.

    Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.

  2. Inicie um shell de comando do usuário root:
    sudo -s
  3. Execute o seguinte comando:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path
    Em que:
    • --dbName especifica o nome do banco de dados
    • --oracleHome especifica o local do Oracle home
    Para criar um CDB, execute o seguinte comando:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path
    Para criar um não CDB, execute o seguinte comando:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path --createAsCDB false

    Quando solicitado, digite as senhas sys e tde.

  4. Saia do shell de comando do usuário root:
    exit

    Para obter mais detalhes sobre opções avançadas suportadas, consulte dbaascli database create.

Executando Verificações de Pré-requisitos antes de Criar o Banco de Dados Oracle

Para executar verificações de pré-requisitos, use a opção de comando --executePrereqs. Isso executará apenas as verificações de pré-requisitos sem executar a criação real do Banco de Dados Oracle.

  1. Conecte-se à máquina virtual como usuário opc.

    Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.

  2. Inicie um shell de comando do usuário root:
    sudo -s
  3. Execute o seguinte comando:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path --executePrereqs
    Em que:
    • --dbName especifica o nome do banco de dados
    • --oracleHome especifica o local do Oracle home
  4. Saia do shell de comando do usuário root:
    exit

    Para obter mais detalhes sobre opções avançadas suportadas, consulte dbaascli database create.

Retomando ou Revertendo a Operação de Criação do Banco de Dados Oracle

Para retomar ou reverter uma operação de criação de banco de dados com falha, use a opção de comando --resume ou --revert.

Por exemplo:
dbaascli database create --dbName database name --oracleHome Oracle Home Path --resume
Observação

  • Ao usar as opções de comando --resume ou --revert, certifique-se de usar o mesmo comando do mesmo nó que foi usado para o fluxo da operação de criação real.
  • Você só poderá retomar a criação do banco de dados se houver uma falha na etapa de pós-criação do banco de dados.

Alterando as Senhas do Banco de Dados

Para alterar a senha SYS ou a senha da wallet de TDE, use este procedimento.

A senha especificada no campo Senha de Administrador do Banco de Dados quando você cria uma nova instância ou banco de dados Oracle Exadata Database Service on Exascale Infrastructure é definida como senha das credenciais SYS, SYSTEM, wallet de TDE e administrador do PDB. Use os procedimentos a seguir se precisar alterar as senhas de um banco de dados existente.

Observação

se você estiver ativando o Data Guard para um banco de dados, a senha SYS e a da wallet de TDE dos bancos de dados principal e standby deverão ser iguais.
Observação

O uso do dbaascli para alterar a senha SYS garantirá que a automação de backup/restauração possa paralelizar os canais em todos os nós do cluster.

Para Alterar a Senha SYS de um Banco de Dados de Infraestrutura do Oracle Exadata Database Service no Exascale

  1. Faça log-in na máquina virtual do Oracle Exadata Database Service no Exascale Infrastructure como opc.
  2. Execute o seguinte comando:
    sudo dbaascli database changepassword --dbname database_name --user SYS

Para Alterar Senhas de Banco de Dados em um Ambiente do Data Guard

  1. Execute o seguinte comando no banco de dados principal:
    dbaascli database changePassword —dbName <dbname> --user SYS --prepareStandbyBlob true --blobLocation <location to create the blob file>
  2. Copie o arquivo blob criado para todos os bancos de dados stand-by e atualize a propriedade do arquivo para o usuário oracle.
  3. Execute o seguinte comando em todos os bancos de dados stand-by:
    dbaascli database changePassword —dbName <dbname> --user SYS --standbyBlobFromPrimary <location of copies the blob file>

Para Alterar a Senha da Wallet de TDE para um Oracle Exadata Database Service no Banco de Dados de Infraestrutura do Exascale

  1. Faça log-in na máquina virtual do Oracle Exadata Database Service no Exascale Infrastructure como opc.
  2. Execute o seguinte comando:
    sudo dbaascli tde changepassword --dbname database_name

Gerenciando Imagens de Software do Oracle Exadata Database Service no Exascale Infrastructure com o Utilitário Dbaascli

Você pode listar e fazer download das imagens do software do banco de dados Oracle em uma instância do Oracle Exadata Database Service no Exascale Infrastructure, que depois podem ser usadas para provisionar um home do banco de dados.

Observação

Você pode criar imagens de software de banco de dados personalizadas para suas instâncias do Oracle Exadata Database Service no Exascale Infrastructure usando a Console ou a API. Essas imagens são armazenadas no serviço Object Storage e podem ser usadas para provisionar um Home de Banco de Dados na instância do Exadata. Consulte Imagens de Software do Oracle Database para obter mais informações.

Você pode controlar a versão de binários Oracle que são instalados quando você provisiona um novo banco de dados em uma instância do Oracle Exadata Database Service no Exascale Infrastructure mantendo as imagens de software no sistema. A Oracle fornece uma biblioteca de imagens de software na nuvem que você pode exibir e submeter a download para sua instância usando o utilitário dbaascli.

Listando Imagens e Versões de Software Disponíveis para o Banco de Dados e o Grid Infrastructure

Para produzir uma lista de versões suportadas disponíveis para aplicação de patch, use o comando dbaascli cswlib showImages.

  1. Conecte-se à máquina virtual como usuário opc.

    Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.

  2. Inicie um shell de comando do usuário root:
    sudo -s
  3. Execute o seguinte comando:
    dbaascli cswlib showImages --product database

    A saída do comando lista as imagens de software de banco de dados disponíveis.

    dbaascli cswlib showImages --product grid

    A saída do comando lista as imagens de software de grade disponíveis.

  4. Saia do shell de comando do usuário root:
    exit

    Para obter mais detalhes sobre opções avançadas suportadas, consulte dbaascli cswlib showImages.

Exemplo 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

Para fazer download de uma imagem de software

Você pode fazer download de imagens de software disponíveis para sua instância do Oracle Exadata Database Service on Exascale Infrastructure usando o subcomando cswlib download do utilitário dbaascli.

  1. Estabeleça conexão com um nó de computação como usuário opc. Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.
  2. Inicie um shell de comando do usuário root:
    $ sudo -s
    #
  3. Execute o comando dbaascli com o subcomando cswlib download:
    # dbaascli cswlib download [--version <software_version>] [--imageTag <image tag
        value>]
    O comando exibe o local das imagens de software baixadas no seu ambiente do Oracle Exadata Database Service no Exascale Infrastructure.

    Os parâmetros opcionais são:

    • version: especifica uma versão do software Oracle Database. Por exemplo, 19.14.0.0.0.0.
    • imageTag: especifica a tag da imagem.
  4. Saia do shell de comando do usuário root:
    # exit
    $

Coletar Logs de Ferramentas da Nuvem e Executar uma Verificação de Integridade das Ferramentas da Nuvem Usando dbaascli

O uso do comando dbaascli diag permite coletar logs de ferramentas da VM Convidada dbaas para os sistemas Exadata Database Service on Dedicated Infrastructure e Exadata Database Service on Cloud@Customer. Você pode usar esses logs para solucionar problemas relacionados às ferramentas dbaas.

Você pode usar o comando diag para coletar logs dbaastools e executar uma verificação de integridade em todos os nós de um cluster do Exadata. Observe que há suporte para as opções --waitForCompletion a partir da versão 22.4.1
Observação

  • Os comandos dbaascli diag devem ser executados como usuário root
  • A execução do comando dbaascli diag collect em um único nó coletará dados de log de todos os nós
  • É recomendável executar os comandos documentados neste tópico usando a opção --waitForCompletion para comandos de execução longa. Consulte os exemplos de uso de amostra.

Para obter informações sobre a atualização do Exadata Cloud Tooling, consulte dbaascli admin updateStack.

Exemplos de Coleta de Dados de Log de Ferramentas

O comando de coleta dbaascli dbaascli diag usa a sintaxe mostrada abaixo para coletar dados de log de ferramentas:

Consulte dbaascli diag collect na Referência de Comando dbaascli para obter detalhes da sintaxe

# 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.
Observação

Use o comando de status do job para monitorar o andamento.
# 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

Exemplos de Execução de uma Verificação de Integridade

Use o comando dbaascli dbaascli diag healthcheck para executar uma verificação de integridade em todos os nós do sistema.

Consulte dbaascli diag healthcheck para obter os detalhes da sintaxe na Referência de Comando dbaascli.

# 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

Atualizando o Conjunto de Ferramentas da Nuvem com o Utilitário dbaascli

Para atualizar a release do conjunto de ferramentas da nuvem no Oracle Exadata Database Service no Exascale Infrastructure, execute este procedimento.

O conjunto de ferramentas específico da nuvem é usado no Oracle Exadata Database Service em VMs Guest da Infraestrutura do Exascale para operações locais, incluindo comandos dbaascli.

O conjunto de ferramentas da nuvem é atualizado automaticamente pela Oracle quando novas releases são disponibilizadas. Se necessário, você poderá seguir as etapas abaixo para garantir que tenha a versão mais recente do conjunto de ferramentas específico da nuvem em todas as máquinas virtuais do cluster de VMs.
Observação

Você pode atualizar as ferramentas específicas da nuvem fazendo download e aplicando um pacote de software contendo as ferramentas atualizadas.
  1. Conecte-se a uma máquina virtual como usuário opc.

    Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.

  2. Inicie um shell de comando do usuário root:
    sudo -s
  3. Para atualizar para a release mais recente disponível do conjunto de ferramentas da nuvem, execute o seguinte comando:
    dbaascli admin updateStack

    O comando faz a atualização da release do conjunto de ferramentas da nuvem em todos os nós do cluster.

    Para obter mais detalhes e outras opções disponíveis, consulte dbaascli admin updateStack --help.

Criando um Banco de Dados Duplicado

Usando dbaascli para Duplicar um Banco de Dados da Nuvem

Você pode criar um banco de dados duplicado usando dbaascli. Esse novo banco de dados pode estar na mesma região de nuvem que a região de origem ou entre as regiões. As etapas a seguir descrevem como criar um banco de dados duplicado na nuvem.

Observação

Se um banco de dados estiver configurado com o OCI Vault para criptografia de TDE e você quiser duplicar um banco de dados, consulte as seções a seguir.

Preparar para duplicação

Certifique-se de que os seguintes pré-requisitos são ment:

  • Certifique-se de que haja uma configuração de caminho de rede para acessar o banco de dados de origem por meio da string EZConnect.
  • Copie o arquivo da wallet de TDE (ewallet.p12 ) para o nó do banco de dados de destino. O nó no qual você decide executar o comando dbaascli.
  • Crie um Oracle home no nó de destino, se necessário. A versão do Oracle home deve ser a mesma versão da origem ou da versão de RU superior.

Executar verificações de pré-requisitos

Para executar verificações de pré-requisitos, use a opção de comando --executePrereqs. Isso só executará as verificações de pré-requisitos sem executar a duplicação real do 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

Duplicar o banco de dados

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

Se o banco de dados de origem estiver usando o OKV para gerenciamento da área de armazenamento de chaves TDE, a operação atual do banco de dados duplicado não suportará essa configuração.

Considerações ao Usar o OCI Vault para o Gerenciamento de Chaves

Esta seção só é aplicável se o banco de dados estiver configurado com o OCI Vault para criptografia de TDE e você quiser duplicar um banco de dados.

Duplicando um banco de dados na mesma região

  • Etapas adicionais de pré-requisito

    Certifique-se de configurar políticas de acesso do OCI Vault para nós do banco de dados de destino. Os nós do banco de dados de destino devem poder acessar o cofre de chaves do OCI do banco de dados de origem juntamente com seu novo cofre de chaves (se for decidido usar o cofre de chaves separado).

  • Executar verificações de pré-requisitos
    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
  • Duplicar o banco de dados
    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>

    Após a conclusão bem-sucedida desse comando, o banco de dados será duplicado.

Duplicando um banco de dados entre regiões

  • Etapas adicionais de pré-requisito
    • Configure um novo OCI Vault para o banco de dados de destino na região correspondente seguindo as etapas descritas em Preparar-se para Usar Chaves Gerenciadas pelo Cliente no Serviço Vault. Conclua as Tarefas de 1 a 3.
    • Configurar a replicação do OCI Vault da região de origem para a região de destino. Para obter mais informações, consulte Replicando Vaults e Chaves.
    • Atualize a política de grupo Dinâmico, que é criada na etapa 2 para permitir o acesso à chave replicada do OCI Vault.
  • Executar verificações de pré-requisitos
    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
  • Duplicar o banco de dados
    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>

    Após a conclusão bem-sucedida desse comando, o banco de dados será duplicado.

Referência de Comando do dbaascli

Use dbaascli para criar bancos de dados e integrá-los à estrutura de automação na nuvem.

dbaascli é uma interface nativa da nuvem que pode usar modelos DBCA como entradas, chama a funcionalidade do DBCA para criar bancos de dados e, em seguida, chama as APIs do OCI para integrar o banco de dados no framework de automação da nuvem. Os clientes que usam DBCA em scripts hoje podem atualizar seus scripts existentes para chamar o dbaascli em vez do DBCA. Se o dbaascli não puder ser usado porque um recurso específico do DBCA está indisponível no dbaascl, os clientes deverão abrir uma solicitação do My Oracle Support (MOS) para adicionar essa funcionalidade ao dbaascli.

Para usar o utilitário dbaascli, você deve estar conectado a um nó de computação do Oracle Exadata Database Service no Exascale Infrastructure.

Alguns comandos do dbaascli podem ser executados como usuário oracle ou opc, mas muitos comandos requerem privilégios de administrador root. Consulte cada comando para obter requisitos específicos.

dbaascli admin updateStack

Para instalar ou atualizar um RPM dbaastools, use o comando dbaascli admin updateStack.

Pré-requisitos

Execute o comando como usuário root.

Para usar o utilitário, conecte-se a uma máquina virtual do Oracle Exadata Database Service no Exascale Infrastructure.

Consulte Estabelecendo Conexão com uma Máquina Virtual com SSH.

Sintaxe

dbaascli admin updateStack 
[--resume]
[--prechecksOnly]
[--nodes]
Em que:
  • --resume retoma a execução anterior
  • --prechecksOnly executa apenas as pré-verificações desta operação
  • --nodes especifica uma lista de nós delimitados por vírgulas nos quais instalar o RPM. Se você não informar esse argumento, o RPM será instalado em todos os nós do cluster

Perguntas Frequentes

P: Para que é usado o comando dbaascli admin updateStack?

R: O comando dbaascli admin updateStack é usado para instalar ou atualizar um RPM dbaastools no Exadata Cloud Infrastructure.

P: Quais são os pré-requisitos para usar o comando dbaascli admin updateStack?

R: Você deve executar o comando como usuário raiz e estabelecer conexão com uma máquina virtual do Exadata Cloud Infrastructure.

P: O que a opção --resume faz?

A: A opção --resume retomará a execução anterior do comando updateStack se ele tiver sido interrompido ou incompleto.

P: Qual é a finalidade da opção --prechecksOnly?

A: A opção --prechecksOnly executa apenas as pré-verificações para a operação sem realmente executar a instalação ou atualização.

P: Como o parâmetro --nodes é usado?

R: O parâmetro --nodes especifica uma lista de nós delimitados por vírgulas nos quais o RPM deve ser instalado. Se não for fornecido, o RPM será instalado em todos os nós do cluster.

P: O que devo fazer se eu encontrar problemas com o comando dbaascli admin updateStack?

R: Certifique-se de que você esteja executando o comando como usuário raiz e que esteja conectado a uma máquina virtual do Exadata Cloud Infrastructure. Verifique se há mensagens de erro específicas e consulte a documentação de comando ou o suporte da Oracle, se necessário.

P: Como estabeleço conexão com uma máquina virtual do Exadata Cloud Infrastructure para usar o comando dbaascli admin updateStack?

R: Você precisa usar SSH para se conectar à máquina virtual. Consulte a seção em "Estabelecendo Conexão com uma Máquina Virtual com SSH" na documentação para obter instruções detalhadas.

Exemplo de Casos de Uso

Exemplo 1: Instalando ou atualizando o RPM dbaastools em todos os nós

dbaascli admin updateStack

Instala ou atualiza o RPM dbaastools em todos os nós do ambiente Exadata Cloud@Customer.

Exemplo 2: executando pré-verificações somente antes de instalar ou atualizar o RPM

dbaascli admin updateStack --prechecksOnly

Executa somente as pré-verificações para a atualização do RPM dbaastools, sem realmente executar a instalação. Ele garante que todos os pré-requisitos sejam atendidos antes de prosseguir com a atualização.

Exemplo 3: Retomando uma operação updateStack interrompida anteriormente

dbaascli admin updateStack --resume

Retoma uma operação de atualização de RPM dbaastools anterior que foi interrompida ou não foi concluída com sucesso.

Exemplo 4: Instalando ou atualizando dbaastools em nós específicos

dbaascli admin updateStack --nodes node1,node2

Instala ou atualiza o RPM dbaastools somente nos nós especificados node1 e node2, sem afetar outros nós do cluster.

Exemplo 5: Retomando o processo updateStack em nós específicos

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

Retoma o processo de atualização para dbaastools somente nos nós específicos node3 e node4, se a execução anterior tiver sido interrompida.

dbaascli cswlib deleteLocal

Para excluir a imagem local, use o comando dbaascli cswlib deleteLocal.

Execute o comando como usuário root.

Sintaxe

dbaascli cswLib deleteLocal --imageTag <value>

Em que:

  • --imageTag especifica a tag de imagem do Oracle home

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli cswlib deleteLocal?

R: O comando dbaascli cswlib deleteLocal é usado para excluir uma imagem local do Oracle home do sistema.

P: Quais são os pré-requisitos para executar o comando dbaascli cswlib deleteLocal?

R: O comando deve ser executado como o usuário root para garantir que as permissões necessárias estejam disponíveis para excluir a imagem local.

P: Como especificar qual imagem local excluir?

A: Use a opção --imageTag para especificar a tag de imagem do Oracle home que você deseja excluir.

P: O que a opção --imageTag representa no comando?

A: A opção --imageTag representa o identificador ou a tag associada à imagem do Oracle home que você deseja excluir.

P: Posso excluir várias imagens locais de uma só vez usando este comando?

R: Não, o comando dbaascli cswlib deleteLocal permite excluir apenas uma imagem local por vez, especificada por sua tag de imagem.

P: O que acontece se eu executar o comando dbaascli cswlib deleteLocal sem especificar --imageTag?

R: O comando falhará porque --imageTag é necessário para identificar qual imagem local deve ser excluída.

P: É possível recuperar uma imagem local depois que ela tiver sido excluída usando este comando?

R: Não, depois que a imagem local for excluída usando o comando dbaascli cswlib deleteLocal, ela não poderá ser recuperada. Certifique-se de verificar a tag da imagem antes de continuar.

P: Quando eu precisaria usar o comando dbaascli cswlib deleteLocal?

R: Você usaria esse comando quando precisasse remover uma imagem do Oracle home não usada ou desatualizada do sistema local para liberar espaço ou limpar seu ambiente.

Exemplo 6-3 dbaascli cswlib deletelocal

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

dbaascli cswlib download

Para fazer download das imagens de software disponíveis e disponibilizá-las no ambiente do Oracle Exadata Database Service on Exascale Infrastructure, use o comando dbaascli cswlib download.

Pré-requisitos

Execute o comando como usuário root.

Para usar o utilitário, conecte-se a uma máquina virtual do Oracle Exadata Database Service no Exascale Infrastructure.

Consulte Estabelecendo Conexão com uma Máquina Virtual com SSH.

Sintaxe

dbaascli cswlib download --version | --imageTag
[--product]
Em que:
  • --version especifica uma versão da imagem do Oracle home
  • --imageTag especifica a tag da imagem
  • --product especifica o tipo de imagem. Valores válidos: database ou grid

Perguntas Frequentes

P: Qual é a finalidade do comando de download dbaascli cswlib?

R: O comando dbaascli cswlib download é usado para fazer download de imagens de software disponíveis e disponibilizá-las no Exadata Cloud Infrastructure.

P: Quais são os pré-requisitos para executar o comando de download dbaascli cswlib?

R: Execute o comando como usuário root. Além disso, você precisa estar conectado a uma máquina virtual do Exadata Cloud Infrastructure.

P: Como me conecto à máquina virtual necessária para este comando?

A: Você precisa usar SSH para estabelecer conexão com a máquina virtual do Exadata Cloud Infrastructure. Instruções detalhadas podem ser encontradas na documentação em "Estabelecendo Conexão com uma Máquina Virtual com SSH".

P: O que a opção --version especifica no comando?

A: A opção --version especifica a versão da imagem do Oracle home que você deseja fazer download.

P: Como eu uso a opção --imageTag no comando dbaascli cswlib download?

A: A opção --imageTag é usada para especificar a tag de imagem da imagem de software que você deseja fazer download.

P: Qual é a finalidade da opção --product no comando?

A: A opção --product especifica o tipo de imagem que você deseja baixar. Os valores válidos são banco de dados ou grade.

P: Posso fazer download de imagens de banco de dados e grade simultaneamente?

R: Não, você deve especificar database ou grid usando a opção --product, para que cada operação de download seja específica de um tipo de imagem.

P: O que acontece se eu não especificar uma tag de versão ou imagem?

R: O comando provavelmente falhará ou solicitará as informações necessárias, pois as opções --version ou --imageTag são necessárias para identificar a imagem de software específica para download.

P: É necessário especificar --version e --imageTag juntos?

R: Não, você geralmente especifica --version ou --imageTag, dependendo de como deseja identificar a imagem a ser transferida por download, mas não ambos ao mesmo tempo.

P: Quando eu usaria o comando dbaascli cswlib download?

R: Você usaria esse comando quando precisasse fazer download de imagens de software do Oracle home para ambientes database ou grid na configuração do Exadata Cloud Infrastructure.

Exemplo 6-4 dbaascli cswlib download --product --imageTag

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

Exemplo 6-5 dbaascli cswlib download --version 19.9.0.0.0

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

dbaascli cswlib listLocal

Para exibir a lista de imagens do Banco de Dados e do Grid Infrastructure disponíveis localmente, use o comando dbaascli cswlib listLocal.

Execute o comando como usuário root.

Sintaxe

dbaascli cswLib listLocal [--product <value>]

Em que:

  • --product identifica o tipo de produto do Oracle home. Valores válidos: database ou grid.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli cswlib listLocal?

R: O comando dbaascli cswlib listLocal é usado para exibir a lista de imagens do Banco de Dados e do Grid Infrastructure disponíveis localmente no seu sistema.

P: Quais são os pré-requisitos para executar o comando dbaascli cswlib listLocal?

R: O comando deve ser executado como o usuário root para ter as permissões necessárias para acessar e listar as imagens disponíveis.

P: Como eu especifico que tipo de imagens listar usando este comando?

A: Use a opção --product para especificar o tipo de imagens do Oracle home que você deseja listar. Os valores válidos são database ou grid.

P: O que a opção --product representa no comando dbaascli cswlib listLocal?

A: A opção --product identifica o tipo de produto Oracle home, permitindo que você filtre a lista de imagens disponíveis para os tipos database ou grid.

P: Posso listar imagens de banco de dados e grade simultaneamente?

R: Não, a opção --product permite listar imagens database ou grid de cada vez. Você precisa executar o comando duas vezes com valores --product diferentes para ver as duas listas.

P: O que acontece se eu não especificar a opção --product no comando?

R: Se a opção --product não for especificada, o comando poderá listar todas as imagens disponíveis localmente ou poderá exigir que você especifique o tipo de produto. O comportamento pode depender da configuração do seu ambiente.

P: Quando devo usar o comando dbaascli cswlib listLocal?

R: Você deve usar esse comando quando quiser verificar quais imagens do Banco de Dados ou do Grid Infrastructure estão disponíveis localmente no sistema.

P: Como posso diferenciar entre imagens de banco de dados e de grade na lista?

R: A opção --product permite filtrar a lista, portanto, especificando database ou grid, você só verá as imagens relevantes para esse tipo de produto, facilitando a diferenciação.

P: Há algum risco associado à execução do comando dbaascli cswlib listLocal?

R: Não, este comando não é destrutivo e exibe apenas informações sobre imagens disponíveis localmente. Ele não modifica ou exclui nenhum arquivo.

P: Este comando exibe imagens remotas ou armazenadas na nuvem?

R: Não, o comando dbaascli cswlib listLocal exibe apenas imagens que estão disponíveis localmente no seu sistema, não aquelas armazenadas remotamente ou na nuvem.

Exemplo 6-6 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

Para exibir a lista de imagens disponíveis do Banco de Dados e do Grid Infrastructure, use o comando dbaascli cswlib showImages.

Execute o comando como usuário root.

Sintaxe

dbaascli cswlib showImages 
[--product]

Em que:

  • --product identifica o tipo de produto do Oracle home. Valores válidos: database ou grid.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli cswlib showImages?

R: O comando dbaascli cswlib showImages é usado para exibir a lista de imagens disponíveis do Banco de Dados e do Grid Infrastructure que podem ser baixadas ou gerenciadas no ambiente do Oracle Exadata Database Service.

P: Quais são os pré-requisitos para executar o comando dbaascli cswlib showImages?

R: O comando deve ser executado como o usuário root para garantir que você tenha as permissões necessárias para exibir as imagens disponíveis.

P: Como faço para filtrar as imagens listadas por este comando?

R: Você pode filtrar as imagens especificando a opção --product com database ou grid para listar somente as imagens relacionadas a esse tipo de produto.

P: O que a opção --product representa no comando dbaascli cswlib showImages?

A: A opção --product identifica o tipo de produto do Oracle home, permitindo que você filtre a lista de imagens para o banco de dados ou a grade.

P: Posso exibir imagens de banco de dados e grade em uma única execução de comando?

R: Não, você precisa executar o comando duas vezes com valores --product diferentes (database e grid) para exibir os dois tipos de imagens.

P: O que acontece se eu não especificar a opção --product no comando?

R: Se a opção --product não for especificada, o comando poderá listar todas as imagens disponíveis ou poderá solicitar que você especifique o tipo de produto, dependendo da configuração do seu ambiente.

P: Quando devo usar o comando dbaascli cswlib showImages?

R: Use este comando quando quiser exibir a lista de imagens do Banco de Dados ou do Grid Infrastructure disponíveis para download ou implantação no ambiente do Oracle Exadata Database Service.

P: Há alguma diferença entre os comandos dbaascli cswlib showImages e dbaascli cswlib listLocal?

R: Sim, dbaascli cswlib showImages lista todas as imagens disponíveis que você pode fazer download ou gerenciar, enquanto dbaascli cswlib listLocal lista apenas as imagens que já foram baixadas e disponíveis localmente no seu sistema.

P: Esse comando pode ser usado para exibir imagens armazenadas na nuvem?

R: Sim, esse comando pode mostrar imagens que estão disponíveis para download nos repositórios da Oracle, não apenas aquelas armazenadas localmente.

P: Que tipo de imagens posso esperar ver com este comando?

R: Você pode esperar ver imagens relacionadas ao Oracle Database e ao Grid Infrastructure, que são componentes essenciais para gerenciar e executar bancos de dados Oracle em plataformas Exadata.

Exemplo 6-7 dbaascli cswlib showImages

dbaascli cswlib showImages

dbaascli database addInstance

Para adicionar a instância do banco de dados no nó especificado, use o comando dbaascli database addInstance.

Pré-requisito

  • Execute o comando como usuário root.

Sintaxe

dbaascli database addInstance --dbname <value> --node <value> [--newNodeSID <value>]
Em que:
  • --dbname especifica o nome do Oracle Database
  • --node especifica o nome do nó da instância do banco de dados
    • --newNodeSID especifica o SID para a instância a ser adicionada no novo nó

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database addInstance?

R: O comando dbaascli database addInstance é usado para adicionar uma nova instância de banco de dados a um nó especificado em um ambiente do Oracle Exadata Database Service.

P: Quais são os pré-requisitos para executar o comando dbaascli database addInstance?

R: O comando deve ser executado como o usuário root para ter as permissões necessárias para adicionar uma instância de banco de dados.

P: O que a opção --dbname representa neste comando?

A: A opção --dbname especifica o nome do Oracle Database para o qual você deseja adicionar uma nova instância.

P: Qual é a opção --node usada no comando addInstance do banco de dados dbaascli?

A: A opção --node especifica o nome do nó em que a nova instância do banco de dados será adicionada.

P: Qual é a finalidade da opção --newNodeSID neste comando?

A: A opção --newNodeSID permite especificar o SID (Identificador do Sistema) para a nova instância do banco de dados que será criada no nó especificado.

P: É obrigatório especificar a opção --newNodeSID ao adicionar uma nova instância?

A: A opção --newNodeSID é opcional. Se não for fornecido, a Oracle gerará automaticamente um SID para a nova instância do banco de dados.

P: Quando devo usar o comando dbaascli database addInstance?

R: Use este comando quando quiser dimensionar seu banco de dados adicionando uma nova instância a um nó adicional em uma configuração do Oracle Database com vários nós.

P: Posso adicionar várias instâncias de banco de dados a nós diferentes usando este comando?

R: Sim, você pode executar o comando várias vezes para adicionar instâncias de banco de dados a diferentes nós especificando os valores --node e --dbname apropriados.

P: O que acontece se o nó especificado na opção --node não estiver disponível?

R: O comando falhará se o nó especificado não estiver disponível ou acessível. Certifique-se de que o nó esteja adequadamente configurado e acessível antes de executar o comando.

P: Este comando pode ser usado em um ambiente do Data Guard?

R: Sim, você pode usar o comando dbaascli database addInstance em um ambiente do Data Guard para adicionar instâncias, mas é recomendável seguir as diretrizes necessárias do Data Guard para essas configurações.

P: Esse comando causará tempo de inatividade do banco de dados?

R: A adição de uma instância a um novo nó geralmente não causa tempo de inatividade para as instâncias de banco de dados existentes, mas é recomendável verificar seu ambiente em busca de dependências específicas.

dbaascli database backup

Para configurar o Oracle Database com um destino de armazenamento de backup, fazer backups do banco de dados, consultar backups e excluir um backup, use o comando dbaascli database backup.

Pré-requisito

  • Execute o comando como usuário root.

Sintaxe

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
        }

Em que:

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

enableRTRT e disableRTRT só se aplicam ao destino de backup ZDLRA no Exadata Database Service on Cloud@Customer.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database backup?

R: O comando dbaascli database backup é usado para configurar destinos de armazenamento de backup do Oracle Database, fazer backups, consultar backups e excluir backups existentes.

P: Quais são os pré-requisitos para executar o comando de backup do banco de dados dbaascli?

R: O comando deve ser executado como o usuário root para ter as permissões necessárias para o gerenciamento de backup.

P: Como inicio um backup completo do Oracle Database usando este comando?

A: Para iniciar um backup completo (Nível-0), use a seguinte sintaxe:

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

P: Como faço um backup incremental usando o comando de backup do banco de dados dbaascli?

A: Para executar um backup incremental de Nível 1, use esta sintaxe:

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

P: Qual é a diferença entre backups de Nível 0 e Nível 1?

R: Um backup de Nível 0 é um backup completo do banco de dados, enquanto um backup de Nível 1 é um backup incremental que captura apenas as alterações feitas desde o último backup de Nível 0 ou Nível 1.

P: Posso fazer um backup de arquivamento usando este comando?

R: Sim, você pode criar um backup de arquivamento usando a opção --archival junto com o comando --start:

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

P: Como excluo um backup de arquivamento existente?

A: Para excluir um backup de arquivamento, use a seguinte sintaxe:

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

P: Como posso verificar o status de um backup específico usando o comando?

R: Você pode verificar o status de um backup usando a opção --status com o parâmetro --uuid, como este:

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

P: Como faço para listar todos os backups de um banco de dados?

A: Para listar todos os backups disponíveis para um banco de dados específico, use a opção --list:

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

Para saída JSON, adicione a opção --json:

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

P: Como posso recuperar um relatório de backup?

R: Você pode obter um relatório de backup usando a opção --getBackupReport, para uma tag específica ou para o backup mais recente:

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

Ou para recuperar o relatório mais recente:

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

P: Como configuro as definições de backup do banco de dados?

A: Use a opção --configure para especificar o arquivo de configuração de backup ou para ativar/desativar o RTRT (Real-Time Redo Transport):

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

Para habilitar o RTRT:

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

P: Como verifico a configuração de backup atual do meu banco de dados?

A: Para exibir a configuração de backup do banco de dados atual, use a opção --getConfig:

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

P: O que a opção --validate faz no comando dbaascli database backup?

A: A opção --validate verifica se os backups estão completos e livres de corrupção. Você pode especificar um intervalo de tempo usando a opção --untilTime:

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

P: Como exibo o histórico de todas as operações de backup de um banco de dados?

A: Use a opção --showHistory para exibir o histórico de todas as operações de backup:

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

Para obter um histórico completo, incluindo todas as operações:

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

P: O que são opções de RTRT (Real-Time Redo Transport) e quando devo usá-las?

R: As opções RTRT (--enableRTRT e --disableRTRT) são usadas para controlar o Transporte de Redo em Tempo Real, aplicável apenas para destinos de backup ZDLRA (Zero Data Loss Recovery Appliance) nos ambientes Exadata Cloud@Customer. Ative o RTRT para garantir a remessa de redo log em tempo real.

Exemplo 6-8 Exemplos

  • Para alterar o período de retenção do log de arquivamento, siga as etapas abaixo:
    dbaascli database backup --getConfig --dbname <dbname>

    Isso gerará um arquivo de configuração de backup .cfg.

    Atualize o valor bkup_archlog_fra_retention neste arquivo de configuração.

    Execute o comando configure:

    dbaascli database backup --configure --dbname <dbname> --configfile <config file generated above>
  • Para obter a configuração de backup de um banco de dados myTestDB:
    dbaascli database backup --dbName myTestDB --getConfig --configFile /tmp/configfile_1.txt
  • Para definir a configuração de backup de um banco de dados myTestDB modificando o arquivo de configuração com detalhes de configuração:
    dbaascli database backup --dbName myTestDB --configure --configFile /tmp/configfile_1_modified.txt
  • Para fazer backup do banco de dados myTestDB:
    dbaascli database backup --dbName myTestDB --start
  • Para consultar o status da solicitação de backup submetida com uuid 58fdcae0bd1c11eb92bc020017075151:
    dbaascli database backup --dbName myTestDB --status --uuid 58fdcae0bd1c11eb92bc020017075151
  • Para ativar o RTRT do banco de dados myTestDB:
    dbaascli database backup --dbName myTestDB --configure —enableRTRT

dbaascli database bounce

Para fazer shutdown e reiniciar um banco de dados Oracle Exadata Database Service no Exascale Infrastructure especificado, use o comando dbaascli database bounce.

Pré-requisitos

Execute o comando como usuário oracle.

Sintaxe

dbaascli database bounce
[--dbname][--rolling <value>]
Em que:
  • --dbname especifica o nome do banco de dados
  • --rolling especifica true ou false para devolver o banco de dados de maneira incremental. O valor padrão é false.

O comando executa um shutdown do banco de dados no modo imediato. O banco de dados é depois reiniciado e aberto. No Oracle Database 12c ou mais recente, todos os PDBs também são abertos.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database bounce?

R: O comando dbaascli database bounce é usado para fazer shutdown e reiniciar um Oracle Database no Exadata Cloud Infrastructure. Ele suporta a reinicialização do banco de dados de forma incremental, garantindo o mínimo de interrupção.

P: Quais são os pré-requisitos para executar o comando dbaascli database bounce?

R: O comando deve ser executado como o usuário oracle, que tem os privilégios necessários para fazer shutdown e reiniciar o banco de dados.

P: O que a opção --dbname especifica neste comando?

A: A opção --dbname especifica o nome do Oracle Database que você deseja desligar e reiniciar.

P: Qual é a opção --rolling usada no comando dbaascli database bounce?

A: A opção --rolling especifica se o banco de dados deve ser devolvido (reinicializado) de maneira incremental. Se definido como verdadeiro, as instâncias do banco de dados serão reiniciadas uma a uma, garantindo um tempo de inatividade mínimo. O valor padrão é false, que reinicia todas as instâncias de uma só vez.

P: O que significa "saltar o banco de dados"?

R: Saltar o banco de dados refere-se a desligá-lo e reiniciá-lo. Esta operação pode ser usada para manutenção, aplicação de alterações ou recuperação de determinados tipos de problemas.

P: O comando dbaascli database bounce executa um shutdown normal?

R: Sim, o comando executa um shutdown no modo "imediato", que fecha o banco de dados e faz rollback de transações não confirmadas sem esperar que os usuários se desconectem.

P: Este comando abrirá automaticamente todos os PDBs em um banco de dados Oracle 12c ou mais recente?

R: Sim, se o banco de dados estiver executando o Oracle Database 12c ou mais recente, o comando abrirá automaticamente todos os Bancos de Dados Plugáveis (PDBs) após a reinicialização do banco de dados.

P: O comando dbaascli database bounce pode ser usado em um ambiente com vários nós ou RAC (Real Application Clusters)?

R: Sim, em um ambiente com vários nós ou RAC, você pode usar a opção --rolling para reiniciar as instâncias do banco de dados uma a uma, minimizando o tempo de inatividade.

P: O que acontece se eu não especificar a opção --rolling?

R: Se a opção --rolling não for especificada ou se estiver definida como falsa, o comando fará shutdown e reiniciará todas as instâncias do banco de dados ao mesmo tempo, o que pode causar um breve período de indisponibilidade.

P: Existe um valor padrão para a opção --rolling no comando dbaascli database bounce?

R: Sim, o valor padrão da opção --rolling é false, o que significa que o banco de dados será devolvido de forma não incremental, a menos que especificado de outra forma.

P: Como reinicio um banco de dados no modo incremental?

R: Para reiniciar o banco de dados no modo incremental, use a seguinte sintaxe:

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

P: É seguro executar o comando dbaascli database bounce durante sessões ativas?

R: Embora o comando use um shutdown imediato, que reverte as transações não confirmadas, é sempre recomendável garantir que não haja sessões críticas ou ativas antes de devolver o banco de dados.

P: Esse comando pode ser usado para PDBs específicos em um banco de dados multitenant?

R: Não, o comando dbaascli database bounce opera em todo o banco de dados. No Oracle 12c ou posterior, ele retornará o Banco de Dados Contêiner (CDB) e abrirá todos os PDBs, mas não permitirá a devolução de PDBs individuais.

P: O que devo fazer se o banco de dados não voltar a ficar on-line depois de devolvê-lo?

R: Se o banco de dados não for reinicializado, verifique se há erros nos logs durante o processo de shutdown ou inicialização. Investigar os logs de alerta da Oracle pode fornecer informações sobre o que causou o problema.

Exemplo 6-9 dbaascli database bounce

dbaascli database bounce --dbname dbname

dbaascli database changepassword

Para alterar a senha de um usuário do Oracle Database especificado, use o comando dbaascli database changePassword. Quando solicitado, digite o nome de usuário cuja senha você deseja alterar e, em seguida, digite a senha.

Pré-requisitos

Execute o comando como usuário root ou oracle.

Sintaxe

dbaascli database changePassword [--dbname <value>] [--user <value>]
{
  [--prepareStandbyBlob <value> [--blobLocation <value>]] | [--standbyBlobFromPrimary <value>]
}
[--resume [--sessionID <value>]]
Em que:
  • --dbname especifica o nome do Oracle Database no qual você deseja atuar
  • --user especifica o nome de usuário cuja alteração de senha é necessária
  • --prepareStandbyBlob especifica true para gerar um arquivo blob contendo os artefatos necessários para alterar a senha em um ambiente do Data Guard. Valores válidos: true|false
  • --blobLocation especifica o caminho personalizado no qual o arquivo blob será gerado
  • --standbyBlobFromPrimary especifica o arquivo blob stand-by, que é preparado no banco de dados principal
  • --resume especifica para retomar a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico

Perguntas Frequentes

P: O que o comando dbaascli database changePassword faz?

A: O comando dbaascli database changePassword é usado para alterar a senha de um usuário especificado do Oracle Database. Será solicitado inserir o nome do usuário e, em seguida, a nova senha.

P: Quais são os pré-requisitos para usar o comando changePassword do banco de dados dbaascli?

R: Você deve executar o comando como o usuário root ou oracle para alterar a senha de um usuário do banco de dados.

P: Como eu especifico o banco de dados ao usar este comando?

A: Use a opção --dbname para especificar o nome do Oracle Database no qual você deseja atuar. Por exemplo:

dbaascli database changePassword --dbname <db_name>

P: Como eu especifico o usuário cuja senha eu quero alterar?

A: Use a opção --user para especificar o nome de usuário cuja senha precisa ser alterada. Por exemplo:

dbaascli database changePassword --user <username>

P: Qual é a finalidade da opção --prepareStandbyBlob no comando dbaascli database changePassword?

A: A opção --prepareStandbyBlob é usada nos ambientes do Data Guard para gerar um arquivo blob que contém os artefatos necessários para a alteração de senha no banco de dados stand-by. Isso garante a sincronização da senha no ambiente do Data Guard.

P: O que a opção --blobLocation especifica?

A: A opção --blobLocation permite especificar um caminho personalizado no qual o arquivo blob stand-by deve ser gerado. Se não for fornecido, o arquivo será salvo no local padrão.

P: Como eu uso o blob gerado do banco de dados principal para alterar a senha no stand-by?

R: Você pode usar a opção --standbyBlobFromPrimary para especificar o arquivo blob preparado do banco de dados principal para aplicar a alteração de senha ao banco de dados stand-by. Por exemplo:

dbaascli database changePassword --standbyBlobFromPrimary <blob_file_path>

P: Para que é usada a opção --resume neste comando?

A: A opção --resume é usada para retomar uma operação de alteração de senha interrompida anteriormente. Você pode especificar o ID da sessão, se necessário, usando a opção --sessionID.

P: Posso retomar uma sessão específica com o comando dbaascli database changePassword?

R: Sim, você pode usar a opção --resume junto com --sessionID para retomar uma sessão de alteração de senha específica especificando o ID da sessão.

P: O comando dbaascli database changePassword é aplicável em um ambiente do Data Guard?

A: Sim, é. A opção --prepareStandbyBlob pode ser usada para garantir que as alterações de senha sejam propagadas para o banco de dados stand-by em uma configuração do Data Guard.

P: O que acontece se eu não fornecer um --blobLocation ao usar --prepareStandbyBlob?

R: Se nenhum --blobLocation for fornecido, o arquivo blob que contém os artefatos de alteração de senha será salvo no local padrão.

P: Como verifico o status de uma sessão retomada usando o banco de dados dbaascli changePassword?

R: Você pode especificar o ID da sessão usando a opção --sessionID para retomar uma sessão específica. O sistema continuará de onde parou ao alterar a senha.

P: Esse comando pode ser usado para bancos de dados regulares e para aqueles em um ambiente do Data Guard?

R: Sim, o comando funciona para bancos de dados Oracle regulares e para bancos de dados em um ambiente Data Guard. Em ambientes do Data Guard, opções adicionais como --prepareStandbyBlob podem ser usadas para gerenciar alterações de senha nos bancos de dados principal e stand-by.

Exemplo 6-10 dbaascli database changePassword

dbaascli database changepassword --dbname db19

dbaascli database convertToPDB

Para converter em PDB o banco de dados não CDB especificado, use o comando dbaascli database convertToPDB.

Sintaxe

dbaascli database convertToPDB --dbname <value> [--cdbName <value>] [--executePrereqs]
        {
            [--copyDatafiles [--keepSourceDB]]|[backupPrepared]
        }
        [--targetPDBName <value>] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Em que:
  • --dbname especifica o nome do Oracle Database
  • --cdbName especifica o nome do CDB de destino no qual o PDB será criado. Se o CDB não existir, ele será criado no mesmo Oracle home que o não CDB de origem
  • --executePrereqs especifica para só executar as verificações de pré-conversão
  • --copyDatafiles especifica para criar uma nova cópia dos arquivos de dados em vez de usar os do banco de dados de origem

    --keepSourceDB - para preservar o banco de dados de origem após a conclusão da operação.

  • --backupPrepared - flag para confirmar que há um backup adequado do banco de dados para o não CDB antes de executar a conversão para o PDB.
  • Flag --backupPrepared para confirmar que um backup de banco de dados adequado está em vigor para o não CDB antes de executar a conversão em PDB
  • --targetPDBName especifica o nome do PDB que será criado como parte da operação
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true|false
  • --resume especifica para retomar a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico

Exemplo 6-11 dbaascli database convertToPDB

Para executar pré-verificações de conversão:
dbaascli database convertToPDB --dbname ndb19 --cdbname cdb19 --backupPrepared --executePrereqs
Para executar uma conversão completa com uma cópia dos arquivos de dados do não CDB:
dbaascli database convertToPDB --dbname tst19 --cdbname cdb19 --copyDatafiles

dbaascli database create

Para criar o Oracle Database, use o comando dbaascli database create. Quando solicitado, digite as senhas sys e tde.

Use este comando para criar o Oracle Database versão 12.1.0.2 ou superior com a atualização de release JAN 2021 ou superior. Para bancos de dados com versões inferiores, recomenda-se usar a API baseada na Console do OCI.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

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]
Em que:
  • --dbname especifica o nome do banco de dados
  • --oracleHome especifica o local do Oracle home
  • --oracleHomeName especifica o nome do Oracle home
  • --dbUniqueName especifica o nome exclusivo do banco de dados
  • --dbSID especifica o SID do banco de dados
  • --createAsCDB especifica true ou false para criar o banco de dados como CDB ou Não CDB
  • --pdbName especifica o nome do PDB
  • --pdbAdminUserName especifique o nome do usuário administrador do PDB
  • --dbCharset especifica o conjunto de caracteres do banco de dados
  • --dbNCharset especifica o conjunto de caracteres nacionais do banco de dados
  • --dbLanguage especifica o idioma do banco de dados
  • --dbTerritory especifica o território do banco de dados
  • --sgaSizeInMB especifica o valor sga_target em unidade de megabyte
  • --pgaSizeInMB especifica o valor pga_aggregate_target em unidade de megabyte
  • --datafileDestination especifica o nome do grupo de discos do ASM a ser usado para arquivos de dados do banco de dados
  • --fraDestination especifica o nome do grupo de discos do ASM a ser usado para a Área de Recuperação Rápida do banco de dados
  • --fraSizeInMB especifica o valor do tamanho da Área de Recuperação Rápida em unidade de megabyte
  • --nodeList especifica uma lista de nós delimitados por vírgulas para o banco de dados
  • --tdeConfigMethod especifica o método de configuração de TDE. Valores válidos: FILE, KMS
  • --kmsKeyOCID especifica o OCID da chave KMS a ser usado para TDE. Isso só será aplicável se o KMS for selecionado para TDE
  • --resume retoma a execução anterior
  • --revert faz rollback da execução anterior
  • --sessionID retoma ou reverte um ID de sessão específico.
  • --executePrereqs especifica yes para só executar os pré-requisitos desta operação. Valores válidos: yes ou no
  • --honorNodeNumberForInstance especifica true ou false para indicar se o nome da instância deve ser sufixado com os números de nó do cluster. Valor padrão: true
  • --lockPDBAdminAccount especifica true ou false para bloquear a conta de usuário administrador do PDB. O valor default é verdadeiro
  • --dbcaTemplateFilePath especifica o caminho absoluto do nome do modelo de dbca para criar o banco de dados.
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true ou false

Perguntas Frequentes

P: O que o comando dbaascli database create faz?

R: O comando dbaascli database create é usado para criar uma nova instância do Oracle Database. Ele suporta a criação do Oracle Database versão 12.1.0.2 ou superior com a atualização de release JAN 2021 ou superior.

P: Como especifico o nome do Oracle Database a ser criado?

A: Use a opção --dbName para especificar o nome do Oracle Database. Por exemplo:

dbaascli database create --dbName <db_name>

P: Como posso criar um CDB (Banco de Dados Contêiner)?

A: Use a opção --createAsCDB e especifique verdadeiro para criar o banco de dados como um CDB. Por exemplo:

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

P: Como especifico o Oracle Home para o banco de dados?

R: Você pode usar a opção --oracleHome para especificar o local do Oracle home ou a opção --oracleHomeName para especificar o nome do Oracle home.

P: Como especifico um nome de banco de dados exclusivo ou SID?

A: Use a opção --dbUniqueName para especificar um nome exclusivo para o banco de dados e a opção --dbSID para especificar o SID do banco de dados.

P: Como crio um PDB (Banco de Dados Plugável) junto com um CDB?

R: Você pode usar a opção --pdbName para especificar o nome do PDB e a opção --pdbAdminUserName para definir o nome do usuário administrador do PDB. Por exemplo:

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

P: Como posso especificar o conjunto de caracteres do banco de dados e o conjunto de caracteres nacionais?

A: Use a opção --dbCharset para especificar o conjunto de caracteres do banco de dados e a opção --dbNCharset para especificar o conjunto de caracteres nacionais. Por exemplo:

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

P: Como defino as definições de memória (SGA e PGA) para o banco de dados?

R: Use a opção --sgaSizeInMB para especificar o tamanho da SGA e a opção --pgaSizeInMB para especificar o tamanho da PGA, ambos em megabytes.

P: Como especificar o destino dos arquivos de dados e da Área de Recuperação Rápida (FRA)?

A: Use a opção --datafileDestination para especificar o grupo de discos ASM para arquivos de dados e a opção --fraDestination para especificar o grupo de discos ASM para o FRA. Você também pode definir o tamanho FRA com a opção --fraSizeInMB.

P: Posso configurar a TDE (Transparent Data Encryption) durante a criação do banco de dados?

R: Sim, você pode configurar a TDE usando a opção --tdeConfigMethod. Os valores válidos são FILE (para criptografia baseada em arquivo) ou KMS (para usar o Oracle Key Management Service). Se estiver usando o KMS, forneça o OCID da chave do KMS com a opção --kmsKeyOCID.

P: Como crio o banco de dados em uma lista específica de nós?

A: Use a opção --nodeList para especificar uma lista de nós separados por vírgulas em que o banco de dados deve ser criado.

P: Como posso retomar ou reverter uma tentativa anterior de criação de banco de dados?

A: Use a opção --resume para retomar a execução anterior ou a opção --revert para fazer rollback da execução anterior. Você também pode especificar um --sessionID para retomar ou reverter uma sessão específica.

P: O que a opção --executePrereqs faz?

A: A opção --executePrereqs só executa os pré-requisitos para a operação de criação do banco de dados, sem realmente criar o banco de dados. Use yes ou no para ativar ou desativar essa opção.

P: Posso especificar um modelo DBCA personalizado para a criação do banco de dados?

R: Sim, use a opção --dbcaTemplateFilePath para fornecer o caminho absoluto do arquivo de modelo DBCA que deve ser usado para criar o banco de dados.

P: Posso executar a operação de criação do banco de dados em segundo plano?

R: Sim, você pode usar a opção --waitForCompletion para especificar se o comando deve aguardar a conclusão da criação do banco de dados (true) ou executar a operação em segundo plano (false).

P: O que acontece se eu não especificar a opção --dbUniqueName?

R: Se você não especificar um nome exclusivo para o banco de dados usando --dbUniqueName, o sistema gerará automaticamente um nome com base no --dbName fornecido.

P: Posso bloquear a conta de administrador do PDB durante a criação de um CDB?

R: Sim, você pode usar a opção --lockPDBAdminAccount e defini-la como verdadeira para bloquear a conta de administrador do PDB após a criação do banco de dados. Por default, este valor é definido como true.

Exemplo 6-12 dbaascli database create

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

dbaascli database delete

Para excluir um Oracle Database, use o comando dbaascli database delete.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli database delete --dbname <value>
[--deleteArchiveLogs <value>]
[--deleteBackups <value>]
[--precheckOnly <value>]
[--waitForCompletion <value>]
[--force]
[--dbSID <value>]
[--resume [--sessionID <value>]]
Em que:
  • --dbname especifica o nome do banco de dados.
  • --deleteArchiveLogs especifica true ou false para indicar a exclusão de logs de arquivamento do banco de dados.
  • --deleteBackups especifica true ou false para indicar a exclusão de backups de banco de dados.
  • --precheckOnly especifica yes para só executar as pré-verificações desta operação. Valores válidos: yes ou no.
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true ou false.
  • Flag –-force para forçar a exclusão do banco de dados.
  • --dbSID especifique o SID do banco de dados.
  • --resume para retomar a execução anterior.
  • --sessionID para retomar um id de sessão específico.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database delete?

R: O comando dbaascli database delete é usado para excluir um Oracle Database no Exadata Cloud Infrastructure.

P: Como especifico o banco de dados que desejo excluir?

A: Use a opção --dbname para especificar o nome do Oracle Database que você deseja excluir. Por exemplo:

dbaascli database delete --dbname <db_name>

P: Como excluo os logs de arquivamento ao excluir um banco de dados?

R: Você pode excluir os logs de arquivamento definindo a opção --deleteArchiveLogs como true. Por exemplo:

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

P: Também posso excluir backups ao excluir o banco de dados?

R: Sim, use a opção --deleteBackups e defina-a como verdadeira para excluir todos os backups associados. Por exemplo:

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

P: Como posso executar apenas as pré-verificações da operação de exclusão sem realmente excluir o banco de dados?

R: Você pode usar a opção --precheckOnly e defini-la como sim para executar as pré-verificações sem excluir o banco de dados. Por exemplo:

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

P: Como faço para forçar a exclusão de um banco de dados?

A: Para forçar a exclusão de um banco de dados, use o flag --force. Isso ignora as verificações e força o processo de exclusão. Por exemplo:

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

P: Como faço para executar a operação de exclusão em segundo plano?

A: Use a opção --waitForCompletion e defina-a como false para executar a operação em segundo plano. Por exemplo:

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

P: Posso especificar o SID do banco de dados que quero excluir?

R: Sim, você pode especificar o SID do banco de dados usando a opção --dbSID. Por exemplo:

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

P: Como retomo uma operação de exclusão interrompida anteriormente?

A: Para retomar uma execução de exclusão anterior, use a opção --resume. Você também pode especificar um ID de sessão usando a opção --sessionID, se necessário. Por exemplo:

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

P: Quais privilégios de usuário são necessários para executar o comando dbaascli database delete?

A: O comando deve ser executado como o usuário root.

P: O que a opção --precheckOnly faz no comando dbaascli database delete?

A: A opção --precheckOnly permite que você execute apenas as pré-verificações da operação de exclusão sem realmente excluir o banco de dados. Ele garante que todas as verificações sejam aprovadas antes de continuar com a exclusão real.

P: Posso excluir um banco de dados sem aguardar a conclusão da operação?

R: Sim, definindo a opção --waitForCompletion como falsa, a operação de exclusão será executada em segundo plano e você não precisará esperar que ela seja concluída.

Exemplo 6-13 dbaascli database delete

dbaascli database delete --dbname db19

dbaascli database deleteInstance

Para excluir a instância do banco de dados no nó especificado, use o comando dbaascli database deleteInstance.

Pré-requisito

  • Execute o comando como usuário root.

Sintaxe

dbaascli database deleteInstance --dbname <value> --node <value> [--continueOnUnreachableNode]
Em que:
  • --dbname especifica o nome do Oracle Database
  • --node especifica o nome do nó para a instância do banco de dados
  • --continueOnUnreachableNode especifica para executar a operação mesmo que o nó não esteja acessível

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database deleteInstance?

R: O comando dbaascli database deleteInstance é usado para excluir uma instância específica do Oracle Database em um nó especificado em um ambiente do Exadata Cloud Infrastructure.

P: Como especifico qual instância do Oracle Database excluir?

R: Você pode especificar a instância do Oracle Database a ser excluída usando a opção --dbname para fornecer o nome do banco de dados e a opção --node para fornecer o nome do nó. Por exemplo:

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

P: Posso excluir a instância mesmo que o nó esteja inacessível?

R: Sim, você pode usar a opção --continueOnUnreachableNode para continuar com a exclusão, mesmo que o nó especificado esteja inacessível. Por exemplo:

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

P: O que acontece se o nó especificado estiver inacessível durante a operação de exclusão da instância?

R: Se o nó estiver inacessível e a opção --continueOnUnreachableNode não for usada, a operação falhará. Se a opção for usada, a operação continuará mesmo que o nó não possa ser acessado.

P: Como excluo uma instância de banco de dados de um nó específico?

A: Use o seguinte comando para excluir uma instância de banco de dados de um nó específico:

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

P: Quais privilégios de usuário são necessários para executar o comando dbaascli database deleteInstance?

A: O comando deve ser executado como o usuário root.

P: Posso excluir uma instância sem especificar o nó?

R: Não, a opção --node é necessária para especificar de qual nó a instância do banco de dados deve ser excluída.

P: O que a opção --continueOnUnreachableNode faz?

R: A opção --continueOnUnreachableNode permite que a operação prossiga mesmo que o nó especificado não possa ser atingido, garantindo que a exclusão da instância continue em cenários em que o nó possa estar inativo.

P: É possível excluir várias instâncias de banco de dados de uma só vez usando este comando?

R: Não, o comando dbaascli database deleteInstance é usado para excluir uma única instância de banco de dados em um nó especificado de cada vez. Você precisaria executar o comando separadamente para cada instância que deseja excluir.

Exemplo 6-14 database deleteinstance

database deleteinstance --node test-node

dbaascli database duplicate

Para criar um banco de dados com base em um banco de dados ativo, use o comando dbaascli database duplicate.

Pré-requisito

  • Execute o comando como usuário root.

Sintaxe

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>]
Em que:
  • --dbName especifica o nome do Oracle Database
  • --sourceDBConnectionString especifica a string de conexão do banco de dados de origem no formato <scan_name>:<scan_port>/<database_service_name>
  • --oracleHome especifica o local do Oracle home
  • --oracleHomeName especifica o nome do Oracle home
  • --dbSID especifica o SID do banco de dados
  • --dbUniqueName especifica o nome exclusivo do banco de dados
  • --sgaSizeInMB especifica o valor sga_target na unidade de megabyte
  • --pgaSizeInMB especifica o valor pga_aggregate_target na unidade de megabyte
  • --datafileDestination especifica o nome do grupo de discos do ASM a ser usado para arquivos de dados do banco de dados
  • --fraDestination especifica o nome do grupo de discos do ASM a ser usado para a área de recuperação rápida do banco de dados
  • --fraSizeInMB especifica o valor do tamanho da área de recuperação rápida em unidade de megabyte
  • --sourceDBWalletLocation especifica a localização do arquivo da wallet de TDE do banco de dados de origem. Isso é necessário para duplicar o banco de dados do banco de dados ativo
  • --nodeList especifica uma lista de nós delimitados por vírgulas para o banco de dados
  • --resume especifica para retomar a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --revert especifica para fazer rollback da execução anterior
    • --sessionID especifica para fazer rollback de um ID de sessão específico
  • --rmanParallelism especifica o valor do paralelo
  • --rmanSectionSizeInGB especifica o tamanho da seção do RMAN em GB
  • --tdeConfigMethod especifica o método de configuração de TDE. Os valores permitidos são FILE e KMS.
  • --kmsKeyOCID especifica o OCID da chave KMS a ser usado para TDE. Isso só será aplicável se o KMS for selecionado para TDE.
  • --sourceDBTdeConfigMethod especifica o método de configuração de TDE do banco de dados de origem. Os valores permitidos são FILE e KMS.
  • --sourceDBKmsKeyOCID especifica o OCID da chave KMS do banco de dados de origem a ser usado para TDE. Isso só será aplicável se o KMS for selecionado para TDE.
  • --executePrereqs especifica yes para só executar os pré-requisitos desta operação. Valores válidos: yes|no
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true|false
  • --skipPDBs especifica uma lista delimitada por vírgulas de nomes de PDB do banco de dados de origem, que precisa ser excluída da operação de banco de dados duplicada. Exemplo: pdb1,pdb2...

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database duplicate?

R: O comando dbaascli database duplicate é usado para criar um novo Oracle Database duplicando um banco de dados ativo existente.

P: Quais são os pré-requisitos para usar o comando duplicado do banco de dados dbaascli?

R: Execute o comando como usuário root.

P: Como especificar o banco de dados de origem para duplicação?

A: Use a opção --sourceDBConnectionString para fornecer a string de conexão do banco de dados de origem no formato <scan_name>:<scan_port>/<database_service_name>. Por exemplo:

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

P: Como especifico o local do Oracle Home para o novo banco de dados?

R: Você pode especificar o local do Oracle Home usando a opção --oracleHome ou o nome do Oracle Home usando a opção --oracleHomeName. Por exemplo:

--oracleHome <value>

ou

--oracleHomeName <value>

P: Qual é a finalidade da opção --sourceDBWalletLocation?

A: A opção --sourceDBWalletLocation especifica o local do arquivo da wallet de TDE do banco de dados de origem, que é necessário para duplicar o banco de dados de um banco de dados de origem ativo.

P: Posso ignorar a duplicação de PDBs específicos do banco de dados de origem?

R: Sim, você pode usar a opção --skipPDBs para especificar uma lista delimitada por vírgulas de nomes de PDB que devem ser excluídos da operação duplicada. Por exemplo:

--skipPDBs pdb1,pdb2

P: Como configuro a TDE para o novo banco de dados?

A: Use a opção --tdeConfigMethod para especificar o método de configuração de TDE (FILE ou KMS). Se você escolher KMS, poderá fornecer o OCID da chave KMS usando a opção --kmsKeyOCID. Por exemplo:

--tdeConfigMethod FILE

ou

--tdeConfigMethod KMS --kmsKeyOCID <value>

P: O que a opção --executePrereqs faz?

A: A opção --executePrereqs especifica se apenas as verificações de pré-requisito devem ser executadas para a operação. Os valores válidos são yes para executar somente pré-requisitos ou no para continuar com a operação completa.

P: Como posso retomar uma operação duplicada interrompida anteriormente?

A: Use a opção --resume junto com a opção --sessionID para retomar uma operação duplicada interrompida anteriormente. Por exemplo:

--resume --sessionID <value>

P: O que a opção --waitForCompletion faz?

A: A opção --waitForCompletion especifica se a operação deve ser concluída. A definição dessa opção como true aguarda conclusão, enquanto false executa a operação em segundo plano. Por exemplo:

--waitForCompletion true

P: Qual é a finalidade da opção --rmanParallelism?

A: A opção --rmanParallelism especifica o valor de paralelismo do RMAN (Recovery Manager) durante o processo de duplicação. Isso pode melhorar a velocidade da operação de duplicação usando vários processos paralelos.

P: Como especifico o tamanho da SGA e da PGA para o novo banco de dados?

R: Use as opções --sgaSizeInMB e --pgaSizeInMB para especificar os tamanhos da SGA (Área Global do Sistema) e da PGA (Área Global do Programa) em megabytes, respectivamente. Por exemplo:

--sgaSizeInMB <value>

--pgaSizeInMB <value>

P: O que a opção --revert faz?

A: A opção --revert é usada para fazer rollback de uma operação duplicada anterior. Você precisa fornecer o --sessionID para especificar qual sessão reverter.

Exemplo 6-15 dbaascli database duplicate

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

dbaascli database getDetails

Esse comando mostra as informações detalhadas de um determinado banco de dados, por exemplo, dbname, informações do nó, informações de bancos de dados plugáveis etc.

Pré-requisitos

Execute o comando como usuário root ou o usuário oracle

Sintaxe

dbaascli database getDetails --dbname <value>
Em que:
  • --dbname - corresponde ao nome do banco de dados Oracle.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database getDetails?

R: O comando dbaascli database getDetails mostra informações detalhadas sobre um banco de dados Oracle especificado, incluindo o nome do banco de dados, as informações do nó e os detalhes do banco de dados plugável (PDB).

P: Quem pode executar o comando dbaascli database getDetails?

R: O comando pode ser executado pelo usuário root ou pelo usuário oracle.

P: O que a opção --dbname especifica no comando dbaascli database getDetails?

A: A opção --dbname especifica o nome do banco de dados Oracle para o qual informações detalhadas estão sendo recuperadas.

P: Que tipo de informação o comando dbaascli database getDetails fornece?

R: O comando fornece detalhes como nome do banco de dados, informações do nó e informações sobre bancos de dados plugáveis (PDBs) associados ao banco de dados contêiner.

dbaascli database getPDBs

Para exibir a lista de todos os bancos de dados plugáveis em um banco de dados contêiner, use o comando dbaascli database getPDBs.

Execute o comando como o usuário root ou oracle.

Sintaxe

dbaascli database getPDBs --dbname <value>
Em que:
  • --dbname especifica o nome do banco de dados contêiner

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database getPDBs?

R: O comando dbaascli database getPDBs é usado para listar todos os bancos de dados plugáveis (PDBs) em um banco de dados contêiner (CDB) especificado.

P: Como especifico o banco de dados contêiner para o comando getPDBs?

A: Você usa a opção --dbname para especificar o nome do banco de dados contêiner. Por exemplo:

--dbname <value>

P: Eu preciso executar o comando dbaascli database getPDBs como um usuário específico?

R: Sim, você deve executar o comando como o usuário root ou o usuário oracle.

P: Posso exibir PDBs em um banco de dados não CDB usando o comando getPDBs?

R: Não, o comando getPDBs só é aplicável a bancos de dados contêineres (CDBs). Não é possível usar esse comando para bancos de dados não CDB.

P: Qual é o formato da saída do comando dbaascli database getPDBs?

R: O comando retorna uma lista de todos os PDBs dentro do banco de dados contêiner especificado. A saída geralmente inclui nomes de PDB, status e outros detalhes relevantes sobre cada banco de dados plugável.

P: Este comando pode ser usado para vários bancos de dados de uma só vez?

R: Não, o comando dbaascli database getPDBs funciona com um único banco de dados contêiner por vez, especificado pela opção --dbname.

P: É necessário fazer shutdown do banco de dados para usar o comando getPDBs?

R: Não, o comando getPDBs não requer que o banco de dados seja submetido a shutdown. Ele pode ser executado enquanto o banco de dados contêiner está operacional.

Exemplo 6-16 dbaascli database getPDBs --dbname

dbaascli database getPDBs --dbname apr_db1

dbaascli database modifyParameters

Para modificar ou redefinir os parâmetros de inicialização de um Banco de Dados Oracle, use o comando dbaascli database modifyParameters.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli database modifyParameters --dbname <value> 
{
--setParameters <values>[--instance <value>] [--backupPrepared] [--allowBounce]|
--resetParameters <values> [--instance <value>] [--backupPrepared] [--allowBounce]
}
--responseFile
[--backupPrepared]
[--instance]
[--allowBounce]
[--waitForCompletion]
Em que:
  • --dbname especifica o nome do banco de dados.
  • --setParameters especifica uma lista de parâmetros delimitados por vírgulas a serem modificados com novos valores. Por exemplo: parameter1=valueA,parameter2=valueB e assim por diante. Para valores em branco, use parameter1=valueA,parameter2='',etc.
  • --resetParameters especifica uma lista de parâmetros delimitados por vírgulas a serem redefinidos para seus valores padrão correspondentes. Por exemplo, parameter1,parameter2 e assim por diante.
  • --instance especifica o nome da instância na qual os parâmetros serão processados. Se não for especificado, a operação será executada no nível do banco de dados.
  • --backupPrepared confirma que há um backup adequado do banco de dados antes de modificar parâmetros críticos ou confidenciais.
  • --allowBounce concede permissão para devolver o banco de dados a fim de refletir as alterações nos parâmetros estáticos aplicáveis.
  • --waitForCompletion especifique false para executar a operação em segundo plano. Valores válidos : true|false.]

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database modifyParameters?

A: O comando dbaascli database modifyParameters é usado para modificar ou redefinir parâmetros de inicialização do Oracle Database.

P: Como eu especifico o banco de dados cujos parâmetros eu quero modificar?

R: Você deve usar a opção --dbname para especificar o nome do banco de dados para o qual deseja modificar ou redefinir parâmetros.

P: Como posso modificar os parâmetros do banco de dados usando o comando modifyParameters?

A: Use a opção --setParameters seguida de uma lista de parâmetros delimitados por vírgulas e seus novos valores. Por exemplo:

--setParameters parameter1=valueA,parameter2=valueB

P: Como redefino parâmetros para seus valores padrão usando este comando?

A: Use a opção --resetParameters seguida de uma lista de parâmetros delimitados por vírgulas para redefinir seus valores padrão. Por exemplo:

--resetParameters parameter1,parameter2

P: Posso modificar parâmetros usando um arquivo de resposta?

R: Sim, você pode especificar a localização absoluta de um arquivo JSON de resposta usando a opção --responseFile. O arquivo deve conter os parâmetros que você deseja modificar.

P: É necessário fazer um backup antes de modificar os parâmetros?

R: Embora não seja obrigatório para todas as alterações, se você estiver modificando parâmetros críticos ou confidenciais, é recomendável ter um backup em vigor. Você pode usar a opção --backupPrepared para confirmar que um backup foi preparado.

P: Posso aplicar alterações apenas a uma instância específica em um banco de dados de várias instâncias?

R: Sim, você pode especificar o nome da instância usando a opção --instance. Se esta opção não for usada, as alterações serão aplicadas no nível do banco de dados.

P: O banco de dados precisará ser devolvido (reiniciado) após a modificação dos parâmetros?

R: Para alguns parâmetros estáticos, é necessário um bounce do banco de dados. Você pode usar a opção --allowBounce para conceder permissão para que o banco de dados seja devolvido, se necessário.

P: O que acontece se eu não permitir que o banco de dados seja devolvido ao alterar parâmetros estáticos?

R: Se você não usar a opção --allowBounce ao modificar parâmetros estáticos, as alterações não entrarão em vigor até a próxima reinicialização manual do banco de dados.

P: Posso retomar a modificação de parâmetros se uma sessão anterior foi interrompida?

R: Não, este comando não suporta a retomada da sessão. Você precisará executar o comando novamente desde o início.

Exemplo 6-17 dbaascli database modifyParameters

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

dbaascli database move

Para mover o banco de dados de um home para outro, use o comando dbaascli database move.

Pré-requisitos

  • Antes de executar uma operação de movimentação, certifique-se de que todas as instâncias associadas do banco de dados estejam ativas e em execução.
  • Execute o comando como usuário root.

Sintaxe

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

Em que:

  • --oracleHome especifica o caminho do Oracle home
  • --oracleHomeName especifica o nome do Oracle home
  • --dbname especifica o nome do banco de dados
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --rollback faz rollback do banco de dados para o home anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --skipDatapatch ignora a execução do datapatch nos bancos de dados
  • --skipPdbs ignora a execução do datapatch em uma lista especificada de PDBs delimitados por vírgulas. Por exemplo: pdb1,pdb2...
  • --skipClosedPDBs ignora a aplicação de patch em PDBs fechados
  • --continueWithDbDowntime continua aplicando patch com tempo de inatividade do banco de dados. Essa opção pode ser usada em ambientes nos quais só há uma instância ativa e a operação de aplicação de patch pode continuar mesmo com um tempo de inatividade.
  • --allowParallelDBMove permite que o banco de dados seja movido em paralelo.
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true|false
  • --nodeList especifica uma lista de nós delimitados por vírgulas se a operação precisar ser executada em um subconjunto de nós

Perguntas Frequentes

P: Para que é usado o comando dbaascli database move?

R: O comando dbaascli database move é usado para mover um banco de dados de um Oracle home para outro.

P: Quais são os pré-requisitos para usar o comando dbaascli database move?

R: Antes de executar uma operação de movimentação, verifique se todas as instâncias associadas do banco de dados estão ativas e em execução. Além disso, o comando deve ser executado como o usuário root.

P: O que o parâmetro --oracleHome especifica?

A: O parâmetro --oracleHome especifica o caminho do Oracle home para o qual o banco de dados será movido.

P: O que o parâmetro --oracleHomeName especifica?

A: O parâmetro --oracleHomeName especifica o nome do Oracle home para o qual o banco de dados será movido.

P: Qual é a finalidade do parâmetro --dbname?

A: O parâmetro --dbname especifica o nome do banco de dados que você deseja mover.

P: O que a opção --executePrereqs faz?

A: A opção --executePrereqs executa as verificações de pré-requisitos e reporta os resultados.

P: Para que é usada a opção --resume?

A: A opção --resume retoma uma operação de movimentação interrompida ou incompleta anteriormente.

P: Como --sessionID é usado no comando?

A: O --sessionID especifica o ID da sessão para retomar uma execução ou rollback anterior.

P: O que a opção --rollback faz?

A: A opção --rollback faz rollback do banco de dados para seu Oracle home anterior.

P: O que a opção --skipDatapatch faz?

A: A opção --skipDatapatch ignora a execução do datapatch nos bancos de dados durante a operação de movimentação.

P: Qual é a função da opção --skipPDBs?

A: A opção --skipPDBs ignora a execução do datapatch em uma lista especificada de PDBs (por exemplo, pdb1, pdb2).

P: O que a opção --skipClosedPDBs faz?

A: A opção --skipClosedPDBs ignora a aplicação de patches de PDBs fechados.

P: O que significa --continueWithDbDowntime?

R: A opção --continueWithDbDowntime permite que a operação de movimentação prossiga mesmo que haja apenas uma instância ativa ativa, permitindo tempo de inatividade durante o processo.

P: Qual é a finalidade da opção --allowParallelDBMove?

A: A opção --allowParallelDBMove permite que a movimentação do banco de dados seja executada em paralelo, potencialmente acelerando o processo.

P: O que --waitForCompletion especifica?

A: A opção --waitForCompletion especifica se a operação deve ser concluída. Definir como falso executa a operação em segundo plano.

P: Como posso usar o parâmetro --nodeList?

R: O parâmetro --nodeList especifica uma lista de nós delimitados por vírgulas nos quais a operação de movimentação será executada, se não for aplicada a todos os nós.

P: O que devo fazer se encontrar problemas com o comando dbaascli database move?

R: Certifique-se de que todas as instâncias do banco de dados estejam em execução e verifique se você está executando o comando como o usuário root. Se os problemas persistirem, consulte a documentação de comando detalhada ou abra um ticket de suporte com a Oracle.

P: Posso executar uma operação de movimentação se uma das instâncias do banco de dados estiver inativa?

R: Não, todas as instâncias de banco de dados associadas devem estar ativas e em execução antes de executar a operação de movimentação.

P: O que acontece se a operação de movimentação for interrompida?

R: Você pode usar a opção --resume para continuar a operação de movimentação de onde parou usando a mesma sessão ou especificando --sessionID.

P: O que a opção --allowParallelDBMove faz?

R: Permite que a movimentação do banco de dados seja executada em paralelo, o que pode reduzir o tempo necessário para concluir a operação, especialmente em ambientes maiores.

P: Como monitoro o andamento de uma operação de movimentação que está sendo executada em segundo plano?

R: Ao usar --waitForCompletion false, o comando não aguarda a conclusão da operação. Você pode verificar o status da operação manualmente usando os logs ou comandos de status apropriados da Oracle.

P: Qual é o significado da opção --skipClosedPDBs?

R: Ele ignora a aplicação de patches para PDBs fechados, reduzindo o tempo de operação se houver PDBs que não precisem de aplicação de patch.

P: A movimentação do banco de dados pode ser revertida a qualquer momento?

R: Sim, a operação de movimentação pode ser submetida a rollback usando a opção --rollback, especificando o ID da sessão ou simplesmente fazendo rollback para o Oracle home anterior.

P: Qual é a função de --nodeList em um ambiente com vários nós?

R: Em um ambiente com vários nós, você pode restringir a operação de movimentação a nós específicos fornecendo uma lista delimitada por vírgulas de nomes de nós com --nodeList.

P: Posso mover o banco de dados para um novo Oracle home ao ignorar nós específicos em um ambiente com vários nós?

R: Sim, você pode usar a opção --nodeList para especificar quais nós incluir na operação de movimentação. Todos os nós não listados serão ignorados.

P: Qual é o número máximo de nós que posso especificar com o parâmetro --nodeList?

R: O parâmetro --nodeList permite especificar uma lista delimitada por vírgulas de quantos nós forem necessários, limitada apenas pela configuração do seu ambiente. Certifique-se de que todos os nós sejam válidos e acessíveis.

P: Como sei quais PDBs estão fechados antes de usar a opção --skipClosedPDBs?

R: Você pode consultar a view v$pdbs para verificar o status de seus PDBs. Todos os PDBs com um status de "MOUNTED" ou "CLOSED" serão ignorados ao usar --skipClosedPDBs.

P: Como verifico se um rollback foi concluído com sucesso?

R: Após executar o comando de rollback, você pode revisar os logs do banco de dados ou usar os logs de alerta da Oracle para verificar se o banco de dados foi submetido a rollback com sucesso para seu Oracle home anterior.

P: Existe uma maneira de forçar a operação de movimentação se alguns pré-requisitos falharem?

R: O comando move impõe verificações de pré-requisitos para a estabilidade do sistema. Não é possível ignorar falhas críticas de pré-requisitos. Resolva todos os problemas reportados pela opção --executePrereqs antes de prosseguir com a movimentação.

Exemplo de Casos de Uso

Exemplo 1: Movimentação Básica do Banco de Dados pelo Caminho do Oracle Home

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL

Move o banco de dados ORCL para o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.

Exemplo 2: Movimentação do Banco de Dados pelo Nome do Oracle Home

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL

Move o banco de dados ORCL para o Oracle home chamado DB_HOME_NAME.

Exemplo 3: Executando Verificações de Pré-requisitos Antes de Mover

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --executePrereqs

Move o banco de dados ORCL para o Oracle home ao executar as verificações de pré-requisitos de antemão.

Exemplo 4: Retomando uma Operação de Movimentação Anterior

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --resume

Retoma uma operação de movimentação anterior para o banco de dados ORCL.

Exemplo 5: Retomando uma Operação de Movimentação com um ID de Sessão Específico

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --resume --sessionID 12345

Retoma a operação de movimentação do banco de dados ORCL usando o ID de sessão 12345.

Exemplo 6: Fazendo Rollback de uma Operação de Movimentação

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --rollback

Faz rollback da operação de movimentação do banco de dados ORCL, restaurando-a para o Oracle home anterior.

Exemplo 7: Fazendo Rollback de uma Operação de Movimentação com um ID de Sessão

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --rollback --sessionID 67890

Faz rollback da operação de movimentação para ORCL usando o ID da sessão 67890.

Exemplo 8: Ignorando Datapatch

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipDatapatch

Move o banco de dados ORCL sem executar o datapatch nos bancos de dados.

Exemplo 9: Ignorando PDBs Específicos Durante o Datapatch

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipPDBs pdb1,pdb2

Move o banco de dados ORCL para um novo Oracle home, mas ignora a execução do patch de dados nos PDBs especificados (pdb1 e pdb2).

Exemplo 10: Ignorando o Datapatch em PDBs Fechados

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipClosedPDBs

Move o banco de dados ORCL e ignora a execução do patch de dados em qualquer PDB fechado.

Exemplo 11: Permitindo o Tempo de Inatividade do Banco de Dados Durante a Movimentação

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --continueWithDbDowntime

Move o banco de dados ORCL para o Oracle home especificado, permitindo o tempo de inatividade do banco de dados durante o processo de movimentação.

Exemplo 12: Movendo o Banco de Dados em Paralelo

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --allowParallelDBMove

Move o banco de dados ORCL para o Oracle home especificado com a opção de executar a movimentação em paralelo para obter melhor desempenho.

Exemplo 13: Executando a Operação em Segundo Plano

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --waitForCompletion false

Move o banco de dados ORCL para um novo Oracle home, mas executa a operação em segundo plano.

Exemplo 14: Especificando Nós para a Movimentação

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --nodeList node1,node2

Move o banco de dados ORCL para o Oracle home especificado, mas executa a operação somente em node1 e node2.

Exemplo 15: Combinação de Movimentação com Verificações de Pré-requisitos, Ignorando PDBs Específicos e Permitindo Período de Indisponibilidade

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --executePrereqs --skipPDBs pdb1 --continueWithDbDowntime

Move o banco de dados ORCL para o Oracle home especificado, executa verificações de pré-requisitos, ignora a execução do datapatch em pdb1 e permite o tempo de inatividade do banco de dados durante a operação.

Exemplo 16: Combinação de Movimentação em Paralelo e Execução em Segundo Plano

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --allowParallelDBMove --waitForCompletion false

Move o banco de dados ORCL para um novo Oracle home, executa a movimentação em paralelo e executa a operação em segundo plano.

Exemplo 17: Combinando Movimentação com Execução Paralela e Ignorando PDBs Fechados

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname TESTDB --allowParallelDBMove --skipClosedPDBs

Move o banco de dados TESTDB para o novo Oracle home /u02/app/oracle/product/19.0.0/dbhome_2, enquanto executa a operação em paralelo e ignora o datapatch em PDBs fechados.

Exemplo 18: Executando Somente Verificação de Pré-requisitos

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname PRODDB --executePrereqs

Verifica os pré-requisitos para mover o banco de dados PRODDB para o Oracle home localizado em /u02/app/oracle/product/19.0.0/dbhome_2 sem realmente executar a movimentação.

Exemplo 19: Ignorando o Datapatch para PDBs Específicos

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname HRDB --skipPDBs pdb1,pdb3

Move o banco de dados HRDB para o novo Oracle home, mas ignora a execução do datapatch para pdb1 e pdb3.

Exemplo 20: Executando a Movimentação em Nós Específicos

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname FINDB --nodeList node1,node3

Move o banco de dados FINDB para o novo Oracle home somente em node1 e node3.

Exemplo 21: Movimentação do Banco de Dados com Tempo de Inatividade Permitido

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --continueWithDbDowntime

Move o banco de dados ORCL para o Oracle home especificado, permitindo tempo de inatividade durante a operação de movimentação.

Exemplo 22: Combinação de Movimentação Paralela e Ignorando Datapatch

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname CRMDB --allowParallelDBMove --skipDatapatch

Move o banco de dados CRMDB em paralelo, ignorando o processo datapatch.

Exemplo 23: Operação de Movimentação em Segundo Plano com uma Lista de Nós

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname SALESDB --waitForCompletion false --nodeList node2,node3

Move o banco de dados SALESDB para o Oracle home especificado em segundo plano, e a operação só é aplicada em node2 e node3.

Exemplo 24: Movimentação do Banco de Dados com Verificação de Pré-requisito e Permissão de Movimentação Paralela

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_2 --dbname ORCL --executePrereqs --allowParallelDBMove

Move o banco de dados ORCL para o novo Oracle home após executar as verificações de pré-requisitos e executar a operação de movimentação em paralelo.

Exemplo 25: Fazendo Rollback de uma Operação de Movimentação e Ignorando PDBs Fechados

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname DEVDB --rollback --skipClosedPDBs

Faz rollback da operação de movimentação do banco de dados DEVDB, ignorando quaisquer PDBs fechados.

Exemplo 26: Movendo o Banco de Dados com Tempo de Inatividade Específico e Execução Paralela

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname FINDB --allowParallelDBMove --continueWithDbDowntime

Move o banco de dados FINDB para o Oracle home especificado, permitindo tempo de inatividade do banco de dados e permitindo a execução paralela para acelerar o processo.

Exemplo 27: Verificando Pré-requisitos de Movimentação do Banco de Dados sem Executar a Movimentação

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname HRDB --executePrereqs

Executa verificações de pré-requisitos para validar se o banco de dados HRDB pode ser movido para o Oracle home especificado sem executar a movimentação propriamente dita.

Exemplo 28: Movendo o Banco de Dados e Executando o Comando em Segundo Plano em Nós Específicos

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_3 --dbname PRODDB --waitForCompletion false --nodeList node1,node4

Move o banco de dados PRODDB para um novo Oracle home, executando a operação em segundo plano e aplicando-a apenas em node1 e node4.

Exemplo 29: Combinando Verificações de Pré-requisitos, Ignorando PDBs Fechados e Permitindo Execução Paralela

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname CRMDB --executePrereqs --skipClosedPDBs --allowParallelDBMove

Executa verificações de pré-requisitos antes de mover o banco de dados CRMDB para o novo Oracle home, ignora a aplicação de patches em PDBs fechados e permite que a operação seja executada em paralelo para uma execução mais rápida.

Exemplo 30: Movimentação do Banco de Dados com Rollback em um ID de Sessão Específico e Ignorando o Datapatch

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname DEVDB --rollback --sessionID 45678 --skipDatapatch

Faz rollback de uma operação de movimentação executada anteriormente para o banco de dados DEVDB para seu Oracle home anterior usando o ID da sessão 45678, ignorando o processo datapatch durante o rollback.

Exemplo 31: Movendo o Banco de Dados com Permitir Execução Paralela e Especificando o Ignoramento de Datapatch para PDBs

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_3 --dbname ANALYTICDB --allowParallelDBMove --skipPDBs pdb2,pdb4

Move o banco de dados ANALYTICDB em paralelo ao Oracle home especificado e ignora o processo datapatch para pdb2 e pdb4.

dbaascli database recovery

Para recuperar um banco de dados, use o comando dbaascli database recover.

Pré-requisito

  • Execute o comando como usuário root.
  • O banco de dados deve ter sido configurado com detalhes do destino de armazenamento de backup em que os backups são armazenados.

Sintaxe

dbaascli database recover --dbname <value>
        {
            --start
                {
                    --untilTime <value>
                    | --untilSCN <value>
                    | --latest
                    | --tag <value>
                }
            | --status --uuid <value>
        }
Em que:
--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>

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database recovery?

R: O comando dbaascli database recover é usado para recuperar um Oracle Database de backups armazenados em um destino de armazenamento de backup.

P: Como especificar qual banco de dados recuperar?

R: Você pode especificar o banco de dados que deseja recuperar usando a opção --dbname seguida pelo nome do banco de dados. Por exemplo:

--dbname <database_name>

P: Quais são as opções de recuperação disponíveis com o comando dbaascli database recovery?

A: As opções de recuperação são:

--untilTime: Recupere o banco de dados para um horário específico.

--untilSCN: Recupere o banco de dados para um SCN (Número de Alteração do Sistema) específico.

--latest: Recupere o banco de dados para o último estado conhecido.

--tag: Recupere o banco de dados usando uma tag de arquivamento.

P: Como recupero o banco de dados em um horário específico?

A: Use a opção --untilTime seguida pela hora no formato DD-MON-YYYY HH24:MI:SS. Por exemplo:

--untilTime 05-SEP-2024 15:30:00

P: Como recupero o banco de dados para um SCN específico?

A: Use a opção --untilSCN seguida pelo valor SCN. Por exemplo:

--untilSCN 123456789

P: Como posso recuperar o banco de dados para o estado mais recente conhecido?

R: Use a opção --latest para recuperar o banco de dados para o estado mais recente possível. Por exemplo:

--latest

P: Qual é o uso da opção --tag no processo de recuperação?

A: A opção --tag permite recuperar o banco de dados usando uma tag de arquivamento associada aos backups. Por exemplo:

--tag <backup_tag>

P: Como posso verificar o status de uma operação de recuperação?

R: Use a opção --status junto com o valor --uuid para verificar o status de uma operação de recuperação em andamento ou anterior. Por exemplo:

--status --uuid <recovery_uuid>

P: O que a opção --start faz no processo de recuperação?

A: A opção --start inicia a operação de recuperação com base no método de recuperação selecionado (--untilTime, --untilSCN, --latest ou --tag).

P: Existe uma maneira de recuperar o banco de dados sem especificar um horário ou SCN?

R: Sim, você pode recuperar o banco de dados para seu último estado conhecido usando a opção --latest, que não requer a especificação de um horário ou SCN.

P: Posso realizar uma recuperação parcial?

R: Sim, você pode recuperar o banco de dados para um ponto específico no tempo ou SCN usando as opções --untilTime ou --untilSCN, respectivamente.

Exemplo 6-18 Exemplos

  • Para recuperar o banco de dados myTestDb para o mais recente:
    dbaascli database recover --dbname myTestDb --start --latest
  • Para consultar o status da solicitação de recuperação submetida com uuid 2508ea18be2911eb82d0020017075151:
    dbaascli database recover --dbname myTestDb --status --uuid 2508ea18be2911eb82d0020017075151

dbaascli database runDatapatch

Para aplicar patch em um Banco de Dados Oracle, use o comando dbaascli database runDatapatch.

Pré-requisitos

  • Antes de executar uma operação runDatapatch, verifique se todas as instâncias associadas do banco de dados estão em funcionamento.

  • Execute o comando como usuário root.

Sintaxe

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

Em que:

  • --dbname especifica o nome do banco de dados
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --skipPdbs ignora a execução do datapatch em uma lista especificada de PDBs delimitados por vírgulas. Por exemplo: pdb1,pdb2...
  • --pdbs executa o datapatch somente em uma lista delimitada por vírgulas de PDBs especificada. Por exemplo: pdb1,pdb2...
  • --executePrereqs executa verificações de pré-requisitos
  • --patchList aplica ou faz rollback da lista especificada de patches delimitados por vírgulas. Por exemplo: patch1,patch2...
  • --skipClosedPdbs ignora a execução do datapatch em PDBs fechados
  • --rollback faz rollback dos patches aplicados

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database runDatapatch?

R: O comando dbaascli database runDatapatch é usado para aplicar patches a um Oracle Database.

P: O que deve ser garantido antes de executar o comando dbaascli database runDatapatch?

R: Antes de executar o comando, certifique-se de que todas as instâncias do banco de dados estejam ativas e em execução.

P: Como especificar qual banco de dados aplicar patch?

A: Use a opção --dbname seguida pelo nome do banco de dados. Por exemplo:

--dbname myDatabase

P: Como retomo uma operação runDatapatch interrompida anteriormente?

A: Use a opção --resume para retomar a execução anterior ou a opção --sessionID para especificar um ID de sessão específico. Por exemplo:

--resume

--sessionID 12345

P: Como posso ignorar determinados PDBs ao executar o patch?

A: Use a opção --skipPdbs seguida de uma lista delimitada por vírgulas de nomes de PDB a serem ignorados. Por exemplo:

--skipPdbs pdb1,pdb2

P: Como posso executar o patch apenas em determinados PDBs?

A: Use a opção --pdbs seguida de uma lista delimitada por vírgulas de nomes de PDB a serem incluídos. Por exemplo:

--pdbs pdb1,pdb2

P: Como aplicar ou reverter um conjunto específico de patches?

A: Use a opção --patchList seguida de uma lista delimitada por vírgulas de nomes de patch para aplicar ou fazer rollback. Por exemplo:

--patchList patch1,patch2

P: O que a opção --rollback faz?

A: A opção --rollback faz rollback dos patches que foram aplicados durante a operação de aplicação de patch.

P: O que acontece se alguns PDBs forem fechados durante a operação de aplicação de patch?

R: Se alguns PDBs estiverem fechados, você poderá usar a opção --skipClosedPdbs para ignorar a aplicação de patch nesses PDBs fechados.

P: Posso executar verificações de pré-requisitos antes de aplicar patches?

R: Sim, use a opção --executePrereqs para executar verificações de pré-requisitos antes de aplicar o patch.

P: Como descubro qual ID de sessão retomar um patch?

R: Após uma operação runDatapatch, o ID da sessão geralmente é registrado. Use a opção --sessionID para especificar esse ID ao retomar um patch. Por exemplo:

--sessionID 67890

dbaascli database runDatapatch --dbname db19

dbaascli database createTemplate

Para criar modelos de banco de dados (modelos DBCA) que possam ser usados subsequentemente para criar bancos de dados, use o comando dbaascli database createTemplate.

Pré-requisitos:

Execute o comando como usuário root.

Sintaxe

Crie um novo modelo de DBCA com base no banco de dados especificado.

dbaascli database createTemplate --dbname <value> --templateLocation <value> 
[--templateName <value>] 
[--rmanParallelism <value>]
Em que:
  • --dbname especifica o nome do banco de dados.
  • --templateLocation especifica o nome do modelo.
  • --rmanParallelism especifica o valor de paralelismo.

dbaascli database start

Para iniciar um Banco de Dados Oracle, use o comando dbaascli database start.

Pré-requisitos

Execute o comando como usuário root.

Sintaxe

dbaascli database start
[--dbname]
[--mode]
Em que:
  • --dbname especifica o nome do banco de dados
  • --mode especifica montagem ou não montagem para iniciar o banco de dados no modo correspondente

O comando inicia e abre o banco de dados. No Oracle Database 12c ou mais recente, todos os PDBs também são abertos.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database start?

A: O comando dbaascli database start é usado para iniciar um Oracle Database.

P: O que deve ser feito antes de executar o comando dbaascli database start?

A: O comando deve ser executado como o usuário root.

P: Como eu especifico o banco de dados que quero iniciar?

A: Use a opção --dbname seguida pelo nome do banco de dados. Por exemplo:

--dbname myDatabase

P: Quais são os modos possíveis em que posso iniciar o banco de dados?

R: Você pode iniciar o banco de dados no modo mount ou nomount usando a opção --mode. Por exemplo:

--mode mount

P: Qual é o modo padrão se eu não especificar um?

R: Se você não especificar um modo, o banco de dados será iniciado no modo open padrão.

P: Este comando abrirá todos os PDBs no Oracle Database 12c ou posterior?

R: Sim, ao iniciar o banco de dados no Oracle Database 12c ou mais recente, todos os bancos de dados plugáveis (PDBs) também serão abertos.

P: Como posso iniciar um banco de dados no modo nomount?

A: Use a opção --mode e defina-a como nomount. Por exemplo:

--mode nomount

P: Como posso iniciar um banco de dados no modo de montagem?

A: Use a opção --mode e defina-a para montar. Por exemplo:

--mode mount

P: É obrigatório especificar um nome de banco de dados ao executar o comando dbaascli database start?

R: Sim, é recomendável especificar o nome do banco de dados usando a opção --dbname para garantir que o banco de dados correto seja iniciado.

Exemplo 6-19 dbaascli database start

dbaascli database start --dbname dbname --mode mount

dbaascli banco de dados status

Para verificar o status de um Banco de Dados Oracle, use o comando dbaascli database status.

Pré-requisitos

Execute o comando como usuário root.

Sintaxe

dbaascli database status
[--service][--dbname] 
[--user]
[--password]
Em que:
  • --service especifica o nome do serviço
  • --dbname especifica o nome do banco de dados
  • --user especifica o nome do usuário do serviço
  • --password especifica a senha do usuário

A saída do comando inclui o modo aberto do banco de dados, a release e a edição do software do banco de dados e a versão da release de outros componentes do software.

Exemplo 6-20 dbaascli database status

dbaascli database status --dbname db19

dbaascli database stop

Para interromper um Banco de Dados Oracle, use o comando dbaascli database stop.

Pré-requisitos

Execute o comando como usuário root.

Sintaxe

dbaascli database stop
[-–dbname <value>]
[--mode <value>]
Em que:
  • --dbname especifica o nome do banco de dados que você deseja interromper
  • --mode especifica o modo do banco de dados. Valores válidos: abort, immediate, normal, transactional

O comando executa um shutdown do banco de dados no modo imediato. Não são permitidas novas conexões ou novas transações. As transações ativas são revertidas e todos os usuários conectados são desconectados.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database stop?

A: O comando dbaascli database stop é usado para interromper um Oracle Database.

P: Quais são os pré-requisitos para usar o comando dbaascli database stop?

R: Execute o comando como usuário root e estabeleça conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH.

P: Como especificar qual banco de dados interromper?

R: Você pode especificar o banco de dados usando a opção --dbname seguida pelo nome do banco de dados. Por exemplo:

--dbname myDatabase

P: Quais são os modos de shutdown válidos do comando de interrupção do banco de dados dbaascli?

A: Os modos de shutdown válidos são:

abort

immediate

normal

transactional

P: Qual será o modo de shutdown padrão se nenhum modo for especificado?

R: Se nenhum modo for especificado, o banco de dados será submetido a shutdown no modo immediate por padrão.

P: O que acontece no modo de desligamento imediato?

R: No modo immediate, nenhuma conexão ou transação nova é permitida, as transações ativas são submetidas a rollback e todos os usuários conectados são desconectados.

P: Como posso interromper o banco de dados no modo de aborto?

R: Para interromper o banco de dados no modo de aborto, use a opção --mode com abortar. Por exemplo:

--mode abort

P: O que o modo normal faz ao interromper o banco de dados?

R: No modo normal, o banco de dados permite que as sessões atuais do usuário sejam concluídas e, em seguida, interrompidas sem afetar as transações ativas.

P: Para que é usado o modo transacional no comando de interrupção do banco de dados dbaascli?

R: No modo transactional, o banco de dados é interrompido somente depois que todas as transações ativas são concluídas, mas nenhuma nova transação é permitida.

P: É obrigatório especificar o modo de shutdown no comando de interrupção do banco de dados dbaascli?

A: Não, especificar um modo shutdown é opcional. Se não for informado, o modo imediato padrão será usado.

Exemplo 6-21 dbaascli database stop

dbaascli database stop --dbname db19

dbaascli database upgrade

Para fazer upgrade de um Banco de Dados Oracle, use o comando dbaascli database upgrade.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli database upgrade --dbname <value> 
{--targetHome <value> | --targetHomeName <value>}
{ [--executePrereqs | --postUpgrade | --rollback]}
{[--standBy | --allStandbyPrepared]}
{[--upgradeOptions <value>]  | [--standBy]}
[--removeGRP]
[--increaseCompatibleParameter]
[--resume [--sessionID <value>]]
[--waitForCompletion <value>]
Em que:
  • --dbname (obrigatório) especifica o nome do banco de dados.
  • --targetHome especifica o local do Oracle home de destino
  • --targetHomeName especifica o nome do home do Banco de Dados Oracle de destino
  • --standBy use esta opção para fazer upgrade de bancos de dados stand-by nas configurações do Data Guard
  • --allStandbyPrepared obrigatório para bancos de dados principais configurados pelo Data Guard. Flags para confirmar que todas as operações obrigatórias foram executadas nos bancos de dados stand-by antes de fazer upgrade do banco de dados principal
  • --removeGRP só remove automaticamente o backup de Ponto de Restauração Garantido (GRP) se o upgrade do banco de dados foi bem-sucedido
  • --increaseCompatibleParameter aumenta automaticamente o parâmetro compatível como parte do upgrade do banco de dados. O parâmetro só será aumentado se o upgrade do banco de dados tiver sido bem-sucedido
  • --executePrereqs executa apenas as verificações de pré-upgrade
  • --postUpgrade use esta opção se o pós-upgrade falhar e precisar executar novamente as etapas pós-upgrade
  • --rollback reverte um Oracle Database para seu Oracle home original
  • --upgradeOptions use esta opção para transmitir argumentos específicos do DBUA para executar o upgrade do Oracle Database. Consulte a documentação correspondente da Oracle para obter os argumentos e as opções com suporte.

    --standby

  • --resume para retomar a execução anterior
  • --sessionID para retomar um id de sessão específico.
  • --waitForCompletion especifique false para executar a operação em segundo plano. Valores válidos : true|false.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli database upgrade?

R: O comando dbaascli database upgrade é usado para fazer upgrade de um Oracle Database para uma nova versão.

P: Quais são os pré-requisitos para usar o comando dbaascli database upgrade?

R: Você deve executar o comando como usuário root e estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH.

P: Como eu especifico o banco de dados que precisa ser atualizado?

A: Use a opção --dbname seguida pelo nome do banco de dados. Por exemplo:

--dbname myDatabase

P: Como posso especificar o Oracle home de destino para o upgrade?

R: Você pode especificar o local do Oracle home de destino com a opção --targetHome ou o nome do home do Oracle Database de destino com a opção --targetHomeName.

P: O que a opção --standBy faz?

A: A opção --standBy é usada para fazer upgrade de bancos de dados stand-by nas configurações do Data Guard.

P: Qual é a finalidade do flag --allStandbyPrepared?

R: O flag --allStandbyPrepared reconhece que todas as operações necessárias em bancos de dados stand-by foram executadas antes do upgrade do banco de dados principal em uma configuração do Data Guard.

P: O que a opção --removeGRP faz?

A: A opção --removeGRP removerá automaticamente o backup de Ponto de Restauração Garantido (GRP) se o upgrade do banco de dados for bem-sucedido.

P: Quando devo usar a opção --increaseCompatibleParameter?

R: Use a opção --increaseCompatibleParameter para aumentar automaticamente o parâmetro compatível durante o upgrade do banco de dados, desde que o upgrade seja bem-sucedido.

P: O que a opção --executePrereqs faz?

A: A opção --executePrereqs executa apenas as verificações de pré-upgrade para garantir que o banco de dados esteja pronto para o upgrade.

P: Como lidar com uma etapa de pós-upgrade com falha?

A: Use a opção --postUpgrade para executar novamente as etapas de pós-upgrade se a tentativa inicial de pós-upgrade falhar.

P: Qual é a finalidade da opção --revert?

A: A opção --revert reverte o Oracle Database para seu Oracle home original, desfazendo o upgrade.

P: Como posso passar argumentos adicionais específicos do DBUA para o upgrade?

A: Use a opção --upgradeOptions para informar argumentos específicos do DBUA para o upgrade do Oracle Database. Consulte a documentação da Oracle para obter os argumentos e as opções com suporte.

P: É obrigatório especificar o Oracle home de destino para o upgrade?

R: Sim, você deve especificar --targetHome ou --targetHomeName para indicar o Oracle home de destino para o upgrade.

P: O que devo fazer se precisar executar uma verificação de pré-upgrade, mas não continuar com o upgrade?

R: Use a opção --executePrereqs para executar somente as verificações de pré-upgrade sem continuar com o upgrade real.

Exemplo 6-22 dbaascli database upgrade pre-upgrade requisite checks

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

dbaascli dataguard prepareStandbyBlob

Para gerar um arquivo blob contendo vários arquivos necessários no site stand-by no caso de um ambiente do dataguard, use o comando dbaascli dataguard prepareStandbyBlob.

Execute o comando como usuário root ou oracle.

Sintaxe

dbaascli dataguard prepareStandbyBlob --dbname <value> --blobLocation <value>
Em que:
  • --dbname especifica o nome do Oracle Database
  • --blobLocation especifica a localização do diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do Data Guard

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli dataguard prepareStandbyBlob?

R: O comando dbaascli dataguard prepareStandbyBlob é usado para gerar um arquivo blob contendo vários arquivos necessários no site stand-by em um ambiente do Data Guard.

P: Quais são os pré-requisitos para executar o comando dbaascli dataguard prepareStandbyBlob?

A: O comando deve ser executado como o usuário root ou oracle.

P: Como especifico o nome do Oracle Database para o qual quero preparar o blob stand-by?

A: Use a opção --dbname seguida pelo nome do Oracle Database. Por exemplo:

--dbname myDatabase

P: Como especificar o local onde o arquivo blob stand-by será gerado?

R: Use a opção --blobLocation para especificar o caminho do diretório personalizado no qual o arquivo blob stand-by será gerado. Por exemplo:

--blobLocation /path/to/standby_blob

P: O que a opção --dbname faz no comando?

A: A opção --dbname especifica o nome do Oracle Database para o qual o arquivo blob stand-by está sendo preparado.

P: Qual é a finalidade da opção --blobLocation?

A: A opção --blobLocation define o caminho do diretório personalizado no qual o arquivo blob stand-by será criado.

P: Posso executar o comando dbaascli dataguard prepareStandbyBlob como usuário diferente do root ou do oracle?

R: Não, o comando deve ser executado como o usuário root ou oracle.

P: É possível usar um caminho relativo para a opção --blobLocation?

R: Recomenda-se usar um caminho absoluto para a opção --blobLocation para garantir que o arquivo blob stand-by seja criado no diretório correto.

P: O que devo fazer se eu quiser alterar o local onde o arquivo blob stand-by é gerado?

A: Modifique a opção --blobLocation para especificar um novo caminho de diretório para o arquivo blob stand-by.

P: Preciso executar alguma etapa adicional após gerar o arquivo blob stand-by?

R: Sim, depois de gerar o arquivo blob stand-by, você precisa transferi-lo para o site stand-by e usá-lo para a configuração do Data Guard.

dbaascli dataguard updateDGConfigAttributes

Para atualizar os atributos de automação do Data Guard em todos os nós do cluster, use o comando dbaascli dataguard updateDGConfigAttributes.

Execute o comando como o usuário root ou oracle.

Sintaxe

dbaascli dataguard updateDGConfigAttributes --attributes <value>
Em que:
  • --attributes contém os atributos de automação do Data Guard que devem ser modificados. Aceita valores delimitados por vírgula no formato <attribute=value>. Os atributos devem ser predefinidos no arquivo de configuração do Data Guard.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli dataguard updateDGConfigAttributes?

R: O comando dbaascli dataguard updateDGConfigAttributes é usado para atualizar atributos de automação do Data Guard em todos os nós do cluster.

P: Quais são os pré-requisitos para executar o comando dbaascli dataguard updateDGConfigAttributes?

A: O comando deve ser executado como o usuário root ou oracle.

P: Como especifico os atributos que desejo atualizar usando este comando?

A: Use a opção --attributes seguida pelos atributos a serem modificados. Os atributos devem estar em um formato delimitado por vírgulas, como attribute=value. Por exemplo:

--attributes attribute1=value1,attribute2=value2

P: Em qual formato os valores da opção --attributes devem estar?

R: Os valores da opção --attributes devem estar em um formato delimitado por vírgulas com cada atributo especificado como attribute=value.

P: Posso especificar vários atributos na opção --attributes?

R: Sim, você pode especificar vários atributos separando-os com vírgulas. Por exemplo:

--attributes attribute1=value1,attribute2=value2

P: O que acontece se eu fornecer um atributo que não seja predefinido no arquivo de configuração do Data Guard?

R: Se você fornecer um atributo que não seja predefinido, o comando poderá falhar ou ignorar o atributo não reconhecido. Certifique-se de que todos os atributos sejam predefinidos no arquivo de configuração do Data Guard.

P: Preciso reiniciar algum serviço após atualizar os atributos de automação do Data Guard?

R: Na maioria dos casos, você não precisa reiniciar os serviços após atualizar os atributos. No entanto, verifique os atributos específicos e seu impacto para determinar se é necessário reiniciar.

P: Como posso verificar se os atributos do Data Guard foram atualizados com sucesso?

R: Após executar o comando, você pode verificar os atributos atualizados verificando a configuração do Data Guard ou usando comandos/ferramentas de verificação apropriados específicos à sua configuração.

P: O que devo fazer se o comando não atualizar os atributos?

R: Verifique as mensagens de erro para obter detalhes sobre o que deu errado. Verifique se você especificou os atributos corretos e se eles estão predefinidos no arquivo de configuração do Data Guard. Verifique as permissões do usuário e a sintaxe do comando.

P: É possível atualizar atributos apenas para nós específicos usando este comando?

R: Não, o comando dbaascli dataguard updateDGConfigAttributes atualiza atributos em todos os nós do cluster. Se precisar atualizar atributos para nós específicos, talvez seja necessário usar métodos ou comandos diferentes.

dbaascli dbhome create

Para criar um home do Banco de Dados Oracle da versão desejada, use o comando dbaascli dbhome create.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli dbhome create --version <value>
[--oracleHome <value>]
[--oracleHomeName <value>]
[--enableUnifiedAuditing <value>] 
[--imageTag <value>]
[--ImageLocation <value>
Em que:
  • --version especifica a versão do Oracle Home definida como cinco segmentos numéricos separados por pontos, por exemplo, 19.12.0.0.0
  • --oracleHome especifica o local do Oracle home
  • --oracleHomeName especifica o nome do Oracle home definido pelo usuário. Se não for fornecido, o nome padrão será usado
  • --enableUnifiedAuditing especifica true ou false para ativar ou desativar a opção de link de auditoria unificada no Oracle home
  • --imageTag especifica a tag de imagem do Oracle home
  • --imageLocation - caminho da imagem a ser usada.
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true ou false.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli dbhome create?

R: O comando dbaascli dbhome create é usado para criar um novo home do Oracle Database com a versão desejada.

P: Quais são os pré-requisitos para executar o comando dbaascli dbhome create?

A: O comando deve ser executado como o usuário root.

P: Como eu especifico a versão do Oracle Database ao criar um novo Oracle Home?

A: Use a opção --version seguida pela versão do Oracle Database no formato de cinco segmentos numéricos separados por pontos, como 19.11.0.0.0.

P: O que a opção --oracleHome especifica?

A: A opção --oracleHome especifica o local onde você deseja instalar o Oracle Home. Se o local não for fornecido, o local padrão será usado.

P: Posso designar um nome personalizado ao novo Oracle Home?

R: Sim, você pode usar a opção --oracleHomeName para especificar um nome definido pelo usuário para o Oracle Home. Se não for especificado, um nome padrão será usado.

P: Como ativo ou desativo a Auditoria Unificada no novo Oracle Home?

A: Use a opção --enableUnifiedAuditing e especifique true para ativar ou false para desativar a Auditoria Unificada para o Oracle Home.

P: O que a opção --imageTag faz?

A: A opção --imageTag especifica a tag de imagem do Oracle Home, que pode ser usada nos casos em que a tag de imagem difere da versão.

P: Qual é um exemplo de uso do comando dbaascli dbhome create com a tag version and image?

A: Um exemplo do comando com a tag version and image é:

dbaascli dbhome create --version 19.8.0.0.0 --imageTag 19.8.0.0.0

Isso cria um Oracle Home para a versão 19.8.0.0.0 com a tag de imagem correspondente.

P: O que acontece se eu não fornecer as opções --oracleHome ou --oracleHomeName?

R: Se --oracleHome não for fornecido, o Oracle Home será instalado no local padrão. Se --oracleHomeName não for especificado, um nome padrão será designado ao Oracle Home.

P: Como posso verificar se a criação do Oracle Home foi bem-sucedida?

R: Depois de executar o comando, verifique os logs de saída em busca de mensagens ou erros bem-sucedidos. Você também pode verificar o Oracle Home navegando até o local especificado ou usando ferramentas Oracle como orainstRoot.sh.

P: É possível criar vários Oracle Homes com versões diferentes no mesmo sistema?

R: Sim, você pode criar vários Oracle Homes com versões diferentes especificando valores diferentes para as opções --version e --oracleHomeName.

P: O que devo fazer se a criação do Oracle Home falhar?

R: Verifique os logs de saída para obter mensagens de erro detalhadas. Verifique se você tem o formato de versão correto, as permissões necessárias e espaço em disco suficiente. Corrija os problemas e tente executar o comando novamente.

Exemplo 6-23 dbaascli dbhome create

dbaascli dbhome create --version 19.11.0.0.0

Como alternativa, dbaascli dbhome create --version 19.8.0.0.0.0 --imageTag 19.8.0.0.0 para casos em que as tags de imagem são diferentes da versão.

dbaascli dbHome delete

Para excluir um determinado home do Oracle Database, use o comando dbaascli dbHome delete.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli dbHome delete 
{ --oracleHome <value> 
| --oracleHomeName <value> } [--resume [--sessionID <value>]] 
Em que:
  • --oracleHome especifica o local do Oracle home
  • --oracleHomeName especifica o nome do Oracle home
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli dbHome delete?

A: O comando dbaascli dbHome delete é usado para excluir um home do Oracle Database especificado do sistema.

P: Quais são os pré-requisitos para executar o comando de exclusão dbaascli dbHome?

A: O comando deve ser executado como o usuário root.

P: Como especifico o Oracle Home a ser excluído?

A: Você pode especificar o Oracle Home a ser excluído usando uma das seguintes opções:

--oracleHome <value> para fornecer o caminho absoluto da localização do Oracle Home.

--oracleHomeName <value> para fornecer o nome do Oracle Home.

P: Qual é a diferença entre as opções --oracleHome e --oracleHomeName?

A4:

--oracleHome especifica o local físico ou o caminho do Oracle Home a ser excluído.

--oracleHomeName especifica o nome definido pelo usuário do Oracle Home a ser excluído.

P: Como posso retomar um processo de exclusão interrompido anteriormente?

R: Você pode usar a opção --resume para retomar um processo de exclusão anterior. Se você souber o ID de sessão específico do processo, poderá incluí-lo com a opção --sessionID.

P: Para que é usada a opção --sessionID no comando dbaascli dbHome delete?

A: A opção --sessionID é usada para retomar uma sessão específica que foi interrompida ou falhou anteriormente durante o processo de exclusão.

P: O que acontece se eu não fornecer as opções --resume ou --sessionID?

R: Se as opções --resume ou --sessionID não forem fornecidas, o comando iniciará um novo processo de exclusão em vez de retomar um processo interrompido.

P: Existe alguma forma de confirmar a exclusão do Oracle Home após a execução do comando?

R: Você pode verificar a exclusão verificando se há mensagens de sucesso nos logs de saída e garantindo que o diretório Oracle Home não esteja mais presente no local especificado.

P: Posso excluir um Oracle Home que está sendo usado no momento por um banco de dados em execução?

R: Não, o Oracle Home não deve estar em uso por nenhum banco de dados ou serviço em execução durante o processo de exclusão. Certifique-se de interromper qualquer banco de dados relacionado antes de executar o comando de exclusão.

P: O que devo fazer se o comando de exclusão dbaascli dbHome falhar?

R: Verifique os logs de saída para obter quaisquer mensagens de erro. Certifique-se de que o Oracle Home não esteja em uso, verifique a localização ou o nome correto do Oracle Home e confirme se você tem as permissões necessárias. Depois de resolver quaisquer problemas, execute novamente o comando ou use a opção --resume, se necessário.

P: Posso excluir vários Oracle Homes de uma só vez usando o comando dbaascli dbHome delete?

R: Não, o comando só permite excluir um Oracle Home por vez especificando a opção --oracleHome ou --oracleHomeName.

P: Qual é um exemplo de exclusão de um Oracle Home por seu nome?

A: Aqui está um exemplo de exclusão de um Oracle Home por nome:

dbaascli dbHome delete --oracleHomeName myOracleHome

Esse comando exclui o Oracle Home com o nome myOracleHome.

P: Qual é um exemplo de exclusão de um Oracle Home por sua localização?

A: Aqui está um exemplo de exclusão de um Oracle Home especificando sua localização:

dbaascli dbHome delete --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

Esse comando exclui o Oracle Home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.

P: Posso cancelar o processo de exclusão depois de iniciado?

R: Não, depois que o processo de exclusão for iniciado, ele não poderá ser cancelado. Certifique-se de que o Oracle Home esteja pronto para exclusão antes de executar o comando.

dbaascli dbhome getDatabases

Para exibir informações sobre todos os Bancos de Dados Oracle em execução em um determinado Oracle home do banco de dados, use o comando dbaascli dbHome getDatabases. Especifique o local ou o nome do Oracle home.

Execute o comando como usuário root.

Sintaxe

dbaascli dbHome getDatabases
{ --oracleHomeName value | --oracleHome value }
Em que:
  • --oracleHomeName especifica o nome do Oracle home definido pelo usuário
  • --oracleHome especifica o local (caminho) do Oracle home

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli dbHome getDatabases?

R: O comando dbaascli dbHome getDatabases é usado para exibir informações sobre todos os Bancos de Dados Oracle em execução em um home do Oracle Database especificado.

P: Como posso especificar o home do Oracle Database a ser verificado?

A: Você pode especificar o home do Oracle Database usando uma das seguintes opções:

--oracleHomeName <value> para especificar o nome definido pelo usuário do Oracle home.

--oracleHome <value> para especificar o local completo (caminho) do Oracle home.

P: Qual é a diferença entre as opções --oracleHomeName e --oracleHome?

A4:

--oracleHomeName refere-se a um nome definido pelo usuário para o Oracle home.

--oracleHome refere-se ao local físico (ou caminho do diretório) do Oracle home no sistema.

P: Como faço para executar o comando dbaascli dbHome getDatabases?

A: Para executar o comando, use a seguinte sintaxe:

dbaascli dbHome getDatabases --oracleHomeName <value>

ou

dbaascli dbHome getDatabases --oracleHome <value>

Certifique-se de executar o comando como usuário root.

P: Posso especificar o nome do Oracle home e o local do Oracle home no mesmo comando?

R: Não, você só pode especificar --oracleHomeName ou --oracleHome em uma única execução de comando. Escolha uma opção com base em como você identifica o Oracle home.

P: Que tipo de informação o comando dbaascli dbHome getDatabases retorna?

R: O comando retorna informações sobre todos os Bancos de Dados Oracle em execução no Oracle home especificado. Isso inclui detalhes como nomes e status do banco de dados.

P: Qual é um exemplo de uso do dbaascli dbHome getDatabases com o local do Oracle home?

A: Aqui está um exemplo de como usar o comando com o local do Oracle home:

dbaascli dbHome getDatabases --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

Esse comando recupera a lista de bancos de dados em execução no Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.

P: Qual é um exemplo de uso do dbaascli dbHome getDatabases com o nome do Oracle home?

A: Aqui está um exemplo de como usar o comando com o nome do Oracle home:

dbaascli dbHome getDatabases --oracleHomeName myOracleHome

Esse comando recupera a lista de bancos de dados em execução no Oracle home chamado myOracleHome.

P: Preciso de permissões especiais para executar este comando?

R: Sim, você deve executar o comando como usuário raiz para exibir as informações sobre Bancos de Dados Oracle em execução em um Oracle home especificado.

P: O que devo verificar se o comando dbaascli dbHome getDatabases não retorna bancos de dados?

R: Certifique-se de ter especificado o nome ou o local correto do Oracle home e de que há bancos de dados em execução nesse Oracle home. Além disso, confirme se o Oracle home está configurado e ativo corretamente.

P: Posso usar o comando dbaascli dbHome getDatabases em vários Oracle homes de uma só vez?

R: Não, o comando funciona em um único Oracle home de cada vez. Execute o comando separadamente para cada Oracle home que você deseja consultar.

P: Existe uma maneira de verificar se o Oracle home especificado no comando está correto?

R: Você pode verificar o Oracle home verificando a estrutura do diretório ou os detalhes da configuração no sistema para garantir que o caminho ou o nome fornecido corresponda ao Oracle home real.

P: O que acontece se eu executar o comando sem especificar um nome do Oracle home ou do Oracle home?

A: O comando requer que a opção --oracleHome ou --oracleHomeName seja especificada. Se nenhuma das opções for fornecida, o comando falhará ao ser executado.

P: Este comando pode recuperar bancos de dados que estão interrompidos no momento?

R: Sim, o comando listará todos os bancos de dados associados ao Oracle home especificado, independentemente de estarem em execução ou interrompidos no momento.

Exemplo 6-24 dbaascli dbHome getDatabases --oracleHome

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

dbaascli dbHome getDetails

Para exibir informações sobre um Oracle home específico, use o comando dbaascli dbHome getDetails. Especifique o local ou o nome do Oracle home.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli dbHome getDetails
{ --oracleHomeName value | --oracleHome value }
Em que:
  • --oracleHomeName especifica o nome do Oracle home definido pelo usuário
  • --oracleHome especifica o local do Oracle home

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli dbHome getDetails?

R: O comando dbaascli dbHome getDetails é usado para exibir informações detalhadas sobre um Oracle home específico no sistema.

P: Como especifico o Oracle home sobre o qual quero obter detalhes?

A: Você pode especificar o Oracle home usando uma das seguintes opções:

--oracleHomeName <value> para especificar o nome definido pelo usuário do Oracle home.

--oracleHome <value> para especificar o local completo (caminho) do Oracle home.

P: Qual é a diferença entre --oracleHomeName e --oracleHome?

A4:

--oracleHomeName é o nome definido pelo usuário para um Oracle home.

--oracleHome refere-se ao caminho completo do diretório em que o Oracle home está localizado.

P: Como faço para executar o comando dbaascli dbHome getDetails?

A: Para executar o comando, use a seguinte sintaxe:

dbaascli dbHome getDetails --oracleHomeName <value>

ou

dbaascli dbHome getDetails --oracleHome <value>

Certifique-se de executar o comando como usuário root.

P: Posso especificar --oracleHomeName e --oracleHome no mesmo comando?

R: Não, você só pode usar uma opção por execução de comando. Especifique o nome do Oracle home ou o local do Oracle home, não ambos.

P: Quais informações o comando dbaascli dbHome getDetails retorna?

R: O comando fornece informações detalhadas sobre o Oracle home especificado, como sua versão, status e quaisquer outros detalhes de configuração associados ao Oracle home.

P: Qual é um exemplo de uso do comando dbaascli dbHome getDetails com um local do Oracle home?

A: Aqui está um exemplo:

dbaascli dbHome getDetails --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

Este comando recupera informações detalhadas sobre o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.

P: Qual é um exemplo de uso do comando dbaascli dbHome getDetails com um nome do Oracle home?

A: Aqui está um exemplo:

dbaascli dbHome getDetails --oracleHomeName myOracleHome

Este comando recupera informações detalhadas sobre o Oracle home chamado myOracleHome.

P: Preciso de permissões especiais para executar este comando?

R: Sim, você deve executar o comando como usuário raiz para exibir detalhes sobre o Oracle home.

P: O que devo fazer se o comando dbaascli dbHome getDetails não retornar informações?

R: Verifique se você especificou corretamente o nome ou o local do Oracle home e se o Oracle home está configurado corretamente e existe no sistema.

P: Posso usar o comando dbaascli dbHome getDetails em vários Oracle homes simultaneamente?

R: Não, o comando só funciona em um único Oracle home de cada vez. Execute o comando separadamente para cada Oracle home.

P: É possível verificar o nome do Oracle home antes de executar o comando?

R: Sim, você pode verificar o nome do Oracle home verificando os arquivos de configuração do sistema ou listando todos os Oracle homes disponíveis no sistema.

P: O que acontece se eu não especificar um nome ou local do Oracle home no comando?

A: O comando requer que a opção --oracleHome ou --oracleHomeName seja especificada. Se nenhum dos dois for fornecido, a execução do comando falhará.

P: Posso recuperar informações sobre Oracle homes que não estão em uso no momento?

R: Sim, o comando dbaascli dbHome getDetails fornece detalhes sobre Oracle homes, independentemente de eles estarem em uso ou ociosos.

P: O que devo verificar se o comando retorna um erro?

R: Verifique se o nome ou a localização do Oracle home está correto, se o Oracle home existe e se você está executando o comando como o usuário root. Verifique novamente se há erros de digitação ou caminhos incorretos.

Exemplo 6-25 dbaascli dbHome getDetails - using Oracle home location

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

Exemplo 6-26 dbaascli dbHome getDetails - using Oracle home name

dbaascli dbHome getDetails --oracleHomeName home_db19c

patch dbaascli dbHome

Para aplicar patch no Oracle home de um nível de patch para outro, use o comando dbaascli dbHome patch.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

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>]
Em que:
  • --oracleHome especifica o caminho do Oracle home
  • --oracleHomeName especifica o nome do Oracle home
  • --targetVersion especifica a versão de destino do Oracle Home definida como cinco segmentos numéricos separados por pontos, por exemplo, 19.12.0.0.0
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --continueWithDbDowntime continua aplicando patch com tempo de inatividade do banco de dados. Essa opção pode ser usada em ambientes nos quais só há uma instância ativa e a operação de aplicação de patch pode continuar mesmo com um tempo de inatividade.
  • --skipUnreachableNodes ignora a operação em nós inacessíveis
  • --nodes especifica uma lista de nós delimitados por vírgulas se a aplicação de patch tiver que ser executada em um subconjunto de nós
  • --executePrereqs executa pré-requisitos
  • --skipDatapatch ignora a execução de datapatch nos bancos de dados
  • --imageFilePath especifica o caminho absoluto do arquivo de imagem a ser usado
  • --skipPDBs ignora a execução do datapatch em uma lista especificada de PDBs delimitados por vírgulas. Por exemplo: cdb1:pdb1,cdb2:pdb2 e assim por diante
  • --skipClosedPdbs ignora a execução de datapatch em PDBs fechados
  • --rollback faz rollback do Oracle home que recebeu patch.
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos : true|false
  • --drainTimeoutInSeconds especifica o tempo (em segundos) para concluir a descarga de recursos enquanto o banco de dados é interrompido
  • --skipUnreachableNodes ignora a operação em nós inacessíveis

Perguntas Frequentes

P: Para que é usado o comando de patch dbaascli dbHome?

A: O comando dbaascli dbHome patch é usado para aplicar patch ao Oracle home de um nível de patch para outro.

P: Preciso de permissões especiais para executar o comando de patch dbaascli dbHome?

R: Sim, você precisa executar o comando como usuário root.

P: Como especifico o caminho ou o nome do Oracle home para o patch?

A: Use a opção --oracleHome para especificar o caminho do Oracle home ou --oracleHomeName para especificar o nome do Oracle home.

P: Como posso definir a versão de destino do patch?

R: Use a opção --targetVersion seguida do número da versão no formato 19.12.0.0.0.

P: O que a opção --resume faz?

A: A opção --resume permite retomar uma sessão de aplicação de patch anterior.

P: Como especificar um ID de sessão específico ao retomar um patch?

R: Use a opção --sessionID para especificar o ID da sessão de aplicação de patch que você deseja retomar.

P: Para que é usada a opção --continueWithDbDowntime?

A: A opção --continueWithDbDowntime permite que a aplicação de patch continue mesmo que haja tempo de inatividade do banco de dados, útil em ambientes com apenas uma instância ativa.

P: Como posso ignorar a aplicação de patch em nós inacessíveis?

A: Use a opção --skipUnreachableNodes para ignorar operações em nós inacessíveis.

P: Como aplicar patch apenas a nós específicos em um cluster?

A: Use a opção --nodes seguida de uma lista delimitada por vírgulas de nomes de nós para aplicar patch a um subconjunto de nós.

P: Para que serve a opção --executePrereqs?

A: A opção --executePrereqs executa verificações de pré-requisitos antes de aplicar o patch.

P: Como posso ignorar a execução do datapatch nos bancos de dados?

A: Use a opção --skipDatapatch para ignorar o processo datapatch durante a aplicação de patch.

P: Posso especificar um local personalizado para a imagem do banco de dados?

R: Sim, use a opção --imageLocation para especificar um local personalizado para a imagem do banco de dados.

P: O que a opção --skipPDBs faz?

A: A opção --skipPDBs permite ignorar a execução do datapatch em uma lista especificada de bancos de dados plugáveis (PDBs) delimitados por vírgulas.

P: Como posso ignorar o datapatch em PDBs fechados?

A: Use a opção --skipClosedPDBs para ignorar o datapatch em PDBs fechados.

P: O que acontece se eu usar a opção --rollback?

A: A opção --rollback reverterá o Oracle home para seu estado anterior antes que o patch seja aplicado.

P: Como especifico o caminho do Oracle home para aplicação de patch?

A: Use a opção --oracleHome seguida pelo caminho para o diretório do Oracle home.

P: Como posso aplicar patch a um Oracle home pelo nome dele, e não pelo caminho?

A: Use a opção --oracleHomeName seguida pelo nome do Oracle home.

P: Como retomo uma operação de aplicação de patch se ela foi interrompida?

A: Use a opção --resume junto com a opção --sessionID para retomar uma sessão interrompida específica.

P: Posso continuar o processo de aplicação de patch se o banco de dados estiver inativo?

R: Sim, use a opção --continueWithDbDowntime para continuar a aplicação de patch, mesmo que o banco de dados esteja inativo.

P: O que devo fazer se alguns nós estiverem inacessíveis durante o processo de aplicação de patch?

A: Use a opção --skipUnreachableNodes para ignorar os nós inacessíveis.

P: Como posso aplicar o patch apenas a determinados nós?

A: Especifique os nós que você deseja aplicar patch usando a opção --nodes com uma lista de nomes de nós separados por vírgulas.

P: Como verifico os pré-requisitos antes de aplicar o patch?

R: Use a opção --executePrereqs para executar verificações de pré-requisitos antes de aplicar o patch.

P: O que devo fazer se quiser evitar a aplicação do datapatch durante o processo de aplicação de patch?

A: Use a opção --skipDatapatch para ignorar a etapa datapatch.

P: Como posso especificar um local diferente para a imagem do banco de dados usada no processo de aplicação de patch?

A: Use a opção --imageLocation para especificar um local personalizado para a imagem.

P: E se eu precisar ignorar o datapatch em determinados PDBs?

A: Use a opção --skipPDBs para ignorar o datapatch em uma lista especificada de PDBs delimitados por vírgulas.

P: Posso ignorar o datapatch em PDBs que não estão abertos no momento?

R: Sim, use a opção --skipClosedPDBs para ignorar o datapatch em PDBs fechados.

P: O que devo fazer se a correção falhar no meio do caminho?

R: Você pode usar a opção --rollback para reverter para o estado anterior ou tentar retomar o processo de correção com a opção --resume.

P: Como posso verificar se todos os pré-requisitos foram atendidos antes de aplicar o patch?

R: Execute o comando de patch com a opção --executePrereqs para garantir que todos os pré-requisitos sejam atendidos.

P: E se a operação de aplicação de patch não for concluída com sucesso e eu precisar tentar novamente?

A: Use a opção --resume para repetir a operação de aplicação de patch de onde ela parou. Se necessário, você pode especificar um --sessionID para retomar uma sessão específica.

P: Como posso verificar se o patch foi aplicado com sucesso?

R: Você pode verificar o processo de aplicação de patch verificando a versão do Oracle home usando o comando opatch lsinventory após a conclusão do patch.

P: Posso executar o comando de aplicação de patches em um modo dryrun para visualizar ações?

R: Não, o comando dbaascli dbHome patch não tem um recurso de dryrun. No entanto, você pode usar a opção --executePrereqs para executar verificações de pré-requisitos antes de realmente aplicar o patch.

P: É possível aplicar vários patches em uma única execução?

A: O comando dbaascli dbHome patch só permite uma versão de destino por vez. Você precisaria executar o comando separadamente para cada versão do patch.

P: Como tratar a aplicação de patches se o ambiente usar vários Oracle homes?

R: Você pode especificar o Oracle home ao qual deseja aplicar patch usando as opções --oracleHome ou --oracleHomeName, dependendo se você está especificando o caminho ou o nome do Oracle home.

P: Posso ignorar o datapatch do PDB e do CDB em um comando?

R: Sim, você pode combinar as opções --skipPDBs e --skipDatapatch para ignorar o patch de dados para PDBs e CDB em uma única execução de patch.

P: Posso aplicar um patch e fazer rollback imediatamente se ele causar problemas?

R: Sim, depois de aplicar um patch, você pode usar a opção --rollback para reverter para o nível de patch anterior se houver algum problema.

P: Posso aplicar patch a vários Oracle homes simultaneamente?

R: Não, você precisa executar o comando dbaascli dbHome patch individualmente para cada Oracle home.

P: Como posso rastrear o andamento da operação de aplicação de patch?

R: Durante o processo de aplicação de patches, o comando fornece mensagens de saída que mostram o andamento. Você também pode verificar os arquivos de log para obter informações detalhadas.

P: Posso executar a aplicação de patches em paralelo em um ambiente clusterizado?

R: As operações de aplicação de patch podem ser aplicadas a um subconjunto de nós usando a opção --nodes. No entanto, a aplicação simultânea de patches deve ser tratada com cuidado e você deve garantir que não haja sessões sobrepostas.

P: Como posso identificar quais patches estão disponíveis para meu Oracle home?

R: Você pode verificar os patches disponíveis por meio do portal de suporte da Oracle ou executando o comando opatch lsinventory para ver os patches atuais aplicados ao Oracle home.

P: Posso especificar um timeout para drenar recursos ao interromper o banco de dados durante a aplicação de patch?

R: Sim, você pode usar a opção --drainTimeoutInSeconds para especificar o tempo em segundos para drenagem de recursos ao interromper o banco de dados.

P: O que acontece se o patch falhar em um dos nós em um ambiente com vários nós?

R: Você pode usar a opção --skipUnreachableNodes para ignorar o nó com falha e continuar o processo de aplicação de patch nos nós restantes. Em seguida, você pode resolver o problema no nó com falha separadamente.

P: Como posso fazer com que o processo de aplicação de patches seja executado em segundo plano?

A: Use a opção --waitForCompletion com um valor de false para permitir que o processo de aplicação de patch seja executado em segundo plano. Dessa forma, você não precisa esperar que o processo seja concluído de forma interativa.

P: Posso executar uma operação de rollback em um subconjunto de nós em um ambiente clusterizado?

R: Sim, você pode usar a opção --nodes junto com a opção --rollback para fazer rollback da aplicação de patch em um conjunto específico de nós.

P: E se eu precisar atualizar a localização da imagem após iniciar o processo de patch?

A: A opção --resume não permite alterar o local da imagem. No entanto, você pode interromper a sessão e iniciar um novo processo de patch com o --imageLocation atualizado.

P: Existe uma maneira de verificar quais IDs de sessão estão disponíveis para retomar um patch?

R: Você pode verificar os arquivos de log ou usar as ferramentas do Oracle Cloud para identificar sessões de aplicação de patches ativas ou pausadas e seus IDs de sessão.

P: Posso limitar o tempo de inatividade durante a aplicação de patches?

R: Se você precisar limitar o tempo de inatividade, use a opção --continueWithDbDowntime com cuidado. Isso permite que você prossiga mesmo quando o tempo de inatividade for esperado, mas requer planejamento para um impacto mínimo no serviço.

Exemplo de Casos de Uso

Exemplo 1: Aplicação Básica de Patch do Oracle Home pelo Caminho do Oracle Home

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

Corrige o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1 para a versão 19.12.0.0.0.

Exemplo 2: Aplicação de Patch por Nome do Oracle Home

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0

Corrige o Oracle home chamado DB_HOME_NAME para a versão 19.12.0.0.0.

Exemplo 3: Retomando uma Operação de Patch Anterior

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --resume

Retoma a operação de aplicação de patch anterior para o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.

Exemplo 4: Retomando um Patch com um ID de Sessão Específico

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --resume --sessionID 12345

Retoma a operação de aplicação de patch do Oracle home DB_HOME_NAME usando o ID da sessão 12345.

Exemplo 5: Patch com Tempo de Inatividade do Banco de Dados Permitido

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --continueWithDbDowntime

Corrige o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1 para a versão 19.12.0.0.0, permitindo o tempo de inatividade do banco de dados.

Exemplo 6: Ignorando Nós Inacessíveis

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes

Corrige o Oracle home para a versão 19.12.0.0.0 ao ignorar qualquer nó inacessível.

Exemplo 7: Aplicando Patch a um Subconjunto de Nós

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --nodes node1,node2

Corrige o Oracle home para a versão 19.12.0.0.0 somente em node1 e node2.

Exemplo 8: Executando Verificações de Pré-requisitos Antes da Aplicação de Patch

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --executePrereqs

Corrige o Oracle home DB_HOME_NAME para a versão 19.12.0.0.0 após executar verificações de pré-requisitos.

Exemplo 9: Ignorando a Etapa Datapatch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch

Corrige o Oracle home para a versão 19.12.0.0.0 sem executar o datapatch nos bancos de dados.

Exemplo 10: Usando um Arquivo de Imagem para Aplicação de Patch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --imageFilePath /path/to/image/file.zip

Corrige o Oracle home para a versão 19.12.0.0.0 usando um arquivo de imagem localizado em /path/to/image/file.zip.

Exemplo 11: Ignorando PDBs Específicos Durante o Datapatch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2

Corrige o Oracle home para a versão 19.12.0.0.0 e ignora a execução de datapatch nos PDBs especificados (pdb1 em cdb1 e pdb2 em cdb2).

Exemplo 12: Ignorando o Datapatch em PDBs Fechados

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipClosedPDBs

Corrige o Oracle home para a versão 19.12.0.0.0 ao ignorar a execução do datapatch em qualquer PDB fechado.

Exemplo 13: Fazendo Rollback do Oracle Home

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback

Faz rollback do último patch aplicado no Oracle home chamado DB_HOME_NAME.

Exemplo 14: Combinação de Aplicação de Patch com Verificações de Pré-requisitos e Nós Específicos

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --executePrereqs --nodes node1,node2

Corrige o Oracle home para a versão 19.12.0.0.0, executa verificações de pré-requisitos e aplica o patch apenas em node1 e node2.

Exemplo 15: Ignorando Nós Inacessíveis e PDBs Específicos

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --skipUnreachableNodes --skipPDBs cdb1:pdb1

Corrige o Oracle home DB_HOME_NAME para a versão 19.12.0.0.0 enquanto ignora nós inacessíveis e evita a execução de datapatch em pdb1 em cdb1.

Exemplo 16: Verificando o Pós-Patch da Versão do Oracle Home

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

opatch lsinventory

Este exemplo mostra como verificar a versão do Oracle home após um patch bem-sucedido executando opatch lsinventory.

Exemplo 17: Fazendo Rollback de Patches com ID de Sessão Específica

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --sessionID 67890

Faz rollback da aplicação de patch do Oracle home para um ID de sessão de 67890.

Exemplo 18: Aplicação de Patch com Ignorando Verificações de Pré-requisitos

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPrereqs

Corrige o Oracle home, mas ignora as verificações de pré-requisitos antes de aplicar o patch.

Exemplo 19: Aplicando um Patch a uma Imagem Personalizada do Oracle Home

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --imageLocation /custom/location/image.zip

Corrige o Oracle home usando um arquivo de imagem personalizado localizado em /custom/location/image.zip.

Exemplo 20: Ignorando Nós Específicos e Executando Pré-requisitos

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes --executePrereqs

Ignora a aplicação de patches em nós inacessíveis e executa verificações de pré-requisitos antes de aplicar o patch.

Exemplo 21: Ignorando o Datapatch em Todos os PDBs em Vários CDBs

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2,cdb3:pdb3

Corrige o Oracle home, mas ignora o patch de dados nos PDBs especificados em vários CDBs.

Exemplo 22: Continuando a Aplicação de Patches com Tempo de Inatividade em Vários Nós

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --continueWithDbDowntime --nodes node3,node4

Continua a aplicação de patches em node3 e node4 com tempo de inatividade do banco de dados permitido.

Exemplo 23: Ignorando o Datapatch em PDBs e PDBs Fechados

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch --skipClosedPDBs

Corrige o Oracle home ao ignorar o patch de dados e os PDBs fechados.

Exemplo 24: Fazendo Rollback e Reaplicando Patch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

Faz rollback do patch atual e, em seguida, reaplica o patch ao Oracle home.

Exemplo 25: Ignorando o Datapatch e Permitindo Tempo de Inatividade em um Nó Específico

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipDatapatch --continueWithDbDowntime --nodes node1

Corrige o Oracle home para a versão 19.13.0.0.0 em node1, ignorando a etapa do datapatch e permitindo tempo de inatividade.

Exemplo 26: Especificando o Timeout de Drenagem Durante o Shutdown do Banco de Dados

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.13.0.0.0 --drainTimeoutInSeconds 300

Corrige o Oracle home DB_HOME_NAME para a versão 19.13.0.0.0 e permite um timeout de 5 minutos (300 segundos) para drenar recursos durante o shutdown.

Exemplo 27: Executando Patches em Segundo Plano

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --waitForCompletion false

Corrige o Oracle home para a versão 19.13.0.0.0 e executa o processo de aplicação de patch em segundo plano sem aguardar a conclusão.

Exemplo 28: Fazendo Rollback do Patch em um Subconjunto de Nós

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --nodes node1,node2

Faz rollback do último patch aplicado em node1 e node2 somente para o Oracle home especificado.

Exemplo 29: Ignorando Pré-requisitos e Aplicando Patches a Vários Nós

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipPrereqs --nodes node3,node4

Corrige o Oracle home para a versão 19.13.0.0.0 em node3 e node4 sem executar verificações de pré-requisitos.

Exemplo 30: Fazendo Rollback do Patch e Ignorando Nós Inacessíveis

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback --skipUnreachableNodes

Faz rollback do último patch no Oracle home DB_HOME_NAME e ignora nós inacessíveis durante o processo de rollback.

dbaascli dbimage Purge

O comando dbimage purge remove a imagem de software especificada do seu ambiente do Oracle Exadata Database Service on Exascale Infrastructure.

Conecte-se ao nó de computação como o usuário opc e execute esse comando como o usuário root.

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

No comando precedente:

  • software_version — especifica a versão do software Oracle Database. Por exemplo, 11204, 12102, 12201, 18000, 19000.

  • software_bp — identifica a release do patch do pacote. Por exemplo, APR2018, JAN2019, OCT2019 etc.

  • --cdb — especifica opcionalmente se a imagem de software que suporta a arquitetura multitenant Oracle deve ser removida. O padrão é yes. Se você especificar --cdb no, a imagem de software que contém os binários para suportar bancos de dados não contêineres (não CDB) será removida.

Se o comando for remover uma imagem de software que não está disponível no momento na biblioteca de imagens de software e, portanto, não pode ser baixada novamente, o comando será pausado e solicitará confirmação.

Não é possível remover a imagem de software padrão atual para qualquer versão de software. Para evitar essa restrição, é necessário tornar outra imagem de software o padrão atual.

dbaascli diag collect

Para coletar diagnóstico, use o comando dbaascli diag collect.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli diag collect [--components <value>] [--startTime <value>] [--endTime <value>] [--nodes <value>] [--dbNames <value>]
        {
            [--objectStoreBucketUri <value>]
            | [--destLocation <value>]
        }
        [--waitForCompletion <value>]
Em que:
  • --components especifica uma lista de componentes para a coleta de logs.

    Valores válidos:

    • db
    • gi
    • os
    • dbaastools
    • all
  • --startTime especifica o horário inicial da coleta de logs. Formato válido de data e hora: YYYY-MM-DDTHH24:MM:SS
  • --endTime especifica o horário final da coleta de logs. Formato válido de data e hora: YYYY-MM-DDTHH24:MM:SS
  • --nodes especifica uma lista de nós delimitados por vírgulas para coletar logs
  • --dbNames especifica o nome do banco de dados cujos logs serão coletados. Você só pode especificar um nome de banco de dados.
  • --objectStoreBucketURI especifica um URL de PAR (solicitação pré-autenticada) do serviço Object Storage usado para fazer upload de logs coletados. Os logs são coletados da VM Convidada. Para obter mais informações, consulte Usando Solicitações Pré-autenticadas.
  • --destLocation especifica o local na VM Convidada para coletar logs. Padrão: /var/opt/oracle/dbaas_acfs
  • --waitForCompletion Valores: true|false. Padrão: true. Especifique false para ser executado em segundo plano.

dbaascli diag healthCheck

Para executar verificações de integridade de diagnóstico, use o comando dbaascli diag healthCheck.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli diag healthCheck
[--destLocation]
[--nodes]
[--objectStoreBucketURI]
Em que:
  • --destLocation especifica o local na VM Convidada para coletar logs. Padrão: /var/opt/oracle/dbaas_acfs
  • --nodes especifica uma lista de nós delimitados por vírgulas para coletar logs
  • --objectStoreBucketURI especifica um URL de PAR (solicitação pré-autenticada) do serviço Object Storage usado para fazer upload de logs coletados. Os logs são coletados da VM Convidada. Para obter mais informações, consulte Usando Solicitações Pré-autenticadas.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli diag healthCheck?

R: O comando dbaascli diag healthCheck é usado para executar verificações de integridade de diagnóstico em um Oracle Database executado em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli diag healthCheck?

R: O comando deve ser executado como o usuário root e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: Como eu especifico um diretório personalizado para coletar os logs?

R: Use a opção --destLocation para especificar o diretório no qual os logs de verificação de integridade serão coletados. O local padrão é /var/opt/oracle/dbaas_acfs.

P: Qual será o local padrão para a coleta de logs se eu não especificar --destLocation?

A: O diretório padrão para coleta de logs é /var/opt/oracle/dbaas_acfs.

P: Posso especificar em quais nós executar a verificação de integridade?

R: Sim, você pode usar a opção --nodes para especificar uma lista de nós delimitados por vírgulas em que a verificação de integridade deve ser executada.

P: Como faço upload dos logs de verificação de integridade para o Object Storage?

A: Use a opção --objectStoreBucketURI para fornecer um URL de PAR (solicitação pré-autenticada) do serviço Object Storage. Isso fará upload dos logs coletados para o bucket especificado.

P: Posso coletar logs de vários nós?

R: Sim, você pode especificar vários nós usando a opção --nodes em um formato delimitado por vírgulas. Por exemplo: --nodes node1,node2.

P: Qual é um exemplo de comando para executar uma verificação de integridade em um nó específico?

A: Aqui está um exemplo de comando para executar a verificação de integridade em um nó específico:

dbaascli diag healthCheck --nodes node1

P: Como posso armazenar os logs no Object Storage em vez de na máquina local?

R: Você pode fornecer um URL de PAR (solicitação pré-autenticada) usando a opção --objectStoreBucketURI para armazenar os logs no Object Storage.

P: Posso especificar --destLocation e --objectStoreBucketURI ao mesmo tempo?

R: Sim, você pode especificar --destLocation para armazenamento local e --objectStoreBucketURI para fazer upload de logs para o Object Storage.

P: O que devo fazer se encontrar um erro ao executar o comando dbaascli diag healthCheck?

R: Certifique-se de que você esteja executando o comando como o usuário raiz e tenha fornecido opções válidas para --destLocation, --nodes ou --objectStoreBucketURI. Verifique se os nomes dos nós estão corretos, se especificados.

P: Posso executar a verificação de integridade em segundo plano?

R: O comando dbaascli diag healthCheck não tem um modo de fundo explícito, mas você pode executá-lo em segundo plano anexando & no final do comando.

P: O que acontece se eu não fornecer a opção --nodes?

R: Se a opção --nodes não for fornecida, a verificação de integridade será executada em todos os nós do cluster por padrão.

P: Posso retomar uma sessão de verificação de integridade anterior usando este comando?

R: Não, o comando dbaascli diag healthCheck não suporta a retomada das sessões anteriores. Você deve iniciar uma nova verificação de integridade todas as vezes.

P: Qual é um exemplo de comando para executar uma verificação de integridade e fazer upload de logs para o Object Storage?

A: Aqui está um exemplo de comando:

dbaascli diag healthCheck --objectStoreBucketURI https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL

P: Qual será o comportamento padrão se eu não especificar --destLocation ou --objectStoreBucketURI?

R: Se nem --destLocation nem --objectStoreBucketURI forem especificados, os logs de verificação de integridade serão coletados no diretório padrão /var/opt/oracle/dbaas_acfs na máquina local.

P: Posso limitar a verificação de integridade a componentes ou logs específicos?

R: Não, o comando dbaascli diag healthCheck não permite especificar componentes ou logs individuais. Ele executa uma verificação geral de saúde de diagnóstico para o sistema.

P: O que devo verificar antes de executar o comando dbaascli diag healthCheck?

R: Certifique-se de estar conectado a uma máquina virtual do Exadata Cloud@Customer e executando o comando como o usuário root.

dbaascli grid configureTCPS

Para configurar o TCPS para o cluster existente, use o comando dbaascli grid configureTCPS.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

Observação

Por padrão, o TCPS é ativado para bancos de dados em sistemas Oracle Exadata Database Service on Dedicated Infrastructure.
Observação

O TCPS não está ativado para bancos de dados nos sistemas Exadata Database Service on Cloud@Customer. Para ativar o TCPS para um determinado banco de dados, atualize o arquivo sqlnet.ora específico do banco de dados com WALLET_LOCATION = (SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=/var/opt/oracle/dbaas_acfs/grid/tcps_wallets))) em todos os nós de banco de dados e, em seguida, devolva o banco de dados. Isso ativará o uso do TCPS para o banco de dados. No entanto, ativar o TCPS fará com que a conexão ZDLRA falhe. Nos sistemas Exadata Database Service on Cloud@Customer, você pode ativar a configuração ZDLRA ou TCPS. A ativação de ZDLRA e TCPS simultaneamente não funcionará.
dbaascli grid configureTCPS
[--pkcs12WalletFilePath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Em que:
  • --pkcs12WalletFilePath especifica o caminho absoluto do arquivo de certificado, que está no formato de wallet pkcs12
  • --caCertChain lista concatenada de certificados, contendo certificados da CA intermediárias e da CA raiz
  • --precheckOnly especifica yes para só executar as pré-verificações desta operação. Valores válidos: yes ou no.
  • --serverCert especifica o caminho do certificado PEM a ser usado ou alternado para a configuração TCPS.
  • --privateKey especifica o caminho do arquivo de chave privada do certificado.
  • --certType tipo do certificado a ser adicionado à wallet do Grid Infrastructure. Os valores aceitos são: SELF_SIGNED_CERT, CA_SIGNED_CERT ou PKCS12_CERT. Padrão: SELF_SIGNED_CERT
  • --privateKeyPasswordProtected especifica se a chave privada é protegida por senha ou não. Valores válidos: true ou false. Padrão: true.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli grid configureTCPS?

A: O comando dbaascli grid configureTCPS é usado para configurar o TCPS (Transport Layer Security) para o cluster existente em um ambiente Oracle Exadata.

P: Qual é o pré-requisito para executar o comando dbaascli grid configureTCPS?

A: O comando deve ser executado como o usuário root.

P: O TCPS é ativado por padrão no Exadata Database Service em sistemas de Infraestrutura Dedicada?

R: Sim, o TCPS é ativado por padrão para bancos de dados em sistemas Oracle Exadata Database Service on Dedicated Infrastructure.

P: O TCPS é ativado por padrão nos sistemas Exadata Database Service on Cloud@Customer?

R: Não, o TCPS não é ativado por padrão nos sistemas Exadata Database Service on Cloud@Customer. Para ativar o TCPS, atualize o arquivo sqlnet.ora do banco de dados específico e reinicie o banco de dados.

P: Qual é a consequência de ativar o TCPS nos sistemas Exadata Cloud@Customer?

R: A ativação do TCPS nos sistemas Exadata Cloud@Customer fará com que as conexões do Zero Data Loss Recovery Appliance (ZDLRA) falhem. Você só pode ativar a configuração ZDLRA ou TCPS, mas não ambos simultaneamente.

P: O que a opção --pkcs12WalletFilePath especifica?

A: A opção --pkcs12WalletFilePath especifica o caminho absoluto para o arquivo de certificado no formato da wallet PKCS12, que é usado para configuração do TCPS.

P: Para que é usada a opção --caCertChain?

A: A opção --caCertChain especifica uma lista concatenada de certificados contendo certificados de CA intermediários e o certificado de CA raiz.

P: O que a opção --precheckOnly faz?

A: A opção --precheckOnly especifica se apenas as pré-verificações devem ser executadas para a operação de configuração do TCPS. Os valores aceitos são yes ou no.

P: O que a opção --serverCert especifica?

A: A opção --serverCert especifica o caminho para o certificado PEM que será usado ou girado para a configuração TCPS.

P: Como especificar a chave privada para a configuração do TCPS?

A: Use a opção --privateKey para especificar o caminho para o arquivo de chave privada associado ao certificado do servidor.

P: Quais são os valores aceitos para a opção --certType?

A: Os valores aceitos para a opção --certType são:

SELF_SIGNED_CERT

CA_SIGNED_CERT

PKCS12_CERT

O valor padrão é SELF_SIGNED_CERT.

P: A senha da chave privada é protegida por padrão?

R: Sim, a opção --privateKeyPasswordProtected é definida como true por padrão, indicando que a chave privada é protegida por senha. Você poderá defini-la como false se a chave privada não for protegida por senha.

P: Posso executar uma pré-verificação antes de configurar o TCPS?

R: Sim, você pode executar somente as pré-verificações da operação definindo a opção --precheckOnly como sim. Isso ajuda a validar o ambiente antes de fazer alterações.

P: O que acontece se eu fornecer um caminho incorreto para o arquivo da wallet PKCS12?

R: Se --pkcs12WalletFilePath contiver um caminho incorreto, o comando falhará e a configuração do TCPS não prosseguirá.

P: O que devo fazer se a chave privada estiver protegida por senha?

R: Se a chave privada for protegida por senha, certifique-se de que a opção --privateKeyPasswordProtected esteja definida como true (que é o padrão).

P: Posso especificar meu próprio certificado assinado pela CA para a configuração do TCPS?

R: Sim, você pode especificar seu próprio certificado assinado pela CA usando as opções --serverCert e --privateKey e definindo --certType como CA_SIGNED_CERT.

P: O que é um exemplo de comando para configurar o TCPS usando um certificado autoassinado?

A: Aqui está um exemplo:

dbaascli grid configureTCPS --serverCert /path/to/self_signed_cert.pem --privateKey /path/to/private_key.pem --certType SELF_SIGNED_CERT

P: Posso usar um certificado PKCS12 para configuração do TCPS?

R: Sim, você pode usar um certificado PKCS12 especificando a opção --pkcs12WalletFilePath e definindo --certType como PKCS12_CERT.

P: O que devo verificar antes de executar o comando dbaascli grid configureTCPS?

R: Verifique se você tem os arquivos de certificado corretos, arquivos de chave privada e se você está conectado como usuário raiz. Além disso, certifique-se de entender as implicações se estiver usando o ZDLRA, pois ele não pode ser executado simultaneamente com o TCPS.

Exemplo 6-27 dbaascli grid configureTCPS

Para configurar a grade usando o certificado autoassinado:
dbaascli grid configureTCPS
Para configurar a grade usando o certificado assinado pela 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 de grade dbaascli

Para aplicar patch no Oracle Grid Infrastructure para a versão secundária especificada, use o comando dbaascli grid patch.

Pré-requisitos

Execute o comando como usuário root.

Sintaxe

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>]

Em que:

  • --targetVersion especifica a versão de destino do Oracle Home indicada como cinco segmentos numéricos separados por pontos (por exemplo, 19.12.0.0.0)
  • --targetHome especifica o caminho totalmente qualificado do diretório home do Grid Infrastructure de destino para aplicação de patches out-of-place
  • --containerURL especifica o URL personalizado para extrair a imagem do Grid Infrastructure
  • Opção --executePrereqs para executar pré-requisitos
  • --nodeList especifica uma lista de nós delimitados por vírgulas se a aplicação de patch tiver de ser executada em um subconjunto de nós
  • --patchInParallel especifica para executar patches de nós remotos em paralelo
  • --rollback especifica para fazer rollback do Oracle home com patch
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --continueWithDbDowntime continua aplicando patch com tempo de inatividade do banco de dados. Essa opção pode ser usada em ambientes nos quais só há uma instância ativa e a operação de aplicação de patch pode continuar mesmo com um tempo de inatividade.
  • --drainTimeoutInSeconds especifica o tempo (em segundos) para concluir a descarga de recursos enquanto o banco de dados é interrompido
  • --createImage cria uma imagem com base em uma cópia do home do Grid ativo, com patch para a versão de destino especificada
    • --createImageDir especifica o caminho totalmente qualificado do diretório no qual a imagem será criada
  • --imageFile especifica o caminho totalmente qualificado da imagem a ser usada
  • --patchInParallel executa a aplicação de patch dos nós remotos em paralelo
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true|false

Perguntas Frequentes

P: O que o comando dbaascli grid patch faz?

A: O comando dbaascli grid patch é usado para aplicar patch ao Oracle Grid Infrastructure para uma versão secundária especificada.

P: Preciso de permissões especiais para executar o comando dbaascli grid patch?

R: Sim, você precisa executar o comando dbaascli grid patch como o usuário root.

P: Posso especificar uma versão de destino ao aplicar patch ao Oracle Grid Infrastructure?

R: Sim, você pode especificar a versão de destino usando a opção --targetVersion.

P: Como especifico a versão de destino do patch?

R: Use a opção --targetVersion seguida do número da versão no formato 19.12.0.0.0.

P: O que a opção --containerURL faz no comando dbaascli grid patch?

A: A opção --containerURL permite especificar um URL personalizado para extrair a imagem do Grid Infrastructure.

P: Qual é a finalidade da opção --executePrereqs?

A: A opção --executePrereqs é usada para executar verificações de pré-requisitos antes de aplicar o patch.

P: Como posso aplicar patch a um subconjunto de nós usando o comando dbaascli grid patch?

A: Use a opção --nodeList seguida de uma lista delimitada por vírgulas de nomes de nós para aplicar patch apenas a um subconjunto de nós.

P: O que acontece se eu usar a opção --rollback?

A: A opção --rollback fará rollback do Oracle home com patch para seu estado anterior.

P: Posso retomar uma sessão de aplicação de patch anterior?

R: Sim, você pode usar a opção --resume para retomar a última sessão de aplicação de patch. Se você tiver um ID de sessão específico, poderá especificá-lo com a opção --sessionID.

P: Para que é usada a opção --continueWithDbDowntime?

A: A opção --continueWithDbDowntime permite que você continue aplicando patches mesmo que haja tempo de inatividade do banco de dados, geralmente usado em ambientes em que há apenas uma instância ativa.

P: Como faço para criar uma imagem de um Grid home com patch?

A: Use a opção --createImage para criar uma imagem. Você pode especificar o diretório em que a imagem deve ser criada usando a opção --createImageDir.

P: Qual é a finalidade da opção --imageFile?

A: A opção --imageFile permite especificar o caminho totalmente qualificado do arquivo de imagem a ser usado para aplicação de patches.

P: Como posso executar o comando dbaascli grid patch em segundo plano?

R: Você pode usar a opção --waitForCompletion definida como false para executar a operação em segundo plano.

P: Posso usar um URL personalizado para extrair a imagem do patch?

R: Sim, você pode usar a opção --containerURL para especificar um URL personalizado para extrair a imagem do Grid Infrastructure.

P: Como especifico quais nós aplicar patch se não quiser aplicar patch a todos eles?

R: Você pode especificar os nós que deseja aplicar patch usando a opção --nodeList com uma lista de nomes de nós separados por vírgulas.

P: O que devo fazer se precisar fazer rollback de um patch?

A: Use a opção --rollback no comando dbaascli grid patch para fazer rollback do patch.

P: Como lidar com uma operação de aplicação de patch se meu ambiente tiver apenas uma instância ativa e precisar continuar com o tempo de inatividade?

A: Use a opção --continueWithDbDowntime para continuar a aplicação de patch mesmo com o tempo de inatividade do banco de dados.

P: Posso criar uma imagem do Grid home corrigido?

R: Sim, você pode usar a opção --createImage para criar uma imagem do Grid home com patch. Se necessário, especifique o diretório em que a imagem deve ser salva usando --createImageDir.

P: O que devo fazer se quiser retomar uma sessão de aplicação de patches após uma interrupção?

A: Use a opção --resume para retomar a sessão de aplicação de patch. Se você souber o ID da sessão, poderá especificá-lo com --sessionID.

P: E se o processo de aplicação de patch falhar no meio do caminho?

R: Se o processo de aplicação de patch falhar, você poderá usar a opção --resume para reiniciar o processo. Você também pode usar a opção --rollback para reverter para o estado anterior.

P: Como posso garantir que todos os pré-requisitos sejam atendidos antes da aplicação de patch?

R: Use a opção --executePrereqs para executar todas as verificações de pré-requisitos antes de aplicar o patch.

Q: Posso executar a correção em segundo plano para evitar segurar o terminal?

R: Sim, você pode usar a opção --waitForCompletion false para executar o processo de aplicação de patch em segundo plano.

P: Como posso criar uma imagem do Grid home após a aplicação de patch?

A: Use a opção --createImage para criar uma nova imagem do Grid home com patch. Especifique o diretório usando --createImageDir, se necessário.

P: Como eu uso um arquivo de imagem existente para aplicação de patches?

R: Você pode usar a opção --imageFile para especificar o caminho totalmente qualificado para o arquivo de imagem que deseja usar para aplicação de patch.

P: O que devo fazer se quiser evitar o tempo de inatividade do banco de dados durante a aplicação de patches?

R: Certifique-se de que seu ambiente tenha mais de uma instância ativa em execução. Você pode evitar o uso da opção --continueWithDbDowntime, que se destina a ambientes com apenas uma instância ativa.

P: Como eu sei o progresso de um patch em execução em segundo plano?

R: Se você executar o patch com --waitForCompletion false, poderá verificar o status do job em segundo plano usando comandos do sistema operacional como ps ou verificar os logs localizados no Grid home.

P: É possível aplicar patch a uma versão principal superior usando o patch de grade dbaascli?

R: Não, dbaascli grid patch só permite aplicação de patch a uma versão secundária da versão principal atual. Para atualizações importantes, você precisará seguir um processo de atualização diferente.

P: Posso ignorar verificações de pré-requisitos específicas durante a aplicação de patch?

R: Não, quando você usar --executePrereqs, todas as verificações de pré-requisitos serão executadas. No entanto, você pode revisar os resultados das verificações de pré-requisitos e tratar manualmente quaisquer problemas antes de continuar.

P: O que devo fazer se o processo de correção estiver preso ou pendurado?

R: Se o processo de aplicação de patch não responder, você poderá interrompê-lo usando comandos do sistema operacional e retomá-lo usando a opção --resume. Se isso não funcionar, tente usar a opção --rollback para reverter o patch.

P: Posso automatizar o processo de aplicação de patches em vários clusters?

R: Sim, usando scripts que incluem o comando dbaascli grid patch com opções apropriadas, você pode automatizar a aplicação de patches em diferentes clusters.

P: Onde posso encontrar logs para o processo de aplicação de patch?

R: Em geral, os logs estão localizados no diretório de logs do Oracle Grid home ou no local padrão especificado durante a configuração. Você pode monitorar esses logs para obter detalhes sobre o processo de aplicação de patch.

P: É possível criar um processo de patch silencioso sem interação do usuário?

R: Sim, especificando todas as opções necessárias no comando e executando-o em segundo plano (--waitForCompletion false), você pode criar um processo de aplicação de patch não interativo.

P: Posso verificar se há atualizações de patch disponíveis antes de aplicar um patch?

R: O próprio comando dbaascli grid patch não tem uma opção para listar patches disponíveis. No entanto, você pode usar os métodos padrão da Oracle, como o Suporte Técnico da Oracle, para identificar os patches mais recentes.

P: Posso usar dbaascli para aplicar patch a vários Oracle Homes?

R: Não, o comando dbaascli grid patch foi projetado para aplicar patch a um home específico do Oracle Grid Infrastructure de cada vez. Você precisaria executar o comando separadamente para cada home.

P: Existe uma maneira de evitar completamente o tempo de inatividade ao aplicar patch ao Grid Infrastructure?

R: Para minimizar o tempo de inatividade, certifique-se de que seu ambiente tenha várias instâncias de banco de dados ativas (configuração RAC) para que a aplicação de patches possa ser feita nó por nó. A opção --continueWithDbDowntime não deve ser usada neste caso.

P: Como lidar com a aplicação de patches para ambientes RAC One Node?

R: Em ambientes RAC One Node, você precisa ser cauteloso com a opção --continueWithDbDowntime, pois pode haver apenas uma instância ativa. Revise a documentação da Oracle para obter diretrizes de aplicação de patches específicas para o RAC One Node.

P: Posso exibir o histórico de sessões de patches anteriores?

R: O utilitário dbaascli não fornece uma maneira direta de exibir o histórico da sessão. No entanto, os logs de sessões de aplicação de patch anteriores podem ser encontrados no diretório de logs do Grid home.

Exemplo de Casos de Uso

Exemplo 1: Aplicação Básica de Patches de Grade

dbaascli grid patch --targetVersion 19.12.0.0.0

Corrige o Oracle Grid Infrastructure para a versão 19.12.0.0.0.

Exemplo 2: Aplicação de Patch com um URL de Contêiner Personalizado

dbaascli grid patch --targetVersion 19.12.0.0.0 --containerURL https://example.com/custom/url

Corrige o Grid Infrastructure para a versão 19.12.0.0.0, usando um URL de contêiner personalizado para extrair a imagem do Grid Infrastructure.

Exemplo 3: Aplicação de Patch com Verificações de Pré-requisitos

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs

Corrige o Grid Infrastructure para a versão 19.12.0.0.0 após executar as verificações de pré-requisitos.

Exemplo 4: Aplicação de Patch em um Subconjunto de Nós

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2,node3

Corrige o Grid Infrastructure para a versão 19.12.0.0.0 nos nós especificados (node1, node2 e node3).

Exemplo 5: Fazendo Rollback do Patch

dbaascli grid patch --rollback

Faz rollback do último patch aplicado no Oracle Grid Infrastructure.

Exemplo 6: Retomando uma Operação de Patch Anterior

dbaascli grid patch --resume

Retoma a operação de aplicação de patch anterior de onde ela foi interrompida.

Exemplo 7: Retomando uma Operação de Patch com um ID de Sessão Específico

dbaascli grid patch --resume --sessionID 12345

Retoma a operação de aplicação de patch usando o ID de sessão 12345.

Exemplo 8: Patch com Tempo de Inatividade do Banco de Dados Permitido

dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime

Corrige o Grid Infrastructure para a versão 19.12.0.0.0, permitindo o tempo de inatividade do banco de dados, se necessário.

Exemplo 9: Criando uma Imagem com Patch

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir

Cria uma imagem do Grid home com patch (versão 19.12.0.0.0) e a armazena no diretório especificado.

Exemplo 10: Usando um Arquivo de Imagem Existente

dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /path/to/image/file.zip

Corrige o Grid Infrastructure para a versão 19.12.0.0.0 usando um arquivo de imagem existente localizado em /path/to/image/file.zip.

Exemplo 11: Executando a Operação de Aplicação de Patch em Segundo Plano

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false

Corrige o Grid Infrastructure para a versão 19.12.0.0.0 e executa a operação em segundo plano.

Exemplo 12: Combinação de Pré-requisitos, URL Personalizado e Subconjunto de Nós

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --containerURL https://example.com/custom/url --nodeList node1,node2

Aplica o Grid Infrastructure à versão 19.12.0.0.0, executa verificações de pré-requisitos, usa um URL personalizado para a imagem e aplica o patch apenas em node1 e node2.

Exemplo 13: Criando uma Imagem com Patch com um Arquivo de Imagem Existente

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir --imageFile /path/to/existing/image.zip

Cria uma imagem corrigida e a armazena no diretório especificado ao usar um arquivo de imagem existente para o patch.

Exemplo 14: Verificando Pré-requisitos sem Aplicação de Patch

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs

Verifica se todos os pré-requisitos foram atendidos para aplicação de patch na versão 19.12.0.0.0 sem realmente aplicar o patch.

Exemplo 15: Executando Patch e Ignorando Falhas de Pré-requisito

dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime --executePrereqs

Executa o patch mesmo que algumas verificações de pré-requisitos falhem. Isso é útil em cenários em que o tempo de inatividade é permitido e determinados pré-requisitos podem ser ignorados.

Exemplo 16: Verificando Problemas nos Logs de Patch

tail -f /u01/app/grid/logs/grid_patch.log

Monitora o log de patch em tempo real para diagnosticar quaisquer problemas durante o processo de aplicação de patch.

Exemplo 17: Aplicando o Patch em um Ambiente Paralelo

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2 --waitForCompletion false

Corrige o Grid Infrastructure em um subconjunto de nós (node1 e node2) e executa o processo em segundo plano.

Exemplo 18: Usando um Arquivo de Imagem Específico de uma Origem Externa

dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /mnt/images/grid_patch_19.12.zip

Corrige o Grid Infrastructure usando um arquivo de imagem pré-download localizado em um dispositivo de armazenamento externo.

Exemplo 19: Executando Patch com um ID de Sessão Personalizado

dbaascli grid patch --targetVersion 19.12.0.0.0 --resume --sessionID 67890

Retoma uma operação de aplicação de patch que foi interrompida, usando o ID de sessão 67890.

Exemplo 20: Programando a Aplicação de Patches para Execução Posterior

echo "dbaascli grid patch --targetVersion 19.12.0.0.0" | at 02:00

Programa o comando de aplicação de patch para ser executado às 2:00 AM usando o comando at no Linux.

Exemplo 21: Especificando o Tempo Limite para Conclusão

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion true --continueWithDbDowntime --timeout 7200

Corrige o Grid Infrastructure enquanto permite tempo de inatividade, mas aguarda até 7200 segundos (2 horas) para conclusão antes do timeout.

Exemplo 22: Criando uma Imagem Personalizada para Outro Ambiente

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /backups/images/grid_patch

Cria uma imagem personalizada do Grid Infrastructure com patch para armazenar no diretório /backups/images/grid_patch para uso em outros ambientes.

Exemplo 23: Recuperação de Patch Após a Interrupção

dbaascli grid patch --resume --continueWithDbDowntime

Recupera e retoma o processo de aplicação de patches se ele tiver sido interrompido, com tempo de inatividade do banco de dados permitido.

Exemplo 24: Combinando a Verificação de Pré-requisitos com a Execução em Segundo Plano

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --waitForCompletion false

Verifica pré-requisitos e executa o patch em segundo plano.

Exemplo 25: Ignorando a Criação de Imagem para Aplicação de Patch Mais Rápida

dbaascli grid patch --targetVersion 19.12.0.0.0 --patchInParallel --continueWithDbDowntime --waitForCompletion false

Corrige o Grid Infrastructure para a versão 19.12.0.0.0 em paralelo entre nós, com tempo de inatividade do banco de dados permitido e sem criar uma imagem para acelerar o processo.

Exemplo 26: Monitorando o Andamento do Patch por meio de Logs

tail -f /u01/app/grid/logs/grid_patch_progress.log

Monitora o arquivo de log para o progresso da aplicação de patches em tempo real, fornecendo insights sobre cada etapa do processo de aplicação de patches.

Exemplo 27: Aplicação de Patches com Timeout de Drenagem Personalizado

dbaascli grid patch --targetVersion 19.12.0.0.0 --drainTimeoutInSeconds 3600 --continueWithDbDowntime

Corrige o Grid Infrastructure e define um timeout personalizado de 1 hora (3600 segundos) para permitir a drenagem normal de recursos durante o tempo de inatividade do banco de dados.

Exemplo 28: Aplicando um Patch a Nós Específicos com Verificações de Pré-requisito

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node4 --executePrereqs

Corrige apenas os nós node1 e node4 para a versão 19.12.0.0.0 e executa as verificações de pré-requisitos antecipadamente.

Exemplo 29: Aplicação de Patch sem Aguardar Conclusão

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false

Começa a aplicar patch no Grid Infrastructure para a versão 19.12.0.0.0 em segundo plano, permitindo que outras tarefas sejam executadas sem aguardar a conclusão do processo.

Exemplo 30: Reaplicando um Patch com Falha Após um Problema de Timeout de Drenagem

dbaascli grid patch --resume --drainTimeoutInSeconds 7200

Retoma a sessão de aplicação de patch anterior e estende o timeout de drenagem do recurso para 2 horas (7200 segundos), caso ele falhe devido ao tempo insuficiente na tentativa anterior.

Exemplo 31: Exibindo Logs de Patch em Tempo Real com ID de Sessão Específico

tail -f /u01/app/grid/logs/grid_patch_12345.log

Monitora o arquivo de log da sessão de aplicação de patch com o ID de sessão 12345 em tempo real.

Exemplo 32: Aplicação de Patch em um Novo Home de Destino

dbaascli grid patch --targetHome /u01/app/grid_home_19c --executePrereqs

Executa um patch fora do local para um novo home do Oracle Grid localizado em /u01/app/grid_home_19c, com verificações de pré-requisitos.

Exemplo 33: Interrompendo um Job de Patch em Segundo Plano

ps -ef | grep dbaascli | grep patch | awk '{print $2}' | xargs kill -9

Interrompe um job de patch em segundo plano localizando e eliminando o ID do processo associado (PID).

Exemplo 34: Verificando a Conclusão de Patches sem Logs

dbaascli grid status --targetVersion 19.12.0.0.0

Verifica se o patch para a versão 19.12.0.0.0 foi aplicado com sucesso verificando o status da versão atual do Grid Infrastructure.

dbaascli grid removeTCPSCert

Para remover certificados TCPS existentes da wallet do Grid Infrastructure, use o comando dbaascli grid removeTCPSCert.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli grid removeTCPSCert --subject <value>
 {
   --userCert | --trustedCert | --requestedCert
 }
 [--serialNumber <value>] [--executePrereqs] [--resume [--sessionID <value>]] [--bounceListeners]
Em que:
  • --subject especifica o assunto do certificado
  • Flag --userCert para indicar o certificado do usuário
  • Flag --trustedCert para indicar um certificado confiável
  • flag --requestedCert para indicar um certificado solicitado
  • --serialNumber especifica o número de série do certificado
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • Flag --bounceListeners para devolver o listener do Grid Infrastructure e verificar o listener

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli grid removeTCPSCert?

R: O comando dbaascli grid removeTCPSCert é usado para remover certificados TCPS existentes da wallet do Grid Infrastructure em um ambiente Oracle Exadata.

P: Qual é o pré-requisito para executar o comando dbaascli grid removeTCPSCert?

A: O comando deve ser executado como o usuário root.

P: O que a opção --subject especifica no comando dbaascli grid removeTCPSCert?

A: A opção --subject especifica o assunto do certificado a ser removido da wallet do Grid Infrastructure.

P: Qual é a finalidade do flag --userCert?

R: O flag --userCert indica que o certificado a ser removido é um certificado do usuário.

P: Quando devo usar o flag --trustedCert?

A: Use o flag --trustedCert ao remover um certificado confiável da wallet do Grid Infrastructure.

P: O que o flag --requestedCert faz?

A: O flag --requestedCert indica que o certificado que está sendo removido é um certificado solicitado.

P: O que a opção --serialNumber especifica?

A: A opção --serialNumber especifica o número de série do certificado a ser removido. É útil para identificar exclusivamente um certificado quando há vários certificados com o mesmo assunto.

P: Qual é a finalidade da opção --executePrereqs?

A: A opção --executePrereqs executa verificações de pré-requisitos antes de remover o certificado e reporta os resultados, garantindo que o ambiente esteja devidamente preparado para a operação.

P: O que a opção --resume faz?

A: A opção --resume retoma a operação de remoção se ela tiver sido interrompida anteriormente.

P: Como especificar um ID de sessão ao retomar uma operação interrompida?

R: Use a opção --sessionID para especificar o ID da sessão da operação interrompida que você deseja retomar.

P: O que o flag --bounceListeners faz?

R: O flag --bounceListeners é usado para reiniciar o listener do Grid Infrastructure e verificar o listener após a remoção do certificado TCPS.

P: Posso remover um certificado TCPS sem devolver os listeners?

R: Sim, o flag --bounceListeners é opcional. Se você não especificá-lo, os listeners não serão devolvidos automaticamente.

Q: Como posso garantir que a operação será executada com segurança?

R: Você pode usar a opção --executePrereqs para executar verificações de pré-requisitos antes de executar o comando, garantindo que tudo esteja em ordem antes do processo de remoção.

P: O que devo fazer se precisar remover um certificado de usuário específico por número de série?

A: Use a opção --subject para especificar o assunto do certificado, o flag --userCert para indicar que ele é um certificado do usuário e a opção --serialNumber para especificar o número de série do certificado.

P: Posso remover vários certificados de uma só vez?

R: Não, o comando é projetado para remover um único certificado de cada vez com base no assunto fornecido e em outros parâmetros.

P: O que acontece se o processo de remoção do certificado for interrompido?

R: Você pode retomar a operação usando a opção --resume junto com o --sessionID do processo interrompido.

P: Preciso executar o comando como usuário raiz?

R: Sim, o comando dbaascli grid removeTCPSCert deve ser executado como o usuário root para ter os privilégios necessários para remover certificados TCPS.

P: Como posso identificar o certificado que quero remover?

R: Você pode identificar o certificado pelo seu assunto e, opcionalmente, pelo seu número de série para garantir que você está direcionando o certificado correto para remoção.

P: O que é um exemplo de comando para remover um certificado confiável?

A: Este é um exemplo:

dbaascli grid removeTCPSCert --subject "CN=example_cert" --trustedCert

dbaascli grid rotateTCPSCert

Para alternar certificados TCPS, use o comando dbaascli grid rotateTCPSCert.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli grid rotateTCPSCert
[--pkcs12WalletFilePath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Em que:
  • --pkcs12WalletFilePath especifica o caminho absoluto do arquivo de certificado, que está no formato de wallet pkcs12
  • --caCertChain lista concatenada de certificados, contendo certificados da CA intermediárias e da CA raiz
  • --precheckOnly especifica yes para só executar as pré-verificações desta operação. Valores válidos: yes ou no.
  • --serverCert especifica o caminho do certificado PEM a ser usado ou alternado para a configuração TCPS.
  • --privateKey especifica o caminho do arquivo de chave privada do certificado.
  • --certType tipo do certificado a ser adicionado à wallet do Grid Infrastructure. Os valores aceitos são: SELF_SIGNED_CERT, CA_SIGNED_CERT ou PKCS12_CERT. Padrão: SELF_SIGNED_CERT
  • --privateKeyPasswordProtected especifica se a chave privada é protegida por senha ou não. Valores válidos: true ou false. Padrão: true.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli grid rotateTCPSCert?

R: O comando dbaascli grid rotateTCPSCert é usado para rotacionar certificados TCPS (Transport Layer Security Protocol) na wallet do Grid Infrastructure em ambientes Oracle Exadata.

P: Qual é o pré-requisito para executar o comando dbaascli grid rotateTCPSCert?

A: O comando deve ser executado como o usuário root.

P: O que a opção --pkcs12WalletFilePath especifica?

A: A opção --pkcs12WalletFilePath especifica o caminho absoluto para o arquivo de certificado no formato da wallet PKCS12 para a configuração do TCPS.

P: Qual é a finalidade da opção --caCertChain?

A: A opção --caCertChain especifica uma lista concatenada de certificados, incluindo CA intermediária e certificados de CA raiz, para a configuração TCPS.

P: O que a opção --precheckOnly faz?

R: A opção --precheckOnly permite executar pré-verificações sem fazer alterações reais. Os valores válidos são "yes" para executar somente as pré-verificações e "no" para prosseguir com a rotação.

P: Como a opção --serverCert é usada?

A: A opção --serverCert especifica o caminho para o certificado do servidor PEM (Privacy Enhanced Mail) que é usado ou rotacionado para a configuração do TCPS.

P: O que a opção --privateKey especifica?

A: A opção --privateKey especifica o caminho para o arquivo de chave privada correspondente ao certificado do servidor usado para rotação TCPS.

P: Quais são os valores válidos para a opção --certType?

A: A opção --certType aceita os seguintes valores para especificar o tipo de certificado a ser adicionado à wallet do Grid Infrastructure:

SELF_SIGNED_CERT (padrão)

CA_SIGNED_CERT

PKCS12_CERT

P: O que a opção --privateKeyPasswordProtected faz?

A: A opção --privateKeyPasswordProtected indica se a chave privada é protegida por senha. Os valores válidos são true (padrão) e false

P: Posso executar o comando dbaascli grid rotateTCPSCert sem girar os certificados?

R: Sim, usando a opção sim --precheckOnly, você só pode executar as pré-verificações sem girar os certificados.

P: Qual é um exemplo de comando para rotacionar um certificado usando uma wallet PKCS12?

A: Aqui está um exemplo de comando:

dbaascli grid rotateTCPSCert --pkcs12WalletFilePath /path/to/wallet.p12 --certType PKCS12_CERT

P: Como rotaciono um certificado de servidor com uma cadeia de certificados assinada pela CA?

A: Use as opções --serverCert e --caCertChain, conforme mostrado abaixo:

dbaascli grid rotateTCPSCert --serverCert /path/to/serverCert.pem --caCertChain /path/to/caChain.pem

P: O que acontece se eu não especificar --privateKeyPasswordProtected?

A: Se você não especificar a opção --privateKeyPasswordProtected, o comando assumirá que a chave privada é protegida por senha (padrão: true).

Q: Posso girar um certificado autoassinado?

R: Sim, você pode rotacionar um certificado autoassinado usando a opção --certType SELF_SIGNED_CERT padrão ou especificando-a explicitamente.

P: Como posso rotacionar um certificado sem fornecer uma chave privada?

R: Para determinados tipos de certificado, como PKCS12, talvez você não precise fornecer um arquivo de chave privada separado, pois ele está incluído na wallet. No entanto, se uma chave privada for necessária, ela deverá ser fornecida usando a opção --privateKey.

P: E se eu quiser girar um certificado em segundo plano?

R: O comando dbaascli grid rotateTCPSCert não fornece uma opção explícita para execução em segundo plano. Você pode executar o comando diretamente em uma sessão em segundo plano (por exemplo, usando nohup ou ferramentas semelhantes).

P: Qual será o tipo de certificado padrão se não for especificado?

A: O tipo de certificado padrão é SELF_SIGNED_CERT.

Exemplo 6-28 dbaascli grid rotateTCPSCert

Para alternar o certificado usando o certificado autoassinado (opção padrão):
dbaascli grid rotateTCPSCert
Para alternar o certificado usando o certificado assinado pela 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

dbaascli grid upgrade

Para fazer upgrade do Oracle Grid Infrastrucure de uma versão principal para outra, use o comando dbaascli grid upgrade.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli grid upgrade --version
[--resume]
[--executePrereqs]
[--containerURL]
[--softwareOnly]
[--targetHome]
[--revert]
Em que:
  • --version especifica a versão de destino
  • --resume retoma a execução anterior
  • --executePrereqs executa pré-requisitos para upgrade do Grid Infrastrucure
  • --containerUrl especifica o URL personalizado para extrair a imagem do Grid Infrastrucure
  • --softwareOnly só instala o software do Grid Infrastructure
  • --targetHome especifica o caminho do home da Grade de destino existente
  • --revert reverte a execução com falha

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli grid upgrade?

R: O comando dbaascli grid upgrade é usado para fazer upgrade do Oracle Grid Infrastructure de uma versão principal para outra em uma máquina virtual do Exadata Cloud@Customer.

P: Qual é o pré-requisito para executar o comando dbaascli grid upgrade?

R: O comando deve ser executado como o usuário root e você precisa estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: O que a opção --version especifica?

A: A opção --version especifica a versão de destino do Oracle Grid Infrastructure para a qual você deseja fazer upgrade.

P: O que a opção --resume faz?

A: A opção --resume retoma um processo de upgrade do Grid Infrastructure interrompido ou com falha anteriormente.

P: Como a opção --executePrereqs é usada?

A: A opção --executePrereqs executa apenas as verificações de pré-requisitos para o upgrade do Grid Infrastructure sem executar o upgrade real.

P: Qual é a finalidade da opção --containerURL?

A: A opção --containerURL especifica um URL personalizado para extrair a imagem de software do Grid Infrastructure para o upgrade.

P: O que a opção --softwareOnly faz?

A: A opção --softwareOnly instala somente o software Grid Infrastructure sem configurar ou fazer upgrade do ambiente Grid.

P: Quando você usaria a opção --targetHome?

A: A opção --targetHome especifica o caminho para o Grid home de destino existente no qual o upgrade será executado.

P: O que acontece se o upgrade falhar?

R: Se o upgrade falhar, você poderá usar a opção --revert para fazer rollback do upgrade para seu estado anterior.

P: Posso executar um upgrade do Grid Infrastructure em estágios?

R: Sim, usando a opção --softwareOnly, você pode primeiro instalar o software e depois concluir o upgrade completo, permitindo upgrades preparados.

P: Como eu uso o comando dbaascli grid upgrade para fazer upgrade somente do software?

A: Use a seguinte sintaxe para fazer upgrade somente do software:

dbaascli grid upgrade --version <target_version> --softwareOnly

P: Posso verificar se há pré-requisitos de upgrade sem executar o upgrade?

R: Sim, você só pode executar as verificações de pré-requisitos usando:

dbaascli grid upgrade --version <target_version> --executePrereqs

P: Como posso fazer upgrade do Grid Infrastructure usando um URL de contêiner personalizado?

A: Você pode especificar o URL para extrair a imagem do Grid Infrastructure da seguinte forma:

dbaascli grid upgrade --version <target_version> --containerURL <custom_url>

P: Como posso retomar um processo de upgrade interrompido anteriormente?

A: Para retomar um upgrade interrompido ou com falha anteriormente, use:

dbaascli grid upgrade --version <target_version> --resume

P: O que a opção --revert faz no comando dbaascli grid upgrade?

A: A opção --revert faz rollback de um upgrade do Grid Infrastructure com falha ou interrompido para seu estado original.

P: Posso executar um upgrade completo sem configurar o Grid Infrastructure imediatamente?

R: Sim, você pode primeiro instalar apenas o software usando a opção --softwareOnly e depois configurá-lo posteriormente.

P: O que devo fazer se um upgrade falhar e eu quiser desfazer as alterações?

A: Use a opção --revert para fazer rollback do upgrade com falha:

dbaascli grid upgrade --version <target_version> --revert

Exemplo 6-29 dbaascli grid upgrade

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

dbaascli job getStatus

Para exibir o status de um job especificado, use o comando dbaascli job getStatus.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli job getStatus --jobID
Em que:
  • --jodID especifica o ID do job

Exemplo 6-30 dbaascli job getStatus

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

dbaascli patch db apply

Observação

Os comandos dbaascli patch db prereq e dbaascli patch db apply foram descontinuados na release 21.2.1.2.0 do dbaascli e substituídos por dbaascli grid patch, dbaascli dbhome patch e dbaascli database move.
Para obter mais informações, consulte:
  • dbaascli grid patch
  • dbaascli dbhome patch
  • dbaascli database move
  • Aplicando Patch no Oracle Grid Infrastructure e em Bancos de Dados Oracle com o Utilitário dbaascli

dba0cli patch db prereq

Observação

Os comandos dbaascli patch db prereq e dbaascli patch db apply foram descontinuados na release 21.2.1.2.0 do dbaascli e substituídos por dbaascli grid patch, dbaascli dbhome patch e dbaascli database move.
Para obter mais informações, consulte:
  • dbaascli grid patch
  • dbaascli dbhome patch
  • dbaascli database move
  • Aplicando Patch no Oracle Grid Infrastructure e em Bancos de Dados Oracle com o Utilitário dbaascli

dbaascli pdb backup

Para fazer backup de um banco de dados plugável (PDB), consultar backups de PDB e excluir um backup de PDB, use o comando dbaascli pdb backup.

Pré-requisito

  • Execute o comando como usuário root.

Sintaxe

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>]
        }
Em que:
--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.]

Perguntas Frequentes

P: Qual é a finalidade do comando de backup dbaascli pdb?

R: O comando dbaascli pdb backup é usado para criar backups para um banco de dados plugável (PDB), consultar o status do backup, gerar relatórios de backup e excluir backups do PDB em um ambiente Exadata Cloud@Customer.

P: Qual é o pré-requisito para usar o comando de backup dbaascli pdb?

R: O comando deve ser executado como o usuário root e você precisa estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: Como inicio um backup do PDB usando o comando de backup dbaascli PDB?

R: Você pode iniciar um backup do PDB usando a opção --start. Por exemplo:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start

P: Quais opções podem ser usadas com o sinalizador --start?

A: Com o flag --start, você pode especificar:

--level1 para um backup incremental de Nível 1

--archival para um backup de arquivamento completo (que também requer um --tag para especificar a tag de backup)

P: Como crio um backup de PDB incremental de Nível 1?

A: Use o flag --level1 com a opção --start para criar um backup incremental de Nível 1:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --level1

P: Como crio um backup de PDB de arquivamento?

A: Use o flag --archival com a opção --start e especifique uma tag de backup usando --tag:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --archival --tag <backup_tag>

P: Como excluo um backup específico do PDB?

A: Para excluir um backup específico, use o flag --delete e especifique a tag de backup usando --backupTag:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --delete --backupTag <backup_tag>

P: Como posso verificar o status de um backup do PDB?

A: Use o flag --status junto com o backup --uuid para verificar o status de um backup específico:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --status --uuid <backup_uuid>

P: Como recupero um relatório de backup do PDB no formato JSON?

A: Para obter um relatório de backup no formato JSON, use a opção --getBackupReport, especifique o nome do arquivo com --json e forneça a tag de backup com --tag:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --getBackupReport --json <file_name> --tag <backup_tag>

P: Como posso listar todos os backups do PDB para um PDB específico?

A: Use a opção --list para obter uma lista de todos os backups de um determinado PDB:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list

Opcionalmente, você pode gerar a lista no formato JSON usando o flag --json:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list --json <file_name>

P: O que a opção --pdbName faz?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) para o qual você deseja fazer backup, consultar ou excluir backups.

P: Qual é a finalidade da opção --dbname?

A: A opção --dbname especifica o nome do Oracle Database ao qual o PDB pertence.

P: Como especifico uma tag de backup para um backup do PDB?

A: Você especifica uma tag de backup usando a opção --tag ao iniciar um backup de arquivamento ou ao recuperar um relatório de backup:

--tag <backup_tag>

P: Posso executar backups de PDB no modo JSON?

R: Sim, as opções de relatório de backup (--getBackupReport) e listagem de backup (--list) suportam saída no formato JSON. Você especifica um nome de arquivo JSON usando a opção --json.

Exemplo 6-31 Exemplos

  • Para fazer backup level1 de um PDB pdb1 em um CDB myTestDb:
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --start --level1
  • Para consultar o status da solicitação de backup do PDB submetida com uuid eef16b26361411ecb13800163e8e4fac:
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --status --uuid eef16b26361411ecb13800163e8e4fac

dbaascli pdb bounce

Para devolver um banco de dados plugável (PDB), use o comando dbaascli pdb bounce.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb bounce --dbname --pdbName | --pdbUID
[–openMode]
Em que:
  • --dbname especifica o nome do banco de dados contêiner que hospeda o PDB
  • --pdbName especifica o nome do PDB
  • --pdbUID especifica o identificador do PDB
  • --openMode especifica o destino OPEN MODE do PDB

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb bounce?

R: O comando dbaascli pdb bounce é usado para devolver (reiniciar) um banco de dados plugável (PDB) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli pdb bounce?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: Como faço para devolver um PDB especificando seu nome?

A: Para devolver um PDB especificando seu nome, use a seguinte sintaxe:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name>

P: Como faço para devolver um PDB usando seu identificador exclusivo (UID)?

A: Para devolver um PDB usando seu identificador exclusivo (UID), use a seguinte sintaxe:

dbaascli pdb bounce --dbname <CDB_Name> --pdbUID <PDB_UID>

P: Para que é usada a opção --dbname?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) que está sendo devolvido.

P: Para que é usada a opção --pdbName?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) que você deseja devolver.

P: Para que é usada a opção --pdbUID?

A: A opção --pdbUID especifica o identificador exclusivo (UID) do banco de dados plugável (PDB) que você deseja devolver.

P: Como especifico o modo de abertura do alvo para o PDB quando ele é devolvido?

R: Você pode usar a opção --openMode para especificar o modo de abertura desejado para o PDB após o bouncing. Os valores válidos são READ_WRITE e READ_ONLY. Por exemplo:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE

P: Posso abrir o PDB no modo somente para leitura após devolvê-lo?

R: Sim, você pode usar a opção --openMode READ_ONLY para abrir o PDB no modo somente leitura após o bouncing:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_ONLY

P: Qual será o modo aberto padrão se --openMode não for especificado?

R: Se --openMode não for especificado, o PDB será aberto em seu modo de abertura padrão, que geralmente é READ_WRITE.

P: Posso usar --pdbName e --pdbUID no mesmo comando?

R: Não, você deve especificar --pdbName ou --pdbUID, mas não ambos no mesmo comando.

P: Como posso reiniciar um PDB e garantir que ele seja aberto no modo de leitura e gravação?

A: Para reiniciar um PDB e garantir que ele seja aberto no modo de leitura e gravação, use a opção --openMode READ_WRITE:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE

P: É obrigatório especificar o modo de abertura ao usar o comando dbaascli pdb bounce?

A: Não, especificar --openMode é opcional. Se não for fornecido, o PDB será aberto em seu modo padrão.

P: O que acontece se eu não especificar o flag --openMode?

R: Se o flag --openMode não for especificado, o PDB será aberto em seu modo padrão, que geralmente é READ_WRITE.

Exemplo 6-32 dbaascli pdb bounce

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

dbaascli pdb close

Para fechar um banco de dados plugável (PDB), use o comando dbaascli pdb close.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb close --dbname --pdbName | --pdbUID
Em que:
  • --dbname especifica o nome do banco de dados contêiner que hospeda o PDB.
  • --pdbname especifica o nome do PDB que você deseja fechar.
  • --pdbUID especifica o identificador do PDB

Após a conclusão bem-sucedida da execução desse comando, o PDB é fechado em todas as instâncias do banco de dados contêiner.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb close?

R: O comando dbaascli pdb close é usado para fechar um banco de dados plugável (PDB) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli pdb close?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: Como fecho um PDB especificando seu nome?

A: Para fechar um PDB especificando seu nome, use a seguinte sintaxe:

dbaascli pdb close --dbname <CDB_Name> --pdbName <PDB_Name>

P: Como fecho um PDB especificando seu identificador exclusivo (UID)?

A: Para fechar um PDB usando seu identificador exclusivo (UID), use a seguinte sintaxe:

dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>

P: O que a opção --dbname faz no comando dbaascli pdb close?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) que você deseja fechar.

P: O que a opção --pdbName faz no comando dbaascli pdb close?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) que você deseja fechar.

P: Qual é a finalidade da opção --pdbUID no comando dbaascli pdb close?

A: A opção --pdbUID permite especificar o identificador exclusivo (UID) do banco de dados plugável (PDB) que você deseja fechar.

P: Posso fechar o PDB em uma instância específica do CDB?

R: Não, após a conclusão bem-sucedida, o PDB é fechado em todas as instâncias do CDB (banco de dados contêiner).

P: É possível especificar --pdbName e --pdbUID no mesmo comando?

R: Não, você pode especificar --pdbName ou --pdbUID, mas não ambos no mesmo comando.

P: O que acontece quando o comando dbaascli pdb close é concluído com sucesso?

R: Quando o comando é concluído com sucesso, o banco de dados plugável (PDB) é fechado em todas as instâncias do banco de dados contêiner (CDB).

P: Como eu fecho um PDB específico em um CDB usando seu UID?

A: Você pode fechar um PDB específico usando seu UID executando:

dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>

P: O que acontece se eu esquecer de especificar --pdbName ou --pdbUID?

A: Você deve especificar --pdbName ou --pdbUID no comando. Se nenhum for fornecido, o comando não será executado.

P: Posso usar o comando dbaascli pdb close para um CDB diretamente?

R: Não, o comando é projetado para fechar um banco de dados plugável (PDB) dentro de um banco de dados contêiner (CDB), não o próprio CDB.

Exemplo 6-33 dbaascli pdb close

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

dbaascli pdb getConnectString

Para exibir informações da string de conexão do Oracle Net para um banco de dados plugável (PDB), execute o comando dbaascli pdb getConnectString.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb getConnectString --dbname --pdbName | --pdbUID
Em que:
  • --dbname especifica o nome do banco de dados contêiner que hospeda o PDB
  • --pdbname especifica o nome do PDB cujas informações da string de conexão você deseja exibir
  • --pdbUID especifica o identificador do PDB

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb getConnectString?

R: O comando dbaascli pdb getConnectString é usado para exibir as informações da string de conexão do Oracle Net para um banco de dados plugável (PDB) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli pdb getConnectString?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: Como recupero a string de conexão de um PDB especificando seu nome?

A: Para recuperar a string de conexão especificando o nome do PDB, use a seguinte sintaxe:

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbName <PDB_Name>

P: Como recupero a string de conexão de um PDB especificando seu identificador exclusivo (UID)?

A: Para recuperar a string de conexão usando o identificador exclusivo (UID) do PDB, use a seguinte sintaxe:

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>

P: O que a opção --dbname faz no comando dbaascli pdb getConnectString?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) para o qual você deseja exibir as informações da string de conexão.

P: O que a opção --pdbName faz no comando dbaascli pdb getConnectString?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) para o qual você deseja recuperar as informações da string de conexão do Oracle Net.

P: Qual é a finalidade da opção --pdbUID no comando dbaascli pdb getConnectString?

A: A opção --pdbUID permite especificar o identificador exclusivo (UID) do banco de dados plugável (PDB) para o qual você deseja exibir a string de conexão.

P: Posso usar --pdbName e --pdbUID no mesmo comando?

R: Não, você pode usar --pdbName ou --pdbUID, mas não ambos no mesmo comando.

P: Que tipo de informação é retornado pelo comando dbaascli pdb getConnectString?

A: O comando retorna as informações da string de conexão do Oracle Net para o banco de dados plugável (PDB) especificado.

P: Posso recuperar a string de conexão de um PDB em uma instância de banco de dados contêiner específica?

R: Não, a string de conexão é para o PDB como um todo, não para uma instância específica do banco de dados contêiner.

P: Como posso obter as informações da string de conexão se souber apenas o identificador exclusivo (UID) do PDB?

A: Você pode recuperar a string de conexão usando o UID do PDB executando:

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>

P: O que acontece se eu não fornecer --pdbName ou --pdbUID?

A: Você deve especificar --pdbName ou --pdbUID para recuperar a string de conexão. O comando não será executado sem uma dessas opções.

P: As informações da string de conexão do PDB são sempre as mesmas em todas as instâncias do CDB?

R: Sim, as informações da string de conexão são consistentes para o PDB em todas as instâncias do banco de dados contêiner (CDB).

Exemplo 6-34 dbaascli pdb getConnectString

dbaascli pdb getConnectString --dbname dbname --pdbName pdbName

dbaascli pdb create

Para criar um novo banco de dados plugável (PDB), use o comando dbaascli pdb create.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

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>]
Em que:
  • --pdbName especifica o nome do novo PDB que você deseja criar
  • --dbName especifica o nome do banco de dados contêiner que hospeda o novo PDB
  • --maxCPU especifica opcionalmente o número máximo de CPUs que estão disponíveis ao PDB. A definição dessa opção é efetivamente o mesmo que definir o parâmetro CPU_COUNT no PDB
  • --maxSize especifica opcionalmente o tamanho total máximo dos arquivos de dados e temporários para tablespaces pertencentes ao PDB. A definição dessa opção é efetivamente o mesmo que definir a cláusula de armazenamento MAXSIZE PDB no comando SQL CREATE PLUGGABLE DATABASE. Você pode impor um limite especificando um número inteiro seguido de uma unidade de tamanho (K, M, G ou T) ou pode especificar UNLIMITED para não impor explicitamente qualquer limite
  • --pdbAdminUserName especifica o novo nome do usuário administrador do PDB
  • --lockPDBAdminAccount especifica true ou false para bloquear a conta de usuário administrador do PDB. O valor default é verdadeiro.
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --executePrereqs especifica yes para só executar os pré-requisitos desta operação. Valores válidos: yes ou no
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true ou false
  • --blobLocation - local de diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG.
  • --standbyBlobFromPrimary especifica o local do arquivo blob stand-by, que é preparado usando o banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by.
    Observe que

    os parâmetrosblobLocation e standbyBlobFromPrimary são mutuamente exclusivos.

Durante o processo de criação do PDB, você é solicitado a especificar a senha de administração do novo PDB.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb create?

R: O comando dbaascli pdb create é usado para criar um novo banco de dados plugável (PDB) em um banco de dados contêiner (CDB) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli pdb create?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: O que a opção --pdbName faz no comando dbaascli pdb create?

A: A opção --pdbName especifica o nome do novo banco de dados plugável (PDB) que você deseja criar.

P: O que a opção --dbName faz no comando dbaascli pdb create?

A: A opção --dbName especifica o nome do banco de dados contêiner (CDB) que hospedará o novo banco de dados plugável (PDB).

P: Posso limitar os recursos de CPU para o novo PDB?

R: Sim, você pode usar a opção --maxCPU para especificar o número máximo de CPUs que o PDB pode usar. Isso é equivalente a definir o parâmetro CPU_COUNT no PDB.

P: Como posso limitar o tamanho do armazenamento de um PDB?

R: Você pode usar a opção --maxSize para especificar o tamanho total máximo de arquivos de dados e arquivos temporários para o PDB. Você pode definir um limite de tamanho (em K, M, G ou T) ou especificar UNLIMITED para nenhum limite.

P: Para que é usada a opção --pdbAdminUserName?

A: A opção --pdbAdminUserName especifica o nome do usuário administrador do novo PDB. Esse usuário terá privilégios administrativos no PDB.

P: É possível bloquear a conta do usuário administrador durante a criação do PDB?

R: Sim, você pode usar a opção --lockPDBAdminAccount para especificar se a conta de administrador do PDB deve ser bloqueada. O valor default é true (bloqueado).

P: O que a opção --resume faz no comando dbaascli pdb create?

A: A opção --resume permite retomar um processo de criação de PDB com falha anterior.

P: Como especificar um ID de sessão para retomar uma execução anterior?

R: Você pode especificar um ID de sessão usando a opção --sessionID para retomar uma sessão específica do processo de criação do PDB.

P: Qual é a finalidade da opção --executePrereqs?

A: A opção --executePrereqs especifica se apenas as verificações de pré-requisito devem ser executadas para a criação do PDB. Você pode definir essa opção como yes ou no.

P: Posso executar o processo de criação do PDB em segundo plano?

R: Sim, você pode usar a opção --waitForCompletion e defini-la como falsa para executar a operação em segundo plano.

P: Para que é usada a opção --standbyBlobFromPrimary?

A: A opção --standbyBlobFromPrimary especifica o local do arquivo blob stand-by, que é preparado no banco de dados principal. Isso é necessário para operações de PDB do banco de dados stand-by.

P: Como serei solicitado a informar a senha de administrador do PDB durante o processo de criação?

R: Durante o processo de criação do PDB, você será solicitado a especificar a senha de administração do novo PDB.

P: Posso criar um PDB stand-by usando o comando dbaascli PDB create?

R: Sim, se você estiver criando um PDB stand-by, poderá usar a opção --standbyBlobFromPrimary para especificar a localização do arquivo blob stand-by no banco de dados principal.

P: O que acontece se eu não usar a opção --maxSize?

R: Se você não especificar a opção --maxSize, o PDB não terá um limite de tamanho de armazenamento, a menos que seja definido de outra forma pelas políticas do CDB.

P: O que acontece se eu não fornecer a opção --pdbAdminUserName?

R: Se você não fornecer a opção --pdbAdminUserName, o PDB será criado sem um usuário administrador especificado e você precisará configurar manualmente o usuário administrador após a criação.

P: Posso retomar a criação de um PDB com falha em qualquer ponto do processo?

R: Sim, desde que a sessão não tenha sido encerrada, você poderá retomar a criação de um PDB com falha usando as opções --resume e --sessionID.

Exemplo 6-35 dbaascli pdb create

Para criar um PDB desde a constituição em um banco de dados padrão, em um ambiente que não seja do Data Guard:
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --maxsize 5G --maxcpu 2
Para criar o PDB no ambiente do Data Guard:
dbaascli pdb create --dbName db721 --pdbName new_pdb1
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --standbyBlobFromPrimary /tmp/send_db721.tar

dbaascli pdb createSnapshot

Para criar um snapshot de um determinado banco de dados plugável (PDB), use o comando dbaascli pdb createSnapshot.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb createSnapshot
{
    --pdbName <value> | --pdbUID <value>
}
--dbName <value>
--snapshotName <value>
[--pdbAdminUserName <value>]
[--executePrereqs] [--resume [--sessionID <value>]]
[--waitForCompletion true|false]

Em que:

  • --pdbName especifica o nome do PDB pelo qual será criado o snapshot.
  • --pdbUID especifica o ID do usuário (UID) do PDB do qual o snapshot será criado.
  • --dbName Nome do Oracle Database.
  • --snapshotName especifica o nome do snapshot do PDB.
  • --pdbAdminUserName especifica o nome do usuário administrador do PDB.
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados.
  • --resume [--sessionID <value>] retoma a operação anterior. Ele pode usar o flag --sessionID <value> para especificar a retomada de um ID de sessão específico (<value>).
  • --waitForCompletion true|false especifica se a operação deve ser executada em primeiro plano (true) ou em segundo plano (false). Valores válidos: true, false.

Exemplo 6-36 dbaascli pdb createSnapshot

No exemplo a seguir, um snapshot é criado com base no banco de dados chamado db721, no nome do PDB pdb1. O nome do snapshot fornecido é snap1.

dbaascli pdb createSnapshot --dbName db721 --pdbName pdb1 --snapshotName snap1

dbaascli pdb configureSnapshot

Para configurar snapshots automáticos para um determinado banco de dados plugável (PDB), use o comando dbaascli pdb configureSnapshot.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb configureSnapshot
{
    --pdbName <value> | --pdbUID <value>
}
--dbName <value>
--snapshotIntervalInMins <value>
[--executePrereqs]
[--maxPDBSnapshots <value>]
[--waitForCompletion <value>]

Em que:

  • --pdbName <value> especifica o nome do PDB para o qual a configuração de snapshot automático será definida.
  • --pdbUID <value> especifica o ID do usuário (UID) do PDB para o qual a configuração de snapshot automático será definida.
  • --dbName Nome do Oracle Database.
  • --snapshotIntervalInMins <value> especifica o intervalo, em minutos, para quando snapshots automáticos do PDB serão tirados.
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados.
  • --maxPDBSnapshots <value>] especifica o número máximo de snapshots a serem criados para o PDB fornecido. .
  • --waitForCompletion true|false especifica se a operação deve ser executada em primeiro plano (true) ou em segundo plano (false). Valores válidos: true, false.

Exemplo 6-37 dbaascli pdb configureSnapshot

No exemplo a seguir, um plano de snapshot automático é configurado no banco de dados chamado db721, no nome do PDB pdb1. O intervalo de snapshot é definido para executar a criação automática de snapshot a cada 60 minutos.

dbaascli pdb configureSnapshot --dbName db721 --pdbName pdb1 --snapshotIntervalInMins 60

dbaascli pdb delete

Para excluir um banco de dados plugável (PDB), execute o comando dbaascli pdb delete.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb delete --dbName value 
{ --pdbName value | --pdbUID value }
[--executePrereqs value]
[--waitForCompletion value]
[--resume [--sessionID value]]
[--allStandbyPrepared]
[--cleanupRelocatedPDB]
Em que:
  • --dbName especifica o nome do banco de dados contêiner que hospeda o PDB
  • --pdbName especifica o nome do PDB que você deseja excluir
  • --pdbUID especifica o UID do PDB que você deseja excluir
  • --executePrereqs especifica yes para só executar os pré-requisitos desta operação. Valores válidos: yes ou no
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true ou false
  • --resume especifica para retomar a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --allStandbyPrepared especifica para confirmar se a operação foi executada com sucesso em todos os bancos de dados stand-by
  • --cleanupRelocatedPDB - opção para limpar o banco de dados de origem após a realocação de um PDB.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb delete?

R: O comando dbaascli pdb delete é usado para excluir um banco de dados plugável (PDB) de um banco de dados contêiner (CDB) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para executar o comando dbaascli pdb delete?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: O que a opção --dbName especifica no comando dbaascli pdb delete?

A: A opção --dbName especifica o nome do banco de dados contêiner (CDB) que hospeda o PDB que você deseja excluir.

P: Como posso especificar qual PDB excluir usando o comando dbaascli PDB delete?

R: Você pode especificar o PDB a ser excluído usando a opção --pdbName (especifica o nome do PDB) ou a opção --pdbUID (especifica o UID do PDB).

P: Posso executar as verificações de pré-requisitos sem realmente excluir o PDB?

R: Sim, você pode usar a opção --executePrereqs e defini-la como yes para executar apenas as verificações de pré-requisitos da operação de exclusão do PDB.

P: Como posso executar o processo de exclusão do PDB em segundo plano?

A: Use a opção --waitForCompletion e defina-a como false para executar o processo de exclusão em segundo plano.

P: O que a opção --resume faz no comando dbaascli pdb delete?

A: A opção --resume permite retomar um processo de exclusão do PDB com falha anterior.

P: Como retomo uma sessão específica para exclusão de um PDB?

R: Você pode especificar um ID de sessão usando a opção --sessionID para retomar uma sessão específica para o processo de exclusão do PDB.

P: O que a opção --allStandbyPrepared faz?

A: A opção --allStandbyPrepared é usada para confirmar se a operação de exclusão foi executada com sucesso em todos os bancos de dados stand-by antes de prosseguir com a exclusão do PDB principal.

P: Qual é a finalidade da opção --cleanupRelocatedPDB?

A: A opção --cleanupRelocatedPDB limpa o banco de dados de origem depois que um PDB é realocado, garantindo que nenhum resíduo seja deixado após a realocação.

P: Posso excluir um PDB que já foi realocado?

R: Sim, você pode usar a opção --cleanupRelocatedPDB para excluir um PDB que já foi realocado para um novo CDB.

P: Como garantir que a operação de exclusão seja executada com sucesso em bancos de dados stand-by?

R: Use a opção --allStandbyPrepared para confirmar se a operação foi executada com sucesso em todos os bancos de dados stand-by antes de continuar.

P: O que acontece se o processo de exclusão falhar e precisar ser retomado?

R: Você pode retomar o processo de exclusão usando a opção --resume e, se necessário, especificar o ID da sessão com --sessionID.

P: O que a definição --waitForCompletion como falso faz?

R: A definição de --waitForCompletion como false permite que o processo de exclusão seja executado em segundo plano, permitindo que você continue trabalhando sem aguardar a conclusão da operação.

Exemplo: dbaascli pdb delete

Para excluir um PDB de um banco de dados padrão em um ambiente que não seja do Data Guard ou do banco de dados Stand-by no ambiente do Data Guard.

dbaascli pdb delete --dbName db721 --pdbName pdb1

Para criar o PDB do banco de dados Principal no ambiente do Data Guard:

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

dbaascli pdb deleteSnapshot

Para excluir um snapshot de um determinado banco de dados plugável (PDB), use o comando dbaascli pdb deleteSnapshot.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb deleteSnapshot
{
    --pdbName <value> | --pdbUID <value>
}
{
    --snapshotName <value> | --snapshotUID <value>
}
--dbName <value>
[--executePrereqs]
[--waitForCompletion <value>
[--resume [--sessionID <value>]
]
]

Em que:

  • --pdbName <value> especifica o nome do PDB para o qual a configuração de snapshot automático será definida.
  • --pdbUID <value> especifica o ID do usuário (UID) do PDB para o qual a configuração de snapshot automático será definida.
  • --snapshotName <value> especifica o nome do snapshot do PDB que você deseja excluir.
  • --snapshotUID <value> especifica o ID do usuário (UID) do snapshot do PDB que você deseja excluir.
  • --dbName especifica o nome do Oracle Database.
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados.
  • --waitForCompletion true|false especifica se a operação deve ser executada em primeiro plano (true) ou em segundo plano (false). Valores válidos: true, false.
  • --resume [sessionID <value>] especifica para retomar a operação anterior. Para especificar a retomada de um ID de sessão específico, adicione o flag sessionID e forneça o número do ID da sessão.

Exemplo 6-38 dbaascli pdb configureSnapshot

No exemplo a seguir, o snapshot snap1 do PDB é especificado para exclusão no PDB chamado pdb1, para o banco de dados chamado db721:

dbaascli pdb deleteSnapshot --dbName db721 --pdbName pdb1 --snapshotName snap1

dbaascli pdb getDetails

Para exibir detalhes de um banco de dados plugável (PDB), use o comando dbaascli pdb getDetails.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb getDetails --dbname --pdbName | --pdbUID
Em que:
  • --dbname especifica o nome do banco de dados contêiner que hospeda o PDB
  • --pdbname especifica o nome do PDB que você deseja excluir
  • --pdbUID especifica o identificador do PDB

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb getDetails?

R: O comando dbaascli pdb getDetails é usado para exibir detalhes de um banco de dados plugável (PDB) hospedado em um banco de dados contêiner (CDB) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para executar o comando dbaascli pdb getDetails?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: O que a opção --dbname especifica no comando dbaascli pdb getDetails?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o PDB cujos detalhes você deseja exibir.

P: Como você especifica o PDB cujos detalhes deseja exibir?

R: Você pode especificar o PDB usando a opção --pdbName (para fornecer o nome do PDB) ou a opção --pdbUID (para fornecer o UID do PDB).

P: Qual é a diferença entre --pdbName e --pdbUID?

A: A opção --pdbName usa o nome do PDB para extrair detalhes, enquanto a opção --pdbUID usa o identificador exclusivo (UID) do PDB para extrair seus detalhes.

P: Posso usar --pdbName e --pdbUID juntos no comando dbaascli pdb getDetails?

R: Não, você pode especificar a opção --pdbName ou --pdbUID para obter detalhes do PDB, mas não os dois ao mesmo tempo.

P: Quais são alguns casos de uso do comando dbaascli pdb getDetails?

A: Você pode usar o comando dbaascli pdb getDetails para:
  • Recuperar detalhes sobre um PDB específico em um CDB.
  • Verifique a configuração de um PDB.
  • Verifique o status de um PDB dentro de um CDB.

P: Como posso exibir detalhes de um PDB com base em seu nome?

A: Para exibir detalhes de um PDB com base em seu nome, use a seguinte sintaxe:

dbaascli pdb getDetails --dbname <CDB_Name> --pdbName <PDB_Name>

P: Como posso exibir detalhes de um PDB com base em seu UID?

A: Para exibir detalhes de um PDB com base em seu UID, use a seguinte sintaxe:

dbaascli pdb getDetails --dbname <CDB_Name> --pdbUID <PDB_UID>

P: Esse comando pode ser usado para vários PDBs em uma execução?

R: Não, o comando pode ser usado para extrair detalhes de um PDB de cada vez especificando seu nome ou UID.

Exemplo 6-39 dbaascli pdb getDetails

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

dbaascli pdb getSnapshot

Para obter detalhes de um determinado snapshot de banco de dados plugável (PDB), use o comando dbaascli pdb getSnapshot.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb getSnapshot
{
    --pdbName <value>| --pdbUID <value>
}
{
    --snapshotName <value> | --snapshotUID <value>
}
--dbName <value>

Em que:

  • --pdbName <value> especifica o nome do PDB cujos detalhes você deseja obter.
  • --pdbUID <value> especifica o ID do usuário (UID) do PDB para o snapshot cujos detalhes você deseja obter.
  • --snapshotName <value> especifica o nome do snapshot cujos detalhes você deseja obter
  • --snapshotUID <value> especifica o ID do usuário (UID) do snapshot cujos detalhes você deseja obter.
  • --dbName especifica o nome do Oracle Database.

Exemplo 6-40 dbaascli pdb configureSnapshot

No exemplo a seguir, os detalhes são obtidos para o snapshot chamado snap1 no banco de dados chamado db721, no nome do PDB pdb1:

dbaascli pdb getSnapshot --dbName db721 --pdbName pdb1 --snapshotName snap1

dbaascli pdb list

Para exibir a lista de bancos de dados plugáveis (PDB) em um banco de dados contêiner, use o comando dbaascli pdb list.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb list --dbname
Em que:
  • --dbname especifica o nome do banco de dados contêiner que hospeda o PDB

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb list?

R: O comando dbaascli pdb list é usado para exibir a lista de bancos de dados plugáveis (PDBs) em um banco de dados contêiner (CDB) especificado em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para executar o comando dbaascli pdb list?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: O que a opção --dbname especifica no comando dbaascli pdb list?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda os bancos de dados plugáveis (PDBs) para os quais você deseja exibir a lista.

P: Posso exibir a lista de PDBs de vários bancos de dados contêineres de uma só vez?

R: Não, o comando dbaascli pdb list permite listar os PDBs de apenas um banco de dados contêiner (CDB) por vez, especificado pela opção --dbname.

P: Como listo os PDBs em um banco de dados contêiner (CDB) específico?

R: Você pode listar os PDBs em um CDB específico usando a seguinte sintaxe:

dbaascli pdb list --dbname <CDB_Name>

P: Quais informações são exibidas ao usar o comando dbaascli pdb list?

R: O comando retorna uma lista de todos os bancos de dados plugáveis (PDBs) dentro do banco de dados contêiner (CDB) especificado. A lista geralmente inclui os nomes dos PDBs e possivelmente outros detalhes, como seu status.

P: Posso filtrar a lista de PDBs usando opções adicionais?

R: Não, o comando dbaascli pdb list não suporta opções de filtragem adicionais. Ele simplesmente retorna a lista completa de PDBs no CDB especificado.

P: O que acontece se o --dbname especificado não existir ou estiver incorreto?

R: Se o --dbname especificado estiver incorreto ou não existir, o comando retornará um erro e nenhuma lista de PDB será exibida.

P: O comando dbaascli pdb list pode ser usado para qualquer ambiente de banco de dados Oracle?

R: Não, o comando dbaascli pdb list foi projetado especificamente para uso nos ambientes Exadata Cloud@Customer.

Exemplo 6-41 dbaascli pdb list

dbaascli pdb list --dbname cdb name

dbaascli pdb listSnapshots

Para listar os snapshots de um determinado banco de dados plugável (PDB), use o comando dbaascli pdb listSnapshots.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb listSnapshots
{
    --pdbName <value> | --pdbUID <value>
}
--dbName <value>

Em que:

  • --pdbName <value> especifica o nome do PDB para o qual os snapshots serão listados.
  • --pdbUID <value> especifica o UID do PDB para o qual os snapshots serão listados.
  • --dbName <value> especifica o nome do Oracle Database.

Exemplo 6-42 dbaascli pdb listSnapshots

No exemplo a seguir, o comando lista os snapshots do banco de dados db721 e o nome do pdb pdb1:

dbaascli pdb listSnapshots --dbName db721 --pdbName pdb1

dbaascli pdb localClone

Para criar um novo banco de dados plugável (PDB) como clone de um PDB existente, no mesmo banco de dados contêiner (CDB), use o comando dbaascli pdb localClone.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

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>]
Em que:
  • --pdbName especifica o nome do novo PDB que você deseja clonar
  • --dbName especifica o nome do banco de dados
  • --targetPDBName especifica o nome do PDB de destino (novo PDB clonado)
  • --powerLimit especifica o grau de paralelismo a ser usado para a operação de clonagem. O valor válido fica entre 1 e 128
  • --maxCPU especifica o número máximo de CPUs a serem alocadas para o PDB
  • --maxSize especifica o tamanho máximo do armazenamento em GB para o novo PDB
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --executePrereqs especifica yes para só executar os pré-requisitos desta operação. Valores válidos: yes ou no
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true ou false
  • --blobLocation local de diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG.
  • --standbyBlobFromPrimary especifica o local do arquivo blob stand-by, que é preparado usando o banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by.
    Observação

    Os parâmetros --blobLocation e --standbyBlobFromPrimary são mutuamente exclusivos.
  • Opção --excludeUserTablespaces para ignorar tablespaces do usuário, exemplo t1,t2,t3.
  • --excludePDBData especifica true/yes para ignorar dados do usuário do pdb de origem.
  • --pdbAdminUserName especifica o novo nome do usuário administrador do PDB.
  • --lockPDBAdminAccount especifica true ou false para bloquear a conta de usuário administrador do PDB. O valor default é verdadeiro.
  • --sourcePDBServiceConvertList especifica uma lista separada por vírgulas de nomes de serviços de origem para destino que precisam ser convertidos. A sintaxe é source_srv1:new_srv1,source_srv2:new_srv2.

O PDB recém-clonado herda senhas de administração do PDB de origem.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb localClone?

R: O comando dbaascli pdb localClone é usado para criar um novo banco de dados plugável (PDB) como clone de um PDB existente no mesmo banco de dados contêiner (CDB) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para executar o comando dbaascli pdb localClone?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer. Além disso, o PDB de origem já deve existir no CDB especificado.

P: O que a opção --dbName especifica no comando dbaascli pdb localClone?

A: A opção --dbName especifica o nome do banco de dados contêiner (CDB) que hospeda o PDB de origem do qual o novo PDB será clonado.

P: O que a opção --pdbName especifica no comando dbaascli pdb localClone?

A: A opção --pdbName especifica o nome do novo PDB que você deseja criar como clone do PDB existente no mesmo CDB.

P: Posso clonar um PDB com outro nome usando o comando dbaascli PDB localClone?

R: Sim, você pode especificar outro nome para o PDB clonado usando a opção --targetPDBName. Se essa opção não for fornecida, o PDB clonado herdará o nome do PDB de origem.

P: O que a opção --resume faz no comando dbaascli pdb localClone?

A: A opção --resume permite retomar uma operação de clonagem do PDB interrompida anteriormente.

P: Como limitar os recursos de CPU disponíveis para o PDB clonado?

R: Você pode limitar os recursos de CPU do PDB clonado usando a opção --maxCPU, que especifica o número máximo de CPUs que serão alocadas para o novo PDB.

P: Posso executar a operação de clonagem do PDB em segundo plano?

R: Sim, você pode executar a operação em segundo plano definindo a opção --waitForCompletion como false. Se você defini-la como true, a operação será executada em primeiro plano e aguardará a conclusão.

P: Qual é a finalidade da opção --maxSize no comando dbaascli pdb localClone?

A: A opção --maxSize especifica o tamanho máximo de armazenamento (em GB) para o PDB recém-clonado. Se nenhum tamanho for especificado, o PDB clonado herdará os mesmos limites de armazenamento que o PDB de origem.

P: Posso controlar o paralelismo da operação de clonagem do PDB?

R: Sim, você pode controlar o grau de paralelismo da operação de clonagem usando a opção --powerLimit. Esta opção aceita valores entre 1 e 128 para definir o grau de paralelismo.

P: Para que é usada a opção --primaryDBWalletTar?

A: A opção --primaryDBWalletTar especifica o local do arquivo tar da wallet do banco de dados principal. Essa opção só será necessária se a operação de clonagem envolver operações do PDB do banco de dados stand-by.

P: Posso executar somente as verificações de pré-requisitos para a operação de clonagem?

R: Sim, você só pode executar as verificações de pré-requisitos usando a opção --executePrereqs e definindo-a como yes. Os valores válidos são yes e no.

P: O que acontece se a operação de clonagem do PDB falhar ou for interrompida?

R: Se a operação de clonagem falhar ou for interrompida, você poderá retomá-la usando a opção --resume para continuar de onde a operação foi interrompida.

Exemplo 6-43 dbaascli pdb localClone

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

dbaascli pdb open

Para abrir um banco de dados plugável (PDB), use o comando dbaascli pdb open.

Execute o comando como usuário root ou oracle.

Sintaxe

dbaascli pdb open
 {
   --pdbName <value> | --pdbUID <value>
 }
--dbname <value> [--openMode <value>] [--startServices <value>] [--waitForCompletion <value>] [--setPDBRefreshModeNone [--skipPDBRefresh] [--pdbAdminUserName <value>]]
Em que:
  • --pdbName especifica o nome do PDB que você deseja abrir
  • --pdbUID especifica o identificador do PDB
  • --dbname especifica o nome do banco de dados contêiner que hospeda o PDB.
  • --openMode especifica o destino OPEN MODE do PDB
  • --startServices: especifica que vai iniciar todos ou listar todos os serviços correspondentes a um PDB. Os valores aceitos são all ou uma lista de serviços do PDB delimitada por vírgulas.
  • --waitForCompletion: especifica false para executar a operação em segundo plano. Valores válidos: true|false
  • --setPDBRefreshModeNone: especifica a conversão de um PDB atualizável em um PDB não atualizável
    • --skipPDBRefresh: especifica que vai ignorar a atualização do PDB atualizável
    • --pdbAdminUserName: - especifica o novo nome do usuário administrador do PDB

Após a conclusão bem-sucedida, o PDB é aberto em todas as instâncias do banco de dados contêiner.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb open?

R: O comando dbaascli pdb open é usado para abrir um banco de dados plugável (PDB) em um banco de dados contêiner (CDB) da Oracle em um ambiente Exadata Cloud@Customer.

P: Quem pode executar o comando dbaascli pdb open?

R: O comando pode ser executado como o usuário root ou oracle.

P: O que a opção --pdbName especifica no comando dbaascli pdb open?

A: A opção --pdbName especifica o nome do PDB que você deseja abrir.

P: O que a opção --pdbUID especifica no comando dbaascli pdb open?

A: A opção --pdbUID especifica o identificador exclusivo (UID) do PDB que você deseja abrir.

P: O que a opção --dbname especifica no comando dbaascli pdb open?

A: A opção --dbname especifica o nome do CDB (banco de dados contêiner) que hospeda o PDB.

P: Qual é a finalidade da opção --openMode?

A: A opção --openMode especifica o modo no qual o PDB será aberto. Os valores válidos são READ_WRITE e READ_ONLY.

P: Posso iniciar serviços ao abrir o PDB?

R: Sim, você pode usar a opção --startServices para iniciar todos os serviços associados ao PDB especificando todos ou fornecer uma lista delimitada por vírgulas de serviços específicos para iniciar.

P: O que acontece se eu definir a opção --waitForCompletion como falsa?

R: Se --waitForCompletion estiver definido como false, o comando será executado em segundo plano e o usuário não precisará aguardar a conclusão da operação. Se definido como true, o comando aguardará a conclusão antes de sair.

P: O que a opção --setPDBRefreshModeNone faz?

A: A opção --setPDBRefreshModeNone converte um PDB atualizável (um que é atualizado regularmente de um banco de dados principal) em um PDB não atualizável.

P: Qual é a função da opção --skipPDBRefresh?

R: A opção --skipPDBRefresh permite ignorar a operação de atualização ao abrir um PDB atualizável, impedindo que o PDB seja sincronizado com o banco de dados principal nesse momento.

P: O que a opção --pdbAdminUserName faz no comando dbaascli pdb open?

A: A opção --pdbAdminUserName permite especificar um novo nome de usuário administrador do PDB ao abrir o PDB.

P: O que acontece se o comando dbaascli pdb open for bem-sucedido?

R: Após a conclusão bem-sucedida, o PDB especificado será aberto em todas as instâncias do banco de dados contêiner (CDB).

P: É possível executar o comando dbaascli PDB open para um PDB atualizável?

R: Sim, o comando pode ser usado para PDBs atualizáveis. A opção --setPDBRefreshModeNone converte o PDB em não atualizável e a opção --skipPDBRefresh ignora a operação de atualização durante o processo de abertura.

P: Qual será o modo de abertura padrão de um PDB se não --openMode for especificado?

R: Se nenhum --openMode for especificado, o PDB geralmente será aberto no modo READ_WRITE por padrão.

Exemplo 6-44 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

Opcional: --openMode READ_WRITE/READ_ONLY

dbaascli pdb recovery

Para recuperar um banco de dados plugável (PDB), use o comando dbaascli pdb recover.

Pré-requisito

  • Execute o comando como usuário root.
  • O banco de dados deve ser configurado com detalhes do destino de armazenamento de backup em que os backups são armazenados.

Sintaxe

dbaascli pdb recover --pdbName <value> --dbname <value>
        {
            --start
                {
                    --untilTime <value>
                    | --untilSCN <value>
                    | --latest
                    | --tag <value>
                }
            | --status --uuid <value>
        }
Em que:
--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>

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb recovery?

R: O comando dbaascli pdb recover é usado para recuperar um banco de dados plugável (PDB) para um estado anterior usando backups armazenados em um destino de armazenamento de backup configurado.

P: Quem pode executar o comando dbaascli pdb recovery?

A: O comando deve ser executado como o usuário root.

P: O que é necessário antes de executar o comando de recuperação dbaascli pdb?

R: Antes de executar o comando, o banco de dados deve ser configurado com detalhes do destino de armazenamento de backup em que os backups são armazenados.

P: O que a opção --pdbName especifica no comando de recuperação dbaascli pdb?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) que você deseja recuperar.

P: O que a opção --dbname especifica no comando de recuperação dbaascli pdb?

A: A opção --dbname especifica o nome do CDB (banco de dados contêiner) que hospeda o PDB.

P: Quais são as opções possíveis para iniciar uma recuperação de PDB usando a opção --start?

R: Você pode recuperar o PDB usando uma das seguintes opções:
  • --untilTime <value>: Recupera o PDB até um horário especificado (formato: DD-MON-YYYY HH24:MI).
  • --untilSCN <value>: Recupera o PDB até um SCN (Número de Alteração do Sistema) especificado.
  • --latest: Recupera o PDB para o estado conhecido mais recente.
  • --tag <value>: Recupera o PDB para uma tag de arquivamento específica.

P: Qual é o formato necessário para especificar a hora na opção --untilTime?

A: A hora deve estar no formato DD-MON-YYYY HH24:MI:SS.

P: Como posso recuperar um PDB para o estado mais recente usando dbaascli PDB recovery?

A: Para recuperar o PDB para o estado mais recente conhecido, use a opção --latest:

dbaascli pdb recover --pdbName <value> --dbname <value> --start --latest

P: Como recupero um PDB para uma tag de arquivamento específica?

A: Você pode recuperar o PDB para uma tag específica usando a opção --tag:

dbaascli pdb recover --pdbName <value> --dbname <value> --start --tag <tag_value>

P: Posso recuperar um PDB usando um SCN específico?

R: Sim, você pode recuperar o PDB para um SCN específico usando a opção --untilSCN:

dbaascli pdb recover --pdbName <value> --dbname <value> --start --untilSCN <SCN_value>

P: O que a opção --status faz no comando dbaascli pdb recovery?

A: A opção --status é usada para verificar o status de uma operação de recuperação. Você deve fornecer o --uuid para especificar a sessão de recuperação.

P: Como posso verificar o status de uma recuperação de PDB?

A: Para verificar o status de uma operação de recuperação, use a opção --status com o --uuid da sessão de recuperação:

dbaascli pdb recover --pdbName <value> --dbname <value> --status --uuid <uuid_value>

P: O que acontece se eu especificar a opção --latest no comando recovery?

R: Se você especificar a opção --latest, o PDB será recuperado para o estado mais recente disponível no backup.

Exemplo 6-45 Exemplos

  • Para recuperar um PDB pdb1 em um CDB myTestDb para o mais recente:
    dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --start --latest
  • Para consultar o status da solicitação de recuperação do PDB submetida com uuid 81a17352362011ecbc3000163e8e4fac:
    dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --status --uuid 81a17352362011ecbc3000163e8e4fac

dbaascli pdb refresh

Para atualizar um PDB (banco de dados plugável) especificado, use o comando dbaascli pdb refresh.

Execute o comando como usuário root ou oracle.

Sintaxe

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

Em que:

  • --dbname: especifica o nome do Oracle Database
  • --pdbName: especifica o nome do banco de dados plugável
  • --pdbUID: especifica o identificador do banco de dados plugável
  • --waitForCompletion: especifica false para executar a operação em segundo plano. Valores válidos: true|false

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb refresh?

R: O comando dbaascli pdb refresh é usado para atualizar um banco de dados plugável (PDB) especificado em um banco de dados contêiner (CDB).

P: Quem pode executar o comando dbaascli pdb refresh?

A: O comando pode ser executado pelo usuário root ou oracle.

P: O que a opção --dbname especifica no comando dbaascli pdb refresh?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) a ser atualizado.

P: O que a opção --pdbName especifica no comando dbaascli pdb refresh?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) que você deseja atualizar.

P: O que a opção --pdbUID especifica no comando dbaascli pdb refresh?

A: A opção --pdbUID especifica o identificador exclusivo (UID) do banco de dados plugável (PDB) que você deseja atualizar.

P: O que a opção --waitForCompletion faz no comando dbaascli pdb refresh?

A: A opção --waitForCompletion especifica se a operação deve ser executada em primeiro plano ou em segundo plano. Se definido como verdadeiro, a operação será executada em primeiro plano e aguardará a conclusão. Se definido como falso, a operação será executada em segundo plano.

P: Como posso atualizar um PDB e executar a operação em segundo plano?

A: Para atualizar um PDB e executar a operação em segundo plano, use a opção --waitForCompletion false:

dbaascli pdb refresh --dbname <value> --pdbName <value> --waitForCompletion false

P: Como atualizo um PDB usando seu identificador exclusivo (UID)?

A: Você pode atualizar o PDB usando a opção --pdbUID:

dbaascli pdb refresh --dbname <value> --pdbUID <value>

P: Posso especificar --pdbName e --pdbUID juntos no comando dbaascli pdb refresh?

R: Não, você deve especificar --pdbName ou --pdbUID, mas não ambos, ao atualizar um PDB.

P: O que acontece se eu não incluir a opção --waitForCompletion no comando?

R: Se você não especificar a opção --waitForCompletion, o comportamento padrão será aguardar a conclusão da operação antes de retornar o controle ao usuário.

P: Posso atualizar um PDB enquanto o banco de dados está em execução?

R: Sim, você pode atualizar um PDB enquanto o banco de dados está em execução, desde que o comando seja executado por um usuário com privilégios apropriados.

dbaascli pdb relocate

Para realocar o PDB especificado do banco de dados remoto para o banco de dados local, use o comando dbaascli pdb relocate.

Pré-requisito

Execute o comando como usuário oracle. Quando solicitado, informe a senha do usuário SYS para o banco de dados de origem.

Sintaxe

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]
}
Em que:
  • --pdbName especifica o nome do PDB de origem a ser realocado
  • --dbName especifica o nome do banco de dados de destino
  • --sourceDBConnectionString especifica a string de conexão do banco de dados de origem no formato <scan_name>:<scan_port>/<database_service_name>
  • --targetPDBName especifica um nome para o PDB de destino (novo PDB realocado)
  • --powerLimit especifica o grau de paralelismo a ser usado para a operação de realocação
  • --maxCpu especifica o número máximo de CPUs a serem alocadas para o PDB
  • --maxSize especifica o tamanho máximo do armazenamento em GB para o novo PDB
  • --resume especifica para retomar a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --executePrereqs especifica yes para só executar os pré-requisitos desta operação. Valores válidos: yes|no
  • --sourcePDBServices especifica uma lista de serviços do PDB de origem delimitados por vírgulas
  • --sourcePDBReadOnlyServices especifica uma lista delimitada por vírgulas de serviços somente leitura do PDB de origem
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true|false
  • --blobLocation especifica o local de um diretório personalizado no qual o arquivo BLOB stand-by será gerado em um ambiente do Data Guard
  • --standbyBlobFromPrimary especifica o local do arquivo BLOB stand-by, que é preparado usando o banco de dados principal. Isso só é necessário para operações stand-by.
    Observação

    Os parâmetros --blobLocation são mutuamente exclusivos.
  • --upgradePDB especifica true para fazer upgrade do PDB como parte dessa operação. Valores válidos : true | false.
  • --updateDBBlockCachesize opção para permitir que o aplicativo defina parâmetros de inicialização db block cache size para suportar a cópia de dados com tamanho de bloco diferente.
  • --skipOpenPDB - indica que o PDB não deve ser aberto no fim da operação atual.
  • --completePDBRelocate - conclui a realocação do PDB, se for executada como operação em duas etapas.

Perguntas Frequentes

P: Para que é usado o comando dbaascli pdb relocate?

R: O comando dbaascli pdb relocate é usado para realocar um PDB (Banco de Dados Plugável) de um banco de dados remoto para um banco de dados local.

P: Qual usuário deve executar o comando dbaascli pdb relocate?

A: O comando deve ser executado como o usuário Oracle.

P: O que é necessário quando solicitado durante a operação de realocação do pdb dbaascli?

R: Forneça a senha do usuário SYS para o banco de dados de origem.

P: O que o parâmetro --pdbName especifica?

A: O parâmetro --pdbName especifica o nome do PDB de origem a ser realocado.

P: Qual é a finalidade do parâmetro --dbName?

A: O parâmetro --dbName especifica o nome do banco de dados de destino no qual o PDB será realocado.

P: Como o --sourceDBConnectionString deve ser formatado?

A: O --sourceDBConnectionString deve ser formatado como <scan_name>:<scan_port>/<database_service_name>.

P: O que o parâmetro --targetPDBName faz?

A: O parâmetro --targetPDBName especifica um novo nome para o PDB realocado.

P: Qual é o uso de --powerLimit?

R: O parâmetro --powerLimit especifica o grau de paralelismo a ser usado durante a operação de realocação.

P: Como --maxCpu afeta o processo de realocação?

A: O parâmetro --maxCpu especifica o número máximo de CPUs a serem alocadas para o processo de realocação do PDB.

P: O que o parâmetro --maxSize define?

A: O parâmetro --maxSize define o tamanho máximo de armazenamento em GB para o novo PDB.

P: Qual é a função de --resume?

R: O parâmetro --resume indica que a operação de realocação deve ser retomada de onde parou.

P: O que devo fornecer com a opção --resume?

R: Você pode especificar um --sessionID para retomar uma sessão específica se estiver retomando uma operação anterior.

P: O que o parâmetro --executePrereqs faz?

R: O parâmetro --executePrereqs determina se apenas os pré-requisitos da operação devem ser executados. Os valores válidos são sim ou não.

P: O que é especificado pelo parâmetro --sourcePDBServices?

A: O parâmetro --sourcePDBServices especifica uma lista de serviços do PDB de origem delimitados por vírgulas.

P: O que faz a lista de parâmetros --sourcePDBReadOnlyServices?

A: O parâmetro --sourcePDBReadOnlyServices lista uma lista delimitada por vírgulas de serviços somente para leitura do PDB de origem.

P: Qual é o efeito de --waitForCompletion?

A: O parâmetro --waitForCompletion especifica se a operação deve ser executada em segundo plano. Os valores válidos são true ou false.

P: O que o parâmetro --blobLocation especifica?

R: O parâmetro --blobLocation especifica o local de um diretório personalizado no qual o arquivo BLOB standby será gerado em um ambiente do Data Guard.

Q: Quando devo usar --standbyBlobFromPrimary?

R: Use --standbyBlobFromPrimary para especificar o local do arquivo BLOB stand-by, que é preparado no banco de dados principal. Isso só é necessário para operações stand-by.

P: Posso usar --blobLocation e --standbyBlobFromPrimary juntos?

R: Não, os parâmetros --blobLocation e --standbyBlobFromPrimary são mutuamente exclusivos e não podem ser usados juntos.

P: O que --upgradePDB faz?

A: O parâmetro --upgradePDB especifica se o PDB deve ser submetido a upgrade como parte da operação de realocação. Os valores válidos são true ou false.

P: Qual é a finalidade de --updateDBBlockCacheSize?

A: A opção --updateDBBlockCacheSize permite que o aplicativo defina os parâmetros de inicialização do tamanho do cache de bloco do BD para suportar a cópia de dados com um tamanho de bloco diferente.

P: O que a opção --skipOpenPDB faz?

A: A opção --skipOpenPDB indica que o PDB não deve ser aberto no final da operação de realocação.

Q: Quando devo usar --completePDBRelocate?

R: Use --completePDBRelocate para concluir a realocação do PDB, se for feita como operação em duas etapas.

P: O que devo fazer se encontrar um erro ao usar o comando dbaascli pdb relocate?

R: Verifique a mensagem de erro para obter detalhes, certifique-se de que todos os parâmetros estejam especificados corretamente e verifique se você tem as permissões e credenciais necessárias. Talvez você também precise revisar os pré-requisitos e as configurações.

P: E se eu esquecer a senha do usuário SYS do banco de dados de origem?

R: Você precisará redefinir ou recuperar a senha do usuário SYS do banco de dados de origem. Sem ele, não é possível concluir a operação de realocação.

Exemplo 6-46 dbaascli pdb relocate

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

dbaascli pdb remoteClone

Para criar um novo banco de dados plugável (PDB) como clone de um PDB existente, em outro banco de dados contêiner (CDB), use o comando dbaascli pdb remoteClone.

Execute o comando como usuário root ou oracle.

Sintaxe

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]
Em que:
  • --pdbName especifica o nome do PDB de origem que você deseja clonar
  • --dbname especifica o nome (DB_NAME) do CDB que hospeda o PDB recém-clonado
  • --sourceDBConnectionString especifica a string de conexão do banco de dados de origem no formato scan_name:scan_port/database_service_name
  • --targetPDBName especifica o nome do PDB de destino (novo PDB clonado)
  • --powerLimit especifica o grau de paralelismo a ser usado para a operação de clonagem. O valor válido fica entre 1 e 128
  • --maxCPU especifica o número máximo de CPUs a serem alocadas para o PDB
  • --maxSize especifica o tamanho máximo do armazenamento em GB para o novo PDB
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --executePrereqs especifica yes para só executar os pré-requisitos desta operação. Valores válidos: yes ou no
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true ou false
  • --sourcePDBExportedTDEKeyFile especifica o arquivo de chave exportado do PDB de origem. Essa variável só se aplica ao banco de dados 12.1.
  • --blobLocation especifica o caminho personalizado em que o arquivo blob stand-by será gerado em um ambiente do Data Guard
  • --standbyBlobFromPrimary especifique o local do arquivo blob stand-by, que é preparado no banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by
    Observação

    Os parâmetros --blobLocation e --standbyBlobFromPrimary são mutuamente exclusivos.
  • --excludeUserTablespaces - opção para ignorar tablespaces de usuário, por exemplo, t1,t2,t3.
  • --excludePDBData - especifique true/yes para ignorar dados do usuário do PDB de origem.
  • --pdbAdminUserName - especifica o novo nome do usuário administrador do PDB
  • --lockPDBAdminAccount especifique true ou false para bloquear a conta do usuário administrador do PDB. O valor default é verdadeiro.
  • --sourcePDBServiceConvertList - especifique uma lista separada por vírgulas de nomes de serviços de origem para destino que precisam ser convertidos. A sintaxe é source_srv1:new_srv1, source_srv2:new_srv2.
  • --refreshablePDB especifica a criação de um PDB atualizável
    • --refreshMode especifica o modo de atualização para um PDB atualizável. Valores válidos: AUTO|MANUAL
      • --refreshIntervalInMinutes especifica o intervalo de atualização para refreshablePDB em minutos
    • --dblinkUsername especifica o usuário comum de um banco de dados remoto usado para link de banco de dados para conexão com o banco de dados remoto
      • --honorCaseSensitiveUserName indica que o nome de usuário especificado faz distinção entre maiúsculas e minúsculas
  • --updateDBBlockCacheSize: especifica a ativação do aplicativo para definir os parâmetros de inicialização db block cache size para suportar a cópia de dados com um tamanho de bloco distinto

Quando solicitado, forneça a senha do usuário SYS para o PDB de origem. O PDB recém-clonado herda senhas de administração do PDB de origem. O PDB clonado é nomeado usando o seguinte formato: dbname_sourcepdbname. Esse comando só é suportado para bancos de dados que não estão em uma configuração do Data Guard e usam o Oracle Database versão 12.2.0.1 ou mais recente.

Perguntas Frequentes

P: Para que é usado o comando dbaascli pdb remoteClone?

R: O comando dbaascli pdb remoteClone é usado para criar um novo Banco de Dados Plugável (PDB) como clone de um PDB existente em outro banco de dados contêiner (CDB).

P: Qual usuário deve executar o comando dbaascli pdb remoteClone?

A: O comando deve ser executado como o usuário root ou oracle.

P: O que é necessário quando solicitado durante a operação dbaascli pdb remoteClone?

R: Forneça a senha do usuário SYS para o PDB de origem.

P: O que o parâmetro --pdbName especifica?

A: O parâmetro --pdbName especifica o nome do PDB de origem que você deseja clonar.

P: O que o parâmetro --dbName representa?

R: O parâmetro --dbName representa o nome (DB_NAME) do CDB que hospedará o PDB recém-clonado.

P: Como o --sourceDBConnectionString deve ser formatado?

A: O --sourceDBConnectionString deve ser formatado como <scan_name>:<scan_port>/<database_service_name>.

P: Qual é a finalidade do parâmetro --targetPDBName?

A: O parâmetro --targetPDBName especifica o nome do PDB recém-clonado.

P: O que o --powerLimit controla?

A: O parâmetro --powerLimit controla o grau de paralelismo usado para a operação de clonagem. O valor válido está entre 1 e 128.

P: O que o parâmetro --maxCPU define?

A: O parâmetro --maxCPU define o número máximo de CPUs a serem alocadas para o processo de clonagem do PDB.

P: Qual é a função de --maxSize?

A: O parâmetro --maxSize especifica o tamanho máximo do armazenamento em GB para o novo PDB.

P: O que o parâmetro --resume faz?

A: O parâmetro --resume retoma a operação de clonagem anterior.

P: O que você deve fornecer com a opção --resume?

R: Você pode especificar um --sessionID para retomar uma sessão específica se estiver retomando uma operação anterior.

P: O que o --executePrereqs controla?

R: O parâmetro --executePrereqs determina se apenas os pré-requisitos para a operação de clonagem devem ser executados. Os valores válidos são yes ou no.

P: Como --waitForCompletion afeta a operação?

R: O parâmetro --waitForCompletion especifica se a operação deve ser concluída ou executada em segundo plano. Os valores válidos são true ou false.

P: O que é especificado pelo parâmetro --sourcePDBExportedTDEKeyFile?

A: O parâmetro --sourcePDBExportedTDEKeyFile especifica o arquivo de chaves exportado do PDB de origem. Esse parâmetro só é aplicável ao Oracle Database versão 12.1.

P: O que o parâmetro --blobLocation define?

A: O parâmetro --blobLocation especifica o caminho personalizado em que o arquivo BLOB stand-by será gerado em um ambiente do Data Guard.

P: Quando --standbyBlobFromPrimary é usado?

A: O parâmetro --standbyBlobFromPrimary especifica a localização do arquivo BLOB stand-by preparado com base no banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by.

P: --blobLocation e --standbyBlobFromPrimary podem ser usados juntos?

A: Não, --blobLocation e --standbyBlobFromPrimary são mutuamente exclusivos e não podem ser usados juntos.

P: O que a opção --excludeUserTablespaces faz?

A: A opção --excludeUserTablespaces permite ignorar a clonagem de tablespaces de usuário específicos. Por exemplo, t1,t2,t3.

P: Qual é o efeito de --excludePDBData?

A: A opção --excludePDBData especifica se os dados do usuário devem ser ignorados do PDB de origem durante a clonagem. Os valores válidos são true ou yes.

P: O que é especificado por --pdbAdminUserName?

A: O parâmetro --pdbAdminUserName especifica o novo nome de usuário administrador do PDB clonado.

P: O que a opção --lockPDBAdminAccount controla?

A: A opção --lockPDBAdminAccount especifica se a conta de usuário administrador do PDB será bloqueada. O valor padrão é true.

P: O que --sourcePDBServiceConvertList especifica?

A: O parâmetro --sourcePDBServiceConvertList especifica uma lista delimitada por vírgulas de conversões de nome de serviço de origem para destino. Por exemplo, source_srv1:new_srv1,source_srv2:new_srv2.

P: Qual é a finalidade de --refreshablePDB?

A: O parâmetro --refreshablePDB especifica se um PDB atualizável deverá ser criado.

P: O que o --refreshMode controla?

A: O parâmetro --refreshMode controla o modo de atualização de um PDB atualizável. Os valores válidos são AUTO ou MANUAL.

P: Como --refreshIntervalInMinutes funciona?

A: O parâmetro --refreshIntervalInMinutes especifica o intervalo em minutos para atualizar o PDB atualizável.

P: Para que é usado --dblinkUsername?

A: O parâmetro --dblinkUsername especifica um usuário comum de um banco de dados remoto usado para o link de banco de dados para conexão com o banco de dados remoto.

P: O que a opção --honorCaseSensitiveUserName indica?

A: A opção --honorCaseSensitiveUserName indica que o nome de usuário especificado faz distinção entre maiúsculas e minúsculas.

P: Qual é o efeito de --updateDBBlockCacheSize?

A: A opção --updateDBBlockCacheSize permite que o aplicativo defina os parâmetros de inicialização do tamanho do cache de bloco do BD para suportar a cópia de dados com um tamanho de bloco diferente.

P: O que devo fazer se encontrar um erro com o comando dbaascli pdb remoteClone?

R: Revise a mensagem de erro para obter detalhes, verifique se todos os parâmetros estão especificados corretamente e verifique se você tem as permissões e credenciais necessárias. Além disso, verifique se os bancos de dados de origem e de destino atendem a todos os requisitos.

P: E se eu esquecer a senha do usuário SYS do PDB de origem?

R: Você precisará redefinir ou recuperar a senha do usuário SYS do PDB de origem. Sem ela, a operação de clonagem não poderá ser concluída.

Exemplo 6-47 dbaascli pdb remoteClone

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

dbaascli system getDBHomes

Para exibir informações sobre todos os Oracle homes, use o comando dbaascli system getDBHomes.

Pré-requisito

Execute o comando como usuário root ou oracle.

Sintaxe

dbaascli system getDBHomes

Perguntas Frequentes

P: Para que é usado o comando dbaascli system getDBHomes?

R: O comando dbaascli system getDBHomes é usado para exibir informações sobre todos os Oracle homes em um sistema.

P: Qual usuário deve executar o comando dbaascli system getDBHomes?

A: O comando deve ser executado como o usuário root ou oracle.

P: Há algum parâmetro para o comando dbaascli system getDBHomes?

A: Não, o comando dbaascli system getDBHomes não tem parâmetros.

P: Que tipo de informação o comando dbaascli system getDBHomes fornece?

R: O comando fornece detalhes sobre todos os Oracle homes no sistema, incluindo seus caminhos e outras informações relevantes.

P: Como posso interpretar a saída do comando dbaascli system getDBHomes?

A: A saída listará todos os Oracle homes com informações como a localização de cada Oracle home. Essas informações podem ajudar no gerenciamento e na configuração de ambientes Oracle.

P: O que devo fazer se o comando dbaascli system getDBHomes não retornar nenhuma saída?

R: Certifique-se de que você esteja executando o comando como usuário root ou oracle e verifique se os Oracle homes estão instalados corretamente no sistema. Você também pode verificar as permissões e configurações do sistema.

P: E se eu receber uma mensagem de erro ao executar o comando dbaascli system getDBHomes?

R: Verifique a mensagem de erro para obter detalhes específicos, verifique se você tem as permissões apropriadas e certifique-se de que a ferramenta dbaascli esteja instalada e configurada corretamente.

P: Posso executar o sistema dbaascli getDBHomes em um sistema não Oracle?

R: Não, o comando dbaascli system getDBHomes é específico para sistemas Oracle e requer que o software Oracle seja instalado.

Exemplo 6-48 dbaascli system getDBHomes

dbaascli system getDBHomes

dbaascli tde changePassword

Para alterar a senha do armazenamento de chaves TDE, bem como a senha da wallet do Banco de Dados para o alias tde_ks_passwd, use o comando dbaascli tde changePassword.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde changePassword [--dbname <value>]
  {            [--prepareStandbyBlob <value> [--blobLocation <value>]]
               | [--standbyBlobFromPrimary <value>]
  }
  [--resume [--sessionID <value>]]
Em que:
  • --dbname especifica o nome do banco de dados
  • --prepareStandbyBlob - especifica true para gerar um arquivo blob contendo os artefatos necessários para executar a operação em um ambiente do DG.
  • --blobLocation - caminho personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG.
  • --standbyBlobFromPrimary - especifica o local do arquivo blob stand-by preparado no banco de dados principal. Isso só é necessário para operações stand-by.
  • --resume - para retomar a execução anterior
  • --sessionID - para retomar um id de sessão específico.

Perguntas Frequentes

P: O que o comando dbaascli tde changePassword faz?

A: O comando dbaascli tde changePassword altera a senha do armazenamento de chaves TDE (Transparent Data Encryption), bem como a senha da wallet do banco de dados do alias tde_ks_passwd.

P: Quem deve executar o comando dbaascli tde changePassword?

A: O comando deve ser executado como o usuário root.

P: Quando devo usar o comando dbaascli tde changePassword?

R: Use este comando quando precisar alterar a senha do armazenamento de chaves TDE ou a senha da wallet de BD para um banco de dados Exadata Cloud@Customer.

P: O que a opção --dbname faz?

A: A opção --dbname especifica o nome do banco de dados para o qual você deseja alterar a senha do armazenamento de chaves de TDE.

P: O que a opção --pdbName faz?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) para o qual a senha da área de armazenamento de chaves de TDE precisa ser alterada. Esta opção é usada em bancos de dados multitenant.

P: Você pode dar um exemplo de como executar este comando para um banco de dados específico?

A: Aqui está um exemplo para alterar a senha da área de armazenamento de chaves de TDE para um banco de dados específico:

dbaascli tde changePassword --dbname mydatabase

P: Como faço para executar o comando de um PDB específico em um banco de dados multitenant?

A: Você pode especificar o nome do PDB usando esta sintaxe:

dbaascli tde changePassword --dbname mydatabase --pdbName mypdb

P: Quais são os pré-requisitos para executar o comando dbaascli tde changePassword?

R: Você deve executar o comando como o usuário root e ter acesso à máquina virtual do Exadata Cloud@Customer na qual o banco de dados está em execução.

P: Preciso interromper o banco de dados para alterar a senha do armazenamento de chaves de TDE?

R: Não, o banco de dados não precisa ser interrompido para alterar a senha da área de armazenamento de chaves de TDE.

P: O que devo fazer se o comando falhar?

R: Certifique-se de que você esteja executando o comando como usuário raiz e que o nome do banco de dados (--dbname) e o nome do PDB (--pdbName, se aplicável) estejam corretos.

P: E se eu receber um erro de "senha inválida" ao alterar a senha do armazenamento de chaves TDE?

R: Certifique-se de que a nova senha atenda aos requisitos de complexidade de senhas do sistema e que você esteja digitando a senha antiga correta, se solicitado.

P: Como verifico se a senha da área de armazenamento de chaves de TDE foi alterada com sucesso?

R: Você pode verificar os logs do banco de dados ou usar as views do Oracle Database Vault e do Key Management para verificar se a alteração da senha da área de armazenamento de chaves de TDE foi bem-sucedida.

P: Posso alterar a senha da área de armazenamento de chaves de TDE para um banco de dados multitenant e todos os PDBs de uma só vez?

R: Não, o comando dbaascli tde changePassword precisará ser executado para cada PDB individualmente se você precisar alterar a senha de vários PDBs.

P: O que acontece se eu esquecer a nova senha da área de armazenamento de chaves TDE?

R: Se a nova senha for esquecida, talvez você precise restaurar a área de armazenamento de chaves de um backup ou seguir o processo de recuperação da Oracle para redefini-la, dependendo da sua configuração.

P: Posso automatizar o processo de alteração da senha da área de armazenamento de chaves TDE?

R: Embora o próprio comando dbaascli tde changePassword não seja projetado para automação, você pode criá-lo como parte de seus procedimentos regulares de manutenção de banco de dados, se necessário.

P: Com que frequência devo alterar a senha da área de armazenamento de chaves TDE?

R: A Oracle recomenda alterar periodicamente sua senha da área de armazenamento de chaves de TDE com base nas políticas de segurança da sua organização. As melhores práticas geralmente envolvem a rotação de chaves de criptografia e senhas de armazenamento de chaves regularmente.

Para alterar a senha de TDE em um ambiente que não seja do Data Guard
dbaascli tde changepassword --dbname
      <dbname>
Para alterar a senha de TDE em um ambiente do Data Guard
  1. Altere a senha de TDE no banco de dados principal.
    dbaascli tde changepassword --dbname
          <dbname> --prepareStandbyBlob true --blobLocation
          <Location where blob file has to be generated>
  2. Copie o blob stand-by criado para o ambiente do banco de dados stand-by.
  3. Altere a senha de TDE no banco de dados stand-by.
    dbaascli tde changepassword --dbname
         <dbname> --standbyBlobFromPrimary <Location of blob generated from
        primary>

dbaascli tde addSecondaryHsmKey

Para adicionar uma chave HSM (KMS) secundária à configuração HSM (KMS) existente, use o comando dbaascli tde addSecondaryHsmKey.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde addSecondaryHsmKey --dbname <value> --secondaryKmsKeyOCID <value>
[--executePrereqs]
Em que:
  • --secondaryKmsKeyOCID especifica a chave KMS secundária a ser adicionada à configuração HSM (KMS) existente
  • --dbname especifica o nome do banco de dados
  • --executePrereqs - execute as verificações de pré-requisitos e reporte os resultados.

Perguntas Frequentes

P: O que o comando dbaascli tde addSecondaryHsmKey faz?

R: O comando dbaascli tde addSecondaryHsmKey adiciona uma chave secundária do HSM (KMS) à configuração existente do HSM (KMS) para um banco de dados do Exadata Cloud@Customer.

P: Quem deve executar o comando dbaascli tde addSecondaryHsmKey?

A: O comando deve ser executado como o usuário root.

P: Em qual máquina devo executar o comando dbaascli tde addSecondaryHsmKey?

R: Você precisa estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.

P: Onde posso encontrar mais detalhes sobre a conexão com uma máquina virtual para executar este comando?

R: Você pode consultar o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções sobre como estabelecer conexão.

P: O que a opção --secondaryKmsKeyOCID especifica?

A: A opção --secondaryKmsKeyOCID especifica o OCID (Oracle Cloud Identifier) da chave KMS secundária a ser adicionada à configuração do HSM (KMS) existente.

P: O que a opção --dbname faz?

A: A opção --dbname permite especificar o nome do banco de dados ao qual a chave KMS secundária deve ser adicionada. É opcional.

P: O que a opção --precheckOnly faz?

A: A opção --precheckOnly, quando definida como yes, executa uma pré-verificação da operação sem fazer alterações reais. Os valores válidos são yes ou no.

P: Posso executar a pré-verificação apenas sem fazer alterações?

R: Sim, você pode usar a opção --precheckOnly yes para executar apenas a pré-verificação sem fazer alterações.

P: Você pode dar um exemplo de como executar este comando para adicionar uma chave HSM secundária?

A: Este é um exemplo:

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example

P: Como executar o comando para um banco de dados específico?

A: Você pode especificar o nome do banco de dados como este:

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --dbname mydatabase

P: Como executar o comando apenas com uma pré-verificação?

A: Para executar a pré-verificação, use a seguinte sintaxe:

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --precheckOnly yes

P: O que devo fazer se o comando falhar?

R: Verifique se você está executando o comando como o usuário root e se conectou à máquina virtual correta do Exadata Cloud@Customer. Além disso, verifique o OCID da chave KMS e verifique se as permissões necessárias foram concedidas.

P: Como posso verificar se tenho o OCID correto para a chave KMS secundária?

R: Você pode recuperar o OCID da chave KMS na console do Oracle Cloud Infrastructure, na seção KMS (Key Management Service).

P: Quais permissões são necessárias para adicionar uma chave KMS secundária?

R: Você precisa de permissões apropriadas no Oracle Cloud Infrastructure para operações KMS, incluindo a capacidade de gerenciar chaves KMS para o compartimento relevante.

P: Posso usar o comando dbaascli tde addSecondaryHsmKey sem especificar a opção --dbname?

R: Sim, a opção --dbname é opcional. Se omitido, o comando se aplica a todos os bancos de dados que usam a configuração HSM (KMS) existente.

P: O que acontece se eu adicionar uma chave KMS secundária?

R: A chave KMS secundária será adicionada à configuração existente, fornecendo uma camada adicional de redundância de gerenciamento de chaves de criptografia.

P: Posso remover uma chave KMS secundária depois que ela for adicionada?

R: Não, depois que uma chave KMS secundária for adicionada, ela não poderá ser removida. Você só pode rotacionar ou atualizar chaves no futuro.

Exemplo 6-49 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

Para ativar o parâmetro spfile wallet_root para o banco de dados existente, use o comando dbaascli tde enableWalletRoot.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde enableWalletRoot --dbname <value>
[--dbRestart <value>]
[--executePrereqs]
[--resume [--sessionID <value>]]
Em que:
  • --dbname especifica o nome do Oracle Database.
  • --dbrestart especifica a opção de reinício do banco de dados. Os valores válidos são: rolling ou full. Valor padrão: rolling

    Se você não informar o argumento dbrestart, o banco de dados será reiniciado de maneira rolling.

  • --precheckOnly só executa a pré-verificação desta operação. Os valores válidos são: yes ou no
  • --resume para retomar a execução anterior
  • --sessionID para retomar um id de sessão específico.

Perguntas Frequentes

P: O que o comando dbaascli tde enableWalletRoot faz?

R: O comando dbaascli tde enableWalletRoot ativa o parâmetro wallet_root em spfile para um banco de dados Oracle existente no Exadata Cloud@Customer.

P: Quem deve executar o comando dbaascli tde enableWalletRoot?

A: O comando deve ser executado como o usuário root.

P: Em qual máquina devo executar o comando dbaascli tde enableWalletRoot?

R: Você deve estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.

P: Onde posso encontrar instruções para me conectar à máquina virtual?

R: Você pode consultar o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções sobre como estabelecer conexão.

P: O que a opção --dbRestart faz?

A: A opção --dbRestart especifica como o banco de dados deve ser reiniciado após a ativação de wallet_root. Os valores válidos são:
  • rolling: Reinicia o banco de dados de forma incremental (comportamento padrão).
  • full: Executa uma reinicialização completa do banco de dados.

P: O que a opção --dbname faz?

A: A opção --dbname permite especificar o nome do Oracle Database para o qual o parâmetro wallet_root deve ser ativado.

P: O que a opção --precheckOnly faz?

A: A opção --precheckOnly executa uma pré-verificação da operação sem fazer alterações reais. Os valores válidos são yes ou no.

P: O que acontece se eu não especificar a opção --dbRestart?

R: Se você não especificar a opção --dbRestart, o banco de dados será reiniciado de forma incremental por padrão.

P: Você pode dar um exemplo de como ativar wallet_root para um banco de dados específico?

A: Veja um exemplo para ativar wallet_root para um banco de dados chamado mydatabase:

dbaascli tde enableWalletRoot --dbname mydatabase

P: Como ativar wallet_root e especificar uma reinicialização completa do banco de dados?

A: Você pode ativar wallet_root com uma reinicialização completa do banco de dados usando o seguinte comando:

dbaascli tde enableWalletRoot --dbname mydatabase --dbRestart full

P: Como executar o comando apenas com uma pré-verificação?

A: Para executar uma pré-verificação sem fazer alterações, use a seguinte sintaxe:

dbaascli tde enableWalletRoot --dbname mydatabase --precheckOnly yes

P: Quais são os pré-requisitos para executar o comando dbaascli tde enableWalletRoot?

R: Você deve executar o comando como o usuário root e estar conectado à máquina virtual correta do Exadata Cloud@Customer.

P: Preciso reiniciar o banco de dados para ativar o wallet_root?

R: Sim, o banco de dados precisará ser reiniciado de forma incremental (padrão) ou totalmente, dependendo da opção escolhida.

P: O que devo fazer se o comando falhar?

R: Certifique-se de que você esteja executando o comando como o usuário raiz e verifique se o nome do banco de dados (--dbname) está correto. Verifique se há erros de pré-verificação se você estiver executando com --precheckOnly.

P: E se o banco de dados falhar ao reiniciar após a execução do comando?

R: Verifique se a opção de reinicialização correta foi usada (rolling ou full) e verifique se há erros nos logs do banco de dados. Talvez seja necessário reiniciar manualmente o banco de dados se a reinicialização automática falhar.

P: Como posso verificar se wallet_root foi ativado com sucesso?

R: Você pode verificar a alteração verificando o spfile do banco de dados ou usando consultas do Oracle SQL para confirmar se o parâmetro wallet_root está ativado.

P: Posso ativar wallet_root sem reiniciar o banco de dados?

R: Não, o banco de dados precisa ser reiniciado para que a alteração entre em vigor. Você pode escolher entre uma reinicialização incremental ou uma reinicialização completa.

P: Qual é a diferença entre uma reinicialização contínua e completa do banco de dados?

R: Uma reinicialização incremental reinicia o banco de dados uma instância por vez, permitindo que o banco de dados permaneça parcialmente disponível durante a operação. Uma reinicialização completa é encerrada e reinicia todo o banco de dados, causando um tempo de inatividade completo.

P: Posso executar este comando para vários bancos de dados simultaneamente?

R: Você precisa executar o comando dbaascli tde enableWalletRoot separadamente para cada banco de dados no qual deseja ativar wallet_root.

P: Como a ativação de wallet_root afeta a configuração do armazenamento de chaves de TDE existente?

R: A ativação de wallet_root atualiza o local do armazenamento de chaves TDE para o novo diretório raiz da wallet, facilitando o gerenciamento de vários armazenamentos de chaves e wallets em bancos de dados Oracle.

Exemplo 6-50 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

Para criptografar todos os tablespaces no PDB especificado, use o comando dbaascli tde encryptTablespacesInPDB.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde encryptTablespacesInPDB --dbname <value> --pdbName <value>
[--executePrereqs]
Em que:
  • --pdbName especifica o nome do PDB para criptografar todos os tablespaces.
  • --dbname especifica o nome do Oracle Database.
  • --executePrereqs - execute as verificações de pré-requisitos e reporte os resultados.

Perguntas Frequentes

P: O que o comando dbaascli tde encryptTablespacesInPDB faz?

R: O comando dbaascli tde encryptTablespacesInPDB criptografa todos os tablespaces no PDB (banco de dados plugável) especificado para um Oracle Database no Exadata Cloud@Customer.

P: Quem deve executar o comando dbaascli tde encryptTablespacesInPDB?

A: O comando deve ser executado como o usuário root.

P: Em qual máquina devo executar o comando dbaascli tde encryptTablespacesInPDB?

R: Você precisa estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.

P: Onde posso encontrar instruções para conexão com a máquina virtual?

A: Consulte o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções de conexão.

P: O que a opção --pdbName especifica?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) cujos tablespaces precisam ser criptografados.

P: O que a opção --dbname faz?

A: A opção --dbname permite especificar o nome do Oracle Database ao qual o PDB pertence.

P: O que a opção --precheckOnly faz?

A: A opção --precheckOnly executa uma pré-verificação da operação de criptografia sem fazer alterações reais. Os valores válidos são yes ou no.

P: O que a opção --useSysdbaCredential faz?

A: A opção --useSysdbaCredential especifica se as credenciais SYSDBA devem ser usadas para a operação. Os valores válidos são verdadeiro ou falso.

P: Você pode dar um exemplo de como criptografar tablespaces em um PDB específico?

A: Aqui está um exemplo para criptografar todos os tablespaces em um PDB chamado mypdb:

dbaascli tde encryptTablespacesInPDB --pdbName mypdb

P: Como criptografar tablespaces em um PDB específico em um banco de dados?

A: Use o seguinte comando para especificar o PDB e o banco de dados:

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --dbname mydatabase

P: Como faço para executar uma pré-verificação sem executar a criptografia?

A: Você só pode executar uma pré-verificação usando esta sintaxe:

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --precheckOnly yes

P: Como eu uso as credenciais SYSDBA para criptografar os tablespaces?

A: Você pode usar as credenciais SYSDBA adicionando a opção --useSysdbaCredential true:

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --useSysdbaCredential true

P: Quais são os pré-requisitos para executar o comando dbaascli tde encryptTablespacesInPDB?

R: Você deve executar o comando como usuário root e ter acesso à máquina virtual do Exadata Cloud@Customer.

P: Preciso reiniciar o banco de dados para criptografar os tablespaces?

R: Não, o comando não requer uma reinicialização do banco de dados. A criptografia é executada enquanto o banco de dados está on-line.

P: Preciso de credenciais SYSDBA para criptografar tablespaces?

R: Talvez você precise de credenciais SYSDBA para esta operação, se especificado usando a opção --useSysdbaCredential.

P: O que devo fazer se o comando falhar?

R: Certifique-se de que você esteja executando o comando como o usuário raiz e verifique se o nome do PDB (--pdbName) e o nome do banco de dados (--dbname) estão corretos. Você também pode executar o comando com --precheckOnly yes para verificar problemas antes de executar a criptografia completa.

P: O que devo fazer se a criptografia dos tablespaces falhar?

R: Verifique os logs do banco de dados e certifique-se de ter os privilégios e recursos necessários para executar a criptografia. Você também pode precisar verificar se há espaço suficiente para lidar com o processo de criptografia.

P: Como posso verificar se os tablespaces em um PDB estão criptografados?

R: Você pode consultar as views de banco de dados relacionadas à criptografia, como V$ENCRYPTED_TABLESPACES, para verificar se os tablespaces foram criptografados com sucesso.

P: Como posso verificar se a pré-verificação foi bem-sucedida?

R: Se você executou o comando com --precheckOnly yes, poderá verificar a saída em busca de avisos ou erros que indiquem possíveis problemas com o processo de criptografia.

P: Posso criptografar os tablespaces de vários PDBs simultaneamente?

R: Não, você precisa executar o comando dbaascli tde encryptTablespacesInPDB separadamente para cada PDB.

P: Posso criptografar parcialmente alguns tablespaces em um PDB?

R: Não, este comando criptografa todos os tablespaces dentro do PDB especificado. Para criptografia parcial, você precisaria usar comandos de gerenciamento de banco de dados diferentes.

P: A criptografia de tablespaces afeta o desempenho do banco de dados?

R: A criptografia de tablespaces pode ter um impacto temporário no desempenho durante o processo de criptografia. No entanto, o impacto deve ser mínimo quando a criptografia estiver concluída.

P: Posso desfazer a criptografia de tablespaces?

R: Não, depois que os tablespaces forem criptografados, a criptografia não poderá ser desfeita. Você só pode rotacionar ou recriptografar as chaves conforme necessário.

P: O que acontece se a operação for interrompida durante o processo de criptografia?

R: Se a operação for interrompida, talvez seja necessário reexecutar o comando. O sistema retomará a criptografia de onde parou e você poderá verificar o status usando views de banco de dados.

Exemplo 6-51 dbaascli tde encryptTablespacesInPDB

dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb
dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb --executePrereqs 

dbaascli tde fileToHsm

Para converter TDE baseada em FILE em TDE baseada em HSM (KMS/OKV), use o comando dbaascli tde fileToHsm.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde fileToHsm --kmsKeyOCID <value> --dbname <value> 
[--skipPatchCheck <value>] 
[--executePrereqs ] 
[--primarySuc <value>]
{
    [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]]
}
[--waitForCompletion <value>]
Em que:
  • --kmsKeyOCID especifica o OCID da chave KMS a ser usado para TDE. Isso só será aplicável se o KMS for selecionado para TDE
  • --dbname especifica o nome do banco de dados
  • --skipPatchCheck ignora a verificação de validação para patches obrigatórios se o valor informado para esse argumento for true. Valores válidos: true ou false
  • --executePrereqs - execute as verificações de pré-requisitos e reporte os resultados.
  • --primarySuc especifica essa propriedade no banco de dados stand-by do ambiente do Data Guard quando o comando é executado com sucesso no banco de dados principal
  • --resume especifica para retomar a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --revert especifica para fazer rollback da execução anterior
    • --sessionID especifica para fazer rollback de um ID de sessão específico
  • --waitForCompletion especifique false para executar a operação em segundo plano. Valores válidos : true|false.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde fileToHsm?

R: O comando dbaascli tde fileToHsm é usado para converter uma TDE (Transparent Data Encryption) baseada em arquivo para a TDE baseada no Módulo de Segurança de Hardware (HSM), como KMS ou OKV, em um ambiente do Oracle Database Cloud Service.

P: Quem pode executar o comando dbaascli tde fileToHsm?

A: O comando deve ser executado como o usuário root.

P: Qual é a finalidade do parâmetro --kmsKeyOCID?

R: O parâmetro --kmsKeyOCID especifica o OCID da chave KMS que será usado para criptografia de TDE ao fazer a transição de TDE baseada em arquivo para TDE baseada em HSM.

P: O que o parâmetro --dbname faz?

R: O parâmetro --dbname especifica o nome do banco de dados para o qual você está convertendo o TDE de baseado em arquivo para baseado em HSM.

P: Posso ignorar a verificação de validação do patch ao converter a TDE?

R: Sim, usando o parâmetro --skipPatchCheck com o valor true, você pode ignorar a verificação de validação dos patches necessários.

P: Para que o parâmetro --executePrereqs é usado?

R: O parâmetro --executePrereqs permite que você execute somente as pré-verificações do processo de conversão de TDE sem executar a conversão real. Os valores válidos são yes ou no.

P: O que o parâmetro --primarySuc faz em uma configuração do Data Guard?

R: O parâmetro --primarySuc é usado em um ambiente do Data Guard para indicar que o comando foi executado com sucesso no banco de dados principal. Ela deve ser especificada no banco de dados stand-by após a conclusão da conversão principal.

P: Como retomar uma conversão de TDE anterior?

R: Você pode retomar uma conversão de TDE anteriormente incompleta usando o parâmetro --resume. Opcionalmente, você pode especificar um ID de sessão específico com --sessionID.

P: Como reverter uma conversão de TDE?

R: Para reverter uma conversão de TDE anterior, use o parâmetro --revert. Você também pode fornecer o ID de sessão específico que deseja reverter usando --sessionID.

P: Como especificar um ID de sessão ao retomar ou reverter uma conversão de TDE?

R: Você pode usar o parâmetro --sessionID para especificar o ID da sessão que deseja retomar ou reverter. Exemplo: --resume --sessionID <ID> ou --revert --sessionID <ID>.

P: O que acontece se eu definir --waitForCompletion como falso?

R: Se você definir --waitForCompletion como false, o processo de conversão de TDE será executado em segundo plano e o prompt de comando retornará imediatamente. Se definido como true, o comando aguardará a conclusão do processo antes de retornar o controle ao usuário.

P: Quais são os valores válidos para o parâmetro --waitForCompletion?

A: Os valores válidos são true ou false. A definição dele como verdadeiro faz com que o comando aguarde até que o processo seja concluído; a definição dele como false executa o processo em segundo plano.

P: Posso executar dbaascli TDE fileToHsm sem converter o TDE imediatamente?

R: Sim, você pode usar o parâmetro --executePrereqs yes para executar apenas as pré-verificações da conversão, sem fazer alterações na TDE.

P: Em um ambiente do Data Guard, como lidar com o banco de dados stand-by após a conversão da TDE no principal?

R: Após executar com sucesso a conversão no banco de dados principal, você precisa especificar --primarySuc ao executar o comando no banco de dados stand-by.

P: O que devo fazer se o processo de conversão de TDE falhar?

R: Se o processo falhar, você poderá usar o parâmetro --resume para tentar retomar de onde parou. Se necessário, você pode usar o parâmetro --revert para fazer rollback das alterações feitas durante a sessão com falha.

Exemplo 6-52 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

Para obter detalhes da chave ativa de TDE, use o comando dbaascli tde getHsmKeys.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde getHsmKeys
[--dbname]
[--infoFile]
Em que:
  • --dbname especifica o nome do banco de dados
  • --infoFile especifica o caminho do arquivo em que a lista de OCIDs será salva. A saída está no formato JSON

Perguntas Frequentes

P: O que o comando dbaascli tde getHsmKeys faz?

R: O comando dbaascli tde getHsmKeys recupera detalhes de chaves TDE (Transparent Data Encryption) ativas do HSM (Hardware Security Module) de um banco de dados especificado.

P: Quem deve executar o comando dbaascli tde getHsmKeys?

A: O comando deve ser executado como o usuário root.

P: Em qual máquina devo executar o comando dbaascli tde getHsmKeys?

R: Você deve estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.

P: Onde posso encontrar instruções para conexão com a máquina virtual?

A: Consulte o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções sobre como estabelecer conexão.

P: O que a opção --dbname faz?

A: A opção --dbname permite especificar o nome do Oracle Database para o qual você deseja recuperar detalhes da chave de TDE.

P: O que a opção --infoFile faz?

A: A opção --infoFile especifica o caminho do arquivo no qual a lista de OCIDs de chave (Identificadores do Oracle Cloud) será salva. A saída está no formato JSON.

P: Você pode dar um exemplo de como recuperar detalhes da chave TDE de um banco de dados específico?

A: Veja um exemplo para obter os detalhes da chave TDE de um banco de dados chamado mydatabase:

dbaascli tde getHsmKeys --dbname mydatabase

P: Como faço para salvar os detalhes da chave TDE em um arquivo?

A: Você pode especificar um caminho de arquivo usando a opção --infoFile para salvar a saída no formato JSON:

dbaascli tde getHsmKeys --dbname mydatabase --infoFile /path/to/output.json

P: Quais são os pré-requisitos para executar o comando dbaascli tde getHsmKeys?

R: Você deve executar o comando como o usuário root e estar conectado à máquina virtual do Exadata Cloud@Customer.

P: Preciso de credenciais SYSDBA para recuperar detalhes da chave TDE?

R: Não, as credenciais SYSDBA não são necessárias para executar o comando dbaascli tde getHsmKeys.

P: Em que formato as informações da chave TDE são salvas ao usar a opção --infoFile?

R: A saída é salva no formato JSON.

P: Quais informações estão incluídas nos detalhes da chave TDE?

R: Os detalhes incluem OCIDs de chave e outros metadados sobre as chaves de criptografia ativas armazenadas no HSM para o banco de dados especificado.

P: O que devo fazer se o comando não recuperar os detalhes da chave?

R: Verifique se você está executando o comando como o usuário raiz e se o nome do banco de dados (--dbname) está correto. Verifique sua conexão com a máquina virtual do Exadata Cloud@Customer.

P: Como verifico se o arquivo de saída foi criado com sucesso?

R: Você pode verificar o caminho do arquivo especificado para o arquivo JSON de saída. Se o arquivo estiver ausente, verifique se o caminho do arquivo está correto e se você tem permissões de gravação no diretório.

P: O que devo fazer se o arquivo de saída estiver vazio?

R: Certifique-se de que o banco de dados especificado contenha chaves de TDE ativas e que o parâmetro --dbname esteja correto. Você também pode precisar verificar se há erros nos logs do banco de dados.

P: Posso recuperar detalhes da chave TDE para vários bancos de dados de uma só vez?

R: Não, você deve executar o comando dbaascli tde getHsmKeys separadamente para cada banco de dados.

P: Como posso usar o arquivo de saída da opção --infoFile em outras operações?

R: Como a saída está no formato JSON, você pode fazer parsing do arquivo de forma programática ou usá-lo como entrada para outras tarefas de gerenciamento de banco de dados ou criptografia.

P: Posso obter detalhes históricos da chave de TDE usando este comando?

R: Não, o comando recupera apenas detalhes sobre as chaves atualmente ativas no HSM.

P: Como posso verificar se as chaves recuperadas estão corretas?

R: Você pode verificar as chaves fazendo referência cruzada delas com a console do OCI (Oracle Cloud Infrastructure) ou usando views de banco de dados relacionadas ao gerenciamento de criptografia.

Exemplo 6-53 dbaascli tde getHsmKeys

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

dbaascli tde getMkidForKeyVersionOCID

Para obter o ID da Chave Principal associado ao OCID da versão da chave KMS, use o comando dbaascli tde getMkidForKeyVersionOCID.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde getMkidForKeyVersionOCID --kmsKeyVersionOCID <value>
[--dbname <value>]
[--waitForCompletion <value>]
Em que:
  • --kmsKeyVersionOCID especifica o OCID da versão da chave KMS a ser definido
  • --dbname especifica o nome do banco de dados
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos : true|false.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde getMkidForKeyVersionOCID?

R: O comando dbaascli tde getMkidForKeyVersionOCID recupera o MKID (Master Key ID) associado a um OCID específico da versão da chave KMS nos ambientes do Oracle Database Cloud Service.

P: Quais são os pré-requisitos para executar o comando dbaascli tde getMkidForKeyVersionOCID?

A: Você deve:
  • Execute o comando como usuário root.
  • Conecte-se a uma máquina virtual do Exadata Cloud@Customer via SSH.

P: Quem pode executar o comando dbaascli tde getMkidForKeyVersionOCID?

R: Somente o usuário root pode executar esse comando.

P: O que o parâmetro --kmsKeyVersionOCID especifica?

A: O parâmetro --kmsKeyVersionOCID especifica o OCID da versão da chave KMS para o qual você deseja recuperar o MKID (Master Key ID) associado.

P: O que o parâmetro --dbname especifica?

A: O parâmetro --dbname especifica o nome do banco de dados para o qual o OCID da versão da chave KMS está sendo consultado.

P: O parâmetro --dbname é obrigatório?

A: Não, o parâmetro --dbname é opcional. Se você não especificar um nome de banco de dados, o comando recuperará o MKID do banco de dados padrão no sistema.

P: O que devo fazer se não souber o OCID da versão da chave KMS?

R: Você deve recuperar o OCID da versão da chave KMS da console de gerenciamento do KMS ou do provedor de serviços antes de usar esse comando. Sem ele, o comando não pode recuperar o ID da chave mestra (MKID).

P: Posso executar este comando em um ambiente que não seja do Exadata Cloud@Customer?

R: Não, esse comando é especificamente para uso em um ambiente Exadata Cloud@Customer e você precisa estabelecer conexão com uma máquina virtual usando SSH para executá-lo.

P: O que acontece se eu executar o comando sem especificar um nome de banco de dados usando --dbname?

R: Se o parâmetro --dbname não for fornecido, o comando tentará recuperar o MKID do banco de dados padrão configurado no sistema.

P: O que devo fazer se encontrar um erro ao recuperar o MKID?

A: Certifique-se de que:
  • Você está executando o comando como o usuário root.
  • Você está conectado corretamente à máquina virtual do Exadata Cloud@Customer.
  • O OCID da versão da chave KMS fornecido é válido. Se o erro persistir, verifique os logs do sistema para obter mais detalhes.

P: Como estabeleço conexão com a máquina virtual do Exadata Cloud@Customer?

R: Você pode se conectar à máquina virtual via SSH. Consulte a documentação do Exadata Cloud@Customer para obter etapas sobre como estabelecer conexão segura.

Exemplo 6-54 dbaascli tde getMkidForKeyVersionOCID

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

dbaascli tde getPrimaryHsmKey

Para obter a chave HSM (KMS) primária da configuração HSM (KMS) existente, use o comando dbaascli tde getPrimaryHsmKey.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde getPrimaryHsmKey
[--dbname]
Em que:
  • --dbname especifica o nome do banco de dados

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde getPrimaryHsmKey?

R: O comando dbaascli tde getPrimaryHsmKey recupera a chave primária do Módulo de Segurança de Hardware (HSM) da configuração existente do HSM (KMS) em um ambiente do Oracle Database.

P: Quais são os pré-requisitos para executar o comando dbaascli tde getPrimaryHsmKey?

A: Você deve:
  • Execute o comando como usuário root.
  • Conecte-se a uma máquina virtual do Exadata Cloud@Customer via SSH.

P: Quem pode executar o comando dbaascli tde getPrimaryHsmKey?

A: Somente o usuário root pode executar esse comando.

P: O que o parâmetro --dbname especifica neste comando?

R: O parâmetro --dbname especifica o nome do banco de dados para o qual você deseja recuperar a chave HSM principal.

P: O parâmetro --dbname é obrigatório?

A: Não, o parâmetro --dbname é opcional. Se não for fornecida, o comando recuperará a chave HSM primária do banco de dados padrão no sistema.

P: O que devo fazer se não especificar um nome de banco de dados com --dbname?

R: Se o parâmetro --dbname não for especificado, o comando tentará recuperar a chave principal do HSM para o banco de dados padrão configurado no sistema.

P: Posso executar este comando em um ambiente que não seja do Exadata Cloud@Customer?

R: Não, esse comando foi projetado especificamente para uso em um ambiente Exadata Cloud@Customer e você deve estar conectado à máquina virtual usando SSH para executá-lo.

P: Como estabeleço conexão com a máquina virtual do Exadata Cloud@Customer para executar o comando?

R: Você pode se conectar à máquina virtual via SSH. Consulte a documentação do Exadata Cloud@Customer para obter instruções sobre como estabelecer conexão segura.

P: O que devo verificar se encontro um erro ao recuperar a chave principal do HSM?

R: Se você encontrar um erro, certifique-se de que:
  • Você está executando o comando como o usuário root.
  • Você está conectado corretamente à máquina virtual do Exadata Cloud@Customer.
  • O nome do banco de dados (se especificado) é válido. Se o problema persistir, consulte logs do sistema ou mensagens de erro para obter mais detalhes.

P: Eu preciso interromper o banco de dados para executar o comando dbaascli tde getPrimaryHsmKey?

R: Não, o banco de dados não precisa ser interrompido para executar este comando. Você pode executá-lo enquanto o banco de dados está em execução.

P: Qual é a finalidade de recuperar a chave principal do HSM?

R: A recuperação da chave HSM principal permite identificar a chave HSM atual que está sendo usada para criptografia na configuração HSM (KMS) existente do banco de dados.

Exemplo 6-55 dbaascli tde getPrimaryHsmKey

dbaascli tde getPrimaryHsmKey --dbname dbname

dbaascli tde hsmToFile

Para converter TDE baseada em HSM (KMS/OKV) em TDE baseada em FILE, use o comando dbaascli tde hsmToFile.

Execute o comando como usuário root.

Sintaxe

dbaascli tde hsmToFile 
[--dbname <value>] 
{
    [--prepareStandbyBlob <value> [--blobLocation <value>]
   | [--standbyBlobFromPrimary <value>]
}
] 
[--skipPatchCheck <value>] 
[--executePrereqs ] 
[--primarySuc <value>] 
{
     [--resume [--sessionID <value>]] |
     [--revert [--sessionID <value>]]
} 
[--waitForCompletion <value>]
Em que:
  • --dbname especifica o nome do banco de dados
  • --prepareStandbyBlob - especifique true para gerar um arquivo blob contendo os artefatos necessários para executar a operação em um ambiente do DG.
  • --blobLocation local de diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG.
  • --standbyBlobFromPrimary especifica o local do arquivo blob stand-by preparado no banco de dados principal. Isso só é necessário para operações stand-by. ]
  • --skipPatchCheck ignora a verificação de validação para patches obrigatórios se o valor informado para esse argumento for true. Valores válidos: true ou false
  • --executePrereqs - execute as verificações de pré-requisitos e reporte os resultados.
  • --primarySuc especifica essa propriedade no banco de dados stand-by do ambiente do Data Guard quando o comando é executado com sucesso no banco de dados principal
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --revert especifica para fazer rollback da execução anterior
    • --sessionID especifica para fazer rollback de um ID de sessão específico
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true|false

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde hsmToFile?

R: O comando dbaascli tde hsmToFile é usado para converter um TDE (Transparent Data Encryption) baseado no Módulo de Segurança de Hardware (HSM) em um TDE baseado em arquivo nos ambientes do Oracle Database Cloud Service.

P: Quais são os pré-requisitos para executar o comando dbaascli tde hsmToFile?

A: Você deve:
  • Execute o comando como usuário root.
  • Certifique-se de ter as permissões e configurações necessárias definidas no ambiente de banco de dados.

P: O que o parâmetro --dbname especifica?

R: O parâmetro --dbname especifica o nome do banco de dados para o qual você está convertendo o TDE de baseado em HSM para baseado em arquivo.

P: Quando o parâmetro --primaryDBWalletTar é necessário?

R: O parâmetro --primaryDBWalletTar só é necessário ao executar a conversão hsmToFile em um banco de dados stand-by. Especifica o arquivo tar da wallet do banco de dados principal.

P: Qual é a finalidade do parâmetro --skipPatchCheck?

R: O parâmetro --skipPatchCheck permite ignorar a verificação de validação dos patches necessários. Defina isso como true para ignorar a verificação ou false para aplicá-la.

P: Como executar apenas pré-verificações para o processo de conversão sem executar a conversão real?

R: Você pode usar o parâmetro --executePrereqs e defini-lo como yes para executar somente as pré-verificações. Defina-o como no para executar a conversão completa.

P: O que o parâmetro --primarySuc faz em um ambiente do Data Guard?

R: O parâmetro --primarySuc é usado em uma configuração do Data Guard para indicar que a conversão foi executada com sucesso no banco de dados principal. Ele deve ser usado ao executar a conversão no banco de dados stand-by.

P: Como posso retomar uma conversão hsmToFile anterior?

R: Você pode retomar uma conversão anterior usando o parâmetro --resume. Opcionalmente, você pode especificar o ID da sessão da execução anterior com --sessionID.

P: Qual é a finalidade do parâmetro --revert?

R: O parâmetro --revert é usado para fazer rollback de um processo de conversão iniciado anteriormente em caso de falha ou se você precisar desfazer a operação.

P: O que acontece se eu definir --waitForCompletion como falso?

R: Se você definir --waitForCompletion como false, a operação será executada em segundo plano, permitindo que você continue outras tarefas. Se definido como true, o comando aguardará a conclusão do processo antes de retornar o controle ao usuário.

P: O que devo fazer se precisar converter a TDE em um banco de dados stand-by em uma configuração do Data Guard?

R: Em uma configuração do Data Guard, depois de converter TDE no banco de dados principal, você deve executar o comando no banco de dados stand-by usando o parâmetro --primaryDBWalletTar, especificando o arquivo tar da wallet do banco de dados principal e incluir --primarySuc.

P: O que devo fazer se quiser ignorar a verificação dos patches necessários durante a conversão?

R: Você pode ignorar a verificação de patch usando o parâmetro --skipPatchCheck e definindo-o como true.

P: Como verifico se o sistema está pronto para a conversão hsmToFile sem fazer alterações?

R: Você só pode executar as pré-verificações usando o parâmetro --executePrereqs e definindo-o como yes.

P: O que devo fazer se o processo de conversão for interrompido?

R: Você pode usar o parâmetro --resume para reiniciar o processo de onde ele parou. Opcionalmente, você pode especificar um ID de sessão específico com --sessionID.

P: O que devo fazer se o processo de conversão falhar?

R: Se a conversão falhar, você poderá fazer rollback do processo usando o parâmetro --revert. Além disso, revise quaisquer mensagens de erro e verifique os logs do sistema para obter mais detalhes.

P: Posso executar o comando dbaascli tde hsmToFile em um ambiente não Exadata?

R: Este comando foi projetado para uso em ambientes Exadata Cloud@Customer. Se você não estiver usando o Exadata, certifique-se de estar em um ambiente suportado para que o comando funcione corretamente.

Exemplo 6-56 dbaascli tde hsmToFile

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

dbaascli tde listKeys

Para listar chaves principais de TDE, use o comando dbaascli tde listKeys.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde listKeys
[--dbname <value>]
[--infoFilePath <value>]
Em que:
  • --dbname especifica o nome do banco de dados
  • --infoFilePath - especifique o caminho absoluto do arquivo no qual os resultados serão salvos.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde listKeys?

R: O comando dbaascli tde listKeys é usado para listar todas as chaves principais de TDE (Transparent Data Encryption) de um banco de dados especificado em um ambiente do Oracle Database.

P: Quais são os pré-requisitos para executar o comando dbaascli tde listKeys?

A: Você deve:
  • Execute o comando como usuário root.
  • Conecte-se a uma máquina virtual do Exadata Cloud@Customer usando SSH.

P: O que o parâmetro --file faz no comando dbaascli tde listKeys?

A: O parâmetro --file especifica o caminho do arquivo no qual a lista de chaves mestras de TDE deve ser salva. Se esse parâmetro não for fornecido, os resultados serão exibidos diretamente no terminal.

P: O que o parâmetro --dbname especifica?

A: O parâmetro --dbname especifica o nome do banco de dados cujas chaves principais de TDE você deseja listar.

P: O parâmetro --file é obrigatório?

A: Não, o parâmetro --file é opcional. Se não for fornecida, a lista de chaves de TDE será mostrada na saída do terminal, em vez de ser salva em um arquivo.

P: O parâmetro --dbname é obrigatório?

A: Não, o parâmetro --dbname é opcional. Se não for especificado, o comando listará as chaves principais de TDE para o banco de dados padrão configurado no sistema.

P: O que devo fazer se eu quiser salvar a lista de chaves em um arquivo?

R: Você deve fornecer o parâmetro --file junto com o caminho de arquivo desejado. Por exemplo:

dbaascli tde listKeys --file /path/to/output.txt

P: O que acontece se eu não fornecer um nome de banco de dados com --dbname?

R: Se o parâmetro --dbname não for fornecido, o comando listará as chaves principais de TDE para o banco de dados padrão no sistema.

P: Posso usar esse comando em ambientes diferentes do Exadata Cloud@Customer?

R: Este comando foi projetado especificamente para ambientes Exadata Cloud@Customer. Verifique se você está conectado à máquina virtual apropriada para executá-la.

P: O que devo fazer se o comando falhar ao listar chaves?

A: Certifique-se de que:
  • Você está executando o comando como o usuário root.
  • Você está conectado à máquina virtual do Exadata Cloud@Customer.
  • O nome do banco de dados (se especificado) está correto. Verifique as mensagens de erro e os logs para obter mais detalhes sobre a falha.

P: Posso executar o comando dbaascli tde listKeys enquanto o banco de dados está em execução?

R: Sim, o comando pode ser executado enquanto o banco de dados está em execução. Ele simplesmente lista as chaves principais de TDE e não altera o estado do banco de dados.

P: Preciso de permissões especiais para executar este comando?

R: Execute esse comando como usuário root. Sem permissões root, você não poderá executar o comando.

P: Qual é a finalidade de listar as chaves mestras de TDE?

R: A listagem de chaves principais de TDE permite que você revise as chaves de criptografia que estão sendo usadas para proteger os dados do seu banco de dados. É essencial para monitorar e gerenciar configurações de criptografia.

P: Como estabeleço conexão com a máquina virtual do Exadata Cloud@Customer para executar o comando?

R: Você pode se conectar à máquina virtual usando SSH. Consulte a documentação do Exadata Cloud@Customer para obter instruções sobre como estabelecer uma conexão segura.

Exemplo 6-57 dbaascli tde listKeys

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

dbaascli tde removeSecondaryHsmKey

Para remover a chave HSM (KMS) secundária da configuração HSM (KMS) existente, use o comando dbaascli tde removeSecondaryHsmKey.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde removeSecondaryHsmKey --dbname <value>
[--confirmDeletion]
[--secondaryKmsKeyOCID]
[--executePrereqs]
Em que:
  • --dbname especifica o nome do banco de dados
  • --confirmDeletion - se não for especificado, o usuário será avisado durante a exclusão de todas as chaves HSM(KMS) existentes.
  • --secondaryKmsKeyOCID - chave KMS secundária a ser removida da configuração HSM(KMS) existente. Se não for especificada, todas as chaves KMS secundárias serão removidas.
  • --executePrereqs - execute as verificações de pré-requisitos e reporte os resultados.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde removeSecondaryHsmKey?

R: O comando dbaascli tde removeSecondaryHsmKey é usado para remover uma chave secundária do Módulo de Segurança de Hardware (HSM) da configuração existente do HSM (KMS) em um ambiente do Oracle Database.

P: Quais são os pré-requisitos para executar o comando dbaascli tde removeSecondaryHsmKey?

A: Você deve:
  • Execute o comando como usuário root.
  • Conecte-se a uma máquina virtual do Oracle Exadata Database Service no Exascale Infrastructure usando SSH.

P: O que o parâmetro --force faz no comando dbaascli tde removeSecondaryHsmKey?

R: O parâmetro --force permite a remoção da chave secundária do HSM sem solicitar confirmação ao usuário. Se não for especificado, o comando solicitará ao usuário antes de excluir as chaves.

P: O que o parâmetro --secondaryKmsKeyOCID especifica?

A: O parâmetro --secondaryKmsKeyOCID especifica o OCID (Oracle Cloud Identifier) da chave KMS secundária que você deseja remover da configuração do HSM existente.

P: O que o parâmetro --dbname faz?

R: O parâmetro --dbname especifica o nome do banco de dados para o qual a chave HSM secundária está sendo removida.

P: Qual é a finalidade do parâmetro --precheckOnly?

R: O parâmetro --precheckOnly, se definido como yes, só executará as pré-verificações para validar a prontidão da operação de remoção sem realmente remover a chave HSM secundária. Se definido como no, a operação de remoção completa será executada.

P: O parâmetro --force é obrigatório?

A: Não, o parâmetro --force é opcional. Se não for especificado, o sistema solicitará confirmação ao usuário antes de prosseguir com a remoção da chave.

P: O parâmetro --secondaryKmsKeyOCID é obrigatório?

R: Sim, você deve fornecer o --secondaryKmsKeyOCID para identificar a chave HSM secundária específica que deseja remover da configuração.

P: O parâmetro --dbname é obrigatório?

A: Não, o parâmetro --dbname é opcional. Se não for especificado, o comando tentará remover a chave secundária do HSM do banco de dados padrão no sistema.

P: O que devo fazer se eu quiser remover a chave secundária do HSM sem prompts do usuário?

R: Você deve usar o parâmetro --force para ignorar o prompt de confirmação e remover a chave secundária do HSM diretamente:

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

P: Como posso testar se o sistema está pronto para remover a chave HSM secundária sem realmente removê-la?

A: Você pode usar o parâmetro --precheckOnly definido como sim para executar uma pré-verificação:

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

P: O que acontece se eu não fornecer um nome de banco de dados com --dbname?

R: Se o parâmetro --dbname não for especificado, o comando tentará remover a chave secundária do HSM do banco de dados padrão configurado no sistema.

P: O que devo verificar se o comando falha ao remover a chave secundária do HSM?

A: Certifique-se de que:
  • Você está executando o comando como o usuário root.
  • Você está conectado à máquina virtual do Exadata Database Service on Exascale Infrastructure.
  • Os valores --secondaryKmsKeyOCID e --dbname corretos são fornecidos. Verifique as mensagens de erro e os logs para obter mais detalhes sobre a falha.

P: O que devo fazer se a operação de remoção falhar a meio do caminho?

R: Se a operação falhar, revise os logs de erro e tente executar o comando com --precheckOnly para garantir que o sistema esteja pronto para a operação. Se necessário, corrija os problemas antes de tentar novamente.

P: Posso executar o comando dbaascli tde removeSecondaryHsmKey enquanto o banco de dados está em execução?

R: Sim, o comando pode ser executado enquanto o banco de dados está em execução, pois não requer que o banco de dados seja interrompido.

P: Qual é a finalidade de remover uma chave HSM secundária?

R: A remoção de uma chave HSM secundária geralmente é feita quando a chave não é mais necessária ou quando você deseja gerenciar as chaves de criptografia usadas na configuração de TDE (Criptografia Transparente de Dados).

P: Como estabeleço conexão com a máquina virtual do Exadata Database Service on Exascale Infrastructure para executar o comando?

R: Você pode se conectar à máquina virtual usando SSH. Consulte a documentação do Exadata Database Service on Exascale Infrastructure para obter instruções sobre como estabelecer uma conexão segura.

Exemplo 6-58 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

Para rotacionar a chave principal da criptografia de banco de dados, use o comando dbaascli tde rotateMasterKey.

Pré-requisitos:

Execute o comando como usuário root.

Sintaxe

dbaascli tde rotateMasterKey --dbname <value> 
[--rotateMasterKeyOnAllPDBs] 
[--pdbName <value>] 
[--executePrereqs] 
[--resume [--sessionID <value>]]
{
     [--prepareStandbyBlob <value> [--blobLocation <value>]]
     | [--standbyBlobFromPrimary <value>]
 }
Em que:
  • --dbname especifica o nome do Oracle Database
  • --rotateMasterKeyOnAllPDBs especifica true para rotacionar a chave principal de todos os PDBs no CDB. Valores válidos: true|false
  • --pdbName especifica o nome do PDB
  • --executePrereqs executa as verificações de pré-requisitos e reporta os resultados
  • --resume especifica a retomada da execução anterior
  • --sessionID especifica para retomar um ID de sessão específico
  • --prepareStandbyBlob especifica true para gerar um arquivo BLOB contendo os artefatos necessários para executar a operação em um ambiente do Data Guard
  • --blobLocation especifica o local do diretório personalizado no qual o arquivo BLOB stand-by será gerado em um ambiente do Data Guard
  • --standbyBlobFromPrimary especifica o local do arquivo BLOB stand-by, que é preparado usando o banco de dados principal. Isso só é necessário para operações stand-by.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde rotateMasterKey?

R: O comando dbaascli tde rotateMasterKey é usado para rotacionar a chave mestra usada para TDE (Transparent Data Encryption) em um Oracle Database. Esse processo garante que as chaves de criptografia sejam atualizadas para melhor segurança.

P: Quais são os pré-requisitos para executar o comando dbaascli tde rotateMasterKey?

A: Você deve:
  • Execute o comando como usuário root.
  • Certifique-se de que o banco de dados esteja configurado corretamente para TDE.

P: O que o parâmetro --dbname especifica?

R: O parâmetro --dbname especifica o nome do Oracle Database para o qual você deseja rotacionar a chave de criptografia principal.

P: Qual é a finalidade do parâmetro --rotateMasterKeyOnAllPDBs?

A: O parâmetro --rotateMasterKeyOnAllPDBs especifica se a chave principal deve ser rotacionada para todos os PDBs (Bancos de Dados Plugáveis) em um CDB (Banco de Dados Contêiner). Os valores válidos são verdadeiro ou falso.

P: O que o parâmetro --pdbName faz?

R: O parâmetro --pdbName especifica o nome de um PDB (Banco de Dados Plugável) específico se você quiser rotacionar a chave principal de um PDB específico em vez de todos os PDBs.

P: O que o parâmetro --executePrereqs faz?

R: O parâmetro --executePrereqs executa verificações de pré-requisitos para validar se o ambiente está pronto para a rotação da chave mestra sem executar a rotação real.

P: O que o parâmetro --resume especifica?

R: O parâmetro --resume é usado para retomar uma operação iniciada anteriormente. Você também pode fornecer um ID de sessão específico usando --sessionID para retomar uma sessão específica.

P: Qual é a finalidade do parâmetro --prepareStandbyBlob?

R: O parâmetro --prepareStandbyBlob, se definido como verdadeiro, gera um arquivo BLOB contendo os artefatos necessários para executar a rotação da chave principal em um ambiente do Data Guard.

P: O que o parâmetro --blobLocation faz?

A: O parâmetro --blobLocation especifica um caminho de diretório personalizado no qual o arquivo BLOB stand-by será gerado. Isso é aplicável quando --prepareStandbyBlob é definido como true.

P: O que o parâmetro --standbyBlobFromPrimary especifica?

R: O parâmetro --standbyBlobFromPrimary especifica a localização do arquivo BLOB stand-by que foi gerado com base no banco de dados principal. Esse parâmetro é usado ao executar a rotação de chave mestra em um banco de dados stand-by em um ambiente do Data Guard.

P: O parâmetro --rotateMasterKeyOnAllPDBs é obrigatório?

A: Não, o parâmetro --rotateMasterKeyOnAllPDBs é opcional. Se ela não for especificada, a chave mestra só será rotacionada para o banco de dados (ou PDB específico) fornecido nos parâmetros --dbname ou --pdbName.

P: O parâmetro --pdbName será necessário se eu estiver rotacionando chaves para um CDB?

R: Não, o parâmetro --pdbName só será necessário se você quiser rotacionar a chave mestra de um PDB (Banco de Dados Plugável) específico. É opcional ao girar a chave de todo o CDB.

P: Preciso usar os parâmetros --prepareStandbyBlob e --standbyBlobFromPrimary para bancos de dados stand-alone?

R: Não, esses parâmetros só são relevantes em um ambiente do Data Guard em que um banco de dados stand-by está envolvido.

P: Como posso rotacionar a chave principal de todos os PDBs em um CDB?

R: Você deve usar o parâmetro --rotateMasterKeyOnAllPDBs definido como verdadeiro para rotacionar a chave principal de todos os PDBs no CDB. Por exemplo:

dbaascli tde rotateMasterKey --dbname CDB_NAME --rotateMasterKeyOnAllPDBs true

P: Como faço para executar uma verificação para validar se o sistema está pronto para a rotação da chave principal sem executar a operação real?

R: Você pode usar o parâmetro --executePrereqs para executar as verificações de pré-requisitos. Isso reportará quaisquer problemas que possam impedir a rotação da chave mestra:

dbaascli tde rotateMasterKey --dbname DB_NAME --executePrereqs

P: O que devo fazer se a operação for interrompida e eu quiser retomá-la?

R: Você pode usar o parâmetro --resume para retomar a operação interrompida anteriormente. Se você tiver um ID de sessão, forneça-o com o parâmetro --sessionID:

dbaascli tde rotateMasterKey --dbname DB_NAME --resume --sessionID <value>

P: Como posso me preparar para a rotação de chaves em um ambiente do Data Guard?

A: Você deve usar o parâmetro --prepareStandbyBlob para gerar um arquivo BLOB que contenha os artefatos necessários para rotacionar a chave principal em um ambiente stand-by:

dbaascli tde rotateMasterKey --dbname DB_NAME --prepareStandbyBlob true --blobLocation /path/to/blob

P: Como aplicar o arquivo BLOB stand-by do banco de dados principal ao rotacionar chaves em um banco de dados stand-by?

A: Use o parâmetro --standbyBlobFromPrimary para especificar o local do arquivo BLOB que foi preparado no banco de dados principal:

dbaascli tde rotateMasterKey --dbname DB_NAME --standbyBlobFromPrimary /path/to/blob

P: O que devo verificar se a rotação da chave mestra falha?

A: Certifique-se de que:
  • Você está executando o comando como o usuário root.
  • O nome do banco de dados (--dbname) está correto.
  • Todas as verificações de pré-requisitos foram executadas usando --executePrereqs para garantir a prontidão. Revise os logs de erro para obter informações mais detalhadas sobre a falha.

P: O que devo fazer se a operação não for concluída com sucesso em um ambiente do Data Guard?

R: Certifique-se de que o arquivo BLOB do banco de dados principal foi preparado corretamente usando --prepareStandbyBlob e, em seguida, use --standbyBlobFromPrimary para aplicá-lo no banco de dados stand-by.

P: Posso executar o comando dbaascli tde rotateMasterKey enquanto o banco de dados está em execução?

R: Sim, o comando pode ser executado enquanto o banco de dados está em execução. No entanto, é recomendável executar verificações de pré-requisitos de antemão usando a opção --executePrereqs.

P: Por que girar a chave mestra é importante?

R: A rotação da chave mestra melhora a segurança do banco de dados, garantindo que as chaves de criptografia usadas para proteção de dados sejam atualizadas periodicamente, reduzindo o risco de comprometimento da chave.

P: Preciso reiniciar o banco de dados após rotacionar a chave mestra?

R: Não, a reinicialização do banco de dados não é necessária após a rotação da chave mestra. A rotação de chaves entrará em vigor imediatamente sem qualquer interrupção do serviço.

dbaascli tde setKeyVersion

Para definir a versão da chave primária a ser usada no DB/CDB ou no PDB, use o comando dbaascli tde setKeyVersion.

Execute o comando como usuário root.

Sintaxe

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <value>
[--pdbName <value>]
[--masterKeyID <value>]
[--standbySuc]
[--executePrereqs]
[--waitForCompletion <value>]
Em que:
  • --kmsKeyVersionOCID especifica o OCID da versão da chave KMS a ser definido.
  • --dbname especifica o nome do banco de dados.
  • --pdbName nome do PDB para usar o OCID da versão da chave.
  • --masterKeyID especifica o ID da chave principal do OCID da versão da chave informada. Isso se aplica ao ambiente do Data Guard.
  • --standbySuc especifica essa propriedade no banco de dados principal do ambiente do Data Guard quando o comando é executado com sucesso no banco de dados stand-by
  • --executePrereqs - execute as verificações de pré-requisitos e reporte os resultados.
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true|false

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde setKeyVersion?

R: O comando dbaascli tde setKeyVersion é usado para definir a versão da chave de criptografia primária que deve ser usada para Criptografia Transparente de Dados (TDE) em um banco de dados ou Banco de Dados Plugável (PDB). Isso permite que a versão específica de uma chave KMS seja designada ao banco de dados.

P: Quais são os pré-requisitos para usar o comando dbaascli tde setKeyVersion?

R: Execute o comando como usuário root e certifique-se de estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: O que o parâmetro --kmsKeyVersionOCID especifica?

A: O parâmetro --kmsKeyVersionOCID especifica o OCID (Oracle Cloud Identifier) da versão da chave KMS que você deseja definir para o banco de dados ou o PDB.

P: O que o parâmetro --dbname especifica?

A: O parâmetro --dbname especifica o nome do Oracle Database para o qual a versão da chave será definida.

P: Qual é a finalidade do parâmetro --pdbName?

R: O parâmetro --pdbName especifica o nome do PDB (Banco de Dados Plugável) em um CDB (Banco de Dados Contêiner) no qual você deseja definir a versão da chave KMS específica.

P: Para que o parâmetro --masterKeyID é usado?

A: O parâmetro --masterKeyID especifica o ID da chave mestra associado ao OCID da versão da chave KMS fornecido. Isso é particularmente importante em um ambiente do Data Guard.

P: Qual é a atribuição do parâmetro --standbySuc?

A: O parâmetro --standbySuc é usado em um ambiente do Data Guard. Especifica que essa propriedade deve ser definida no banco de dados principal após a execução bem-sucedida do comando no banco de dados stand-by.

P: O que o parâmetro --executePrereqs faz?

R: O parâmetro --executePrereqs especifica se as verificações de pré-requisitos devem ser executadas antes da execução da operação. Os valores válidos são yes ou no.

P: O que o parâmetro --waitForCompletion controla?

R: O parâmetro --waitForCompletion determina se a operação será executada de forma síncrona (aguardando conclusão) ou assíncrona (em segundo plano). Os valores válidos são true ou false.

P: O parâmetro --pdbName é necessário se a versão da chave for definida para um CDB?

R: Não, o parâmetro --pdbName só será necessário se você estiver definindo a versão da chave para um PDB (Banco de Dados Plugável) específico. É opcional se você estiver definindo a versão da chave para todo o Banco de Dados Contêiner (CDB).

P: O parâmetro --masterKeyID é necessário para ambientes que não são do Data Guard?

R: Não, o parâmetro --masterKeyID geralmente só é usado em ambientes do Data Guard. Para bancos de dados independentes, esse parâmetro não é necessário.

P: Como defino a versão da chave para um banco de dados?

A: Você pode definir a versão da chave para um banco de dados executando:

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME>

P: Como defino a versão da chave para um PDB específico?

A: Para definir a versão da chave para um PDB (Banco de Dados Plugável) específico, use o parâmetro --pdbName com o nome do banco de dados:

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME> --pdbName <PDB_NAME>

P: Como posso garantir que todos os pré-requisitos sejam atendidos antes de definir a versão da chave?

A: Você pode executar as verificações de pré-requisitos usando o parâmetro --executePrereqs:

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --executePrereqs yes

P: Como defino a versão da chave em um ambiente do Data Guard?

A: Em um ambiente do Data Guard, você deve:
  • Execute o comando no banco de dados stand-by:

    dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --masterKeyID <keyID> --dbname <DB_NAME>

  • Após executar com sucesso o comando no banco de dados stand-by, execute o comando no banco de dados principal usando o parâmetro --standbySuc:

    dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME> --standbySuc yes

P: Como posso executar a operação em segundo plano sem esperar que ela seja concluída?

A: Você pode executar a operação de forma assíncrona definindo --waitForCompletion como false:

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --waitForCompletion false

P: O que devo fazer se a versão da chave não for definida?

A: Certifique-se de que:
  • Você está executando o comando como o usuário root.
  • O OCID da versão da chave KMS está correto.
  • Todas as verificações de pré-requisitos foram executadas usando --executePrereqs para garantir a prontidão. Revise os logs de erro para obter detalhes específicos e execute novamente a operação, se necessário.

P: O que devo verificar se a operação não foi concluída com sucesso em um ambiente do Data Guard?

R: Certifique-se de que o parâmetro --masterKeyID esteja especificado corretamente ao executar o comando no banco de dados stand-by. Uma vez concluído no stand-by, o parâmetro --standbySuc deverá ser usado ao executar o comando no banco de dados principal.

P: Posso executar o comando dbaascli tde setKeyVersion enquanto o banco de dados está em execução?

R: Sim, o comando pode ser executado enquanto o banco de dados está em execução. No entanto, é recomendável executar as verificações de pré-requisitos antecipadamente usando --executePrereqs.

P: Por que é importante definir a versão correta da chave KMS para um banco de dados?

A definição da versão correta da chave KMS garante que o banco de dados esteja usando a versão apropriada da chave de criptografia para TDE, o que ajuda a manter a segurança dos dados e a conformidade com as políticas organizacionais.

P: O que acontece se eu usar o OCID errado da versão da chave KMS?

R: Se um OCID incorreto da versão da chave KMS for usado, a criptografia poderá falhar e o banco de dados não poderá usar a chave incorreta para operações de criptografia. Certifique-se de que o OCID correto da versão da chave seja fornecido.

P: Preciso reiniciar o banco de dados após definir a versão da chave?

R: Não, a reinicialização do banco de dados não é necessária após definir a versão da chave. A nova versão da chave entrará em vigor imediatamente sem exigir uma reinicialização.

Exemplo 6-59 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

Para alterar a chave HSM (KMS) primária para a configuração HSM (KMS) existente, use o comando dbaascli tde setPrimaryHsmKey.

Execute o comando como usuário root.

Sintaxe

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <value> --dbname <value>
[--allStandbyPrepared]
[--bounceDatabase]
[--executePrereqs]
[--resume [--sessionID <value>]]
Em que:
  • --primaryKmsKeyOCID especifica a chave KMS primária a ser definida
  • --dbname especifica o nome do banco de dados
  • --allStandbyPrepared - especifique para confirmar se a operação foi executada com sucesso em todos os bancos de dados stand-by.
  • --bounceDatabase especifica este flag para fazer bounce do banco de dados incremental para esta operação
  • --executePrereqs - execute as verificações de pré-requisitos e reporte os resultados.
  • --resume para retomar a execução anterior
  • --sessionID para retomar um id de sessão específico.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde setPrimaryHsmKey?

R: O comando dbaascli tde setPrimaryHsmKey é usado para alterar a chave primária do HSM (Hardware Security Module) ou KMS (Key Management Service) em uma configuração existente do HSM/KMS para TDE (Transparent Data Encryption).

P: Quais são os pré-requisitos para executar o comando dbaascli tde setPrimaryHsmKey?

R: O comando deve ser executado como o usuário root e o ambiente deve ser uma máquina virtual do Exadata Cloud@Customer.

P: O que o parâmetro --primaryKmsKeyOCID especifica?

A: O parâmetro --primaryKmsKeyOCID especifica o OCID (Oracle Cloud Identifier) da chave KMS principal a ser definida para o ambiente de TDE.

P: Qual é a função do parâmetro --dbname?

A: O parâmetro --dbname especifica o nome do Oracle Database para o qual a chave principal do HSM/KMS será definida.

P: O que o parâmetro --standbySuc faz?

A: O parâmetro --standbySuc é usado em um ambiente do Data Guard. Ele especifica que o comando deve ser executado no banco de dados principal após sua execução com sucesso no banco de dados stand-by.

P: Qual é a finalidade do parâmetro --precheckOnly?

R: O parâmetro --precheckOnly permite que você execute somente as pré-verificações para esta operação. Ele valida o ambiente sem fazer alterações reais. Os valores válidos são yes ou no.

P: O que o parâmetro --bounceDatabase controla?

R: O parâmetro --bounceDatabase especifica se o banco de dados deve ser devolvido (reiniciado) de maneira incremental como parte da operação. Isso garante um tempo de inatividade mínimo reiniciando partes do banco de dados uma a uma.

P: Como defino a chave KMS principal do meu banco de dados?

A: Para definir a chave KMS primária, execute o seguinte comando:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME>

P: Como posso garantir que a operação possa ser executada sem problemas?

A: Execute a operação com o parâmetro --precheckOnly para verificar se todos os pré-requisitos foram atendidos:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --precheckOnly yes

P: Como defino a chave KMS principal em um ambiente do Data Guard?

A: Primeiro, execute o comando no banco de dados stand-by:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME>

Em seguida, execute o comando no banco de dados principal com o parâmetro --standbySuc:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME> --standbySuc yes

P: Como minimizo o tempo de inatividade ao alterar a chave KMS principal?

A: Você pode usar o parâmetro --bounceDatabase para executar uma reinicialização incremental, minimizando o tempo de inatividade:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --bounceDatabase

P: O parâmetro --dbname é necessário para todos os bancos de dados?

R: Sim, você deve especificar o parâmetro --dbname para indicar o banco de dados de destino para o qual a chave KMS principal deve ser definida.

P: É obrigatório usar o parâmetro --standbySuc em um ambiente do Data Guard?

R: Sim, o parâmetro --standbySuc deve ser usado ao executar o comando no banco de dados principal após executá-lo com sucesso no banco de dados stand-by.

P: Posso ignorar a operação de bounce do banco de dados?

R: Sim, se você não especificar o parâmetro --bounceDatabase, o banco de dados não será devolvido (reiniciado) como parte da operação.

P: O que devo fazer se o comando falhar durante a execução?

A: Se o comando falhar, certifique-se de:
  • Você o está executando como o usuário root.
  • Os valores --primaryKmsKeyOCID e --dbname corretos são fornecidos.
  • O ambiente passa por todas as verificações de pré-requisitos (executado com --precheckOnly).

P: E se a operação falhar em um ambiente do Data Guard?

R: Certifique-se de que o comando tenha sido executado com sucesso no banco de dados stand-by antes de executá-lo no principal. Verifique se há erros nos logs e execute novamente a operação com os parâmetros corretos.

P: Posso executar o comando dbaascli tde setPrimaryHsmKey em um banco de dados ativo?

R: Sim, o comando pode ser executado enquanto o banco de dados estiver ativo. No entanto, o uso do parâmetro --bounceDatabase reiniciará o banco de dados de forma incremental, o que minimiza o impacto.

P: Como faço para executar o comando de forma contínua para evitar tempo de inatividade completo?

A: Use o parâmetro --bounceDatabase para executar uma reinicialização incremental do banco de dados ao alterar a chave KMS principal:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --bounceDatabase

P: Qual é o significado de alterar a chave KMS primária?

R: A alteração da chave KMS principal garante que o banco de dados use uma chave de criptografia atualizada ou diferente para TDE (Transparent Data Encryption). Isso pode ser necessário por motivos de segurança ou conformidade.

P: Com que frequência a chave KMS primária deve ser girada ou alterada?

R: Embora não haja uma regra estrita, as organizações podem rotacionar a chave KMS principal com base em políticas de segurança, como intervalos de rotação de chaves ou requisitos de conformidade.

P: O que acontece se a chave KMS principal estiver definida incorretamente?

R: Se o OCID da chave incorreta for definido, as operações de criptografia do banco de dados poderão falhar e talvez você precise reverter para a chave correta ou retificar a configuração definindo o OCID da chave KMS correta.

P: Preciso reiniciar o banco de dados depois de alterar a chave KMS principal?

R: Não, você não precisa reiniciar o banco de dados, a menos que opte por usar o parâmetro --bounceDatabase, que reiniciará automaticamente o banco de dados para aplicar a alteração.

Exemplo 6-60 dbaascli tde setPrimaryHsmKey

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

dbaascli tde status

Para exibir informações sobre o armazenamento de chaves do banco de dados especificado, use o comando dbaascli tde status.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli tde status --dbname dbname
Em que:
  • --dbname especifica o nome do banco de dados que você deseja verificar.

A saída do comando inclui o tipo e o status do armazenamento de chaves.

Perguntas Frequentes

P: O que o comando dbaascli tde status faz?

A: O comando dbaascli tde status exibe informações sobre o armazenamento de chaves de um banco de dados especificado. Isso inclui detalhes sobre o tipo de armazenamento de chaves e seu status.

P: Quem deve executar o comando dbaascli tde status?

A: O comando deve ser executado como o usuário oracle.

P: Onde o comando dbaascli tde status deve ser executado?

R: O comando deve ser executado em uma máquina virtual do Exadata Cloud@Customer. Você deve se conectar à máquina virtual via SSH para executar o utilitário.

P: Qual é a função do parâmetro --dbname?

R: O parâmetro --dbname especifica o nome do banco de dados para o qual o status da área de armazenamento de chaves de TDE será verificado.

P: Quais informações o comando dbaascli tde status retorna?

A: A saída do comando inclui o tipo de armazenamento de chaves (por exemplo, baseado em HSM ou baseado em arquivo) e o status atual do armazenamento de chaves, como se ele está aberto, fechado ou em algum outro estado.

P: Como posso saber se a área de armazenamento de chaves está aberta ou fechada usando o comando dbaascli tde status?

R: O status da área de armazenamento de chaves, incluindo se ela está aberta ou fechada, faz parte da saída retornada pelo comando dbaascli tde status.

P: Como verifico o status do armazenamento de chaves de TDE de um banco de dados específico?

A: Para verificar o status da área de armazenamento de chaves de TDE para um banco de dados específico, execute:

dbaascli tde status --dbname <DB_NAME>

P: Posso verificar o status da área de armazenamento de chaves para vários bancos de dados?

R: Sim, mas você precisa executar o comando separadamente para cada banco de dados, especificando seu nome usando o parâmetro --dbname.

P: O comando dbaascli tde status pode ser executado como usuário raiz?

R: Não, o comando deve ser executado como o usuário oracle, não como o usuário root.

P: Preciso de permissões especiais para executar o comando dbaascli tde status?

R: Sim, você precisa ter privilégios de usuário oracle e estar conectado a uma máquina virtual do Exadata Cloud@Customer para executar o comando.

P: O que devo fazer se obtiver um erro ao executar o comando de status dbaascli tde?

R: Certifique-se de que esteja executando o comando como o usuário oracle e verifique se você tem as permissões necessárias e se está conectado à máquina virtual correta.

P: Como sei que tipo de armazenamento de chaves meu banco de dados está usando?

R: O tipo de armazenamento de chaves, como se fosse baseado em arquivo ou HSM/KMS, é exibido na saída do comando dbaascli tde status.

P: O que devo fazer se a área de armazenamento de chaves estiver fechada?

R: Se a área de armazenamento de chaves estiver fechada, talvez seja necessário abri-la manualmente, dependendo da operação que você está tentando executar. O processo exato dependerá do tipo de armazenamento de chaves e do seu ambiente.

P: Posso exibir o status da área de armazenamento de chaves de um CDB (Banco de Dados Contêiner) ou PDB (Banco de Dados Plugável)?

R: Sim, especificando o nome do banco de dados apropriado usando o parâmetro --dbname, você pode exibir o status do armazenamento de chaves para CDBs e PDBs.

P: O que significa se o comando retornar um erro sobre a conectividade do banco de dados?

R: Isso pode indicar um problema com a conexão com o banco de dados ou um problema com seu ambiente. Certifique-se de que o banco de dados esteja em execução e acessível e verifique sua conexão SSH com a máquina virtual do Exadata Cloud@Customer.

P: O que acontece se o nome do banco de dados estiver incorreto?

R: Se o parâmetro --dbname especificar um banco de dados incorreto ou não existente, o comando falhará e você receberá uma mensagem de erro indicando o problema.

P: Como solucionar problemas se o status da área de armazenamento de chaves indicar um estado inesperado?

R: Se o status da área de armazenamento de chaves indicar um estado inesperado, revise os logs do banco de dados para obter mais detalhes e verifique a configuração da área de armazenamento de chaves para garantir que ela esteja configurada corretamente.

P: Posso automatizar a verificação do status da área de armazenamento de chaves para fins de monitoramento?

R: Sim, você pode criar script do comando dbaascli tde status para verificar o status do armazenamento de chaves periodicamente ou integrá-lo às suas ferramentas de monitoramento de banco de dados.

P: Como verifico se a Criptografia Transparente de Dados (TDE) está ativada corretamente?

R: Você pode verificar se a TDE está ativada corretamente verificando o status do armazenamento de chaves usando o comando dbaascli tde status. Uma área de armazenamento de chaves válida e aberta indica que a TDE está configurada corretamente.

Exemplo 6-61 dbaascli tde status

dbaascli tde status --dbname dbname