Documentação do Oracle Cloud Infrastructure

Usando o Utilitário dbaascli no Exadata Cloud Infrastructure

Aprenda a usar o utilitário dbaascli no Exadata Cloud Infrastructure.

Tópico principal: Guias de Referência do Exadata Cloud Infrastructure

Sobre o Uso do Utilitário dbaascli no Exadata Cloud Infrastructure

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 Exadata Cloud Infrastructure, como alteração da senha de um usuário do banco de dados, inicialização de um banco de dados, gerenciamento de 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 Exadata Cloud Infrastructure. Para obter instruções detalhadas, consulte Conexão com uma Instância do Exadata Cloud 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

Tópico principal: Usando o Utilitário dbaascli no Exadata Cloud Infrastructure

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.

Tópicos Relacionados

Tópico principal: Criando Bancos de Dados com o dbaascli

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 do Exadata Cloud 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 do Exadata Cloud Infrastructure

  1. Faça log-on na máquina virtual do Exadata Cloud 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 de um Banco de Dados do Exadata Cloud Infrastructure

  1. Faça log-on na máquina virtual do Exadata Cloud Infrastructure como opc.
  2. Execute o seguinte comando:
    sudo dbaascli tde changepassword --dbname database_name

Gerenciando Imagens de Software do Exadata Cloud 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 Exadata Cloud Infrastructure, que pode ser usada 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 Exadata Cloud 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 Exadata Cloud 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.

Tópico principal: Usando o Utilitário dbaascli no Exadata Cloud Infrastructure

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 Exadata Cloud Infrastructure usando o subcomando cswlib download do utilitário dbaascli.

  1. Conecte-se a um nó de computação como o usuário opc. Para obter instruções detalhadas, consulte Conexão com uma Máquina Virtual usando SSH.
  2. Inicie um shell de comando do usuário raiz:
    $ 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 submetidas a download no seu ambiente do Exadata Cloud Infrastructure.

    Os parâmetros opcionais são:

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

Aplicando Patch no Oracle Grid Infrastructure e em Bancos de Dados Oracle com o Utilitário dbaascli

Aprenda a usar o utilitário dbaascli para executar operações de aplicação de patches para o Oracle Grid Infrastructure e o Oracle Database em um sistema Exadata Cloud Infrastructure.

Tópico principal: Usando o Utilitário dbaascli no Exadata Cloud Infrastructure

Aplicando Patch em Bancos de Dados com o utilitário dbaascli

Com o utilitário o dbaascli, você pode optar por aplicar patch em um banco de dados, aplicando patch no Oracle home ou movendo o banco de dados para um Oracle home com o nível de patch desejado.

  • Aplicando patch em um Oracle home (aplicação de patch no local). Isso atualiza todos os bancos de dados localizados no Oracle home.
  • Movendo um banco de dados para outro Oracle home que tenha a versão desejada do software Oracle Database (aplicação de patch fora do local).

Tópico principal: Aplicando Patch no Oracle Grid Infrastructure e nos Bancos de Dados Oracle com o Utilitário dbaascli

Aplicando Patch em um Home de Banco de Dados (Aplicação de Patch de Banco de Dados no Local)

Para aplicar patch em um Oracle home, use o comando dbaascli dbHome patch.

Isso aplicará patch em todos os bancos de dados em execução no home especificado e os bancos de dados permanecerão no home após a conclusão da aplicação de patch. O seguinte se aplica ao uso do comando dbHome patch para operações de aplicação de patch no local:
  • Você pode aplicar patch em todos os nós de banco de dados ou em um subconjunto de nós.
  • A aplicação de patches de vários nós ocorre de maneira incremental.
  • Se preferir, você poderá executar uma operação de patch somente para software. Assim, quando estiver pronto, poderá executar datapatch para executar ações SQL pós-patch.
  • Você pode aplicar patch em um Oracle home contendo um ou mais bancos de dados.

Para aplicar patch em um Oracle Home (dbhome):

  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 patch --oracleHome dbhome_path --targetVersion Oracle_Database_version
    Em que:
    • --oracleHome identifica o caminho do Oracle home a receber o patch.
    • --targetVersion especifica a versão do Oracle Database de destino a ser usada para aplicação de patch, especificada como cinco segmentos numéricos separados por pontos (por exemplo, 19.12.0.0.0).
    Por exemplo:
    dbaascli dbhome patch --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --targetVersion 19.9.0.0.0
  4. Saia do shell de comando do usuário root:
    exit

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

Movendo um Banco de Dados para Outro Oracle Home (Aplicação de Patch Fora do Local)

Para aplicar patch em um Banco de Dados Oracle movendo-o para um Oracle home que já esteja no nível de patch desejado, use o comando dbaascli database move.

Depois que a operação de movimentação do banco de dados é concluída, o banco de dados é executado usando a versão do software Oracle Database do Oracle Home de destino.

Para aplicar patch em um banco de dados movendo-o para outro Oracle Home:

  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 move --oracleHome path_to_target_oracle_home --dbname database_name
    Em que:
    • --oracleHome identifica o caminho do Oracle home de destino que usa a versão desejada do software Oracle Database. Observe que o Oracle home de destino deve existir no sistema antes de usar o comando database move.
    • --dbname especifica o nome do banco de dados que está sendo movido.
    Por exemplo:
    dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --dbname xyz
  4. Saia do shell de comando do usuário root:
    exit

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

Aplicando Patch no Oracle Grid Infrastructure

Para aplicar um patch no Oracle Grid Infrastructure, use o comando grid patch.

  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 grid patch --targetVersion target_software_version_number

    Em que --targetVersion identifica a versão do software de destino na qual o patch do Oracle Grid Infrastructure será aplicado.

    Por exemplo:
    dbaascli grid patch --targetVersion 19.11.0.0.0
  4. Saia do shell de comando do usuário root:
    exit

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

Aplicando Patch no Oracle GI (Grid Infrastructure) Usando a Imagem do Software do GI

Para aplicar patch ao Oracle GI (Grid Infrastructure) usando a imagem do software do GI, use esse procedimento.

O Oracle Grid Infrastructure também pode receber aplicação de patches primeiro criando uma imagem de software com patch e depois usando essa imagem para executar a operação de aplicação de patch. Isso oferece a vantagem de que uma imagem pode ser criada antecipadamente fora da janela de aplicação de patches. Ele também ajuda na resolução de conflitos, pois os conflitos entre os patches são destacados durante o processo de criação de imagem sem afetar a janela de aplicação de patches.

  1. Crie uma imagem de software com patch.
    dbaascli grid patch --targetVersion <target_software_version_number> --createImage
    Quando a criação da imagem de software com patch for concluída, a imagem poderá ser usada para executar a operação de aplicação de patch.
  2. Execute a operação de aplicação de patch.
    dbaascli grid patch --targetVersion <target_software_version_number> --imageLocation <location_of_patched_software_image>

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-3 dbaascli cswlib showImages

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

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

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

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

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

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

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

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

Executando uma Pré-verificação antes de Aplicar Patch em Bancos de Dados e no Grid Infrastructure

Você pode executar uma operação de verificação de pré-requisitos (também chamada de "pré-verificação") para os comandos deste tópico usando o indicador de pré-verificação aplicável.

A execução de pré-verificações permite que você execute apenas a parte de pré-verificação da operação de aplicação de patch sem executar a aplicação de patch real. A Oracle recomenda a execução de pré-verificações para descobrir problemas de software que possam impedir o sucesso da aplicação de patch.

Para executar pré-verificações de aplicação de patch, primeiro, estabeleça conexão com uma máquina virtual na sua instância do Exadata Cloud Infrastructure como o usuário root.

Pré-verificar Aplicação de Patch do Oracle Home (Aplicação de Patch no Local)

Use o flag --executePrereqs com o comando dbaascli dbhome patch.

  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 patch --oracleHome dbhome_path --targetVersion Oracle_Database_version --executePrereqs
    Em que:
    • --oracleHome identifica o caminho do Oracle home a ser pré-verificado.
    • --targetVersion especifica a versão do Oracle Database de destino que receberá patch, especificada como cinco segmentos numéricos separados por pontos (por exemplo, 19.12.0.0.0).
  4. Saia do shell de comando do usuário root:
    exit
Pré-verificar Aplicação de Patch de Movimentação do Banco de Dados (Aplicação de Patch Fora do Local)

Use o flag --executePrereqs com o comando dbaascli database move.

  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 move --oracleHome path_to_target_oracle_home --dbname database_name --executePrereqs
    Em que:
    • --oracleHome identifica o caminho do Oracle Home de destino que usa a versão desejada do software Oracle Database. Observe que o Oracle Home de destino deve existir no sistema antes de usar o comando database move.
    • --dbname especifica o nome do banco de dados que está sendo movido
  4. Saia do shell de comando do usuário root:
    exit
Pré-verificar Aplicação de Patch do Oracle Grid Infrastructure

Use o flag --executePrereqs com o comando dbaascli grid patch.

  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 grid patch --targetVersion target_software_version_number --executePrereqs

    Em que --targetVersion identifica a versão do software de destino para a qual o Oracle Grid Infrastructure receberá patches, especificada como cinco segmentos numéricos separados por pontos, por exemplo, 19.12.0.0.0

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

Retomando ou Fazendo Rollback de uma Operação de Aplicação de Patch

Você pode retomar ou reverter uma operação de aplicação de patch com falha. A reversão de um patch é conhecida como rollback.

Tópico principal: Aplicando Patch no Oracle Grid Infrastructure e nos Bancos de Dados Oracle com o Utilitário dbaascli

Retomando uma Operação de Aplicação de Patch

Para retomar uma operação de aplicação de patch, use o flag --resume com o comando de aplicação de patch original.

  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 comando de aplicação de patch original para retomar uma operação de aplicação de patch:
    Por exemplo:
    dbaascli dbhome patch --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --targetVersion 19.9.0.0.0 --resume
  4. Saia do shell de comando do usuário root:
    exit
Fazendo Rollback de uma Operação de Aplicação de Patch

Use o flag --rollback com o comando de aplicação de patch original para fazer rollback (reverter) de uma operação de aplicação de patch.

  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 comando de aplicação de patch original para fazer rollback (reverter) de uma operação de aplicação de patch:
    Por exemplo:
    dbaascli grid patch --targetVersion 19.11.0.0.0 --rollback
    Observação

    • As operações de Retomada e Rollback são suportadas para aplicação de patch do Oracle Home e do Oracle Grid Infrastructure e para operações de movimentação de banco de dados.
    • Ao retomar ou fazer rollback de uma operação de aplicação de patch, execute o comando de retomada ou rollback do mesmo nó que foi usado para executar o comando de aplicação de patch original e execute o comando original com a adição do flag --resume ou --rollback.
  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.

Tópicos Relacionados

Tópico principal: Usando o Utilitário dbaascli no Exadata Cloud Infrastructure

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 on Dedicated Infrastructure, execute este procedimento.

O conjunto de ferramentas específico da nuvem é usado nas VMs Convidadas do Exadata Cloud Infrastructure 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

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.

Duplicar um Banco de Dados Local

Usando dbaascli, você pode duplicar um banco de dados local na nuvem. Isso pode ser feito com o comando dbaascli database duplicate. Esse comando cria um novo banco de dados na nuvem, que é uma duplicata de um banco de dados local junto com seus dados. Enquanto esse processo está acontecendo, o banco de dados on-premises continua operacional. Você pode migrar seus aplicativos para o banco de dados duplicado na nuvem após a devida verificação.

Preparar para duplicação

O processo de migração inclui os seguintes pré-requisitos a serem atendidos.
  • Certifique-se de que haja uma configuração de caminho de rede para acessar um banco de dados on-premises do nó do OCI por meio da string EZConnect.
  • Se um banco de dados local estiver configurado com TDE, copie o arquivo da wallet de TDE (ewallet.p12 ) para o nó do OCI, no qual você decide executar o comando dbaascli.
  • Crie um Oracle home no nó do OCI, se necessário. A versão do Oracle home deve ser a mesma da origem ou de uma versão de RU mais alta.

Verificar os RPMs necessários

Esse processo requer uma versão de RPM dbaastools mínima de 23.3.2.0.0, mas a atualização para o RPM dbaastools mais recente é sempre recomendada.

  • Para verificar a versão instalada atualmente, execute:
    dbaascli --version
DBAAS CLI version 23.3.2.0.0
  • Para aplicar o RPM de ferramentas mais recente, como usuário root, execute:
    # dbaascli admin updateStack

Executar as verificações de pré-requisitos

Para executar as verificações de pré-requisito, 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> --executePrereqs

Duplicar o banco de dados

Duplique o banco de dados usando o seguinte comando:

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

Por exemplo:

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

Após a conclusão bem-sucedida desse comando, o banco de dados é duplicado para a Nuvem e está pronto para verificações de sanidade para uso do aplicativo. Depois que a verificação for concluída, as conexões do aplicativo poderão ser migradas para o banco de dados da Nuvem.

Consulte dbaascli database duplicate –help para obter opções de configuração adicionais.

Poucas considerações sobre migração

  • Se preferir alocar vários canais para o RMAN duplicado, você poderá fazer isso especificando o argumento --rmanParallelism.
  • O Exadata Cloud Service configura a memória do banco de dados como ASM (Automatic Shared Memory Management). Se seu banco de dados local estiver configurado com gerenciamento de memória diferente, certifique-se de ajustar os valores do parâmetro de memória adequadamente no lado do OCI, fornecendo valores para --sgaSizeInMB e --pgaSizeInMB.
  • Verifique se o banco de dados local não contém parâmetros de inicialização obsoletos ou inválidos.
  • Os parâmetros de inicialização do banco de dados relacionados ao armazenamento do banco de dados (local do arquivo de dados, local de redo, destino da área de recuperação, multiplexação do arquivo de controle) podem ser alterados usando o argumento --initParams.

    Por exemplo, para substituir o valor db_create_online_log_dest do banco de dados duplicado: --initParams db_create_online_log_dest_1=+DATAC1,db_create_online_log_dest_2=+RECOC1

Diagnosticando e solucionando problemas de duplicação de banco de dados

  • O arquivo de log da operação dbaascli pode ser encontrado em /var/opt/oracle/log/<dbname>/database/duplicate
  • Um dos jobs da duplicata é executar dbca. Seu arquivo de log pode ser encontrado em /u02/app/oracle/cfgtoollogs/dbca e /u02/app/oracle/cfgtoollogs/dbca/<dbuniquename>.

Se a operação falhar, você terá uma opção para retomar a operação fornecendo o argumento --resume para o mesmo comando. Como alternativa, limpe o banco de dados usando dbaascli database delete –dbname <dbname> –force e execute novamente o comando de duplicação do banco de dados.

Notas da Release

Verifique as alterações feitas em várias releases do dbaascli.

Tópico principal: Usando o Utilitário dbaascli no Exadata Cloud Infrastructure

Release 25.4.1.0.0 (251107)

  • Multicloud: AWS — Suporte para criação de banco de dados entre regiões a partir de backups irestore no Amazon S3 (Simple Storage Service).
  • Várias correções de bug e melhorias de estabilidade.

Tópico principal: Notas da Release

Release 25.3.1.0.0 (250826)

  • Inclui AHF 25.6.2
  • Inclui syslens 25.2.3.0
  • Inclui exacs-configs-release-master_25-3-1
  • O comando dbaascli dbhome patch agora inclui a opção skipDBForDatapatch.

    Finalidade: Permite que você especifique uma lista de bancos de dados nos quais a etapa de datapatch será ignorada durante a aplicação de patch no home do BD no local.

  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 25.2.1.0.0 (250522)

  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 25.1.2.0.0 (250325)

  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 25.1.1.0.0 (250107)

  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 24.4.1.0.0 (241104)

  • dbaascli database getDetails aprimorado para incluir detalhes de tde encryption. O comando dbaascli tde status agora está obsoleto.
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 24.3.2.0.0 (240828)

  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 24.3.1.0.0 (240711)

  • Migração de TDE de sqlnet.ora para wallet_root no upgrade do banco de dados para a release 19c
  • Patch de grade no local para usar aplicação de patch baseada em imagem como modo padrão
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 24.2.1.0.0 (240530)

  • Adicionado suporte para o Oracle AI Database 26ai.
  • Melhorias na área de backup e recuperação com o Zero Data Loss Autonomous Recovery Service (ZRCV) como destino de backup.
  • Várias correções de bug e melhorias de estabilidade.

Tópico principal: Notas da Release

Release 24.1.2.2.0.0 (240306)

  • Introduziu um novo fluxo de trabalho otimizado para operações do Data Guard
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 24.1.1.1.0.0 (231219)

  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 23.4.1.0.0 (2311102)

  • Backup e Recuperação: A janela de recuperação mínima de Backup foi alterada para 7 dias. Embora a automação de partes de backup obsoleta considere a janela de recuperação como 7 dias se descobrir qualquer valor menor que 7 do sistema.
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 23.3.2.0.0 (230921)

  • Operações do Banco de Dados Plugável
    • Adicionado suporte para definir o OCID da versão da chave personalizada (Bring Your Own Key - BYOK) do OCI Vault durante as operações de criação e clonagem. Para obter detalhes, consulte a ajuda dos respectivos comandos do PDB.
  • Aplicação de Patch do GI (Grid Infrastructure)
    • Melhorou o fluxo de trabalho de aplicação de patches para melhorar o tempo de aplicação de patches, especialmente em ambientes com alto número de bancos de dados.
    • É introduzida uma nova opção --patchInParallel que pode ser usada para executar a aplicação de patches em nós remotos em paralelo.
  • Patch do Banco de Dados
    • Opção fornecida para executar o datapatch em um nó específico do cluster.
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 23.3.1.0.0 (230712)

  • Novos comandos dbaascli
    • dbaascli gridHome create - Este comando pode ser usado para criar um home do Grid Infrastructure de uma versão suportada. Para obter detalhes, consulte dbaascli gridHome create --help.
    • dbaascli system getGridHomes - Este comando fornece detalhes sobre os homes disponíveis do Grid Infrastructure no sistema. Para obter detalhes, consulte dbaascli system getGridHomes --help.
    • dbaascli admin updateAHF - Esse comando pode ser usado para atualizar o AHF para uma versão certificada na nuvem especificada da versão do AHF. No entanto, é recomendável que as atualizações do AHF sejam tratadas implicitamente pela automação da nuvem. Para obter detalhes, consulte dbaascli admin updateAHF --help.
  • Operações do Banco de Dados Plugável
    • Melhorias na área do ciclo de vida do banco de dados plugável atualizável.
  • Backup e Recuperação de Bancos de Dados
    • Adicionado suporte para configurar backups em sites stand-by em caso de configurações do dataguard. A configuração de backups é específica do site do Data Guard, ou seja, a alteração de atribuições (por exemplo, com a operação de switchover do Data Guard) não afetará as operações de backup do banco de dados nos sites principal ou stand-by. Os backups, se configurados no site principal ou no site stand-by, continuarão independentemente da alteração de função.
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 23.2.1.0.0 (230503)

  • Melhorias relacionadas ao Ciclo de Vida do Banco de Dados
    • Introduziu dbaascli grid removeTCPSCert para remover certificados TCPS expirados. Para obter detalhes, consulte dbaascli grid removeTCPSCert --help.
    • Opção adicionada para excluir PDBs específicos durante a duplicação do banco de dados. Para obter detalhes, consulte o argumento skipPDBs em dbaascli database duplicate --help.
  • Backup e Recuperação de Bancos de Dados
    • Alterou o padrão de FILES_PER_SET para 64 para backups do OSS. Isso pode ser alterado com dbaascli database backup --configure. Para obter detalhes, consulte dbaascli database backup --help.
    • Os backups de log de arquivamento continuam no site stand-by após o switchover de atribuição nos ambientes do Data Guard.
    • Para backups que não são gerenciados pela Oracle, as programações para backups L0 e L1 não são criadas por padrão. Eles devem ser criados explicitamente usando o comando dbaascli database backup --configure.
  • sysLens

    Uma estrutura que coleta, analisa e relata dados de recursos do sistema para frotas ExaDB-D está incluída na versão 23.2.1.0.0 (235503). Para obter mais informações, consulte Gerenciar sysLens.

  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 23.1.2.0.0 (230305)

  • Melhorias relacionadas ao Ciclo de Vida do Banco de Dados
    • Opção adicionada para criar modelos de banco de dados (modelos de DBCA) para o armazenamento de objetos. Os modelos do DBCA podem ser usados subsequentemente para criar bancos de dados. Para obter detalhes, consulte dbaascli database createTemplate --help.
  • Operações do Banco de Dados Plugável
    • Introduzido o comando dbaascli pdb refresh para atualizar um banco de dados plugável que foi criado usando a opção de atualização manual. Para obter detalhes, consulte dbaascli pdb refresh --help.
    • Opção adicionada para converter o banco de dados plugável atualizável em um banco de dados plugável regular. Para obter detalhes, consulte dbaascli pdb open --help.
    • A criação de um banco de dados plugável atualizável agora requer que o usuário do banco de dados de origem existente crie um link de banco de dados para o banco de dados plugável de origem. Para obter detalhes, consulte o argumento dblinkUserName em dbaascli pdb remoteClone --help.
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 23.1.1.0.1 (230113)

  • Melhorias relacionadas ao Ciclo de Vida do Banco de Dados
    • Adicionado suporte para criar um banco de dados duplicado de um banco de dados de origem que usa o OCI Vault Services para gerenciamento de chaves de criptografia.
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 22.4.1.0.1 (221122)

  • Operações do Banco de Dados Plugável
    • Opção adicionada para não abrir o PDB no fim da realocação. Para obter detalhes, consulte o argumento skipOpenPDB em dbaascli pdb relocate --help. Após usar essa opção, a realocação de pdb pode ser concluída executando o comando com o uso do argumento completePDBRelocate.
    • Opção adicionada para limpar os metadados/serviços do PDB realocados no local de origem. Para obter detalhes, consulte o argumento cleanupRelocatedPDB em dbaascli pdb delete --help
  • Novos comandos dbaascli
    • dbaascli database createTemplate - Esse comando pode ser usado para criar modelos de banco de dados (modelos DBCA) que podem ser usados subsequentemente para criar bancos de dados. Os modelos de DBCA são amplamente usados para criar um banco de dados clone com o DBCA - uma ferramenta que é fornecida com o software de servidor do Oracle Database. Para obter detalhes, consulte dbaascli database createTemplate --help
    • Foi introduzido dbaascli tde rotateMasterKey para rotacionar a chave principal para criptografia de banco de dados. Para obter detalhes, consulte dbaascli tde rotateMasterKey --help. O comando dbaascli tde rotate masterkey agora está obsoleto.
  • Melhorias relacionadas ao Ciclo de Vida do Banco de Dados
    • Adicionado suporte ao uso de modelos de dbca nos workflows de criação de banco de dados. Para obter detalhes, consulte o argumento dbcaTemplateFilePath em dbaascli database create --help
    • Melhorado o desempenho para criação de banco de dados duplicado. Para obter detalhes sobre como criar banco de dados duplicado, consulte dbaascli database duplicate --help
    • Adicionado suporte para criar um banco de dados duplicado de um banco de dados de origem que não é criptografado por TDE.
  • Gerenciamento de TDE
    • Foi introduzido dbaascli tde rotateMasterKey para rotacionar a chave principal para criptografia de banco de dados. Para obter detalhes, consulte dbaascli tde rotateMasterKey --help. O comando dbaascli tde rotate masterkey agora está obsoleto.
    • Renovado o workflow para todas as operações de TDE. Para obter detalhes, consulte dbaascli tde --help
  • Aplicação de Patch do GI (Grid Infrastructure)
    • Adicionado suporte para permitir a execução paralela da operação de aplicação de patch nos nós. Essa opção precisa ser cuidadosamente testada, visto que resulta em uma disponibilidade reduzida do banco de dados.
  • Backup e Recuperação de Bancos de Dados
    • Renovado o workflow para criar banco de dados usando backups independentes
  • Inclui o AHF versão 22.2.4
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 22.3.1.1.0 (221003)

  • Novos comandos dbaascli
    • 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. Para obter detalhes, consulte dbaascli database getDetails --help.
  • Operações do Banco de Dados Plugável
    • Adicionado suporte para a criação de bancos de dados plugáveis como clone atualizável usando o argumento refreshablePDB. Para obter detalhes, consulte dbaascli pdb remoteClone --help
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 22.3.1.0.1 (220721)

  • Novos comandos do ciclo de vida do banco de dados
    • dbaascli database addInstance - Este comando pode ser usado para adicionar uma instância de banco de dados a um dos nós do cluster no qual o banco de dados ainda não está configurado. Para obter detalhes, consulte dbaascli database addInstance --help.
    • dbaascli database deleteInstance - Este comando pode ser usado para excluir uma instância do banco de dados de um dos nós do cluster no qual o banco de dados está configurado. Para obter detalhes, consulte dbaascli database deleteInstance --help.
    • dbaascli database duplicate - Este comando pode ser usado para criar um novo banco de dados com base em um banco de dados já existente dentro de um cluster ou entre clusters, desde que exista conexão de rede entre os clusters. Para obter detalhes, consulte dbaascli database duplicate --help.
  • Biblioteca de Software da Nuvem
    • Introduzido o comando dbaascli cswlib listLocal para listar imagens submetidas a download da biblioteca de software localmente no sistema. Para obter detalhes, consulte dbaascli cswlib listLocal --help O comando dbaascli dbimage list agora está obsoleto.
    • Introduzido o comando dbaascli cswlib deleteLocal para excluir imagens submetidas a download da biblioteca de software na nuvem. Para obter detalhes, consulte dbaascli cswlib deleteLocal --help O comando dbaascli dbImage purge agora está obsoleto.
  • O local do log do comando dbaascli admin updateStack foi alterado para seguir a convenção de outros comandos dbaascli. Os logs podem ser convenientemente encontrados no diretório /var/opt/oracle/log/admin/updateStack. O local anterior era /var/opt/oracle/log/tooling/Update.
  • A ajuda dbaascli agora considera a plataforma de nuvem, na medida em que ela lista a saída de ajuda para comandos aplicáveis ao ambiente de nuvem no qual está operando.
  • Adicionado o suporte para alteração da senha de TDE em ambientes dataguard. Para obter detalhes, consulte dbaascli tde changePassword --help. Esse suporte não está disponível no momento para a versão 11.2.0.4.
  • Foi incluído o AHF versão 22.1.5.
  • Reformulado o workflow para operação de upgrade do banco de dados.
  • Reformulado o workflow para operação de criação do home do banco de dados.
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 22.2.1.1.0 (220623)

  • Foi incluído o AHF versão 22.1.1
  • Corrigido um problema em que a atualização do rpm dbaastools no sistema pode ter resultado em indisponibilidade do banco de dados com o erro ORA-600
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 22.2.1.1.0 (220609)

  • Novos comandos do dbaascli:
    • dbaascli dbHome getDatabases - Este comando lista todos os bancos de dados em execução de um determinado Oracle home do banco de dados. A saída é retornada no formato JSON para facilitar a automação. Para obter detalhes, consulte dbaascli dbHome getDatabases --help.
    • dbaascli database getPDBs - Este comando lista todos os bancos de dados plugáveis de um determinado banco de dados contêiner. A saída é retornada no formato JSON para facilitar a automação. Para obter detalhes, consulte dbaascli database getPDBs --help.
    • dbaascli dbHome delete - Este comando exclui um determinado Oracle home do banco de dados. Para obter detalhes, consulte dbaascli dbHome delete --help.
    • dbaascli dataguard prepareStandbyBlob - Este comando gera um arquivo blob contendo vários arquivos que são necessários no site stand-by para um ambiente do Data Guard. Para obter detalhes, consulte dbaascli dataguard prepareStandbyBlob --help.
  • Aplicação de Patch no GI (Grid Infrastructure):
    • Novo workflow otimizado
    • Introduzida uma forma de criar a imagem do software GI (Grid Infrastructure) antes da aplicação de patch. Esta imagem do GI pode ser usada subsequentemente para executar a operação de aplicação de patch do GI. A vantagem dessa abordagem é que ela resulta em uma janela de aplicação de patch reduzida, pois a imagem já está preparada. A pilha do GI no nó não é desativada para criar a imagem. Para obter detalhes, consulte a opção createImage em dbaascli grid patch --help
    • Introduzida uma forma de fazer a aplicação de patches do Grid Infrastructure por meio do uso de imagem de software do GI especificada pelo usuário, criada usando a opção createImage do comando dbaascli grid patch. Para obter detalhes, consulte a opção imageLocation em dbaascli grid patch --help.
  • Alterar suporte a Senha no ambiente do Data Guard:
    • Adicionado suporte para alterar a senha em ambientes do Data Guard. Para obter detalhes, consulte dbaascli database changePassword --help e dbaascli dataguard prepareStandbyBlob --help
  • Configuração do Data Guard:
    • Adicionado suporte para atualizar Atributos de Automação do Data Guard (no arquivo /var/opt/oracle/dg/dg.conf). Para obter detalhes, consulte dbaascli dataguard --help.
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 22.2.1.0.1 (220423)

  • Novos comandos do dbaascli
    • Foi introduzido o dbaascli admin showLatestStackVersion para mostrar a versão mais recente do dbaastools disponível para que os clientes façam download e instalem. É possível executar a instalação do rpm dbaastools usando o comando dbaascli admin updateStack. Para obter detalhes, consulte a seção "Referência de Comando do dbaascli".
  • Biblioteca de Software da Nuvem
    • Foi descontinuado o suporte para ativação de BP (dbaascli cswlib activateBP), uma vez que os BPs (Patches do Bundle) agora são substituídos por RUs (“Release Updates”). A implantação em nuvem consome RUs na forma de imagens de software, identificadas com "Tags de Imagem". Portanto, é recomendável usar tags de imagem ao estabelecer interface com os comandos da Biblioteca de Software da Nuvem (cswlib). Para obter detalhes, consulte dbaasscli cswlib download –help.
    • Foi eliminada a necessidade de fazer download de imagens Não CDB para criar bancos de dados não CDB. Agora, os usuários podem criar o banco de dados não CDB usando imagens comuns. Para obter detalhes, consulte a opção createAsCDB em dbaascli database create -help.
  • Criação de Banco de Dados Não CDB
    • Foi aprimorado o workflow de criação de banco de dados para criar um banco de dados não CDB usando a imagem de software de banco de dados padrão. Para obter detalhes, consulte a opção createAsCDB em dbaascli database create -help.
  • Aplicação de Patch do Home do Banco de Dados
    • Novo workflow otimizado
  • Upgrade do Grid Infrastructure
    • Novo workflow otimizado
  • Operações do Banco de Dados Plugável (PDB)
    • A exclusão do PDB nos ambientes DataGuard requer confirmação explícita para indicar que as operações necessárias no site stand-by foram concluídas, passando pelo argumento adicional -allStandByPrepared. Para obter detalhes, consulte dbaascli pdb delete --help
  • É fornecida capacidade incremental para a operação de bounce do banco de dados. Para obter detalhes, consulte dbaascli database bounce –help.
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 22.1.1.2.0 (220405)

  • Adicionado suporte para o ExaDB-D X9M
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 22.1.1.1.0 (220317)

  • Novos comandos do dbaascli:
    • Foi introduzido dbaascli system getDBHomes para obter todos os Oracle homes de banco de dados no cluster. A saída é retornada no formato JSON para facilitar a automação.
    • Foi introduzido dbaascli dbhome getDetails para obter informações detalhadas sobre um Oracle home específico. A saída é retornada no formato JSON para facilitar a automação.
  • Biblioteca de Software da Nuvem (cswlib):
    • Foi descontinuado o suporte para o comando dbaascli cswlib list para operações de listagem de bibliotecas de software da nuvem. O novo comando é dbaascli cswlib showImages que lista as imagens com seu ImageTag. É recomendável usar Image tags para fazer download das imagens na biblioteca de software da nuvem. Para obter detalhes sobre downloads usando tags de imagem, consulte dbaascli cswlib download –help.
    • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 22.1.1.0.1 (220223)

  • Upgrade do Grid Infrastructure
    • Novo workflow otimizado
  • Backup e Recuperação de Bancos de Dados
    • Atualização interna para o repositório de metadados de backup
    • Foram introduzidas mensagens sobre descontinuação para comandos bkup_api, uma vez que agora eles são substituídos por comandos dbaascli. Para obter detalhes, consulte 'dbaascli database backup --help' e 'dbaascli database recovery -help'
  • Operações do Banco de Dados Plugável (PDB)
    • Agora há suporte para a operação de realocação do PDB. Para obter detalhes, consulte ‘dbaascli pdb relocate –help’.
    • Foi reformulado o workflow para converter de não CDB em PDB. Para obter detalhes, consulte ‘dbaascli database convertToPDB –help’.
  • Gerenciamento de Chaves de Criptografia
    • Os parâmetros de inicialização específicos da pulsação da Criptografia Transparente de Dados (TDE) são definidos com os valores recomendados da nuvem para bancos de dados com 'Chaves Gerenciadas pelo Cliente'.
  • Gerenciamento da Biblioteca de Software da Nuvem
    • Foi reformulado o download de artefatos da biblioteca de software por meio de imageTags. É recomendável usar imageTags para fazer download das imagens do banco de dados e do software de grade. Para obter detalhes, consulte ‘dbaascli cswlib showimages’ e ‘dbaascli cswlib download –help’
  • Foi incluído o AHF versão 21.4.2
  • Várias correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 21.4.1.1.0 (220209)

  • Foi incluído o AHF versão 21.4.1
  • Correções de bugs e melhorias de estabilidade

Tópico principal: Notas da Release

Release 21.4.1.1.0

  • Foi ativada a criptografia dos tablespaces no nível do sistema (SYSTEM, SYSAUX, UNDO e TEMP) para bancos de dados que serão criados com essa versão do dbaastools em diante. Esse recurso está ativado para o Oracle Database versão 19.6.0.0.0 e posterior.
  • Aplicação de Patch de Grade:
    • Foi adicionada a condição de pré-requisito para verificar se a propriedade de arquivo a seguir pertence ao usuário grid. 
      • <gi_home>/suptools/tfa/release/tfa_home/jlib/jdev-rt.jar
      • <gi_home>/suptools/tfa/release/tfa_home/jlib/jewt4.jar
  • Aplicação de Patch do Banco de Dados:
    • A operação database move simultânea não é permitida por padrão. Foi introduzida uma nova opção –allowParallelDBMove que pode ser usada para substituir o comportamento padrão das releases 12.2 e posteriores do Oracle Database.
    • Foram corrigidos os problemas relacionados à movimentação de bancos de dados stand-by no modo MOUNT.
  • Backup e Recuperação do Banco de Dados
    • Foram adicionadas novas opções de linha de comando para backup do banco de dados. Para obter mais detalhes, consulte a referência do comando dbaascli database backup.
    • Foram adicionadas novas opções de linha de comando para recuperação de banco de dados. Para obter mais detalhes, consulte a referência do comando dbaascli database recover.
    • O uso do bkup_api para operações de backup e recuperação será descontinuado no futuro.
    • Para estar alinhado com a prática recomendada pela Oracle de usar o privilégio administrativo de SYSBACKUP para operações de Backup e Recuperação, a automação da nuvem cria um usuário administrativo comum C##DBLCMUSER com a atribuição SYSBACKUP no nível do contêiner CDB$ROOT. Portanto, as operações de backup e recuperação são executadas com o usuário tendo o mínimo de privilégios necessários. As credenciais para esse usuário são geradas aleatoriamente e gerenciadas com segurança pela automação da nuvem. Se o usuário não for encontrado ou for LOCKED e EXPIRED, a automação da nuvem recriará ou desbloqueará esse usuário durante a operação de backup ou recuperação. Essa alteração na automação da nuvem é feita a partir do dbaastools versão 21.4.1.1.0.
  • Foi aprimorada a funcionalidade dbaascli resume para retomar qualquer sessão anterior especificando o argumento –sessionID <value> para o comando de retomada. O ID da sessão é compartilhado na saída dbaascli, bem como nos logs.
  • Foi aprimorada a saída dbaascli help para mostrar o uso do comando.
  • Foi descontinuado o uso do shell dbaascli (sessão interativa). Será totalmente removido o suporte para esse recurso após março de 2022. É recomendável executar comandos dbaascli completos no prompt de comando, conforme sugerido em todos os exemplos de documento.
  • Foi incluído o Autonomous Health Framework (AHF) versão 21.2.8.
  • Várias correções de bug e melhorias de estabilidade.

Tópico principal: Notas da Release

Release 21.3.1.2.0

  • Foi melhorado o cronograma das operações do dbaascli com lógica de sincronização de metadados aprimorada do Plano de Controle.
  • Foram aprimorados os logs do dbaascli para ter informações em milissegundos com o thread associado.
  • Foram introduzidas mais verificações de pré-requisitos na aplicação de patch do home do banco de dados e nas operações de movimentação de banco de dados para detectar possíveis cenários de falhas com sugestões para a ação corretiva.
  • As operações de aplicação de patch do banco de dados agora mantêm o estado dos bancos de dados igual ao que era antes da aplicação de patch. Para bancos de dados plugáveis, o estado salvo do pdb é respeitado.
  • Várias correções de bug e melhorias de estabilidade.

Tópico principal: Notas da Release

Release 21.3.1.1.0

  • Foi adicionado suporte para desbloquear a conta do usuário Administrador do PDB como parte da operação de criação do PDB, localClone ou remoteClone. Para obter detalhes, consulte a opção --lockPDBAdminAccount em dbaascli pdb create --help.
  • Foi corrigido um problema que atualiza o recurso de banco de dados registrado no Oracle Grid Infrastructure em ambientes existentes com o valor correto do nome do banco de dados.
  • Foram aprimoradas as operações de ciclo de vida do PDB.
  • Várias correções de bug e melhorias de estabilidade.

Tópico principal: Notas da Release

Release 21.3.1.0.1

  • Suporte para que os comandos dbaascli a seguir sejam executados como usuário oracle.
    • dbaascli pdb bounce
    • dbaascli pdb close
    • dbaascli pdb connectString
    • dbaascli pdb create
    • dbaascli pdb delete
    • dbaascli pdb getDetails
    • dbaascli pdb list
    • dbaascli pdb localClone
    • dbaascli pdb open
    • dbaascli pdb remoteClone
  • Foi reformulada a aplicação de patch do banco de dados fora do local. Para obter detalhes, consulte dbaascli database move –help.
  • Aprimoramentos relacionados a cronograma no workflow de aplicação de patch do Oracle Grid Infrastructure. Para obter detalhes, consulte dbaascli grid patch –help.
  • Foi descontinuado o suporte para exadbcpatchmulti / dbaascli patch para operações de aplicação de patch. Os comandos dbaascli dbhome patch e dbaascli grid patch são fornecidos para a operação de aplicação de patch para homes de banco de dados e para o Oracle Grid Infrastructure. Consulte a seção Aplicando Patch no Oracle Grid Infrastructure e no Oracle Database com o Utilitário dbaascli para obter detalhes. Consulte também a seção Referência de Comando do dbaascli.
  • Foi descontinuado o suporte para o comando de patch de ferramentas do dbaascli para trazer consistência nas convenções de comando do dbaascli. O novo comando é dbaascli admin updateStack. Para obter detalhes, consulte a seção Atualizando o Conjunto de Ferramentas da Nuvem com o utilitário dbaascli.
  • Capacidade de executar dbaascli no modo desconectado para operações de longa execução. A execução do comando dbaascli com --waitForCompletion false obtém um ID de job que pode ser consultado posteriormente para obter o status da operação, usando dbaascli job getStatus –jobid job_id. Isso é útil nas operações de longa execução nas quais os usuários podem querer obter o controle de volta imediatamente após a execução do comando. Nessa versão, essa opção está disponível apenas para o comando dbaascli database create. Mais comandos serão adicionados nas releases subsequentes para ter esse suporte. A saída da ajuda para esses comandos refletirá o suporte da opção --waitForCompletion.
  • Foi descontinuado o suporte para o shell dbaascli. É recomendável que os usuários executem os comandos dbaascli completos no prompt de comando conforme sugerido em todos os exemplos de documento. A execução apenas do dbaascli mostrará a saída de sua ajuda de uso em vez de entrar em um shell dbaascli.
  • Várias correções de bug e melhorias de estabilidade.

Tópico principal: Notas da Release

Release 21.2.1.x.x

  • Foi reprojetada a operação de aplicação de patch do Oracle Grid Infrastructure e adicionada a capacidade de retomada do ponto de falha, patch no subconjunto de nós, drenagem da instância e outros aprimoramentos. Para obter detalhes, consulte dbaascli grid patch --help. Consulte também a seção Aplicando Patch no Oracle Grid Infrastructure e no Oracle Database com o Utilitário dbaascli.
  • Foi descontinuado o suporte para exadbcpatchmulti / dbaascli patch para operações de aplicação de patch. Os comandos dbaascli dbhome patch e dbaascli grid patch são fornecidos para a operação de aplicação de patch para homes de banco de dados e para o Oracle Grid Infrastructure. Consulte a seção Aplicando Patch no Oracle Grid Infrastructure e no Oracle Database com o Utilitário dbaascli para obter detalhes. Consulte também a seção Referência de Comando do dbaascli.
  • Foi descontinuado o suporte para o comando dbaascli tools patch para trazer consistência nas convenções de comando. O novo comando é dbaascli admin updateStack.
  • Foram reprojetadas as APIs de gerenciamento de PDB para operações de criação, clonagem local e clonagem remota. Para obter detalhes, consulte dbaascli pdb --help.
  • Foi reprojetada a API de exclusão de banco de dados. Para obter detalhes, consulte dbaascli database delete --help.
  • Foi reformulada a criação de dbhome (suporte para imagem de software personalizada e operação de expansão). Para obter detalhes, consulte dbaascli dbhome create --help.
  • Suporte para criação de banco de dados no subconjunto de nós do cluster. Para obter detalhes, consulte dbaascli database create --help.
  • Capacidade de executar dbaascli no modo desconectado para operações de longa execução. A execução do comando dbaascli com --waitForCompletion false obtém um ID de job que pode ser consultado posteriormente para obter o status da operação, usando dbaascli job getStatus –jobid job_id. Isso é útil nas operações de longa execução nas quais os usuários podem querer obter o controle de volta imediatamente após a execução do comando. Nessa versão, essa opção está disponível apenas para o comando dbaascli database create. Mais comandos serão adicionados nas releases subsequentes para ter esse suporte. A saída da ajuda para esses comandos refletirá o suporte da opção --waitForCompletion.
  • Foi aprimorada a experiência de aplicação de patch do dbhome com a introdução de várias opções, como skipPDBs, continueWithDowntime etc. Para obter detalhes, consulte dbaascli dbhome patch --help.
  • Suporte para melhor coleta de diagnóstico. Para obter detalhes, consulte dbaascli diag collect --help.
  • Pequenas melhorias na área de automação de upgrade de banco de dados.
  • Várias correções de bug e melhorias de estabilidade.

Tópico principal: Notas da Release

Referência de Comando do dbaascli

Você deve usar 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 do 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 à estrutura de automação da nuvem. Os clientes que usam o DBCA em scripts hoje podem atualizar seus scripts existentes para chamar dbaascli em vez do DBCA. Se 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 MOS (My Oracle Support) para adicionar essa funcionalidade a dbaascli.

Para usar o utilitário dbaascli, você deve estar conectado a um nó de computação do Exadata Cloud Infrastructure. Consulte Conexão com uma Instância do Exadata Cloud Infrastructure para obter instruções.

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 updateAHF
    Para instalar ou atualizar o AHF (Autonomous Health Framework), use o comando dbaascli admin updateAHF.
  • dbaascli admin updateStack
    Para instalar ou atualizar um RPM dbaastools, use o comando dbaascli admin updateStack.
  • dbaascli cswlib deleteLocal
    Para excluir a imagem local, use o comando dbaascli cswlib deleteLocal.
  • dbaascli cswlib download
    Para fazer download das imagens de software disponíveis e disponibilizá-las no ambiente do Exadata Cloud Infrastructure, use o comando dbaascli cswlib download.
  • 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.
  • 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.
  • dbaascli database addInstance
    Para adicionar a instância do banco de dados no nó especificado, use o comando dbaascli database addInstance.
  • dbaascli database backup
    Para configurar o Oracle Database com um destino de armazenamento de backup, fazer backups de bancos de dados, consultar backups e excluir um backup, use o comando dbaascli database backup.
  • dbaascli database bounce
    Para fazer shutdown e reiniciar um banco de dados Exadata Cloud Infrastructure especificado, use o comando dbaascli database bounce.
  • dbaascli database changepassword
    Para alterar a senha de um usuário especificado do Oracle Database, 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.
  • dbaascli database convertToPDB
    Para converter em PDB o banco de dados não CDB especificado, use o comando dbaascli database convertToPDB.
  • dbaascli database create
    Para criar o Banco de Dados Oracle, use o comando dbaascli database create. Quando solicitado, digite as senhas sys e tde.
  • dbaascli database delete
    Para excluir um Banco de Dados Oracle, use o comando dbaascli database delete.
  • dbaascli database deleteInstance
    Para excluir a instância do banco de dados no nó especificado, use o comando dbaascli database deleteInstance.
  • dbaascli database duplicate
    Para criar um banco de dados com base em um banco de dados ativo, use o comando dbaascli database duplicate.
  • 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.
  • 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.
  • 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.
  • dbaascli database move
    Para mover o banco de dados de um home para outro, use o comando dbaascli database move.
  • dbaascli database recovery
    Para recuperar um banco de dados, use o comando dbaascli database recover.
  • dbaascli database runDatapatch
    Para aplicar patch em um Banco de Dados Oracle, use o comando dbaascli database runDatapatch.
  • dbaascli database createTemplate
    Use esse comando para criar modelos de banco de dados (modelos DBCA) que podem ser usados subsequentemente para criar bancos de dados.
  • dbaascli database start
    Para iniciar um Banco de Dados Oracle, use o comando dbaascli database start.
  • dbaascli database status
    Para verificar o status de um Banco de Dados Oracle, use o comando dbaascli database status.
  • dbaascli database stop
    Para interromper um Banco de Dados Oracle, use o comando dbaascli database stop.
  • dbaascli database upgrade
    Para fazer upgrade de um Banco de Dados Oracle, use o comando dbaascli database upgrade.
  • 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.
  • 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.
  • dbaascli dataguard failover
    Para executar um failover manual no banco de dados stand-by, use o comando dataguard failover.
  • dbaascli dataguard reinstate
    Para restabelecer um banco de dados com falha como banco de dados stand-by após um failover, use o comando dataguard reinstate.
  • dbaascli dataguard switchover
    Para executar um switchover para o banco de dados stand-by, use o comando dataguard switchover.
  • dbaascli dataguard prepareForStandby
    Para criar um Banco de Dados Oracle Stand-by, use o comando dbaascli dataguard prepareForStandby como primeira etapa.
  • dbaascli dataguard configureStandby
    Para criar um novo Banco de Dados Stand-by, use o comando dbaascli dataguard configureStandby como segunda etapa após a etapa prepareForStandby.
  • dbaascli dataguard registerStandby
    Para registrar um banco de dados stand-by recém-criado com todos os bancos de dados stand-by existentes e com o banco de dados principal, use o comando dbaascli dataguard registerStandby como terceira etapa após a etapa configureStandby.
  • dbaascli dataguard deregisterStandby
    Durante a exclusão do stand-by, execute o comando dbaascli dataguard deregisterStandby antes de excluir o banco de dados no cluster stand-by para cancelar o registro do banco de dados stand-by na configuração do Oracle Data Guard Broker.
  • dbaascli dataguard configureAWR
    Para ativar ou desativar a configuração do AWR (Automatic Workload Repository) no seu stand-by Active Data Guard, use o comando dbaascli dataguard configureAWR.
  • dbaascli dataguard updateConfiguration
    Para atualizar o modo de transporte ou o modo de proteção ou os dois parâmetros de um ambiente do Data Guard, use o comando dbaascli dataguard updateConfiguration.
  • dbaascli dbhome create
    Para criar um home do Banco de Dados Oracle da versão desejada, use o comando dbaascli dbhome create.
  • dbaascli dbHome delete
    Para excluir um determinado home do Oracle Database, use o comando dbaascli dbHome delete.
  • 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.
  • 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.
  • dbaascli dbHome patch
    Para aplicar patch no Oracle home de um nível de patch para outro, use o comando dbaascli dbHome patch.
  • dbaascli dbimage Purge
    O comando dbimage purge remove a imagem de software especificada do seu ambiente do Exadata Cloud Infrastructure.
  • dbaascli diag Collect
    Para coletar diagnóstico, use o comando dbaascli diag collect.
  • dbaascli diag healthCheck
    Para executar verificações de integridade de diagnóstico, use o comando dbaascli diag healthCheck.
  • dbaascli gridHome create
    Para configurar o home do Grid Infrastructure, use o comando dbaascli gridHome create.
  • dbaascli grid configureTCPS
    Para configurar o TCPS para o cluster existente, use o comando dbaascli grid configureTCPS.
  • dbaascli grid patch
    Para aplicar patch do Oracle Grid Infrastructure na versão secundária especificada, use o comando dbaascli grid patch.
  • dbaascli grid removeTCPSCert
    Para remover certificados TCPS existentes da wallet do Grid Infrastructure, use o comando dbaascli grid removeTCPSCert.
  • dbaascli grid rotateTCPSCert
    Para alternar certificados TCPS, use o comando dbaascli grid rotateTCPSCert.
  • dbaascli grid upgrade
    Para fazer upgrade do Oracle Grid Infrastrucure de uma versão principal para outra, use o comando dbaascli grid upgrade.
  • dbaascli job getStatus
    Para exibir o status de um job especificado, use o comando dbaascli job getStatus.
  • dbaascli patch db apply
  • dbaascli patch db prereq
  • dbaascli pdb backup
    Para fazer backup de um banco de dados plugável (PDB), consultar backups do PDB e excluir um backup do PDB, use o comando dbaascli pdb backup.
  • dbaascli pdb bounce
    Para devolver um banco de dados plugável (PDB), use o comando dbaascli pdb bounce.
  • dbaascli pdb close
    Para fechar um banco de dados plugável (PDB), use o comando dbaascli pdb close.
  • dbaascli pdb getConnectString
    Para exibir informações da string de conexão do Oracle Net para um PDB (banco de dados plugável), execute o comando dbaascli pdb getConnectString.
  • dbaascli pdb create
    Para criar um novo banco de dados plugável (PDB), use o comando dbaascli pdb create.
  • dbaascli pdb delete
    Para excluir um banco de dados plugável (PDB), execute o comando dbaascli pdb delete.
  • dbaascli pdb getDetails
    Para exibir detalhes de um banco de dados plugável (PDB), use o comando dbaascli pdb getDetails.
  • 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.
  • 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.
  • dbaascli pdb open
    Para abrir um banco de dados plugável (PDB), use o comando dbaascli pdb open.
  • dbaascli pdb recover
    Para recuperar um banco de dados plugável (PDB), use o comando dbaascli pdb recover.
  • dbaascli pdb refresh
    Para atualizar um banco de dados plugável (PDB) especificado, use o comando dbaascli pdb refresh.
  • 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.
  • 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.
  • dbaascli system getDBHomes
    Para exibir informações sobre todos os Oracle homes, use o comando dbaascli system getDBHomes.
  • dbaascli system getGridHomes
    Para listar os detalhes de todos os homes do Grid, use o comando dbaascli system getGridHomes.
  • 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.
  • dbaascli tde addSecondaryHsmKey
    Para adicionar uma chave HSM (KMS) secundária à configuração HSM (KMS) existente, use o comando dbaascli tde addSecondaryHsmKey.
  • dbaascli tde enableWalletRoot
    Para ativar o parâmetro spfile wallet_root para o banco de dados existente, use o comando dbaascli tde enableWalletRoot.
  • dbaascli tde encryptTablespacesInPDB
    Para criptografar todos os tablespaces no PDB especificado, use o comando dbaascli tde encryptTablespacesInPDB.
  • dbaascli TDE fileToHsm
    Para converter em HSM a TDE baseada em FILE (KMS/OKV), use o comando dbaascli TDE fileToHsm.
  • dbaascli tde getHsmKeys
    Para obter detalhes da chave ativa de TDE, use o comando dbaascli tde getHsmKeys.
  • 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.
  • dbaascli tde getPrimaryHsmKey
    Para obter a chave HSM (KMS) primária da configuração HSM (KMS) existente, use o comando dbaascli tde getPrimaryHsmKey.
  • dbaascli tde hsmToFile
    Para converter TDE baseada em HSM (KMS/OKV) em TDE baseada em FILE, use o comando dbaascli tde hsmToFile.
  • dbaascli tde listKeys
    Para listar chaves principais de TDE, use o comando dbaascli tde listKeys.
  • dbaascli tde removeSecondaryHsmKey
    Para remover a chave HSM (KMS) secundária da configuração HSM (KMS) existente, use o comando dbaascli tde removeSecondaryHsmKey.
  • dbaascli tde rotateMasterKey
    Rotacione a chave principal para criptografia de banco de dados.
  • 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.
  • dbaascli tde setPrimaryHsmKey
    Para alterar a chave HSM (KMS) primária para a configuração HSM (KMS) existente, use o comando dbaascli tde setPrimaryHsmKey.
  • dbaascli tde status
    Para exibir informações sobre o armazenamento de chaves do banco de dados especificado, use o comando dbaascli tde status.

Tópico principal: Usando o Utilitário dbaascli no Exadata Cloud Infrastructure

dbaascli admin updateAHF

Para instalar ou atualizar o AHF (Autonomous Health Framework), use o comando dbaascli admin updateAHF.

Pré-requisitos

Execute o comando como usuário root.

Sintaxe

dbaascli admin updateAHF
 {
   --targetVersion value | --imageTag value
}
[--resume [--sessionID value]] [--executePrereqs]
Em que:
  • --targetVersion especifica a versão de destino para a qual atualizar o AHF
  • --imageTag especifica a tag de imagem do artefato AHF a ser instalado
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --executePrereqs executa verificações de pré-requisitos e relata os resultados

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, você deve estabelecer conexão com uma máquina virtual do Exadata Cloud 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

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

Exemplo 6-4 dbaascli cswlib deletelocal

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

dbaascli cswlib download

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

Pré-requisitos

Execute o comando como usuário root.

Para usar o utilitário, você deve estabelecer conexão com uma máquina virtual do Exadata Cloud 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

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

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

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

Exemplo 6-7 dbaascli cswlib listlocal

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

dbaascli cswlib showImages

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.

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

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 especifica o nome do Oracle Database
  • --list retorna informações de backup do banco de dados

    [--backupType | --json]

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

    [--json especifica o Nome do arquivo da saída JSON ]

  • --start inicia o backup do banco de dados

    [--level0 cria um backup de Nível 0 (completo)]

    [--level1 cria um backup de Nível 1 (incremental) ]

    [--archival | --archivelog]

    [--archival cria um backup completo de arquivamento]

    --tag especifica a tag de backup

    [--archivelog ]

  • --delete exclui backup de Arquivamento

    --backupTag especifica a tag de backup a ser excluída

  • --status exibe os detalhes sobre um processo de job de backup

    Identificador exclusivo --uuid da operação de backup. Formato de entrada: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

    [--json especifica o Nome do arquivo da saída JSON]

  • --getBackupReport retorna BackupReport

    --tag | --latest

    --tag especifica a tag de backup

    --latest retorna o relatório de backup mais recente (todos os tipos de backup de banco de dados)

    --json especifica o nome do arquivo para saída JSON

  • --configure configura o banco de dados para backup

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

    --configFile especifica o arquivo de configuração de backup do banco de dados

    --enableRTRT ativa o Transporte de Redo em Tempo Real

    --disableRTRT desativa o Transporte de Redo em Tempo Real

    --disableCatalog desativa o catálogo de recuperação

    --deleteImmutableConfiguration exclui a configuração imutável

  • --getConfig retorna a configuração de backup do banco de dados

    [--configFile | --showOldParams]

    [--configFile especifica o arquivo de configuração de backup do banco de dados]

    [--showOldParams retorna nomes de parâmetros antigos da configuração de backup.]

  • --validate confirma se os backups foram concluídos e estão livres de corrupção

    [--untilTime valida do backup de Nível 0 (completo) mais próximo até o tempo fornecido. Formato de entrada: DD-MON-YYYY HH24:MI:SS]

  • --showHistory exibe o histórico das operações de backup

    [--all exibe todas as operações de backup]

  • --getSchedules retorna todas as programações de backup de um determinado banco de dados
Observação

Os parâmetros enableRTRT e disableRTRT só se aplicam ao destino de backup ZDLRA do Exadata Database Service on Cloud@Customer.

dbaascli database bounce

Para fazer shutdown e reiniciar um banco de dados Exadata Cloud 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.

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

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 especifique true ou false para criar o banco de dados como CDB ou Não CDB
  • --pdbName especifique 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 para retomar ou reverter 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 especifique true ou false para bloquear a conta do usuário administrador do PDB. O valor default é verdadeiro
  • --dbcaTemplateFilePath especifique 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

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.

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

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...

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.

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

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>| --resetParameters <values> | --responseFile
[--backupPrepared]
[--instance]
[--allowBounce]
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.
  • --responseFile especifica o local absoluto do arquivo JSON de resposta para modificar os parâmetros do banco de dados
  • --backupPrepared confirma que há um backup adequado do banco de dados antes de modificar parâmetros críticos ou confidenciais.
  • --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.
  • --allowBounce concede permissão para devolver o banco de dados a fim de refletir as alterações nos parâmetros estáticos aplicáveis.

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>
        {
            [--resume [--sessionID <value>]]
            | [--rollback [--sessionID <value>]]
        }
[--executePrereqs]
[--nonRolling]
[--skipDatapatch]
[--skipPDBs <value>]
[--skipClosedPDBs]
[--continueWithDbDowntime]
[--drainTimeoutInSeconds <value>]
[--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
  • --nonRolling move o banco de dados em todos os nós em paralelo.

    Observe que isso causaria tempo de inatividade do banco de dados.

  • --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.

  • --drainTimeoutInSeconds especifica o tempo (em segundos) para concluir a descarga de recursos enquanto o banco de dados é interrompido
  • --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

Exemplo 6-18 dbaascli database move

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

dbaascli database recover

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>

Exemplo 6-19 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 
dbaascli database runDatapatch --dbname db19

dbaascli database createTemplate

Use esse comando para criar modelos de banco de dados (modelos de DBCA) que podem ser usados subsequentemente para criar bancos de dados.

Execute o comando como usuário root ou oracle.

Sintaxe

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

dbaascli database createTemplate --dbname <value>
 {
   --templateLocation <value> | --uploadToObjectStorage --objectStorageLoginUser <value> --objectStorageBucketName <value> [--objectStorageUrl <value>]
 }
 [--templateName <value>] [--rmanParallelism <value>]
Em que:
  • --dbname especifica o nome do banco de dados
  • --templateLocation especifica o nome do modelo
  • --uploadToObjectStorage: especifica o upload do modelo para o serviço Object Storage
    • --objectStorageLoginUser: especifica o usuário do log-in do serviço Object Storage
    • --objectStorageBucketName: especifica o nome do bucket do serviço Object Storage
    • --objectStorageUrl: especifica o URL do serviço Object Storage
  • --templateName: 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.

Exemplo 6-20 dbaascli database start

dbaascli database start --dbname dbname --mode mount

dbaascli database 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-21 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.

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

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

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.

dbaascli dataguard failover

Para executar um failover manual no banco de dados stand-by, use o comando dataguard failover.

Execute este comando como o usuário oracle no banco de dados stand-by de destino.

Sintaxe

dbaascli dataguard failover --dbname <value> [--useImmediateFailover] [--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Em que:
  • --dbname especifica o nome do Oracle Database.
  • --useImmediateFailover usa esse flag quando a configuração do Oracle Data Guard está em um estado de advertência ou erro.
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados.
  • --waitForCompletion especifica se deve aguardar a conclusão da operação. Defina como false para executar a operação no segundo plano. Valores válidos: true|false.
  • --resume retoma a operação anterior.
  • --sessionID retoma uma sessão específica por seu ID.

Tópico principal: Referência de Comando do dbaascli

Executando uma Operação de Failover Manual com o Utilitário dbaascli

Para executar um failover manual no banco de dados stand-by, use o comando dataguard failover.

  1. Estabeleça conexão com a máquina virtual na configuração do Oracle Data Guard que hospedará o novo banco de dados principal como o 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 raiz e alterne para o usuário oracle:
    $ sudo -s
# su - oracle
$
  3. Inicie o failover para o Banco de Dados stand-by.
    $ dbaascli dataguard failover --dbname <db-name>
  4. Retorne para ser o usuário root.
    $ exit
#
  5. Desconecte-se da máquina virtual e saia do shell do comando root-user.
    # exit
$ exit

Tópico principal: dbaascli dataguard failover

dbaascli dataguard reintegrado

Para restabelecer um banco de dados com falha como banco de dados stand-by após um failover, use o comando dataguard reinstate.

Execute esse comando como o usuário oracle no qual a reintegração é necessária (que é o banco de dados stand-by com falha).

Sintaxe

dbaascli dataguard reinstate --dbname <value> [--primaryDBUniqueName <value>] [--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Em que:
  • --dbname especifica o nome do Oracle Database.
  • --primaryDBUniqueName especifica o nome exclusivo do banco de dados principal atual na configuração do Oracle Data Guard.
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados.
  • --waitForCompletion especifica se deseja aguardar a conclusão da operação. Defina como false para executar a operação no segundo plano. Valores válidos: true|false.
  • --resume retoma a operação anterior.
  • --sessionID retoma uma sessão específica por seu ID.

Para determinar quando um membro deve ser reintegrado em uma configuração do Data Guard (DG):

Monitore a saída dgmgrl show database para os seguintes erros ORA:

  • No novo cluster principal:

    ORA-16661: O banco de dados stand-by deve ser reintegrado

  • No cluster principal antigo:

    ORA-16623: Alteração de atribuição detectada pelo membro

Essas mensagens indicam que ocorreu um failover. Para restaurar a sincronização completa na configuração do Data Guard, o principal anterior deve ser restabelecido.

Tópico principal: Referência de Comando do dbaascli

Reintegrando um Banco de Dados Principal com Falha Usando o Utilitário dbaascli

Para restabelecer um banco de dados principal com falha após um failover, use o comando dataguard reinstate.

  1. Estabeleça conexão com uma das máquinas virtuais na configuração do Oracle Data Guard como o usuário oracle.

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

  2. Inicie a reintegração do banco de dados principal com falha.
    $ dbaascli dataguard reinstate --dbname <db-name>

    Em uma configuração stand-by múltipla (grupo do Data Guard), é recomendável especificar o argumento --primaryDBUniqueName. 

    dbaascli dataguard reinstate --dbname <db-name> --primaryDBUniqueName <primary-DB-unique-name>
  3. Desconecte da máquina virtual.
    $ exit

Tópico principal: dbaascli dataguard reinstate

dbaascli dataguard switchover

Para executar um switchover para o banco de dados stand-by, use o comando dataguard switchover.

Execute este comando como o usuário oracle.

Sintaxe

dbaascli dataguard switchover --dbname <value> [--targetStandbyDBUniqueName <value>] [--executePrereqs] [--enableDGDebug] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Em que:
  • --dbname especifica o nome do Oracle Database.
  • --targetStandbyDBUniqueName especifica o nome exclusivo para o banco de Dados stand-by a fim de alterar a atribuição de stand-by para principal.
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados.
  • --enableDGDebug ativa os rastreamentos durante a execução da operação.
  • --waitForCompletion especifica se deseja aguardar a conclusão da operação. Defina como false para executar a operação no segundo plano. Valores válidos: true|false.
  • --resume retoma a operação anterior.
  • --sessionID retoma uma sessão específica por seu ID.

Tópico principal: Referência de Comando do dbaascli

Executando uma Operação de Switchover com o Utilitário dbaascli

Para executar um switchover para o banco de dados stand-by, use o comando dataguard switchover.

  1. Estabeleça conexão com a máquina virtual na configuração do Oracle Data Guard que hospedará o novo banco de dados principal como o 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 raiz e alterne para o usuário oracle.
    $ sudo -s
# su - oracle
$
  3. Inicie o switchover para o Banco de Dados stand-by.
    $ dbaascli dataguard switchover --dbname <db-name>

    Em uma configuração stand-by múltipla (grupo do Data Guard), é recomendável especificar o argumento --targetStandbyDBUniqueName. 

    dbaascli dataguard switchover --dbname <db-name> --targetStandbyDBUniqueName <target-standby-DB-unique-name>
  4. Retorne para ser o usuário root.
    $ exit
#
  5. Saia do shell do comando root-user e desconecte-se da máquina virtual.
    # exit
$ exit

Tópico principal: dbaascli dataguard switchover

dbaascli dataguard prepareForStandby

Para criar um Banco de Dados Oracle Standby, use o comando dbaascli dataguard prepareForStandby como a primeira etapa.

Execute este comando como o usuário root no banco de dados principal. No final da execução do comando, um arquivo BLOB stand-by é criado. Copie esse arquivo para o sistema de banco de dados stand-by para prosseguir com a etapa configureStandby.

Observação

Para configurações de DR (Recuperação de Desastre) no Exadata Cloud@Customer (ExaDB-C@C), use a Console do OCI (Oracle Cloud Infrastructure) ou o SDK do OCI para configurar o Data Guard. O utilitário dbaascli não é suportado para este caso de uso e não deve ser usado.

Sintaxe

dbaascli dataguard prepareForStandby --dbname <value> --standbyDBUniqueName <value>  --standbyDBDomain | --noDBDomain  --standbyScanIPAddresses <Standby SCAN IP Addresses> [ --standbyScanPort ] [ --standbyServiceName ] [  -- primaryScanIPAddresses ] [ --primaryScanPort ] [--executePrereqs] [--resume [--sessionID <value>]] [--revert [--sessionID <value>]] [--waitForCompletion] [--skipDRConfiguration]
Em que:
  • --dbname especifica o nome do Oracle Database.
  • --standbyDBUniqueName especifica o nome exclusivo para o banco de dados stand-by cujo banco de dados principal será configurado.
  • --standbyDBDomain especifica o domínio de banco de dados stand-by para o qual o banco de dados principal será configurado.
  • --noDBDomain especifica não usar o nome do domínio do banco de dados para o banco de dados stand-by.
  • --standbyScanIPAddresses especifica uma lista delimitada por vírgulas de endereços IP correspondentes ao listener SCAN do banco e dados stand-by ou o nome do SCAN do banco e dados stand-by.
  • --standbyScanPort especifica o número de porta SCAN correspondente do banco do dados stand-by.
  • --standbyServiceName especifica o nome do sistema stand-by para o qual o banco principal será configurado.
  • --primaryScanIPAddresses especifica uma lista delimitada por vírgulas de endereços IP correspondentes ao listener SCAN do banco principal ou o nome do SCAN do banco principal.
  • --primaryScanPort especifica o número de porta de SCAN correspondente do banco de dados principal.
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados.
  • --resume retoma a operação anterior.
  • --sessionID retoma uma sessão específica por seu ID.
  • --revert faz rollback da operação anterior.
  • --waitForCompletion especifica se deseja aguardar a conclusão da operação. Defina como false para executar a operação no segundo plano. Valores válidos: true|false.
  • --skipDRConfiguration especifica se a configuração de DR (Recuperação de Desastre) deve ser ignorada como parte da configuração do banco de dados stand-by. Valores válidos: true (ignorar configuração de DR) ou false (configurar DR).

Tópico principal: Referência de Comando do dbaascli

Executando a Operação PrepareForStandby com o Utilitário dbaascli

Para preparar o banco de dados principal para criar um novo banco de dados stand-by, use o comando dbaascli dataguard prepareForStandby.

  1. Estabeleça conexão com a Máquina Virtual na qual você deseja hospedar o banco de dados principal como o 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 raiz.
    $ sudo -s
  3. Execute o comando prepareForStandby. Informe a senha SYS quando solicitado.
    dbaascli dataguard prepareForStandby --dbName <db name> --standbyDBUniqueName <standby db unique name> --standbyDBDomain <standby db domain> --standbyScanIPAddresses  <comma-delimieted list of standby SCAN IP addresses> --primaryScanIPAddresses <comma-delimited list of primary SCAN IP addresses> --standbyScanPort <standby SCAN listener port>

    Após a conclusão, o comando exibe o local onde o arquivo BLOB stand-by é criado.

  4. Desconecte-se da máquina virtual e saia do shell do comando root-user.
    #  exit

dbaascli dataguard configureStandby

Para criar um novo Banco de Dados Stand-by, use o comando dbaascli dataguard configureStandby como segunda etapa após a etapa prepareForStandby.

Execute isso como o usuário root no cluster stand-by.

Sintaxe

dbaascli dataguard configureStandby --dbname <value>  --oracleHome <value> | --oracleHomeName <value> --standbyDBUniqueName <value> [--standbyDBDomain <value>] | [--noDBDomain] --primaryScanIPAddresses <value> --primaryScanPort <value> --primaryServiceName <value> --protectionMode <value> --transportType <value> --activeDG <value> [--standbyBlobFromPrimary <value>] | [--standbyDBInfoJsonLocation <value>] [--standbyScanIPAddresses <value>] [--standbyScanPort <value>] [--standbySID <value>] [--nodeList <value>] [--skipAWRConfiguration] [--primaryDBOCID <value>] [--sgaSizeInMB <value>] [--pgaSizeInMB <value>] [--datafileDestination <value>] [--fraDestination <value>] [--redoLogDestination <value>] [--fraSizeInMB <value>] [--tdeKeyStoreType <value> [--tdeKeyOCID <value>]] [--tdeKeyOCID <value>] [--executePrereqs]  [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]] --waitForCompletion <value>] [--enableFIPS <value>] [--skipDRConfiguration] [--okvServer <value> --okvAdminUserName <value> [--okvServerRestPort <value>]] [--okvWalletName <value>]
Em que:
  • --dbname especifica o nome do Oracle Database.
  • --oracleHome especifica o caminho de Oracle home.
  • --oracleHomeName especifica o nome do Oracle home.
  • --standbyDBUniqueName especifica o nome exclusivo do banco de dados stand-by.
  • --standbyDBDomain especifica o domínio de banco de dados stand-by para o qual o banco de dados principal será configurado.
  • --noDBDomain especifica não usar o nome do domínio do banco de dados para o banco de dados stand-by.
  • --primaryScanIPAddresses especifica uma lista delimitada por vírgulas de endereços IP correspondentes ao listener SCAN do banco principal ou o nome do SCAN do banco principal.
  • --primaryScanPort especifica o número de porta do SCAN correspondente do serviço de banco de dados principal.
  • --primaryServiceName especifica o nome do principal serviço de banco do dados para o qual o banco do dados stand-by será configurado.
  • --protectionMode especifica o modo do Data Guard a ser definido ao configurar o banco de dados stand-by. Valores válidos: MAX_PERFORMANCE|MAX_AVAILABILITY.
  • --transportType especifica o tipo do transporte Data Guard a ser definido ao configurar o banco de dados stand-by. Valores válidos: ASYNC|SYNC.
  • --activeDG especifica se a configuração da Data Guard estará ativa ou não. Valores válidos: true|false.
  • --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.
  • --standbyDBInfoJsonLocation especifica a localização do arquivo de informações gerado do banco de dados principal para exportar metadados adicionais. Esta opção é obrigatória apenas para operações stand-by.
  • --standbyScanIPAddresses especifica uma lista delimitada por vírgulas de endereços IP correspondentes ao listener SCAN do banco e dados stand-by ou o nome do SCAN do banco e dados stand-by.
  • --standbyScanPort especifica o número de porta SCAN correspondente do banco do dados stand-by.
  • --standbySID especifica o SID do banco de dados stand-by para configuração stand-by.
  • --nodeList especifica uma lista de nós em que o banco de dados stand-by deve ser executado, incluindo nós que já estão em execução ou configurados.
  • --skipAWRConfiguration especifica se a configuração do Oracle AWR deve ser ignorada como parte da configuração do banco de dados stand-by. Valores válidos: true (ignorar configuração do AWR) ou false (configurar AWR).
  • --primaryDBOCID especifica o valor do OCID do recurso correspondente ao banco de dados principal.
  • --sgaSizeInMB especifica o valor sga_target em MB.
  • --pgaSizeInMB especifica o valor pga_aggregate_target no MB.
  • --datafileDestination especifica o local de armazenamento a ser usado para arquivos de dados do banco de dados.
  • --fraDestination especifica o local de armazenamento a ser usado para a área de recuperação rápida do banco de dados.
  • --redoLogDestination especifica o local de armazenamento a ser usado para os arquivos de redo log.
  • --fraSizeInMB especifica o valor de tamanho de área em MB para rápida recuperação.
  • --tdeKeyStoreType especifica o tipo de armazenamento de chaves TDE. Valores válidos: FILE|KMS|AZURE|GOOGLE|AWS|OKV
  • --tdeKeyOCID especifica o OCID da chave KMS/AZURE/GOOGLE/AWS a ser usado para TDE. Isso só será aplicável se KMS/AZURE/GOOGLE/AWS estiver selecionado para o tipo de armazenamento de chaves TDE.
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados.
  • --resume retoma a operação anterior.
  • --sessionID retoma uma sessão específica por seu ID.
  • --revert faz rollback da operação anterior.
  • --waitForCompletion especifica se deseja aguardar a conclusão da operação. Defina como false para executar a operação no segundo plano. Valores válidos: true|false.
  • --enableFIPS especifica se o FIPS deve ser ativado. Defina como false para desativá-lo. Valores válidos: true|false.
  • --skipDRConfiguration especifica se a configuração de DR (Recuperação de Desastre) deve ser ignorada como parte da configuração do banco de dados stand-by. Valores válidos: true (ignorar configuração de DR) ou false (configurar DR).
  • --okvServer especifica o servidor do Oracle Key Vault. Lista delimitada por vírgulas de vários endereços IP.
  • --okvAdminUserName especifica o nome de usuário admin do Oracle Key Vault.
  • --okvServerRestPort especifica o número de porta REST do Oracle Key Vault.
  • --okvWalletName especifica o nome do Oracle Key Vault wallet.

Tópico principal: Referência de Comando do dbaascli

Executando a Operação configureStandby com o Utilitário dbaascli

Para criar um banco de dados stand-by, use o comando dbaascli dataguard configureStandby.

  1. Estabeleça conexão com a Máquina Virtual na qual você deseja hospedar o banco de dados stand-by como o 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 raiz.
    $ sudo -s
  3. Execute o comando configureStandby.
    dbaascli dataguard configureStandby --standbySID <standby SID> --activeDG <true|false> --dbName <db name> --standbyDBUniqueName <standby db unique name> --standbyScanName <comma-delimited list of standby SCAN IP addresses> --protectionMode <MAX_PERFORMANCE|MAX_AVAILABILITY> --standbyScanPort <standby SCAN port> --oracleHome <oracle home path> --standbyDBDomain <standby db domain name>. --primaryServiceName <primary db service name> --transportType <ASYNC|SYNC> --primaryScanPort <primary db SCAN port> --primaryScanIPAddresses <comma-delimited list primary db SCAN IP addresses> --standbyBlobFromPrimary <standby BLOB from primary>
  4. Informe as senhas do banco de dados principal SYS, TDE e AWR quando solicitado.

    Após a conclusão bem-sucedida do comando, o banco de dados stand-by é iniciado e se torna operacional.

dbaascli dataguard registerStandby

Para registrar um banco de dados stand-by recém-criado com todos os bancos de dados stand-by existentes e com o banco de dados principal, use o comando dbaascli dataguard registerStandby como terceira etapa após a etapa configureStandby.

Execute este comando como o usuário root no cluster principal. Além disso, em uma configuração de vários stand-by, execute o comando em todos os clusters stand-by, exceto no cluster de banco de dados stand-by recém-criado.

Sintaxe

dbaascli dataguard registerStandby --dbname <value> --standbyDBUniqueName <value>  --standbyDBDomain <value> | --noDBDomain --standbyScanIPAddresses <value> [--standbyScanPort <value>] [--standbyServiceName <value>] [--executePrereqs] [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]] [--waitForCompletion <value>]
Em que:
  • --dbname especifica o nome do Oracle Database.
  • --standbyDBUniqueName especifica o nome exclusivo do banco e dados stand-by a ser registrado com a configuração do Oracle Data Guard Broker.
  • --standbyDBDomain especifica o domínio de banco de dados stand-by para o qual o banco de dados principal será configurado.
  • --noDBDomain especifica não usar o nome do domínio do banco de dados para o banco de dados stand-by.
  • --standbyScanIPAddresses especifica uma lista delimitada por vírgulas de endereços IP correspondentes ao listener SCAN do banco e dados stand-by ou o nome do SCAN do banco e dados stand-by.
  • --standbyScanPort especifica o número de porta SCAN correspondente do banco do dados stand-by.
  • --standbyServiceName especifica o nome do sistema stand-by para o qual o banco principal será configurado.
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados.
  • --resume retoma a operação anterior.
  • --sessionID retoma uma sessão específica por seu ID.
  • --revert faz rollback da operação anterior.
  • --waitForCompletion especifica se deve aguardar a conclusão da operação. Defina como false para executar a operação no segundo plano. Valores válidos: true|false.

Tópico principal: Referência de Comando do dbaascli

Executando a Operação registerStandby com o Utilitário dbaascli

Para registrar o banco de dados stand-by especificado na configuração do Oracle Data Guard Broker, use o comando dbaascli dataguard registerStandby.

Para casos de uso stand-by únicos, o comando registerStandby deve ser executado somente no cluster principal, pois há uma associação um a um entre o principal e o stand-by.

No entanto, em configurações com vários bancos de dados stand-by, você deve executar o comando registerStandby no cluster principal e em todos os clusters stand-by existentes, excluindo o novo banco de dados stand-by que está sendo adicionado.

Por exemplo, considere uma configuração com dois bancos de dados stand-by: stdby1 e stdby2, em que stdby2 é o novo stand-by a ser registrado. Nesse caso, execute o comando registerStandby no cluster principal e no stdby1, mas não no stdby2.

Em resumo, ao adicionar um novo banco de dados stand-by a uma configuração existente do Oracle Data Guard, execute o comando registerStandby no principal e em todos os outros clusters stand-by registrados anteriormente, exceto o novo stand-by que está sendo adicionado.

  1. Estabeleça conexão com o cluster principal da configuração do Data Guard como o 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 raiz.
    $ sudo -s
  3. Execute o comando registerStandby.
    dbaascli dataguard registerStandby --dbname <db-name> --standbyDBUniqueName <standby-DB-unique-name> --standbyDBDomain <standby-DB-domain>

    Após a conclusão bem-sucedida do comando, o banco de dados stand-by especificado será registrado na configuração do Oracle Data Guard Broker.

  4. Repita as etapas de 1 a 3, conforme executadas no cluster principal, em todos os clusters stand-by existentes na configuração do Oracle Data Guard Broker, exceto o que está sendo registrado.

dbaascli dataguard deregisterStandby

Durante a exclusão do stand-by, execute o comando dbaascli dataguard deregisterStandby antes de excluir o banco de dados no cluster stand-by para cancelar o registro do banco de dados stand-by na configuração do Oracle Data Guard Broker.

Execute este comando como o usuário root no cluster principal. No entanto, no contexto de vários bancos de dados stand-by, esse comando precisa ser executado em todos os clusters stand-by, exceto no stand-by de destino.

Sintaxe

dbaascli dataguard deregisterStandby --dbname <value> --standbyDBUniqueName <value> [--executePrereqs] [--resume [--sessionID <value>]] [--waitForCompletion <value>]
Em que:
  • --dbname especifica o nome do Oracle Database.
  • --standbyDBUniqueName especifica o nome exclusivo do banco do dados stand-by a ser cancelado no registro da configuração do Oracle Data Guard Broker.
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados.
  • --resume retoma a operação anterior.
  • --sessionID retoma uma sessão específica por seu ID.
  • --waitForCompletion especifica se deve aguardar a conclusão da operação. Defina como false para executar a operação no segundo plano. Valores válidos: true|false.

Tópico principal: Referência de Comando do dbaascli

Executando a Operação deregisterStandby com o Utilitário dbaascli

Durante a exclusão do stand-by, execute o comando dbaascli dataguard deregisterStandby antes de excluir o banco de dados no cluster stand-by para cancelar o registro do banco de dados stand-by na configuração do Oracle Data Guard Broker.

Para casos de uso stand-by únicos, o comando deregisterStandby deve ser executado somente no cluster principal, pois há uma associação um a um entre o principal e o stand-by.

No entanto, em configurações com vários bancos de dados stand-by, você deve executar o comando deregisterStandby no cluster principal e em todos os clusters stand-by existentes, excluindo o banco de dados stand-by que está sendo cancelado no momento.

Por exemplo, considere uma configuração com dois bancos de dados stand-by: stdby1 e stdby2, em que o registro de stdby2 será cancelado. Nesse caso, execute o comando deregisterStandby no cluster principal e no stdby1, mas não no stdby2.

Em resumo, ao excluir um banco de dados stand-by de uma configuração existente do Oracle Data Guard, execute o comando deregisterStandby no principal e em todos os outros clusters stand-by existentes antes da operação de exclusão do banco de dados no cluster stand-by desejado.

  1. Estabeleça conexão com o cluster principal da configuração do Oracle Data Guard como o 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 raiz.
    $ sudo -s
  3. Execute o comando deregisterStandby.
    dbaascli dataguard deregisterStandby --dbname <db-name> --standbyDBUniqueName <standby-DB-unique-name>

    Após a conclusão bem-sucedida do comando, o banco de dados stand-by especificado será cancelado (removido) da configuração do Oracle Data Guard Broker.

  4. Repita as etapas de 1 a 3, conforme executadas no cluster principal, em todos os clusters stand-by existentes na configuração do Oracle Data Guard Broker, exceto o que está sendo cancelado.

dbaascli dataguard configureAWR

Para ativar ou desativar a configuração do AWR (Automatic Workload Repository) no stand-by do Active Data Guard, use o comando dbaascli dataguard configureAWR.

Execute esse comando como o usuário root no cluster stand-by do Active Data Guard no qual você deseja ativar ou desativar a configuração do AWR. Use este comando se o AWR não tiver sido configurado durante o processo de adição stand-by.

Sintaxe

dbaascli dataguard configureAWR --dbname <value> { --action <value> | --enable | --disable } [--executePrereqs] [--resume [--sessionID <value>]]
Em que:
  • --dbname especifica o nome do Oracle Database.
  • --action especifica se o AWR deve ser ativado ou desativado. Use --action enable para ativar o AWR e --action disable para desativá-lo.

    O argumento --action é retido para compatibilidade com versões anteriores. No entanto, é recomendável usar --enable ou --disable, pois eles fornecem a mesma funcionalidade, mas são mais explícitos

  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados.
  • --resume retoma a operação anterior.
  • --sessionID retoma uma sessão específica por seu ID.

Tópico principal: Referência de Comando do dbaascli

Executando a Operação configureAWR com o Utilitário dbaascli

Para configurar o AWR em um banco de dados stand-by ADG, use o comando dbaascli dataguard configureAWR.

  1. Conecte-se à Máquina Virtual na qual seu banco de dados stand-by do ADG está hospedado 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 raiz.
    $ sudo -s
  3. Execute o comando configureAWR.

    Para ativar o AWR, execute:

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

    Para desativar o AWR, execute:

    $ dbaascli dataguard configureAWR --dbname <db-name> --disable
  4. Informe as senhas SYS e AWR quando solicitado.

    Após a conclusão bem-sucedida do comando, o banco de dados stand-by ADG teria sido configurado com o AWR

Tópico principal: dbaascli dataguard configureAWR

dbaascli dataguard updateConfiguration

Para atualizar o modo de transporte ou o modo de proteção ou ambos os parâmetros de um ambiente do Data Guard, use o comando dbaascli dataguard updateConfiguration.

Execute-o como usuário root.

Quando o comando de atualização do modo de transporte é executado no principal, somente o modo de transporte do banco de dados principal é atualizado. Para atualizar o modo de transporte de um banco de dados stand-by, o comando deve ser executado separadamente nesse stand-by.

Por outro lado, quando o comando update protection mode é executado no principal, o modo de proteção é atualizado para os bancos de dados principal e stand-by. O modo de proteção também pode ser atualizado do modo stand-by, caso em que os bancos de dados principal e stand-by são atualizados.

Ao atualizar o modo de transporte ou proteção do principal, o sistema verifica os modos atuais nos bancos de dados principal e stand-by e prossegue com a atualização somente se todas as condições necessárias forem atendidas.

Sintaxe

dbaascli dataguard updateConfiguration --dbname <value> [--protectionMode <value>] [--transportType <value>] [--standbyDGType <value>] [--executePrereqs] [--resume [--sessionID <value>]] [--waitForCompletion <value>]
Em que:
  • --dbname especifica o nome do Oracle Database.
  • --protectionMode especifica o modo do Data Guard a ser definido ao configurar o banco de dados stand-by. Valores válidos: MAX_PERFORMANCE|MAX_AVAILABILITY.
  • --transportType especifica o tipo do transporte Data Guard a ser definido ao configurar o banco de dados stand-by. Valores válidos: ASYNC|SYNC.
  • --standbyDGType especifica o tipo de Data Guard do banco de dados stand-by a ser definido. Valores válidos: ADG|DG.
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados.
  • --resume retoma a operação anterior.
  • --sessionID retoma uma sessão específica por seu ID.
  • --waitForCompletion especifica se deseja aguardar a conclusão da operação. Defina como false para executar a operação no segundo plano. Valores válidos: true|false.

Tópico principal: Referência de Comando do dbaascli

Executando a Operação updateConfiguration com o Utilitário dbaascli

Para atualizar o modo de transporte e o modo de proteção ou ambos os parâmetros, use o comando dbaascli dataguard updateConfiguration.

  1. Conecte-se à Máquina Virtual na qual seu banco de dados stand-by do ADG está hospedado 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 raiz.
    $ sudo -s
  3. Execute o comando updateConfiguration.
    $ dbaascli dataguard updateConfiguration --dbname <db-name> --protectionMode MAX_PERFORMANCE|MAX_AVAILABILITY --transportType ASYNC|SYNC --standbyDGType ADG|DG.

    Após a conclusão bem-sucedida do comando, o Data Guard especificado será configurado com o modo de transporte ou o modo de proteção especificados.

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.

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

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

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

Exemplo 6-26 dbaascli dbHome getDetails - using Oracle home location

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

Exemplo 6-27 dbaascli dbHome getDetails - using Oracle home name

dbaascli dbHome getDetails --oracleHomeName home_db19c

dbaascli dbHome patch

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>]
[--nonRolling] 
[--skipDatapatchForDB <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
  • [--nonRolling] aplica patches no dbhome em todos os nós em paralelo. Observe que isso causaria um tempo de inatividade no banco de dados.
  • [--skipDatapatchForDB <value>] ignora a execução do datapatch na lista de bancos de dados delimitados por vírgulas especificada. Exemplo: db1,db2,db3...

Exemplo 6-28 dbaascli dbhome patch

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

dbaascli dbimage purge

O comando dbimage purge remove a imagem de software especificada do seu ambiente do Exadata Cloud 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.

dbaascli gridHome create

Para configurar o home do Grid Infrastructure, use o comando dbaascli gridHome create.

Pré-requisito

Execute o comando como usuário root.

Sintaxe

dbaascli gridHome create --version value [--resume [--sessionID value]] [--waitForCompletion value]
Em que:
  • --version especifica a versão do Grid home
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true|false

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
[--pkcs12WalletPath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Em que:
  • --pkcs12WalletPath especifica o caminho do 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.

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

dbaascli grid patch

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 a correção 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

Exemplo 6-30 dbaascli grid patch

dbaascli grid patch --targetVersion 19.12.0.0.0

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

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
[--pkcs12WalletPath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Em que:
  • --pkcs12WalletPath especifica o caminho do 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.

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

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

dbaascli 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.]

Exemplo 6-34 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
	{
            --pdbName <value>
            | --pdbUID <value>
        }
        --dbname <value> [--openMode <value>] [--startServices <value>] [--waitForCompletion <value>]
Em que:
  • --pdbName especifica o nome do PDB
  • --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 para iniciar todos ou uma lista de 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 para executar a operação em primeiro plano ou em segundo plano. Valores válidos: true|false.

Exemplo 6-35 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
        {
            --pdbName <value>
            | --pdbUID <value>
        }
        --dbname <value> [--waitForCompletion <value>]
Em que:
  • --pdbname especifica o nome do PDB que você deseja fechar.
  • --pdbUID especifica o identificador do PDB
  • --dbname especifica o nome do banco de dados contêiner que hospeda o PDB.
  • --waitForCompletion especifica para executar a operação em primeiro plano ou em segundo plano. Valores válidos: true|false.

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.

Exemplo 6-36 dbaascli pdb close

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

dbaascli pdb getConnectString

Para exibir informações da string de conexão do Oracle Net para um PDB (banco de dados plugável), execute o comando dbaascli pdb getConnectString.

Pré-requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb getConnectString --dbname <value>
        {
            --pdbName <value>
            | --pdbUID <value>
        }
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

Exemplo 6-37 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] [--waitForCompletion <value>]
        {
            [--blobLocation <value>]
            | [--standbyBlobFromPrimary <value>]
        }
        [--pdbTdeKeyVersionOCID <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.
  • --pdbTdeKeyVersionOCID

Durante o processo de criação do PDB, você é solicitado a especificar a senha de administração do novo PDB.

Exemplo 6-38 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 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] [--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 especifique para limpar o banco de dados de origem após um PDB ser realocado
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 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 <value>
        {
            --pdbName <value>
            | --pdbUID <value>
        }
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

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

Exemplo 6-40 dbaascli pdb list

dbaascli pdb list --dbname cdb name

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>]
    {
      [--createFromSnapshot
        {
          --snapshotName <value>
          | --snapshotUID <value>
        }
        [--copyDataFiles]]
      | [--snapshot]
    }
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 especifique true ou false para bloquear a conta do usuário administrador do PDB. O valor default é verdadeiro.
  • --sourcePDBServiceConvertList especifica uma lista de nomes de serviço de origem para destino delimitados por vírgulas que precisam ser convertidos. A sintaxe é source_srv1:new_srv1,source_srv2:new_srv2.
  • --createFromSnapshot | --snapshot
    • --createFromSnapshot especifique para criar o PDB com base no snapshot do PDB

      --snapshotName | --snapshotUID

      • --snapshotName especifique o nome do snapshot a ser criado com base no PDB.
      • --snapshotUID especifique o UID do snapshot para criar o PDB com base no PDB.

      --copyDataFiles especifique esta opção para ignorar a cópia do snapshot.

    • --snapshot especifique para criar o PDB com cópia de snapshot.

O PDB recém-clonado herda senhas de administração do PDB de origem.

Exemplo 6-41 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>]] [--executePrereqs] [--resume [--sessionID <value>]] [--blobLocation <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
  • --executePrereqs especifica para executar as verificações de pré-requisito e reportar os resultados
  • --resume retoma a operação anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --blobLocation especifica a localização do diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do Data Guard

Após a conclusão bem-sucedida, o PDB é aberto em todas as instâncias do banco de dados contêiner.

Exemplo 6-42 dbaascli pdb open

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

Opcional: --openMode READ_WRITE/READ_ONLY

dbaascli pdb recover

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 --dbname <value> --pdbName <value>
        {
            --start
                {
                    --untilTime <value> [--nonUTC]
                    | --untilSCN <value>
                    | --latest
                    | --tag <value>
                }
            | --status --uuid <value>
        }

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 recuperar
  • O --start inicia a recuperação de um PDB.
    • --untilTime recupera o PDB até o momento. Formato de entrada: DD-MON-YYYY HH24:MI:SS
    • --untilSCN recupera o PDB até SCN
    • --latest recupera o PDB para o último estado conhecido
    • --tag recupera o PDB para a tag de arquivamento
  • --status exibe os detalhes sobre um processo da tarefa de recuperação do PDB
    • --uuid identificador exclusivo da operação de recuperação do PDB. Formato de entrada: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx,

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

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] [--sourcePDBServices <value>] [--sourcePDBReadOnlyServices <value>] [--relocateAvailabilityType <value>] [--waitForCompletion <value>]
        {
            [--blobLocation <value>]
            | [--standbyBlobFromPrimary <value>]
        }
        [--upgradePDB] [--updateDBBlockCacheSize]
        {
            [--skipOpenPDB [--enableRefreshMode --refreshMode <value> [--refreshIntervalInMinutes <value>]]]
            | [--completePDBRelocate]
        }
        {
            [--dblinkUsername <value> [--honorCaseSensitiveUserName]]
            | [--dbLinkName <value>]
        }
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
  • --relocateAvailabilityType especifica a disponibilidade de MAX|NORMAL para ativar o encaminhamento de conexão do listener
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true|false
  • --blobLocation especifica um local de diretório personalizado no qual o arquivo blob stand-by será gerado em um ambiente 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 stand-by.
    Observação

    Os parâmetros --blobLocation são mutuamente exclusivos.
  • --upgradePDB especifica true para fazer upgrade do PDB como parte desta operação. Valores válidos : true | false.
  • O --updateDBBlockCachesize especifica para permitir que o aplicativo defina os parâmetros da inicialização do db block cache size a fim de suportar a cópia dos dados com tamanho diferente de bloco
  • --skipOpenPDB especifica que o PDB não deve ser aberto no final da operação atual.
    • --enableRefreshMode especifica para ativar o suporte de atualização do PDB na etapa um de realocação do PDB.
      • --refreshMode especifica o modo de atualização do PDB atualizável. Valores válidos: AUTO|MANUAL
        • --refreshIntervalInMinutes especifica para atualizar o intervalo de refreshablePDB em minutos
  • --completePDBRelocate especifica para concluir a realocação do PDB, se feita como uma operação de duas fases.

Exemplo 6-44 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>] [--upgradePDB]
        {
            [--createFromSnapshot --snapshotName <value> [--copyDataFiles]]
            | [--snapshot]
        }
        [--refreshablePDB --refreshMode <value> [--refreshIntervalInMinutes <value>]] [--updateDBBlockCacheSize]
        {
            [--dblinkUsername <value> [--honorCaseSensitiveUserName]]
            | [--dbLinkName <value>]
        }
        [--keepSourceDBServices <value>]
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.
  • --upgradePDB especifique para fazer upgrade do PDB como parte desta operação
  • --createFromSnapshot | --snapshot
    • --createFromSnapshot especifique para criar o PDB com base no snapshot do PDB
      • --snapshotName especifique o nome do snapshot a ser criado com base no PDB.

      --copyDataFiles especifique esta opção para ignorar a cópia do snapshot.

    • --snapshot especifique para criar o PDB com cópia de snapshot.
  • --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
  • --dbLinkName especifica um nome do link de banco de dados existente no banco de dados de destino que aponta para o banco de dados remoto

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.

Exemplo 6-45 dbaascli pdb remoteClone

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

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

Exemplo 6-46 dbaascli system getDBHomes

dbaascli system getDBHomes

dbaascli system getGridHomes

Para listar os detalhes de todos os homes do Grid, use o comando dbaascli system getGridHomes.

Pré-requisito

Execute o comando como usuário root ou oracle.

Sintaxe

dbaascli system getGridHomes

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.
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.

Exemplo 6-47 dbaascli tde addSecondaryHsmKey

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

dbaascli tde enableWalletRoot

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.

Exemplo 6-48 dbaascli tde enableWalletRoot

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

dbaascli tde encryptTablespacesInPDB

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 --pdbName
[--dbname]
[--precheckOnly]
[--useSysdbaCredential]
Em que:
  • --pdbName especifica o nome do PDB para criptografar todos os tablespaces.
  • --dbname especifica o nome do Oracle Database.
  • --precheckOnly só executa a pré-verificação desta operação. Valores válidos: yes ou no
  • --useSysdbaCredential usa credenciais SYSDBA para esta operação se o valor informado for true. Valores válidos: true ou false

Exemplo 6-49 dbaascli tde encryptTablespacesInPDB

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

dbaascli tde fileToHsm

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.

Exemplo 6-50 dbaascli tde fileToHsm --kmsKeyOCID

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

dbaascli tde getHsmKeys

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

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

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

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

Exemplo 6-54 dbaascli tde hsmToFile

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

dbaascli tde listKeys

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.

Exemplo 6-55 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 Exadata Cloud 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 Cloud 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 Cloud Infrastructure para executar o comando?

R: Você pode se conectar à máquina virtual usando SSH. Consulte a documentação do Exadata Cloud Infrastructure para obter instruções sobre como estabelecer uma conexão segura.

Exemplo 6-56 dbaascli tde removeSecondaryHsmKey

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

dbaascli tde rotateMasterKey

Rotacione a chave principal para a criptografia do banco de dados.

Pré-requisitos:

Execute o comando como usuário root.

Sintaxe

(Opcional) <Digite informações de sintaxe aqui.>

dbaascli tde rotateMasterKey --dbname <value> 
[--rotateMasterKeyOnAllPDBs] 
[--pdbName <value>] 
[--executePrereqs] 
[--resume [--sessionID <value>]]
{
     [--prepareStandbyBlob <value> [--blobLocation <value>]]
     | [--standbyBlobFromPrimary <value>]
 }
Em que:
  • --dbname - corresponde ao nome do banco de dados Oracle.
  • --rotateMasterKeyOnAllPDBs - especifique verdadeiro para rotacionar a chave principal de todos os PDBs no CDB. Valores válidos: true|false
  • --pdbName - especifique o nome do PDB.
  • --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.
  • --prepareStandbyBlob | --standbyBlobFromPrimary]
  • --prepareStandbyBlob - especifica 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

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

Exemplo 6-57 dbaascli tde setKeyVersion

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

dbaascli tde setPrimaryHsmKey

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.

Exemplo 6-58 dbaascli tde setPrimaryHsmKey

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

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

Observação

O comando dbaascli tde status foi descontinuado na release dbaascli 24.4.1.0.0. A Oracle recomenda o uso do comando dbaascli database getDetails.

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.

Exemplo 6-59 dbaascli tde status

dbaascli tde status --dbname dbname

Tópicos Relacionados

Tópico principal: Referência de Comando do dbaascli