Gerenciamento do Data Guard

Esta seção se concentra no gerenciamento de configurações e operações do Oracle Data Guard. Inclui comandos como dbaascli dataguard prepareStandbyBlob para gerar um arquivo blob para configurar um site stand-by e dbaascli dataguard updateDGConfigAttributes para atualizar os 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
dbaascli dataguard updateDGConfigAttributes
dbaascli dataguard failover
dbaascli dataguard reintegrado
dbaascli dataguard switchover
dbaascli dataguard prepareForStandby
dbaascli dataguard configureStandby
dbaascli dataguard registerStandby
dbaascli dataguard deregisterStandby
dbaascli dataguard configureAWR
dbaascli dataguard updateConfiguration

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>

Parâmetros:

Parâmetro	Descrição
`--dbname`	especifica o nome do Oracle AI Database
`--blobLocation`	especifica o local de diretório personalizado no qual o arquivo blob stand-by será gerado em um ambiente Data Guard

Perguntas Frequentes:

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

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

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

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

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

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

--dbname myDatabase

P: Como eu especifico 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?

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

P: Qual é a finalidade da opção –blobLocation?

R: 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 um usuário diferente de root ou 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: É recomendável usar um caminho absoluto para a opção --blobLocation para garantir que o arquivo blob stand-by seja criado no diretório necessário.

P: O que devo fazer se eu quiser alterar o local onde o arquivo blob stand-by é gerado?

R: 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 depois de gerar o arquivo blob stand-by?

R: Sim, depois de gerar o arquivo blob stand-by, você precisa transferi-lo para o site stand-by e usá-lo para a configuração do Data Guard.

dbaascli dataguard updateDGConfigAttributes

Para atualizar os atributos de automação do Data Guard em todos os nós do cluster, use o comando dbaascli dataguard updateDGConfigAttributes.

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

Sintaxe:

dbaascli dataguard updateDGConfigAttributes --attributes <value>

Parâmetros:

Parâmetro	Descrição
`--attributes`	contém os atributos do Data Guard que serão modificados. Aceita valores delimitados por vírgulas no formato `<attribute=value>`. Os atributos devem ser predefinidos no arquivo de configuração do Data Guard.

Perguntas Frequentes:

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

R: O comando dbaascli dataguard updateDGConfigAttributes é usado para atualizar 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?

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

P: Como eu especifico os atributos que quero 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 é 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 estejam 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, não é necessário reiniciar os serviços após a atualização dos 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: Depois de 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 para 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 atributos válidos 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 somente 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 você precisar atualizar atributos para nós específicos, talvez seja necessário usar diferentes métodos ou comandos.

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

Parâmetros:

Parâmetro	Descrição
`--dbname`	especifica o nome do Oracle AI Database.
`--useImmediateFailover`	use este flag quando a configuração do Oracle Data Guard estiver em um estado de advertência ou erro.
`--executePrereqs`	executa as verificações de pré-requisito e reporta os resultados.
`--waitForCompletion`	especifica se a operação deve ser concluída. Defina como `false` para executar a operação em segundo plano. Valores válidos: `true` ou `false`.
`--resume`	retoma a operação anterior.
`--sessionID`	retoma uma sessão específica por seu ID.

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

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

Estabeleça conexão com a máquina virtual na configuração do Oracle Data Guard que hospedará o novo banco de dados principal como o usuário opc.

Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.
Inicie um shell de comando do usuário raiz e alterne para o usuário oracle:
```
$ sudo -s
# su - oracle
$
```
Inicie o failover para o Banco de Dados stand-by.
```
$ dbaascli dataguard failover --dbname <db-name>
```
Retorne para ser o usuário root.
```
$ exit
#
```
Desconecte-se da máquina virtual e saia do shell do comando root-user.
```
# exit
$ exit
```

dbaascli dataguard reintegrado

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

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

Sintaxe:

dbaascli dataguard reinstate --dbname <value> [--primaryDBUniqueName <value>] [--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]]

Parâmetros:

Parâmetro	Descrição
`--dbname`	especifica o nome do Oracle AI Database.
`--primaryDBUniqueName`	especifica o nome exclusivo do banco de dados principal atual na configuração do Oracle Data Guard.
`--executePrereqs`	executa as verificações de pré-requisito e reporta os resultados.
`--waitForCompletion`	especifica se deseja aguardar a conclusão da operação. Defina como `false` para executar a operação no segundo plano. Valores válidos: `true` ou `false`.
`--resume`	retoma a operação anterior.
`--sessionID`	retoma uma sessão específica por seu ID.

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

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

No novo cluster principal:

ORA-16661: O banco de dados stand-by deve ser reintegrado
No cluster principal antigo:

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

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

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

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

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

Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.
Inicie a reintegração do banco de dados principal com falha.
```
$ dbaascli dataguard reinstate --dbname <db-name>
```
Em uma configuração stand-by múltipla (grupo do Data Guard), é recomendável especificar o argumento --primaryDBUniqueName.
```
dbaascli dataguard reinstate --dbname <db-name> --primaryDBUniqueName <primary-DB-unique-name>
```
Desconecte da máquina virtual.
```
$ exit
```

dbaascli dataguard switchover

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

Execute este comando como o usuário oracle.

Sintaxe:

dbaascli dataguard switchover --dbname <value> [--targetStandbyDBUniqueName <value>] [--executePrereqs] [--enableDGDebug] [--waitForCompletion <value>] [--resume [--sessionID <value>]]

Parâmetros:

Parâmetro	Descrição
`--dbname`	especifica o nome do Oracle AI Database.
`--targetStandbyDBUniqueName`	especifica o nome exclusivo de banco de dado stand-by para alterar a atribuição de banco de dado stand-by para principal.
`--executePrereqs`	executa as verificações de pré-requisito e reporta os resultados.
`--enableDGDebug`	ativa os rastreamentos ao executar a operação.
`--waitForCompletion`	especifica se a operação deve ser concluída. Defina como `false` para executar a operação em segundo plano. Valores válidos: `true` ou `false`.
`--resume`	retoma a operação anterior.
`--sessionID`	retoma uma sessão específica por seu ID.

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

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

Estabeleça conexão com a máquina virtual na configuração do Oracle Data Guard que hospedará o novo banco de dados principal como o usuário opc.

Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.
Inicie um shell de comando do usuário raiz e alterne para o usuário oracle.
```
$ sudo -s
# su - oracle
$
```
Inicie o switchover para o Banco de Dados stand-by.
```
$ dbaascli dataguard switchover --dbname <db-name>
```
Em uma configuração stand-by múltipla (grupo do Data Guard), é recomendável especificar o argumento --targetStandbyDBUniqueName.
```
dbaascli dataguard switchover --dbname <db-name> --targetStandbyDBUniqueName <target-standby-DB-unique-name>
```
Retorne para ser o usuário root.
```
$ exit
#
```
Saia do shell do comando root-user e desconecte-se da máquina virtual.
```
# exit
$ exit
```

dbaascli dataguard prepareForStandby

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

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

Observação: Para configurações de DR (Recuperação de Desastre) no Oracle Base Database Cloud@Customer, 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]

Parâmetros:

Parâmetro	Descrição
`--dbname`	especifica o nome do Oracle AI Database.
`--standbyDBUniqueName`	especifica o nome exclusivo de banco de dados stand-by para o qual o banco de dados principal será configurado.
`--standbyDBDomain`	especifica o domínio do banco de dados stand-by para o qual o banco de dados principal será configurado.
`--noDBDomain`	especifica para não usar o nome de 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 standby.
`--standbyScanPort`	especifica o número de porta SCAN correspondente do banco do dados stand-by.
`--standbyServiceName`	especifica o nome do Serviço de Banco de Dados Stand-by para o qual o Banco de Dados 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 SCAN do banco principal.
`--primaryScanPort`	especifica o número de porta do SCAN correspondente do banco de dados principal.
`--executePrereqs`	executa as verificações de pré-requisito e reporta os resultados.
`--resume`	retoma a operação anterior.
`--sessionID`	retoma uma sessão específica por seu ID.
`--revert`	faz rollback da operação anterior.
`--waitForCompletion`	especifica se deseja aguardar a conclusão da operação. Defina como `false` para executar a operação em segundo plano. Valores válidos: `true` ou `false`.
`--skipDRConfiguration`	especifica se a configuração de DR (Recuperação de Desastre) deve ser ignorada como parte da configuração do banco de dados stand-by. Valores válidos: `true` (ignorar configuração de DR) ou `false` (configurar DR).

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

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

Estabeleça conexão com a Máquina Virtual na qual você deseja hospedar o banco de dados principal como o usuário opc.

Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.
Inicie um shell de comando do usuário raiz.
```
$ sudo -s
```

Execute o comando prepareForStandby. Informe a senha SYS quando solicitado.

dbaascli dataguard prepareForStandby --dbName <db name> --standbyDBUniqueName <standby db unique name> --standbyDBDomain <standby db domain> --standbyScanIPAddresses  <comma-delimieted list of standby SCAN IP addresses> --primaryScanIPAddresses <comma-delimited list of primary SCAN IP addresses> --standbyScanPort <standby SCAN listener port>

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

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

dbaascli dataguard configureStandby

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

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

Sintaxe:

dbaascli dataguard configureStandby --dbname <value>  --oracleHome <value> | --oracleHomeName <value> --standbyDBUniqueName <value> [--standbyDBDomain <value>] | [--noDBDomain] --primaryScanIPAddresses <value> --primaryScanPort <value> --primaryServiceName <value> --protectionMode <value> --transportType <value> --activeDG <value> [--standbyBlobFromPrimary <value>] | [--standbyDBInfoJsonLocation <value>] [--standbyScanIPAddresses <value>] [--standbyScanPort <value>] [--standbySID <value>] [--nodeList <value>] [--skipAWRConfiguration] [--primaryDBOCID <value>] [--sgaSizeInMB <value>] [--pgaSizeInMB <value>] [--datafileDestination <value>] [--fraDestination <value>] [--redoLogDestination <value>] [--fraSizeInMB <value>] [--tdeKeyStoreType <value> [--tdeKeyOCID <value>]] [--tdeKeyOCID <value>] [--executePrereqs]  [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]] --waitForCompletion <value>] [--enableFIPS <value>] [--skipDRConfiguration] [--okvServer <value> --okvAdminUserName <value> [--okvServerRestPort <value>]] [--okvWalletName <value>]

Parâmetros:

Parâmetro	Descrição
`--dbname`	especifica o nome do Oracle AI Database.
`--oracleHome`	especifica o caminho do 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 do banco de dados stand-by para o qual o banco de dados principal será configurado.
`--noDBDomain`	especifica para não usar o nome de 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 SCAN do banco principal.
`--primaryScanPort`	especifica o número de porta SCAN correspondente ao serviço de banco da dados principal.
`--primaryServiceName`	especifica o nome do principal serviço de bancos de dados para o qual o stand-by será configurado.
`--protectionMode`	especifica o modo da proteção de Data Guard a ser definido ao configurar o banco de dados stand-by. Valores válidos: `MAX_PERFORMANCE` ou `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` ou `SYNC`.
`--activeDG`	especifica se a configuração de Data Guard estará ativa ou não. Valores válidos: `true` ou `false`.
`--standbyBlobFromPrimary`	especifica o local do arquivo BLOB stand-by, que é preparado com base no 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 standby.
`--standbyScanPort`	especifica o número de porta SCAN correspondente do banco do dados stand-by.
`--standbySID`	especifica o SID de banco de dados stand-by para configuração stand-by.
`--nodeList`	especifica uma lista de nós em que o banco de dados stand-by deve ser executado, incluindo nós que já estão em execução ou configurados.
`--skipAWRConfiguration`	especifica se a configuração do Oracle AWR deve ser ignorada como parte da configuração do banco de dados stand-by. Valores válidos: `true` (ignorar configuração do AWR) ou `false` (configurar AWR).
`--primaryDBOCID`	especifica o valor do OCID do recurso correspondente ao banco de dados principal.
`--sgaSizeInMB`	especifica o valor `sga_target` em MB.
`--pgaSizeInMB`	especifica o valor `pga_aggregate_target` em 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 do espaço de recuperação rápida em MB.
`--tdeKeyStoreType`	especifica o tipo de armazenamento de chaves TDE. Valores válidos: `FILE`, `KMS`, `AZURE`, `GOOGLE`, `AWS` ou `OKV`
`--tdeKeyOCID`	especifica o OCID da chave `KMS`/`AZURE`/`GOOGLE`/`AWS` a ser usado para TDE. Isso só será aplicável se `KMS`/`AZURE`/`GOOGLE`/`AWS` estiver selecionado para o tipo de armazenamento de chaves TDE.
`--executePrereqs`	executa as verificações de pré-requisito e reporta os resultados.
`--resume`	retoma a operação anterior.
`--sessionID`	retoma uma sessão específica por seu ID.
`--revert`	faz rollback da operação anterior.
`--waitForCompletion`	especifica se deseja aguardar a conclusão da operação. Defina como `false` para executar a operação no segundo plano. Valores válidos: `true` ou `false`.
`--enableFIPS`	especifica se o FIPS deve ser ativado. Defina como `false` para desativá-lo. Valores válidos: `true` ou `false`.
`--skipDRConfiguration`	especifica se a configuração de DR (Recuperação de Desastre) deve ser ignorada como parte da configuração do banco de dados stand-by. Valores válidos: `true` (ignorar configuração de DR) ou `false` (configurar DR).
`--okvServer`	especifica o servidor do Oracle Key Vault. Lista delimitada por vírgulas de vários endereços IP.
`--okvAdminUserName`	especifica o nome de usuário admin do Oracle Key Vault.
`--okvServerRestPort`	especifica o número de porta REST do Oracle Key Vault.
`--okvWalletName`	especifica o nome do Oracle Key Vault wallet.

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

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

Estabeleça conexão com a Máquina Virtual na qual você deseja hospedar o banco de dados stand-by como o usuário opc.

Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.
Inicie um shell de comando do usuário raiz.
```
$ sudo -s
```

Execute o comando configureStandby.

dbaascli dataguard configureStandby --standbySID <standby SID> --activeDG <true|false> --dbName <db name> --standbyDBUniqueName <standby db unique name> --standbyScanName <comma-delimited list of standby SCAN IP addresses> --protectionMode <MAX_PERFORMANCE|MAX_AVAILABILITY> --standbyScanPort <standby SCAN port> --oracleHome <oracle home path> --standbyDBDomain <standby db domain name>. --primaryServiceName <primary db service name> --transportType <ASYNC|SYNC> --primaryScanPort <primary db SCAN port> --primaryScanIPAddresses <comma-delimited list primary db SCAN IP addresses> --standbyBlobFromPrimary <standby BLOB from primary>

Informe as senhas do banco de dados principal SYS, TDE e AWR quando solicitado.

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

dbaascli dataguard registerStandby

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

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

Sintaxe:

dbaascli dataguard registerStandby --dbname <value> --standbyDBUniqueName <value>  --standbyDBDomain <value> | --noDBDomain --standbyScanIPAddresses <value> [--standbyScanPort <value>] [--standbyServiceName <value>] [--executePrereqs] [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]] [--waitForCompletion <value>]

Parâmetros:

Parâmetro	Descrição
`--dbname`	especifica o nome do Oracle AI Database.
`--standbyDBUniqueName`	especifica o nome exclusivo do banco da base de dados stand-by a ser registrado com a configuração do Oracle Data Guard Broker.
`--standbyDBDomain`	especifica o domínio do banco de dados stand-by para o qual o banco de dados principal será configurado.
`--noDBDomain`	especifica para não usar o nome de 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 standby.
`--standbyScanPort`	especifica o número de porta SCAN correspondente do banco do dados stand-by.
`--standbyServiceName`	especifica o nome do Serviço de Banco de Dados Stand-by para o qual o Banco de Dados 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 deseja aguardar a conclusão da operação. Defina como `false` para executar a operação no segundo plano. Valores válidos: `true` ou `false`.

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

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

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

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

Por exemplo, considere uma configuração com dois bancos de dados stand-by: stdby1 e stdby2, em que stdby2 é o novo stand-by a ser registrado. Nesse caso, execute o comando registerStandby no cluster primário e no stdby1, mas não em 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.

Estabeleça conexão com o cluster principal da configuração do Data Guard como o usuário opc.

Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.
Inicie um shell de comando do usuário raiz.
```
$ sudo -s
```
Execute o comando registerStandby.
```
dbaascli dataguard registerStandby --dbname <db-name> --standbyDBUniqueName <standby-DB-unique-name> --standbyDBDomain <standby-DB-domain>
```
Após a conclusão bem-sucedida do comando, o banco de dados stand-by especificado será registrado na configuração do Oracle Data Guard Broker.
Repita as etapas de 1 a 3, conforme executadas no cluster principal, em todos os clusters stand-by existentes na configuração do Oracle Data Guard Broker, exceto o que está sendo registrado.

dbaascli dataguard deregisterStandby

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

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

Sintaxe:

dbaascli dataguard deregisterStandby --dbname <value> --standbyDBUniqueName <value> [--executePrereqs] [--resume [--sessionID <value>]] [--waitForCompletion <value>]

Parâmetros:

Parâmetro	Descrição
`--dbname`	especifica o nome do Oracle AI Database.
`--standbyDBUniqueName`	especifica o nome exclusivo do banco da base de 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 a operação deve ser concluída. Defina como `false` para executar a operação em segundo plano. Valores válidos: `true` ou `false`.

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

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 stdby2 deve ser cancelado o registro. 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.

Estabeleça conexão com o cluster principal da configuração do Oracle Data Guard como o usuário opc.

Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.
Inicie um shell de comando do usuário raiz.
```
$ sudo -s
```
Execute o comando deregisterStandby.
```
dbaascli dataguard deregisterStandby --dbname <db-name> --standbyDBUniqueName <standby-DB-unique-name>
```
Após a conclusão bem-sucedida do comando, o banco de dados stand-by especificado será cancelado (removido) da configuração do Oracle Data Guard Broker.
Repita as etapas de 1 a 3, conforme executadas no cluster principal, em todos os clusters stand-by existentes na configuração do Oracle Data Guard Broker, exceto o que está sendo cancelado.

dbaascli dataguard configureAWR

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

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

Sintaxe:

dbaascli dataguard configureAWR --dbname <value> { --action <value> | --enable | --disable } [--executePrereqs] [--resume [--sessionID <value>]]

Parâmetros:

Parâmetro	Descrição
`--dbname`	especifica o nome do Oracle AI Database.
`--action`	especifica se o AWR deve ser ativado ou desativado. Use `--action enable` para ativar o AWR e `--action disable` para desativá-lo. O argumento `--action` é retido para compatibilidade com versões anteriores. No entanto, é recomendável usar `--enable` ou `--disable`, pois eles fornecem a mesma funcionalidade, mas são mais explícitos
`--executePrereqs`	executa as verificações de pré-requisito e reporta os resultados.
`--resume`	retoma a operação anterior.
`--sessionID`	retoma uma sessão específica por seu ID.

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

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

Conecte-se à Máquina Virtual na qual seu banco de dados stand-by do ADG está hospedado como usuário opc.

Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.
Inicie um shell de comando do usuário raiz.
```
$ sudo -s
```

Execute o comando configureAWR.

Para ativar o AWR, execute:

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

Para desativar o AWR, execute:

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

Informe as senhas SYS e AWR quando solicitado.

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

dbaascli dataguard updateConfiguration

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

Execute isso como o usuário root.

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

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

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

Sintaxe:

dbaascli dataguard updateConfiguration --dbname <value> [--protectionMode <value>] [--transportType <value>] [--standbyDGType <value>] [--executePrereqs] [--resume [--sessionID <value>]] [--waitForCompletion <value>]

Parâmetros:

Parâmetro	Descrição
`--dbname`	especifica o nome do Oracle AI Database.
`--protectionMode`	especifica o modo da proteção de Data Guard a ser definido ao configurar o banco de dados stand-by. Valores válidos: `MAX_PERFORMANCE` ou `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` ou `SYNC`.
`--standbyDGType`	especifica o tipo de Data Guard do banco de dados stand-by a ser definido. Valores válidos: `ADG` ou `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 a operação deve ser concluída. Defina como `false` para executar a operação em segundo plano. Valores válidos: `true` ou `false`.

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

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

Conecte-se à Máquina Virtual na qual seu banco de dados stand-by do ADG está hospedado como usuário opc.

Para obter instruções detalhadas, consulte Estabelecendo Conexão com uma Máquina Virtual usando SSH.
Inicie um shell de comando do usuário raiz.
```
$ sudo -s
```
Execute o comando updateConfiguration.
```
$ dbaascli dataguard updateConfiguration --dbname <db-name> --protectionMode MAX_PERFORMANCE|MAX_AVAILABILITY --transportType ASYNC|SYNC --standbyDGType ADG|DG.
```
Após a conclusão bem-sucedida do comando, o Data Guard especificado será configurado com o modo de transporte ou o modo de proteção especificados.