Usando o Utilitário dbaascli no Oracle Exadata Database Service na Infraestrutura do Exascale
Aprenda a usar o utilitário dbaascli no Oracle Exadata Database Service na Infraestrutura do Exascale.
- Sobre o Uso do Utilitário dbaascli no Oracle Exadata Database Service na Infraestrutura do Exascale
Você pode usar o utilitáriodbaasclipara executar várias operações de ciclo de vida e administração do banco de dados no Oracle Exadata Database Service na Infraestrutura do Exascale - Criando Bancos de Dados com o dbaascli
Usando odbaascli, você pode criar um Banco de Dados Oracle primeiramente criando um home do Banco de Dados Oracle da versão desejada, seguido pela criação de um banco de dados nesse home - Alterando as Senhas do Banco de Dados
Para alterar a senha SYS ou a senha da wallet de TDE, use este procedimento. - Gerenciando Imagens de Software do Oracle Exadata Database Service no Exascale Infrastructure com o Utilitário Dbaascli
Você pode listar e fazer download das imagens do software do banco de dados Oracle em uma instância do Oracle Exadata Database Service no Exascale Infrastructure, que depois podem ser usadas para provisionar um home do banco de dados. - Coletar Logs de Ferramentas da Nuvem e Executar uma Verificação de Integridade das Ferramentas da Nuvem Usando dbaascli
O uso do comando dbaasclidiagpermite coletar logs de ferramentas da VM Convidadadbaaspara os sistemas Exadata Database Service on Dedicated Infrastructure e Exadata Database Service on Cloud@Customer. Você pode usar esses logs para solucionar problemas relacionados às ferramentasdbaas. - Atualizando o Conjunto de Ferramentas da Nuvem com o Utilitário dbaascli
Para atualizar a release do conjunto de ferramentas da nuvem do Oracle Exadata Database Service no Exascale Infrastructure, execute este procedimento. - Criando um Banco de Dados Duplicado
- Referência de Comando dbaascli
Usedbaasclipara criar bancos de dados e integrá-los à estrutura de automação da nuvem.
Sobre o Uso do Utilitário dbaascli no Oracle Exadata Database Service na Infraestrutura do Exascale
Você pode usar o utilitário dbaascli para executar várias operações de ciclo de vida e administração do banco de dados no Oracle Exadata Database Service no Exascale Infrastructure
Por exemplo, com dbaascli, você pode alterar a senha de um usuário do banco de dados, iniciar um banco de dados ou gerenciar bancos de dados plugáveis (PDBs) e muito mais.
Use a console ou a interface de linha de comando do Oracle Cloud Infrastructure para dimensionar recursos. Os recursos do utilitário dbaascli são adicionais e distintos na Console, na API ou na interface de linha de comando (CLI). A menos que especificado de forma diferente, você precisará de acesso root ao dbaascli para executar todos os comandos de administração.
Para usar o utilitário, você deve estar conectado a uma máquina virtual do Oracle Exadata Database Service no Exascale Infrastructure.
Para obter os comandos possíveis disponíveis com o dbaascli, execute dbaascli --help.
Para obter ajuda específica do comando, execute dbaascli command --help. Por exemplo, dbaascli database create --help.
Consulte Referência de Comando do dbasscli no documento para obter comandos e informações específicas do comando.
Criando Bancos de Dados com o dbaascli
Usando o dbaascli, você pode criar um Banco de Dados Oracle criando primeiramente um home de banco de dados Oracle da versão desejada, seguido pela criação de um banco de dados nesse home
- Listando Imagens e Versões de Software Disponíveis para o Banco de Dados e o Grid Infrastructure
Para produzir uma lista de versões suportadas disponíveis para aplicação de patch, use o comandodbaascli 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 comandodbaascli 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 comandodbaascli database create.
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.
- 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.
- Inicie um shell de comando do usuário
root:sudo -s - Execute o seguinte comando:
dbaascli cswlib showImages --product databaseA saída do comando lista as imagens de software de banco de dados disponíveis.
dbaascli cswlib showImages --product gridA saída do comando lista as imagens de software de grade disponíveis.
- Saia do shell de comando do usuário
root:exitPara obter mais detalhes sobre opções avançadas suportadas, consulte
dbaascli cswlib showImages.
Exemplo 6-1 dbaascli cswlib showImages
[root@dg11lrg1 dbhome_1]# dbaascli cswlib showImages
DBAAS CLI version <version>
Executing command cswlib
showImagesJob id: 00e89b1a-1607-422c-a920-22f44bec1953Log file location:
/var/opt/oracle/log/cswLib/showImages/dbaastools_2022-05-11_08-49-12-AM_46941.log
############
List of Available Database Images
#############
17.IMAGE_TAG=18.17.0.0.0
VERSION=18.17.0.0.0
DESCRIPTION=18c JAN 2022 DB Image
18.IMAGE_TAG=19.10.0.0.0
VERSION=19.10.0.0.0
DESCRIPTION=19c JAN 2021 DB Image
19.IMAGE_TAG=19.11.0.0.0
VERSION=19.11.0.0.0
DESCRIPTION=19c APR 2021 DB Image
20.IMAGE_TAG=19.12.0.0.0
VERSION=19.12.0.0.0
DESCRIPTION=19c JUL 2021 DB Image
21.IMAGE_TAG=19.13.0.0.0
VERSION=19.13.0.0.0
DESCRIPTION=19c OCT 2021 DB Image
Images can be downloaded using their image tags. For details, see help using 'dbaascli cswlib download --help'.
dbaascli execution completed
Tópicos Relacionados
Tópico principal: Criando Bancos de Dados com o dbaascli
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.
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).
- 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.
- Inicie um shell de comando do usuário
root:sudo -s - Execute o seguinte comando:
dbaascli dbhome create --version Oracle Home Version --imageTag image Tag ValueEm que:--versionespecifica a versão do Oracle Database--imageTagespecifica a Tag da Imagem a ser usada
Por exemplo:dbaascli dbhome create --version 23.26.0.0.0Observação
A especificação deimageTagé opcional. Para exibir as Tags de Imagem, consulte o comandodbaascli 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. - Saia do shell de comando do usuário
root:exitPara obter mais detalhes sobre opções avançadas suportadas, consulte
dbaascli dbhome create.
Tópicos Relacionados
Tópico principal: Criando Bancos de Dados com o dbaascli
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.
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.
- O utilitário dbaascli só é compatível com o provisionamento do Oracle AI Database 26ai no Oracle Exadata Database Service on Exascale Infrastructure. A Oracle recomenda que você use a API baseada na console do OCI em vez de dbaascli para provisionar o Oracle Database 19c neste serviço.
- 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.
- Inicie um shell de comando do usuário
root:sudo -s - Execute o seguinte comando:
dbaascli database create --dbName database name --oracleHome Oracle Home PathEm que:--dbNameespecifica o nome do banco de dados--oracleHomeespecifica o local do Oracle home
Para criar um CDB, execute o seguinte comando:dbaascli database create --dbName database name --oracleHome Oracle Home PathPara criar um não CDB, execute o seguinte comando:dbaascli database create --dbName database name --oracleHome Oracle Home Path --createAsCDB falseQuando solicitado, digite as senhas
sysetde. - Saia do shell de comando do usuário
root:exitPara 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. - 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--resumeou--revert.
Tópicos Relacionados
Tópico principal: Criando Bancos de Dados com o dbaascli
Executando Verificações de Pré-requisitos antes de Criar o Banco de Dados Oracle
Para executar verificações de pré-requisitos, use a opção de comando --executePrereqs. Isso executará apenas as verificações de pré-requisitos sem executar a criação real do Banco de Dados Oracle.
- 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.
- Inicie um shell de comando do usuário
root:sudo -s - Execute o seguinte comando:
dbaascli database create --dbName database name --oracleHome Oracle Home Path --executePrereqsEm que:--dbNameespecifica o nome do banco de dados--oracleHomeespecifica o local do Oracle home
- Saia do shell de comando do usuário
root:exitPara obter mais detalhes sobre opções avançadas suportadas, consulte
dbaascli database create.
Tópicos Relacionados
Tópico principal: Criando o Banco de Dados Oracle no Home Especificado
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.
dbaascli database create --dbName database name --oracleHome Oracle Home Path --resume- Ao usar as opções de comando
--resumeou--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.
Tópicos Relacionados
Tópico principal: Criando o Banco de Dados Oracle no Home Especificado
Alterando as Senhas do Banco de Dados
Para alterar a senha SYS ou a senha da wallet de TDE, use este procedimento.
A senha especificada no campo Senha de Administrador do Banco de Dados quando você cria uma nova instância ou banco de dados Oracle Exadata Database Service on Exascale Infrastructure é definida como senha das credenciais SYS, SYSTEM, wallet de TDE e administrador do PDB. Use os procedimentos a seguir se precisar alterar as senhas de um banco de dados existente.
Se você estiver ativando a Data Guard para um banco do dados, a senha SYS e a senha da wallet TDE dos bancos de Dados principal e stand-by deverão ser iguais.
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.
Gerenciando Imagens de Software do Oracle Exadata Database Service no Exascale Infrastructure com o Utilitário Dbaascli
Você pode listar e fazer download das imagens do software do banco de dados Oracle em uma instância do Oracle Exadata Database Service no Exascale Infrastructure, que depois podem ser usadas para provisionar um home do banco de dados.
Você pode criar imagens de software de banco de dados personalizadas para suas instâncias do Oracle Exadata Database Service no Exascale Infrastructure usando a Console ou a API. Essas imagens são armazenadas no serviço Object Storage e podem ser usadas para provisionar um Home de Banco de Dados na instância do Exadata. Consulte Imagens de Software do Oracle Database para obter mais informações.
Você pode controlar a versão de binários Oracle que são instalados quando você provisiona um novo banco de dados em uma instância do Oracle Exadata Database Service no Exascale Infrastructure mantendo as imagens de software no sistema. A Oracle fornece uma biblioteca de imagens de software na nuvem que você pode exibir e submeter a download para sua instância usando o utilitário dbaascli.
- Listando Imagens e Versões de Software Disponíveis para o Banco de Dados e o Grid Infrastructure
Para produzir uma lista de versões suportadas disponíveis para aplicação de patch, use o comandodbaascli cswlib showImages. - Para fazer download de uma imagem de software
Você pode fazer download de imagens de software disponíveis para seu Oracle Exadata Database Service na instância do Exascale Infrastructure usando o subcomandocswlib downloaddo utilitáriodbaascli.
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.
- 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.
- Inicie um shell de comando do usuário
root:sudo -s - Execute o seguinte comando:
dbaascli cswlib showImages --product databaseA saída do comando lista as imagens de software de banco de dados disponíveis.
dbaascli cswlib showImages --product gridA saída do comando lista as imagens de software de grade disponíveis.
- Saia do shell de comando do usuário
root:exitPara obter mais detalhes sobre opções avançadas suportadas, consulte
dbaascli cswlib showImages.
Exemplo 6-2 dbaascli cswlib showImages
[root@dg11lrg1 dbhome_1]# dbaascli cswlib showImages
DBAAS CLI version <version>
Executing command cswlib
showImagesJob id: 00e89b1a-1607-422c-a920-22f44bec1953Log file location:
/var/opt/oracle/log/cswLib/showImages/dbaastools_2022-05-11_08-49-12-AM_46941.log
############
List of Available Database Images
#############
17.IMAGE_TAG=18.17.0.0.0
VERSION=18.17.0.0.0
DESCRIPTION=18c JAN 2022 DB Image
18.IMAGE_TAG=19.10.0.0.0
VERSION=19.10.0.0.0
DESCRIPTION=19c JAN 2021 DB Image
19.IMAGE_TAG=19.11.0.0.0
VERSION=19.11.0.0.0
DESCRIPTION=19c APR 2021 DB Image
20.IMAGE_TAG=19.12.0.0.0
VERSION=19.12.0.0.0
DESCRIPTION=19c JUL 2021 DB Image
21.IMAGE_TAG=19.13.0.0.0
VERSION=19.13.0.0.0
DESCRIPTION=19c OCT 2021 DB Image
Images can be downloaded using their image tags. For details, see help using 'dbaascli cswlib download --help'.
dbaascli execution completed
Coletar Logs de Ferramentas da Nuvem e Executar uma Verificação de Integridade das Ferramentas da Nuvem Usando dbaascli
O uso do comando dbaascli diag permite coletar logs de ferramentas da VM Convidada dbaas para os sistemas Exadata Database Service on Dedicated Infrastructure e Exadata Database Service on Cloud@Customer. Você pode usar esses logs para solucionar problemas relacionados às ferramentas dbaas.
diag para coletar logs dbaastools e executar uma verificação de integridade em todos os nós de um cluster do Exadata. Observe que há suporte para as opções --waitForCompletion a partir da versão 22.4.1
- Os comandos dbaascli
diagdevem ser executados como usuárioroot - A execução do comando
dbaascli diag collectem um único nó coletará dados de log de todos os nós - É recomendável executar os comandos documentados neste tópico usando a opção
--waitForCompletionpara comandos de execução longa. Consulte os exemplos de uso de amostra.
Para obter informações sobre a atualização do Exadata Cloud Tooling, consulte dbaascli admin updateStack.
- Coletando Exemplos de Dados de Log de Ferramentas
O comando de coleta dbaascli dbaascli diag usa a sintaxe mostrada abaixo para coletar dados de log de ferramentas: - Exemplos de Execução da Verificação de Integridade
Use o comando dbaasclidbaascli diag healthcheckpara executar uma verificação de integridade em todos os nós do sistema.
Tópicos Relacionados
Exemplos de Coleta de Dados de Log de Ferramentas
O comando de coleta dbaascli dbaascli diag usa a sintaxe mostrada abaixo para coletar dados de log de ferramentas:
Consulte dbaascli diag collect na Referência de Comando dbaascli para obter detalhes da sintaxe
# dbaascli diag collect
DBAAS CLI version 24.1.1.0.0
Executing command diag collect
Job id: 92f33125-aa70-4ce2-94fb-64d8f1cbdc93
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_07-20-44-PM_83383.log
Loading PILOT...
Session ID of the current execution is: 10
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_07-20-48-PM_83856
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
"collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-1920/diag_cloudlogs_20231214-1920_node1.zip=a0d049b87ab9e9cec2ab7d95ded4903bac818c81c8b6a46d295e1e75f4630e19}"
}
dbaascli execution completed
# dbaascli diag collect --waitForCompletion false
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --waitForCompletion false
Job id: 5b556976-dba1-4be9-a4fe-4b58e69c1d96
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_07-23-26-PM_98107.log
Job accepted. Use "dbaascli job getStatus --jobID 5b556976-dba1-4be9-a4fe-4b58e69c1d96" to check the job status.
Use o comando de status do job para monitorar o andamento.
# dbaascli diag collect --dbnames myOracleDatabase19cName
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --dbnames myOracleDatabase19cName
Job id: 8e1d2667-4649-4384-8610-b6348d6548ac
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_08-41-41-PM_88831.log
Loading PILOT...
Session ID of the current execution is: 12
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_08-41-45-PM_89361
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
"collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2041/diag_cloudlogs_20231214-2041_node1.zip=9e50500089a74ca7cd8ae08550c06868e26e1cd9c52e808194256594f63397e4}"
}
dbaascli execution completed# dbaascli diag collect --destLocation /tmp/test/
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --destLocation /tmp/test/
Job id: f992afdf-415e-4b58-ab5b-9e38f8c2079d
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-42-54-PM_16270.log
Loading PILOT...
Session ID of the current execution is: 14
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-42-58-PM_16777
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
"collectedArchive with SHA256 CheckSum" : "{/tmp/test/diag_collect/artifacts_diag_cloudlogs_20231214-2143/diag_cloudlogs_20231214-2143_node1.zip=8a26cffcfdd72c261660d4f736c615981856e357749d90751b94f3eda19a9a70}"
}
dbaascli execution completed# dbaascli diag collect --startTime 2023-12-05T10:00:00 --endTime 2023-12-05T11:00:00
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --startTime 2023-12-05T10:00:00 --endTime 2023-12-05T11:00:00
Job id: 70b03e50-98cc-4c2b-9684-1f82070bac88
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-45-17-PM_42856.log
Loading PILOT...
Session ID of the current execution is: 15
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-45-21-PM_43526
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
"collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2145/diag_cloudlogs_20231214-2145_node1.zip=b44cf3bfca1ab7a1629dd83098a7772790ab949e50dbb3950f0017e427d7bd05}"
}
dbaascli execution completed# dbaascli diag collect --nodes node1,node2
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --nodes node1,node2
Job id: fa70da09-3de6-4cc8-854c-a739b4fc2ceb
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-46-58-PM_55884.log
Loading PILOT...
Session ID of the current execution is: 16
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-47-02-PM_56418
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
"collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2147/diag_cloudlogs_20231214-2147_node1.zip=de2805c9c6c2af2d602395a84d37747935327b73a6c73052282665a8410eb41f}"
}# dbaascli diag collect --components dbaastools
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --components dbaastools
Job id: da941d3c-5191-4ced-b1bb-9b083fa75865
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-47-23-PM_68256.log
Loading PILOT...
Session ID of the current execution is: 17
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-47-27-PM_68729
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
"collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2147/diag_cloudlogs_20231214-2147_node1.zip=d1f290fb42c981935e1142ec059c2dbba8be2e0a9ffebc9eea83a6336abe2eed}"
}
dbaascli execution completed# dbaascli diag collect --objectStoreBucketUri https://objectstorage.us-phoenix-1.oraclecloud.com/p/aL-IbIKQ1j6lWNftJc2rLoLh6o9bJgbZm8z0S--BeVuXaipSEEMISrSCfFrVEolG/n/intexadatateam/b/diag_collect_test/o/
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --objectStoreBucketUri https://objectstorage.us-phoenix-1.oraclecloud.com/p/aL-IbIKQ1j6lWNftJc2rLoLh6o9bJgbZm8z0S--BeVuXaipSEEMISrSCfFrVEolG/n/intexadatateam/b/diag_collect_test/o/
Job id: 028151b7-cbc4-409a-9ec6-69affe10f3bb
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-51-36-PM_2963.log
Loading PILOT...
Session ID of the current execution is: 20
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-51-40-PM_3555
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
"collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2151/diag_cloudlogs_20231214-2151_node1.zip=71633e13ccd06de15cb26850bb0266cf0d869e259550515c5b1fb734c487b470}"
}
dbaascli execution completedTópicos Relacionados
Exemplos de Execução de uma Verificação de Integridade
Use o comando dbaascli dbaascli diag healthcheck para executar uma verificação de integridade em todos os nós do sistema.
Consulte dbaascli diag healthcheck para obter os detalhes da sintaxe na Referência de Comando dbaascli.
# dbaascli diag healthcheck
DBAAS CLI version MAIN
Executing command diag healthcheck
INFO: Starting diag healthcheck
INFO: Collected diag logs at: /var/opt/oracle/dbaas_acfs/diag_cloudlogs_20210322-2246.tar.gz
# dbaascli diag healthcheck --destLocation /tmp/test
DBAAS CLI version MAIN
Executing command diag healthcheck --destLocation /tmp/test
INFO: Starting diag healthcheck
INFO: Collected diag logs at: /tmp/test/diag_cloudlogs_20210322-2250.tar.gz
# dbaascli diag healthcheck --nodes rbcl1,rbcl2
DBAAS CLI version MAIN
Executing command diag healthcheck --nodes rbcl1,rbcl2
INFO: Starting diag healthcheck
INFO: Collected diag logs at: /var/opt/oracle/dbaas_acfs/diag_cloudlogs_20210421-1915.tar.gz
# dbaascli diag healthcheck --objectStoreBucketUri https://objectstorage.us-phoenix-1.oraclecloud.com/p/t0Z-kRV5pSmFzqnf-y5XhaAbM4LS82epeBnulKnCr31IeHVjxI9tOkntLF2kq7fP/n/MyNamespace/b/MyParBucket/o/
DBAAS CLI version MAIN
Executing command diag healthcheck --objectStoreBucketUri https://objectstorage.us-phoenix-1.oraclecloud.com/p/t0Z-kRV5pSmFzqnf-y5XhaAbM4LS82epeBnulKnCr31IeHVjxI9tOkntLF2kq7fP/n/MyNamespace/b/MyParBucket/o/
INFO: Collected diag logs at: https://objectstorage.us-phoenix-1.oraclecloud.com/p/t0Z-kRV5pSmFzqnf-y5XhaAbM4LS82epeBnulKnCr31IeHVjxI9tOkntLF2kq7fP/n/MyNamespace/b/MyParBucket/o/diag_cloudlogs_20210421-1839.tar.gz
Atualizando o Conjunto de Ferramentas da Nuvem com o Utilitário dbaascli
Para atualizar a release do conjunto de ferramentas da nuvem no Oracle Exadata Database Service no Exascale Infrastructure, execute este procedimento.
O conjunto de ferramentas específico da nuvem é usado no Oracle Exadata Database Service em VMs Guest da Infraestrutura do Exascale para operações locais, incluindo comandos dbaascli.
Você pode atualizar as ferramentas específicas da nuvem fazendo download e aplicando um pacote de software contendo as ferramentas atualizadas.
- 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.
- Inicie um shell de comando do usuário
root:sudo -s - Para atualizar para a release mais recente disponível do conjunto de ferramentas da nuvem, execute o seguinte comando:
dbaascli admin updateStackO 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.
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 comandodbaascli. - 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
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.
Tópico principal: Criando um Banco de Dados Duplicado
Considerações ao Usar o OCI Vault para o Gerenciamento de Chaves
Esta seção só é aplicável se o banco de dados estiver configurado com o OCI Vault para criptografia de TDE e você quiser duplicar um banco de dados.
Duplicando um banco de dados na mesma região
- Etapas adicionais de pré-requisito
Certifique-se de configurar políticas de acesso do OCI Vault para nós do banco de dados de destino. Os nós do banco de dados de destino devem poder acessar o cofre de chaves do OCI do banco de dados de origem juntamente com seu novo cofre de chaves (se for decidido usar o cofre de chaves separado).
- Executar verificações de pré-requisitos
dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID> --executePrereqs - Duplicar o banco de dados
dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID>Após a conclusão bem-sucedida desse comando, o banco de dados será duplicado.
Duplicando um banco de dados entre regiões
- Etapas adicionais de pré-requisito
- Configure um novo OCI Vault para o banco de dados de destino na região correspondente seguindo as etapas descritas em Preparar-se para Usar Chaves Gerenciadas pelo Cliente no Serviço Vault. Conclua as Tarefas de 1 a 3.
- Configurar a replicação do OCI Vault da região de origem para a região de destino. Para obter mais informações, consulte Replicando Vaults e Chaves.
- Atualize a política de grupo Dinâmico, que é criada na etapa 2 para permitir o acesso à chave replicada do OCI Vault.
- Executar verificações de pré-requisitos
dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID> --executePrereqs - Duplicar o banco de dados
dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID>Após a conclusão bem-sucedida desse comando, o banco de dados será duplicado.
Tópico principal: Criando um Banco de Dados Duplicado
Referência de Comando do dbaascli
Use dbaascli para criar bancos de dados e integrá-los à estrutura de automação na nuvem.
dbaascli é uma interface nativa da nuvem que pode usar modelos DBCA como entradas, chama a funcionalidade do DBCA para criar bancos de dados e, em seguida, chama as APIs do OCI para integrar o banco de dados no framework de automação da nuvem. Os clientes que usam DBCA em scripts hoje podem atualizar seus scripts existentes para chamar o dbaascli em vez do DBCA. Se o dbaascli não puder ser usado porque um recurso específico do DBCA está indisponível no dbaascl, os clientes deverão abrir uma solicitação do My Oracle Support (MOS) para adicionar essa funcionalidade ao dbaascli.
Para usar o utilitário dbaascli, você deve estar conectado a um nó de computação do Oracle Exadata Database Service no Exascale Infrastructure.
Alguns comandos do dbaascli podem ser executados como usuário oracle ou opc, mas muitos comandos requerem privilégios de administrador root. Consulte cada comando para obter requisitos específicos.
- dbaascli admin updateStack
Para instalar ou atualizar um RPM dbaastools, use o comandodbaascli admin updateStack. - dbaascli cswlib deleteLocal
Para excluir a imagem local, use o comandodbaascli cswlib deleteLocal. - dbaascli cswlib download
Para fazer download das imagens de software disponíveis e disponibilizá-las no ambiente do Oracle Exadata Database Service on Exascale Infrastructure, use o comandodbaascli cswlib download. - dbaascli cswlib listLocal
Para exibir a lista de imagens do Banco de Dados e do Grid Infrastructure disponíveis localmente, use o comandodbaascli cswlib listLocal. - dbaascli cswlib showImages
Para exibir a lista de imagens disponíveis do Banco de Dados e do Grid Infrastructure, use o comandodbaascli cswlib showImages. - dbaascli database addInstance
Para adicionar a instância do banco de dados no nó especificado, use o comandodbaascli database addInstance. - dbaascli database backup
Para configurar o Oracle Database com um destino de armazenamento de backup, fazer backups de bancos de dados, consultar backups e excluir um backup, use o comandodbaascli database backup. - dbaascli database bounce
Para fazer shutdown e reiniciar um Oracle Exadata Database Service especificado no banco de dados Exascale Infrastructure, use o comandodbaascli database bounce. - dbaascli database changepassword
Para alterar a senha de um usuário especificado do Oracle Database, use o comandodbaascli database changePassword. Quando solicitado, digite o nome de usuário cuja senha você deseja alterar e, em seguida, digite a senha. - dbaascli database convertToPDB
Para converter em PDB o banco de dados não CDB especificado, use o comandodbaascli database convertToPDB. - dbaascli database create
Para criar o Banco de Dados Oracle, use o comandodbaascli database create. Quando solicitado, digite as senhassysetde. - dbaascli database delete
Para excluir um Banco de Dados Oracle, use o comandodbaascli database delete. - dbaascli database deleteInstance
Para excluir a instância do banco de dados no nó especificado, use o comandodbaascli database deleteInstance. - dbaascli database duplicate
Para criar um banco de dados com base em um banco de dados ativo, use o comandodbaascli database duplicate. - dbaascli database getDetails
Esse comando mostra as informações detalhadas de um determinado banco de dados, por exemplo, dbname, informações do nó, informações de bancos de dados plugáveis etc. - dbaascli database getPDBs
Para exibir a lista de todos os bancos de dados plugáveis em um banco de dados contêiner, use o comandodbaascli database getPDBs. - dbaascli database modifyParameters
Para modificar ou redefinir os parâmetros de inicialização de um Banco de Dados Oracle, use o comandodbaascli database modifyParameters. - dbaascli database move
Para mover o banco de dados de um home para outro, use o comandodbaascli database move. - dbaascli database recovery
Para recuperar um banco de dados, use o comandodbaascli database recover. - dbaascli database runDatapatch
Para aplicar patch em um Banco de Dados Oracle, use o comandodbaascli database runDatapatch. - dbaascli database createTemplate
Para criar modelos de banco de dados (modelos DBCA) que possam ser usados subsequentemente para criar bancos de dados, use o comandodbaascli database createTemplate. - dbaascli database start
Para iniciar um Banco de Dados Oracle, use o comandodbaascli database start. - dbaascli database status
Para verificar o status de um Banco de Dados Oracle, use o comandodbaascli database status. - dbaascli database stop
Para interromper um Banco de Dados Oracle, use o comandodbaascli database stop. - dbaascli database upgrade
Para fazer upgrade de um Banco de Dados Oracle, use o comandodbaascli database upgrade. - dbaascli dataguard prepareStandbyBlob
Para gerar um arquivo blob contendo vários arquivos necessários no site stand-by no caso de um ambiente do dataguard, use o comandodbaascli dataguard prepareStandbyBlob. - dbaascli dataguard updateDGConfigAttributes
Para atualizar os atributos de automação do Data Guard em todos os nós do cluster, use o comandodbaascli dataguard updateDGConfigAttributes. - dbaascli dbhome create
Para criar um home do Banco de Dados Oracle da versão desejada, use o comandodbaascli dbhome create. - dbaascli dbHome delete
Para excluir um determinado home do Oracle Database, use o comandodbaascli dbHome delete. - dbaascli dbhome getDatabases
Para exibir informações sobre todos os Bancos de Dados Oracle em execução em um determinado Oracle home do banco de dados, use o comandodbaascli dbHome getDatabases. Especifique o local ou o nome do Oracle home. - dbaascli dbHome getDetails
Para exibir informações sobre um Oracle home específico, use o comandodbaascli dbHome getDetails. Especifique o local ou o nome do Oracle home. - dbaascli dbHome patch
Para aplicar patch no Oracle home de um nível de patch para outro, use o comandodbaascli dbHome patch. - dbaascli dbimage Purge
O comandodbimage purgeremove a imagem de software especificada do seu ambiente do Oracle Exadata Database Service no Exascale Infrastructure. - dbaascli diag Collect
Para coletar diagnóstico, use o comandodbaascli diag collect. - dbaascli diag healthCheck
Para executar verificações de integridade de diagnóstico, use o comandodbaascli diag healthCheck. - dbaascli grid configureTCPS
Para configurar o TCPS para o cluster existente, use o comandodbaascli grid configureTCPS. - dbaascli grid patch
Para aplicar patch do Oracle Grid Infrastructure na versão secundária especificada, use o comandodbaascli grid patch. - dbaascli grid removeTCPSCert
Para remover certificados TCPS existentes da wallet do Grid Infrastructure, use o comandodbaascli grid removeTCPSCert. - dbaascli grid rotateTCPSCert
Para alternar certificados TCPS, use o comando dbaascli grid rotateTCPSCert. - dbaascli grid upgrade
Para fazer upgrade do Oracle Grid Infrastrucure de uma versão principal para outra, use o comandodbaascli grid upgrade. - dbaascli job getStatus
Para exibir o status de um job especificado, use o comandodbaascli job getStatus. - dbaascli patch db prereq
- dbaascli pdb backup
Para fazer backup de um banco de dados plugável (PDB), consultar backups do PDB e excluir um backup do PDB, use o comandodbaascli pdb backup. - dbaascli pdb bounce
Para devolver um banco de dados plugável (PDB), use o comandodbaascli pdb bounce. - dbaascli pdb close
Para fechar um banco de dados plugável (PDB), use o comandodbaascli pdb close. - 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 comandodbaascli pdb getConnectString. - dbaascli pdb create
Para criar um novo banco de dados plugável (PDB), use o comandodbaascli pdb create. - dbaascli PDB createSnapshot
Para criar um snapshot de um determinado banco de dados plugável (PDB), use o comandodbaascli pdb createSnapshot. - dbaascli PDB configureSnapshot
Para configurar snapshots automáticos para um determinado banco de dados plugável (PDB), use o comandodbaascli pdb configureSnapshot. - dbaascli pdb delete
Para excluir um banco de dados plugável (PDB), execute o comandodbaascli pdb delete. - dbaascli PDB deleteSnapshot
Para excluir um snapshot de um determinado banco de dados plugável (PDB), use o comandodbaascli pdb deleteSnapshot. - dbaascli pdb getDetails
Para exibir detalhes de um banco de dados plugável (PDB), use o comandodbaascli pdb getDetails. - dbaascli PDB getSnapshot
Para obter detalhes de um determinado snapshot do banco de dados plugável (PDB), use o comandodbaascli pdb getSnapshot. - dbaascli pdb list
Para exibir a lista de bancos de dados plugáveis (PDB) em um banco de dados contêiner, use o comandodbaascli pdb list. - dbaascli PDB listSnapshots
Para listar os snapshots de um determinado banco de dados plugável (PDB), use o comandodbaascli pdb listSnapshots. - 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 comandodbaascli pdb localClone. - dbaascli pdb open
Para abrir um banco de dados plugável (PDB), use o comandodbaascli pdb open. - dbaascli pdb recover
Para recuperar um banco de dados plugável (PDB), use o comandodbaascli pdb recover. - dbaascli pdb refresh
Para atualizar um banco de dados plugável (PDB) especificado, use o comandodbaascli pdb refresh. - dbaascli pdb relocate
Para realocar o PDB especificado do banco de dados remoto para o banco de dados local, use o comandodbaascli pdb relocate. - dbaascli pdb remoteClone
Para criar um novo banco de dados plugável (PDB) como clone de um PDB existente, em outro banco de dados contêiner (CDB), use o comandodbaascli pdb remoteClone. - dbaascli system getDBHomes
Para exibir informações sobre todos os Oracle homes, use o comandodbaascli system getDBHomes. - dbaascli tde changePassword
Para alterar a senha do armazenamento de chaves TDE, bem como a senha da wallet do Banco de Dados para o aliastde_ks_passwd, use o comandodbaascli tde changePassword. - dbaascli tde addSecondaryHsmKey
Para adicionar uma chave HSM (KMS) secundária à configuração HSM (KMS) existente, use o comandodbaascli tde addSecondaryHsmKey. - dbaascli tde enableWalletRoot
Para ativar o parâmetro spfilewallet_rootpara o banco de dados existente, use o comandodbaascli tde enableWalletRoot. - dbaascli tde encryptTablespacesInPDB
Para criptografar todos os tablespaces no PDB especificado, use o comandodbaascli tde encryptTablespacesInPDB. - dbaascli TDE fileToHsm
Para converter em HSM a TDE baseada em FILE (KMS/OKV), use o comandodbaascli TDE fileToHsm. - dbaascli tde getHsmKeys
Para obter detalhes da chave ativa de TDE, use o comandodbaascli tde getHsmKeys. - dbaascli tde getMkidForKeyVersionOCID
Para obter o ID da Chave Principal associado ao OCID da versão da chave KMS, use o comandodbaascli tde getMkidForKeyVersionOCID. - dbaascli tde getPrimaryHsmKey
Para obter a chave HSM (KMS) primária da configuração HSM (KMS) existente, use o comandodbaascli tde getPrimaryHsmKey. - dbaascli tde hsmToFile
Para converter TDE baseada em HSM (KMS/OKV) em TDE baseada em FILE, use o comandodbaascli tde hsmToFile. - dbaascli tde listKeys
Para listar chaves principais de TDE, use o comandodbaascli tde listKeys. - dbaascli tde removeSecondaryHsmKey
Para remover a chave HSM (KMS) secundária da configuração HSM (KMS) existente, use o comandodbaascli tde removeSecondaryHsmKey. - dbaascli tde rotateMasterKey
Para rotacionar a chave principal para criptografia de banco de dados, use o comandodbaascli tde rotateMasterKey. - dbaascli tde setKeyVersion
Para definir a versão da chave primária a ser usada no DB/CDB ou no PDB, use o comandodbaascli tde setKeyVersion. - dbaascli tde setPrimaryHsmKey
Para alterar a chave HSM (KMS) primária para a configuração HSM (KMS) existente, use o comandodbaascli tde setPrimaryHsmKey. - dbaascli tde status
Para exibir informações sobre o armazenamento de chaves do banco de dados especificado, use o comandodbaascli tde status.
dbaascli admin updateStack
Para instalar ou atualizar um RPM dbaastools, use o comando dbaascli admin updateStack.
Pré-requisitos
Execute o comando como usuário root.
Para usar o utilitário, conecte-se a uma máquina virtual do Oracle Exadata Database Service no Exascale Infrastructure.
Consulte Estabelecendo Conexão com uma Máquina Virtual com SSH.
Sintaxe
dbaascli admin updateStack
[--resume]
[--prechecksOnly]
[--nodes]
--resumeretoma a execução anterior--prechecksOnlyexecuta apenas as pré-verificações desta operação--nodesespecifica 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.
Tópicos Relacionados
Tópico principal: Referência de Comando do dbaascli
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:
--imageTagespecifica a tag de imagem do Oracle home
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli cswlib deleteLocal?
R: O comando dbaascli cswlib deleteLocal é usado para excluir uma imagem local do Oracle home do sistema.
P: Quais são os pré-requisitos para executar o comando dbaascli cswlib deleteLocal?
R: O comando deve ser executado como o usuário root para garantir que as permissões necessárias estejam disponíveis para excluir a imagem local.
P: Como especificar qual imagem local excluir?
A: Use a opção --imageTag para especificar a tag de imagem do Oracle home que você deseja excluir.
P: O que a opção --imageTag representa no comando?
A: A opção --imageTag representa o identificador ou a tag associada à imagem do Oracle home que você deseja excluir.
P: Posso excluir várias imagens locais de uma só vez usando este comando?
R: Não, o comando dbaascli cswlib deleteLocal permite excluir apenas uma imagem local por vez, especificada por sua tag de imagem.
P: O que acontece se eu executar o comando dbaascli cswlib deleteLocal sem especificar --imageTag?
R: O comando falhará porque --imageTag é necessário para identificar qual imagem local deve ser excluída.
P: É possível recuperar uma imagem local depois que ela tiver sido excluída usando este comando?
R: Não, depois que a imagem local for excluída usando o comando dbaascli cswlib deleteLocal, ela não poderá ser recuperada. Certifique-se de verificar a tag da imagem antes de continuar.
P: Quando eu precisaria usar o comando dbaascli cswlib deleteLocal?
R: Você usaria esse comando quando precisasse remover uma imagem do Oracle home não usada ou desatualizada do sistema local para liberar espaço ou limpar seu ambiente.
Exemplo 6-3 dbaascli cswlib deletelocal
dbaascli cswlib deletelocal --imagetag 19.15.0.0.0
DBAAS CLI version MAIN
Executing command cswlib deletelocal --imagetag 19.15.0.0.0
Job id: 8b3e71de-4b81-4832-b49c-7f892179bb4f
Log file location: /var/opt/oracle/log/cswLib/deleteLocal/dbaastools_2022-07-18_10-00-02-AM_73658.log
dbaascli execution completed
Tópicos Relacionados
Tópico principal: Referência de Comando do dbaascli
dbaascli cswlib download
Para fazer download das imagens de software disponíveis e disponibilizá-las no ambiente do Oracle Exadata Database Service on Exascale Infrastructure, use o comando dbaascli cswlib download.
Pré-requisitos
Execute o comando como usuário root.
Para usar o utilitário, conecte-se a uma máquina virtual do Oracle Exadata Database Service no Exascale Infrastructure.
Consulte Estabelecendo Conexão com uma Máquina Virtual com SSH.
Sintaxe
dbaascli cswlib download --version | --imageTag
[--product]
--versionespecifica uma versão da imagem do Oracle home--imageTagespecifica a tag da imagem--productespecifica o tipo de imagem. Valores válidos:databaseougrid
Perguntas Frequentes
P: Qual é a finalidade do comando de download dbaascli cswlib?
R: O comando dbaascli cswlib download é usado para fazer download de imagens de software disponíveis e disponibilizá-las no Exadata Cloud Infrastructure.
P: Quais são os pré-requisitos para executar o comando de download dbaascli cswlib?
R: Execute o comando como usuário root. Além disso, você precisa estar conectado a uma máquina virtual do Exadata Cloud Infrastructure.
P: Como me conecto à máquina virtual necessária para este comando?
A: Você precisa usar SSH para estabelecer conexão com a máquina virtual do Exadata Cloud Infrastructure. Instruções detalhadas podem ser encontradas na documentação em "Estabelecendo Conexão com uma Máquina Virtual com SSH".
P: O que a opção --version especifica no comando?
A: A opção --version especifica a versão da imagem do Oracle home que você deseja fazer download.
P: Como eu uso a opção --imageTag no comando dbaascli cswlib download?
A: A opção --imageTag é usada para especificar a tag de imagem da imagem de software que você deseja fazer download.
P: Qual é a finalidade da opção --product no comando?
A: A opção --product especifica o tipo de imagem que você deseja baixar. Os valores válidos são banco de dados ou grade.
P: Posso fazer download de imagens de banco de dados e grade simultaneamente?
R: Não, você deve especificar database ou grid usando a opção --product, para que cada operação de download seja específica de um tipo de imagem.
P: O que acontece se eu não especificar uma tag de versão ou imagem?
R: O comando provavelmente falhará ou solicitará as informações necessárias, pois as opções --version ou --imageTag são necessárias para identificar a imagem de software específica para download.
P: É necessário especificar --version e --imageTag juntos?
R: Não, você geralmente especifica --version ou --imageTag, dependendo de como deseja identificar a imagem a ser transferida por download, mas não ambos ao mesmo tempo.
P: Quando eu usaria o comando dbaascli cswlib download?
R: Você usaria esse comando quando precisasse fazer download de imagens de software do Oracle home para ambientes database ou grid na configuração do Exadata Cloud Infrastructure.
Exemplo 6-4 dbaascli cswlib download --product --imageTag
dbaascli cswlib download --product database --imageTag 19.14.0.0.0
Exemplo 6-5 dbaascli cswlib download --version 19.9.0.0.0
dbaascli cswlib download --product database --imageTag 19.14.0.0.0
Tópicos Relacionados
Tópico principal: Referência de Comando do dbaascli
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:
--productidentifica o tipo de produto do Oracle home. Valores válidos:databaseougrid.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli cswlib listLocal?
R: O comando dbaascli cswlib listLocal é usado para exibir a lista de imagens do Banco de Dados e do Grid Infrastructure disponíveis localmente no seu sistema.
P: Quais são os pré-requisitos para executar o comando dbaascli cswlib listLocal?
R: O comando deve ser executado como o usuário root para ter as permissões necessárias para acessar e listar as imagens disponíveis.
P: Como eu especifico que tipo de imagens listar usando este comando?
A: Use a opção --product para especificar o tipo de imagens do Oracle home que você deseja listar. Os valores válidos são database ou grid.
P: O que a opção --product representa no comando dbaascli cswlib listLocal?
A: A opção --product identifica o tipo de produto Oracle home, permitindo que você filtre a lista de imagens disponíveis para os tipos database ou grid.
P: Posso listar imagens de banco de dados e grade simultaneamente?
R: Não, a opção --product permite listar imagens database ou grid de cada vez. Você precisa executar o comando duas vezes com valores --product diferentes para ver as duas listas.
P: O que acontece se eu não especificar a opção --product no comando?
R: Se a opção --product não for especificada, o comando poderá listar todas as imagens disponíveis localmente ou poderá exigir que você especifique o tipo de produto. O comportamento pode depender da configuração do seu ambiente.
P: Quando devo usar o comando dbaascli cswlib listLocal?
R: Você deve usar esse comando quando quiser verificar quais imagens do Banco de Dados ou do Grid Infrastructure estão disponíveis localmente no sistema.
P: Como posso diferenciar entre imagens de banco de dados e de grade na lista?
R: A opção --product permite filtrar a lista, portanto, especificando database ou grid, você só verá as imagens relevantes para esse tipo de produto, facilitando a diferenciação.
P: Há algum risco associado à execução do comando dbaascli cswlib listLocal?
R: Não, este comando não é destrutivo e exibe apenas informações sobre imagens disponíveis localmente. Ele não modifica ou exclui nenhum arquivo.
P: Este comando exibe imagens remotas ou armazenadas na nuvem?
R: Não, o comando dbaascli cswlib listLocal exibe apenas imagens que estão disponíveis localmente no seu sistema, não aquelas armazenadas remotamente ou na nuvem.
Exemplo 6-6 dbaascli cswlib listlocal
dbaascli cswlib listlocal
DBAAS CLI version MAIN
Executing command cswlib listlocal
Job id: bc4f047c-0a34-4d4d-a1ea-21ddc2a9c627
Log file location: /var/opt/oracle/log/cswLib/listLocal/dbaastools_2022-07-18_10-29-53-AM_16077.log
############ List of Available Database Images #############
1.IMAGE_TAG=12.2.0.1.220419
IMAGE_SIZE=5GB
VERSION=12.2.0.1.220419
DESCRIPTION=12.2 APR 2022 DB Image
2.IMAGE_TAG=18.16.0.0.0
IMAGE_SIZE=6GB
VERSION=18.16.0.0.0
DESCRIPTION=18c OCT 2021 DB Image
3.IMAGE_TAG=19.14.0.0.0
IMAGE_SIZE=5GB
VERSION=19.14.0.0.0
DESCRIPTION=19c JAN 2022 DB Image
dbaascli execution completed
Tópicos Relacionados
Tópico principal: Referência de Comando do dbaascli
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:
--productidentifica o tipo de produto do Oracle home. Valores válidos:databaseougrid.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli cswlib showImages?
R: O comando dbaascli cswlib showImages é usado para exibir a lista de imagens disponíveis do Banco de Dados e do Grid Infrastructure que podem ser baixadas ou gerenciadas no ambiente do Oracle Exadata Database Service.
P: Quais são os pré-requisitos para executar o comando dbaascli cswlib showImages?
R: O comando deve ser executado como o usuário root para garantir que você tenha as permissões necessárias para exibir as imagens disponíveis.
P: Como faço para filtrar as imagens listadas por este comando?
R: Você pode filtrar as imagens especificando a opção --product com database ou grid para listar somente as imagens relacionadas a esse tipo de produto.
P: O que a opção --product representa no comando dbaascli cswlib showImages?
A: A opção --product identifica o tipo de produto do Oracle home, permitindo que você filtre a lista de imagens para o banco de dados ou a grade.
P: Posso exibir imagens de banco de dados e grade em uma única execução de comando?
R: Não, você precisa executar o comando duas vezes com valores --product diferentes (database e grid) para exibir os dois tipos de imagens.
P: O que acontece se eu não especificar a opção --product no comando?
R: Se a opção --product não for especificada, o comando poderá listar todas as imagens disponíveis ou poderá solicitar que você especifique o tipo de produto, dependendo da configuração do seu ambiente.
P: Quando devo usar o comando dbaascli cswlib showImages?
R: Use este comando quando quiser exibir a lista de imagens do Banco de Dados ou do Grid Infrastructure disponíveis para download ou implantação no ambiente do Oracle Exadata Database Service.
P: Há alguma diferença entre os comandos dbaascli cswlib showImages e dbaascli cswlib listLocal?
R: Sim, dbaascli cswlib showImages lista todas as imagens disponíveis que você pode fazer download ou gerenciar, enquanto dbaascli cswlib listLocal lista apenas as imagens que já foram baixadas e disponíveis localmente no seu sistema.
P: Esse comando pode ser usado para exibir imagens armazenadas na nuvem?
R: Sim, esse comando pode mostrar imagens que estão disponíveis para download nos repositórios da Oracle, não apenas aquelas armazenadas localmente.
P: Que tipo de imagens posso esperar ver com este comando?
R: Você pode esperar ver imagens relacionadas ao Oracle Database e ao Grid Infrastructure, que são componentes essenciais para gerenciar e executar bancos de dados Oracle em plataformas Exadata.
Exemplo 6-7 dbaascli cswlib showImages
dbaascli cswlib showImages
Tópicos Relacionados
Tópico principal: Referência de Comando do dbaascli
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>]
--dbnameespecifica o nome do Oracle Database--nodeespecifica o nome do nó da instância do banco de dados--newNodeSIDespecifica 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.
Tópico principal: Referência de Comando do dbaascli
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.
enableRTRT e disableRTRT só se aplicam ao destino de backup ZDLRA no Exadata Database Service on Cloud@Customer.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database backup?
R: O comando dbaascli database backup é usado para configurar destinos de armazenamento de backup do Oracle Database, fazer backups, consultar backups e excluir backups existentes.
P: Quais são os pré-requisitos para executar o comando de backup do banco de dados dbaascli?
R: O comando deve ser executado como o usuário root para ter as permissões necessárias para o gerenciamento de backup.
P: Como inicio um backup completo do Oracle Database usando este comando?
A: Para iniciar um backup completo (Nível-0), use a seguinte sintaxe:
dbaascli database backup --dbname <value> --start --level0
P: Como faço um backup incremental usando o comando de backup do banco de dados dbaascli?
A: Para executar um backup incremental de Nível 1, use esta sintaxe:
dbaascli database backup --dbname <value> --start --level1
P: Qual é a diferença entre backups de Nível 0 e Nível 1?
R: Um backup de Nível 0 é um backup completo do banco de dados, enquanto um backup de Nível 1 é um backup incremental que captura apenas as alterações feitas desde o último backup de Nível 0 ou Nível 1.
P: Posso fazer um backup de arquivamento usando este comando?
R: Sim, você pode criar um backup de arquivamento usando a opção --archival junto com o comando --start:
dbaascli database backup --dbname <value> --start --archival --tag <backup_tag>
P: Como excluo um backup de arquivamento existente?
A: Para excluir um backup de arquivamento, use a seguinte sintaxe:
dbaascli database backup --dbname <value> --delete --backupTag <tag_value>
P: Como posso verificar o status de um backup específico usando o comando?
R: Você pode verificar o status de um backup usando a opção --status com o parâmetro --uuid, como este:
dbaascli database backup --dbname <value> --status --uuid <backup_uuid>
P: Como faço para listar todos os backups de um banco de dados?
A: Para listar todos os backups disponíveis para um banco de dados específico, use a opção --list:
dbaascli database backup --dbname <value> --list
Para saída JSON, adicione a opção --json:
dbaascli database backup --dbname <value> --list --json <file_name>
P: Como posso recuperar um relatório de backup?
R: Você pode obter um relatório de backup usando a opção --getBackupReport, para uma tag específica ou para o backup mais recente:
dbaascli database backup --dbname <value> --getBackupReport --tag <backup_tag> --json <file_name>
Ou para recuperar o relatório mais recente:
dbaascli database backup --dbname <value> --getBackupReport --latest --json <file_name>
P: Como configuro as definições de backup do banco de dados?
A: Use a opção --configure para especificar o arquivo de configuração de backup ou para ativar/desativar o RTRT (Real-Time Redo Transport):
dbaascli database backup --dbname <value> --configure --configFile <config_file>
Para habilitar o RTRT:
dbaascli database backup --dbname <value> --configure --enableRTRT
P: Como verifico a configuração de backup atual do meu banco de dados?
A: Para exibir a configuração de backup do banco de dados atual, use a opção --getConfig:
dbaascli database backup --dbname <value> --getConfig
P: O que a opção --validate faz no comando dbaascli database backup?
A: A opção --validate verifica se os backups estão completos e livres de corrupção. Você pode especificar um intervalo de tempo usando a opção --untilTime:
dbaascli database backup --dbname <value> --validate --untilTime "DD-MON-YYYY HH24:MI:SS"
P: Como exibo o histórico de todas as operações de backup de um banco de dados?
A: Use a opção --showHistory para exibir o histórico de todas as operações de backup:
dbaascli database backup --dbname <value> --showHistory
Para obter um histórico completo, incluindo todas as operações:
dbaascli database backup --dbname <value> --showHistory --all
P: O que são opções de RTRT (Real-Time Redo Transport) e quando devo usá-las?
R: As opções RTRT (--enableRTRT e --disableRTRT) são usadas para controlar o Transporte de Redo em Tempo Real, aplicável apenas para destinos de backup ZDLRA (Zero Data Loss Recovery Appliance) nos ambientes Exadata Cloud@Customer. Ative o RTRT para garantir a remessa de redo log em tempo real.
Exemplo 6-8 Exemplos
- Para alterar o período de retenção do log de arquivamento, siga as etapas abaixo:
dbaascli database backup --getConfig --dbname <dbname>Isso gerará um arquivo de configuração de backup
.cfg.Atualize o valor
bkup_archlog_fra_retentionneste arquivo de configuração.Execute o comando configure:
dbaascli database backup --configure --dbname <dbname> --configfile <config file generated above> - Para obter a configuração de backup de um banco de dados myTestDB:
dbaascli database backup --dbName myTestDB --getConfig --configFile /tmp/configfile_1.txt - Para definir a configuração de backup de um banco de dados myTestDB modificando o arquivo de configuração com detalhes de configuração:
dbaascli database backup --dbName myTestDB --configure --configFile /tmp/configfile_1_modified.txt - Para fazer backup do banco de dados myTestDB:
dbaascli database backup --dbName myTestDB --start - Para consultar o status da solicitação de backup submetida com
uuid58fdcae0bd1c11eb92bc020017075151:dbaascli database backup --dbName myTestDB --status --uuid 58fdcae0bd1c11eb92bc020017075151 - Para ativar o RTRT do banco de dados myTestDB:
dbaascli database backup --dbName myTestDB --configure —enableRTRT
Tópico principal: Referência de Comando do dbaascli
dbaascli database bounce
Para fazer shutdown e reiniciar um banco de dados Oracle Exadata Database Service no Exascale Infrastructure especificado, use o comando dbaascli database bounce.
Pré-requisitos
Execute o comando como usuário oracle.
Sintaxe
dbaascli database bounce
[--dbname][--rolling <value>]
--dbnameespecifica o nome do banco de dados--rollingespecificatrueoufalsepara devolver o banco de dados de maneira incremental. O valor padrão éfalse.
O comando executa um shutdown do banco de dados no modo imediato. O banco de dados é depois reiniciado e aberto. No Oracle Database 12c ou mais recente, todos os PDBs também são abertos.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database bounce?
R: O comando dbaascli database bounce é usado para fazer shutdown e reiniciar um Oracle Database no Exadata Cloud Infrastructure. Ele suporta a reinicialização do banco de dados de forma incremental, garantindo o mínimo de interrupção.
P: Quais são os pré-requisitos para executar o comando dbaascli database bounce?
R: O comando deve ser executado como o usuário oracle, que tem os privilégios necessários para fazer shutdown e reiniciar o banco de dados.
P: O que a opção --dbname especifica neste comando?
A: A opção --dbname especifica o nome do Oracle Database que você deseja desligar e reiniciar.
P: Qual é a opção --rolling usada no comando dbaascli database bounce?
A: A opção --rolling especifica se o banco de dados deve ser devolvido (reinicializado) de maneira incremental. Se definido como verdadeiro, as instâncias do banco de dados serão reiniciadas uma a uma, garantindo um tempo de inatividade mínimo. O valor padrão é false, que reinicia todas as instâncias de uma só vez.
P: O que significa "saltar o banco de dados"?
R: Saltar o banco de dados refere-se a desligá-lo e reiniciá-lo. Esta operação pode ser usada para manutenção, aplicação de alterações ou recuperação de determinados tipos de problemas.
P: O comando dbaascli database bounce executa um shutdown normal?
R: Sim, o comando executa um shutdown no modo "imediato", que fecha o banco de dados e faz rollback de transações não confirmadas sem esperar que os usuários se desconectem.
P: Este comando abrirá automaticamente todos os PDBs em um banco de dados Oracle 12c ou mais recente?
R: Sim, se o banco de dados estiver executando o Oracle Database 12c ou mais recente, o comando abrirá automaticamente todos os Bancos de Dados Plugáveis (PDBs) após a reinicialização do banco de dados.
P: O comando dbaascli database bounce pode ser usado em um ambiente com vários nós ou RAC (Real Application Clusters)?
R: Sim, em um ambiente com vários nós ou RAC, você pode usar a opção --rolling para reiniciar as instâncias do banco de dados uma a uma, minimizando o tempo de inatividade.
P: O que acontece se eu não especificar a opção --rolling?
R: Se a opção --rolling não for especificada ou se estiver definida como falsa, o comando fará shutdown e reiniciará todas as instâncias do banco de dados ao mesmo tempo, o que pode causar um breve período de indisponibilidade.
P: Existe um valor padrão para a opção --rolling no comando dbaascli database bounce?
R: Sim, o valor padrão da opção --rolling é false, o que significa que o banco de dados será devolvido de forma não incremental, a menos que especificado de outra forma.
P: Como reinicio um banco de dados no modo incremental?
R: Para reiniciar o banco de dados no modo incremental, use a seguinte sintaxe:
dbaascli database bounce --dbname <value> --rolling true
P: É seguro executar o comando dbaascli database bounce durante sessões ativas?
R: Embora o comando use um shutdown imediato, que reverte as transações não confirmadas, é sempre recomendável garantir que não haja sessões críticas ou ativas antes de devolver o banco de dados.
P: Esse comando pode ser usado para PDBs específicos em um banco de dados multitenant?
R: Não, o comando dbaascli database bounce opera em todo o banco de dados. No Oracle 12c ou posterior, ele retornará o Banco de Dados Contêiner (CDB) e abrirá todos os PDBs, mas não permitirá a devolução de PDBs individuais.
P: O que devo fazer se o banco de dados não voltar a ficar on-line depois de devolvê-lo?
R: Se o banco de dados não for reinicializado, verifique se há erros nos logs durante o processo de shutdown ou inicialização. Investigar os logs de alerta da Oracle pode fornecer informações sobre o que causou o problema.
Exemplo 6-9 dbaascli database bounce
dbaascli database bounce --dbname dbname
Tópico principal: Referência de Comando do dbaascli
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>]]
--dbnameespecifica o nome do Oracle Database no qual você deseja atuar--userespecifica o nome de usuário cuja alteração de senha é necessária--prepareStandbyBlobespecificatruepara gerar um arquivo blob contendo os artefatos necessários para alterar a senha em um ambiente do Data Guard. Valores válidos:true|false--blobLocationespecifica o caminho personalizado no qual o arquivo blob será gerado--standbyBlobFromPrimaryespecifica o arquivo blob stand-by, que é preparado no banco de dados principal--resumeespecifica para retomar a execução anterior--sessionIDespecifica para retomar um ID de sessão específico
Perguntas Frequentes
P: O que o comando dbaascli database changePassword faz?
A: O comando dbaascli database changePassword é usado para alterar a senha de um usuário especificado do Oracle Database. Será solicitado inserir o nome do usuário e, em seguida, a nova senha.
P: Quais são os pré-requisitos para usar o comando changePassword do banco de dados dbaascli?
R: Você deve executar o comando como o usuário root ou oracle para alterar a senha de um usuário do banco de dados.
P: Como eu especifico o banco de dados ao usar este comando?
A: Use a opção --dbname para especificar o nome do Oracle Database no qual você deseja atuar. Por exemplo:
dbaascli database changePassword --dbname <db_name>
P: Como eu especifico o usuário cuja senha eu quero alterar?
A: Use a opção --user para especificar o nome de usuário cuja senha precisa ser alterada. Por exemplo:
dbaascli database changePassword --user <username>
P: Qual é a finalidade da opção --prepareStandbyBlob no comando dbaascli database changePassword?
A: A opção --prepareStandbyBlob é usada nos ambientes do Data Guard para gerar um arquivo blob que contém os artefatos necessários para a alteração de senha no banco de dados stand-by. Isso garante a sincronização da senha no ambiente do Data Guard.
P: O que a opção --blobLocation especifica?
A: A opção --blobLocation permite especificar um caminho personalizado no qual o arquivo blob stand-by deve ser gerado. Se não for fornecido, o arquivo será salvo no local padrão.
P: Como eu uso o blob gerado do banco de dados principal para alterar a senha no stand-by?
R: Você pode usar a opção --standbyBlobFromPrimary para especificar o arquivo blob preparado do banco de dados principal para aplicar a alteração de senha ao banco de dados stand-by. Por exemplo:
dbaascli database changePassword --standbyBlobFromPrimary <blob_file_path>
P: Para que é usada a opção --resume neste comando?
A: A opção --resume é usada para retomar uma operação de alteração de senha interrompida anteriormente. Você pode especificar o ID da sessão, se necessário, usando a opção --sessionID.
P: Posso retomar uma sessão específica com o comando dbaascli database changePassword?
R: Sim, você pode usar a opção --resume junto com --sessionID para retomar uma sessão de alteração de senha específica especificando o ID da sessão.
P: O comando dbaascli database changePassword é aplicável em um ambiente do Data Guard?
A: Sim, é. A opção --prepareStandbyBlob pode ser usada para garantir que as alterações de senha sejam propagadas para o banco de dados stand-by em uma configuração do Data Guard.
P: O que acontece se eu não fornecer um --blobLocation ao usar --prepareStandbyBlob?
R: Se nenhum --blobLocation for fornecido, o arquivo blob que contém os artefatos de alteração de senha será salvo no local padrão.
P: Como verifico o status de uma sessão retomada usando o banco de dados dbaascli changePassword?
R: Você pode especificar o ID da sessão usando a opção --sessionID para retomar uma sessão específica. O sistema continuará de onde parou ao alterar a senha.
P: Esse comando pode ser usado para bancos de dados regulares e para aqueles em um ambiente do Data Guard?
R: Sim, o comando funciona para bancos de dados Oracle regulares e para bancos de dados em um ambiente Data Guard. Em ambientes do Data Guard, opções adicionais como --prepareStandbyBlob podem ser usadas para gerenciar alterações de senha nos bancos de dados principal e stand-by.
Exemplo 6-10 dbaascli database changePassword
dbaascli database changepassword --dbname db19
Tópico principal: Referência de Comando do dbaascli
dbaascli database convertToPDB
Para converter em PDB o banco de dados não CDB especificado, use o comando dbaascli database convertToPDB.
Sintaxe
dbaascli database convertToPDB --dbname <value> [--cdbName <value>] [--executePrereqs]
{
[--copyDatafiles [--keepSourceDB]]|[backupPrepared]
}
[--targetPDBName <value>] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
--dbnameespecifica o nome do Oracle Database--cdbNameespecifica 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--executePrereqsespecifica para só executar as verificações de pré-conversão--copyDatafilesespecifica para criar uma nova cópia dos arquivos de dados em vez de usar os do banco de dados de origem--keepSourceDB- para preservar o banco de dados de origem após a conclusão da operação.-
--backupPrepared- flag para confirmar que há um backup adequado do banco de dados para o não CDB antes de executar a conversão para o PDB. - Flag
--backupPreparedpara 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 --targetPDBNameespecifica o nome do PDB que será criado como parte da operação--waitForCompletionespecificafalsepara executar a operação em segundo plano. Valores válidos:true|false--resumeespecifica para retomar a execução anterior--sessionIDespecifica para retomar um ID de sessão específico
Exemplo 6-11 dbaascli database convertToPDB
dbaascli database convertToPDB --dbname ndb19 --cdbname cdb19 --backupPrepared --executePrereqsdbaascli database convertToPDB --dbname tst19 --cdbname cdb19 --copyDatafilesTópico principal: Referência de Comando do dbaascli
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]
--dbnameespecifica o nome do banco de dados--oracleHomeespecifica o local do Oracle home--oracleHomeNameespecifica o nome do Oracle home--dbUniqueNameespecifica o nome exclusivo do banco de dados--dbSIDespecifica o SID do banco de dados--createAsCDBespecificatrueoufalsepara criar o banco de dados como CDB ou Não CDB--pdbNameespecifica o nome do PDB--pdbAdminUserNameespecifique o nome do usuário administrador do PDB--dbCharsetespecifica o conjunto de caracteres do banco de dados--dbNCharsetespecifica o conjunto de caracteres nacionais do banco de dados--dbLanguageespecifica o idioma do banco de dados--dbTerritoryespecifica o território do banco de dados--sgaSizeInMBespecifica o valorsga_targetem unidade de megabyte--pgaSizeInMBespecifica o valorpga_aggregate_targetem unidade de megabyte--datafileDestinationespecifica o nome do grupo de discos do ASM a ser usado para arquivos de dados do banco de dados--fraDestinationespecifica o nome do grupo de discos do ASM a ser usado para a Área de Recuperação Rápida do banco de dados--fraSizeInMBespecifica o valor do tamanho da Área de Recuperação Rápida em unidade de megabyte--nodeListespecifica uma lista de nós delimitados por vírgulas para o banco de dados--tdeConfigMethodespecifica o método de configuração de TDE. Valores válidos:FILE,KMS--kmsKeyOCIDespecifica o OCID da chave KMS a ser usado para TDE. Isso só será aplicável se o KMS for selecionado para TDE--resumeretoma a execução anterior--revertfaz rollback da execução anterior--sessionIDretoma ou reverte um ID de sessão específico.--executePrereqsespecificayespara só executar os pré-requisitos desta operação. Valores válidos:yesouno--honorNodeNumberForInstanceespecificatrueoufalsepara indicar se o nome da instância deve ser sufixado com os números de nó do cluster. Valor padrão:true--lockPDBAdminAccountespecificatrueoufalsepara bloquear a conta de usuário administrador do PDB. O valor default éverdadeiro--dbcaTemplateFilePathespecifica o caminho absoluto do nome do modelo de dbca para criar o banco de dados.--waitForCompletionespecificafalsepara executar a operação em segundo plano. Valores válidos:trueoufalse
Perguntas Frequentes
P: O que o comando dbaascli database create faz?
R: O comando dbaascli database create é usado para criar uma nova instância do Oracle Database. Ele suporta a criação do Oracle Database versão 12.1.0.2 ou superior com a atualização de release JAN 2021 ou superior.
P: Como especifico o nome do Oracle Database a ser criado?
A: Use a opção --dbName para especificar o nome do Oracle Database. Por exemplo:
dbaascli database create --dbName <db_name>
P: Como posso criar um CDB (Banco de Dados Contêiner)?
A: Use a opção --createAsCDB e especifique verdadeiro para criar o banco de dados como um CDB. Por exemplo:
dbaascli database create --dbName <db_name> --createAsCDB true
P: Como especifico o Oracle Home para o banco de dados?
R: Você pode usar a opção --oracleHome para especificar o local do Oracle home ou a opção --oracleHomeName para especificar o nome do Oracle home.
P: Como especifico um nome de banco de dados exclusivo ou SID?
A: Use a opção --dbUniqueName para especificar um nome exclusivo para o banco de dados e a opção --dbSID para especificar o SID do banco de dados.
P: Como crio um PDB (Banco de Dados Plugável) junto com um CDB?
R: Você pode usar a opção --pdbName para especificar o nome do PDB e a opção --pdbAdminUserName para definir o nome do usuário administrador do PDB. Por exemplo:
dbaascli database create --dbName <db_name> --createAsCDB true --pdbName <pdb_name> --pdbAdminUserName <admin_user>
P: Como posso especificar o conjunto de caracteres do banco de dados e o conjunto de caracteres nacionais?
A: Use a opção --dbCharset para especificar o conjunto de caracteres do banco de dados e a opção --dbNCharset para especificar o conjunto de caracteres nacionais. Por exemplo:
dbaascli database create --dbName <db_name> --dbCharset AL32UTF8 --dbNCharset AL16UTF16
P: Como defino as definições de memória (SGA e PGA) para o banco de dados?
R: Use a opção --sgaSizeInMB para especificar o tamanho da SGA e a opção --pgaSizeInMB para especificar o tamanho da PGA, ambos em megabytes.
P: Como especificar o destino dos arquivos de dados e da Área de Recuperação Rápida (FRA)?
A: Use a opção --datafileDestination para especificar o grupo de discos ASM para arquivos de dados e a opção --fraDestination para especificar o grupo de discos ASM para o FRA. Você também pode definir o tamanho FRA com a opção --fraSizeInMB.
P: Posso configurar a TDE (Transparent Data Encryption) durante a criação do banco de dados?
R: Sim, você pode configurar a TDE usando a opção --tdeConfigMethod. Os valores válidos são FILE (para criptografia baseada em arquivo) ou KMS (para usar o Oracle Key Management Service). Se estiver usando o KMS, forneça o OCID da chave do KMS com a opção --kmsKeyOCID.
P: Como crio o banco de dados em uma lista específica de nós?
A: Use a opção --nodeList para especificar uma lista de nós separados por vírgulas em que o banco de dados deve ser criado.
P: Como posso retomar ou reverter uma tentativa anterior de criação de banco de dados?
A: Use a opção --resume para retomar a execução anterior ou a opção --revert para fazer rollback da execução anterior. Você também pode especificar um --sessionID para retomar ou reverter uma sessão específica.
P: O que a opção --executePrereqs faz?
A: A opção --executePrereqs só executa os pré-requisitos para a operação de criação do banco de dados, sem realmente criar o banco de dados. Use yes ou no para ativar ou desativar essa opção.
P: Posso especificar um modelo DBCA personalizado para a criação do banco de dados?
R: Sim, use a opção --dbcaTemplateFilePath para fornecer o caminho absoluto do arquivo de modelo DBCA que deve ser usado para criar o banco de dados.
P: Posso executar a operação de criação do banco de dados em segundo plano?
R: Sim, você pode usar a opção --waitForCompletion para especificar se o comando deve aguardar a conclusão da criação do banco de dados (true) ou executar a operação em segundo plano (false).
P: O que acontece se eu não especificar a opção --dbUniqueName?
R: Se você não especificar um nome exclusivo para o banco de dados usando --dbUniqueName, o sistema gerará automaticamente um nome com base no --dbName fornecido.
P: Posso bloquear a conta de administrador do PDB durante a criação de um CDB?
R: Sim, você pode usar a opção --lockPDBAdminAccount e defini-la como verdadeira para bloquear a conta de administrador do PDB após a criação do banco de dados. Por default, este valor é definido como true.
Exemplo 6-12 dbaascli database create
dbaascli database create --dbName db19 --oracleHomeName myhome19 --dbSid db19sid --nodeList node1,node2 --createAsCDB true
Tópico principal: Referência de Comando do dbaascli
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>]]
--dbnameespecifica o nome do banco de dados.--deleteArchiveLogsespecificatrueoufalsepara indicar a exclusão de logs de arquivamento do banco de dados.--deleteBackupsespecificatrueoufalsepara indicar a exclusão de backups de banco de dados.--precheckOnlyespecificayespara só executar as pré-verificações desta operação. Valores válidos:yesouno.--waitForCompletionespecificafalsepara executar a operação em segundo plano. Valores válidos:trueoufalse.- Flag
–-forcepara forçar a exclusão do banco de dados. --dbSIDespecifique o SID do banco de dados.--resumepara retomar a execução anterior.-
--sessionIDpara retomar um id de sessão específico.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database delete?
R: O comando dbaascli database delete é usado para excluir um Oracle Database no Exadata Cloud Infrastructure.
P: Como especifico o banco de dados que desejo excluir?
A: Use a opção --dbname para especificar o nome do Oracle Database que você deseja excluir. Por exemplo:
dbaascli database delete --dbname <db_name>
P: Como excluo os logs de arquivamento ao excluir um banco de dados?
R: Você pode excluir os logs de arquivamento definindo a opção --deleteArchiveLogs como true. Por exemplo:
dbaascli database delete --dbname <db_name> --deleteArchiveLogs true
P: Também posso excluir backups ao excluir o banco de dados?
R: Sim, use a opção --deleteBackups e defina-a como verdadeira para excluir todos os backups associados. Por exemplo:
dbaascli database delete --dbname <db_name> --deleteBackups true
P: Como posso executar apenas as pré-verificações da operação de exclusão sem realmente excluir o banco de dados?
R: Você pode usar a opção --precheckOnly e defini-la como sim para executar as pré-verificações sem excluir o banco de dados. Por exemplo:
dbaascli database delete --dbname <db_name> --precheckOnly yes
P: Como faço para forçar a exclusão de um banco de dados?
A: Para forçar a exclusão de um banco de dados, use o flag --force. Isso ignora as verificações e força o processo de exclusão. Por exemplo:
dbaascli database delete --dbname <db_name> --force
P: Como faço para executar a operação de exclusão em segundo plano?
A: Use a opção --waitForCompletion e defina-a como false para executar a operação em segundo plano. Por exemplo:
dbaascli database delete --dbname <db_name> --waitForCompletion false
P: Posso especificar o SID do banco de dados que quero excluir?
R: Sim, você pode especificar o SID do banco de dados usando a opção --dbSID. Por exemplo:
dbaascli database delete --dbname <db_name> --dbSID <sid>
P: Como retomo uma operação de exclusão interrompida anteriormente?
A: Para retomar uma execução de exclusão anterior, use a opção --resume. Você também pode especificar um ID de sessão usando a opção --sessionID, se necessário. Por exemplo:
dbaascli database delete --dbname <db_name> --resume --sessionID <session_id>
P: Quais privilégios de usuário são necessários para executar o comando dbaascli database delete?
A: O comando deve ser executado como o usuário root.
P: O que a opção --precheckOnly faz no comando dbaascli database delete?
A: A opção --precheckOnly permite que você execute apenas as pré-verificações da operação de exclusão sem realmente excluir o banco de dados. Ele garante que todas as verificações sejam aprovadas antes de continuar com a exclusão real.
P: Posso excluir um banco de dados sem aguardar a conclusão da operação?
R: Sim, definindo a opção --waitForCompletion como falsa, a operação de exclusão será executada em segundo plano e você não precisará esperar que ela seja concluída.
Exemplo 6-13 dbaascli database delete
dbaascli database delete --dbname db19
Tópico principal: Referência de Comando do dbaascli
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]
--dbnameespecifica o nome do Oracle Database--nodeespecifica o nome do nó para a instância do banco de dados--continueOnUnreachableNodeespecifica para executar a operação mesmo que o nó não esteja acessível
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database deleteInstance?
R: O comando dbaascli database deleteInstance é usado para excluir uma instância específica do Oracle Database em um nó especificado em um ambiente do Exadata Cloud Infrastructure.
P: Como especifico qual instância do Oracle Database excluir?
R: Você pode especificar a instância do Oracle Database a ser excluída usando a opção --dbname para fornecer o nome do banco de dados e a opção --node para fornecer o nome do nó. Por exemplo:
dbaascli database deleteInstance --dbname <db_name> --node <node_name>
P: Posso excluir a instância mesmo que o nó esteja inacessível?
R: Sim, você pode usar a opção --continueOnUnreachableNode para continuar com a exclusão, mesmo que o nó especificado esteja inacessível. Por exemplo:
dbaascli database deleteInstance --dbname <db_name> --node <node_name> --continueOnUnreachableNode
P: O que acontece se o nó especificado estiver inacessível durante a operação de exclusão da instância?
R: Se o nó estiver inacessível e a opção --continueOnUnreachableNode não for usada, a operação falhará. Se a opção for usada, a operação continuará mesmo que o nó não possa ser acessado.
P: Como excluo uma instância de banco de dados de um nó específico?
A: Use o seguinte comando para excluir uma instância de banco de dados de um nó específico:
dbaascli database deleteInstance --dbname <db_name> --node <node_name>
P: Quais privilégios de usuário são necessários para executar o comando dbaascli database deleteInstance?
A: O comando deve ser executado como o usuário root.
P: Posso excluir uma instância sem especificar o nó?
R: Não, a opção --node é necessária para especificar de qual nó a instância do banco de dados deve ser excluída.
P: O que a opção --continueOnUnreachableNode faz?
R: A opção --continueOnUnreachableNode permite que a operação prossiga mesmo que o nó especificado não possa ser atingido, garantindo que a exclusão da instância continue em cenários em que o nó possa estar inativo.
P: É possível excluir várias instâncias de banco de dados de uma só vez usando este comando?
R: Não, o comando dbaascli database deleteInstance é usado para excluir uma única instância de banco de dados em um nó especificado de cada vez. Você precisaria executar o comando separadamente para cada instância que deseja excluir.
Exemplo 6-14 database deleteinstance
database deleteinstance --node test-node
Tópico principal: Referência de Comando do dbaascli
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>]
--dbNameespecifica o nome do Oracle Database--sourceDBConnectionStringespecifica a string de conexão do banco de dados de origem no formato<scan_name>:<scan_port>/<database_service_name>--oracleHomeespecifica o local do Oracle home--oracleHomeNameespecifica o nome do Oracle home--dbSIDespecifica o SID do banco de dados--dbUniqueNameespecifica o nome exclusivo do banco de dados--sgaSizeInMBespecifica o valorsga_targetna unidade de megabyte--pgaSizeInMBespecifica o valorpga_aggregate_targetna unidade de megabyte--datafileDestinationespecifica o nome do grupo de discos do ASM a ser usado para arquivos de dados do banco de dados--fraDestinationespecifica o nome do grupo de discos do ASM a ser usado para a área de recuperação rápida do banco de dados--fraSizeInMBespecifica o valor do tamanho da área de recuperação rápida em unidade de megabyte--sourceDBWalletLocationespecifica 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--nodeListespecifica uma lista de nós delimitados por vírgulas para o banco de dados--resumeespecifica para retomar a execução anterior--sessionIDespecifica para retomar um ID de sessão específico
--revertespecifica para fazer rollback da execução anterior--sessionIDespecifica para fazer rollback de um ID de sessão específico
--rmanParallelismespecifica o valor do paralelo--rmanSectionSizeInGBespecifica o tamanho da seção do RMAN em GB--tdeConfigMethodespecifica o método de configuração de TDE. Os valores permitidos sãoFILEeKMS.--kmsKeyOCIDespecifica o OCID da chave KMS a ser usado para TDE. Isso só será aplicável se o KMS for selecionado para TDE.--sourceDBTdeConfigMethodespecifica o método de configuração de TDE do banco de dados de origem. Os valores permitidos sãoFILEeKMS.--sourceDBKmsKeyOCIDespecifica 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.--executePrereqsespecificayespara só executar os pré-requisitos desta operação. Valores válidos:yes|no--waitForCompletionespecificafalsepara executar a operação em segundo plano. Valores válidos:true|false--skipPDBsespecifica uma lista delimitada por vírgulas de nomes de PDB do banco de dados de origem, que precisa ser excluída da operação de banco de dados duplicada. Exemplo: pdb1,pdb2...
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database duplicate?
R: O comando dbaascli database duplicate é usado para criar um novo Oracle Database duplicando um banco de dados ativo existente.
P: Quais são os pré-requisitos para usar o comando duplicado do banco de dados dbaascli?
R: Execute o comando como usuário root.
P: Como especificar o banco de dados de origem para duplicação?
A: Use a opção --sourceDBConnectionString para fornecer a string de conexão do banco de dados de origem no formato <scan_name>:<scan_port>/<database_service_name>. Por exemplo:
--sourceDBConnectionString <scan_name>:<scan_port>/<database_service_name>
P: Como especifico o local do Oracle Home para o novo banco de dados?
R: Você pode especificar o local do Oracle Home usando a opção --oracleHome ou o nome do Oracle Home usando a opção --oracleHomeName. Por exemplo:
--oracleHome <value>
ou
--oracleHomeName <value>
P: Qual é a finalidade da opção --sourceDBWalletLocation?
A: A opção --sourceDBWalletLocation especifica o local do arquivo da wallet de TDE do banco de dados de origem, que é necessário para duplicar o banco de dados de um banco de dados de origem ativo.
P: Posso ignorar a duplicação de PDBs específicos do banco de dados de origem?
R: Sim, você pode usar a opção --skipPDBs para especificar uma lista delimitada por vírgulas de nomes de PDB que devem ser excluídos da operação duplicada. Por exemplo:
--skipPDBs pdb1,pdb2
P: Como configuro a TDE para o novo banco de dados?
A: Use a opção --tdeConfigMethod para especificar o método de configuração de TDE (FILE ou KMS). Se você escolher KMS, poderá fornecer o OCID da chave KMS usando a opção --kmsKeyOCID. Por exemplo:
--tdeConfigMethod FILE
ou
--tdeConfigMethod KMS --kmsKeyOCID <value>
P: O que a opção --executePrereqs faz?
A: A opção --executePrereqs especifica se apenas as verificações de pré-requisito devem ser executadas para a operação. Os valores válidos são yes para executar somente pré-requisitos ou no para continuar com a operação completa.
P: Como posso retomar uma operação duplicada interrompida anteriormente?
A: Use a opção --resume junto com a opção --sessionID para retomar uma operação duplicada interrompida anteriormente. Por exemplo:
--resume --sessionID <value>
P: O que a opção --waitForCompletion faz?
A: A opção --waitForCompletion especifica se a operação deve ser concluída. A definição dessa opção como true aguarda conclusão, enquanto false executa a operação em segundo plano. Por exemplo:
--waitForCompletion true
P: Qual é a finalidade da opção --rmanParallelism?
A: A opção --rmanParallelism especifica o valor de paralelismo do RMAN (Recovery Manager) durante o processo de duplicação. Isso pode melhorar a velocidade da operação de duplicação usando vários processos paralelos.
P: Como especifico o tamanho da SGA e da PGA para o novo banco de dados?
R: Use as opções --sgaSizeInMB e --pgaSizeInMB para especificar os tamanhos da SGA (Área Global do Sistema) e da PGA (Área Global do Programa) em megabytes, respectivamente. Por exemplo:
--sgaSizeInMB <value>
--pgaSizeInMB <value>
P: O que a opção --revert faz?
A: A opção --revert é usada para fazer rollback de uma operação duplicada anterior. Você precisa fornecer o --sessionID para especificar qual sessão reverter.
Exemplo 6-15 dbaascli database duplicate
dbaascli database duplicate --sourceDBConnectionString test-user-scan.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521/mynew.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --dbName newdup --sourceDBWalletLocation /var/opt/oracle/dbaas_acfs/tmp/prim_wallet
Tópico principal: Referência de Comando do 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.
Pré-requisitos
Execute o comando como usuário root ou o usuário oracle
Sintaxe
dbaascli database getDetails --dbname <value>
-
--dbname- corresponde ao nome do banco de dados Oracle.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database getDetails?
R: O comando dbaascli database getDetails mostra informações detalhadas sobre um banco de dados Oracle especificado, incluindo o nome do banco de dados, as informações do nó e os detalhes do banco de dados plugável (PDB).
P: Quem pode executar o comando dbaascli database getDetails?
R: O comando pode ser executado pelo usuário root ou pelo usuário oracle.
P: O que a opção --dbname especifica no comando dbaascli database getDetails?
A: A opção --dbname especifica o nome do banco de dados Oracle para o qual informações detalhadas estão sendo recuperadas.
P: Que tipo de informação o comando dbaascli database getDetails fornece?
R: O comando fornece detalhes como nome do banco de dados, informações do nó e informações sobre bancos de dados plugáveis (PDBs) associados ao banco de dados contêiner.
Tópico principal: Referência de Comando do dbaascli
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>
--dbnameespecifica o nome do banco de dados contêiner
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database getPDBs?
R: O comando dbaascli database getPDBs é usado para listar todos os bancos de dados plugáveis (PDBs) em um banco de dados contêiner (CDB) especificado.
P: Como especifico o banco de dados contêiner para o comando getPDBs?
A: Você usa a opção --dbname para especificar o nome do banco de dados contêiner. Por exemplo:
--dbname <value>
P: Eu preciso executar o comando dbaascli database getPDBs como um usuário específico?
R: Sim, você deve executar o comando como o usuário root ou o usuário oracle.
P: Posso exibir PDBs em um banco de dados não CDB usando o comando getPDBs?
R: Não, o comando getPDBs só é aplicável a bancos de dados contêineres (CDBs). Não é possível usar esse comando para bancos de dados não CDB.
P: Qual é o formato da saída do comando dbaascli database getPDBs?
R: O comando retorna uma lista de todos os PDBs dentro do banco de dados contêiner especificado. A saída geralmente inclui nomes de PDB, status e outros detalhes relevantes sobre cada banco de dados plugável.
P: Este comando pode ser usado para vários bancos de dados de uma só vez?
R: Não, o comando dbaascli database getPDBs funciona com um único banco de dados contêiner por vez, especificado pela opção --dbname.
P: É necessário fazer shutdown do banco de dados para usar o comando getPDBs?
R: Não, o comando getPDBs não requer que o banco de dados seja submetido a shutdown. Ele pode ser executado enquanto o banco de dados contêiner está operacional.
Exemplo 6-16 dbaascli database getPDBs --dbname
dbaascli database getPDBs --dbname apr_db1
Tópico principal: Referência de Comando do dbaascli
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]
--dbnameespecifica o nome do banco de dados.--setParametersespecifica uma lista de parâmetros delimitados por vírgulas a serem modificados com novos valores. Por exemplo:parameter1=valueA,parameter2=valueBe assim por diante. Para valores em branco, use parameter1=valueA,parameter2='',etc.--resetParametersespecifica uma lista de parâmetros delimitados por vírgulas a serem redefinidos para seus valores padrão correspondentes. Por exemplo,parameter1,parameter2e assim por diante.--instanceespecifica 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.--backupPreparedconfirma que há um backup adequado do banco de dados antes de modificar parâmetros críticos ou confidenciais.--allowBounceconcede permissão para devolver o banco de dados a fim de refletir as alterações nos parâmetros estáticos aplicáveis.--waitForCompletionespecifique false para executar a operação em segundo plano. Valores válidos : true|false.]
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database modifyParameters?
A: O comando dbaascli database modifyParameters é usado para modificar ou redefinir parâmetros de inicialização do Oracle Database.
P: Como eu especifico o banco de dados cujos parâmetros eu quero modificar?
R: Você deve usar a opção --dbname para especificar o nome do banco de dados para o qual deseja modificar ou redefinir parâmetros.
P: Como posso modificar os parâmetros do banco de dados usando o comando modifyParameters?
A: Use a opção --setParameters seguida de uma lista de parâmetros delimitados por vírgulas e seus novos valores. Por exemplo:
--setParameters parameter1=valueA,parameter2=valueB
P: Como redefino parâmetros para seus valores padrão usando este comando?
A: Use a opção --resetParameters seguida de uma lista de parâmetros delimitados por vírgulas para redefinir seus valores padrão. Por exemplo:
--resetParameters parameter1,parameter2
P: Posso modificar parâmetros usando um arquivo de resposta?
R: Sim, você pode especificar a localização absoluta de um arquivo JSON de resposta usando a opção --responseFile. O arquivo deve conter os parâmetros que você deseja modificar.
P: É necessário fazer um backup antes de modificar os parâmetros?
R: Embora não seja obrigatório para todas as alterações, se você estiver modificando parâmetros críticos ou confidenciais, é recomendável ter um backup em vigor. Você pode usar a opção --backupPrepared para confirmar que um backup foi preparado.
P: Posso aplicar alterações apenas a uma instância específica em um banco de dados de várias instâncias?
R: Sim, você pode especificar o nome da instância usando a opção --instance. Se esta opção não for usada, as alterações serão aplicadas no nível do banco de dados.
P: O banco de dados precisará ser devolvido (reiniciado) após a modificação dos parâmetros?
R: Para alguns parâmetros estáticos, é necessário um bounce do banco de dados. Você pode usar a opção --allowBounce para conceder permissão para que o banco de dados seja devolvido, se necessário.
P: O que acontece se eu não permitir que o banco de dados seja devolvido ao alterar parâmetros estáticos?
R: Se você não usar a opção --allowBounce ao modificar parâmetros estáticos, as alterações não entrarão em vigor até a próxima reinicialização manual do banco de dados.
P: Posso retomar a modificação de parâmetros se uma sessão anterior foi interrompida?
R: Não, este comando não suporta a retomada da sessão. Você precisará executar o comando novamente desde o início.
Exemplo 6-17 dbaascli database modifyParameters
dbaascli database modifyParameters --dbname dbname --setParameters "log_archive_dest_state_17=ENABLE"
Tópico principal: Referência de Comando do dbaascli
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:
--oracleHomeespecifica o caminho do Oracle home--oracleHomeNameespecifica o nome do Oracle home--dbnameespecifica o nome do banco de dados--executePrereqsexecuta as verificações de pré-requisito e reporta os resultados--resumeretoma a execução anterior-
--sessionIDespecifica para retomar um ID de sessão específico
-
--rollbackfaz rollback do banco de dados para o home anterior--sessionIDespecifica para retomar um ID de sessão específico
--skipDatapatchignora a execução do datapatch nos bancos de dados--skipPdbsignora a execução do datapatch em uma lista especificada de PDBs delimitados por vírgulas. Por exemplo: pdb1,pdb2...--skipClosedPDBsignora a aplicação de patch em PDBs fechados--continueWithDbDowntimecontinua 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.--allowParallelDBMovepermite que o banco de dados seja movido em paralelo.--waitForCompletionespecificafalsepara executar a operação em segundo plano. Valores válidos:true|false--nodeListespecifica uma lista de nós delimitados por vírgulas se a operação precisar ser executada em um subconjunto de nós
Perguntas Frequentes
P: Para que é usado o comando dbaascli database move?
R: O comando dbaascli database move é usado para mover um banco de dados de um Oracle home para outro.
P: Quais são os pré-requisitos para usar o comando dbaascli database move?
R: Antes de executar uma operação de movimentação, verifique se todas as instâncias associadas do banco de dados estão ativas e em execução. Além disso, o comando deve ser executado como o usuário root.
P: O que o parâmetro --oracleHome especifica?
A: O parâmetro --oracleHome especifica o caminho do Oracle home para o qual o banco de dados será movido.
P: O que o parâmetro --oracleHomeName especifica?
A: O parâmetro --oracleHomeName especifica o nome do Oracle home para o qual o banco de dados será movido.
P: Qual é a finalidade do parâmetro --dbname?
A: O parâmetro --dbname especifica o nome do banco de dados que você deseja mover.
P: O que a opção --executePrereqs faz?
A: A opção --executePrereqs executa as verificações de pré-requisitos e reporta os resultados.
P: Para que é usada a opção --resume?
A: A opção --resume retoma uma operação de movimentação interrompida ou incompleta anteriormente.
P: Como --sessionID é usado no comando?
A: O --sessionID especifica o ID da sessão para retomar uma execução ou rollback anterior.
P: O que a opção --rollback faz?
A: A opção --rollback faz rollback do banco de dados para seu Oracle home anterior.
P: O que a opção --skipDatapatch faz?
A: A opção --skipDatapatch ignora a execução do datapatch nos bancos de dados durante a operação de movimentação.
P: Qual é a função da opção --skipPDBs?
A: A opção --skipPDBs ignora a execução do datapatch em uma lista especificada de PDBs (por exemplo, pdb1, pdb2).
P: O que a opção --skipClosedPDBs faz?
A: A opção --skipClosedPDBs ignora a aplicação de patches de PDBs fechados.
P: O que significa --continueWithDbDowntime?
R: A opção --continueWithDbDowntime permite que a operação de movimentação prossiga mesmo que haja apenas uma instância ativa ativa, permitindo tempo de inatividade durante o processo.
P: Qual é a finalidade da opção --allowParallelDBMove?
A: A opção --allowParallelDBMove permite que a movimentação do banco de dados seja executada em paralelo, potencialmente acelerando o processo.
P: O que --waitForCompletion especifica?
A: A opção --waitForCompletion especifica se a operação deve ser concluída. Definir como falso executa a operação em segundo plano.
P: Como posso usar o parâmetro --nodeList?
R: O parâmetro --nodeList especifica uma lista de nós delimitados por vírgulas nos quais a operação de movimentação será executada, se não for aplicada a todos os nós.
P: O que devo fazer se encontrar problemas com o comando dbaascli database move?
R: Certifique-se de que todas as instâncias do banco de dados estejam em execução e verifique se você está executando o comando como o usuário root. Se os problemas persistirem, consulte a documentação de comando detalhada ou abra um ticket de suporte com a Oracle.
P: Posso executar uma operação de movimentação se uma das instâncias do banco de dados estiver inativa?
R: Não, todas as instâncias de banco de dados associadas devem estar ativas e em execução antes de executar a operação de movimentação.
P: O que acontece se a operação de movimentação for interrompida?
R: Você pode usar a opção --resume para continuar a operação de movimentação de onde parou usando a mesma sessão ou especificando --sessionID.
P: O que a opção --allowParallelDBMove faz?
R: Permite que a movimentação do banco de dados seja executada em paralelo, o que pode reduzir o tempo necessário para concluir a operação, especialmente em ambientes maiores.
P: Como monitoro o andamento de uma operação de movimentação que está sendo executada em segundo plano?
R: Ao usar --waitForCompletion false, o comando não aguarda a conclusão da operação. Você pode verificar o status da operação manualmente usando os logs ou comandos de status apropriados da Oracle.
P: Qual é o significado da opção --skipClosedPDBs?
R: Ele ignora a aplicação de patches para PDBs fechados, reduzindo o tempo de operação se houver PDBs que não precisem de aplicação de patch.
P: A movimentação do banco de dados pode ser revertida a qualquer momento?
R: Sim, a operação de movimentação pode ser submetida a rollback usando a opção --rollback, especificando o ID da sessão ou simplesmente fazendo rollback para o Oracle home anterior.
P: Qual é a função de --nodeList em um ambiente com vários nós?
R: Em um ambiente com vários nós, você pode restringir a operação de movimentação a nós específicos fornecendo uma lista delimitada por vírgulas de nomes de nós com --nodeList.
P: Posso mover o banco de dados para um novo Oracle home ao ignorar nós específicos em um ambiente com vários nós?
R: Sim, você pode usar a opção --nodeList para especificar quais nós incluir na operação de movimentação. Todos os nós não listados serão ignorados.
P: Qual é o número máximo de nós que posso especificar com o parâmetro --nodeList?
R: O parâmetro --nodeList permite especificar uma lista delimitada por vírgulas de quantos nós forem necessários, limitada apenas pela configuração do seu ambiente. Certifique-se de que todos os nós sejam válidos e acessíveis.
P: Como sei quais PDBs estão fechados antes de usar a opção --skipClosedPDBs?
R: Você pode consultar a view v$pdbs para verificar o status de seus PDBs. Todos os PDBs com um status de "MOUNTED" ou "CLOSED" serão ignorados ao usar --skipClosedPDBs.
P: Como verifico se um rollback foi concluído com sucesso?
R: Após executar o comando de rollback, você pode revisar os logs do banco de dados ou usar os logs de alerta da Oracle para verificar se o banco de dados foi submetido a rollback com sucesso para seu Oracle home anterior.
P: Existe uma maneira de forçar a operação de movimentação se alguns pré-requisitos falharem?
R: O comando move impõe verificações de pré-requisitos para a estabilidade do sistema. Não é possível ignorar falhas críticas de pré-requisitos. Resolva todos os problemas reportados pela opção --executePrereqs antes de prosseguir com a movimentação.
Exemplo de Casos de Uso
Exemplo 1: Movimentação Básica do Banco de Dados pelo Caminho do Oracle Home
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL
Move o banco de dados ORCL para o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.
Exemplo 2: Movimentação do Banco de Dados pelo Nome do Oracle Home
dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL
Move o banco de dados ORCL para o Oracle home chamado DB_HOME_NAME.
Exemplo 3: Executando Verificações de Pré-requisitos Antes de Mover
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --executePrereqs
Move o banco de dados ORCL para o Oracle home ao executar as verificações de pré-requisitos de antemão.
Exemplo 4: Retomando uma Operação de Movimentação Anterior
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --resume
Retoma uma operação de movimentação anterior para o banco de dados ORCL.
Exemplo 5: Retomando uma Operação de Movimentação com um ID de Sessão Específico
dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --resume --sessionID 12345
Retoma a operação de movimentação do banco de dados ORCL usando o ID de sessão 12345.
Exemplo 6: Fazendo Rollback de uma Operação de Movimentação
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --rollback
Faz rollback da operação de movimentação do banco de dados ORCL, restaurando-a para o Oracle home anterior.
Exemplo 7: Fazendo Rollback de uma Operação de Movimentação com um ID de Sessão
dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --rollback --sessionID 67890
Faz rollback da operação de movimentação para ORCL usando o ID da sessão 67890.
Exemplo 8: Ignorando Datapatch
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipDatapatch
Move o banco de dados ORCL sem executar o datapatch nos bancos de dados.
Exemplo 9: Ignorando PDBs Específicos Durante o Datapatch
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipPDBs pdb1,pdb2
Move o banco de dados ORCL para um novo Oracle home, mas ignora a execução do patch de dados nos PDBs especificados (pdb1 e pdb2).
Exemplo 10: Ignorando o Datapatch em PDBs Fechados
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipClosedPDBs
Move o banco de dados ORCL e ignora a execução do patch de dados em qualquer PDB fechado.
Exemplo 11: Permitindo o Tempo de Inatividade do Banco de Dados Durante a Movimentação
dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --continueWithDbDowntime
Move o banco de dados ORCL para o Oracle home especificado, permitindo o tempo de inatividade do banco de dados durante o processo de movimentação.
Exemplo 12: Movendo o Banco de Dados em Paralelo
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --allowParallelDBMove
Move o banco de dados ORCL para o Oracle home especificado com a opção de executar a movimentação em paralelo para obter melhor desempenho.
Exemplo 13: Executando a Operação em Segundo Plano
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --waitForCompletion false
Move o banco de dados ORCL para um novo Oracle home, mas executa a operação em segundo plano.
Exemplo 14: Especificando Nós para a Movimentação
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --nodeList node1,node2
Move o banco de dados ORCL para o Oracle home especificado, mas executa a operação somente em node1 e node2.
Exemplo 15: Combinação de Movimentação com Verificações de Pré-requisitos, Ignorando PDBs Específicos e Permitindo Período de Indisponibilidade
dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --executePrereqs --skipPDBs pdb1 --continueWithDbDowntime
Move o banco de dados ORCL para o Oracle home especificado, executa verificações de pré-requisitos, ignora a execução do datapatch em pdb1 e permite o tempo de inatividade do banco de dados durante a operação.
Exemplo 16: Combinação de Movimentação em Paralelo e Execução em Segundo Plano
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --allowParallelDBMove --waitForCompletion false
Move o banco de dados ORCL para um novo Oracle home, executa a movimentação em paralelo e executa a operação em segundo plano.
Exemplo 17: Combinando Movimentação com Execução Paralela e Ignorando PDBs Fechados
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname TESTDB --allowParallelDBMove --skipClosedPDBs
Move o banco de dados TESTDB para o novo Oracle home /u02/app/oracle/product/19.0.0/dbhome_2, enquanto executa a operação em paralelo e ignora o datapatch em PDBs fechados.
Exemplo 18: Executando Somente Verificação de Pré-requisitos
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname PRODDB --executePrereqs
Verifica os pré-requisitos para mover o banco de dados PRODDB para o Oracle home localizado em /u02/app/oracle/product/19.0.0/dbhome_2 sem realmente executar a movimentação.
Exemplo 19: Ignorando o Datapatch para PDBs Específicos
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname HRDB --skipPDBs pdb1,pdb3
Move o banco de dados HRDB para o novo Oracle home, mas ignora a execução do datapatch para pdb1 e pdb3.
Exemplo 20: Executando a Movimentação em Nós Específicos
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname FINDB --nodeList node1,node3
Move o banco de dados FINDB para o novo Oracle home somente em node1 e node3.
Exemplo 21: Movimentação do Banco de Dados com Tempo de Inatividade Permitido
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --continueWithDbDowntime
Move o banco de dados ORCL para o Oracle home especificado, permitindo tempo de inatividade durante a operação de movimentação.
Exemplo 22: Combinação de Movimentação Paralela e Ignorando Datapatch
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname CRMDB --allowParallelDBMove --skipDatapatch
Move o banco de dados CRMDB em paralelo, ignorando o processo datapatch.
Exemplo 23: Operação de Movimentação em Segundo Plano com uma Lista de Nós
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname SALESDB --waitForCompletion false --nodeList node2,node3
Move o banco de dados SALESDB para o Oracle home especificado em segundo plano, e a operação só é aplicada em node2 e node3.
Exemplo 24: Movimentação do Banco de Dados com Verificação de Pré-requisito e Permissão de Movimentação Paralela
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_2 --dbname ORCL --executePrereqs --allowParallelDBMove
Move o banco de dados ORCL para o novo Oracle home após executar as verificações de pré-requisitos e executar a operação de movimentação em paralelo.
Exemplo 25: Fazendo Rollback de uma Operação de Movimentação e Ignorando PDBs Fechados
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname DEVDB --rollback --skipClosedPDBs
Faz rollback da operação de movimentação do banco de dados DEVDB, ignorando quaisquer PDBs fechados.
Exemplo 26: Movendo o Banco de Dados com Tempo de Inatividade Específico e Execução Paralela
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname FINDB --allowParallelDBMove --continueWithDbDowntime
Move o banco de dados FINDB para o Oracle home especificado, permitindo tempo de inatividade do banco de dados e permitindo a execução paralela para acelerar o processo.
Exemplo 27: Verificando Pré-requisitos de Movimentação do Banco de Dados sem Executar a Movimentação
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname HRDB --executePrereqs
Executa verificações de pré-requisitos para validar se o banco de dados HRDB pode ser movido para o Oracle home especificado sem executar a movimentação propriamente dita.
Exemplo 28: Movendo o Banco de Dados e Executando o Comando em Segundo Plano em Nós Específicos
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_3 --dbname PRODDB --waitForCompletion false --nodeList node1,node4
Move o banco de dados PRODDB para um novo Oracle home, executando a operação em segundo plano e aplicando-a apenas em node1 e node4.
Exemplo 29: Combinando Verificações de Pré-requisitos, Ignorando PDBs Fechados e Permitindo Execução Paralela
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname CRMDB --executePrereqs --skipClosedPDBs --allowParallelDBMove
Executa verificações de pré-requisitos antes de mover o banco de dados CRMDB para o novo Oracle home, ignora a aplicação de patches em PDBs fechados e permite que a operação seja executada em paralelo para uma execução mais rápida.
Exemplo 30: Movimentação do Banco de Dados com Rollback em um ID de Sessão Específico e Ignorando o Datapatch
dbaascli database move --oracleHomeName DB_HOME_NAME --dbname DEVDB --rollback --sessionID 45678 --skipDatapatch
Faz rollback de uma operação de movimentação executada anteriormente para o banco de dados DEVDB para seu Oracle home anterior usando o ID da sessão 45678, ignorando o processo datapatch durante o rollback.
Exemplo 31: Movendo o Banco de Dados com Permitir Execução Paralela e Especificando o Ignoramento de Datapatch para PDBs
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_3 --dbname ANALYTICDB --allowParallelDBMove --skipPDBs pdb2,pdb4
Move o banco de dados ANALYTICDB em paralelo ao Oracle home especificado e ignora o processo datapatch para pdb2 e pdb4.
Tópico principal: Referência de Comando do dbaascli
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>
}
--dbname: Oracle Database name.--start|--status--start: Begins database recovery.--untilTime|--untilSCN|--latest|--tag--untilTime: Recovers database until time. Input format:DD-MON-YYYY HH24:MI:SS.--untilSCN: Recovers database until SCN.--latest: Recovers database to last known state.--tag: Recovers database to archival tag.--status--uuid <value>
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database recovery?
R: O comando dbaascli database recover é usado para recuperar um Oracle Database de backups armazenados em um destino de armazenamento de backup.
P: Como especificar qual banco de dados recuperar?
R: Você pode especificar o banco de dados que deseja recuperar usando a opção --dbname seguida pelo nome do banco de dados. Por exemplo:
--dbname <database_name>
P: Quais são as opções de recuperação disponíveis com o comando dbaascli database recovery?
A: As opções de recuperação são:
--untilTime: Recupere o banco de dados para um horário específico.
--untilSCN: Recupere o banco de dados para um SCN (Número de Alteração do Sistema) específico.
--latest: Recupere o banco de dados para o último estado conhecido.
--tag: Recupere o banco de dados usando uma tag de arquivamento.
P: Como recupero o banco de dados em um horário específico?
A: Use a opção --untilTime seguida pela hora no formato DD-MON-YYYY HH24:MI:SS. Por exemplo:
--untilTime 05-SEP-2024 15:30:00
P: Como recupero o banco de dados para um SCN específico?
A: Use a opção --untilSCN seguida pelo valor SCN. Por exemplo:
--untilSCN 123456789
P: Como posso recuperar o banco de dados para o estado mais recente conhecido?
R: Use a opção --latest para recuperar o banco de dados para o estado mais recente possível. Por exemplo:
--latest
P: Qual é o uso da opção --tag no processo de recuperação?
A: A opção --tag permite recuperar o banco de dados usando uma tag de arquivamento associada aos backups. Por exemplo:
--tag <backup_tag>
P: Como posso verificar o status de uma operação de recuperação?
R: Use a opção --status junto com o valor --uuid para verificar o status de uma operação de recuperação em andamento ou anterior. Por exemplo:
--status --uuid <recovery_uuid>
P: O que a opção --start faz no processo de recuperação?
A: A opção --start inicia a operação de recuperação com base no método de recuperação selecionado (--untilTime, --untilSCN, --latest ou --tag).
P: Existe uma maneira de recuperar o banco de dados sem especificar um horário ou SCN?
R: Sim, você pode recuperar o banco de dados para seu último estado conhecido usando a opção --latest, que não requer a especificação de um horário ou SCN.
P: Posso realizar uma recuperação parcial?
R: Sim, você pode recuperar o banco de dados para um ponto específico no tempo ou SCN usando as opções --untilTime ou --untilSCN, respectivamente.
Exemplo 6-18 Exemplos
- Para recuperar o banco de dados myTestDb para o mais recente:
dbaascli database recover --dbname myTestDb --start --latest - Para consultar o status da solicitação de recuperação submetida com
uuid2508ea18be2911eb82d0020017075151:dbaascli database recover --dbname myTestDb --status --uuid 2508ea18be2911eb82d0020017075151
Tópico principal: Referência de Comando do dbaascli
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:
--dbnameespecifica o nome do banco de dados--resumeretoma a execução anterior--sessionIDespecifica para retomar um ID de sessão específico
--skipPdbsignora a execução do datapatch em uma lista especificada de PDBs delimitados por vírgulas. Por exemplo: pdb1,pdb2...--pdbsexecuta o datapatch somente em uma lista delimitada por vírgulas de PDBs especificada. Por exemplo: pdb1,pdb2...--executePrereqsexecuta verificações de pré-requisitos--patchListaplica ou faz rollback da lista especificada de patches delimitados por vírgulas. Por exemplo: patch1,patch2...--skipClosedPdbsignora a execução do datapatch em PDBs fechados--rollbackfaz 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
Tópico principal: Referência de Comando do dbaascli
dbaascli database createTemplate
Para criar modelos de banco de dados (modelos DBCA) que possam ser usados subsequentemente para criar bancos de dados, use o comando dbaascli database createTemplate.
Pré-requisitos:
Execute o comando como usuário root.
Sintaxe
Crie um novo modelo de DBCA com base no banco de dados especificado.
dbaascli database createTemplate --dbname <value> --templateLocation <value>
[--templateName <value>]
[--rmanParallelism <value>]
--dbnameespecifica o nome do banco de dados.--templateLocationespecifica o nome do modelo.--rmanParallelismespecifica o valor de paralelismo.
Tópico principal: Referência de Comando do dbaascli
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]
--dbnameespecifica o nome do banco de dados--modeespecifica montagem ou não montagem para iniciar o banco de dados no modo correspondente
O comando inicia e abre o banco de dados. No Oracle Database 12c ou mais recente, todos os PDBs também são abertos.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database start?
A: O comando dbaascli database start é usado para iniciar um Oracle Database.
P: O que deve ser feito antes de executar o comando dbaascli database start?
A: O comando deve ser executado como o usuário root.
P: Como eu especifico o banco de dados que quero iniciar?
A: Use a opção --dbname seguida pelo nome do banco de dados. Por exemplo:
--dbname myDatabase
P: Quais são os modos possíveis em que posso iniciar o banco de dados?
R: Você pode iniciar o banco de dados no modo mount ou nomount usando a opção --mode. Por exemplo:
--mode mount
P: Qual é o modo padrão se eu não especificar um?
R: Se você não especificar um modo, o banco de dados será iniciado no modo open padrão.
P: Este comando abrirá todos os PDBs no Oracle Database 12c ou posterior?
R: Sim, ao iniciar o banco de dados no Oracle Database 12c ou mais recente, todos os bancos de dados plugáveis (PDBs) também serão abertos.
P: Como posso iniciar um banco de dados no modo nomount?
A: Use a opção --mode e defina-a como nomount. Por exemplo:
--mode nomount
P: Como posso iniciar um banco de dados no modo de montagem?
A: Use a opção --mode e defina-a para montar. Por exemplo:
--mode mount
P: É obrigatório especificar um nome de banco de dados ao executar o comando dbaascli database start?
R: Sim, é recomendável especificar o nome do banco de dados usando a opção --dbname para garantir que o banco de dados correto seja iniciado.
Exemplo 6-19 dbaascli database start
dbaascli database start --dbname dbname --mode mount
Tópico principal: Referência de Comando do dbaascli
dbaascli banco de dados status
Para verificar o status de um Banco de Dados Oracle, use o comando dbaascli database status.
Pré-requisitos
Execute o comando como usuário root.
Sintaxe
dbaascli database status
[--service][--dbname]
[--user]
[--password]
--serviceespecifica o nome do serviço--dbnameespecifica o nome do banco de dados--userespecifica o nome do usuário do serviço--passwordespecifica a senha do usuário
A saída do comando inclui o modo aberto do banco de dados, a release e a edição do software do banco de dados e a versão da release de outros componentes do software.
Exemplo 6-20 dbaascli database status
dbaascli database status --dbname db19
Tópico principal: Referência de Comando do dbaascli
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>]
--dbnameespecifica o nome do banco de dados que você deseja interromper--modeespecifica o modo do banco de dados. Valores válidos:abort,immediate,normal,transactional
O comando executa um shutdown do banco de dados no modo imediato. Não são permitidas novas conexões ou novas transações. As transações ativas são revertidas e todos os usuários conectados são desconectados.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database stop?
A: O comando dbaascli database stop é usado para interromper um Oracle Database.
P: Quais são os pré-requisitos para usar o comando dbaascli database stop?
R: Execute o comando como usuário root e estabeleça conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH.
P: Como especificar qual banco de dados interromper?
R: Você pode especificar o banco de dados usando a opção --dbname seguida pelo nome do banco de dados. Por exemplo:
--dbname myDatabase
P: Quais são os modos de shutdown válidos do comando de interrupção do banco de dados dbaascli?
A: Os modos de shutdown válidos são:
abort
immediate
normal
transactional
P: Qual será o modo de shutdown padrão se nenhum modo for especificado?
R: Se nenhum modo for especificado, o banco de dados será submetido a shutdown no modo immediate por padrão.
P: O que acontece no modo de desligamento imediato?
R: No modo immediate, nenhuma conexão ou transação nova é permitida, as transações ativas são submetidas a rollback e todos os usuários conectados são desconectados.
P: Como posso interromper o banco de dados no modo de aborto?
R: Para interromper o banco de dados no modo de aborto, use a opção --mode com abortar. Por exemplo:
--mode abort
P: O que o modo normal faz ao interromper o banco de dados?
R: No modo normal, o banco de dados permite que as sessões atuais do usuário sejam concluídas e, em seguida, interrompidas sem afetar as transações ativas.
P: Para que é usado o modo transacional no comando de interrupção do banco de dados dbaascli?
R: No modo transactional, o banco de dados é interrompido somente depois que todas as transações ativas são concluídas, mas nenhuma nova transação é permitida.
P: É obrigatório especificar o modo de shutdown no comando de interrupção do banco de dados dbaascli?
A: Não, especificar um modo shutdown é opcional. Se não for informado, o modo imediato padrão será usado.
Exemplo 6-21 dbaascli database stop
dbaascli database stop --dbname db19
Tópico principal: Referência de Comando do dbaascli
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>]
--dbname(obrigatório) especifica o nome do banco de dados.--targetHomeespecifica o local do Oracle home de destino--targetHomeNameespecifica o nome do home do Banco de Dados Oracle de destino--standByuse esta opção para fazer upgrade de bancos de dados stand-by nas configurações do Data Guard--allStandbyPreparedobrigató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--removeGRPsó remove automaticamente o backup de Ponto de Restauração Garantido (GRP) se o upgrade do banco de dados foi bem-sucedido--increaseCompatibleParameteraumenta 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--executePrereqsexecuta apenas as verificações de pré-upgrade--postUpgradeuse esta opção se o pós-upgrade falhar e precisar executar novamente as etapas pós-upgrade--rollbackreverte um Oracle Database para seu Oracle home original--upgradeOptionsuse 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--resumepara retomar a execução anterior-
--sessionIDpara retomar um id de sessão específico. --waitForCompletionespecifique false para executar a operação em segundo plano. Valores válidos : true|false.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database upgrade?
R: O comando dbaascli database upgrade é usado para fazer upgrade de um Oracle Database para uma nova versão.
P: Quais são os pré-requisitos para usar o comando dbaascli database upgrade?
R: Você deve executar o comando como usuário root e estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH.
P: Como eu especifico o banco de dados que precisa ser atualizado?
A: Use a opção --dbname seguida pelo nome do banco de dados. Por exemplo:
--dbname myDatabase
P: Como posso especificar o Oracle home de destino para o upgrade?
R: Você pode especificar o local do Oracle home de destino com a opção --targetHome ou o nome do home do Oracle Database de destino com a opção --targetHomeName.
P: O que a opção --standBy faz?
A: A opção --standBy é usada para fazer upgrade de bancos de dados stand-by nas configurações do Data Guard.
P: Qual é a finalidade do flag --allStandbyPrepared?
R: O flag --allStandbyPrepared reconhece que todas as operações necessárias em bancos de dados stand-by foram executadas antes do upgrade do banco de dados principal em uma configuração do Data Guard.
P: O que a opção --removeGRP faz?
A: A opção --removeGRP removerá automaticamente o backup de Ponto de Restauração Garantido (GRP) se o upgrade do banco de dados for bem-sucedido.
P: Quando devo usar a opção --increaseCompatibleParameter?
R: Use a opção --increaseCompatibleParameter para aumentar automaticamente o parâmetro compatível durante o upgrade do banco de dados, desde que o upgrade seja bem-sucedido.
P: O que a opção --executePrereqs faz?
A: A opção --executePrereqs executa apenas as verificações de pré-upgrade para garantir que o banco de dados esteja pronto para o upgrade.
P: Como lidar com uma etapa de pós-upgrade com falha?
A: Use a opção --postUpgrade para executar novamente as etapas de pós-upgrade se a tentativa inicial de pós-upgrade falhar.
P: Qual é a finalidade da opção --revert?
A: A opção --revert reverte o Oracle Database para seu Oracle home original, desfazendo o upgrade.
P: Como posso passar argumentos adicionais específicos do DBUA para o upgrade?
A: Use a opção --upgradeOptions para informar argumentos específicos do DBUA para o upgrade do Oracle Database. Consulte a documentação da Oracle para obter os argumentos e as opções com suporte.
P: É obrigatório especificar o Oracle home de destino para o upgrade?
R: Sim, você deve especificar --targetHome ou --targetHomeName para indicar o Oracle home de destino para o upgrade.
P: O que devo fazer se precisar executar uma verificação de pré-upgrade, mas não continuar com o upgrade?
R: Use a opção --executePrereqs para executar somente as verificações de pré-upgrade sem continuar com o upgrade real.
Exemplo 6-22 dbaascli database upgrade pre-upgrade requisite checks
dbaascli database upgrade --dbbname dbname --targetHome Target Oracle home location --executePrereqs
Tópico principal: Referência de Comando do dbaascli
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>--dbnameespecifica o nome do Oracle Database--blobLocationespecifica a localização do diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do Data Guard
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli dataguard prepareStandbyBlob?
R: O comando dbaascli dataguard prepareStandbyBlob é usado para gerar um arquivo blob contendo vários arquivos necessários no site stand-by em um ambiente do Data Guard.
P: Quais são os pré-requisitos para executar o comando dbaascli dataguard prepareStandbyBlob?
A: O comando deve ser executado como o usuário root ou oracle.
P: Como especifico o nome do Oracle Database para o qual quero preparar o blob stand-by?
A: Use a opção --dbname seguida pelo nome do Oracle Database. Por exemplo:
--dbname myDatabase
P: Como especificar o local onde o arquivo blob stand-by será gerado?
R: Use a opção --blobLocation para especificar o caminho do diretório personalizado no qual o arquivo blob stand-by será gerado. Por exemplo:
--blobLocation /path/to/standby_blob
P: O que a opção --dbname faz no comando?
A: A opção --dbname especifica o nome do Oracle Database para o qual o arquivo blob stand-by está sendo preparado.
P: Qual é a finalidade da opção --blobLocation?
A: A opção --blobLocation define o caminho do diretório personalizado no qual o arquivo blob stand-by será criado.
P: Posso executar o comando dbaascli dataguard prepareStandbyBlob como usuário diferente do root ou do oracle?
R: Não, o comando deve ser executado como o usuário root ou oracle.
P: É possível usar um caminho relativo para a opção --blobLocation?
R: Recomenda-se usar um caminho absoluto para a opção --blobLocation para garantir que o arquivo blob stand-by seja criado no diretório correto.
P: O que devo fazer se eu quiser alterar o local onde o arquivo blob stand-by é gerado?
A: Modifique a opção --blobLocation para especificar um novo caminho de diretório para o arquivo blob stand-by.
P: Preciso executar alguma etapa adicional após gerar o arquivo blob stand-by?
R: Sim, depois de gerar o arquivo blob stand-by, você precisa transferi-lo para o site stand-by e usá-lo para a configuração do Data Guard.
Tópico principal: Referência de Comando do dbaascli
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>--attributescontém os atributos de automação do Data Guard que devem ser modificados. Aceita valores delimitados por vírgula no formato <attribute=value>. Os atributos devem ser predefinidos no arquivo de configuração do Data Guard.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli dataguard updateDGConfigAttributes?
R: O comando dbaascli dataguard updateDGConfigAttributes é usado para atualizar atributos de automação do Data Guard em todos os nós do cluster.
P: Quais são os pré-requisitos para executar o comando dbaascli dataguard updateDGConfigAttributes?
A: O comando deve ser executado como o usuário root ou oracle.
P: Como especifico os atributos que desejo atualizar usando este comando?
A: Use a opção --attributes seguida pelos atributos a serem modificados. Os atributos devem estar em um formato delimitado por vírgulas, como attribute=value. Por exemplo:
--attributes attribute1=value1,attribute2=value2
P: Em qual formato os valores da opção --attributes devem estar?
R: Os valores da opção --attributes devem estar em um formato delimitado por vírgulas com cada atributo especificado como attribute=value.
P: Posso especificar vários atributos na opção --attributes?
R: Sim, você pode especificar vários atributos separando-os com vírgulas. Por exemplo:
--attributes attribute1=value1,attribute2=value2
P: O que acontece se eu fornecer um atributo que não seja predefinido no arquivo de configuração do Data Guard?
R: Se você fornecer um atributo que não seja predefinido, o comando poderá falhar ou ignorar o atributo não reconhecido. Certifique-se de que todos os atributos sejam predefinidos no arquivo de configuração do Data Guard.
P: Preciso reiniciar algum serviço após atualizar os atributos de automação do Data Guard?
R: Na maioria dos casos, você não precisa reiniciar os serviços após atualizar os atributos. No entanto, verifique os atributos específicos e seu impacto para determinar se é necessário reiniciar.
P: Como posso verificar se os atributos do Data Guard foram atualizados com sucesso?
R: Após executar o comando, você pode verificar os atributos atualizados verificando a configuração do Data Guard ou usando comandos/ferramentas de verificação apropriados específicos à sua configuração.
P: O que devo fazer se o comando não atualizar os atributos?
R: Verifique as mensagens de erro para obter detalhes sobre o que deu errado. Verifique se você especificou os atributos corretos e se eles estão predefinidos no arquivo de configuração do Data Guard. Verifique as permissões do usuário e a sintaxe do comando.
P: É possível atualizar atributos apenas para nós específicos usando este comando?
R: Não, o comando dbaascli dataguard updateDGConfigAttributes atualiza atributos em todos os nós do cluster. Se precisar atualizar atributos para nós específicos, talvez seja necessário usar métodos ou comandos diferentes.
Tópico principal: Referência de Comando do dbaascli
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>
--versionespecifica a versão do Oracle Home definida como cinco segmentos numéricos separados por pontos, por exemplo, 19.12.0.0.0--oracleHomeespecifica o local do Oracle home--oracleHomeNameespecifica o nome do Oracle home definido pelo usuário. Se não for fornecido, o nome padrão será usado--enableUnifiedAuditingespecificatrueoufalsepara ativar ou desativar a opção de link de auditoria unificada no Oracle home--imageTagespecifica a tag de imagem do Oracle home-
--imageLocation- caminho da imagem a ser usada. --waitForCompletionespecificafalsepara executar a operação em segundo plano. Valores válidos:trueoufalse.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli dbhome create?
R: O comando dbaascli dbhome create é usado para criar um novo home do Oracle Database com a versão desejada.
P: Quais são os pré-requisitos para executar o comando dbaascli dbhome create?
A: O comando deve ser executado como o usuário root.
P: Como eu especifico a versão do Oracle Database ao criar um novo Oracle Home?
A: Use a opção --version seguida pela versão do Oracle Database no formato de cinco segmentos numéricos separados por pontos, como 19.11.0.0.0.
P: O que a opção --oracleHome especifica?
A: A opção --oracleHome especifica o local onde você deseja instalar o Oracle Home. Se o local não for fornecido, o local padrão será usado.
P: Posso designar um nome personalizado ao novo Oracle Home?
R: Sim, você pode usar a opção --oracleHomeName para especificar um nome definido pelo usuário para o Oracle Home. Se não for especificado, um nome padrão será usado.
P: Como ativo ou desativo a Auditoria Unificada no novo Oracle Home?
A: Use a opção --enableUnifiedAuditing e especifique true para ativar ou false para desativar a Auditoria Unificada para o Oracle Home.
P: O que a opção --imageTag faz?
A: A opção --imageTag especifica a tag de imagem do Oracle Home, que pode ser usada nos casos em que a tag de imagem difere da versão.
P: Qual é um exemplo de uso do comando dbaascli dbhome create com a tag version and image?
A: Um exemplo do comando com a tag version and image é:
dbaascli dbhome create --version 19.8.0.0.0 --imageTag 19.8.0.0.0
Isso cria um Oracle Home para a versão 19.8.0.0.0 com a tag de imagem correspondente.
P: O que acontece se eu não fornecer as opções --oracleHome ou --oracleHomeName?
R: Se --oracleHome não for fornecido, o Oracle Home será instalado no local padrão. Se --oracleHomeName não for especificado, um nome padrão será designado ao Oracle Home.
P: Como posso verificar se a criação do Oracle Home foi bem-sucedida?
R: Depois de executar o comando, verifique os logs de saída em busca de mensagens ou erros bem-sucedidos. Você também pode verificar o Oracle Home navegando até o local especificado ou usando ferramentas Oracle como orainstRoot.sh.
P: É possível criar vários Oracle Homes com versões diferentes no mesmo sistema?
R: Sim, você pode criar vários Oracle Homes com versões diferentes especificando valores diferentes para as opções --version e --oracleHomeName.
P: O que devo fazer se a criação do Oracle Home falhar?
R: Verifique os logs de saída para obter mensagens de erro detalhadas. Verifique se você tem o formato de versão correto, as permissões necessárias e espaço em disco suficiente. Corrija os problemas e tente executar o comando novamente.
Exemplo 6-23 dbaascli dbhome create
dbaascli dbhome create --version 19.11.0.0.0
Como alternativa, dbaascli dbhome create --version 19.8.0.0.0.0 --imageTag 19.8.0.0.0 para casos em que as tags de imagem são diferentes da versão.
Tópico principal: Referência de Comando do dbaascli
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>]]
--oracleHomeespecifica o local do Oracle home--oracleHomeNameespecifica o nome do Oracle home--resumeretoma a execução anterior--sessionIDespecifica para retomar um ID de sessão específico
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli dbHome delete?
A: O comando dbaascli dbHome delete é usado para excluir um home do Oracle Database especificado do sistema.
P: Quais são os pré-requisitos para executar o comando de exclusão dbaascli dbHome?
A: O comando deve ser executado como o usuário root.
P: Como especifico o Oracle Home a ser excluído?
A: Você pode especificar o Oracle Home a ser excluído usando uma das seguintes opções:
--oracleHome <value> para fornecer o caminho absoluto da localização do Oracle Home.
--oracleHomeName <value> para fornecer o nome do Oracle Home.
P: Qual é a diferença entre as opções --oracleHome e --oracleHomeName?
A4:
--oracleHome especifica o local físico ou o caminho do Oracle Home a ser excluído.
--oracleHomeName especifica o nome definido pelo usuário do Oracle Home a ser excluído.
P: Como posso retomar um processo de exclusão interrompido anteriormente?
R: Você pode usar a opção --resume para retomar um processo de exclusão anterior. Se você souber o ID de sessão específico do processo, poderá incluí-lo com a opção --sessionID.
P: Para que é usada a opção --sessionID no comando dbaascli dbHome delete?
A: A opção --sessionID é usada para retomar uma sessão específica que foi interrompida ou falhou anteriormente durante o processo de exclusão.
P: O que acontece se eu não fornecer as opções --resume ou --sessionID?
R: Se as opções --resume ou --sessionID não forem fornecidas, o comando iniciará um novo processo de exclusão em vez de retomar um processo interrompido.
P: Existe alguma forma de confirmar a exclusão do Oracle Home após a execução do comando?
R: Você pode verificar a exclusão verificando se há mensagens de sucesso nos logs de saída e garantindo que o diretório Oracle Home não esteja mais presente no local especificado.
P: Posso excluir um Oracle Home que está sendo usado no momento por um banco de dados em execução?
R: Não, o Oracle Home não deve estar em uso por nenhum banco de dados ou serviço em execução durante o processo de exclusão. Certifique-se de interromper qualquer banco de dados relacionado antes de executar o comando de exclusão.
P: O que devo fazer se o comando de exclusão dbaascli dbHome falhar?
R: Verifique os logs de saída para obter quaisquer mensagens de erro. Certifique-se de que o Oracle Home não esteja em uso, verifique a localização ou o nome correto do Oracle Home e confirme se você tem as permissões necessárias. Depois de resolver quaisquer problemas, execute novamente o comando ou use a opção --resume, se necessário.
P: Posso excluir vários Oracle Homes de uma só vez usando o comando dbaascli dbHome delete?
R: Não, o comando só permite excluir um Oracle Home por vez especificando a opção --oracleHome ou --oracleHomeName.
P: Qual é um exemplo de exclusão de um Oracle Home por seu nome?
A: Aqui está um exemplo de exclusão de um Oracle Home por nome:
dbaascli dbHome delete --oracleHomeName myOracleHome
Esse comando exclui o Oracle Home com o nome myOracleHome.
P: Qual é um exemplo de exclusão de um Oracle Home por sua localização?
A: Aqui está um exemplo de exclusão de um Oracle Home especificando sua localização:
dbaascli dbHome delete --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1
Esse comando exclui o Oracle Home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.
P: Posso cancelar o processo de exclusão depois de iniciado?
R: Não, depois que o processo de exclusão for iniciado, ele não poderá ser cancelado. Certifique-se de que o Oracle Home esteja pronto para exclusão antes de executar o comando.
Tópico principal: Referência de Comando do dbaascli
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 }
--oracleHomeNameespecifica o nome do Oracle home definido pelo usuário--oracleHomeespecifica o local (caminho) do Oracle home
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli dbHome getDatabases?
R: O comando dbaascli dbHome getDatabases é usado para exibir informações sobre todos os Bancos de Dados Oracle em execução em um home do Oracle Database especificado.
P: Como posso especificar o home do Oracle Database a ser verificado?
A: Você pode especificar o home do Oracle Database usando uma das seguintes opções:
--oracleHomeName <value> para especificar o nome definido pelo usuário do Oracle home.
--oracleHome <value> para especificar o local completo (caminho) do Oracle home.
P: Qual é a diferença entre as opções --oracleHomeName e --oracleHome?
A4:
--oracleHomeName refere-se a um nome definido pelo usuário para o Oracle home.
--oracleHome refere-se ao local físico (ou caminho do diretório) do Oracle home no sistema.
P: Como faço para executar o comando dbaascli dbHome getDatabases?
A: Para executar o comando, use a seguinte sintaxe:
dbaascli dbHome getDatabases --oracleHomeName <value>
ou
dbaascli dbHome getDatabases --oracleHome <value>
Certifique-se de executar o comando como usuário root.
P: Posso especificar o nome do Oracle home e o local do Oracle home no mesmo comando?
R: Não, você só pode especificar --oracleHomeName ou --oracleHome em uma única execução de comando. Escolha uma opção com base em como você identifica o Oracle home.
P: Que tipo de informação o comando dbaascli dbHome getDatabases retorna?
R: O comando retorna informações sobre todos os Bancos de Dados Oracle em execução no Oracle home especificado. Isso inclui detalhes como nomes e status do banco de dados.
P: Qual é um exemplo de uso do dbaascli dbHome getDatabases com o local do Oracle home?
A: Aqui está um exemplo de como usar o comando com o local do Oracle home:
dbaascli dbHome getDatabases --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1
Esse comando recupera a lista de bancos de dados em execução no Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.
P: Qual é um exemplo de uso do dbaascli dbHome getDatabases com o nome do Oracle home?
A: Aqui está um exemplo de como usar o comando com o nome do Oracle home:
dbaascli dbHome getDatabases --oracleHomeName myOracleHome
Esse comando recupera a lista de bancos de dados em execução no Oracle home chamado myOracleHome.
P: Preciso de permissões especiais para executar este comando?
R: Sim, você deve executar o comando como usuário raiz para exibir as informações sobre Bancos de Dados Oracle em execução em um Oracle home especificado.
P: O que devo verificar se o comando dbaascli dbHome getDatabases não retorna bancos de dados?
R: Certifique-se de ter especificado o nome ou o local correto do Oracle home e de que há bancos de dados em execução nesse Oracle home. Além disso, confirme se o Oracle home está configurado e ativo corretamente.
P: Posso usar o comando dbaascli dbHome getDatabases em vários Oracle homes de uma só vez?
R: Não, o comando funciona em um único Oracle home de cada vez. Execute o comando separadamente para cada Oracle home que você deseja consultar.
P: Existe uma maneira de verificar se o Oracle home especificado no comando está correto?
R: Você pode verificar o Oracle home verificando a estrutura do diretório ou os detalhes da configuração no sistema para garantir que o caminho ou o nome fornecido corresponda ao Oracle home real.
P: O que acontece se eu executar o comando sem especificar um nome do Oracle home ou do Oracle home?
A: O comando requer que a opção --oracleHome ou --oracleHomeName seja especificada. Se nenhuma das opções for fornecida, o comando falhará ao ser executado.
P: Este comando pode recuperar bancos de dados que estão interrompidos no momento?
R: Sim, o comando listará todos os bancos de dados associados ao Oracle home especificado, independentemente de estarem em execução ou interrompidos no momento.
Exemplo 6-24 dbaascli dbHome getDatabases --oracleHome
dbaascli dbHome getDatabases --oracleHome /u02/app/mar_home/
Tópico principal: Referência de Comando do dbaascli
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 }
--oracleHomeNameespecifica o nome do Oracle home definido pelo usuário--oracleHomeespecifica o local do Oracle home
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli dbHome getDetails?
R: O comando dbaascli dbHome getDetails é usado para exibir informações detalhadas sobre um Oracle home específico no sistema.
P: Como especifico o Oracle home sobre o qual quero obter detalhes?
A: Você pode especificar o Oracle home usando uma das seguintes opções:
--oracleHomeName <value> para especificar o nome definido pelo usuário do Oracle home.
--oracleHome <value> para especificar o local completo (caminho) do Oracle home.
P: Qual é a diferença entre --oracleHomeName e --oracleHome?
A4:
--oracleHomeName é o nome definido pelo usuário para um Oracle home.
--oracleHome refere-se ao caminho completo do diretório em que o Oracle home está localizado.
P: Como faço para executar o comando dbaascli dbHome getDetails?
A: Para executar o comando, use a seguinte sintaxe:
dbaascli dbHome getDetails --oracleHomeName <value>
ou
dbaascli dbHome getDetails --oracleHome <value>
Certifique-se de executar o comando como usuário root.
P: Posso especificar --oracleHomeName e --oracleHome no mesmo comando?
R: Não, você só pode usar uma opção por execução de comando. Especifique o nome do Oracle home ou o local do Oracle home, não ambos.
P: Quais informações o comando dbaascli dbHome getDetails retorna?
R: O comando fornece informações detalhadas sobre o Oracle home especificado, como sua versão, status e quaisquer outros detalhes de configuração associados ao Oracle home.
P: Qual é um exemplo de uso do comando dbaascli dbHome getDetails com um local do Oracle home?
A: Aqui está um exemplo:
dbaascli dbHome getDetails --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1
Este comando recupera informações detalhadas sobre o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.
P: Qual é um exemplo de uso do comando dbaascli dbHome getDetails com um nome do Oracle home?
A: Aqui está um exemplo:
dbaascli dbHome getDetails --oracleHomeName myOracleHome
Este comando recupera informações detalhadas sobre o Oracle home chamado myOracleHome.
P: Preciso de permissões especiais para executar este comando?
R: Sim, você deve executar o comando como usuário raiz para exibir detalhes sobre o Oracle home.
P: O que devo fazer se o comando dbaascli dbHome getDetails não retornar informações?
R: Verifique se você especificou corretamente o nome ou o local do Oracle home e se o Oracle home está configurado corretamente e existe no sistema.
P: Posso usar o comando dbaascli dbHome getDetails em vários Oracle homes simultaneamente?
R: Não, o comando só funciona em um único Oracle home de cada vez. Execute o comando separadamente para cada Oracle home.
P: É possível verificar o nome do Oracle home antes de executar o comando?
R: Sim, você pode verificar o nome do Oracle home verificando os arquivos de configuração do sistema ou listando todos os Oracle homes disponíveis no sistema.
P: O que acontece se eu não especificar um nome ou local do Oracle home no comando?
A: O comando requer que a opção --oracleHome ou --oracleHomeName seja especificada. Se nenhum dos dois for fornecido, a execução do comando falhará.
P: Posso recuperar informações sobre Oracle homes que não estão em uso no momento?
R: Sim, o comando dbaascli dbHome getDetails fornece detalhes sobre Oracle homes, independentemente de eles estarem em uso ou ociosos.
P: O que devo verificar se o comando retorna um erro?
R: Verifique se o nome ou a localização do Oracle home está correto, se o Oracle home existe e se você está executando o comando como o usuário root. Verifique novamente se há erros de digitação ou caminhos incorretos.
Exemplo 6-25 dbaascli dbHome getDetails - using Oracle home location
dbaascli dbHome getDetails --oracleHome /u02/app/home_db19c/
Exemplo 6-26 dbaascli dbHome getDetails - using Oracle home name
dbaascli dbHome getDetails --oracleHomeName home_db19c
Tópico principal: Referência de Comando do dbaascli
patch dbaascli dbHome
Para aplicar patch no Oracle home de um nível de patch para outro, use o comando dbaascli dbHome patch.
Pré-requisito
Execute o comando como usuário root.
Sintaxe
dbaascli dbHome patch
{
--oracleHome <value>
| --oracleHomeName <value>
}
[--imageFilePath <value>] [--executePrereqs] [--nodes <value>]
{
[--resume [--sessionID <value>]]
| [--rollback [--sessionID <value>]]
}
[--skipDatapatch]
[--skipClosedPDBs]
[--skipPDBs <value>]
[--continueWithDbDowntime]
[--skipUnreachableNodes]
[--drainTimeoutInSeconds <value>]
[--waitForCompletion <value>]
--oracleHomeespecifica o caminho do Oracle home--oracleHomeNameespecifica o nome do Oracle home--targetVersionespecifica a versão de destino do Oracle Home definida como cinco segmentos numéricos separados por pontos, por exemplo, 19.12.0.0.0--resumeretoma a execução anterior-
--sessionIDespecifica para retomar um ID de sessão específico
-
--continueWithDbDowntimecontinua 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.--skipUnreachableNodesignora a operação em nós inacessíveis--nodesespecifica 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--executePrereqsexecuta pré-requisitos--skipDatapatchignora a execução dedatapatchnos bancos de dados--imageFilePathespecifica o caminho absoluto do arquivo de imagem a ser usado--skipPDBsignora 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--skipClosedPdbsignora a execução dedatapatchem PDBs fechados--rollbackfaz rollback do Oracle home que recebeu patch.--waitForCompletionespecifica false para executar a operação em segundo plano. Valores válidos :true|false--drainTimeoutInSecondsespecifica o tempo (em segundos) para concluir a descarga de recursos enquanto o banco de dados é interrompido--skipUnreachableNodesignora a operação em nós inacessíveis
Perguntas Frequentes
P: Para que é usado o comando de patch dbaascli dbHome?
A: O comando dbaascli dbHome patch é usado para aplicar patch ao Oracle home de um nível de patch para outro.
P: Preciso de permissões especiais para executar o comando de patch dbaascli dbHome?
R: Sim, você precisa executar o comando como usuário root.
P: Como especifico o caminho ou o nome do Oracle home para o patch?
A: Use a opção --oracleHome para especificar o caminho do Oracle home ou --oracleHomeName para especificar o nome do Oracle home.
P: Como posso definir a versão de destino do patch?
R: Use a opção --targetVersion seguida do número da versão no formato 19.12.0.0.0.
P: O que a opção --resume faz?
A: A opção --resume permite retomar uma sessão de aplicação de patch anterior.
P: Como especificar um ID de sessão específico ao retomar um patch?
R: Use a opção --sessionID para especificar o ID da sessão de aplicação de patch que você deseja retomar.
P: Para que é usada a opção --continueWithDbDowntime?
A: A opção --continueWithDbDowntime permite que a aplicação de patch continue mesmo que haja tempo de inatividade do banco de dados, útil em ambientes com apenas uma instância ativa.
P: Como posso ignorar a aplicação de patch em nós inacessíveis?
A: Use a opção --skipUnreachableNodes para ignorar operações em nós inacessíveis.
P: Como aplicar patch apenas a nós específicos em um cluster?
A: Use a opção --nodes seguida de uma lista delimitada por vírgulas de nomes de nós para aplicar patch a um subconjunto de nós.
P: Para que serve a opção --executePrereqs?
A: A opção --executePrereqs executa verificações de pré-requisitos antes de aplicar o patch.
P: Como posso ignorar a execução do datapatch nos bancos de dados?
A: Use a opção --skipDatapatch para ignorar o processo datapatch durante a aplicação de patch.
P: Posso especificar um local personalizado para a imagem do banco de dados?
R: Sim, use a opção --imageLocation para especificar um local personalizado para a imagem do banco de dados.
P: O que a opção --skipPDBs faz?
A: A opção --skipPDBs permite ignorar a execução do datapatch em uma lista especificada de bancos de dados plugáveis (PDBs) delimitados por vírgulas.
P: Como posso ignorar o datapatch em PDBs fechados?
A: Use a opção --skipClosedPDBs para ignorar o datapatch em PDBs fechados.
P: O que acontece se eu usar a opção --rollback?
A: A opção --rollback reverterá o Oracle home para seu estado anterior antes que o patch seja aplicado.
P: Como especifico o caminho do Oracle home para aplicação de patch?
A: Use a opção --oracleHome seguida pelo caminho para o diretório do Oracle home.
P: Como posso aplicar patch a um Oracle home pelo nome dele, e não pelo caminho?
A: Use a opção --oracleHomeName seguida pelo nome do Oracle home.
P: Como retomo uma operação de aplicação de patch se ela foi interrompida?
A: Use a opção --resume junto com a opção --sessionID para retomar uma sessão interrompida específica.
P: Posso continuar o processo de aplicação de patch se o banco de dados estiver inativo?
R: Sim, use a opção --continueWithDbDowntime para continuar a aplicação de patch, mesmo que o banco de dados esteja inativo.
P: O que devo fazer se alguns nós estiverem inacessíveis durante o processo de aplicação de patch?
A: Use a opção --skipUnreachableNodes para ignorar os nós inacessíveis.
P: Como posso aplicar o patch apenas a determinados nós?
A: Especifique os nós que você deseja aplicar patch usando a opção --nodes com uma lista de nomes de nós separados por vírgulas.
P: Como verifico os pré-requisitos antes de aplicar o patch?
R: Use a opção --executePrereqs para executar verificações de pré-requisitos antes de aplicar o patch.
P: O que devo fazer se quiser evitar a aplicação do datapatch durante o processo de aplicação de patch?
A: Use a opção --skipDatapatch para ignorar a etapa datapatch.
P: Como posso especificar um local diferente para a imagem do banco de dados usada no processo de aplicação de patch?
A: Use a opção --imageLocation para especificar um local personalizado para a imagem.
P: E se eu precisar ignorar o datapatch em determinados PDBs?
A: Use a opção --skipPDBs para ignorar o datapatch em uma lista especificada de PDBs delimitados por vírgulas.
P: Posso ignorar o datapatch em PDBs que não estão abertos no momento?
R: Sim, use a opção --skipClosedPDBs para ignorar o datapatch em PDBs fechados.
P: O que devo fazer se a correção falhar no meio do caminho?
R: Você pode usar a opção --rollback para reverter para o estado anterior ou tentar retomar o processo de correção com a opção --resume.
P: Como posso verificar se todos os pré-requisitos foram atendidos antes de aplicar o patch?
R: Execute o comando de patch com a opção --executePrereqs para garantir que todos os pré-requisitos sejam atendidos.
P: E se a operação de aplicação de patch não for concluída com sucesso e eu precisar tentar novamente?
A: Use a opção --resume para repetir a operação de aplicação de patch de onde ela parou. Se necessário, você pode especificar um --sessionID para retomar uma sessão específica.
P: Como posso verificar se o patch foi aplicado com sucesso?
R: Você pode verificar o processo de aplicação de patch verificando a versão do Oracle home usando o comando opatch lsinventory após a conclusão do patch.
P: Posso executar o comando de aplicação de patches em um modo dryrun para visualizar ações?
R: Não, o comando dbaascli dbHome patch não tem um recurso de dryrun. No entanto, você pode usar a opção --executePrereqs para executar verificações de pré-requisitos antes de realmente aplicar o patch.
P: É possível aplicar vários patches em uma única execução?
A: O comando dbaascli dbHome patch só permite uma versão de destino por vez. Você precisaria executar o comando separadamente para cada versão do patch.
P: Como tratar a aplicação de patches se o ambiente usar vários Oracle homes?
R: Você pode especificar o Oracle home ao qual deseja aplicar patch usando as opções --oracleHome ou --oracleHomeName, dependendo se você está especificando o caminho ou o nome do Oracle home.
P: Posso ignorar o datapatch do PDB e do CDB em um comando?
R: Sim, você pode combinar as opções --skipPDBs e --skipDatapatch para ignorar o patch de dados para PDBs e CDB em uma única execução de patch.
P: Posso aplicar um patch e fazer rollback imediatamente se ele causar problemas?
R: Sim, depois de aplicar um patch, você pode usar a opção --rollback para reverter para o nível de patch anterior se houver algum problema.
P: Posso aplicar patch a vários Oracle homes simultaneamente?
R: Não, você precisa executar o comando dbaascli dbHome patch individualmente para cada Oracle home.
P: Como posso rastrear o andamento da operação de aplicação de patch?
R: Durante o processo de aplicação de patches, o comando fornece mensagens de saída que mostram o andamento. Você também pode verificar os arquivos de log para obter informações detalhadas.
P: Posso executar a aplicação de patches em paralelo em um ambiente clusterizado?
R: As operações de aplicação de patch podem ser aplicadas a um subconjunto de nós usando a opção --nodes. No entanto, a aplicação simultânea de patches deve ser tratada com cuidado e você deve garantir que não haja sessões sobrepostas.
P: Como posso identificar quais patches estão disponíveis para meu Oracle home?
R: Você pode verificar os patches disponíveis por meio do portal de suporte da Oracle ou executando o comando opatch lsinventory para ver os patches atuais aplicados ao Oracle home.
P: Posso especificar um timeout para drenar recursos ao interromper o banco de dados durante a aplicação de patch?
R: Sim, você pode usar a opção --drainTimeoutInSeconds para especificar o tempo em segundos para drenagem de recursos ao interromper o banco de dados.
P: O que acontece se o patch falhar em um dos nós em um ambiente com vários nós?
R: Você pode usar a opção --skipUnreachableNodes para ignorar o nó com falha e continuar o processo de aplicação de patch nos nós restantes. Em seguida, você pode resolver o problema no nó com falha separadamente.
P: Como posso fazer com que o processo de aplicação de patches seja executado em segundo plano?
A: Use a opção --waitForCompletion com um valor de false para permitir que o processo de aplicação de patch seja executado em segundo plano. Dessa forma, você não precisa esperar que o processo seja concluído de forma interativa.
P: Posso executar uma operação de rollback em um subconjunto de nós em um ambiente clusterizado?
R: Sim, você pode usar a opção --nodes junto com a opção --rollback para fazer rollback da aplicação de patch em um conjunto específico de nós.
P: E se eu precisar atualizar a localização da imagem após iniciar o processo de patch?
A: A opção --resume não permite alterar o local da imagem. No entanto, você pode interromper a sessão e iniciar um novo processo de patch com o --imageLocation atualizado.
P: Existe uma maneira de verificar quais IDs de sessão estão disponíveis para retomar um patch?
R: Você pode verificar os arquivos de log ou usar as ferramentas do Oracle Cloud para identificar sessões de aplicação de patches ativas ou pausadas e seus IDs de sessão.
P: Posso limitar o tempo de inatividade durante a aplicação de patches?
R: Se você precisar limitar o tempo de inatividade, use a opção --continueWithDbDowntime com cuidado. Isso permite que você prossiga mesmo quando o tempo de inatividade for esperado, mas requer planejamento para um impacto mínimo no serviço.
Exemplo de Casos de Uso
Exemplo 1: Aplicação Básica de Patch do Oracle Home pelo Caminho do Oracle Home
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0
Corrige o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1 para a versão 19.12.0.0.0.
Exemplo 2: Aplicação de Patch por Nome do Oracle Home
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0
Corrige o Oracle home chamado DB_HOME_NAME para a versão 19.12.0.0.0.
Exemplo 3: Retomando uma Operação de Patch Anterior
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --resume
Retoma a operação de aplicação de patch anterior para o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.
Exemplo 4: Retomando um Patch com um ID de Sessão Específico
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --resume --sessionID 12345
Retoma a operação de aplicação de patch do Oracle home DB_HOME_NAME usando o ID da sessão 12345.
Exemplo 5: Patch com Tempo de Inatividade do Banco de Dados Permitido
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --continueWithDbDowntime
Corrige o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1 para a versão 19.12.0.0.0, permitindo o tempo de inatividade do banco de dados.
Exemplo 6: Ignorando Nós Inacessíveis
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes
Corrige o Oracle home para a versão 19.12.0.0.0 ao ignorar qualquer nó inacessível.
Exemplo 7: Aplicando Patch a um Subconjunto de Nós
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --nodes node1,node2
Corrige o Oracle home para a versão 19.12.0.0.0 somente em node1 e node2.
Exemplo 8: Executando Verificações de Pré-requisitos Antes da Aplicação de Patch
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --executePrereqs
Corrige o Oracle home DB_HOME_NAME para a versão 19.12.0.0.0 após executar verificações de pré-requisitos.
Exemplo 9: Ignorando a Etapa Datapatch
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch
Corrige o Oracle home para a versão 19.12.0.0.0 sem executar o datapatch nos bancos de dados.
Exemplo 10: Usando um Arquivo de Imagem para Aplicação de Patch
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --imageFilePath /path/to/image/file.zip
Corrige o Oracle home para a versão 19.12.0.0.0 usando um arquivo de imagem localizado em /path/to/image/file.zip.
Exemplo 11: Ignorando PDBs Específicos Durante o Datapatch
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2
Corrige o Oracle home para a versão 19.12.0.0.0 e ignora a execução de datapatch nos PDBs especificados (pdb1 em cdb1 e pdb2 em cdb2).
Exemplo 12: Ignorando o Datapatch em PDBs Fechados
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipClosedPDBs
Corrige o Oracle home para a versão 19.12.0.0.0 ao ignorar a execução do datapatch em qualquer PDB fechado.
Exemplo 13: Fazendo Rollback do Oracle Home
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback
Faz rollback do último patch aplicado no Oracle home chamado DB_HOME_NAME.
Exemplo 14: Combinação de Aplicação de Patch com Verificações de Pré-requisitos e Nós Específicos
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --executePrereqs --nodes node1,node2
Corrige o Oracle home para a versão 19.12.0.0.0, executa verificações de pré-requisitos e aplica o patch apenas em node1 e node2.
Exemplo 15: Ignorando Nós Inacessíveis e PDBs Específicos
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --skipUnreachableNodes --skipPDBs cdb1:pdb1
Corrige o Oracle home DB_HOME_NAME para a versão 19.12.0.0.0 enquanto ignora nós inacessíveis e evita a execução de datapatch em pdb1 em cdb1.
Exemplo 16: Verificando o Pós-Patch da Versão do Oracle Home
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0
opatch lsinventory
Este exemplo mostra como verificar a versão do Oracle home após um patch bem-sucedido executando opatch lsinventory.
Exemplo 17: Fazendo Rollback de Patches com ID de Sessão Específica
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --sessionID 67890
Faz rollback da aplicação de patch do Oracle home para um ID de sessão de 67890.
Exemplo 18: Aplicação de Patch com Ignorando Verificações de Pré-requisitos
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPrereqs
Corrige o Oracle home, mas ignora as verificações de pré-requisitos antes de aplicar o patch.
Exemplo 19: Aplicando um Patch a uma Imagem Personalizada do Oracle Home
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --imageLocation /custom/location/image.zip
Corrige o Oracle home usando um arquivo de imagem personalizado localizado em /custom/location/image.zip.
Exemplo 20: Ignorando Nós Específicos e Executando Pré-requisitos
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes --executePrereqs
Ignora a aplicação de patches em nós inacessíveis e executa verificações de pré-requisitos antes de aplicar o patch.
Exemplo 21: Ignorando o Datapatch em Todos os PDBs em Vários CDBs
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2,cdb3:pdb3
Corrige o Oracle home, mas ignora o patch de dados nos PDBs especificados em vários CDBs.
Exemplo 22: Continuando a Aplicação de Patches com Tempo de Inatividade em Vários Nós
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --continueWithDbDowntime --nodes node3,node4
Continua a aplicação de patches em node3 e node4 com tempo de inatividade do banco de dados permitido.
Exemplo 23: Ignorando o Datapatch em PDBs e PDBs Fechados
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch --skipClosedPDBs
Corrige o Oracle home ao ignorar o patch de dados e os PDBs fechados.
Exemplo 24: Fazendo Rollback e Reaplicando Patch
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0
Faz rollback do patch atual e, em seguida, reaplica o patch ao Oracle home.
Exemplo 25: Ignorando o Datapatch e Permitindo Tempo de Inatividade em um Nó Específico
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipDatapatch --continueWithDbDowntime --nodes node1
Corrige o Oracle home para a versão 19.13.0.0.0 em node1, ignorando a etapa do datapatch e permitindo tempo de inatividade.
Exemplo 26: Especificando o Timeout de Drenagem Durante o Shutdown do Banco de Dados
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.13.0.0.0 --drainTimeoutInSeconds 300
Corrige o Oracle home DB_HOME_NAME para a versão 19.13.0.0.0 e permite um timeout de 5 minutos (300 segundos) para drenar recursos durante o shutdown.
Exemplo 27: Executando Patches em Segundo Plano
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --waitForCompletion false
Corrige o Oracle home para a versão 19.13.0.0.0 e executa o processo de aplicação de patch em segundo plano sem aguardar a conclusão.
Exemplo 28: Fazendo Rollback do Patch em um Subconjunto de Nós
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --nodes node1,node2
Faz rollback do último patch aplicado em node1 e node2 somente para o Oracle home especificado.
Exemplo 29: Ignorando Pré-requisitos e Aplicando Patches a Vários Nós
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipPrereqs --nodes node3,node4
Corrige o Oracle home para a versão 19.13.0.0.0 em node3 e node4 sem executar verificações de pré-requisitos.
Exemplo 30: Fazendo Rollback do Patch e Ignorando Nós Inacessíveis
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback --skipUnreachableNodes
Faz rollback do último patch no Oracle home DB_HOME_NAME e ignora nós inacessíveis durante o processo de rollback.
Tópico principal: Referência de Comando do dbaascli
dbaascli dbimage Purge
O comando dbimage purge remove a imagem de software especificada do seu ambiente do Oracle Exadata Database Service on Exascale Infrastructure.
Conecte-se ao nó de computação como o usuário opc e execute esse comando como o usuário root.
# dbaascli dbimage purge --version software_version --bp software_bp [--cdb ( yes | no )]No comando precedente:
-
software_version— especifica a versão do software Oracle Database. Por exemplo,11204,12102,12201,18000,19000. -
software_bp— identifica a release do patch do pacote. Por exemplo,APR2018,JAN2019,OCT2019etc. -
--cdb— especifica opcionalmente se a imagem de software que suporta a arquitetura multitenant Oracle deve ser removida. O padrão éyes. Se você especificar--cdb no, a imagem de software que contém os binários para suportar bancos de dados não contêineres (não CDB) será removida.
Se o comando for remover uma imagem de software que não está disponível no momento na biblioteca de imagens de software e, portanto, não pode ser baixada novamente, o comando será pausado e solicitará confirmação.
Não é possível remover a imagem de software padrão atual para qualquer versão de software. Para evitar essa restrição, é necessário tornar outra imagem de software o padrão atual.
Tópico principal: Referência de Comando do dbaascli
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>]
--componentsespecifica uma lista de componentes para a coleta de logs.Valores válidos:
dbgiosdbaastoolsall
--startTimeespecifica o horário inicial da coleta de logs. Formato válido de data e hora:YYYY-MM-DDTHH24:MM:SS--endTimeespecifica o horário final da coleta de logs. Formato válido de data e hora:YYYY-MM-DDTHH24:MM:SS--nodesespecifica uma lista de nós delimitados por vírgulas para coletar logs--dbNamesespecifica o nome do banco de dados cujos logs serão coletados. Você só pode especificar um nome de banco de dados.--objectStoreBucketURIespecifica 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.--destLocationespecifica o local na VM Convidada para coletar logs. Padrão:/var/opt/oracle/dbaas_acfs--waitForCompletionValores:true|false. Padrão:true. Especifiquefalsepara ser executado em segundo plano.
Tópicos Relacionados
Tópico principal: Referência de Comando do dbaascli
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]
--destLocationespecifica o local na VM Convidada para coletar logs. Padrão:/var/opt/oracle/dbaas_acfs--nodesespecifica uma lista de nós delimitados por vírgulas para coletar logs--objectStoreBucketURIespecifica um URL de PAR (solicitação pré-autenticada) do serviço Object Storage usado para fazer upload de logs coletados. Os logs são coletados da VM Convidada. Para obter mais informações, consulte Usando Solicitações Pré-autenticadas.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli diag healthCheck?
R: O comando dbaascli diag healthCheck é usado para executar verificações de integridade de diagnóstico em um Oracle Database executado em um ambiente Exadata Cloud@Customer.
P: Quais são os pré-requisitos para usar o comando dbaascli diag healthCheck?
R: O comando deve ser executado como o usuário root e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: Como eu especifico um diretório personalizado para coletar os logs?
R: Use a opção --destLocation para especificar o diretório no qual os logs de verificação de integridade serão coletados. O local padrão é /var/opt/oracle/dbaas_acfs.
P: Qual será o local padrão para a coleta de logs se eu não especificar --destLocation?
A: O diretório padrão para coleta de logs é /var/opt/oracle/dbaas_acfs.
P: Posso especificar em quais nós executar a verificação de integridade?
R: Sim, você pode usar a opção --nodes para especificar uma lista de nós delimitados por vírgulas em que a verificação de integridade deve ser executada.
P: Como faço upload dos logs de verificação de integridade para o Object Storage?
A: Use a opção --objectStoreBucketURI para fornecer um URL de PAR (solicitação pré-autenticada) do serviço Object Storage. Isso fará upload dos logs coletados para o bucket especificado.
P: Posso coletar logs de vários nós?
R: Sim, você pode especificar vários nós usando a opção --nodes em um formato delimitado por vírgulas. Por exemplo: --nodes node1,node2.
P: Qual é um exemplo de comando para executar uma verificação de integridade em um nó específico?
A: Aqui está um exemplo de comando para executar a verificação de integridade em um nó específico:
dbaascli diag healthCheck --nodes node1
P: Como posso armazenar os logs no Object Storage em vez de na máquina local?
R: Você pode fornecer um URL de PAR (solicitação pré-autenticada) usando a opção --objectStoreBucketURI para armazenar os logs no Object Storage.
P: Posso especificar --destLocation e --objectStoreBucketURI ao mesmo tempo?
R: Sim, você pode especificar --destLocation para armazenamento local e --objectStoreBucketURI para fazer upload de logs para o Object Storage.
P: O que devo fazer se encontrar um erro ao executar o comando dbaascli diag healthCheck?
R: Certifique-se de que você esteja executando o comando como o usuário raiz e tenha fornecido opções válidas para --destLocation, --nodes ou --objectStoreBucketURI. Verifique se os nomes dos nós estão corretos, se especificados.
P: Posso executar a verificação de integridade em segundo plano?
R: O comando dbaascli diag healthCheck não tem um modo de fundo explícito, mas você pode executá-lo em segundo plano anexando & no final do comando.
P: O que acontece se eu não fornecer a opção --nodes?
R: Se a opção --nodes não for fornecida, a verificação de integridade será executada em todos os nós do cluster por padrão.
P: Posso retomar uma sessão de verificação de integridade anterior usando este comando?
R: Não, o comando dbaascli diag healthCheck não suporta a retomada das sessões anteriores. Você deve iniciar uma nova verificação de integridade todas as vezes.
P: Qual é um exemplo de comando para executar uma verificação de integridade e fazer upload de logs para o Object Storage?
A: Aqui está um exemplo de comando:
dbaascli diag healthCheck --objectStoreBucketURI https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL
P: Qual será o comportamento padrão se eu não especificar --destLocation ou --objectStoreBucketURI?
R: Se nem --destLocation nem --objectStoreBucketURI forem especificados, os logs de verificação de integridade serão coletados no diretório padrão /var/opt/oracle/dbaas_acfs na máquina local.
P: Posso limitar a verificação de integridade a componentes ou logs específicos?
R: Não, o comando dbaascli diag healthCheck não permite especificar componentes ou logs individuais. Ele executa uma verificação geral de saúde de diagnóstico para o sistema.
P: O que devo verificar antes de executar o comando dbaascli diag healthCheck?
R: Certifique-se de estar conectado a uma máquina virtual do Exadata Cloud@Customer e executando o comando como o usuário root.
Tópicos Relacionados
Tópico principal: Referência de Comando do dbaascli
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
Por padrão, o TCPS é ativado para bancos de dados em sistemas Oracle Exadata Database Service on Dedicated Infrastructure.
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]
--pkcs12WalletFilePathespecifica o caminho absoluto do arquivo de certificado, que está no formato de walletpkcs12--caCertChainlista concatenada de certificados, contendo certificados da CA intermediárias e da CA raiz--precheckOnlyespecificayespara só executar as pré-verificações desta operação. Valores válidos:yesouno.--serverCertespecifica o caminho do certificado PEM a ser usado ou alternado para a configuração TCPS.--privateKeyespecifica o caminho do arquivo de chave privada do certificado.--certTypetipo do certificado a ser adicionado à wallet do Grid Infrastructure. Os valores aceitos são:SELF_SIGNED_CERT,CA_SIGNED_CERTouPKCS12_CERT. Padrão:SELF_SIGNED_CERT--privateKeyPasswordProtectedespecifica se a chave privada é protegida por senha ou não. Valores válidos:trueoufalse. Padrão:true.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli grid configureTCPS?
A: O comando dbaascli grid configureTCPS é usado para configurar o TCPS (Transport Layer Security) para o cluster existente em um ambiente Oracle Exadata.
P: Qual é o pré-requisito para executar o comando dbaascli grid configureTCPS?
A: O comando deve ser executado como o usuário root.
P: O TCPS é ativado por padrão no Exadata Database Service em sistemas de Infraestrutura Dedicada?
R: Sim, o TCPS é ativado por padrão para bancos de dados em sistemas Oracle Exadata Database Service on Dedicated Infrastructure.
P: O TCPS é ativado por padrão nos sistemas Exadata Database Service on Cloud@Customer?
R: Não, o TCPS não é ativado por padrão nos sistemas Exadata Database Service on Cloud@Customer. Para ativar o TCPS, atualize o arquivo sqlnet.ora do banco de dados específico e reinicie o banco de dados.
P: Qual é a consequência de ativar o TCPS nos sistemas Exadata Cloud@Customer?
R: A ativação do TCPS nos sistemas Exadata Cloud@Customer fará com que as conexões do Zero Data Loss Recovery Appliance (ZDLRA) falhem. Você só pode ativar a configuração ZDLRA ou TCPS, mas não ambos simultaneamente.
P: O que a opção --pkcs12WalletFilePath especifica?
A: A opção --pkcs12WalletFilePath especifica o caminho absoluto para o arquivo de certificado no formato da wallet PKCS12, que é usado para configuração do TCPS.
P: Para que é usada a opção --caCertChain?
A: A opção --caCertChain especifica uma lista concatenada de certificados contendo certificados de CA intermediários e o certificado de CA raiz.
P: O que a opção --precheckOnly faz?
A: A opção --precheckOnly especifica se apenas as pré-verificações devem ser executadas para a operação de configuração do TCPS. Os valores aceitos são yes ou no.
P: O que a opção --serverCert especifica?
A: A opção --serverCert especifica o caminho para o certificado PEM que será usado ou girado para a configuração TCPS.
P: Como especificar a chave privada para a configuração do TCPS?
A: Use a opção --privateKey para especificar o caminho para o arquivo de chave privada associado ao certificado do servidor.
P: Quais são os valores aceitos para a opção --certType?
A: Os valores aceitos para a opção --certType são:
SELF_SIGNED_CERT
CA_SIGNED_CERT
PKCS12_CERT
O valor padrão é SELF_SIGNED_CERT.
P: A senha da chave privada é protegida por padrão?
R: Sim, a opção --privateKeyPasswordProtected é definida como true por padrão, indicando que a chave privada é protegida por senha. Você poderá defini-la como false se a chave privada não for protegida por senha.
P: Posso executar uma pré-verificação antes de configurar o TCPS?
R: Sim, você pode executar somente as pré-verificações da operação definindo a opção --precheckOnly como sim. Isso ajuda a validar o ambiente antes de fazer alterações.
P: O que acontece se eu fornecer um caminho incorreto para o arquivo da wallet PKCS12?
R: Se --pkcs12WalletFilePath contiver um caminho incorreto, o comando falhará e a configuração do TCPS não prosseguirá.
P: O que devo fazer se a chave privada estiver protegida por senha?
R: Se a chave privada for protegida por senha, certifique-se de que a opção --privateKeyPasswordProtected esteja definida como true (que é o padrão).
P: Posso especificar meu próprio certificado assinado pela CA para a configuração do TCPS?
R: Sim, você pode especificar seu próprio certificado assinado pela CA usando as opções --serverCert e --privateKey e definindo --certType como CA_SIGNED_CERT.
P: O que é um exemplo de comando para configurar o TCPS usando um certificado autoassinado?
A: Aqui está um exemplo:
dbaascli grid configureTCPS --serverCert /path/to/self_signed_cert.pem --privateKey /path/to/private_key.pem --certType SELF_SIGNED_CERT
P: Posso usar um certificado PKCS12 para configuração do TCPS?
R: Sim, você pode usar um certificado PKCS12 especificando a opção --pkcs12WalletFilePath e definindo --certType como PKCS12_CERT.
P: O que devo verificar antes de executar o comando dbaascli grid configureTCPS?
R: Verifique se você tem os arquivos de certificado corretos, arquivos de chave privada e se você está conectado como usuário raiz. Além disso, certifique-se de entender as implicações se estiver usando o ZDLRA, pois ele não pode ser executado simultaneamente com o TCPS.
Exemplo 6-27 dbaascli grid configureTCPS
dbaascli grid configureTCPSdbaascli 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 falseTópico principal: Referência de Comando do dbaascli
patch de grade dbaascli
Para aplicar patch no Oracle Grid Infrastructure para a versão secundária especificada, use o comando dbaascli grid patch.
Pré-requisitos
Execute o comando como usuário root.
Sintaxe
dbaascli grid patch
{
--targetVersion <value>
| --targetHome <value>
}
[--executePrereqs] [--nodeList <value>] [--continueWithDbDowntime] [--drainTimeoutInSeconds <value>] [--containerURL <value>] [--imageFile <value>] [--patchInParallel]
{
[--resume [--sessionID <value>]]
| [--rollback [--sessionID <value>]]
}
[--waitForCompletion <value>]
Em que:
--targetVersionespecifica a versão de destino do Oracle Home indicada como cinco segmentos numéricos separados por pontos (por exemplo, 19.12.0.0.0)--targetHomeespecifica o caminho totalmente qualificado do diretório home do Grid Infrastructure de destino para aplicação de patches out-of-place--containerURLespecifica o URL personalizado para extrair a imagem do Grid Infrastructure- Opção
--executePrereqspara executar pré-requisitos --nodeListespecifica 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--patchInParallelespecifica para executar patches de nós remotos em paralelo--rollbackespecifica para fazer rollback do Oracle home com patch--resumeretoma a execução anterior--sessionIDespecifica para retomar um ID de sessão específico
--continueWithDbDowntimecontinua 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.--drainTimeoutInSecondsespecifica o tempo (em segundos) para concluir a descarga de recursos enquanto o banco de dados é interrompido--createImagecria uma imagem com base em uma cópia do home do Grid ativo, com patch para a versão de destino especificada--createImageDirespecifica o caminho totalmente qualificado do diretório no qual a imagem será criada
--imageFileespecifica o caminho totalmente qualificado da imagem a ser usada--patchInParallelexecuta a aplicação de patch dos nós remotos em paralelo--waitForCompletionespecificafalsepara executar a operação em segundo plano. Valores válidos:true|false
Perguntas Frequentes
P: O que o comando dbaascli grid patch faz?
A: O comando dbaascli grid patch é usado para aplicar patch ao Oracle Grid Infrastructure para uma versão secundária especificada.
P: Preciso de permissões especiais para executar o comando dbaascli grid patch?
R: Sim, você precisa executar o comando dbaascli grid patch como o usuário root.
P: Posso especificar uma versão de destino ao aplicar patch ao Oracle Grid Infrastructure?
R: Sim, você pode especificar a versão de destino usando a opção --targetVersion.
P: Como especifico a versão de destino do patch?
R: Use a opção --targetVersion seguida do número da versão no formato 19.12.0.0.0.
P: O que a opção --containerURL faz no comando dbaascli grid patch?
A: A opção --containerURL permite especificar um URL personalizado para extrair a imagem do Grid Infrastructure.
P: Qual é a finalidade da opção --executePrereqs?
A: A opção --executePrereqs é usada para executar verificações de pré-requisitos antes de aplicar o patch.
P: Como posso aplicar patch a um subconjunto de nós usando o comando dbaascli grid patch?
A: Use a opção --nodeList seguida de uma lista delimitada por vírgulas de nomes de nós para aplicar patch apenas a um subconjunto de nós.
P: O que acontece se eu usar a opção --rollback?
A: A opção --rollback fará rollback do Oracle home com patch para seu estado anterior.
P: Posso retomar uma sessão de aplicação de patch anterior?
R: Sim, você pode usar a opção --resume para retomar a última sessão de aplicação de patch. Se você tiver um ID de sessão específico, poderá especificá-lo com a opção --sessionID.
P: Para que é usada a opção --continueWithDbDowntime?
A: A opção --continueWithDbDowntime permite que você continue aplicando patches mesmo que haja tempo de inatividade do banco de dados, geralmente usado em ambientes em que há apenas uma instância ativa.
P: Como faço para criar uma imagem de um Grid home com patch?
A: Use a opção --createImage para criar uma imagem. Você pode especificar o diretório em que a imagem deve ser criada usando a opção --createImageDir.
P: Qual é a finalidade da opção --imageFile?
A: A opção --imageFile permite especificar o caminho totalmente qualificado do arquivo de imagem a ser usado para aplicação de patches.
P: Como posso executar o comando dbaascli grid patch em segundo plano?
R: Você pode usar a opção --waitForCompletion definida como false para executar a operação em segundo plano.
P: Posso usar um URL personalizado para extrair a imagem do patch?
R: Sim, você pode usar a opção --containerURL para especificar um URL personalizado para extrair a imagem do Grid Infrastructure.
P: Como especifico quais nós aplicar patch se não quiser aplicar patch a todos eles?
R: Você pode especificar os nós que deseja aplicar patch usando a opção --nodeList com uma lista de nomes de nós separados por vírgulas.
P: O que devo fazer se precisar fazer rollback de um patch?
A: Use a opção --rollback no comando dbaascli grid patch para fazer rollback do patch.
P: Como lidar com uma operação de aplicação de patch se meu ambiente tiver apenas uma instância ativa e precisar continuar com o tempo de inatividade?
A: Use a opção --continueWithDbDowntime para continuar a aplicação de patch mesmo com o tempo de inatividade do banco de dados.
P: Posso criar uma imagem do Grid home corrigido?
R: Sim, você pode usar a opção --createImage para criar uma imagem do Grid home com patch. Se necessário, especifique o diretório em que a imagem deve ser salva usando --createImageDir.
P: O que devo fazer se quiser retomar uma sessão de aplicação de patches após uma interrupção?
A: Use a opção --resume para retomar a sessão de aplicação de patch. Se você souber o ID da sessão, poderá especificá-lo com --sessionID.
P: E se o processo de aplicação de patch falhar no meio do caminho?
R: Se o processo de aplicação de patch falhar, você poderá usar a opção --resume para reiniciar o processo. Você também pode usar a opção --rollback para reverter para o estado anterior.
P: Como posso garantir que todos os pré-requisitos sejam atendidos antes da aplicação de patch?
R: Use a opção --executePrereqs para executar todas as verificações de pré-requisitos antes de aplicar o patch.
Q: Posso executar a correção em segundo plano para evitar segurar o terminal?
R: Sim, você pode usar a opção --waitForCompletion false para executar o processo de aplicação de patch em segundo plano.
P: Como posso criar uma imagem do Grid home após a aplicação de patch?
A: Use a opção --createImage para criar uma nova imagem do Grid home com patch. Especifique o diretório usando --createImageDir, se necessário.
P: Como eu uso um arquivo de imagem existente para aplicação de patches?
R: Você pode usar a opção --imageFile para especificar o caminho totalmente qualificado para o arquivo de imagem que deseja usar para aplicação de patch.
P: O que devo fazer se quiser evitar o tempo de inatividade do banco de dados durante a aplicação de patches?
R: Certifique-se de que seu ambiente tenha mais de uma instância ativa em execução. Você pode evitar o uso da opção --continueWithDbDowntime, que se destina a ambientes com apenas uma instância ativa.
P: Como eu sei o progresso de um patch em execução em segundo plano?
R: Se você executar o patch com --waitForCompletion false, poderá verificar o status do job em segundo plano usando comandos do sistema operacional como ps ou verificar os logs localizados no Grid home.
P: É possível aplicar patch a uma versão principal superior usando o patch de grade dbaascli?
R: Não, dbaascli grid patch só permite aplicação de patch a uma versão secundária da versão principal atual. Para atualizações importantes, você precisará seguir um processo de atualização diferente.
P: Posso ignorar verificações de pré-requisitos específicas durante a aplicação de patch?
R: Não, quando você usar --executePrereqs, todas as verificações de pré-requisitos serão executadas. No entanto, você pode revisar os resultados das verificações de pré-requisitos e tratar manualmente quaisquer problemas antes de continuar.
P: O que devo fazer se o processo de correção estiver preso ou pendurado?
R: Se o processo de aplicação de patch não responder, você poderá interrompê-lo usando comandos do sistema operacional e retomá-lo usando a opção --resume. Se isso não funcionar, tente usar a opção --rollback para reverter o patch.
P: Posso automatizar o processo de aplicação de patches em vários clusters?
R: Sim, usando scripts que incluem o comando dbaascli grid patch com opções apropriadas, você pode automatizar a aplicação de patches em diferentes clusters.
P: Onde posso encontrar logs para o processo de aplicação de patch?
R: Em geral, os logs estão localizados no diretório de logs do Oracle Grid home ou no local padrão especificado durante a configuração. Você pode monitorar esses logs para obter detalhes sobre o processo de aplicação de patch.
P: É possível criar um processo de patch silencioso sem interação do usuário?
R: Sim, especificando todas as opções necessárias no comando e executando-o em segundo plano (--waitForCompletion false), você pode criar um processo de aplicação de patch não interativo.
P: Posso verificar se há atualizações de patch disponíveis antes de aplicar um patch?
R: O próprio comando dbaascli grid patch não tem uma opção para listar patches disponíveis. No entanto, você pode usar os métodos padrão da Oracle, como o Suporte Técnico da Oracle, para identificar os patches mais recentes.
P: Posso usar dbaascli para aplicar patch a vários Oracle Homes?
R: Não, o comando dbaascli grid patch foi projetado para aplicar patch a um home específico do Oracle Grid Infrastructure de cada vez. Você precisaria executar o comando separadamente para cada home.
P: Existe uma maneira de evitar completamente o tempo de inatividade ao aplicar patch ao Grid Infrastructure?
R: Para minimizar o tempo de inatividade, certifique-se de que seu ambiente tenha várias instâncias de banco de dados ativas (configuração RAC) para que a aplicação de patches possa ser feita nó por nó. A opção --continueWithDbDowntime não deve ser usada neste caso.
P: Como lidar com a aplicação de patches para ambientes RAC One Node?
R: Em ambientes RAC One Node, você precisa ser cauteloso com a opção --continueWithDbDowntime, pois pode haver apenas uma instância ativa. Revise a documentação da Oracle para obter diretrizes de aplicação de patches específicas para o RAC One Node.
P: Posso exibir o histórico de sessões de patches anteriores?
R: O utilitário dbaascli não fornece uma maneira direta de exibir o histórico da sessão. No entanto, os logs de sessões de aplicação de patch anteriores podem ser encontrados no diretório de logs do Grid home.
Exemplo de Casos de Uso
Exemplo 1: Aplicação Básica de Patches de Grade
dbaascli grid patch --targetVersion 19.12.0.0.0
Corrige o Oracle Grid Infrastructure para a versão 19.12.0.0.0.
Exemplo 2: Aplicação de Patch com um URL de Contêiner Personalizado
dbaascli grid patch --targetVersion 19.12.0.0.0 --containerURL https://example.com/custom/url
Corrige o Grid Infrastructure para a versão 19.12.0.0.0, usando um URL de contêiner personalizado para extrair a imagem do Grid Infrastructure.
Exemplo 3: Aplicação de Patch com Verificações de Pré-requisitos
dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs
Corrige o Grid Infrastructure para a versão 19.12.0.0.0 após executar as verificações de pré-requisitos.
Exemplo 4: Aplicação de Patch em um Subconjunto de Nós
dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2,node3
Corrige o Grid Infrastructure para a versão 19.12.0.0.0 nos nós especificados (node1, node2 e node3).
Exemplo 5: Fazendo Rollback do Patch
dbaascli grid patch --rollback
Faz rollback do último patch aplicado no Oracle Grid Infrastructure.
Exemplo 6: Retomando uma Operação de Patch Anterior
dbaascli grid patch --resume
Retoma a operação de aplicação de patch anterior de onde ela foi interrompida.
Exemplo 7: Retomando uma Operação de Patch com um ID de Sessão Específico
dbaascli grid patch --resume --sessionID 12345
Retoma a operação de aplicação de patch usando o ID de sessão 12345.
Exemplo 8: Patch com Tempo de Inatividade do Banco de Dados Permitido
dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime
Corrige o Grid Infrastructure para a versão 19.12.0.0.0, permitindo o tempo de inatividade do banco de dados, se necessário.
Exemplo 9: Criando uma Imagem com Patch
dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir
Cria uma imagem do Grid home com patch (versão 19.12.0.0.0) e a armazena no diretório especificado.
Exemplo 10: Usando um Arquivo de Imagem Existente
dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /path/to/image/file.zip
Corrige o Grid Infrastructure para a versão 19.12.0.0.0 usando um arquivo de imagem existente localizado em /path/to/image/file.zip.
Exemplo 11: Executando a Operação de Aplicação de Patch em Segundo Plano
dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false
Corrige o Grid Infrastructure para a versão 19.12.0.0.0 e executa a operação em segundo plano.
Exemplo 12: Combinação de Pré-requisitos, URL Personalizado e Subconjunto de Nós
dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --containerURL https://example.com/custom/url --nodeList node1,node2
Aplica o Grid Infrastructure à versão 19.12.0.0.0, executa verificações de pré-requisitos, usa um URL personalizado para a imagem e aplica o patch apenas em node1 e node2.
Exemplo 13: Criando uma Imagem com Patch com um Arquivo de Imagem Existente
dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir --imageFile /path/to/existing/image.zip
Cria uma imagem corrigida e a armazena no diretório especificado ao usar um arquivo de imagem existente para o patch.
Exemplo 14: Verificando Pré-requisitos sem Aplicação de Patch
dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs
Verifica se todos os pré-requisitos foram atendidos para aplicação de patch na versão 19.12.0.0.0 sem realmente aplicar o patch.
Exemplo 15: Executando Patch e Ignorando Falhas de Pré-requisito
dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime --executePrereqs
Executa o patch mesmo que algumas verificações de pré-requisitos falhem. Isso é útil em cenários em que o tempo de inatividade é permitido e determinados pré-requisitos podem ser ignorados.
Exemplo 16: Verificando Problemas nos Logs de Patch
tail -f /u01/app/grid/logs/grid_patch.log
Monitora o log de patch em tempo real para diagnosticar quaisquer problemas durante o processo de aplicação de patch.
Exemplo 17: Aplicando o Patch em um Ambiente Paralelo
dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2 --waitForCompletion false
Corrige o Grid Infrastructure em um subconjunto de nós (node1 e node2) e executa o processo em segundo plano.
Exemplo 18: Usando um Arquivo de Imagem Específico de uma Origem Externa
dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /mnt/images/grid_patch_19.12.zip
Corrige o Grid Infrastructure usando um arquivo de imagem pré-download localizado em um dispositivo de armazenamento externo.
Exemplo 19: Executando Patch com um ID de Sessão Personalizado
dbaascli grid patch --targetVersion 19.12.0.0.0 --resume --sessionID 67890
Retoma uma operação de aplicação de patch que foi interrompida, usando o ID de sessão 67890.
Exemplo 20: Programando a Aplicação de Patches para Execução Posterior
echo "dbaascli grid patch --targetVersion 19.12.0.0.0" | at 02:00
Programa o comando de aplicação de patch para ser executado às 2:00 AM usando o comando at no Linux.
Exemplo 21: Especificando o Tempo Limite para Conclusão
dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion true --continueWithDbDowntime --timeout 7200
Corrige o Grid Infrastructure enquanto permite tempo de inatividade, mas aguarda até 7200 segundos (2 horas) para conclusão antes do timeout.
Exemplo 22: Criando uma Imagem Personalizada para Outro Ambiente
dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /backups/images/grid_patch
Cria uma imagem personalizada do Grid Infrastructure com patch para armazenar no diretório /backups/images/grid_patch para uso em outros ambientes.
Exemplo 23: Recuperação de Patch Após a Interrupção
dbaascli grid patch --resume --continueWithDbDowntime
Recupera e retoma o processo de aplicação de patches se ele tiver sido interrompido, com tempo de inatividade do banco de dados permitido.
Exemplo 24: Combinando a Verificação de Pré-requisitos com a Execução em Segundo Plano
dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --waitForCompletion false
Verifica pré-requisitos e executa o patch em segundo plano.
Exemplo 25: Ignorando a Criação de Imagem para Aplicação de Patch Mais Rápida
dbaascli grid patch --targetVersion 19.12.0.0.0 --patchInParallel --continueWithDbDowntime --waitForCompletion false
Corrige o Grid Infrastructure para a versão 19.12.0.0.0 em paralelo entre nós, com tempo de inatividade do banco de dados permitido e sem criar uma imagem para acelerar o processo.
Exemplo 26: Monitorando o Andamento do Patch por meio de Logs
tail -f /u01/app/grid/logs/grid_patch_progress.log
Monitora o arquivo de log para o progresso da aplicação de patches em tempo real, fornecendo insights sobre cada etapa do processo de aplicação de patches.
Exemplo 27: Aplicação de Patches com Timeout de Drenagem Personalizado
dbaascli grid patch --targetVersion 19.12.0.0.0 --drainTimeoutInSeconds 3600 --continueWithDbDowntime
Corrige o Grid Infrastructure e define um timeout personalizado de 1 hora (3600 segundos) para permitir a drenagem normal de recursos durante o tempo de inatividade do banco de dados.
Exemplo 28: Aplicando um Patch a Nós Específicos com Verificações de Pré-requisito
dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node4 --executePrereqs
Corrige apenas os nós node1 e node4 para a versão 19.12.0.0.0 e executa as verificações de pré-requisitos antecipadamente.
Exemplo 29: Aplicação de Patch sem Aguardar Conclusão
dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false
Começa a aplicar patch no Grid Infrastructure para a versão 19.12.0.0.0 em segundo plano, permitindo que outras tarefas sejam executadas sem aguardar a conclusão do processo.
Exemplo 30: Reaplicando um Patch com Falha Após um Problema de Timeout de Drenagem
dbaascli grid patch --resume --drainTimeoutInSeconds 7200
Retoma a sessão de aplicação de patch anterior e estende o timeout de drenagem do recurso para 2 horas (7200 segundos), caso ele falhe devido ao tempo insuficiente na tentativa anterior.
Exemplo 31: Exibindo Logs de Patch em Tempo Real com ID de Sessão Específico
tail -f /u01/app/grid/logs/grid_patch_12345.log
Monitora o arquivo de log da sessão de aplicação de patch com o ID de sessão 12345 em tempo real.
Exemplo 32: Aplicação de Patch em um Novo Home de Destino
dbaascli grid patch --targetHome /u01/app/grid_home_19c --executePrereqs
Executa um patch fora do local para um novo home do Oracle Grid localizado em /u01/app/grid_home_19c, com verificações de pré-requisitos.
Exemplo 33: Interrompendo um Job de Patch em Segundo Plano
ps -ef | grep dbaascli | grep patch | awk '{print $2}' | xargs kill -9
Interrompe um job de patch em segundo plano localizando e eliminando o ID do processo associado (PID).
Exemplo 34: Verificando a Conclusão de Patches sem Logs
dbaascli grid status --targetVersion 19.12.0.0.0
Verifica se o patch para a versão 19.12.0.0.0 foi aplicado com sucesso verificando o status da versão atual do Grid Infrastructure.
Tópico principal: Referência de Comando do dbaascli
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]
--subjectespecifica o assunto do certificado- Flag
--userCertpara indicar o certificado do usuário - Flag
--trustedCertpara indicar um certificado confiável - flag
--requestedCertpara indicar um certificado solicitado --serialNumberespecifica o número de série do certificado--executePrereqsexecuta as verificações de pré-requisito e reporta os resultados--resumeretoma a execução anterior--sessionIDespecifica para retomar um ID de sessão específico
- Flag
--bounceListenerspara devolver o listener do Grid Infrastructure e verificar o listener
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli grid removeTCPSCert?
R: O comando dbaascli grid removeTCPSCert é usado para remover certificados TCPS existentes da wallet do Grid Infrastructure em um ambiente Oracle Exadata.
P: Qual é o pré-requisito para executar o comando dbaascli grid removeTCPSCert?
A: O comando deve ser executado como o usuário root.
P: O que a opção --subject especifica no comando dbaascli grid removeTCPSCert?
A: A opção --subject especifica o assunto do certificado a ser removido da wallet do Grid Infrastructure.
P: Qual é a finalidade do flag --userCert?
R: O flag --userCert indica que o certificado a ser removido é um certificado do usuário.
P: Quando devo usar o flag --trustedCert?
A: Use o flag --trustedCert ao remover um certificado confiável da wallet do Grid Infrastructure.
P: O que o flag --requestedCert faz?
A: O flag --requestedCert indica que o certificado que está sendo removido é um certificado solicitado.
P: O que a opção --serialNumber especifica?
A: A opção --serialNumber especifica o número de série do certificado a ser removido. É útil para identificar exclusivamente um certificado quando há vários certificados com o mesmo assunto.
P: Qual é a finalidade da opção --executePrereqs?
A: A opção --executePrereqs executa verificações de pré-requisitos antes de remover o certificado e reporta os resultados, garantindo que o ambiente esteja devidamente preparado para a operação.
P: O que a opção --resume faz?
A: A opção --resume retoma a operação de remoção se ela tiver sido interrompida anteriormente.
P: Como especificar um ID de sessão ao retomar uma operação interrompida?
R: Use a opção --sessionID para especificar o ID da sessão da operação interrompida que você deseja retomar.
P: O que o flag --bounceListeners faz?
R: O flag --bounceListeners é usado para reiniciar o listener do Grid Infrastructure e verificar o listener após a remoção do certificado TCPS.
P: Posso remover um certificado TCPS sem devolver os listeners?
R: Sim, o flag --bounceListeners é opcional. Se você não especificá-lo, os listeners não serão devolvidos automaticamente.
Q: Como posso garantir que a operação será executada com segurança?
R: Você pode usar a opção --executePrereqs para executar verificações de pré-requisitos antes de executar o comando, garantindo que tudo esteja em ordem antes do processo de remoção.
P: O que devo fazer se precisar remover um certificado de usuário específico por número de série?
A: Use a opção --subject para especificar o assunto do certificado, o flag --userCert para indicar que ele é um certificado do usuário e a opção --serialNumber para especificar o número de série do certificado.
P: Posso remover vários certificados de uma só vez?
R: Não, o comando é projetado para remover um único certificado de cada vez com base no assunto fornecido e em outros parâmetros.
P: O que acontece se o processo de remoção do certificado for interrompido?
R: Você pode retomar a operação usando a opção --resume junto com o --sessionID do processo interrompido.
P: Preciso executar o comando como usuário raiz?
R: Sim, o comando dbaascli grid removeTCPSCert deve ser executado como o usuário root para ter os privilégios necessários para remover certificados TCPS.
P: Como posso identificar o certificado que quero remover?
R: Você pode identificar o certificado pelo seu assunto e, opcionalmente, pelo seu número de série para garantir que você está direcionando o certificado correto para remoção.
P: O que é um exemplo de comando para remover um certificado confiável?
A: Este é um exemplo:
dbaascli grid removeTCPSCert --subject "CN=example_cert" --trustedCert
Tópico principal: Referência de Comando do dbaascli
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]
--pkcs12WalletFilePathespecifica o caminho absoluto do arquivo de certificado, que está no formato de walletpkcs12--caCertChainlista concatenada de certificados, contendo certificados da CA intermediárias e da CA raiz--precheckOnlyespecificayespara só executar as pré-verificações desta operação. Valores válidos:yesouno.--serverCertespecifica o caminho do certificado PEM a ser usado ou alternado para a configuração TCPS.--privateKeyespecifica o caminho do arquivo de chave privada do certificado.--certTypetipo do certificado a ser adicionado à wallet do Grid Infrastructure. Os valores aceitos são:SELF_SIGNED_CERT,CA_SIGNED_CERTouPKCS12_CERT. Padrão:SELF_SIGNED_CERT--privateKeyPasswordProtectedespecifica se a chave privada é protegida por senha ou não. Valores válidos:trueoufalse. Padrão:true.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli grid rotateTCPSCert?
R: O comando dbaascli grid rotateTCPSCert é usado para rotacionar certificados TCPS (Transport Layer Security Protocol) na wallet do Grid Infrastructure em ambientes Oracle Exadata.
P: Qual é o pré-requisito para executar o comando dbaascli grid rotateTCPSCert?
A: O comando deve ser executado como o usuário root.
P: O que a opção --pkcs12WalletFilePath especifica?
A: A opção --pkcs12WalletFilePath especifica o caminho absoluto para o arquivo de certificado no formato da wallet PKCS12 para a configuração do TCPS.
P: Qual é a finalidade da opção --caCertChain?
A: A opção --caCertChain especifica uma lista concatenada de certificados, incluindo CA intermediária e certificados de CA raiz, para a configuração TCPS.
P: O que a opção --precheckOnly faz?
R: A opção --precheckOnly permite executar pré-verificações sem fazer alterações reais. Os valores válidos são "yes" para executar somente as pré-verificações e "no" para prosseguir com a rotação.
P: Como a opção --serverCert é usada?
A: A opção --serverCert especifica o caminho para o certificado do servidor PEM (Privacy Enhanced Mail) que é usado ou rotacionado para a configuração do TCPS.
P: O que a opção --privateKey especifica?
A: A opção --privateKey especifica o caminho para o arquivo de chave privada correspondente ao certificado do servidor usado para rotação TCPS.
P: Quais são os valores válidos para a opção --certType?
A: A opção --certType aceita os seguintes valores para especificar o tipo de certificado a ser adicionado à wallet do Grid Infrastructure:
SELF_SIGNED_CERT (padrão)
CA_SIGNED_CERT
PKCS12_CERT
P: O que a opção --privateKeyPasswordProtected faz?
A: A opção --privateKeyPasswordProtected indica se a chave privada é protegida por senha. Os valores válidos são true (padrão) e false
P: Posso executar o comando dbaascli grid rotateTCPSCert sem girar os certificados?
R: Sim, usando a opção sim --precheckOnly, você só pode executar as pré-verificações sem girar os certificados.
P: Qual é um exemplo de comando para rotacionar um certificado usando uma wallet PKCS12?
A: Aqui está um exemplo de comando:
dbaascli grid rotateTCPSCert --pkcs12WalletFilePath /path/to/wallet.p12 --certType PKCS12_CERT
P: Como rotaciono um certificado de servidor com uma cadeia de certificados assinada pela CA?
A: Use as opções --serverCert e --caCertChain, conforme mostrado abaixo:
dbaascli grid rotateTCPSCert --serverCert /path/to/serverCert.pem --caCertChain /path/to/caChain.pem
P: O que acontece se eu não especificar --privateKeyPasswordProtected?
A: Se você não especificar a opção --privateKeyPasswordProtected, o comando assumirá que a chave privada é protegida por senha (padrão: true).
Q: Posso girar um certificado autoassinado?
R: Sim, você pode rotacionar um certificado autoassinado usando a opção --certType SELF_SIGNED_CERT padrão ou especificando-a explicitamente.
P: Como posso rotacionar um certificado sem fornecer uma chave privada?
R: Para determinados tipos de certificado, como PKCS12, talvez você não precise fornecer um arquivo de chave privada separado, pois ele está incluído na wallet. No entanto, se uma chave privada for necessária, ela deverá ser fornecida usando a opção --privateKey.
P: E se eu quiser girar um certificado em segundo plano?
R: O comando dbaascli grid rotateTCPSCert não fornece uma opção explícita para execução em segundo plano. Você pode executar o comando diretamente em uma sessão em segundo plano (por exemplo, usando nohup ou ferramentas semelhantes).
P: Qual será o tipo de certificado padrão se não for especificado?
A: O tipo de certificado padrão é SELF_SIGNED_CERT.
Exemplo 6-28 dbaascli grid rotateTCPSCert
dbaascli grid rotateTCPSCertdbaascli 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 trueTópico principal: Referência de Comando do dbaascli
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]
--versionespecifica a versão de destino--resumeretoma a execução anterior--executePrereqsexecuta pré-requisitos para upgrade do Grid Infrastrucure--containerUrlespecifica o URL personalizado para extrair a imagem do Grid Infrastrucure--softwareOnlysó instala o software do Grid Infrastructure--targetHomeespecifica o caminho do home da Grade de destino existente--revertreverte a execução com falha
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli grid upgrade?
R: O comando dbaascli grid upgrade é usado para fazer upgrade do Oracle Grid Infrastructure de uma versão principal para outra em uma máquina virtual do Exadata Cloud@Customer.
P: Qual é o pré-requisito para executar o comando dbaascli grid upgrade?
R: O comando deve ser executado como o usuário root e você precisa estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: O que a opção --version especifica?
A: A opção --version especifica a versão de destino do Oracle Grid Infrastructure para a qual você deseja fazer upgrade.
P: O que a opção --resume faz?
A: A opção --resume retoma um processo de upgrade do Grid Infrastructure interrompido ou com falha anteriormente.
P: Como a opção --executePrereqs é usada?
A: A opção --executePrereqs executa apenas as verificações de pré-requisitos para o upgrade do Grid Infrastructure sem executar o upgrade real.
P: Qual é a finalidade da opção --containerURL?
A: A opção --containerURL especifica um URL personalizado para extrair a imagem de software do Grid Infrastructure para o upgrade.
P: O que a opção --softwareOnly faz?
A: A opção --softwareOnly instala somente o software Grid Infrastructure sem configurar ou fazer upgrade do ambiente Grid.
P: Quando você usaria a opção --targetHome?
A: A opção --targetHome especifica o caminho para o Grid home de destino existente no qual o upgrade será executado.
P: O que acontece se o upgrade falhar?
R: Se o upgrade falhar, você poderá usar a opção --revert para fazer rollback do upgrade para seu estado anterior.
P: Posso executar um upgrade do Grid Infrastructure em estágios?
R: Sim, usando a opção --softwareOnly, você pode primeiro instalar o software e depois concluir o upgrade completo, permitindo upgrades preparados.
P: Como eu uso o comando dbaascli grid upgrade para fazer upgrade somente do software?
A: Use a seguinte sintaxe para fazer upgrade somente do software:
dbaascli grid upgrade --version <target_version> --softwareOnly
P: Posso verificar se há pré-requisitos de upgrade sem executar o upgrade?
R: Sim, você só pode executar as verificações de pré-requisitos usando:
dbaascli grid upgrade --version <target_version> --executePrereqs
P: Como posso fazer upgrade do Grid Infrastructure usando um URL de contêiner personalizado?
A: Você pode especificar o URL para extrair a imagem do Grid Infrastructure da seguinte forma:
dbaascli grid upgrade --version <target_version> --containerURL <custom_url>
P: Como posso retomar um processo de upgrade interrompido anteriormente?
A: Para retomar um upgrade interrompido ou com falha anteriormente, use:
dbaascli grid upgrade --version <target_version> --resume
P: O que a opção --revert faz no comando dbaascli grid upgrade?
A: A opção --revert faz rollback de um upgrade do Grid Infrastructure com falha ou interrompido para seu estado original.
P: Posso executar um upgrade completo sem configurar o Grid Infrastructure imediatamente?
R: Sim, você pode primeiro instalar apenas o software usando a opção --softwareOnly e depois configurá-lo posteriormente.
P: O que devo fazer se um upgrade falhar e eu quiser desfazer as alterações?
A: Use a opção --revert para fazer rollback do upgrade com falha:
dbaascli grid upgrade --version <target_version> --revert
Exemplo 6-29 dbaascli grid upgrade
daascli grid upgrade --version 19.11.0.0.0 --executePrereqs
DBAAS CLI version MAIN
Executing command grid upgrade --version 19.11.0.0.0 --executePrereqs
Tópico principal: Referência de Comando do dbaascli
dbaascli job getStatus
Para exibir o status de um job especificado, use o comando dbaascli job getStatus.
Pré-requisito
Execute o comando como usuário root.
Sintaxe
dbaascli job getStatus --jobID
--jodIDespecifica o ID do job
Exemplo 6-30 dbaascli job getStatus
dbaascli job getStatus --jobID 13c82031-f202-41b7-9aef-f4a71df0f551
DBAAS CLI version MAIN
Executing command job getStatus --jobID 13c82031-f202-41b7-9aef-f4a71df0f551
{
"jobId" : "13c82031-f202-41b7-9aef-f4a71df0f551",
"status" : "Success",
"message" : "database create job: Success",
"createTimestamp" : 1628095442431,
"updatedTime" : 1628095633660,
"description" : "Service job report for operation database create",
"appMessages" : {
"schema" : [ ],
"errorAction" : "SUCCEED_AND_SHOW"
},
"resourceList" : [ ],
"pct_complete" : "100"
}
Tópico principal: Referência de Comando do dbaascli
dba0cli patch db prereq
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 grid patchdbaascli dbhome patchdbaascli database move- Aplicando Patch no Oracle Grid Infrastructure e em Bancos de Dados Oracle com o Utilitário dbaascli
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb backup
Para fazer backup de um banco de dados plugável (PDB), consultar backups de PDB e excluir um backup de PDB, use o comando dbaascli pdb backup.
Pré-requisito
- Execute o comando como usuário
root.
Sintaxe
dbaascli pdb backup --pdbName <value> --dbname <value>
{
--start
{
[--level1]
| [--archival --tag <value>]
}
| --delete --backupTag <value>
| --status --uuid <value>
| --getBackupReport --json <value> --tag <value>
| --list [--json <value>]
}
--pdbName: PDB name.--dbname: Oracle Database name.--start|--delete|--status|--getBackupReport|--list--start: Begins PDB backup. [--level1|--archival] [--level1: Creates a Level-1 (incremental) backup.] [--archival: Creates an archival full backup.]--tag: Specify backup tag.--delete: Deletes archival backup.--backupTag: Specify backup tag to delete.--status--uuid <value>--getBackupReport: Returns backup report.--json: Specify the file name for JSON output.--tag: Specify backup tag.--list: Returns PDB backup information. [--json: Specify the file name for JSON output.]
Perguntas Frequentes
P: Qual é a finalidade do comando de backup dbaascli pdb?
R: O comando dbaascli pdb backup é usado para criar backups para um banco de dados plugável (PDB), consultar o status do backup, gerar relatórios de backup e excluir backups do PDB em um ambiente Exadata Cloud@Customer.
P: Qual é o pré-requisito para usar o comando de backup dbaascli pdb?
R: O comando deve ser executado como o usuário root e você precisa estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: Como inicio um backup do PDB usando o comando de backup dbaascli PDB?
R: Você pode iniciar um backup do PDB usando a opção --start. Por exemplo:
dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start
P: Quais opções podem ser usadas com o sinalizador --start?
A: Com o flag --start, você pode especificar:
--level1 para um backup incremental de Nível 1
--archival para um backup de arquivamento completo (que também requer um --tag para especificar a tag de backup)
P: Como crio um backup de PDB incremental de Nível 1?
A: Use o flag --level1 com a opção --start para criar um backup incremental de Nível 1:
dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --level1
P: Como crio um backup de PDB de arquivamento?
A: Use o flag --archival com a opção --start e especifique uma tag de backup usando --tag:
dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --archival --tag <backup_tag>
P: Como excluo um backup específico do PDB?
A: Para excluir um backup específico, use o flag --delete e especifique a tag de backup usando --backupTag:
dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --delete --backupTag <backup_tag>
P: Como posso verificar o status de um backup do PDB?
A: Use o flag --status junto com o backup --uuid para verificar o status de um backup específico:
dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --status --uuid <backup_uuid>
P: Como recupero um relatório de backup do PDB no formato JSON?
A: Para obter um relatório de backup no formato JSON, use a opção --getBackupReport, especifique o nome do arquivo com --json e forneça a tag de backup com --tag:
dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --getBackupReport --json <file_name> --tag <backup_tag>
P: Como posso listar todos os backups do PDB para um PDB específico?
A: Use a opção --list para obter uma lista de todos os backups de um determinado PDB:
dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list
Opcionalmente, você pode gerar a lista no formato JSON usando o flag --json:
dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list --json <file_name>
P: O que a opção --pdbName faz?
A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) para o qual você deseja fazer backup, consultar ou excluir backups.
P: Qual é a finalidade da opção --dbname?
A: A opção --dbname especifica o nome do Oracle Database ao qual o PDB pertence.
P: Como especifico uma tag de backup para um backup do PDB?
A: Você especifica uma tag de backup usando a opção --tag ao iniciar um backup de arquivamento ou ao recuperar um relatório de backup:
--tag <backup_tag>
P: Posso executar backups de PDB no modo JSON?
R: Sim, as opções de relatório de backup (--getBackupReport) e listagem de backup (--list) suportam saída no formato JSON. Você especifica um nome de arquivo JSON usando a opção --json.
Exemplo 6-31 Exemplos
- Para fazer backup level1 de um PDB pdb1 em um CDB myTestDb:
dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --start --level1 - Para consultar o status da solicitação de backup do PDB submetida com
uuideef16b26361411ecb13800163e8e4fac:dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --status --uuid eef16b26361411ecb13800163e8e4fac
Tópicos Relacionados
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb bounce
Para devolver um banco de dados plugável (PDB), use o comando dbaascli pdb bounce.
Pré-requisito
Execute o comando como usuário oracle.
Sintaxe
dbaascli pdb bounce
{
--pdbName <value>
| --pdbUID <value>
}
--dbname <value> [--openMode <value>] [--startServices <value>] [--waitForCompletion <value>]
--pdbNameespecifica o nome do PDB--pdbUIDespecifica o identificador do PDB--dbnameespecifica o nome do banco de dados contêiner que hospeda o PDB--openModeespecifica o destinoOPEN MODEdo PDB--startServicesespecifica para iniciar todos ou uma lista de todos os serviços correspondentes a um PDB. Os valores aceitos sãoallou uma lista de serviços do PDB delimitada por vírgulas.--waitForCompletionespecifica para executar a operação em primeiro plano ou em segundo plano. Valores válidos:true|false.
Exemplo 6-32 dbaascli pdb bounce
dbaascli pdb bounce --dbname cdb_name --pdbName pdb name associated with the CDB
dbaascli pdb bounce --dbname cdb_name --pdbUID con_uid of that pdb
--openMode READ_WRITE--openMode READ_ONLY
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb close
Para fechar um banco de dados plugável (PDB), use o comando dbaascli pdb close.
Pré-requisito
Execute o comando como usuário oracle.
Sintaxe
dbaascli pdb close
{
--pdbName <value>
| --pdbUID <value>
}
--dbname <value> [--waitForCompletion <value>]
--pdbnameespecifica o nome do PDB que você deseja fechar.--pdbUIDespecifica o identificador do PDB--dbnameespecifica o nome do banco de dados contêiner que hospeda o PDB.-
--waitForCompletionespecifica para executar a operação em primeiro plano ou em segundo plano. Valores válidos:true|false.
Após a conclusão bem-sucedida da execução desse comando, o PDB é fechado em todas as instâncias do banco de dados contêiner.
Exemplo 6-33 dbaascli pdb close
dbaascli pdb close --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb close --dbname cdb name --pdbUID con_uid of that pdb
Tópico principal: Referência de Comando do dbaascli
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 <value>
{
--pdbName <value>
| --pdbUID <value>
}
--dbnameespecifica o nome do banco de dados contêiner que hospeda o PDB--pdbnameespecifica o nome do PDB cujas informações da string de conexão você deseja exibir--pdbUIDespecifica o identificador do PDB
Exemplo 6-34 dbaascli pdb getConnectString
dbaascli pdb getConnectString --dbname dbname --pdbName pdbName
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb create
Para criar um novo banco de dados plugável (PDB), use o comando dbaascli pdb create.
Pré-requisito
Execute o comando como usuário oracle.
Sintaxe
dbaascli pdb create --pdbName <value> --dbName <value> [--maxCPU <value>] [--maxSize <value>] [--pdbAdminUserName <value>] [--lockPDBAdminAccount <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--waitForCompletion <value>]
{
[--blobLocation <value>]
| [--standbyBlobFromPrimary <value>]
}
[--pdbTdeKeyVersionOCID <value>]
--pdbNameespecifica o nome do novo PDB que você deseja criar--dbNameespecifica o nome do banco de dados contêiner que hospeda o novo PDB--maxCPUespecifica 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âmetroCPU_COUNTno PDB--maxSizeespecifica 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 armazenamentoMAXSIZE PDBno comando SQLCREATE PLUGGABLE DATABASE. Você pode impor um limite especificando um número inteiro seguido de uma unidade de tamanho (K,M,GouT) ou pode especificarUNLIMITEDpara não impor explicitamente qualquer limite--pdbAdminUserNameespecifica o novo nome do usuário administrador do PDB--lockPDBAdminAccountespecificatrueoufalsepara bloquear a conta de usuário administrador do PDB. O valor default éverdadeiro.--resumeretoma a execução anterior--sessionIDespecifica para retomar um ID de sessão específico
--executePrereqsespecificayespara só executar os pré-requisitos desta operação. Valores válidos:yesouno--waitForCompletionespecificafalsepara executar a operação em segundo plano. Valores válidos:trueoufalse--blobLocation- local de diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG.--standbyBlobFromPrimaryespecifica 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âmetrosblobLocationestandbyBlobFromPrimarysão mutuamente exclusivos.--pdbTdeKeyVersionOCID
Durante o processo de criação do PDB, você é solicitado a especificar a senha de administração do novo PDB.
Exemplo 6-35 dbaascli pdb create
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --maxsize 5G --maxcpu 2dbaascli pdb create --dbName db721 --pdbName new_pdb1dbaascli pdb create --dbName db721 --pdbName new_pdb1 --standbyBlobFromPrimary /tmp/send_db721.tarTópico principal: Referência de Comando do dbaascli
dbaascli pdb createSnapshot
Para criar um snapshot de um determinado banco de dados plugável (PDB), use o comando dbaascli pdb createSnapshot.
Pré-requisito
Execute o comando como usuário oracle.
Sintaxe
dbaascli pdb createSnapshot
{
--pdbName <value> | --pdbUID <value>
}
--dbName <value>
--snapshotName <value>
[--pdbAdminUserName <value>]
[--executePrereqs] [--resume [--sessionID <value>]]
[--waitForCompletion true|false]
Em que:
--pdbNameespecifica o nome do PDB pelo qual será criado o snapshot.--pdbUIDespecifica o ID do usuário (UID) do PDB do qual o snapshot será criado.--dbNameNome do Oracle Database.--snapshotNameespecifica o nome do snapshot do PDB.--pdbAdminUserNameespecifica o nome do usuário administrador do PDB.--executePrereqsexecuta as verificações de pré-requisito e reporta os resultados.--resume [--sessionID <value>]retoma a operação anterior. Ele pode usar o flag--sessionID <value>para especificar a retomada de um ID de sessão específico (<value>).--waitForCompletion true|falseespecifica se a operação deve ser executada em primeiro plano (true) ou em segundo plano (false). Valores válidos:true,false.
Exemplo 6-36 dbaascli pdb createSnapshot
No exemplo a seguir, um snapshot é criado com base no banco de dados chamado db721, no nome do PDB pdb1. O nome do snapshot fornecido é snap1.
dbaascli pdb createSnapshot --dbName db721 --pdbName pdb1 --snapshotName snap1
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb configureSnapshot
Para configurar snapshots automáticos para um determinado banco de dados plugável (PDB), use o comando dbaascli pdb configureSnapshot.
Pré-requisito
Execute o comando como usuário oracle.
Sintaxe
dbaascli pdb configureSnapshot
{
--pdbName <value> | --pdbUID <value>
}
--dbName <value>
--snapshotIntervalInMins <value>
[--executePrereqs]
[--maxPDBSnapshots <value>]
[--waitForCompletion <value>]
Em que:
--pdbName <value>especifica o nome do PDB para o qual a configuração de snapshot automático será definida.--pdbUID <value>especifica o ID do usuário (UID) do PDB para o qual a configuração de snapshot automático será definida.--dbNameNome do Oracle Database.--snapshotIntervalInMins <value>especifica o intervalo, em minutos, para quando snapshots automáticos do PDB serão tirados.--executePrereqsexecuta as verificações de pré-requisito e reporta os resultados.--maxPDBSnapshots <value>]especifica o número máximo de snapshots a serem criados para o PDB fornecido. .--waitForCompletion true|falseespecifica se a operação deve ser executada em primeiro plano (true) ou em segundo plano (false). Valores válidos:true,false.
Exemplo 6-37 dbaascli pdb configureSnapshot
No exemplo a seguir, um plano de snapshot automático é configurado no banco de dados chamado db721, no nome do PDB pdb1. O intervalo de snapshot é definido para executar a criação automática de snapshot a cada 60 minutos.
dbaascli pdb configureSnapshot --dbName db721 --pdbName pdb1 --snapshotIntervalInMins 60
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb delete
Para excluir um banco de dados plugável (PDB), execute o comando dbaascli pdb delete.
Pré-requisito
Execute o comando como usuário oracle.
Sintaxe
dbaascli pdb delete --dbName <value>
{
--pdbName <value>
| --pdbUID <value>
}
[--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]] [--allStandbyPrepared] [--cleanupRelocatedPDB]
--dbNameespecifica o nome do banco de dados contêiner que hospeda o PDB--pdbNameespecifica o nome do PDB que você deseja excluir--pdbUIDespecifica o UID do PDB que você deseja excluir--executePrereqsespecificayespara só executar os pré-requisitos desta operação. Valores válidos:yesouno--waitForCompletionespecificafalsepara executar a operação em segundo plano. Valores válidos:trueoufalse--resumeespecifica para retomar a execução anterior--sessionIDespecifica para retomar um ID de sessão específico
--allStandbyPreparedespecifica para confirmar se a operação foi executada com sucesso em todos os bancos de dados stand-by--cleanupRelocatedPDBespecifique para limpar o banco de dados de origem após um PDB ser realocado
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 pdb1Para criar o PDB do banco de dados Principal no ambiente do Data Guard:
dbaascli pdb create --dbName db721 --pdbName pdb1 --allStandbyPreparedTópico principal: Referência de Comando do dbaascli
dbaascli pdb deleteSnapshot
Para excluir um snapshot de um determinado banco de dados plugável (PDB), use o comando dbaascli pdb deleteSnapshot.
Pré-requisito
Execute o comando como usuário oracle.
Sintaxe
dbaascli pdb deleteSnapshot
{
--pdbName <value> | --pdbUID <value>
}
{
--snapshotName <value> | --snapshotUID <value>
}
--dbName <value>
[--executePrereqs]
[--waitForCompletion <value>
[--resume [--sessionID <value>]
]
]
Em que:
--pdbName <value>especifica o nome do PDB para o qual a configuração de snapshot automático será definida.--pdbUID <value>especifica o ID do usuário (UID) do PDB para o qual a configuração de snapshot automático será definida.--snapshotName <value>especifica o nome do snapshot do PDB que você deseja excluir.--snapshotUID <value>especifica o ID do usuário (UID) do snapshot do PDB que você deseja excluir.--dbNameespecifica o nome do Oracle Database.--executePrereqsexecuta as verificações de pré-requisito e reporta os resultados.--waitForCompletion true|falseespecifica se a operação deve ser executada em primeiro plano (true) ou em segundo plano (false). Valores válidos:true,false.--resume [sessionID <value>]especifica para retomar a operação anterior. Para especificar a retomada de um ID de sessão específico, adicione o flag sessionID e forneça o número do ID da sessão.
Exemplo 6-38 dbaascli pdb configureSnapshot
No exemplo a seguir, o snapshot snap1 do PDB é especificado para exclusão no PDB chamado pdb1, para o banco de dados chamado db721:
dbaascli pdb deleteSnapshot --dbName db721 --pdbName pdb1 --snapshotName snap1
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb getDetails
Para exibir detalhes de um banco de dados plugável (PDB), use o comando dbaascli pdb getDetails.
Pré-requisito
Execute o comando como usuário oracle.
Sintaxe
dbaascli pdb getDetails --dbname <value>
{
--pdbName <value>
| --pdbUID <value>
}
--dbnameespecifica o nome do banco de dados contêiner que hospeda o PDB--pdbnameespecifica o nome do PDB que você deseja excluir--pdbUIDespecifica o identificador do PDB
Exemplo 6-39 dbaascli pdb getDetails
dbaascli pdb getDetails--dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb getDetails--dbname cdb name --pdbUID con_uid of that pdb
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb getSnapshot
Para obter detalhes de um determinado snapshot de banco de dados plugável (PDB), use o comando dbaascli pdb getSnapshot.
Pré-requisito
Execute o comando como usuário oracle.
Sintaxe
dbaascli pdb getSnapshot
{
--pdbName <value>| --pdbUID <value>
}
{
--snapshotName <value> | --snapshotUID <value>
}
--dbName <value>
Em que:
--pdbName <value>especifica o nome do PDB cujos detalhes você deseja obter.--pdbUID <value>especifica o ID do usuário (UID) do PDB para o snapshot cujos detalhes você deseja obter.--snapshotName <value>especifica o nome do snapshot cujos detalhes você deseja obter--snapshotUID <value>especifica o ID do usuário (UID) do snapshot cujos detalhes você deseja obter.--dbNameespecifica o nome do Oracle Database.
Exemplo 6-40 dbaascli pdb configureSnapshot
No exemplo a seguir, os detalhes são obtidos para o snapshot chamado snap1 no banco de dados chamado db721, no nome do PDB pdb1:
dbaascli pdb getSnapshot --dbName db721 --pdbName pdb1 --snapshotName snap1
Tópico principal: Referência de Comando do dbaascli
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
--dbnameespecifica o nome do banco de dados contêiner que hospeda o PDB
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli pdb list?
R: O comando dbaascli pdb list é usado para exibir a lista de bancos de dados plugáveis (PDBs) em um banco de dados contêiner (CDB) especificado em um ambiente Exadata Cloud@Customer.
P: Quais são os pré-requisitos para executar o comando dbaascli pdb list?
R: O comando deve ser executado como o usuário oracle e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: O que a opção --dbname especifica no comando dbaascli pdb list?
A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda os bancos de dados plugáveis (PDBs) para os quais você deseja exibir a lista.
P: Posso exibir a lista de PDBs de vários bancos de dados contêineres de uma só vez?
R: Não, o comando dbaascli pdb list permite listar os PDBs de apenas um banco de dados contêiner (CDB) por vez, especificado pela opção --dbname.
P: Como listo os PDBs em um banco de dados contêiner (CDB) específico?
R: Você pode listar os PDBs em um CDB específico usando a seguinte sintaxe:
dbaascli pdb list --dbname <CDB_Name>
P: Quais informações são exibidas ao usar o comando dbaascli pdb list?
R: O comando retorna uma lista de todos os bancos de dados plugáveis (PDBs) dentro do banco de dados contêiner (CDB) especificado. A lista geralmente inclui os nomes dos PDBs e possivelmente outros detalhes, como seu status.
P: Posso filtrar a lista de PDBs usando opções adicionais?
R: Não, o comando dbaascli pdb list não suporta opções de filtragem adicionais. Ele simplesmente retorna a lista completa de PDBs no CDB especificado.
P: O que acontece se o --dbname especificado não existir ou estiver incorreto?
R: Se o --dbname especificado estiver incorreto ou não existir, o comando retornará um erro e nenhuma lista de PDB será exibida.
P: O comando dbaascli pdb list pode ser usado para qualquer ambiente de banco de dados Oracle?
R: Não, o comando dbaascli pdb list foi projetado especificamente para uso nos ambientes Exadata Cloud@Customer.
Exemplo 6-41 dbaascli pdb list
dbaascli pdb list --dbname cdb name
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb listSnapshots
Para listar os snapshots de um determinado banco de dados plugável (PDB), use o comando dbaascli pdb listSnapshots.
Pré-requisito
Execute o comando como usuário oracle.
Sintaxe
dbaascli pdb listSnapshots
{
--pdbName <value> | --pdbUID <value>
}
--dbName <value>
Em que:
--pdbNameespecifica o nome do PDB para o qual os snapshots serão listados.<value>--pdbUIDespecifica o UID do PDB para o qual os snapshots serão listados.<value>--dbNameespecifica o nome do Oracle Database.<value>
Exemplo 6-42 dbaascli pdb listSnapshots
No exemplo a seguir, o comando lista os snapshots do banco de dados db721 e o nome do pdb pdb1:
dbaascli pdb listSnapshots --dbName db721 --pdbName pdb1
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb localClone
Para criar um novo banco de dados plugável (PDB) como clone de um PDB existente, no mesmo banco de dados contêiner (CDB), use o comando dbaascli pdb localClone.
Pré-requisito
Execute o comando como usuário oracle.
Sintaxe
dbaascli pdb localClone --pdbName <value> --dbName <value> [--targetPDBName <value>] [--powerLimit <value>] [--maxCPU <value>] [--maxSize <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--waitForCompletion <value>]
{
[--blobLocation <value>]
| [--standbyBlobFromPrimary <value>]
}
[--excludeUserTablespaces <value>] [--excludePDBData <value>] [--pdbAdminUserName <value>] [--lockPDBAdminAccount <value>] [--sourcePDBServiceConvertList <value>]
{
[--createFromSnapshot
{
--snapshotName <value>
| --snapshotUID <value>
}
[--copyDataFiles]]
| [--snapshot]
}
--pdbNameespecifica o nome do novo PDB que você deseja clonar--dbNameespecifica o nome do banco de dados--targetPDBNameespecifica o nome do PDB de destino (novo PDB clonado)--powerLimitespecifica o grau de paralelismo a ser usado para a operação de clonagem. O valor válido fica entre 1 e 128--maxCPUespecifica o número máximo de CPUs a serem alocadas para o PDB--maxSizeespecifica o tamanho máximo do armazenamento em GB para o novo PDB--resumeretoma a execução anterior-
--sessionIDespecifica para retomar um ID de sessão específico
-
--executePrereqsespecificayespara só executar os pré-requisitos desta operação. Valores válidos:yesouno--waitForCompletionespecificafalsepara executar a operação em segundo plano. Valores válidos:trueoufalse--blobLocationlocal de diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG.--standbyBlobFromPrimaryespecifica 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--blobLocatione--standbyBlobFromPrimarysão mutuamente exclusivos.- Opção
--excludeUserTablespacespara ignorar tablespaces do usuário, exemplo t1,t2,t3. --excludePDBDataespecifica true/yes para ignorar dados do usuário do PDB de origem.--pdbAdminUserNameespecifica o novo nome do usuário administrador do PDB.--lockPDBAdminAccountespecifiquetrueoufalsepara bloquear a conta do usuário administrador do PDB. O valor default éverdadeiro.--sourcePDBServiceConvertListespecifica uma lista de nomes de serviço de origem para destino delimitados por vírgulas que precisam ser convertidos. A sintaxe ésource_srv1:new_srv1,source_srv2:new_srv2.--createFromSnapshot|--snapshot--createFromSnapshotespecifique para criar o PDB com base no snapshot do PDB--snapshotName|--snapshotUID--snapshotNameespecifique o nome do snapshot a ser criado com base no PDB.--snapshotUIDespecifique o UID do snapshot para criar o PDB com base no PDB.
--copyDataFilesespecifique esta opção para ignorar a cópia do snapshot.--snapshotespecifique para criar o PDB com cópia de snapshot.
O PDB recém-clonado herda senhas de administração do PDB de origem.
Exemplo 6-43 dbaascli pdb localClone
dbaascli pdb localClone --dbName db35 --pdbName PDB35 --targetPDBName local_clone1 --maxCPU 2 --maxSize 15
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb open
Para abrir um banco de dados plugável (PDB), use o comando dbaascli pdb open.
Execute o comando como usuário root ou oracle.
Sintaxe
dbaascli pdb open
{
--pdbName <value>
| --pdbUID <value>
}
--dbname <value> [--openMode <value>] [--startServices <value>] [--waitForCompletion <value>] [--setPDBRefreshModeNone [--skipPDBRefresh] [--pdbAdminUserName <value>]] [--executePrereqs] [--resume [--sessionID <value>]] [--blobLocation <value>]
--pdbNameespecifica o nome do PDB que você deseja abrir--pdbUIDespecifica o identificador do PDB--dbnameespecifica o nome do banco de dados contêiner que hospeda o PDB.--openModeespecifica 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ãoallou uma lista de serviços do PDB delimitada por vírgulas.--waitForCompletion: especificafalsepara 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
--executePrereqsespecifica para executar as verificações de pré-requisito e reportar os resultados--resumeretoma a operação anterior--sessionIDespecifica para retomar um ID de sessão específico
--blobLocationespecifica a localização do diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do Data Guard
Após a conclusão bem-sucedida, o PDB é aberto em todas as instâncias do banco de dados contêiner.
Exemplo 6-44 dbaascli pdb open
dbaascli pdb open --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb open --dbname cdb name --pdbUID con_uid of that pdb
Opcional: --openMode READ_WRITE/READ_ONLY
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb recovery
Para recuperar um banco de dados plugável (PDB), use o comando dbaascli pdb recover.
Pré-requisito
- Execute o comando como usuário
root. - O banco de dados deve ser configurado com detalhes do destino de armazenamento de backup em que os backups são armazenados.
Sintaxe
dbaascli pdb recover --dbname <value> --pdbName <value>
{
--start
{
--untilTime <value> [--nonUTC]
| --untilSCN <value>
| --latest
| --tag <value>
}
| --status --uuid <value>
}
Em que:
--dbnameespecifica o nome do banco de dados contêiner que hospeda o PDB--pdbNameespecifica o nome do PDB que você deseja recuperar- O
--startinicia a recuperação de um PDB.--untilTimerecupera o PDB até o momento. Formato de entrada:DD-MON-YYYY HH24:MI:SS--untilSCNrecupera o PDB até SCN--latestrecupera o PDB para o último estado conhecido--tagrecupera o PDB para a tag de arquivamento
--statusexibe os detalhes sobre um processo da tarefa de recuperação do PDB--uuididentificador exclusivo da operação de recuperação do PDB. Formato de entrada:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx,
Exemplo 6-45 Exemplos
- Para recuperar um PDB pdb1 em um CDB myTestDb para o mais recente:
dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --start --latest - Para consultar o status da solicitação de recuperação do PDB submetida com
uuid81a17352362011ecbc3000163e8e4fac:dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --status --uuid 81a17352362011ecbc3000163e8e4fac
Tópicos Relacionados
Tópico principal: Referência de Comando do dbaascli
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: especificafalsepara executar a operação em segundo plano. Valores válidos:true|false
Tópicos Relacionados
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb relocate
Para realocar o PDB especificado do banco de dados remoto para o banco de dados local, use o comando dbaascli pdb relocate.
Pré-requisito
Execute o comando como usuário oracle. Quando solicitado, informe a senha do usuário SYS para o banco de dados de origem.
Sintaxe
dbaascli pdb relocate --pdbName <value> --dbName <value> --sourceDBConnectionString <value> [--targetPDBName <value>] [--powerLimit <value>] [--maxCpu <value>] [--maxSize <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--sourcePDBServices <value>] [--sourcePDBReadOnlyServices <value>] [--relocateAvailabilityType <value>] [--waitForCompletion <value>]
{
[--blobLocation <value>]
| [--standbyBlobFromPrimary <value>]
}
[--upgradePDB] [--updateDBBlockCacheSize]
{
[--skipOpenPDB [--enableRefreshMode --refreshMode <value> [--refreshIntervalInMinutes <value>]]]
| [--completePDBRelocate]
}
{
[--dblinkUsername <value> [--honorCaseSensitiveUserName]]
| [--dbLinkName <value>]
}
--pdbNameespecifica o nome do PDB de origem a ser realocado--dbNameespecifica o nome do banco de dados de destino--sourceDBConnectionStringespecifica a string de conexão do banco de dados de origem no formato<scan_name>:<scan_port>/<database_service_name>--targetPDBNameespecifica um nome para o PDB de destino (novo PDB realocado)--powerLimitespecifica o grau de paralelismo a ser usado para a operação de realocação--maxCpuespecifica o número máximo de CPUs a serem alocadas para o PDB--maxSizeespecifica o tamanho máximo do armazenamento em GB para o novo PDB--resumeespecifica para retomar a execução anterior--sessionIDespecifica para retomar um ID de sessão específico
--executePrereqsespecificayespara só executar os pré-requisitos desta operação. Valores válidos:yes|no--sourcePDBServicesespecifica uma lista de serviços do PDB de origem delimitados por vírgulas--sourcePDBReadOnlyServicesespecifica uma lista delimitada por vírgulas de serviços somente leitura do PDB de origem--relocateAvailabilityTypeespecifica a disponibilidade deMAX|NORMALpara ativar o encaminhamento de conexão do listener--waitForCompletionespecificafalsepara executar a operação em segundo plano. Valores válidos:true|false--blobLocationespecifica um local de diretório personalizado no qual o arquivo blob stand-by será gerado em um ambiente DG.--standbyBlobFromPrimaryespecifica 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--blobLocationsão mutuamente exclusivos.--upgradePDBespecificatruepara fazer upgrade do PDB como parte desta operação. Valores válidos :true|false.- O
--updateDBBlockCachesizeespecifica para permitir que o aplicativo defina os parâmetros da inicialização dodb block cache sizea fim de suportar a cópia dos dados com tamanho diferente de bloco --skipOpenPDBespecifica que o PDB não deve ser aberto no final da operação atual.--enableRefreshModeespecifica para ativar o suporte de atualização do PDB na etapa um de realocação do PDB.--refreshModeespecifica o modo de atualização do PDB atualizável. Valores válidos:AUTO|MANUAL--refreshIntervalInMinutesespecifica para atualizar o intervalo derefreshablePDBem minutos
--completePDBRelocateespecifica para concluir a realocação do PDB, se feita como uma operação de duas fases.
Exemplo 6-46 dbaascli pdb relocate
dbaascli pdb relocate --sourceDBConnectionString test-scan.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521/source_cdb_service_name --pdbName source_pdb --dbName target_db
Tópico principal: Referência de Comando do dbaascli
dbaascli pdb remoteClone
Para criar um novo banco de dados plugável (PDB) como clone de um PDB existente, em outro banco de dados contêiner (CDB), use o comando dbaascli pdb remoteClone.
Execute o comando como usuário root ou oracle.
Sintaxe
dbaascli pdb remoteClone --pdbName <value> --dbName <value> --sourceDBConnectionString <value> [--targetPDBName <value>] [--powerLimit <value>] [--maxCPU <value>] [--maxSize <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--waitForCompletion <value>] [--sourcePDBExportedTDEKeyFile <value>]
{
[--blobLocation <value>]
| [--standbyBlobFromPrimary <value>]
}
[--excludeUserTablespaces <value>] [--excludePDBData <value>] [--pdbAdminUserName <value>] [--lockPDBAdminAccount <value>] [--sourcePDBServiceConvertList <value>] [--upgradePDB]
{
[--createFromSnapshot --snapshotName <value> [--copyDataFiles]]
| [--snapshot]
}
[--refreshablePDB --refreshMode <value> [--refreshIntervalInMinutes <value>]] [--updateDBBlockCacheSize]
{
[--dblinkUsername <value> [--honorCaseSensitiveUserName]]
| [--dbLinkName <value>]
}
[--keepSourceDBServices <value>]
--pdbNameespecifica o nome do PDB de origem que você deseja clonar--dbnameespecifica o nome (DB_NAME) do CDB que hospeda o PDB recém-clonado--sourceDBConnectionStringespecifica a string de conexão do banco de dados de origem no formatoscan_name:scan_port/database_service_name--targetPDBNameespecifica o nome do PDB de destino (novo PDB clonado)--powerLimitespecifica o grau de paralelismo a ser usado para a operação de clonagem. O valor válido fica entre 1 e 128--maxCPUespecifica o número máximo de CPUs a serem alocadas para o PDB--maxSizeespecifica o tamanho máximo do armazenamento em GB para o novo PDB--resumeretoma a execução anterior-
--sessionIDespecifica para retomar um ID de sessão específico
-
--executePrereqsespecificayespara só executar os pré-requisitos desta operação. Valores válidos:yesouno--waitForCompletionespecificafalsepara executar a operação em segundo plano. Valores válidos:trueoufalse--sourcePDBExportedTDEKeyFileespecifica o arquivo de chave exportado do PDB de origem. Essa variável só se aplica ao banco de dados 12.1.--blobLocationespecifica o caminho personalizado em que o arquivo blob stand-by será gerado em um ambiente do Data Guard--standbyBlobFromPrimaryespecifique 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-byObservação
Os parâmetros--blobLocatione--standbyBlobFromPrimarysão mutuamente exclusivos.--excludeUserTablespaces- opção para ignorar tablespaces de usuário, por exemplo, t1,t2,t3.-
--excludePDBData- especifiquetrue/yespara ignorar dados do usuário do PDB de origem. --pdbAdminUserName- especifica o novo nome do usuário administrador do PDB--lockPDBAdminAccountespecifiquetrueoufalsepara 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.--upgradePDBespecifique para fazer upgrade do PDB como parte desta operação--createFromSnapshot|--snapshot--createFromSnapshotespecifique para criar o PDB com base no snapshot do PDB--snapshotNameespecifique o nome do snapshot a ser criado com base no PDB.
--copyDataFilesespecifique esta opção para ignorar a cópia do snapshot.--snapshotespecifique para criar o PDB com cópia de snapshot.
--refreshablePDBespecifica a criação de um PDB atualizável--refreshModeespecifica o modo de atualização para um PDB atualizável. Valores válidos:AUTO|MANUAL--refreshIntervalInMinutesespecifica o intervalo de atualização pararefreshablePDBem minutos
--dblinkUsernameespecifica 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--honorCaseSensitiveUserNameindica que o nome de usuário especificado faz distinção entre maiúsculas e minúsculas
--dbLinkNameespecifica um nome do link de banco de dados existente no banco de dados de destino que aponta para o banco de dados remoto
Quando solicitado, forneça a senha do usuário SYS para o PDB de origem. O PDB recém-clonado herda senhas de administração do PDB de origem. O PDB clonado é nomeado usando o seguinte formato: dbname_sourcepdbname. Esse comando só é suportado para bancos de dados que não estão em uma configuração do Data Guard e usam o Oracle Database versão 12.2.0.1 ou mais recente.
Exemplo 6-47 dbaascli pdb remoteClone
dbaascli pdb remoteClone --sourceDBConnectionString test-can.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521 --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2
dbaascli pdb remoteClone --sourceDBConnectionString orcla.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2
Tópico principal: Referência de Comando do dbaascli
dbaascli system getDBHomes
Para exibir informações sobre todos os Oracle homes, use o comando dbaascli system getDBHomes.
Pré-requisito
Execute o comando como usuário root ou oracle.
Sintaxe
dbaascli system getDBHomes
Perguntas Frequentes
P: Para que é usado o comando dbaascli system getDBHomes?
R: O comando dbaascli system getDBHomes é usado para exibir informações sobre todos os Oracle homes em um sistema.
P: Qual usuário deve executar o comando dbaascli system getDBHomes?
A: O comando deve ser executado como o usuário root ou oracle.
P: Há algum parâmetro para o comando dbaascli system getDBHomes?
A: Não, o comando dbaascli system getDBHomes não tem parâmetros.
P: Que tipo de informação o comando dbaascli system getDBHomes fornece?
R: O comando fornece detalhes sobre todos os Oracle homes no sistema, incluindo seus caminhos e outras informações relevantes.
P: Como posso interpretar a saída do comando dbaascli system getDBHomes?
A: A saída listará todos os Oracle homes com informações como a localização de cada Oracle home. Essas informações podem ajudar no gerenciamento e na configuração de ambientes Oracle.
P: O que devo fazer se o comando dbaascli system getDBHomes não retornar nenhuma saída?
R: Certifique-se de que você esteja executando o comando como usuário root ou oracle e verifique se os Oracle homes estão instalados corretamente no sistema. Você também pode verificar as permissões e configurações do sistema.
P: E se eu receber uma mensagem de erro ao executar o comando dbaascli system getDBHomes?
R: Verifique a mensagem de erro para obter detalhes específicos, verifique se você tem as permissões apropriadas e certifique-se de que a ferramenta dbaascli esteja instalada e configurada corretamente.
P: Posso executar o sistema dbaascli getDBHomes em um sistema não Oracle?
R: Não, o comando dbaascli system getDBHomes é específico para sistemas Oracle e requer que o software Oracle seja instalado.
Exemplo 6-48 dbaascli system getDBHomes
dbaascli system getDBHomes
Tópico principal: Referência de Comando do dbaascli
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>]]
--dbnameespecifica o nome do banco de dados--prepareStandbyBlob- especifica true para gerar um arquivo blob contendo os artefatos necessários para executar a operação em um ambiente do DG.-
--blobLocation- caminho personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG. --standbyBlobFromPrimary- especifica o local do arquivo blob stand-by preparado no banco de dados principal. Isso só é necessário para operações stand-by.--resume- para retomar a execução anterior--sessionID- para retomar um id de sessão específico.
Perguntas Frequentes
P: O que o comando dbaascli tde changePassword faz?
A: O comando dbaascli tde changePassword altera a senha do armazenamento de chaves TDE (Transparent Data Encryption), bem como a senha da wallet do banco de dados do alias tde_ks_passwd.
P: Quem deve executar o comando dbaascli tde changePassword?
A: O comando deve ser executado como o usuário root.
P: Quando devo usar o comando dbaascli tde changePassword?
R: Use este comando quando precisar alterar a senha do armazenamento de chaves TDE ou a senha da wallet de BD para um banco de dados Exadata Cloud@Customer.
P: O que a opção --dbname faz?
A: A opção --dbname especifica o nome do banco de dados para o qual você deseja alterar a senha do armazenamento de chaves de TDE.
P: O que a opção --pdbName faz?
A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) para o qual a senha da área de armazenamento de chaves de TDE precisa ser alterada. Esta opção é usada em bancos de dados multitenant.
P: Você pode dar um exemplo de como executar este comando para um banco de dados específico?
A: Aqui está um exemplo para alterar a senha da área de armazenamento de chaves de TDE para um banco de dados específico:
dbaascli tde changePassword --dbname mydatabase
P: Como faço para executar o comando de um PDB específico em um banco de dados multitenant?
A: Você pode especificar o nome do PDB usando esta sintaxe:
dbaascli tde changePassword --dbname mydatabase --pdbName mypdb
P: Quais são os pré-requisitos para executar o comando dbaascli tde changePassword?
R: Você deve executar o comando como o usuário root e ter acesso à máquina virtual do Exadata Cloud@Customer na qual o banco de dados está em execução.
P: Preciso interromper o banco de dados para alterar a senha do armazenamento de chaves de TDE?
R: Não, o banco de dados não precisa ser interrompido para alterar a senha da área de armazenamento de chaves de TDE.
P: O que devo fazer se o comando falhar?
R: Certifique-se de que você esteja executando o comando como usuário raiz e que o nome do banco de dados (--dbname) e o nome do PDB (--pdbName, se aplicável) estejam corretos.
P: E se eu receber um erro de "senha inválida" ao alterar a senha do armazenamento de chaves TDE?
R: Certifique-se de que a nova senha atenda aos requisitos de complexidade de senhas do sistema e que você esteja digitando a senha antiga correta, se solicitado.
P: Como verifico se a senha da área de armazenamento de chaves de TDE foi alterada com sucesso?
R: Você pode verificar os logs do banco de dados ou usar as views do Oracle Database Vault e do Key Management para verificar se a alteração da senha da área de armazenamento de chaves de TDE foi bem-sucedida.
P: Posso alterar a senha da área de armazenamento de chaves de TDE para um banco de dados multitenant e todos os PDBs de uma só vez?
R: Não, o comando dbaascli tde changePassword precisará ser executado para cada PDB individualmente se você precisar alterar a senha de vários PDBs.
P: O que acontece se eu esquecer a nova senha da área de armazenamento de chaves TDE?
R: Se a nova senha for esquecida, talvez você precise restaurar a área de armazenamento de chaves de um backup ou seguir o processo de recuperação da Oracle para redefini-la, dependendo da sua configuração.
P: Posso automatizar o processo de alteração da senha da área de armazenamento de chaves TDE?
R: Embora o próprio comando dbaascli tde changePassword não seja projetado para automação, você pode criá-lo como parte de seus procedimentos regulares de manutenção de banco de dados, se necessário.
P: Com que frequência devo alterar a senha da área de armazenamento de chaves TDE?
R: A Oracle recomenda alterar periodicamente sua senha da área de armazenamento de chaves de TDE com base nas políticas de segurança da sua organização. As melhores práticas geralmente envolvem a rotação de chaves de criptografia e senhas de armazenamento de chaves regularmente.
dbaascli tde changepassword --dbname
<dbname>- 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> - Copie o blob stand-by criado para o ambiente do banco de dados stand-by.
- Altere a senha de TDE no banco de dados stand-by.
dbaascli tde changepassword --dbname <dbname> --standbyBlobFromPrimary <Location of blob generated from primary>
Tópico principal: Referência de Comando do dbaascli
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]
--secondaryKmsKeyOCIDespecifica a chave KMS secundária a ser adicionada à configuração HSM (KMS) existente--dbnameespecifica o nome do banco de dados--executePrereqs- execute as verificações de pré-requisitos e reporte os resultados.
Perguntas Frequentes
P: O que o comando dbaascli tde addSecondaryHsmKey faz?
R: O comando dbaascli tde addSecondaryHsmKey adiciona uma chave secundária do HSM (KMS) à configuração existente do HSM (KMS) para um banco de dados do Exadata Cloud@Customer.
P: Quem deve executar o comando dbaascli tde addSecondaryHsmKey?
A: O comando deve ser executado como o usuário root.
P: Em qual máquina devo executar o comando dbaascli tde addSecondaryHsmKey?
R: Você precisa estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.
P: Onde posso encontrar mais detalhes sobre a conexão com uma máquina virtual para executar este comando?
R: Você pode consultar o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções sobre como estabelecer conexão.
P: O que a opção --secondaryKmsKeyOCID especifica?
A: A opção --secondaryKmsKeyOCID especifica o OCID (Oracle Cloud Identifier) da chave KMS secundária a ser adicionada à configuração do HSM (KMS) existente.
P: O que a opção --dbname faz?
A: A opção --dbname permite especificar o nome do banco de dados ao qual a chave KMS secundária deve ser adicionada. É opcional.
P: O que a opção --precheckOnly faz?
A: A opção --precheckOnly, quando definida como yes, executa uma pré-verificação da operação sem fazer alterações reais. Os valores válidos são yes ou no.
P: Posso executar a pré-verificação apenas sem fazer alterações?
R: Sim, você pode usar a opção --precheckOnly yes para executar apenas a pré-verificação sem fazer alterações.
P: Você pode dar um exemplo de como executar este comando para adicionar uma chave HSM secundária?
A: Este é um exemplo:
dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example
P: Como executar o comando para um banco de dados específico?
A: Você pode especificar o nome do banco de dados como este:
dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --dbname mydatabase
P: Como executar o comando apenas com uma pré-verificação?
A: Para executar a pré-verificação, use a seguinte sintaxe:
dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --precheckOnly yes
P: O que devo fazer se o comando falhar?
R: Verifique se você está executando o comando como o usuário root e se conectou à máquina virtual correta do Exadata Cloud@Customer. Além disso, verifique o OCID da chave KMS e verifique se as permissões necessárias foram concedidas.
P: Como posso verificar se tenho o OCID correto para a chave KMS secundária?
R: Você pode recuperar o OCID da chave KMS na console do Oracle Cloud Infrastructure, na seção KMS (Key Management Service).
P: Quais permissões são necessárias para adicionar uma chave KMS secundária?
R: Você precisa de permissões apropriadas no Oracle Cloud Infrastructure para operações KMS, incluindo a capacidade de gerenciar chaves KMS para o compartimento relevante.
P: Posso usar o comando dbaascli tde addSecondaryHsmKey sem especificar a opção --dbname?
R: Sim, a opção --dbname é opcional. Se omitido, o comando se aplica a todos os bancos de dados que usam a configuração HSM (KMS) existente.
P: O que acontece se eu adicionar uma chave KMS secundária?
R: A chave KMS secundária será adicionada à configuração existente, fornecendo uma camada adicional de redundância de gerenciamento de chaves de criptografia.
P: Posso remover uma chave KMS secundária depois que ela for adicionada?
R: Não, depois que uma chave KMS secundária for adicionada, ela não poderá ser removida. Você só pode rotacionar ou atualizar chaves no futuro.
Exemplo 6-49 dbaascli tde addSecondaryHsmKey
dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --precheckOnly yes
Tópico principal: Referência de Comando do dbaascli
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>]]
--dbnameespecifica o nome do Oracle Database.--dbrestartespecifica a opção de reinício do banco de dados. Os valores válidos são:rollingoufull. Valor padrão:rollingSe você não informar o argumento
dbrestart, o banco de dados será reiniciado de maneirarolling.--precheckOnlysó executa a pré-verificação desta operação. Os valores válidos são:yesouno--resumepara retomar a execução anterior-
--sessionIDpara retomar um id de sessão específico.
Perguntas Frequentes
P: O que o comando dbaascli tde enableWalletRoot faz?
R: O comando dbaascli tde enableWalletRoot ativa o parâmetro wallet_root em spfile para um banco de dados Oracle existente no Exadata Cloud@Customer.
P: Quem deve executar o comando dbaascli tde enableWalletRoot?
A: O comando deve ser executado como o usuário root.
P: Em qual máquina devo executar o comando dbaascli tde enableWalletRoot?
R: Você deve estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.
P: Onde posso encontrar instruções para me conectar à máquina virtual?
R: Você pode consultar o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções sobre como estabelecer conexão.
P: O que a opção --dbRestart faz?
--dbRestart especifica como o banco de dados deve ser reiniciado após a ativação de wallet_root. Os valores válidos são:
rolling: Reinicia o banco de dados de forma incremental (comportamento padrão).full: Executa uma reinicialização completa do banco de dados.
P: O que a opção --dbname faz?
A: A opção --dbname permite especificar o nome do Oracle Database para o qual o parâmetro wallet_root deve ser ativado.
P: O que a opção --precheckOnly faz?
A: A opção --precheckOnly executa uma pré-verificação da operação sem fazer alterações reais. Os valores válidos são yes ou no.
P: O que acontece se eu não especificar a opção --dbRestart?
R: Se você não especificar a opção --dbRestart, o banco de dados será reiniciado de forma incremental por padrão.
P: Você pode dar um exemplo de como ativar wallet_root para um banco de dados específico?
A: Veja um exemplo para ativar wallet_root para um banco de dados chamado mydatabase:
dbaascli tde enableWalletRoot --dbname mydatabase
P: Como ativar wallet_root e especificar uma reinicialização completa do banco de dados?
A: Você pode ativar wallet_root com uma reinicialização completa do banco de dados usando o seguinte comando:
dbaascli tde enableWalletRoot --dbname mydatabase --dbRestart full
P: Como executar o comando apenas com uma pré-verificação?
A: Para executar uma pré-verificação sem fazer alterações, use a seguinte sintaxe:
dbaascli tde enableWalletRoot --dbname mydatabase --precheckOnly yes
P: Quais são os pré-requisitos para executar o comando dbaascli tde enableWalletRoot?
R: Você deve executar o comando como o usuário root e estar conectado à máquina virtual correta do Exadata Cloud@Customer.
P: Preciso reiniciar o banco de dados para ativar o wallet_root?
R: Sim, o banco de dados precisará ser reiniciado de forma incremental (padrão) ou totalmente, dependendo da opção escolhida.
P: O que devo fazer se o comando falhar?
R: Certifique-se de que você esteja executando o comando como o usuário raiz e verifique se o nome do banco de dados (--dbname) está correto. Verifique se há erros de pré-verificação se você estiver executando com --precheckOnly.
P: E se o banco de dados falhar ao reiniciar após a execução do comando?
R: Verifique se a opção de reinicialização correta foi usada (rolling ou full) e verifique se há erros nos logs do banco de dados. Talvez seja necessário reiniciar manualmente o banco de dados se a reinicialização automática falhar.
P: Como posso verificar se wallet_root foi ativado com sucesso?
R: Você pode verificar a alteração verificando o spfile do banco de dados ou usando consultas do Oracle SQL para confirmar se o parâmetro wallet_root está ativado.
P: Posso ativar wallet_root sem reiniciar o banco de dados?
R: Não, o banco de dados precisa ser reiniciado para que a alteração entre em vigor. Você pode escolher entre uma reinicialização incremental ou uma reinicialização completa.
P: Qual é a diferença entre uma reinicialização contínua e completa do banco de dados?
R: Uma reinicialização incremental reinicia o banco de dados uma instância por vez, permitindo que o banco de dados permaneça parcialmente disponível durante a operação. Uma reinicialização completa é encerrada e reinicia todo o banco de dados, causando um tempo de inatividade completo.
P: Posso executar este comando para vários bancos de dados simultaneamente?
R: Você precisa executar o comando dbaascli tde enableWalletRoot separadamente para cada banco de dados no qual deseja ativar wallet_root.
P: Como a ativação de wallet_root afeta a configuração do armazenamento de chaves de TDE existente?
R: A ativação de wallet_root atualiza o local do armazenamento de chaves TDE para o novo diretório raiz da wallet, facilitando o gerenciamento de vários armazenamentos de chaves e wallets em bancos de dados Oracle.
Exemplo 6-50 dbaascli tde enableWalletRoot
dbaascli tde enableWalletRoot --dbname db name --dbrestart rolling|full
dbaascli tde enableWalletRoot --dbname orcl
dbaascli tde enableWalletRoot --dbname orcl--dbrestart full
Tópico principal: Referência de Comando do dbaascli
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]
--pdbNameespecifica o nome do PDB para criptografar todos os tablespaces.--dbnameespecifica o nome do Oracle Database.--executePrereqs- execute as verificações de pré-requisitos e reporte os resultados.
Perguntas Frequentes
P: O que o comando dbaascli tde encryptTablespacesInPDB faz?
R: O comando dbaascli tde encryptTablespacesInPDB criptografa todos os tablespaces no PDB (banco de dados plugável) especificado para um Oracle Database no Exadata Cloud@Customer.
P: Quem deve executar o comando dbaascli tde encryptTablespacesInPDB?
A: O comando deve ser executado como o usuário root.
P: Em qual máquina devo executar o comando dbaascli tde encryptTablespacesInPDB?
R: Você precisa estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.
P: Onde posso encontrar instruções para conexão com a máquina virtual?
A: Consulte o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções de conexão.
P: O que a opção --pdbName especifica?
A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) cujos tablespaces precisam ser criptografados.
P: O que a opção --dbname faz?
A: A opção --dbname permite especificar o nome do Oracle Database ao qual o PDB pertence.
P: O que a opção --precheckOnly faz?
A: A opção --precheckOnly executa uma pré-verificação da operação de criptografia sem fazer alterações reais. Os valores válidos são yes ou no.
P: O que a opção --useSysdbaCredential faz?
A: A opção --useSysdbaCredential especifica se as credenciais SYSDBA devem ser usadas para a operação. Os valores válidos são verdadeiro ou falso.
P: Você pode dar um exemplo de como criptografar tablespaces em um PDB específico?
A: Aqui está um exemplo para criptografar todos os tablespaces em um PDB chamado mypdb:
dbaascli tde encryptTablespacesInPDB --pdbName mypdb
P: Como criptografar tablespaces em um PDB específico em um banco de dados?
A: Use o seguinte comando para especificar o PDB e o banco de dados:
dbaascli tde encryptTablespacesInPDB --pdbName mypdb --dbname mydatabase
P: Como faço para executar uma pré-verificação sem executar a criptografia?
A: Você só pode executar uma pré-verificação usando esta sintaxe:
dbaascli tde encryptTablespacesInPDB --pdbName mypdb --precheckOnly yes
P: Como eu uso as credenciais SYSDBA para criptografar os tablespaces?
A: Você pode usar as credenciais SYSDBA adicionando a opção --useSysdbaCredential true:
dbaascli tde encryptTablespacesInPDB --pdbName mypdb --useSysdbaCredential true
P: Quais são os pré-requisitos para executar o comando dbaascli tde encryptTablespacesInPDB?
R: Você deve executar o comando como usuário root e ter acesso à máquina virtual do Exadata Cloud@Customer.
P: Preciso reiniciar o banco de dados para criptografar os tablespaces?
R: Não, o comando não requer uma reinicialização do banco de dados. A criptografia é executada enquanto o banco de dados está on-line.
P: Preciso de credenciais SYSDBA para criptografar tablespaces?
R: Talvez você precise de credenciais SYSDBA para esta operação, se especificado usando a opção --useSysdbaCredential.
P: O que devo fazer se o comando falhar?
R: Certifique-se de que você esteja executando o comando como o usuário raiz e verifique se o nome do PDB (--pdbName) e o nome do banco de dados (--dbname) estão corretos. Você também pode executar o comando com --precheckOnly yes para verificar problemas antes de executar a criptografia completa.
P: O que devo fazer se a criptografia dos tablespaces falhar?
R: Verifique os logs do banco de dados e certifique-se de ter os privilégios e recursos necessários para executar a criptografia. Você também pode precisar verificar se há espaço suficiente para lidar com o processo de criptografia.
P: Como posso verificar se os tablespaces em um PDB estão criptografados?
R: Você pode consultar as views de banco de dados relacionadas à criptografia, como V$ENCRYPTED_TABLESPACES, para verificar se os tablespaces foram criptografados com sucesso.
P: Como posso verificar se a pré-verificação foi bem-sucedida?
R: Se você executou o comando com --precheckOnly yes, poderá verificar a saída em busca de avisos ou erros que indiquem possíveis problemas com o processo de criptografia.
P: Posso criptografar os tablespaces de vários PDBs simultaneamente?
R: Não, você precisa executar o comando dbaascli tde encryptTablespacesInPDB separadamente para cada PDB.
P: Posso criptografar parcialmente alguns tablespaces em um PDB?
R: Não, este comando criptografa todos os tablespaces dentro do PDB especificado. Para criptografia parcial, você precisaria usar comandos de gerenciamento de banco de dados diferentes.
P: A criptografia de tablespaces afeta o desempenho do banco de dados?
R: A criptografia de tablespaces pode ter um impacto temporário no desempenho durante o processo de criptografia. No entanto, o impacto deve ser mínimo quando a criptografia estiver concluída.
P: Posso desfazer a criptografia de tablespaces?
R: Não, depois que os tablespaces forem criptografados, a criptografia não poderá ser desfeita. Você só pode rotacionar ou recriptografar as chaves conforme necessário.
P: O que acontece se a operação for interrompida durante o processo de criptografia?
R: Se a operação for interrompida, talvez seja necessário reexecutar o comando. O sistema retomará a criptografia de onde parou e você poderá verificar o status usando views de banco de dados.
Exemplo 6-51 dbaascli tde encryptTablespacesInPDB
dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb
dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb --executePrereqs
Tópico principal: Referência de Comando do dbaascli
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>]
--kmsKeyOCIDespecifica o OCID da chave KMS a ser usado para TDE. Isso só será aplicável se o KMS for selecionado para TDE--dbnameespecifica o nome do banco de dados--skipPatchCheckignora a verificação de validação para patches obrigatórios se o valor informado para esse argumento fortrue. Valores válidos:trueoufalse--executePrereqs- execute as verificações de pré-requisitos e reporte os resultados.--primarySucespecifica essa propriedade no banco de dados stand-by do ambiente do Data Guard quando o comando é executado com sucesso no banco de dados principal--resumeespecifica para retomar a execução anterior-
--sessionIDespecifica para retomar um ID de sessão específico
-
--revertespecifica para fazer rollback da execução anterior-
--sessionIDespecifica para fazer rollback de um ID de sessão específico
-
--waitForCompletionespecifique false para executar a operação em segundo plano. Valores válidos : true|false.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli tde fileToHsm?
R: O comando dbaascli tde fileToHsm é usado para converter uma TDE (Transparent Data Encryption) baseada em arquivo para a TDE baseada no Módulo de Segurança de Hardware (HSM), como KMS ou OKV, em um ambiente do Oracle Database Cloud Service.
P: Quem pode executar o comando dbaascli tde fileToHsm?
A: O comando deve ser executado como o usuário root.
P: Qual é a finalidade do parâmetro --kmsKeyOCID?
R: O parâmetro --kmsKeyOCID especifica o OCID da chave KMS que será usado para criptografia de TDE ao fazer a transição de TDE baseada em arquivo para TDE baseada em HSM.
P: O que o parâmetro --dbname faz?
R: O parâmetro --dbname especifica o nome do banco de dados para o qual você está convertendo o TDE de baseado em arquivo para baseado em HSM.
P: Posso ignorar a verificação de validação do patch ao converter a TDE?
R: Sim, usando o parâmetro --skipPatchCheck com o valor true, você pode ignorar a verificação de validação dos patches necessários.
P: Para que o parâmetro --executePrereqs é usado?
R: O parâmetro --executePrereqs permite que você execute somente as pré-verificações do processo de conversão de TDE sem executar a conversão real. Os valores válidos são yes ou no.
P: O que o parâmetro --primarySuc faz em uma configuração do Data Guard?
R: O parâmetro --primarySuc é usado em um ambiente do Data Guard para indicar que o comando foi executado com sucesso no banco de dados principal. Ela deve ser especificada no banco de dados stand-by após a conclusão da conversão principal.
P: Como retomar uma conversão de TDE anterior?
R: Você pode retomar uma conversão de TDE anteriormente incompleta usando o parâmetro --resume. Opcionalmente, você pode especificar um ID de sessão específico com --sessionID.
P: Como reverter uma conversão de TDE?
R: Para reverter uma conversão de TDE anterior, use o parâmetro --revert. Você também pode fornecer o ID de sessão específico que deseja reverter usando --sessionID.
P: Como especificar um ID de sessão ao retomar ou reverter uma conversão de TDE?
R: Você pode usar o parâmetro --sessionID para especificar o ID da sessão que deseja retomar ou reverter. Exemplo: --resume --sessionID <ID> ou --revert --sessionID <ID>.
P: O que acontece se eu definir --waitForCompletion como falso?
R: Se você definir --waitForCompletion como false, o processo de conversão de TDE será executado em segundo plano e o prompt de comando retornará imediatamente. Se definido como true, o comando aguardará a conclusão do processo antes de retornar o controle ao usuário.
P: Quais são os valores válidos para o parâmetro --waitForCompletion?
A: Os valores válidos são true ou false. A definição dele como verdadeiro faz com que o comando aguarde até que o processo seja concluído; a definição dele como false executa o processo em segundo plano.
P: Posso executar dbaascli TDE fileToHsm sem converter o TDE imediatamente?
R: Sim, você pode usar o parâmetro --executePrereqs yes para executar apenas as pré-verificações da conversão, sem fazer alterações na TDE.
P: Em um ambiente do Data Guard, como lidar com o banco de dados stand-by após a conversão da TDE no principal?
R: Após executar com sucesso a conversão no banco de dados principal, você precisa especificar --primarySuc ao executar o comando no banco de dados stand-by.
P: O que devo fazer se o processo de conversão de TDE falhar?
R: Se o processo falhar, você poderá usar o parâmetro --resume para tentar retomar de onde parou. Se necessário, você pode usar o parâmetro --revert para fazer rollback das alterações feitas durante a sessão com falha.
Exemplo 6-52 dbaascli tde fileToHsm --kmsKeyOCID
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --resume
Tópico principal: Referência de Comando do dbaascli
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]
--dbnameespecifica o nome do banco de dados--infoFileespecifica o caminho do arquivo em que a lista de OCIDs será salva. A saída está no formato JSON
Perguntas Frequentes
P: O que o comando dbaascli tde getHsmKeys faz?
R: O comando dbaascli tde getHsmKeys recupera detalhes de chaves TDE (Transparent Data Encryption) ativas do HSM (Hardware Security Module) de um banco de dados especificado.
P: Quem deve executar o comando dbaascli tde getHsmKeys?
A: O comando deve ser executado como o usuário root.
P: Em qual máquina devo executar o comando dbaascli tde getHsmKeys?
R: Você deve estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.
P: Onde posso encontrar instruções para conexão com a máquina virtual?
A: Consulte o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções sobre como estabelecer conexão.
P: O que a opção --dbname faz?
A: A opção --dbname permite especificar o nome do Oracle Database para o qual você deseja recuperar detalhes da chave de TDE.
P: O que a opção --infoFile faz?
A: A opção --infoFile especifica o caminho do arquivo no qual a lista de OCIDs de chave (Identificadores do Oracle Cloud) será salva. A saída está no formato JSON.
P: Você pode dar um exemplo de como recuperar detalhes da chave TDE de um banco de dados específico?
A: Veja um exemplo para obter os detalhes da chave TDE de um banco de dados chamado mydatabase:
dbaascli tde getHsmKeys --dbname mydatabase
P: Como faço para salvar os detalhes da chave TDE em um arquivo?
A: Você pode especificar um caminho de arquivo usando a opção --infoFile para salvar a saída no formato JSON:
dbaascli tde getHsmKeys --dbname mydatabase --infoFile /path/to/output.json
P: Quais são os pré-requisitos para executar o comando dbaascli tde getHsmKeys?
R: Você deve executar o comando como o usuário root e estar conectado à máquina virtual do Exadata Cloud@Customer.
P: Preciso de credenciais SYSDBA para recuperar detalhes da chave TDE?
R: Não, as credenciais SYSDBA não são necessárias para executar o comando dbaascli tde getHsmKeys.
P: Em que formato as informações da chave TDE são salvas ao usar a opção --infoFile?
R: A saída é salva no formato JSON.
P: Quais informações estão incluídas nos detalhes da chave TDE?
R: Os detalhes incluem OCIDs de chave e outros metadados sobre as chaves de criptografia ativas armazenadas no HSM para o banco de dados especificado.
P: O que devo fazer se o comando não recuperar os detalhes da chave?
R: Verifique se você está executando o comando como o usuário raiz e se o nome do banco de dados (--dbname) está correto. Verifique sua conexão com a máquina virtual do Exadata Cloud@Customer.
P: Como verifico se o arquivo de saída foi criado com sucesso?
R: Você pode verificar o caminho do arquivo especificado para o arquivo JSON de saída. Se o arquivo estiver ausente, verifique se o caminho do arquivo está correto e se você tem permissões de gravação no diretório.
P: O que devo fazer se o arquivo de saída estiver vazio?
R: Certifique-se de que o banco de dados especificado contenha chaves de TDE ativas e que o parâmetro --dbname esteja correto. Você também pode precisar verificar se há erros nos logs do banco de dados.
P: Posso recuperar detalhes da chave TDE para vários bancos de dados de uma só vez?
R: Não, você deve executar o comando dbaascli tde getHsmKeys separadamente para cada banco de dados.
P: Como posso usar o arquivo de saída da opção --infoFile em outras operações?
R: Como a saída está no formato JSON, você pode fazer parsing do arquivo de forma programática ou usá-lo como entrada para outras tarefas de gerenciamento de banco de dados ou criptografia.
P: Posso obter detalhes históricos da chave de TDE usando este comando?
R: Não, o comando recupera apenas detalhes sobre as chaves atualmente ativas no HSM.
P: Como posso verificar se as chaves recuperadas estão corretas?
R: Você pode verificar as chaves fazendo referência cruzada delas com a console do OCI (Oracle Cloud Infrastructure) ou usando views de banco de dados relacionadas ao gerenciamento de criptografia.
Exemplo 6-53 dbaascli tde getHsmKeys
dbaascli tde getHsmkeys --dbname dbname
dbaascli tde getHsmkeys --dbname dbname --infoFile infoFilePath
Tópico principal: Referência de Comando do dbaascli
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>]
--kmsKeyVersionOCIDespecifica o OCID da versão da chave KMS a ser definido--dbnameespecifica o nome do banco de dados--waitForCompletionespecificafalsepara 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?
- 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?
- Você está executando o comando como o usuário
root. - Você está conectado corretamente à máquina virtual do Exadata Cloud@Customer.
- O OCID da versão da chave KMS fornecido é válido. Se o erro persistir, verifique os logs do sistema para obter mais detalhes.
P: Como estabeleço conexão com a máquina virtual do Exadata Cloud@Customer?
R: Você pode se conectar à máquina virtual via SSH. Consulte a documentação do Exadata Cloud@Customer para obter etapas sobre como estabelecer conexão segura.
Exemplo 6-54 dbaascli tde getMkidForKeyVersionOCID
dbaascli tde getMkidForKeyVersionOCID --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
Tópico principal: Referência de Comando do dbaascli
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]
--dbnameespecifica 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?
- Execute o comando como usuário
root. - Conecte-se a uma máquina virtual do Exadata Cloud@Customer via SSH.
P: Quem pode executar o comando dbaascli tde getPrimaryHsmKey?
A: Somente o usuário root pode executar esse comando.
P: O que o parâmetro --dbname especifica neste comando?
R: O parâmetro --dbname especifica o nome do banco de dados para o qual você deseja recuperar a chave HSM principal.
P: O parâmetro --dbname é obrigatório?
A: Não, o parâmetro --dbname é opcional. Se não for fornecida, o comando recuperará a chave HSM primária do banco de dados padrão no sistema.
P: O que devo fazer se não especificar um nome de banco de dados com --dbname?
R: Se o parâmetro --dbname não for especificado, o comando tentará recuperar a chave principal do HSM para o banco de dados padrão configurado no sistema.
P: Posso executar este comando em um ambiente que não seja do Exadata Cloud@Customer?
R: Não, esse comando foi projetado especificamente para uso em um ambiente Exadata Cloud@Customer e você deve estar conectado à máquina virtual usando SSH para executá-lo.
P: Como estabeleço conexão com a máquina virtual do Exadata Cloud@Customer para executar o comando?
R: Você pode se conectar à máquina virtual via SSH. Consulte a documentação do Exadata Cloud@Customer para obter instruções sobre como estabelecer conexão segura.
P: O que devo verificar se encontro um erro ao recuperar a chave principal do HSM?
- Você está executando o comando como o usuário
root. - Você está conectado corretamente à máquina virtual do Exadata Cloud@Customer.
- O nome do banco de dados (se especificado) é válido. Se o problema persistir, consulte logs do sistema ou mensagens de erro para obter mais detalhes.
P: Eu preciso interromper o banco de dados para executar o comando dbaascli tde getPrimaryHsmKey?
R: Não, o banco de dados não precisa ser interrompido para executar este comando. Você pode executá-lo enquanto o banco de dados está em execução.
P: Qual é a finalidade de recuperar a chave principal do HSM?
R: A recuperação da chave HSM principal permite identificar a chave HSM atual que está sendo usada para criptografia na configuração HSM (KMS) existente do banco de dados.
Exemplo 6-55 dbaascli tde getPrimaryHsmKey
dbaascli tde getPrimaryHsmKey --dbname dbname
Tópico principal: Referência de Comando do dbaascli
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>]
--dbnameespecifica o nome do banco de dados--prepareStandbyBlob- especifiquetruepara gerar um arquivo blob contendo os artefatos necessários para executar a operação em um ambiente do DG.-
--blobLocationlocal de diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG. --standbyBlobFromPrimaryespecifica o local do arquivo blob stand-by preparado no banco de dados principal. Isso só é necessário para operações stand-by. ]--skipPatchCheckignora a verificação de validação para patches obrigatórios se o valor informado para esse argumento fortrue. Valores válidos:trueoufalse--executePrereqs- execute as verificações de pré-requisitos e reporte os resultados.--primarySucespecifica essa propriedade no banco de dados stand-by do ambiente do Data Guard quando o comando é executado com sucesso no banco de dados principal--resumeretoma a execução anterior-
--sessionIDespecifica para retomar um ID de sessão específico
-
--revertespecifica para fazer rollback da execução anterior-
--sessionIDespecifica para fazer rollback de um ID de sessão específico
-
--waitForCompletionespecificafalsepara 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?
- Execute o comando como usuário
root. - Certifique-se de ter as permissões e configurações necessárias definidas no ambiente de banco de dados.
P: O que o parâmetro --dbname especifica?
R: O parâmetro --dbname especifica o nome do banco de dados para o qual você está convertendo o TDE de baseado em HSM para baseado em arquivo.
P: Quando o parâmetro --primaryDBWalletTar é necessário?
R: O parâmetro --primaryDBWalletTar só é necessário ao executar a conversão hsmToFile em um banco de dados stand-by. Especifica o arquivo tar da wallet do banco de dados principal.
P: Qual é a finalidade do parâmetro --skipPatchCheck?
R: O parâmetro --skipPatchCheck permite ignorar a verificação de validação dos patches necessários. Defina isso como true para ignorar a verificação ou false para aplicá-la.
P: Como executar apenas pré-verificações para o processo de conversão sem executar a conversão real?
R: Você pode usar o parâmetro --executePrereqs e defini-lo como yes para executar somente as pré-verificações. Defina-o como no para executar a conversão completa.
P: O que o parâmetro --primarySuc faz em um ambiente do Data Guard?
R: O parâmetro --primarySuc é usado em uma configuração do Data Guard para indicar que a conversão foi executada com sucesso no banco de dados principal. Ele deve ser usado ao executar a conversão no banco de dados stand-by.
P: Como posso retomar uma conversão hsmToFile anterior?
R: Você pode retomar uma conversão anterior usando o parâmetro --resume. Opcionalmente, você pode especificar o ID da sessão da execução anterior com --sessionID.
P: Qual é a finalidade do parâmetro --revert?
R: O parâmetro --revert é usado para fazer rollback de um processo de conversão iniciado anteriormente em caso de falha ou se você precisar desfazer a operação.
P: O que acontece se eu definir --waitForCompletion como falso?
R: Se você definir --waitForCompletion como false, a operação será executada em segundo plano, permitindo que você continue outras tarefas. Se definido como true, o comando aguardará a conclusão do processo antes de retornar o controle ao usuário.
P: O que devo fazer se precisar converter a TDE em um banco de dados stand-by em uma configuração do Data Guard?
R: Em uma configuração do Data Guard, depois de converter TDE no banco de dados principal, você deve executar o comando no banco de dados stand-by usando o parâmetro --primaryDBWalletTar, especificando o arquivo tar da wallet do banco de dados principal e incluir --primarySuc.
P: O que devo fazer se quiser ignorar a verificação dos patches necessários durante a conversão?
R: Você pode ignorar a verificação de patch usando o parâmetro --skipPatchCheck e definindo-o como true.
P: Como verifico se o sistema está pronto para a conversão hsmToFile sem fazer alterações?
R: Você só pode executar as pré-verificações usando o parâmetro --executePrereqs e definindo-o como yes.
P: O que devo fazer se o processo de conversão for interrompido?
R: Você pode usar o parâmetro --resume para reiniciar o processo de onde ele parou. Opcionalmente, você pode especificar um ID de sessão específico com --sessionID.
P: O que devo fazer se o processo de conversão falhar?
R: Se a conversão falhar, você poderá fazer rollback do processo usando o parâmetro --revert. Além disso, revise quaisquer mensagens de erro e verifique os logs do sistema para obter mais detalhes.
P: Posso executar o comando dbaascli tde hsmToFile em um ambiente não Exadata?
R: Este comando foi projetado para uso em ambientes Exadata Cloud@Customer. Se você não estiver usando o Exadata, certifique-se de estar em um ambiente suportado para que o comando funcione corretamente.
Exemplo 6-56 dbaascli tde hsmToFile
dbaascli tde hsmToFile --dbname dbname
dbaascli tde hsmToFile --dbname dbname --executePrereqs
dbaascli tde hsmToFile --dbname dbname --resume
Tópico principal: Referência de Comando do dbaascli
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>]
--dbnameespecifica 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?
- 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?
- Você está executando o comando como o usuário
root. - Você está conectado à máquina virtual do Exadata Cloud@Customer.
- O nome do banco de dados (se especificado) está correto. Verifique as mensagens de erro e os logs para obter mais detalhes sobre a falha.
P: Posso executar o comando dbaascli tde listKeys enquanto o banco de dados está em execução?
R: Sim, o comando pode ser executado enquanto o banco de dados está em execução. Ele simplesmente lista as chaves principais de TDE e não altera o estado do banco de dados.
P: Preciso de permissões especiais para executar este comando?
R: Execute esse comando como usuário root. Sem permissões root, você não poderá executar o comando.
P: Qual é a finalidade de listar as chaves mestras de TDE?
R: A listagem de chaves principais de TDE permite que você revise as chaves de criptografia que estão sendo usadas para proteger os dados do seu banco de dados. É essencial para monitorar e gerenciar configurações de criptografia.
P: Como estabeleço conexão com a máquina virtual do Exadata Cloud@Customer para executar o comando?
R: Você pode se conectar à máquina virtual usando SSH. Consulte a documentação do Exadata Cloud@Customer para obter instruções sobre como estabelecer uma conexão segura.
Exemplo 6-57 dbaascli tde listKeys
dbaascli tde listKeys --dbname dbname
dbaascli tde listKeys --dbname dbname --infoFilePath infoFilePath
Tópico principal: Referência de Comando do dbaascli
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]
--dbnameespecifica 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?
- Execute o comando como usuário
root. - Conecte-se a uma máquina virtual do Oracle Exadata Database Service no Exascale Infrastructure usando SSH.
P: O que o parâmetro --force faz no comando dbaascli tde removeSecondaryHsmKey?
R: O parâmetro --force permite a remoção da chave secundária do HSM sem solicitar confirmação ao usuário. Se não for especificado, o comando solicitará ao usuário antes de excluir as chaves.
P: O que o parâmetro --secondaryKmsKeyOCID especifica?
A: O parâmetro --secondaryKmsKeyOCID especifica o OCID (Oracle Cloud Identifier) da chave KMS secundária que você deseja remover da configuração do HSM existente.
P: O que o parâmetro --dbname faz?
R: O parâmetro --dbname especifica o nome do banco de dados para o qual a chave HSM secundária está sendo removida.
P: Qual é a finalidade do parâmetro --precheckOnly?
R: O parâmetro --precheckOnly, se definido como yes, só executará as pré-verificações para validar a prontidão da operação de remoção sem realmente remover a chave HSM secundária. Se definido como no, a operação de remoção completa será executada.
P: O parâmetro --force é obrigatório?
A: Não, o parâmetro --force é opcional. Se não for especificado, o sistema solicitará confirmação ao usuário antes de prosseguir com a remoção da chave.
P: O parâmetro --secondaryKmsKeyOCID é obrigatório?
R: Sim, você deve fornecer o --secondaryKmsKeyOCID para identificar a chave HSM secundária específica que deseja remover da configuração.
P: O parâmetro --dbname é obrigatório?
A: Não, o parâmetro --dbname é opcional. Se não for especificado, o comando tentará remover a chave secundária do HSM do banco de dados padrão no sistema.
P: O que devo fazer se eu quiser remover a chave secundária do HSM sem prompts do usuário?
R: Você deve usar o parâmetro --force para ignorar o prompt de confirmação e remover a chave secundária do HSM diretamente:
dbaascli tde removeSecondaryHsmKey --force --secondaryKmsKeyOCID <value>
P: Como posso testar se o sistema está pronto para remover a chave HSM secundária sem realmente removê-la?
A: Você pode usar o parâmetro --precheckOnly definido como sim para executar uma pré-verificação:
dbaascli tde removeSecondaryHsmKey --precheckOnly yes --secondaryKmsKeyOCID <value>
P: O que acontece se eu não fornecer um nome de banco de dados com --dbname?
R: Se o parâmetro --dbname não for especificado, o comando tentará remover a chave secundária do HSM do banco de dados padrão configurado no sistema.
P: O que devo verificar se o comando falha ao remover a chave secundária do HSM?
- Você está executando o comando como o usuário
root. - Você está conectado à máquina virtual do Oracle Exadata Database Service on Exascale Infrastructure.
- Os valores
--secondaryKmsKeyOCIDe--dbnamecorretos são fornecidos. Verifique as mensagens de erro e os logs para obter mais detalhes sobre a falha.
P: O que devo fazer se a operação de remoção falhar a meio do caminho?
R: Se a operação falhar, revise os logs de erro e tente executar o comando com --precheckOnly para garantir que o sistema esteja pronto para a operação. Se necessário, corrija os problemas antes de tentar novamente.
P: Posso executar o comando dbaascli tde removeSecondaryHsmKey enquanto o banco de dados está em execução?
R: Sim, o comando pode ser executado enquanto o banco de dados está em execução, pois não requer que o banco de dados seja interrompido.
P: Qual é a finalidade de remover uma chave HSM secundária?
R: A remoção de uma chave HSM secundária geralmente é feita quando a chave não é mais necessária ou quando você deseja gerenciar as chaves de criptografia usadas na configuração de TDE (Criptografia Transparente de Dados).
P: Como eu estabeleço conexão com a máquina virtual do Oracle Exadata Database Service on Exascale Infrastructure para executar o comando?
R: Você pode se conectar à máquina virtual usando SSH. Consulte a documentação do Oracle Exadata Database Service on Exascale Infrastructure para obter instruções sobre como estabelecer uma conexão segura.
Exemplo 6-58 dbaascli tde removeSecondaryHsmKey
dbaascli tde removeSecondaryHsmKey --dbname dbname
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs
Tópico principal: Referência de Comando do dbaascli
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>]
}
--dbnameespecifica o nome do Oracle Database--rotateMasterKeyOnAllPDBsespecificatruepara rotacionar a chave principal de todos os PDBs no CDB. Valores válidos:true|false--pdbNameespecifica o nome do PDB--executePrereqsexecuta as verificações de pré-requisitos e reporta os resultados--resumeespecifica a retomada da execução anterior-
--sessionIDespecifica para retomar um ID de sessão específico -
--prepareStandbyBlobespecificatruepara gerar um arquivo BLOB contendo os artefatos necessários para executar a operação em um ambiente do Data Guard -
--blobLocationespecifica o local do diretório personalizado no qual o arquivo BLOB stand-by será gerado em um ambiente do Data Guard --standbyBlobFromPrimaryespecifica 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?
- Execute o comando como usuário
root. - Certifique-se de que o banco de dados esteja configurado corretamente para TDE.
P: O que o parâmetro --dbname especifica?
R: O parâmetro --dbname especifica o nome do Oracle Database para o qual você deseja rotacionar a chave de criptografia principal.
P: Qual é a finalidade do parâmetro --rotateMasterKeyOnAllPDBs?
A: O parâmetro --rotateMasterKeyOnAllPDBs especifica se a chave principal deve ser rotacionada para todos os PDBs (Bancos de Dados Plugáveis) em um CDB (Banco de Dados Contêiner). Os valores válidos são verdadeiro ou falso.
P: O que o parâmetro --pdbName faz?
R: O parâmetro --pdbName especifica o nome de um PDB (Banco de Dados Plugável) específico se você quiser rotacionar a chave principal de um PDB específico em vez de todos os PDBs.
P: O que o parâmetro --executePrereqs faz?
R: O parâmetro --executePrereqs executa verificações de pré-requisitos para validar se o ambiente está pronto para a rotação da chave mestra sem executar a rotação real.
P: O que o parâmetro --resume especifica?
R: O parâmetro --resume é usado para retomar uma operação iniciada anteriormente. Você também pode fornecer um ID de sessão específico usando --sessionID para retomar uma sessão específica.
P: Qual é a finalidade do parâmetro --prepareStandbyBlob?
R: O parâmetro --prepareStandbyBlob, se definido como verdadeiro, gera um arquivo BLOB contendo os artefatos necessários para executar a rotação da chave principal em um ambiente do Data Guard.
P: O que o parâmetro --blobLocation faz?
A: O parâmetro --blobLocation especifica um caminho de diretório personalizado no qual o arquivo BLOB stand-by será gerado. Isso é aplicável quando --prepareStandbyBlob é definido como true.
P: O que o parâmetro --standbyBlobFromPrimary especifica?
R: O parâmetro --standbyBlobFromPrimary especifica a localização do arquivo BLOB stand-by que foi gerado com base no banco de dados principal. Esse parâmetro é usado ao executar a rotação de chave mestra em um banco de dados stand-by em um ambiente do Data Guard.
P: O parâmetro --rotateMasterKeyOnAllPDBs é obrigatório?
A: Não, o parâmetro --rotateMasterKeyOnAllPDBs é opcional. Se ela não for especificada, a chave mestra só será rotacionada para o banco de dados (ou PDB específico) fornecido nos parâmetros --dbname ou --pdbName.
P: O parâmetro --pdbName será necessário se eu estiver rotacionando chaves para um CDB?
R: Não, o parâmetro --pdbName só será necessário se você quiser rotacionar a chave mestra de um PDB (Banco de Dados Plugável) específico. É opcional ao girar a chave de todo o CDB.
P: Preciso usar os parâmetros --prepareStandbyBlob e --standbyBlobFromPrimary para bancos de dados stand-alone?
R: Não, esses parâmetros só são relevantes em um ambiente do Data Guard em que um banco de dados stand-by está envolvido.
P: Como posso rotacionar a chave principal de todos os PDBs em um CDB?
R: Você deve usar o parâmetro --rotateMasterKeyOnAllPDBs definido como verdadeiro para rotacionar a chave principal de todos os PDBs no CDB. Por exemplo:
dbaascli tde rotateMasterKey --dbname CDB_NAME --rotateMasterKeyOnAllPDBs true
P: Como faço para executar uma verificação para validar se o sistema está pronto para a rotação da chave principal sem executar a operação real?
R: Você pode usar o parâmetro --executePrereqs para executar as verificações de pré-requisitos. Isso reportará quaisquer problemas que possam impedir a rotação da chave mestra:
dbaascli tde rotateMasterKey --dbname DB_NAME --executePrereqs
P: O que devo fazer se a operação for interrompida e eu quiser retomá-la?
R: Você pode usar o parâmetro --resume para retomar a operação interrompida anteriormente. Se você tiver um ID de sessão, forneça-o com o parâmetro --sessionID:
dbaascli tde rotateMasterKey --dbname DB_NAME --resume --sessionID <value>
P: Como posso me preparar para a rotação de chaves em um ambiente do Data Guard?
A: Você deve usar o parâmetro --prepareStandbyBlob para gerar um arquivo BLOB que contenha os artefatos necessários para rotacionar a chave principal em um ambiente stand-by:
dbaascli tde rotateMasterKey --dbname DB_NAME --prepareStandbyBlob true --blobLocation /path/to/blob
P: Como aplicar o arquivo BLOB stand-by do banco de dados principal ao rotacionar chaves em um banco de dados stand-by?
A: Use o parâmetro --standbyBlobFromPrimary para especificar o local do arquivo BLOB que foi preparado no banco de dados principal:
dbaascli tde rotateMasterKey --dbname DB_NAME --standbyBlobFromPrimary /path/to/blob
P: O que devo verificar se a rotação da chave mestra falha?
- 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
--executePrereqspara 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.
Tópico principal: Referência de Comando do dbaascli
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>]
--kmsKeyVersionOCIDespecifica o OCID da versão da chave KMS a ser definido.--dbnameespecifica o nome do banco de dados.--pdbNamenome do PDB para usar o OCID da versão da chave.--masterKeyIDespecifica o ID da chave principal do OCID da versão da chave informada. Isso se aplica ao ambiente do Data Guard.--standbySucespecifica 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.--waitForCompletionespecificafalsepara executar a operação em segundo plano. Valores válidos:true|false
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli tde setKeyVersion?
R: O comando dbaascli tde setKeyVersion é usado para definir a versão da chave de criptografia primária que deve ser usada para Criptografia Transparente de Dados (TDE) em um banco de dados ou Banco de Dados Plugável (PDB). Isso permite que a versão específica de uma chave KMS seja designada ao banco de dados.
P: Quais são os pré-requisitos para usar o comando dbaascli tde setKeyVersion?
R: Execute o comando como usuário root e certifique-se de estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: O que o parâmetro --kmsKeyVersionOCID especifica?
A: O parâmetro --kmsKeyVersionOCID especifica o OCID (Oracle Cloud Identifier) da versão da chave KMS que você deseja definir para o banco de dados ou o PDB.
P: O que o parâmetro --dbname especifica?
A: O parâmetro --dbname especifica o nome do Oracle Database para o qual a versão da chave será definida.
P: Qual é a finalidade do parâmetro --pdbName?
R: O parâmetro --pdbName especifica o nome do PDB (Banco de Dados Plugável) em um CDB (Banco de Dados Contêiner) no qual você deseja definir a versão da chave KMS específica.
P: Para que o parâmetro --masterKeyID é usado?
A: O parâmetro --masterKeyID especifica o ID da chave mestra associado ao OCID da versão da chave KMS fornecido. Isso é particularmente importante em um ambiente do Data Guard.
P: Qual é a atribuição do parâmetro --standbySuc?
A: O parâmetro --standbySuc é usado em um ambiente do Data Guard. Especifica que essa propriedade deve ser definida no banco de dados principal após a execução bem-sucedida do comando no banco de dados stand-by.
P: O que o parâmetro --executePrereqs faz?
R: O parâmetro --executePrereqs especifica se as verificações de pré-requisitos devem ser executadas antes da execução da operação. Os valores válidos são yes ou no.
P: O que o parâmetro --waitForCompletion controla?
R: O parâmetro --waitForCompletion determina se a operação será executada de forma síncrona (aguardando conclusão) ou assíncrona (em segundo plano). Os valores válidos são true ou false.
P: O parâmetro --pdbName é necessário se a versão da chave for definida para um CDB?
R: Não, o parâmetro --pdbName só será necessário se você estiver definindo a versão da chave para um PDB (Banco de Dados Plugável) específico. É opcional se você estiver definindo a versão da chave para todo o Banco de Dados Contêiner (CDB).
P: O parâmetro --masterKeyID é necessário para ambientes que não são do Data Guard?
R: Não, o parâmetro --masterKeyID geralmente só é usado em ambientes do Data Guard. Para bancos de dados independentes, esse parâmetro não é necessário.
P: Como defino a versão da chave para um banco de dados?
A: Você pode definir a versão da chave para um banco de dados executando:
dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME>
P: Como defino a versão da chave para um PDB específico?
A: Para definir a versão da chave para um PDB (Banco de Dados Plugável) específico, use o parâmetro --pdbName com o nome do banco de dados:
dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME> --pdbName <PDB_NAME>
P: Como posso garantir que todos os pré-requisitos sejam atendidos antes de definir a versão da chave?
A: Você pode executar as verificações de pré-requisitos usando o parâmetro --executePrereqs:
dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --executePrereqs yes
P: Como defino a versão da chave em um ambiente do Data Guard?
- 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?
- 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
--executePrereqspara garantir a prontidão. Revise os logs de erro para obter detalhes específicos e execute novamente a operação, se necessário.
P: O que devo verificar se a operação não foi concluída com sucesso em um ambiente do Data Guard?
R: Certifique-se de que o parâmetro --masterKeyID esteja especificado corretamente ao executar o comando no banco de dados stand-by. Uma vez concluído no stand-by, o parâmetro --standbySuc deverá ser usado ao executar o comando no banco de dados principal.
P: Posso executar o comando dbaascli tde setKeyVersion enquanto o banco de dados está em execução?
R: Sim, o comando pode ser executado enquanto o banco de dados está em execução. No entanto, é recomendável executar as verificações de pré-requisitos antecipadamente usando --executePrereqs.
P: Por que é importante definir a versão correta da chave KMS para um banco de dados?
A definição da versão correta da chave KMS garante que o banco de dados esteja usando a versão apropriada da chave de criptografia para TDE, o que ajuda a manter a segurança dos dados e a conformidade com as políticas organizacionais.
P: O que acontece se eu usar o OCID errado da versão da chave KMS?
R: Se um OCID incorreto da versão da chave KMS for usado, a criptografia poderá falhar e o banco de dados não poderá usar a chave incorreta para operações de criptografia. Certifique-se de que o OCID correto da versão da chave seja fornecido.
P: Preciso reiniciar o banco de dados após definir a versão da chave?
R: Não, a reinicialização do banco de dados não é necessária após definir a versão da chave. A nova versão da chave entrará em vigor imediatamente sem exigir uma reinicialização.
Exemplo 6-59 dbaascli tde setKeyVersion
dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha --executePrereqs
dbaascli tde setKeyVersion --dbname dbname --pdbName pdb --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
Tópico principal: Referência de Comando do dbaascli
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>]]
--primaryKmsKeyOCIDespecifica a chave KMS primária a ser definida--dbnameespecifica 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.--bounceDatabaseespecifica 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.--resumepara retomar a execução anterior-
--sessionIDpara 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?
- Você o está executando como o usuário
root. - Os valores
--primaryKmsKeyOCIDe--dbnamecorretos são fornecidos. - O ambiente passa por todas as verificações de pré-requisitos (executado com
--precheckOnly).
P: E se a operação falhar em um ambiente do Data Guard?
R: Certifique-se de que o comando tenha sido executado com sucesso no banco de dados stand-by antes de executá-lo no principal. Verifique se há erros nos logs e execute novamente a operação com os parâmetros corretos.
P: Posso executar o comando dbaascli tde setPrimaryHsmKey em um banco de dados ativo?
R: Sim, o comando pode ser executado enquanto o banco de dados estiver ativo. No entanto, o uso do parâmetro --bounceDatabase reiniciará o banco de dados de forma incremental, o que minimiza o impacto.
P: Como faço para executar o comando de forma contínua para evitar tempo de inatividade completo?
A: Use o parâmetro --bounceDatabase para executar uma reinicialização incremental do banco de dados ao alterar a chave KMS principal:
dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --bounceDatabase
P: Qual é o significado de alterar a chave KMS primária?
R: A alteração da chave KMS principal garante que o banco de dados use uma chave de criptografia atualizada ou diferente para TDE (Transparent Data Encryption). Isso pode ser necessário por motivos de segurança ou conformidade.
P: Com que frequência a chave KMS primária deve ser girada ou alterada?
R: Embora não haja uma regra estrita, as organizações podem rotacionar a chave KMS principal com base em políticas de segurança, como intervalos de rotação de chaves ou requisitos de conformidade.
P: O que acontece se a chave KMS principal estiver definida incorretamente?
R: Se o OCID da chave incorreta for definido, as operações de criptografia do banco de dados poderão falhar e talvez você precise reverter para a chave correta ou retificar a configuração definindo o OCID da chave KMS correta.
P: Preciso reiniciar o banco de dados depois de alterar a chave KMS principal?
R: Não, você não precisa reiniciar o banco de dados, a menos que opte por usar o parâmetro --bounceDatabase, que reiniciará automaticamente o banco de dados para aplicar a alteração.
Exemplo 6-60 dbaascli tde setPrimaryHsmKey
dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs
Tópico principal: Referência de Comando do 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
--dbnameespecifica o nome do banco de dados que você deseja verificar.
A saída do comando inclui o tipo e o status do armazenamento de chaves.
Perguntas Frequentes
P: O que o comando dbaascli tde status faz?
A: O comando dbaascli tde status exibe informações sobre o armazenamento de chaves de um banco de dados especificado. Isso inclui detalhes sobre o tipo de armazenamento de chaves e seu status.
P: Quem deve executar o comando dbaascli tde status?
A: O comando deve ser executado como o usuário oracle.
P: Onde o comando dbaascli tde status deve ser executado?
R: O comando deve ser executado em uma máquina virtual do Exadata Cloud@Customer. Você deve se conectar à máquina virtual via SSH para executar o utilitário.
P: Qual é a função do parâmetro --dbname?
R: O parâmetro --dbname especifica o nome do banco de dados para o qual o status da área de armazenamento de chaves de TDE será verificado.
P: Quais informações o comando dbaascli tde status retorna?
A: A saída do comando inclui o tipo de armazenamento de chaves (por exemplo, baseado em HSM ou baseado em arquivo) e o status atual do armazenamento de chaves, como se ele está aberto, fechado ou em algum outro estado.
P: Como posso saber se a área de armazenamento de chaves está aberta ou fechada usando o comando dbaascli tde status?
R: O status da área de armazenamento de chaves, incluindo se ela está aberta ou fechada, faz parte da saída retornada pelo comando dbaascli tde status.
P: Como verifico o status do armazenamento de chaves de TDE de um banco de dados específico?
A: Para verificar o status da área de armazenamento de chaves de TDE para um banco de dados específico, execute:
dbaascli tde status --dbname <DB_NAME>
P: Posso verificar o status da área de armazenamento de chaves para vários bancos de dados?
R: Sim, mas você precisa executar o comando separadamente para cada banco de dados, especificando seu nome usando o parâmetro --dbname.
P: O comando dbaascli tde status pode ser executado como usuário raiz?
R: Não, o comando deve ser executado como o usuário oracle, não como o usuário root.
P: Preciso de permissões especiais para executar o comando dbaascli tde status?
R: Sim, você precisa ter privilégios de usuário oracle e estar conectado a uma máquina virtual do Exadata Cloud@Customer para executar o comando.
P: O que devo fazer se obtiver um erro ao executar o comando de status dbaascli tde?
R: Certifique-se de que esteja executando o comando como o usuário oracle e verifique se você tem as permissões necessárias e se está conectado à máquina virtual correta.
P: Como sei que tipo de armazenamento de chaves meu banco de dados está usando?
R: O tipo de armazenamento de chaves, como se fosse baseado em arquivo ou HSM/KMS, é exibido na saída do comando dbaascli tde status.
P: O que devo fazer se a área de armazenamento de chaves estiver fechada?
R: Se a área de armazenamento de chaves estiver fechada, talvez seja necessário abri-la manualmente, dependendo da operação que você está tentando executar. O processo exato dependerá do tipo de armazenamento de chaves e do seu ambiente.
P: Posso exibir o status da área de armazenamento de chaves de um CDB (Banco de Dados Contêiner) ou PDB (Banco de Dados Plugável)?
R: Sim, especificando o nome do banco de dados apropriado usando o parâmetro --dbname, você pode exibir o status do armazenamento de chaves para CDBs e PDBs.
P: O que significa se o comando retornar um erro sobre a conectividade do banco de dados?
R: Isso pode indicar um problema com a conexão com o banco de dados ou um problema com seu ambiente. Certifique-se de que o banco de dados esteja em execução e acessível e verifique sua conexão SSH com a máquina virtual do Exadata Cloud@Customer.
P: O que acontece se o nome do banco de dados estiver incorreto?
R: Se o parâmetro --dbname especificar um banco de dados incorreto ou não existente, o comando falhará e você receberá uma mensagem de erro indicando o problema.
P: Como solucionar problemas se o status da área de armazenamento de chaves indicar um estado inesperado?
R: Se o status da área de armazenamento de chaves indicar um estado inesperado, revise os logs do banco de dados para obter mais detalhes e verifique a configuração da área de armazenamento de chaves para garantir que ela esteja configurada corretamente.
P: Posso automatizar a verificação do status da área de armazenamento de chaves para fins de monitoramento?
R: Sim, você pode criar script do comando dbaascli tde status para verificar o status do armazenamento de chaves periodicamente ou integrá-lo às suas ferramentas de monitoramento de banco de dados.
P: Como verifico se a Criptografia Transparente de Dados (TDE) está ativada corretamente?
R: Você pode verificar se a TDE está ativada corretamente verificando o status do armazenamento de chaves usando o comando dbaascli tde status. Uma área de armazenamento de chaves válida e aberta indica que a TDE está configurada corretamente.
Exemplo 6-61 dbaascli tde status
dbaascli tde status --dbname dbname
Tópico principal: Referência de Comando do dbaascli