Usando o Utilitário dbaascli com o Oracle Exadata Database Service on Cloud@Customer
Aprenda a usar o utilitário dbaascli
no Oracle Exadata Database Service on Cloud@Customer.
- Sobre o Uso do Utilitário dbaascli no Oracle Exadata Database Service on Cloud@Customer
Você pode usar o utilitáriodbaascli
para executar várias operações de ciclo de vida e administração do banco de dados no Oracle Exadata Database Service on Cloud@Customer, como criar um Oracle Database, aplicar patch a um Oracle Database, gerenciar bancos de dados plugáveis (PDBs), dimensionar a contagem de núcleos de CPU no modo desconectado e muito mais. - Criando o Banco de Dados Oracle com o Utilitário 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 on Cloud@Customer com o Utilitário Dbaascli
Você pode listar e fazer download das imagens de software do banco de dados Oracle em uma instância do Oracle Exadata Database Service on Cloud@Customer, que depois podem ser usadas para provisionar um home de banco de dados. - Aplicando Patch no Grid Infrastructure e em Bancos de Dados Oracle com o Utilitário dbaascli
Aprenda a usar o utilitáriodbaascli
para executar operações de aplicação de patch no Oracle Grid Infrastructure e no Banco de Dados Oracle em um sistema Exadata Cloud@Customer. - 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 on Cloud@Customer, execute este procedimento. - Criando um Banco de Dados Duplicado
- Notas da Release
Confira as alterações feitas em várias releases dodbaascli
. - Referência de Comando dbaascli
Usedbaascli
para criar bancos de dados e integrá-los ao framework de automação da nuvem.
Tópico principal: Guias de Referência do Oracle Exadata Database Service on Cloud@Customer
Sobre o Uso do Utilitário dbaascli no Oracle Exadata Database Service on Cloud@Customer
Você pode usar o utilitário dbaascli
para executar várias operações de ciclo de vida e administração do banco de dados no Oracle Exadata Database Service on Cloud@Customer, como criar um Oracle Database, aplicar patches a um Oracle Database, gerenciar bancos de dados plugáveis (PDBs), dimensionar a contagem de núcleos de CPU em modo desconectado e muito mais.
Use a console do DBaaS ou a interface de linha de comando para dimensionar recursos. Os recursos do utilitário dbaascli
são adicionais e distintos na Console, na API ou na interface de linha de comando (CLI) do Oracle Cloud Infrastructure. A menos que especificado de forma diferente, você precisará de acesso root
ao dbaascli
para executar todos os comandos de administração.
Para usar o utilitário, você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer. Consulte Estabelecendo Conexão com uma Máquina Virtual com SSH.
Para obter os comandos possíveis disponíveis com o dbaascli
, execute dbaascli --help
.
Para obter ajuda específica do comando, execute dbaascli command --help
. Por exemplo, dbaascli database create --help
.
Criando o Banco de Dados Oracle com o Utilitário dbaascli
Usando o dbaascli
, você pode criar um Banco de Dados Oracle criando primeiramente um home de banco de dados Oracle da versão desejada, seguido pela criação de um banco de dados nesse home.
- Listando Imagens e Versões de Software Disponíveis para Banco de Dados
Para obter uma lista das versões suportadas disponíveis para criação do Banco de Dados Oracle, 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
Para obter uma lista das versões suportadas disponíveis para criar o Banco de Dados Oracle, 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
A saída do comando lista as imagens de software de banco de dados disponíveis.
- Saia do shell de comando do usuário
root
:exit
Para obter mais detalhes sobre opções avançadas suportadas, consulte
dbaascli cswlib showImages
.
Exemplo 7-1 dbaascli cswlib showImages
dbaascli cswlib showImages
DBAAS CLI version MAIN Executing command cswlib showImages
INFO : Log file => /var/opt/oracle/log/list/list_2021-05-10_10:11:00.56966610630.log
############ List of Available DB Images #############
1.IMAGE_TAG=19.8.0.0.0
VERSION=19.8.0.0.0
DESCRIPTION=19c JUL 2020 DB Image
IMAGE_ALIASES=19000-19800,19000-JUL2020
2.IMAGE_TAG=19.8.0.0.0-NC
VERSION=19.8.0.0.0
DESCRIPTION=19c JUL 2020 Non CDB Image
IMAGE_ALIASES=19000-NC19800,19000-NCJUL2020
3.IMAGE_TAG=19.9.0.0.0
VERSION=19.9.0.0.0
DESCRIPTION=19c OCT 2020 DB Image
IMAGE_ALIASES=19000-19900,19000-OCT2020
4.IMAGE_TAG=19.9.0.0.0-NC
VERSION=19.9.0.0.0
DESCRIPTION=19c OCT 2020 Non CDB Image
IMAGE_ALIASES=19000-NC19900,19000-NCOCT2020
Você pode especificar a versão de destino no comando
dbaascli dbhome create
como valor --version
da saída do comando dbaascli cswlib showImages
.
Tópicos Relacionados
Tópico principal: Criando o Banco de Dados Oracle com o Utilitário 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 Value
Em que:--version
especifica a versão do Oracle Database--imageTag
especifica a Tag da Imagem a ser usada
Por exemplo:dbaascli dbhome create --version 19.9.0.0.0
Observação
A especificação 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
:exit
Para obter mais detalhes sobre opções avançadas suportadas, consulte
dbaascli dbhome create
.
Tópicos Relacionados
Tópico principal: Criando o Banco de Dados Oracle com o Utilitário 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. - Crie o Oracle Database versão 12.1.0.2 ou superior com a atualização de release JAN 2021 ou superior. Para bancos de dados com versões inferiores, recomenda-se usar a API baseada na Console do OCI.
- 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
Em que:--dbName
especifica o nome do banco de dados--oracleHome
especifica o local do Oracle home
Para criar um CDB, execute o seguinte comando:dbaascli database create --dbName database name --oracleHome Oracle Home Path
Para criar um não CDB, execute o seguinte comando:dbaascli database create --dbName database name --oracleHome Oracle Home Path --createAsCDB false
Quando solicitado, digite as senhas
sys
etde
. - Saia do shell de comando do usuário
root
:exit
Para obter mais detalhes sobre opções avançadas suportadas, consulte
dbaascli database create
.
- Executando Verificações de Pré-requisitos antes de Criar o Banco de Dados Oracle
Para executar verificações de pré-requisitos, use a opção de comando--executePrereqs
. Isso executará apenas as verificações de pré-requisitos sem executar a criação real do Banco de Dados Oracle. - 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
.
Tópicos Relacionados
Tópico principal: Criando o Banco de Dados Oracle com o Utilitário 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 --executePrereqs
Em que:--dbName
especifica o nome do banco de dados--oracleHome
especifica o local do Oracle home
- Saia do shell de comando do usuário
root
:exit
Para obter mais detalhes sobre opções avançadas suportadas, consulte
dbaascli database create
.
Tópicos Relacionados
Tópico principal: Criando 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
--resume
ou--revert
, certifique-se de usar o mesmo comando do mesmo nó que foi usado para o fluxo da operação de criação real. - Você só poderá retomar a criação do banco de dados se houver uma falha na etapa de pós-criação do banco de dados.
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 Exadata Database Service on Cloud@Customer é definida como senha das credenciais SYS, SYSTEM, wallet de TDE e administrador do PDB. Use os procedimentos a seguir se precisar alterar as senhas de um banco de dados existente.
se você estiver ativando o Data Guard para um banco de dados, a senha SYS e a da wallet de TDE dos bancos de dados principal e standby deverão ser iguais.
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 on Cloud@Customer com o Utilitário Dbaascli
Você pode listar e fazer download das imagens de software do banco de dados Oracle em uma instância do Oracle Exadata Database Service on Cloud@Customer, que depois podem ser usadas para provisionar um home de banco de dados.
Você pode criar imagens de software de banco de dados personalizadas para suas instâncias do Oracle Exadata Database Service on Cloud@Customer usando a Console ou a API. Essas imagens são armazenadas no serviço Object Storage e podem ser usadas para provisionar um Home de Banco de Dados na instância do Exadata. Consulte Imagens de Software do Oracle Database para obter mais informações.
Você pode controlar a versão de binários Oracle que são instalados quando você provisiona um novo banco de dados em uma instância do Oracle Exadata Database Service on Cloud@Customer mantendo as imagens de software no sistema. A Oracle fornece uma biblioteca de imagens de software na nuvem que você pode exibir e submeter a download para sua instância usando o utilitário dbaascli
.
- Listando Imagens e Versões de Software Disponíveis para o Banco de Dados e o Grid Infrastructure
Para produzir uma lista de versões suportadas disponíveis para aplicação de patch, use o comandodbaascli cswlib showImages
. - Para fazer download de uma imagem de software
Você pode fazer download de imagens de software disponíveis para sua instância do Oracle Exadata Database Service on Cloud@Customer usando o subcomandocswlib download
do 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 database
A saída do comando lista as imagens de software de banco de dados disponíveis.
dbaascli cswlib showImages --product grid
A saída do comando lista as imagens de software de grade disponíveis.
- Saia do shell de comando do usuário
root
:exit
Para obter mais detalhes sobre opções avançadas suportadas, consulte
dbaascli cswlib showImages
.
Exemplo 7-2 dbaascli cswlib showImages
[root@dg11lrg1 dbhome_1]# dbaascli cswlib showImages
DBAAS CLI version <version>
Executing command cswlib
showImagesJob id: 00e89b1a-1607-422c-a920-22f44bec1953Log file location:
/var/opt/oracle/log/cswLib/showImages/dbaastools_2022-05-11_08-49-12-AM_46941.log
############
List of Available Database Images
#############
17.IMAGE_TAG=18.17.0.0.0
VERSION=18.17.0.0.0
DESCRIPTION=18c JAN 2022 DB Image
18.IMAGE_TAG=19.10.0.0.0
VERSION=19.10.0.0.0
DESCRIPTION=19c JAN 2021 DB Image
19.IMAGE_TAG=19.11.0.0.0
VERSION=19.11.0.0.0
DESCRIPTION=19c APR 2021 DB Image
20.IMAGE_TAG=19.12.0.0.0
VERSION=19.12.0.0.0
DESCRIPTION=19c JUL 2021 DB Image
21.IMAGE_TAG=19.13.0.0.0
VERSION=19.13.0.0.0
DESCRIPTION=19c OCT 2021 DB Image
Images can be downloaded using their image tags. For details, see help using 'dbaascli cswlib download --help'.
dbaascli execution completed
Aplicando Patch no Oracle Grid Infrastructure e em Bancos de Dados Oracle com o Utilitário dbaascli
Aprenda a usar o utilitário dbaascli
para executar operações de aplicação de patch no Oracle Grid Infrastructure e no Banco de Dados Oracle em um sistema Exadata Cloud@Customer.
- Aplicando Patch em Bancos de Dados com o Utilitário dbaascli
Usando odbaascli
, você pode optar por aplicar patch em um banco de dados, aplicando patch no Oracle home ou movendo o banco de dados para um Oracle home com o nível de patch desejado. - Aplicando Patch no Oracle Grid Infrastructure
Para aplicar um patch no Oracle Grid Infrastructure, use o comandogrid patch
. - 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
. - Executando uma Pré-verificação antes de Aplicar Patch em Bancos de Dados e no Grid Infrastructure
Você pode executar uma operação de verificação de pré-requisitos (também chamada de "pré-verificação") para os comandos deste tópico usando o flag de pré-verificação aplicável. - Retomando ou Fazendo Rollback de uma Operação de Aplicação de Patch
Você pode retomar ou reverter uma operação de aplicação de patch com falha. A reversão de um patch é conhecida como rollback.
Aplicando Patch em Bancos de Dados com o utilitário dbaascli
Com o utilitário o dbaascli
, você pode optar por aplicar patch em um banco de dados, aplicando patch no Oracle home ou movendo o banco de dados para um Oracle home com o nível de patch desejado.
- Aplicando patch em um Oracle home (aplicação de patch no local). Isso atualiza todos os bancos de dados localizados no Oracle home.
- Movendo um banco de dados para outro Oracle home que tenha a versão desejada do software Oracle Database (aplicação de patch fora do local).
- Aplicando Patch em um Home de Banco de Dados (Aplicação de Patch de Banco de Dados no Local)
Para aplicar patch em um Oracle home, use o comandodbaascli dbHome patch
. - Movendo um Banco de Dados para Outro Oracle Home (Aplicação de Patch Fora do Local)
Para aplicar patch em um Banco de Dados Oracle movendo-o para um Oracle home que já esteja no nível de patch desejado, use o comandodbaascli database move
.
Aplicando Patch em um Home de Banco de Dados (Aplicação de Patch de Banco de Dados no Local)
Para aplicar patch em um Oracle home, use o comando dbaascli dbHome patch
.
dbHome patch
para operações de aplicação de patch no local:
- Você pode aplicar patch em todos os nós de banco de dados ou em um subconjunto de nós.
- A aplicação de patches de vários nós ocorre de maneira incremental.
- Se preferir, você poderá executar uma operação de patch somente para software. Assim, quando estiver pronto, poderá executar
datapatch
para executar ações SQL pós-patch. - Você pode aplicar patch em um Oracle home contendo um ou mais bancos de dados.
Para aplicar patch em um Oracle Home (dbhome):
- 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 patch --oracleHome dbhome_path --targetVersion Oracle_Database_version
Em que:--oracleHome
identifica o caminho do Oracle home a receber o patch.--targetVersion
especifica a versão do Oracle Database de destino a ser usada para aplicação de patch, especificada como cinco segmentos numéricos separados por pontos (por exemplo, 19.12.0.0.0).
Por exemplo:dbaascli dbhome patch --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --targetVersion 19.9.0.0.0
- Saia do shell de comando do usuário
root
:exit
Para obter mais detalhes sobre opções avançadas suportadas, consulte
dbaascli dbHome patch
.
Tópicos Relacionados
Tópico principal: Aplicando Patch em Bancos de Dados com o utilitário dbaascli
Movendo um Banco de Dados para Outro Oracle Home (Aplicação de Patch Fora do Local)
Para aplicar patch em um Banco de Dados Oracle movendo-o para um Oracle home que já esteja no nível de patch desejado, use o comando dbaascli database move
.
Depois que a operação de movimentação do banco de dados é concluída, o banco de dados é executado usando a versão do software Oracle Database do Oracle Home de destino.
Para aplicar patch em um banco de dados movendo-o para outro Oracle Home:
- 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 move --oracleHome path_to_target_oracle_home --dbname database_name
Em que:--oracleHome
identifica o caminho do Oracle home de destino que usa a versão desejada do software Oracle Database. Observe que o Oracle home de destino deve existir no sistema antes de usar o comandodatabase move
.--dbname
especifica o nome do banco de dados que está sendo movido.
Por exemplo:dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --dbname xyz
- Saia do shell de comando do usuário
root
:exit
Para obter mais detalhes sobre opções avançadas suportadas, consulte
dbaascli database move
.
Tópicos Relacionados
Tópico principal: Aplicando Patch em Bancos de Dados com o utilitário dbaascli
Aplicando Patch no Oracle Grid Infrastructure
Para aplicar um patch no Oracle Grid Infrastructure, use o comando grid patch
.
- 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 grid patch --targetVersion target_software_version_number
Em que
--targetVersion
identifica a versão do software de destino na qual o patch do Oracle Grid Infrastructure será aplicado.Por exemplo:dbaascli grid patch --targetVersion 19.11.0.0.0
- Saia do shell de comando do usuário
root
:exit
Para obter mais detalhes sobre opções avançadas suportadas, consulte
dbaascli grid patch
.
- Aplicando Patch no Oracle GI (Grid Infrastructure) Usando a Imagem do Software do GI
Para aplicar patch no Oracle GI (Grid Infrastructure) usando a imagem do software do GI, use esse procedimento.
Tópicos Relacionados
Aplicando Patch no Oracle GI (Grid Infrastructure) Usando a Imagem do Software do GI
Para aplicar patch ao Oracle GI (Grid Infrastructure) usando a imagem do software do GI, use esse procedimento.
O Oracle Grid Infrastructure também pode receber aplicação de patches primeiro criando uma imagem de software com patch e depois usando essa imagem para executar a operação de aplicação de patch. Isso oferece a vantagem de que uma imagem pode ser criada antecipadamente fora da janela de aplicação de patches. Ele também ajuda na resolução de conflitos, pois os conflitos entre os patches são destacados durante o processo de criação de imagem sem afetar a janela de aplicação de patches.
Tópico principal: Aplicando Patch no Oracle Grid Infrastructure
Listando Imagens e Versões de Software Disponíveis para o Banco de Dados e o Grid Infrastructure
Para produzir uma lista de versões suportadas disponíveis para aplicação de patch, use o comando dbaascli cswlib showImages
.
- 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 database
A saída do comando lista as imagens de software de banco de dados disponíveis.
dbaascli cswlib showImages --product grid
A saída do comando lista as imagens de software de grade disponíveis.
- Saia do shell de comando do usuário
root
:exit
Para obter mais detalhes sobre opções avançadas suportadas, consulte
dbaascli cswlib showImages
.
Exemplo 7-3 dbaascli cswlib showImages
[root@dg11lrg1 dbhome_1]# dbaascli cswlib showImages
DBAAS CLI version <version>
Executing command cswlib
showImagesJob id: 00e89b1a-1607-422c-a920-22f44bec1953Log file location:
/var/opt/oracle/log/cswLib/showImages/dbaastools_2022-05-11_08-49-12-AM_46941.log
############
List of Available Database Images
#############
17.IMAGE_TAG=18.17.0.0.0
VERSION=18.17.0.0.0
DESCRIPTION=18c JAN 2022 DB Image
18.IMAGE_TAG=19.10.0.0.0
VERSION=19.10.0.0.0
DESCRIPTION=19c JAN 2021 DB Image
19.IMAGE_TAG=19.11.0.0.0
VERSION=19.11.0.0.0
DESCRIPTION=19c APR 2021 DB Image
20.IMAGE_TAG=19.12.0.0.0
VERSION=19.12.0.0.0
DESCRIPTION=19c JUL 2021 DB Image
21.IMAGE_TAG=19.13.0.0.0
VERSION=19.13.0.0.0
DESCRIPTION=19c OCT 2021 DB Image
Images can be downloaded using their image tags. For details, see help using 'dbaascli cswlib download --help'.
dbaascli execution completed
Executando uma Pré-verificação antes de Aplicar Patch em Bancos de Dados e no Grid Infrastructure
Você pode executar uma operação de verificação de pré-requisitos (também chamada de "pré-verificação") para os comandos deste tópico usando o indicador de pré-verificação aplicável.
A execução de pré-verificações permite que você execute apenas a parte de pré-verificação da operação de aplicação de patch sem executar a aplicação de patch real. A Oracle recomenda a execução de pré-verificações para descobrir problemas de software que possam impedir o sucesso da aplicação de patch.
Para executar pré-verificações de aplicação de patch, primeiramente, conecte-se como usuário root
a uma máquina virtual na instância do Exadata Cloud@Customer.
- Pré-verificar Aplicação de Patch do Oracle Home (Aplicação de Patch no Local)
Use o flag--executePrereqs
com o comandodbaascli dbhome patch
. - Pré-verificar Aplicação de Patch de Movimentação do Banco de Dados (Aplicação de Patch Fora do Local)
Use o flag--executePrereqs
com o comandodbaascli database move
. - Pré-verificar Aplicação de Patch do Oracle Grid Infrastructure
Use o flag--executePrereqs
com o comandodbaascli grid patch
.
Pré-verificar Aplicação de Patch do Oracle Home (Aplicação de Patch no Local)
Use o flag --executePrereqs
com o comando dbaascli dbhome patch
.
- 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 patch --oracleHome dbhome_path --targetVersion Oracle_Database_version --executePrereqs
Em que:--oracleHome
identifica o caminho do Oracle home a ser pré-verificado.--targetVersion
especifica a versão do Oracle Database de destino que receberá patch, especificada como cinco segmentos numéricos separados por pontos (por exemplo, 19.12.0.0.0).
- Saia do shell de comando do usuário
root
:exit
Pré-verificar Aplicação de Patch de Movimentação do Banco de Dados (Aplicação de Patch Fora do Local)
Use o flag --executePrereqs
com o comando dbaascli database move
.
- 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 move --oracleHome path_to_target_oracle_home --dbname database_name --executePrereqs
Em que:--oracleHome
identifica o caminho do Oracle Home de destino que usa a versão desejada do software Oracle Database. Observe que o Oracle Home de destino deve existir no sistema antes de usar o comandodatabase move
.--dbname
especifica o nome do banco de dados que está sendo movido
- Saia do shell de comando do usuário
root
:exit
Pré-verificar Aplicação de Patch do Oracle Grid Infrastructure
Use o flag --executePrereqs
com o comando dbaascli grid patch
.
- 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 grid patch --targetVersion target_software_version_number --executePrereqs
Em que
--targetVersion
identifica a versão do software de destino para a qual o Oracle Grid Infrastructure receberá patches, especificada como cinco segmentos numéricos separados por pontos, por exemplo, 19.12.0.0.0 - Saia do shell de comando do usuário
root
:exit
Retomando ou Fazendo Rollback de uma Operação de Aplicação de Patch
Você pode retomar ou reverter uma operação de aplicação de patch com falha. A reversão de um patch é conhecida como rollback.
- Retomando uma Operação de Aplicação de Patch
Para retomar uma operação de aplicação de patch, use o flag--resume
com o comando de aplicação de patch original. - Fazendo Rollback de uma Operação de Patch
Use o flag--rollback
com o comando de aplicação de patch original para fazer rollback (reverter) de uma operação de aplicação de patch.
Retomando uma Operação de Aplicação de Patch
Para retomar uma operação de aplicação de patch, use o flag --resume
com o comando de aplicação de patch original.
- 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 comando de aplicação de patch original para retomar uma operação de aplicação de patch:
Por exemplo:
dbaascli dbhome patch --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --targetVersion 19.9.0.0.0 --resume
- Saia do shell de comando do usuário
root
:exit
Tópicos Relacionados
Tópico principal: Retomando ou Fazendo Rollback de uma Operação de Aplicação de Patch
Fazendo Rollback de uma Operação de Aplicação de Patch
Use o flag --rollback
com o comando de aplicação de patch original para fazer rollback (reverter) de uma operação de aplicação de patch.
- 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 comando de aplicação de patch original para fazer rollback (reverter) de uma operação de aplicação de patch:
Por exemplo:
dbaascli grid patch --targetVersion 19.11.0.0.0 --rollback
Observação
- As operações de Retomada e Rollback são suportadas para aplicação de patch do Oracle Home e do Oracle Grid Infrastructure e para operações de movimentação de banco de dados.
- Ao retomar ou fazer rollback de uma operação de aplicação de patch, execute o comando de retomada ou rollback do mesmo nó que foi usado para executar o comando de aplicação de patch original e execute o comando original com a adição do flag
--resume
ou--rollback
.
- Saia do shell de comando do usuário
root
:exit
Tópicos Relacionados
Tópico principal: Retomando ou Fazendo Rollback de uma Operação de Aplicação de Patch
Atualizando o Conjunto de Ferramentas da Nuvem com o Utilitário dbaascli
Para atualizar a release do conjunto de ferramentas da nuvem no Oracle Exadata Database Service on Cloud@Customer, conclua este procedimento.
O conjunto de ferramentas específico da nuvem é usado nas VMs Convidadas do Exadata Cloud@Customer para operações locais, incluindo os comandos dbaascli
.
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 updateStack
O comando faz a atualização da release do conjunto de ferramentas da nuvem em todos os nós do cluster.
Para obter mais detalhes e outras opções disponíveis, consulte
dbaascli admin updateStack --help
.
Criando um Banco de Dados Duplicado
Usando dbaascli para Duplicar um Banco de Dados da Nuvem
Você pode criar um banco de dados duplicado usando dbaascli
. Esse novo banco de dados pode estar na mesma região de nuvem que a região de origem ou entre as regiões. As etapas a seguir descrevem como criar um banco de dados duplicado na nuvem.
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
Duplicar um Banco de Dados Local
Usando dbaascli
, você pode duplicar um banco de dados local na nuvem. Isso pode ser feito com o comando dbaascli database duplicate
. Esse comando cria um novo banco de dados na nuvem, que é uma duplicata de um banco de dados local junto com seus dados. Enquanto esse processo está acontecendo, o banco de dados on-premises continua operacional. Você pode migrar seus aplicativos para o banco de dados duplicado na nuvem após a devida verificação.
Preparar para duplicação
- Certifique-se de que haja uma configuração de caminho de rede para acessar um banco de dados on-premises do nó do OCI por meio da string
EZConnect
. - Se um banco de dados local estiver configurado com TDE, copie o arquivo da wallet de TDE (
ewallet.p12
) para o nó do OCI, no qual você decide executar o comandodbaascli
. - Crie um Oracle home no nó do OCI, se necessário. A versão do Oracle home deve ser a mesma da origem ou de uma versão de RU mais alta.
Verificar os RPMs necessários
Esse processo requer uma versão de RPM dbaastools
mínima de 23.3.2.0.0, mas a atualização para o RPM dbaastools
mais recente é sempre recomendada.
- Para verificar a versão instalada atualmente, execute:
dbaascli --version DBAAS CLI version 23.3.2.0.0
- Para aplicar o RPM de ferramentas mais recente, como usuário
root
, execute:# dbaascli admin updateStack
Executar as verificações de pré-requisitos
Para executar as verificações de pré-requisito, use a opção de comando --executePrereqs
. Isso só executará as verificações de pré-requisitos sem executar a duplicação real do Oracle Database.
dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --executePrereqs
Duplicar o banco de dados
Duplique o banco de dados usando o seguinte comando:
dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet>
Por exemplo:
dbaascli database duplicate --sourceDBConnectionString xyzhost.oracle.com:1521/dbuniquename.oracle.com --dbName orcl --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_1 --sourceDBTDEWalletLocation /tmp/wallet_copy/tde --waitForCompletion false
Após a conclusão bem-sucedida desse comando, o banco de dados é duplicado para a Nuvem e está pronto para verificações de sanidade para uso do aplicativo. Depois que a verificação for concluída, as conexões do aplicativo poderão ser migradas para o banco de dados da Nuvem.
Consulte dbaascli database duplicate –help
para obter opções de configuração adicionais.
Poucas considerações sobre migração
- Se preferir alocar vários canais para o RMAN duplicado, você poderá fazer isso especificando o argumento
--rmanParallelism
. - O Exadata Cloud Service configura a memória do banco de dados como ASM (Automatic Shared Memory Management). Se seu banco de dados local estiver configurado com gerenciamento de memória diferente, certifique-se de ajustar os valores do parâmetro de memória adequadamente no lado do OCI, fornecendo valores para
--sgaSizeInMB
e--pgaSizeInMB
. - Verifique se o banco de dados local não contém parâmetros de inicialização obsoletos ou inválidos.
- Os parâmetros de inicialização do banco de dados relacionados ao armazenamento do banco de dados (local do arquivo de dados, local de redo, destino da área de recuperação, multiplexação do arquivo de controle) podem ser alterados usando o argumento
--initParams
.Por exemplo, para substituir o valor
db_create_online_log_dest
do banco de dados duplicado:--initParams db_create_online_log_dest_1=+DATAC1,db_create_online_log_dest_2=+RECOC1
Diagnosticando e solucionando problemas de duplicação de banco de dados
- O arquivo de log da operação
dbaascli
pode ser encontrado em/var/opt/oracle/log/<dbname>/database/duplicate
- Um dos jobs da duplicata é executar
dbca
. Seu arquivo de log pode ser encontrado em/u02/app/oracle/cfgtoollogs/dbca
e/u02/app/oracle/cfgtoollogs/dbca/<dbuniquename>
.
Se a operação falhar, você terá uma opção para retomar a operação fornecendo o argumento --resume
para o mesmo comando. Como alternativa, limpe o banco de dados usando dbaascli database delete –dbname <dbname> –force
e execute novamente o comando de duplicação do banco de dados.
Tópico principal: Criando um Banco de Dados Duplicado
Notas da Release
Verifique as alterações feitas em várias releases do dbaascli
.
- Release 25.1.2.0.0 (250505)
- Release 25.1.1.0.0 (250220)
- Release 24.4.1.0.0 (241212)
- Release 24.3.2.0.0 (240912)
- Release 24.3.1.0 (240730)
- Release 24.2.1.0.0 (240620)
- Release 24.1.2.0.0 (240327, 240424, 240502)
- Release 24.1.1.0.0 (240118, 240219)
- Release 23.4.1.0 (231219)
- Release 23.3.2.0.0 (231115)
- Release 23.3.1.0.0 (230817, 231020)
- Release 23.2.1.0.0 (230708, 230724)
- Release 23.1.2.0.0 (230411, 230616)
- Release 23.1.1.0.1 (230302)
- Release 22.4.1.0.1 (221214)
- Release 22.3.1.1.0 (221003)
- Release 22.3.1.0.1 (220831)
- Release 22.2.1.1.0 (220713)
- Release 22.2.1.0.1 (220504)
- Release 22.1.1.1.0 (220301)
- Release 22.1.1.0.1 (220223)
- Release 21.4.1.1.0
- Release 21.3.1.2.0
- Release 21.3.1.1.0
- Release 21.3.1.0.1
- Versão 21.2.1.x.x
Release 25.1.2.0.0 (250505)
- Inclui AHF 25.2.4
- Inclui syslens 25.1.1.0
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 25.1.1.0.0 (250220)
- Inclui AHF 24.11.0
- Inclui syslens 24.4.2.0
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 24.4.1.0.0 (241212)
- Inclui AHF 24.9.1
- Inclui syslens 24.3.3.1
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 24.3.2.0.0 (240912)
- Inclui o AHF versão 24.7
- Inclui o syslens versão 24.3.1.0
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 24.3.1.0.0 (240730)
- Migração de TDE de
sqlnet.ora
parawallet_root
no upgrade do banco de dados para a release 19c - Patch de grade no local para usar aplicação de patch baseada em imagem como modo padrão
- Inclui o AHF versão 24.6.1
- Inclui syslens versão 24.1.2.0
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 24.2.1.0.0 (240620)
- Adicionado suporte para o Oracle Database 23ai.
- Inclui o AHF versão 24.4.3
- Inclui o syslens versão 24.1.2.0
- Várias correções de bug e melhorias de estabilidade.
Tópico principal: Notas da Release
Release 24.1.2.0.0 (240327, 240424, 240502)
- Inclui o AHF versão 24.1.1.
- Inclui o syslens versão 2.6.8.0.
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 24.1.1.0.0 (240118, 240219)
- Inclui o AHF versão 23.11.1.
- Inclui o syslens versão 2.6.4.3.
- Várias correções de bugs e melhorias de estabilidade
- (240219) Correção do Bug 36309260 aplicável ao agente DBCS versão 21.2 ou anterior: a comunicação entre o OCI Control Plane e o agente DBCS não funciona em algumas VMs.
Tópico principal: Notas da Release
Release 23.4.1.0.0 (231219)
- Inclui o AHF versão 23.9.5.
- Inclui o syslens versão 2.6.4.2.
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 23.3.2.0.0 (231115)
- Operações do Banco de Dados Plugável
- Adicionado suporte para definir o OCID da versão da chave personalizada (Bring Your Own Key - BYOK) do OCI Vault durante as operações de criação e clonagem. Para obter detalhes, consulte a ajuda dos respectivos comandos do PDB.
- Aplicação de Patch do GI (Grid Infrastructure)
- Melhorou o fluxo de trabalho de aplicação de patches para melhorar o tempo de aplicação de patches, especialmente em ambientes com alto número de bancos de dados.
- É introduzida uma nova opção
--patchInParallel
que pode ser usada para executar a aplicação de patches em nós remotos em paralelo.
- Patch do Banco de Dados
- Opção fornecida para executar o datapatch em um nó específico do cluster.
- Inclui o AHF versão 23.7.7
- Inclui syslens versão 2.3.6.10
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 23.3.1.0.0 (230817, 231020)
- Novos comandos
dbaascli
dbaascli gridHome create
- Este comando pode ser usado para criar um home do Grid Infrastructure de uma versão suportada. Para obter detalhes, consultedbaascli gridHome create --help
.dbaascli system getGridHomes
- Este comando fornece detalhes sobre os homes disponíveis do Grid Infrastructure no sistema. Para obter detalhes, consultedbaascli system getGridHomes --help
.
- Operações do Banco de Dados Plugável
- Melhorias na área do ciclo de vida do banco de dados plugável atualizável.
- Backup e Recuperação de Bancos de Dados
- Adicionado suporte para configurar backups em sites stand-by no caso de configurações do Data Guard. A configuração de backups é específica do site do Data Guard, ou seja, a alteração de atribuições (por exemplo, com a operação de switchover do Data Guard) não afetará as operações de backup do banco de dados nos sites principal ou stand-by. Os backups, se configurados no site principal ou no site stand-by, continuarão independentemente da alteração de função.
-
- Inclui o AHF versão 23.5.2 - Versão 23.3.1.0.0 (230817)
- Inclui o AHF versão 23.5.4 - Versão 23.3.1.0.0 (231020)
- Inclui syslens versão 2.3.6.9
- Várias correções de bugs e melhorias de estabilidade
- Correções críticas adicionais de produtos (231020)
Tópico principal: Notas da Release
Release 23.2.1.0.0 (230708, 230724)
- Melhorias relacionadas ao Ciclo de Vida do Banco de Dados
- Introduziu
dbaascli grid removeTCPSCert
para remover certificados TCPS expirados. Para obter detalhes, consultedbaascli grid removeTCPSCert --help
. - Opção adicionada para excluir PDBs específicos durante a duplicação do banco de dados. Para obter detalhes, consulte o argumento
skipPDBs
emdbaascli database duplicate --help
.
- Introduziu
- Backup e Recuperação de Bancos de Dados
- Alterou o padrão de
FILES_PER_SET
para 64 para backups do OSS. Isso pode ser alterado comdbaascli database backup --configure
. Para obter detalhes, consultedbaascli database backup --help
. - Os backups de log de arquivamento continuam no site stand-by após o switchover de atribuição nos ambientes do Data Guard.
- Para backups que não são gerenciados pela Oracle, as programações para backups L0 e L1 não são criadas por padrão. Eles devem ser criados explicitamente usando o comando
dbaascli database backup --configure
.
- Alterou o padrão de
-
- Inclui o AHF versão 23.3.4 - Versão 23.2.1.0.0 (230708)
- Inclui o AHF versão 23.3.5 - Versão 23.2.1.0.0 (230724)
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 23.1.2.0.0 (230411, 230616)
- Melhorias relacionadas ao Ciclo de Vida do Banco de Dados
- Opção adicionada para criar modelos de banco de dados (modelos de DBCA) para o armazenamento de objetos. Os modelos do DBCA podem ser usados subsequentemente para criar bancos de dados. Para obter detalhes, consulte
dbaascli database createTemplate --help
.
- Opção adicionada para criar modelos de banco de dados (modelos de DBCA) para o armazenamento de objetos. Os modelos do DBCA podem ser usados subsequentemente para criar bancos de dados. Para obter detalhes, consulte
- Operações do Banco de Dados Plugável
- Introduzido o comando
dbaascli pdb refresh
para atualizar um banco de dados plugável que foi criado usando a opção de atualização manual. Para obter detalhes, consultedbaascli pdb refresh --help
. - Opção adicionada para converter o banco de dados plugável atualizável em um banco de dados plugável regular. Para obter detalhes, consulte
dbaascli pdb open --help
. - A criação de um banco de dados plugável atualizável agora requer que o usuário do banco de dados de origem existente crie um link de banco de dados para o banco de dados plugável de origem. Para obter detalhes, consulte o argumento
dblinkUserName
emdbaascli pdb remoteClone --help
.
- Introduzido o comando
- Inclui o AHF versão 23.2.0
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 23.1.1.0.1 (230302)
- Melhorias relacionadas ao Ciclo de Vida do Banco de Dados
- Adicionado suporte para criar um banco de dados duplicado de um banco de dados de origem que usa o OCI Vault Services para gerenciamento de chaves de criptografia.
- Inclui o AHF versão 22.2.5
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 22.4.1.0.1 (221214)
- Operações do Banco de Dados Plugável
- Opção adicionada para não abrir o PDB no fim da realocação. Para obter detalhes, consulte o argumento
skipOpenPDB
emdbaascli pdb relocate --help
. Após usar essa opção, a realocação de pdb pode ser concluída executando o comando com o uso do argumentocompletePDBRelocate
. - Opção adicionada para limpar os metadados/serviços do PDB realocados no local de origem. Para obter detalhes, consulte o argumento
cleanupRelocatedPDB
emdbaascli pdb delete --help
- Opção adicionada para não abrir o PDB no fim da realocação. Para obter detalhes, consulte o argumento
- Novos comandos
dbaascli
dbaascli database createTemplate
- Esse comando pode ser usado para criar modelos de banco de dados (modelos DBCA) que podem ser usados subsequentemente para criar bancos de dados. Os modelos de DBCA são amplamente usados para criar um banco de dados clone com o DBCA - uma ferramenta que é fornecida com o software de servidor do Oracle Database. Para obter detalhes, consultedbaascli database createTemplate --help
- Foi introduzido
dbaascli tde rotateMasterKey
para rotacionar a chave principal para criptografia de banco de dados. Para obter detalhes, consultedbaascli tde rotateMasterKey --help
. O comandodbaascli tde rotate masterkey
agora está obsoleto.
- Melhorias relacionadas ao Ciclo de Vida do Banco de Dados
- Adicionado suporte ao uso de modelos de dbca nos workflows de criação de banco de dados. Para obter detalhes, consulte o argumento
dbcaTemplateFilePath
emdbaascli database create --help
- Melhorado o desempenho para criação de banco de dados duplicado. Para obter detalhes sobre como criar banco de dados duplicado, consulte
dbaascli database duplicate --help
- Adicionado suporte para criar um banco de dados duplicado de um banco de dados de origem que não é criptografado por TDE.
- Adicionado suporte ao uso de modelos de dbca nos workflows de criação de banco de dados. Para obter detalhes, consulte o argumento
- Gerenciamento de TDE
- Foi introduzido
dbaascli tde rotateMasterKey
para rotacionar a chave principal para criptografia de banco de dados. Para obter detalhes, consultedbaascli tde rotateMasterKey --help
. O comandodbaascli tde rotate masterkey
agora está obsoleto. - Renovado o workflow para todas as operações de TDE. Para obter detalhes, consulte
dbaascli tde --help
- Foi introduzido
- Aplicação de Patch do GI (Grid Infrastructure)
- Adicionado suporte para permitir a execução paralela da operação de aplicação de patch nos nós. Essa opção precisa ser cuidadosamente testada, visto que resulta em uma disponibilidade reduzida do banco de dados.
- Backup e Recuperação de Bancos de Dados
- Renovado o workflow para criar banco de dados usando backups independentes
- Inclui o AHF versão 22.2.4
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 22.3.1.1.0 (221003)
- Novos comandos
dbaascli
dbaascli database getDetails
- Esse comando mostra as informações detalhadas de um determinado banco de dados, por exemplo, dbname, informações do nó, informações de bancos de dados plugáveis etc. Para obter detalhes, consultedbaascli database getDetails --help
.
- Operações do Banco de Dados Plugável
- Adicionado suporte para a criação de bancos de dados plugáveis como clone atualizável usando o argumento
refreshablePDB
. Para obter detalhes, consultedbaascli pdb remoteClone --help
- Adicionado suporte para a criação de bancos de dados plugáveis como clone atualizável usando o argumento
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 22.3.1.0.1 (220831)
- Novos comandos do ciclo de vida do banco de dados
dbaascli database addInstance
- Este comando pode ser usado para adicionar uma instância de banco de dados a um dos nós do cluster no qual o banco de dados ainda não está configurado. Para obter detalhes, consultedbaascli database addInstance --help
.dbaascli database deleteInstance
- Este comando pode ser usado para excluir uma instância do banco de dados de um dos nós do cluster no qual o banco de dados está configurado. Para obter detalhes, consultedbaascli database deleteInstance --help
.dbaascli database duplicate
- Este comando pode ser usado para criar um novo banco de dados com base em um banco de dados já existente dentro de um cluster ou entre clusters, desde que exista conexão de rede entre os clusters. Para obter detalhes, consultedbaascli database duplicate --help
.
- Biblioteca de Software da Nuvem
- Introduzido o comando
dbaascli cswlib listLocal
para listar imagens submetidas a download da biblioteca de software localmente no sistema. Para obter detalhes, consultedbaascli cswlib listLocal --help
. O comandodbaascli dbimage list
agora se tornou obsoleto. - Introduzido o comando
dbaascli cswlib deleteLocal
para excluir imagens submetidas a download da biblioteca de software na nuvem. Para obter detalhes, consultedbaascli cswlib deleteLocal --help
. O comandodbaascli dbImage purge
agora se tornou obsoleto.
- Introduzido o comando
- O local do log do comando
dbaascli admin updateStack
foi alterado para seguir a convenção de outros comandosdbaascli
. Os logs podem ser convenientemente encontrados no diretório/var/opt/oracle/log/admin/updateStack
. O local anterior era/var/opt/oracle/log/tooling/Update
. - A ajuda
dbaascli
agora considera a plataforma de nuvem, na medida em que ela lista a saída de ajuda para comandos aplicáveis ao ambiente de nuvem no qual está operando. - Adicionado o suporte para alteração da senha de TDE em ambientes dataguard. Para obter detalhes, consulte
dbaascli tde changePassword --help
. Esse suporte não está disponível no momento para a versão 11.2.0.4. - Foi incluído o AHF versão 22.1.5.
- Reformulado o workflow para operação de upgrade do banco de dados.
- Reformulado o workflow para operação de criação do home do banco de dados.
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 22.2.1.1.0 (220713)
- Novos comandos
dbaascli
:dbaascli dbHome getDatabases
- Este comando lista todos os bancos de dados em execução de um determinado Oracle home do banco de dados. A saída é retornada no formato JSON para facilitar a automação. Para obter detalhes, consultedbaascli dbHome getDatabases --help
.dbaascli database getPDBs
- Este comando lista todos os bancos de dados plugáveis de um determinado banco de dados contêiner. A saída é retornada no formato JSON para facilitar a automação. Para obter detalhes, consultedbaascli database getPDBs --help
.dbaascli dbHome delete
- Este comando exclui um determinado Oracle home do banco de dados. Para obter detalhes, consultedbaascli dbHome delete --help
.dbaascli dataguard prepareStandbyBlob
- Este comando gera um arquivo blob contendo vários arquivos que são necessários no site stand-by para um ambiente do Data Guard. Para obter detalhes, consultedbaascli dataguard prepareStandbyBlob --help
.
- Aplicação de Patch no GI (Grid Infrastructure):
- Novo workflow otimizado
- Introduzida uma forma de criar a imagem do software GI (Grid Infrastructure) antes da aplicação de patch. Esta imagem do GI pode ser usada subsequentemente para executar a operação de aplicação de patch do GI. A vantagem dessa abordagem é que ela resulta em uma janela de aplicação de patch reduzida, pois a imagem já está preparada. A pilha do GI no nó não é desativada para criar a imagem. Para obter detalhes, consulte a opção
createImage
emdbaascli grid patch --help
- Introduzida uma forma de fazer a aplicação de patches do Grid Infrastructure por meio do uso de imagem de software do GI especificada pelo usuário, criada usando a opção
createImage
do comandodbaascli grid patch
. Para obter detalhes, consulte a opçãoimageLocation
emdbaascli grid patch --help
.
- Alterar suporte a Senha no ambiente do Data Guard:
- Adicionado suporte para alterar a senha em ambientes do Data Guard. Para obter detalhes, consulte
dbaascli database changePassword --help
edbaascli dataguard prepareStandbyBlob --help
- Adicionado suporte para alterar a senha em ambientes do Data Guard. Para obter detalhes, consulte
- Configuração do Data Guard:
- Adicionado suporte para atualizar Atributos de Automação do Data Guard (no arquivo
/var/opt/oracle/dg/dg.conf
). Para obter detalhes, consultedbaascli dataguard --help.
- Adicionado suporte para atualizar Atributos de Automação do Data Guard (no arquivo
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 22.2.1.0.1 (220504)
- Novos comandos
dbaascli
:- Foi introduzido o
dbaascli admin showLatestStackVersion
para mostrar a versão mais recente do dbaastools disponível para que os clientes façam download e instalem. A instalação do RPM dbaastools pode ser executada com o comandodbaascli admin updateStack
. Para obter detalhes, consulte a seção Referência de Comando dodbaascli
.
- Foi introduzido o
- Biblioteca de Software da Nuvem:
- Foi descontinuado o suporte para ativação de BP (
dbaascli cswlib activateBP
), uma vez que os BPs (Bundle Patches) agora são substituídos por RUs ("Release Updates"). A implantação na nuvem consome RUs na forma de imagens de software, identificadas comImage Tags
. Portanto, é recomendável usar tags de imagem ao estabelecer interface com os comandos da Biblioteca de Software da Nuvem (cswlib
). Para obter detalhes, consultedbaasscli cswlib download –help
. - Foi eliminada a necessidade de fazer download de imagens de não CDB para criar bancos de dados não CDB. Agora os usuários podem criar o banco de dados não CDB usando imagens comuns. Para obter detalhes, consulte a opção
createAsCDB
emdbaascli database create –help
.
- Foi descontinuado o suporte para ativação de BP (
- Criação de Banco de Dados Não CDB:
- Foi aprimorado o workflow de criação de banco de dados para criar um banco de dados não CDB usando a imagem de software de banco de dados padrão. Para obter detalhes, consulte a opção
createAsCDB
emdbaascli database create –help
.
- Foi aprimorado o workflow de criação de banco de dados para criar um banco de dados não CDB usando a imagem de software de banco de dados padrão. Para obter detalhes, consulte a opção
- Aplicação de Patch do Home do Banco de Dados:
- Novo workflow otimizado
- Upgrade do Grid Infrastructure:
- Novo workflow otimizado
- Operações do Banco de Dados Plugável (PDB):
- A exclusão do PDB nos ambientes do Data Guard exige confirmação explícita para indicar que as operações necessárias no site stand-by foram concluídas, informando o argumento adicional
–allStandByPrepared
. Para obter detalhes, consultedbaascli pdb delete --help
.
- A exclusão do PDB nos ambientes do Data Guard exige confirmação explícita para indicar que as operações necessárias no site stand-by foram concluídas, informando o argumento adicional
- É fornecida capacidade incremental para a operação de bounce do banco de dados. Para obter detalhes, consulte
dbaascli database bounce –help
. - Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 22.1.1.1.0 (220301)
- Novos comandos
dbaascli
:- Foi introduzido
dbaascli system getDBHomes
para obter todos os Oracle homes de banco de dados no cluster. A saída é retornada no formato JSON para facilitar a automação. - Foi introduzido
dbaascli dbhome getDetails
para obter informações detalhadas sobre um Oracle home específico. A saída é retornada no formato JSON para facilitar a automação.
- Foi introduzido
- Biblioteca de Software da Nuvem (cswlib):
- Foi descontinuado o suporte para o comando
dbaascli cswlib list
para operações de listagem de bibliotecas de software da nuvem. O novo comando édbaascli cswlib showImages
que lista as imagens com seuImageTag
. É recomendável usarImage tags
para fazer download das imagens na biblioteca de software da nuvem. Para obter detalhes sobre downloads usando tags de imagem, consultedbaascli cswlib download –help
. - Várias correções de bugs e melhorias de estabilidade
- Foi descontinuado o suporte para o comando
Tópico principal: Notas da Release
Release 22.1.1.0.1 (220223)
- Upgrade do Grid Infrastructure:
- Novo workflow otimizado
- Backup e Recuperação do Banco de Dados
- Atualização interna para o repositório de metadados de backup
- Foram introduzidas mensagens sobre descontinuação para comandos
bkup_api
, uma vez que agora eles são substituídos por comandosdbaascli
. Para obter detalhes, consultedbaascli database backup --help
edbaascli database recover –help
- Operações do Banco de Dados Plugável (PDB):
- Agora há suporte para a operação de realocação do PDB. Para obter detalhes, consulte
dbaascli pdb relocate –help
. - Foi reformulado o workflow para converter não CDB em PDB. Para obter detalhes, consulte
dbaascli database convertToPDB –help
.
- Agora há suporte para a operação de realocação do PDB. Para obter detalhes, consulte
- Gerenciamento de Chaves de Criptografia:
- Os parâmetros de inicialização específicos da pulsação da Criptografia Transparente de Dados (TDE) são definidos com os valores recomendados da nuvem para bancos de dados com 'Chaves Gerenciadas pelo Cliente'.
- Gerenciamento da Biblioteca de Software da Nuvem:
- Foi reformulado o download de artefatos da biblioteca de software por meio de
imageTags
. É recomendável usarimageTags
para fazer download das imagens do banco de dados e do software de grade. Para obter detalhes, consultedbaascli cswlib showimages
edbaascli cswlib download –help
- Foi reformulado o download de artefatos da biblioteca de software por meio de
- Foi incluído o AHF versão 21.4.2
- Várias correções de bugs e melhorias de estabilidade
Tópico principal: Notas da Release
Release 21.4.1.1.0
- Foi ativada a criptografia dos tablespaces no nível do sistema (
SYSTEM
,SYSAUX
,UNDO
eTEMP
) para bancos de dados que serão criados com essa versão do dbaastools em diante. Esse recurso está ativado para o Oracle Database versão 19.6.0.0.0 e posterior. - Aplicação de Patch de Grade:
- Foi adicionada a condição de pré-requisito para verificar se a propriedade de arquivo a seguir pertence ao usuário
grid
.-
<gi_home>/suptools/tfa/release/tfa_home/jlib/jdev-rt.jar
-
<gi_home>/suptools/tfa/release/tfa_home/jlib/jewt4.jar
-
- Foi adicionada a condição de pré-requisito para verificar se a propriedade de arquivo a seguir pertence ao usuário
- Aplicação de Patch do Banco de Dados:
- A operação
database move
simultânea não é permitida por padrão. Foi introduzida uma nova opção–allowParallelDBMove
que pode ser usada para substituir o comportamento padrão das releases 12.2 e posteriores do Oracle Database. - Foram corrigidos os problemas relacionados à movimentação de bancos de dados stand-by no modo
MOUNT
.
- A operação
- Backup e Recuperação do Banco de Dados
- Foram adicionadas novas opções de linha de comando para backup do banco de dados. Para obter mais detalhes, consulte a referência do comando dbaascli database backup.
- Foram adicionadas novas opções de linha de comando para recuperação de banco de dados. Para obter mais detalhes, consulte a referência do comando dbaascli database recover.
- O uso do
bkup_api
para operações de backup e recuperação será descontinuado no futuro. - Para estar alinhado com a prática recomendada pela Oracle de usar o privilégio administrativo de
SYSBACKUP
para operações de Backup e Recuperação, a automação da nuvem cria um usuário administrativo comumC##DBLCMUSER
com a atribuiçãoSYSBACKUP
no nível do contêinerCDB$ROOT
. Portanto, as operações de backup e recuperação são executadas com o usuário tendo o mínimo de privilégios necessários. As credenciais para esse usuário são geradas aleatoriamente e gerenciadas com segurança pela automação da nuvem. Se o usuário não for encontrado ou forLOCKED
eEXPIRED
, a automação da nuvem recriará ou desbloqueará esse usuário durante a operação de backup ou recuperação. Essa alteração na automação da nuvem é feita a partir do dbaastools versão 21.4.1.1.0.
- Foi aprimorada a funcionalidade
dbaascli resume
para retomar qualquer sessão anterior especificando o argumento–sessionID <value>
para o comando de retomada. O ID da sessão é compartilhado na saídadbaascli
, bem como nos logs. - Foi aprimorada a saída
dbaascli help
para mostrar o uso do comando. - Foi descontinuado o uso do shell
dbaascli
(sessão interativa). Será totalmente removido o suporte para esse recurso após março de 2022. É recomendável executar comandosdbaascli
completos no prompt de comando, conforme sugerido em todos os exemplos de documento. - Foi incluído o Autonomous Health Framework (AHF) versão 21.2.8.
- Várias correções de bug e melhorias de estabilidade.
Tópico principal: Notas da Release
Release 21.3.1.2.0
- Foi melhorado o cronograma das operações do
dbaascli
com lógica de sincronização de metadados aprimorada do Plano de Controle. - Foram aprimorados os logs do
dbaascli
para ter informações em milissegundos com o thread associado. - Foram introduzidas mais verificações de pré-requisitos na aplicação de patch do home do banco de dados e nas operações de movimentação de banco de dados para detectar possíveis cenários de falhas com sugestões para a ação corretiva.
- As operações de aplicação de patch do banco de dados agora mantêm o estado dos bancos de dados igual ao que era antes da aplicação de patch. Para bancos de dados plugáveis, o estado salvo do pdb é respeitado.
- Várias correções de bug e melhorias de estabilidade.
Tópico principal: Notas da Release
Release 21.3.1.1.0
- Foi adicionado suporte para desbloquear a conta do usuário Administrador do PDB como parte da operação de criação do PDB,
localClone
ouremoteClone
. Para obter detalhes, consulte a opção--lockPDBAdminAccount
emdbaascli pdb create --help
. - Foi corrigido um problema que atualiza o recurso de banco de dados registrado no Oracle Grid Infrastructure em ambientes existentes com o valor correto do nome do banco de dados.
- Foram aprimoradas as operações de ciclo de vida do PDB.
- Várias correções de bug e melhorias de estabilidade.
Tópico principal: Notas da Release
Release 21.3.1.0.1
- Suporte para que os comandos
dbaascli
a seguir sejam executados como usuáriooracle
.dbaascli pdb bounce
dbaascli pdb close
dbaascli pdb connectString
dbaascli pdb create
dbaascli pdb delete
dbaascli pdb getDetails
dbaascli pdb list
dbaascli pdb localClone
dbaascli pdb open
dbaascli pdb remoteClone
- Foi reformulada a aplicação de patch do banco de dados fora do local. Para obter detalhes, consulte
dbaascli database move –help
. - Aprimoramentos relacionados a cronograma no workflow de aplicação de patch do Oracle Grid Infrastructure. Para obter detalhes, consulte
dbaascli grid patch –help
. - Foi descontinuado o suporte para
exadbcpatchmulti
/dbaascli patch
para operações de aplicação de patch. Os comandosdbaascli dbhome patch
edbaascli grid patch
são fornecidos para a operação de aplicação de patch para homes de banco de dados e para o Oracle Grid Infrastructure. Consulte a seção Aplicando Patch no Oracle Grid Infrastructure e no Oracle Database com o Utilitário dbaascli para obter detalhes. Consulte também a seção Referência de Comando do dbaascli. - Foi descontinuado o suporte para o comando de patch de ferramentas do
dbaascli
para trazer consistência nas convenções de comando dodbaascli
. O novo comando édbaascli admin updateStack
. Para obter detalhes, consulte a seção Atualizando o Conjunto de Ferramentas da Nuvem com o utilitário dbaascli. - Capacidade de executar
dbaascli
no modo desconectado para operações de longa execução. A execução do comandodbaascli
com--waitForCompletion false
obtém um ID de job que pode ser consultado posteriormente para obter o status da operação, usandodbaascli job getStatus –jobid job_id
. Isso é útil nas operações de longa execução nas quais os usuários podem querer obter o controle de volta imediatamente após a execução do comando. Nessa versão, essa opção está disponível apenas para o comandodbaascli database create
. Mais comandos serão adicionados nas releases subsequentes para ter esse suporte. A saída da ajuda para esses comandos refletirá o suporte da opção--waitForCompletion
. - Foi descontinuado o suporte para o shell
dbaascli
. É recomendável que os usuários executem os comandosdbaascli
completos no prompt de comando conforme sugerido em todos os exemplos de documento. A execução apenas dodbaascli
mostrará a saída de sua ajuda de uso em vez de entrar em um shelldbaascli
. - Várias correções de bug e melhorias de estabilidade.
Tópico principal: Notas da Release
Release 21.2.1.x.x
- Foi reprojetada a operação de aplicação de patch do Oracle Grid Infrastructure e adicionada a capacidade de retomada do ponto de falha, patch no subconjunto de nós, drenagem da instância e outros aprimoramentos. Para obter detalhes, consulte
dbaascli grid patch --help
. Consulte também a seção Aplicando Patch no Oracle Grid Infrastructure e no Oracle Database com o Utilitário dbaascli. - Foi descontinuado o suporte para
exadbcpatchmulti
/dbaascli patch
para operações de aplicação de patch. Os comandosdbaascli dbhome patch
edbaascli grid patch
são fornecidos para a operação de aplicação de patch para homes de banco de dados e para o Oracle Grid Infrastructure. Consulte a seção Aplicando Patch no Oracle Grid Infrastructure e no Oracle Database com o Utilitário dbaascli para obter detalhes. Consulte também a seção Referência de Comando do dbaascli. - Foi descontinuado o suporte para o comando
dbaascli tools patch
para trazer consistência nas convenções de comando. O novo comando édbaascli admin updateStack
. - Foram reprojetadas as APIs de gerenciamento de PDB para operações de criação, clonagem local e clonagem remota. Para obter detalhes, consulte
dbaascli pdb --help
. - Foi reprojetada a API de exclusão de banco de dados. Para obter detalhes, consulte
dbaascli database delete --help
. - Foi reformulada a criação de dbhome (suporte para imagem de software personalizada e operação de expansão). Para obter detalhes, consulte
dbaascli dbhome create --help
. - Suporte para criação de banco de dados no subconjunto de nós do cluster. Para obter detalhes, consulte
dbaascli database create --help
. - Capacidade de executar
dbaascli
no modo desconectado para operações de longa execução. A execução do comandodbaascli
com--waitForCompletion false
obtém um ID de job que pode ser consultado posteriormente para obter o status da operação, usandodbaascli job getStatus –jobid job_id
. Isso é útil nas operações de longa execução nas quais os usuários podem querer obter o controle de volta imediatamente após a execução do comando. Nessa versão, essa opção está disponível apenas para o comandodbaascli database create
. Mais comandos serão adicionados nas releases subsequentes para ter esse suporte. A saída da ajuda para esses comandos refletirá o suporte da opção--waitForCompletion
. - Foi aprimorada a experiência de aplicação de patch do dbhome com a introdução de várias opções, como
skipPDBs
,continueWithDowntime
etc. Para obter detalhes, consultedbaascli dbhome patch --help
. - Suporte para melhor coleta de diagnóstico. Para obter detalhes, consulte
dbaascli diag collect --help
. - Pequenas melhorias na área de automação de upgrade de banco de dados.
- Várias correções de bug e melhorias de estabilidade.
Tópico principal: Notas da Release
Referência de Comando do dbaascli
Use dbaascli
para criar bancos de dados e integrá-los ao framework de automação da nuvem.
dbaascli
é uma interface nativa da nuvem que pode usar modelos DBCA como entradas, chama a funcionalidade do DBCA para criar bancos de dados e, em seguida, chama as APIs do OCI para integrar o banco de dados no framework de automação da nuvem. Os clientes que usam DBCA em scripts hoje podem atualizar seus scripts existentes para chamar o dbaascli
em vez do DBCA. Se o dbaascli
não puder ser usado porque um recurso específico do DBCA está indisponível no dbaascl, os clientes deverão abrir uma solicitação do My Oracle Support (MOS) para adicionar essa funcionalidade ao dbaascli
.
- Administração e Configuração
Esta seção aborda tarefas essenciais para o gerenciamento e a configuração de ambientes do Oracle Database. Ele inclui comandos comodbaascli admin updateStack
para instalar ou atualizar o RPMdbaastools
edbaascli job getStatus
para verificar o status de jobs específicos. - Dimensionamento de CPU
Esta seção se concentra no ajuste de recursos de CPU em um cluster de VMs. Inclui comandos comodbaascli cpuscale get_status
para verificar o status de solicitações de dimensionamento atuais ou anteriores edbaascli cpuscale update
para aumentar ou diminuir o número de núcleos de CPU alocados para uma máquina virtual, permitindo o gerenciamento flexível de recursos com base nas demandas de carga de trabalho. - Gerenciamento da Biblioteca de Software da Nuvem (CSWLIB)
Esta seção fornece ferramentas para gerenciar imagens de software nos ambientes Exadata Database Service on Cloud@Customer. Comandos comodbaascli cswlib deleteLocal
permitem a remoção de imagens locais, enquantodbaascli cswlib download
permite o download de novas imagens de software. Você também pode exibir imagens disponíveis localmente comdbaascli cswlib listLocal
ou verificar todas as imagens disponíveis do Database e do Grid Infrastructure usandodbaascli cswlib showImages
. Esses comandos ajudam a gerenciar e manter bibliotecas de software com eficiência. - Database Management
Esta seção abrange tarefas abrangentes para gerenciar Bancos de Dados Oracle. Ele inclui comandos para criar (dbaascli database create
), excluir (dbaascli database delete
) e fazer upgrade de bancos de dados (dbaascli database upgrade
). Outras tarefas principais incluem adicionar e excluir instâncias (dbaascli database addInstance
,dbaascli database deleteInstance
), gerenciar backups (dbaascli database backup
) e tratar a recuperação do banco de dados (dbaascli database recover
). Você também pode modificar parâmetros de banco de dados, gerenciar bancos de dados plugáveis, aplicar patches a bancos de dados e converter bancos de dados não CDB em PDBs. Esses comandos garantem um controle eficiente sobre todo o ciclo de vida do banco de dados. - Gerenciamento do Data Guard
Esta seção se concentra no gerenciamento de configurações e operações do Oracle Data Guard. Ele inclui comandos comodbaascli dataguard prepareStandbyBlob
para gerar um arquivo blob para configurar um site stand-by edbaascli dataguard updateDGConfigAttributes
para atualizar atributos de automação do Data Guard em todos os nós do cluster. Esses comandos simplificam a configuração e a manutenção de ambientes do Data Guard para alta disponibilidade e recuperação de desastres. - Database Home Management
Esta seção fornece ferramentas para gerenciar homes do Oracle Database. Ele inclui comandos comodbaascli dbhome create
para criar um novo home do Oracle Database edbaascli dbHome delete
para remover um existente. Você também pode exibir informações detalhadas sobre um Oracle home específico comdbaascli dbHome getDetails
e verificar quais bancos de dados estão sendo executados em um determinado Oracle home usandodbaascli dbhome getDatabases
. Esses comandos garantem o gerenciamento eficiente de ambientes de banco de dados. - Diagnósticos e Verificações de Integridade
Esta seção aborda ferramentas para manter a integridade e diagnosticar problemas nos ambientes do Oracle Database. Comandos comodbaascli diag collect
são usados para coletar dados de diagnóstico, enquantodbaascli diag healthCheck
permite executar verificações de integridade para identificar possíveis problemas. Essas ferramentas ajudam a garantir a estabilidade e o desempenho do sistema, monitorando e abordando proativamente as preocupações. - Gerenciamento de Infraestrutura de Grade
Esta seção se concentra no gerenciamento do Oracle Grid Infrastructure, que suporta clusterização e alta disponibilidade. As principais tarefas incluem a configuração de um home do Grid Infrastructure (dbaascli gridHome create
), o upgrade do Grid Infrastructure (dbaascli grid upgrade
) e o gerenciamento de certificados TCPS (Transport Layer Security) configurando (dbaascli grid configureTCPS
), removendo (dbaascli grid removeTCPSCert
) ou alternando-os (dbaascli grid rotateTCPSCert
). Esses comandos garantem a configuração, a manutenção e a segurança eficientes do Grid Infrastructure. - Aplicação de Patches e Upgrade
Esta seção fornece ferramentas para atualizar e manter ambientes Oracle por meio de patches e upgrades. Ele inclui comandos comodbaascli grid patch
para aplicar patch ao Oracle Grid Infrastructure,dbaascli dbHome patch
para aplicar patches aos Oracle homes edbaascli database move
para mover bancos de dados entre homes durante upgrades ou processos de aplicação de patch. Esses comandos ajudam a garantir que os sistemas permaneçam seguros, estáveis e atualizados. - Gerenciamento de Banco de Dados Plugável (PDB)
Esta seção abrange o gerenciamento de Bancos de Dados Plugáveis (PDBs) em um banco de dados contêiner (CDB). Ele inclui comandos para criar (dbaascli pdb create
), excluir (dbaascli pdb delete
) e clonar PDBs (dbaascli pdb localClone
,dbaascli pdb remoteClone
). Você pode gerenciar estados do PDB com comandos para abrir, fechar ou devolver PDBs e recuperar detalhes da conexão (dbaascli pdb getConnectString
). Comandos adicionais suportam backup, recuperação e realocação de PDBs, garantindo controle abrangente sobre o ciclo de vida e as operações do PDB. - Gerenciamento de Sistema
Esta seção se concentra em supervisionar e gerenciar Oracle homes no sistema. Ele inclui comandos comodbaascli system getDBHomes
para exibir detalhes sobre todos os homes do Oracle Database edbaascli system getGridHomes
para listar os detalhes de todos os homes do Grid Infrastructure. Esses comandos fornecem informações essenciais para a manutenção e solução de problemas do ambiente geral do sistema. - Gerenciamento de Criptografia de Dados Transparentes (TDE)
Esta seção abrange o gerenciamento de Criptografia de Dados Transparentes (TDE) para proteger dados de banco de dados. Ele inclui comandos para tratar chaves de criptografia e armazenamentos de chaves, comodbaascli tde addSecondaryHsmKey
para adicionar chaves HSM secundárias,dbaascli tde rotateMasterKey
para rotacionar a chave mestra edbaascli tde encryptTablespacesInPDB
para criptografar tablespaces em um banco de dados plugável. Você também pode converter entre FILE e TDE baseado em HSM (dbaascli tde fileToHsm
,dbaascli tde hsmToFile
), gerenciar versões de chave e recuperar detalhes de chave com vários comandos. Essas ferramentas garantem um gerenciamento eficaz de criptografia e segurança de dados. - Comandos dbaascli obsoletos
Os comandosdbaascli patch db prereq
edbaascli patch db apply
foram descontinuados na release 21.2.1.2.2.0 dodbaascli
e substituídos pordbaascli grid patch
,dbaascli dbhome patch
edbaascli database move
.
Administração e configuração
Esta seção aborda tarefas essenciais para o gerenciamento e a configuração de ambientes do Oracle Database. Ele inclui comandos como dbaascli admin updateStack
para instalar ou atualizar o RPM dbaastools
e dbaascli job getStatus
para verificar o status de jobs específicos.
- dbaascli admin updateStack
Para instalar ou atualizar um RPM dbaastools, use o comandodbaascli admin updateStack
. - dbaascli job getStatus
Para exibir o status de um job especificado, use o comandodbaascli job getStatus
.
Tópico principal: Referência de Comando do dbaascli
dbaascli admin updateStack
Para instalar ou atualizar um RPM dbaastools, use o comando dbaascli admin updateStack
.
Pré-requisitos
Execute o comando como usuário root
.
Para usar o utilitário, conecte-se a uma máquina virtual do Exadata Database Service on Cloud@Customer.
Consulte Estabelecendo Conexão com uma Máquina Virtual com SSH.
Sintaxe
dbaascli admin updateStack
[--resume]
[--prechecksOnly]
[--nodes]
--resume
retoma a execução anterior--prechecksOnly
executa apenas as pré-verificações desta operação--nodes
especifica uma lista de nós delimitados por vírgulas nos quais instalar o RPM. Se você não informar esse argumento, o RPM será instalado em todos os nós do cluster
Perguntas Frequentes
P: Para que é usado o comando dbaascli admin updateStack?
R: O comando dbaascli admin updateStack
é usado para instalar ou atualizar um RPM dbaastools no Exadata Cloud Infrastructure.
P: Quais são os pré-requisitos para usar o comando dbaascli admin updateStack?
R: Você deve executar o comando como usuário raiz e estabelecer conexão com uma máquina virtual do Exadata Cloud Infrastructure.
P: O que a opção --resume faz?
A: A opção --resume
retomará a execução anterior do comando updateStack
se ele tiver sido interrompido ou incompleto.
P: Qual é a finalidade da opção --prechecksOnly?
A: A opção --prechecksOnly
executa apenas as pré-verificações para a operação sem realmente executar a instalação ou atualização.
P: Como o parâmetro --nodes é usado?
R: O parâmetro --nodes
especifica uma lista de nós delimitados por vírgulas nos quais o RPM deve ser instalado. Se não for fornecido, o RPM será instalado em todos os nós do cluster.
P: O que devo fazer se eu encontrar problemas com o comando dbaascli admin updateStack?
R: Certifique-se de que você esteja executando o comando como usuário raiz e que esteja conectado a uma máquina virtual do Exadata Cloud Infrastructure. Verifique se há mensagens de erro específicas e consulte a documentação de comando ou o suporte da Oracle, se necessário.
P: Como estabeleço conexão com uma máquina virtual do Exadata Cloud Infrastructure para usar o comando dbaascli admin updateStack?
R: Você precisa usar SSH para se conectar à máquina virtual. Consulte a seção em "Estabelecendo Conexão com uma Máquina Virtual com SSH" na documentação para obter instruções detalhadas.
Exemplo de Casos de Uso
Exemplo 1: Instalando ou atualizando o RPM dbaastools em todos os nós
dbaascli admin updateStack
Instala ou atualiza o RPM dbaastools
em todos os nós do ambiente Exadata Cloud@Customer.
Exemplo 2: executando pré-verificações somente antes de instalar ou atualizar o RPM
dbaascli admin updateStack --prechecksOnly
Executa somente as pré-verificações para a atualização do RPM dbaastools
, sem realmente executar a instalação. Ele garante que todos os pré-requisitos sejam atendidos antes de prosseguir com a atualização.
Exemplo 3: Retomando uma operação updateStack interrompida anteriormente
dbaascli admin updateStack --resume
Retoma uma operação de atualização de RPM dbaastools
anterior que foi interrompida ou não foi concluída com sucesso.
Exemplo 4: Instalando ou atualizando dbaastools em nós específicos
dbaascli admin updateStack --nodes node1,node2
Instala ou atualiza o RPM dbaastools
somente nos nós especificados node1 e node2, sem afetar outros nós do cluster.
Exemplo 5: Retomando o processo updateStack em nós específicos
dbaascli admin updateStack --resume --nodes node3,node4
Retoma o processo de atualização para dbaastools
somente nos nós específicos node3 e node4, se a execução anterior tiver sido interrompida.
Tópicos Relacionados
Tópico pai: Administração e Configuração
dbaascli job getStatus
Para exibir o status de um job especificado, use o comando dbaascli job getStatus
.
Pré-Requisito
Execute o comando como usuário root
.
Para usar o utilitário, conecte-se a uma máquina virtual do Exadata Cloud@Customer.
Consulte Estabelecendo Conexão com uma Máquina Virtual com SSH.
Sintaxe
dbaascli job getStatus --jobID
--jodID
especifica o ID do job
Perguntas Frequentes
P: Para que é usado o comando getStatus do job dbaascli?
A: O comando dbaascli job getStatus
é usado para exibir o status
Exemplo de Casos de Uso
Exemplo 1: Verificando o status de um job específico usando o ID do job
dbaascli job getStatus --jobID 12345
Verifica o status do job com o ID 12345. A saída mostrará o estado atual do job (por exemplo, em andamento, concluído ou com falha).
Exemplo 2: Verificando o status de um job de aplicação de patch usando o ID do job
dbaascli job getStatus --jobID 98765
Recupera o status de um job de aplicação de patch com o ID 98765 para ver se o patch foi aplicado com sucesso ou se ainda está em execução.
Exemplo 3: Verificando o status de um job de backup de banco de dados
dbaascli job getStatus --jobID 45678
Verifica o status de um job de backup de banco de dados com o ID 45678. A saída fornecerá detalhes sobre o andamento ou a conclusão do backup.
Exemplo 4: Verificando o andamento de um job de longa execução
dbaascli job getStatus --jobID 23456
Verifique o andamento de um job de execução longa (ID 23456) para ver se ele ainda está em execução ou se foi concluído.
Exemplo 5: Exibindo o status de um job de criação de banco de dados
dbaascli job getStatus --jobID 67890
Verifica o status de um job de criação de banco de dados identificado pelo ID de job 67890.
Tópicos Relacionados
Tópico pai: Administração e Configuração
Escala de CPU
Esta seção se concentra no ajuste de recursos de CPU em um cluster de VMs. Inclui comandos como dbaascli cpuscale get_status
para verificar o status de solicitações de dimensionamento atuais ou anteriores e dbaascli cpuscale update
para aumentar ou diminuir o número de núcleos de CPU alocados para uma máquina virtual, permitindo o gerenciamento flexível de recursos com base nas demandas de carga de trabalho.
- dbaascli cpuscale get_status
Para verificar o status da atual ou última solicitação de dimensionamento executada quando a conectividade de rede entre o Control Plane Server e a região do OCI for interrompida, use o comandodbaascli cpuscale get_status
. - dbaascli cpuscale update
Para aumentar ou diminuir a contagem de núcleos de CPU de uma máquina virtual em um cluster de VMs quando a conectividade de rede entre o Control Plane Server e a região do OCI for interrompida, use o comandodbaascli cpuscale update
.
Tópico principal: Referência de Comando do dbaascli
dbaascli cpuscale get_status
Para verificar o status da atual ou última solicitação de dimensionamento executada quando a conectividade de rede entre o Control Plane Server e a região do OCI for interrompida, use o comando dbaascli cpuscale get_status
.
Pré-requisitos
Execute o comando como usuário root
.
Para usar o utilitário, conecte-se a uma máquina virtual do Exadata Cloud@Customer.
Consulte Estabelecendo Conexão com uma Máquina Virtual com SSH.
Sintaxe
scheduled
, running
e finalmente para success
ou failure
.dbaascli cpuscale get_status
Perguntas Frequentes
P: Para que é usado o comando dbaascli cpuscale get_status?
R: O comando dbaascli cpuscale get_status
é usado para verificar o status da atual ou última solicitação de dimensionamento de CPU, especialmente quando a conectividade de rede entre o Control Plane Server e a região do OCI é interrompida.
P: Quais são os pré-requisitos para usar o comando dbaascli cpuscale get_status?
R: Você deve executar o comando como usuário root
e estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer.
P: O que devo fazer se eu encontrar problemas ao executar o comando dbaascli cpuscale get_status?
R: Verifique se você está executando o comando como o usuário root
e se está conectado a uma máquina virtual do Exadata Cloud@Customer. Se os problemas persistirem, consulte a documentação de comando ou procure suporte da Oracle.
P: E se o comando mostrar um status de falha?
R: Se o comando mostrar um status de falha, verifique os logs detalhados para obter mensagens de erro e solucionar problemas com base no erro específico. Talvez seja necessário resolver problemas de rede ou revisar os detalhes da solicitação de dimensionamento.
Exemplo de Casos de Uso
Exemplo 1: Verificando o status da operação de dimensionamento de CPU mais recente
dbaascli cpuscale get_status
Verifica o status da solicitação de dimensionamento atual ou da última CPU. Ele fornecerá informações sobre se o dimensionamento está programado, em execução ou concluído com sucesso ou falha.
Exemplo 2: Falha ao verificar o status após uma solicitação de dimensionamento
Uma operação de dimensionamento foi solicitada, mas encontrou problemas de rede entre o Control Plane Server e a região do OCI.
dbaascli cpuscale get_status
Verifica o status da solicitação de dimensionamento. Como o processo de dimensionamento falhou devido a problemas de rede, a saída fornecerá detalhes sobre o estado da falha.
Exemplo 3: Verificando o status quando o dimensionamento está em andamento
Uma operação de dimensionamento de CPU está em andamento e o usuário deseja monitorar seu progresso.
dbaascli cpuscale get_status
Verifica o status atual, mostrando que a solicitação de dimensionamento está no estado "em execução". Ele permite que o usuário rastreie a operação até que ela seja concluída ou falhe.
Exemplo 4: Verificando o status após a conclusão do dimensionamento bem-sucedida
Uma operação de dimensionamento foi executada e concluída com sucesso.
dbaascli cpuscale get_status
Verifica o status e confirma que a operação de dimensionamento foi concluída com sucesso. Ele relata o estado final como "sucesso".
Tópicos Relacionados
Tópico principal: Dimensionamento de CPU
dbaascli cpuscale update
Para aumentar ou diminuir a contagem de núcleos de CPU de uma máquina virtual em um cluster de VMs quando a conectividade de rede entre o Control Plane Server e a região do OCI for interrompida, use o comando dbaascli cpuscale update
.
Pré-requisitos
Para ampliar ou reduzir OCPUs em um cluster de VMs no modo desconectado, execute os comandos dbaascli cpuscale update
e dbaascli cpuscale get_status
em qualquer nó dentro de um cluster de VMs para alterar a contagem de núcleos de CPU desse cluster. Se você tiver mais de um cluster de VMs, execute outro comando em qualquer nó dentro de cada cluster de VMs que você deseja ampliar ou reduzir. Esses comandos foram projetados para não funcionar se forem emitidos durante o modo normal conectado e vão expirar após 600 segundos (10 minutos).
Execute o comando como usuário root
.
Para usar o utilitário, conecte-se a uma máquina virtual do Exadata Cloud@Customer.
Consulte Estabelecendo Conexão com uma Máquina Virtual com SSH.
Sintaxe
O Exadata Database Service on Cloud@Customer é considerado no modo Desconectado quando há uma perda de conectividade com o plano de controle DBaaS em execução no Oracle Cloud Infrastructure (OCI).
dbaascli cpuscale update --coreCount coreCount --message message
--coreCount
especifica o número de destino de CPUs que você deseja expandir ou reduzir para cada VM no cluster--message
você pode incluir uma mensagem para sua referência
Perguntas Frequentes
P: Para que é usado o comando dbaascli cpuscale update?
R: O comando dbaascli cpuscale update
é usado para aumentar ou diminuir a contagem de núcleos de CPU de uma máquina virtual em um cluster de VMs quando a conectividade de rede entre o Control Plane Server e o Oracle Cloud Infrastructure (OCI) é interrompida.
P: Quais são os pré-requisitos para usar o comando dbaascli cpuscale update?
R: Antes de usar esse comando, certifique-se de executá-lo no modo desconectado, o que significa que há uma perda de conectividade com o plano de controle DBaaS no OCI. Execute o comando de qualquer nó dentro do cluster de VMs e observe que ele expirará após 600 segundos (10 minutos) se usado no modo conectado. O comando deve ser executado como usuário raiz.
P: Como me conecto a uma máquina virtual para usar esse comando?
R: Para usar o comando dbaascli cpuscale update
, você precisa estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH. Consulte "Conectando-se a uma Máquina Virtual usando SSH" para obter instruções detalhadas.
P: O que a opção --coreCount especifica no comando?
A: A opção --coreCount
especifica o número de destino de CPUs que você deseja expandir ou reduzir para cada VM no cluster.
P: Posso incluir uma mensagem com o comando dbaascli cpuscale update?
R: Sim, você pode incluir uma mensagem opcional usando a opção --message
para sua referência.
P: Como verifico o status de uma operação de dimensionamento de CPU?
R: Para verificar o status de uma operação de dimensionamento de CPU, use o comando dbaascli cpuscale get_status
. Isso também deve ser executado de qualquer nó dentro do cluster de VMs.
P: O que acontece se eu executar o comando de atualização dbaascli cpuscale no modo conectado?
R: O comando foi projetado para não funcionar no modo conectado e expirará após 600 segundos (10 minutos). Ele só deve ser usado no modo desconectado.
P: Como dimensiono núcleos de CPU para vários clusters de VMs?
R: Se você tiver mais de um cluster de VMs, será necessário executar o comando dbaascli cpuscale update
separadamente de qualquer nó dentro de cada cluster de VMs que você deseja ampliar ou reduzir.
Exemplo de Casos de Uso
Exemplo 1: Dimensionando núcleos de CPU para 20
O cluster de VMs está em execução com 16 núcleos e você deseja aumentá-lo para 20.
dbaascli cpuscale update --coreCount 20 --message "Scaling up for increased demand"
Dimensiona a contagem de núcleos da CPU até 20 e inclui uma mensagem "Dimensionando para maior demanda" para referência.
Exemplo 2: Reduzir núcleos de CPU para 8
No momento, o cluster de VMs está usando 12 núcleos, mas você deseja reduzir a contagem para 8 para salvar recursos.
dbaascli cpuscale update --coreCount 8 --message "Reducing CPU for maintenance period"
Reduz o número de núcleos de CPU para 8 e fornece uma mensagem para referência futura sobre por que a operação de dimensionamento foi executada.
Exemplo 3: Dimensionando a CPU sem uma mensagem
Você precisa dimensionar os núcleos de CPU de 32 para 24, mas nenhuma mensagem adicional é necessária.
dbaascli cpuscale update --coreCount 24
Este comando reduz a contagem de núcleos para 24 sem nenhuma mensagem. A operação será realizada com o log padrão de ações.
Exemplo 4: Verificando o status após dimensionar a CPU
Depois de executar o comando de dimensionamento, você deseja verificar se a atualização foi bem-sucedida.
dbaascli cpuscale get_status
Verifica o status da solicitação de dimensionamento atual ou da última, permitindo que você confirme se a operação de ampliação ou redução foi bem-sucedida.
Exemplo 5: Tentativa de dimensionar quando a VM já está no máximo de núcleos
O cluster de VMs já tem o máximo permitido de núcleos de CPU (48), mas é feita uma tentativa de expansão.
dbaascli cpuscale update --coreCount 50 --message "Attempt to scale beyond limit"
Falha, pois o cluster de VMs não pode exceder seu máximo de núcleos permitidos. O status refletirá a falha depois de tentar dimensionar para 50 núcleos.
Tópicos Relacionados
Tópico principal: Dimensionamento de CPU
Gerenciamento da Biblioteca de Software da Nuvem (CSWLIB)
Esta seção fornece ferramentas para gerenciar imagens de software nos ambientes Exadata Database Service on Cloud@Customer. Comandos como dbaascli cswlib deleteLocal
permitem a remoção de imagens locais, enquanto dbaascli cswlib download
permite o download de novas imagens de software. Você também pode exibir imagens disponíveis localmente com dbaascli cswlib listLocal
ou verificar todas as imagens disponíveis do Database e do Grid Infrastructure usando dbaascli cswlib showImages
. Esses comandos ajudam a gerenciar e manter bibliotecas de software com eficiência.
- dbaascli cswlib deleteLocal
Para excluir a imagem local, use o comandodbaascli cswlib deleteLocal
. - dbaascli cswlib download
Para fazer download das imagens de software disponíveis e disponibilizá-las no ambiente do Exadata Database Service on Cloud@Customer, use o 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
.
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:
--imageTag
especifica a tag de imagem do Oracle home
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli cswlib deleteLocal?
R: O comando dbaascli cswlib deleteLocal
é usado para excluir uma imagem local do Oracle home do sistema.
P: Quais são os pré-requisitos para executar o comando dbaascli cswlib deleteLocal?
R: O comando deve ser executado como o usuário root
para garantir que as permissões necessárias estejam disponíveis para excluir a imagem local.
P: Como especificar qual imagem local excluir?
A: Use a opção --imageTag
para especificar a tag de imagem do Oracle home que você deseja excluir.
P: O que a opção --imageTag representa no comando?
A: A opção --imageTag
representa o identificador ou a tag associada à imagem do Oracle home que você deseja excluir.
P: Posso excluir várias imagens locais de uma só vez usando este comando?
R: Não, o comando dbaascli cswlib deleteLocal
permite excluir apenas uma imagem local por vez, especificada por sua tag de imagem.
P: O que acontece se eu executar o comando dbaascli cswlib deleteLocal sem especificar --imageTag?
R: O comando falhará porque --imageTag
é necessário para identificar qual imagem local deve ser excluída.
P: É possível recuperar uma imagem local depois que ela tiver sido excluída usando este comando?
R: Não, depois que a imagem local for excluída usando o comando dbaascli cswlib deleteLocal
, ela não poderá ser recuperada. Certifique-se de verificar a tag da imagem antes de continuar.
P: Quando eu precisaria usar o comando dbaascli cswlib deleteLocal?
R: Você usaria esse comando quando precisasse remover uma imagem do Oracle home não usada ou desatualizada do sistema local para liberar espaço ou limpar seu ambiente.
Exemplo 7-4 dbaascli cswlib deletelocal
dbaascli cswlib deletelocal --imagetag 19.15.0.0.0
DBAAS CLI version MAIN
Executing command cswlib deletelocal --imagetag 19.15.0.0.0
Job id: 8b3e71de-4b81-4832-b49c-7f892179bb4f
Log file location: /var/opt/oracle/log/cswLib/deleteLocal/dbaastools_2022-07-18_10-00-02-AM_73658.log
dbaascli execution completed
Tópicos Relacionados
Tópico principal: Gerenciamento da Biblioteca de Software da Nuvem (CSWLIB)
dbaascli cswlib download
Para fazer download das imagens de software disponíveis e disponibilizá-las no ambiente do Exadata Database Service on Cloud@Customer, use o comando dbaascli cswlib download
.
Pré-requisitos
Execute o comando como usuário root
.
Para usar o utilitário, conecte-se a uma máquina virtual do Exadata Database Service on Cloud@Customer.
Consulte Estabelecendo Conexão com uma Máquina Virtual com SSH.
Sintaxe
dbaascli cswlib download --version | --imageTag
[--product]
--version
especifica uma versão da imagem do Oracle home--imageTag
especifica a tag da imagem--product
especifica o tipo de imagem. Valores válidos:database
ougrid
Perguntas Frequentes
P: Qual é a finalidade do comando de download dbaascli cswlib?
R: O comando dbaascli cswlib download
é usado para fazer download das imagens de software disponíveis e disponibilizá-las no Exadata Cloud Infrastructure.
P: Quais são os pré-requisitos para executar o comando de download dbaascli cswlib?
R: Execute o comando como usuário root
. Além disso, você precisa estar conectado a uma máquina virtual do Exadata Cloud Infrastructure.
P: Como me conecto à máquina virtual necessária para este comando?
A: Você precisa usar SSH para estabelecer conexão com a máquina virtual do Exadata Cloud Infrastructure. Instruções detalhadas podem ser encontradas na documentação em "Estabelecendo Conexão com uma Máquina Virtual com SSH".
P: O que a opção --version especifica no comando?
A: A opção --version
especifica a versão da imagem do Oracle home que você deseja fazer download.
P: Como eu uso a opção --imageTag no comando dbaascli cswlib download?
A: A opção --imageTag
é usada para especificar a tag de imagem da imagem de software que você deseja fazer download.
P: Qual é a finalidade da opção --product no comando?
A: A opção --product
especifica o tipo de imagem que você deseja baixar. Os valores válidos são banco de dados ou grade.
P: Posso fazer download de imagens de banco de dados e grade simultaneamente?
R: Não, você deve especificar database
ou grid
usando a opção --product
, para que cada operação de download seja específica de um tipo de imagem.
P: O que acontece se eu não especificar uma tag de versão ou imagem?
R: O comando provavelmente falhará ou solicitará as informações necessárias, pois as opções --version
ou --imageTag
são necessárias para identificar a imagem de software específica para download.
P: É necessário especificar --version e --imageTag juntos?
R: Não, você geralmente especifica --version
ou --imageTag
, dependendo de como deseja identificar a imagem a ser transferida por download, mas não ambos ao mesmo tempo.
P: Quando eu usaria o comando dbaascli cswlib download?
R: Você usaria esse comando quando precisasse fazer download de imagens de software do Oracle home para ambientes database
ou grid
na configuração do Exadata Cloud Infrastructure.
Exemplo 7-5 dbaascli cswlib download --product --imageTag
dbaascli cswlib download --product database --imageTag 19.14.0.0.0
Exemplo 7-6 dbaascli cswlib download --version 19.9.0.0.0
dbaascli cswlib download --product database --imageTag 19.14.0.0.0
Tópicos Relacionados
Tópico principal: Gerenciamento da Biblioteca de Software da Nuvem (CSWLIB)
dbaascli cswlib listLocal
Para exibir a lista de imagens do Banco de Dados e do Grid Infrastructure disponíveis localmente, use o comando dbaascli cswlib listLocal
.
Execute o comando como usuário root
.
Sintaxe
dbaascli cswLib listLocal [--product <value>]
Em que:
--product
identifica o tipo de produto do Oracle home. Valores válidos:database
ougrid
.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli cswlib listLocal?
R: O comando dbaascli cswlib listLocal
é usado para exibir a lista de imagens do Banco de Dados e do Grid Infrastructure disponíveis localmente no seu sistema.
P: Quais são os pré-requisitos para executar o comando dbaascli cswlib listLocal?
R: O comando deve ser executado como o usuário root
para ter as permissões necessárias para acessar e listar as imagens disponíveis.
P: Como eu especifico que tipo de imagens listar usando este comando?
A: Use a opção --product
para especificar o tipo de imagens do Oracle home que você deseja listar. Os valores válidos são database
ou grid
.
P: O que a opção --product representa no comando dbaascli cswlib listLocal?
A: A opção --product
identifica o tipo de produto Oracle home, permitindo que você filtre a lista de imagens disponíveis para os tipos database
ou grid
.
P: Posso listar imagens de banco de dados e grade simultaneamente?
R: Não, a opção --product
permite listar imagens database
ou grid
de cada vez. Você precisa executar o comando duas vezes com valores --product
diferentes para ver as duas listas.
P: O que acontece se eu não especificar a opção --product no comando?
R: Se a opção --product
não for especificada, o comando poderá listar todas as imagens disponíveis localmente ou poderá exigir que você especifique o tipo de produto. O comportamento pode depender da configuração do seu ambiente.
P: Quando devo usar o comando dbaascli cswlib listLocal?
R: Você deve usar esse comando quando quiser verificar quais imagens do Banco de Dados ou do Grid Infrastructure estão disponíveis localmente no sistema.
P: Como posso diferenciar entre imagens de banco de dados e de grade na lista?
R: A opção --product
permite filtrar a lista, portanto, especificando database
ou grid
, você só verá as imagens relevantes para esse tipo de produto, facilitando a diferenciação.
P: Há algum risco associado à execução do comando dbaascli cswlib listLocal?
R: Não, este comando não é destrutivo e exibe apenas informações sobre imagens disponíveis localmente. Ele não modifica ou exclui nenhum arquivo.
P: Este comando exibe imagens remotas ou armazenadas na nuvem?
R: Não, o comando dbaascli cswlib listLocal
exibe apenas imagens que estão disponíveis localmente no seu sistema, não aquelas armazenadas remotamente ou na nuvem.
Exemplo 7-7 dbaascli cswlib listlocal
dbaascli cswlib listlocal
DBAAS CLI version MAIN
Executing command cswlib listlocal
Job id: bc4f047c-0a34-4d4d-a1ea-21ddc2a9c627
Log file location: /var/opt/oracle/log/cswLib/listLocal/dbaastools_2022-07-18_10-29-53-AM_16077.log
############ List of Available Database Images #############
1.IMAGE_TAG=12.2.0.1.220419
IMAGE_SIZE=5GB
VERSION=12.2.0.1.220419
DESCRIPTION=12.2 APR 2022 DB Image
2.IMAGE_TAG=18.16.0.0.0
IMAGE_SIZE=6GB
VERSION=18.16.0.0.0
DESCRIPTION=18c OCT 2021 DB Image
3.IMAGE_TAG=19.14.0.0.0
IMAGE_SIZE=5GB
VERSION=19.14.0.0.0
DESCRIPTION=19c JAN 2022 DB Image
dbaascli execution completed
Tópicos Relacionados
Tópico principal: Gerenciamento da Biblioteca de Software da Nuvem (CSWLIB)
dbaascli cswlib showImages
Para exibir a lista de imagens disponíveis do Banco de Dados e do Grid Infrastructure, use o comando dbaascli cswlib showImages
.
Execute o comando como usuário root
.
Sintaxe
dbaascli cswlib showImages
[--product]
Em que:
--product
identifica o tipo de produto do Oracle home. Valores válidos:database
ougrid
.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli cswlib showImages?
R: O comando dbaascli cswlib showImages
é usado para exibir a lista de imagens disponíveis do Banco de Dados e do Grid Infrastructure que podem ser baixadas ou gerenciadas no ambiente do Oracle Exadata Database Service.
P: Quais são os pré-requisitos para executar o comando dbaascli cswlib showImages?
R: O comando deve ser executado como o usuário root
para garantir que você tenha as permissões necessárias para exibir as imagens disponíveis.
P: Como faço para filtrar as imagens listadas por este comando?
R: Você pode filtrar as imagens especificando a opção --product
com database
ou grid
para listar somente as imagens relacionadas a esse tipo de produto.
P: O que a opção --product representa no comando dbaascli cswlib showImages?
A: A opção --product
identifica o tipo de produto do Oracle home, permitindo que você filtre a lista de imagens para o banco de dados ou a grade.
P: Posso exibir imagens de banco de dados e grade em uma única execução de comando?
R: Não, você precisa executar o comando duas vezes com valores --product
diferentes (database
e grid
) para exibir os dois tipos de imagens.
P: O que acontece se eu não especificar a opção --product no comando?
R: Se a opção --product
não for especificada, o comando poderá listar todas as imagens disponíveis ou poderá solicitar que você especifique o tipo de produto, dependendo da configuração do seu ambiente.
P: Quando devo usar o comando dbaascli cswlib showImages?
R: Use este comando quando quiser exibir a lista de imagens do Banco de Dados ou do Grid Infrastructure disponíveis para download ou implantação no ambiente do Oracle Exadata Database Service.
P: Há alguma diferença entre os comandos dbaascli cswlib showImages e dbaascli cswlib listLocal?
R: Sim, dbaascli cswlib showImages
lista todas as imagens disponíveis que você pode fazer download ou gerenciar, enquanto dbaascli cswlib listLocal
lista apenas as imagens que já foram baixadas e disponíveis localmente no seu sistema.
P: Esse comando pode ser usado para exibir imagens armazenadas na nuvem?
R: Sim, esse comando pode mostrar imagens que estão disponíveis para download nos repositórios da Oracle, não apenas aquelas armazenadas localmente.
P: Que tipo de imagens posso esperar ver com este comando?
R: Você pode esperar ver imagens relacionadas ao Oracle Database e ao Grid Infrastructure, que são componentes essenciais para gerenciar e executar bancos de dados Oracle em plataformas Exadata.
Exemplo 7-8 dbaascli cswlib showImages
dbaascli cswlib showImages
Tópicos Relacionados
Tópico principal: Gerenciamento da Biblioteca de Software da Nuvem (CSWLIB)
Serviço Database Management
Esta seção aborda tarefas abrangentes para o gerenciamento de Bancos de Dados Oracle. Ele inclui comandos para criar (dbaascli database create
), excluir (dbaascli database delete
) e fazer upgrade de bancos de dados (dbaascli database upgrade
). Outras tarefas principais incluem adicionar e excluir instâncias (dbaascli database addInstance
, dbaascli database deleteInstance
), gerenciar backups (dbaascli database backup
) e tratar a recuperação do banco de dados (dbaascli database recover
). Você também pode modificar parâmetros de banco de dados, gerenciar bancos de dados plugáveis, aplicar patches a bancos de dados e converter bancos de dados não CDB em PDBs. Esses comandos garantem um controle eficiente sobre todo o ciclo de vida do banco de dados.
- dbaascli database addInstance
Para adicionar a instância do banco de dados no nó especificado, use o 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 banco de dados Exadata Database Service on Cloud@Customer especificado, 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 senhassys
etde
. - dbaascli database createTemplate
Use esse comando para criar modelos de banco de dados (modelos DBCA) que podem ser usados subsequentemente para criar bancos de dados. - dbaascli database 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 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 start
Para iniciar um Banco de Dados Oracle, use o comandodbaascli database start
. - 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
.
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>]
--dbname
especifica o nome do Oracle Database--node
especifica o nome do nó da instância do banco de dados--newNodeSID
especifica o SID para a instância a ser adicionada no novo nó
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database addInstance?
R: O comando dbaascli database addInstance
é usado para adicionar uma nova instância de banco de dados a um nó especificado em um ambiente do Oracle Exadata Database Service.
P: Quais são os pré-requisitos para executar o comando dbaascli database addInstance?
R: O comando deve ser executado como o usuário root
para ter as permissões necessárias para adicionar uma instância de banco de dados.
P: O que a opção --dbname representa neste comando?
A: A opção --dbname
especifica o nome do Oracle Database para o qual você deseja adicionar uma nova instância.
P: Qual é a opção --node usada no comando addInstance do banco de dados dbaascli?
A: A opção --node
especifica o nome do nó em que a nova instância do banco de dados será adicionada.
P: Qual é a finalidade da opção --newNodeSID neste comando?
A: A opção --newNodeSID
permite especificar o SID (Identificador do Sistema) para a nova instância do banco de dados que será criada no nó especificado.
P: É obrigatório especificar a opção --newNodeSID ao adicionar uma nova instância?
A: A opção --newNodeSID
é opcional. Se não for fornecido, a Oracle gerará automaticamente um SID para a nova instância do banco de dados.
P: Quando devo usar o comando dbaascli database addInstance?
R: Use este comando quando quiser dimensionar seu banco de dados adicionando uma nova instância a um nó adicional em uma configuração do Oracle Database com vários nós.
P: Posso adicionar várias instâncias de banco de dados a nós diferentes usando este comando?
R: Sim, você pode executar o comando várias vezes para adicionar instâncias de banco de dados a diferentes nós especificando os valores --node
e --dbname
apropriados.
P: O que acontece se o nó especificado na opção --node não estiver disponível?
R: O comando falhará se o nó especificado não estiver disponível ou acessível. Certifique-se de que o nó esteja adequadamente configurado e acessível antes de executar o comando.
P: Este comando pode ser usado em um ambiente do Data Guard?
R: Sim, você pode usar o comando dbaascli database addInstance
em um ambiente do Data Guard para adicionar instâncias, mas é recomendável seguir as diretrizes necessárias do Data Guard para essas configurações.
P: Esse comando causará tempo de inatividade do banco de dados?
R: A adição de uma instância a um novo nó geralmente não causa tempo de inatividade para as instâncias de banco de dados existentes, mas é recomendável verificar seu ambiente em busca de dependências específicas.
Tópico-pai: Database Management
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 a saída JSON, adicione a opção --json
:
dbaascli database backup --dbname <value> --list --json <file_name>
P: Como posso recuperar um relatório de backup?
R: Você pode obter um relatório de backup usando a opção --getBackupReport
, para uma tag específica ou para o backup mais recente:
dbaascli database backup --dbname <value> --getBackupReport --tag <backup_tag> --json <file_name>
Ou para recuperar o relatório mais recente:
dbaascli database backup --dbname <value> --getBackupReport --latest --json <file_name>
P: Como configuro as definições de backup do banco de dados?
A: Use a opção --configure para especificar o arquivo de configuração de backup ou para ativar/desativar o RTRT (Real-Time Redo Transport):
dbaascli database backup --dbname <value> --configure --configFile <config_file>
Para ativar o RTRT:
dbaascli database backup --dbname <value> --configure --enableRTRT
P: Como verifico a configuração de backup atual do meu banco de dados?
A: Para exibir a configuração de backup do banco de dados atual, use a opção --getConfig
:
dbaascli database backup --dbname <value> --getConfig
P: O que a opção --validate faz no comando dbaascli database backup?
A: A opção --validate
verifica se os backups estão completos e livres de corrupção. Você pode especificar um intervalo de tempo usando a opção --untilTime
:
dbaascli database backup --dbname <value> --validate --untilTime "DD-MON-YYYY HH24:MI:SS"
P: Como exibo o histórico de todas as operações de backup de um banco de dados?
A: Use a opção --showHistory
para exibir o histórico de todas as operações de backup:
dbaascli database backup --dbname <value> --showHistory
Para obter um histórico completo, incluindo todas as operações:
dbaascli database backup --dbname <value> --showHistory --all
P: O que são opções de RTRT (Real-Time Redo Transport) e quando devo usá-las?
R: As opções RTRT (--enableRTRT
e --disableRTRT
) são usadas para controlar o Transporte de Redo em Tempo Real, aplicável apenas para destinos de backup ZDLRA (Zero Data Loss Recovery Appliance) nos ambientes Exadata Cloud@Customer. Ative o RTRT para garantir a remessa de redo log em tempo real.
Exemplo 7-9 Exemplos
- Para alterar o período de retenção do log de arquivamento, siga as etapas abaixo:
dbaascli database backup --getConfig --dbname <dbname>
Isso gerará um arquivo de configuração de backup
.cfg
.Atualize o valor
bkup_archlog_fra_retention
neste arquivo de configuração.Execute o comando de configuração:
dbaascli database backup --configure --dbname <dbname> --configfile <config file generated above>
- Para obter a configuração de backup de um banco de dados myTestDB:
dbaascli database backup --dbName myTestDB --getConfig --configFile /tmp/configfile_1.txt
- Para definir a configuração de backup de um banco de dados myTestDB modificando o arquivo de configuração com detalhes de configuração:
dbaascli database backup --dbName myTestDB --configure --configFile /tmp/configfile_1_modified.txt
- Para fazer backup do banco de dados myTestDB:
dbaascli database backup --dbName myTestDB --start
- Para consultar o status da solicitação de backup submetida com
uuid
58fdcae0bd1c11eb92bc020017075151:dbaascli database backup --dbName myTestDB --status --uuid 58fdcae0bd1c11eb92bc020017075151
- Para ativar o RTRT do banco de dados myTestDB:
dbaascli database backup --dbName myTestDB --configure —enableRTRT
Tópico-pai: Database Management
dbaascli database bounce
Para fazer shutdown e reiniciar um banco de dados Exadata Database Service on Cloud@Customer especificado, use o comando dbaascli database bounce
.
Pré-requisitos
Execute o comando como usuário oracle
.
Sintaxe
dbaascli database bounce
[--dbname][--rolling <value>]
--dbname
especifica o nome do banco de dados--rolling
especificatrue
oufalse
para devolver o banco de dados de maneira incremental. O valor padrão éfalse
.
O comando executa um shutdown do banco de dados no modo imediato. O banco de dados é depois reiniciado e aberto. No Oracle Database 12c ou mais recente, todos os PDBs também são abertos.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database bounce?
R: O comando dbaascli database bounce
é usado para fazer shutdown e reiniciar um Oracle Database no Exadata Cloud Infrastructure. Ele suporta a reinicialização do banco de dados de forma incremental, garantindo o mínimo de interrupção.
P: Quais são os pré-requisitos para executar o comando dbaascli database bounce?
R: O comando deve ser executado como o usuário oracle
, que tem os privilégios necessários para fazer shutdown e reiniciar o banco de dados.
P: O que a opção --dbname especifica neste comando?
A: A opção --dbname
especifica o nome do Oracle Database que você deseja desligar e reiniciar.
P: Qual é a opção --rolling usada no comando dbaascli database bounce?
A: A opção --rolling
especifica se o banco de dados deve ser devolvido (reinicializado) de maneira incremental. Se definido como verdadeiro, as instâncias do banco de dados serão reiniciadas uma a uma, garantindo um tempo de inatividade mínimo. O valor padrão é false
, que reinicia todas as instâncias de uma só vez.
P: O que significa "saltar o banco de dados"?
R: Saltar o banco de dados refere-se a desligá-lo e reiniciá-lo. Esta operação pode ser usada para manutenção, aplicação de alterações ou recuperação de determinados tipos de problemas.
P: O comando dbaascli database bounce executa um shutdown normal?
R: Sim, o comando executa um shutdown no modo "imediato", que fecha o banco de dados e faz rollback de transações não confirmadas sem esperar que os usuários se desconectem.
P: Este comando abrirá automaticamente todos os PDBs em um banco de dados Oracle 12c ou mais recente?
R: Sim, se o banco de dados estiver executando o Oracle Database 12c ou mais recente, o comando abrirá automaticamente todos os Bancos de Dados Plugáveis (PDBs) após a reinicialização do banco de dados.
P: O comando dbaascli database bounce pode ser usado em um ambiente com vários nós ou RAC (Real Application Clusters)?
R: Sim, em um ambiente com vários nós ou RAC, você pode usar a opção --rolling
para reiniciar as instâncias do banco de dados uma a uma, minimizando o tempo de inatividade.
P: O que acontece se eu não especificar a opção --rolling?
R: Se a opção --rolling
não for especificada ou se estiver definida como falsa, o comando fará shutdown e reiniciará todas as instâncias do banco de dados ao mesmo tempo, o que pode causar um breve período de indisponibilidade.
P: Existe um valor padrão para a opção --rolling no comando dbaascli database bounce?
R: Sim, o valor padrão da opção --rolling
é false
, o que significa que o banco de dados será devolvido de forma não incremental, a menos que especificado de outra forma.
P: Como reinicio um banco de dados no modo incremental?
R: Para reiniciar o banco de dados no modo incremental, use a seguinte sintaxe:
dbaascli database bounce --dbname <value> --rolling true
P: É seguro executar o comando dbaascli database bounce durante sessões ativas?
R: Embora o comando use um shutdown imediato, que reverte as transações não confirmadas, é sempre recomendável garantir que não haja sessões críticas ou ativas antes de devolver o banco de dados.
P: Esse comando pode ser usado para PDBs específicos em um banco de dados multitenant?
R: Não, o comando dbaascli database bounce
opera em todo o banco de dados. No Oracle 12c ou posterior, ele retornará o Banco de Dados Contêiner (CDB) e abrirá todos os PDBs, mas não permitirá a devolução de PDBs individuais.
P: O que devo fazer se o banco de dados não voltar a ficar on-line depois de devolvê-lo?
R: Se o banco de dados não for reinicializado, verifique se há erros nos logs durante o processo de shutdown ou inicialização. Investigar os logs de alerta da Oracle pode fornecer informações sobre o que causou o problema.
Exemplo 7-10 dbaascli database bounce
dbaascli database bounce --dbname dbname
Tópico-pai: Database Management
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>]]
--dbname
especifica o nome do Oracle Database no qual você deseja atuar--user
especifica o nome de usuário cuja alteração de senha é necessária--prepareStandbyBlob
especificatrue
para gerar um arquivo blob contendo os artefatos necessários para alterar a senha em um ambiente do Data Guard. Valores válidos:true
|false
--blobLocation
especifica o caminho personalizado no qual o arquivo blob será gerado--standbyBlobFromPrimary
especifica o arquivo blob stand-by, que é preparado no banco de dados principal--resume
especifica para retomar a execução anterior--sessionID
especifica para retomar um ID de sessão específico
Perguntas Frequentes
P: O que o comando dbaascli database changePassword faz?
A: O comando dbaascli database changePassword
é usado para alterar a senha de um usuário do Oracle Database especificado. Será solicitado inserir o nome do usuário e, em seguida, a nova senha.
P: Quais são os pré-requisitos para usar o comando changePassword do banco de dados dbaascli?
R: Você deve executar o comando como o usuário root
ou oracle
para alterar a senha de um usuário do banco de dados.
P: Como eu especifico o banco de dados ao usar este comando?
A: Use a opção --dbname
para especificar o nome do Oracle Database no qual você deseja atuar. Por exemplo:
dbaascli database changePassword --dbname <db_name>
P: Como eu especifico o usuário cuja senha eu quero alterar?
A: Use a opção --user
para especificar o nome de usuário cuja senha precisa ser alterada. Por exemplo:
dbaascli database changePassword --user <username>
P: Qual é a finalidade da opção --prepareStandbyBlob no comando dbaascli database changePassword?
A: A opção --prepareStandbyBlob
é usada nos ambientes do Data Guard para gerar um arquivo blob que contém os artefatos necessários para a alteração de senha no banco de dados stand-by. Isso garante a sincronização da senha no ambiente do Data Guard.
P: O que a opção --blobLocation especifica?
A: A opção --blobLocation
permite especificar um caminho personalizado no qual o arquivo blob stand-by deve ser gerado. Se não for fornecido, o arquivo será salvo no local padrão.
P: Como eu uso o blob gerado do banco de dados principal para alterar a senha no stand-by?
R: Você pode usar a opção --standbyBlobFromPrimary
para especificar o arquivo blob preparado do banco de dados principal para aplicar a alteração de senha ao banco de dados stand-by. Por exemplo:
dbaascli database changePassword --standbyBlobFromPrimary <blob_file_path>
P: Para que é usada a opção --resume neste comando?
A: A opção --resume
é usada para retomar uma operação de alteração de senha interrompida anteriormente. Você pode especificar o ID da sessão, se necessário, usando a opção --sessionID
.
P: Posso retomar uma sessão específica com o comando dbaascli database changePassword?
R: Sim, você pode usar a opção --resume
junto com --sessionID
para retomar uma sessão de alteração de senha específica especificando o ID da sessão.
P: O comando dbaascli database changePassword é aplicável em um ambiente do Data Guard?
A: Sim, é. A opção --prepareStandbyBlob
pode ser usada para garantir que as alterações de senha sejam propagadas para o banco de dados stand-by em uma configuração do Data Guard.
P: O que acontece se eu não fornecer um --blobLocation ao usar --prepareStandbyBlob?
R: Se nenhum --blobLocation
for fornecido, o arquivo blob que contém os artefatos de alteração de senha será salvo no local padrão.
P: Como verifico o status de uma sessão retomada usando o banco de dados dbaascli changePassword?
R: Você pode especificar o ID da sessão usando a opção --sessionID
para retomar uma sessão específica. O sistema continuará de onde parou ao alterar a senha.
P: Esse comando pode ser usado para bancos de dados regulares e para aqueles em um ambiente do Data Guard?
R: Sim, o comando funciona para bancos de dados Oracle regulares e para bancos de dados em um ambiente Data Guard. Em ambientes do Data Guard, opções adicionais como --prepareStandbyBlob
podem ser usadas para gerenciar alterações de senha nos bancos de dados principal e stand-by.
Exemplo 7-11 dbaascli database changePassword
dbaascli database changepassword --dbname db19
Tópico-pai: Database Management
dbaascli database convertToPDB
Para converter em PDB o banco de dados não CDB especificado, use o comando dbaascli database convertToPDB
.
Sintaxe
dbaascli database convertToPDB --dbname <value> [--cdbName <value>] [--executePrereqs]
{
[--copyDatafiles]
| [--backupPrepared]
}
[--targetPDBName <value>] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
--dbname
especifica o nome do Oracle Database--cdbName
especifica o nome do CDB de destino no qual o PDB será criado. Se o CDB não existir, ele será criado no mesmo Oracle home que o não CDB de origem--executePrereqs
especifica para só executar as verificações de pré-conversão--copyDatafiles
especifica para criar uma nova cópia dos arquivos de dados em vez de usar os do banco de dados de origem- Flag
--backupPrepared
para confirmar que um backup de banco de dados adequado está em vigor para o não CDB antes de executar a conversão em PDB --targetPDBName
especifica o nome do PDB que será criado como parte da operação--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
|false
--resume
especifica para retomar a execução anterior--sessionID
especifica para retomar um ID de sessão específico
Perguntas Frequentes
P: O que o comando dbaascli database convertToPDB faz?
R: O comando dbaascli database convertToPDB
converte um Oracle Database não CDB especificado em um PDB (Banco de Dados Plugável) dentro de um CDB (Banco de Dados Contêiner).
P: Como eu especifico qual banco de dados converter?
A: Use a opção --dbname
para especificar o nome do Oracle Database não CDB que você deseja converter. Por exemplo:
dbaascli database convertToPDB --dbname <db_name>
P: Como especifico o CDB de destino para a conversão do PDB?
A: Use a opção --cdbName
para especificar o nome do CDB (Banco de Dados Contêiner) de destino no qual o novo PDB será criado. Se o CDB não existir, um novo será criado no mesmo Oracle home que o não CDB de origem.
P: O que a opção --executePrereqs faz?
A: A opção --executePrereqs
executa verificações de pré-conversão para garantir que o banco de dados esteja pronto para conversão. Nenhuma alteração será feita no banco de dados durante esta etapa.
P: Como faço para copiar os arquivos de dados durante a conversão?
R: Você pode usar a opção --copyDatafiles
para criar uma nova cópia dos arquivos de dados em vez de usar os arquivos originais do banco de dados de origem.
P: Qual é a finalidade da opção --keepSourceDB?
R: A opção --keepSourceDB
permite preservar o não CDB de origem original após a conclusão da operação de conversão. Se você não usar essa opção, o banco de dados de origem será removido após a conversão.
Q: Como eu confirmo que um backup é preparado antes da conversão?
R: Use o flag --backupPrepared
para confirmar que você fez um backup adequado do banco de dados não CDB antes de executar a conversão. Esta etapa é crucial para evitar a perda de dados.
P: Como especifico um nome personalizado para o novo PDB?
A: Use a opção --targetPDBName
para fornecer um nome específico para o novo PDB que será criado como parte da conversão. Por exemplo:
dbaascli database convertToPDB --dbname <db_name> --targetPDBName <pdb_name>
P: Posso executar a conversão em segundo plano?
R: Sim, você pode usar a opção --waitForCompletion
para especificar se a operação deve ser executada em segundo plano. Use false
para executar em segundo plano e true
para aguardar a conclusão da operação antes de continuar. O default é true
.
P: Como retomar uma conversão interrompida anteriormente?
R: Você pode usar a opção --resume
para retomar um processo de conversão interrompido anteriormente. Opcionalmente, você pode fornecer o --sessionID
para retomar uma sessão específica.
P: O que acontece se eu não especificar um nome de CDB?
R: Se a opção --cdbName
não for fornecida, o sistema criará o novo PDB no mesmo Oracle home do banco de dados não CDB de origem.
P: Posso continuar a conversão após uma interrupção sem saber o ID da sessão?
R: Sim, usar a opção --resume
sem especificar um ID de sessão retomará a última sessão conhecida. Se quiser retomar uma sessão específica, você poderá fornecer o --sessionID
.
P: O que a opção --sessionID faz?
A: A opção --sessionID
é usada em conjunto com --resume
para especificar uma sessão específica a ser retomada, caso haja várias sessões interrompidas.
P: É obrigatório ter um backup antes de converter um não CDB em um PDB?
R: Embora o flag --backupPrepared
seja opcional, é altamente recomendável fazer um backup do não CDB antes de executar a conversão para o PDB. Isso garante que você possa restaurar o banco de dados em caso de problemas durante a conversão.
Exemplo 7-12 dbaascli database convertToPDB
dbaascli database convertToPDB --dbname ndb19 --cdbname cdb19 --backupPrepared --executePrereqs
dbaascli database convertToPDB --dbname tst19 --cdbname cdb19 --copyDatafiles
Tópico-pai: Database Management
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]
--dbname
especifica o nome do banco de dados--oracleHome
especifica o local do Oracle home--oracleHomeName
especifica o nome do Oracle home--dbUniqueName
especifica o nome exclusivo do banco de dados--dbSID
especifica o SID do banco de dados--createAsCDB
especificatrue
oufalse
para criar o banco de dados como CDB ou Não CDB--pdbName
especifica o nome do PDB--pdbAdminUserName
especifique o nome do usuário administrador do PDB--dbCharset
especifica o conjunto de caracteres do banco de dados--dbNCharset
especifica o conjunto de caracteres nacionais do banco de dados--dbLanguage
especifica o idioma do banco de dados--dbTerritory
especifica o território do banco de dados--sgaSizeInMB
especifica o valorsga_target
em unidade de megabyte--pgaSizeInMB
especifica o valorpga_aggregate_target
em unidade de megabyte--datafileDestination
especifica o nome do grupo de discos do ASM a ser usado para arquivos de dados do banco de dados--fraDestination
especifica o nome do grupo de discos do ASM a ser usado para a Área de Recuperação Rápida do banco de dados--fraSizeInMB
especifica o valor do tamanho da Área de Recuperação Rápida em unidade de megabyte--nodeList
especifica uma lista de nós delimitados por vírgulas para o banco de dados--tdeConfigMethod
especifica o método de configuração de TDE. Valores válidos:FILE
,KMS
--kmsKeyOCID
especifica o OCID da chave KMS a ser usado para TDE. Isso só será aplicável se o KMS for selecionado para TDE--resume
retoma a execução anterior--revert
faz rollback da execução anterior--sessionID
retoma ou reverte um ID de sessão específico.--executePrereqs
especificayes
para só executar os pré-requisitos desta operação. Valores válidos:yes
ouno
--honorNodeNumberForInstance
especificatrue
oufalse
para indicar se o nome da instância deve ser sufixado com os números de nó do cluster. Valor padrão:true
--lockPDBAdminAccount
especificatrue
oufalse
para bloquear a conta de usuário administrador do PDB. O valor default éverdadeiro
--dbcaTemplateFilePath
especifica o caminho absoluto do nome do modelo de dbca para criar o banco de dados.--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
oufalse
Perguntas Frequentes
P: O que o comando dbaascli database create faz?
R: O comando dbaascli database create
é usado para criar uma nova instância do Oracle Database. Ele suporta a criação do Oracle Database versão 12.1.0.2 ou superior com a atualização de release JAN 2021 ou superior.
P: Como especifico o nome do Oracle Database a ser criado?
A: Use a opção --dbName
para especificar o nome do Oracle Database. Por exemplo:
dbaascli database create --dbName <db_name>
P: Como posso criar um CDB (Banco de Dados Contêiner)?
A: Use a opção --createAsCDB
e especifique verdadeiro para criar o banco de dados como um CDB. Por exemplo:
dbaascli database create --dbName <db_name> --createAsCDB true
P: Como especifico o Oracle Home para o banco de dados?
R: Você pode usar a opção --oracleHome
para especificar o local do Oracle home ou a opção --oracleHomeName
para especificar o nome do Oracle home.
P: Como especifico um nome de banco de dados exclusivo ou SID?
A: Use a opção --dbUniqueName
para especificar um nome exclusivo para o banco de dados e a opção --dbSID
para especificar o SID do banco de dados.
P: Como crio um PDB (Banco de Dados Plugável) junto com um CDB?
R: Você pode usar a opção --pdbName
para especificar o nome do PDB e a opção --pdbAdminUserName
para definir o nome do usuário administrador do PDB. Por exemplo:
dbaascli database create --dbName <db_name> --createAsCDB true --pdbName <pdb_name> --pdbAdminUserName <admin_user>
P: Como posso especificar o conjunto de caracteres do banco de dados e o conjunto de caracteres nacional?
A: Use a opção --dbCharset
para especificar o conjunto de caracteres do banco de dados e a opção --dbNCharset
para especificar o conjunto de caracteres nacionais. Por exemplo:
dbaascli database create --dbName <db_name> --dbCharset AL32UTF8 --dbNCharset AL16UTF16
P: Como defino as definições de memória (SGA e PGA) para o banco de dados?
R: Use a opção --sgaSizeInMB
para especificar o tamanho da SGA e a opção --pgaSizeInMB
para especificar o tamanho da PGA, ambos em megabytes.
P: Como especificar o destino dos arquivos de dados e da Área de Recuperação Rápida (FRA)?
A: Use a opção --datafileDestination
para especificar o grupo de discos ASM para arquivos de dados e a opção --fraDestination
para especificar o grupo de discos ASM para o FRA. Você também pode definir o tamanho FRA com a opção --fraSizeInMB
.
P: Posso configurar a TDE (Transparent Data Encryption) durante a criação do banco de dados?
R: Sim, você pode configurar a TDE usando a opção --tdeConfigMethod
. Os valores válidos são FILE
(para criptografia baseada em arquivo) ou KMS
(para usar o Oracle Key Management Service). Se estiver usando o KMS, forneça o OCID da chave do KMS com a opção --kmsKeyOCID
.
P: Como crio o banco de dados em uma lista específica de nós?
A: Use a opção --nodeList
para especificar uma lista de nós separados por vírgulas em que o banco de dados deve ser criado.
P: Como posso retomar ou reverter uma tentativa anterior de criação de banco de dados?
A: Use a opção --resume
para retomar a execução anterior ou a opção --revert
para fazer rollback da execução anterior. Você também pode especificar um --sessionID
para retomar ou reverter uma sessão específica.
P: O que a opção --executePrereqs faz?
A: A opção --executePrereqs
só executa os pré-requisitos para a operação de criação do banco de dados, sem realmente criar o banco de dados. Utilize yes
ou no
para ativar ou desativar esta opção.
P: Posso especificar um modelo DBCA personalizado para a criação do banco de dados?
R: Sim, use a opção --dbcaTemplateFilePath
para fornecer o caminho absoluto do arquivo de modelo DBCA que deve ser usado para criar o banco de dados.
P: Posso executar a operação de criação do banco de dados em segundo plano?
R: Sim, você pode usar a opção --waitForCompletion
para especificar se o comando deve aguardar a conclusão da criação do banco de dados (true
) ou executar a operação em segundo plano (false
).
P: O que acontece se eu não especificar a opção --dbUniqueName?
R: Se você não especificar um nome exclusivo para o banco de dados usando --dbUniqueName
, o sistema gerará automaticamente um nome com base no --dbName
fornecido.
P: Posso bloquear a conta de administrador do PDB durante a criação de um CDB?
R: Sim, você pode usar a opção --lockPDBAdminAccount
e defini-la como verdadeira para bloquear a conta de administrador do PDB após a criação do banco de dados. Por default, este valor é definido como true
.
Exemplo 7-13 dbaascli database create
dbaascli database create --dbName db19 --oracleHomeName myhome19 --dbSid db19sid --nodeList node1,node2 --createAsCDB true
Tópico-pai: Database Management
dbaascli database createTemplate
Use esse comando para criar modelos de banco de dados (modelos de DBCA) que podem ser usados subsequentemente para criar bancos de dados.
Execute o comando como usuário root
ou oracle
.
Sintaxe
Crie um novo modelo de DBCA com base no banco de dados especificado.
dbaascli database createTemplate --dbname <value>
{
--templateLocation <value> | --uploadToObjectStorage --objectStorageLoginUser <value> --objectStorageBucketName <value> [--objectStorageUrl <value>]
}
[--templateName <value>] [--rmanParallelism <value>]
--dbname
especifica o nome do banco de dados--templateLocation
especifica o nome do modelo--uploadToObjectStorage
: especifica o upload do modelo para o serviço Object Storage--objectStorageLoginUser
: especifica o usuário do log-in do serviço Object Storage--objectStorageBucketName
: especifica o nome do bucket do serviço Object Storage--objectStorageUrl
: especifica o URL do serviço Object Storage
--templateName
: especifica o nome do modelo--rmanParallelism
especifica o valor de paralelismo
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database createTemplate?
R: O comando dbaascli database createTemplate
é usado para criar modelos de banco de dados (modelos DBCA) com base em um banco de dados especificado, que pode ser usado posteriormente para criar novos bancos de dados.
P: Como especifico o nome do banco de dados para o qual quero criar um modelo?
A: Use a opção --dbname
para especificar o nome do Oracle Database do qual o modelo será criado. Por exemplo:
dbaascli database createTemplate --dbname <db_name>
P: Como especificar onde o modelo deve ser salvo?
R: Use a opção --templateLocation
para especificar o local onde o modelo DBCA será salvo. Por exemplo:
dbaascli database createTemplate --dbname <db_name> --templateLocation /path/to/template
P: Posso fazer upload do modelo para o Object Storage diretamente?
R: Sim, você pode usar a opção --uploadToObjectStorage
para fazer upload do modelo DBCA para o Object Storage. Você precisará especificar o usuário de log-in do Object Storage e o nome do bucket com as opções --objectStorageLoginUser
e --objectStorageBucketName
, respectivamente.
P: Como especifico os detalhes de log-in do Object Storage ao fazer upload do modelo?
A: Use as seguintes opções para especificar detalhes do Object Storage:
--objectStorageLoginUser
: Especifica o usuário do log-in do serviço Object Storage.
--objectStorageBucketName
: Especifica o nome do bucket do serviço Object Storage.
--objectStorageUrl
: (Opcional) Especifica o URL do Object Storage se ele for diferente do padrão.
Por exemplo:
dbaascli database createTemplate --dbname <db_name> --uploadToObjectStorage --objectStorageLoginUser <user> --objectStorageBucketName <bucket_name>
P: Como especificar um nome personalizado para o modelo DBCA?
A: Use a opção --templateName
para especificar um nome personalizado para o modelo DBCA. Por exemplo:
dbaascli database createTemplate --dbname <db_name> --templateName <template_name>
P: Para que é usada a opção --rmanParallelism?
A: A opção --rmanParallelism
especifica o nível de paralelismo para operações do RMAN durante o processo de criação do modelo. Por exemplo:
dbaascli database createTemplate --dbname <db_name> --rmanParallelism 4
P: O que acontece se eu não especificar as opções --templateLocation ou --uploadToObjectStorage?
R: Se você não especificar um local de modelo usando --templateLocation
ou optar por fazer upload para o Object Storage usando --uploadToObjectStorage
, o comando não saberá onde armazenar o modelo criado e não será concluído.
P: Posso usar --templateLocation e --uploadToObjectStorage ao mesmo tempo?
R: Não, você deve escolher --templateLocation
para salvar o modelo localmente ou --uploadToObjectStorage
para fazer upload dele no Object Storage, mas não ambos.
P: A opção --objectStorageUrl é obrigatória ao fazer upload do modelo para o Object Storage?
A: Não, a opção --objectStorageUrl
é opcional. Se não for especificado, o URL padrão do Object Storage será usado. Você só precisará especificar isso se estiver usando um URL personalizado do Object Storage.
P: Quais privilégios de usuário são necessários para executar o comando dbaascli database createTemplate?
R: O comando deve ser executado como o usuário root
ou oracle
.
P: Posso retomar um processo de criação de modelo com falha anteriormente?
R: Não, o comando dbaascli database createTemplate
não suporta a retomada de um processo com falha. Você precisará reiniciar o comando desde o início.
Tópico-pai: Database Management
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>]]
--dbname
especifica o nome do banco de dados.--deleteArchiveLogs
especificatrue
oufalse
para indicar a exclusão de logs de arquivamento do banco de dados.--deleteBackups
especificatrue
oufalse
para indicar a exclusão de backups de banco de dados.--precheckOnly
especificayes
para só executar as pré-verificações desta operação. Valores válidos:yes
ouno
.--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
oufalse
.- Flag
–-force
para forçar a exclusão do banco de dados. --dbSID
especifique o SID do banco de dados.--resume
para retomar a execução anterior.-
--sessionID
para retomar um id de sessão específico.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database delete?
R: O comando dbaascli database delete
é usado para excluir um Oracle Database no Exadata Cloud Infrastructure.
P: Como especifico o banco de dados que desejo excluir?
A: Use a opção --dbname
para especificar o nome do Oracle Database que você deseja excluir. Por exemplo:
dbaascli database delete --dbname <db_name>
P: Como excluo os logs de arquivamento ao excluir um banco de dados?
R: Você pode excluir os logs de arquivamento definindo a opção --deleteArchiveLogs
como true
. Por exemplo:
dbaascli database delete --dbname <db_name> --deleteArchiveLogs true
P: Também posso excluir backups ao excluir o banco de dados?
R: Sim, use a opção --deleteBackups
e defina-a como verdadeira para excluir todos os backups associados. Por exemplo:
dbaascli database delete --dbname <db_name> --deleteBackups true
P: Como posso executar apenas as pré-verificações da operação de exclusão sem realmente excluir o banco de dados?
R: Você pode usar a opção --precheckOnly
e defini-la como sim para executar as pré-verificações sem excluir o banco de dados. Por exemplo:
dbaascli database delete --dbname <db_name> --precheckOnly yes
P: Como faço para forçar a exclusão de um banco de dados?
A: Para forçar a exclusão de um banco de dados, use o flag --force
. Isso ignora as verificações e força o processo de exclusão. Por exemplo:
dbaascli database delete --dbname <db_name> --force
P: Como faço para executar a operação de exclusão em segundo plano?
A: Use a opção --waitForCompletion
e defina-a como false
para executar a operação em segundo plano. Por exemplo:
dbaascli database delete --dbname <db_name> --waitForCompletion false
P: Posso especificar o SID do banco de dados que quero excluir?
R: Sim, você pode especificar o SID do banco de dados usando a opção --dbSID
. Por exemplo:
dbaascli database delete --dbname <db_name> --dbSID <sid>
P: Como retomo uma operação de exclusão interrompida anteriormente?
A: Para retomar uma execução de exclusão anterior, use a opção --resume
. Você também pode especificar um ID de sessão usando a opção --sessionID
, se necessário. Por exemplo:
dbaascli database delete --dbname <db_name> --resume --sessionID <session_id>
P: Quais privilégios de usuário são necessários para executar o comando dbaascli database delete?
A: O comando deve ser executado como usuário root
.
P: O que a opção --precheckOnly faz no comando dbaascli database delete?
A: A opção --precheckOnly
permite que você execute apenas as pré-verificações da operação de exclusão sem realmente excluir o banco de dados. Ele garante que todas as verificações sejam aprovadas antes de continuar com a exclusão real.
P: Posso excluir um banco de dados sem aguardar a conclusão da operação?
R: Sim, definindo a opção --waitForCompletion
como falsa, a operação de exclusão será executada em segundo plano e você não precisará esperar que ela seja concluída.
Exemplo 7-14 dbaascli database delete
dbaascli database delete --dbname db19
Tópico-pai: Database Management
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]
--dbname
especifica o nome do Oracle Database--node
especifica o nome do nó para a instância do banco de dados--continueOnUnreachableNode
especifica para executar a operação mesmo que o nó não esteja acessível
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database deleteInstance?
R: O comando dbaascli database deleteInstance
é usado para excluir uma instância específica do Oracle Database em um nó especificado em um ambiente do Exadata Cloud Infrastructure.
P: Como especifico qual instância do Oracle Database excluir?
R: Você pode especificar a instância do Oracle Database a ser excluída usando a opção --dbname
para fornecer o nome do banco de dados e a opção --node
para fornecer o nome do nó. Por exemplo:
dbaascli database deleteInstance --dbname <db_name> --node <node_name>
P: Posso excluir a instância mesmo que o nó esteja inacessível?
R: Sim, você pode usar a opção --continueOnUnreachableNode
para continuar com a exclusão, mesmo que o nó especificado esteja inacessível. Por exemplo:
dbaascli database deleteInstance --dbname <db_name> --node <node_name> --continueOnUnreachableNode
P: O que acontece se o nó especificado estiver inacessível durante a operação de exclusão da instância?
R: Se o nó estiver inacessível e a opção --continueOnUnreachableNode
não for usada, a operação falhará. Se a opção for usada, a operação continuará mesmo que o nó não possa ser acessado.
P: Como excluo uma instância de banco de dados de um nó específico?
A: Use o seguinte comando para excluir uma instância de banco de dados de um nó específico:
dbaascli database deleteInstance --dbname <db_name> --node <node_name>
P: Quais privilégios de usuário são necessários para executar o comando dbaascli database deleteInstance?
A: O comando deve ser executado como usuário root
.
P: Posso excluir uma instância sem especificar o nó?
R: Não, a opção --node
é necessária para especificar de qual nó a instância do banco de dados deve ser excluída.
P: O que a opção --continueOnUnreachableNode faz?
R: A opção --continueOnUnreachableNode
permite que a operação prossiga mesmo que o nó especificado não possa ser atingido, garantindo que a exclusão da instância continue em cenários em que o nó possa estar inativo.
P: É possível excluir várias instâncias de banco de dados de uma só vez usando este comando?
R: Não, o comando dbaascli database deleteInstance
é usado para excluir uma única instância do banco de dados em um nó especificado de cada vez. Você precisaria executar o comando separadamente para cada instância que deseja excluir.
Exemplo 7-15 database deleteinstance
database deleteinstance --node test-node
Tópico-pai: Database Management
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>]
--dbName
especifica o nome do Oracle Database--sourceDBConnectionString
especifica a string de conexão do banco de dados de origem no formato<scan_name>:<scan_port>/<database_service_name>
--oracleHome
especifica o local do Oracle home--oracleHomeName
especifica o nome do Oracle home--dbSID
especifica o SID do banco de dados--dbUniqueName
especifica o nome exclusivo do banco de dados--sgaSizeInMB
especifica o valorsga_target
na unidade de megabyte--pgaSizeInMB
especifica o valorpga_aggregate_target
na unidade de megabyte--datafileDestination
especifica o nome do grupo de discos do ASM a ser usado para arquivos de dados do banco de dados--fraDestination
especifica o nome do grupo de discos do ASM a ser usado para a área de recuperação rápida do banco de dados--fraSizeInMB
especifica o valor do tamanho da área de recuperação rápida em unidade de megabyte--sourceDBWalletLocation
especifica a localização do arquivo da wallet de TDE do banco de dados de origem. Isso é necessário para duplicar o banco de dados do banco de dados ativo--nodeList
especifica uma lista de nós delimitados por vírgulas para o banco de dados--resume
especifica para retomar a execução anterior--sessionID
especifica para retomar um ID de sessão específico
--revert
especifica para fazer rollback da execução anterior--sessionID
especifica para fazer rollback de um ID de sessão específico
--rmanParallelism
especifica o valor do paralelo--rmanSectionSizeInGB
especifica o tamanho da seção do RMAN em GB--tdeConfigMethod
especifica o método de configuração de TDE. Os valores permitidos sãoFILE
eKMS
.--kmsKeyOCID
especifica o OCID da chave KMS a ser usado para TDE. Isso só será aplicável se o KMS for selecionado para TDE.--sourceDBTdeConfigMethod
especifica o método de configuração de TDE do banco de dados de origem. Os valores permitidos sãoFILE
eKMS
.--sourceDBKmsKeyOCID
especifica o OCID da chave KMS do banco de dados de origem a ser usado para TDE. Isso só será aplicável se o KMS for selecionado para TDE.--executePrereqs
especificayes
para só executar os pré-requisitos desta operação. Valores válidos:yes
|no
--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
|false
--skipPDBs
especifica uma lista delimitada por vírgulas de nomes de PDB do banco de dados de origem, que precisa ser excluída da operação de banco de dados duplicada. Exemplo: pdb1,pdb2...
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database duplicate?
R: O comando dbaascli database duplicate
é usado para criar um novo Oracle Database duplicando um banco de dados ativo existente.
P: Quais são os pré-requisitos para usar o comando duplicado do banco de dados dbaascli?
R: Execute o comando como usuário root
.
P: Como especificar o banco de dados de origem para duplicação?
A: Use a opção --sourceDBConnectionString
para fornecer a string de conexão do banco de dados de origem no formato <scan_name>:<scan_port>/<database_service_name>
. Por exemplo:
--sourceDBConnectionString <scan_name>:<scan_port>/<database_service_name>
P: Como especifico o local do Oracle Home para o novo banco de dados?
R: Você pode especificar o local do Oracle Home usando a opção --oracleHome
ou o nome do Oracle Home usando a opção --oracleHomeName
. Por exemplo:
--oracleHome <value>
ou
--oracleHomeName <value>
P: Qual é a finalidade da opção --sourceDBWalletLocation?
A: A opção --sourceDBWalletLocation
especifica o local do arquivo da wallet de TDE do banco de dados de origem, que é obrigatório para duplicar o banco de dados de um banco de dados de origem ativo.
P: Posso ignorar a duplicação de PDBs específicos do banco de dados de origem?
R: Sim, você pode usar a opção --skipPDBs
para especificar uma lista delimitada por vírgulas de nomes de PDB que devem ser excluídos da operação duplicada. Por exemplo:
--skipPDBs pdb1,pdb2
P: Como configuro a TDE para o novo banco de dados?
A: Use a opção --tdeConfigMethod
para especificar o método de configuração de TDE (FILE
ou KMS
). Se você escolher KMS
, poderá fornecer o OCID da chave KMS
usando a opção --kmsKeyOCID
. Por exemplo:
--tdeConfigMethod FILE
ou
--tdeConfigMethod KMS --kmsKeyOCID <value>
P: O que a opção --executePrereqs faz?
A: A opção --executePrereqs
especifica se apenas as verificações de pré-requisito devem ser executadas para a operação. Os valores válidos são yes
para executar somente pré-requisitos ou no
para continuar com a operação completa.
P: Como posso retomar uma operação duplicada interrompida anteriormente?
A: Use a opção --resume
junto com a opção --sessionID
para retomar uma operação duplicada interrompida anteriormente. Por exemplo:
--resume --sessionID <value>
P: O que a opção --waitForCompletion faz?
A: A opção --waitForCompletion
especifica se a operação deve ser concluída. A definição dessa opção como true
aguarda conclusão, enquanto false
executa a operação em segundo plano. Por exemplo:
--waitForCompletion true
P: Qual é a finalidade da opção --rmanParallelism?
A: A opção --rmanParallelism
especifica o valor de paralelismo do RMAN (Recovery Manager) durante o processo de duplicação. Isso pode melhorar a velocidade da operação de duplicação usando vários processos paralelos.
P: Como especifico o tamanho da SGA e da PGA para o novo banco de dados?
R: Use as opções --sgaSizeInMB
e --pgaSizeInMB
para especificar os tamanhos da SGA (Área Global do Sistema) e da PGA (Área Global do Programa) em megabytes, respectivamente. Por exemplo:
--sgaSizeInMB <value>
--pgaSizeInMB <value>
P: O que a opção --revert faz?
A: A opção --revert
é usada para fazer rollback de uma operação duplicada anterior. Você precisa fornecer o --sessionID
para especificar qual sessão reverter.
Exemplo 7-16 dbaascli database duplicate
dbaascli database duplicate --sourceDBConnectionString test-user-scan.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521/mynew.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --dbName newdup --sourceDBWalletLocation /var/opt/oracle/dbaas_acfs/tmp/prim_wallet
Tópico-pai: Database Management
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?
A: O comando pode ser executado pelo usuário root
ou pelo usuário oracle
.
P: O que a opção --dbname especifica no comando dbaascli database getDetails?
A: A opção --dbname
especifica o nome do banco de dados Oracle para o qual informações detalhadas estão sendo recuperadas.
P: Que tipo de informação o comando dbaascli database getDetails fornece?
R: O comando fornece detalhes como nome do banco de dados, informações do nó e informações sobre bancos de dados plugáveis (PDBs) associados ao banco de dados contêiner.
Tópico-pai: Database Management
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>
--dbname
especifica o nome do banco de dados contêiner
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database getPDBs?
R: O comando dbaascli database getPDBs
é usado para listar todos os bancos de dados plugáveis (PDBs) em um banco de dados contêiner (CDB) especificado.
P: Como especifico o banco de dados contêiner para o comando getPDBs?
A: Você usa a opção --dbname
para especificar o nome do banco de dados contêiner. Por exemplo:
--dbname <value>
P: Eu preciso executar o comando dbaascli database getPDBs como um usuário específico?
R: Sim, execute o comando como usuário root
ou o usuário oracle
.
P: Posso exibir PDBs em um banco de dados não CDB usando o comando getPDBs?
R: Não, o comando getPDBs só é aplicável a bancos de dados contêineres (CDBs). Não é possível usar esse comando para bancos de dados não CDB.
P: Qual é o formato da saída do comando dbaascli database getPDBs?
R: O comando retorna uma lista de todos os PDBs dentro do banco de dados contêiner especificado. A saída geralmente inclui nomes de PDB, status e outros detalhes relevantes sobre cada banco de dados plugável.
P: Este comando pode ser usado para vários bancos de dados de uma só vez?
R: Não, o comando dbaascli database getPDBs
funciona com um único banco de dados contêiner por vez, especificado pela opção --dbname
.
P: É necessário fazer shutdown do banco de dados para usar o comando getPDBs?
R: Não, o comando getPDBs
não requer que o banco de dados seja submetido a shutdown. Ele pode ser executado enquanto o banco de dados contêiner está operacional.
Exemplo 7-17 dbaascli database getPDBs --dbname
dbaascli database getPDBs --dbname apr_db1
Tópico-pai: Database Management
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]
--dbname
especifica o nome do banco de dados.--setParameters
especifica uma lista de parâmetros delimitados por vírgulas a serem modificados com novos valores. Por exemplo:parameter1=valueA
,parameter2=valueB
e assim por diante. Para valores em branco, use parameter1=valueA,parameter2='',etc.--resetParameters
especifica uma lista de parâmetros delimitados por vírgulas a serem redefinidos para seus valores padrão correspondentes. Por exemplo,parameter1
,parameter2
e assim por diante.--instance
especifica o nome da instância na qual os parâmetros serão processados. Se não for especificado, a operação será executada no nível do banco de dados.--backupPrepared
confirma que há um backup adequado do banco de dados antes de modificar parâmetros críticos ou confidenciais.--allowBounce
concede permissão para devolver o banco de dados a fim de refletir as alterações nos parâmetros estáticos aplicáveis.--waitForCompletion
especifique false para executar a operação em segundo plano. Valores válidos : true|false.]
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database modifyParameters?
A: O comando dbaascli database modifyParameters
é usado para modificar ou redefinir parâmetros de inicialização do Oracle Database.
P: Como eu especifico o banco de dados cujos parâmetros eu quero modificar?
R: Você deve usar a opção --dbname
para especificar o nome do banco de dados para o qual deseja modificar ou redefinir parâmetros.
P: Como posso modificar os parâmetros do banco de dados usando o comando modifyParameters?
A: Use a opção --setParameters
seguida de uma lista de parâmetros delimitados por vírgulas e seus novos valores. Por exemplo:
--setParameters parameter1=valueA,parameter2=valueB
P: Como redefino parâmetros para seus valores padrão usando este comando?
A: Use a opção --resetParameters
seguida de uma lista de parâmetros delimitados por vírgulas para redefinir seus valores padrão. Por exemplo:
--resetParameters parameter1,parameter2
P: Posso modificar parâmetros usando um arquivo de resposta?
R: Sim, você pode especificar a localização absoluta de um arquivo JSON de resposta usando a opção --responseFile
. O arquivo deve conter os parâmetros que você deseja modificar.
P: É necessário fazer um backup antes de modificar os parâmetros?
R: Embora não seja obrigatório para todas as alterações, se você estiver modificando parâmetros críticos ou confidenciais, é recomendável ter um backup em vigor. Você pode usar a opção --backupPrepared
para confirmar que um backup foi preparado.
P: Posso aplicar alterações apenas a uma instância específica em um banco de dados de várias instâncias?
R: Sim, você pode especificar o nome da instância usando a opção --instance
. Se esta opção não for usada, as alterações serão aplicadas no nível do banco de dados.
P: O banco de dados precisará ser devolvido (reiniciado) após a modificação dos parâmetros?
R: Para alguns parâmetros estáticos, é necessário um bounce do banco de dados. Você pode usar a opção --allowBounce
para conceder permissão para que o banco de dados seja devolvido, se necessário.
P: O que acontece se eu não permitir que o banco de dados seja devolvido ao alterar parâmetros estáticos?
R: Se você não usar a opção --allowBounce
ao modificar parâmetros estáticos, as alterações não entrarão em vigor até a próxima reinicialização manual do banco de dados.
P: Posso retomar a modificação de parâmetros se uma sessão anterior foi interrompida?
R: Não, este comando não suporta a retomada da sessão. Você precisará executar o comando novamente desde o início.
Exemplo 7-18 dbaascli database modifyParameters
dbaascli database modifyParameters --dbname dbname --setParameters "log_archive_dest_state_17=ENABLE"
Tópico-pai: Database Management
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 7-19 Exemplos
- Para recuperar o banco de dados myTestDb para o mais recente:
dbaascli database recover --dbname myTestDb --start --latest
- Para consultar o status da solicitação de recuperação submetida com
uuid
2508ea18be2911eb82d0020017075151:dbaascli database recover --dbname myTestDb --status --uuid 2508ea18be2911eb82d0020017075151
Tópico-pai: Database Management
dbaascli database runDatapatch
Para aplicar patch em um Banco de Dados Oracle, use o comando dbaascli database runDatapatch
.
Pré-requisitos
-
Antes de executar uma operação
runDatapatch
, verifique se todas as instâncias associadas do banco de dados estão em funcionamento. -
Execute o comando como usuário
root
.
Sintaxe
dbaascli database runDatapatch --dbname
[--resume]
[--sessionID]
[--skipPdbs | --pdbs]
[--executePrereqs]
[--patchList]
[--skipClosedPdbs]
[--rollback]
Em que:
--dbname
especifica o nome do banco de dados--resume
retoma a execução anterior--sessionID
especifica para retomar um ID de sessão específico
--skipPdbs
ignora a execução do datapatch em uma lista especificada de PDBs delimitados por vírgulas. Por exemplo: pdb1,pdb2...--pdbs
executa o datapatch somente em uma lista delimitada por vírgulas de PDBs especificada. Por exemplo: pdb1,pdb2...--executePrereqs
executa verificações de pré-requisitos--patchList
aplica ou faz rollback da lista especificada de patches delimitados por vírgulas. Por exemplo: patch1,patch2...--skipClosedPdbs
ignora a execução do datapatch em PDBs fechados--rollback
faz rollback dos patches aplicados
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database runDatapatch?
R: O comando dbaascli database runDatapatch
é usado para aplicar patches a um Oracle Database.
P: O que deve ser garantido antes de executar o comando dbaascli database runDatapatch?
R: Antes de executar o comando, certifique-se de que todas as instâncias do banco de dados estejam ativas e em execução.
P: Como especificar qual banco de dados aplicar patch?
A: Use a opção --dbname
seguida pelo nome do banco de dados. Por exemplo:
--dbname myDatabase
P: Como retomo uma operação runDatapatch interrompida anteriormente?
A: Use a opção --resume
para retomar a execução anterior ou a opção --sessionID
para especificar um ID de sessão específico. Por exemplo:
--resume
--sessionID 12345
P: Como posso ignorar determinados PDBs ao executar o patch?
A: Use a opção --skipPdbs
seguida de uma lista delimitada por vírgulas de nomes de PDB a serem ignorados. Por exemplo:
--skipPdbs pdb1,pdb2
P: Como posso executar o patch apenas em determinados PDBs?
A: Use a opção --pdbs
seguida de uma lista delimitada por vírgulas de nomes de PDB a serem incluídos. Por exemplo:
--pdbs pdb1,pdb2
P: Como aplicar ou reverter um conjunto específico de patches?
A: Use a opção --patchList
seguida de uma lista delimitada por vírgulas de nomes de patch para aplicar ou fazer rollback. Por exemplo:
--patchList patch1,patch2
P: O que a opção --rollback faz?
A: A opção --rollback
faz rollback dos patches que foram aplicados durante a operação de aplicação de patch.
P: O que acontece se alguns PDBs forem fechados durante a operação de aplicação de patch?
R: Se alguns PDBs estiverem fechados, você poderá usar a opção --skipClosedPdbs
para ignorar a aplicação de patch nesses PDBs fechados.
P: Posso executar verificações de pré-requisitos antes de aplicar patches?
R: Sim, use a opção --executePrereqs
para executar verificações de pré-requisitos antes de aplicar o patch.
P: Como descubro qual ID de sessão retomar um patch?
R: Após uma operação runDatapatch
, o ID da sessão geralmente é registrado. Use a opção --sessionID
para especificar esse ID ao retomar um patch. Por exemplo:
--sessionID 67890
dbaascli database runDatapatch --dbname db19
Tópico-pai: Database Management
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]
--dbname
especifica o nome do banco de dados--mode
especifica montagem ou não montagem para iniciar o banco de dados no modo correspondente
O comando inicia e abre o banco de dados. No Oracle Database 12c ou mais recente, todos os PDBs também são abertos.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database start?
A: O comando dbaascli database start
é usado para iniciar um Oracle Database.
P: O que deve ser feito antes de executar o comando dbaascli database start?
A: O comando deve ser executado como usuário root
.
P: Como eu especifico o banco de dados que quero iniciar?
A: Use a opção --dbname
seguida pelo nome do banco de dados. Por exemplo:
--dbname myDatabase
P: Quais são os modos possíveis em que posso iniciar o banco de dados?
R: Você pode iniciar o banco de dados no modo mount
ou nomount
usando a opção --mode
. Por exemplo:
--mode mount
P: Qual é o modo padrão se eu não especificar um?
R: Se você não especificar um modo, o banco de dados será iniciado no modo open
padrão.
P: Este comando abrirá todos os PDBs no Oracle Database 12c ou posterior?
R: Sim, ao iniciar o banco de dados no Oracle Database 12c ou mais recente, todos os bancos de dados plugáveis (PDBs) também serão abertos.
P: Como posso iniciar um banco de dados no modo nomount?
A: Use a opção --mode
e defina-a como nomount
. Por exemplo:
--mode nomount
P: Como posso iniciar um banco de dados no modo de montagem?
A: Use a opção --mode
e defina-a para montar. Por exemplo:
--mode mount
P: É obrigatório especificar um nome de banco de dados ao executar o comando dbaascli database start?
R: Sim, é recomendável especificar o nome do banco de dados usando a opção --dbname
para garantir que o banco de dados correto seja iniciado.
Exemplo 7-20 dbaascli database start
dbaascli database start --dbname dbname --mode mount
Tópico-pai: Database Management
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>]
--dbname
especifica o nome do banco de dados que você deseja interromper--mode
especifica o modo do banco de dados. Valores válidos:abort
,immediate
,normal
,transactional
O comando executa um shutdown do banco de dados no modo imediato. Não são permitidas novas conexões ou novas transações. As transações ativas são revertidas e todos os usuários conectados são desconectados.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database stop?
A: O comando dbaascli database stop
é usado para interromper um Oracle Database.
P: Quais são os pré-requisitos para usar o comando dbaascli database stop?
R: Execute o comando como usuário root
e estabeleça conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH.
P: Como especificar qual banco de dados interromper?
R: Você pode especificar o banco de dados usando a opção --dbname
seguida pelo nome do banco de dados. Por exemplo:
--dbname myDatabase
P: Quais são os modos de shutdown válidos do comando de interrupção do banco de dados dbaascli?
A: Os modos de shutdown válidos são:
abort
immediate
normal
transactional
P: Qual será o modo de shutdown padrão se nenhum modo for especificado?
R: Se nenhum modo for especificado, o banco de dados será submetido a shutdown no modo immediate
por padrão.
P: O que acontece no modo de desligamento imediato?
R: No modo immediate
, nenhuma conexão ou transação nova é permitida, as transações ativas são submetidas a rollback e todos os usuários conectados são desconectados.
P: Como posso interromper o banco de dados no modo de aborto?
R: Para interromper o banco de dados no modo de aborto, use a opção --mode
com abortar. Por exemplo:
--mode abort
P: O que o modo normal faz ao interromper o banco de dados?
R: No modo normal, o banco de dados permite que as sessões atuais do usuário sejam concluídas e, em seguida, interrompidas sem afetar as transações ativas.
P: Para que é usado o modo transacional no comando de interrupção do banco de dados dbaascli?
R: No modo transactional
, o banco de dados é interrompido somente depois que todas as transações ativas são concluídas, mas nenhuma nova transação é permitida.
P: É obrigatório especificar o modo de shutdown no comando de interrupção do banco de dados dbaascli?
A: Não, especificar um modo shutdown
é opcional. Se não for informado, o modo imediato padrão será usado.
Exemplo 7-21 dbaascli database stop
dbaascli database stop --dbname db19
Tópico-pai: Database Management
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.--targetHome
especifica o local do Oracle home de destino--targetHomeName
especifica o nome do home do Banco de Dados Oracle de destino--standBy
use esta opção para fazer upgrade de bancos de dados stand-by nas configurações do Data Guard--allStandbyPrepared
obrigatório para bancos de dados principais configurados pelo Data Guard. Flags para confirmar que todas as operações obrigatórias foram executadas nos bancos de dados stand-by antes de fazer upgrade do banco de dados principal--removeGRP
só remove automaticamente o backup de Ponto de Restauração Garantido (GRP) se o upgrade do banco de dados foi bem-sucedido--increaseCompatibleParameter
aumenta automaticamente o parâmetro compatível como parte do upgrade do banco de dados. O parâmetro só será aumentado se o upgrade do banco de dados tiver sido bem-sucedido--executePrereqs
executa apenas as verificações de pré-upgrade--postUpgrade
use esta opção se o pós-upgrade falhar e precisar executar novamente as etapas pós-upgrade--rollback
reverte um Oracle Database para seu Oracle home original--upgradeOptions
use esta opção para transmitir argumentos específicos do DBUA para executar o upgrade do Oracle Database. Consulte a documentação correspondente da Oracle para obter os argumentos e as opções com suporte.--standby
--resume
para retomar a execução anterior-
--sessionID
para retomar um id de sessão específico. --waitForCompletion
especifique false para executar a operação em segundo plano. Valores válidos : true|false.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli database upgrade?
R: O comando dbaascli database upgrade
é usado para fazer upgrade de um Oracle Database para uma nova versão.
P: Quais são os pré-requisitos para usar o comando dbaascli database upgrade?
R: Você deve executar o comando como usuário root
e estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH.
P: Como eu especifico o banco de dados que precisa ser atualizado?
A: Use a opção --dbname
seguida pelo nome do banco de dados. Por exemplo:
--dbname myDatabase
P: Como posso especificar o Oracle home de destino para o upgrade?
R: Você pode especificar o local do Oracle home de destino com a opção --targetHome
ou o nome do home do Oracle Database de destino com a opção --targetHomeName
.
P: O que a opção --standBy faz?
A: A opção --standBy
é usada para fazer upgrade de bancos de dados stand-by nas configurações do Data Guard.
P: Qual é a finalidade do flag --allStandbyPrepared?
R: O flag --allStandbyPrepared
reconhece que todas as operações necessárias em bancos de dados stand-by foram executadas antes do upgrade do banco de dados principal em uma configuração do Data Guard.
P: O que a opção --removeGRP faz?
A: A opção --removeGRP
removerá automaticamente o backup de Ponto de Restauração Garantido (GRP) se o upgrade do banco de dados for bem-sucedido.
P: Quando devo usar a opção --increaseCompatibleParameter?
R: Use a opção --increaseCompatibleParameter
para aumentar automaticamente o parâmetro compatível durante o upgrade do banco de dados, desde que o upgrade seja bem-sucedido.
P: O que a opção --executePrereqs faz?
A: A opção --executePrereqs
executa apenas as verificações de pré-upgrade para garantir que o banco de dados esteja pronto para o upgrade.
P: Como lidar com uma etapa de pós-upgrade com falha?
A: Use a opção --postUpgrade
para executar novamente as etapas de pós-upgrade se a tentativa inicial de pós-upgrade falhar.
P: Qual é o propósito da opção --revert?
A: A opção --revert
reverte o Oracle Database ao seu Oracle home original, desfazendo o upgrade.
P: Como posso passar argumentos adicionais específicos do DBUA para o upgrade?
A: Use a opção --upgradeOptions
para transmitir argumentos específicos do DBUA para o upgrade do Oracle Database. Consulte a documentação da Oracle para obter os argumentos e as opções com suporte.
P: É obrigatório especificar o Oracle home de destino para o upgrade?
R: Sim, você deve especificar --targetHome
ou --targetHomeName
para indicar o Oracle home de destino para o upgrade.
P: O que devo fazer se precisar executar uma verificação de pré-upgrade, mas não continuar com o upgrade?
R: Use a opção --executePrereqs
para executar somente as verificações de pré-upgrade sem continuar com o upgrade real.
Exemplo 7-22 dbaascli database upgrade pre-upgrade requisite checks
dbaascli database upgrade --dbbname dbname --targetHome Target Oracle home location --executePrereqs
Tópico-pai: Database Management
Gerenciamento do Data Guard
Esta seção se concentra no gerenciamento de configurações e operações do Oracle Data Guard. Ele inclui comandos como dbaascli dataguard prepareStandbyBlob
para gerar um arquivo blob para configurar um site stand-by e dbaascli dataguard updateDGConfigAttributes
para atualizar atributos de automação do Data Guard em todos os nós do cluster. Esses comandos simplificam a configuração e a manutenção de ambientes do Data Guard para alta disponibilidade e recuperação de desastres.
- dbaascli dataguard prepareStandbyBlob
Para gerar um arquivo blob contendo vários arquivos necessários no site stand-by no caso de um ambiente do dataguard, use o 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 dataguard failover
Para executar um failover manual no banco de dados stand-by, use o comandodataguard failover
. - dbaascli dataguard reinstate
Para restabelecer um banco de dados com falha como banco de dados stand-by após um failover, use o comandodataguard reinstate
. - dbaascli dataguard switchover
Para executar um switchover para o banco de dados stand-by, use o comandodataguard switchover
. - dbaascli dataguard prepareForStandby
Para criar um Banco de Dados Oracle Stand-by, use o comandodbaascli dataguard prepareForStandby
como primeira etapa. - dbaascli dataguard configureStandby
Para criar um novo Banco de Dados Stand-by, use o comandodbaascli dataguard configureStandby
como segunda etapa após a etapaprepareForStandby
. - dbaascli dataguard registerStandby
Para registrar um banco de dados stand-by recém-criado com todos os bancos de dados stand-by existentes e com o banco de dados principal, use o comandodbaascli dataguard registerStandby
como terceira etapa após a etapaconfigureStandby
. - dbaascli dataguard deregisterStandby
Durante a exclusão do stand-by, execute o comandodbaascli dataguard deregisterStandby
antes de excluir o banco de dados no cluster stand-by para cancelar o registro do banco de dados stand-by na configuração do Oracle Data Guard Broker. - dbaascli dataguard configureAWR
Para ativar ou desativar a configuração do AWR (Automatic Workload Repository) no seu stand-by Active Data Guard, use o comandodbaascli dataguard configureAWR
. - dbaascli dataguard updateConfiguration
Para atualizar o modo de transporte ou o modo de proteção ou os dois parâmetros de um ambiente do Data Guard, use o comandodbaascli dataguard updateConfiguration
.
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>
--dbname
especifica o nome do Oracle Database--blobLocation
especifica a localização do diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do Data Guard
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli dataguard prepareStandbyBlob?
A: O comando dbaascli dataguard prepareStandbyBlob
é usado para gerar um arquivo blob contendo vários arquivos necessários no site stand-by em um ambiente do Data Guard.
P: Quais são os pré-requisitos para executar o comando dbaascli dataguard prepareStandbyBlob?
A: O comando deve ser executado como usuário root
ou oracle
.
P: Como especifico o nome do Oracle Database para o qual quero preparar o blob stand-by?
A: Use a opção --dbname
seguida pelo nome do Oracle Database. Por exemplo:
--dbname myDatabase
P: Como especificar o local onde o arquivo blob stand-by será gerado?
R: Use a opção --blobLocation
para especificar o caminho do diretório personalizado no qual o arquivo blob stand-by será gerado. Por exemplo:
--blobLocation
/path/to/standby_blob
P: O que a opção --dbname faz no comando?
A: A opção --dbname
especifica o nome do Oracle Database para o qual o arquivo blob stand-by está sendo preparado.
P: Qual é a finalidade da opção --blobLocation?
A: A opção --blobLocation
define o caminho do diretório personalizado no qual o arquivo blob stand-by será criado.
P: Posso executar o comando dbaascli dataguard prepareStandbyBlob como usuário diferente do root ou do oracle?
R: Não, o comando deve ser executado como o usuário root
ou oracle
.
P: É possível usar um caminho relativo para a opção --blobLocation?
R: Recomenda-se usar um caminho absoluto para a opção --blobLocation
para garantir que o arquivo blob stand-by seja criado no diretório correto.
P: O que devo fazer se eu quiser alterar o local onde o arquivo blob stand-by é gerado?
A: Modifique a opção --blobLocation
para especificar um novo caminho de diretório para o arquivo blob stand-by.
P: Preciso executar alguma etapa adicional após gerar o arquivo blob stand-by?
R: Sim, depois de gerar o arquivo blob stand-by, você precisa transferi-lo para o site stand-by e usá-lo para a configuração do Data Guard.
Tópico principal: Data Guard Management
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>
--attributes
contém os atributos de automação do Data Guard que devem ser modificados. Aceita valores delimitados por vírgula no formato <attribute=value>. Os atributos devem ser predefinidos no arquivo de configuração do Data Guard.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli dataguard updateDGConfigAttributes?
A: O comando dbaascli dataguard updateDGConfigAttributes
é usado para atualizar os atributos de automação do Data Guard em todos os nós do cluster.
P: Quais são os pré-requisitos para executar o comando dbaascli dataguard updateDGConfigAttributes?
A: O comando deve ser executado como o usuário root
ou oracle
.
P: Como especifico os atributos que desejo atualizar usando este comando?
A: Use a opção --attributes
seguida pelos atributos a serem modificados. Os atributos devem estar em um formato delimitado por vírgulas, como attribute=value
. Por exemplo:
--attributes attribute1=value1,attribute2=value2
P: Em qual formato os valores da opção --attributes devem estar?
R: Os valores da opção --attributes
devem estar em um formato delimitado por vírgulas com cada atributo especificado como attribute=value
.
P: Posso especificar vários atributos na opção --attributes?
R: Sim, você pode especificar vários atributos separando-os com vírgulas. Por exemplo:
--attributes attribute1=value1,attribute2=value2
P: O que acontece se eu fornecer um atributo que não seja predefinido no arquivo de configuração do Data Guard?
R: Se você fornecer um atributo que não seja predefinido, o comando poderá falhar ou ignorar o atributo não reconhecido. Certifique-se de que todos os atributos sejam predefinidos no arquivo de configuração do Data Guard.
P: Preciso reiniciar algum serviço após atualizar os atributos de automação do Data Guard?
R: Na maioria dos casos, você não precisa reiniciar os serviços após atualizar os atributos. No entanto, verifique os atributos específicos e seu impacto para determinar se é necessário reiniciar.
P: Como posso verificar se os atributos do Data Guard foram atualizados com sucesso?
R: Após executar o comando, você pode verificar os atributos atualizados verificando a configuração do Data Guard ou usando comandos/ferramentas de verificação apropriados específicos à sua configuração.
P: O que devo fazer se o comando não atualizar os atributos?
R: Verifique as mensagens de erro para obter detalhes sobre o que deu errado. Verifique se você especificou os atributos corretos e se eles estão predefinidos no arquivo de configuração do Data Guard. Verifique as permissões do usuário e a sintaxe do comando.
P: É possível atualizar atributos apenas para nós específicos usando este comando?
R: Não, o comando dbaascli dataguard updateDGConfigAttributes
atualiza atributos em todos os nós do cluster. Se precisar atualizar atributos para nós específicos, talvez seja necessário usar métodos ou comandos diferentes.
Tópico principal: Data Guard Management
dbaascli dataguard failover
Para executar um failover manual no banco de dados stand-by, use o comando dataguard failover
.
Execute este comando como o usuário oracle
no banco de dados stand-by de destino.
Sintaxe
dbaascli dataguard failover --dbname <value> [--useImmediateFailover] [--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
--dbname
especifica o nome do Oracle Database.--useImmediateFailover
usa esse flag quando a configuração do Oracle Data Guard está em um estado de advertência ou erro.--executePrereqs
executa as verificações de pré-requisito e reporta os resultados.--waitForCompletion
especifica se deseja aguardar a conclusão da operação. Defina comofalse
para executar a operação no segundo plano. Valores válidos:true
|false
.--resume
retoma a operação anterior.--sessionID
retoma uma sessão específica por seu ID.
- Executando uma Operação de Failover Manual Usando o Utilitário dbaascli
Para executar um failover manual para o banco de dados stand-by, use o comandodataguard failover
.
Tópico principal: Gerenciamento do Data Guard
Executando uma Operação de Failover Manual com o Utilitário dbaascli
Para executar um failover manual no banco de dados stand-by, use o comando dataguard failover
.
Tópico principal: dbaascli dataguard failover
dbaascli dataguard reintegrado
Para restabelecer um banco de dados com falha como banco de dados stand-by após um failover, use o comando dataguard reinstate
.
Execute esse comando como o usuário oracle
no qual a reintegração é necessária (que é o banco de dados stand-by com falha).
Sintaxe
dbaascli dataguard reinstate --dbname <value> [--primaryDBUniqueName <value>] [--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
--dbname
especifica o nome do Oracle Database.--primaryDBUniqueName
especifica o nome exclusivo do banco de dados principal atual na configuração do Oracle Data Guard.--executePrereqs
executa as verificações de pré-requisito e reporta os resultados.--waitForCompletion
especifica se deve aguardar a conclusão da operação. Defina comofalse
para executar a operação no segundo plano. Valores válidos:true
|false
.--resume
retoma a operação anterior.--sessionID
retoma uma sessão específica por seu ID.
Para determinar quando um membro deve ser reintegrado em uma configuração do Data Guard (DG):
Monitore a saída dgmgrl show database
para os seguintes erros ORA:
- No novo cluster principal:
ORA-16661: O banco de dados stand-by deve ser reintegrado
- No cluster principal antigo:
ORA-16623: Alteração de atribuição detectada pelo membro
Essas mensagens indicam que ocorreu um failover. Para restaurar a sincronização completa na configuração do Data Guard, o principal anterior deve ser restabelecido.
- Reintegrando um Banco de Dados Principal com Falha Usando o Utilitário dbaascli
Para restabelecer um banco de dados principal com falha após um failover, use o comandodataguard reinstate
.
Tópico principal: Gerenciamento do Data Guard
Reintegrando um Banco de Dados Principal com Falha Usando o Utilitário dbaascli
Para restabelecer um banco de dados principal com falha após um failover, use o comando dataguard reinstate
.
Tópico principal: dbaascli dataguard reinstate
dbaascli dataguard switchover
Para executar um switchover para o banco de dados stand-by, use o comando dataguard switchover
.
Execute este comando como o usuário oracle
.
Sintaxe
dbaascli dataguard switchover --dbname <value> [--targetStandbyDBUniqueName <value>] [--executePrereqs] [--enableDGDebug] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
--dbname
especifica o nome do Oracle Database.--targetStandbyDBUniqueName
especifica o nome exclusivo para o banco de Dados stand-by a fim de alterar a atribuição de stand-by para principal.--executePrereqs
executa as verificações de pré-requisito e reporta os resultados.--enableDGDebug
ativa os rastreamentos durante a execução da operação.--waitForCompletion
especifica se deve aguardar a conclusão da operação. Defina comofalse
para executar a operação no segundo plano. Valores válidos:true
|false
.--resume
retoma a operação anterior.--sessionID
retoma uma sessão específica por seu ID.
- Executando uma Operação de Switchover com o Utilitário dbaascli
Para executar um switchover para o banco de dados stand-by, use o comandodataguard switchover
.
Tópico principal: Gerenciamento do Data Guard
Executando uma Operação de Switchover com o Utilitário dbaascli
Para executar um switchover para o banco de dados stand-by, use o comando dataguard switchover
.
Tópico principal: dbaascli dataguard switchover
dbaascli dataguard prepareForStandby
Para criar um Banco de Dados Oracle Standby, use o comando dbaascli dataguard prepareForStandby
como a primeira etapa.
Execute este comando como o usuário root
no banco de dados principal. No final da execução do comando, um arquivo BLOB stand-by é criado. Copie esse arquivo para o sistema de banco de dados stand-by para prosseguir com a etapa configureStandby
.
Para configurações de DR (Recuperação de Desastre) no Exadata Cloud@Customer (ExaDB-C@C), use a Console do OCI (Oracle Cloud Infrastructure) ou o SDK do OCI para configurar o Data Guard. O utilitário
dbaascli
não é suportado para este caso de uso e não deve ser usado.
Sintaxe
dbaascli dataguard prepareForStandby --dbname <value> --standbyDBUniqueName <value> --standbyDBDomain | --noDBDomain --standbyScanIPAddresses <Standby SCAN IP Addresses> [ --standbyScanPort ] [ --standbyServiceName ] [ -- primaryScanIPAddresses ] [ --primaryScanPort ] [--executePrereqs] [--resume [--sessionID <value>]] [--revert [--sessionID <value>]] [--waitForCompletion] [--skipDRConfiguration]
--dbname
especifica o nome do Oracle Database.--standbyDBUniqueName
especifica o nome exclusivo para o banco de dados stand-by cujo banco de dados principal será configurado.--standbyDBDomain
especifica o domínio de banco de dados stand-by para o qual o banco de dados principal será configurado.--noDBDomain
especifica não usar o nome do domínio do banco de dados para o banco de dados stand-by.--standbyScanIPAddresses
especifica uma lista delimitada por vírgulas de endereços IP correspondentes ao listener SCAN do banco e dados stand-by ou o nome do SCAN do banco e dados stand-by.--standbyScanPort
especifica o número de porta SCAN correspondente do banco do dados stand-by.--standbyServiceName
especifica o nome do sistema stand-by para o qual o banco principal será configurado.--primaryScanIPAddresses
especifica uma lista delimitada por vírgulas de endereços IP correspondentes ao listener SCAN do banco principal ou o nome do SCAN do banco principal.--primaryScanPort
especifica o número de porta de SCAN correspondente do banco de dados principal.--executePrereqs
executa as verificações de pré-requisito e reporta os resultados.--resume
retoma a operação anterior.--sessionID
retoma uma sessão específica por seu ID.--revert
faz rollback da operação anterior.--waitForCompletion
especifica se deve aguardar a conclusão da operação. Defina comofalse
para executar a operação no segundo plano. Valores válidos:true
|false
.--skipDRConfiguration
especifica se a configuração de DR (Recuperação de Desastre) deve ser ignorada como parte da configuração do banco de dados stand-by. Valores válidos:true
(ignorar configuração de DR) oufalse
(configurar DR).
- Executando a Operação PrepareForStandby Usando o Utilitário dbaascli
Para preparar o banco de dados principal para criar um novo banco de dados stand-by, use o comandodbaascli dataguard prepareForStandby
.
Tópico principal: Gerenciamento do Data Guard
Executando a Operação PrepareForStandby com o Utilitário dbaascli
Para preparar o banco de dados principal para criar um novo banco de dados stand-by, use o comando dbaascli dataguard prepareForStandby
.
Tópico principal: dbaascli dataguard prepareForStandby
dbaascli dataguard configureStandby
Para criar um novo Banco de Dados Stand-by, use o comando dbaascli dataguard configureStandby
como segunda etapa após a etapa prepareForStandby
.
Execute isso como o usuário root
no cluster stand-by.
Sintaxe
dbaascli dataguard configureStandby --dbname <value> --oracleHome <value> | --oracleHomeName <value> --standbyDBUniqueName <value> [--standbyDBDomain <value>] | [--noDBDomain] --primaryScanIPAddresses <value> --primaryScanPort <value> --primaryServiceName <value> --protectionMode <value> --transportType <value> --activeDG <value> [--standbyBlobFromPrimary <value>] | [--standbyDBInfoJsonLocation <value>] [--standbyScanIPAddresses <value>] [--standbyScanPort <value>] [--standbySID <value>] [--nodeList <value>] [--skipAWRConfiguration] [--primaryDBOCID <value>] [--sgaSizeInMB <value>] [--pgaSizeInMB <value>] [--datafileDestination <value>] [--fraDestination <value>] [--redoLogDestination <value>] [--fraSizeInMB <value>] [--tdeKeyStoreType <value> [--tdeKeyOCID <value>]] [--tdeKeyOCID <value>] [--executePrereqs] [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]] --waitForCompletion <value>] [--enableFIPS <value>] [--skipDRConfiguration] [--okvServer <value> --okvAdminUserName <value> [--okvServerRestPort <value>]] [--okvWalletName <value>]
--dbname
especifica o nome do Oracle Database.--oracleHome
especifica o caminho de Oracle home.--oracleHomeName
especifica o nome do Oracle home.--standbyDBUniqueName
especifica o nome exclusivo do banco de dados stand-by.--standbyDBDomain
especifica o domínio de banco de dados stand-by para o qual o banco de dados principal será configurado.--noDBDomain
especifica não usar o nome do domínio do banco de dados para o banco de dados stand-by.--primaryScanIPAddresses
especifica uma lista delimitada por vírgulas de endereços IP correspondentes ao listener SCAN do banco principal ou o nome do SCAN do banco principal.--primaryScanPort
especifica o número de porta do SCAN correspondente do serviço de banco de dados principal.--primaryServiceName
especifica o nome do principal serviço de banco do dados para o qual o banco do dados stand-by será configurado.--protectionMode
especifica o modo do Data Guard a ser definido ao configurar o banco de dados stand-by. Valores válidos:MAX_PERFORMANCE
|MAX_AVAILABILITY
.--transportType
especifica o tipo do transporte Data Guard a ser definido ao configurar o banco de dados stand-by. Valores válidos:ASYNC
|SYNC
.--activeDG
especifica se a configuração da Data Guard estará ativa ou não. Valores válidos:true
|false
.--standbyBlobFromPrimary
especifica o local do arquivo BLOB stand-by, que é preparado usando o banco de dados principal. Isso só é necessário para operações stand-by.--standbyDBInfoJsonLocation
especifica a localização do arquivo de informações gerado do banco de dados principal para exportar metadados adicionais. Esta opção é obrigatória apenas para operações stand-by.--standbyScanIPAddresses
especifica uma lista delimitada por vírgulas de endereços IP correspondentes ao listener SCAN do banco e dados stand-by ou o nome do SCAN do banco e dados stand-by.--standbyScanPort
especifica o número de porta SCAN correspondente do banco do dados stand-by.--standbySID
especifica o SID do banco de dados stand-by para configuração stand-by.--nodeList
especifica uma lista de nós em que o banco de dados stand-by deve ser executado, incluindo nós que já estão em execução ou configurados.--skipAWRConfiguration
especifica se a configuração do Oracle AWR deve ser ignorada como parte da configuração do banco de dados stand-by. Valores válidos:true
(ignorar configuração do AWR) oufalse
(configurar AWR).--primaryDBOCID
especifica o valor do OCID do recurso correspondente ao banco de dados principal.--sgaSizeInMB
especifica o valorsga_target
em MB.--pgaSizeInMB
especifica o valorpga_aggregate_target
no MB.--datafileDestination
especifica o local de armazenamento a ser usado para arquivos de dados do banco de dados.--fraDestination
especifica o local de armazenamento a ser usado para a área de recuperação rápida do banco de dados.--redoLogDestination
especifica o local de armazenamento a ser usado para os arquivos de redo log.--fraSizeInMB
especifica o valor de tamanho de área em MB para rápida recuperação.--tdeKeyStoreType
especifica o tipo de armazenamento de chaves TDE. Valores válidos:FILE
|KMS
|AZURE
|GOOGLE
|AWS
|OKV
--tdeKeyOCID
especifica o OCID da chaveKMS
/AZURE
/GOOGLE
/AWS
a ser usado para TDE. Isso só será aplicável seKMS
/AZURE
/GOOGLE
/AWS
estiver selecionado para o tipo de armazenamento de chaves TDE.--executePrereqs
executa as verificações de pré-requisito e reporta os resultados.--resume
retoma a operação anterior.--sessionID
retoma uma sessão específica por seu ID.--revert
faz rollback da operação anterior.--waitForCompletion
especifica se deve aguardar a conclusão da operação. Defina comofalse
para executar a operação no segundo plano. Valores válidos:true
|false
.--enableFIPS
especifica se o FIPS deve ser ativado. Defina comofalse
para desativá-lo. Valores válidos:true
|false
.--skipDRConfiguration
especifica se a configuração de DR (Recuperação de Desastre) deve ser ignorada como parte da configuração do banco de dados stand-by. Valores válidos:true
(ignorar configuração de DR) oufalse
(configurar DR).--okvServer
especifica o servidor do Oracle Key Vault. Lista delimitada por vírgulas de vários endereços IP.--okvAdminUserName
especifica o nome de usuário admin do Oracle Key Vault.--okvServerRestPort
especifica o número de porta REST do Oracle Key Vault.--okvWalletName
especifica o nome do Oracle Key Vault wallet.
- Executando a Operação configureStandby Usando o Utilitário dbaascli
Para criar um banco de dados stand-by, use o comandodbaascli dataguard configureStandby
.
Tópico principal: Gerenciamento do Data Guard
Executando a Operação configureStandby com o Utilitário dbaascli
Para criar um banco de dados stand-by, use o comando dbaascli dataguard configureStandby
.
Tópico principal: dbaascli dataguard configureStandby
dbaascli dataguard registerStandby
Para registrar um banco de dados stand-by recém-criado com todos os bancos de dados stand-by existentes e com o banco de dados principal, use o comando dbaascli dataguard registerStandby
como terceira etapa após a etapa configureStandby
.
Execute este comando como o usuário root
no cluster principal. Além disso, em uma configuração de vários stand-by, execute o comando em todos os clusters stand-by, exceto no cluster de banco de dados stand-by recém-criado.
Sintaxe
dbaascli dataguard registerStandby --dbname <value> --standbyDBUniqueName <value> --standbyDBDomain <value> | --noDBDomain --standbyScanIPAddresses <value> [--standbyScanPort <value>] [--standbyServiceName <value>] [--executePrereqs] [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]] [--waitForCompletion <value>]
--dbname
especifica o nome do Oracle Database.--standbyDBUniqueName
especifica o nome exclusivo do banco e dados stand-by a ser registrado com a configuração do Oracle Data Guard Broker.--standbyDBDomain
especifica o domínio de banco de dados stand-by para o qual o banco de dados principal será configurado.--noDBDomain
especifica não usar o nome do domínio do banco de dados para o banco de dados stand-by.--standbyScanIPAddresses
especifica uma lista delimitada por vírgulas de endereços IP correspondentes ao listener SCAN do banco e dados stand-by ou o nome do SCAN do banco e dados stand-by.--standbyScanPort
especifica o número de porta SCAN correspondente do banco do dados stand-by.--standbyServiceName
especifica o nome do sistema stand-by para o qual o banco principal será configurado.--executePrereqs
executa as verificações de pré-requisito e reporta os resultados.--resume
retoma a operação anterior.--sessionID
retoma uma sessão específica por seu ID.--revert
faz rollback da operação anterior.--waitForCompletion
especifica se deve aguardar a conclusão da operação. Defina comofalse
para executar a operação no segundo plano. Valores válidos:true
|false
.
- Executando a Operação registerStandby Usando o Utilitário dbaascli
Para registrar o banco de dados stand-by especificado na configuração do Oracle Data Guard Broker, use o comandodbaascli dataguard registerStandby
.
Tópico principal: Gerenciamento do Data Guard
Executando a Operação registerStandby com o Utilitário dbaascli
Para registrar o banco de dados stand-by especificado na configuração do Oracle Data Guard Broker, use o comando dbaascli dataguard registerStandby
.
Para casos de uso stand-by únicos, o comando registerStandby
deve ser executado somente no cluster principal, pois há uma associação um a um entre o principal e o stand-by.
No entanto, em configurações com vários bancos de dados stand-by, você deve executar o comando registerStandby
no cluster principal e em todos os clusters stand-by existentes, excluindo o novo banco de dados stand-by que está sendo adicionado.
Por exemplo, considere uma configuração com dois bancos de dados stand-by: stdby1 e stdby2, em que stdby2 é o novo stand-by a ser registrado. Nesse caso, execute o comando registerStandby
no cluster principal e no stdby1, mas não no stdby2.
Em resumo, ao adicionar um novo banco de dados stand-by a uma configuração existente do Oracle Data Guard, execute o comando registerStandby
no principal e em todos os outros clusters stand-by registrados anteriormente, exceto o novo stand-by que está sendo adicionado.
Tópico principal: dbaascli dataguard registerStandby
dbaascli dataguard deregisterStandby
Durante a exclusão do stand-by, execute o comando dbaascli dataguard deregisterStandby
antes de excluir o banco de dados no cluster stand-by para cancelar o registro do banco de dados stand-by na configuração do Oracle Data Guard Broker.
Execute este comando como o usuário root
no cluster principal. No entanto, no contexto de vários bancos de dados stand-by, esse comando precisa ser executado em todos os clusters stand-by, exceto no stand-by de destino.
Sintaxe
dbaascli dataguard deregisterStandby --dbname <value> --standbyDBUniqueName <value> [--executePrereqs] [--resume [--sessionID <value>]] [--waitForCompletion <value>]
--dbname
especifica o nome do Oracle Database.--standbyDBUniqueName
especifica o nome exclusivo do banco do dados stand-by a ser cancelado no registro da configuração do Oracle Data Guard Broker.--executePrereqs
executa as verificações de pré-requisito e reporta os resultados.--resume
retoma a operação anterior.--sessionID
retoma uma sessão específica por seu ID.--waitForCompletion
especifica se deseja aguardar a conclusão da operação. Defina comofalse
para executar a operação no segundo plano. Valores válidos:true
|false
.
- Executando a Operação deregisterStandby Usando o Utilitário dbaascli
Durante a exclusão do stand-by, execute o comandodbaascli dataguard deregisterStandby
antes de excluir o banco de dados no cluster stand-by para cancelar o registro do banco de dados stand-by na configuração do Oracle Data Guard Broker.
Tópico principal: Gerenciamento do Data Guard
Executando a Operação deregisterStandby com o Utilitário dbaascli
Durante a exclusão do stand-by, execute o comando dbaascli dataguard deregisterStandby
antes de excluir o banco de dados no cluster stand-by para cancelar o registro do banco de dados stand-by na configuração do Oracle Data Guard Broker.
Para casos de uso stand-by únicos, o comando deregisterStandby
deve ser executado somente no cluster principal, pois há uma associação um a um entre o principal e o stand-by.
No entanto, em configurações com vários bancos de dados stand-by, você deve executar o comando deregisterStandby
no cluster principal e em todos os clusters stand-by existentes, excluindo o banco de dados stand-by que está sendo cancelado no momento.
Por exemplo, considere uma configuração com dois bancos de dados stand-by: stdby1 e stdby2, em que o registro de stdby2 será cancelado. Nesse caso, execute o comando deregisterStandby
no cluster principal e no stdby1
, mas não no stdby2
.
Em resumo, ao excluir um banco de dados stand-by de uma configuração existente do Oracle Data Guard, execute o comando deregisterStandby
no principal e em todos os outros clusters stand-by existentes antes da operação de exclusão do banco de dados no cluster stand-by desejado.
Tópico principal: dbaascli dataguard deregisterStandby
dbaascli dataguard configureAWR
Para ativar ou desativar a configuração do AWR (Automatic Workload Repository) no stand-by do Active Data Guard, use o comando dbaascli dataguard configureAWR
.
Execute esse comando como o usuário root
no cluster stand-by do Active Data Guard no qual você deseja ativar ou desativar a configuração do AWR. Use este comando se o AWR não tiver sido configurado durante o processo de adição stand-by.
Sintaxe
dbaascli dataguard configureAWR --dbname <value> { --action <value> | --enable | --disable } [--executePrereqs] [--resume [--sessionID <value>]]
--dbname
especifica o nome do Oracle Database.--action
especifica se o AWR deve ser ativado ou desativado. Use--action enable
para ativar o AWR e--action disable
para desativá-lo.O argumento
--action
é retido para compatibilidade com versões anteriores. No entanto, é recomendável usar--enable
ou--disable
, pois eles fornecem a mesma funcionalidade, mas são mais explícitos--executePrereqs
executa as verificações de pré-requisito e reporta os resultados.--resume
retoma a operação anterior.--sessionID
retoma uma sessão específica por seu ID.
- Executando a Operação configureAWR Usando o Utilitário dbaascli
Para configurar o AWR em um banco de dados stand-by do ADG, use o comandodbaascli dataguard configureAWR
.
Tópico principal: Gerenciamento do Data Guard
Executando a Operação configureAWR com o Utilitário dbaascli
Para configurar o AWR em um banco de dados stand-by ADG, use o comando dbaascli dataguard configureAWR
.
Tópico principal: dbaascli dataguard configureAWR
dbaascli dataguard updateConfiguration
Para atualizar o modo de transporte ou o modo de proteção ou ambos os parâmetros de um ambiente do Data Guard, use o comando dbaascli dataguard updateConfiguration
.
Execute isso como o usuário root
.
Quando o comando de atualização do modo de transporte é executado no principal, somente o modo de transporte do banco de dados principal é atualizado. Para atualizar o modo de transporte de um banco de dados stand-by, o comando deve ser executado separadamente nesse stand-by.
Por outro lado, quando o comando update protection mode é executado no principal, o modo de proteção é atualizado para os bancos de dados principal e stand-by. O modo de proteção também pode ser atualizado do modo stand-by, caso em que os bancos de dados principal e stand-by são atualizados.
Ao atualizar o modo de transporte ou proteção do principal, o sistema verifica os modos atuais nos bancos de dados principal e stand-by e prossegue com a atualização somente se todas as condições necessárias forem atendidas.
Sintaxe
dbaascli dataguard updateConfiguration --dbname <value> [--protectionMode <value>] [--transportType <value>] [--standbyDGType <value>] [--executePrereqs] [--resume [--sessionID <value>]] [--waitForCompletion <value>]
--dbname
especifica o nome do Oracle Database.--protectionMode
especifica o modo do Data Guard a ser definido ao configurar o banco de dados stand-by. Valores válidos:MAX_PERFORMANCE
|MAX_AVAILABILITY
.--transportType
especifica o tipo do transporte Data Guard a ser definido ao configurar o banco de dados stand-by. Valores válidos:ASYNC
|SYNC
.--standbyDGType
especifica o tipo de Data Guard do banco de dados stand-by a ser definido. Valores válidos: ADG|DG.--executePrereqs
executa as verificações de pré-requisito e reporta os resultados.--resume
retoma a operação anterior.--sessionID
retoma uma sessão específica por seu ID.--waitForCompletion
especifica se deve aguardar a conclusão da operação. Defina comofalse
para executar a operação no segundo plano. Valores válidos:true
|false
.
- Executando a Operação updateConfiguration Usando o Utilitário dbaascli
Para atualizar o modo de transporte e o modo de proteção ou os dois parâmetros, use o comandodbaascli dataguard updateConfiguration
.
Tópico principal: Gerenciamento do Data Guard
Executando a Operação updateConfiguration com o Utilitário dbaascli
Para atualizar o modo de transporte e o modo de proteção ou ambos os parâmetros, use o comando dbaascli dataguard updateConfiguration
.
Tópico principal: dbaascli dataguard updateConfiguration
Gerenciamento do Home do Banco de Dados
Esta seção fornece ferramentas para gerenciar homes do Oracle Database. Ele inclui comandos como dbaascli dbhome create
para criar um novo home do Oracle Database e dbaascli dbHome delete
para remover um existente. Você também pode exibir informações detalhadas sobre um Oracle home específico com dbaascli dbHome getDetails
e verificar quais bancos de dados estão sendo executados em um determinado Oracle home usando dbaascli dbhome getDatabases
. Esses comandos garantem o gerenciamento eficiente de ambientes de banco de dados.
- dbaascli dbhome create
Para criar um home do Banco de Dados Oracle da versão desejada, use o 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.
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>
--version
especifica a versão do Oracle Home definida como cinco segmentos numéricos separados por pontos, por exemplo, 19.12.0.0.0--oracleHome
especifica o local do Oracle home--oracleHomeName
especifica o nome do Oracle home definido pelo usuário. Se não for fornecido, o nome padrão será usado--enableUnifiedAuditing
especificatrue
oufalse
para ativar ou desativar a opção de link de auditoria unificada no Oracle home--imageTag
especifica a tag de imagem do Oracle home-
--imageLocation
- caminho da imagem a ser usada. --waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
oufalse
.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli dbhome create?
R: O comando dbaascli dbhome create
é usado para criar um novo home do Oracle Database com a versão desejada.
P: Quais são os pré-requisitos para executar o comando dbaascli dbhome create?
A: O comando deve ser executado como usuário root
.
P: Como eu especifico a versão do Oracle Database ao criar um novo Oracle Home?
A: Use a opção --version
seguida pela versão do Oracle Database no formato de cinco segmentos numéricos separados por pontos, como 19.11.0.0.0.
P: O que a opção --oracleHome especifica?
A: A opção --oracleHome
especifica o local onde você deseja instalar o Oracle Home. Se não for fornecido, o local padrão será usado.
P: Posso designar um nome personalizado ao novo Oracle Home?
R: Sim, você pode usar a opção --oracleHomeName
para especificar um nome definido pelo usuário para o Oracle Home. Se não for especificado, um nome padrão será usado.
P: Como ativo ou desativo a Auditoria Unificada no novo Oracle Home?
A: Use a opção --enableUnifiedAuditing
e especifique true
para ativar ou false
para desativar a Auditoria Unificada do Oracle Home.
P: O que a opção --imageTag faz?
A: A opção --imageTag
especifica a tag de imagem do Oracle Home, que pode ser usada nos casos em que a tag de imagem difere da versão.
P: Qual é um exemplo de uso do comando dbaascli dbhome create com a tag version and image?
A: Um exemplo do comando com a tag version and image é:
dbaascli dbhome create --version 19.8.0.0.0 --imageTag 19.8.0.0.0
Isso cria um Oracle Home para a versão 19.8.0.0.0 com a tag de imagem correspondente.
P: O que acontece se eu não fornecer as opções --oracleHome ou --oracleHomeName?
R: Se --oracleHome
não for fornecido, o Oracle Home será instalado no local padrão. Se --oracleHomeName
não for especificado, um nome padrão será designado ao Oracle Home.
P: Como posso verificar se a criação do Oracle Home foi bem-sucedida?
R: Depois de executar o comando, verifique os logs de saída em busca de mensagens ou erros bem-sucedidos. Você também pode verificar o Oracle Home navegando até o local especificado ou usando ferramentas Oracle como orainstRoot.sh
.
P: É possível criar vários Oracle Homes com versões diferentes no mesmo sistema?
R: Sim, você pode criar vários Oracle Homes com versões diferentes especificando valores diferentes para as opções --version
e --oracleHomeName
.
P: O que devo fazer se a criação do Oracle Home falhar?
R: Verifique os logs de saída para obter mensagens de erro detalhadas. Verifique se você tem o formato de versão correto, as permissões necessárias e espaço em disco suficiente. Corrija os problemas e tente executar o comando novamente.
Exemplo 7-23 dbaascli dbhome create
dbaascli dbhome create --version 19.11.0.0.0
Como alternativa, dbaascli dbhome create --version 19.8.0.0.0.0 --imageTag 19.8.0.0.0
para casos em que as tags de imagem são diferentes da versão.
Tópico principal: Database Home Management
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>]]
--oracleHome
especifica o local do Oracle home--oracleHomeName
especifica o nome do Oracle home--resume
retoma a execução anterior--sessionID
especifica para retomar um ID de sessão específico
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli dbHome delete?
A: O comando dbaascli dbHome delete
é usado para excluir um home do Oracle Database especificado do sistema.
P: Quais são os pré-requisitos para executar o comando de exclusão dbaascli dbHome?
A: O comando deve ser executado como usuário root
.
P: Como especifico o Oracle Home a ser excluído?
A: Você pode especificar o Oracle Home a ser excluído usando uma das seguintes opções:
--oracleHome <value>
para fornecer o caminho absoluto da localização do Oracle Home.
--oracleHomeName <value>
para fornecer o nome do Oracle Home.
P: Qual é a diferença entre as opções --oracleHome e --oracleHomeName?
A4:
--oracleHome
especifica o local físico ou o caminho do Oracle Home a ser excluído.
--oracleHomeName
especifica o nome definido pelo usuário do Oracle Home a ser excluído.
P: Como posso retomar um processo de exclusão interrompido anteriormente?
R: Você pode usar a opção --resume
para retomar um processo de exclusão anterior. Se você souber o ID de sessão específico do processo, poderá incluí-lo com a opção --sessionID
.
P: Para que é usada a opção --sessionID no comando dbaascli dbHome delete?
A: A opção --sessionID
é usada para retomar uma sessão específica que foi interrompida ou falhou anteriormente durante o processo de exclusão.
P: O que acontece se eu não fornecer as opções --resume ou --sessionID?
R: Se as opções --resume
ou --sessionID
não forem fornecidas, o comando iniciará um novo processo de exclusão em vez de retomar um processo interrompido.
P: Existe alguma forma de confirmar a exclusão do Oracle Home após a execução do comando?
R: Você pode verificar a exclusão verificando se há mensagens de sucesso nos logs de saída e garantindo que o diretório Oracle Home não esteja mais presente no local especificado.
P: Posso excluir um Oracle Home que está sendo usado no momento por um banco de dados em execução?
R: Não, o Oracle Home não deve estar em uso por nenhum banco de dados ou serviço em execução durante o processo de exclusão. Certifique-se de interromper qualquer banco de dados relacionado antes de executar o comando de exclusão.
P: O que devo fazer se o comando de exclusão dbaascli dbHome falhar?
R: Verifique os logs de saída para obter quaisquer mensagens de erro. Certifique-se de que o Oracle Home não esteja em uso, verifique a localização ou o nome correto do Oracle Home e confirme se você tem as permissões necessárias. Depois de resolver quaisquer problemas, execute novamente o comando ou use a opção --resume
, se necessário.
P: Posso excluir vários Oracle Homes de uma só vez usando o comando dbaascli dbHome delete?
R: Não, o comando só permite excluir um Oracle Home por vez especificando a opção --oracleHome
ou --oracleHomeName
.
P: Qual é um exemplo de exclusão de um Oracle Home por seu nome?
A: Aqui está um exemplo de exclusão de um Oracle Home por nome:
dbaascli dbHome delete --oracleHomeName myOracleHome
Esse comando exclui o Oracle Home com o nome myOracleHome.
P: Qual é um exemplo de exclusão de um Oracle Home por sua localização?
A: Aqui está um exemplo de exclusão de um Oracle Home especificando sua localização:
dbaascli dbHome delete --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1
Esse comando exclui o Oracle Home localizado em /u01/app/oracle/product/19.0.0/dbhome_1.
P: Posso cancelar o processo de exclusão depois de iniciado?
R: Não, depois que o processo de exclusão for iniciado, ele não poderá ser cancelado. Certifique-se de que o Oracle Home esteja pronto para exclusão antes de executar o comando.
Tópico principal: Database Home Management
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 }
--oracleHomeName
especifica o nome do Oracle home definido pelo usuário--oracleHome
especifica o local (caminho) do Oracle home
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli dbHome getDatabases?
A: O comando dbaascli dbHome getDatabases
é usado para exibir informações sobre todos os Bancos de Dados Oracle em execução em um home do Oracle Database especificado.
P: Como posso especificar o home do Oracle Database a ser verificado?
A: Você pode especificar o home do Oracle Database usando uma das seguintes opções:
--oracleHomeName <value>
para especificar o nome definido pelo usuário do Oracle home.
--oracleHome <value>
para especificar o local completo (caminho) do Oracle home.
P: Qual é a diferença entre as opções --oracleHomeName e --oracleHome?
A4:
--oracleHomeName
refere-se a um nome definido pelo usuário para o Oracle home.
--oracleHome
refere-se ao local físico (ou caminho do diretório) do Oracle home no sistema.
P: Como faço para executar o comando dbaascli dbHome getDatabases?
A: Para executar o comando, use a sintaxe a seguir:
dbaascli dbHome getDatabases --oracleHomeName <value>
ou
dbaascli dbHome getDatabases --oracleHome <value>
Certifique-se de executar o comando como usuário root
.
P: Posso especificar o nome do Oracle home e o local do Oracle home no mesmo comando?
R: Não, você só pode especificar --oracleHomeName
ou --oracleHome
em uma única execução de comando. Escolha uma opção com base em como você identifica o Oracle home.
P: Que tipo de informação o comando dbaascli dbHome getDatabases retorna?
R: O comando retorna informações sobre todos os Bancos de Dados Oracle em execução no Oracle home especificado. Isso inclui detalhes como nomes e status do banco de dados.
P: Qual é um exemplo de uso do dbaascli dbHome getDatabases com o local do Oracle home?
A: Aqui está um exemplo de como usar o comando com o local do Oracle home:
dbaascli dbHome getDatabases --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1
Esse comando recupera a lista de bancos de dados em execução no Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1
.
P: Qual é um exemplo de uso do dbaascli dbHome getDatabases com o nome do Oracle home?
A: Aqui está um exemplo de como usar o comando com o nome do Oracle home:
dbaascli dbHome getDatabases --oracleHomeName myOracleHome
Esse comando recupera a lista de bancos de dados em execução no Oracle home chamado myOracleHome.
P: Preciso de permissões especiais para executar este comando?
R: Sim, você deve executar o comando como usuário raiz para exibir as informações sobre Bancos de Dados Oracle em execução em um Oracle home especificado.
P: O que devo verificar se o comando dbaascli dbHome getDatabases não retorna bancos de dados?
R: Certifique-se de ter especificado o nome ou o local correto do Oracle home e de que há bancos de dados em execução nesse Oracle home. Além disso, confirme se o Oracle home está configurado e ativo corretamente.
P: Posso usar o comando dbaascli dbHome getDatabases em vários Oracle homes de uma só vez?
R: Não, o comando funciona em um único Oracle home de cada vez. Execute o comando separadamente para cada Oracle home que você deseja consultar.
P: Existe uma maneira de verificar se o Oracle home especificado no comando está correto?
R: Você pode verificar o Oracle home verificando a estrutura do diretório ou os detalhes da configuração no sistema para garantir que o caminho ou o nome fornecido corresponda ao Oracle home real.
P: O que acontece se eu executar o comando sem especificar um nome do Oracle home ou do Oracle home?
A: O comando requer que a opção --oracleHome
ou --oracleHomeName
seja especificada. Se nenhuma das opções for fornecida, o comando falhará ao ser executado.
P: Este comando pode recuperar bancos de dados que estão interrompidos no momento?
R: Sim, o comando listará todos os bancos de dados associados ao Oracle home especificado, independentemente de estarem em execução ou interrompidos no momento.
Exemplo 7-24 dbaascli dbHome getDatabases --oracleHome
dbaascli dbHome getDatabases --oracleHome /u02/app/mar_home/
Tópico principal: Database Home Management
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 }
--oracleHomeName
especifica o nome do Oracle home definido pelo usuário--oracleHome
especifica o local do Oracle home
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli dbHome getDetails?
R: O comando dbaascli dbHome getDetails
é usado para exibir informações detalhadas sobre um Oracle home específico no sistema.
P: Como especifico o Oracle home sobre o qual quero obter detalhes?
A: Você pode especificar o Oracle home usando uma das seguintes opções:
--oracleHomeName <value>
para especificar o nome definido pelo usuário do Oracle home.
--oracleHome <value>
para especificar o local completo (caminho) do Oracle home.
P: Qual é a diferença entre --oracleHomeName e --oracleHome?
A4:
--oracleHomeName
é o nome definido pelo usuário para um Oracle home.
--oracleHome
refere-se ao caminho completo do diretório em que o Oracle home está localizado.
P: Como faço para executar o comando dbaascli dbHome getDetails?
A: Para executar o comando, use a sintaxe a seguir:
dbaascli dbHome getDetails --oracleHomeName <value>
ou
dbaascli dbHome getDetails --oracleHome <value>
Certifique-se de executar o comando como usuário root
.
P: Posso especificar --oracleHomeName e --oracleHome no mesmo comando?
R: Não, você só pode usar uma opção por execução de comando. Você deve especificar o nome do Oracle home ou a localização do Oracle home, não ambos.
P: Quais informações o comando dbaascli dbHome getDetails retorna?
R: O comando fornece informações detalhadas sobre o Oracle home especificado, como sua versão, status e quaisquer outros detalhes de configuração associados ao Oracle home.
P: Qual é um exemplo de uso do comando dbaascli dbHome getDetails com um local do Oracle home?
A: Aqui está um exemplo:
dbaascli dbHome getDetails --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1
Este comando recupera informações detalhadas sobre o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1
.
P: Qual é um exemplo de uso do comando dbaascli dbHome getDetails com um nome do Oracle home?
A: Aqui está um exemplo:
dbaascli dbHome getDetails --oracleHomeName myOracleHome
Este comando recupera informações detalhadas sobre o Oracle home chamado myOracleHome.
P: Preciso de permissões especiais para executar este comando?
R: Sim, você deve executar o comando como usuário raiz para exibir detalhes sobre o Oracle home.
P: O que devo fazer se o comando dbaascli dbHome getDetails não retornar informações?
R: Verifique se você especificou corretamente o nome ou o local do Oracle home e se o Oracle home está configurado corretamente e existe no sistema.
P: Posso usar o comando dbaascli dbHome getDetails em vários Oracle homes simultaneamente?
R: Não, o comando só funciona em um único Oracle home de cada vez. Execute o comando separadamente para cada Oracle home.
P: É possível verificar o nome do Oracle home antes de executar o comando?
R: Sim, você pode verificar o nome do Oracle home verificando os arquivos de configuração do sistema ou listando todos os Oracle homes disponíveis no sistema.
P: O que acontece se eu não especificar um nome ou local do Oracle home no comando?
A: O comando requer que a opção --oracleHome
ou --oracleHomeName
seja especificada. Se nenhum dos dois for fornecido, a execução do comando falhará.
P: Posso recuperar informações sobre Oracle homes que não estão em uso no momento?
R: Sim, o comando dbaascli dbHome getDetails
fornece detalhes sobre Oracle homes, independentemente de eles estarem em uso ou ociosos.
P: O que devo verificar se o comando retorna um erro?
R: Verifique se o nome ou a localização do Oracle home está correto, se o Oracle home existe e se você está executando o comando como o usuário root
. Verifique novamente se há erros de digitação ou caminhos incorretos.
Exemplo 7-25 dbaascli dbHome getDetails - using Oracle home location
dbaascli dbHome getDetails --oracleHome /u02/app/home_db19c/
Exemplo 7-26 dbaascli dbHome getDetails - using Oracle home name
dbaascli dbHome getDetails --oracleHomeName home_db19c
Tópico principal: Database Home Management
Diagnósticos e Verificações de Integridade
Esta seção aborda ferramentas para a manutenção da integridade e do diagnóstico de problemas nos ambientes do Oracle Database. Comandos como dbaascli diag collect
são usados para coletar dados de diagnóstico, enquanto dbaascli diag healthCheck
permite executar verificações de integridade para identificar possíveis problemas. Essas ferramentas ajudam a garantir a estabilidade e o desempenho do sistema, monitorando e abordando proativamente as preocupações.
- dbaascli diag Collect
Para coletar diagnóstico, use o comandodbaascli diag collect
. - dbaascli diag healthCheck
Para executar verificações de integridade de diagnóstico, use o comandodbaascli diag healthCheck
.
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>]
--components
especifica uma lista de componentes para a coleta de logs.Valores válidos:
db
gi
os
dbaastools
all
--startTime
especifica o horário inicial da coleta de logs. Formato válido de data e hora:YYYY-MM-DDTHH24:MM:SS
--endTime
especifica o horário final da coleta de logs. Formato válido de data e hora:YYYY-MM-DDTHH24:MM:SS
--nodes
especifica uma lista de nós delimitados por vírgulas para coletar logs--dbNames
especifica o nome do banco de dados cujos logs serão coletados. Você só pode especificar um nome de banco de dados.--objectStoreBucketURI
especifica um URL de PAR (solicitação pré-autenticada) do serviço Object Storage usado para fazer upload de logs coletados. Os logs são coletados da VM Convidada. Para obter mais informações, consulte Usando Solicitações Pré-autenticadas.--destLocation
especifica o local na VM Convidada para coletar logs. Padrão:/var/opt/oracle/dbaas_acfs
--waitForCompletion
Valores:true
|false
. Padrão:true
. Especifiquefalse
para ser executado em segundo plano.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli diag collect?
R: O comando dbaascli diag collect
é usado para coletar logs de diagnóstico do Oracle Database e componentes associados, como SO, Grid Infrastructure (GI) e ferramentas DBaaS.
P: Como especifico para quais componentes coletar diagnósticos?
A: Você pode especificar os componentes usando a opção --components
. Os valores válidos são:
db
(para logs de banco de dados)
gi
(para logs do Grid Infrastructure)
os
(para logs do sistema operacional)
dbaastools
(para logs de ferramentas DBaaS)
all
(para coletar logs de todos os componentes)
P: Como posso coletar logs para um intervalo de tempo específico?
A: Use as seguintes opções para especificar um intervalo de tempo:
--startTime <value>
para definir o horário inicial da coleta de logs.
--endTime <value>
para definir o horário final da coleta de logs.
A hora deve estar no formato: YYYY-MM-DDTHH24:MM:SS
.
P: Em que formato os horários inicial e final devem estar?
A: --startTime
e --endTime
devem estar no formato YYYY-MM-DDTHH24:MM:SS
. Por exemplo, 2024-09-01T15:30:00.
P: Como especifico de quais nós coletar diagnósticos?
R: Você pode usar a opção --nodes
para especificar uma lista de nós delimitados por vírgulas. Por exemplo:
--nodes node1,node2
P: Como coleto logs de um banco de dados específico?
A: Use a opção --dbNames
para especificar o nome do banco de dados para o qual você deseja coletar logs. Somente um nome de banco de dados pode ser especificado por vez.
P: Como posso armazenar os logs coletados no Object Storage?
A: Use a opção --objectStoreBucketUri
para especificar o URL de PAR (solicitação pré-autenticada) do bucket do Object Storage no qual o upload dos logs será feito.
P: Posso coletar logs para um diretório local em vez do Object Storage?
R: Sim, você pode usar a opção --destLocation
para especificar um diretório na VM convidada em que os logs serão coletados. O local padrão é /var/opt/oracle/dbaas_acfs
.
P: O que acontece se eu não especificar um destino para os logs?
R: Se nenhum destino for especificado, os logs coletados serão armazenados no local padrão /var/opt/oracle/dbaas_acfs
na VM convidada.
P: O que a opção --waitForCompletion faz?
A: A opção --waitForCompletion
especifica se o comando deve ser finalizado antes de retornar o controle ao usuário. O valor padrão é true
. Se você especificar false
, a operação será executada em segundo plano.
P: Como posso executar a coleta de logs em segundo plano?
A: Defina a opção --waitForCompletion
como false
para executar o processo de coleta de logs em segundo plano:
dbaascli diag collect --waitForCompletion false
P: Posso retomar uma sessão anterior de coleta de logs com este comando?
R: Não, o comando dbaascli diag collect
não suporta a retomada das sessões anteriores. Você precisará iniciar um novo processo de coleta de logs.
P: Como posso garantir que o upload dos logs seja feito diretamente no Object Storage?
R: Você pode fornecer um --objectStoreBucketUri
válido (URL de solicitação pré-autenticada do Object Storage) no qual o upload dos logs será feito após a coleta.
P: Posso coletar logs para vários bancos de dados de uma só vez?
R: Não, você só pode especificar um nome de banco de dados por vez usando a opção --dbNames
.
P: O que devo fazer se quiser coletar todos os logs disponíveis para todos os componentes?
A: Use --components
tudo para coletar logs de todos os componentes, incluindo o banco de dados, o Grid Infrastructure, o sistema operacional e as ferramentas DBaaS.
P: Qual é um exemplo de comando para coletar logs do componente de banco de dados de um intervalo de tempo específico?
A: Aqui está um exemplo de comando:
dbaascli diag collect --components db --startTime 2024-09-01T12:00:00 --endTime 2024-09-01T14:00:00 --dbname orcl
P: Qual é um exemplo de comando para coletar logs e fazer upload deles para o Object Storage?
A: Aqui está um exemplo de comando:
dbaascli diag collect --components db --objectStoreBucketUri https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL
P: Qual será o comportamento padrão se a opção --components não for especificada?
R: Se você não especificar a opção --components
, o comando poderá não saber quais logs coletar e poderá falhar. É recomendável sempre especificar os componentes dos quais você deseja coletar logs.
P: Posso especificar as opções --objectStoreBucketUri e --destLocation no mesmo comando?
R: Não, você deve escolher um destino — Object Storage via --objectStoreBucketUri
ou um diretório local via --destLocation
.
P: O que devo fazer se encontrar um erro ao usar o comando dbaascli diag collect?
R: Verifique novamente se você forneceu nomes de componentes válidos, formatos de data/hora e opções de destino. Além disso, certifique-se de estar executando o comando como o usuário root
.
Tópicos Relacionados
Tópico principal: Diagnósticos e Verificações de Integridade
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]
--destLocation
especifica o local na VM Convidada para coletar logs. Padrão:/var/opt/oracle/dbaas_acfs
--nodes
especifica uma lista de nós delimitados por vírgulas para coletar logs--objectStoreBucketURI
especifica um URL de PAR (solicitação pré-autenticada) do serviço Object Storage usado para fazer upload de logs coletados. Os logs são coletados da VM Convidada. Para obter mais informações, consulte Usando Solicitações Pré-autenticadas.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli diag healthCheck?
R: O comando dbaascli diag healthCheck
é usado para executar verificações de integridade de diagnóstico em um Oracle Database executado em um ambiente Exadata Cloud@Customer.
P: Quais são os pré-requisitos para usar o comando dbaascli diag healthCheck?
R: O comando deve ser executado como o usuário root
e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: Como eu especifico um diretório personalizado para coletar os logs?
R: Use a opção --destLocation
para especificar o diretório no qual os logs de verificação de integridade serão coletados. O local padrão é /var/opt/oracle/dbaas_acfs
.
P: Qual será o local padrão para a coleta de logs se eu não especificar --destLocation?
A: O diretório padrão para coleta de logs é /var/opt/oracle/dbaas_acfs
.
P: Posso especificar em quais nós executar a verificação de integridade?
R: Sim, você pode usar a opção --nodes
para especificar uma lista de nós delimitados por vírgulas em que a verificação de integridade deve ser executada.
P: Como faço upload dos logs de verificação de integridade para o Object Storage?
A: Use a opção --objectStoreBucketURI
para fornecer um URL de PAR (solicitação pré-autenticada) do serviço Object Storage. Isso fará upload dos logs coletados para o bucket especificado.
P: Posso coletar logs de vários nós?
R: Sim, você pode especificar vários nós usando a opção --nodes
em um formato delimitado por vírgulas. Por exemplo: --nodes node1,node2
.
P: Qual é um exemplo de comando para executar uma verificação de integridade em um nó específico?
A: Aqui está um exemplo de comando para executar a verificação de integridade em um nó específico:
dbaascli diag healthCheck --nodes node1
P: Como posso armazenar os logs no Object Storage em vez de na máquina local?
R: Você pode fornecer um URL de PAR (solicitação pré-autenticada) usando a opção --objectStoreBucketURI
para armazenar os logs no Object Storage.
P: Posso especificar --destLocation e --objectStoreBucketURI ao mesmo tempo?
R: Sim, você pode especificar --destLocation
para armazenamento local e --objectStoreBucketURI
para fazer upload de logs para o Object Storage.
P: O que devo fazer se encontrar um erro ao executar o comando dbaascli diag healthCheck?
R: Certifique-se de que você esteja executando o comando como o usuário raiz e tenha fornecido opções válidas para --destLocation
, --nodes
ou --objectStoreBucketURI
. Verifique se os nomes dos nós estão corretos, se especificado.
P: Posso executar a verificação de integridade em segundo plano?
R: O comando dbaascli diag healthCheck
não tem um modo de fundo explícito, mas você pode executá-lo em segundo plano anexando & no final do comando.
P: O que acontece se eu não fornecer a opção --nodes?
R: Se a opção --nodes
não for fornecida, a verificação de integridade será executada em todos os nós do cluster por padrão.
P: Posso retomar uma sessão de verificação de integridade anterior usando este comando?
R: Não, o comando dbaascli diag healthCheck
não suporta a retomada das sessões anteriores. Você deve iniciar uma nova verificação de integridade todas as vezes.
P: Qual é um exemplo de comando para executar uma verificação de integridade e fazer upload de logs para o Object Storage?
A: Aqui está um exemplo de comando:
dbaascli diag healthCheck --objectStoreBucketURI
https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL
P: Qual será o comportamento padrão se eu não especificar --destLocation ou --objectStoreBucketURI?
R: Se nem --destLocation
nem --objectStoreBucketURI
forem especificados, os logs de verificação de integridade serão coletados no diretório padrão /var/opt/oracle/dbaas_acfs
na máquina local.
P: Posso limitar a verificação de integridade a componentes ou logs específicos?
R: Não, o comando dbaascli diag healthCheck
não permite especificar componentes ou logs individuais. Ele executa uma verificação geral de saúde de diagnóstico para o sistema.
P: O que devo verificar antes de executar o comando dbaascli diag healthCheck?
R: Certifique-se de estar conectado a uma máquina virtual do Exadata Cloud@Customer e executando o comando como o usuário root
.
Tópicos Relacionados
Tópico principal: Diagnósticos e Verificações de Integridade
Gerenciamento do Grid Infrastructure
Esta seção se concentra no gerenciamento do Oracle Grid Infrastructure, que suporta clusterização e alta disponibilidade. As principais tarefas incluem a configuração de um home do Grid Infrastructure (dbaascli gridHome create
), o upgrade do Grid Infrastructure (dbaascli grid upgrade
) e o gerenciamento de certificados TCPS (Transport Layer Security) configurando (dbaascli grid configureTCPS
), removendo (dbaascli grid removeTCPSCert
) ou alternando-os (dbaascli grid rotateTCPSCert
). Esses comandos garantem a configuração, a manutenção e a segurança eficientes do Grid Infrastructure.
- dbaascli gridHome create
Para configurar o home do Grid Infrastructure, use o comandodbaascli gridHome create
. - dbaascli grid configureTCPS
Para configurar o TCPS para o cluster existente, use o comandodbaascli grid configureTCPS
. - 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
.
Tópico principal: Referência de Comando do dbaascli
dbaascli gridHome create
Para configurar o home do Grid Infrastructure, use o comando dbaascli gridHome create
.
Pré-Requisito
Execute o comando como usuário root
.
Sintaxe
dbaascli gridHome create --version value [--resume [--sessionID value]] [--waitForCompletion value]
--version
especifica a versão do Grid home--resume
retoma a execução anterior--sessionID
especifica para retomar um ID de sessão específico
--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
|false
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli gridHome create?
R: O comando dbaascli gridHome create
é usado para configurar um home do Grid Infrastructure para o Oracle Grid Infrastructure em um ambiente Exadata Cloud@Customer.
P: Qual é o pré-requisito para executar o comando dbaascli gridHome create?
A: O comando deve ser executado como usuário root
.
P: Como especifico a versão do home do Grid Infrastructure a ser criada?
A: Use a opção --version
para especificar a versão do Grid home. Esta é uma opção obrigatória ao criar o Grid home.
P: Posso retomar uma sessão de criação dbaascli gridHome anterior?
R: Sim, você pode usar a opção --resume
para retomar uma sessão anterior. Opcionalmente, você pode especificar o ID da sessão usando a opção --sessionID
para retomar uma sessão específica.
P: O que a opção --resume faz no comando dbaascli gridHome create?
A: A opção --resume
permite retomar uma operação interrompida ou incompleta anteriormente.
Q: Como faço para executar a operação em segundo plano?
R: Você pode definir a opção --waitForCompletion
como falsa para executar a operação em segundo plano. Os valores válidos para esta opção são true
(padrão) ou false
.
P: Qual será o comportamento padrão se --waitForCompletion não for especificado?
R: Se --waitForCompletion
não for especificado, a operação será executada em primeiro plano, e o comando aguardará a conclusão da operação antes de retornar o controle ao usuário.
P: Qual é a finalidade da opção --sessionID?
A: A opção --sessionID
é usada para especificar o ID de uma sessão anterior que você deseja retomar, no caso de uma operação incompleta ou interrompida.
P: Posso usar o comando dbaascli gridHome create para fazer upgrade de um Grid home existente?
R: Não, esse comando é usado especificamente para configurar um novo home do Grid Infrastructure, não para fazer upgrade de um existente.
P: O que é um exemplo de comando para criar um Grid home com a versão 19.9.0.0.0?
A: Aqui está um exemplo de comando:
dbaascli gridHome create --version 19.9.0.0.0
P: O que devo fazer se o comando dbaascli gridHome create for interrompido?
R: Você pode retomar a operação usando a opção --resume
. Se você tiver o ID da sessão, poderá fornecê-lo usando a opção --sessionID
para retomar uma sessão específica.
P: Posso especificar a opção --resume sem um ID de sessão?
R: Sim, você pode usar a opção --resume
sem especificar um ID de sessão. Nesse caso, o sistema tentará retomar a sessão mais recente.
P: O que acontece se eu especificar --waitForCompletion falso?
R: Se você especificar --waitForCompletion false
, a operação será executada em segundo plano, permitindo que você continue usando a linha de comando enquanto a operação for concluída.
P: É possível acompanhar o progresso de uma operação em segundo plano?
R: O comando dbaascli não fornece uma maneira direta de rastrear operações em segundo plano. Talvez seja necessário verificar os logs do sistema ou o status da sessão manualmente.
P: Posso especificar uma versão do Grid home inválida ao criá-la?
R: Não, a opção --version
deve conter uma versão válida do Grid Infrastructure. Se uma versão inválida for fornecida, o comando retornará um erro.
P: Como posso determinar a versão do Grid home a ser usada para criação?
R: Você pode consultar a documentação da Oracle ou consultar o administrador do banco de dados para determinar a versão correta do Grid home a ser usada para seu ambiente.
P: O que devo verificar antes de executar o comando dbaascli gridHome create?
R: Certifique-se de que você esteja conectado como o usuário root
e que a versão que você deseja usar para o Grid Infrastructure seja compatível com seu ambiente.
Tópico principal: Gerenciamento de Infraestrutura de Grade
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]
--pkcs12WalletFilePath
especifica o caminho absoluto do arquivo de certificado, que está no formato de walletpkcs12
--caCertChain
lista concatenada de certificados, contendo certificados da CA intermediárias e da CA raiz--precheckOnly
especificayes
para só executar as pré-verificações desta operação. Valores válidos:yes
ouno
.--serverCert
especifica o caminho do certificado PEM a ser usado ou alternado para a configuração TCPS.--privateKey
especifica o caminho do arquivo de chave privada do certificado.--certType
tipo do certificado a ser adicionado à wallet do Grid Infrastructure. Os valores aceitos são:SELF_SIGNED_CERT
,CA_SIGNED_CERT
ouPKCS12_CERT
. Padrão:SELF_SIGNED_CERT
--privateKeyPasswordProtected
especifica se a chave privada é protegida por senha ou não. Valores válidos:true
oufalse
. Padrão:true
.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli grid configureTCPS?
A: O comando dbaascli grid configureTCPS
é usado para configurar o TCPS (Transport Layer Security) para o cluster existente em um ambiente Oracle Exadata.
P: Qual é o pré-requisito para executar o comando dbaascli grid configureTCPS?
A: O comando deve ser executado como usuário root
.
P: O TCPS é ativado por padrão no Exadata Database Service em sistemas de Infraestrutura Dedicada?
R: Sim, o TCPS é ativado por padrão para bancos de dados em sistemas Oracle Exadata Database Service on Dedicated Infrastructure.
P: O TCPS é ativado por padrão nos sistemas Exadata Database Service on Cloud@Customer?
R: Não, o TCPS não é ativado por padrão nos sistemas Exadata Database Service on Cloud@Customer. Para ativar o TCPS, atualize o arquivo sqlnet.ora
do banco de dados específico e reinicie o banco de dados.
P: Qual é a consequência de ativar o TCPS nos sistemas Exadata Cloud@Customer?
R: A ativação do TCPS nos sistemas Exadata Cloud@Customer fará com que as conexões do Zero Data Loss Recovery Appliance (ZDLRA) falhem. Você só pode ativar a configuração ZDLRA ou TCPS, mas não ambos simultaneamente.
P: O que a opção --pkcs12WalletFilePath especifica?
A: A opção --pkcs12WalletFilePath
especifica o caminho absoluto para o arquivo de certificado no formato de wallet PKCS12, que é usado para configuração do TCPS.
P: Para que é usada a opção --caCertChain?
A: A opção --caCertChain
especifica uma lista concatenada de certificados contendo certificados de CA intermediária e o certificado de CA raiz.
P: O que a opção --precheckOnly faz?
A: A opção --precheckOnly
especifica se apenas as pré-verificações devem ser executadas para a operação de configuração do TCPS. Os valores aceitos são yes
ou no
.
P: O que a opção --serverCert especifica?
A: A opção --serverCert
especifica o caminho para o certificado PEM que será usado ou girado para a configuração TCPS.
P: Como especificar a chave privada para a configuração do TCPS?
A: Use a opção --privateKey
para especificar o caminho para o arquivo de chave privada associado ao certificado do servidor.
P: Quais são os valores aceitos para a opção --certType?
A: Os valores aceitos para a opção --certType
são:
SELF_SIGNED_CERT
CA_SIGNED_CERT
PKCS12_CERT
O valor padrão é SELF_SIGNED_CERT
.
P: A senha da chave privada é protegida por padrão?
R: Sim, a opção --privateKeyPasswordProtected
é definida como true
por padrão, indicando que a chave privada é protegida por senha. Você poderá defini-la como false
se a chave privada não for protegida por senha.
P: Posso executar uma pré-verificação antes de configurar o TCPS?
R: Sim, você pode executar somente as pré-verificações da operação definindo a opção --precheckOnly
como sim. Isso ajuda a validar o ambiente antes de fazer alterações.
P: O que acontece se eu fornecer um caminho incorreto para o arquivo da wallet PKCS12?
R: Se --pkcs12WalletFilePath
contiver um caminho incorreto, o comando falhará e a configuração do TCPS não prosseguirá.
P: O que devo fazer se a chave privada estiver protegida por senha?
R: Se a chave privada for protegida por senha, certifique-se de que a opção --privateKeyPasswordProtected
esteja definida como true
(que é o padrão).
P: Posso especificar meu próprio certificado assinado pela CA para a configuração do TCPS?
R: Sim, você pode especificar seu próprio certificado assinado pela CA usando as opções --serverCert
e --privateKey
e definindo --certType
como CA_SIGNED_CERT
.
P: O que é um exemplo de comando para configurar o TCPS usando um certificado autoassinado?
A: Este é um exemplo:
dbaascli grid configureTCPS --serverCert /path/to/self_signed_cert.pem --privateKey /path/to/private_key.pem --certType SELF_SIGNED_CERT
P: Posso usar um certificado PKCS12 para configuração do TCPS?
R: Sim, você pode usar um certificado PKCS12 especificando a opção --pkcs12WalletFilePath
e definindo --certType
como PKCS12_CERT
.
P: O que devo verificar antes de executar o comando dbaascli grid configureTCPS?
R: Verifique se você tem os arquivos de certificado corretos, arquivos de chave privada e se você está conectado como usuário raiz. Além disso, certifique-se de entender as implicações se estiver usando o ZDLRA, pois ele não pode ser executado simultaneamente com o TCPS.
Exemplo 7-27 dbaascli grid configureTCPS
dbaascli grid configureTCPS
dbaascli grid configureTCPS --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --private_key_password_protected false
Tópico principal: Gerenciamento de Infraestrutura de Grade
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]
--subject
especifica o assunto do certificado- Flag
--userCert
para indicar o certificado do usuário - Flag
--trustedCert
para indicar um certificado confiável - flag
--requestedCert
para indicar um certificado solicitado --serialNumber
especifica o número de série do certificado--executePrereqs
executa as verificações de pré-requisito e reporta os resultados--resume
retoma a execução anterior--sessionID
especifica para retomar um ID de sessão específico
- Flag
--bounceListeners
para devolver o listener do Grid Infrastructure e verificar o listener
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli grid removeTCPSCert?
R: O comando dbaascli grid removeTCPSCert
é usado para remover certificados TCPS existentes da wallet do Grid Infrastructure em um ambiente Oracle Exadata.
P: Qual é o pré-requisito para executar o comando dbaascli grid removeTCPSCert?
A: O comando deve ser executado como usuário root
.
P: O que a opção --subject especifica no comando dbaascli grid removeTCPSCert?
A: A opção --subject
especifica o assunto do certificado a ser removido da wallet do Grid Infrastructure.
P: Qual é a finalidade do flag --userCert?
R: O flag --userCert
indica que o certificado a ser removido é um certificado do usuário.
P: Quando devo usar o flag --trustedCert?
A: Use o flag --trustedCert
ao remover um certificado confiável da wallet do Grid Infrastructure.
P: O que o flag --requestedCert faz?
A: O flag --requestedCert
indica que o certificado que está sendo removido é um certificado solicitado.
P: O que a opção --serialNumber especifica?
A: A opção --serialNumber
especifica o número de série do certificado a ser removido. É útil para identificar exclusivamente um certificado quando há vários certificados com o mesmo assunto.
P: Qual é a finalidade da opção --executePrereqs?
A: A opção --executePrereqs
executa verificações de pré-requisitos antes de remover o certificado e reporta os resultados, garantindo que o ambiente esteja devidamente preparado para a operação.
P: O que a opção --resume faz?
A: A opção --resume
retoma a operação de remoção se ela tiver sido interrompida anteriormente.
P: Como especificar um ID de sessão ao retomar uma operação interrompida?
R: Use a opção --sessionID
para especificar o ID da sessão da operação interrompida que você deseja retomar.
P: O que o flag --bounceListeners faz?
R: O flag --bounceListeners
é usado para reiniciar o listener do Grid Infrastructure e verificar o listener após a remoção do certificado TCPS.
P: Posso remover um certificado TCPS sem devolver os listeners?
R: Sim, o flag --bounceListeners
é opcional. Se você não especificá-lo, os listeners não serão devolvidos automaticamente.
Q: Como posso garantir que a operação será executada com segurança?
R: Você pode usar a opção --executePrereqs
para executar verificações de pré-requisitos antes de executar o comando, garantindo que tudo esteja em ordem antes do processo de remoção.
P: O que devo fazer se precisar remover um certificado de usuário específico por número de série?
A: Use a opção --subject
para especificar o assunto do certificado, o flag --userCert
para indicar que ele é um certificado do usuário e a opção --serialNumber
para especificar o número de série do certificado.
P: Posso remover vários certificados de uma só vez?
R: Não, o comando é projetado para remover um único certificado de cada vez com base no assunto fornecido e em outros parâmetros.
P: O que acontece se o processo de remoção do certificado for interrompido?
R: Você pode retomar a operação usando a opção --resume
junto com o --sessionID
do processo interrompido.
P: Preciso executar o comando como usuário raiz?
R: Sim, o comando dbaascli grid removeTCPSCert
deve ser executado como o usuário root
para ter os privilégios necessários para remover certificados TCPS.
P: Como posso identificar o certificado que quero remover?
R: Você pode identificar o certificado pelo seu assunto e, opcionalmente, pelo seu número de série para garantir que você está direcionando o certificado correto para remoção.
P: O que é um exemplo de comando para remover um certificado confiável?
A: Aqui está um exemplo:
dbaascli grid removeTCPSCert --subject "CN=example_cert" --trustedCert
Tópico principal: Gerenciamento de Infraestrutura de Grade
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]
--pkcs12WalletFilePath
especifica o caminho absoluto do arquivo de certificado, que está no formato de walletpkcs12
--caCertChain
lista concatenada de certificados, contendo certificados da CA intermediárias e da CA raiz--precheckOnly
especificayes
para só executar as pré-verificações desta operação. Valores válidos:yes
ouno
.--serverCert
especifica o caminho do certificado PEM a ser usado ou alternado para a configuração TCPS.--privateKey
especifica o caminho do arquivo de chave privada do certificado.--certType
tipo do certificado a ser adicionado à wallet do Grid Infrastructure. Os valores aceitos são:SELF_SIGNED_CERT
,CA_SIGNED_CERT
ouPKCS12_CERT
. Padrão:SELF_SIGNED_CERT
--privateKeyPasswordProtected
especifica se a chave privada é protegida por senha ou não. Valores válidos:true
oufalse
. Padrão:true
.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli grid rotateTCPSCert?
R: O comando dbaascli grid rotateTCPSCert
é usado para rotacionar certificados TCPS (Transport Layer Security Protocol) na wallet do Grid Infrastructure em ambientes Oracle Exadata.
P: Qual é o pré-requisito para executar o comando dbaascli grid rotateTCPSCert?
A: O comando deve ser executado como usuário root
.
P: O que a opção --pkcs12WalletFilePath especifica?
A: A opção --pkcs12WalletFilePath
especifica o caminho absoluto para o arquivo de certificado no formato de wallet PKCS12 para a configuração do TCPS.
P: Qual é a finalidade da opção --caCertChain?
A: A opção --caCertChain
especifica uma lista concatenada de certificados, incluindo CA intermediária e certificados de CA raiz, para a configuração TCPS.
P: O que a opção --precheckOnly faz?
R: A opção --precheckOnly
permite executar pré-verificações sem fazer alterações reais. Os valores válidos são "yes
" para executar somente as pré-verificações e "no
" para prosseguir com a rotação.
P: Como a opção --serverCert é usada?
A: A opção --serverCert
especifica o caminho para o certificado do servidor PEM (Privacy Enhanced Mail) que é usado ou rotacionado para a configuração do TCPS.
P: O que a opção --privateKey especifica?
A: A opção --privateKey
especifica o caminho para o arquivo de chave privada correspondente ao certificado do servidor usado para rotação TCPS.
P: Quais são os valores válidos para a opção --certType?
A: A opção --certType
aceita os seguintes valores para especificar o tipo de certificado a ser adicionado à wallet do Grid Infrastructure:
SELF_SIGNED_CERT
(padrão)
CA_SIGNED_CERT
PKCS12_CERT
P: O que a opção --privateKeyPasswordProtected faz?
A: A opção --privateKeyPasswordProtected
indica se a chave privada é protegida por senha. Os valores válidos são true
(padrão) e false
P: Posso executar o comando dbaascli grid rotateTCPSCert sem girar os certificados?
R: Sim, usando a opção sim --precheckOnly
, você só pode executar as pré-verificações sem girar os certificados.
P: Qual é um exemplo de comando para rotacionar um certificado usando uma wallet PKCS12?
A: Aqui está um exemplo de comando:
dbaascli grid rotateTCPSCert --pkcs12WalletFilePath /path/to/wallet.p12 --certType PKCS12_CERT
P: Como rotaciono um certificado de servidor com uma cadeia de certificados assinada pela CA?
A: Use as opções --serverCert
e --caCertChain
, conforme mostrado abaixo:
dbaascli grid rotateTCPSCert --serverCert /path/to/serverCert.pem --caCertChain /path/to/caChain.pem
P: O que acontece se eu não especificar --privateKeyPasswordProtected?
A: Se você não especificar a opção --privateKeyPasswordProtected
, o comando assumirá que a chave privada é protegida por senha (padrão: true
).
Q: Posso girar um certificado autoassinado?
R: Sim, você pode rotacionar um certificado autoassinado usando a opção --certType SELF_SIGNED_CERT
padrão ou especificando-a explicitamente.
P: Como posso rotacionar um certificado sem fornecer uma chave privada?
R: Para determinados tipos de certificado, como PKCS12, talvez você não precise fornecer um arquivo de chave privada separado, pois ele está incluído na wallet. No entanto, se uma chave privada for necessária, ela deverá ser fornecida usando a opção --privateKey
.
P: E se eu quiser girar um certificado em segundo plano?
R: O comando dbaascli grid rotateTCPSCert
não fornece uma opção explícita para execução em segundo plano. Você pode executar o comando diretamente em uma sessão em segundo plano (por exemplo, usando nohup
ou ferramentas semelhantes).
P: Qual será o tipo de certificado padrão se não for especificado?
A: O tipo de certificado padrão é SELF_SIGNED_CERT
.
Exemplo 7-28 dbaascli grid rotateTCPSCert
dbaascli grid rotateTCPSCert
dbaascli grid rotateTCPSCert --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --privateKeyPasswordProtected true
Tópico principal: Gerenciamento de Infraestrutura de Grade
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]
--version
especifica a versão de destino--resume
retoma a execução anterior--executePrereqs
executa pré-requisitos para upgrade do Grid Infrastrucure--containerUrl
especifica o URL personalizado para extrair a imagem do Grid Infrastrucure--softwareOnly
só instala o software do Grid Infrastructure--targetHome
especifica o caminho do home da Grade de destino existente--revert
reverte a execução com falha
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli grid upgrade?
R: O comando dbaascli grid upgrade
é usado para fazer upgrade do Oracle Grid Infrastructure de uma versão principal para outra em uma máquina virtual do Exadata Cloud@Customer.
P: Qual é o pré-requisito para executar o comando dbaascli grid upgrade?
R: O comando deve ser executado como o usuário root
e você precisa estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: O que a opção --version especifica?
A: A opção --version
especifica a versão de destino do Oracle Grid Infrastructure para a qual você deseja fazer upgrade.
P: O que a opção --resume faz?
A: A opção --resume
retoma um processo de upgrade do Grid Infrastructure interrompido ou com falha anteriormente.
P: Como a opção --executePrereqs é usada?
A: A opção --executePrereqs
executa apenas as verificações de pré-requisitos para o upgrade do Grid Infrastructure sem executar o upgrade real.
P: Qual é a finalidade da opção --containerURL?
A: A opção --containerURL
especifica um URL personalizado para extrair a imagem de software do Grid Infrastructure para o upgrade.
P: O que a opção --softwareOnly faz?
A: A opção --softwareOnly
instala somente o software Grid Infrastructure sem configurar ou fazer upgrade do ambiente Grid.
P: Quando você usaria a opção --targetHome?
A: A opção --targetHome
especifica o caminho para o Grid home de destino existente no qual o upgrade será executado.
P: O que acontece se o upgrade falhar?
R: Se o upgrade falhar, você poderá usar a opção --revert
para fazer rollback do upgrade para seu estado anterior.
P: Posso executar um upgrade do Grid Infrastructure em estágios?
R: Sim, usando a opção --softwareOnly
, você pode primeiro instalar o software e depois concluir o upgrade completo, permitindo upgrades preparados.
P: Como eu uso o comando dbaascli grid upgrade para fazer upgrade somente do software?
A: Use a seguinte sintaxe para fazer upgrade somente do software:
dbaascli grid upgrade --version <target_version> --softwareOnly
P: Posso verificar se há pré-requisitos de upgrade sem executar o upgrade?
R: Sim, você só pode executar as verificações de pré-requisitos usando:
dbaascli grid upgrade --version <target_version> --executePrereqs
P: Como posso fazer upgrade do Grid Infrastructure usando um URL de contêiner personalizado?
A: Você pode especificar o URL para extrair a imagem do Grid Infrastructure da seguinte forma:
dbaascli grid upgrade --version <target_version> --containerURL <custom_url>
P: Como posso retomar um processo de upgrade interrompido anteriormente?
A: Para retomar um upgrade interrompido ou com falha anteriormente, use:
dbaascli grid upgrade --version <target_version> --resume
P: O que a opção --revert faz no comando dbaascli grid upgrade?
A: A opção --revert
faz rollback de um upgrade do Grid Infrastructure com falha ou interrompido para seu estado original.
P: Posso executar um upgrade completo sem configurar o Grid Infrastructure imediatamente?
R: Sim, você pode primeiro instalar apenas o software usando a opção --softwareOnly
e depois configurá-lo posteriormente.
P: O que devo fazer se um upgrade falhar e eu quiser desfazer as alterações?
A: Use a opção --revert
para fazer rollback do upgrade com falha:
dbaascli grid upgrade --version <target_version> --revert
Exemplo 7-29 dbaascli grid upgrade
daascli grid upgrade --version 19.11.0.0.0 --executePrereqs
DBAAS CLI version MAIN
Executing command grid upgrade --version 19.11.0.0.0 --executePrereqs
Tópico principal: Gerenciamento de Infraestrutura de Grade
Aplicação de Patch e Upgrade
Esta seção fornece ferramentas para atualizar e manter ambientes Oracle por meio de patches e atualizações. Ele inclui comandos como dbaascli grid patch
para aplicar patch ao Oracle Grid Infrastructure, dbaascli dbHome patch
para aplicar patches aos Oracle homes e dbaascli database move
para mover bancos de dados entre homes durante upgrades ou processos de aplicação de patch. Esses comandos ajudam a garantir que os sistemas permaneçam seguros, estáveis e atualizados.
- dbaascli grid patch
Para aplicar patch do Oracle Grid Infrastructure na versão secundária especificada, use o comandodbaascli grid patch
. - dbaascli dbHome patch
Para aplicar patch no Oracle home de um nível de patch para outro, use o comandodbaascli dbHome patch
. - dbaascli database move
Para mover o banco de dados de um home para outro, use o comandodbaascli database move
. - Diversos
Tópico principal: Referência de Comando do dbaascli
dbaascli grid patch
Para aplicar patch no Oracle Grid Infrastructure para a versão secundária especificada, use o comando dbaascli grid patch
.
Pré-requisitos
Execute o comando como usuário root
.
Sintaxe
dbaascli grid patch
{
--targetVersion <value>
| --targetHome <value>
}
[--executePrereqs] [--nodeList <value>] [--continueWithDbDowntime] [--drainTimeoutInSeconds <value>] [--containerURL <value>] [--imageFile <value>] [--patchInParallel]
{
[--resume [--sessionID <value>]]
| [--rollback [--sessionID <value>]]
}
[--waitForCompletion <value>]
Em que:
--targetVersion
especifica a versão de destino do Oracle Home indicada como cinco segmentos numéricos separados por pontos (por exemplo, 19.12.0.0.0)--targetHome
especifica o caminho totalmente qualificado do diretório home do Grid Infrastructure de destino para aplicação de patches out-of-place--containerURL
especifica o URL personalizado para extrair a imagem do Grid Infrastructure- Opção
--executePrereqs
para executar pré-requisitos --nodeList
especifica uma lista de nós delimitados por vírgulas se a aplicação de patch tiver de ser executada em um subconjunto de nós--patchInParallel
especifica para executar a correção de nós remotos em paralelo--rollback
especifica para fazer rollback do Oracle home com patch--resume
retoma a execução anterior--sessionID
especifica para retomar um ID de sessão específico
--continueWithDbDowntime
continua aplicando patch com tempo de inatividade do banco de dados. Essa opção pode ser usada em ambientes nos quais só há uma instância ativa e a operação de aplicação de patch pode continuar mesmo com um tempo de inatividade.--drainTimeoutInSeconds
especifica o tempo (em segundos) para concluir a descarga de recursos enquanto o banco de dados é interrompido--createImage
cria uma imagem com base em uma cópia do home do Grid ativo, com patch para a versão de destino especificada--createImageDir
especifica o caminho totalmente qualificado do diretório no qual a imagem será criada
--imageFile
especifica o caminho totalmente qualificado da imagem a ser usada--patchInParallel
executa a aplicação de patch dos nós remotos em paralelo--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
|false
Perguntas Frequentes
P: O que o comando dbaascli grid patch faz?
A: O comando dbaascli grid patch
é usado para aplicar patch no Oracle Grid Infrastructure para uma versão secundária especificada.
P: Preciso de permissões especiais para executar o comando dbaascli grid patch?
R: Sim, você precisa executar o comando dbaascli grid patch
como o usuário root
.
P: Posso especificar uma versão de destino ao aplicar patch ao Oracle Grid Infrastructure?
R: Sim, você pode especificar a versão de destino usando a opção --targetVersion
.
P: Como especifico a versão de destino do patch?
R: Use a opção --targetVersion
seguida do número da versão no formato 19.12.0.0.0
.
P: O que a opção --containerURL faz no comando dbaascli grid patch?
A: A opção --containerURL
permite especificar um URL personalizado para extrair a imagem do Grid Infrastructure.
P: Qual é a finalidade da opção --executePrereqs?
A: A opção --executePrereqs
é usada para executar verificações de pré-requisitos antes de aplicar o patch.
P: Como posso aplicar patch a um subconjunto de nós usando o comando dbaascli grid patch?
A: Use a opção --nodeList
seguida de uma lista delimitada por vírgulas de nomes de nós para aplicar patch apenas a um subconjunto de nós.
P: O que acontece se eu usar a opção --rollback?
A: A opção --rollback
fará rollback do Oracle home com patch para seu estado anterior.
P: Posso retomar uma sessão de aplicação de patch anterior?
R: Sim, você pode usar a opção --resume
para retomar a última sessão de aplicação de patch. Se você tiver um ID de sessão específico, poderá especificá-lo com a opção --sessionID
.
P: Para que é usada a opção --continueWithDbDowntime?
A: A opção --continueWithDbDowntime
permite que você continue aplicando patches mesmo que haja tempo de inatividade do banco de dados, geralmente usado em ambientes em que há apenas uma instância ativa.
P: Como faço para criar uma imagem de um Grid home com patch?
A: Use a opção --createImage
para criar uma imagem. Você pode especificar o diretório em que a imagem deve ser criada usando a opção --createImageDir
.
P: Qual é a finalidade da opção --imageFile?
A: A opção --imageFile
permite especificar o caminho totalmente qualificado do arquivo de imagem a ser usado para aplicação de patches.
P: Como posso executar o comando dbaascli grid patch em segundo plano?
R: Você pode usar a opção --waitForCompletion
definida como false
para executar a operação em segundo plano.
P: Posso usar um URL personalizado para extrair a imagem do patch?
R: Sim, você pode usar a opção --containerURL
para especificar um URL personalizado para extrair a imagem do Grid Infrastructure.
P: Como especifico quais nós aplicar patch se não quiser aplicar patch a todos eles?
R: Você pode especificar os nós que deseja aplicar patch usando a opção --nodeList
com uma lista de nomes de nós separados por vírgulas.
P: O que devo fazer se precisar fazer rollback de um patch?
A: Use a opção --rollback
no comando dbaascli grid patch
para fazer rollback do patch.
P: Como lidar com uma operação de aplicação de patch se meu ambiente tiver apenas uma instância ativa e precisar continuar com o tempo de inatividade?
A: Use a opção --continueWithDbDowntime
para continuar a aplicação de patch mesmo com o tempo de inatividade do banco de dados.
P: Posso criar uma imagem do Grid home corrigido?
R: Sim, você pode usar a opção --createImage
para criar uma imagem do Grid home com patch. Se necessário, especifique o diretório em que a imagem deve ser salva usando --createImageDir
.
P: O que devo fazer se quiser retomar uma sessão de aplicação de patches após uma interrupção?
A: Use a opção --resume
para retomar a sessão de aplicação de patch. Se você souber o ID da sessão, poderá especificá-lo com --sessionID
.
P: E se o processo de aplicação de patch falhar no meio do caminho?
R: Se o processo de aplicação de patch falhar, você poderá usar a opção --resume
para reiniciar o processo. Você também pode usar a opção --rollback
para reverter para o estado anterior.
P: Como posso garantir que todos os pré-requisitos sejam atendidos antes da aplicação de patch?
R: Use a opção --executePrereqs
para executar todas as verificações de pré-requisitos antes de aplicar o patch.
Q: Posso executar a correção em segundo plano para evitar segurar o terminal?
R: Sim, você pode usar a opção --waitForCompletion false
para executar o processo de aplicação de patch em segundo plano.
P: Como posso criar uma imagem do Grid home após a aplicação de patch?
A: Use a opção --createImage
para criar uma nova imagem do Grid home com patch. Especifique o diretório usando --createImageDir
, se necessário.
P: Como eu uso um arquivo de imagem existente para aplicação de patches?
R: Você pode usar a opção --imageFile
para especificar o caminho totalmente qualificado para o arquivo de imagem que deseja usar para aplicação de patch.
P: O que devo fazer se quiser evitar o tempo de inatividade do banco de dados durante a aplicação de patches?
R: Certifique-se de que seu ambiente tenha mais de uma instância ativa em execução. Você pode evitar o uso da opção --continueWithDbDowntime
, que se destina a ambientes com apenas uma instância ativa.
P: Como eu sei o progresso de um patch em execução em segundo plano?
R: Se você executar o patch com --waitForCompletion false
, poderá verificar o status do job em segundo plano usando comandos do sistema operacional como ps
ou verificar os logs localizados no Grid home.
P: É possível aplicar patch a uma versão principal superior usando o patch de grade dbaascli?
R: Não, dbaascli grid patch
só permite aplicação de patch a uma versão secundária da versão principal atual. Para atualizações importantes, você precisará seguir um processo de atualização diferente.
P: Posso ignorar verificações de pré-requisitos específicas durante a aplicação de patch?
R: Não, quando você usar --executePrereqs
, todas as verificações de pré-requisitos serão executadas. No entanto, você pode revisar os resultados das verificações de pré-requisitos e tratar manualmente quaisquer problemas antes de continuar.
P: O que devo fazer se o processo de correção estiver preso ou pendurado?
R: Se o processo de aplicação de patch não responder, você poderá interrompê-lo usando comandos do sistema operacional e retomá-lo usando a opção --resume
. Se isso não funcionar, tente usar a opção --rollback
para reverter o patch.
P: Posso automatizar o processo de aplicação de patches em vários clusters?
R: Sim, usando scripts que incluem o comando dbaascli grid patch
com opções apropriadas, você pode automatizar a aplicação de patches em diferentes clusters.
P: Onde posso encontrar logs para o processo de aplicação de patch?
R: Em geral, os logs estão localizados no diretório de logs do Oracle Grid home ou no local padrão especificado durante a configuração. Você pode monitorar esses logs para obter detalhes sobre o processo de aplicação de patch.
P: É possível criar um processo de patch silencioso sem interação do usuário?
R: Sim, especificando todas as opções necessárias no comando e executando-o em segundo plano (--waitForCompletion false
), você pode criar um processo de aplicação de patch não interativo.
P: Posso verificar se há atualizações de patch disponíveis antes de aplicar um patch?
R: O próprio comando dbaascli grid patch
não tem uma opção para listar patches disponíveis. No entanto, você pode usar os métodos padrão da Oracle, como o Suporte Técnico da Oracle, para identificar os patches mais recentes.
P: Posso usar dbaascli para aplicar patch a vários Oracle Homes?
R: Não, o comando dbaascli grid patch
foi projetado para aplicar patch a um home específico do Oracle Grid Infrastructure de cada vez. Você precisaria executar o comando separadamente para cada home.
P: Existe uma maneira de evitar completamente o tempo de inatividade ao aplicar patch ao Grid Infrastructure?
R: Para minimizar o tempo de inatividade, certifique-se de que seu ambiente tenha várias instâncias de banco de dados ativas (configuração RAC) para que a aplicação de patches possa ser feita nó por nó. A opção --continueWithDbDowntime
não deve ser usada neste caso.
P: Como lidar com a aplicação de patches para ambientes RAC One Node?
R: Em ambientes RAC One Node, você precisa ser cauteloso com a opção --continueWithDbDowntime
, pois pode haver apenas uma instância ativa. Revise a documentação da Oracle para obter diretrizes de aplicação de patches específicas para o RAC One Node.
P: Posso exibir o histórico de sessões de patches anteriores?
R: O utilitário dbaascli não fornece uma maneira direta de exibir o histórico da sessão. No entanto, os logs de sessões de aplicação de patch anteriores podem ser encontrados no diretório de logs do Grid home.
Exemplo de Casos de Uso
Exemplo 1: Aplicação Básica de Patches de Grade
dbaascli grid patch --targetVersion 19.12.0.0.0
Corrige o Oracle Grid Infrastructure para a versão 19.12.0.0.0.
Exemplo 2: Aplicação de Patch com um URL de Contêiner Personalizado
dbaascli grid patch --targetVersion 19.12.0.0.0 --containerURL
https://example.com/custom/url
Corrige o Grid Infrastructure para a versão 19.12.0.0.0, usando um URL de contêiner personalizado para extrair a imagem do Grid Infrastructure.
Exemplo 3: Aplicação de Patch com Verificações de Pré-requisitos
dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs
Corrige o Grid Infrastructure para a versão 19.12.0.0.0 após executar as verificações de pré-requisitos.
Exemplo 4: Aplicação de Patch em um Subconjunto de Nós
dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2,node3
Corrige o Grid Infrastructure para a versão 19.12.0.0.0 nos nós especificados (node1, node2 e node3).
Exemplo 5: Fazendo Rollback do Patch
dbaascli grid patch --rollback
Faz rollback do último patch aplicado no Oracle Grid Infrastructure.
Exemplo 6: Retomando uma Operação de Patch Anterior
dbaascli grid patch --resume
Retoma a operação de aplicação de patch anterior de onde ela foi interrompida.
Exemplo 7: Retomando uma Operação de Patch com um ID de Sessão Específico
dbaascli grid patch --resume --sessionID 12345
Retoma a operação de aplicação de patch usando o ID de sessão 12345.
Exemplo 8: Aplicação de Patch com Tempo de Inatividade do Banco de Dados Permitida
dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime
Corrige o Grid Infrastructure para a versão 19.12.0.0.0, permitindo o tempo de inatividade do banco de dados, se necessário.
Exemplo 9: Criando uma Imagem com Patch
dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir
/path/to/dir
Cria uma imagem do Grid home com patch (versão 19.12.0.0.0) e a armazena no diretório especificado.
Exemplo 10: Usando um Arquivo de Imagem Existente
dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile
/path/to/image/file.zip
Corrige o Grid Infrastructure para a versão 19.12.0.0.0 usando um arquivo de imagem existente localizado em /path/to/image/file.zip.
Exemplo 11: Executando a Operação de Aplicação de Patch em Segundo Plano
dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false
Corrige o Grid Infrastructure para a versão 19.12.0.0.0 e executa a operação em segundo plano.
Exemplo 12: Combinação de Pré-requisitos, URL Personalizado e Subconjunto de Nós
dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --containerURL https://example.com/custom/url --nodeList node1,node2
Aplica o Grid Infrastructure à versão 19.12.0.0.0, executa verificações de pré-requisitos, usa um URL personalizado para a imagem e aplica o patch apenas em node1 e node2.
Exemplo 13: Criando uma Imagem com Patch com um Arquivo de Imagem Existente
dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir --imageFile
/path/to/existing/image.zip
Cria uma imagem corrigida e a armazena no diretório especificado ao usar um arquivo de imagem existente para o patch.
Exemplo 14: Verificando Pré-requisitos sem Aplicação de Patch
dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs
Verifica se todos os pré-requisitos foram atendidos para aplicação de patch na versão 19.12.0.0.0 sem realmente aplicar o patch.
Exemplo 15: Executando Patch e Ignorando Falhas de Pré-requisito
dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime --executePrereqs
Executa o patch mesmo que algumas verificações de pré-requisitos falhem. Isso é útil em cenários em que o tempo de inatividade é permitido e determinados pré-requisitos podem ser ignorados.
Exemplo 16: Verificando Problemas nos Logs de Patch
tail -f
/u01/app/grid/logs/grid_patch.log
Monitora o log de patch em tempo real para diagnosticar quaisquer problemas durante o processo de aplicação de patch.
Exemplo 17: Aplicando o Patch em um Ambiente Paralelo
dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2 --waitForCompletion false
Corrige o Grid Infrastructure em um subconjunto de nós (node1 e node2) e executa o processo em segundo plano.
Exemplo 18: Usando um Arquivo de Imagem Específico de uma Origem Externa
dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile
/mnt/images/grid_patch_19.12.zip
Corrige o Grid Infrastructure usando um arquivo de imagem pré-download localizado em um dispositivo de armazenamento externo.
Exemplo 19: Executando Patch com um ID de Sessão Personalizado
dbaascli grid patch --targetVersion 19.12.0.0.0 --resume --sessionID 67890
Retoma uma operação de aplicação de patch que foi interrompida, usando o ID de sessão 67890.
Exemplo 20: Programando a Aplicação de Patches para Execução Posterior
echo "dbaascli grid patch --targetVersion 19.12.0.0.0" | at 02:00
Programa o comando de aplicação de patch para ser executado às 2:00 AM usando o comando at no Linux.
Exemplo 21: Especificando o Tempo Limite para Conclusão
dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion true --continueWithDbDowntime --timeout 7200
Corrige o Grid Infrastructure enquanto permite tempo de inatividade, mas aguarda até 7200 segundos (2 horas) para conclusão antes do timeout.
Exemplo 22: Criando uma Imagem Personalizada para Outro Ambiente
dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /backups/images/grid_patch
Cria uma imagem personalizada do Grid Infrastructure com patch para armazenar no diretório /backups/images/grid_patch
para uso em outros ambientes.
Exemplo 23: Recuperação de Patch Após a Interrupção
dbaascli grid patch --resume --continueWithDbDowntime
Recupera e retoma o processo de aplicação de patches se ele tiver sido interrompido, com tempo de inatividade do banco de dados permitido.
Exemplo 24: Combinando a Verificação de Pré-requisitos com a Execução em Segundo Plano
dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --waitForCompletion false
Verifica pré-requisitos e executa o patch em segundo plano.
Exemplo 25: Ignorando a Criação de Imagem para Aplicação de Patch Mais Rápida
dbaascli grid patch --targetVersion 19.12.0.0.0 --patchInParallel --continueWithDbDowntime --waitForCompletion false
Corrige o Grid Infrastructure para a versão 19.12.0.0.0 em paralelo entre nós, com tempo de inatividade do banco de dados permitido e sem criar uma imagem para acelerar o processo.
Exemplo 26: Monitorando o Andamento do Patch por meio de Logs
tail -f
/u01/app/grid/logs/grid_patch_progress.log
Monitora o arquivo de log para o progresso da aplicação de patches em tempo real, fornecendo insights sobre cada etapa do processo de aplicação de patches.
Exemplo 27: Aplicação de Patches com Timeout de Drenagem Personalizado
dbaascli grid patch --targetVersion 19.12.0.0.0 --drainTimeoutInSeconds 3600 --continueWithDbDowntime
Corrige o Grid Infrastructure e define um timeout personalizado de 1 hora (3600 segundos) para permitir a drenagem normal de recursos durante o tempo de inatividade do banco de dados.
Exemplo 28: Aplicando um Patch a Nós Específicos com Verificações de Pré-requisito
dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node4 --executePrereqs
Corrige apenas os nós node1 e node4 para a versão 19.12.0.0.0 e executa as verificações de pré-requisitos antecipadamente.
Exemplo 29: Aplicação de Patch sem Aguardar Conclusão
dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false
Começa a aplicar patch no Grid Infrastructure para a versão 19.12.0.0.0 em segundo plano, permitindo que outras tarefas sejam executadas sem aguardar a conclusão do processo.
Exemplo 30: Reaplicando um Patch com Falha Após um Problema de Timeout de Drenagem
dbaascli grid patch --resume --drainTimeoutInSeconds 7200
Retoma a sessão de aplicação de patch anterior e estende o timeout de drenagem do recurso para 2 horas (7200 segundos), caso ele falhe devido ao tempo insuficiente na tentativa anterior.
Exemplo 31: Exibindo Logs de Patch em Tempo Real com ID de Sessão Específico
tail -f
/u01/app/grid/logs/grid_patch_12345.log
Monitora o arquivo de log da sessão de aplicação de patch com o ID de sessão 12345 em tempo real.
Exemplo 32: Aplicação de Patch em um Novo Home de Destino
dbaascli grid patch --targetHome /u01/app/grid_home_19c --executePrereqs
Executa um patch fora do local para um novo home do Oracle Grid localizado em /u01/app/grid_home_19c, com verificações de pré-requisitos.
Exemplo 33: Interrompendo um Job de Patch em Segundo Plano
ps -ef | grep dbaascli | grep patch | awk '{print $2}' | xargs kill -9
Interrompe um job de patch em segundo plano localizando e eliminando o ID do processo associado (PID).
Exemplo 34: Verificando a Conclusão de Patches sem Logs
dbaascli grid status --targetVersion 19.12.0.0.0
Verifica se o patch para a versão 19.12.0.0.0 foi aplicado com sucesso verificando o status da versão atual do Grid Infrastructure.
Tópico principal: Aplicando Patch e Fazendo Upgrade
dbaascli dbHome patch
Para aplicar patch no Oracle home de um nível de patch para outro, use o comando dbaascli dbHome patch
.
Pré-Requisito
Execute o comando como usuário root
.
Sintaxe
dbaascli dbHome patch
{
--oracleHome <value>
| --oracleHomeName <value>
}
[--imageFilePath <value>] [--executePrereqs] [--nodes <value>]
{
[--resume [--sessionID <value>]]
| [--rollback [--sessionID <value>]]
}
[--skipDatapatch]
[--skipClosedPDBs]
[--skipPDBs <value>]
[--continueWithDbDowntime]
[--skipUnreachableNodes]
[--drainTimeoutInSeconds <value>]
[--waitForCompletion <value>]
--oracleHome
especifica o caminho do Oracle home--oracleHomeName
especifica o nome do Oracle home--targetVersion
especifica a versão de destino do Oracle Home definida como cinco segmentos numéricos separados por pontos, por exemplo, 19.12.0.0.0--resume
retoma a execução anterior-
--sessionID
especifica para retomar um ID de sessão específico
-
--continueWithDbDowntime
continua aplicando patch com tempo de inatividade do banco de dados. Essa opção pode ser usada em ambientes nos quais só há uma instância ativa e a operação de aplicação de patch pode continuar mesmo com um tempo de inatividade.--skipUnreachableNodes
ignora a operação em nós inacessíveis--nodes
especifica uma lista de nós delimitados por vírgulas se a aplicação de patch tiver que ser executada em um subconjunto de nós--executePrereqs
executa pré-requisitos--skipDatapatch
ignora a execução dedatapatch
nos bancos de dados--imageFilePath
especifica o caminho absoluto do arquivo de imagem a ser usado--skipPDBs
ignora a execução do datapatch em uma lista especificada de PDBs delimitados por vírgulas. Por exemplo: cdb1:pdb1,cdb2:pdb2 e assim por diante--skipClosedPdbs
ignora a execução dedatapatch
em PDBs fechados--rollback
faz rollback do Oracle home que recebeu patch.--waitForCompletion
especifica false para executar a operação em segundo plano. Valores válidos :true
|false
--drainTimeoutInSeconds
especifica o tempo (em segundos) para concluir a descarga de recursos enquanto o banco de dados é interrompido--skipUnreachableNodes
ignora a operação em nós inacessíveis
Perguntas Frequentes
P: Para que é usado o comando de patch dbaascli dbHome?
A: O comando dbaascli dbHome patch
é usado para aplicar patch no Oracle home de um nível de patch para outro.
P: Preciso de permissões especiais para executar o comando de patch dbaascli dbHome?
R: Sim, você precisa executar o comando como usuário root
.
P: Como especifico o caminho ou o nome do Oracle home para o patch?
A: Use a opção --oracleHome
para especificar o caminho do Oracle home ou --oracleHomeName
para especificar o nome do Oracle home.
P: Como posso definir a versão de destino do patch?
R: Use a opção --targetVersion
seguida do número da versão no formato 19.12.0.0.0
.
P: O que a opção --resume faz?
A: A opção --resume
permite retomar uma sessão de aplicação de patch anterior.
P: Como especificar um ID de sessão específico ao retomar um patch?
R: Use a opção --sessionID
para especificar o ID da sessão de aplicação de patch que você deseja retomar.
P: Para que é usada a opção --continueWithDbDowntime?
A: A opção --continueWithDbDowntime
permite que a aplicação de patch continue mesmo que haja tempo de inatividade do banco de dados, útil em ambientes com apenas uma instância ativa.
P: Como posso ignorar a aplicação de patch em nós inacessíveis?
A: Use a opção --skipUnreachableNodes
para ignorar operações em nós inacessíveis.
P: Como aplicar patch apenas a nós específicos em um cluster?
A: Use a opção --nodes
seguida de uma lista delimitada por vírgulas de nomes de nós para aplicar patch a um subconjunto de nós.
P: Para que serve a opção --executePrereqs?
A: A opção --executePrereqs
executa verificações de pré-requisitos antes de aplicar o patch.
P: Como posso ignorar a execução do datapatch nos bancos de dados?
A: Use a opção --skipDatapatch
para ignorar o processo datapatch durante a aplicação de patch.
P: Posso especificar um local personalizado para a imagem do banco de dados?
R: Sim, use a opção --imageLocation
para especificar um local personalizado para a imagem do banco de dados.
P: O que a opção --skipPDBs faz?
A: A opção --skipPDBs
permite ignorar a execução do datapatch em uma lista especificada de bancos de dados plugáveis (PDBs) delimitados por vírgulas.
P: Como posso ignorar o datapatch em PDBs fechados?
A: Use a opção --skipClosedPDBs
para ignorar o datapatch em PDBs fechados.
P: O que acontece se eu usar a opção --rollback?
A: A opção --rollback
reverterá o Oracle home para seu estado anterior antes que o patch seja aplicado.
P: Como especifico o caminho do Oracle home para aplicação de patch?
A: Use a opção --oracleHome
seguida pelo caminho para o diretório do Oracle home.
P: Como posso aplicar patch a um Oracle home pelo nome dele, e não pelo caminho?
A: Use a opção --oracleHomeName
seguida pelo nome do Oracle home.
P: Como retomo uma operação de aplicação de patch se ela foi interrompida?
A: Use a opção --resume
junto com a opção --sessionID
para retomar uma sessão interrompida específica.
P: Posso continuar o processo de aplicação de patch se o banco de dados estiver inativo?
R: Sim, use a opção --continueWithDbDowntime
para continuar a aplicação de patch, mesmo que o banco de dados esteja inativo.
P: O que devo fazer se alguns nós estiverem inacessíveis durante o processo de aplicação de patch?
A: Use a opção --skipUnreachableNodes
para ignorar os nós inacessíveis.
P: Como posso aplicar o patch apenas a determinados nós?
A: Especifique os nós que você deseja aplicar patch usando a opção --nodes
com uma lista de nomes de nós separados por vírgulas.
P: Como verifico os pré-requisitos antes de aplicar o patch?
R: Use a opção --executePrereqs
para executar verificações de pré-requisitos antes de aplicar o patch.
P: O que devo fazer se quiser evitar a aplicação do datapatch durante o processo de aplicação de patch?
A: Use a opção --skipDatapatch
para ignorar a etapa datapatch.
P: Como posso especificar um local diferente para a imagem do banco de dados usada no processo de aplicação de patch?
A: Use a opção --imageLocation
para especificar um local personalizado para a imagem.
P: E se eu precisar ignorar o datapatch em determinados PDBs?
A: Use a opção --skipPDBs
para ignorar o datapatch em uma lista especificada de PDBs delimitados por vírgulas.
P: Posso ignorar o datapatch em PDBs que não estão abertos no momento?
R: Sim, use a opção --skipClosedPDBs
para ignorar o datapatch em PDBs fechados.
P: O que devo fazer se a correção falhar no meio do caminho?
R: Você pode usar a opção --rollback
para reverter para o estado anterior ou tentar retomar o processo de correção com a opção --resume
.
P: Como posso verificar se todos os pré-requisitos foram atendidos antes de aplicar o patch?
R: Execute o comando de patch com a opção --executePrereqs
para garantir que todos os pré-requisitos sejam atendidos.
P: E se a operação de aplicação de patch não for concluída com sucesso e eu precisar tentar novamente?
A: Use a opção --resume
para repetir a operação de aplicação de patch de onde ela parou. Se necessário, você pode especificar um --sessionID
para retomar uma sessão específica.
P: Como posso verificar se o patch foi aplicado com sucesso?
R: Você pode verificar o processo de aplicação de patch verificando a versão do Oracle home usando o comando opatch lsinventory
após a conclusão do patch.
P: Posso executar o comando de aplicação de patches em um modo dryrun para visualizar ações?
R: Não, o comando dbaascli dbHome patch
não tem um recurso de dryrun. No entanto, você pode usar a opção --executePrereqs
para executar verificações de pré-requisitos antes de realmente aplicar o patch.
P: É possível aplicar vários patches em uma única execução?
A: O comando dbaascli dbHome patch
só permite uma versão de destino por vez. Você precisaria executar o comando separadamente para cada versão do patch.
P: Como tratar a aplicação de patches se o ambiente usar vários Oracle homes?
R: Você pode especificar o Oracle home ao qual deseja aplicar patch usando as opções --oracleHome
ou --oracleHomeName
, dependendo se você está especificando o caminho ou o nome do Oracle home.
P: Posso ignorar o datapatch do PDB e do CDB em um comando?
R: Sim, você pode combinar as opções --skipPDBs
e --skipDatapatch
para ignorar o patch de dados para PDBs e CDB em uma única execução de patch.
P: Posso aplicar um patch e fazer rollback imediatamente se ele causar problemas?
R: Sim, depois de aplicar um patch, você pode usar a opção --rollback
para reverter para o nível de patch anterior se houver algum problema.
P: Posso aplicar patch a vários Oracle homes simultaneamente?
R: Não, você precisa executar o comando dbaascli dbHome patch
individualmente para cada Oracle home.
P: Como posso rastrear o andamento da operação de aplicação de patch?
R: Durante o processo de aplicação de patches, o comando fornece mensagens de saída que mostram o andamento. Você também pode verificar os arquivos de log para obter informações detalhadas.
P: Posso executar a aplicação de patches em paralelo em um ambiente clusterizado?
R: As operações de aplicação de patch podem ser aplicadas a um subconjunto de nós usando a opção --nodes
. No entanto, a aplicação simultânea de patches deve ser tratada com cuidado e você deve garantir que não haja sessões sobrepostas.
P: Como posso identificar quais patches estão disponíveis para meu Oracle home?
R: Você pode verificar os patches disponíveis por meio do portal de suporte da Oracle ou executando o comando opatch lsinventory
para ver os patches atuais aplicados ao Oracle home.
P: Posso especificar um timeout para drenar recursos ao interromper o banco de dados durante a aplicação de patch?
R: Sim, você pode usar a opção --drainTimeoutInSeconds
para especificar o tempo em segundos para drenagem de recursos ao interromper o banco de dados.
P: O que acontece se o patch falhar em um dos nós em um ambiente com vários nós?
R: Você pode usar a opção --skipUnreachableNodes
para ignorar o nó com falha e continuar o processo de aplicação de patch nos nós restantes. Em seguida, você pode resolver o problema no nó com falha separadamente.
P: Como posso fazer com que o processo de aplicação de patches seja executado em segundo plano?
A: Use a opção --waitForCompletion
com um valor de false
para permitir que o processo de aplicação de patch seja executado em segundo plano. Dessa forma, você não precisa esperar que o processo seja concluído de forma interativa.
P: Posso executar uma operação de rollback em um subconjunto de nós em um ambiente clusterizado?
R: Sim, você pode usar a opção --nodes
junto com a opção --rollback
para fazer rollback da aplicação de patch em um conjunto específico de nós.
P: E se eu precisar atualizar a localização da imagem após iniciar o processo de patch?
A: A opção --resume
não permite alterar o local da imagem. No entanto, você pode interromper a sessão e iniciar um novo processo de patch com o --imageLocation
atualizado.
P: Existe uma maneira de verificar quais IDs de sessão estão disponíveis para retomar um patch?
R: Você pode verificar os arquivos de log ou usar as ferramentas do Oracle Cloud para identificar sessões de aplicação de patches ativas ou pausadas e seus IDs de sessão.
P: Posso limitar o tempo de inatividade durante a aplicação de patches?
R: Se você precisar limitar o tempo de inatividade, use a opção --continueWithDbDowntime
com cuidado. Isso permite que você prossiga mesmo quando o tempo de inatividade for esperado, mas requer planejamento para um impacto mínimo no serviço.
Exemplo de Casos de Uso
Exemplo 1: Aplicação Básica de Patches do Oracle Home pelo Caminho do Oracle Home
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0
Corrige o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1
para a versão 19.12.0.0.0.
Exemplo 2: Aplicação de Patch por Nome do Oracle Home
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0
Corrige o Oracle home chamado DB_HOME_NAME
para a versão 19.12.0.0.0.
Exemplo 3: Retomando uma Operação de Patch Anterior
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --resume
Retoma a operação de aplicação de patch anterior para o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1
.
Exemplo 4: Retomando um Patch com um ID de Sessão Específico
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --resume --sessionID 12345
Retoma a operação de aplicação de patch do Oracle home DB_HOME_NAME usando o ID da sessão 12345.
Exemplo 5: Aplicação de Patch com Tempo de Inatividade do Banco de Dados Permitida
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --continueWithDbDowntime
Corrige o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1
para a versão 19.12.0.0.0, permitindo o tempo de inatividade do banco de dados.
Exemplo 6: Ignorando Nós Inacessíveis
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes
Corrige o Oracle home para a versão 19.12.0.0.0 ao ignorar qualquer nó inacessível.
Exemplo 7: Aplicando Patch a um Subconjunto de Nós
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --nodes node1,node2
Corrige o Oracle home para a versão 19.12.0.0.0 somente em node1 e node2.
Exemplo 8: Executando Verificações de Pré-requisitos Antes da Aplicação de Patch
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --executePrereqs
Corrige o Oracle home DB_HOME_NAME
para a versão 19.12.0.0.0 após executar verificações de pré-requisitos.
Exemplo 9: Ignorando a Etapa Datapatch
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch
Corrige o Oracle home para a versão 19.12.0.0.0 sem executar o datapatch nos bancos de dados.
Exemplo 10: Usando um Arquivo de Imagem para Aplicação de Patch
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --imageFilePath /path/to/image/file.zip
Corrige o Oracle home para a versão 19.12.0.0.0 usando um arquivo de imagem localizado em /path/to/image/file.zip
.
Exemplo 11: Ignorando PDBs Específicos Durante o Datapatch
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2
Corrige o Oracle home para a versão 19.12.0.0.0 e ignora a execução de datapatch nos PDBs especificados (pdb1 em cdb1 e pdb2 em cdb2).
Exemplo 12: Ignorando o Datapatch em PDBs Fechados
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipClosedPDBs
Corrige o Oracle home para a versão 19.12.0.0.0 ao ignorar a execução do datapatch em qualquer PDB fechado.
Exemplo 13: Fazendo Rollback do Oracle Home
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback
Faz rollback do último patch aplicado no Oracle home chamado DB_HOME_NAME
.
Exemplo 14: Combinação de Aplicação de Patch com Verificações de Pré-requisitos e Nós Específicos
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --executePrereqs --nodes node1,node2
Corrige o Oracle home para a versão 19.12.0.0.0, executa verificações de pré-requisitos e aplica o patch apenas em node1 e node2.
Exemplo 15: Ignorando Nós Inacessíveis e PDBs Específicos
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --skipUnreachableNodes --skipPDBs cdb1:pdb1
Corrige o Oracle home DB_HOME_NAME
para a versão 19.12.0.0.0 enquanto ignora nós inacessíveis e evita a execução de datapatch em pdb1 em cdb1.
Exemplo 16: Verificando o Pós-Patch da Versão do Oracle Home
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0
opatch lsinventory
Este exemplo mostra como verificar a versão do Oracle home após um patch bem-sucedido executando opatch lsinventory
.
Exemplo 17: Fazendo Rollback de Patches com ID de Sessão Específica
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --sessionID 67890
Faz rollback da aplicação de patch do Oracle home para um ID de sessão de 67890.
Exemplo 18: Aplicação de Patch com Ignorando Verificações de Pré-requisitos
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPrereqs
Corrige o Oracle home, mas ignora as verificações de pré-requisitos antes de aplicar o patch.
Exemplo 19: Aplicando um Patch a uma Imagem Personalizada do Oracle Home
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --imageLocation /custom/location/image.zip
Corrige o Oracle home usando um arquivo de imagem personalizado localizado em /custom/location/image.zip.
Exemplo 20: Ignorando Nós Específicos e Executando Pré-requisitos
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes --executePrereqs
Ignora a aplicação de patches em nós inacessíveis e executa verificações de pré-requisitos antes de aplicar o patch.
Exemplo 21: Ignorando o Datapatch em Todos os PDBs em Vários CDBs
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2,cdb3:pdb3
Corrige o Oracle home, mas ignora o patch de dados nos PDBs especificados em vários CDBs.
Exemplo 22: Continuando a Aplicação de Patches com Tempo de Inatividade em Vários Nós
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --continueWithDbDowntime --nodes node3,node4
Continua a aplicação de patches em node3 e node4 com tempo de inatividade do banco de dados permitido.
Exemplo 23: Ignorando o Datapatch em PDBs e PDBs Fechados
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch --skipClosedPDBs
Corrige o Oracle home ao ignorar o patch de dados e os PDBs fechados.
Exemplo 24: Fazendo Rollback e Reaplicando Patch
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0
Faz rollback do patch atual e, em seguida, reaplica o patch ao Oracle home.
Exemplo 25: Ignorando o Datapatch e Permitindo Tempo de Inatividade em um Nó Específico
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipDatapatch --continueWithDbDowntime --nodes node1
Corrige o Oracle home para a versão 19.13.0.0.0 em node1, ignorando a etapa do datapatch e permitindo tempo de inatividade.
Exemplo 26: Especificando o Timeout de Drenagem Durante o Shutdown do Banco de Dados
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.13.0.0.0 --drainTimeoutInSeconds 300
Corrige o Oracle home DB_HOME_NAME
para a versão 19.13.0.0.0 e permite um timeout de 5 minutos (300 segundos) para drenar recursos durante o shutdown.
Exemplo 27: Executando Patches em Segundo Plano
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --waitForCompletion false
Corrige o Oracle home para a versão 19.13.0.0.0 e executa o processo de aplicação de patch em segundo plano sem aguardar a conclusão.
Exemplo 28: Fazendo Rollback do Patch em um Subconjunto de Nós
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --nodes node1,node2
Faz rollback do último patch aplicado em node1 e node2 somente para o Oracle home especificado.
Exemplo 29: Ignorando Pré-requisitos e Aplicando Patches a Vários Nós
dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipPrereqs --nodes node3,node4
Corrige o Oracle home para a versão 19.13.0.0.0 em node3 e node4 sem executar verificações de pré-requisitos.
Exemplo 30: Fazendo Rollback do Patch e Ignorando Nós Inacessíveis
dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback --skipUnreachableNodes
Faz rollback do último patch no Oracle home DB_HOME_NAME
e ignora nós inacessíveis durante o processo de rollback.
Tópico principal: Aplicando Patch e Fazendo Upgrade
dbaascli database move
Para mover o banco de dados de um home para outro, use o comando dbaascli database move
.
Pré-requisitos
- Antes de executar uma operação de movimentação, certifique-se de que todas as instâncias associadas do banco de dados estejam ativas e em execução.
- Execute o comando como usuário
root
.
Sintaxe
dbaascli database move
{
--oracleHome <value> | --oracleHomeName <value>
}
--dbname <value>
[--executePrereqs]
[--resume [--sessionID <value>]]
[--rollback [--sessionID <value>]]
[--skipDatapatch]
[--skipPDBs <value>]
[--skipClosedPDBs]
[--continueWithDbDowntime]
[--allowParallelDBMove]
[--waitForCompletion <value>]
[--nodeList <value>]
Em que:
--oracleHome
especifica o caminho do Oracle home--oracleHomeName
especifica o nome do Oracle home--dbname
especifica o nome do banco de dados--executePrereqs
executa as verificações de pré-requisito e reporta os resultados--resume
retoma a execução anterior-
--sessionID
especifica para retomar um ID de sessão específico
-
--rollback
faz rollback do banco de dados para o home anterior--sessionID
especifica para retomar um ID de sessão específico
--skipDatapatch
ignora a execução do datapatch nos bancos de dados--skipPdbs
ignora a execução do datapatch em uma lista especificada de PDBs delimitados por vírgulas. Por exemplo: pdb1,pdb2...--skipClosedPDBs
ignora a aplicação de patch em PDBs fechados--continueWithDbDowntime
continua aplicando patch com tempo de inatividade do banco de dados. Essa opção pode ser usada em ambientes nos quais só há uma instância ativa e a operação de aplicação de patch pode continuar mesmo com um tempo de inatividade.--allowParallelDBMove
permite que o banco de dados seja movido em paralelo.--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
|false
--nodeList
especifica uma lista de nós delimitados por vírgulas se a operação precisar ser executada em um subconjunto de nós
Perguntas Frequentes
P: Para que é usado o comando dbaascli database move?
A: O comando dbaascli database move
é usado para mover um banco de dados de um Oracle home para outro.
P: Quais são os pré-requisitos para usar o comando dbaascli database move?
R: Antes de executar uma operação de movimentação, verifique se todas as instâncias associadas do banco de dados estão ativas e em execução. Além disso, o comando deve ser executado como usuário root
.
P: O que o parâmetro --oracleHome especifica?
A: O parâmetro --oracleHome
especifica o caminho do Oracle home para o qual o banco de dados será movido.
P: O que o parâmetro --oracleHomeName especifica?
A: O parâmetro --oracleHomeName
especifica o nome do Oracle home para o qual o banco de dados será movido.
P: Qual é a finalidade do parâmetro --dbname?
A: O parâmetro --dbname
especifica o nome do banco de dados que você deseja mover.
P: O que a opção --executePrereqs faz?
A: A opção --executePrereqs
executa as verificações de pré-requisitos e reporta os resultados.
P: Para que é usada a opção --resume?
A: A opção --resume
retoma uma operação de movimentação interrompida ou incompleta anteriormente.
P: Como --sessionID é usado no comando?
A: O --sessionID
especifica o ID da sessão para retomar uma execução ou rollback anterior.
P: O que a opção --rollback faz?
A: A opção --rollback
faz rollback do banco de dados para seu Oracle home anterior.
P: O que a opção --skipDatapatch faz?
A: A opção --skipDatapatch
ignora a execução do datapatch nos bancos de dados durante a operação de movimentação.
P: Qual é a função da opção --skipPDBs?
A: A opção --skipPDBs
ignora a execução do datapatch em uma lista especificada de PDBs (por exemplo, pdb1, pdb2).
P: O que a opção --skipClosedPDBs faz?
A: A opção --skipClosedPDBs
ignora a aplicação de patches de PDBs fechados.
P: O que --continueWithDbDowntime significa?
R: A opção --continueWithDbDowntime
permite que a operação de movimentação prossiga mesmo que haja apenas uma instância ativa ativa, permitindo tempo de inatividade durante o processo.
P: Qual é a finalidade da opção --allowParallelDBMove?
A: A opção --allowParallelDBMove
permite que a movimentação do banco de dados seja executada em paralelo, potencialmente acelerando o processo.
P: O que --waitForCompletion especifica?
A: A opção --waitForCompletion
especifica se a operação deve ser concluída. Definir como falso executa a operação em segundo plano.
P: Como eu uso o parâmetro --nodeList?
R: O parâmetro --nodeList
especifica uma lista de nós delimitados por vírgulas nos quais a operação de movimentação será executada, se não for aplicada a todos os nós.
P: O que devo fazer se encontrar problemas com o comando dbaascli database move?
R: Certifique-se de que todas as instâncias do banco de dados estejam em execução e verifique se você está executando o comando como o usuário root
. Se os problemas persistirem, consulte a documentação de comando detalhada ou abra um ticket de suporte com a Oracle.
P: Posso executar uma operação de movimentação se uma das instâncias do banco de dados estiver inativa?
R: Não, todas as instâncias associadas do banco de dados devem estar ativas e em execução antes de executar a operação de movimentação.
P: O que acontece se a operação de movimentação for interrompida?
R: Você pode usar a opção --resume
para continuar a operação de movimentação de onde parou usando a mesma sessão ou especificando --sessionID
.
P: O que a opção --allowParallelDBMove faz?
R: Permite que a movimentação do banco de dados seja executada em paralelo, o que pode reduzir o tempo necessário para concluir a operação, especialmente em ambientes maiores.
P: Como monitoro o andamento de uma operação de movimentação que está sendo executada em segundo plano?
R: Ao usar --waitForCompletion false
, o comando não aguarda a conclusão da operação. Você pode verificar o status da operação manualmente usando os logs ou comandos de status apropriados da Oracle.
P: Qual é o significado da opção --skipClosedPDBs?
R: Ele ignora a aplicação de patches para PDBs fechados, reduzindo o tempo de operação se houver PDBs que não precisem de aplicação de patch.
P: A movimentação do banco de dados pode ser revertida a qualquer momento?
R: Sim, a operação de movimentação pode ser submetida a rollback usando a opção --rollback
, especificando o ID da sessão ou simplesmente fazendo rollback para o Oracle home anterior.
P: Qual é a função de --nodeList em um ambiente com vários nós?
R: Em um ambiente com vários nós, você pode restringir a operação de movimentação a nós específicos fornecendo uma lista delimitada por vírgulas de nomes de nós com --nodeList
.
P: Posso mover o banco de dados para um novo Oracle home ao ignorar nós específicos em um ambiente com vários nós?
R: Sim, você pode usar a opção --nodeList
para especificar quais nós incluir na operação de movimentação. Todos os nós não listados serão ignorados.
P: Qual é o número máximo de nós que posso especificar com o parâmetro --nodeList?
R: O parâmetro --nodeList
permite especificar uma lista delimitada por vírgulas de quantos nós forem necessários, limitada apenas pela configuração do seu ambiente. Certifique-se de que todos os nós sejam válidos e acessíveis.
P: Como sei quais PDBs estão fechados antes de usar a opção --skipClosedPDBs?
R: Você pode consultar a view v$pdbs
para verificar o status de seus PDBs. Todos os PDBs com um status de "MOUNTED
" ou "CLOSED
" serão ignorados ao usar --skipClosedPDBs
.
P: Como verifico se um rollback foi concluído com sucesso?
R: Após executar o comando de rollback, você pode revisar os logs do banco de dados ou usar os logs de alerta da Oracle para verificar se o banco de dados foi submetido a rollback com sucesso para seu Oracle home anterior.
P: Existe uma maneira de forçar a operação de movimentação se alguns pré-requisitos falharem?
R: O comando move impõe verificações de pré-requisitos para a estabilidade do sistema. Não é possível ignorar falhas críticas de pré-requisitos. Resolva todos os problemas reportados pela opção --executePrereqs
antes de prosseguir com a movimentação.
Exemplo de Casos de Uso
Exemplo 1: Movimentação Básica do Banco de Dados pelo Caminho do Oracle Home
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL
Move o banco de dados ORCL
para o Oracle home localizado em /u01/app/oracle/product/19.0.0/dbhome_1
.
Exemplo 2: Movimentação do Banco de Dados pelo Nome do Oracle Home
dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL
Move o banco de dados ORCL
para o Oracle home chamado DB_HOME_NAME
.
Exemplo 3: Executando Verificações de Pré-requisitos Antes de Mover
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --executePrereqs
Move o banco de dados ORCL
para o Oracle home ao executar as verificações de pré-requisitos de antemão.
Exemplo 4: Retomando uma Operação de Movimentação Anterior
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --resume
Retoma uma operação de movimentação anterior para o banco de dados ORCL
.
Exemplo 5: Retomando uma Operação de Movimentação com um ID de Sessão Específico
dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --resume --sessionID 12345
Retoma a operação de movimentação do banco de dados ORCL usando o ID de sessão 12345.
Exemplo 6: Fazendo Rollback de uma Operação de Movimentação
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --rollback
Faz rollback da operação de movimentação do banco de dados ORCL, restaurando-a para o Oracle home anterior.
Exemplo 7: Fazendo Rollback de uma Operação de Movimentação com um ID de Sessão
dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --rollback --sessionID 67890
Faz rollback da operação de movimentação para ORCL usando o ID da sessão 67890.
Exemplo 8: Ignorando Datapatch
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipDatapatch
Move o banco de dados ORCL
sem executar o datapatch nos bancos de dados.
Exemplo 9: Ignorando PDBs Específicos Durante o Datapatch
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipPDBs pdb1,pdb2
Move o banco de dados ORCL
para um novo Oracle home, mas ignora a execução do patch de dados nos PDBs especificados (pdb1 e pdb2).
Exemplo 10: Ignorando o Datapatch em PDBs Fechados
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipClosedPDBs
Move o banco de dados ORCL
e ignora a execução do patch de dados em qualquer PDB fechado.
Exemplo 11: Permitindo o Tempo de Inatividade do Banco de Dados Durante a Movimentação
dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --continueWithDbDowntime
Move o banco de dados ORCL
para o Oracle home especificado, permitindo o tempo de inatividade do banco de dados durante o processo de movimentação.
Exemplo 12: Movendo o Banco de Dados em Paralelo
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --allowParallelDBMove
Move o banco de dados ORCL
para o Oracle home especificado com a opção de executar a movimentação em paralelo para obter melhor desempenho.
Exemplo 13: Executando a Operação em Segundo Plano
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --waitForCompletion false
Move o banco de dados ORCL
para um novo Oracle home, mas executa a operação em segundo plano.
Exemplo 14: Especificando Nós para a Movimentação
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --nodeList node1,node2
Move o banco de dados ORCL
para o Oracle home especificado, mas executa a operação somente em node1 e node2.
Exemplo 15: Combinação de Movimentação com Verificações de Pré-requisitos, Ignorando PDBs Específicos e Permitindo Período de Indisponibilidade
dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --executePrereqs --skipPDBs pdb1 --continueWithDbDowntime
Move o banco de dados ORCL
para o Oracle home especificado, executa verificações de pré-requisitos, ignora a execução do datapatch em pdb1 e permite o tempo de inatividade do banco de dados durante a operação.
Exemplo 16: Combinação de Movimentação em Paralelo e Execução em Segundo Plano
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --allowParallelDBMove --waitForCompletion false
Move o banco de dados ORCL
para um novo Oracle home, executa a movimentação em paralelo e executa a operação em segundo plano.
Exemplo 17: Combinando Movimentação com Execução Paralela e Ignorando PDBs Fechados
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname TESTDB --allowParallelDBMove --skipClosedPDBs
Move o banco de dados TESTDB
para o novo Oracle home /u02/app/oracle/product/19.0.0/dbhome_2
, enquanto executa a operação em paralelo e ignora o datapatch em PDBs fechados.
Exemplo 18: Executando Somente Verificação de Pré-requisitos
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname PRODDB --executePrereqs
Verifica os pré-requisitos para mover o banco de dados PRODDB
para o Oracle home localizado em /u02/app/oracle/product/19.0.0/dbhome_2
sem realmente executar a movimentação.
Exemplo 19: Ignorando o Datapatch para PDBs Específicos
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname HRDB --skipPDBs pdb1,pdb3
Move o banco de dados HRDB
para o novo Oracle home, mas ignora a execução do datapatch para pdb1 e pdb3.
Exemplo 20: Executando a Movimentação em Nós Específicos
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname FINDB --nodeList node1,node3
Move o banco de dados FINDB
para o novo Oracle home somente em node1 e node3.
Exemplo 21: Movimentação do Banco de Dados com Tempo de Inatividade Permitido
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --continueWithDbDowntime
Move o banco de dados ORCL
para o Oracle home especificado, permitindo tempo de inatividade durante a operação de movimentação.
Exemplo 22: Combinação de Movimentação Paralela e Ignorando Datapatch
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname CRMDB --allowParallelDBMove --skipDatapatch
Move o banco de dados CRMDB
em paralelo, ignorando o processo datapatch.
Exemplo 23: Operação de Movimentação em Segundo Plano com uma Lista de Nós
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname SALESDB --waitForCompletion false --nodeList node2,node3
Move o banco de dados SALESDB
para o Oracle home especificado em segundo plano, e a operação só é aplicada em node2 e node3.
Exemplo 24: Movimentação do Banco de Dados com Verificação de Pré-requisito e Permissão de Movimentação Paralela
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_2 --dbname ORCL --executePrereqs --allowParallelDBMove
Move o banco de dados ORCL
para o novo Oracle home após executar as verificações de pré-requisitos e executar a operação de movimentação em paralelo.
Exemplo 25: Fazendo Rollback de uma Operação de Movimentação e Ignorando PDBs Fechados
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname DEVDB --rollback --skipClosedPDBs
Faz rollback da operação de movimentação do banco de dados DEVDB
, ignorando quaisquer PDBs fechados.
Exemplo 26: Movendo o Banco de Dados com Tempo de Inatividade Específico e Execução Paralela
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname FINDB --allowParallelDBMove --continueWithDbDowntime
Move o banco de dados FINDB
para o Oracle home especificado, permitindo tempo de inatividade do banco de dados e permitindo a execução paralela para acelerar o processo.
Exemplo 27: Verificando Pré-requisitos de Movimentação do Banco de Dados sem Executar a Movimentação
dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname HRDB --executePrereqs
Executa verificações de pré-requisitos para validar se o banco de dados HRDB
pode ser movido para o Oracle home especificado sem executar a movimentação propriamente dita.
Exemplo 28: Movendo o Banco de Dados e Executando o Comando em Segundo Plano em Nós Específicos
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_3 --dbname PRODDB --waitForCompletion false --nodeList node1,node4
Move o banco de dados PRODDB
para um novo Oracle home, executando a operação em segundo plano e aplicando-a apenas em node1 e node4.
Exemplo 29: Combinando Verificações de Pré-requisitos, Ignorando PDBs Fechados e Permitindo Execução Paralela
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname CRMDB --executePrereqs --skipClosedPDBs --allowParallelDBMove
Executa verificações de pré-requisitos antes de mover o banco de dados CRMDB
para o novo Oracle home, ignora a aplicação de patches em PDBs fechados e permite que a operação seja executada em paralelo para uma execução mais rápida.
Exemplo 30: Movimentação do Banco de Dados com Rollback em um ID de Sessão Específico e Ignorando o Datapatch
dbaascli database move --oracleHomeName DB_HOME_NAME --dbname DEVDB --rollback --sessionID 45678 --skipDatapatch
Faz rollback de uma operação de movimentação executada anteriormente para o banco de dados DEVDB
para seu Oracle home anterior usando o ID da sessão 45678, ignorando o processo datapatch durante o rollback.
Exemplo 31: Movendo o Banco de Dados com Permitir Execução Paralela e Especificando o Ignoramento de Datapatch para PDBs
dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_3 --dbname ANALYTICDB --allowParallelDBMove --skipPDBs pdb2,pdb4
Move o banco de dados ANALYTICDB
em paralelo ao Oracle home especificado e ignora o processo datapatch para pdb2 e pdb4.
Tópico principal: Aplicando Patch e Fazendo Upgrade
Diversos
P: Como posso ignorar a execução do catbundle ao aplicar patch ao Oracle Database 11.2.0.4.0?
R: Para ignorar a execução de catbundle
durante o processo de aplicação de patch do Oracle Database, use a opção --skipDatapatch
com o comando dbaascli database move
ou dbaascli dbHome patch
.
P: Quais são as melhores práticas a serem seguidas durante a aplicação de patches do Oracle Database?
R: A Oracle recomenda executar aplicação de patch fora do local usando o comando dbaascli database move
para minimizar a janela de aplicação de patch.
A Oracle recomenda o uso da opção --allowParallelDBMove
para ativar a aplicação de patches paralelos, o que poderá agilizar o processo.
P: Os avisos reportados durante os pré-requisitos de patch do Oracle Database podem ser ignorados?
R: É aconselhável abordar e resolver quaisquer avisos relatados durante a verificação de pré-requisitos antes de continuar com o processo de aplicação de patches. Ignorar avisos pode levar a problemas durante a aplicação de patch real.
P: Como posso continuar com a aplicação de patches do Oracle Database se apenas uma instância do banco de dados estiver ativa e em execução?
R: Recomenda-se ter pelo menos duas instâncias em execução para evitar o tempo de inatividade do banco de dados. Se não for possível executar duas instâncias, você poderá usar a opção --continueWithDbDowntime
com o comando dbaascli database move
ou dbaascli dbHome patch
para continuar com a aplicação de patches apesar do tempo de inatividade.
P: Em um ambiente do Data Guard, o datapatch é executado nos bancos de dados principal e stand-by?
R: Não, em um ambiente Data Guard, o datapatch é executado apenas como parte do processo principal de aplicação de patches do banco de dados.
P: Atualizações de Software Provisórias (patches one-off) ou patches individuais podem ser aplicados manualmente em Oracle Homes em ambientes Exadata Cloud@Customer (ExaDB-C@C)?
R: Sim, patches one-off ou patches individuais podem ser aplicados manualmente aos Oracle Homes nos ambientes ExaDB-C@C. No entanto, é recomendável usar a opção Imagem de Software do Oracle Database para um processo de aplicação de patches mais simplificado e suportado.
P: Como aplico patch a vários bancos de dados Oracle em execução no mesmo Oracle Home quando cada banco de dados está em execução em apenas um nó?
R: Use o comando dbaascli dbHome patch
para aplicar patch no Oracle Home especificado, que aplicará o patch a todos os bancos de dados em execução nesse home. Recomenda-se ter várias instâncias em execução para evitar tempo de inatividade. Se não for possível executar várias instâncias, você poderá usar a opção --continueWithDbDowntime
para continuar com a aplicação de patches apesar do tempo de inatividade.
Tópico principal: Aplicando Patch e Fazendo Upgrade
Gerenciamento de Banco de Dados Plugável (PDB)
Esta seção abrange o gerenciamento de Bancos de Dados Plugáveis (PDBs) em um banco de dados contêiner (CDB). Ele inclui comandos para criar (dbaascli pdb create
), excluir (dbaascli pdb delete
) e clonar PDBs (dbaascli pdb localClone
, dbaascli pdb remoteClone
). Você pode gerenciar estados do PDB com comandos para abrir, fechar ou devolver PDBs e recuperar detalhes da conexão (dbaascli pdb getConnectString
). Comandos adicionais suportam backup, recuperação e realocação de PDBs, garantindo controle abrangente sobre o ciclo de vida e as operações do PDB.
- dbaascli pdb backup
Para fazer backup de um banco de dados plugável (PDB), consultar backups 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 create
Para criar um novo banco de dados plugável (PDB), use o comandodbaascli pdb create
. - dbaascli pdb delete
Para excluir um banco de dados plugável (PDB), execute o comandodbaascli pdb delete
. - 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 getDetails
Para exibir detalhes de um banco de dados plugável (PDB), use o comandodbaascli pdb getDetails
. - dbaascli pdb list
Para exibir a lista de bancos de dados plugáveis (PDB) em um banco de dados contêiner, use o comandodbaascli pdb list
. - dbaascli pdb localClone
Para criar um novo banco de dados plugável (PDB) como clone de um PDB existente, no mesmo banco de dados contêiner (CDB), use o 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 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 pdb relocate
Para realocar o PDB especificado do banco de dados remoto para o banco de dados local, use o comandodbaascli pdb relocate
.
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 7-30 Exemplos
- Para fazer backup level1 de um PDB pdb1 em um CDB myTestDb:
dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --start --level1
- Para consultar o status da solicitação de backup do PDB submetida com
uuid
eef16b26361411ecb13800163e8e4fac:dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --status --uuid eef16b26361411ecb13800163e8e4fac
Tópicos Relacionados
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
dbaascli pdb bounce
Para devolver um banco de dados plugável (PDB), use o comando dbaascli pdb bounce
.
Pré-Requisito
Execute o comando como usuário oracle
.
Sintaxe
dbaascli pdb bounce --dbname --pdbName | --pdbUID
[–openMode]
--dbname
especifica o nome do banco de dados contêiner que hospeda o PDB--pdbName
especifica o nome do PDB--pdbUID
especifica o identificador do PDB--openMode
especifica o destinoOPEN MODE
do PDB
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli pdb bounce?
R: O comando dbaascli pdb bounce
é usado para devolver (reiniciar) um banco de dados plugável (PDB) em um ambiente Exadata Cloud@Customer.
P: Quais são os pré-requisitos para usar o comando dbaascli pdb bounce?
R: O comando deve ser executado como o usuário oracle
e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: Como faço para devolver um PDB especificando seu nome?
A: Para devolver um PDB especificando seu nome, use a seguinte sintaxe:
dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name>
P: Como faço para devolver um PDB usando seu identificador exclusivo (UID)?
A: Para devolver um PDB usando seu identificador exclusivo (UID), use a seguinte sintaxe:
dbaascli pdb bounce --dbname <CDB_Name> --pdbUID <PDB_UID>
P: Para que é usada a opção --dbname?
A: A opção --dbname
especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) que está sendo devolvido.
P: Para que é usada a opção --pdbName?
A: A opção --pdbName
especifica o nome do banco de dados plugável (PDB) que você deseja devolver.
P: Para que é usada a opção --pdbUID?
A: A opção --pdbUID
especifica o identificador exclusivo (UID) do banco de dados plugável (PDB) que você deseja devolver.
P: Como especifico o modo de abertura do alvo para o PDB quando ele é devolvido?
R: Você pode usar a opção --openMode
para especificar o modo de abertura desejado para o PDB após o bouncing. Os valores válidos são READ_WRITE
e READ_ONLY
. Por exemplo:
dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE
P: Posso abrir o PDB no modo somente leitura após devolvê-lo?
R: Sim, você pode usar a opção --openMode READ_ONLY
para abrir o PDB no modo somente leitura após o bouncing:
dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_ONLY
P: Qual será o modo aberto padrão se --openMode não for especificado?
R: Se --openMode
não for especificado, o PDB será aberto em seu modo de abertura padrão, que geralmente é READ_WRITE
.
P: Posso usar --pdbName e --pdbUID no mesmo comando?
R: Não, você deve especificar --pdbName
ou --pdbUID
, mas não ambos no mesmo comando.
P: Como posso reiniciar um PDB e garantir que ele seja aberto no modo de leitura e gravação?
A: Para reiniciar um PDB e garantir que ele seja aberto no modo de leitura e gravação, use a opção --openMode READ_WRITE
:
dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE
P: É obrigatório especificar o modo de abertura ao usar o comando dbaascli pdb bounce?
A: Não, especificar --openMode
é opcional. Se não for fornecido, o PDB será aberto em seu modo padrão.
P: O que acontece se eu não especificar o flag --openMode?
R: Se o flag --openMode
não for especificado, o PDB será aberto em seu modo padrão, que geralmente é READ_WRITE
.
Exemplo 7-31 dbaascli pdb bounce
dbaascli pdb bounce --dbname cdb_name --pdbName pdb name associated with the CDB
dbaascli pdb bounce --dbname cdb_name --pdbUID con_uid of that pdb
--openMode READ_WRITE
--openMode READ_ONLY
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
dbaascli pdb close
Para fechar um banco de dados plugável (PDB), use o comando dbaascli pdb close
.
Pré-Requisito
Execute o comando como usuário oracle
.
Sintaxe
dbaascli pdb close --dbname --pdbName | --pdbUID
--dbname
especifica o nome do banco de dados contêiner que hospeda o PDB.--pdbname
especifica o nome do PDB que você deseja fechar.--pdbUID
especifica o identificador do PDB
Após a conclusão bem-sucedida da execução desse comando, o PDB é fechado em todas as instâncias do banco de dados contêiner.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli pdb close?
R: O comando dbaascli pdb close
é usado para fechar um PDB (banco de dados plugável) em um ambiente Exadata Cloud@Customer.
P: Quais são os pré-requisitos para usar o comando dbaascli pdb close?
R: O comando deve ser executado como o usuário oracle
e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: Como fecho um PDB especificando seu nome?
A: Para fechar um PDB especificando seu nome, use a seguinte sintaxe:
dbaascli pdb close --dbname <CDB_Name> --pdbName <PDB_Name>
P: Como fecho um PDB especificando seu identificador exclusivo (UID)?
A: Para fechar um PDB usando seu identificador exclusivo (UID), use a seguinte sintaxe:
dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>
P: O que a opção --dbname faz no comando dbaascli pdb close?
A: A opção --dbname
especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) que você deseja fechar.
P: O que a opção --pdbName faz no comando dbaascli pdb close?
A: A opção --pdbName
especifica o nome do banco de dados plugável (PDB) que você deseja fechar.
P: Qual é a finalidade da opção --pdbUID no comando dbaascli pdb close?
A: A opção --pdbUID
permite especificar o identificador exclusivo (UID) do banco de dados plugável (PDB) que você deseja fechar.
P: Posso fechar o PDB em uma instância específica do CDB?
R: Não, após a conclusão bem-sucedida, o PDB é fechado em todas as instâncias do CDB (banco de dados contêiner).
P: É possível especificar --pdbName e --pdbUID no mesmo comando?
R: Não, você pode especificar --pdbName
ou --pdbUID
, mas não ambos no mesmo comando.
P: O que acontece quando o comando dbaascli pdb close é concluído com sucesso?
R: Quando o comando é concluído com sucesso, o banco de dados plugável (PDB) é fechado em todas as instâncias do banco de dados contêiner (CDB).
P: Como eu fecho um PDB específico em um CDB usando seu UID?
A: Você pode fechar um PDB específico usando seu UID executando:
dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>
P: O que acontece se eu esquecer de especificar --pdbName ou --pdbUID?
A: Você deve especificar --pdbName
ou --pdbUID
no comando. Se nenhum for fornecido, o comando não será executado.
P: Posso usar o comando dbaascli pdb close para um CDB diretamente?
R: Não, o comando é projetado para fechar um banco de dados plugável (PDB) dentro de um banco de dados contêiner (CDB), não o próprio CDB.
Exemplo 7-32 dbaascli pdb close
dbaascli pdb close --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb close --dbname cdb name --pdbUID con_uid of that pdb
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
dbaascli pdb create
Para criar um novo banco de dados plugável (PDB), use o comando dbaascli pdb create
.
Pré-Requisito
Execute o comando como usuário oracle
.
Sintaxe
dbaascli pdb create --pdbName <value> --dbName <value>
[--maxCPU <value>]
[--maxSize <value>]
[--pdbAdminUserName <value>]
[--lockPDBAdminAccount <value>]
[--resume [--sessionID <value>]]
[--executePrereqs <value>]
[--waitForCompletion <value>]
[--blobLocation |--standbyBlobFromPrimary <value>]
--pdbName
especifica o nome do novo PDB que você deseja criar--dbName
especifica o nome do banco de dados contêiner que hospeda o novo PDB--maxCPU
especifica opcionalmente o número máximo de CPUs que estão disponíveis ao PDB. A definição dessa opção é efetivamente o mesmo que definir o parâmetroCPU_COUNT
no PDB--maxSize
especifica opcionalmente o tamanho total máximo dos arquivos de dados e temporários para tablespaces pertencentes ao PDB. A definição dessa opção é efetivamente o mesmo que definir a cláusula de armazenamentoMAXSIZE PDB
no comando SQLCREATE PLUGGABLE DATABASE
. Você pode impor um limite especificando um número inteiro seguido de uma unidade de tamanho (K
,M
,G
ouT
) ou pode especificarUNLIMITED
para não impor explicitamente qualquer limite--pdbAdminUserName
especifica o novo nome do usuário administrador do PDB--lockPDBAdminAccount
especificatrue
oufalse
para bloquear a conta de usuário administrador do PDB. O valor default éverdadeiro
.--resume
retoma a execução anterior--sessionID
especifica para retomar um ID de sessão específico
--executePrereqs
especificayes
para só executar os pré-requisitos desta operação. Valores válidos:yes
ouno
--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
oufalse
--blobLocation
- local de diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG.--standbyBlobFromPrimary
especifica o local do arquivo blob stand-by, que é preparado usando o banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by.Observe que
os parâmetrosblobLocation
estandbyBlobFromPrimary
são mutuamente exclusivos.
Durante o processo de criação do PDB, você é solicitado a especificar a senha de administração do novo PDB.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli pdb create?
R: O comando dbaascli pdb create
é usado para criar um novo banco de dados plugável (PDB) em um banco de dados contêiner (CDB) em um ambiente Exadata Cloud@Customer.
P: Quais são os pré-requisitos para usar o comando dbaascli pdb create?
R: O comando deve ser executado como o usuário oracle
e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: O que a opção --pdbName faz no comando dbaascli pdb create?
A: A opção --pdbName
especifica o nome do novo banco de dados plugável (PDB) que você deseja criar.
P: O que a opção --dbName faz no comando dbaascli pdb create?
A: A opção --dbName
especifica o nome do banco de dados contêiner (CDB) que hospedará o novo banco de dados plugável (PDB).
P: Posso limitar os recursos de CPU para o novo PDB?
R: Sim, você pode usar a opção --maxCPU
para especificar o número máximo de CPUs que o PDB pode usar. Isso é equivalente a definir o parâmetro CPU_COUNT
no PDB.
P: Como posso limitar o tamanho do armazenamento de um PDB?
R: Você pode usar a opção --maxSize
para especificar o tamanho total máximo de arquivos de dados e arquivos temporários para o PDB. Você pode definir um limite de tamanho (em K, M, G ou T) ou especificar UNLIMITED
sem limite.
P: Para que é usada a opção --pdbAdminUserName?
A: A opção --pdbAdminUserName
especifica o nome do usuário administrador do novo PDB. Esse usuário terá privilégios administrativos no PDB.
P: É possível bloquear a conta do usuário administrador durante a criação do PDB?
R: Sim, você pode usar a opção --lockPDBAdminAccount
para especificar se a conta de administrador do PDB deve ser bloqueada. O valor default é true
(bloqueado).
P: O que a opção --resume faz no comando dbaascli pdb create?
A: A opção --resume
permite retomar um processo de criação de PDB com falha anterior.
P: Como especificar um ID de sessão para retomar uma execução anterior?
R: Você pode especificar um ID de sessão usando a opção --sessionID
para retomar uma sessão específica do processo de criação do PDB.
P: Qual é a finalidade da opção --executePrereqs?
A: A opção --executePrereqs
especifica se apenas as verificações de pré-requisito devem ser executadas para a criação do PDB. Você pode definir essa opção como yes
ou no
.
P: Posso executar o processo de criação do PDB em segundo plano?
R: Sim, você pode usar a opção --waitForCompletion
e defini-la como falsa para executar a operação em segundo plano.
P: Para que é usada a opção --standbyBlobFromPrimary?
A: A opção --standbyBlobFromPrimary
especifica o local do arquivo blob stand-by, que é preparado no banco de dados principal. Isso é necessário para operações de PDB do banco de dados stand-by.
P: Como serei solicitado a informar a senha de administrador do PDB durante o processo de criação?
R: Durante o processo de criação do PDB, você será solicitado a especificar a senha de administração do novo PDB.
P: Posso criar um PDB stand-by usando o comando dbaascli PDB create?
R: Sim, se você estiver criando um PDB stand-by, poderá usar a opção --standbyBlobFromPrimary
para especificar a localização do arquivo blob stand-by no banco de dados principal.
P: O que acontece se eu não usar a opção --maxSize?
R: Se você não especificar a opção --maxSize
, o PDB não terá um limite de tamanho de armazenamento, a menos que seja definido de outra forma pelas políticas do CDB.
P: O que acontece se eu não fornecer a opção --pdbAdminUserName?
R: Se você não fornecer a opção --pdbAdminUserName
, o PDB será criado sem um usuário administrador especificado e você precisará configurar manualmente o usuário administrador após a criação.
P: Posso retomar a criação de um PDB com falha em qualquer ponto do processo?
R: Sim, desde que a sessão não tenha sido encerrada, você poderá retomar a criação de um PDB com falha usando as opções --resume
e --sessionID
.
Exemplo 7-33 dbaascli pdb create
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --maxsize 5G --maxcpu 2
dbaascli pdb create --dbName db721 --pdbName new_pdb1
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --standbyBlobFromPrimary /tmp/send_db721.tar
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
dbaascli pdb delete
Para excluir um banco de dados plugável (PDB), execute o comando dbaascli pdb delete
.
Pré-Requisito
Execute o comando como usuário oracle
.
Sintaxe
dbaascli pdb delete --dbName value
{ --pdbName value | --pdbUID value }
[--executePrereqs value]
[--waitForCompletion value]
[--resume [--sessionID value]]
[--allStandbyPrepared]
[--cleanupRelocatedPDB]
--dbName
especifica o nome do banco de dados contêiner que hospeda o PDB--pdbName
especifica o nome do PDB que você deseja excluir--pdbUID
especifica o UID do PDB que você deseja excluir--executePrereqs
especificayes
para só executar os pré-requisitos desta operação. Valores válidos:yes
ouno
--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
oufalse
--resume
especifica para retomar a execução anterior--sessionID
especifica para retomar um ID de sessão específico
--allStandbyPrepared
especifica para confirmar se a operação foi executada com sucesso em todos os bancos de dados stand-by--cleanupRelocatedPDB
- opção para limpar o banco de dados de origem após a realocação de um PDB.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli pdb delete?
R: O comando dbaascli pdb delete
é usado para excluir um banco de dados plugável (PDB) de um banco de dados contêiner (CDB) em um ambiente Exadata Cloud@Customer.
P: Quais são os pré-requisitos para executar o comando dbaascli pdb delete?
R: O comando deve ser executado como o usuário oracle
e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: O que a opção --dbName especifica no comando dbaascli pdb delete?
A: A opção --dbName
especifica o nome do banco de dados contêiner (CDB) que hospeda o PDB que você deseja excluir.
P: Como posso especificar qual PDB excluir usando o comando dbaascli PDB delete?
R: Você pode especificar o PDB a ser excluído usando a opção --pdbName
(especifica o nome do PDB) ou a opção --pdbUID
(especifica o UID do PDB).
P: Posso executar as verificações de pré-requisitos sem realmente excluir o PDB?
R: Sim, você pode usar a opção --executePrereqs
e defini-la como yes
para executar apenas as verificações de pré-requisitos da operação de exclusão do PDB.
P: Como posso executar o processo de exclusão do PDB em segundo plano?
A: Use a opção --waitForCompletion
e defina-a como false
para executar o processo de exclusão em segundo plano.
P: O que a opção --resume faz no comando dbaascli pdb delete?
A: A opção --resume
permite retomar um processo de exclusão do PDB com falha anterior.
P: Como retomo uma sessão específica para exclusão de um PDB?
R: Você pode especificar um ID de sessão usando a opção --sessionID
para retomar uma sessão específica para o processo de exclusão do PDB.
P: O que a opção --allStandbyPrepared faz?
A: A opção --allStandbyPrepared
é usada para confirmar se a operação de exclusão foi executada com sucesso em todos os bancos de dados stand-by antes de prosseguir com a exclusão do PDB principal.
P: Qual é a finalidade da opção --cleanupRelocatedPDB?
A: A opção --cleanupRelocatedPDB
limpa o banco de dados de origem depois que um PDB é realocado, garantindo que nenhum resíduo seja deixado após a realocação.
P: Posso excluir um PDB que já foi realocado?
R: Sim, você pode usar a opção --cleanupRelocatedPDB
para excluir um PDB que já foi realocado para um novo CDB.
P: Como garantir que a operação de exclusão seja executada com sucesso em bancos de dados stand-by?
R: Use a opção --allStandbyPrepared
para confirmar se a operação foi executada com sucesso em todos os bancos de dados stand-by antes de continuar.
P: O que acontece se o processo de exclusão falhar e precisar ser retomado?
R: Você pode retomar o processo de exclusão usando a opção --resume
e, se necessário, especificar o ID da sessão com --sessionID
.
P: O que a definição --waitForCompletion como falso faz?
R: A definição de --waitForCompletion
como false
permite que o processo de exclusão seja executado em segundo plano, permitindo que você continue trabalhando sem aguardar a conclusão da operação.
Para excluir um PDB de um banco de dados padrão em um ambiente que não seja do Data Guard ou do banco de dados Stand-by no ambiente do Data Guard.
dbaascli pdb delete --dbName db721 --pdbName pdb1
Para criar o PDB do banco de dados Principal no ambiente do Data Guard:
dbaascli pdb create --dbName db721 --pdbName pdb1 --allStandbyPrepared
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
dbaascli pdb getConnectString
Para exibir informações da string de conexão do Oracle Net para um banco de dados plugável (PDB), execute o comando dbaascli pdb getConnectString
.
Pré-Requisito
Execute o comando como usuário oracle
.
Sintaxe
dbaascli pdb getConnectString --dbname --pdbName | --pdbUID
--dbname
especifica o nome do banco de dados contêiner que hospeda o PDB--pdbname
especifica o nome do PDB cujas informações da string de conexão você deseja exibir--pdbUID
especifica o identificador do PDB
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli pdb getConnectString?
R: O comando dbaascli pdb getConnectString
é usado para exibir as informações da string de conexão do Oracle Net para um PDB (banco de dados plugável) em um ambiente Exadata Cloud@Customer.
P: Quais são os pré-requisitos para usar o comando dbaascli pdb getConnectString?
R: O comando deve ser executado como o usuário oracle
e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: Como recupero a string de conexão de um PDB especificando seu nome?
A: Para recuperar a string de conexão especificando o nome do PDB, use a seguinte sintaxe:
dbaascli pdb getConnectString --dbname <CDB_Name> --pdbName <PDB_Name>
P: Como recupero a string de conexão de um PDB especificando seu identificador exclusivo (UID)?
A: Para recuperar a string de conexão usando o identificador exclusivo (UID) do PDB, use a seguinte sintaxe:
dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>
P: O que a opção --dbname faz no comando dbaascli pdb getConnectString?
A: A opção --dbname
especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) para o qual você deseja exibir as informações da string de conexão.
P: O que a opção --pdbName faz no comando dbaascli pdb getConnectString?
A: A opção --pdbName
especifica o nome do banco de dados plugável (PDB) para o qual você deseja recuperar as informações da string de conexão do Oracle Net.
P: Qual é a finalidade da opção --pdbUID no comando dbaascli pdb getConnectString?
A: A opção --pdbUID
permite especificar o identificador exclusivo (UID) do banco de dados plugável (PDB) para o qual você deseja exibir a string de conexão.
P: Posso usar --pdbName e --pdbUID no mesmo comando?
R: Não, você pode usar --pdbName
ou --pdbUID
, mas não ambos no mesmo comando.
P: Que tipo de informação é retornado pelo comando dbaascli pdb getConnectString?
A: O comando retorna as informações da string de conexão do Oracle Net para o banco de dados plugável (PDB) especificado.
P: Posso recuperar a string de conexão de um PDB em uma instância de banco de dados contêiner específica?
R: Não, a string de conexão é para o PDB como um todo, não para uma instância específica do banco de dados contêiner.
P: Como posso obter as informações da string de conexão se souber apenas o identificador exclusivo (UID) do PDB?
A: Você pode recuperar a string de conexão usando o UID do PDB executando:
dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>
P: O que acontece se eu não fornecer --pdbName ou --pdbUID?
A: Você deve especificar --pdbName
ou --pdbUID
para recuperar a string de conexão. O comando não será executado sem uma dessas opções.
P: As informações da string de conexão do PDB são sempre as mesmas em todas as instâncias do CDB?
R: Sim, as informações da string de conexão são consistentes para o PDB em todas as instâncias do banco de dados contêiner (CDB).
Exemplo 7-34 dbaascli pdb getConnectString
dbaascli pdb getConnectString --dbname dbname --pdbName pdbName
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
dbaascli pdb getDetails
Para exibir detalhes de um banco de dados plugável (PDB), use o comando dbaascli pdb getDetails
.
Pré-Requisito
Execute o comando como usuário oracle
.
Sintaxe
dbaascli pdb getDetails --dbname --pdbName | --pdbUID
--dbname
especifica o nome do banco de dados contêiner que hospeda o PDB--pdbname
especifica o nome do PDB que você deseja excluir--pdbUID
especifica o identificador do PDB
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli pdb getDetails?
R: O comando dbaascli pdb getDetails
é usado para exibir detalhes de um banco de dados plugável (PDB) hospedado em um banco de dados contêiner (CDB) em um ambiente Exadata Cloud@Customer.
P: Quais são os pré-requisitos para executar o comando dbaascli pdb getDetails?
R: O comando deve ser executado como o usuário oracle
e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: O que a opção --dbname especifica no comando dbaascli pdb getDetails?
A: A opção --dbname
especifica o nome do banco de dados contêiner (CDB) que hospeda o PDB cujos detalhes você deseja exibir.
P: Como você especifica o PDB cujos detalhes deseja exibir?
R: Você pode especificar o PDB usando a opção --pdbName
(para fornecer o nome do PDB) ou a opção --pdbUID
(para fornecer o UID do PDB).
P: Qual é a diferença entre --pdbName e --pdbUID?
A: A opção --pdbName
usa o nome do PDB para extrair detalhes, enquanto a opção --pdbUID
usa o identificador exclusivo (UID) do PDB para extrair seus detalhes.
P: Posso usar --pdbName e --pdbUID juntos no comando dbaascli pdb getDetails?
R: Não, você pode especificar a opção --pdbName
ou --pdbUID
para obter detalhes do PDB, mas não os dois ao mesmo tempo.
P: Quais são alguns casos de uso do comando dbaascli pdb getDetails?
dbaascli pdb getDetails
para:
- Recuperar detalhes sobre um PDB específico em um CDB.
- Verifique a configuração de um PDB.
- Verifique o status de um PDB dentro de um CDB.
P: Como posso exibir detalhes de um PDB com base em seu nome?
A: Para exibir detalhes de um PDB com base em seu nome, use a seguinte sintaxe:
dbaascli pdb getDetails --dbname <CDB_Name> --pdbName <PDB_Name>
P: Como posso exibir detalhes de um PDB com base em seu UID?
A: Para exibir detalhes de um PDB com base em seu UID, use a seguinte sintaxe:
dbaascli pdb getDetails --dbname <CDB_Name> --pdbUID <PDB_UID>
P: Esse comando pode ser usado para vários PDBs em uma execução?
R: Não, o comando pode ser usado para extrair detalhes de um PDB de cada vez especificando seu nome ou UID.
Exemplo 7-35 dbaascli pdb getDetails
dbaascli pdb getDetails--dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb getDetails--dbname cdb name --pdbUID con_uid of that pdb
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
dbaascli pdb list
Para exibir a lista de bancos de dados plugáveis (PDB) em um banco de dados contêiner, use o comando dbaascli pdb list
.
Pré-Requisito
Execute o comando como usuário oracle
.
Sintaxe
dbaascli pdb list --dbname
--dbname
especifica o nome do banco de dados contêiner que hospeda o PDB
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli pdb list?
R: O comando dbaascli pdb list
é usado para exibir a lista de bancos de dados plugáveis (PDBs) em um banco de dados contêiner (CDB) especificado em um ambiente Exadata Cloud@Customer.
P: Quais são os pré-requisitos para executar o comando dbaascli pdb list?
R: O comando deve ser executado como o usuário oracle
e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: O que a opção --dbname especifica no comando dbaascli pdb list?
A: A opção --dbname
especifica o nome do banco de dados contêiner (CDB) que hospeda os bancos de dados plugáveis (PDBs) para os quais você deseja exibir a lista.
P: Posso exibir a lista de PDBs de vários bancos de dados contêineres de uma só vez?
R: Não, o comando dbaascli pdb list
permite listar os PDBs de apenas um banco de dados contêiner (CDB) por vez, especificado pela opção --dbname
.
P: Como listo os PDBs em um banco de dados contêiner (CDB) específico?
R: Você pode listar os PDBs em um CDB específico usando a seguinte sintaxe:
dbaascli pdb list --dbname <CDB_Name>
P: Quais informações são exibidas ao usar o comando dbaascli pdb list?
R: O comando retorna uma lista de todos os bancos de dados plugáveis (PDBs) dentro do banco de dados contêiner (CDB) especificado. A lista geralmente inclui os nomes dos PDBs e possivelmente outros detalhes, como seu status.
P: Posso filtrar a lista de PDBs usando opções adicionais?
R: Não, o comando dbaascli pdb list
não suporta opções de filtragem adicionais. Ele simplesmente retorna a lista completa de PDBs no CDB especificado.
P: O que acontece se o --dbname especificado não existir ou estiver incorreto?
R: Se o --dbname
especificado estiver incorreto ou não existir, o comando retornará um erro e nenhuma lista de PDB será exibida.
P: O comando dbaascli pdb list pode ser usado para qualquer ambiente de banco de dados Oracle?
R: Não, o comando dbaascli pdb list
foi projetado especificamente para uso nos ambientes Exadata Cloud@Customer.
Exemplo 7-36 dbaascli pdb list
dbaascli pdb list --dbname cdb name
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
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>]
--pdbName
especifica o nome do novo PDB que você deseja clonar--dbName
especifica o nome do banco de dados--targetPDBName
especifica o nome do PDB de destino (novo PDB clonado)--powerLimit
especifica o grau de paralelismo a ser usado para a operação de clonagem. O valor válido fica entre 1 e 128--maxCPU
especifica o número máximo de CPUs a serem alocadas para o PDB--maxSize
especifica o tamanho máximo do armazenamento em GB para o novo PDB--resume
retoma a execução anterior-
--sessionID
especifica para retomar um ID de sessão específico
-
--executePrereqs
especificayes
para só executar os pré-requisitos desta operação. Valores válidos:yes
ouno
--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
oufalse
--blobLocation
local de diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG.--standbyBlobFromPrimary
especifica o local do arquivo blob stand-by, que é preparado usando o banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by.Observação
Os parâmetros--blobLocation
e--standbyBlobFromPrimary
são mutuamente exclusivos.--excludeUserTablespaces
- opção para ignorar tablespaces de usuário, por exemplo, t1,t2,t3.--excludePDBData
especifica true/yes para ignorar dados do usuário do pdb de origem.--pdbAdminUserName
especifica o novo nome do usuário administrador do PDB.--lockPDBAdminAccount
especifica true ou false para bloquear a conta de usuário administrador do PDB. O valor default é verdadeiro.--sourcePDBServiceConvertList
especifica uma lista separada por vírgulas de nomes de serviços de origem para destino que precisam ser convertidos. A sintaxe é source_srv1:new_srv1,source_srv2:new_srv2.
O PDB recém-clonado herda senhas de administração do PDB de origem.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli pdb localClone?
R: O comando dbaascli pdb localClone
é usado para criar um novo banco de dados plugável (PDB) como clone de um PDB existente no mesmo banco de dados contêiner (CDB) em um ambiente Exadata Cloud@Customer.
P: Quais são os pré-requisitos para executar o comando dbaascli pdb localClone?
R: O comando deve ser executado como o usuário oracle
e você deve estar conectado a uma máquina virtual do Exadata Cloud@Customer. Além disso, o PDB de origem já deve existir no CDB especificado.
P: O que a opção --dbName especifica no comando dbaascli pdb localClone?
A: A opção --dbName
especifica o nome do banco de dados contêiner (CDB) que hospeda o PDB de origem do qual o novo PDB será clonado.
P: O que a opção --pdbName especifica no comando dbaascli pdb localClone?
A: A opção --pdbName
especifica o nome do novo PDB que você deseja criar como clone do PDB existente no mesmo CDB.
P: Posso clonar um PDB com outro nome usando o comando dbaascli PDB localClone?
R: Sim, você pode especificar outro nome para o PDB clonado usando a opção --targetPDBName
. Se essa opção não for fornecida, o PDB clonado herdará o nome do PDB de origem.
P: O que a opção --resume faz no comando dbaascli pdb localClone?
A: A opção --resume
permite retomar uma operação de clonagem do PDB interrompida anteriormente.
P: Como limitar os recursos de CPU disponíveis para o PDB clonado?
R: Você pode limitar os recursos de CPU do PDB clonado usando a opção --maxCPU
, que especifica o número máximo de CPUs que serão alocadas para o novo PDB.
P: Posso executar a operação de clonagem do PDB em segundo plano?
R: Sim, você pode executar a operação em segundo plano definindo a opção --waitForCompletion
como false
. Se você defini-la como true
, a operação será executada em primeiro plano e aguardará a conclusão.
P: Qual é a finalidade da opção --maxSize no comando dbaascli pdb localClone?
A: A opção --maxSize
especifica o tamanho máximo de armazenamento (em GB) para o PDB recém-clonado. Se nenhum tamanho for especificado, o PDB clonado herdará os mesmos limites de armazenamento que o PDB de origem.
P: Posso controlar o paralelismo da operação de clonagem do PDB?
R: Sim, você pode controlar o grau de paralelismo da operação de clonagem usando a opção --powerLimit
. Esta opção aceita valores entre 1 e 128 para definir o grau de paralelismo.
P: Para que é usada a opção --primaryDBWalletTar?
A: A opção --primaryDBWalletTar
especifica o local do arquivo tar da wallet do banco de dados principal. Essa opção só será necessária se a operação de clonagem envolver operações de PDB do banco de dados stand-by.
P: Posso executar somente as verificações de pré-requisitos para a operação de clonagem?
R: Sim, você só pode executar as verificações de pré-requisitos usando a opção --executePrereqs
e definindo-a como yes
. Os valores válidos são yes
e no
.
P: O que acontece se a operação de clonagem do PDB falhar ou for interrompida?
R: Se a operação de clonagem falhar ou for interrompida, você poderá retomá-la usando a opção --resume
para continuar de onde a operação foi interrompida.
Exemplo 7-37 dbaascli pdb localClone
dbaascli pdb localClone --dbName db35 --pdbName PDB35 --targetPDBName local_clone1 --maxCPU 2 --maxSize 15
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
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>]]
--pdbName
especifica o nome do PDB que você deseja abrir--pdbUID
especifica o identificador do PDB--dbname
especifica o nome do banco de dados contêiner que hospeda o PDB.--openMode
especifica o destino OPEN MODE do PDB--startServices
: especifica que vai iniciar todos ou listar todos os serviços correspondentes a um PDB. Os valores aceitos sãoall
ou uma lista de serviços do PDB delimitada por vírgulas.--waitForCompletion
: especificafalse
para executar a operação em segundo plano. Valores válidos:true
|false
--setPDBRefreshModeNone
: especifica a conversão de um PDB atualizável em um PDB não atualizável--skipPDBRefresh
: especifica que vai ignorar a atualização do PDB atualizável--pdbAdminUserName
: - especifica o novo nome do usuário administrador do PDB
Após a conclusão bem-sucedida, o PDB é aberto em todas as instâncias do banco de dados contêiner.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli pdb open?
R: O comando dbaascli pdb open
é usado para abrir um banco de dados plugável (PDB) em um banco de dados contêiner (CDB) da Oracle em um ambiente Exadata Cloud@Customer.
P: Quem pode executar o comando dbaascli pdb open?
R: O comando pode ser executado como o usuário root
ou oracle
.
P: O que a opção --pdbName especifica no comando dbaascli pdb open?
A: A opção --pdbName
especifica o nome do PDB que você deseja abrir.
P: O que a opção --pdbUID especifica no comando dbaascli pdb open?
A: A opção --pdbUID
especifica o identificador exclusivo (UID) do PDB que você deseja abrir.
P: O que a opção --dbname especifica no comando dbaascli pdb open?
A: A opção --dbname
especifica o nome do CDB (banco de dados contêiner) que hospeda o PDB.
P: Qual é a finalidade da opção --openMode?
A: A opção --openMode
especifica o modo no qual o PDB será aberto. Os valores válidos são READ_WRITE
e READ_ONLY
.
P: Posso iniciar serviços ao abrir o PDB?
R: Sim, você pode usar a opção --startServices
para iniciar todos os serviços associados ao PDB especificando todos ou fornecer uma lista delimitada por vírgulas de serviços específicos para iniciar.
P: O que acontece se eu definir a opção --waitForCompletion como falsa?
R: Se --waitForCompletion
estiver definido como false
, o comando será executado em segundo plano e o usuário não precisará aguardar a conclusão da operação. Se definido como true
, o comando aguardará a conclusão antes de sair.
P: O que a opção --setPDBRefreshModeNone faz?
A: A opção --setPDBRefreshModeNone
converte um PDB atualizável (um que é atualizado regularmente de um banco de dados principal) em um PDB não atualizável.
P: Qual é a função da opção --skipPDBRefresh?
R: A opção --skipPDBRefresh
permite ignorar a operação de atualização ao abrir um PDB atualizável, impedindo que o PDB seja sincronizado com o banco de dados principal nesse momento.
P: O que a opção --pdbAdminUserName faz no comando dbaascli pdb open?
A: A opção --pdbAdminUserName
permite especificar um novo nome de usuário administrador do PDB ao abrir o PDB.
P: O que acontece se o comando dbaascli pdb open for bem-sucedido?
R: Após a conclusão bem-sucedida, o PDB especificado será aberto em todas as instâncias do banco de dados contêiner (CDB).
P: É possível executar o comando dbaascli PDB open para um PDB atualizável?
R: Sim, o comando pode ser usado para PDBs atualizáveis. A opção --setPDBRefreshModeNone
converte o PDB em não atualizável e a opção --skipPDBRefresh
ignora a operação de atualização durante o processo de abertura.
P: Qual será o modo de abertura padrão de um PDB se não --openMode for especificado?
R: Se nenhum --openMode
for especificado, o PDB geralmente será aberto no modo READ_WRITE
por padrão.
Exemplo 7-38 dbaascli pdb open
dbaascli pdb open --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb open --dbname cdb name --pdbUID con_uid of that pdb
Opcional: --openMode
READ_WRITE
/READ_ONLY
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
dbaascli pdb recover
Para recuperar um banco de dados plugável (PDB), use o comando dbaascli pdb recover
.
Pré-Requisito
- Execute o comando como usuário
root
. - O banco de dados deve ser configurado com detalhes do destino de armazenamento de backup em que os backups são armazenados.
Sintaxe
dbaascli pdb recover --pdbName <value> --dbname <value>
{
--start
{
--untilTime <value>
| --untilSCN <value>
| --latest
| --tag <value>
}
| --status --uuid <value>
}
--pdbName
: PDB name.--dbname
: Oracle Database name.--start
|--status
--start
--untilTime
|--untilSCN
|--latest
|--tag
--untilTime
: Recovers PDB until time. Input format:DD-MON-YYYY HH24:MI:SS
.--untilSCN
: Recovers PDB until SCN.--latest
: Recovers PDB to last known state.--tag
: Recovers PDB to archival tag.--status
--uuid <value>
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli pdb recovery?
R: O comando dbaascli pdb recover
é usado para recuperar um banco de dados plugável (PDB) para um estado anterior usando backups armazenados em um destino de armazenamento de backup configurado.
P: Quem pode executar o comando dbaascli pdb recovery?
A: O comando deve ser executado como usuário root
.
P: O que é necessário antes de executar o comando de recuperação dbaascli pdb?
R: Antes de executar o comando, o banco de dados deve ser configurado com detalhes do destino de armazenamento de backup em que os backups são armazenados.
P: O que a opção --pdbName especifica no comando de recuperação dbaascli pdb?
A: A opção --pdbName
especifica o nome do banco de dados plugável (PDB) que você deseja recuperar.
P: O que a opção --dbname especifica no comando de recuperação dbaascli pdb?
A: A opção --dbname
especifica o nome do CDB (banco de dados contêiner) que hospeda o PDB.
P: Quais são as opções possíveis para iniciar uma recuperação de PDB usando a opção --start?
--untilTime <value>
: Recupera o PDB até um horário especificado (formato:DD-MON-YYYY HH24:MI
).--untilSCN <value>
: Recupera o PDB até um SCN (Número de Alteração do Sistema) especificado.--latest
: Recupera o PDB para o estado conhecido mais recente.--tag <value>
: Recupera o PDB para uma tag de arquivamento específica.
P: Qual é o formato necessário para especificar a hora na opção --untilTime?
A: A hora deve estar no formato DD-MON-YYYY HH24:MI:SS
.
P: Como posso recuperar um PDB para o estado mais recente usando dbaascli PDB recovery?
A: Para recuperar o PDB para o estado mais recente conhecido, use a opção --latest
:
dbaascli pdb recover --pdbName <value> --dbname <value> --start --latest
P: Como recupero um PDB para uma tag de arquivamento específica?
A: Você pode recuperar o PDB para uma tag específica usando a opção --tag
:
dbaascli pdb recover --pdbName <value> --dbname <value> --start --tag <tag_value>
P: Posso recuperar um PDB usando um SCN específico?
R: Sim, você pode recuperar o PDB para um SCN específico usando a opção --untilSCN
:
dbaascli pdb recover --pdbName <value> --dbname <value> --start --untilSCN <SCN_value>
P: O que a opção --status faz no comando dbaascli pdb recovery?
A: A opção --status
é usada para verificar o status de uma operação de recuperação. Você deve fornecer o --uuid
para especificar a sessão de recuperação.
P: Como posso verificar o status de uma recuperação de PDB?
A: Para verificar o status de uma operação de recuperação, use a opção --status
com o --uuid
da sessão de recuperação:
dbaascli pdb recover --pdbName <value> --dbname <value> --status --uuid <uuid_value>
P: O que acontece se eu especificar a opção --latest no comando recovery?
R: Se você especificar a opção --latest
, o PDB será recuperado para o estado mais recente disponível no backup.
Exemplo 7-39 Exemplos
- Para recuperar um PDB pdb1 em um CDB myTestDb para o mais recente:
dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --start --latest
- Para consultar o status da solicitação de recuperação do PDB submetida com
uuid
81a17352362011ecbc3000163e8e4fac:dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --status --uuid 81a17352362011ecbc3000163e8e4fac
Tópicos Relacionados
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
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
: especificafalse
para executar a operação em segundo plano. Valores válidos:true
|false
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli pdb refresh?
R: O comando dbaascli pdb refresh
é usado para atualizar um PDB (banco de dados plugável) especificado em um CDB (banco de dados contêiner).
P: Quem pode executar o comando dbaascli pdb refresh?
A: O comando pode ser executado pelo usuário root
ou oracle
.
P: O que a opção --dbname especifica no comando dbaascli pdb refresh?
A: A opção --dbname
especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) a ser atualizado.
P: O que a opção --pdbName especifica no comando dbaascli pdb refresh?
A: A opção --pdbName
especifica o nome do banco de dados plugável (PDB) que você deseja atualizar.
P: O que a opção --pdbUID especifica no comando dbaascli pdb refresh?
A: A opção --pdbUID
especifica o identificador exclusivo (UID) do banco de dados plugável (PDB) que você deseja atualizar.
P: O que a opção --waitForCompletion faz no comando dbaascli pdb refresh?
A: A opção --waitForCompletion
especifica se a operação deve ser executada em primeiro plano ou em segundo plano. Se definido como verdadeiro, a operação será executada em primeiro plano e aguardará a conclusão. Se definido como false, a operação será executada em segundo plano.
P: Como posso atualizar um PDB e executar a operação em segundo plano?
A: Para atualizar um PDB e executar a operação em segundo plano, use a opção --waitForCompletion false
:
dbaascli pdb refresh --dbname <value> --pdbName <value> --waitForCompletion false
P: Como atualizo um PDB usando seu identificador exclusivo (UID)?
A: Você pode atualizar o PDB usando a opção --pdbUID
:
dbaascli pdb refresh --dbname <value> --pdbUID <value>
P: Posso especificar --pdbName e --pdbUID juntos no comando dbaascli pdb refresh?
R: Não, você deve especificar --pdbName
ou --pdbUID
, mas não ambos, ao atualizar um PDB.
P: O que acontece se eu não incluir a opção --waitForCompletion no comando?
R: Se você não especificar a opção --waitForCompletion
, o comportamento padrão será aguardar a conclusão da operação antes de retornar o controle ao usuário.
P: Posso atualizar um PDB enquanto o banco de dados está em execução?
R: Sim, você pode atualizar um PDB enquanto o banco de dados está em execução, desde que o comando seja executado por um usuário com privilégios apropriados.
Tópicos Relacionados
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
dbaascli pdb remoteClone
Para criar um novo banco de dados plugável (PDB) como clone de um PDB existente, em outro banco de dados contêiner (CDB), use o comando dbaascli pdb remoteClone
.
Execute o comando como usuário root
ou oracle
.
Sintaxe
dbaascli pdb remoteClone --pdbName <value> --dbName <value> --sourceDBConnectionString <value> [--targetPDBName <value>] [--powerLimit <value>] [--maxCPU <value>] [--maxSize <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--waitForCompletion <value>] [--sourcePDBExportedTDEKeyFile <value>]
{
[--blobLocation <value>]
| [--standbyBlobFromPrimary <value>]
}
[--excludeUserTablespaces <value>]
[--excludePDBData <value>]
[--pdbAdminUserName <value>]
[--lockPDBAdminAccount <value>]
[--sourcePDBServiceConvertList <value>]
[--refreshablePDB --refreshMode <value> [--refreshIntervalInMinutes <value>] --dblinkUsername <value> [--honorCaseSensitiveUserName]]
[--updateDBBlockCacheSize]
--pdbName
especifica o nome do PDB de origem que você deseja clonar--dbname
especifica o nome (DB_NAME
) do CDB que hospeda o PDB recém-clonado--sourceDBConnectionString
especifica a string de conexão do banco de dados de origem no formatoscan_name:scan_port/database_service_name
--targetPDBName
especifica o nome do PDB de destino (novo PDB clonado)--powerLimit
especifica o grau de paralelismo a ser usado para a operação de clonagem. O valor válido fica entre 1 e 128--maxCPU
especifica o número máximo de CPUs a serem alocadas para o PDB--maxSize
especifica o tamanho máximo do armazenamento em GB para o novo PDB--resume
retoma a execução anterior-
--sessionID
especifica para retomar um ID de sessão específico
-
--executePrereqs
especificayes
para só executar os pré-requisitos desta operação. Valores válidos:yes
ouno
--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
oufalse
--sourcePDBExportedTDEKeyFile
especifica o arquivo de chave exportado do PDB de origem. Essa variável só se aplica ao banco de dados 12.1.--blobLocation
especifica o caminho personalizado em que o arquivo blob stand-by será gerado em um ambiente do Data Guard--standbyBlobFromPrimary
especifique o local do arquivo blob stand-by, que é preparado no banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-byObservação
Os parâmetros--blobLocation
e--standbyBlobFromPrimary
são mutuamente exclusivos.--excludeUserTablespaces
- opção para ignorar tablespaces de usuário, por exemplo, t1,t2,t3.-
--excludePDBData
- especifiquetrue
/yes
para ignorar dados do usuário do PDB de origem. --pdbAdminUserName
- especifica o novo nome do usuário administrador do PDB--lockPDBAdminAccount
especifiquetrue
oufalse
para bloquear a conta do usuário administrador do PDB. O valor default éverdadeiro
.--sourcePDBServiceConvertList
- especifique uma lista separada por vírgulas de nomes de serviços de origem para destino que precisam ser convertidos. A sintaxe ésource_srv1:new_srv1
,source_srv2:new_srv2
.--refreshablePDB
especifica a criação de um PDB atualizável--refreshMode
especifica o modo de atualização para um PDB atualizável. Valores válidos:AUTO
|MANUAL
--refreshIntervalInMinutes
especifica o intervalo de atualização pararefreshablePDB
em minutos
--dblinkUsername
especifica o usuário comum de um banco de dados remoto usado para link de banco de dados para conexão com o banco de dados remoto--honorCaseSensitiveUserName
indica que o nome de usuário especificado faz distinção entre maiúsculas e minúsculas
--updateDBBlockCacheSize
: especifica a ativação do aplicativo para definir os parâmetros de inicializaçãodb block cache size
para suportar a cópia de dados com um tamanho de bloco distinto
Quando solicitado, forneça a senha do usuário SYS para o PDB de origem. O PDB recém-clonado herda senhas de administração do PDB de origem. O PDB clonado é nomeado usando o seguinte formato: dbname_sourcepdbname
. Esse comando só é suportado para bancos de dados que não estão em uma configuração do Data Guard e usam o Oracle Database versão 12.2.0.1 ou mais recente.
Perguntas Frequentes
P: Para que é usado o comando dbaascli pdb remoteClone?
R: O comando dbaascli pdb remoteClone
é usado para criar um novo Banco de Dados Plugável (PDB) como clone de um PDB existente, em outro banco de dados contêiner (CDB).
P: Qual usuário deve executar o comando dbaascli pdb remoteClone?
A: O comando deve ser executado como o usuário root
ou oracle
.
P: O que é necessário quando solicitado durante a operação dbaascli pdb remoteClone?
R: Forneça a senha do usuário SYS para o PDB de origem.
P: O que o parâmetro --pdbName especifica?
A: O parâmetro --pdbName
especifica o nome do PDB de origem que você deseja clonar.
P: O que o parâmetro --dbName representa?
R: O parâmetro --dbName
representa o nome (DB_NAME
) do CDB que hospedará o PDB recém-clonado.
P: Como o --sourceDBConnectionString deve ser formatado?
A: O --sourceDBConnectionString
deve ser formatado como <scan_name>
:<scan_port>
/<database_service_name>
.
P: Qual é a finalidade do parâmetro --targetPDBName?
A: O parâmetro --targetPDBName
especifica o nome do PDB recém-clonado.
P: O que o --powerLimit controla?
A: O parâmetro --powerLimit
controla o grau de paralelismo usado para a operação de clonagem. O valor válido fica entre 1 e 128.
P: O que o parâmetro --maxCPU define?
A: O parâmetro --maxCPU
define o número máximo de CPUs a serem alocadas para o processo de clonagem do PDB.
P: Qual é a função de --maxSize?
A: O parâmetro --maxSize
especifica o tamanho máximo do armazenamento em GB para o novo PDB.
P: O que o parâmetro --resume faz?
A: O parâmetro --resume
retoma a operação de clonagem anterior.
P: O que você deve fornecer com a opção --resume?
R: Você pode especificar um --sessionID
para retomar uma sessão específica se estiver retomando uma operação anterior.
P: O que o --executePrereqs controla?
R: O parâmetro --executePrereqs
determina se apenas os pré-requisitos para a operação de clonagem devem ser executados. Os valores válidos são yes
ou no
.
P: Como --waitForCompletion afeta a operação?
R: O parâmetro --waitForCompletion
especifica se a operação deve ser concluída ou executada em segundo plano. Os valores válidos são true
ou false
.
P: O que é especificado pelo parâmetro --sourcePDBExportedTDEKeyFile?
A: O parâmetro --sourcePDBExportedTDEKeyFile
especifica o arquivo de chave exportado do PDB de origem. Este parâmetro só é aplicável ao Oracle Database versão 12.1.
P: O que o parâmetro --blobLocation define?
A: O parâmetro --blobLocation
especifica o caminho personalizado no qual o arquivo BLOB standby será gerado em um ambiente do Data Guard.
P: Quando --standbyBlobFromPrimary é usado?
A: O parâmetro --standbyBlobFromPrimary
especifica o local do arquivo BLOB stand-by preparado no banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by.
P: --blobLocation e --standbyBlobFromPrimary podem ser usados juntos?
A: Não, --blobLocation
e --standbyBlobFromPrimary
são mutuamente exclusivos e não podem ser usados juntos.
P: O que a opção --excludeUserTablespaces faz?
A: A opção --excludeUserTablespaces
permite ignorar a clonagem de tablespaces de usuário específicos. Por exemplo, t1,t2,t3.
P: Qual é o efeito de --excludePDBData?
A: A opção --excludePDBData
especifica se os dados do usuário devem ser ignorados do PDB de origem durante a clonagem. Os valores válidos são true
ou yes
.
P: O que é especificado por --pdbAdminUserName?
A: O parâmetro --pdbAdminUserName
especifica o novo nome do usuário administrador do PDB clonado.
P: O que a opção --lockPDBAdminAccount controla?
A: A opção --lockPDBAdminAccount
especifica se a conta de usuário administrador do PDB será bloqueada. O valor padrão é true
.
P: O que --sourcePDBServiceConvertList especifica?
A: O parâmetro --sourcePDBServiceConvertList
especifica uma lista delimitada por vírgulas de conversões de nome de serviço de origem para destino. Por exemplo, source_srv1
:new_srv1
,source_srv2
:new_srv2
.
P: Qual é a finalidade de --refreshablePDB?
A: O parâmetro --refreshablePDB
especifica se um PDB atualizável deverá ser criado.
P: O que o --refreshMode controla?
A: O parâmetro --refreshMode
controla o modo de atualização de um PDB atualizável. Os valores válidos são AUTO
ou MANUAL
.
P: Como --refreshIntervalInMinutes funciona?
A: O parâmetro --refreshIntervalInMinutes
especifica o intervalo em minutos para atualizar o PDB atualizável.
P: Para que é usado --dblinkUsername?
A: O parâmetro --dblinkUsername
especifica um usuário comum de um banco de dados remoto usado para o link de banco de dados para estabelecer conexão com o banco de dados remoto.
P: O que a opção --honorCaseSensitiveUserName indica?
A: A opção --honorCaseSensitiveUserName
indica que o nome de usuário especificado faz distinção entre maiúsculas e minúsculas.
P: Qual é o efeito de --updateDBBlockCacheSize?
A: A opção --updateDBBlockCacheSize
permite que o aplicativo defina os parâmetros de inicialização do tamanho do cache de bloco do BD para suportar cópia de dados com um tamanho de bloco diferente.
P: O que devo fazer se encontrar um erro com o comando dbaascli pdb remoteClone?
R: Revise a mensagem de erro para obter detalhes, verifique se todos os parâmetros estão especificados corretamente e verifique se você tem as permissões e credenciais necessárias. Além disso, verifique se os bancos de dados de origem e de destino atendem a todos os requisitos.
P: E se eu esquecer a senha do usuário SYS do PDB de origem?
R: Você precisará redefinir ou recuperar a senha do usuário SYS do PDB de origem. Sem ela, a operação de clonagem não pode ser concluída.
Exemplo 7-40 dbaascli pdb remoteClone
dbaascli pdb remoteClone --sourceDBConnectionString test-can.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521 --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2
dbaascli pdb remoteClone --sourceDBConnectionString orcla.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
dbaascli pdb relocate
Para realocar o PDB especificado do banco de dados remoto para o banco de dados local, use o comando dbaascli pdb relocate
.
Pré-Requisito
Execute o comando como usuário oracle
. Quando solicitado, informe a senha do usuário SYS para o banco de dados de origem.
Sintaxe
dbaascli pdb relocate --pdbName <value> --dbName <value> --sourceDBConnectionString <value>
[--targetPDBName <value>]
[--powerLimit <value>]
[--maxCpu <value>]
[--maxSize <value>]
[--resume [--sessionID <value>]]
[--executePrereqs <value>]
[--sourcePDBServices <value>]
[--sourcePDBReadOnlyServices <value>]
[--waitForCompletion <value>]
{
[--blobLocation <value>] | [--standbyBlobFromPrimary <value>]
}
[--upgradePDB <value>]
[--updateDBBlockCacheSize]
{
[skipOpenPDB] | [--completePDBRelocate]
}
--pdbName
especifica o nome do PDB de origem a ser realocado--dbName
especifica o nome do banco de dados de destino--sourceDBConnectionString
especifica a string de conexão do banco de dados de origem no formato<scan_name>:<scan_port>/<database_service_name>
--targetPDBName
especifica um nome para o PDB de destino (novo PDB realocado)--powerLimit
especifica o grau de paralelismo a ser usado para a operação de realocação--maxCpu
especifica o número máximo de CPUs a serem alocadas para o PDB--maxSize
especifica o tamanho máximo do armazenamento em GB para o novo PDB--resume
especifica para retomar a execução anterior--sessionID
especifica para retomar um ID de sessão específico
--executePrereqs
especificayes
para só executar os pré-requisitos desta operação. Valores válidos:yes
|no
--sourcePDBServices
especifica uma lista de serviços do PDB de origem delimitados por vírgulas--sourcePDBReadOnlyServices
especifica uma lista delimitada por vírgulas de serviços somente leitura do PDB de origem--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
|false
--blobLocation
especifica o local de um diretório personalizado no qual o arquivo BLOB stand-by será gerado em um ambiente do Data Guard--standbyBlobFromPrimary
especifica o local do arquivo BLOB stand-by, que é preparado usando o banco de dados principal. Isso só é necessário para operações stand-by.Observação
Os parâmetros--blobLocation
são mutuamente exclusivos.--upgradePDB
especificatrue
para fazer upgrade do PDB como parte dessa operação. Valores válidos :true
|false
.--updateDBBlockCachesize
opção para permitir que o aplicativo defina parâmetros de inicializaçãodb block cache size
para suportar a cópia de dados com tamanho de bloco diferente.--skipOpenPDB
- indica que o PDB não deve ser aberto no fim da operação atual.--completePDBRelocate
- conclui a realocação do PDB, se for executada como operação em duas etapas.
Perguntas Frequentes
P: Para que é usado o comando dbaascli pdb relocate?
R: O comando dbaascli pdb relocate
é usado para realocar um Banco de Dados Plugável (PDB) de um banco de dados remoto para um banco de dados local.
P: Qual usuário deve executar o comando dbaascli pdb relocate?
A: O comando deve ser executado como usuário Oracle
.
P: O que é necessário quando solicitado durante a operação de realocação do pdb dbaascli?
A: Informe a senha do usuário SYS para o banco de dados de origem.
P: O que o parâmetro --pdbName especifica?
A: O parâmetro --pdbName
especifica o nome do PDB de origem a ser realocado.
P: Qual é a finalidade do parâmetro --dbName?
A: O parâmetro --dbName
especifica o nome do banco de dados de destino no qual o PDB será realocado.
P: Como o --sourceDBConnectionString deve ser formatado?
A: O --sourceDBConnectionString
deve ser formatado como <scan_name>
:<scan_port>
/<database_service_name>
.
P: O que o parâmetro --targetPDBName faz?
A: O parâmetro --targetPDBName
especifica um novo nome para o PDB realocado.
P: Qual é o uso de --powerLimit?
R: O parâmetro --powerLimit
especifica o grau de paralelismo a ser usado durante a operação de realocação.
P: Como --maxCpu afeta o processo de realocação?
A: O parâmetro --maxCpu
especifica o número máximo de CPUs a serem alocadas para o processo de realocação do PDB.
P: O que o parâmetro --maxSize define?
A: O parâmetro --maxSize
define o tamanho máximo de armazenamento em GB para o novo PDB.
Q: Qual é a função de --resume?
R: O parâmetro --resume
indica que a operação de realocação deve ser retomada de onde parou.
P: O que devo fornecer com a opção --resume?
R: Você pode especificar um --sessionID
para retomar uma sessão específica se estiver retomando uma operação anterior.
P: O que o parâmetro --executePrereqs faz?
R: O parâmetro --executePrereqs
determina se apenas os pré-requisitos da operação devem ser executados. Os valores válidos são sim ou não.
P: O que é especificado pelo parâmetro --sourcePDBServices?
A: O parâmetro --sourcePDBServices
especifica uma lista de serviços do PDB de origem delimitados por vírgulas.
P: O que faz a lista de parâmetros --sourcePDBReadOnlyServices?
A: O parâmetro --sourcePDBReadOnlyServices
lista uma lista delimitada por vírgulas de serviços somente leitura do PDB de origem.
P: Qual é o efeito de --waitForCompletion?
A: O parâmetro --waitForCompletion
especifica se a operação deve ser executada em segundo plano. Os valores válidos são true
ou false
.
P: O que o parâmetro --blobLocation especifica?
A: O parâmetro --blobLocation
especifica o local de um diretório personalizado no qual o arquivo BLOB stand-by será gerado em um ambiente do Data Guard.
Q: Quando devo usar --standbyBlobFromPrimary?
R: Use --standbyBlobFromPrimary
para especificar o local do arquivo BLOB stand-by, que é preparado no banco de dados principal. Isso só é necessário para operações stand-by.
P: Posso usar --blobLocation e --standbyBlobFromPrimary juntos?
R: Não, os parâmetros --blobLocation
e --standbyBlobFromPrimary
são mutuamente exclusivos e não podem ser usados juntos.
P: O que --upgradePDB faz?
A: O parâmetro --upgradePDB
especifica se o PDB deve ser submetido a upgrade como parte da operação de realocação. Os valores válidos são true
ou false
.
P: Qual é a finalidade de --updateDBBlockCacheSize?
A: A opção --updateDBBlockCacheSize
permite que o aplicativo defina os parâmetros de inicialização do tamanho do cache de bloco do BD para suportar cópia de dados com um tamanho de bloco diferente.
P: O que a opção --skipOpenPDB faz?
A: A opção --skipOpenPDB
indica que o PDB não deve ser aberto no final da operação de realocação.
Q: Quando devo usar --completePDBRelocate?
R: Use --completePDBRelocate
para concluir a realocação do PDB, se for feita como operação em duas etapas.
P: O que devo fazer se encontrar um erro ao usar o comando dbaascli pdb relocate?
R: Verifique a mensagem de erro para obter detalhes, certifique-se de que todos os parâmetros estejam especificados corretamente e verifique se você tem as permissões e credenciais necessárias. Talvez você também precise revisar os pré-requisitos e as configurações.
P: E se eu esquecer a senha do usuário SYS do banco de dados de origem?
R: Você precisará redefinir ou recuperar a senha do usuário SYS do banco de dados de origem. Sem ele, não é possível concluir a operação de realocação.
Exemplo 7-41 dbaascli pdb relocate
dbaascli pdb relocate --sourceDBConnectionString test-scan.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521/source_cdb_service_name --pdbName source_pdb --dbName target_db
Tópico principal: Gerenciamento de Banco de Dados Plugável (PDB)
Gerenciamento do Sistema
Esta seção enfoca a supervisão e o gerenciamento de Oracle homes no sistema. Ele inclui comandos como dbaascli system getDBHomes
para exibir detalhes sobre todos os homes do Oracle Database e dbaascli system getGridHomes
para listar os detalhes de todos os homes do Grid Infrastructure. Esses comandos fornecem informações essenciais para a manutenção e solução de problemas do ambiente geral do sistema.
- dbaascli system getDBHomes
Para exibir informações sobre todos os Oracle homes, use o comandodbaascli system getDBHomes
. - dbaascli system getGridHomes
Para listar os detalhes de todos os homes do Grid, use o comandodbaascli system getGridHomes
.
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?
A: O comando dbaascli system getDBHomes
é usado para exibir informações sobre todos os Oracle homes em um sistema.
P: Qual usuário deve executar o comando dbaascli system getDBHomes?
A: O comando deve ser executado como o usuário root
ou oracle
.
P: Há algum parâmetro para o comando dbaascli system getDBHomes?
A: Não, o comando dbaascli system getDBHomes
não tem parâmetros.
P: Que tipo de informação o comando dbaascli system getDBHomes fornece?
R: O comando fornece detalhes sobre todos os Oracle homes no sistema, incluindo seus caminhos e outras informações relevantes.
P: Como posso interpretar a saída do comando dbaascli system getDBHomes?
A: A saída listará todos os Oracle homes com informações como a localização de cada Oracle home. Essas informações podem ajudar no gerenciamento e na configuração de ambientes Oracle.
P: O que devo fazer se o comando dbaascli system getDBHomes não retornar nenhuma saída?
R: Certifique-se de que você esteja executando o comando como usuário root
ou oracle
e verifique se os Oracle homes estão instalados corretamente no sistema. Você também pode verificar as permissões e configurações do sistema.
P: E se eu receber uma mensagem de erro ao executar o comando dbaascli system getDBHomes?
R: Verifique a mensagem de erro para obter detalhes específicos, verifique se você tem as permissões apropriadas e certifique-se de que a ferramenta dbaascli
esteja instalada e configurada corretamente.
P: Posso executar o sistema dbaascli getDBHomes em um sistema não Oracle?
R: Não, o comando dbaascli system getDBHomes
é específico para sistemas Oracle e requer que o software Oracle seja instalado.
Exemplo 7-42 dbaascli system getDBHomes
dbaascli system getDBHomes
Tópico-pai: Gerenciamento do Sistema
dbaascli system getGridHomes
Para listar os detalhes de todos os homes do Grid, use o comando dbaascli system getGridHomes
.
Pré-Requisito
Execute o comando como usuário root
ou oracle
.
Sintaxe
dbaascli system getGridHomes
Perguntas Frequentes
P: Para que é usado o comando dbaascli system getGridHomes?
R: O comando dbaascli system getGridHomes
é usado para listar os detalhes de todos os Grid homes em um sistema.
P: Qual usuário deve executar o comando dbaascli system getGridHomes?
A: O comando deve ser executado como o usuário root
ou oracle
.
P: Há algum parâmetro para o comando dbaascli system getGridHomes?
A: Não, o comando dbaascli system getGridHomes
não tem parâmetros.
P: Que tipo de informação o comando dbaascli system getGridHomes fornece?
R: O comando fornece detalhes sobre todos os Grid homes no sistema, incluindo seus locais e outras informações relevantes.
P: Como posso interpretar a saída do comando dbaascli system getGridHomes?
A: A saída listará todos os Grid homes com informações, como seus caminhos e configurações. Isso ajuda no gerenciamento e na configuração do Oracle Grid Infrastructure.
P: O que devo fazer se o comando dbaascli system getGridHomes não retornar nenhuma saída?
R: Certifique-se de que você esteja executando o comando como usuário root
ou oracle
e verifique se os Oracle Grid homes estão instalados corretamente no sistema. Verifique as permissões e configurações do sistema, se necessário.
P: E se eu receber uma mensagem de erro ao executar o comando dbaascli system getGridHomes?
R: Revise a mensagem de erro para obter detalhes específicos, verifique se você tem as permissões apropriadas e se a ferramenta dbaascli
está instalada e configurada corretamente.
P: Posso executar o sistema dbaascli getGridHomes em um sistema sem o Oracle Grid Infrastructure?
R: Não, o comando dbaascli system getGridHomes
é específico para sistemas com o Oracle Grid infrastructure instalado. Se nenhum Grid homes estiver presente, o comando poderá não retornar nenhum resultado.
Tópico-pai: Gerenciamento do Sistema
Gerenciamento de Criptografia de Dados Transparentes (TDE)
Esta seção abrange o gerenciamento da Criptografia Transparente de Dados (TDE) para proteger dados de banco de dados. Ele inclui comandos para tratar chaves de criptografia e armazenamentos de chaves, como dbaascli tde addSecondaryHsmKey
para adicionar chaves HSM secundárias, dbaascli tde rotateMasterKey
para rotacionar a chave mestra e dbaascli tde encryptTablespacesInPDB
para criptografar tablespaces em um banco de dados plugável. Você também pode converter entre FILE e TDE baseado em HSM (dbaascli tde fileToHsm
, dbaascli tde hsmToFile
), gerenciar versões de chave e recuperar detalhes de chave com vários comandos. Essas ferramentas garantem um gerenciamento eficaz de criptografia e segurança de dados.
- dbaascli tde addSecondaryHsmKey
Para adicionar uma chave HSM (KMS) secundária à configuração HSM (KMS) existente, use o comandodbaascli tde addSecondaryHsmKey
. - 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 enableWalletRoot
Para ativar o parâmetro spfilewallet_root
para 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
.
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]
--secondaryKmsKeyOCID
especifica a chave KMS secundária a ser adicionada à configuração HSM (KMS) existente--dbname
especifica o nome do banco de dados--executePrereqs
- execute as verificações de pré-requisitos e reporte os resultados.
Perguntas Frequentes
P: O que o comando dbaascli tde addSecondaryHsmKey faz?
R: O comando dbaascli tde addSecondaryHsmKey
adiciona uma chave HSM (KMS) secundária à configuração HSM (KMS) existente para um banco de dados Exadata Cloud@Customer.
P: Quem deve executar o comando dbaascli tde addSecondaryHsmKey?
A: O comando deve ser executado como usuário root
.
P: Em qual máquina devo executar o comando dbaascli tde addSecondaryHsmKey?
R: Você precisa estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.
P: Onde posso encontrar mais detalhes sobre a conexão com uma máquina virtual para executar este comando?
R: Você pode consultar o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções sobre como estabelecer conexão.
P: O que a opção --secondaryKmsKeyOCID especifica?
A: A opção --secondaryKmsKeyOCID
especifica o OCID (Oracle Cloud Identifier) da chave KMS secundária a ser adicionada à configuração do HSM (KMS) existente.
P: O que a opção --dbname faz?
A: A opção --dbname
permite especificar o nome do banco de dados ao qual a chave KMS secundária deve ser adicionada. Ela é opcional.
P: O que a opção --precheckOnly faz?
A: A opção --precheckOnly
, quando definida como yes
, executa uma pré-verificação da operação sem fazer alterações reais. Os valores válidos são yes
ou no
.
P: Posso executar a pré-verificação apenas sem fazer alterações?
R: Sim, você pode usar a opção --precheckOnly yes
para executar apenas a pré-verificação sem fazer alterações.
P: Você pode dar um exemplo de como executar este comando para adicionar uma chave HSM secundária?
A: Este é um exemplo:
dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example
P: Como executar o comando para um banco de dados específico?
A: Você pode especificar o nome do banco de dados como este:
dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --dbname mydatabase
P: Como executar o comando apenas com uma pré-verificação?
A: Para executar a pré-verificação, use a seguinte sintaxe:
dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --precheckOnly yes
P: O que devo fazer se o comando falhar?
R: Verifique se você está executando o comando como o usuário root
e se conectou à máquina virtual correta do Exadata Cloud@Customer. Além disso, verifique o OCID da chave KMS e verifique se as permissões necessárias foram concedidas.
P: Como posso verificar se tenho o OCID correto para a chave KMS secundária?
R: Você pode recuperar o OCID da chave KMS na console do Oracle Cloud Infrastructure, na seção KMS (Key Management Service).
P: Quais permissões são necessárias para adicionar uma chave KMS secundária?
R: Você precisa de permissões apropriadas no Oracle Cloud Infrastructure para operações KMS, incluindo a capacidade de gerenciar chaves KMS para o compartimento relevante.
P: Posso usar o comando dbaascli tde addSecondaryHsmKey sem especificar a opção --dbname?
R: Sim, a opção --dbname
é opcional. Se omitido, o comando se aplica a todos os bancos de dados que usam a configuração HSM (KMS) existente.
P: O que acontece se eu adicionar uma chave KMS secundária?
R: A chave KMS secundária será adicionada à configuração existente, fornecendo uma camada adicional de redundância de gerenciamento de chaves de criptografia.
P: Posso remover uma chave KMS secundária depois que ela for adicionada?
R: Não, depois que uma chave KMS secundária for adicionada, ela não poderá ser removida. Você só pode rotacionar ou atualizar chaves no futuro.
Exemplo 7-43 dbaascli tde addSecondaryHsmKey
dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --precheckOnly yes
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
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>]]
--dbname
especifica o nome do banco de dados--prepareStandbyBlob
- especifica true para gerar um arquivo blob contendo os artefatos necessários para executar a operação em um ambiente do DG.-
--blobLocation
- caminho personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG. --standbyBlobFromPrimary
- especifica o local do arquivo blob stand-by preparado no banco de dados principal. Isso só é necessário para operações stand-by.--resume
- para retomar a execução anterior--sessionID
- para retomar um id de sessão específico.
Perguntas Frequentes
P: O que o comando dbaascli tde changePassword faz?
A: O comando dbaascli tde changePassword
altera a senha do armazenamento de chaves TDE (Transparent Data Encryption), bem como a senha da wallet do banco de dados do alias tde_ks_passwd
.
P: Quem deve executar o comando dbaascli tde changePassword?
A: O comando deve ser executado como usuário root
.
P: Quando devo usar o comando dbaascli tde changePassword?
R: Use este comando quando precisar alterar a senha do armazenamento de chaves TDE ou a senha da wallet de BD para um banco de dados Exadata Cloud@Customer.
P: O que a opção --dbname faz?
A: A opção --dbname
especifica o nome do banco de dados para o qual você deseja alterar a senha do armazenamento de chaves de TDE.
P: O que a opção --pdbName faz?
A: A opção --pdbName
especifica o nome do banco de dados plugável (PDB) cuja senha do armazenamento de chaves de TDE precisa ser alterada. Esta opção é usada para bancos de dados multitenant.
P: Você pode dar um exemplo de como executar este comando para um banco de dados específico?
A: Aqui está um exemplo para alterar a senha da área de armazenamento de chaves de TDE para um banco de dados específico:
dbaascli tde changePassword --dbname mydatabase
P: Como faço para executar o comando de um PDB específico em um banco de dados multitenant?
A: Você pode especificar o nome do PDB usando esta sintaxe:
dbaascli tde changePassword --dbname mydatabase --pdbName mypdb
P: Quais são os pré-requisitos para executar o comando dbaascli tde changePassword?
R: Você deve executar o comando como o usuário root
e ter acesso à máquina virtual do Exadata Cloud@Customer na qual o banco de dados está em execução.
P: Preciso interromper o banco de dados para alterar a senha do armazenamento de chaves de TDE?
R: Não, o banco de dados não precisa ser interrompido para alterar a senha da área de armazenamento de chaves de TDE.
P: O que devo fazer se o comando falhar?
R: Certifique-se de que você esteja executando o comando como usuário raiz e que o nome do banco de dados (--dbname
) e o nome do PDB (--pdbName
, se aplicável) estejam corretos.
P: E se eu receber um erro de "senha inválida" ao alterar a senha do armazenamento de chaves TDE?
R: Certifique-se de que a nova senha atenda aos requisitos de complexidade de senhas do sistema e que você esteja digitando a senha antiga correta, se solicitado.
P: Como verifico se a senha da área de armazenamento de chaves de TDE foi alterada com sucesso?
R: Você pode verificar os logs do banco de dados ou usar as views do Oracle Database Vault e do Key Management para verificar se a alteração da senha da área de armazenamento de chaves de TDE foi bem-sucedida.
P: Posso alterar a senha da área de armazenamento de chaves de TDE para um banco de dados multitenant e todos os PDBs de uma só vez?
R: Não, o comando dbaascli tde changePassword
precisará ser executado para cada PDB individualmente se você precisar alterar a senha de vários PDBs.
P: O que acontece se eu esquecer a nova senha da área de armazenamento de chaves TDE?
R: Se a nova senha for esquecida, talvez você precise restaurar a área de armazenamento de chaves de um backup ou seguir o processo de recuperação da Oracle para redefini-la, dependendo da sua configuração.
P: Posso automatizar o processo de alteração da senha da área de armazenamento de chaves TDE?
R: Embora o próprio comando dbaascli tde changePassword
não seja projetado para automação, você pode criá-lo como parte de seus procedimentos regulares de manutenção de banco de dados, se necessário.
P: Com que frequência devo alterar a senha da área de armazenamento de chaves TDE?
R: A Oracle recomenda alterar periodicamente sua senha da área de armazenamento de chaves de TDE com base nas políticas de segurança da sua organização. As melhores práticas geralmente envolvem a rotação de chaves de criptografia e senhas de armazenamento de chaves regularmente.
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: Gerenciamento Transparente de Criptografia de Dados (TDE)
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>]]
--dbname
especifica o nome do Oracle Database.--dbrestart
especifica a opção de reinício do banco de dados. Os valores válidos são:rolling
oufull
. Valor padrão:rolling
Se você não informar o argumento
dbrestart
, o banco de dados será reiniciado de maneirarolling
.--precheckOnly
só executa a pré-verificação desta operação. Os valores válidos são:yes
ouno
--resume
para retomar a execução anterior-
--sessionID
para retomar um id de sessão específico.
Perguntas Frequentes
P: O que o comando dbaascli tde enableWalletRoot faz?
R: O comando dbaascli tde enableWalletRoot
ativa o parâmetro wallet_root
em spfile
para um banco de dados Oracle existente no Exadata Cloud@Customer.
P: Quem deve executar o comando dbaascli tde enableWalletRoot?
A: O comando deve ser executado como usuário root
.
P: Em qual máquina devo executar o comando dbaascli tde enableWalletRoot?
R: Você deve estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.
P: Onde posso encontrar instruções para me conectar à máquina virtual?
R: Você pode consultar o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções sobre como estabelecer conexão.
P: O que a opção --dbRestart faz?
--dbRestart
especifica como o banco de dados deve ser reiniciado após a ativação de wallet_root
. Os valores válidos são:
rolling
: Reinicia o banco de dados de forma incremental (comportamento padrão).full
: Executa uma reinicialização completa do banco de dados.
P: O que a opção --dbname faz?
A: A opção --dbname
permite especificar o nome do Oracle Database para o qual o parâmetro wallet_root
deve ser ativado.
P: O que a opção --precheckOnly faz?
A: A opção --precheckOnly
executa uma pré-verificação da operação sem fazer alterações reais. Os valores válidos são yes
ou no
.
P: O que acontece se eu não especificar a opção --dbRestart?
R: Se você não especificar a opção --dbRestart
, o banco de dados será reiniciado de forma incremental por padrão.
P: Você pode dar um exemplo de como ativar wallet_root para um banco de dados específico?
A: Veja um exemplo para ativar wallet_root
para um banco de dados chamado mydatabase
:
dbaascli tde enableWalletRoot --dbname mydatabase
P: Como ativar wallet_root e especificar uma reinicialização completa do banco de dados?
A: Você pode ativar wallet_root
com uma reinicialização completa do banco de dados usando o seguinte comando:
dbaascli tde enableWalletRoot --dbname mydatabase --dbRestart full
P: Como executar o comando apenas com uma pré-verificação?
A: Para executar uma pré-verificação sem fazer alterações, use a seguinte sintaxe:
dbaascli tde enableWalletRoot --dbname mydatabase --precheckOnly yes
P: Quais são os pré-requisitos para executar o comando dbaascli tde enableWalletRoot?
R: Você deve executar o comando como o usuário root
e estar conectado à máquina virtual correta do Exadata Cloud@Customer.
P: Preciso reiniciar o banco de dados para ativar o wallet_root?
R: Sim, o banco de dados precisará ser reiniciado de forma incremental (padrão) ou totalmente, dependendo da opção escolhida.
P: O que devo fazer se o comando falhar?
R: Certifique-se de que você esteja executando o comando como o usuário raiz e verifique se o nome do banco de dados (--dbname
) está correto. Verifique se há erros de pré-verificação se você estiver executando com --precheckOnly
.
P: E se o banco de dados falhar ao reiniciar após a execução do comando?
R: Verifique se a opção de reinicialização correta foi usada (rolling
ou full
) e verifique se há erros nos logs do banco de dados. Talvez seja necessário reiniciar manualmente o banco de dados se a reinicialização automática falhar.
P: Como posso verificar se wallet_root foi ativado com sucesso?
R: Você pode verificar a alteração verificando o spfile
do banco de dados ou usando consultas do Oracle SQL para confirmar se o parâmetro wallet_root
está ativado.
P: Posso ativar wallet_root sem reiniciar o banco de dados?
R: Não, o banco de dados precisa ser reiniciado para que a alteração entre em vigor. Você pode escolher entre uma reinicialização incremental ou uma reinicialização completa.
P: Qual é a diferença entre uma reinicialização contínua e completa do banco de dados?
R: Uma reinicialização incremental reinicia o banco de dados uma instância por vez, permitindo que o banco de dados permaneça parcialmente disponível durante a operação. Uma reinicialização completa é encerrada e reinicia todo o banco de dados, causando um tempo de inatividade completo.
P: Posso executar este comando para vários bancos de dados simultaneamente?
R: Você precisa executar o comando dbaascli tde enableWalletRoot
separadamente para cada banco de dados no qual deseja ativar wallet_root.
P: Como a ativação de wallet_root afeta a configuração do armazenamento de chaves de TDE existente?
R: A ativação de wallet_root
atualiza o local do armazenamento de chaves TDE para o novo diretório raiz da wallet, facilitando o gerenciamento de vários armazenamentos de chaves e wallets em bancos de dados Oracle.
Exemplo 7-44 dbaascli tde enableWalletRoot
dbaascli tde enableWalletRoot --dbname db name --dbrestart rolling|full
dbaascli tde enableWalletRoot --dbname orcl
dbaascli tde enableWalletRoot --dbname orcl--dbrestart full
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
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]
--pdbName
especifica o nome do PDB para criptografar todos os tablespaces.--dbname
especifica o nome do Oracle Database.--executePrereqs
- execute as verificações de pré-requisitos e reporte os resultados.
Perguntas Frequentes
P: O que o comando dbaascli tde encryptTablespacesInPDB faz?
R: O comando dbaascli tde encryptTablespacesInPDB
criptografa todos os tablespaces no PDB (banco de dados plugável) especificado para um Oracle Database no Exadata Cloud@Customer.
P: Quem deve executar o comando dbaascli tde encryptTablespacesInPDB?
A: O comando deve ser executado como usuário root
.
P: Em qual máquina devo executar o comando dbaascli tde encryptTablespacesInPDB?
R: Você precisa estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.
P: Onde posso encontrar instruções para conexão com a máquina virtual?
A: Consulte o guia "Estabelecendo Conexão com uma Máquina Virtual com SSH" para obter instruções de conexão.
P: O que a opção --pdbName especifica?
A: A opção --pdbName
especifica o nome do banco de dados plugável (PDB) cujos tablespaces precisam ser criptografados.
P: O que a opção --dbname faz?
A: A opção --dbname
permite especificar o nome do Oracle Database ao qual o PDB pertence.
P: O que a opção --precheckOnly faz?
A: A opção --precheckOnly
executa uma pré-verificação da operação de criptografia sem fazer alterações reais. Os valores válidos são yes
ou no
.
P: O que a opção --useSysdbaCredential faz?
A: A opção --useSysdbaCredential
especifica se as credenciais SYSDBA devem ser usadas para a operação. Os valores válidos são verdadeiro ou falso.
P: Você pode dar um exemplo de como criptografar tablespaces em um PDB específico?
A: Aqui está um exemplo para criptografar todos os tablespaces em um PDB chamado mypdb
:
dbaascli tde encryptTablespacesInPDB --pdbName mypdb
P: Como criptografar tablespaces em um PDB específico em um banco de dados?
A: Use o seguinte comando para especificar o PDB e o banco de dados:
dbaascli tde encryptTablespacesInPDB --pdbName mypdb --dbname mydatabase
P: Como faço para executar uma pré-verificação sem executar a criptografia?
A: Você só pode executar uma pré-verificação usando esta sintaxe:
dbaascli tde encryptTablespacesInPDB --pdbName mypdb --precheckOnly yes
P: Como eu uso as credenciais SYSDBA para criptografar os tablespaces?
A: Você pode usar as credenciais SYSDBA adicionando a opção --useSysdbaCredential true
:
dbaascli tde encryptTablespacesInPDB --pdbName mypdb --useSysdbaCredential true
P: Quais são os pré-requisitos para executar o comando dbaascli tde encryptTablespacesInPDB?
R: Você deve executar o comando como usuário root
e ter acesso à máquina virtual do Exadata Cloud@Customer.
P: Preciso reiniciar o banco de dados para criptografar os tablespaces?
R: Não, o comando não requer uma reinicialização do banco de dados. A criptografia é executada enquanto o banco de dados está on-line.
P: Preciso de credenciais SYSDBA para criptografar tablespaces?
R: Talvez você precise de credenciais SYSDBA para esta operação, se especificado usando a opção --useSysdbaCredential
.
P: O que devo fazer se o comando falhar?
R: Certifique-se de que você esteja executando o comando como o usuário raiz e verifique se o nome do PDB (--pdbName
) e o nome do banco de dados (--dbname
) estão corretos. Você também pode executar o comando com --precheckOnly yes
para verificar problemas antes de executar a criptografia completa.
P: O que devo fazer se a criptografia dos tablespaces falhar?
R: Verifique os logs do banco de dados e certifique-se de ter os privilégios e recursos necessários para executar a criptografia. Você também pode precisar verificar se há espaço suficiente para lidar com o processo de criptografia.
P: Como posso verificar se os tablespaces em um PDB estão criptografados?
R: Você pode consultar as views de banco de dados relacionadas à criptografia, como V$ENCRYPTED_TABLESPACES
, para verificar se os tablespaces foram criptografados com sucesso.
P: Como posso verificar se a pré-verificação foi bem-sucedida?
R: Se você executou o comando com --precheckOnly yes
, poderá verificar a saída em busca de avisos ou erros que indiquem possíveis problemas com o processo de criptografia.
P: Posso criptografar os tablespaces de vários PDBs simultaneamente?
R: Não, você precisa executar o comando dbaascli tde encryptTablespacesInPDB
separadamente para cada PDB.
P: Posso criptografar parcialmente alguns tablespaces em um PDB?
R: Não, este comando criptografa todos os tablespaces dentro do PDB especificado. Para criptografia parcial, você precisaria usar comandos de gerenciamento de banco de dados diferentes.
P: A criptografia de tablespaces afeta o desempenho do banco de dados?
R: A criptografia de tablespaces pode ter um impacto temporário no desempenho durante o processo de criptografia. No entanto, o impacto deve ser mínimo quando a criptografia estiver concluída.
P: Posso desfazer a criptografia de tablespaces?
R: Não, depois que os tablespaces forem criptografados, a criptografia não poderá ser desfeita. Você só pode rotacionar ou recriptografar as chaves conforme necessário.
P: O que acontece se a operação for interrompida durante o processo de criptografia?
R: Se a operação for interrompida, talvez seja necessário reexecutar o comando. O sistema retomará a criptografia de onde parou e você poderá verificar o status usando views de banco de dados.
Exemplo 7-45 dbaascli tde encryptTablespacesInPDB
dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb
dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb --executePrereqs
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
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>]
--kmsKeyOCID
especifica o OCID da chave KMS a ser usado para TDE. Isso só será aplicável se o KMS for selecionado para TDE--dbname
especifica o nome do banco de dados--skipPatchCheck
ignora a verificação de validação para patches obrigatórios se o valor informado para esse argumento fortrue
. Valores válidos:true
oufalse
--executePrereqs
- execute as verificações de pré-requisitos e reporte os resultados.--primarySuc
especifica essa propriedade no banco de dados stand-by do ambiente do Data Guard quando o comando é executado com sucesso no banco de dados principal--resume
especifica para retomar a execução anterior-
--sessionID
especifica para retomar um ID de sessão específico
-
--revert
especifica para fazer rollback da execução anterior-
--sessionID
especifica para fazer rollback de um ID de sessão específico
-
--waitForCompletion
especifique false para executar a operação em segundo plano. Valores válidos : true|false.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli tde fileToHsm?
R: O comando dbaascli tde fileToHsm
é usado para converter uma TDE (Transparent Data Encryption) baseada em arquivo para a TDE baseada no Módulo de Segurança de Hardware (HSM), como KMS ou OKV, em um ambiente do Oracle Database Cloud Service.
P: Quem pode executar o comando dbaascli tde fileToHsm?
A: O comando deve ser executado como usuário root
.
P: Qual é a finalidade do parâmetro --kmsKeyOCID?
R: O parâmetro --kmsKeyOCID
especifica o OCID da chave KMS que será usado para criptografia de TDE ao fazer a transição de TDE baseada em arquivo para TDE baseada em HSM.
P: O que o parâmetro --dbname faz?
R: O parâmetro --dbname
especifica o nome do banco de dados para o qual você está convertendo o TDE de baseado em arquivo para baseado em HSM.
P: Posso ignorar a verificação de validação do patch ao converter a TDE?
R: Sim, usando o parâmetro --skipPatchCheck
com o valor true
, você pode ignorar a verificação de validação dos patches necessários.
P: Para que o parâmetro --executePrereqs é usado?
R: O parâmetro --executePrereqs
permite que você execute somente as pré-verificações do processo de conversão de TDE sem executar a conversão real. Os valores válidos são yes
ou no
.
P: O que o parâmetro --primarySuc faz em uma configuração do Data Guard?
R: O parâmetro --primarySuc
é usado em um ambiente do Data Guard para indicar que o comando foi executado com sucesso no banco de dados principal. Ela deve ser especificada no banco de dados stand-by após a conclusão da conversão principal.
P: Como retomar uma conversão de TDE anterior?
R: Você pode retomar uma conversão de TDE anteriormente incompleta usando o parâmetro --resume
. Opcionalmente, você pode especificar um ID de sessão específico com --sessionID
.
P: Como reverter uma conversão de TDE?
R: Para reverter uma conversão de TDE anterior, use o parâmetro --revert
. Você também pode fornecer o ID de sessão específico que deseja reverter usando --sessionID
.
P: Como especificar um ID de sessão ao retomar ou reverter uma conversão de TDE?
R: Você pode usar o parâmetro --sessionID
para especificar o ID da sessão que deseja retomar ou reverter. Exemplo: --resume --sessionID <ID>
ou --revert --sessionID <ID>
.
P: O que acontece se eu definir --waitForCompletion como falso?
R: Se você definir --waitForCompletion
como false
, o processo de conversão de TDE será executado em segundo plano e o prompt de comando retornará imediatamente. Se definido como true
, o comando aguardará a conclusão do processo antes de retornar o controle ao usuário.
P: Quais são os valores válidos para o parâmetro --waitForCompletion?
A: Os valores válidos são true
ou false
. A definição dele como verdadeiro faz com que o comando aguarde até que o processo seja concluído; a definição dele como false
executa o processo em segundo plano.
P: Posso executar dbaascli TDE fileToHsm sem converter o TDE imediatamente?
R: Sim, você pode usar o parâmetro --executePrereqs yes
para executar apenas as pré-verificações da conversão, sem fazer alterações na TDE.
P: Em um ambiente do Data Guard, como lidar com o banco de dados stand-by após a conversão da TDE no principal?
R: Após executar com sucesso a conversão no banco de dados principal, você precisa especificar --primarySuc
ao executar o comando no banco de dados stand-by.
P: O que devo fazer se o processo de conversão de TDE falhar?
R: Se o processo falhar, você poderá usar o parâmetro --resume
para tentar retomar de onde parou. Se necessário, você pode usar o parâmetro --revert
para fazer rollback das alterações feitas durante a sessão com falha.
Exemplo 7-46 dbaascli tde fileToHsm --kmsKeyOCID
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --resume
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
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]
--dbname
especifica o nome do banco de dados--infoFile
especifica o caminho do arquivo em que a lista de OCIDs será salva. A saída está no formato JSON
Perguntas Frequentes
P: O que o comando dbaascli tde getHsmKeys faz?
R: O comando dbaascli tde getHsmKeys
recupera detalhes de chaves TDE (Transparent Data Encryption) ativas do HSM (Hardware Security Module) de um banco de dados especificado.
P: Quem deve executar o comando dbaascli tde getHsmKeys?
A: O comando deve ser executado como usuário root
.
P: Em qual máquina devo executar o comando dbaascli tde getHsmKeys?
R: Você deve estabelecer conexão com uma máquina virtual do Exadata Cloud@Customer usando SSH para executar esse comando.
P: Onde posso encontrar instruções para conexão com a máquina virtual?
A: Consulte o guia "Connecting to a Virtual Machine with SSH" para obter instruções sobre como estabelecer conexão.
P: O que a opção --dbname faz?
A: A opção --dbname
permite especificar o nome do Oracle Database para o qual você deseja recuperar detalhes da chave de TDE.
P: O que a opção --infoFile faz?
A: A opção --infoFile
especifica o caminho do arquivo no qual a lista de OCIDs de chave (Identificadores do Oracle Cloud) será salva. A saída está no formato JSON.
P: Você pode dar um exemplo de como recuperar detalhes da chave TDE de um banco de dados específico?
A: Veja um exemplo para obter os detalhes da chave TDE de um banco de dados chamado mydatabase
:
dbaascli tde getHsmKeys --dbname mydatabase
P: Como faço para salvar os detalhes da chave TDE em um arquivo?
A: Você pode especificar um caminho de arquivo usando a opção --infoFile
para salvar a saída no formato JSON:
dbaascli tde getHsmKeys --dbname mydatabase --infoFile
/path/to/output.json
P: Quais são os pré-requisitos para executar o comando dbaascli tde getHsmKeys?
R: Você deve executar o comando como o usuário root
e estar conectado à máquina virtual do Exadata Cloud@Customer.
P: Preciso de credenciais SYSDBA para recuperar detalhes da chave TDE?
R: Não, as credenciais SYSDBA não são necessárias para executar o comando dbaascli tde getHsmKeys
.
P: Em que formato as informações da chave TDE são salvas ao usar a opção --infoFile?
A: A saída é salva no formato JSON.
P: Quais informações estão incluídas nos detalhes da chave TDE?
R: Os detalhes incluem OCIDs de chave e outros metadados sobre as chaves de criptografia ativas armazenadas no HSM para o banco de dados especificado.
P: O que devo fazer se o comando não recuperar os detalhes da chave?
R: Verifique se você está executando o comando como o usuário raiz e se o nome do banco de dados (--dbname
) está correto. Verifique sua conexão com a máquina virtual do Exadata Cloud@Customer.
P: Como verifico se o arquivo de saída foi criado com sucesso?
R: Você pode verificar o caminho do arquivo especificado para o arquivo JSON de saída. Se o arquivo estiver ausente, verifique se o caminho do arquivo está correto e se você tem permissões de gravação no diretório.
P: O que devo fazer se o arquivo de saída estiver vazio?
R: Certifique-se de que o banco de dados especificado contenha chaves de TDE ativas e que o parâmetro --dbname
esteja correto. Você também pode precisar verificar se há erros nos logs do banco de dados.
P: Posso recuperar detalhes da chave TDE para vários bancos de dados de uma só vez?
R: Não, você deve executar o comando dbaascli tde getHsmKeys
separadamente para cada banco de dados.
P: Como posso usar o arquivo de saída da opção --infoFile em outras operações?
R: Como a saída está no formato JSON, você pode fazer parsing do arquivo de forma programática ou usá-lo como entrada para outras tarefas de gerenciamento de banco de dados ou criptografia.
P: Posso obter detalhes históricos da chave de TDE usando este comando?
R: Não, o comando recupera apenas detalhes sobre as chaves atualmente ativas no HSM.
P: Como posso verificar se as chaves recuperadas estão corretas?
R: Você pode verificar as chaves fazendo referência cruzada delas com a console do OCI (Oracle Cloud Infrastructure) ou usando views de banco de dados relacionadas ao gerenciamento de criptografia.
Exemplo 7-47 dbaascli tde getHsmKeys
dbaascli tde getHsmkeys --dbname dbname
dbaascli tde getHsmkeys --dbname dbname --infoFile infoFilePath
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
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>]
--kmsKeyVersionOCID
especifica o OCID da versão da chave KMS a ser definido--dbname
especifica o nome do banco de dados--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos :true
|false
.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli tde getMkidForKeyVersionOCID?
R: O comando dbaascli tde getMkidForKeyVersionOCID
recupera o MKID (Master Key ID) associado a um OCID específico da versão da chave KMS nos ambientes do Oracle Database Cloud Service.
P: Quais são os pré-requisitos para executar o comando dbaascli tde getMkidForKeyVersionOCID?
- 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 7-48 dbaascli tde getMkidForKeyVersionOCID
dbaascli tde getMkidForKeyVersionOCID --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
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]
--dbname
especifica o nome do banco de dados
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli tde getPrimaryHsmKey?
R: O comando dbaascli tde getPrimaryHsmKey
recupera a chave primária do Módulo de Segurança de Hardware (HSM) da configuração existente do HSM (KMS) em um ambiente do Oracle Database.
P: Quais são os pré-requisitos para executar o comando dbaascli tde getPrimaryHsmKey?
- Execute o comando como usuário
root
. - Conecte-se a uma máquina virtual do Exadata Cloud@Customer via SSH.
P: Quem pode executar o comando dbaascli tde getPrimaryHsmKey?
A: Somente o usuário root
pode executar este comando.
P: O que o parâmetro --dbname especifica neste comando?
R: O parâmetro --dbname
especifica o nome do banco de dados para o qual você deseja recuperar a chave HSM principal.
P: O parâmetro --dbname é obrigatório?
A: Não, o parâmetro --dbname
é opcional. Se não for fornecida, o comando recuperará a chave HSM primária do banco de dados padrão no sistema.
P: O que devo fazer se não especificar um nome de banco de dados com --dbname?
R: Se o parâmetro --dbname
não for especificado, o comando tentará recuperar a chave principal do HSM para o banco de dados padrão configurado no sistema.
P: Posso executar este comando em um ambiente que não seja do Exadata Cloud@Customer?
R: Não, esse comando foi projetado especificamente para uso em um ambiente Exadata Cloud@Customer e você deve estar conectado à máquina virtual usando SSH para executá-lo.
P: Como estabeleço conexão com a máquina virtual do Exadata Cloud@Customer para executar o comando?
R: Você pode se conectar à máquina virtual via SSH. Consulte a documentação do Exadata Cloud@Customer para obter instruções sobre como estabelecer conexão segura.
P: O que devo verificar se encontro um erro ao recuperar a chave principal do HSM?
- Você está executando o comando como o usuário
root
. - Você está conectado corretamente à máquina virtual do Exadata Cloud@Customer.
- O nome do banco de dados (se especificado) é válido. Se o problema persistir, consulte logs do sistema ou mensagens de erro para obter mais detalhes.
P: Eu preciso interromper o banco de dados para executar o comando dbaascli tde getPrimaryHsmKey?
R: Não, o banco de dados não precisa ser interrompido para executar este comando. Você pode executá-lo enquanto o banco de dados está sendo executado.
P: Qual é a finalidade de recuperar a chave principal do HSM?
R: A recuperação da chave HSM principal permite identificar a chave HSM atual que está sendo usada para criptografia na configuração HSM (KMS) existente do banco de dados.
Exemplo 7-49 dbaascli tde getPrimaryHsmKey
dbaascli tde getPrimaryHsmKey --dbname dbname
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
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>]
--dbname
especifica o nome do banco de dados--prepareStandbyBlob
- especifiquetrue
para gerar um arquivo blob contendo os artefatos necessários para executar a operação em um ambiente do DG.-
--blobLocation
local de diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente do DG. --standbyBlobFromPrimary
especifica o local do arquivo blob stand-by preparado no banco de dados principal. Isso só é necessário para operações stand-by. ]--skipPatchCheck
ignora a verificação de validação para patches obrigatórios se o valor informado para esse argumento fortrue
. Valores válidos:true
oufalse
--executePrereqs
- execute as verificações de pré-requisitos e reporte os resultados.--primarySuc
especifica essa propriedade no banco de dados stand-by do ambiente do Data Guard quando o comando é executado com sucesso no banco de dados principal--resume
retoma a execução anterior-
--sessionID
especifica para retomar um ID de sessão específico
-
--revert
especifica para fazer rollback da execução anterior-
--sessionID
especifica para fazer rollback de um ID de sessão específico
-
--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
|false
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli tde hsmToFile?
R: O comando dbaascli tde hsmToFile
é usado para converter um TDE (Transparent Data Encryption) baseado no Módulo de Segurança de Hardware (HSM) em um TDE baseado em arquivo nos ambientes do Oracle Database Cloud Service.
P: Quais são os pré-requisitos para executar o comando dbaascli tde hsmToFile?
- Execute o comando como usuário
root
. - Certifique-se de ter as permissões e configurações necessárias definidas no ambiente de banco de dados.
P: O que o parâmetro --dbname especifica?
R: O parâmetro --dbname
especifica o nome do banco de dados para o qual você está convertendo o TDE de baseado em HSM para baseado em arquivo.
P: Quando o parâmetro --primaryDBWalletTar é necessário?
R: O parâmetro --primaryDBWalletTar
só é necessário ao executar a conversão hsmToFile
em um banco de dados stand-by. Especifica o arquivo tar da wallet do banco de dados principal.
P: Qual é a finalidade do parâmetro --skipPatchCheck?
R: O parâmetro --skipPatchCheck
permite ignorar a verificação de validação dos patches necessários. Defina isso como true
para ignorar a verificação ou false
para aplicá-la.
P: Como executar apenas pré-verificações para o processo de conversão sem executar a conversão real?
R: Você pode usar o parâmetro --executePrereqs
e defini-lo como yes
para executar somente as pré-verificações. Defina-o como no
para executar a conversão completa.
P: O que o parâmetro --primarySuc faz em um ambiente do Data Guard?
R: O parâmetro --primarySuc
é usado em uma configuração do Data Guard para indicar que a conversão foi executada com sucesso no banco de dados principal. Ele deve ser usado ao executar a conversão no banco de dados stand-by.
P: Como posso retomar uma conversão hsmToFile anterior?
R: Você pode retomar uma conversão anterior usando o parâmetro --resume
. Opcionalmente, você pode especificar o ID da sessão da execução anterior com --sessionID
.
P: Qual é o propósito do parâmetro --revert?
R: O parâmetro --revert
é usado para fazer rollback de um processo de conversão iniciado anteriormente em caso de falha ou se você precisar desfazer a operação.
P: O que acontece se eu definir --waitForCompletion como falso?
R: Se você definir --waitForCompletion
como false
, a operação será executada em segundo plano, permitindo que você continue outras tarefas. Se definido como true
, o comando aguardará a conclusão do processo antes de retornar o controle ao usuário.
P: O que devo fazer se precisar converter a TDE em um banco de dados stand-by em uma configuração do Data Guard?
R: Em uma configuração do Data Guard, depois de converter TDE no banco de dados principal, você deve executar o comando no banco de dados stand-by usando o parâmetro --primaryDBWalletTar
, especificando o arquivo tar da wallet do banco de dados principal e incluir --primarySuc
.
P: O que devo fazer se quiser ignorar a verificação dos patches necessários durante a conversão?
R: Você pode ignorar a verificação de patch usando o parâmetro --skipPatchCheck
e definindo-o como true
.
P: Como verifico se o sistema está pronto para a conversão hsmToFile sem fazer alterações?
R: Você só pode executar as pré-verificações usando o parâmetro --executePrereqs
e definindo-o como yes
.
P: O que devo fazer se o processo de conversão for interrompido?
R: Você pode usar o parâmetro --resume
para reiniciar o processo de onde ele parou. Opcionalmente, você pode especificar um ID de sessão específico com --sessionID
.
P: O que devo fazer se o processo de conversão falhar?
R: Se a conversão falhar, você poderá fazer rollback do processo usando o parâmetro --revert
. Além disso, revise quaisquer mensagens de erro e verifique os logs do sistema para obter mais detalhes.
P: Posso executar o comando dbaascli tde hsmToFile em um ambiente não Exadata?
R: Este comando foi projetado para uso em ambientes Exadata Cloud@Customer. Se você não estiver usando o Exadata, certifique-se de estar em um ambiente suportado para que o comando funcione corretamente.
Exemplo 7-50 dbaascli tde hsmToFile
dbaascli tde hsmToFile --dbname dbname
dbaascli tde hsmToFile --dbname dbname --executePrereqs
dbaascli tde hsmToFile --dbname dbname --resume
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
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>]
--dbname
especifica o nome do banco de dados--infoFilePath
- especifique o caminho absoluto do arquivo no qual os resultados serão salvos.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli tde listKeys?
R: O comando dbaascli tde listKeys
é usado para listar todas as chaves principais de TDE (Transparent Data Encryption) de um banco de dados especificado em um ambiente do Oracle Database.
P: Quais são os pré-requisitos para executar o comando dbaascli tde listKeys?
- 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. Consulte as mensagens de erro e os logs para obter mais detalhes sobre a falha.
P: Posso executar o comando dbaascli tde listKeys enquanto o banco de dados está em execução?
R: Sim, o comando pode ser executado enquanto o banco de dados está em execução. Ele simplesmente lista as chaves principais de TDE e não altera o estado do banco de dados.
P: Preciso de permissões especiais para executar este comando?
R: Execute esse comando como usuário root
. Sem permissões root, você não poderá executar o comando.
P: Qual é a finalidade de listar as chaves mestras de TDE?
R: A listagem de chaves principais de TDE permite que você revise as chaves de criptografia que estão sendo usadas para proteger os dados do seu banco de dados. É essencial para monitorar e gerenciar configurações de criptografia.
P: Como estabeleço conexão com a máquina virtual do Exadata Cloud@Customer para executar o comando?
R: Você pode se conectar à máquina virtual usando SSH. Consulte a documentação do Exadata Cloud@Customer para obter instruções sobre como estabelecer uma conexão segura.
Exemplo 7-51 dbaascli tde listKeys
dbaascli tde listKeys --dbname dbname
dbaascli tde listKeys --dbname dbname --infoFilePath infoFilePath
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
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]
--dbname
especifica o nome do banco de dados--confirmDeletion
- se não for especificado, o usuário será avisado durante a exclusão de todas as chaves HSM(KMS) existentes.--secondaryKmsKeyOCID
- chave KMS secundária a ser removida da configuração HSM(KMS) existente. Se não for especificada, todas as chaves KMS secundárias serão removidas.--executePrereqs
- execute as verificações de pré-requisitos e reporte os resultados.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli tde removeSecondaryHsmKey?
R: O comando dbaascli tde removeSecondaryHsmKey
é usado para remover uma chave secundária do Módulo de Segurança de Hardware (HSM) da configuração existente do HSM (KMS) em um ambiente do Oracle Database.
P: Quais são os pré-requisitos para executar o comando dbaascli tde removeSecondaryHsmKey?
- Execute o comando como usuário
root
. - Conecte-se a uma máquina virtual do Exadata Cloud@Customer usando SSH.
P: O que o parâmetro --force faz no comando dbaascli tde removeSecondaryHsmKey?
R: O parâmetro --force
permite a remoção da chave secundária do HSM sem solicitar confirmação ao usuário. Se não for especificado, o comando solicitará ao usuário antes de excluir as chaves.
P: O que o parâmetro --secondaryKmsKeyOCID especifica?
A: O parâmetro --secondaryKmsKeyOCID
especifica o OCID (Oracle Cloud Identifier) da chave KMS secundária que você deseja remover da configuração do HSM existente.
P: O que o parâmetro --dbname faz?
R: O parâmetro --dbname
especifica o nome do banco de dados para o qual a chave HSM secundária está sendo removida.
P: Qual é a finalidade do parâmetro --precheckOnly?
R: O parâmetro --precheckOnly
, se definido como yes
, só executará as pré-verificações para validar a prontidão da operação de remoção sem realmente remover a chave HSM secundária. Se definido como no
, a operação de remoção completa será executada.
P: O parâmetro --force é obrigatório?
A: Não, o parâmetro --force
é opcional. Se não for especificado, o sistema solicitará confirmação ao usuário antes de prosseguir com a remoção da chave.
P: O parâmetro --secondaryKmsKeyOCID é obrigatório?
R: Sim, você deve fornecer o --secondaryKmsKeyOCID
para identificar a chave HSM secundária específica que deseja remover da configuração.
P: O parâmetro --dbname é obrigatório?
A: Não, o parâmetro --dbname
é opcional. Se não for especificado, o comando tentará remover a chave secundária do HSM do banco de dados padrão no sistema.
P: O que devo fazer se eu quiser remover a chave secundária do HSM sem prompts do usuário?
R: Você deve usar o parâmetro --force
para ignorar o prompt de confirmação e remover a chave secundária do HSM diretamente:
dbaascli tde removeSecondaryHsmKey --force --secondaryKmsKeyOCID <value>
P: Como posso testar se o sistema está pronto para remover a chave HSM secundária sem realmente removê-la?
A: Você pode usar o parâmetro --precheckOnly
definido como sim para executar uma pré-verificação:
dbaascli tde removeSecondaryHsmKey --precheckOnly yes --secondaryKmsKeyOCID <value>
P: O que acontece se eu não fornecer um nome de banco de dados com --dbname?
R: Se o parâmetro --dbname
não for especificado, o comando tentará remover a chave secundária do HSM do banco de dados padrão configurado no sistema.
P: O que devo verificar se o comando falha ao remover a chave secundária do HSM?
- Você está executando o comando como o usuário
root
. - Você está conectado à máquina virtual do Exadata Cloud@Customer.
- Os valores
--secondaryKmsKeyOCID
e--dbname
corretos são fornecidos. Consulte as mensagens de erro e os logs para obter mais detalhes sobre a falha.
P: O que devo fazer se a operação de remoção falhar a meio do caminho?
R: Se a operação falhar, revise os logs de erro e tente executar o comando com --precheckOnly
para garantir que o sistema esteja pronto para a operação. Se necessário, corrija os problemas antes de tentar novamente.
P: Posso executar o comando dbaascli tde removeSecondaryHsmKey enquanto o banco de dados está em execução?
R: Sim, o comando pode ser executado enquanto o banco de dados está em execução, pois não requer que o banco de dados seja interrompido.
P: Qual é a finalidade de remover uma chave HSM secundária?
R: A remoção de uma chave HSM secundária geralmente é feita quando a chave não é mais necessária ou quando você deseja gerenciar as chaves de criptografia usadas na configuração de TDE (Criptografia Transparente de Dados).
P: Como estabeleço conexão com a máquina virtual do Exadata Cloud@Customer para executar o comando?
R: Você pode se conectar à máquina virtual usando SSH. Consulte a documentação do Exadata Cloud@Customer para obter instruções sobre como estabelecer uma conexão segura.
Exemplo 7-52 dbaascli tde removeSecondaryHsmKey
dbaascli tde removeSecondaryHsmKey --dbname dbname
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
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>]
}
--dbname
especifica o nome do Oracle Database--rotateMasterKeyOnAllPDBs
especificatrue
para rotacionar a chave principal de todos os PDBs no CDB. Valores válidos:true
|false
--pdbName
especifica o nome do PDB--executePrereqs
executa as verificações de pré-requisitos e reporta os resultados--resume
especifica a retomada da execução anterior-
--sessionID
especifica para retomar um ID de sessão específico -
--prepareStandbyBlob
especificatrue
para gerar um arquivo BLOB contendo os artefatos necessários para executar a operação em um ambiente do Data Guard -
--blobLocation
especifica o local do diretório personalizado no qual o arquivo BLOB stand-by será gerado em um ambiente do Data Guard --standbyBlobFromPrimary
especifica o local do arquivo BLOB stand-by, que é preparado usando o banco de dados principal. Isso só é necessário para operações stand-by.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli tde rotateMasterKey?
R: O comando dbaascli tde rotateMasterKey
é usado para rotacionar a chave mestra usada para TDE (Transparent Data Encryption) em um Oracle Database. Esse processo garante que as chaves de criptografia sejam atualizadas para melhor segurança.
P: Quais são os pré-requisitos para executar o comando dbaascli tde rotateMasterKey?
- Execute o comando como usuário
root
. - Certifique-se de que o banco de dados esteja configurado corretamente para TDE.
P: O que o parâmetro --dbname especifica?
R: O parâmetro --dbname
especifica o nome do Oracle Database para o qual você deseja rotacionar a chave de criptografia principal.
P: Qual é a finalidade do parâmetro --rotateMasterKeyOnAllPDBs?
A: O parâmetro --rotateMasterKeyOnAllPDBs
especifica se a chave principal deve ser rotacionada para todos os PDBs (Bancos de Dados Plugáveis) em um CDB (Banco de Dados Contêiner). Os valores válidos são verdadeiro ou falso.
P: O que o parâmetro --pdbName faz?
R: O parâmetro --pdbName
especifica o nome de um PDB (Banco de Dados Plugável) específico se você quiser rotacionar a chave principal de um PDB específico em vez de todos os PDBs.
P: O que o parâmetro --executePrereqs faz?
R: O parâmetro --executePrereqs
executa verificações de pré-requisitos para validar se o ambiente está pronto para a rotação da chave mestra sem executar a rotação real.
P: O que o parâmetro --resume especifica?
R: O parâmetro --resume
é usado para retomar uma operação iniciada anteriormente. Você também pode fornecer um ID de sessão específico usando --sessionID
para retomar uma sessão específica.
P: Qual é a finalidade do parâmetro --prepareStandbyBlob?
R: O parâmetro --prepareStandbyBlob
, se definido como verdadeiro, gera um arquivo BLOB contendo os artefatos necessários para executar a rotação da chave principal em um ambiente do Data Guard.
P: O que o parâmetro --blobLocation faz?
R: O parâmetro --blobLocation
especifica um caminho de diretório personalizado no qual o arquivo BLOB stand-by será gerado. Isso é aplicável quando --prepareStandbyBlob
é definido como true
.
P: O que o parâmetro --standbyBlobFromPrimary especifica?
R: O parâmetro --standbyBlobFromPrimary
especifica o local do arquivo BLOB stand-by que foi gerado pelo banco de dados principal. Esse parâmetro é usado ao executar a rotação de chave mestra em um banco de dados stand-by em um ambiente do Data Guard.
P: O parâmetro --rotateMasterKeyOnAllPDBs é obrigatório?
A: Não, o parâmetro --rotateMasterKeyOnAllPDBs
é opcional. Se ela não for especificada, a chave mestra só será rotacionada para o banco de dados (ou PDB específico) fornecido nos parâmetros --dbname
ou --pdbName
.
P: O parâmetro --pdbName será necessário se eu estiver rotacionando chaves para um CDB?
R: Não, o parâmetro --pdbName
só será necessário se você quiser rotacionar a chave mestra de um PDB (Banco de Dados Plugável) específico. É opcional ao girar a chave de todo o CDB.
P: Preciso usar os parâmetros --prepareStandbyBlob e --standbyBlobFromPrimary para bancos de dados stand-alone?
R: Não, esses parâmetros só são relevantes em um ambiente do Data Guard em que um banco de dados stand-by está envolvido.
P: Como posso rotacionar a chave principal de todos os PDBs em um CDB?
R: Você deve usar o parâmetro --rotateMasterKeyOnAllPDBs
definido como verdadeiro para rotacionar a chave principal de todos os PDBs no CDB. Por exemplo:
dbaascli tde rotateMasterKey --dbname CDB_NAME --rotateMasterKeyOnAllPDBs true
P: Como faço para executar uma verificação para validar se o sistema está pronto para a rotação da chave principal sem executar a operação real?
R: Você pode usar o parâmetro --executePrereqs
para executar as verificações de pré-requisitos. Isso reportará quaisquer problemas que possam impedir a rotação da chave mestra:
dbaascli tde rotateMasterKey --dbname DB_NAME --executePrereqs
P: O que devo fazer se a operação for interrompida e eu quiser retomá-la?
R: Você pode usar o parâmetro --resume
para retomar a operação interrompida anteriormente. Se você tiver um ID de sessão, forneça-o com o parâmetro --sessionID
:
dbaascli tde rotateMasterKey --dbname DB_NAME --resume --sessionID <value>
P: Como posso me preparar para a rotação de chaves em um ambiente do Data Guard?
A: Você deve usar o parâmetro --prepareStandbyBlob
para gerar um arquivo BLOB que contenha os artefatos necessários para rotacionar a chave principal em um ambiente stand-by:
dbaascli tde rotateMasterKey --dbname DB_NAME --prepareStandbyBlob true --blobLocation
/path/to/blob
P: Como aplicar o arquivo BLOB stand-by do banco de dados principal ao rotacionar chaves em um banco de dados stand-by?
A: Use o parâmetro --standbyBlobFromPrimary
para especificar o local do arquivo BLOB que foi preparado no banco de dados principal:
dbaascli tde rotateMasterKey --dbname DB_NAME --standbyBlobFromPrimary
/path/to/blob
P: O que devo verificar se a rotação da chave mestra falha?
- Você está executando o comando como o usuário
root
. - O nome do banco de dados (
--dbname
) está correto. - Todas as verificações de pré-requisitos foram executadas usando
--executePrereqs
para garantir a prontidão. Revise os logs de erro para obter informações mais detalhadas sobre a falha.
P: O que devo fazer se a operação não for concluída com sucesso em um ambiente do Data Guard?
R: Certifique-se de que o arquivo BLOB do banco de dados principal foi preparado corretamente usando --prepareStandbyBlob
e, em seguida, use --standbyBlobFromPrimary
para aplicá-lo no banco de dados stand-by.
P: Posso executar o comando dbaascli tde rotateMasterKey enquanto o banco de dados está em execução?
R: Sim, o comando pode ser executado enquanto o banco de dados está em execução. No entanto, é recomendável executar verificações de pré-requisitos de antemão usando a opção --executePrereqs
.
P: Por que girar a chave mestra é importante?
R: A rotação da chave mestra melhora a segurança do banco de dados, garantindo que as chaves de criptografia usadas para proteção de dados sejam atualizadas periodicamente, reduzindo o risco de comprometimento da chave.
P: Preciso reiniciar o banco de dados após rotacionar a chave mestra?
R: Não, a reinicialização do banco de dados não é necessária após a rotação da chave mestra. A rotação de chaves entrará em vigor imediatamente sem qualquer interrupção do serviço.
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
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>]
--kmsKeyVersionOCID
especifica o OCID da versão da chave KMS a ser definido.--dbname
especifica o nome do banco de dados.--pdbName
nome do PDB para usar o OCID da versão da chave.--masterKeyID
especifica o ID da chave principal do OCID da versão da chave informada. Isso se aplica ao ambiente do Data Guard.--standbySuc
especifica essa propriedade no banco de dados principal do ambiente do Data Guard quando o comando é executado com sucesso no banco de dados stand-by--executePrereqs
- execute as verificações de pré-requisitos e reporte os resultados.--waitForCompletion
especificafalse
para executar a operação em segundo plano. Valores válidos:true
|false
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli tde setKeyVersion?
R: O comando dbaascli tde setKeyVersion
é usado para definir a versão da chave de criptografia primária que deve ser usada para Criptografia Transparente de Dados (TDE) em um banco de dados ou Banco de Dados Plugável (PDB). Isso permite que a versão específica de uma chave KMS seja designada ao banco de dados.
P: Quais são os pré-requisitos para usar o comando dbaascli tde setKeyVersion?
R: Execute o comando como usuário root
e certifique-se de estar conectado a uma máquina virtual do Exadata Cloud@Customer.
P: O que o parâmetro --kmsKeyVersionOCID especifica?
A: O parâmetro --kmsKeyVersionOCID
especifica o OCID (Oracle Cloud Identifier) da versão da chave KMS que você deseja definir para o banco de dados ou o PDB.
P: O que o parâmetro --dbname especifica?
A: O parâmetro --dbname
especifica o nome do Oracle Database para o qual a versão da chave será definida.
P: Qual é a finalidade do parâmetro --pdbName?
R: O parâmetro --pdbName
especifica o nome do PDB (Banco de Dados Plugável) em um CDB (Banco de Dados Contêiner) no qual você deseja definir a versão da chave KMS específica.
P: Para que o parâmetro --masterKeyID é usado?
A: O parâmetro --masterKeyID
especifica o ID da chave principal que está associado ao OCID da versão da chave KMS informada. Isso é particularmente importante em um ambiente do Data Guard.
P: Qual é a atribuição do parâmetro --standbySuc?
A: O parâmetro --standbySuc
é usado em um ambiente do Data Guard. Especifica que essa propriedade deve ser definida no banco de dados principal após a execução bem-sucedida do comando no banco de dados stand-by.
P: O que o parâmetro --executePrereqs faz?
R: O parâmetro --executePrereqs
especifica se as verificações de pré-requisitos devem ser executadas antes da execução da operação. Os valores válidos são yes
ou no
.
P: O que o parâmetro --waitForCompletion controla?
R: O parâmetro --waitForCompletion
determina se a operação será executada de forma síncrona (aguardando conclusão) ou assíncrona (em segundo plano). Os valores válidos são true
ou false
.
P: O parâmetro --pdbName é necessário se a versão da chave for definida para um CDB?
R: Não, o parâmetro --pdbName
só será necessário se você estiver definindo a versão da chave para um PDB (Banco de Dados Plugável) específico. É opcional se você estiver definindo a versão da chave para todo o Banco de Dados Contêiner (CDB).
P: O parâmetro --masterKeyID é necessário para ambientes que não são do Data Guard?
R: Não, o parâmetro --masterKeyID
geralmente só é usado em ambientes do Data Guard. Para bancos de dados independentes, esse parâmetro não é necessário.
P: Como defino a versão da chave para um banco de dados?
A: Você pode definir a versão da chave para um banco de dados executando:
dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME>
P: Como defino a versão da chave para um PDB específico?
A: Para definir a versão da chave para um PDB (Banco de Dados Plugável) específico, use o parâmetro --pdbName
com o nome do banco de dados:
dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME> --pdbName <PDB_NAME>
P: Como posso garantir que todos os pré-requisitos sejam atendidos antes de definir a versão da chave?
A: Você pode executar as verificações de pré-requisitos usando o parâmetro --executePrereqs
:
dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --executePrereqs yes
P: Como defino a versão da chave em um ambiente do Data Guard?
- 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
--executePrereqs
para garantir a prontidão. Revise os logs de erro para obter detalhes específicos e execute novamente a operação, se necessário.
P: O que devo verificar se a operação não foi concluída com sucesso em um ambiente do Data Guard?
R: Certifique-se de que o parâmetro --masterKeyID
esteja especificado corretamente ao executar o comando no banco de dados stand-by. Uma vez concluído no stand-by, o parâmetro --standbySuc
deverá ser usado ao executar o comando no banco de dados principal.
P: Posso executar o comando dbaascli tde setKeyVersion enquanto o banco de dados está em execução?
R: Sim, o comando pode ser executado enquanto o banco de dados está em execução. No entanto, é recomendável executar as verificações de pré-requisitos antecipadamente usando --executePrereqs
.
P: Por que é importante definir a versão correta da chave KMS para um banco de dados?
A definição da versão correta da chave KMS garante que o banco de dados esteja usando a versão apropriada da chave de criptografia para TDE, o que ajuda a manter a segurança dos dados e a conformidade com as políticas organizacionais.
P: O que acontece se eu usar o OCID errado da versão da chave KMS?
R: Se um OCID incorreto da versão da chave KMS for usado, a criptografia poderá falhar e o banco de dados não poderá usar a chave incorreta para operações de criptografia. Certifique-se de que o OCID correto da versão da chave seja fornecido.
P: Preciso reiniciar o banco de dados após definir a versão da chave?
R: Não, a reinicialização do banco de dados não é necessária após definir a versão da chave. A nova versão da chave entrará em vigor imediatamente sem exigir uma reinicialização.
Exemplo 7-53 dbaascli tde setKeyVersion
dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha --executePrereqs
dbaascli tde setKeyVersion --dbname dbname --pdbName pdb --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
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>]]
--primaryKmsKeyOCID
especifica a chave KMS primária a ser definida--dbname
especifica o nome do banco de dados--allStandbyPrepared
- especifique para confirmar se a operação foi executada com sucesso em todos os bancos de dados stand-by.--bounceDatabase
especifica este flag para fazer bounce do banco de dados incremental para esta operação--executePrereqs
- execute as verificações de pré-requisitos e reporte os resultados.--resume
para retomar a execução anterior-
--sessionID
para retomar um id de sessão específico.
Perguntas Frequentes
P: Qual é a finalidade do comando dbaascli tde setPrimaryHsmKey?
R: O comando dbaascli tde setPrimaryHsmKey
é usado para alterar a chave primária do HSM (Hardware Security Module) ou KMS (Key Management Service) em uma configuração existente do HSM/KMS para TDE (Transparent Data Encryption).
P: Quais são os pré-requisitos para executar o comando dbaascli tde setPrimaryHsmKey?
R: O comando deve ser executado como o usuário root
e o ambiente deve ser uma máquina virtual do Exadata Cloud@Customer.
P: O que o parâmetro --primaryKmsKeyOCID especifica?
A: O parâmetro --primaryKmsKeyOCID
especifica o OCID (Oracle Cloud Identifier) da chave KMS principal a ser definida para o ambiente de TDE.
P: Qual é a função do parâmetro --dbname?
A: O parâmetro --dbname
especifica o nome do Oracle Database para o qual a chave principal do HSM/KMS será definida.
P: O que o parâmetro --standbySuc faz?
A: O parâmetro --standbySuc
é usado em um ambiente do Data Guard. Ele especifica que o comando deve ser executado no banco de dados principal após sua execução com sucesso no banco de dados stand-by.
P: Qual é a finalidade do parâmetro --precheckOnly?
R: O parâmetro --precheckOnly
permite que você execute somente as pré-verificações para esta operação. Ele valida o ambiente sem fazer alterações reais. Os valores válidos são yes
ou no
.
P: O que o parâmetro --bounceDatabase controla?
R: O parâmetro --bounceDatabase
especifica se o banco de dados deve ser devolvido (reiniciado) de maneira incremental como parte da operação. Isso garante um tempo de inatividade mínimo reiniciando partes do banco de dados uma a uma.
P: Como defino a chave KMS principal do meu banco de dados?
A: Para definir a chave KMS primária, execute o seguinte comando:
dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME>
P: Como posso garantir que a operação possa ser executada sem problemas?
A: Execute a operação com o parâmetro --precheckOnly
para verificar se todos os pré-requisitos foram atendidos:
dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --precheckOnly yes
P: Como defino a chave KMS principal em um ambiente do Data Guard?
A: Primeiro, execute o comando no banco de dados stand-by:
dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME>
Em seguida, execute o comando no banco de dados principal com o parâmetro --standbySuc
:
dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME> --standbySuc yes
P: Como minimizo o tempo de inatividade ao alterar a chave KMS principal?
A: Você pode usar o parâmetro --bounceDatabase
para executar uma reinicialização incremental, minimizando o tempo de inatividade:
dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --bounceDatabase
P: O parâmetro --dbname é necessário para todos os bancos de dados?
R: Sim, você deve especificar o parâmetro --dbname
para indicar o banco de dados de destino para o qual a chave KMS principal deve ser definida.
P: É obrigatório usar o parâmetro --standbySuc em um ambiente do Data Guard?
R: Sim, o parâmetro --standbySuc
deve ser usado ao executar o comando no banco de dados principal após executá-lo com sucesso no banco de dados stand-by.
P: Posso ignorar a operação de bounce do banco de dados?
R: Sim, se você não especificar o parâmetro --bounceDatabase
, o banco de dados não será devolvido (reiniciado) como parte da operação.
P: O que devo fazer se o comando falhar durante a execução?
- Você o está executando como o usuário
root
. - Os valores
--primaryKmsKeyOCID
e--dbname
corretos são fornecidos. - O ambiente passa por todas as verificações de pré-requisitos (executado com
--precheckOnly
).
P: E se a operação falhar em um ambiente do Data Guard?
R: Certifique-se de que o comando tenha sido executado com sucesso no banco de dados stand-by antes de executá-lo no principal. Verifique se há erros nos logs e execute novamente a operação com os parâmetros corretos.
P: Posso executar o comando dbaascli tde setPrimaryHsmKey em um banco de dados ativo?
R: Sim, o comando pode ser executado enquanto o banco de dados estiver ativo. No entanto, o uso do parâmetro --bounceDatabase
reiniciará o banco de dados de forma incremental, o que minimiza o impacto.
P: Como faço para executar o comando de forma contínua para evitar tempo de inatividade completo?
A: Use o parâmetro --bounceDatabase
para executar uma reinicialização incremental do banco de dados ao alterar a chave KMS principal:
dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --bounceDatabase
P: Qual é o significado de alterar a chave KMS primária?
R: A alteração da chave KMS principal garante que o banco de dados use uma chave de criptografia atualizada ou diferente para TDE (Transparent Data Encryption). Isso pode ser necessário por motivos de segurança ou conformidade.
P: Com que frequência a chave KMS primária deve ser girada ou alterada?
R: Embora não haja uma regra estrita, as organizações podem rotacionar a chave KMS principal com base em políticas de segurança, como intervalos de rotação de chaves ou requisitos de conformidade.
P: O que acontece se a chave KMS principal estiver definida incorretamente?
R: Se o OCID da chave incorreta for definido, as operações de criptografia do banco de dados poderão falhar e talvez você precise reverter para a chave correta ou retificar a configuração definindo o OCID da chave KMS correta.
P: Preciso reiniciar o banco de dados depois de alterar a chave KMS principal?
R: Não, você não precisa reiniciar o banco de dados, a menos que opte por usar o parâmetro --bounceDatabase
, que reiniciará automaticamente o banco de dados para aplicar a alteração.
Exemplo 7-54 dbaascli tde setPrimaryHsmKey
dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
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
--dbname
especifica o nome do banco de dados que você deseja verificar.
A saída do comando inclui o tipo e o status do armazenamento de chaves.
Perguntas Frequentes
P: O que o comando dbaascli tde status faz?
R: O comando dbaascli tde status
exibe informações sobre o armazenamento de chaves de um banco de dados especificado. Isso inclui detalhes sobre o tipo de armazenamento de chaves e seu status.
P: Quem deve executar o comando dbaascli tde status?
A: O comando deve ser executado como o usuário oracle
.
P: Onde o comando dbaascli tde status deve ser executado?
R: O comando deve ser executado em uma máquina virtual do Exadata Cloud@Customer. Você deve se conectar à máquina virtual via SSH para executar o utilitário.
P: Qual é a função do parâmetro --dbname?
R: O parâmetro --dbname
especifica o nome do banco de dados para o qual o status da área de armazenamento de chaves de TDE será verificado.
P: Quais informações o comando dbaascli tde status retorna?
A: A saída do comando inclui o tipo de armazenamento de chaves (por exemplo, baseado em HSM ou baseado em arquivo) e o status atual do armazenamento de chaves, como se ele está aberto, fechado ou em algum outro estado.
P: Como posso saber se a área de armazenamento de chaves está aberta ou fechada usando o comando dbaascli tde status?
R: O status da área de armazenamento de chaves, incluindo se ela está aberta ou fechada, faz parte da saída retornada pelo comando dbaascli tde status
.
P: Como verifico o status do armazenamento de chaves de TDE de um banco de dados específico?
A: Para verificar o status da área de armazenamento de chaves de TDE para um banco de dados específico, execute:
dbaascli tde status --dbname <DB_NAME>
P: Posso verificar o status da área de armazenamento de chaves para vários bancos de dados?
R: Sim, mas você precisa executar o comando separadamente para cada banco de dados, especificando seu nome usando o parâmetro --dbname
.
P: O comando dbaascli tde status pode ser executado como usuário raiz?
R: Não, o comando deve ser executado como o usuário oracle
, não como o usuário root
.
P: Preciso de permissões especiais para executar o comando dbaascli tde status?
R: Sim, você precisa ter privilégios de usuário oracle e estar conectado a uma máquina virtual do Exadata Cloud@Customer para executar o comando.
P: O que devo fazer se obtiver um erro ao executar o comando de status dbaascli tde?
R: Certifique-se de que esteja executando o comando como o usuário oracle
e verifique se você tem as permissões necessárias e se está conectado à máquina virtual correta.
P: Como sei que tipo de armazenamento de chaves meu banco de dados está usando?
R: O tipo de armazenamento de chaves, como se fosse baseado em arquivo ou HSM/KMS, é exibido na saída do comando dbaascli tde status
.
P: O que devo fazer se a área de armazenamento de chaves estiver fechada?
R: Se a área de armazenamento de chaves estiver fechada, talvez seja necessário abri-la manualmente, dependendo da operação que você está tentando executar. O processo exato dependerá do tipo de armazenamento de chaves e do seu ambiente.
P: Posso exibir o status da área de armazenamento de chaves de um CDB (Banco de Dados Contêiner) ou PDB (Banco de Dados Plugável)?
R: Sim, especificando o nome do banco de dados apropriado usando o parâmetro --dbname
, você pode exibir o status do armazenamento de chaves para CDBs e PDBs.
P: O que significa se o comando retornar um erro sobre a conectividade do banco de dados?
R: Isso pode indicar um problema com a conexão com o banco de dados ou um problema com seu ambiente. Certifique-se de que o banco de dados esteja em execução e acessível e verifique sua conexão SSH com a máquina virtual do Exadata Cloud@Customer.
P: O que acontece se o nome do banco de dados estiver incorreto?
R: Se o parâmetro --dbname
especificar um banco de dados incorreto ou não existente, o comando falhará e você receberá uma mensagem de erro indicando o problema.
P: Como solucionar problemas se o status da área de armazenamento de chaves indicar um estado inesperado?
R: Se o status da área de armazenamento de chaves indicar um estado inesperado, revise os logs do banco de dados para obter mais detalhes e verifique a configuração da área de armazenamento de chaves para garantir que ela esteja configurada corretamente.
P: Posso automatizar a verificação do status da área de armazenamento de chaves para fins de monitoramento?
R: Sim, você pode criar script do comando dbaascli tde status
para verificar o status do armazenamento de chaves periodicamente ou integrá-lo às suas ferramentas de monitoramento de banco de dados.
P: Como verifico se a Criptografia Transparente de Dados (TDE) está ativada corretamente?
R: Você pode verificar se a TDE está ativada corretamente verificando o status do armazenamento de chaves usando o comando dbaascli tde status
. Uma área de armazenamento de chaves válida e aberta indica que a TDE está configurada corretamente.
Exemplo 7-55 status dbaascli tde
dbaascli tde status --dbname dbname
Tópico principal: Gerenciamento Transparente de Criptografia de Dados (TDE)
Comandos dbaascli obsoletos
Os comandos dbaascli patch db prereq
e dbaascli patch db apply
foram descontinuados na release 21.2.1.2.0 do dbaascli
e substituídos por dbaascli grid patch
, dbaascli dbhome patch
e dbaascli database move
.
- dbaascli patch db apply
- dbaascli patch db prereq
- dbaascli tde status
Para exibir informações sobre o armazenamento de chaves do banco de dados especificado, use o comandodbaascli tde status
.
Tópico principal: Referência de Comando do dbaascli
dbaascli patch db apply
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 patch
dbaascli dbhome patch
dbaascli database move
- Aplicando Patch no Oracle Grid Infrastructure e em Bancos de Dados Oracle com o Utilitário dbaascli
dbaascli patch db prereq
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 patch
dbaascli dbhome patch
dbaascli database move
- Aplicando Patch no Oracle Grid Infrastructure e em Bancos de Dados Oracle com o Utilitário dbaascli
dbaascli tde status
Para exibir informações sobre o armazenamento de chaves do banco de dados especificado, use o comando dbaascli tde status
.
Pré-Requisito
Execute o comando como usuário oracle
.
Sintaxe
dbaascli tde status --dbname dbname
--dbname
especifica o nome do banco de dados que você deseja verificar.
A saída do comando inclui o tipo e o status do armazenamento de chaves.
Perguntas Frequentes
P: O que o comando dbaascli tde status faz?
R: O comando dbaascli tde status
exibe informações sobre o armazenamento de chaves de um banco de dados especificado. Isso inclui detalhes sobre o tipo de armazenamento de chaves e seu status.
P: Quem deve executar o comando dbaascli tde status?
A: O comando deve ser executado como o usuário oracle
.
P: Onde o comando dbaascli tde status deve ser executado?
R: O comando deve ser executado em uma máquina virtual do Exadata Cloud@Customer. Você deve se conectar à máquina virtual via SSH para executar o utilitário.
P: Qual é a função do parâmetro --dbname?
R: O parâmetro --dbname
especifica o nome do banco de dados para o qual o status da área de armazenamento de chaves de TDE será verificado.
P: Quais informações o comando dbaascli tde status retorna?
A: A saída do comando inclui o tipo de armazenamento de chaves (por exemplo, baseado em HSM ou baseado em arquivo) e o status atual do armazenamento de chaves, como se ele está aberto, fechado ou em algum outro estado.
P: Como posso saber se a área de armazenamento de chaves está aberta ou fechada usando o comando dbaascli tde status?
R: O status da área de armazenamento de chaves, incluindo se ela está aberta ou fechada, faz parte da saída retornada pelo comando dbaascli tde status
.
P: Como verifico o status do armazenamento de chaves de TDE de um banco de dados específico?
A: Para verificar o status da área de armazenamento de chaves de TDE para um banco de dados específico, execute:
dbaascli tde status --dbname <DB_NAME>
P: Posso verificar o status da área de armazenamento de chaves para vários bancos de dados?
R: Sim, mas você precisa executar o comando separadamente para cada banco de dados, especificando seu nome usando o parâmetro --dbname
.
P: O comando dbaascli tde status pode ser executado como usuário raiz?
R: Não, o comando deve ser executado como o usuário oracle
, não como o usuário root
.
P: Preciso de permissões especiais para executar o comando dbaascli tde status?
R: Sim, você precisa ter privilégios de usuário oracle e estar conectado a uma máquina virtual do Exadata Cloud@Customer para executar o comando.
P: O que devo fazer se obtiver um erro ao executar o comando de status dbaascli tde?
R: Certifique-se de que esteja executando o comando como o usuário oracle
e verifique se você tem as permissões necessárias e se está conectado à máquina virtual correta.
P: Como sei que tipo de armazenamento de chaves meu banco de dados está usando?
R: O tipo de armazenamento de chaves, como se fosse baseado em arquivo ou HSM/KMS, é exibido na saída do comando dbaascli tde status
.
P: O que devo fazer se a área de armazenamento de chaves estiver fechada?
R: Se a área de armazenamento de chaves estiver fechada, talvez seja necessário abri-la manualmente, dependendo da operação que você está tentando executar. O processo exato dependerá do tipo de armazenamento de chaves e do seu ambiente.
P: Posso exibir o status da área de armazenamento de chaves de um CDB (Banco de Dados Contêiner) ou PDB (Banco de Dados Plugável)?
R: Sim, especificando o nome do banco de dados apropriado usando o parâmetro --dbname
, você pode exibir o status do armazenamento de chaves para CDBs e PDBs.
P: O que significa se o comando retornar um erro sobre a conectividade do banco de dados?
R: Isso pode indicar um problema com a conexão com o banco de dados ou um problema com seu ambiente. Certifique-se de que o banco de dados esteja em execução e acessível e verifique sua conexão SSH com a máquina virtual do Exadata Cloud@Customer.
P: O que acontece se o nome do banco de dados estiver incorreto?
R: Se o parâmetro --dbname
especificar um banco de dados incorreto ou não existente, o comando falhará e você receberá uma mensagem de erro indicando o problema.
P: Como solucionar problemas se o status da área de armazenamento de chaves indicar um estado inesperado?
R: Se o status da área de armazenamento de chaves indicar um estado inesperado, revise os logs do banco de dados para obter mais detalhes e verifique a configuração da área de armazenamento de chaves para garantir que ela esteja configurada corretamente.
P: Posso automatizar a verificação do status da área de armazenamento de chaves para fins de monitoramento?
R: Sim, você pode criar script do comando dbaascli tde status
para verificar o status do armazenamento de chaves periodicamente ou integrá-lo às suas ferramentas de monitoramento de banco de dados.
P: Como verifico se a Criptografia Transparente de Dados (TDE) está ativada corretamente?
R: Você pode verificar se a TDE está ativada corretamente verificando o status do armazenamento de chaves usando o comando dbaascli tde status
. Uma área de armazenamento de chaves válida e aberta indica que a TDE está configurada corretamente.
Exemplo 7-56 status dbaascli tde
dbaascli tde status --dbname dbname
Tópico principal: Comandos dbaascli obsoletos