Usando o Utilitário dbaascli com o Oracle Exadata Database Service on Cloud@Customer

Aprenda a usar o utilitário dbaascli no Oracle Exadata Database Service on Cloud@Customer.

Sobre o Uso do Utilitário dbaascli no Oracle Exadata Database Service on Cloud@Customer

Você pode usar o utilitário dbaascli para executar várias operações de ciclo de vida e administração do banco de dados no Oracle Exadata Database Service on Cloud@Customer, como criar um Oracle Database, aplicar patches a um Oracle Database, gerenciar bancos de dados plugáveis (PDBs), dimensionar a contagem de núcleos de CPU em modo desconectado e muito mais.

Use a console do DBaaS ou a interface de linha de comando 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) do Oracle Cloud Infrastructure. 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@Customer. Consulte Estabelecendo Conexão com uma Máquina Virtual com SSH.

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.

Criando o Banco de Dados Oracle com o Utilitário dbaascli

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

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

Para obter uma lista das versões suportadas disponíveis para criar o Banco de Dados Oracle, 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

    A saída do comando lista as imagens de software de banco de dados 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 7-1 dbaascli cswlib showImages

dbaascli cswlib showImages

DBAAS CLI version MAIN Executing command cswlib showImages 
INFO : Log file => /var/opt/oracle/log/list/list_2021-05-10_10:11:00.56966610630.log 

############ List of Available DB Images #############
1.IMAGE_TAG=19.8.0.0.0
VERSION=19.8.0.0.0
DESCRIPTION=19c JUL 2020 DB Image
IMAGE_ALIASES=19000-19800,19000-JUL2020

2.IMAGE_TAG=19.8.0.0.0-NC
VERSION=19.8.0.0.0
DESCRIPTION=19c JUL 2020 Non CDB Image
IMAGE_ALIASES=19000-NC19800,19000-NCJUL2020

3.IMAGE_TAG=19.9.0.0.0
VERSION=19.9.0.0.0
DESCRIPTION=19c OCT 2020 DB Image
IMAGE_ALIASES=19000-19900,19000-OCT2020

4.IMAGE_TAG=19.9.0.0.0-NC
VERSION=19.9.0.0.0
DESCRIPTION=19c OCT 2020 Non CDB Image
IMAGE_ALIASES=19000-NC19900,19000-NCOCT2020
Observação

Você pode especificar a versão de destino no comando dbaascli dbhome create como valor --version da saída do comando dbaascli cswlib showImages.

Criando o Home do Banco de Dados Oracle

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

Observação

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

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

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

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

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

Criando o Banco de Dados Oracle no Home Especificado

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

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

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

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

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

    Quando solicitado, digite as senhas sys e tde.

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

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

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

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

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

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

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

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

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

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

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

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

Alterando as Senhas do Banco de Dados

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

A senha especificada no campo Senha de Administrador do Banco de Dados quando você cria uma nova instância ou banco de dados Exadata Database Service on Cloud@Customer é 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 Exadata Database Service on Cloud@Customer

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

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

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

Para Alterar a Senha da Wallet de TDE para um Banco de Dados Exadata Database Service on Cloud@Customer

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

Gerenciando Imagens de Software do Oracle Exadata Database Service on Cloud@Customer com o Utilitário Dbaascli

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

Observação

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

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

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

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

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

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

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

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

    dbaascli cswlib showImages --product grid

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

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

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

Exemplo 7-2 dbaascli cswlib showImages

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

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

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

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

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

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

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

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

Para fazer download de uma imagem de software

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

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

    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 root:
    # 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 patch no Oracle Grid Infrastructure e no Banco de Dados Oracle em um sistema Exadata Cloud@Customer.

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).
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 7-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, primeiramente, conecte-se como usuário root a uma máquina virtual na instância do Exadata Cloud@Customer.

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.

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

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 Cloud@Customer, conclua este procedimento.

O conjunto de ferramentas específico da nuvem é usado nas VMs Convidadas do Exadata Cloud@Customer para operações locais, incluindo os comandos dbaascli.

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

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

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

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

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

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

Criando um Banco de Dados Duplicado

Usando dbaascli para Duplicar um Banco de Dados da Nuvem

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

Observação

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

Preparar para duplicação

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

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

Executar verificações de pré-requisitos

Para executar verificações de pré-requisitos, use a opção de comando --executePrereqs. Isso só executará as verificações de pré-requisitos sem executar a duplicação real do Oracle Database.

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

Duplicar o banco de dados

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

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

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.

Release 25.1.2.0.0 (250505)

  • Inclui AHF 25.2.4
  • Inclui syslens 25.1.1.0
  • Várias correções de bugs e melhorias de estabilidade

Release 25.1.1.0.0 (250220)

  • Inclui AHF 24.11.0
  • Inclui syslens 24.4.2.0
  • Várias correções de bugs e melhorias de estabilidade

Release 24.4.1.0.0 (241212)

  • Inclui AHF 24.9.1
  • Inclui syslens 24.3.3.1
  • Várias correções de bugs e melhorias de estabilidade

Release 24.3.2.0.0 (240912)

  • Inclui o AHF versão 24.7
  • Inclui o syslens versão 24.3.1.0
  • Várias correções de bugs e melhorias de estabilidade

Release 24.3.1.0.0 (240730)

  • 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
  • Inclui o AHF versão 24.6.1
  • Inclui syslens versão 24.1.2.0
  • Várias correções de bugs e melhorias de estabilidade

Release 24.2.1.0.0 (240620)

  • Adicionado suporte para o Oracle Database 23ai.
  • Inclui o AHF versão 24.4.3
  • Inclui o syslens versão 24.1.2.0
  • Várias correções de bug e melhorias de estabilidade.

Release 24.1.2.0.0 (240327, 240424, 240502)

  • Inclui o AHF versão 24.1.1.
  • Inclui o syslens versão 2.6.8.0.
  • Várias correções de bugs e melhorias de estabilidade

Release 24.1.1.0.0 (240118, 240219)

  • Inclui o AHF versão 23.11.1.
  • Inclui o syslens versão 2.6.4.3.
  • Várias correções de bugs e melhorias de estabilidade
  • (240219) Correção do Bug 36309260 aplicável ao agente DBCS versão 21.2 ou anterior: a comunicação entre o OCI Control Plane e o agente DBCS não funciona em algumas VMs.

Release 23.4.1.0.0 (231219)

  • Inclui o AHF versão 23.9.5.
  • Inclui o syslens versão 2.6.4.2.
  • Várias correções de bugs e melhorias de estabilidade

Release 23.3.2.0.0 (231115)

  • 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.
  • Inclui o AHF versão 23.7.7
  • Inclui syslens versão 2.3.6.10
  • Várias correções de bugs e melhorias de estabilidade

Release 23.3.1.0.0 (230817, 231020)

  • 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.
  • 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 no caso de configurações do Data Guard. 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.
    • Inclui o AHF versão 23.5.2 - Versão 23.3.1.0.0 (230817)
    • Inclui o AHF versão 23.5.4 - Versão 23.3.1.0.0 (231020)
  • Inclui syslens versão 2.3.6.9
  • Várias correções de bugs e melhorias de estabilidade
  • Correções críticas adicionais de produtos (231020)

Release 23.2.1.0.0 (230708, 230724)

  • 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.
    • Inclui o AHF versão 23.3.4 - Versão 23.2.1.0.0 (230708)
    • Inclui o AHF versão 23.3.5 - Versão 23.2.1.0.0 (230724)
  • Várias correções de bugs e melhorias de estabilidade

Release 23.1.2.0.0 (230411, 230616)

  • 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.
  • Inclui o AHF versão 23.2.0
  • Várias correções de bugs e melhorias de estabilidade

Release 23.1.1.0.1 (230302)

  • 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.
  • Inclui o AHF versão 22.2.5
  • Várias correções de bugs e melhorias de estabilidade

Release 22.4.1.0.1 (221214)

  • 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

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

Release 22.3.1.0.1 (220831)

  • 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 se tornou 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 se tornou 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

Release 22.2.1.1.0 (220713)

  • Novos comandos 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

Release 22.2.1.0.1 (220504)

  • Novos comandos 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. A instalação do RPM dbaastools pode ser executada com 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 (Bundle Patches) agora são substituídos por RUs ("Release Updates"). A implantação na nuvem consome RUs na forma de imagens de software, identificadas com Image Tags. 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 de 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 do Data Guard exige confirmação explícita para indicar que as operações necessárias no site stand-by foram concluídas, informando o 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

Release 22.1.1.1.0 (220301)

  • Novos comandos 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

Release 22.1.1.0.1 (220223)

  • Upgrade do Grid Infrastructure:
    • Novo workflow otimizado
  • Backup e Recuperação do Banco 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 recover –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 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

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.

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.

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.

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.

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.

Referência de Comando do dbaascli

Use dbaascli para criar bancos de dados e integrá-los ao framework de automação da nuvem.

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

Administração e configuração

Esta seção aborda tarefas essenciais para o gerenciamento e a configuração de ambientes do Oracle Database. Ele inclui comandos como dbaascli admin updateStack para instalar ou atualizar o RPM dbaastools e dbaascli job getStatus para verificar o status de jobs específicos.

dbaascli admin updateStack

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

Pré-requisitos

Execute o comando como usuário root.

Para usar o utilitário, conecte-se a uma máquina virtual do Exadata Database Service on Cloud@Customer.

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

Sintaxe

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

Perguntas Frequentes

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Exemplo de Casos de Uso

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

dbaascli admin updateStack

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

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

dbaascli admin updateStack --prechecksOnly

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

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

dbaascli admin updateStack --resume

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

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

dbaascli admin updateStack --nodes node1,node2

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

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

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

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

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

Para usar o utilitário, conecte-se a uma máquina virtual do Exadata Cloud@Customer.

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

Sintaxe

dbaascli job getStatus --jobID
Em que:
  • --jodID especifica o ID do job

Perguntas Frequentes

P: Para que é usado o comando getStatus do job dbaascli?

A: O comando dbaascli job getStatus é usado para exibir o status

Exemplo de Casos de Uso

Exemplo 1: Verificando o status de um job específico usando o ID do job

dbaascli job getStatus --jobID 12345

Verifica o status do job com o ID 12345. A saída mostrará o estado atual do job (por exemplo, em andamento, concluído ou com falha).

Exemplo 2: Verificando o status de um job de aplicação de patch usando o ID do job

dbaascli job getStatus --jobID 98765

Recupera o status de um job de aplicação de patch com o ID 98765 para ver se o patch foi aplicado com sucesso ou se ainda está em execução.

Exemplo 3: Verificando o status de um job de backup de banco de dados

dbaascli job getStatus --jobID 45678

Verifica o status de um job de backup de banco de dados com o ID 45678. A saída fornecerá detalhes sobre o andamento ou a conclusão do backup.

Exemplo 4: Verificando o andamento de um job de longa execução

dbaascli job getStatus --jobID 23456

Verifique o andamento de um job de execução longa (ID 23456) para ver se ele ainda está em execução ou se foi concluído.

Exemplo 5: Exibindo o status de um job de criação de banco de dados

dbaascli job getStatus --jobID 67890

Verifica o status de um job de criação de banco de dados identificado pelo ID de job 67890.

Escala de CPU

Esta seção se concentra no ajuste de recursos de CPU em um cluster de VMs. Inclui comandos como dbaascli cpuscale get_status para verificar o status de solicitações de dimensionamento atuais ou anteriores e dbaascli cpuscale update para aumentar ou diminuir o número de núcleos de CPU alocados para uma máquina virtual, permitindo o gerenciamento flexível de recursos com base nas demandas de carga de trabalho.

dbaascli cpuscale get_status

Para verificar o status da atual ou última solicitação de dimensionamento executada quando a conectividade de rede entre o Control Plane Server e a região do OCI for interrompida, use o comando dbaascli cpuscale get_status.

Pré-requisitos

Execute o comando como usuário root.

Para usar o utilitário, conecte-se a uma máquina virtual do Exadata Cloud@Customer.

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

Sintaxe

Exibe vários estados de execução de comando à medida que ele progride de scheduled, running e finalmente para success ou failure.
dbaascli cpuscale get_status

Perguntas Frequentes

P: Para que é usado o comando dbaascli cpuscale get_status?

R: O comando dbaascli cpuscale get_status é usado para verificar o status da atual ou última solicitação de dimensionamento de CPU, especialmente quando a conectividade de rede entre o Control Plane Server e a região do OCI é interrompida.

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

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

P: O que devo fazer se eu encontrar problemas ao executar o comando dbaascli cpuscale get_status?

R: Verifique se você está executando o comando como o usuário root e se está conectado a uma máquina virtual do Exadata Cloud@Customer. Se os problemas persistirem, consulte a documentação de comando ou procure suporte da Oracle.

P: E se o comando mostrar um status de falha?

R: Se o comando mostrar um status de falha, verifique os logs detalhados para obter mensagens de erro e solucionar problemas com base no erro específico. Talvez seja necessário resolver problemas de rede ou revisar os detalhes da solicitação de dimensionamento.

Exemplo de Casos de Uso

Exemplo 1: Verificando o status da operação de dimensionamento de CPU mais recente

dbaascli cpuscale get_status

Verifica o status da solicitação de dimensionamento atual ou da última CPU. Ele fornecerá informações sobre se o dimensionamento está programado, em execução ou concluído com sucesso ou falha.

Exemplo 2: Falha ao verificar o status após uma solicitação de dimensionamento

Uma operação de dimensionamento foi solicitada, mas encontrou problemas de rede entre o Control Plane Server e a região do OCI.

dbaascli cpuscale get_status

Verifica o status da solicitação de dimensionamento. Como o processo de dimensionamento falhou devido a problemas de rede, a saída fornecerá detalhes sobre o estado da falha.

Exemplo 3: Verificando o status quando o dimensionamento está em andamento

Uma operação de dimensionamento de CPU está em andamento e o usuário deseja monitorar seu progresso.

dbaascli cpuscale get_status

Verifica o status atual, mostrando que a solicitação de dimensionamento está no estado "em execução". Ele permite que o usuário rastreie a operação até que ela seja concluída ou falhe.

Exemplo 4: Verificando o status após a conclusão do dimensionamento bem-sucedida

Uma operação de dimensionamento foi executada e concluída com sucesso.

dbaascli cpuscale get_status

Verifica o status e confirma que a operação de dimensionamento foi concluída com sucesso. Ele relata o estado final como "sucesso".

dbaascli cpuscale update

Para aumentar ou diminuir a contagem de núcleos de CPU de uma máquina virtual em um cluster de VMs quando a conectividade de rede entre o Control Plane Server e a região do OCI for interrompida, use o comando dbaascli cpuscale update.

Pré-requisitos

Para ampliar ou reduzir OCPUs em um cluster de VMs no modo desconectado, execute os comandos dbaascli cpuscale update e dbaascli cpuscale get_status em qualquer nó dentro de um cluster de VMs para alterar a contagem de núcleos de CPU desse cluster. Se você tiver mais de um cluster de VMs, execute outro comando em qualquer nó dentro de cada cluster de VMs que você deseja ampliar ou reduzir. Esses comandos foram projetados para não funcionar se forem emitidos durante o modo normal conectado e vão expirar após 600 segundos (10 minutos).

Execute o comando como usuário root.

Para usar o utilitário, conecte-se a uma máquina virtual do Exadata Cloud@Customer.

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

Sintaxe

O Exadata Database Service on Cloud@Customer é considerado no modo Desconectado quando há uma perda de conectividade com o plano de controle DBaaS em execução no Oracle Cloud Infrastructure (OCI).

dbaascli cpuscale update --coreCount coreCount --message message
Em que:
  • --coreCount especifica o número de destino de CPUs que você deseja expandir ou reduzir para cada VM no cluster
  • --message você pode incluir uma mensagem para sua referência

Perguntas Frequentes

P: Para que é usado o comando dbaascli cpuscale update?

R: O comando dbaascli cpuscale update é usado para aumentar ou diminuir a contagem de núcleos de CPU de uma máquina virtual em um cluster de VMs quando a conectividade de rede entre o Control Plane Server e o Oracle Cloud Infrastructure (OCI) é interrompida.

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

R: Antes de usar esse comando, certifique-se de executá-lo no modo desconectado, o que significa que há uma perda de conectividade com o plano de controle DBaaS no OCI. Execute o comando de qualquer nó dentro do cluster de VMs e observe que ele expirará após 600 segundos (10 minutos) se usado no modo conectado. O comando deve ser executado como usuário raiz.

P: Como me conecto a uma máquina virtual para usar esse comando?

R: Para usar o comando dbaascli cpuscale update, você precisa estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH. Consulte "Conectando-se a uma Máquina Virtual usando SSH" para obter instruções detalhadas.

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

A: A opção --coreCount especifica o número de destino de CPUs que você deseja expandir ou reduzir para cada VM no cluster.

P: Posso incluir uma mensagem com o comando dbaascli cpuscale update?

R: Sim, você pode incluir uma mensagem opcional usando a opção --message para sua referência.

P: Como verifico o status de uma operação de dimensionamento de CPU?

R: Para verificar o status de uma operação de dimensionamento de CPU, use o comando dbaascli cpuscale get_status. Isso também deve ser executado de qualquer nó dentro do cluster de VMs.

P: O que acontece se eu executar o comando de atualização dbaascli cpuscale no modo conectado?

R: O comando foi projetado para não funcionar no modo conectado e expirará após 600 segundos (10 minutos). Ele só deve ser usado no modo desconectado.

P: Como dimensiono núcleos de CPU para vários clusters de VMs?

R: Se você tiver mais de um cluster de VMs, será necessário executar o comando dbaascli cpuscale update separadamente de qualquer nó dentro de cada cluster de VMs que você deseja ampliar ou reduzir.

Exemplo de Casos de Uso

Exemplo 1: Dimensionando núcleos de CPU para 20

O cluster de VMs está em execução com 16 núcleos e você deseja aumentá-lo para 20.

dbaascli cpuscale update --coreCount 20 --message "Scaling up for increased demand"

Dimensiona a contagem de núcleos da CPU até 20 e inclui uma mensagem "Dimensionando para maior demanda" para referência.

Exemplo 2: Reduzir núcleos de CPU para 8

No momento, o cluster de VMs está usando 12 núcleos, mas você deseja reduzir a contagem para 8 para salvar recursos.

dbaascli cpuscale update --coreCount 8 --message "Reducing CPU for maintenance period"

Reduz o número de núcleos de CPU para 8 e fornece uma mensagem para referência futura sobre por que a operação de dimensionamento foi executada.

Exemplo 3: Dimensionando a CPU sem uma mensagem

Você precisa dimensionar os núcleos de CPU de 32 para 24, mas nenhuma mensagem adicional é necessária.

dbaascli cpuscale update --coreCount 24

Este comando reduz a contagem de núcleos para 24 sem nenhuma mensagem. A operação será realizada com o log padrão de ações.

Exemplo 4: Verificando o status após dimensionar a CPU

Depois de executar o comando de dimensionamento, você deseja verificar se a atualização foi bem-sucedida.

dbaascli cpuscale get_status

Verifica o status da solicitação de dimensionamento atual ou da última, permitindo que você confirme se a operação de ampliação ou redução foi bem-sucedida.

Exemplo 5: Tentativa de dimensionar quando a VM já está no máximo de núcleos

O cluster de VMs já tem o máximo permitido de núcleos de CPU (48), mas é feita uma tentativa de expansão.

dbaascli cpuscale update --coreCount 50 --message "Attempt to scale beyond limit"

Falha, pois o cluster de VMs não pode exceder seu máximo de núcleos permitidos. O status refletirá a falha depois de tentar dimensionar para 50 núcleos.

Gerenciamento da Biblioteca de Software da Nuvem (CSWLIB)

Esta seção fornece ferramentas para gerenciar imagens de software nos ambientes Exadata Database Service on Cloud@Customer. Comandos como dbaascli cswlib deleteLocal permitem a remoção de imagens locais, enquanto dbaascli cswlib download permite o download de novas imagens de software. Você também pode exibir imagens disponíveis localmente com dbaascli cswlib listLocal ou verificar todas as imagens disponíveis do Database e do Grid Infrastructure usando dbaascli cswlib showImages. Esses comandos ajudam a gerenciar e manter bibliotecas de software com eficiência.

dbaascli cswlib deleteLocal

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

Execute o comando como usuário root.

Sintaxe

dbaascli cswLib deleteLocal --imageTag <value>

Em que:

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

Perguntas Frequentes

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

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

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

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

P: Como especificar qual imagem local excluir?

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

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

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

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

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

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

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

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

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

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

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

Exemplo 7-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 Database Service on Cloud@Customer, use o comando dbaascli cswlib download.

Pré-requisitos

Execute o comando como usuário root.

Para usar o utilitário, conecte-se a uma máquina virtual do Exadata Database Service on Cloud@Customer.

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

Sintaxe

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

Perguntas Frequentes

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

P: Quando eu usaria o comando dbaascli cswlib download?

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

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

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

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

Perguntas Frequentes

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

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

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

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

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

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

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

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

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

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

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

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

P: Quando devo usar o comando dbaascli cswlib listLocal?

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

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

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

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

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

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

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

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

Perguntas Frequentes

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

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

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

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

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

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

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

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

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

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

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

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

P: Quando devo usar o comando dbaascli cswlib showImages?

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

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

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

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

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

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

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

Exemplo 7-8 dbaascli cswlib showImages

dbaascli cswlib showImages

Serviço Database Management

Esta seção aborda tarefas abrangentes para o gerenciamento de Bancos de Dados Oracle. Ele inclui comandos para criar (dbaascli database create), excluir (dbaascli database delete) e fazer upgrade de bancos de dados (dbaascli database upgrade). Outras tarefas principais incluem adicionar e excluir instâncias (dbaascli database addInstance, dbaascli database deleteInstance), gerenciar backups (dbaascli database backup) e tratar a recuperação do banco de dados (dbaascli database recover). Você também pode modificar parâmetros de banco de dados, gerenciar bancos de dados plugáveis, aplicar patches a bancos de dados e converter bancos de dados não CDB em PDBs. Esses comandos garantem um controle eficiente sobre todo o ciclo de vida do banco de dados.

dbaascli database addInstance

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

Pré-Requisito

  • Execute o comando como usuário root.

Sintaxe

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

Perguntas Frequentes

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

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

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

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

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

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

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

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

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

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

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

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

P: Quando devo usar o comando dbaascli database addInstance?

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

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

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

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

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

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

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

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

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

dbaascli database backup

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

Pré-Requisito

  • Execute o comando como usuário root.

Sintaxe

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

Em que:

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

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

Perguntas Frequentes

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

P: Como excluo um backup de arquivamento existente?

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

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

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

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

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

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

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

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

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

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

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

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

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

Ou para recuperar o relatório mais recente:

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

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

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

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

Para ativar o RTRT:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Exemplo 7-9 Exemplos

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

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

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

    Execute o comando de configuração:

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

Para fazer shutdown e reiniciar um banco de dados Exadata Database Service on Cloud@Customer especificado, use o comando dbaascli database bounce.

Pré-requisitos

Execute o comando como usuário oracle.

Sintaxe

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

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

Perguntas Frequentes

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Exemplo 7-10 dbaascli database bounce

dbaascli database bounce --dbname dbname
dbaascli database changepassword

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

Pré-requisitos

Execute o comando como usuário root ou oracle.

Sintaxe

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

Perguntas Frequentes

P: O que o comando dbaascli database changePassword faz?

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

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

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

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

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

dbaascli database changePassword --dbname <db_name>

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

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

dbaascli database changePassword --user <username>

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

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

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

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

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

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

dbaascli database changePassword --standbyBlobFromPrimary <blob_file_path>

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

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

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

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

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

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

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

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

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

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

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

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

Exemplo 7-11 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]
            | [--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
  • 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

Perguntas Frequentes

P: O que o comando dbaascli database convertToPDB faz?

R: O comando dbaascli database convertToPDB converte um Oracle Database não CDB especificado em um PDB (Banco de Dados Plugável) dentro de um CDB (Banco de Dados Contêiner).

P: Como eu especifico qual banco de dados converter?

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

dbaascli database convertToPDB --dbname <db_name>

P: Como especifico o CDB de destino para a conversão do PDB?

A: Use a opção --cdbName para especificar o nome do CDB (Banco de Dados Contêiner) de destino no qual o novo PDB será criado. Se o CDB não existir, um novo será criado no mesmo Oracle home que o não CDB de origem.

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

A: A opção --executePrereqs executa verificações de pré-conversão para garantir que o banco de dados esteja pronto para conversão. Nenhuma alteração será feita no banco de dados durante esta etapa.

P: Como faço para copiar os arquivos de dados durante a conversão?

R: Você pode usar a opção --copyDatafiles para criar uma nova cópia dos arquivos de dados em vez de usar os arquivos originais do banco de dados de origem.

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

R: A opção --keepSourceDB permite preservar o não CDB de origem original após a conclusão da operação de conversão. Se você não usar essa opção, o banco de dados de origem será removido após a conversão.

Q: Como eu confirmo que um backup é preparado antes da conversão?

R: Use o flag --backupPrepared para confirmar que você fez um backup adequado do banco de dados não CDB antes de executar a conversão. Esta etapa é crucial para evitar a perda de dados.

P: Como especifico um nome personalizado para o novo PDB?

A: Use a opção --targetPDBName para fornecer um nome específico para o novo PDB que será criado como parte da conversão. Por exemplo:

dbaascli database convertToPDB --dbname <db_name> --targetPDBName <pdb_name>

P: Posso executar a conversão em segundo plano?

R: Sim, você pode usar a opção --waitForCompletion para especificar se a operação deve ser executada em segundo plano. Use false para executar em segundo plano e true para aguardar a conclusão da operação antes de continuar. O default é true.

P: Como retomar uma conversão interrompida anteriormente?

R: Você pode usar a opção --resume para retomar um processo de conversão interrompido anteriormente. Opcionalmente, você pode fornecer o --sessionID para retomar uma sessão específica.

P: O que acontece se eu não especificar um nome de CDB?

R: Se a opção --cdbName não for fornecida, o sistema criará o novo PDB no mesmo Oracle home do banco de dados não CDB de origem.

P: Posso continuar a conversão após uma interrupção sem saber o ID da sessão?

R: Sim, usar a opção --resume sem especificar um ID de sessão retomará a última sessão conhecida. Se quiser retomar uma sessão específica, você poderá fornecer o --sessionID.

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

A: A opção --sessionID é usada em conjunto com --resume para especificar uma sessão específica a ser retomada, caso haja várias sessões interrompidas.

P: É obrigatório ter um backup antes de converter um não CDB em um PDB?

R: Embora o flag --backupPrepared seja opcional, é altamente recomendável fazer um backup do não CDB antes de executar a conversão para o PDB. Isso garante que você possa restaurar o banco de dados em caso de problemas durante a conversão.

Exemplo 7-12 dbaascli database convertToPDB

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

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

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

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

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

Perguntas Frequentes

P: O que o comando dbaascli database create faz?

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

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

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

dbaascli database create --dbName <db_name>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Exemplo 7-13 dbaascli database create

dbaascli database create --dbName db19 --oracleHomeName myhome19 --dbSid db19sid --nodeList node1,node2 --createAsCDB true
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

Perguntas Frequentes

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

R: O comando dbaascli database createTemplate é usado para criar modelos de banco de dados (modelos DBCA) com base em um banco de dados especificado, que pode ser usado posteriormente para criar novos bancos de dados.

P: Como especifico o nome do banco de dados para o qual quero criar um modelo?

A: Use a opção --dbname para especificar o nome do Oracle Database do qual o modelo será criado. Por exemplo:

dbaascli database createTemplate --dbname <db_name>

P: Como especificar onde o modelo deve ser salvo?

R: Use a opção --templateLocation para especificar o local onde o modelo DBCA será salvo. Por exemplo:

dbaascli database createTemplate --dbname <db_name> --templateLocation /path/to/template

P: Posso fazer upload do modelo para o Object Storage diretamente?

R: Sim, você pode usar a opção --uploadToObjectStorage para fazer upload do modelo DBCA para o Object Storage. Você precisará especificar o usuário de log-in do Object Storage e o nome do bucket com as opções --objectStorageLoginUser e --objectStorageBucketName, respectivamente.

P: Como especifico os detalhes de log-in do Object Storage ao fazer upload do modelo?

A: Use as seguintes opções para especificar detalhes do 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: (Opcional) Especifica o URL do Object Storage se ele for diferente do padrão.

Por exemplo:

dbaascli database createTemplate --dbname <db_name> --uploadToObjectStorage --objectStorageLoginUser <user> --objectStorageBucketName <bucket_name>

P: Como especificar um nome personalizado para o modelo DBCA?

A: Use a opção --templateName para especificar um nome personalizado para o modelo DBCA. Por exemplo:

dbaascli database createTemplate --dbname <db_name> --templateName <template_name>

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

A: A opção --rmanParallelism especifica o nível de paralelismo para operações do RMAN durante o processo de criação do modelo. Por exemplo:

dbaascli database createTemplate --dbname <db_name> --rmanParallelism 4

P: O que acontece se eu não especificar as opções --templateLocation ou --uploadToObjectStorage?

R: Se você não especificar um local de modelo usando --templateLocation ou optar por fazer upload para o Object Storage usando --uploadToObjectStorage, o comando não saberá onde armazenar o modelo criado e não será concluído.

P: Posso usar --templateLocation e --uploadToObjectStorage ao mesmo tempo?

R: Não, você deve escolher --templateLocation para salvar o modelo localmente ou --uploadToObjectStorage para fazer upload dele no Object Storage, mas não ambos.

P: A opção --objectStorageUrl é obrigatória ao fazer upload do modelo para o Object Storage?

A: Não, a opção --objectStorageUrl é opcional. Se não for especificado, o URL padrão do Object Storage será usado. Você só precisará especificar isso se estiver usando um URL personalizado do Object Storage.

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

R: O comando deve ser executado como o usuário root ou oracle.

P: Posso retomar um processo de criação de modelo com falha anteriormente?

R: Não, o comando dbaascli database createTemplate não suporta a retomada de um processo com falha. Você precisará reiniciar o comando desde o início.

dbaascli database delete

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

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

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

Perguntas Frequentes

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

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

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

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

dbaascli database delete --dbname <db_name>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Exemplo 7-14 dbaascli database delete

dbaascli database delete --dbname db19
dbaascli database deleteInstance

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

Pré-Requisito

  • Execute o comando como usuário root.

Sintaxe

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

Perguntas Frequentes

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Exemplo 7-15 database deleteinstance

database deleteinstance --node test-node
dbaascli database duplicate

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

Pré-Requisito

  • Execute o comando como usuário root.

Sintaxe

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

Perguntas Frequentes

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

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

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

R: Execute o comando como usuário root.

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

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

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

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

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

--oracleHome <value>

ou

--oracleHomeName <value>

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

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

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

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

--skipPDBs pdb1,pdb2

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

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

--tdeConfigMethod FILE

ou

--tdeConfigMethod KMS --kmsKeyOCID <value>

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

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

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

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

--resume --sessionID <value>

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

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

--waitForCompletion true

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

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

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

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

--sgaSizeInMB <value>

--pgaSizeInMB <value>

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

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

Exemplo 7-16 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>
Onde :
  • --dbname - corresponde ao nome do banco de dados Oracle.

Perguntas Frequentes

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

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

P: Quem pode executar o comando dbaascli database getDetails?

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

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

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

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

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

dbaascli database getPDBs

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

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

Sintaxe

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

Perguntas Frequentes

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

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

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

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

--dbname <value>

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

R: Sim, execute o comando como usuário root ou o usuário oracle.

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

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

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

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

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

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

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

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

Exemplo 7-17 dbaascli database getPDBs --dbname

dbaascli database getPDBs --dbname apr_db1
dbaascli database modifyParameters

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

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

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

Perguntas Frequentes

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

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

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

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

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

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

--setParameters parameter1=valueA,parameter2=valueB

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

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

--resetParameters parameter1,parameter2

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

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

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

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

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

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

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

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

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

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

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

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

Exemplo 7-18 dbaascli database modifyParameters

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

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

Pré-Requisito

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

Sintaxe

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

Perguntas Frequentes

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

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

P: Como especificar qual banco de dados recuperar?

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

--dbname <database_name>

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

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

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

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

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

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

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

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

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

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

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

--untilSCN 123456789

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

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

--latest

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

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

--tag <backup_tag>

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

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

--status --uuid <recovery_uuid>

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

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

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

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

P: Posso realizar uma recuperação parcial?

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

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

Perguntas Frequentes

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

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

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

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

P: Como especificar qual banco de dados aplicar patch?

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

--dbname myDatabase

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

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

--resume

--sessionID 12345

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

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

--skipPdbs pdb1,pdb2

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

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

--pdbs pdb1,pdb2

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

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

--patchList patch1,patch2

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

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

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

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

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

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

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

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

--sessionID 67890

dbaascli database runDatapatch --dbname db19
dbaascli database start

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

Pré-requisitos

Execute o comando como usuário root.

Sintaxe

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

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

Perguntas Frequentes

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

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

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

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

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

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

--dbname myDatabase

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

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

--mode mount

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

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

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

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

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

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

--mode nomount

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

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

--mode mount

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

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

Exemplo 7-20 dbaascli database start

dbaascli database start --dbname dbname --mode mount
dbaascli database stop

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

Pré-requisitos

Execute o comando como usuário root.

Sintaxe

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

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

Perguntas Frequentes

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

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

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

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

P: Como especificar qual banco de dados interromper?

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

--dbname myDatabase

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

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

abort

immediate

normal

transactional

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

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

P: O que acontece no modo de desligamento imediato?

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

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

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

--mode abort

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

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

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

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

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

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

Exemplo 7-21 dbaascli database stop

dbaascli database stop --dbname db19
dbaascli database upgrade

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

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

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

    --standby

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

Perguntas Frequentes

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

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

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

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

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

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

--dbname myDatabase

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

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

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

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

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

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

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

A: A opção --removeGRP removerá automaticamente o backup de Ponto de Restauração Garantido (GRP) se o upgrade do banco de dados for bem-sucedido.

P: Quando devo usar a opção --increaseCompatibleParameter?

R: Use a opção --increaseCompatibleParameter para aumentar automaticamente o parâmetro compatível durante o upgrade do banco de dados, desde que o upgrade seja bem-sucedido.

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

A: A opção --executePrereqs executa apenas as verificações de pré-upgrade para garantir que o banco de dados esteja pronto para o upgrade.

P: Como lidar com uma etapa de pós-upgrade com falha?

A: Use a opção --postUpgrade para executar novamente as etapas de pós-upgrade se a tentativa inicial de pós-upgrade falhar.

P: Qual é o propósito da opção --revert?

A: A opção --revert reverte o Oracle Database ao seu Oracle home original, desfazendo o upgrade.

P: Como posso passar argumentos adicionais específicos do DBUA para o upgrade?

A: Use a opção --upgradeOptions para transmitir argumentos específicos do DBUA para o upgrade do Oracle Database. Consulte a documentação da Oracle para obter os argumentos e as opções com suporte.

P: É obrigatório especificar o Oracle home de destino para o upgrade?

R: Sim, você deve especificar --targetHome ou --targetHomeName para indicar o Oracle home de destino para o upgrade.

P: O que devo fazer se precisar executar uma verificação de pré-upgrade, mas não continuar com o upgrade?

R: Use a opção --executePrereqs para executar somente as verificações de pré-upgrade sem continuar com o upgrade real.

Exemplo 7-22 dbaascli database upgrade pre-upgrade requisite checks

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

Gerenciamento do Data Guard

Esta seção se concentra no gerenciamento de configurações e operações do Oracle Data Guard. Ele inclui comandos como dbaascli dataguard prepareStandbyBlob para gerar um arquivo blob para configurar um site stand-by e dbaascli dataguard updateDGConfigAttributes para atualizar atributos de automação do Data Guard em todos os nós do cluster. Esses comandos simplificam a configuração e a manutenção de ambientes do Data Guard para alta disponibilidade e recuperação de desastres.

dbaascli dataguard prepareStandbyBlob

Para gerar um arquivo blob contendo vários arquivos necessários no site stand-by no caso de um ambiente do dataguard, use o comando dbaascli dataguard prepareStandbyBlob.

Execute o comando como usuário root ou oracle.

Sintaxe

dbaascli dataguard prepareStandbyBlob --dbname <value> --blobLocation <value>
Em que:
  • --dbname especifica o nome do Oracle Database
  • --blobLocation especifica a localização do diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do Data Guard

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli dataguard prepareStandbyBlob?

A: O comando dbaascli dataguard prepareStandbyBlob é usado para gerar um arquivo blob contendo vários arquivos necessários no site stand-by em um ambiente do Data Guard.

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

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

P: Como especifico o nome do Oracle Database para o qual quero preparar o blob stand-by?

A: Use a opção --dbname seguida pelo nome do Oracle Database. Por exemplo:

--dbname myDatabase

P: Como especificar o local onde o arquivo blob stand-by será gerado?

R: Use a opção --blobLocation para especificar o caminho do diretório personalizado no qual o arquivo blob stand-by será gerado. Por exemplo:

--blobLocation /path/to/standby_blob

P: O que a opção --dbname faz no comando?

A: A opção --dbname especifica o nome do Oracle Database para o qual o arquivo blob stand-by está sendo preparado.

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

A: A opção --blobLocation define o caminho do diretório personalizado no qual o arquivo blob stand-by será criado.

P: Posso executar o comando dbaascli dataguard prepareStandbyBlob como usuário diferente do root ou do oracle?

R: Não, o comando deve ser executado como o usuário root ou oracle.

P: É possível usar um caminho relativo para a opção --blobLocation?

R: Recomenda-se usar um caminho absoluto para a opção --blobLocation para garantir que o arquivo blob stand-by seja criado no diretório correto.

P: O que devo fazer se eu quiser alterar o local onde o arquivo blob stand-by é gerado?

A: Modifique a opção --blobLocation para especificar um novo caminho de diretório para o arquivo blob stand-by.

P: Preciso executar alguma etapa adicional após gerar o arquivo blob stand-by?

R: Sim, depois de gerar o arquivo blob stand-by, você precisa transferi-lo para o site stand-by e usá-lo para a configuração do Data Guard.

dbaascli dataguard updateDGConfigAttributes

Para atualizar os atributos de automação do Data Guard em todos os nós do cluster, use o comando dbaascli dataguard updateDGConfigAttributes.

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

Sintaxe

dbaascli dataguard updateDGConfigAttributes --attributes <value>
Em que:
  • --attributes contém os atributos de automação do Data Guard que devem ser modificados. Aceita valores delimitados por vírgula no formato <attribute=value>. Os atributos devem ser predefinidos no arquivo de configuração do Data Guard.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli dataguard updateDGConfigAttributes?

A: O comando dbaascli dataguard updateDGConfigAttributes é usado para atualizar os atributos de automação do Data Guard em todos os nós do cluster.

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

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

P: Como especifico os atributos que desejo atualizar usando este comando?

A: Use a opção --attributes seguida pelos atributos a serem modificados. Os atributos devem estar em um formato delimitado por vírgulas, como attribute=value. Por exemplo:

--attributes attribute1=value1,attribute2=value2

P: Em qual formato os valores da opção --attributes devem estar?

R: Os valores da opção --attributes devem estar em um formato delimitado por vírgulas com cada atributo especificado como attribute=value.

P: Posso especificar vários atributos na opção --attributes?

R: Sim, você pode especificar vários atributos separando-os com vírgulas. Por exemplo:

--attributes attribute1=value1,attribute2=value2

P: O que acontece se eu fornecer um atributo que não seja predefinido no arquivo de configuração do Data Guard?

R: Se você fornecer um atributo que não seja predefinido, o comando poderá falhar ou ignorar o atributo não reconhecido. Certifique-se de que todos os atributos sejam predefinidos no arquivo de configuração do Data Guard.

P: Preciso reiniciar algum serviço após atualizar os atributos de automação do Data Guard?

R: Na maioria dos casos, você não precisa reiniciar os serviços após atualizar os atributos. No entanto, verifique os atributos específicos e seu impacto para determinar se é necessário reiniciar.

P: Como posso verificar se os atributos do Data Guard foram atualizados com sucesso?

R: Após executar o comando, você pode verificar os atributos atualizados verificando a configuração do Data Guard ou usando comandos/ferramentas de verificação apropriados específicos à sua configuração.

P: O que devo fazer se o comando não atualizar os atributos?

R: Verifique as mensagens de erro para obter detalhes sobre o que deu errado. Verifique se você especificou os atributos corretos e se eles estão predefinidos no arquivo de configuração do Data Guard. Verifique as permissões do usuário e a sintaxe do comando.

P: É possível atualizar atributos apenas para nós específicos usando este comando?

R: Não, o comando dbaascli dataguard updateDGConfigAttributes atualiza atributos em todos os nós do cluster. Se precisar atualizar atributos para nós específicos, talvez seja necessário usar métodos ou comandos diferentes.

dbaascli 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 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.
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. Saia do shell do comando root-user e desconecte-se da máquina virtual.
    # exit
    $ exit
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 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.

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.

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
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 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.
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
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 deve 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).
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 deve 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.
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.
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 deseja aguardar a conclusão da operação. Defina como false para executar a operação no segundo plano. Valores válidos: true|false.
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.
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

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 isso como o 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 deve aguardar a conclusão da operação. Defina como false para executar a operação no segundo plano. Valores válidos: true|false.
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.

Gerenciamento do Home do Banco de Dados

Esta seção fornece ferramentas para gerenciar homes do Oracle Database. Ele inclui comandos como dbaascli dbhome create para criar um novo home do Oracle Database e dbaascli dbHome delete para remover um existente. Você também pode exibir informações detalhadas sobre um Oracle home específico com dbaascli dbHome getDetails e verificar quais bancos de dados estão sendo executados em um determinado Oracle home usando dbaascli dbhome getDatabases. Esses comandos garantem o gerenciamento eficiente de ambientes de banco de dados.

dbaascli dbhome create

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

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli dbhome create --version <value>
[--oracleHome <value>]
[--oracleHomeName <value>]
[--enableUnifiedAuditing <value>] 
[--imageTag <value>]
[--ImageLocation <value>
Em que:
  • --version especifica a versão do Oracle Home definida como cinco segmentos numéricos separados por pontos, por exemplo, 19.12.0.0.0
  • --oracleHome especifica o local do Oracle home
  • --oracleHomeName especifica o nome do Oracle home definido pelo usuário. Se não for fornecido, o nome padrão será usado
  • --enableUnifiedAuditing especifica true ou false para ativar ou desativar a opção de link de auditoria unificada no Oracle home
  • --imageTag especifica a tag de imagem do Oracle home
  • --imageLocation - caminho da imagem a ser usada.
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true ou false.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli dbhome create?

R: O comando dbaascli dbhome create é usado para criar um novo home do Oracle Database com a versão desejada.

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

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

P: Como eu especifico a versão do Oracle Database ao criar um novo Oracle Home?

A: Use a opção --version seguida pela versão do Oracle Database no formato de cinco segmentos numéricos separados por pontos, como 19.11.0.0.0.

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

A: A opção --oracleHome especifica o local onde você deseja instalar o Oracle Home. Se não for fornecido, o local padrão será usado.

P: Posso designar um nome personalizado ao novo Oracle Home?

R: Sim, você pode usar a opção --oracleHomeName para especificar um nome definido pelo usuário para o Oracle Home. Se não for especificado, um nome padrão será usado.

P: Como ativo ou desativo a Auditoria Unificada no novo Oracle Home?

A: Use a opção --enableUnifiedAuditing e especifique true para ativar ou false para desativar a Auditoria Unificada do Oracle Home.

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

A: A opção --imageTag especifica a tag de imagem do Oracle Home, que pode ser usada nos casos em que a tag de imagem difere da versão.

P: Qual é um exemplo de uso do comando dbaascli dbhome create com a tag version and image?

A: Um exemplo do comando com a tag version and image é:

dbaascli dbhome create --version 19.8.0.0.0 --imageTag 19.8.0.0.0

Isso cria um Oracle Home para a versão 19.8.0.0.0 com a tag de imagem correspondente.

P: O que acontece se eu não fornecer as opções --oracleHome ou --oracleHomeName?

R: Se --oracleHome não for fornecido, o Oracle Home será instalado no local padrão. Se --oracleHomeName não for especificado, um nome padrão será designado ao Oracle Home.

P: Como posso verificar se a criação do Oracle Home foi bem-sucedida?

R: Depois de executar o comando, verifique os logs de saída em busca de mensagens ou erros bem-sucedidos. Você também pode verificar o Oracle Home navegando até o local especificado ou usando ferramentas Oracle como orainstRoot.sh.

P: É possível criar vários Oracle Homes com versões diferentes no mesmo sistema?

R: Sim, você pode criar vários Oracle Homes com versões diferentes especificando valores diferentes para as opções --version e --oracleHomeName.

P: O que devo fazer se a criação do Oracle Home falhar?

R: Verifique os logs de saída para obter mensagens de erro detalhadas. Verifique se você tem o formato de versão correto, as permissões necessárias e espaço em disco suficiente. Corrija os problemas e tente executar o comando novamente.

Exemplo 7-23 dbaascli dbhome create

dbaascli dbhome create --version 19.11.0.0.0

Como alternativa, dbaascli dbhome create --version 19.8.0.0.0.0 --imageTag 19.8.0.0.0 para casos em que as tags de imagem são diferentes da versão.

dbaascli dbHome delete

Para excluir um determinado home do Oracle Database, use o comando dbaascli dbHome delete.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli dbHome delete 
{ --oracleHome <value> 
| --oracleHomeName <value> } [--resume [--sessionID <value>]] 
Em que:
  • --oracleHome especifica o local do Oracle home
  • --oracleHomeName especifica o nome do Oracle home
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico

Perguntas Frequentes

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

A: O comando dbaascli dbHome delete é usado para excluir um home do Oracle Database especificado do sistema.

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

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

P: Como especifico o Oracle Home a ser excluído?

A: Você pode especificar o Oracle Home a ser excluído usando uma das seguintes opções:

--oracleHome <value> para fornecer o caminho absoluto da localização do Oracle Home.

--oracleHomeName <value> para fornecer o nome do Oracle Home.

P: Qual é a diferença entre as opções --oracleHome e --oracleHomeName?

A4:

--oracleHome especifica o local físico ou o caminho do Oracle Home a ser excluído.

--oracleHomeName especifica o nome definido pelo usuário do Oracle Home a ser excluído.

P: Como posso retomar um processo de exclusão interrompido anteriormente?

R: Você pode usar a opção --resume para retomar um processo de exclusão anterior. Se você souber o ID de sessão específico do processo, poderá incluí-lo com a opção --sessionID.

P: Para que é usada a opção --sessionID no comando dbaascli dbHome delete?

A: A opção --sessionID é usada para retomar uma sessão específica que foi interrompida ou falhou anteriormente durante o processo de exclusão.

P: O que acontece se eu não fornecer as opções --resume ou --sessionID?

R: Se as opções --resume ou --sessionID não forem fornecidas, o comando iniciará um novo processo de exclusão em vez de retomar um processo interrompido.

P: Existe alguma forma de confirmar a exclusão do Oracle Home após a execução do comando?

R: Você pode verificar a exclusão verificando se há mensagens de sucesso nos logs de saída e garantindo que o diretório Oracle Home não esteja mais presente no local especificado.

P: Posso excluir um Oracle Home que está sendo usado no momento por um banco de dados em execução?

R: Não, o Oracle Home não deve estar em uso por nenhum banco de dados ou serviço em execução durante o processo de exclusão. Certifique-se de interromper qualquer banco de dados relacionado antes de executar o comando de exclusão.

P: O que devo fazer se o comando de exclusão dbaascli dbHome falhar?

R: Verifique os logs de saída para obter quaisquer mensagens de erro. Certifique-se de que o Oracle Home não esteja em uso, verifique a localização ou o nome correto do Oracle Home e confirme se você tem as permissões necessárias. Depois de resolver quaisquer problemas, execute novamente o comando ou use a opção --resume, se necessário.

P: Posso excluir vários Oracle Homes de uma só vez usando o comando dbaascli dbHome delete?

R: Não, o comando só permite excluir um Oracle Home por vez especificando a opção --oracleHome ou --oracleHomeName.

P: Qual é um exemplo de exclusão de um Oracle Home por seu nome?

A: Aqui está um exemplo de exclusão de um Oracle Home por nome:

dbaascli dbHome delete --oracleHomeName myOracleHome

Esse comando exclui o Oracle Home com o nome myOracleHome.

P: Qual é um exemplo de exclusão de um Oracle Home por sua localização?

A: Aqui está um exemplo de exclusão de um Oracle Home especificando sua localização:

dbaascli dbHome delete --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

Esse comando exclui o Oracle Home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.

P: Posso cancelar o processo de exclusão depois de iniciado?

R: Não, depois que o processo de exclusão for iniciado, ele não poderá ser cancelado. Certifique-se de que o Oracle Home esteja pronto para exclusão antes de executar o comando.

dbaascli dbhome getDatabases

Para exibir informações sobre todos os Bancos de Dados Oracle em execução em um determinado Oracle home do banco de dados, use o comando dbaascli dbHome getDatabases. Especifique o local ou o nome do Oracle home.

Execute o comando como usuário root.

Sintaxe

dbaascli dbHome getDatabases
{ --oracleHomeName value | --oracleHome value }
Em que:
  • --oracleHomeName especifica o nome do Oracle home definido pelo usuário
  • --oracleHome especifica o local (caminho) do Oracle home

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli dbHome getDatabases?

A: O comando dbaascli dbHome getDatabases é usado para exibir informações sobre todos os Bancos de Dados Oracle em execução em um home do Oracle Database especificado.

P: Como posso especificar o home do Oracle Database a ser verificado?

A: Você pode especificar o home do Oracle Database usando uma das seguintes opções:

--oracleHomeName <value> para especificar o nome definido pelo usuário do Oracle home.

--oracleHome <value> para especificar o local completo (caminho) do Oracle home.

P: Qual é a diferença entre as opções --oracleHomeName e --oracleHome?

A4:

--oracleHomeName refere-se a um nome definido pelo usuário para o Oracle home.

--oracleHome refere-se ao local físico (ou caminho do diretório) do Oracle home no sistema.

P: Como faço para executar o comando dbaascli dbHome getDatabases?

A: Para executar o comando, use a sintaxe a seguir:

dbaascli dbHome getDatabases --oracleHomeName <value>

ou

dbaascli dbHome getDatabases --oracleHome <value>

Certifique-se de executar o comando como usuário root.

P: Posso especificar o nome do Oracle home e o local do Oracle home no mesmo comando?

R: Não, você só pode especificar --oracleHomeName ou --oracleHome em uma única execução de comando. Escolha uma opção com base em como você identifica o Oracle home.

P: Que tipo de informação o comando dbaascli dbHome getDatabases retorna?

R: O comando retorna informações sobre todos os Bancos de Dados Oracle em execução no Oracle home especificado. Isso inclui detalhes como nomes e status do banco de dados.

P: Qual é um exemplo de uso do dbaascli dbHome getDatabases com o local do Oracle home?

A: Aqui está um exemplo de como usar o comando com o local do Oracle home:

dbaascli dbHome getDatabases --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

Esse comando recupera a lista de bancos de dados em execução no Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.

P: Qual é um exemplo de uso do dbaascli dbHome getDatabases com o nome do Oracle home?

A: Aqui está um exemplo de como usar o comando com o nome do Oracle home:

dbaascli dbHome getDatabases --oracleHomeName myOracleHome

Esse comando recupera a lista de bancos de dados em execução no Oracle home chamado myOracleHome.

P: Preciso de permissões especiais para executar este comando?

R: Sim, você deve executar o comando como usuário raiz para exibir as informações sobre Bancos de Dados Oracle em execução em um Oracle home especificado.

P: O que devo verificar se o comando dbaascli dbHome getDatabases não retorna bancos de dados?

R: Certifique-se de ter especificado o nome ou o local correto do Oracle home e de que há bancos de dados em execução nesse Oracle home. Além disso, confirme se o Oracle home está configurado e ativo corretamente.

P: Posso usar o comando dbaascli dbHome getDatabases em vários Oracle homes de uma só vez?

R: Não, o comando funciona em um único Oracle home de cada vez. Execute o comando separadamente para cada Oracle home que você deseja consultar.

P: Existe uma maneira de verificar se o Oracle home especificado no comando está correto?

R: Você pode verificar o Oracle home verificando a estrutura do diretório ou os detalhes da configuração no sistema para garantir que o caminho ou o nome fornecido corresponda ao Oracle home real.

P: O que acontece se eu executar o comando sem especificar um nome do Oracle home ou do Oracle home?

A: O comando requer que a opção --oracleHome ou --oracleHomeName seja especificada. Se nenhuma das opções for fornecida, o comando falhará ao ser executado.

P: Este comando pode recuperar bancos de dados que estão interrompidos no momento?

R: Sim, o comando listará todos os bancos de dados associados ao Oracle home especificado, independentemente de estarem em execução ou interrompidos no momento.

Exemplo 7-24 dbaascli dbHome getDatabases --oracleHome

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

Para exibir informações sobre um Oracle home específico, use o comando dbaascli dbHome getDetails. Especifique o local ou o nome do Oracle home.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli dbHome getDetails
{ --oracleHomeName value | --oracleHome value }
Em que:
  • --oracleHomeName especifica o nome do Oracle home definido pelo usuário
  • --oracleHome especifica o local do Oracle home

Perguntas Frequentes

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

R: O comando dbaascli dbHome getDetails é usado para exibir informações detalhadas sobre um Oracle home específico no sistema.

P: Como especifico o Oracle home sobre o qual quero obter detalhes?

A: Você pode especificar o Oracle home usando uma das seguintes opções:

--oracleHomeName <value> para especificar o nome definido pelo usuário do Oracle home.

--oracleHome <value> para especificar o local completo (caminho) do Oracle home.

P: Qual é a diferença entre --oracleHomeName e --oracleHome?

A4:

--oracleHomeName é o nome definido pelo usuário para um Oracle home.

--oracleHome refere-se ao caminho completo do diretório em que o Oracle home está localizado.

P: Como faço para executar o comando dbaascli dbHome getDetails?

A: Para executar o comando, use a sintaxe a seguir:

dbaascli dbHome getDetails --oracleHomeName <value>

ou

dbaascli dbHome getDetails --oracleHome <value>

Certifique-se de executar o comando como usuário root.

P: Posso especificar --oracleHomeName e --oracleHome no mesmo comando?

R: Não, você só pode usar uma opção por execução de comando. Você deve especificar o nome do Oracle home ou a localização do Oracle home, não ambos.

P: Quais informações o comando dbaascli dbHome getDetails retorna?

R: O comando fornece informações detalhadas sobre o Oracle home especificado, como sua versão, status e quaisquer outros detalhes de configuração associados ao Oracle home.

P: Qual é um exemplo de uso do comando dbaascli dbHome getDetails com um local do Oracle home?

A: Aqui está um exemplo:

dbaascli dbHome getDetails --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

Este comando recupera informações detalhadas sobre o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.

P: Qual é um exemplo de uso do comando dbaascli dbHome getDetails com um nome do Oracle home?

A: Aqui está um exemplo:

dbaascli dbHome getDetails --oracleHomeName myOracleHome

Este comando recupera informações detalhadas sobre o Oracle home chamado myOracleHome.

P: Preciso de permissões especiais para executar este comando?

R: Sim, você deve executar o comando como usuário raiz para exibir detalhes sobre o Oracle home.

P: O que devo fazer se o comando dbaascli dbHome getDetails não retornar informações?

R: Verifique se você especificou corretamente o nome ou o local do Oracle home e se o Oracle home está configurado corretamente e existe no sistema.

P: Posso usar o comando dbaascli dbHome getDetails em vários Oracle homes simultaneamente?

R: Não, o comando só funciona em um único Oracle home de cada vez. Execute o comando separadamente para cada Oracle home.

P: É possível verificar o nome do Oracle home antes de executar o comando?

R: Sim, você pode verificar o nome do Oracle home verificando os arquivos de configuração do sistema ou listando todos os Oracle homes disponíveis no sistema.

P: O que acontece se eu não especificar um nome ou local do Oracle home no comando?

A: O comando requer que a opção --oracleHome ou --oracleHomeName seja especificada. Se nenhum dos dois for fornecido, a execução do comando falhará.

P: Posso recuperar informações sobre Oracle homes que não estão em uso no momento?

R: Sim, o comando dbaascli dbHome getDetails fornece detalhes sobre Oracle homes, independentemente de eles estarem em uso ou ociosos.

P: O que devo verificar se o comando retorna um erro?

R: Verifique se o nome ou a localização do Oracle home está correto, se o Oracle home existe e se você está executando o comando como o usuário root. Verifique novamente se há erros de digitação ou caminhos incorretos.

Exemplo 7-25 dbaascli dbHome getDetails - using Oracle home location

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

Exemplo 7-26 dbaascli dbHome getDetails - using Oracle home name

dbaascli dbHome getDetails --oracleHomeName home_db19c

Diagnósticos e Verificações de Integridade

Esta seção aborda ferramentas para a manutenção da integridade e do diagnóstico de problemas nos ambientes do Oracle Database. Comandos como dbaascli diag collect são usados para coletar dados de diagnóstico, enquanto dbaascli diag healthCheck permite executar verificações de integridade para identificar possíveis problemas. Essas ferramentas ajudam a garantir a estabilidade e o desempenho do sistema, monitorando e abordando proativamente as preocupações.

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.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli diag collect?

R: O comando dbaascli diag collect é usado para coletar logs de diagnóstico do Oracle Database e componentes associados, como SO, Grid Infrastructure (GI) e ferramentas DBaaS.

P: Como especifico para quais componentes coletar diagnósticos?

A: Você pode especificar os componentes usando a opção --components. Os valores válidos são:

db (para logs de banco de dados)

gi (para logs do Grid Infrastructure)

os (para logs do sistema operacional)

dbaastools (para logs de ferramentas DBaaS)

all (para coletar logs de todos os componentes)

P: Como posso coletar logs para um intervalo de tempo específico?

A: Use as seguintes opções para especificar um intervalo de tempo:

--startTime <value> para definir o horário inicial da coleta de logs.

--endTime <value> para definir o horário final da coleta de logs.

A hora deve estar no formato: YYYY-MM-DDTHH24:MM:SS.

P: Em que formato os horários inicial e final devem estar?

A: --startTime e --endTime devem estar no formato YYYY-MM-DDTHH24:MM:SS. Por exemplo, 2024-09-01T15:30:00.

P: Como especifico de quais nós coletar diagnósticos?

R: Você pode usar a opção --nodes para especificar uma lista de nós delimitados por vírgulas. Por exemplo:

--nodes node1,node2

P: Como coleto logs de um banco de dados específico?

A: Use a opção --dbNames para especificar o nome do banco de dados para o qual você deseja coletar logs. Somente um nome de banco de dados pode ser especificado por vez.

P: Como posso armazenar os logs coletados no Object Storage?

A: Use a opção --objectStoreBucketUri para especificar o URL de PAR (solicitação pré-autenticada) do bucket do Object Storage no qual o upload dos logs será feito.

P: Posso coletar logs para um diretório local em vez do Object Storage?

R: Sim, você pode usar a opção --destLocation para especificar um diretório na VM convidada em que os logs serão coletados. O local padrão é /var/opt/oracle/dbaas_acfs.

P: O que acontece se eu não especificar um destino para os logs?

R: Se nenhum destino for especificado, os logs coletados serão armazenados no local padrão /var/opt/oracle/dbaas_acfs na VM convidada.

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

A: A opção --waitForCompletion especifica se o comando deve ser finalizado antes de retornar o controle ao usuário. O valor padrão é true. Se você especificar false, a operação será executada em segundo plano.

P: Como posso executar a coleta de logs em segundo plano?

A: Defina a opção --waitForCompletion como false para executar o processo de coleta de logs em segundo plano:

dbaascli diag collect --waitForCompletion false

P: Posso retomar uma sessão anterior de coleta de logs com este comando?

R: Não, o comando dbaascli diag collect não suporta a retomada das sessões anteriores. Você precisará iniciar um novo processo de coleta de logs.

P: Como posso garantir que o upload dos logs seja feito diretamente no Object Storage?

R: Você pode fornecer um --objectStoreBucketUri válido (URL de solicitação pré-autenticada do Object Storage) no qual o upload dos logs será feito após a coleta.

P: Posso coletar logs para vários bancos de dados de uma só vez?

R: Não, você só pode especificar um nome de banco de dados por vez usando a opção --dbNames.

P: O que devo fazer se quiser coletar todos os logs disponíveis para todos os componentes?

A: Use --components tudo para coletar logs de todos os componentes, incluindo o banco de dados, o Grid Infrastructure, o sistema operacional e as ferramentas DBaaS.

P: Qual é um exemplo de comando para coletar logs do componente de banco de dados de um intervalo de tempo específico?

A: Aqui está um exemplo de comando:

dbaascli diag collect --components db --startTime 2024-09-01T12:00:00 --endTime 2024-09-01T14:00:00 --dbname orcl

P: Qual é um exemplo de comando para coletar logs e fazer upload deles para o Object Storage?

A: Aqui está um exemplo de comando:

dbaascli diag collect --components db --objectStoreBucketUri https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL

P: Qual será o comportamento padrão se a opção --components não for especificada?

R: Se você não especificar a opção --components, o comando poderá não saber quais logs coletar e poderá falhar. É recomendável sempre especificar os componentes dos quais você deseja coletar logs.

P: Posso especificar as opções --objectStoreBucketUri e --destLocation no mesmo comando?

R: Não, você deve escolher um destino — Object Storage via --objectStoreBucketUri ou um diretório local via --destLocation.

P: O que devo fazer se encontrar um erro ao usar o comando dbaascli diag collect?

R: Verifique novamente se você forneceu nomes de componentes válidos, formatos de data/hora e opções de destino. Além disso, certifique-se de estar executando o comando como o usuário root.

dbaascli diag healthCheck

Para executar verificações de integridade de diagnóstico, use o comando dbaascli diag healthCheck.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli diag healthCheck
[--destLocation]
[--nodes]
[--objectStoreBucketURI]
Em que:
  • --destLocation especifica o local na VM Convidada para coletar logs. Padrão: /var/opt/oracle/dbaas_acfs
  • --nodes especifica uma lista de nós delimitados por vírgulas para coletar logs
  • --objectStoreBucketURI especifica um URL de PAR (solicitação pré-autenticada) do serviço Object Storage usado para fazer upload de logs coletados. Os logs são coletados da VM Convidada. Para obter mais informações, consulte Usando Solicitações Pré-autenticadas.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli diag healthCheck?

R: O comando dbaascli diag healthCheck é usado para executar verificações de integridade de diagnóstico em um Oracle Database executado em um ambiente Exadata Cloud@Customer.

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

R: O comando deve ser executado como o usuário root e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: Como eu especifico um diretório personalizado para coletar os logs?

R: Use a opção --destLocation para especificar o diretório no qual os logs de verificação de integridade serão coletados. O local padrão é /var/opt/oracle/dbaas_acfs.

P: Qual será o local padrão para a coleta de logs se eu não especificar --destLocation?

A: O diretório padrão para coleta de logs é /var/opt/oracle/dbaas_acfs.

P: Posso especificar em quais nós executar a verificação de integridade?

R: Sim, você pode usar a opção --nodes para especificar uma lista de nós delimitados por vírgulas em que a verificação de integridade deve ser executada.

P: Como faço upload dos logs de verificação de integridade para o Object Storage?

A: Use a opção --objectStoreBucketURI para fornecer um URL de PAR (solicitação pré-autenticada) do serviço Object Storage. Isso fará upload dos logs coletados para o bucket especificado.

P: Posso coletar logs de vários nós?

R: Sim, você pode especificar vários nós usando a opção --nodes em um formato delimitado por vírgulas. Por exemplo: --nodes node1,node2.

P: Qual é um exemplo de comando para executar uma verificação de integridade em um nó específico?

A: Aqui está um exemplo de comando para executar a verificação de integridade em um nó específico:

dbaascli diag healthCheck --nodes node1

P: Como posso armazenar os logs no Object Storage em vez de na máquina local?

R: Você pode fornecer um URL de PAR (solicitação pré-autenticada) usando a opção --objectStoreBucketURI para armazenar os logs no Object Storage.

P: Posso especificar --destLocation e --objectStoreBucketURI ao mesmo tempo?

R: Sim, você pode especificar --destLocation para armazenamento local e --objectStoreBucketURI para fazer upload de logs para o Object Storage.

P: O que devo fazer se encontrar um erro ao executar o comando dbaascli diag healthCheck?

R: Certifique-se de que você esteja executando o comando como o usuário raiz e tenha fornecido opções válidas para --destLocation, --nodes ou --objectStoreBucketURI. Verifique se os nomes dos nós estão corretos, se especificado.

P: Posso executar a verificação de integridade em segundo plano?

R: O comando dbaascli diag healthCheck não tem um modo de fundo explícito, mas você pode executá-lo em segundo plano anexando & no final do comando.

P: O que acontece se eu não fornecer a opção --nodes?

R: Se a opção --nodes não for fornecida, a verificação de integridade será executada em todos os nós do cluster por padrão.

P: Posso retomar uma sessão de verificação de integridade anterior usando este comando?

R: Não, o comando dbaascli diag healthCheck não suporta a retomada das sessões anteriores. Você deve iniciar uma nova verificação de integridade todas as vezes.

P: Qual é um exemplo de comando para executar uma verificação de integridade e fazer upload de logs para o Object Storage?

A: Aqui está um exemplo de comando:

dbaascli diag healthCheck --objectStoreBucketURI https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL

P: Qual será o comportamento padrão se eu não especificar --destLocation ou --objectStoreBucketURI?

R: Se nem --destLocation nem --objectStoreBucketURI forem especificados, os logs de verificação de integridade serão coletados no diretório padrão /var/opt/oracle/dbaas_acfs na máquina local.

P: Posso limitar a verificação de integridade a componentes ou logs específicos?

R: Não, o comando dbaascli diag healthCheck não permite especificar componentes ou logs individuais. Ele executa uma verificação geral de saúde de diagnóstico para o sistema.

P: O que devo verificar antes de executar o comando dbaascli diag healthCheck?

R: Certifique-se de estar conectado a uma máquina virtual do Exadata Cloud@Customer e executando o comando como o usuário root.

Gerenciamento do Grid Infrastructure

Esta seção se concentra no gerenciamento do Oracle Grid Infrastructure, que suporta clusterização e alta disponibilidade. As principais tarefas incluem a configuração de um home do Grid Infrastructure (dbaascli gridHome create), o upgrade do Grid Infrastructure (dbaascli grid upgrade) e o gerenciamento de certificados TCPS (Transport Layer Security) configurando (dbaascli grid configureTCPS), removendo (dbaascli grid removeTCPSCert) ou alternando-os (dbaascli grid rotateTCPSCert). Esses comandos garantem a configuração, a manutenção e a segurança eficientes do Grid Infrastructure.

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

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli gridHome create?

R: O comando dbaascli gridHome create é usado para configurar um home do Grid Infrastructure para o Oracle Grid Infrastructure em um ambiente Exadata Cloud@Customer.

P: Qual é o pré-requisito para executar o comando dbaascli gridHome create?

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

P: Como especifico a versão do home do Grid Infrastructure a ser criada?

A: Use a opção --version para especificar a versão do Grid home. Esta é uma opção obrigatória ao criar o Grid home.

P: Posso retomar uma sessão de criação dbaascli gridHome anterior?

R: Sim, você pode usar a opção --resume para retomar uma sessão anterior. Opcionalmente, você pode especificar o ID da sessão usando a opção --sessionID para retomar uma sessão específica.

P: O que a opção --resume faz no comando dbaascli gridHome create?

A: A opção --resume permite retomar uma operação interrompida ou incompleta anteriormente.

Q: Como faço para executar a operação em segundo plano?

R: Você pode definir a opção --waitForCompletion como falsa para executar a operação em segundo plano. Os valores válidos para esta opção são true (padrão) ou false.

P: Qual será o comportamento padrão se --waitForCompletion não for especificado?

R: Se --waitForCompletion não for especificado, a operação será executada em primeiro plano, e o comando aguardará a conclusão da operação antes de retornar o controle ao usuário.

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

A: A opção --sessionID é usada para especificar o ID de uma sessão anterior que você deseja retomar, no caso de uma operação incompleta ou interrompida.

P: Posso usar o comando dbaascli gridHome create para fazer upgrade de um Grid home existente?

R: Não, esse comando é usado especificamente para configurar um novo home do Grid Infrastructure, não para fazer upgrade de um existente.

P: O que é um exemplo de comando para criar um Grid home com a versão 19.9.0.0.0?

A: Aqui está um exemplo de comando:

dbaascli gridHome create --version 19.9.0.0.0

P: O que devo fazer se o comando dbaascli gridHome create for interrompido?

R: Você pode retomar a operação usando a opção --resume. Se você tiver o ID da sessão, poderá fornecê-lo usando a opção --sessionID para retomar uma sessão específica.

P: Posso especificar a opção --resume sem um ID de sessão?

R: Sim, você pode usar a opção --resume sem especificar um ID de sessão. Nesse caso, o sistema tentará retomar a sessão mais recente.

P: O que acontece se eu especificar --waitForCompletion falso?

R: Se você especificar --waitForCompletion false, a operação será executada em segundo plano, permitindo que você continue usando a linha de comando enquanto a operação for concluída.

P: É possível acompanhar o progresso de uma operação em segundo plano?

R: O comando dbaascli não fornece uma maneira direta de rastrear operações em segundo plano. Talvez seja necessário verificar os logs do sistema ou o status da sessão manualmente.

P: Posso especificar uma versão do Grid home inválida ao criá-la?

R: Não, a opção --version deve conter uma versão válida do Grid Infrastructure. Se uma versão inválida for fornecida, o comando retornará um erro.

P: Como posso determinar a versão do Grid home a ser usada para criação?

R: Você pode consultar a documentação da Oracle ou consultar o administrador do banco de dados para determinar a versão correta do Grid home a ser usada para seu ambiente.

P: O que devo verificar antes de executar o comando dbaascli gridHome create?

R: Certifique-se de que você esteja conectado como o usuário root e que a versão que você deseja usar para o Grid Infrastructure seja compatível com seu ambiente.

dbaascli grid configureTCPS

Para configurar o TCPS para o cluster existente, use o comando dbaascli grid configureTCPS.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

Observação

Por padrão, o TCPS é ativado para bancos de dados em sistemas Oracle Exadata Database Service on Dedicated Infrastructure.
Observação

O TCPS não está ativado para bancos de dados nos sistemas Exadata Database Service on Cloud@Customer. Para ativar o TCPS para um determinado banco de dados, atualize o arquivo sqlnet.ora específico do banco de dados com WALLET_LOCATION = (SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=/var/opt/oracle/dbaas_acfs/grid/tcps_wallets))) em todos os nós de banco de dados e, em seguida, devolva o banco de dados. Isso ativará o uso do TCPS para o banco de dados. No entanto, ativar o TCPS fará com que a conexão ZDLRA falhe. Nos sistemas Exadata Database Service on Cloud@Customer, você pode ativar a configuração ZDLRA ou TCPS. A ativação de ZDLRA e TCPS simultaneamente não funcionará.
dbaascli grid configureTCPS
[--pkcs12WalletFilePath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Em que:
  • --pkcs12WalletFilePath especifica o caminho absoluto do arquivo de certificado, que está no formato de wallet pkcs12
  • --caCertChain lista concatenada de certificados, contendo certificados da CA intermediárias e da CA raiz
  • --precheckOnly especifica yes para só executar as pré-verificações desta operação. Valores válidos: yes ou no.
  • --serverCert especifica o caminho do certificado PEM a ser usado ou alternado para a configuração TCPS.
  • --privateKey especifica o caminho do arquivo de chave privada do certificado.
  • --certType tipo do certificado a ser adicionado à wallet do Grid Infrastructure. Os valores aceitos são: SELF_SIGNED_CERT, CA_SIGNED_CERT ou PKCS12_CERT. Padrão: SELF_SIGNED_CERT
  • --privateKeyPasswordProtected especifica se a chave privada é protegida por senha ou não. Valores válidos: true ou false. Padrão: true.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli grid configureTCPS?

A: O comando dbaascli grid configureTCPS é usado para configurar o TCPS (Transport Layer Security) para o cluster existente em um ambiente Oracle Exadata.

P: Qual é o pré-requisito para executar o comando dbaascli grid configureTCPS?

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

P: O TCPS é ativado por padrão no Exadata Database Service em sistemas de Infraestrutura Dedicada?

R: Sim, o TCPS é ativado por padrão para bancos de dados em sistemas Oracle Exadata Database Service on Dedicated Infrastructure.

P: O TCPS é ativado por padrão nos sistemas Exadata Database Service on Cloud@Customer?

R: Não, o TCPS não é ativado por padrão nos sistemas Exadata Database Service on Cloud@Customer. Para ativar o TCPS, atualize o arquivo sqlnet.ora do banco de dados específico e reinicie o banco de dados.

P: Qual é a consequência de ativar o TCPS nos sistemas Exadata Cloud@Customer?

R: A ativação do TCPS nos sistemas Exadata Cloud@Customer fará com que as conexões do Zero Data Loss Recovery Appliance (ZDLRA) falhem. Você só pode ativar a configuração ZDLRA ou TCPS, mas não ambos simultaneamente.

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

A: A opção --pkcs12WalletFilePath especifica o caminho absoluto para o arquivo de certificado no formato de wallet PKCS12, que é usado para configuração do TCPS.

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

A: A opção --caCertChain especifica uma lista concatenada de certificados contendo certificados de CA intermediária e o certificado de CA raiz.

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

A: A opção --precheckOnly especifica se apenas as pré-verificações devem ser executadas para a operação de configuração do TCPS. Os valores aceitos são yes ou no.

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

A: A opção --serverCert especifica o caminho para o certificado PEM que será usado ou girado para a configuração TCPS.

P: Como especificar a chave privada para a configuração do TCPS?

A: Use a opção --privateKey para especificar o caminho para o arquivo de chave privada associado ao certificado do servidor.

P: Quais são os valores aceitos para a opção --certType?

A: Os valores aceitos para a opção --certType são:

SELF_SIGNED_CERT

CA_SIGNED_CERT

PKCS12_CERT

O valor padrão é SELF_SIGNED_CERT.

P: A senha da chave privada é protegida por padrão?

R: Sim, a opção --privateKeyPasswordProtected é definida como true por padrão, indicando que a chave privada é protegida por senha. Você poderá defini-la como false se a chave privada não for protegida por senha.

P: Posso executar uma pré-verificação antes de configurar o TCPS?

R: Sim, você pode executar somente as pré-verificações da operação definindo a opção --precheckOnly como sim. Isso ajuda a validar o ambiente antes de fazer alterações.

P: O que acontece se eu fornecer um caminho incorreto para o arquivo da wallet PKCS12?

R: Se --pkcs12WalletFilePath contiver um caminho incorreto, o comando falhará e a configuração do TCPS não prosseguirá.

P: O que devo fazer se a chave privada estiver protegida por senha?

R: Se a chave privada for protegida por senha, certifique-se de que a opção --privateKeyPasswordProtected esteja definida como true (que é o padrão).

P: Posso especificar meu próprio certificado assinado pela CA para a configuração do TCPS?

R: Sim, você pode especificar seu próprio certificado assinado pela CA usando as opções --serverCert e --privateKey e definindo --certType como CA_SIGNED_CERT.

P: O que é um exemplo de comando para configurar o TCPS usando um certificado autoassinado?

A: Este é um exemplo:

dbaascli grid configureTCPS --serverCert /path/to/self_signed_cert.pem --privateKey /path/to/private_key.pem --certType SELF_SIGNED_CERT

P: Posso usar um certificado PKCS12 para configuração do TCPS?

R: Sim, você pode usar um certificado PKCS12 especificando a opção --pkcs12WalletFilePath e definindo --certType como PKCS12_CERT.

P: O que devo verificar antes de executar o comando dbaascli grid configureTCPS?

R: Verifique se você tem os arquivos de certificado corretos, arquivos de chave privada e se você está conectado como usuário raiz. Além disso, certifique-se de entender as implicações se estiver usando o ZDLRA, pois ele não pode ser executado simultaneamente com o TCPS.

Exemplo 7-27 dbaascli grid configureTCPS

Para configurar a grade usando o certificado autoassinado:
dbaascli grid configureTCPS
Para configurar a grade usando o certificado assinado pela CA:
dbaascli grid configureTCPS --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --private_key_password_protected false
dbaascli grid removeTCPSCert

Para remover certificados TCPS existentes da wallet do Grid Infrastructure, use o comando dbaascli grid removeTCPSCert.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli grid removeTCPSCert --subject <value>
 {
   --userCert | --trustedCert | --requestedCert
 }
 [--serialNumber <value>] [--executePrereqs] [--resume [--sessionID <value>]] [--bounceListeners]
Em que:
  • --subject especifica o assunto do certificado
  • Flag --userCert para indicar o certificado do usuário
  • Flag --trustedCert para indicar um certificado confiável
  • flag --requestedCert para indicar um certificado solicitado
  • --serialNumber especifica o número de série do certificado
  • --executePrereqs executa as verificações de pré-requisito e reporta os resultados
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • Flag --bounceListeners para devolver o listener do Grid Infrastructure e verificar o listener

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli grid removeTCPSCert?

R: O comando dbaascli grid removeTCPSCert é usado para remover certificados TCPS existentes da wallet do Grid Infrastructure em um ambiente Oracle Exadata.

P: Qual é o pré-requisito para executar o comando dbaascli grid removeTCPSCert?

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

P: O que a opção --subject especifica no comando dbaascli grid removeTCPSCert?

A: A opção --subject especifica o assunto do certificado a ser removido da wallet do Grid Infrastructure.

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

R: O flag --userCert indica que o certificado a ser removido é um certificado do usuário.

P: Quando devo usar o flag --trustedCert?

A: Use o flag --trustedCert ao remover um certificado confiável da wallet do Grid Infrastructure.

P: O que o flag --requestedCert faz?

A: O flag --requestedCert indica que o certificado que está sendo removido é um certificado solicitado.

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

A: A opção --serialNumber especifica o número de série do certificado a ser removido. É útil para identificar exclusivamente um certificado quando há vários certificados com o mesmo assunto.

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

A: A opção --executePrereqs executa verificações de pré-requisitos antes de remover o certificado e reporta os resultados, garantindo que o ambiente esteja devidamente preparado para a operação.

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

A: A opção --resume retoma a operação de remoção se ela tiver sido interrompida anteriormente.

P: Como especificar um ID de sessão ao retomar uma operação interrompida?

R: Use a opção --sessionID para especificar o ID da sessão da operação interrompida que você deseja retomar.

P: O que o flag --bounceListeners faz?

R: O flag --bounceListeners é usado para reiniciar o listener do Grid Infrastructure e verificar o listener após a remoção do certificado TCPS.

P: Posso remover um certificado TCPS sem devolver os listeners?

R: Sim, o flag --bounceListeners é opcional. Se você não especificá-lo, os listeners não serão devolvidos automaticamente.

Q: Como posso garantir que a operação será executada com segurança?

R: Você pode usar a opção --executePrereqs para executar verificações de pré-requisitos antes de executar o comando, garantindo que tudo esteja em ordem antes do processo de remoção.

P: O que devo fazer se precisar remover um certificado de usuário específico por número de série?

A: Use a opção --subject para especificar o assunto do certificado, o flag --userCert para indicar que ele é um certificado do usuário e a opção --serialNumber para especificar o número de série do certificado.

P: Posso remover vários certificados de uma só vez?

R: Não, o comando é projetado para remover um único certificado de cada vez com base no assunto fornecido e em outros parâmetros.

P: O que acontece se o processo de remoção do certificado for interrompido?

R: Você pode retomar a operação usando a opção --resume junto com o --sessionID do processo interrompido.

P: Preciso executar o comando como usuário raiz?

R: Sim, o comando dbaascli grid removeTCPSCert deve ser executado como o usuário root para ter os privilégios necessários para remover certificados TCPS.

P: Como posso identificar o certificado que quero remover?

R: Você pode identificar o certificado pelo seu assunto e, opcionalmente, pelo seu número de série para garantir que você está direcionando o certificado correto para remoção.

P: O que é um exemplo de comando para remover um certificado confiável?

A: Aqui está um exemplo:

dbaascli grid removeTCPSCert --subject "CN=example_cert" --trustedCert

dbaascli grid rotateTCPSCert

Para alternar certificados TCPS, use o comando dbaascli grid rotateTCPSCert.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli grid rotateTCPSCert
[--pkcs12WalletFilePath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Em que:
  • --pkcs12WalletFilePath especifica o caminho absoluto do arquivo de certificado, que está no formato de wallet pkcs12
  • --caCertChain lista concatenada de certificados, contendo certificados da CA intermediárias e da CA raiz
  • --precheckOnly especifica yes para só executar as pré-verificações desta operação. Valores válidos: yes ou no.
  • --serverCert especifica o caminho do certificado PEM a ser usado ou alternado para a configuração TCPS.
  • --privateKey especifica o caminho do arquivo de chave privada do certificado.
  • --certType tipo do certificado a ser adicionado à wallet do Grid Infrastructure. Os valores aceitos são: SELF_SIGNED_CERT, CA_SIGNED_CERT ou PKCS12_CERT. Padrão: SELF_SIGNED_CERT
  • --privateKeyPasswordProtected especifica se a chave privada é protegida por senha ou não. Valores válidos: true ou false. Padrão: true.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli grid rotateTCPSCert?

R: O comando dbaascli grid rotateTCPSCert é usado para rotacionar certificados TCPS (Transport Layer Security Protocol) na wallet do Grid Infrastructure em ambientes Oracle Exadata.

P: Qual é o pré-requisito para executar o comando dbaascli grid rotateTCPSCert?

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

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

A: A opção --pkcs12WalletFilePath especifica o caminho absoluto para o arquivo de certificado no formato de wallet PKCS12 para a configuração do TCPS.

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

A: A opção --caCertChain especifica uma lista concatenada de certificados, incluindo CA intermediária e certificados de CA raiz, para a configuração TCPS.

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

R: A opção --precheckOnly permite executar pré-verificações sem fazer alterações reais. Os valores válidos são "yes" para executar somente as pré-verificações e "no" para prosseguir com a rotação.

P: Como a opção --serverCert é usada?

A: A opção --serverCert especifica o caminho para o certificado do servidor PEM (Privacy Enhanced Mail) que é usado ou rotacionado para a configuração do TCPS.

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

A: A opção --privateKey especifica o caminho para o arquivo de chave privada correspondente ao certificado do servidor usado para rotação TCPS.

P: Quais são os valores válidos para a opção --certType?

A: A opção --certType aceita os seguintes valores para especificar o tipo de certificado a ser adicionado à wallet do Grid Infrastructure:

SELF_SIGNED_CERT (padrão)

CA_SIGNED_CERT

PKCS12_CERT

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

A: A opção --privateKeyPasswordProtected indica se a chave privada é protegida por senha. Os valores válidos são true (padrão) e false

P: Posso executar o comando dbaascli grid rotateTCPSCert sem girar os certificados?

R: Sim, usando a opção sim --precheckOnly, você só pode executar as pré-verificações sem girar os certificados.

P: Qual é um exemplo de comando para rotacionar um certificado usando uma wallet PKCS12?

A: Aqui está um exemplo de comando:

dbaascli grid rotateTCPSCert --pkcs12WalletFilePath /path/to/wallet.p12 --certType PKCS12_CERT

P: Como rotaciono um certificado de servidor com uma cadeia de certificados assinada pela CA?

A: Use as opções --serverCert e --caCertChain, conforme mostrado abaixo:

dbaascli grid rotateTCPSCert --serverCert /path/to/serverCert.pem --caCertChain /path/to/caChain.pem

P: O que acontece se eu não especificar --privateKeyPasswordProtected?

A: Se você não especificar a opção --privateKeyPasswordProtected, o comando assumirá que a chave privada é protegida por senha (padrão: true).

Q: Posso girar um certificado autoassinado?

R: Sim, você pode rotacionar um certificado autoassinado usando a opção --certType SELF_SIGNED_CERT padrão ou especificando-a explicitamente.

P: Como posso rotacionar um certificado sem fornecer uma chave privada?

R: Para determinados tipos de certificado, como PKCS12, talvez você não precise fornecer um arquivo de chave privada separado, pois ele está incluído na wallet. No entanto, se uma chave privada for necessária, ela deverá ser fornecida usando a opção --privateKey.

P: E se eu quiser girar um certificado em segundo plano?

R: O comando dbaascli grid rotateTCPSCert não fornece uma opção explícita para execução em segundo plano. Você pode executar o comando diretamente em uma sessão em segundo plano (por exemplo, usando nohup ou ferramentas semelhantes).

P: Qual será o tipo de certificado padrão se não for especificado?

A: O tipo de certificado padrão é SELF_SIGNED_CERT.

Exemplo 7-28 dbaascli grid rotateTCPSCert

Para alternar o certificado usando o certificado autoassinado (opção padrão):
dbaascli grid rotateTCPSCert
Para alternar o certificado usando o certificado assinado pela CA:
dbaascli grid rotateTCPSCert --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --privateKeyPasswordProtected true
dbaascli grid upgrade

Para fazer upgrade do Oracle Grid Infrastrucure de uma versão principal para outra, use o comando dbaascli grid upgrade.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli grid upgrade --version
[--resume]
[--executePrereqs]
[--containerURL]
[--softwareOnly]
[--targetHome]
[--revert]
Em que:
  • --version especifica a versão de destino
  • --resume retoma a execução anterior
  • --executePrereqs executa pré-requisitos para upgrade do Grid Infrastrucure
  • --containerUrl especifica o URL personalizado para extrair a imagem do Grid Infrastrucure
  • --softwareOnly só instala o software do Grid Infrastructure
  • --targetHome especifica o caminho do home da Grade de destino existente
  • --revert reverte a execução com falha

Perguntas Frequentes

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

R: O comando dbaascli grid upgrade é usado para fazer upgrade do Oracle Grid Infrastructure de uma versão principal para outra em uma máquina virtual do Exadata Cloud@Customer.

P: Qual é o pré-requisito para executar o comando dbaascli grid upgrade?

R: O comando deve ser executado como o usuário root e você precisa estar conectado a uma máquina virtual do Exadata Cloud@Customer.

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

A: A opção --version especifica a versão de destino do Oracle Grid Infrastructure para a qual você deseja fazer upgrade.

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

A: A opção --resume retoma um processo de upgrade do Grid Infrastructure interrompido ou com falha anteriormente.

P: Como a opção --executePrereqs é usada?

A: A opção --executePrereqs executa apenas as verificações de pré-requisitos para o upgrade do Grid Infrastructure sem executar o upgrade real.

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

A: A opção --containerURL especifica um URL personalizado para extrair a imagem de software do Grid Infrastructure para o upgrade.

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

A: A opção --softwareOnly instala somente o software Grid Infrastructure sem configurar ou fazer upgrade do ambiente Grid.

P: Quando você usaria a opção --targetHome?

A: A opção --targetHome especifica o caminho para o Grid home de destino existente no qual o upgrade será executado.

P: O que acontece se o upgrade falhar?

R: Se o upgrade falhar, você poderá usar a opção --revert para fazer rollback do upgrade para seu estado anterior.

P: Posso executar um upgrade do Grid Infrastructure em estágios?

R: Sim, usando a opção --softwareOnly, você pode primeiro instalar o software e depois concluir o upgrade completo, permitindo upgrades preparados.

P: Como eu uso o comando dbaascli grid upgrade para fazer upgrade somente do software?

A: Use a seguinte sintaxe para fazer upgrade somente do software:

dbaascli grid upgrade --version <target_version> --softwareOnly

P: Posso verificar se há pré-requisitos de upgrade sem executar o upgrade?

R: Sim, você só pode executar as verificações de pré-requisitos usando:

dbaascli grid upgrade --version <target_version> --executePrereqs

P: Como posso fazer upgrade do Grid Infrastructure usando um URL de contêiner personalizado?

A: Você pode especificar o URL para extrair a imagem do Grid Infrastructure da seguinte forma:

dbaascli grid upgrade --version <target_version> --containerURL <custom_url>

P: Como posso retomar um processo de upgrade interrompido anteriormente?

A: Para retomar um upgrade interrompido ou com falha anteriormente, use:

dbaascli grid upgrade --version <target_version> --resume

P: O que a opção --revert faz no comando dbaascli grid upgrade?

A: A opção --revert faz rollback de um upgrade do Grid Infrastructure com falha ou interrompido para seu estado original.

P: Posso executar um upgrade completo sem configurar o Grid Infrastructure imediatamente?

R: Sim, você pode primeiro instalar apenas o software usando a opção --softwareOnly e depois configurá-lo posteriormente.

P: O que devo fazer se um upgrade falhar e eu quiser desfazer as alterações?

A: Use a opção --revert para fazer rollback do upgrade com falha:

dbaascli grid upgrade --version <target_version> --revert

Exemplo 7-29 dbaascli grid upgrade

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

Aplicação de Patch e Upgrade

Esta seção fornece ferramentas para atualizar e manter ambientes Oracle por meio de patches e atualizações. Ele inclui comandos como dbaascli grid patch para aplicar patch ao Oracle Grid Infrastructure, dbaascli dbHome patch para aplicar patches aos Oracle homes e dbaascli database move para mover bancos de dados entre homes durante upgrades ou processos de aplicação de patch. Esses comandos ajudam a garantir que os sistemas permaneçam seguros, estáveis e atualizados.

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

Perguntas Frequentes

P: O que o comando dbaascli grid patch faz?

A: O comando dbaascli grid patch é usado para aplicar patch no Oracle Grid Infrastructure para uma versão secundária especificada.

P: Preciso de permissões especiais para executar o comando dbaascli grid patch?

R: Sim, você precisa executar o comando dbaascli grid patch como o usuário root.

P: Posso especificar uma versão de destino ao aplicar patch ao Oracle Grid Infrastructure?

R: Sim, você pode especificar a versão de destino usando a opção --targetVersion.

P: Como especifico a versão de destino do patch?

R: Use a opção --targetVersion seguida do número da versão no formato 19.12.0.0.0.

P: O que a opção --containerURL faz no comando dbaascli grid patch?

A: A opção --containerURL permite especificar um URL personalizado para extrair a imagem do Grid Infrastructure.

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

A: A opção --executePrereqs é usada para executar verificações de pré-requisitos antes de aplicar o patch.

P: Como posso aplicar patch a um subconjunto de nós usando o comando dbaascli grid patch?

A: Use a opção --nodeList seguida de uma lista delimitada por vírgulas de nomes de nós para aplicar patch apenas a um subconjunto de nós.

P: O que acontece se eu usar a opção --rollback?

A: A opção --rollback fará rollback do Oracle home com patch para seu estado anterior.

P: Posso retomar uma sessão de aplicação de patch anterior?

R: Sim, você pode usar a opção --resume para retomar a última sessão de aplicação de patch. Se você tiver um ID de sessão específico, poderá especificá-lo com a opção --sessionID.

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

A: A opção --continueWithDbDowntime permite que você continue aplicando patches mesmo que haja tempo de inatividade do banco de dados, geralmente usado em ambientes em que há apenas uma instância ativa.

P: Como faço para criar uma imagem de um Grid home com patch?

A: Use a opção --createImage para criar uma imagem. Você pode especificar o diretório em que a imagem deve ser criada usando a opção --createImageDir.

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

A: A opção --imageFile permite especificar o caminho totalmente qualificado do arquivo de imagem a ser usado para aplicação de patches.

P: Como posso executar o comando dbaascli grid patch em segundo plano?

R: Você pode usar a opção --waitForCompletion definida como false para executar a operação em segundo plano.

P: Posso usar um URL personalizado para extrair a imagem do patch?

R: Sim, você pode usar a opção --containerURL para especificar um URL personalizado para extrair a imagem do Grid Infrastructure.

P: Como especifico quais nós aplicar patch se não quiser aplicar patch a todos eles?

R: Você pode especificar os nós que deseja aplicar patch usando a opção --nodeList com uma lista de nomes de nós separados por vírgulas.

P: O que devo fazer se precisar fazer rollback de um patch?

A: Use a opção --rollback no comando dbaascli grid patch para fazer rollback do patch.

P: Como lidar com uma operação de aplicação de patch se meu ambiente tiver apenas uma instância ativa e precisar continuar com o tempo de inatividade?

A: Use a opção --continueWithDbDowntime para continuar a aplicação de patch mesmo com o tempo de inatividade do banco de dados.

P: Posso criar uma imagem do Grid home corrigido?

R: Sim, você pode usar a opção --createImage para criar uma imagem do Grid home com patch. Se necessário, especifique o diretório em que a imagem deve ser salva usando --createImageDir.

P: O que devo fazer se quiser retomar uma sessão de aplicação de patches após uma interrupção?

A: Use a opção --resume para retomar a sessão de aplicação de patch. Se você souber o ID da sessão, poderá especificá-lo com --sessionID.

P: E se o processo de aplicação de patch falhar no meio do caminho?

R: Se o processo de aplicação de patch falhar, você poderá usar a opção --resume para reiniciar o processo. Você também pode usar a opção --rollback para reverter para o estado anterior.

P: Como posso garantir que todos os pré-requisitos sejam atendidos antes da aplicação de patch?

R: Use a opção --executePrereqs para executar todas as verificações de pré-requisitos antes de aplicar o patch.

Q: Posso executar a correção em segundo plano para evitar segurar o terminal?

R: Sim, você pode usar a opção --waitForCompletion false para executar o processo de aplicação de patch em segundo plano.

P: Como posso criar uma imagem do Grid home após a aplicação de patch?

A: Use a opção --createImage para criar uma nova imagem do Grid home com patch. Especifique o diretório usando --createImageDir, se necessário.

P: Como eu uso um arquivo de imagem existente para aplicação de patches?

R: Você pode usar a opção --imageFile para especificar o caminho totalmente qualificado para o arquivo de imagem que deseja usar para aplicação de patch.

P: O que devo fazer se quiser evitar o tempo de inatividade do banco de dados durante a aplicação de patches?

R: Certifique-se de que seu ambiente tenha mais de uma instância ativa em execução. Você pode evitar o uso da opção --continueWithDbDowntime, que se destina a ambientes com apenas uma instância ativa.

P: Como eu sei o progresso de um patch em execução em segundo plano?

R: Se você executar o patch com --waitForCompletion false, poderá verificar o status do job em segundo plano usando comandos do sistema operacional como ps ou verificar os logs localizados no Grid home.

P: É possível aplicar patch a uma versão principal superior usando o patch de grade dbaascli?

R: Não, dbaascli grid patch só permite aplicação de patch a uma versão secundária da versão principal atual. Para atualizações importantes, você precisará seguir um processo de atualização diferente.

P: Posso ignorar verificações de pré-requisitos específicas durante a aplicação de patch?

R: Não, quando você usar --executePrereqs, todas as verificações de pré-requisitos serão executadas. No entanto, você pode revisar os resultados das verificações de pré-requisitos e tratar manualmente quaisquer problemas antes de continuar.

P: O que devo fazer se o processo de correção estiver preso ou pendurado?

R: Se o processo de aplicação de patch não responder, você poderá interrompê-lo usando comandos do sistema operacional e retomá-lo usando a opção --resume. Se isso não funcionar, tente usar a opção --rollback para reverter o patch.

P: Posso automatizar o processo de aplicação de patches em vários clusters?

R: Sim, usando scripts que incluem o comando dbaascli grid patch com opções apropriadas, você pode automatizar a aplicação de patches em diferentes clusters.

P: Onde posso encontrar logs para o processo de aplicação de patch?

R: Em geral, os logs estão localizados no diretório de logs do Oracle Grid home ou no local padrão especificado durante a configuração. Você pode monitorar esses logs para obter detalhes sobre o processo de aplicação de patch.

P: É possível criar um processo de patch silencioso sem interação do usuário?

R: Sim, especificando todas as opções necessárias no comando e executando-o em segundo plano (--waitForCompletion false), você pode criar um processo de aplicação de patch não interativo.

P: Posso verificar se há atualizações de patch disponíveis antes de aplicar um patch?

R: O próprio comando dbaascli grid patch não tem uma opção para listar patches disponíveis. No entanto, você pode usar os métodos padrão da Oracle, como o Suporte Técnico da Oracle, para identificar os patches mais recentes.

P: Posso usar dbaascli para aplicar patch a vários Oracle Homes?

R: Não, o comando dbaascli grid patch foi projetado para aplicar patch a um home específico do Oracle Grid Infrastructure de cada vez. Você precisaria executar o comando separadamente para cada home.

P: Existe uma maneira de evitar completamente o tempo de inatividade ao aplicar patch ao Grid Infrastructure?

R: Para minimizar o tempo de inatividade, certifique-se de que seu ambiente tenha várias instâncias de banco de dados ativas (configuração RAC) para que a aplicação de patches possa ser feita nó por nó. A opção --continueWithDbDowntime não deve ser usada neste caso.

P: Como lidar com a aplicação de patches para ambientes RAC One Node?

R: Em ambientes RAC One Node, você precisa ser cauteloso com a opção --continueWithDbDowntime, pois pode haver apenas uma instância ativa. Revise a documentação da Oracle para obter diretrizes de aplicação de patches específicas para o RAC One Node.

P: Posso exibir o histórico de sessões de patches anteriores?

R: O utilitário dbaascli não fornece uma maneira direta de exibir o histórico da sessão. No entanto, os logs de sessões de aplicação de patch anteriores podem ser encontrados no diretório de logs do Grid home.

Exemplo de Casos de Uso

Exemplo 1: Aplicação Básica de Patches de Grade

dbaascli grid patch --targetVersion 19.12.0.0.0

Corrige o Oracle Grid Infrastructure para a versão 19.12.0.0.0.

Exemplo 2: Aplicação de Patch com um URL de Contêiner Personalizado

dbaascli grid patch --targetVersion 19.12.0.0.0 --containerURL https://example.com/custom/url

Corrige o Grid Infrastructure para a versão 19.12.0.0.0, usando um URL de contêiner personalizado para extrair a imagem do Grid Infrastructure.

Exemplo 3: Aplicação de Patch com Verificações de Pré-requisitos

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs

Corrige o Grid Infrastructure para a versão 19.12.0.0.0 após executar as verificações de pré-requisitos.

Exemplo 4: Aplicação de Patch em um Subconjunto de Nós

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2,node3

Corrige o Grid Infrastructure para a versão 19.12.0.0.0 nos nós especificados (node1, node2 e node3).

Exemplo 5: Fazendo Rollback do Patch

dbaascli grid patch --rollback

Faz rollback do último patch aplicado no Oracle Grid Infrastructure.

Exemplo 6: Retomando uma Operação de Patch Anterior

dbaascli grid patch --resume

Retoma a operação de aplicação de patch anterior de onde ela foi interrompida.

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

dbaascli grid patch --resume --sessionID 12345

Retoma a operação de aplicação de patch usando o ID de sessão 12345.

Exemplo 8: Aplicação de Patch com Tempo de Inatividade do Banco de Dados Permitida

dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime

Corrige o Grid Infrastructure para a versão 19.12.0.0.0, permitindo o tempo de inatividade do banco de dados, se necessário.

Exemplo 9: Criando uma Imagem com Patch

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir

Cria uma imagem do Grid home com patch (versão 19.12.0.0.0) e a armazena no diretório especificado.

Exemplo 10: Usando um Arquivo de Imagem Existente

dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /path/to/image/file.zip

Corrige o Grid Infrastructure para a versão 19.12.0.0.0 usando um arquivo de imagem existente localizado em /path/to/image/file.zip.

Exemplo 11: Executando a Operação de Aplicação de Patch em Segundo Plano

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false

Corrige o Grid Infrastructure para a versão 19.12.0.0.0 e executa a operação em segundo plano.

Exemplo 12: Combinação de Pré-requisitos, URL Personalizado e Subconjunto de Nós

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --containerURL https://example.com/custom/url --nodeList node1,node2

Aplica o Grid Infrastructure à versão 19.12.0.0.0, executa verificações de pré-requisitos, usa um URL personalizado para a imagem e aplica o patch apenas em node1 e node2.

Exemplo 13: Criando uma Imagem com Patch com um Arquivo de Imagem Existente

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir --imageFile /path/to/existing/image.zip

Cria uma imagem corrigida e a armazena no diretório especificado ao usar um arquivo de imagem existente para o patch.

Exemplo 14: Verificando Pré-requisitos sem Aplicação de Patch

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs

Verifica se todos os pré-requisitos foram atendidos para aplicação de patch na versão 19.12.0.0.0 sem realmente aplicar o patch.

Exemplo 15: Executando Patch e Ignorando Falhas de Pré-requisito

dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime --executePrereqs

Executa o patch mesmo que algumas verificações de pré-requisitos falhem. Isso é útil em cenários em que o tempo de inatividade é permitido e determinados pré-requisitos podem ser ignorados.

Exemplo 16: Verificando Problemas nos Logs de Patch

tail -f /u01/app/grid/logs/grid_patch.log

Monitora o log de patch em tempo real para diagnosticar quaisquer problemas durante o processo de aplicação de patch.

Exemplo 17: Aplicando o Patch em um Ambiente Paralelo

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2 --waitForCompletion false

Corrige o Grid Infrastructure em um subconjunto de nós (node1 e node2) e executa o processo em segundo plano.

Exemplo 18: Usando um Arquivo de Imagem Específico de uma Origem Externa

dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /mnt/images/grid_patch_19.12.zip

Corrige o Grid Infrastructure usando um arquivo de imagem pré-download localizado em um dispositivo de armazenamento externo.

Exemplo 19: Executando Patch com um ID de Sessão Personalizado

dbaascli grid patch --targetVersion 19.12.0.0.0 --resume --sessionID 67890

Retoma uma operação de aplicação de patch que foi interrompida, usando o ID de sessão 67890.

Exemplo 20: Programando a Aplicação de Patches para Execução Posterior

echo "dbaascli grid patch --targetVersion 19.12.0.0.0" | at 02:00

Programa o comando de aplicação de patch para ser executado às 2:00 AM usando o comando at no Linux.

Exemplo 21: Especificando o Tempo Limite para Conclusão

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion true --continueWithDbDowntime --timeout 7200

Corrige o Grid Infrastructure enquanto permite tempo de inatividade, mas aguarda até 7200 segundos (2 horas) para conclusão antes do timeout.

Exemplo 22: Criando uma Imagem Personalizada para Outro Ambiente

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /backups/images/grid_patch

Cria uma imagem personalizada do Grid Infrastructure com patch para armazenar no diretório /backups/images/grid_patch para uso em outros ambientes.

Exemplo 23: Recuperação de Patch Após a Interrupção

dbaascli grid patch --resume --continueWithDbDowntime

Recupera e retoma o processo de aplicação de patches se ele tiver sido interrompido, com tempo de inatividade do banco de dados permitido.

Exemplo 24: Combinando a Verificação de Pré-requisitos com a Execução em Segundo Plano

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --waitForCompletion false

Verifica pré-requisitos e executa o patch em segundo plano.

Exemplo 25: Ignorando a Criação de Imagem para Aplicação de Patch Mais Rápida

dbaascli grid patch --targetVersion 19.12.0.0.0 --patchInParallel --continueWithDbDowntime --waitForCompletion false

Corrige o Grid Infrastructure para a versão 19.12.0.0.0 em paralelo entre nós, com tempo de inatividade do banco de dados permitido e sem criar uma imagem para acelerar o processo.

Exemplo 26: Monitorando o Andamento do Patch por meio de Logs

tail -f /u01/app/grid/logs/grid_patch_progress.log

Monitora o arquivo de log para o progresso da aplicação de patches em tempo real, fornecendo insights sobre cada etapa do processo de aplicação de patches.

Exemplo 27: Aplicação de Patches com Timeout de Drenagem Personalizado

dbaascli grid patch --targetVersion 19.12.0.0.0 --drainTimeoutInSeconds 3600 --continueWithDbDowntime

Corrige o Grid Infrastructure e define um timeout personalizado de 1 hora (3600 segundos) para permitir a drenagem normal de recursos durante o tempo de inatividade do banco de dados.

Exemplo 28: Aplicando um Patch a Nós Específicos com Verificações de Pré-requisito

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node4 --executePrereqs

Corrige apenas os nós node1 e node4 para a versão 19.12.0.0.0 e executa as verificações de pré-requisitos antecipadamente.

Exemplo 29: Aplicação de Patch sem Aguardar Conclusão

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false

Começa a aplicar patch no Grid Infrastructure para a versão 19.12.0.0.0 em segundo plano, permitindo que outras tarefas sejam executadas sem aguardar a conclusão do processo.

Exemplo 30: Reaplicando um Patch com Falha Após um Problema de Timeout de Drenagem

dbaascli grid patch --resume --drainTimeoutInSeconds 7200

Retoma a sessão de aplicação de patch anterior e estende o timeout de drenagem do recurso para 2 horas (7200 segundos), caso ele falhe devido ao tempo insuficiente na tentativa anterior.

Exemplo 31: Exibindo Logs de Patch em Tempo Real com ID de Sessão Específico

tail -f /u01/app/grid/logs/grid_patch_12345.log

Monitora o arquivo de log da sessão de aplicação de patch com o ID de sessão 12345 em tempo real.

Exemplo 32: Aplicação de Patch em um Novo Home de Destino

dbaascli grid patch --targetHome /u01/app/grid_home_19c --executePrereqs

Executa um patch fora do local para um novo home do Oracle Grid localizado em /u01/app/grid_home_19c, com verificações de pré-requisitos.

Exemplo 33: Interrompendo um Job de Patch em Segundo Plano

ps -ef | grep dbaascli | grep patch | awk '{print $2}' | xargs kill -9

Interrompe um job de patch em segundo plano localizando e eliminando o ID do processo associado (PID).

Exemplo 34: Verificando a Conclusão de Patches sem Logs

dbaascli grid status --targetVersion 19.12.0.0.0

Verifica se o patch para a versão 19.12.0.0.0 foi aplicado com sucesso verificando o status da versão atual do Grid Infrastructure.

dbaascli 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>]
Em que:
  • --oracleHome especifica o caminho do Oracle home
  • --oracleHomeName especifica o nome do Oracle home
  • --targetVersion especifica a versão de destino do Oracle Home definida como cinco segmentos numéricos separados por pontos, por exemplo, 19.12.0.0.0
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --continueWithDbDowntime continua aplicando patch com tempo de inatividade do banco de dados. Essa opção pode ser usada em ambientes nos quais só há uma instância ativa e a operação de aplicação de patch pode continuar mesmo com um tempo de inatividade.
  • --skipUnreachableNodes ignora a operação em nós inacessíveis
  • --nodes especifica uma lista de nós delimitados por vírgulas se a aplicação de patch tiver que ser executada em um subconjunto de nós
  • --executePrereqs executa pré-requisitos
  • --skipDatapatch ignora a execução de datapatch nos bancos de dados
  • --imageFilePath especifica o caminho absoluto do arquivo de imagem a ser usado
  • --skipPDBs ignora a execução do datapatch em uma lista especificada de PDBs delimitados por vírgulas. Por exemplo: cdb1:pdb1,cdb2:pdb2 e assim por diante
  • --skipClosedPdbs ignora a execução de datapatch em PDBs fechados
  • --rollback faz rollback do Oracle home que recebeu patch.
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos : true|false
  • --drainTimeoutInSeconds especifica o tempo (em segundos) para concluir a descarga de recursos enquanto o banco de dados é interrompido
  • --skipUnreachableNodes ignora a operação em nós inacessíveis

Perguntas Frequentes

P: Para que é usado o comando de patch dbaascli dbHome?

A: O comando dbaascli dbHome patch é usado para aplicar patch no Oracle home de um nível de patch para outro.

P: Preciso de permissões especiais para executar o comando de patch dbaascli dbHome?

R: Sim, você precisa executar o comando como usuário root.

P: Como especifico o caminho ou o nome do Oracle home para o patch?

A: Use a opção --oracleHome para especificar o caminho do Oracle home ou --oracleHomeName para especificar o nome do Oracle home.

P: Como posso definir a versão de destino do patch?

R: Use a opção --targetVersion seguida do número da versão no formato 19.12.0.0.0.

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

A: A opção --resume permite retomar uma sessão de aplicação de patch anterior.

P: Como especificar um ID de sessão específico ao retomar um patch?

R: Use a opção --sessionID para especificar o ID da sessão de aplicação de patch que você deseja retomar.

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

A: A opção --continueWithDbDowntime permite que a aplicação de patch continue mesmo que haja tempo de inatividade do banco de dados, útil em ambientes com apenas uma instância ativa.

P: Como posso ignorar a aplicação de patch em nós inacessíveis?

A: Use a opção --skipUnreachableNodes para ignorar operações em nós inacessíveis.

P: Como aplicar patch apenas a nós específicos em um cluster?

A: Use a opção --nodes seguida de uma lista delimitada por vírgulas de nomes de nós para aplicar patch a um subconjunto de nós.

P: Para que serve a opção --executePrereqs?

A: A opção --executePrereqs executa verificações de pré-requisitos antes de aplicar o patch.

P: Como posso ignorar a execução do datapatch nos bancos de dados?

A: Use a opção --skipDatapatch para ignorar o processo datapatch durante a aplicação de patch.

P: Posso especificar um local personalizado para a imagem do banco de dados?

R: Sim, use a opção --imageLocation para especificar um local personalizado para a imagem do banco de dados.

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

A: A opção --skipPDBs permite ignorar a execução do datapatch em uma lista especificada de bancos de dados plugáveis (PDBs) delimitados por vírgulas.

P: Como posso ignorar o datapatch em PDBs fechados?

A: Use a opção --skipClosedPDBs para ignorar o datapatch em PDBs fechados.

P: O que acontece se eu usar a opção --rollback?

A: A opção --rollback reverterá o Oracle home para seu estado anterior antes que o patch seja aplicado.

P: Como especifico o caminho do Oracle home para aplicação de patch?

A: Use a opção --oracleHome seguida pelo caminho para o diretório do Oracle home.

P: Como posso aplicar patch a um Oracle home pelo nome dele, e não pelo caminho?

A: Use a opção --oracleHomeName seguida pelo nome do Oracle home.

P: Como retomo uma operação de aplicação de patch se ela foi interrompida?

A: Use a opção --resume junto com a opção --sessionID para retomar uma sessão interrompida específica.

P: Posso continuar o processo de aplicação de patch se o banco de dados estiver inativo?

R: Sim, use a opção --continueWithDbDowntime para continuar a aplicação de patch, mesmo que o banco de dados esteja inativo.

P: O que devo fazer se alguns nós estiverem inacessíveis durante o processo de aplicação de patch?

A: Use a opção --skipUnreachableNodes para ignorar os nós inacessíveis.

P: Como posso aplicar o patch apenas a determinados nós?

A: Especifique os nós que você deseja aplicar patch usando a opção --nodes com uma lista de nomes de nós separados por vírgulas.

P: Como verifico os pré-requisitos antes de aplicar o patch?

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

P: O que devo fazer se quiser evitar a aplicação do datapatch durante o processo de aplicação de patch?

A: Use a opção --skipDatapatch para ignorar a etapa datapatch.

P: Como posso especificar um local diferente para a imagem do banco de dados usada no processo de aplicação de patch?

A: Use a opção --imageLocation para especificar um local personalizado para a imagem.

P: E se eu precisar ignorar o datapatch em determinados PDBs?

A: Use a opção --skipPDBs para ignorar o datapatch em uma lista especificada de PDBs delimitados por vírgulas.

P: Posso ignorar o datapatch em PDBs que não estão abertos no momento?

R: Sim, use a opção --skipClosedPDBs para ignorar o datapatch em PDBs fechados.

P: O que devo fazer se a correção falhar no meio do caminho?

R: Você pode usar a opção --rollback para reverter para o estado anterior ou tentar retomar o processo de correção com a opção --resume.

P: Como posso verificar se todos os pré-requisitos foram atendidos antes de aplicar o patch?

R: Execute o comando de patch com a opção --executePrereqs para garantir que todos os pré-requisitos sejam atendidos.

P: E se a operação de aplicação de patch não for concluída com sucesso e eu precisar tentar novamente?

A: Use a opção --resume para repetir a operação de aplicação de patch de onde ela parou. Se necessário, você pode especificar um --sessionID para retomar uma sessão específica.

P: Como posso verificar se o patch foi aplicado com sucesso?

R: Você pode verificar o processo de aplicação de patch verificando a versão do Oracle home usando o comando opatch lsinventory após a conclusão do patch.

P: Posso executar o comando de aplicação de patches em um modo dryrun para visualizar ações?

R: Não, o comando dbaascli dbHome patch não tem um recurso de dryrun. No entanto, você pode usar a opção --executePrereqs para executar verificações de pré-requisitos antes de realmente aplicar o patch.

P: É possível aplicar vários patches em uma única execução?

A: O comando dbaascli dbHome patch só permite uma versão de destino por vez. Você precisaria executar o comando separadamente para cada versão do patch.

P: Como tratar a aplicação de patches se o ambiente usar vários Oracle homes?

R: Você pode especificar o Oracle home ao qual deseja aplicar patch usando as opções --oracleHome ou --oracleHomeName, dependendo se você está especificando o caminho ou o nome do Oracle home.

P: Posso ignorar o datapatch do PDB e do CDB em um comando?

R: Sim, você pode combinar as opções --skipPDBs e --skipDatapatch para ignorar o patch de dados para PDBs e CDB em uma única execução de patch.

P: Posso aplicar um patch e fazer rollback imediatamente se ele causar problemas?

R: Sim, depois de aplicar um patch, você pode usar a opção --rollback para reverter para o nível de patch anterior se houver algum problema.

P: Posso aplicar patch a vários Oracle homes simultaneamente?

R: Não, você precisa executar o comando dbaascli dbHome patch individualmente para cada Oracle home.

P: Como posso rastrear o andamento da operação de aplicação de patch?

R: Durante o processo de aplicação de patches, o comando fornece mensagens de saída que mostram o andamento. Você também pode verificar os arquivos de log para obter informações detalhadas.

P: Posso executar a aplicação de patches em paralelo em um ambiente clusterizado?

R: As operações de aplicação de patch podem ser aplicadas a um subconjunto de nós usando a opção --nodes. No entanto, a aplicação simultânea de patches deve ser tratada com cuidado e você deve garantir que não haja sessões sobrepostas.

P: Como posso identificar quais patches estão disponíveis para meu Oracle home?

R: Você pode verificar os patches disponíveis por meio do portal de suporte da Oracle ou executando o comando opatch lsinventory para ver os patches atuais aplicados ao Oracle home.

P: Posso especificar um timeout para drenar recursos ao interromper o banco de dados durante a aplicação de patch?

R: Sim, você pode usar a opção --drainTimeoutInSeconds para especificar o tempo em segundos para drenagem de recursos ao interromper o banco de dados.

P: O que acontece se o patch falhar em um dos nós em um ambiente com vários nós?

R: Você pode usar a opção --skipUnreachableNodes para ignorar o nó com falha e continuar o processo de aplicação de patch nos nós restantes. Em seguida, você pode resolver o problema no nó com falha separadamente.

P: Como posso fazer com que o processo de aplicação de patches seja executado em segundo plano?

A: Use a opção --waitForCompletion com um valor de false para permitir que o processo de aplicação de patch seja executado em segundo plano. Dessa forma, você não precisa esperar que o processo seja concluído de forma interativa.

P: Posso executar uma operação de rollback em um subconjunto de nós em um ambiente clusterizado?

R: Sim, você pode usar a opção --nodes junto com a opção --rollback para fazer rollback da aplicação de patch em um conjunto específico de nós.

P: E se eu precisar atualizar a localização da imagem após iniciar o processo de patch?

A: A opção --resume não permite alterar o local da imagem. No entanto, você pode interromper a sessão e iniciar um novo processo de patch com o --imageLocation atualizado.

P: Existe uma maneira de verificar quais IDs de sessão estão disponíveis para retomar um patch?

R: Você pode verificar os arquivos de log ou usar as ferramentas do Oracle Cloud para identificar sessões de aplicação de patches ativas ou pausadas e seus IDs de sessão.

P: Posso limitar o tempo de inatividade durante a aplicação de patches?

R: Se você precisar limitar o tempo de inatividade, use a opção --continueWithDbDowntime com cuidado. Isso permite que você prossiga mesmo quando o tempo de inatividade for esperado, mas requer planejamento para um impacto mínimo no serviço.

Exemplo de Casos de Uso

Exemplo 1: Aplicação Básica de Patches do Oracle Home pelo Caminho do Oracle Home

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

Corrige o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1 para a versão 19.12.0.0.0.

Exemplo 2: Aplicação de Patch por Nome do Oracle Home

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0

Corrige o Oracle home chamado DB_HOME_NAME para a versão 19.12.0.0.0.

Exemplo 3: Retomando uma Operação de Patch Anterior

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --resume

Retoma a operação de aplicação de patch anterior para o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.

Exemplo 4: Retomando um Patch com um ID de Sessão Específico

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --resume --sessionID 12345

Retoma a operação de aplicação de patch do Oracle home DB_HOME_NAME usando o ID da sessão 12345.

Exemplo 5: Aplicação de Patch com Tempo de Inatividade do Banco de Dados Permitida

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --continueWithDbDowntime

Corrige o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1 para a versão 19.12.0.0.0, permitindo o tempo de inatividade do banco de dados.

Exemplo 6: Ignorando Nós Inacessíveis

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes

Corrige o Oracle home para a versão 19.12.0.0.0 ao ignorar qualquer nó inacessível.

Exemplo 7: Aplicando Patch a um Subconjunto de Nós

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --nodes node1,node2

Corrige o Oracle home para a versão 19.12.0.0.0 somente em node1 e node2.

Exemplo 8: Executando Verificações de Pré-requisitos Antes da Aplicação de Patch

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --executePrereqs

Corrige o Oracle home DB_HOME_NAME para a versão 19.12.0.0.0 após executar verificações de pré-requisitos.

Exemplo 9: Ignorando a Etapa Datapatch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch

Corrige o Oracle home para a versão 19.12.0.0.0 sem executar o datapatch nos bancos de dados.

Exemplo 10: Usando um Arquivo de Imagem para Aplicação de Patch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --imageFilePath /path/to/image/file.zip

Corrige o Oracle home para a versão 19.12.0.0.0 usando um arquivo de imagem localizado em /path/to/image/file.zip.

Exemplo 11: Ignorando PDBs Específicos Durante o Datapatch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2

Corrige o Oracle home para a versão 19.12.0.0.0 e ignora a execução de datapatch nos PDBs especificados (pdb1 em cdb1 e pdb2 em cdb2).

Exemplo 12: Ignorando o Datapatch em PDBs Fechados

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipClosedPDBs

Corrige o Oracle home para a versão 19.12.0.0.0 ao ignorar a execução do datapatch em qualquer PDB fechado.

Exemplo 13: Fazendo Rollback do Oracle Home

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback

Faz rollback do último patch aplicado no Oracle home chamado DB_HOME_NAME.

Exemplo 14: Combinação de Aplicação de Patch com Verificações de Pré-requisitos e Nós Específicos

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --executePrereqs --nodes node1,node2

Corrige o Oracle home para a versão 19.12.0.0.0, executa verificações de pré-requisitos e aplica o patch apenas em node1 e node2.

Exemplo 15: Ignorando Nós Inacessíveis e PDBs Específicos

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --skipUnreachableNodes --skipPDBs cdb1:pdb1

Corrige o Oracle home DB_HOME_NAME para a versão 19.12.0.0.0 enquanto ignora nós inacessíveis e evita a execução de datapatch em pdb1 em cdb1.

Exemplo 16: Verificando o Pós-Patch da Versão do Oracle Home

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

opatch lsinventory

Este exemplo mostra como verificar a versão do Oracle home após um patch bem-sucedido executando opatch lsinventory.

Exemplo 17: Fazendo Rollback de Patches com ID de Sessão Específica

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --sessionID 67890

Faz rollback da aplicação de patch do Oracle home para um ID de sessão de 67890.

Exemplo 18: Aplicação de Patch com Ignorando Verificações de Pré-requisitos

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPrereqs

Corrige o Oracle home, mas ignora as verificações de pré-requisitos antes de aplicar o patch.

Exemplo 19: Aplicando um Patch a uma Imagem Personalizada do Oracle Home

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --imageLocation /custom/location/image.zip

Corrige o Oracle home usando um arquivo de imagem personalizado localizado em /custom/location/image.zip.

Exemplo 20: Ignorando Nós Específicos e Executando Pré-requisitos

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes --executePrereqs

Ignora a aplicação de patches em nós inacessíveis e executa verificações de pré-requisitos antes de aplicar o patch.

Exemplo 21: Ignorando o Datapatch em Todos os PDBs em Vários CDBs

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2,cdb3:pdb3

Corrige o Oracle home, mas ignora o patch de dados nos PDBs especificados em vários CDBs.

Exemplo 22: Continuando a Aplicação de Patches com Tempo de Inatividade em Vários Nós

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --continueWithDbDowntime --nodes node3,node4

Continua a aplicação de patches em node3 e node4 com tempo de inatividade do banco de dados permitido.

Exemplo 23: Ignorando o Datapatch em PDBs e PDBs Fechados

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch --skipClosedPDBs

Corrige o Oracle home ao ignorar o patch de dados e os PDBs fechados.

Exemplo 24: Fazendo Rollback e Reaplicando Patch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

Faz rollback do patch atual e, em seguida, reaplica o patch ao Oracle home.

Exemplo 25: Ignorando o Datapatch e Permitindo Tempo de Inatividade em um Nó Específico

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipDatapatch --continueWithDbDowntime --nodes node1

Corrige o Oracle home para a versão 19.13.0.0.0 em node1, ignorando a etapa do datapatch e permitindo tempo de inatividade.

Exemplo 26: Especificando o Timeout de Drenagem Durante o Shutdown do Banco de Dados

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.13.0.0.0 --drainTimeoutInSeconds 300

Corrige o Oracle home DB_HOME_NAME para a versão 19.13.0.0.0 e permite um timeout de 5 minutos (300 segundos) para drenar recursos durante o shutdown.

Exemplo 27: Executando Patches em Segundo Plano

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --waitForCompletion false

Corrige o Oracle home para a versão 19.13.0.0.0 e executa o processo de aplicação de patch em segundo plano sem aguardar a conclusão.

Exemplo 28: Fazendo Rollback do Patch em um Subconjunto de Nós

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --nodes node1,node2

Faz rollback do último patch aplicado em node1 e node2 somente para o Oracle home especificado.

Exemplo 29: Ignorando Pré-requisitos e Aplicando Patches a Vários Nós

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipPrereqs --nodes node3,node4

Corrige o Oracle home para a versão 19.13.0.0.0 em node3 e node4 sem executar verificações de pré-requisitos.

Exemplo 30: Fazendo Rollback do Patch e Ignorando Nós Inacessíveis

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback --skipUnreachableNodes

Faz rollback do último patch no Oracle home DB_HOME_NAME e ignora nós inacessíveis durante o processo de rollback.

dbaascli database move

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

Pré-requisitos

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

Sintaxe

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

Em que:

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

Perguntas Frequentes

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

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

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

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

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

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

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

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

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

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

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

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

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

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

P: Como --sessionID é usado no comando?

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

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

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

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

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

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

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

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

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

P: O que --continueWithDbDowntime significa?

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

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

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

P: O que --waitForCompletion especifica?

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

P: Como eu uso o parâmetro --nodeList?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Exemplo de Casos de Uso

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

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

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

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

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Exemplo 8: Ignorando Datapatch

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

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

Exemplo 9: Ignorando PDBs Específicos Durante o Datapatch

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

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

Exemplo 10: Ignorando o Datapatch em PDBs Fechados

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

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

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

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

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

Exemplo 12: Movendo o Banco de Dados em Paralelo

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Exemplo 19: Ignorando o Datapatch para PDBs Específicos

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Diversos

P: Como posso ignorar a execução do catbundle ao aplicar patch ao Oracle Database 11.2.0.4.0?

R: Para ignorar a execução de catbundle durante o processo de aplicação de patch do Oracle Database, use a opção --skipDatapatch com o comando dbaascli database move ou dbaascli dbHome patch.

P: Quais são as melhores práticas a serem seguidas durante a aplicação de patches do Oracle Database?

R: A Oracle recomenda executar aplicação de patch fora do local usando o comando dbaascli database move para minimizar a janela de aplicação de patch.

A Oracle recomenda o uso da opção --allowParallelDBMove para ativar a aplicação de patches paralelos, o que poderá agilizar o processo.

P: Os avisos reportados durante os pré-requisitos de patch do Oracle Database podem ser ignorados?

R: É aconselhável abordar e resolver quaisquer avisos relatados durante a verificação de pré-requisitos antes de continuar com o processo de aplicação de patches. Ignorar avisos pode levar a problemas durante a aplicação de patch real.

P: Como posso continuar com a aplicação de patches do Oracle Database se apenas uma instância do banco de dados estiver ativa e em execução?

R: Recomenda-se ter pelo menos duas instâncias em execução para evitar o tempo de inatividade do banco de dados. Se não for possível executar duas instâncias, você poderá usar a opção --continueWithDbDowntime com o comando dbaascli database move ou dbaascli dbHome patch para continuar com a aplicação de patches apesar do tempo de inatividade.

P: Em um ambiente do Data Guard, o datapatch é executado nos bancos de dados principal e stand-by?

R: Não, em um ambiente Data Guard, o datapatch é executado apenas como parte do processo principal de aplicação de patches do banco de dados.

P: Atualizações de Software Provisórias (patches one-off) ou patches individuais podem ser aplicados manualmente em Oracle Homes em ambientes Exadata Cloud@Customer (ExaDB-C@C)?

R: Sim, patches one-off ou patches individuais podem ser aplicados manualmente aos Oracle Homes nos ambientes ExaDB-C@C. No entanto, é recomendável usar a opção Imagem de Software do Oracle Database para um processo de aplicação de patches mais simplificado e suportado.

P: Como aplico patch a vários bancos de dados Oracle em execução no mesmo Oracle Home quando cada banco de dados está em execução em apenas um nó?

R: Use o comando dbaascli dbHome patch para aplicar patch no Oracle Home especificado, que aplicará o patch a todos os bancos de dados em execução nesse home. Recomenda-se ter várias instâncias em execução para evitar tempo de inatividade. Se não for possível executar várias instâncias, você poderá usar a opção --continueWithDbDowntime para continuar com a aplicação de patches apesar do tempo de inatividade.

Gerenciamento de Banco de Dados Plugável (PDB)

Esta seção abrange o gerenciamento de Bancos de Dados Plugáveis (PDBs) em um banco de dados contêiner (CDB). Ele inclui comandos para criar (dbaascli pdb create), excluir (dbaascli pdb delete) e clonar PDBs (dbaascli pdb localClone, dbaascli pdb remoteClone). Você pode gerenciar estados do PDB com comandos para abrir, fechar ou devolver PDBs e recuperar detalhes da conexão (dbaascli pdb getConnectString). Comandos adicionais suportam backup, recuperação e realocação de PDBs, garantindo controle abrangente sobre o ciclo de vida e as operações do PDB.

dbaascli pdb backup

Para fazer backup de um banco de dados plugável (PDB), consultar backups de PDB e excluir um backup de PDB, use o comando dbaascli pdb backup.

Pré-Requisito

  • Execute o comando como usuário root.

Sintaxe

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

Perguntas Frequentes

P: Qual é a finalidade do comando de backup dbaascli pdb?

R: O comando dbaascli pdb backup é usado para criar backups para um banco de dados plugável (PDB), consultar o status do backup, gerar relatórios de backup e excluir backups do PDB em um ambiente Exadata Cloud@Customer.

P: Qual é o pré-requisito para usar o comando de backup dbaascli pdb?

R: O comando deve ser executado como o usuário root e você precisa estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: Como inicio um backup do PDB usando o comando de backup dbaascli PDB?

R: Você pode iniciar um backup do PDB usando a opção --start. Por exemplo:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start

P: Quais opções podem ser usadas com o sinalizador --start?

A: Com o flag --start, você pode especificar:

--level1 para um backup incremental de Nível 1

--archival para um backup de arquivamento completo (que também requer um --tag para especificar a tag de backup)

P: Como crio um backup de PDB incremental de Nível 1?

A: Use o flag --level1 com a opção --start para criar um backup incremental de Nível 1:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --level1

P: Como crio um backup de PDB de arquivamento?

A: Use o flag --archival com a opção --start e especifique uma tag de backup usando --tag:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --archival --tag <backup_tag>

P: Como excluo um backup específico do PDB?

A: Para excluir um backup específico, use o flag --delete e especifique a tag de backup usando --backupTag:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --delete --backupTag <backup_tag>

P: Como posso verificar o status de um backup do PDB?

A: Use o flag --status junto com o backup --uuid para verificar o status de um backup específico:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --status --uuid <backup_uuid>

P: Como recupero um relatório de backup do PDB no formato JSON?

A: Para obter um relatório de backup no formato JSON, use a opção --getBackupReport, especifique o nome do arquivo com --json e forneça a tag de backup com --tag:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --getBackupReport --json <file_name> --tag <backup_tag>

P: Como posso listar todos os backups do PDB para um PDB específico?

A: Use a opção --list para obter uma lista de todos os backups de um determinado PDB:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list

Opcionalmente, você pode gerar a lista no formato JSON usando o flag --json:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list --json <file_name>

P: O que a opção --pdbName faz?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) para o qual você deseja fazer backup, consultar ou excluir backups.

P: Qual é a finalidade da opção --dbname?

A: A opção --dbname especifica o nome do Oracle Database ao qual o PDB pertence.

P: Como especifico uma tag de backup para um backup do PDB?

A: Você especifica uma tag de backup usando a opção --tag ao iniciar um backup de arquivamento ou ao recuperar um relatório de backup:

--tag <backup_tag>

P: Posso executar backups de PDB no modo JSON?

R: Sim, as opções de relatório de backup (--getBackupReport) e listagem de backup (--list) suportam saída no formato JSON. Você especifica um nome de arquivo JSON usando a opção --json.

Exemplo 7-30 Exemplos

  • Para fazer backup level1 de um PDB pdb1 em um CDB myTestDb:
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --start --level1
  • Para consultar o status da solicitação de backup do PDB submetida com uuid eef16b26361411ecb13800163e8e4fac:
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --status --uuid eef16b26361411ecb13800163e8e4fac
dbaascli pdb bounce

Para devolver um banco de dados plugável (PDB), use o comando dbaascli pdb bounce.

Pré-Requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb bounce --dbname --pdbName | --pdbUID
[–openMode]
Em que:
  • --dbname especifica o nome do banco de dados contêiner que hospeda o PDB
  • --pdbName especifica o nome do PDB
  • --pdbUID especifica o identificador do PDB
  • --openMode especifica o destino OPEN MODE do PDB

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb bounce?

R: O comando dbaascli pdb bounce é usado para devolver (reiniciar) um banco de dados plugável (PDB) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli pdb bounce?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: Como faço para devolver um PDB especificando seu nome?

A: Para devolver um PDB especificando seu nome, use a seguinte sintaxe:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name>

P: Como faço para devolver um PDB usando seu identificador exclusivo (UID)?

A: Para devolver um PDB usando seu identificador exclusivo (UID), use a seguinte sintaxe:

dbaascli pdb bounce --dbname <CDB_Name> --pdbUID <PDB_UID>

P: Para que é usada a opção --dbname?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) que está sendo devolvido.

P: Para que é usada a opção --pdbName?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) que você deseja devolver.

P: Para que é usada a opção --pdbUID?

A: A opção --pdbUID especifica o identificador exclusivo (UID) do banco de dados plugável (PDB) que você deseja devolver.

P: Como especifico o modo de abertura do alvo para o PDB quando ele é devolvido?

R: Você pode usar a opção --openMode para especificar o modo de abertura desejado para o PDB após o bouncing. Os valores válidos são READ_WRITE e READ_ONLY. Por exemplo:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE

P: Posso abrir o PDB no modo somente leitura após devolvê-lo?

R: Sim, você pode usar a opção --openMode READ_ONLY para abrir o PDB no modo somente leitura após o bouncing:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_ONLY

P: Qual será o modo aberto padrão se --openMode não for especificado?

R: Se --openMode não for especificado, o PDB será aberto em seu modo de abertura padrão, que geralmente é READ_WRITE.

P: Posso usar --pdbName e --pdbUID no mesmo comando?

R: Não, você deve especificar --pdbName ou --pdbUID, mas não ambos no mesmo comando.

P: Como posso reiniciar um PDB e garantir que ele seja aberto no modo de leitura e gravação?

A: Para reiniciar um PDB e garantir que ele seja aberto no modo de leitura e gravação, use a opção --openMode READ_WRITE:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE

P: É obrigatório especificar o modo de abertura ao usar o comando dbaascli pdb bounce?

A: Não, especificar --openMode é opcional. Se não for fornecido, o PDB será aberto em seu modo padrão.

P: O que acontece se eu não especificar o flag --openMode?

R: Se o flag --openMode não for especificado, o PDB será aberto em seu modo padrão, que geralmente é READ_WRITE.

Exemplo 7-31 dbaascli pdb bounce

dbaascli pdb bounce --dbname cdb_name --pdbName pdb name associated with the CDB
dbaascli pdb bounce --dbname cdb_name --pdbUID con_uid of that pdb
Opcional:
  • --openMode READ_WRITE
  • --openMode READ_ONLY
dbaascli pdb close

Para fechar um banco de dados plugável (PDB), use o comando dbaascli pdb close.

Pré-Requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb close --dbname --pdbName | --pdbUID
Em que:
  • --dbname especifica o nome do banco de dados contêiner que hospeda o PDB.
  • --pdbname especifica o nome do PDB que você deseja fechar.
  • --pdbUID especifica o identificador do PDB

Após a conclusão bem-sucedida da execução desse comando, o PDB é fechado em todas as instâncias do banco de dados contêiner.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb close?

R: O comando dbaascli pdb close é usado para fechar um PDB (banco de dados plugável) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli pdb close?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: Como fecho um PDB especificando seu nome?

A: Para fechar um PDB especificando seu nome, use a seguinte sintaxe:

dbaascli pdb close --dbname <CDB_Name> --pdbName <PDB_Name>

P: Como fecho um PDB especificando seu identificador exclusivo (UID)?

A: Para fechar um PDB usando seu identificador exclusivo (UID), use a seguinte sintaxe:

dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>

P: O que a opção --dbname faz no comando dbaascli pdb close?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) que você deseja fechar.

P: O que a opção --pdbName faz no comando dbaascli pdb close?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) que você deseja fechar.

P: Qual é a finalidade da opção --pdbUID no comando dbaascli pdb close?

A: A opção --pdbUID permite especificar o identificador exclusivo (UID) do banco de dados plugável (PDB) que você deseja fechar.

P: Posso fechar o PDB em uma instância específica do CDB?

R: Não, após a conclusão bem-sucedida, o PDB é fechado em todas as instâncias do CDB (banco de dados contêiner).

P: É possível especificar --pdbName e --pdbUID no mesmo comando?

R: Não, você pode especificar --pdbName ou --pdbUID, mas não ambos no mesmo comando.

P: O que acontece quando o comando dbaascli pdb close é concluído com sucesso?

R: Quando o comando é concluído com sucesso, o banco de dados plugável (PDB) é fechado em todas as instâncias do banco de dados contêiner (CDB).

P: Como eu fecho um PDB específico em um CDB usando seu UID?

A: Você pode fechar um PDB específico usando seu UID executando:

dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>

P: O que acontece se eu esquecer de especificar --pdbName ou --pdbUID?

A: Você deve especificar --pdbName ou --pdbUID no comando. Se nenhum for fornecido, o comando não será executado.

P: Posso usar o comando dbaascli pdb close para um CDB diretamente?

R: Não, o comando é projetado para fechar um banco de dados plugável (PDB) dentro de um banco de dados contêiner (CDB), não o próprio CDB.

Exemplo 7-32 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 create

Para criar um novo banco de dados plugável (PDB), use o comando dbaascli pdb create.

Pré-Requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb create --pdbName <value> --dbName <value> 
[--maxCPU <value>] 
[--maxSize <value>] 
[--pdbAdminUserName <value>] 
[--lockPDBAdminAccount <value>] 
[--resume [--sessionID <value>]] 
[--executePrereqs <value>] 
[--waitForCompletion <value>] 
[--blobLocation |--standbyBlobFromPrimary <value>]
Em que:
  • --pdbName especifica o nome do novo PDB que você deseja criar
  • --dbName especifica o nome do banco de dados contêiner que hospeda o novo PDB
  • --maxCPU especifica opcionalmente o número máximo de CPUs que estão disponíveis ao PDB. A definição dessa opção é efetivamente o mesmo que definir o parâmetro CPU_COUNT no PDB
  • --maxSize especifica opcionalmente o tamanho total máximo dos arquivos de dados e temporários para tablespaces pertencentes ao PDB. A definição dessa opção é efetivamente o mesmo que definir a cláusula de armazenamento MAXSIZE PDB no comando SQL CREATE PLUGGABLE DATABASE. Você pode impor um limite especificando um número inteiro seguido de uma unidade de tamanho (K, M, G ou T) ou pode especificar UNLIMITED para não impor explicitamente qualquer limite
  • --pdbAdminUserName especifica o novo nome do usuário administrador do PDB
  • --lockPDBAdminAccount especifica true ou false para bloquear a conta de usuário administrador do PDB. O valor default é verdadeiro.
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --executePrereqs especifica yes para só executar os pré-requisitos desta operação. Valores válidos: yes ou no
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true ou false
  • --blobLocation - local de diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG.
  • --standbyBlobFromPrimary especifica o local do arquivo blob stand-by, que é preparado usando o banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by.
    Observe que

    os parâmetrosblobLocation e standbyBlobFromPrimary são mutuamente exclusivos.

Durante o processo de criação do PDB, você é solicitado a especificar a senha de administração do novo PDB.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb create?

R: O comando dbaascli pdb create é usado para criar um novo banco de dados plugável (PDB) em um banco de dados contêiner (CDB) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli pdb create?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: O que a opção --pdbName faz no comando dbaascli pdb create?

A: A opção --pdbName especifica o nome do novo banco de dados plugável (PDB) que você deseja criar.

P: O que a opção --dbName faz no comando dbaascli pdb create?

A: A opção --dbName especifica o nome do banco de dados contêiner (CDB) que hospedará o novo banco de dados plugável (PDB).

P: Posso limitar os recursos de CPU para o novo PDB?

R: Sim, você pode usar a opção --maxCPU para especificar o número máximo de CPUs que o PDB pode usar. Isso é equivalente a definir o parâmetro CPU_COUNT no PDB.

P: Como posso limitar o tamanho do armazenamento de um PDB?

R: Você pode usar a opção --maxSize para especificar o tamanho total máximo de arquivos de dados e arquivos temporários para o PDB. Você pode definir um limite de tamanho (em K, M, G ou T) ou especificar UNLIMITED sem limite.

P: Para que é usada a opção --pdbAdminUserName?

A: A opção --pdbAdminUserName especifica o nome do usuário administrador do novo PDB. Esse usuário terá privilégios administrativos no PDB.

P: É possível bloquear a conta do usuário administrador durante a criação do PDB?

R: Sim, você pode usar a opção --lockPDBAdminAccount para especificar se a conta de administrador do PDB deve ser bloqueada. O valor default é true (bloqueado).

P: O que a opção --resume faz no comando dbaascli pdb create?

A: A opção --resume permite retomar um processo de criação de PDB com falha anterior.

P: Como especificar um ID de sessão para retomar uma execução anterior?

R: Você pode especificar um ID de sessão usando a opção --sessionID para retomar uma sessão específica do processo de criação do PDB.

P: Qual é a finalidade da opção --executePrereqs?

A: A opção --executePrereqs especifica se apenas as verificações de pré-requisito devem ser executadas para a criação do PDB. Você pode definir essa opção como yes ou no.

P: Posso executar o processo de criação do PDB em segundo plano?

R: Sim, você pode usar a opção --waitForCompletion e defini-la como falsa para executar a operação em segundo plano.

P: Para que é usada a opção --standbyBlobFromPrimary?

A: A opção --standbyBlobFromPrimary especifica o local do arquivo blob stand-by, que é preparado no banco de dados principal. Isso é necessário para operações de PDB do banco de dados stand-by.

P: Como serei solicitado a informar a senha de administrador do PDB durante o processo de criação?

R: Durante o processo de criação do PDB, você será solicitado a especificar a senha de administração do novo PDB.

P: Posso criar um PDB stand-by usando o comando dbaascli PDB create?

R: Sim, se você estiver criando um PDB stand-by, poderá usar a opção --standbyBlobFromPrimary para especificar a localização do arquivo blob stand-by no banco de dados principal.

P: O que acontece se eu não usar a opção --maxSize?

R: Se você não especificar a opção --maxSize, o PDB não terá um limite de tamanho de armazenamento, a menos que seja definido de outra forma pelas políticas do CDB.

P: O que acontece se eu não fornecer a opção --pdbAdminUserName?

R: Se você não fornecer a opção --pdbAdminUserName, o PDB será criado sem um usuário administrador especificado e você precisará configurar manualmente o usuário administrador após a criação.

P: Posso retomar a criação de um PDB com falha em qualquer ponto do processo?

R: Sim, desde que a sessão não tenha sido encerrada, você poderá retomar a criação de um PDB com falha usando as opções --resume e --sessionID.

Exemplo 7-33 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 value]
[--waitForCompletion value]
[--resume [--sessionID value]]
[--allStandbyPrepared]
[--cleanupRelocatedPDB]
Em que:
  • --dbName especifica o nome do banco de dados contêiner que hospeda o PDB
  • --pdbName especifica o nome do PDB que você deseja excluir
  • --pdbUID especifica o UID do PDB que você deseja excluir
  • --executePrereqs especifica yes para só executar os pré-requisitos desta operação. Valores válidos: yes ou no
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true ou false
  • --resume especifica para retomar a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --allStandbyPrepared especifica para confirmar se a operação foi executada com sucesso em todos os bancos de dados stand-by
  • --cleanupRelocatedPDB - opção para limpar o banco de dados de origem após a realocação de um PDB.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb delete?

R: O comando dbaascli pdb delete é usado para excluir um banco de dados plugável (PDB) de um banco de dados contêiner (CDB) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para executar o comando dbaascli pdb delete?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: O que a opção --dbName especifica no comando dbaascli pdb delete?

A: A opção --dbName especifica o nome do banco de dados contêiner (CDB) que hospeda o PDB que você deseja excluir.

P: Como posso especificar qual PDB excluir usando o comando dbaascli PDB delete?

R: Você pode especificar o PDB a ser excluído usando a opção --pdbName (especifica o nome do PDB) ou a opção --pdbUID (especifica o UID do PDB).

P: Posso executar as verificações de pré-requisitos sem realmente excluir o PDB?

R: Sim, você pode usar a opção --executePrereqs e defini-la como yes para executar apenas as verificações de pré-requisitos da operação de exclusão do PDB.

P: Como posso executar o processo de exclusão do PDB em segundo plano?

A: Use a opção --waitForCompletion e defina-a como false para executar o processo de exclusão em segundo plano.

P: O que a opção --resume faz no comando dbaascli pdb delete?

A: A opção --resume permite retomar um processo de exclusão do PDB com falha anterior.

P: Como retomo uma sessão específica para exclusão de um PDB?

R: Você pode especificar um ID de sessão usando a opção --sessionID para retomar uma sessão específica para o processo de exclusão do PDB.

P: O que a opção --allStandbyPrepared faz?

A: A opção --allStandbyPrepared é usada para confirmar se a operação de exclusão foi executada com sucesso em todos os bancos de dados stand-by antes de prosseguir com a exclusão do PDB principal.

P: Qual é a finalidade da opção --cleanupRelocatedPDB?

A: A opção --cleanupRelocatedPDB limpa o banco de dados de origem depois que um PDB é realocado, garantindo que nenhum resíduo seja deixado após a realocação.

P: Posso excluir um PDB que já foi realocado?

R: Sim, você pode usar a opção --cleanupRelocatedPDB para excluir um PDB que já foi realocado para um novo CDB.

P: Como garantir que a operação de exclusão seja executada com sucesso em bancos de dados stand-by?

R: Use a opção --allStandbyPrepared para confirmar se a operação foi executada com sucesso em todos os bancos de dados stand-by antes de continuar.

P: O que acontece se o processo de exclusão falhar e precisar ser retomado?

R: Você pode retomar o processo de exclusão usando a opção --resume e, se necessário, especificar o ID da sessão com --sessionID.

P: O que a definição --waitForCompletion como falso faz?

R: A definição de --waitForCompletion como false permite que o processo de exclusão seja executado em segundo plano, permitindo que você continue trabalhando sem aguardar a conclusão da operação.

Exemplo: dbaascli pdb delete

Para excluir um PDB de um banco de dados padrão em um ambiente que não seja do Data Guard ou do banco de dados Stand-by no ambiente do Data Guard.

dbaascli pdb delete --dbName db721 --pdbName pdb1

Para criar o PDB do banco de dados Principal no ambiente do Data Guard:

dbaascli pdb create --dbName db721 --pdbName pdb1 --allStandbyPrepared
dbaascli pdb getConnectString

Para exibir informações da string de conexão do Oracle Net para um banco de dados plugável (PDB), execute o comando dbaascli pdb getConnectString.

Pré-Requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb getConnectString --dbname --pdbName | --pdbUID
Em que:
  • --dbname especifica o nome do banco de dados contêiner que hospeda o PDB
  • --pdbname especifica o nome do PDB cujas informações da string de conexão você deseja exibir
  • --pdbUID especifica o identificador do PDB

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb getConnectString?

R: O comando dbaascli pdb getConnectString é usado para exibir as informações da string de conexão do Oracle Net para um PDB (banco de dados plugável) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli pdb getConnectString?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: Como recupero a string de conexão de um PDB especificando seu nome?

A: Para recuperar a string de conexão especificando o nome do PDB, use a seguinte sintaxe:

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbName <PDB_Name>

P: Como recupero a string de conexão de um PDB especificando seu identificador exclusivo (UID)?

A: Para recuperar a string de conexão usando o identificador exclusivo (UID) do PDB, use a seguinte sintaxe:

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>

P: O que a opção --dbname faz no comando dbaascli pdb getConnectString?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) para o qual você deseja exibir as informações da string de conexão.

P: O que a opção --pdbName faz no comando dbaascli pdb getConnectString?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) para o qual você deseja recuperar as informações da string de conexão do Oracle Net.

P: Qual é a finalidade da opção --pdbUID no comando dbaascli pdb getConnectString?

A: A opção --pdbUID permite especificar o identificador exclusivo (UID) do banco de dados plugável (PDB) para o qual você deseja exibir a string de conexão.

P: Posso usar --pdbName e --pdbUID no mesmo comando?

R: Não, você pode usar --pdbName ou --pdbUID, mas não ambos no mesmo comando.

P: Que tipo de informação é retornado pelo comando dbaascli pdb getConnectString?

A: O comando retorna as informações da string de conexão do Oracle Net para o banco de dados plugável (PDB) especificado.

P: Posso recuperar a string de conexão de um PDB em uma instância de banco de dados contêiner específica?

R: Não, a string de conexão é para o PDB como um todo, não para uma instância específica do banco de dados contêiner.

P: Como posso obter as informações da string de conexão se souber apenas o identificador exclusivo (UID) do PDB?

A: Você pode recuperar a string de conexão usando o UID do PDB executando:

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>

P: O que acontece se eu não fornecer --pdbName ou --pdbUID?

A: Você deve especificar --pdbName ou --pdbUID para recuperar a string de conexão. O comando não será executado sem uma dessas opções.

P: As informações da string de conexão do PDB são sempre as mesmas em todas as instâncias do CDB?

R: Sim, as informações da string de conexão são consistentes para o PDB em todas as instâncias do banco de dados contêiner (CDB).

Exemplo 7-34 dbaascli pdb getConnectString

dbaascli pdb getConnectString --dbname dbname --pdbName pdbName
dbaascli pdb getDetails

Para exibir detalhes de um banco de dados plugável (PDB), use o comando dbaascli pdb getDetails.

Pré-Requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli pdb getDetails --dbname --pdbName | --pdbUID
Em que:
  • --dbname especifica o nome do banco de dados contêiner que hospeda o PDB
  • --pdbname especifica o nome do PDB que você deseja excluir
  • --pdbUID especifica o identificador do PDB

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb getDetails?

R: O comando dbaascli pdb getDetails é usado para exibir detalhes de um banco de dados plugável (PDB) hospedado em um banco de dados contêiner (CDB) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para executar o comando dbaascli pdb getDetails?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: O que a opção --dbname especifica no comando dbaascli pdb getDetails?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o PDB cujos detalhes você deseja exibir.

P: Como você especifica o PDB cujos detalhes deseja exibir?

R: Você pode especificar o PDB usando a opção --pdbName (para fornecer o nome do PDB) ou a opção --pdbUID (para fornecer o UID do PDB).

P: Qual é a diferença entre --pdbName e --pdbUID?

A: A opção --pdbName usa o nome do PDB para extrair detalhes, enquanto a opção --pdbUID usa o identificador exclusivo (UID) do PDB para extrair seus detalhes.

P: Posso usar --pdbName e --pdbUID juntos no comando dbaascli pdb getDetails?

R: Não, você pode especificar a opção --pdbName ou --pdbUID para obter detalhes do PDB, mas não os dois ao mesmo tempo.

P: Quais são alguns casos de uso do comando dbaascli pdb getDetails?

A: Você pode usar o comando dbaascli pdb getDetails para:
  • Recuperar detalhes sobre um PDB específico em um CDB.
  • Verifique a configuração de um PDB.
  • Verifique o status de um PDB dentro de um CDB.

P: Como posso exibir detalhes de um PDB com base em seu nome?

A: Para exibir detalhes de um PDB com base em seu nome, use a seguinte sintaxe:

dbaascli pdb getDetails --dbname <CDB_Name> --pdbName <PDB_Name>

P: Como posso exibir detalhes de um PDB com base em seu UID?

A: Para exibir detalhes de um PDB com base em seu UID, use a seguinte sintaxe:

dbaascli pdb getDetails --dbname <CDB_Name> --pdbUID <PDB_UID>

P: Esse comando pode ser usado para vários PDBs em uma execução?

R: Não, o comando pode ser usado para extrair detalhes de um PDB de cada vez especificando seu nome ou UID.

Exemplo 7-35 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

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb list?

R: O comando dbaascli pdb list é usado para exibir a lista de bancos de dados plugáveis (PDBs) em um banco de dados contêiner (CDB) especificado em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para executar o comando dbaascli pdb list?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: O que a opção --dbname especifica no comando dbaascli pdb list?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda os bancos de dados plugáveis (PDBs) para os quais você deseja exibir a lista.

P: Posso exibir a lista de PDBs de vários bancos de dados contêineres de uma só vez?

R: Não, o comando dbaascli pdb list permite listar os PDBs de apenas um banco de dados contêiner (CDB) por vez, especificado pela opção --dbname.

P: Como listo os PDBs em um banco de dados contêiner (CDB) específico?

R: Você pode listar os PDBs em um CDB específico usando a seguinte sintaxe:

dbaascli pdb list --dbname <CDB_Name>

P: Quais informações são exibidas ao usar o comando dbaascli pdb list?

R: O comando retorna uma lista de todos os bancos de dados plugáveis (PDBs) dentro do banco de dados contêiner (CDB) especificado. A lista geralmente inclui os nomes dos PDBs e possivelmente outros detalhes, como seu status.

P: Posso filtrar a lista de PDBs usando opções adicionais?

R: Não, o comando dbaascli pdb list não suporta opções de filtragem adicionais. Ele simplesmente retorna a lista completa de PDBs no CDB especificado.

P: O que acontece se o --dbname especificado não existir ou estiver incorreto?

R: Se o --dbname especificado estiver incorreto ou não existir, o comando retornará um erro e nenhuma lista de PDB será exibida.

P: O comando dbaascli pdb list pode ser usado para qualquer ambiente de banco de dados Oracle?

R: Não, o comando dbaascli pdb list foi projetado especificamente para uso nos ambientes Exadata Cloud@Customer.

Exemplo 7-36 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>]
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.
  • --excludeUserTablespaces - opção para ignorar tablespaces de usuário, por exemplo, t1,t2,t3.
  • --excludePDBData especifica true/yes para ignorar dados do usuário do pdb de origem.
  • --pdbAdminUserName especifica o novo nome do usuário administrador do PDB.
  • --lockPDBAdminAccount especifica true ou false para bloquear a conta de usuário administrador do PDB. O valor default é verdadeiro.
  • --sourcePDBServiceConvertList especifica uma lista separada por vírgulas de nomes de serviços de origem para destino que precisam ser convertidos. A sintaxe é source_srv1:new_srv1,source_srv2:new_srv2.

O PDB recém-clonado herda senhas de administração do PDB de origem.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb localClone?

R: O comando dbaascli pdb localClone é usado para criar um novo banco de dados plugável (PDB) como clone de um PDB existente no mesmo banco de dados contêiner (CDB) em um ambiente Exadata Cloud@Customer.

P: Quais são os pré-requisitos para executar o comando dbaascli pdb localClone?

R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer. Além disso, o PDB de origem já deve existir no CDB especificado.

P: O que a opção --dbName especifica no comando dbaascli pdb localClone?

A: A opção --dbName especifica o nome do banco de dados contêiner (CDB) que hospeda o PDB de origem do qual o novo PDB será clonado.

P: O que a opção --pdbName especifica no comando dbaascli pdb localClone?

A: A opção --pdbName especifica o nome do novo PDB que você deseja criar como clone do PDB existente no mesmo CDB.

P: Posso clonar um PDB com outro nome usando o comando dbaascli PDB localClone?

R: Sim, você pode especificar outro nome para o PDB clonado usando a opção --targetPDBName. Se essa opção não for fornecida, o PDB clonado herdará o nome do PDB de origem.

P: O que a opção --resume faz no comando dbaascli pdb localClone?

A: A opção --resume permite retomar uma operação de clonagem do PDB interrompida anteriormente.

P: Como limitar os recursos de CPU disponíveis para o PDB clonado?

R: Você pode limitar os recursos de CPU do PDB clonado usando a opção --maxCPU, que especifica o número máximo de CPUs que serão alocadas para o novo PDB.

P: Posso executar a operação de clonagem do PDB em segundo plano?

R: Sim, você pode executar a operação em segundo plano definindo a opção --waitForCompletion como false. Se você defini-la como true, a operação será executada em primeiro plano e aguardará a conclusão.

P: Qual é a finalidade da opção --maxSize no comando dbaascli pdb localClone?

A: A opção --maxSize especifica o tamanho máximo de armazenamento (em GB) para o PDB recém-clonado. Se nenhum tamanho for especificado, o PDB clonado herdará os mesmos limites de armazenamento que o PDB de origem.

P: Posso controlar o paralelismo da operação de clonagem do PDB?

R: Sim, você pode controlar o grau de paralelismo da operação de clonagem usando a opção --powerLimit. Esta opção aceita valores entre 1 e 128 para definir o grau de paralelismo.

P: Para que é usada a opção --primaryDBWalletTar?

A: A opção --primaryDBWalletTar especifica o local do arquivo tar da wallet do banco de dados principal. Essa opção só será necessária se a operação de clonagem envolver operações de PDB do banco de dados stand-by.

P: Posso executar somente as verificações de pré-requisitos para a operação de clonagem?

R: Sim, você só pode executar as verificações de pré-requisitos usando a opção --executePrereqs e definindo-a como yes. Os valores válidos são yes e no.

P: O que acontece se a operação de clonagem do PDB falhar ou for interrompida?

R: Se a operação de clonagem falhar ou for interrompida, você poderá retomá-la usando a opção --resume para continuar de onde a operação foi interrompida.

Exemplo 7-37 dbaascli pdb localClone

dbaascli pdb localClone --dbName db35 --pdbName PDB35 --targetPDBName local_clone1 --maxCPU 2 --maxSize 15
dbaascli pdb open

Para abrir um banco de dados plugável (PDB), use o comando dbaascli pdb open.

Execute o comando como usuário root ou oracle.

Sintaxe

dbaascli pdb open
 {
   --pdbName <value> | --pdbUID <value>
 }
--dbname <value> [--openMode <value>] [--startServices <value>] [--waitForCompletion <value>] [--setPDBRefreshModeNone [--skipPDBRefresh] [--pdbAdminUserName <value>]]
Em que:
  • --pdbName especifica o nome do PDB que você deseja abrir
  • --pdbUID especifica o identificador do PDB
  • --dbname especifica o nome do banco de dados contêiner que hospeda o PDB.
  • --openMode especifica o destino OPEN MODE do PDB
  • --startServices: especifica que vai iniciar todos ou listar todos os serviços correspondentes a um PDB. Os valores aceitos são all ou uma lista de serviços do PDB delimitada por vírgulas.
  • --waitForCompletion: especifica false para executar a operação em segundo plano. Valores válidos: true|false
  • --setPDBRefreshModeNone: especifica a conversão de um PDB atualizável em um PDB não atualizável
    • --skipPDBRefresh: especifica que vai ignorar a atualização do PDB atualizável
    • --pdbAdminUserName: - especifica o novo nome do usuário administrador do PDB

Após a conclusão bem-sucedida, o PDB é aberto em todas as instâncias do banco de dados contêiner.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb open?

R: O comando dbaascli pdb open é usado para abrir um banco de dados plugável (PDB) em um banco de dados contêiner (CDB) da Oracle em um ambiente Exadata Cloud@Customer.

P: Quem pode executar o comando dbaascli pdb open?

R: O comando pode ser executado como o usuário root ou oracle.

P: O que a opção --pdbName especifica no comando dbaascli pdb open?

A: A opção --pdbName especifica o nome do PDB que você deseja abrir.

P: O que a opção --pdbUID especifica no comando dbaascli pdb open?

A: A opção --pdbUID especifica o identificador exclusivo (UID) do PDB que você deseja abrir.

P: O que a opção --dbname especifica no comando dbaascli pdb open?

A: A opção --dbname especifica o nome do CDB (banco de dados contêiner) que hospeda o PDB.

P: Qual é a finalidade da opção --openMode?

A: A opção --openMode especifica o modo no qual o PDB será aberto. Os valores válidos são READ_WRITE e READ_ONLY.

P: Posso iniciar serviços ao abrir o PDB?

R: Sim, você pode usar a opção --startServices para iniciar todos os serviços associados ao PDB especificando todos ou fornecer uma lista delimitada por vírgulas de serviços específicos para iniciar.

P: O que acontece se eu definir a opção --waitForCompletion como falsa?

R: Se --waitForCompletion estiver definido como false, o comando será executado em segundo plano e o usuário não precisará aguardar a conclusão da operação. Se definido como true, o comando aguardará a conclusão antes de sair.

P: O que a opção --setPDBRefreshModeNone faz?

A: A opção --setPDBRefreshModeNone converte um PDB atualizável (um que é atualizado regularmente de um banco de dados principal) em um PDB não atualizável.

P: Qual é a função da opção --skipPDBRefresh?

R: A opção --skipPDBRefresh permite ignorar a operação de atualização ao abrir um PDB atualizável, impedindo que o PDB seja sincronizado com o banco de dados principal nesse momento.

P: O que a opção --pdbAdminUserName faz no comando dbaascli pdb open?

A: A opção --pdbAdminUserName permite especificar um novo nome de usuário administrador do PDB ao abrir o PDB.

P: O que acontece se o comando dbaascli pdb open for bem-sucedido?

R: Após a conclusão bem-sucedida, o PDB especificado será aberto em todas as instâncias do banco de dados contêiner (CDB).

P: É possível executar o comando dbaascli PDB open para um PDB atualizável?

R: Sim, o comando pode ser usado para PDBs atualizáveis. A opção --setPDBRefreshModeNone converte o PDB em não atualizável e a opção --skipPDBRefresh ignora a operação de atualização durante o processo de abertura.

P: Qual será o modo de abertura padrão de um PDB se não --openMode for especificado?

R: Se nenhum --openMode for especificado, o PDB geralmente será aberto no modo READ_WRITE por padrão.

Exemplo 7-38 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 --pdbName <value> --dbname <value>
        {
            --start
                {
                    --untilTime <value>
                    | --untilSCN <value>
                    | --latest
                    | --tag <value>
                }
            | --status --uuid <value>
        }
Em que:
--pdbName: PDB name.
--dbname: Oracle Database name.
--start | --status
--start
       --untilTime | --untilSCN | --latest | --tag
       --untilTime: Recovers PDB until time. Input format: DD-MON-YYYY HH24:MI:SS.
       --untilSCN: Recovers PDB until SCN.
       --latest: Recovers PDB to last known state.
       --tag: Recovers PDB to archival tag.
--status
       --uuid <value>

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb recovery?

R: O comando dbaascli pdb recover é usado para recuperar um banco de dados plugável (PDB) para um estado anterior usando backups armazenados em um destino de armazenamento de backup configurado.

P: Quem pode executar o comando dbaascli pdb recovery?

A: O comando deve ser executado como usuário root.

P: O que é necessário antes de executar o comando de recuperação dbaascli pdb?

R: Antes de executar o comando, o banco de dados deve ser configurado com detalhes do destino de armazenamento de backup em que os backups são armazenados.

P: O que a opção --pdbName especifica no comando de recuperação dbaascli pdb?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) que você deseja recuperar.

P: O que a opção --dbname especifica no comando de recuperação dbaascli pdb?

A: A opção --dbname especifica o nome do CDB (banco de dados contêiner) que hospeda o PDB.

P: Quais são as opções possíveis para iniciar uma recuperação de PDB usando a opção --start?

R: Você pode recuperar o PDB usando uma das seguintes opções:
  • --untilTime <value>: Recupera o PDB até um horário especificado (formato: DD-MON-YYYY HH24:MI).
  • --untilSCN <value>: Recupera o PDB até um SCN (Número de Alteração do Sistema) especificado.
  • --latest: Recupera o PDB para o estado conhecido mais recente.
  • --tag <value>: Recupera o PDB para uma tag de arquivamento específica.

P: Qual é o formato necessário para especificar a hora na opção --untilTime?

A: A hora deve estar no formato DD-MON-YYYY HH24:MI:SS.

P: Como posso recuperar um PDB para o estado mais recente usando dbaascli PDB recovery?

A: Para recuperar o PDB para o estado mais recente conhecido, use a opção --latest:

dbaascli pdb recover --pdbName <value> --dbname <value> --start --latest

P: Como recupero um PDB para uma tag de arquivamento específica?

A: Você pode recuperar o PDB para uma tag específica usando a opção --tag:

dbaascli pdb recover --pdbName <value> --dbname <value> --start --tag <tag_value>

P: Posso recuperar um PDB usando um SCN específico?

R: Sim, você pode recuperar o PDB para um SCN específico usando a opção --untilSCN:

dbaascli pdb recover --pdbName <value> --dbname <value> --start --untilSCN <SCN_value>

P: O que a opção --status faz no comando dbaascli pdb recovery?

A: A opção --status é usada para verificar o status de uma operação de recuperação. Você deve fornecer o --uuid para especificar a sessão de recuperação.

P: Como posso verificar o status de uma recuperação de PDB?

A: Para verificar o status de uma operação de recuperação, use a opção --status com o --uuid da sessão de recuperação:

dbaascli pdb recover --pdbName <value> --dbname <value> --status --uuid <uuid_value>

P: O que acontece se eu especificar a opção --latest no comando recovery?

R: Se você especificar a opção --latest, o PDB será recuperado para o estado mais recente disponível no backup.

Exemplo 7-39 Exemplos

  • Para recuperar um PDB pdb1 em um CDB myTestDb para o mais recente:
    dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --start --latest
  • Para consultar o status da solicitação de recuperação do PDB submetida com uuid 81a17352362011ecbc3000163e8e4fac:
    dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --status --uuid 81a17352362011ecbc3000163e8e4fac
dbaascli pdb refresh

Para atualizar um PDB (banco de dados plugável) especificado, use o comando dbaascli pdb refresh.

Execute o comando como usuário root ou oracle.

Sintaxe

dbaascli pdb refresh --dbname <value>
   {
      --pdbName <value> | --pdbUID <value>
    }
    [--waitForCompletion <value>]

Em que:

  • --dbname: especifica o nome do Oracle Database
  • --pdbName: especifica o nome do banco de dados plugável
  • --pdbUID: especifica o identificador do banco de dados plugável
  • --waitForCompletion: especifica false para executar a operação em segundo plano. Valores válidos: true|false

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli pdb refresh?

R: O comando dbaascli pdb refresh é usado para atualizar um PDB (banco de dados plugável) especificado em um CDB (banco de dados contêiner).

P: Quem pode executar o comando dbaascli pdb refresh?

A: O comando pode ser executado pelo usuário root ou oracle.

P: O que a opção --dbname especifica no comando dbaascli pdb refresh?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) a ser atualizado.

P: O que a opção --pdbName especifica no comando dbaascli pdb refresh?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) que você deseja atualizar.

P: O que a opção --pdbUID especifica no comando dbaascli pdb refresh?

A: A opção --pdbUID especifica o identificador exclusivo (UID) do banco de dados plugável (PDB) que você deseja atualizar.

P: O que a opção --waitForCompletion faz no comando dbaascli pdb refresh?

A: A opção --waitForCompletion especifica se a operação deve ser executada em primeiro plano ou em segundo plano. Se definido como verdadeiro, a operação será executada em primeiro plano e aguardará a conclusão. Se definido como false, a operação será executada em segundo plano.

P: Como posso atualizar um PDB e executar a operação em segundo plano?

A: Para atualizar um PDB e executar a operação em segundo plano, use a opção --waitForCompletion false:

dbaascli pdb refresh --dbname <value> --pdbName <value> --waitForCompletion false

P: Como atualizo um PDB usando seu identificador exclusivo (UID)?

A: Você pode atualizar o PDB usando a opção --pdbUID:

dbaascli pdb refresh --dbname <value> --pdbUID <value>

P: Posso especificar --pdbName e --pdbUID juntos no comando dbaascli pdb refresh?

R: Não, você deve especificar --pdbName ou --pdbUID, mas não ambos, ao atualizar um PDB.

P: O que acontece se eu não incluir a opção --waitForCompletion no comando?

R: Se você não especificar a opção --waitForCompletion, o comportamento padrão será aguardar a conclusão da operação antes de retornar o controle ao usuário.

P: Posso atualizar um PDB enquanto o banco de dados está em execução?

R: Sim, você pode atualizar um PDB enquanto o banco de dados está em execução, desde que o comando seja executado por um usuário com privilégios apropriados.

dbaascli pdb remoteClone

Para criar um novo banco de dados plugável (PDB) como clone de um PDB existente, em outro banco de dados contêiner (CDB), use o comando dbaascli pdb remoteClone.

Execute o comando como usuário root ou oracle.

Sintaxe

dbaascli pdb remoteClone --pdbName <value> --dbName <value> --sourceDBConnectionString <value> [--targetPDBName <value>] [--powerLimit <value>] [--maxCPU <value>] [--maxSize <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--waitForCompletion <value>] [--sourcePDBExportedTDEKeyFile <value>]
        {
            [--blobLocation <value>]
            | [--standbyBlobFromPrimary <value>]
        }
[--excludeUserTablespaces <value>] 
[--excludePDBData <value>] 
[--pdbAdminUserName <value>] 
[--lockPDBAdminAccount <value>] 
[--sourcePDBServiceConvertList <value>] 
[--refreshablePDB --refreshMode <value> [--refreshIntervalInMinutes <value>] --dblinkUsername <value> [--honorCaseSensitiveUserName]] 
[--updateDBBlockCacheSize]
Em que:
  • --pdbName especifica o nome do PDB de origem que você deseja clonar
  • --dbname especifica o nome (DB_NAME) do CDB que hospeda o PDB recém-clonado
  • --sourceDBConnectionString especifica a string de conexão do banco de dados de origem no formato scan_name:scan_port/database_service_name
  • --targetPDBName especifica o nome do PDB de destino (novo PDB clonado)
  • --powerLimit especifica o grau de paralelismo a ser usado para a operação de clonagem. O valor válido fica entre 1 e 128
  • --maxCPU especifica o número máximo de CPUs a serem alocadas para o PDB
  • --maxSize especifica o tamanho máximo do armazenamento em GB para o novo PDB
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --executePrereqs especifica yes para só executar os pré-requisitos desta operação. Valores válidos: yes ou no
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true ou false
  • --sourcePDBExportedTDEKeyFile especifica o arquivo de chave exportado do PDB de origem. Essa variável só se aplica ao banco de dados 12.1.
  • --blobLocation especifica o caminho personalizado em que o arquivo blob stand-by será gerado em um ambiente do Data Guard
  • --standbyBlobFromPrimary especifique o local do arquivo blob stand-by, que é preparado no banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by
    Observação

    Os parâmetros --blobLocation e --standbyBlobFromPrimary são mutuamente exclusivos.
  • --excludeUserTablespaces - opção para ignorar tablespaces de usuário, por exemplo, t1,t2,t3.
  • --excludePDBData - especifique true/yes para ignorar dados do usuário do PDB de origem.
  • --pdbAdminUserName - especifica o novo nome do usuário administrador do PDB
  • --lockPDBAdminAccount especifique true ou false para bloquear a conta do usuário administrador do PDB. O valor default é verdadeiro.
  • --sourcePDBServiceConvertList - especifique uma lista separada por vírgulas de nomes de serviços de origem para destino que precisam ser convertidos. A sintaxe é source_srv1:new_srv1, source_srv2:new_srv2.
  • --refreshablePDB especifica a criação de um PDB atualizável
    • --refreshMode especifica o modo de atualização para um PDB atualizável. Valores válidos: AUTO|MANUAL
      • --refreshIntervalInMinutes especifica o intervalo de atualização para refreshablePDB em minutos
    • --dblinkUsername especifica o usuário comum de um banco de dados remoto usado para link de banco de dados para conexão com o banco de dados remoto
      • --honorCaseSensitiveUserName indica que o nome de usuário especificado faz distinção entre maiúsculas e minúsculas
  • --updateDBBlockCacheSize: especifica a ativação do aplicativo para definir os parâmetros de inicialização db block cache size para suportar a cópia de dados com um tamanho de bloco distinto

Quando solicitado, forneça a senha do usuário SYS para o PDB de origem. O PDB recém-clonado herda senhas de administração do PDB de origem. O PDB clonado é nomeado usando o seguinte formato: dbname_sourcepdbname. Esse comando só é suportado para bancos de dados que não estão em uma configuração do Data Guard e usam o Oracle Database versão 12.2.0.1 ou mais recente.

Perguntas Frequentes

P: Para que é usado o comando dbaascli pdb remoteClone?

R: O comando dbaascli pdb remoteClone é usado para criar um novo Banco de Dados Plugável (PDB) como clone de um PDB existente, em outro banco de dados contêiner (CDB).

P: Qual usuário deve executar o comando dbaascli pdb remoteClone?

A: O comando deve ser executado como o usuário root ou oracle.

P: O que é necessário quando solicitado durante a operação dbaascli pdb remoteClone?

R: Forneça a senha do usuário SYS para o PDB de origem.

P: O que o parâmetro --pdbName especifica?

A: O parâmetro --pdbName especifica o nome do PDB de origem que você deseja clonar.

P: O que o parâmetro --dbName representa?

R: O parâmetro --dbName representa o nome (DB_NAME) do CDB que hospedará o PDB recém-clonado.

P: Como o --sourceDBConnectionString deve ser formatado?

A: O --sourceDBConnectionString deve ser formatado como <scan_name>:<scan_port>/<database_service_name>.

P: Qual é a finalidade do parâmetro --targetPDBName?

A: O parâmetro --targetPDBName especifica o nome do PDB recém-clonado.

P: O que o --powerLimit controla?

A: O parâmetro --powerLimit controla o grau de paralelismo usado para a operação de clonagem. O valor válido fica entre 1 e 128.

P: O que o parâmetro --maxCPU define?

A: O parâmetro --maxCPU define o número máximo de CPUs a serem alocadas para o processo de clonagem do PDB.

P: Qual é a função de --maxSize?

A: O parâmetro --maxSize especifica o tamanho máximo do armazenamento em GB para o novo PDB.

P: O que o parâmetro --resume faz?

A: O parâmetro --resume retoma a operação de clonagem anterior.

P: O que você deve fornecer com a opção --resume?

R: Você pode especificar um --sessionID para retomar uma sessão específica se estiver retomando uma operação anterior.

P: O que o --executePrereqs controla?

R: O parâmetro --executePrereqs determina se apenas os pré-requisitos para a operação de clonagem devem ser executados. Os valores válidos são yes ou no.

P: Como --waitForCompletion afeta a operação?

R: O parâmetro --waitForCompletion especifica se a operação deve ser concluída ou executada em segundo plano. Os valores válidos são true ou false.

P: O que é especificado pelo parâmetro --sourcePDBExportedTDEKeyFile?

A: O parâmetro --sourcePDBExportedTDEKeyFile especifica o arquivo de chave exportado do PDB de origem. Este parâmetro só é aplicável ao Oracle Database versão 12.1.

P: O que o parâmetro --blobLocation define?

A: O parâmetro --blobLocation especifica o caminho personalizado no qual o arquivo BLOB standby será gerado em um ambiente do Data Guard.

P: Quando --standbyBlobFromPrimary é usado?

A: O parâmetro --standbyBlobFromPrimary especifica o local do arquivo BLOB stand-by preparado no banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by.

P: --blobLocation e --standbyBlobFromPrimary podem ser usados juntos?

A: Não, --blobLocation e --standbyBlobFromPrimary são mutuamente exclusivos e não podem ser usados juntos.

P: O que a opção --excludeUserTablespaces faz?

A: A opção --excludeUserTablespaces permite ignorar a clonagem de tablespaces de usuário específicos. Por exemplo, t1,t2,t3.

P: Qual é o efeito de --excludePDBData?

A: A opção --excludePDBData especifica se os dados do usuário devem ser ignorados do PDB de origem durante a clonagem. Os valores válidos são true ou yes.

P: O que é especificado por --pdbAdminUserName?

A: O parâmetro --pdbAdminUserName especifica o novo nome do usuário administrador do PDB clonado.

P: O que a opção --lockPDBAdminAccount controla?

A: A opção --lockPDBAdminAccount especifica se a conta de usuário administrador do PDB será bloqueada. O valor padrão é true.

P: O que --sourcePDBServiceConvertList especifica?

A: O parâmetro --sourcePDBServiceConvertList especifica uma lista delimitada por vírgulas de conversões de nome de serviço de origem para destino. Por exemplo, source_srv1:new_srv1,source_srv2:new_srv2.

P: Qual é a finalidade de --refreshablePDB?

A: O parâmetro --refreshablePDB especifica se um PDB atualizável deverá ser criado.

P: O que o --refreshMode controla?

A: O parâmetro --refreshMode controla o modo de atualização de um PDB atualizável. Os valores válidos são AUTO ou MANUAL.

P: Como --refreshIntervalInMinutes funciona?

A: O parâmetro --refreshIntervalInMinutes especifica o intervalo em minutos para atualizar o PDB atualizável.

P: Para que é usado --dblinkUsername?

A: O parâmetro --dblinkUsername especifica um usuário comum de um banco de dados remoto usado para o link de banco de dados para estabelecer conexão com o banco de dados remoto.

P: O que a opção --honorCaseSensitiveUserName indica?

A: A opção --honorCaseSensitiveUserName indica que o nome de usuário especificado faz distinção entre maiúsculas e minúsculas.

P: Qual é o efeito de --updateDBBlockCacheSize?

A: A opção --updateDBBlockCacheSize permite que o aplicativo defina os parâmetros de inicialização do tamanho do cache de bloco do BD para suportar cópia de dados com um tamanho de bloco diferente.

P: O que devo fazer se encontrar um erro com o comando dbaascli pdb remoteClone?

R: Revise a mensagem de erro para obter detalhes, verifique se todos os parâmetros estão especificados corretamente e verifique se você tem as permissões e credenciais necessárias. Além disso, verifique se os bancos de dados de origem e de destino atendem a todos os requisitos.

P: E se eu esquecer a senha do usuário SYS do PDB de origem?

R: Você precisará redefinir ou recuperar a senha do usuário SYS do PDB de origem. Sem ela, a operação de clonagem não pode ser concluída.

Exemplo 7-40 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 pdb relocate

Para realocar o PDB especificado do banco de dados remoto para o banco de dados local, use o comando dbaascli pdb relocate.

Pré-Requisito

Execute o comando como usuário oracle. Quando solicitado, informe a senha do usuário SYS para o banco de dados de origem.

Sintaxe

dbaascli pdb relocate --pdbName <value> --dbName <value> --sourceDBConnectionString <value> 
[--targetPDBName <value>]
[--powerLimit <value>]
[--maxCpu <value>]
[--maxSize <value>]
[--resume [--sessionID <value>]]
[--executePrereqs <value>]
[--sourcePDBServices <value>]
[--sourcePDBReadOnlyServices <value>]
[--waitForCompletion <value>]
{
    [--blobLocation <value>] | [--standbyBlobFromPrimary <value>]
}
[--upgradePDB <value>]
[--updateDBBlockCacheSize]
{
    [skipOpenPDB] | [--completePDBRelocate]
}
Em que:
  • --pdbName especifica o nome do PDB de origem a ser realocado
  • --dbName especifica o nome do banco de dados de destino
  • --sourceDBConnectionString especifica a string de conexão do banco de dados de origem no formato <scan_name>:<scan_port>/<database_service_name>
  • --targetPDBName especifica um nome para o PDB de destino (novo PDB realocado)
  • --powerLimit especifica o grau de paralelismo a ser usado para a operação de realocação
  • --maxCpu especifica o número máximo de CPUs a serem alocadas para o PDB
  • --maxSize especifica o tamanho máximo do armazenamento em GB para o novo PDB
  • --resume especifica para retomar a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --executePrereqs especifica yes para só executar os pré-requisitos desta operação. Valores válidos: yes|no
  • --sourcePDBServices especifica uma lista de serviços do PDB de origem delimitados por vírgulas
  • --sourcePDBReadOnlyServices especifica uma lista delimitada por vírgulas de serviços somente leitura do PDB de origem
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true|false
  • --blobLocation especifica o local de um diretório personalizado no qual o arquivo BLOB stand-by será gerado em um ambiente do Data Guard
  • --standbyBlobFromPrimary especifica o local do arquivo BLOB stand-by, que é preparado usando o banco de dados principal. Isso só é necessário para operações stand-by.
    Observação

    Os parâmetros --blobLocation são mutuamente exclusivos.
  • --upgradePDB especifica true para fazer upgrade do PDB como parte dessa operação. Valores válidos : true | false.
  • --updateDBBlockCachesize opção para permitir que o aplicativo defina parâmetros de inicialização db block cache size para suportar a cópia de dados com tamanho de bloco diferente.
  • --skipOpenPDB - indica que o PDB não deve ser aberto no fim da operação atual.
  • --completePDBRelocate - conclui a realocação do PDB, se for executada como operação em duas etapas.

Perguntas Frequentes

P: Para que é usado o comando dbaascli pdb relocate?

R: O comando dbaascli pdb relocate é usado para realocar um Banco de Dados Plugável (PDB) de um banco de dados remoto para um banco de dados local.

P: Qual usuário deve executar o comando dbaascli pdb relocate?

A: O comando deve ser executado como usuário Oracle.

P: O que é necessário quando solicitado durante a operação de realocação do pdb dbaascli?

A: Informe a senha do usuário SYS para o banco de dados de origem.

P: O que o parâmetro --pdbName especifica?

A: O parâmetro --pdbName especifica o nome do PDB de origem a ser realocado.

P: Qual é a finalidade do parâmetro --dbName?

A: O parâmetro --dbName especifica o nome do banco de dados de destino no qual o PDB será realocado.

P: Como o --sourceDBConnectionString deve ser formatado?

A: O --sourceDBConnectionString deve ser formatado como <scan_name>:<scan_port>/<database_service_name>.

P: O que o parâmetro --targetPDBName faz?

A: O parâmetro --targetPDBName especifica um novo nome para o PDB realocado.

P: Qual é o uso de --powerLimit?

R: O parâmetro --powerLimit especifica o grau de paralelismo a ser usado durante a operação de realocação.

P: Como --maxCpu afeta o processo de realocação?

A: O parâmetro --maxCpu especifica o número máximo de CPUs a serem alocadas para o processo de realocação do PDB.

P: O que o parâmetro --maxSize define?

A: O parâmetro --maxSize define o tamanho máximo de armazenamento em GB para o novo PDB.

Q: Qual é a função de --resume?

R: O parâmetro --resume indica que a operação de realocação deve ser retomada de onde parou.

P: O que devo fornecer com a opção --resume?

R: Você pode especificar um --sessionID para retomar uma sessão específica se estiver retomando uma operação anterior.

P: O que o parâmetro --executePrereqs faz?

R: O parâmetro --executePrereqs determina se apenas os pré-requisitos da operação devem ser executados. Os valores válidos são sim ou não.

P: O que é especificado pelo parâmetro --sourcePDBServices?

A: O parâmetro --sourcePDBServices especifica uma lista de serviços do PDB de origem delimitados por vírgulas.

P: O que faz a lista de parâmetros --sourcePDBReadOnlyServices?

A: O parâmetro --sourcePDBReadOnlyServices lista uma lista delimitada por vírgulas de serviços somente leitura do PDB de origem.

P: Qual é o efeito de --waitForCompletion?

A: O parâmetro --waitForCompletion especifica se a operação deve ser executada em segundo plano. Os valores válidos são true ou false.

P: O que o parâmetro --blobLocation especifica?

A: O parâmetro --blobLocation especifica o local de um diretório personalizado no qual o arquivo BLOB stand-by será gerado em um ambiente do Data Guard.

Q: Quando devo usar --standbyBlobFromPrimary?

R: Use --standbyBlobFromPrimary para especificar o local do arquivo BLOB stand-by, que é preparado no banco de dados principal. Isso só é necessário para operações stand-by.

P: Posso usar --blobLocation e --standbyBlobFromPrimary juntos?

R: Não, os parâmetros --blobLocation e --standbyBlobFromPrimary são mutuamente exclusivos e não podem ser usados juntos.

P: O que --upgradePDB faz?

A: O parâmetro --upgradePDB especifica se o PDB deve ser submetido a upgrade como parte da operação de realocação. Os valores válidos são true ou false.

P: Qual é a finalidade de --updateDBBlockCacheSize?

A: A opção --updateDBBlockCacheSize permite que o aplicativo defina os parâmetros de inicialização do tamanho do cache de bloco do BD para suportar cópia de dados com um tamanho de bloco diferente.

P: O que a opção --skipOpenPDB faz?

A: A opção --skipOpenPDB indica que o PDB não deve ser aberto no final da operação de realocação.

Q: Quando devo usar --completePDBRelocate?

R: Use --completePDBRelocate para concluir a realocação do PDB, se for feita como operação em duas etapas.

P: O que devo fazer se encontrar um erro ao usar o comando dbaascli pdb relocate?

R: Verifique a mensagem de erro para obter detalhes, certifique-se de que todos os parâmetros estejam especificados corretamente e verifique se você tem as permissões e credenciais necessárias. Talvez você também precise revisar os pré-requisitos e as configurações.

P: E se eu esquecer a senha do usuário SYS do banco de dados de origem?

R: Você precisará redefinir ou recuperar a senha do usuário SYS do banco de dados de origem. Sem ele, não é possível concluir a operação de realocação.

Exemplo 7-41 dbaascli pdb relocate

dbaascli pdb relocate --sourceDBConnectionString test-scan.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521/source_cdb_service_name --pdbName source_pdb --dbName target_db

Gerenciamento do Sistema

Esta seção enfoca a supervisão e o gerenciamento de Oracle homes no sistema. Ele inclui comandos como dbaascli system getDBHomes para exibir detalhes sobre todos os homes do Oracle Database e dbaascli system getGridHomes para listar os detalhes de todos os homes do Grid Infrastructure. Esses comandos fornecem informações essenciais para a manutenção e solução de problemas do ambiente geral do sistema.

dbaascli system getDBHomes

Para exibir informações sobre todos os Oracle homes, use o comando dbaascli system getDBHomes.

Pré-Requisito

Execute o comando como usuário root ou oracle.

Sintaxe

dbaascli system getDBHomes

Perguntas Frequentes

P: Para que é usado o comando dbaascli system getDBHomes?

A: O comando dbaascli system getDBHomes é usado para exibir informações sobre todos os Oracle homes em um sistema.

P: Qual usuário deve executar o comando dbaascli system getDBHomes?

A: O comando deve ser executado como o usuário root ou oracle.

P: Há algum parâmetro para o comando dbaascli system getDBHomes?

A: Não, o comando dbaascli system getDBHomes não tem parâmetros.

P: Que tipo de informação o comando dbaascli system getDBHomes fornece?

R: O comando fornece detalhes sobre todos os Oracle homes no sistema, incluindo seus caminhos e outras informações relevantes.

P: Como posso interpretar a saída do comando dbaascli system getDBHomes?

A: A saída listará todos os Oracle homes com informações como a localização de cada Oracle home. Essas informações podem ajudar no gerenciamento e na configuração de ambientes Oracle.

P: O que devo fazer se o comando dbaascli system getDBHomes não retornar nenhuma saída?

R: Certifique-se de que você esteja executando o comando como usuário root ou oracle e verifique se os Oracle homes estão instalados corretamente no sistema. Você também pode verificar as permissões e configurações do sistema.

P: E se eu receber uma mensagem de erro ao executar o comando dbaascli system getDBHomes?

R: Verifique a mensagem de erro para obter detalhes específicos, verifique se você tem as permissões apropriadas e certifique-se de que a ferramenta dbaascli esteja instalada e configurada corretamente.

P: Posso executar o sistema dbaascli getDBHomes em um sistema não Oracle?

R: Não, o comando dbaascli system getDBHomes é específico para sistemas Oracle e requer que o software Oracle seja instalado.

Exemplo 7-42 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

Perguntas Frequentes

P: Para que é usado o comando dbaascli system getGridHomes?

R: O comando dbaascli system getGridHomes é usado para listar os detalhes de todos os Grid homes em um sistema.

P: Qual usuário deve executar o comando dbaascli system getGridHomes?

A: O comando deve ser executado como o usuário root ou oracle.

P: Há algum parâmetro para o comando dbaascli system getGridHomes?

A: Não, o comando dbaascli system getGridHomes não tem parâmetros.

P: Que tipo de informação o comando dbaascli system getGridHomes fornece?

R: O comando fornece detalhes sobre todos os Grid homes no sistema, incluindo seus locais e outras informações relevantes.

P: Como posso interpretar a saída do comando dbaascli system getGridHomes?

A: A saída listará todos os Grid homes com informações, como seus caminhos e configurações. Isso ajuda no gerenciamento e na configuração do Oracle Grid Infrastructure.

P: O que devo fazer se o comando dbaascli system getGridHomes não retornar nenhuma saída?

R: Certifique-se de que você esteja executando o comando como usuário root ou oracle e verifique se os Oracle Grid homes estão instalados corretamente no sistema. Verifique as permissões e configurações do sistema, se necessário.

P: E se eu receber uma mensagem de erro ao executar o comando dbaascli system getGridHomes?

R: Revise a mensagem de erro para obter detalhes específicos, verifique se você tem as permissões apropriadas e se a ferramenta dbaascli está instalada e configurada corretamente.

P: Posso executar o sistema dbaascli getGridHomes em um sistema sem o Oracle Grid Infrastructure?

R: Não, o comando dbaascli system getGridHomes é específico para sistemas com o Oracle Grid infrastructure instalado. Se nenhum Grid homes estiver presente, o comando poderá não retornar nenhum resultado.

Gerenciamento de Criptografia de Dados Transparentes (TDE)

Esta seção abrange o gerenciamento da Criptografia Transparente de Dados (TDE) para proteger dados de banco de dados. Ele inclui comandos para tratar chaves de criptografia e armazenamentos de chaves, como dbaascli tde addSecondaryHsmKey para adicionar chaves HSM secundárias, dbaascli tde rotateMasterKey para rotacionar a chave mestra e dbaascli tde encryptTablespacesInPDB para criptografar tablespaces em um banco de dados plugável. Você também pode converter entre FILE e TDE baseado em HSM (dbaascli tde fileToHsm, dbaascli tde hsmToFile), gerenciar versões de chave e recuperar detalhes de chave com vários comandos. Essas ferramentas garantem um gerenciamento eficaz de criptografia e segurança de dados.

dbaascli tde addSecondaryHsmKey

Para adicionar uma chave HSM (KMS) secundária à configuração HSM (KMS) existente, use o comando dbaascli tde addSecondaryHsmKey.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde addSecondaryHsmKey --dbname <value> --secondaryKmsKeyOCID <value>
[--executePrereqs]
Em que:
  • --secondaryKmsKeyOCID especifica a chave KMS secundária a ser adicionada à configuração HSM (KMS) existente
  • --dbname especifica o nome do banco de dados
  • --executePrereqs - execute as verificações de pré-requisitos e reporte os resultados.

Perguntas Frequentes

P: O que o comando dbaascli tde addSecondaryHsmKey faz?

R: O comando dbaascli tde addSecondaryHsmKey adiciona uma chave HSM (KMS) secundária à configuração HSM (KMS) existente para um banco de dados Exadata Cloud@Customer.

P: Quem deve executar o comando dbaascli tde addSecondaryHsmKey?

A: O comando deve ser executado como usuário root.

P: Em qual máquina devo executar o comando dbaascli tde addSecondaryHsmKey?

R: Você precisa estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.

P: Onde posso encontrar mais detalhes sobre a conexão com uma máquina virtual para executar este comando?

R: Você pode consultar o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções sobre como estabelecer conexão.

P: O que a opção --secondaryKmsKeyOCID especifica?

A: A opção --secondaryKmsKeyOCID especifica o OCID (Oracle Cloud Identifier) da chave KMS secundária a ser adicionada à configuração do HSM (KMS) existente.

P: O que a opção --dbname faz?

A: A opção --dbname permite especificar o nome do banco de dados ao qual a chave KMS secundária deve ser adicionada. Ela é opcional.

P: O que a opção --precheckOnly faz?

A: A opção --precheckOnly, quando definida como yes, executa uma pré-verificação da operação sem fazer alterações reais. Os valores válidos são yes ou no.

P: Posso executar a pré-verificação apenas sem fazer alterações?

R: Sim, você pode usar a opção --precheckOnly yes para executar apenas a pré-verificação sem fazer alterações.

P: Você pode dar um exemplo de como executar este comando para adicionar uma chave HSM secundária?

A: Este é um exemplo:

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example

P: Como executar o comando para um banco de dados específico?

A: Você pode especificar o nome do banco de dados como este:

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --dbname mydatabase

P: Como executar o comando apenas com uma pré-verificação?

A: Para executar a pré-verificação, use a seguinte sintaxe:

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --precheckOnly yes

P: O que devo fazer se o comando falhar?

R: Verifique se você está executando o comando como o usuário root e se conectou à máquina virtual correta do Exadata Cloud@Customer. Além disso, verifique o OCID da chave KMS e verifique se as permissões necessárias foram concedidas.

P: Como posso verificar se tenho o OCID correto para a chave KMS secundária?

R: Você pode recuperar o OCID da chave KMS na console do Oracle Cloud Infrastructure, na seção KMS (Key Management Service).

P: Quais permissões são necessárias para adicionar uma chave KMS secundária?

R: Você precisa de permissões apropriadas no Oracle Cloud Infrastructure para operações KMS, incluindo a capacidade de gerenciar chaves KMS para o compartimento relevante.

P: Posso usar o comando dbaascli tde addSecondaryHsmKey sem especificar a opção --dbname?

R: Sim, a opção --dbname é opcional. Se omitido, o comando se aplica a todos os bancos de dados que usam a configuração HSM (KMS) existente.

P: O que acontece se eu adicionar uma chave KMS secundária?

R: A chave KMS secundária será adicionada à configuração existente, fornecendo uma camada adicional de redundância de gerenciamento de chaves de criptografia.

P: Posso remover uma chave KMS secundária depois que ela for adicionada?

R: Não, depois que uma chave KMS secundária for adicionada, ela não poderá ser removida. Você só pode rotacionar ou atualizar chaves no futuro.

Exemplo 7-43 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 changePassword

Para alterar a senha do armazenamento de chaves TDE, bem como a senha da wallet do Banco de Dados para o alias tde_ks_passwd, use o comando dbaascli tde changePassword.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde changePassword [--dbname <value>]
  {            [--prepareStandbyBlob <value> [--blobLocation <value>]]
               | [--standbyBlobFromPrimary <value>]
  }
  [--resume [--sessionID <value>]]
Em que:
  • --dbname especifica o nome do banco de dados
  • --prepareStandbyBlob - especifica true para gerar um arquivo blob contendo os artefatos necessários para executar a operação em um ambiente do DG.
  • --blobLocation - caminho personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG.
  • --standbyBlobFromPrimary - especifica o local do arquivo blob stand-by preparado no banco de dados principal. Isso só é necessário para operações stand-by.
  • --resume - para retomar a execução anterior
  • --sessionID - para retomar um id de sessão específico.

Perguntas Frequentes

P: O que o comando dbaascli tde changePassword faz?

A: O comando dbaascli tde changePassword altera a senha do armazenamento de chaves TDE (Transparent Data Encryption), bem como a senha da wallet do banco de dados do alias tde_ks_passwd.

P: Quem deve executar o comando dbaascli tde changePassword?

A: O comando deve ser executado como usuário root.

P: Quando devo usar o comando dbaascli tde changePassword?

R: Use este comando quando precisar alterar a senha do armazenamento de chaves TDE ou a senha da wallet de BD para um banco de dados Exadata Cloud@Customer.

P: O que a opção --dbname faz?

A: A opção --dbname especifica o nome do banco de dados para o qual você deseja alterar a senha do armazenamento de chaves de TDE.

P: O que a opção --pdbName faz?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) cuja senha do armazenamento de chaves de TDE precisa ser alterada. Esta opção é usada para bancos de dados multitenant.

P: Você pode dar um exemplo de como executar este comando para um banco de dados específico?

A: Aqui está um exemplo para alterar a senha da área de armazenamento de chaves de TDE para um banco de dados específico:

dbaascli tde changePassword --dbname mydatabase

P: Como faço para executar o comando de um PDB específico em um banco de dados multitenant?

A: Você pode especificar o nome do PDB usando esta sintaxe:

dbaascli tde changePassword --dbname mydatabase --pdbName mypdb

P: Quais são os pré-requisitos para executar o comando dbaascli tde changePassword?

R: Você deve executar o comando como o usuário root e ter acesso à máquina virtual do Exadata Cloud@Customer na qual o banco de dados está em execução.

P: Preciso interromper o banco de dados para alterar a senha do armazenamento de chaves de TDE?

R: Não, o banco de dados não precisa ser interrompido para alterar a senha da área de armazenamento de chaves de TDE.

P: O que devo fazer se o comando falhar?

R: Certifique-se de que você esteja executando o comando como usuário raiz e que o nome do banco de dados (--dbname) e o nome do PDB (--pdbName, se aplicável) estejam corretos.

P: E se eu receber um erro de "senha inválida" ao alterar a senha do armazenamento de chaves TDE?

R: Certifique-se de que a nova senha atenda aos requisitos de complexidade de senhas do sistema e que você esteja digitando a senha antiga correta, se solicitado.

P: Como verifico se a senha da área de armazenamento de chaves de TDE foi alterada com sucesso?

R: Você pode verificar os logs do banco de dados ou usar as views do Oracle Database Vault e do Key Management para verificar se a alteração da senha da área de armazenamento de chaves de TDE foi bem-sucedida.

P: Posso alterar a senha da área de armazenamento de chaves de TDE para um banco de dados multitenant e todos os PDBs de uma só vez?

R: Não, o comando dbaascli tde changePassword precisará ser executado para cada PDB individualmente se você precisar alterar a senha de vários PDBs.

P: O que acontece se eu esquecer a nova senha da área de armazenamento de chaves TDE?

R: Se a nova senha for esquecida, talvez você precise restaurar a área de armazenamento de chaves de um backup ou seguir o processo de recuperação da Oracle para redefini-la, dependendo da sua configuração.

P: Posso automatizar o processo de alteração da senha da área de armazenamento de chaves TDE?

R: Embora o próprio comando dbaascli tde changePassword não seja projetado para automação, você pode criá-lo como parte de seus procedimentos regulares de manutenção de banco de dados, se necessário.

P: Com que frequência devo alterar a senha da área de armazenamento de chaves TDE?

R: A Oracle recomenda alterar periodicamente sua senha da área de armazenamento de chaves de TDE com base nas políticas de segurança da sua organização. As melhores práticas geralmente envolvem a rotação de chaves de criptografia e senhas de armazenamento de chaves regularmente.

Para alterar a senha de TDE em um ambiente que não seja do Data Guard
dbaascli tde changepassword --dbname
      <dbname>
Para alterar a senha de TDE em um ambiente do Data Guard
  1. Altere a senha de TDE no banco de dados principal.
    dbaascli tde changepassword --dbname
          <dbname> --prepareStandbyBlob true --blobLocation
          <Location where blob file has to be generated>
  2. Copie o blob stand-by criado para o ambiente do banco de dados stand-by.
  3. Altere a senha de TDE no banco de dados stand-by.
    dbaascli tde changepassword --dbname
         <dbname> --standbyBlobFromPrimary <Location of blob generated from
        primary>

dbaascli tde enableWalletRoot

Para ativar o parâmetro spfile wallet_root para o banco de dados existente, use o comando dbaascli tde enableWalletRoot.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde enableWalletRoot --dbname <value>
[--dbRestart <value>]
[--executePrereqs]
[--resume [--sessionID <value>]]
Em que:
  • --dbname especifica o nome do Oracle Database.
  • --dbrestart especifica a opção de reinício do banco de dados. Os valores válidos são: rolling ou full. Valor padrão: rolling

    Se você não informar o argumento dbrestart, o banco de dados será reiniciado de maneira rolling.

  • --precheckOnly só executa a pré-verificação desta operação. Os valores válidos são: yes ou no
  • --resume para retomar a execução anterior
  • --sessionID para retomar um id de sessão específico.

Perguntas Frequentes

P: O que o comando dbaascli tde enableWalletRoot faz?

R: O comando dbaascli tde enableWalletRoot ativa o parâmetro wallet_root em spfile para um banco de dados Oracle existente no Exadata Cloud@Customer.

P: Quem deve executar o comando dbaascli tde enableWalletRoot?

A: O comando deve ser executado como usuário root.

P: Em qual máquina devo executar o comando dbaascli tde enableWalletRoot?

R: Você deve estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.

P: Onde posso encontrar instruções para me conectar à máquina virtual?

R: Você pode consultar o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções sobre como estabelecer conexão.

P: O que a opção --dbRestart faz?

A: A opção --dbRestart especifica como o banco de dados deve ser reiniciado após a ativação de wallet_root. Os valores válidos são:
  • rolling: Reinicia o banco de dados de forma incremental (comportamento padrão).
  • full: Executa uma reinicialização completa do banco de dados.

P: O que a opção --dbname faz?

A: A opção --dbname permite especificar o nome do Oracle Database para o qual o parâmetro wallet_root deve ser ativado.

P: O que a opção --precheckOnly faz?

A: A opção --precheckOnly executa uma pré-verificação da operação sem fazer alterações reais. Os valores válidos são yes ou no.

P: O que acontece se eu não especificar a opção --dbRestart?

R: Se você não especificar a opção --dbRestart, o banco de dados será reiniciado de forma incremental por padrão.

P: Você pode dar um exemplo de como ativar wallet_root para um banco de dados específico?

A: Veja um exemplo para ativar wallet_root para um banco de dados chamado mydatabase:

dbaascli tde enableWalletRoot --dbname mydatabase

P: Como ativar wallet_root e especificar uma reinicialização completa do banco de dados?

A: Você pode ativar wallet_root com uma reinicialização completa do banco de dados usando o seguinte comando:

dbaascli tde enableWalletRoot --dbname mydatabase --dbRestart full

P: Como executar o comando apenas com uma pré-verificação?

A: Para executar uma pré-verificação sem fazer alterações, use a seguinte sintaxe:

dbaascli tde enableWalletRoot --dbname mydatabase --precheckOnly yes

P: Quais são os pré-requisitos para executar o comando dbaascli tde enableWalletRoot?

R: Você deve executar o comando como o usuário root e estar conectado à máquina virtual correta do Exadata Cloud@Customer.

P: Preciso reiniciar o banco de dados para ativar o wallet_root?

R: Sim, o banco de dados precisará ser reiniciado de forma incremental (padrão) ou totalmente, dependendo da opção escolhida.

P: O que devo fazer se o comando falhar?

R: Certifique-se de que você esteja executando o comando como o usuário raiz e verifique se o nome do banco de dados (--dbname) está correto. Verifique se há erros de pré-verificação se você estiver executando com --precheckOnly.

P: E se o banco de dados falhar ao reiniciar após a execução do comando?

R: Verifique se a opção de reinicialização correta foi usada (rolling ou full) e verifique se há erros nos logs do banco de dados. Talvez seja necessário reiniciar manualmente o banco de dados se a reinicialização automática falhar.

P: Como posso verificar se wallet_root foi ativado com sucesso?

R: Você pode verificar a alteração verificando o spfile do banco de dados ou usando consultas do Oracle SQL para confirmar se o parâmetro wallet_root está ativado.

P: Posso ativar wallet_root sem reiniciar o banco de dados?

R: Não, o banco de dados precisa ser reiniciado para que a alteração entre em vigor. Você pode escolher entre uma reinicialização incremental ou uma reinicialização completa.

P: Qual é a diferença entre uma reinicialização contínua e completa do banco de dados?

R: Uma reinicialização incremental reinicia o banco de dados uma instância por vez, permitindo que o banco de dados permaneça parcialmente disponível durante a operação. Uma reinicialização completa é encerrada e reinicia todo o banco de dados, causando um tempo de inatividade completo.

P: Posso executar este comando para vários bancos de dados simultaneamente?

R: Você precisa executar o comando dbaascli tde enableWalletRoot separadamente para cada banco de dados no qual deseja ativar wallet_root.

P: Como a ativação de wallet_root afeta a configuração do armazenamento de chaves de TDE existente?

R: A ativação de wallet_root atualiza o local do armazenamento de chaves TDE para o novo diretório raiz da wallet, facilitando o gerenciamento de vários armazenamentos de chaves e wallets em bancos de dados Oracle.

Exemplo 7-44 dbaascli tde enableWalletRoot

dbaascli tde enableWalletRoot --dbname db name --dbrestart rolling|full
dbaascli tde enableWalletRoot --dbname orcl
dbaascli tde enableWalletRoot --dbname orcl--dbrestart full
dbaascli tde encryptTablespacesInPDB

Para criptografar todos os tablespaces no PDB especificado, use o comando dbaascli tde encryptTablespacesInPDB.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde encryptTablespacesInPDB --dbname <value> --pdbName <value>
[--executePrereqs]
Em que:
  • --pdbName especifica o nome do PDB para criptografar todos os tablespaces.
  • --dbname especifica o nome do Oracle Database.
  • --executePrereqs - execute as verificações de pré-requisitos e reporte os resultados.

Perguntas Frequentes

P: O que o comando dbaascli tde encryptTablespacesInPDB faz?

R: O comando dbaascli tde encryptTablespacesInPDB criptografa todos os tablespaces no PDB (banco de dados plugável) especificado para um Oracle Database no Exadata Cloud@Customer.

P: Quem deve executar o comando dbaascli tde encryptTablespacesInPDB?

A: O comando deve ser executado como usuário root.

P: Em qual máquina devo executar o comando dbaascli tde encryptTablespacesInPDB?

R: Você precisa estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.

P: Onde posso encontrar instruções para conexão com a máquina virtual?

A: Consulte o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções de conexão.

P: O que a opção --pdbName especifica?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) cujos tablespaces precisam ser criptografados.

P: O que a opção --dbname faz?

A: A opção --dbname permite especificar o nome do Oracle Database ao qual o PDB pertence.

P: O que a opção --precheckOnly faz?

A: A opção --precheckOnly executa uma pré-verificação da operação de criptografia sem fazer alterações reais. Os valores válidos são yes ou no.

P: O que a opção --useSysdbaCredential faz?

A: A opção --useSysdbaCredential especifica se as credenciais SYSDBA devem ser usadas para a operação. Os valores válidos são verdadeiro ou falso.

P: Você pode dar um exemplo de como criptografar tablespaces em um PDB específico?

A: Aqui está um exemplo para criptografar todos os tablespaces em um PDB chamado mypdb:

dbaascli tde encryptTablespacesInPDB --pdbName mypdb

P: Como criptografar tablespaces em um PDB específico em um banco de dados?

A: Use o seguinte comando para especificar o PDB e o banco de dados:

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --dbname mydatabase

P: Como faço para executar uma pré-verificação sem executar a criptografia?

A: Você só pode executar uma pré-verificação usando esta sintaxe:

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --precheckOnly yes

P: Como eu uso as credenciais SYSDBA para criptografar os tablespaces?

A: Você pode usar as credenciais SYSDBA adicionando a opção --useSysdbaCredential true:

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --useSysdbaCredential true

P: Quais são os pré-requisitos para executar o comando dbaascli tde encryptTablespacesInPDB?

R: Você deve executar o comando como usuário root e ter acesso à máquina virtual do Exadata Cloud@Customer.

P: Preciso reiniciar o banco de dados para criptografar os tablespaces?

R: Não, o comando não requer uma reinicialização do banco de dados. A criptografia é executada enquanto o banco de dados está on-line.

P: Preciso de credenciais SYSDBA para criptografar tablespaces?

R: Talvez você precise de credenciais SYSDBA para esta operação, se especificado usando a opção --useSysdbaCredential.

P: O que devo fazer se o comando falhar?

R: Certifique-se de que você esteja executando o comando como o usuário raiz e verifique se o nome do PDB (--pdbName) e o nome do banco de dados (--dbname) estão corretos. Você também pode executar o comando com --precheckOnly yes para verificar problemas antes de executar a criptografia completa.

P: O que devo fazer se a criptografia dos tablespaces falhar?

R: Verifique os logs do banco de dados e certifique-se de ter os privilégios e recursos necessários para executar a criptografia. Você também pode precisar verificar se há espaço suficiente para lidar com o processo de criptografia.

P: Como posso verificar se os tablespaces em um PDB estão criptografados?

R: Você pode consultar as views de banco de dados relacionadas à criptografia, como V$ENCRYPTED_TABLESPACES, para verificar se os tablespaces foram criptografados com sucesso.

P: Como posso verificar se a pré-verificação foi bem-sucedida?

R: Se você executou o comando com --precheckOnly yes, poderá verificar a saída em busca de avisos ou erros que indiquem possíveis problemas com o processo de criptografia.

P: Posso criptografar os tablespaces de vários PDBs simultaneamente?

R: Não, você precisa executar o comando dbaascli tde encryptTablespacesInPDB separadamente para cada PDB.

P: Posso criptografar parcialmente alguns tablespaces em um PDB?

R: Não, este comando criptografa todos os tablespaces dentro do PDB especificado. Para criptografia parcial, você precisaria usar comandos de gerenciamento de banco de dados diferentes.

P: A criptografia de tablespaces afeta o desempenho do banco de dados?

R: A criptografia de tablespaces pode ter um impacto temporário no desempenho durante o processo de criptografia. No entanto, o impacto deve ser mínimo quando a criptografia estiver concluída.

P: Posso desfazer a criptografia de tablespaces?

R: Não, depois que os tablespaces forem criptografados, a criptografia não poderá ser desfeita. Você só pode rotacionar ou recriptografar as chaves conforme necessário.

P: O que acontece se a operação for interrompida durante o processo de criptografia?

R: Se a operação for interrompida, talvez seja necessário reexecutar o comando. O sistema retomará a criptografia de onde parou e você poderá verificar o status usando views de banco de dados.

Exemplo 7-45 dbaascli tde encryptTablespacesInPDB

dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb
dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb --executePrereqs 
dbaascli tde fileToHsm

Para converter TDE baseada em FILE em TDE baseada em HSM (KMS/OKV), use o comando dbaascli tde fileToHsm.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde fileToHsm --kmsKeyOCID <value> --dbname <value> 
[--skipPatchCheck <value>] 
[--executePrereqs ] 
[--primarySuc <value>]
{
    [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]]
}
[--waitForCompletion <value>]
Em que:
  • --kmsKeyOCID especifica o OCID da chave KMS a ser usado para TDE. Isso só será aplicável se o KMS for selecionado para TDE
  • --dbname especifica o nome do banco de dados
  • --skipPatchCheck ignora a verificação de validação para patches obrigatórios se o valor informado para esse argumento for true. Valores válidos: true ou false
  • --executePrereqs - execute as verificações de pré-requisitos e reporte os resultados.
  • --primarySuc especifica essa propriedade no banco de dados stand-by do ambiente do Data Guard quando o comando é executado com sucesso no banco de dados principal
  • --resume especifica para retomar a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --revert especifica para fazer rollback da execução anterior
    • --sessionID especifica para fazer rollback de um ID de sessão específico
  • --waitForCompletion especifique false para executar a operação em segundo plano. Valores válidos : true|false.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde fileToHsm?

R: O comando dbaascli tde fileToHsm é usado para converter uma TDE (Transparent Data Encryption) baseada em arquivo para a TDE baseada no Módulo de Segurança de Hardware (HSM), como KMS ou OKV, em um ambiente do Oracle Database Cloud Service.

P: Quem pode executar o comando dbaascli tde fileToHsm?

A: O comando deve ser executado como usuário root.

P: Qual é a finalidade do parâmetro --kmsKeyOCID?

R: O parâmetro --kmsKeyOCID especifica o OCID da chave KMS que será usado para criptografia de TDE ao fazer a transição de TDE baseada em arquivo para TDE baseada em HSM.

P: O que o parâmetro --dbname faz?

R: O parâmetro --dbname especifica o nome do banco de dados para o qual você está convertendo o TDE de baseado em arquivo para baseado em HSM.

P: Posso ignorar a verificação de validação do patch ao converter a TDE?

R: Sim, usando o parâmetro --skipPatchCheck com o valor true, você pode ignorar a verificação de validação dos patches necessários.

P: Para que o parâmetro --executePrereqs é usado?

R: O parâmetro --executePrereqs permite que você execute somente as pré-verificações do processo de conversão de TDE sem executar a conversão real. Os valores válidos são yes ou no.

P: O que o parâmetro --primarySuc faz em uma configuração do Data Guard?

R: O parâmetro --primarySuc é usado em um ambiente do Data Guard para indicar que o comando foi executado com sucesso no banco de dados principal. Ela deve ser especificada no banco de dados stand-by após a conclusão da conversão principal.

P: Como retomar uma conversão de TDE anterior?

R: Você pode retomar uma conversão de TDE anteriormente incompleta usando o parâmetro --resume. Opcionalmente, você pode especificar um ID de sessão específico com --sessionID.

P: Como reverter uma conversão de TDE?

R: Para reverter uma conversão de TDE anterior, use o parâmetro --revert. Você também pode fornecer o ID de sessão específico que deseja reverter usando --sessionID.

P: Como especificar um ID de sessão ao retomar ou reverter uma conversão de TDE?

R: Você pode usar o parâmetro --sessionID para especificar o ID da sessão que deseja retomar ou reverter. Exemplo: --resume --sessionID <ID> ou --revert --sessionID <ID>.

P: O que acontece se eu definir --waitForCompletion como falso?

R: Se você definir --waitForCompletion como false, o processo de conversão de TDE será executado em segundo plano e o prompt de comando retornará imediatamente. Se definido como true, o comando aguardará a conclusão do processo antes de retornar o controle ao usuário.

P: Quais são os valores válidos para o parâmetro --waitForCompletion?

A: Os valores válidos são true ou false. A definição dele como verdadeiro faz com que o comando aguarde até que o processo seja concluído; a definição dele como false executa o processo em segundo plano.

P: Posso executar dbaascli TDE fileToHsm sem converter o TDE imediatamente?

R: Sim, você pode usar o parâmetro --executePrereqs yes para executar apenas as pré-verificações da conversão, sem fazer alterações na TDE.

P: Em um ambiente do Data Guard, como lidar com o banco de dados stand-by após a conversão da TDE no principal?

R: Após executar com sucesso a conversão no banco de dados principal, você precisa especificar --primarySuc ao executar o comando no banco de dados stand-by.

P: O que devo fazer se o processo de conversão de TDE falhar?

R: Se o processo falhar, você poderá usar o parâmetro --resume para tentar retomar de onde parou. Se necessário, você pode usar o parâmetro --revert para fazer rollback das alterações feitas durante a sessão com falha.

Exemplo 7-46 dbaascli tde fileToHsm --kmsKeyOCID

dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs 
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --resume
dbaascli tde getHsmKeys

Para obter detalhes da chave ativa de TDE, use o comando dbaascli tde getHsmKeys.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde getHsmKeys
[--dbname]
[--infoFile]
Em que:
  • --dbname especifica o nome do banco de dados
  • --infoFile especifica o caminho do arquivo em que a lista de OCIDs será salva. A saída está no formato JSON

Perguntas Frequentes

P: O que o comando dbaascli tde getHsmKeys faz?

R: O comando dbaascli tde getHsmKeys recupera detalhes de chaves TDE (Transparent Data Encryption) ativas do HSM (Hardware Security Module) de um banco de dados especificado.

P: Quem deve executar o comando dbaascli tde getHsmKeys?

A: O comando deve ser executado como usuário root.

P: Em qual máquina devo executar o comando dbaascli tde getHsmKeys?

R: Você deve estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.

P: Onde posso encontrar instruções para conexão com a máquina virtual?

A: Consulte o guia "Connecting to a Virtual Machine with SSH" para obter instruções sobre como estabelecer conexão.

P: O que a opção --dbname faz?

A: A opção --dbname permite especificar o nome do Oracle Database para o qual você deseja recuperar detalhes da chave de TDE.

P: O que a opção --infoFile faz?

A: A opção --infoFile especifica o caminho do arquivo no qual a lista de OCIDs de chave (Identificadores do Oracle Cloud) será salva. A saída está no formato JSON.

P: Você pode dar um exemplo de como recuperar detalhes da chave TDE de um banco de dados específico?

A: Veja um exemplo para obter os detalhes da chave TDE de um banco de dados chamado mydatabase:

dbaascli tde getHsmKeys --dbname mydatabase

P: Como faço para salvar os detalhes da chave TDE em um arquivo?

A: Você pode especificar um caminho de arquivo usando a opção --infoFile para salvar a saída no formato JSON:

dbaascli tde getHsmKeys --dbname mydatabase --infoFile /path/to/output.json

P: Quais são os pré-requisitos para executar o comando dbaascli tde getHsmKeys?

R: Você deve executar o comando como o usuário root e estar conectado à máquina virtual do Exadata Cloud@Customer.

P: Preciso de credenciais SYSDBA para recuperar detalhes da chave TDE?

R: Não, as credenciais SYSDBA não são necessárias para executar o comando dbaascli tde getHsmKeys.

P: Em que formato as informações da chave TDE são salvas ao usar a opção --infoFile?

A: A saída é salva no formato JSON.

P: Quais informações estão incluídas nos detalhes da chave TDE?

R: Os detalhes incluem OCIDs de chave e outros metadados sobre as chaves de criptografia ativas armazenadas no HSM para o banco de dados especificado.

P: O que devo fazer se o comando não recuperar os detalhes da chave?

R: Verifique se você está executando o comando como o usuário raiz e se o nome do banco de dados (--dbname) está correto. Verifique sua conexão com a máquina virtual do Exadata Cloud@Customer.

P: Como verifico se o arquivo de saída foi criado com sucesso?

R: Você pode verificar o caminho do arquivo especificado para o arquivo JSON de saída. Se o arquivo estiver ausente, verifique se o caminho do arquivo está correto e se você tem permissões de gravação no diretório.

P: O que devo fazer se o arquivo de saída estiver vazio?

R: Certifique-se de que o banco de dados especificado contenha chaves de TDE ativas e que o parâmetro --dbname esteja correto. Você também pode precisar verificar se há erros nos logs do banco de dados.

P: Posso recuperar detalhes da chave TDE para vários bancos de dados de uma só vez?

R: Não, você deve executar o comando dbaascli tde getHsmKeys separadamente para cada banco de dados.

P: Como posso usar o arquivo de saída da opção --infoFile em outras operações?

R: Como a saída está no formato JSON, você pode fazer parsing do arquivo de forma programática ou usá-lo como entrada para outras tarefas de gerenciamento de banco de dados ou criptografia.

P: Posso obter detalhes históricos da chave de TDE usando este comando?

R: Não, o comando recupera apenas detalhes sobre as chaves atualmente ativas no HSM.

P: Como posso verificar se as chaves recuperadas estão corretas?

R: Você pode verificar as chaves fazendo referência cruzada delas com a console do OCI (Oracle Cloud Infrastructure) ou usando views de banco de dados relacionadas ao gerenciamento de criptografia.

Exemplo 7-47 dbaascli tde getHsmKeys

dbaascli tde getHsmkeys --dbname dbname
dbaascli tde getHsmkeys --dbname dbname --infoFile infoFilePath
dbaascli tde getMkidForKeyVersionOCID

Para obter o ID da Chave Principal associado ao OCID da versão da chave KMS, use o comando dbaascli tde getMkidForKeyVersionOCID.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde getMkidForKeyVersionOCID --kmsKeyVersionOCID <value>
[--dbname <value>]
[--waitForCompletion <value>]
Em que:
  • --kmsKeyVersionOCID especifica o OCID da versão da chave KMS a ser definido
  • --dbname especifica o nome do banco de dados
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos : true|false.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde getMkidForKeyVersionOCID?

R: O comando dbaascli tde getMkidForKeyVersionOCID recupera o MKID (Master Key ID) associado a um OCID específico da versão da chave KMS nos ambientes do Oracle Database Cloud Service.

P: Quais são os pré-requisitos para executar o comando dbaascli tde getMkidForKeyVersionOCID?

A: Você deve:
  • Execute o comando como usuário root.
  • Conecte-se a uma máquina virtual do Exadata Cloud@Customer via SSH.

P: Quem pode executar o comando dbaascli tde getMkidForKeyVersionOCID?

R: Somente o usuário root pode executar esse comando.

P: O que o parâmetro --kmsKeyVersionOCID especifica?

A: O parâmetro --kmsKeyVersionOCID especifica o OCID da versão da chave KMS para o qual você deseja recuperar o MKID (Master Key ID) associado.

P: O que o parâmetro --dbname especifica?

A: O parâmetro --dbname especifica o nome do banco de dados para o qual o OCID da versão da chave KMS está sendo consultado.

P: O parâmetro --dbname é obrigatório?

A: Não, o parâmetro --dbname é opcional. Se você não especificar um nome de banco de dados, o comando recuperará o MKID do banco de dados padrão no sistema.

P: O que devo fazer se não souber o OCID da versão da chave KMS?

R: Você deve recuperar o OCID da versão da chave KMS da console de gerenciamento do KMS ou do provedor de serviços antes de usar esse comando. Sem ele, o comando não pode recuperar o ID da chave mestra (MKID).

P: Posso executar este comando em um ambiente que não seja do Exadata Cloud@Customer?

R: Não, esse comando é especificamente para uso em um ambiente Exadata Cloud@Customer e você precisa estabelecer conexão com uma máquina virtual usando SSH para executá-lo.

P: O que acontece se eu executar o comando sem especificar um nome de banco de dados usando --dbname?

R: Se o parâmetro --dbname não for fornecido, o comando tentará recuperar o MKID do banco de dados padrão configurado no sistema.

P: O que devo fazer se encontrar um erro ao recuperar o MKID?

A: Certifique-se de que:
  • Você está executando o comando como o usuário root.
  • Você está conectado corretamente à máquina virtual do Exadata Cloud@Customer.
  • O OCID da versão da chave KMS fornecido é válido. Se o erro persistir, verifique os logs do sistema para obter mais detalhes.

P: Como estabeleço conexão com a máquina virtual do Exadata Cloud@Customer?

R: Você pode se conectar à máquina virtual via SSH. Consulte a documentação do Exadata Cloud@Customer para obter etapas sobre como estabelecer conexão segura.

Exemplo 7-48 dbaascli tde getMkidForKeyVersionOCID

dbaascli tde getMkidForKeyVersionOCID --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
dbaascli tde getPrimaryHsmKey

Para obter a chave HSM (KMS) primária da configuração HSM (KMS) existente, use o comando dbaascli tde getPrimaryHsmKey.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde getPrimaryHsmKey
[--dbname]
Em que:
  • --dbname especifica o nome do banco de dados

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde getPrimaryHsmKey?

R: O comando dbaascli tde getPrimaryHsmKey recupera a chave primária do Módulo de Segurança de Hardware (HSM) da configuração existente do HSM (KMS) em um ambiente do Oracle Database.

P: Quais são os pré-requisitos para executar o comando dbaascli tde getPrimaryHsmKey?

A: Você deve:
  • Execute o comando como usuário root.
  • Conecte-se a uma máquina virtual do Exadata Cloud@Customer via SSH.

P: Quem pode executar o comando dbaascli tde getPrimaryHsmKey?

A: Somente o usuário root pode executar este comando.

P: O que o parâmetro --dbname especifica neste comando?

R: O parâmetro --dbname especifica o nome do banco de dados para o qual você deseja recuperar a chave HSM principal.

P: O parâmetro --dbname é obrigatório?

A: Não, o parâmetro --dbname é opcional. Se não for fornecida, o comando recuperará a chave HSM primária do banco de dados padrão no sistema.

P: O que devo fazer se não especificar um nome de banco de dados com --dbname?

R: Se o parâmetro --dbname não for especificado, o comando tentará recuperar a chave principal do HSM para o banco de dados padrão configurado no sistema.

P: Posso executar este comando em um ambiente que não seja do Exadata Cloud@Customer?

R: Não, esse comando foi projetado especificamente para uso em um ambiente Exadata Cloud@Customer e você deve estar conectado à máquina virtual usando SSH para executá-lo.

P: Como estabeleço conexão com a máquina virtual do Exadata Cloud@Customer para executar o comando?

R: Você pode se conectar à máquina virtual via SSH. Consulte a documentação do Exadata Cloud@Customer para obter instruções sobre como estabelecer conexão segura.

P: O que devo verificar se encontro um erro ao recuperar a chave principal do HSM?

R: Se você encontrar um erro, certifique-se de que:
  • Você está executando o comando como o usuário root.
  • Você está conectado corretamente à máquina virtual do Exadata Cloud@Customer.
  • O nome do banco de dados (se especificado) é válido. Se o problema persistir, consulte logs do sistema ou mensagens de erro para obter mais detalhes.

P: Eu preciso interromper o banco de dados para executar o comando dbaascli tde getPrimaryHsmKey?

R: Não, o banco de dados não precisa ser interrompido para executar este comando. Você pode executá-lo enquanto o banco de dados está sendo executado.

P: Qual é a finalidade de recuperar a chave principal do HSM?

R: A recuperação da chave HSM principal permite identificar a chave HSM atual que está sendo usada para criptografia na configuração HSM (KMS) existente do banco de dados.

Exemplo 7-49 dbaascli tde getPrimaryHsmKey

dbaascli tde getPrimaryHsmKey --dbname dbname
dbaascli tde hsmToFile

Para converter TDE baseada em HSM (KMS/OKV) em TDE baseada em FILE, use o comando dbaascli tde hsmToFile.

Execute o comando como usuário root.

Sintaxe

dbaascli tde hsmToFile 
[--dbname <value>] 
{
    [--prepareStandbyBlob <value> [--blobLocation <value>]
   | [--standbyBlobFromPrimary <value>]
}
] 
[--skipPatchCheck <value>] 
[--executePrereqs ] 
[--primarySuc <value>] 
{
     [--resume [--sessionID <value>]] |
     [--revert [--sessionID <value>]]
} 
[--waitForCompletion <value>]
Em que:
  • --dbname especifica o nome do banco de dados
  • --prepareStandbyBlob - especifique true para gerar um arquivo blob contendo os artefatos necessários para executar a operação em um ambiente do DG.
  • --blobLocation local de diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG.
  • --standbyBlobFromPrimary especifica o local do arquivo blob stand-by preparado no banco de dados principal. Isso só é necessário para operações stand-by. ]
  • --skipPatchCheck ignora a verificação de validação para patches obrigatórios se o valor informado para esse argumento for true. Valores válidos: true ou false
  • --executePrereqs - execute as verificações de pré-requisitos e reporte os resultados.
  • --primarySuc especifica essa propriedade no banco de dados stand-by do ambiente do Data Guard quando o comando é executado com sucesso no banco de dados principal
  • --resume retoma a execução anterior
    • --sessionID especifica para retomar um ID de sessão específico
  • --revert especifica para fazer rollback da execução anterior
    • --sessionID especifica para fazer rollback de um ID de sessão específico
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true|false

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde hsmToFile?

R: O comando dbaascli tde hsmToFile é usado para converter um TDE (Transparent Data Encryption) baseado no Módulo de Segurança de Hardware (HSM) em um TDE baseado em arquivo nos ambientes do Oracle Database Cloud Service.

P: Quais são os pré-requisitos para executar o comando dbaascli tde hsmToFile?

A: Você deve:
  • Execute o comando como usuário root.
  • Certifique-se de ter as permissões e configurações necessárias definidas no ambiente de banco de dados.

P: O que o parâmetro --dbname especifica?

R: O parâmetro --dbname especifica o nome do banco de dados para o qual você está convertendo o TDE de baseado em HSM para baseado em arquivo.

P: Quando o parâmetro --primaryDBWalletTar é necessário?

R: O parâmetro --primaryDBWalletTar só é necessário ao executar a conversão hsmToFile em um banco de dados stand-by. Especifica o arquivo tar da wallet do banco de dados principal.

P: Qual é a finalidade do parâmetro --skipPatchCheck?

R: O parâmetro --skipPatchCheck permite ignorar a verificação de validação dos patches necessários. Defina isso como true para ignorar a verificação ou false para aplicá-la.

P: Como executar apenas pré-verificações para o processo de conversão sem executar a conversão real?

R: Você pode usar o parâmetro --executePrereqs e defini-lo como yes para executar somente as pré-verificações. Defina-o como no para executar a conversão completa.

P: O que o parâmetro --primarySuc faz em um ambiente do Data Guard?

R: O parâmetro --primarySuc é usado em uma configuração do Data Guard para indicar que a conversão foi executada com sucesso no banco de dados principal. Ele deve ser usado ao executar a conversão no banco de dados stand-by.

P: Como posso retomar uma conversão hsmToFile anterior?

R: Você pode retomar uma conversão anterior usando o parâmetro --resume. Opcionalmente, você pode especificar o ID da sessão da execução anterior com --sessionID.

P: Qual é o propósito do parâmetro --revert?

R: O parâmetro --revert é usado para fazer rollback de um processo de conversão iniciado anteriormente em caso de falha ou se você precisar desfazer a operação.

P: O que acontece se eu definir --waitForCompletion como falso?

R: Se você definir --waitForCompletion como false, a operação será executada em segundo plano, permitindo que você continue outras tarefas. Se definido como true, o comando aguardará a conclusão do processo antes de retornar o controle ao usuário.

P: O que devo fazer se precisar converter a TDE em um banco de dados stand-by em uma configuração do Data Guard?

R: Em uma configuração do Data Guard, depois de converter TDE no banco de dados principal, você deve executar o comando no banco de dados stand-by usando o parâmetro --primaryDBWalletTar, especificando o arquivo tar da wallet do banco de dados principal e incluir --primarySuc.

P: O que devo fazer se quiser ignorar a verificação dos patches necessários durante a conversão?

R: Você pode ignorar a verificação de patch usando o parâmetro --skipPatchCheck e definindo-o como true.

P: Como verifico se o sistema está pronto para a conversão hsmToFile sem fazer alterações?

R: Você só pode executar as pré-verificações usando o parâmetro --executePrereqs e definindo-o como yes.

P: O que devo fazer se o processo de conversão for interrompido?

R: Você pode usar o parâmetro --resume para reiniciar o processo de onde ele parou. Opcionalmente, você pode especificar um ID de sessão específico com --sessionID.

P: O que devo fazer se o processo de conversão falhar?

R: Se a conversão falhar, você poderá fazer rollback do processo usando o parâmetro --revert. Além disso, revise quaisquer mensagens de erro e verifique os logs do sistema para obter mais detalhes.

P: Posso executar o comando dbaascli tde hsmToFile em um ambiente não Exadata?

R: Este comando foi projetado para uso em ambientes Exadata Cloud@Customer. Se você não estiver usando o Exadata, certifique-se de estar em um ambiente suportado para que o comando funcione corretamente.

Exemplo 7-50 dbaascli tde hsmToFile

dbaascli tde hsmToFile --dbname dbname
dbaascli tde hsmToFile --dbname dbname --executePrereqs
dbaascli tde hsmToFile --dbname dbname --resume
dbaascli tde listKeys

Para listar chaves principais de TDE, use o comando dbaascli tde listKeys.

Pré-Requisito

Execute o comando como usuário root.

Sintaxe

dbaascli tde listKeys
[--dbname <value>]
[--infoFilePath <value>]
Em que:
  • --dbname especifica o nome do banco de dados
  • --infoFilePath - especifique o caminho absoluto do arquivo no qual os resultados serão salvos.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde listKeys?

R: O comando dbaascli tde listKeys é usado para listar todas as chaves principais de TDE (Transparent Data Encryption) de um banco de dados especificado em um ambiente do Oracle Database.

P: Quais são os pré-requisitos para executar o comando dbaascli tde listKeys?

A: Você deve:
  • Execute o comando como usuário root.
  • Conecte-se a uma máquina virtual do Exadata Cloud@Customer usando SSH.

P: O que o parâmetro --file faz no comando dbaascli tde listKeys?

A: O parâmetro --file especifica o caminho do arquivo no qual a lista de chaves mestras de TDE deve ser salva. Se esse parâmetro não for fornecido, os resultados serão exibidos diretamente no terminal.

P: O que o parâmetro --dbname especifica?

A: O parâmetro --dbname especifica o nome do banco de dados cujas chaves principais de TDE você deseja listar.

P: O parâmetro --file é obrigatório?

A: Não, o parâmetro --file é opcional. Se não for fornecida, a lista de chaves de TDE será mostrada na saída do terminal, em vez de ser salva em um arquivo.

P: O parâmetro --dbname é obrigatório?

A: Não, o parâmetro --dbname é opcional. Se não for especificado, o comando listará as chaves principais de TDE para o banco de dados padrão configurado no sistema.

P: O que devo fazer se eu quiser salvar a lista de chaves em um arquivo?

R: Você deve fornecer o parâmetro --file junto com o caminho de arquivo desejado. Por exemplo:

dbaascli tde listKeys --file /path/to/output.txt

P: O que acontece se eu não fornecer um nome de banco de dados com --dbname?

R: Se o parâmetro --dbname não for fornecido, o comando listará as chaves principais de TDE para o banco de dados padrão no sistema.

P: Posso usar esse comando em ambientes diferentes do Exadata Cloud@Customer?

R: Este comando foi projetado especificamente para ambientes Exadata Cloud@Customer. Verifique se você está conectado à máquina virtual apropriada para executá-la.

P: O que devo fazer se o comando falhar ao listar chaves?

A: Certifique-se de que:
  • Você está executando o comando como o usuário root.
  • Você está conectado à máquina virtual do Exadata Cloud@Customer.
  • O nome do banco de dados (se especificado) está correto. Consulte as mensagens de erro e os logs para obter mais detalhes sobre a falha.

P: Posso executar o comando dbaascli tde listKeys enquanto o banco de dados está em execução?

R: Sim, o comando pode ser executado enquanto o banco de dados está em execução. Ele simplesmente lista as chaves principais de TDE e não altera o estado do banco de dados.

P: Preciso de permissões especiais para executar este comando?

R: Execute esse comando como usuário root. Sem permissões root, você não poderá executar o comando.

P: Qual é a finalidade de listar as chaves mestras de TDE?

R: A listagem de chaves principais de TDE permite que você revise as chaves de criptografia que estão sendo usadas para proteger os dados do seu banco de dados. É essencial para monitorar e gerenciar configurações de criptografia.

P: Como estabeleço conexão com a máquina virtual do Exadata Cloud@Customer para executar o comando?

R: Você pode se conectar à máquina virtual usando SSH. Consulte a documentação do Exadata Cloud@Customer para obter instruções sobre como estabelecer uma conexão segura.

Exemplo 7-51 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@Customer 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@Customer.
  • Os valores --secondaryKmsKeyOCID e --dbname corretos são fornecidos. Consulte 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@Customer para executar o comando?

R: Você pode se conectar à máquina virtual usando SSH. Consulte a documentação do Exadata Cloud@Customer para obter instruções sobre como estabelecer uma conexão segura.

Exemplo 7-52 dbaascli tde removeSecondaryHsmKey

dbaascli tde removeSecondaryHsmKey --dbname dbname
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs 
dbaascli tde rotateMasterKey

Para rotacionar a chave principal da criptografia de banco de dados, use o comando dbaascli tde rotateMasterKey.

Pré-requisitos:

Execute o comando como usuário root.

Sintaxe

dbaascli tde rotateMasterKey --dbname <value> 
[--rotateMasterKeyOnAllPDBs] 
[--pdbName <value>] 
[--executePrereqs] 
[--resume [--sessionID <value>]]
{
     [--prepareStandbyBlob <value> [--blobLocation <value>]]
     | [--standbyBlobFromPrimary <value>]
 }
Em que:
  • --dbname especifica o nome do Oracle Database
  • --rotateMasterKeyOnAllPDBs especifica true para rotacionar a chave principal de todos os PDBs no CDB. Valores válidos: true|false
  • --pdbName especifica o nome do PDB
  • --executePrereqs executa as verificações de pré-requisitos e reporta os resultados
  • --resume especifica a retomada da execução anterior
  • --sessionID especifica para retomar um ID de sessão específico
  • --prepareStandbyBlob especifica true para gerar um arquivo BLOB contendo os artefatos necessários para executar a operação em um ambiente do Data Guard
  • --blobLocation especifica o local do diretório personalizado no qual o arquivo BLOB stand-by será gerado em um ambiente do Data Guard
  • --standbyBlobFromPrimary especifica o local do arquivo BLOB stand-by, que é preparado usando o banco de dados principal. Isso só é necessário para operações stand-by.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde rotateMasterKey?

R: O comando dbaascli tde rotateMasterKey é usado para rotacionar a chave mestra usada para TDE (Transparent Data Encryption) em um Oracle Database. Esse processo garante que as chaves de criptografia sejam atualizadas para melhor segurança.

P: Quais são os pré-requisitos para executar o comando dbaascli tde rotateMasterKey?

A: Você deve:
  • Execute o comando como usuário root.
  • Certifique-se de que o banco de dados esteja configurado corretamente para TDE.

P: O que o parâmetro --dbname especifica?

R: O parâmetro --dbname especifica o nome do Oracle Database para o qual você deseja rotacionar a chave de criptografia principal.

P: Qual é a finalidade do parâmetro --rotateMasterKeyOnAllPDBs?

A: O parâmetro --rotateMasterKeyOnAllPDBs especifica se a chave principal deve ser rotacionada para todos os PDBs (Bancos de Dados Plugáveis) em um CDB (Banco de Dados Contêiner). Os valores válidos são verdadeiro ou falso.

P: O que o parâmetro --pdbName faz?

R: O parâmetro --pdbName especifica o nome de um PDB (Banco de Dados Plugável) específico se você quiser rotacionar a chave principal de um PDB específico em vez de todos os PDBs.

P: O que o parâmetro --executePrereqs faz?

R: O parâmetro --executePrereqs executa verificações de pré-requisitos para validar se o ambiente está pronto para a rotação da chave mestra sem executar a rotação real.

P: O que o parâmetro --resume especifica?

R: O parâmetro --resume é usado para retomar uma operação iniciada anteriormente. Você também pode fornecer um ID de sessão específico usando --sessionID para retomar uma sessão específica.

P: Qual é a finalidade do parâmetro --prepareStandbyBlob?

R: O parâmetro --prepareStandbyBlob, se definido como verdadeiro, gera um arquivo BLOB contendo os artefatos necessários para executar a rotação da chave principal em um ambiente do Data Guard.

P: O que o parâmetro --blobLocation faz?

R: O parâmetro --blobLocation especifica um caminho de diretório personalizado no qual o arquivo BLOB stand-by será gerado. Isso é aplicável quando --prepareStandbyBlob é definido como true.

P: O que o parâmetro --standbyBlobFromPrimary especifica?

R: O parâmetro --standbyBlobFromPrimary especifica o local do arquivo BLOB stand-by que foi gerado pelo banco de dados principal. Esse parâmetro é usado ao executar a rotação de chave mestra em um banco de dados stand-by em um ambiente do Data Guard.

P: O parâmetro --rotateMasterKeyOnAllPDBs é obrigatório?

A: Não, o parâmetro --rotateMasterKeyOnAllPDBs é opcional. Se ela não for especificada, a chave mestra só será rotacionada para o banco de dados (ou PDB específico) fornecido nos parâmetros --dbname ou --pdbName.

P: O parâmetro --pdbName será necessário se eu estiver rotacionando chaves para um CDB?

R: Não, o parâmetro --pdbName só será necessário se você quiser rotacionar a chave mestra de um PDB (Banco de Dados Plugável) específico. É opcional ao girar a chave de todo o CDB.

P: Preciso usar os parâmetros --prepareStandbyBlob e --standbyBlobFromPrimary para bancos de dados stand-alone?

R: Não, esses parâmetros só são relevantes em um ambiente do Data Guard em que um banco de dados stand-by está envolvido.

P: Como posso rotacionar a chave principal de todos os PDBs em um CDB?

R: Você deve usar o parâmetro --rotateMasterKeyOnAllPDBs definido como verdadeiro para rotacionar a chave principal de todos os PDBs no CDB. Por exemplo:

dbaascli tde rotateMasterKey --dbname CDB_NAME --rotateMasterKeyOnAllPDBs true

P: Como faço para executar uma verificação para validar se o sistema está pronto para a rotação da chave principal sem executar a operação real?

R: Você pode usar o parâmetro --executePrereqs para executar as verificações de pré-requisitos. Isso reportará quaisquer problemas que possam impedir a rotação da chave mestra:

dbaascli tde rotateMasterKey --dbname DB_NAME --executePrereqs

P: O que devo fazer se a operação for interrompida e eu quiser retomá-la?

R: Você pode usar o parâmetro --resume para retomar a operação interrompida anteriormente. Se você tiver um ID de sessão, forneça-o com o parâmetro --sessionID:

dbaascli tde rotateMasterKey --dbname DB_NAME --resume --sessionID <value>

P: Como posso me preparar para a rotação de chaves em um ambiente do Data Guard?

A: Você deve usar o parâmetro --prepareStandbyBlob para gerar um arquivo BLOB que contenha os artefatos necessários para rotacionar a chave principal em um ambiente stand-by:

dbaascli tde rotateMasterKey --dbname DB_NAME --prepareStandbyBlob true --blobLocation /path/to/blob

P: Como aplicar o arquivo BLOB stand-by do banco de dados principal ao rotacionar chaves em um banco de dados stand-by?

A: Use o parâmetro --standbyBlobFromPrimary para especificar o local do arquivo BLOB que foi preparado no banco de dados principal:

dbaascli tde rotateMasterKey --dbname DB_NAME --standbyBlobFromPrimary /path/to/blob

P: O que devo verificar se a rotação da chave mestra falha?

A: Certifique-se de que:
  • Você está executando o comando como o usuário root.
  • O nome do banco de dados (--dbname) está correto.
  • Todas as verificações de pré-requisitos foram executadas usando --executePrereqs para garantir a prontidão. Revise os logs de erro para obter informações mais detalhadas sobre a falha.

P: O que devo fazer se a operação não for concluída com sucesso em um ambiente do Data Guard?

R: Certifique-se de que o arquivo BLOB do banco de dados principal foi preparado corretamente usando --prepareStandbyBlob e, em seguida, use --standbyBlobFromPrimary para aplicá-lo no banco de dados stand-by.

P: Posso executar o comando dbaascli tde rotateMasterKey enquanto o banco de dados está em execução?

R: Sim, o comando pode ser executado enquanto o banco de dados está em execução. No entanto, é recomendável executar verificações de pré-requisitos de antemão usando a opção --executePrereqs.

P: Por que girar a chave mestra é importante?

R: A rotação da chave mestra melhora a segurança do banco de dados, garantindo que as chaves de criptografia usadas para proteção de dados sejam atualizadas periodicamente, reduzindo o risco de comprometimento da chave.

P: Preciso reiniciar o banco de dados após rotacionar a chave mestra?

R: Não, a reinicialização do banco de dados não é necessária após a rotação da chave mestra. A rotação de chaves entrará em vigor imediatamente sem qualquer interrupção do serviço.

dbaascli tde setKeyVersion

Para definir a versão da chave primária a ser usada no DB/CDB ou no PDB, use o comando dbaascli tde setKeyVersion.

Execute o comando como usuário root.

Sintaxe

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <value>
[--pdbName <value>]
[--masterKeyID <value>]
[--standbySuc]
[--executePrereqs]
[--waitForCompletion <value>]
Em que:
  • --kmsKeyVersionOCID especifica o OCID da versão da chave KMS a ser definido.
  • --dbname especifica o nome do banco de dados.
  • --pdbName nome do PDB para usar o OCID da versão da chave.
  • --masterKeyID especifica o ID da chave principal do OCID da versão da chave informada. Isso se aplica ao ambiente do Data Guard.
  • --standbySuc especifica essa propriedade no banco de dados principal do ambiente do Data Guard quando o comando é executado com sucesso no banco de dados stand-by
  • --executePrereqs - execute as verificações de pré-requisitos e reporte os resultados.
  • --waitForCompletion especifica false para executar a operação em segundo plano. Valores válidos: true|false

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde setKeyVersion?

R: O comando dbaascli tde setKeyVersion é usado para definir a versão da chave de criptografia primária que deve ser usada para Criptografia Transparente de Dados (TDE) em um banco de dados ou Banco de Dados Plugável (PDB). Isso permite que a versão específica de uma chave KMS seja designada ao banco de dados.

P: Quais são os pré-requisitos para usar o comando dbaascli tde setKeyVersion?

R: Execute o comando como usuário root e certifique-se de estar conectado a uma máquina virtual do Exadata Cloud@Customer.

P: O que o parâmetro --kmsKeyVersionOCID especifica?

A: O parâmetro --kmsKeyVersionOCID especifica o OCID (Oracle Cloud Identifier) da versão da chave KMS que você deseja definir para o banco de dados ou o PDB.

P: O que o parâmetro --dbname especifica?

A: O parâmetro --dbname especifica o nome do Oracle Database para o qual a versão da chave será definida.

P: Qual é a finalidade do parâmetro --pdbName?

R: O parâmetro --pdbName especifica o nome do PDB (Banco de Dados Plugável) em um CDB (Banco de Dados Contêiner) no qual você deseja definir a versão da chave KMS específica.

P: Para que o parâmetro --masterKeyID é usado?

A: O parâmetro --masterKeyID especifica o ID da chave principal que está associado ao OCID da versão da chave KMS informada. Isso é particularmente importante em um ambiente do Data Guard.

P: Qual é a atribuição do parâmetro --standbySuc?

A: O parâmetro --standbySuc é usado em um ambiente do Data Guard. Especifica que essa propriedade deve ser definida no banco de dados principal após a execução bem-sucedida do comando no banco de dados stand-by.

P: O que o parâmetro --executePrereqs faz?

R: O parâmetro --executePrereqs especifica se as verificações de pré-requisitos devem ser executadas antes da execução da operação. Os valores válidos são yes ou no.

P: O que o parâmetro --waitForCompletion controla?

R: O parâmetro --waitForCompletion determina se a operação será executada de forma síncrona (aguardando conclusão) ou assíncrona (em segundo plano). Os valores válidos são true ou false.

P: O parâmetro --pdbName é necessário se a versão da chave for definida para um CDB?

R: Não, o parâmetro --pdbName só será necessário se você estiver definindo a versão da chave para um PDB (Banco de Dados Plugável) específico. É opcional se você estiver definindo a versão da chave para todo o Banco de Dados Contêiner (CDB).

P: O parâmetro --masterKeyID é necessário para ambientes que não são do Data Guard?

R: Não, o parâmetro --masterKeyID geralmente só é usado em ambientes do Data Guard. Para bancos de dados independentes, esse parâmetro não é necessário.

P: Como defino a versão da chave para um banco de dados?

A: Você pode definir a versão da chave para um banco de dados executando:

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME>

P: Como defino a versão da chave para um PDB específico?

A: Para definir a versão da chave para um PDB (Banco de Dados Plugável) específico, use o parâmetro --pdbName com o nome do banco de dados:

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME> --pdbName <PDB_NAME>

P: Como posso garantir que todos os pré-requisitos sejam atendidos antes de definir a versão da chave?

A: Você pode executar as verificações de pré-requisitos usando o parâmetro --executePrereqs:

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --executePrereqs yes

P: Como defino a versão da chave em um ambiente do Data Guard?

A: Em um ambiente do Data Guard, você deve:
  • Execute o comando no banco de dados stand-by:

    dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --masterKeyID <keyID> --dbname <DB_NAME>

  • Após executar com sucesso o comando no banco de dados stand-by, execute o comando no banco de dados principal usando o parâmetro --standbySuc:

    dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME> --standbySuc yes

P: Como posso executar a operação em segundo plano sem esperar que ela seja concluída?

A: Você pode executar a operação de forma assíncrona definindo --waitForCompletion como false:

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --waitForCompletion false

P: O que devo fazer se a versão da chave não for definida?

A: Certifique-se de que:
  • Você está executando o comando como o usuário root.
  • O OCID da versão da chave KMS está correto.
  • Todas as verificações de pré-requisitos foram executadas usando --executePrereqs para garantir a prontidão. Revise os logs de erro para obter detalhes específicos e execute novamente a operação, se necessário.

P: O que devo verificar se a operação não foi concluída com sucesso em um ambiente do Data Guard?

R: Certifique-se de que o parâmetro --masterKeyID esteja especificado corretamente ao executar o comando no banco de dados stand-by. Uma vez concluído no stand-by, o parâmetro --standbySuc deverá ser usado ao executar o comando no banco de dados principal.

P: Posso executar o comando dbaascli tde setKeyVersion enquanto o banco de dados está em execução?

R: Sim, o comando pode ser executado enquanto o banco de dados está em execução. No entanto, é recomendável executar as verificações de pré-requisitos antecipadamente usando --executePrereqs.

P: Por que é importante definir a versão correta da chave KMS para um banco de dados?

A definição da versão correta da chave KMS garante que o banco de dados esteja usando a versão apropriada da chave de criptografia para TDE, o que ajuda a manter a segurança dos dados e a conformidade com as políticas organizacionais.

P: O que acontece se eu usar o OCID errado da versão da chave KMS?

R: Se um OCID incorreto da versão da chave KMS for usado, a criptografia poderá falhar e o banco de dados não poderá usar a chave incorreta para operações de criptografia. Certifique-se de que o OCID correto da versão da chave seja fornecido.

P: Preciso reiniciar o banco de dados após definir a versão da chave?

R: Não, a reinicialização do banco de dados não é necessária após definir a versão da chave. A nova versão da chave entrará em vigor imediatamente sem exigir uma reinicialização.

Exemplo 7-53 dbaascli tde setKeyVersion

dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha --executePrereqs
dbaascli tde setKeyVersion --dbname dbname --pdbName pdb --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
dbaascli tde setPrimaryHsmKey

Para alterar a chave HSM (KMS) primária para a configuração HSM (KMS) existente, use o comando dbaascli tde setPrimaryHsmKey.

Execute o comando como usuário root.

Sintaxe

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <value> --dbname <value>
[--allStandbyPrepared]
[--bounceDatabase]
[--executePrereqs]
[--resume [--sessionID <value>]]
Em que:
  • --primaryKmsKeyOCID especifica a chave KMS primária a ser definida
  • --dbname especifica o nome do banco de dados
  • --allStandbyPrepared - especifique para confirmar se a operação foi executada com sucesso em todos os bancos de dados stand-by.
  • --bounceDatabase especifica este flag para fazer bounce do banco de dados incremental para esta operação
  • --executePrereqs - execute as verificações de pré-requisitos e reporte os resultados.
  • --resume para retomar a execução anterior
  • --sessionID para retomar um id de sessão específico.

Perguntas Frequentes

P: Qual é a finalidade do comando dbaascli tde setPrimaryHsmKey?

R: O comando dbaascli tde setPrimaryHsmKey é usado para alterar a chave primária do HSM (Hardware Security Module) ou KMS (Key Management Service) em uma configuração existente do HSM/KMS para TDE (Transparent Data Encryption).

P: Quais são os pré-requisitos para executar o comando dbaascli tde setPrimaryHsmKey?

R: O comando deve ser executado como o usuário root e o ambiente deve ser uma máquina virtual do Exadata Cloud@Customer.

P: O que o parâmetro --primaryKmsKeyOCID especifica?

A: O parâmetro --primaryKmsKeyOCID especifica o OCID (Oracle Cloud Identifier) da chave KMS principal a ser definida para o ambiente de TDE.

P: Qual é a função do parâmetro --dbname?

A: O parâmetro --dbname especifica o nome do Oracle Database para o qual a chave principal do HSM/KMS será definida.

P: O que o parâmetro --standbySuc faz?

A: O parâmetro --standbySuc é usado em um ambiente do Data Guard. Ele especifica que o comando deve ser executado no banco de dados principal após sua execução com sucesso no banco de dados stand-by.

P: Qual é a finalidade do parâmetro --precheckOnly?

R: O parâmetro --precheckOnly permite que você execute somente as pré-verificações para esta operação. Ele valida o ambiente sem fazer alterações reais. Os valores válidos são yes ou no.

P: O que o parâmetro --bounceDatabase controla?

R: O parâmetro --bounceDatabase especifica se o banco de dados deve ser devolvido (reiniciado) de maneira incremental como parte da operação. Isso garante um tempo de inatividade mínimo reiniciando partes do banco de dados uma a uma.

P: Como defino a chave KMS principal do meu banco de dados?

A: Para definir a chave KMS primária, execute o seguinte comando:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME>

P: Como posso garantir que a operação possa ser executada sem problemas?

A: Execute a operação com o parâmetro --precheckOnly para verificar se todos os pré-requisitos foram atendidos:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --precheckOnly yes

P: Como defino a chave KMS principal em um ambiente do Data Guard?

A: Primeiro, execute o comando no banco de dados stand-by:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME>

Em seguida, execute o comando no banco de dados principal com o parâmetro --standbySuc:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME> --standbySuc yes

P: Como minimizo o tempo de inatividade ao alterar a chave KMS principal?

A: Você pode usar o parâmetro --bounceDatabase para executar uma reinicialização incremental, minimizando o tempo de inatividade:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --bounceDatabase

P: O parâmetro --dbname é necessário para todos os bancos de dados?

R: Sim, você deve especificar o parâmetro --dbname para indicar o banco de dados de destino para o qual a chave KMS principal deve ser definida.

P: É obrigatório usar o parâmetro --standbySuc em um ambiente do Data Guard?

R: Sim, o parâmetro --standbySuc deve ser usado ao executar o comando no banco de dados principal após executá-lo com sucesso no banco de dados stand-by.

P: Posso ignorar a operação de bounce do banco de dados?

R: Sim, se você não especificar o parâmetro --bounceDatabase, o banco de dados não será devolvido (reiniciado) como parte da operação.

P: O que devo fazer se o comando falhar durante a execução?

A: Se o comando falhar, certifique-se de:
  • Você o está executando como o usuário root.
  • Os valores --primaryKmsKeyOCID e --dbname corretos são fornecidos.
  • O ambiente passa por todas as verificações de pré-requisitos (executado com --precheckOnly).

P: E se a operação falhar em um ambiente do Data Guard?

R: Certifique-se de que o comando tenha sido executado com sucesso no banco de dados stand-by antes de executá-lo no principal. Verifique se há erros nos logs e execute novamente a operação com os parâmetros corretos.

P: Posso executar o comando dbaascli tde setPrimaryHsmKey em um banco de dados ativo?

R: Sim, o comando pode ser executado enquanto o banco de dados estiver ativo. No entanto, o uso do parâmetro --bounceDatabase reiniciará o banco de dados de forma incremental, o que minimiza o impacto.

P: Como faço para executar o comando de forma contínua para evitar tempo de inatividade completo?

A: Use o parâmetro --bounceDatabase para executar uma reinicialização incremental do banco de dados ao alterar a chave KMS principal:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --bounceDatabase

P: Qual é o significado de alterar a chave KMS primária?

R: A alteração da chave KMS principal garante que o banco de dados use uma chave de criptografia atualizada ou diferente para TDE (Transparent Data Encryption). Isso pode ser necessário por motivos de segurança ou conformidade.

P: Com que frequência a chave KMS primária deve ser girada ou alterada?

R: Embora não haja uma regra estrita, as organizações podem rotacionar a chave KMS principal com base em políticas de segurança, como intervalos de rotação de chaves ou requisitos de conformidade.

P: O que acontece se a chave KMS principal estiver definida incorretamente?

R: Se o OCID da chave incorreta for definido, as operações de criptografia do banco de dados poderão falhar e talvez você precise reverter para a chave correta ou retificar a configuração definindo o OCID da chave KMS correta.

P: Preciso reiniciar o banco de dados depois de alterar a chave KMS principal?

R: Não, você não precisa reiniciar o banco de dados, a menos que opte por usar o parâmetro --bounceDatabase, que reiniciará automaticamente o banco de dados para aplicar a alteração.

Exemplo 7-54 dbaascli tde setPrimaryHsmKey

dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs
dbaascli tde status

Para exibir informações sobre o armazenamento de chaves do banco de dados especificado, use o comando dbaascli tde status.

Pré-Requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli tde status --dbname dbname
Em que:
  • --dbname especifica o nome do banco de dados que você deseja verificar.

A saída do comando inclui o tipo e o status do armazenamento de chaves.

Perguntas Frequentes

P: O que o comando dbaascli tde status faz?

R: O comando dbaascli tde status exibe informações sobre o armazenamento de chaves de um banco de dados especificado. Isso inclui detalhes sobre o tipo de armazenamento de chaves e seu status.

P: Quem deve executar o comando dbaascli tde status?

A: O comando deve ser executado como o usuário oracle.

P: Onde o comando dbaascli tde status deve ser executado?

R: O comando deve ser executado em uma máquina virtual do Exadata Cloud@Customer. Você deve se conectar à máquina virtual via SSH para executar o utilitário.

P: Qual é a função do parâmetro --dbname?

R: O parâmetro --dbname especifica o nome do banco de dados para o qual o status da área de armazenamento de chaves de TDE será verificado.

P: Quais informações o comando dbaascli tde status retorna?

A: A saída do comando inclui o tipo de armazenamento de chaves (por exemplo, baseado em HSM ou baseado em arquivo) e o status atual do armazenamento de chaves, como se ele está aberto, fechado ou em algum outro estado.

P: Como posso saber se a área de armazenamento de chaves está aberta ou fechada usando o comando dbaascli tde status?

R: O status da área de armazenamento de chaves, incluindo se ela está aberta ou fechada, faz parte da saída retornada pelo comando dbaascli tde status.

P: Como verifico o status do armazenamento de chaves de TDE de um banco de dados específico?

A: Para verificar o status da área de armazenamento de chaves de TDE para um banco de dados específico, execute:

dbaascli tde status --dbname <DB_NAME>

P: Posso verificar o status da área de armazenamento de chaves para vários bancos de dados?

R: Sim, mas você precisa executar o comando separadamente para cada banco de dados, especificando seu nome usando o parâmetro --dbname.

P: O comando dbaascli tde status pode ser executado como usuário raiz?

R: Não, o comando deve ser executado como o usuário oracle, não como o usuário root.

P: Preciso de permissões especiais para executar o comando dbaascli tde status?

R: Sim, você precisa ter privilégios de usuário oracle e estar conectado a uma máquina virtual do Exadata Cloud@Customer para executar o comando.

P: O que devo fazer se obtiver um erro ao executar o comando de status dbaascli tde?

R: Certifique-se de que esteja executando o comando como o usuário oracle e verifique se você tem as permissões necessárias e se está conectado à máquina virtual correta.

P: Como sei que tipo de armazenamento de chaves meu banco de dados está usando?

R: O tipo de armazenamento de chaves, como se fosse baseado em arquivo ou HSM/KMS, é exibido na saída do comando dbaascli tde status.

P: O que devo fazer se a área de armazenamento de chaves estiver fechada?

R: Se a área de armazenamento de chaves estiver fechada, talvez seja necessário abri-la manualmente, dependendo da operação que você está tentando executar. O processo exato dependerá do tipo de armazenamento de chaves e do seu ambiente.

P: Posso exibir o status da área de armazenamento de chaves de um CDB (Banco de Dados Contêiner) ou PDB (Banco de Dados Plugável)?

R: Sim, especificando o nome do banco de dados apropriado usando o parâmetro --dbname, você pode exibir o status do armazenamento de chaves para CDBs e PDBs.

P: O que significa se o comando retornar um erro sobre a conectividade do banco de dados?

R: Isso pode indicar um problema com a conexão com o banco de dados ou um problema com seu ambiente. Certifique-se de que o banco de dados esteja em execução e acessível e verifique sua conexão SSH com a máquina virtual do Exadata Cloud@Customer.

P: O que acontece se o nome do banco de dados estiver incorreto?

R: Se o parâmetro --dbname especificar um banco de dados incorreto ou não existente, o comando falhará e você receberá uma mensagem de erro indicando o problema.

P: Como solucionar problemas se o status da área de armazenamento de chaves indicar um estado inesperado?

R: Se o status da área de armazenamento de chaves indicar um estado inesperado, revise os logs do banco de dados para obter mais detalhes e verifique a configuração da área de armazenamento de chaves para garantir que ela esteja configurada corretamente.

P: Posso automatizar a verificação do status da área de armazenamento de chaves para fins de monitoramento?

R: Sim, você pode criar script do comando dbaascli tde status para verificar o status do armazenamento de chaves periodicamente ou integrá-lo às suas ferramentas de monitoramento de banco de dados.

P: Como verifico se a Criptografia Transparente de Dados (TDE) está ativada corretamente?

R: Você pode verificar se a TDE está ativada corretamente verificando o status do armazenamento de chaves usando o comando dbaascli tde status. Uma área de armazenamento de chaves válida e aberta indica que a TDE está configurada corretamente.

Exemplo 7-55 status dbaascli tde

dbaascli tde status --dbname dbname

Comandos dbaascli obsoletos

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.

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 tde status

Para exibir informações sobre o armazenamento de chaves do banco de dados especificado, use o comando dbaascli tde status.

Pré-Requisito

Execute o comando como usuário oracle.

Sintaxe

dbaascli tde status --dbname dbname
Em que:
  • --dbname especifica o nome do banco de dados que você deseja verificar.

A saída do comando inclui o tipo e o status do armazenamento de chaves.

Perguntas Frequentes

P: O que o comando dbaascli tde status faz?

R: O comando dbaascli tde status exibe informações sobre o armazenamento de chaves de um banco de dados especificado. Isso inclui detalhes sobre o tipo de armazenamento de chaves e seu status.

P: Quem deve executar o comando dbaascli tde status?

A: O comando deve ser executado como o usuário oracle.

P: Onde o comando dbaascli tde status deve ser executado?

R: O comando deve ser executado em uma máquina virtual do Exadata Cloud@Customer. Você deve se conectar à máquina virtual via SSH para executar o utilitário.

P: Qual é a função do parâmetro --dbname?

R: O parâmetro --dbname especifica o nome do banco de dados para o qual o status da área de armazenamento de chaves de TDE será verificado.

P: Quais informações o comando dbaascli tde status retorna?

A: A saída do comando inclui o tipo de armazenamento de chaves (por exemplo, baseado em HSM ou baseado em arquivo) e o status atual do armazenamento de chaves, como se ele está aberto, fechado ou em algum outro estado.

P: Como posso saber se a área de armazenamento de chaves está aberta ou fechada usando o comando dbaascli tde status?

R: O status da área de armazenamento de chaves, incluindo se ela está aberta ou fechada, faz parte da saída retornada pelo comando dbaascli tde status.

P: Como verifico o status do armazenamento de chaves de TDE de um banco de dados específico?

A: Para verificar o status da área de armazenamento de chaves de TDE para um banco de dados específico, execute:

dbaascli tde status --dbname <DB_NAME>

P: Posso verificar o status da área de armazenamento de chaves para vários bancos de dados?

R: Sim, mas você precisa executar o comando separadamente para cada banco de dados, especificando seu nome usando o parâmetro --dbname.

P: O comando dbaascli tde status pode ser executado como usuário raiz?

R: Não, o comando deve ser executado como o usuário oracle, não como o usuário root.

P: Preciso de permissões especiais para executar o comando dbaascli tde status?

R: Sim, você precisa ter privilégios de usuário oracle e estar conectado a uma máquina virtual do Exadata Cloud@Customer para executar o comando.

P: O que devo fazer se obtiver um erro ao executar o comando de status dbaascli tde?

R: Certifique-se de que esteja executando o comando como o usuário oracle e verifique se você tem as permissões necessárias e se está conectado à máquina virtual correta.

P: Como sei que tipo de armazenamento de chaves meu banco de dados está usando?

R: O tipo de armazenamento de chaves, como se fosse baseado em arquivo ou HSM/KMS, é exibido na saída do comando dbaascli tde status.

P: O que devo fazer se a área de armazenamento de chaves estiver fechada?

R: Se a área de armazenamento de chaves estiver fechada, talvez seja necessário abri-la manualmente, dependendo da operação que você está tentando executar. O processo exato dependerá do tipo de armazenamento de chaves e do seu ambiente.

P: Posso exibir o status da área de armazenamento de chaves de um CDB (Banco de Dados Contêiner) ou PDB (Banco de Dados Plugável)?

R: Sim, especificando o nome do banco de dados apropriado usando o parâmetro --dbname, você pode exibir o status do armazenamento de chaves para CDBs e PDBs.

P: O que significa se o comando retornar um erro sobre a conectividade do banco de dados?

R: Isso pode indicar um problema com a conexão com o banco de dados ou um problema com seu ambiente. Certifique-se de que o banco de dados esteja em execução e acessível e verifique sua conexão SSH com a máquina virtual do Exadata Cloud@Customer.

P: O que acontece se o nome do banco de dados estiver incorreto?

R: Se o parâmetro --dbname especificar um banco de dados incorreto ou não existente, o comando falhará e você receberá uma mensagem de erro indicando o problema.

P: Como solucionar problemas se o status da área de armazenamento de chaves indicar um estado inesperado?

R: Se o status da área de armazenamento de chaves indicar um estado inesperado, revise os logs do banco de dados para obter mais detalhes e verifique a configuração da área de armazenamento de chaves para garantir que ela esteja configurada corretamente.

P: Posso automatizar a verificação do status da área de armazenamento de chaves para fins de monitoramento?

R: Sim, você pode criar script do comando dbaascli tde status para verificar o status do armazenamento de chaves periodicamente ou integrá-lo às suas ferramentas de monitoramento de banco de dados.

P: Como verifico se a Criptografia Transparente de Dados (TDE) está ativada corretamente?

R: Você pode verificar se a TDE está ativada corretamente verificando o status do armazenamento de chaves usando o comando dbaascli tde status. Uma área de armazenamento de chaves válida e aberta indica que a TDE está configurada corretamente.

Exemplo 7-56 status dbaascli tde

dbaascli tde status --dbname dbname