Gestión de Data Guard

Esta sección se centra en la gestión de las configuraciones y operaciones de Oracle Data Guard. Incluye comandos como dbaascli dataguard prepareStandbyBlob para generar un archivo blob para configurar una ubicación en espera y dbaascli dataguard updateDGConfigAttributes para actualizar los atributos de automatización de Data Guard en todos los nodos de cluster. Estos comandos optimizan la configuración y el mantenimiento de entornos de Data Guard para una alta disponibilidad y recuperación ante desastres.

dbaascli dataguard prepareStandbyBlob
dbaascli dataguard updateDGConfigAttributes
Failover de Data Guard de dbaascli
rehabilitación de dataguard dbaascli
switchover de dataguard dbaascli
dbaascli dataguard prepareForStandby
dbaascli dataguard configureStandby
dbaascli dataguard registerStandby
dbaascli dataguard deregisterStandby
dbaascli dataguard configureAWR
dbaascli dataguard updateConfiguration

dbaascli dataguard prepareStandbyBlob

Para generar un archivo blob que contenga varios archivos necesarios en el sitio de la base de datos en espera en el caso de un entorno de dataguard, utilice el comando dbaascli dataguard prepareStandbyBlob.

Ejecute el comando como usuario root o oracle.

Sintaxis:

dbaascli dataguard prepareStandbyBlob --dbname <value> --blobLocation <value>

Parámetros:

Parámetro	Descripción
`--dbname`	especifica el nombre de Oracle AI Database
`--blobLocation`	especifica la ubicación del directorio personalizado donde se generará el archivo BLOB de base de datos en espera en un entorno de Data Guard

Preguntas frecuentes:

P: ¿Cuál es la finalidad del comando dbaascli dataguard prepareStandbyBlob?

R: El comando dbaascli dataguard prepareStandbyBlob se utiliza para generar un archivo blob que contiene varios archivos necesarios en la ubicación en espera en un entorno de Data Guard.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli dataguard prepareStandbyBlob?

R: El comando se debe ejecutar como usuario root o oracle.

P: ¿Cómo puedo especificar el nombre de la base de datos Oracle AI Database para la que quiero preparar el blob en espera?

R: Utilice la opción --dbname seguida del nombre de Oracle AI Database. Por ejemplo:

--dbname myDatabase

P: ¿Cómo puedo especificar la ubicación en la que se generará el archivo BLOB en espera?

R: Utilice la opción --blobLocation para especificar la ruta de acceso del directorio personalizado en la que se generará el archivo blob en espera. Por ejemplo:

--blobLocation /path/to/standby_blob

P: ¿Qué hace la opción –dbname en el comando?

R: La opción --dbname especifica el nombre de la instancia de Oracle AI Database para la que se está preparando el archivo blob en espera.

P: ¿Cuál es el propósito de la opción –blobLocation?

R: La opción --blobLocation define la ruta de acceso del directorio personalizado en el que se creará el archivo blob en espera.

P: ¿Puedo ejecutar el comando dbaascli dataguard prepareStandbyBlob como un usuario que no sea root u oracle?

R: No, el comando se debe ejecutar como usuario root o oracle.

P: ¿Es posible utilizar una ruta relativa para la opción –blobLocation?

R: Se recomienda utilizar una ruta de acceso absoluta para la opción --blobLocation para asegurarse de que el archivo blob en espera se crea en el directorio necesario.

P: ¿Qué debo hacer si quiero cambiar la ubicación donde se genera el archivo blob en espera?

R: Modifique la opción --blobLocation para especificar una nueva ruta de acceso de directorio para el archivo blob en espera.

P: ¿Tengo que realizar algún paso adicional después de generar el archivo blob en espera?

R: Sí, después de generar el archivo blob en espera, debe transferirlo a la ubicación en espera y utilizarlo para la configuración de Data Guard.

dbaascli dataguard updateDGConfigAttributes

Para actualizar los atributos de automatización de Data Guard en todos los nodos de cluster, utilice el comando dbaascli dataguard updateDGConfigAttributes.

Ejecute el comando como usuario root u oracle.

Sintaxis:

dbaascli dataguard updateDGConfigAttributes --attributes <value>

Parámetros:

Parámetro	Descripción
`--attributes`	contiene los atributos que se van a modificar de automatización de Data Guard. Acepta valores delimitadas por comas con el formato `<attribute=value>`. Los atributos deben estar predefinidos en el archivo de configuración de Data Guard.

Preguntas frecuentes:

P: ¿Cuál es la finalidad del comando dbaascli dataguard updateDGConfigAttributes?

R: El comando dbaascli dataguard updateDGConfigAttributes se utiliza para actualizar los atributos de automatización de Data Guard en todos los nodos de cluster.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli dataguard updateDGConfigAttributes?

R: El comando se debe ejecutar como usuario root o oracle.

P: ¿Cómo puedo especificar los atributos que quiero actualizar con este comando?

R: Utilice la opción --attributes seguida de los atributos que se van a modificar. Los atributos deben tener un formato delimitado por comas, como attribute=value. Por ejemplo:

--attributes attribute1=value1,attribute2=value2

P: ¿En qué formato deben estar los valores de opción –attributes?

R: Los valores de la opción --attributes deben tener un formato delimitado por comas con cada atributo especificado como attribute=value.

P: ¿Puedo especificar varios atributos en la opción –attributes?

R: Sí, puede especificar varios atributos separándolos con comas. Por ejemplo:

--attributes attribute1=value1,attribute2=value2

P: ¿Qué sucede si proporciono un atributo que no está predefinido en el archivo de configuración de Data Guard?

R: Si proporciona un atributo que no está predefinido, el comando puede fallar o ignorar el atributo no reconocido. Asegúrese de que todos los atributos están predefinidos en el archivo de configuración de Data Guard.

P: ¿Necesito reiniciar algún servicio después de actualizar los atributos de automatización de Data Guard?

R: En la mayoría de los casos, no es necesario reiniciar los servicios después de actualizar los atributos. Sin embargo, compruebe los atributos específicos y su impacto para determinar si es necesario reiniciar.

P: ¿Cómo puedo verificar si los atributos de Data Guard se han actualizado correctamente?

R: Después de ejecutar el comando, puede verificar los atributos actualizados comprobando la configuración de Data Guard o utilizando los comandos/herramientas de verificación adecuados específicos de la configuración.

P: ¿Qué debo hacer si el comando no actualiza los atributos?

R: Compruebe los mensajes de error para obtener detalles sobre lo que salió mal. Asegúrese de que ha especificado atributos válidos y que están predefinidos en el archivo de configuración de Data Guard. Verifique los permisos de usuario y la sintaxis de los comandos.

P: ¿Es posible actualizar atributos solo para nodos específicos mediante este comando?

R: No, el comando dbaascli dataguard updateDGConfigAttributes actualiza los atributos en todos los nodos del cluster. Si necesita actualizar atributos para nodos específicos, puede que necesite utilizar diferentes métodos o comandos.

Failover de Data Guard de dbaascli

Para realizar un failover manual a la base de datos en espera, utilice el comando dataguard failover.

Ejecute este comando como el usuario oracle en la base de datos en espera de destino.

Sintaxis:

dbaascli dataguard failover --dbname <value> [--useImmediateFailover] [--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]]

Parámetros:

Parámetro	Descripción
`--dbname`	Especifica el nombre de Oracle AI Database.
`--useImmediateFailover`	utilice este indicador cuando la configuración de Oracle Data Guard tenga un estado de advertencia o error.
`--executePrereqs`	ejecuta las comprobaciones de requisitos y informa de los resultados.
`--waitForCompletion`	Especifica si se espera a que finalice la operación. Se define en `false` para que se ejecute la operación en segundo plano. Valores válidos: `true` o `false`.
`--resume`	reanuda la operación anterior.
`--sessionID`	reanuda una sesión específica por su ID.

Realización de una Operación de Failover Manual con la Utilidad dbaascli

Para realizar un failover manual a la base de datos en espera, utilice el comando dataguard failover.

Conéctese a la máquina virtual en la configuración de Oracle Data Guard que alojará la nueva base de datos primaria como usuario opc.

Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.
Inicie un shell de comandos de usuario root y, a continuación, cambie al usuario oracle:
```
$ sudo -s
# su - oracle
$
```
Inicie la operación de failover en la base datos en espera.
```
$ dbaascli dataguard failover --dbname <db-name>
```
Vuelva a ser el usuario root.
```
$ exit
#
```
Salga del Shell de comandos de usuario root y desconéctese de la máquina virtual.
```
# exit
$ exit
```

rehabilitación de dataguard dbaascli

Para volver a instanciar una base de datos fallida como base de datos en espera después de un failover, utilice el comando dataguard reinstate.

Ejecute este comando como usuario oracle en el que es necesario volver a instanciar (que es una base de datos en espera con fallos).

Sintaxis:

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

Parámetros:

Parámetro	Descripción
`--dbname`	Especifica el nombre de Oracle AI Database.
`--primaryDBUniqueName`	Especifica el nombre único de la base de datos primaria actual en la configuración de Oracle Data Guard.
`--executePrereqs`	ejecuta las comprobaciones de requisitos y informa de los resultados.
`--waitForCompletion`	Especifica si se espera a que finalice la operación. Se define en `false` para que se ejecute la operación en segundo plano. Valores válidos: `true` o `false`.
`--resume`	reanuda la operación anterior.
`--sessionID`	reanuda una sesión específica por su ID.

Para determinar cuándo se debe rehabilitar un miembro en una configuración de Data Guard (DG):

Supervise la salida dgmgrl show database para detectar los siguientes errores de ORA:

En el nuevo cluster primario:

ORA-16661: Se debe volver a instanciar la base de datos de espera
En el cluster primario anterior:

ORA-16623: El miembro ha detectado un cambio de roles

Estos mensajes indican que se ha producido un failover. Para restaurar la sincronización completa dentro de la configuración de Data Guard, se debe volver a instanciar la principal anterior.

Reintegración de una base de datos primaria con fallos mediante la utilidad dbaascli

Para volver a instanciar una base de datos primaria fallida después de un failover, utilice el comando dataguard reinstate.

Conéctese a una de las máquinas virtuales de la configuración de Oracle Data Guard como usuario oracle.

Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.
Inicie la nueva instanciación de la base de datos primaria fallida.
```
$ dbaascli dataguard reinstate --dbname <db-name>
```
En una configuración de varias bases de datos en espera (grupo de Data Guard), se recomienda especificar el argumento --primaryDBUniqueName.
```
dbaascli dataguard reinstate --dbname <db-name> --primaryDBUniqueName <primary-DB-unique-name>
```
Desconéctese de la máquina virtual.
```
$ exit
```

switchover de dataguard dbaascli

Para realizar un switchover a la base de datos en espera, utilice el comando dataguard switchover.

Ejecute este comando como usuario oracle.

Sintaxis:

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

Parámetros:

Parámetro	Descripción
`--dbname`	Especifica el nombre de Oracle AI Database.
`--targetStandbyDBUniqueName`	Especifica el nombre único de las bases de Datos en espera para cambiar el rol de las bases de Datos en espera a las primarias.
`--executePrereqs`	ejecuta las comprobaciones de requisitos y informa de los resultados.
`--enableDGDebug`	activa los rastreos mientras se realiza la operación.
`--waitForCompletion`	Especifica si se espera a que finalice la operación. Se define en `false` para que se ejecute la operación en segundo plano. Valores válidos: `true` o `false`.
`--resume`	reanuda la operación anterior.
`--sessionID`	reanuda una sesión específica por su ID.

Realización de una Operación de Switchover con la Utilidad dbaascli

Para realizar un switchover a la base de datos en espera, utilice el comando dataguard switchover.

Conéctese a la máquina virtual en la configuración de Oracle Data Guard que alojará la nueva base de datos primaria como usuario opc.

Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.
Inicie un shell de comandos de usuario root y, a continuación, cambie al usuario oracle.
```
$ sudo -s
# su - oracle
$
```
Inicie la operación de switchover a la base datos en espera.
```
$ dbaascli dataguard switchover --dbname <db-name>
```
En una configuración de varias bases de datos en espera (grupo de Data Guard), se recomienda especificar el argumento --targetStandbyDBUniqueName.
```
dbaascli dataguard switchover --dbname <db-name> --targetStandbyDBUniqueName <target-standby-DB-unique-name>
```
Vuelva a ser el usuario root.
```
$ exit
#
```
Salga del shell del comando del usuario root y desconéctese de la máquina virtual.
```
# exit
$ exit
```

dbaascli dataguard prepareForStandby

Para crear una base de datos en espera de Oracle, utilice el comando dbaascli dataguard prepareForStandby como primer paso.

Ejecute este comando como usuario root en la base de datos primaria. Al final de la ejecución del comando, se crea un archivo BLOB en espera. Debe copiar este archivo en el sistema de base de datos en espera para continuar con el paso configureStandby.

Nota: Para las configuraciones de Disaster Recovery (DR) en Oracle Base Database Cloud@Customer, debe utilizar la consola de Oracle Cloud Infrastructure (OCI) o el SDK de OCI para configurar Data Guard. La utilidad dbaascli no está soportada para este caso de uso y no se debe utilizar.

Sintaxis:

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	Descripción
`--dbname`	Especifica el nombre de Oracle AI Database.
`--standbyDBUniqueName`	especifica el nombre único de las bases de datos en espera para la que se configurará.
`--standbyDBDomain`	especifica el dominio de base de datos en espera para la que se configurará el base de datos principal.
`--noDBDomain`	Especifica que no se debe usar el nombre del dominio de base del sistema para el sistema en espera.
`--standbyScanIPAddresses`	Especifica una lista delimitada por comas de direcciones IP correspondientes al listener de SCAN o el nombre de SCAN para la base en espera.
`--standbyScanPort`	Especifica el número del puerto SCAN correspondiente de la base en espera.
`--standbyServiceName`	Especifica el nombre del Servicio de Base de Datos en Espera para el que se configurará La Base de Datos Principal.
`--primaryScanIPAddresses`	Especifica una lista delimitada por comas de direcciones IP correspondientes al listener de SCAN o al nombre de SCAN de la base datos principal.
`--primaryScanPort`	Especifica el número del puerto SCAN correspondiente de la base datos principal.
`--executePrereqs`	ejecuta las comprobaciones de requisitos y informa de los resultados.
`--resume`	reanuda la operación anterior.
`--sessionID`	reanuda una sesión específica por su ID.
`--revert`	revierte la operación anterior.
`--waitForCompletion`	Especifica si se espera a que finalice la operación. Se define en `false` para que se ejecute la operación en segundo plano. Valores válidos: `true` o `false`.
`--skipDRConfiguration`	Especifica si se debe omitir la configuración de Disaster Recovery (DR) como parte de la configuración de la base de datos en espera. Valores válidos: `true` (omitir configuración de DR) o `false` (configurar DR).

Realización de la Operación PrepareForStandby con la Utilidad dbaascli

Para preparar la base de datos primaria para crear una nueva base de datos en espera, utilice el comando dbaascli dataguard prepareForStandby.

Conéctese a la máquina virtual en la que desea alojar la base de datos primaria como usuario opc.

Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.
Inicie un shell de comandos de usuario root.
```
$ sudo -s
```

Ejecute el comando prepareForStandby. Introduzca la contraseña SYS cuando se le solicite.

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>

Al finalizar, el comando muestra la ubicación en la que se crea el archivo BLOB en espera.

Salga del shell del comando del usuario root y desconéctese de la máquina virtual.
```
#  exit
```

dbaascli dataguard configureStandby

Para crear una nueva base de datos en espera, utilice el comando dbaascli dataguard configureStandby como segundo paso después del paso prepareForStandby.

Ejecute este comando como usuario root en el cluster en espera.

Sintaxis:

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	Descripción
`--dbname`	Especifica el nombre de Oracle AI Database.
`--oracleHome`	Especifica la ruta de acceso del directorio raíz de Oracle.
`--oracleHomeName`	Especifica el nombre del directorio raíz de Oracle.
`--standbyDBUniqueName`	Especifica el nombre único de la base datos para la base en espera.
`--standbyDBDomain`	especifica el dominio de base de datos en espera para la que se configurará el base de datos principal.
`--noDBDomain`	Especifica que no se debe usar el nombre del dominio de base del sistema para el sistema en espera.
`--primaryScanIPAddresses`	Especifica una lista delimitada por comas de direcciones IP correspondientes al listener de SCAN o al nombre de SCAN de la base datos principal.
`--primaryScanPort`	especifica el número del puerto del SCAN correspondiente del servicio del sistema de base datos principal.
`--primaryServiceName`	especifica el nombre del Servicio de Base de Datos Principal para el que se configurará La Base de Datos en espera.
`--protectionMode`	especifica el modo a proteger de Data Guard que se debe definir al configurar la base de datos en espera. Valores válidos: `MAX_PERFORMANCE` o `MAX_AVAILABILITY`.
`--transportType`	Especifica el tipo del transporte de Data Guard que se debe definir al configurar la base datos en espera. Valores válidos: `ASYNC` o `SYNC`.
`--activeDG`	Especifica si la configuración de Data Guard estará activa o no. Valores válidos: `true` o `false`.
`--standbyBlobFromPrimary`	Especifica la ubicación del archivo BLOB en espera, que se prepara a partir de la Base de Datos Principal. Solo es necesario para las operaciones de base de datos en espera.
`--standbyDBInfoJsonLocation`	Especifica la ubicación del archivo de información generado a partir de la base de datos primaria para exportar metadatos adicionales. Solo es necesario para operaciones de base de datos en espera.
`--standbyScanIPAddresses`	Especifica una lista delimitada por comas de direcciones IP correspondientes al listener de SCAN o el nombre de SCAN para la base en espera.
`--standbyScanPort`	Especifica el número del puerto SCAN correspondiente de la base en espera.
`--standbySID`	Especifica el SID de las bases de datos en espera para la configuración en espera.
`--nodeList`	Especifica una lista de nodos en los que se espera que se ejecute la base de datos en espera, incluidos los nodos que ya se están ejecutando o configurados.
`--skipAWRConfiguration`	Especifica si se debe omitir la configuración de Oracle AWR como parte de la configuración de la base de datos en espera. Valores válidos: `true` (omitir configuración de AWR) o `false` (configurar AWR).
`--primaryDBOCID`	especifica el valor de OCID de recurso correspondiente a la base datos principal.
`--sgaSizeInMB`	Especifica el valor `sga_target` en MB.
`--pgaSizeInMB`	Especifica el valor `pga_aggregate_target` en MB.
`--datafileDestination`	Especifica la ubicación de almacenamiento que se utilizará para los archivos de datos de la base de datos.
`--fraDestination`	Especifica la ubicación de almacenamiento que se utilizará para el área de recuperación rápida de la base de datos.
`--redoLogDestination`	Especifica la ubicación de almacenamiento que usar para los archivos redo log.
`--fraSizeInMB`	Especifica el valor Del Tamaño Del Área de Recuperación Rápida en MB.
`--tdeKeyStoreType`	Especifica el tipo de almacén de claves de TDE. Valores válidos: `FILE`, `KMS`, `AZURE`, `GOOGLE`, `AWS` o `OKV`
`--tdeKeyOCID`	Especifica el OCID de clave `KMS`/`AZURE`/`GOOGLE`/`AWS` que se utilizará para TDE. Solo se aplica si se ha seleccionado `KMS`/`AZURE`/`GOOGLE`/`AWS` para el tipo de almacén de claves TDE.
`--executePrereqs`	ejecuta las comprobaciones de requisitos y informa de los resultados.
`--resume`	reanuda la operación anterior.
`--sessionID`	reanuda una sesión específica por su ID.
`--revert`	revierte la operación anterior.
`--waitForCompletion`	Especifica si se espera a que finalice la operación. Se define en `false` para que se ejecute la operación en segundo plano. Valores válidos: `true` o `false`.
`--enableFIPS`	Especifica si se debe activar FIPS. Defina esta opción en `false` para desactivarla. Valores válidos: `true` o `false`.
`--skipDRConfiguration`	Especifica si se debe omitir la configuración de Disaster Recovery (DR) como parte de la configuración de la base de datos en espera. Valores válidos: `true` (omitir configuración de DR) o `false` (configurar DR).
`--okvServer`	Especifica el servidor Oracle Key Vault. Lista delimitada por comas de varias direcciones IP.
`--okvAdminUserName`	especifica el nombre del usuario administrativo de Oracle Key Vault.
`--okvServerRestPort`	Especifica el número de puerto REST para Oracle Key Vault.
`--okvWalletName`	Especifica el nombre de las carteras de Oracle Key Vault.

Realización de la Operación configureStandby con la Utilidad dbaascli

Para crear una base de datos en espera, utilice el comando dbaascli dataguard configureStandby.

Conéctese a la máquina virtual donde desea alojar la base de datos en espera como usuario opc.

Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.
Inicie un shell de comandos de usuario root.
```
$ sudo -s
```

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

Introduzca las contraseñas SYS, TDE y AWR de la base de datos primaria cuando se le solicite.

Una vez finalizado correctamente el comando, la base de datos en espera se inicia y se pone en funcionamiento.

dbaascli dataguard registerStandby

Para registrar una base de datos en espera recién creada con todas las bases de datos en espera existentes y en la base de datos primaria, utilice el comando dbaascli dataguard registerStandby como un tercer paso después del paso configureStandby.

Ejecute este comando como usuario root en el cluster primario. Además, en una configuración de varias bases de datos en espera, ejecute el comando en todos los clusters en espera, excepto en el cluster de base de datos en espera recién creado.

Sintaxis:

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	Descripción
`--dbname`	Especifica el nombre de Oracle AI Database.
`--standbyDBUniqueName`	especifica el nombre único de la base datos en espera para que se registre con la configuración de Oracle Data Guard Broker.
`--standbyDBDomain`	especifica el dominio de base de datos en espera para la que se configurará el base de datos principal.
`--noDBDomain`	Especifica que no se debe usar el nombre del dominio de base del sistema para el sistema en espera.
`--standbyScanIPAddresses`	Especifica una lista delimitada por comas de direcciones IP correspondientes al listener de SCAN o el nombre de SCAN para la base en espera.
`--standbyScanPort`	Especifica el número del puerto SCAN correspondiente de la base en espera.
`--standbyServiceName`	Especifica el nombre del Servicio de Base de Datos en Espera para el que se configurará La Base de Datos Principal.
`--executePrereqs`	ejecuta las comprobaciones de requisitos y informa de los resultados.
`--resume`	reanuda la operación anterior.
`--sessionID`	reanuda una sesión específica por su ID.
`--revert`	revierte la operación anterior.
`--waitForCompletion`	Especifica si se espera a que finalice la operación. Se define en `false` para que se ejecute la operación en segundo plano. Valores válidos: `true` o `false`.

Realización de la Operación registerStandby con la Utilidad dbaascli

Para registrar la base de datos en espera especificada con la configuración de Oracle Data Guard Broker, utilice el comando dbaascli dataguard registerStandby.

Para casos de uso de una sola base de datos en espera, el comando registerStandby solo se debe ejecutar en el cluster primario, ya que hay una asociación uno a uno entre la base de datos principal y la base de datos en espera.

Sin embargo, en las configuraciones con varias bases de datos en espera, debe ejecutar el comando registerStandby tanto en el cluster primario como en todos los clusters en espera existentes, excepto en la nueva base de datos en espera que se va a agregar.

Por ejemplo, considere una configuración con dos bases de datos en espera: stdby1 y stdby2, donde stdby2 es la nueva base de datos en espera que se va a registrar. En este caso, ejecute el comando registerStandby en el cluster primario y en stdby1, pero no en stdby2.

En resumen, al agregar una nueva base de datos en espera a una configuración de Oracle Data Guard existente, ejecute el comando registerStandby en la base de datos principal y en todos los demás clusters en espera registrados anteriormente, excepto en la nueva base de datos en espera que se va a agregar.

Conéctese al cluster primario de la configuración de Data Guard como usuario opc.

Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.
Inicie un shell de comandos de usuario root.
```
$ sudo -s
```
Ejecute el comando registerStandby.
```
dbaascli dataguard registerStandby --dbname <db-name> --standbyDBUniqueName <standby-DB-unique-name> --standbyDBDomain <standby-DB-domain>
```
Cuando el comando se haya completado correctamente, la base de datos en espera especificada se registrará con la configuración de Oracle Data Guard Broker.
Repita los pasos del 1 al 3, como se realiza en el cluster primario, en todos los clusters en espera existentes en la configuración de Oracle Data Guard Broker, excepto el que se está registrando.

dbaascli dataguard deregisterStandby

Durante la supresión en espera, ejecute el comando dbaascli dataguard deregisterStandby antes de suprimir la base de datos en el cluster en espera para anular el registro de la base de datos en espera de la configuración de Oracle Data Guard Broker.

Ejecute este comando como usuario root en el cluster primario. Sin embargo, en el contexto de varias bases de datos en espera, este comando debe ejecutarse en todos los clusters en espera, excepto en el destino en espera.

Sintaxis:

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

Parámetros:

Parámetro	Descripción
`--dbname`	Especifica el nombre de Oracle AI Database.
`--standbyDBUniqueName`	Especifica el nombre único de la base de Datos en espera para que se anule su registro de la configuración de Oracle Data Guard Broker.
`--executePrereqs`	ejecuta las comprobaciones de requisitos y informa de los resultados.
`--resume`	reanuda la operación anterior.
`--sessionID`	reanuda una sesión específica por su ID.
`--waitForCompletion`	Especifica si se espera a que finalice la operación. Se define en `false` para que se ejecute la operación en segundo plano. Valores válidos: `true` o `false`.

Realización de la Operación deregisterStandby con la Utilidad dbaascli

Para casos de uso de una sola base de datos en espera, el comando deregisterStandby solo se debe ejecutar en el cluster primario, ya que hay una asociación uno a uno entre la base de datos principal y la base de datos en espera.

Sin embargo, en configuraciones con varias bases de datos en espera, debe ejecutar el comando deregisterStandby tanto en el cluster primario como en todos los clusters en espera existentes, con exclusión de la base de datos en espera cuyo registro se está anulando actualmente.

Por ejemplo, considere una configuración con dos bases de datos en espera: stdby1 y stdby2, donde se anulará el registro de stdby2. En este caso, ejecute el comando deregisterStandby en el cluster primario y en stdby1, pero no en stdby2.

En resumen, al suprimir una base de datos en espera de una configuración de Oracle Data Guard existente, ejecute el comando deregisterStandby en la base de datos principal y en todos los demás clusters en espera existentes antes de la operación de supresión de la base de datos en el cluster en espera deseado.

Conéctese al cluster primario de la configuración de Oracle Data Guard como usuario opc.

Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.
Inicie un shell de comandos de usuario root.
```
$ sudo -s
```
Ejecute el comando deregisterStandby.
```
dbaascli dataguard deregisterStandby --dbname <db-name> --standbyDBUniqueName <standby-DB-unique-name>
```
Una vez completado correctamente el comando, se anulará el registro (eliminará) de la base de datos en espera especificada de la configuración de Oracle Data Guard Broker.
Repita los pasos del 1 al 3, como se realiza en el cluster primario, en todos los clusters en espera existentes en la configuración de Oracle Data Guard Broker, excepto el que se va a anular el registro.

dbaascli dataguard configureAWR

Para activar o desactivar la configuración del repositorio de carga de trabajo automática (AWR) en la base de datos en espera de Active Data Guard, utilice el comando dbaascli dataguard configureAWR.

Ejecute este comando como usuario root en el cluster en espera de Active Data Guard en el que desea activar o desactivar la configuración de AWR. Utilice este comando si no se ha configurado AWR durante el proceso de adición en espera.

Sintaxis:

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

Parámetros:

Parámetro	Descripción
`--dbname`	Especifica el nombre de Oracle AI Database.
`--action`	Especifica si se debe activar o desactivar el AWR. Utilice `--action enable` para activar AWR y `--action disable` para desactivarla. El argumento `--action` se conserva para la compatibilidad con versiones anteriores. Sin embargo, se recomienda utilizar `--enable` o `--disable`, ya que proporcionan la misma funcionalidad, pero son más explícitos
`--executePrereqs`	ejecuta las comprobaciones de requisitos y informa de los resultados.
`--resume`	reanuda la operación anterior.
`--sessionID`	reanuda una sesión específica por su ID.

Realización de la Operación configureAWR con la Utilidad dbaascli

Para configurar AWR en una base de datos en espera de ADG, utilice el comando dbaascli dataguard configureAWR.

Conéctese a la máquina virtual en la que la base de datos en espera de ADG se aloja como usuario opc.

Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.
Inicie un shell de comandos de usuario root.
```
$ sudo -s
```

Ejecute el comando configureAWR.

Para activar AWR, ejecute:

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

Para desactivar AWR, ejecute:

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

Introduzca las contraseñas SYS y AWR cuando se le solicite.

Cuando el comando se haya completado correctamente, la base de datos en espera de ADG se habría configurado con AWR

dbaascli dataguard updateConfiguration

Para actualizar el modo de transporte, el modo de protección o ambos parámetros de un entorno de Data Guard, utilice el comando dbaascli dataguard updateConfiguration.

Ejecute este comando como el usuario root.

Cuando el comando de actualización de modo de transporte se ejecuta en la base de datos primaria, solo se actualiza el modo de transporte de la base de datos primaria. Para actualizar el modo de transporte de una base de datos en espera, el comando se debe ejecutar por separado en esa base de datos en espera.

Por el contrario, cuando el comando de modo de protección de actualización se ejecuta en la base de datos principal, el modo de protección se actualiza tanto para la base de datos principal como para la base de datos en espera. El modo de protección también se puede actualizar desde el lado en espera, en cuyo caso se actualizan las bases de datos primaria y en espera.

Al actualizar el modo de transporte o protección desde la base de datos principal, el sistema comprueba los modos actuales tanto en la base de datos principal como en la base de datos en espera y continúa con la actualización solo si se cumplen todas las condiciones necesarias.

Sintaxis:

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

Parámetros:

Parámetro	Descripción
`--dbname`	Especifica el nombre de Oracle AI Database.
`--protectionMode`	especifica el modo a proteger de Data Guard que se debe definir al configurar la base de datos en espera. Valores válidos: `MAX_PERFORMANCE` o `MAX_AVAILABILITY`.
`--transportType`	Especifica el tipo del transporte de Data Guard que se debe definir al configurar la base datos en espera. Valores válidos: `ASYNC` o `SYNC`.
`--standbyDGType`	Especifica el tipo de Data Guard de la base de datos en espera que se va a definir. Valores válidos: `ADG` o `DG`.
`--executePrereqs`	ejecuta las comprobaciones de requisitos y informa de los resultados.
`--resume`	reanuda la operación anterior.
`--sessionID`	reanuda una sesión específica por su ID.
`--waitForCompletion`	Especifica si se espera a que finalice la operación. Se define en `false` para que se ejecute la operación en segundo plano. Valores válidos: `true` o `false`.

Realización de la Operación updateConfiguration con la Utilidad dbaascli

Para actualizar el modo de transporte y el modo de protección o ambos parámetros, utilice el comando dbaascli dataguard updateConfiguration.

Conéctese a la máquina virtual en la que la base de datos en espera de ADG se aloja como usuario opc.

Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.
Inicie un shell de comandos de usuario root.
```
$ sudo -s
```
Ejecute el comando updateConfiguration.
```
$ dbaascli dataguard updateConfiguration --dbname <db-name> --protectionMode MAX_PERFORMANCE|MAX_AVAILABILITY --transportType ASYNC|SYNC --standbyDGType ADG|DG.
```
Cuando finalice correctamente el comando, Data Guard especificado se configurará con el modo de transporte o el modo de protección especificados.