Documentación de Oracle Cloud Infrastructure

Uso de la utilidad dbaascli en Exadata Cloud Infrastructure

Aprenda a usar la utilidad dbaascli en Exadata Cloud Infrastructure.

Tema principal: Guías de referencia para Exadata Cloud Infrastructure

Acerca del uso de la utilidad dbaascli en Exadata Cloud Infrastructure

Puede usar la utilidad dbaascli para realizar varias operaciones de administración y ciclo de vida de base de datos en Exadata Cloud Infrastructure, como cambiar la contraseña de un usuario de base de datos, iniciar una base de datos, gestionar bases de datos conectables, etc.

Para escalar recursos, debe utilizar la consola o la interfaz de línea de comandos de Oracle Cloud Infrastructure. Las capacidades de la utilidad dbaascli son adicionales e independientes de la consola, la API o la interfaz de línea de comandos (CLI). A menos que se especifique de otro modo, necesita acceso root a dbaascli para ejecutar todos los comandos de administración.

Para usar la utilidad, debe estar conectado a una máquina virtual de Exadata Cloud Infrastructure. Para obtener instrucciones detalladas, consulte Conexión a una instancia de Exadata Cloud Infrastructure.

Para obtener los posibles comandos disponibles con dbaascli, ejecute dbaascli --help.

Para obtener ayuda específica del comando, ejecute dbaascli command --help. Por ejemplo, dbaascli database create --help.

Consulte Referencia de comandos dbasscli en el documento para conocer los comandos y obtener información específica de los comandos.

Creación de bases de datos mediante dbaascli

Con dbaascli, puede crear una instancia de Oracle Database mediante la creación en primer lugar de un directorio raíz de Oracle Database de la versión deseada y la creación a continuación de una base de datos en ese directorio raíz de Oracle Database

Tema principal: Uso de la utilidad dbaascli en Exadata Cloud Infrastructure

Lista de imágenes y versiones de software disponibles para la base de datos y Grid Infrastructure

Para generar una lista de las versiones soportadas disponibles para la aplicación de parches, utilice el comando dbaascli cswlib showImages.

  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el siguiente comando:
    dbaascli cswlib showImages --product database

    La salida del comando muestra las imágenes de software de base de datos disponibles.

    dbaascli cswlib showImages --product grid

    La salida del comando muestra las imágenes de software de cuadrícula disponibles.

  4. Salga del shell de comandos del usuario root:
    exit

    Para obtener más información sobre las opciones avanzadas soportadas, consulte dbaascli cswlib showImages.

Ejemplo 6-1 dbaascli cswlib showImages

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

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

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

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

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

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

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

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

Creación del directorio raíz de Oracle Database

Para crear un directorio raíz de Oracle Database de la versión deseada, utilice el comando dbaascli dbhome create.

Nota

Puede crear un directorio raíz de Oracle Database con un nombre de directorio raíz de Oracle especificado. Si no lo especifica, se calculará automáticamente (recomendado).
  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el siguiente comando: 
    dbaascli dbhome create --version Oracle Home Version --imageTag image Tag Value
    Donde:
    • --version especifica la versión de Oracle Database
    • --imageTag especifica la etiqueta de imagen de la imagen que se va a utilizar
    Por ejemplo:
    dbaascli dbhome create --version 19.9.0.0.0
    Nota

    La especificación de imageTag es opcional. Para ver las etiquetas de imagen, consulte el comando dbaascli cswlib showImages. Las etiquetas de imagen suelen ser las mismas que las de la versión de la base de datos. Sin embargo, se mantiene como una provisión para casos en los que puede que sea necesario publicar varias imágenes para la misma versión, en la que cada una de las cuales cumple un requisito específico del cliente.
  4. Salga del shell de comandos del usuario root:
    exit

    Para obtener más información sobre las opciones avanzadas soportadas, consulte dbaascli dbhome create.

Creación de una instancia de Oracle Database en el directorio raíz de Oracle Database especificado

Para crear una instancia de Oracle Database en el directorio raíz de Oracle Database especificado de la versión deseada, utilice el comando dbaascli database create.

Puede utilizar el comando dbaascli database create para:
  • Creación de una base de datos de contenedores (CDB) o una base de datos sin contenedor
  • Creación de una CDB con bases de datos conectables (PDB)
  • Creación de una instancia de Oracle Database con el juego de caracteres especificado
  • Creación de una instancia de Oracle Database en un subjuego de nodos de cluster
    Nota

    Las bases de datos creadas en un subjuego de nodos no se mostrarán en la consola de OCI.
  • Cree una instancia de Oracle Database versión 12.1.0.2 o superior con la actualización de la versión JAN 2021 o posterior. Para las bases de datos con versiones anteriores, se recomienda utilizar la API basada en la consola de OCI.
  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el siguiente comando:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path
    Donde:
    • --dbName especifica el nombre de la base de datos
    • --oracleHome especifica la ubicación del directorio raíz de Oracle
    Para crear una CDB, ejecute el siguiente comando:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path
    Para crear una base de datos no CDB, ejecute el siguiente comando:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path --createAsCDB false

    Cuando se le solicite, introduzca las contraseñas sys y tde.

  4. Salga del shell de comandos del usuario root:
    exit

    Para obtener más información sobre las opciones avanzadas soportadas, consulte dbaascli database create.

Temas relacionados

Tema principal: Creación de bases de datos mediante dbaascli

Ejecución de comprobaciones de requisitos antes de crear una instancia de Oracle Database

Para ejecutar comprobaciones de requisitos, utilice la opción de comando --executePrereqs. Solo realizará las comprobaciones de requisitos sin llevar a cabo la creación en sí de la instancia de Oracle Database.

  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el siguiente comando:
    dbaascli database create --dbName database name --oracleHome Oracle Home Path --executePrereqs
    Donde:
    • --dbName especifica el nombre de la base de datos
    • --oracleHome especifica la ubicación del directorio raíz de Oracle
  4. Salga del shell de comandos del usuario root:
    exit

    Para obtener más información sobre las opciones avanzadas soportadas, consulte dbaascli database create.

Reanudación o reversión de la operación de creación de una instancia de Oracle Database

Para reanudar o revertir una operación de creación de base de datos fallida, utilice la opción de comando --resume o --revert.

Por ejemplo:
dbaascli database create --dbName database name --oracleHome Oracle Home Path --resume
Nota

  • Al utilizar las opciones de comando --resume o --revert, asegúrese de utilizar el mismo comando del mismo nodo que se haya utilizado para el flujo de operación de creación real.
  • Solo puede reanudar la creación de la base de datos si se produce un fallo en el paso posterior a la creación de la base de datos.

Cambio de las contraseñas de la base de datos

Para cambiar la contraseña SYS o la contraseña de la cartera de TDE, utilice este procedimiento.

La contraseña que especifique en el campo Contraseña de administrador de base de datos al crear una nueva instancia o base de datos de Exadata Cloud Infrastructure se define como la contraseña para las credenciales de SYS, SYSTEM, cartera de TDE y administrador de PDB. Utilice los siguientes procedimientos si necesita cambiar las contraseñas de una base de datos existente.

Nota

Si va a activar Data Guard para una base de datos, la contraseña SYS y la contraseña de la cartera de TDE de las bases de datos principal y en espera deben ser las mismas.
Nota

El uso de dbaascli para cambiar la contraseña SYS garantizará que la automatización de copia de seguridad/restauración pueda paralelizar los canales en todos los nodos del cluster.

Cambio de la contraseña de SYS de una base de datos de Exadata Cloud Infrastructure

  1. Conéctese a la máquina virtual de Exadata Cloud Infrastructure como opc.
  2. Ejecute el siguiente comando:
    sudo dbaascli database changepassword --dbname database_name --user SYS

Cambio de contraseñas de base de datos en un entorno de Data Guard

  1. Ejecute el siguiente comando en la base de datos principal:
    dbaascli database changePassword —dbName <dbname> --user SYS --prepareStandbyBlob true --blobLocation <location to create the blob file>
  2. Copie el archivo blob creado en todas las bases de datos en espera y actualice la propiedad del archivo al usuario oracle.
  3. Ejecute el siguiente comando en todas las bases de datos en espera:
    dbaascli database changePassword —dbName <dbname> --user SYS --standbyBlobFromPrimary <location of copies the blob file>

Cambio de la contraseña de cartera de TDE para una base de datos de Exadata Cloud Infrastructure

  1. Conéctese a la máquina virtual de Exadata Cloud Infrastructure como opc.
  2. Ejecute el siguiente comando:
    sudo dbaascli tde changepassword --dbname database_name

Gestión de imágenes de software de Exadata Cloud Infrastructure con la utilidad dbaascli

Puede mostrar y descargar las imágenes de software de base de datos de Oracle en una instancia de Exadata Cloud Infrastructure, las cuales se pueden utilizar posteriormente para aprovisionar un directorio raíz de base de datos.

Nota

Puede crear imágenes de software de base de datos personalizadas para sus instancias de Exadata Cloud Infrastructure mediante la consola o la API. Estas imágenes se almacenan en Object Storage y se pueden utilizar para aprovisionar un directorio raíz de base de datos en la instancia de Exadata. Consulte Imágenes de software de Oracle Database para obtener más información.

Puede controlar la versión de los binarios de Oracle instalada al aprovisionar una nueva base de datos en una instancia de Exadata Cloud Infrastructure manteniendo las imágenes de software en el sistema. Oracle proporciona una biblioteca de imágenes de software en la nube que se pueden ver y descargar en la instancia mediante la utilidad dbaascli.

Tema principal: Uso de la utilidad dbaascli en Exadata Cloud Infrastructure

Lista de imágenes y versiones de software disponibles para la base de datos y Grid Infrastructure

Para generar una lista de las versiones soportadas disponibles para la aplicación de parches, utilice el comando dbaascli cswlib showImages.

  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el siguiente comando:
    dbaascli cswlib showImages --product database

    La salida del comando muestra las imágenes de software de base de datos disponibles.

    dbaascli cswlib showImages --product grid

    La salida del comando muestra las imágenes de software de cuadrícula disponibles.

  4. Salga del shell de comandos del usuario root:
    exit

    Para obtener más información sobre las opciones avanzadas soportadas, consulte dbaascli cswlib showImages.

Ejemplo 6-2 dbaascli cswlib showImages

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

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

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

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

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

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

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

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

Descarga de una imagen de software

Puede descargar las imágenes de software disponibles a la instancia de Exadata Cloud Infrastructure mediante el subcomando cswlib download de la utilidad dbaascli.

  1. Conéctese a un nodo de cálculo como usuario opc. Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.
  2. Inicie un shell de comandos de usuario root:
    $ sudo -s
#
  3. Ejecute el comando dbaascli con el subcomando cswlib download:
    # dbaascli cswlib download [--version <software_version>] [--imageTag <image tag
    value>]
    El comando muestra la ubicación de las imágenes de software que se descargan en el entorno de Exadata Cloud Infrastructure.

    Los parámetros opcionales son:

    • version: especifica una versión del software de Oracle Database. Por ejemplo, 19.14.0.0.0.
    • imageTag: especifica la etiqueta de imagen de la imagen.
  4. Salga del shell de comandos de usuario root:
    # exit
$

Aplicación de parches en Oracle Database y Oracle Grid Infrastructure mediante dbaascli

Obtenga información sobre cómo usar la utilidad dbaascli para realizar operaciones de aplicación de parches para Oracle Grid Infrastructure y Oracle Database en un sistema Exadata Cloud Infrastructure.

Tema principal: Uso de la utilidad dbaascli en Exadata Cloud Infrastructure

Aplicación de parches en bases de datos mediante dbaascli

Con dbaascli, puede optar por aplicar parches en una base de datos aplicando parches en el directorio raíz de Oracle o moviendo la base de datos a un directorio raíz de Oracle con el nivel de parche deseado.

  • Aplicación de parches en un directorio raíz de Oracle (aplicación de parches interna). De esta forma, se actualizan todas las bases de datos ubicadas en el directorio raíz de Oracle.
  • Mover una base de datos a un directorio raíz de Oracle diferente que tenga la versión de software de Oracle Database deseada (aplicación de parches externa).

Tema principal: Aplicación de parches en Oracle Database y Oracle Grid Infrastructure mediante dbaascli

Aplicación de parches en un directorio raíz de base de datos (aplicación de parches de base de datos interna)

Para aplicar parches en un directorio raíz de Oracle, utilice el comando dbaascli dbHome patch.

Este aplicará parches a todas las bases de datos que se ejecuten en el directorio raíz especificado, y las bases de datos permanecerán en el directorio raíz una vez que se haya completado la aplicación de parches. Los puntos siguientes se aplican al uso del comando dbHome patch para operaciones de aplicación de parches interna:
  • Puede aplicar parches a todos los nodos de base de datos o a un subjuego de nodos.
  • La aplicación de parches en varios nodos tiene lugar de manera sucesiva.
  • Si lo desea, puede realizar una operación solo de aplicación de parches de software. A continuación, cuando esté listo, puede ejecutar datapatch para realizar acciones SQL posteriores a la aplicación de parches.
  • Puede aplicar parches en un directorio raíz de Oracle que contenga una o más bases de datos.

Para aplicar parches en un directorio raíz de Oracle (dbhome):

  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el siguiente comando:
    dbaascli dbhome patch --oracleHome dbhome_path --targetVersion Oracle_Database_version
    Donde:
    • --oracleHome identifica la ruta del directorio raíz de Oracle en el que se va a aplicar el parche.
    • --targetVersion especifica la versión de Oracle Database de destino que se va a utilizar para la aplicación de parches, especificada como cinco segmentos numéricos separados por puntos (por ejemplo, 19.12.0.0.0).
    Por ejemplo:
    dbaascli dbhome patch --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --targetVersion 19.9.0.0.0
  4. Salga del shell de comandos del usuario root:
    exit

    Para obtener más información sobre las opciones avanzadas soportadas, consulte dbaascli dbHome patch.

Traslado de una base de datos a un directorio raíz de Oracle diferente (aplicación de parche externa)

Para aplicar parches en una instancia de Oracle Database moviéndola a un directorio raíz de Oracle que ya tiene el nivel de parche deseado, utilice el comando dbaascli database move.

Una vez completada la operación de movimiento de la base de datos, la base de datos se ejecuta con la versión de software de Oracle Database del directorio raíz de Oracle de destino.

Para aplicar parches en una base de datos moviéndola a un directorio raíz de Oracle diferente:

  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el siguiente comando:
    dbaascli database move --oracleHome path_to_target_oracle_home --dbname database_name
    Donde:
    • --oracleHome identifica la ruta del directorio raíz de Oracle de destino que utiliza la versión de software de Oracle Database deseada. Tenga en cuenta que el directorio raíz de Oracle de destino debe existir en el sistema antes de utilizar el comando database move.
    • --dbname especifica el nombre de la base de datos que se va a mover.
    Por ejemplo:
    dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --dbname xyz
  4. Salga del shell de comandos del usuario root:
    exit

    Para obtener más información sobre las opciones avanzadas soportadas, consulte dbaascli database move.

Aplicación de parches en Oracle Grid Infrastructure

Para aplicar un parche en Oracle Grid Infrastructure, utilice el comando grid patch.

  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el siguiente comando:
    dbaascli grid patch --targetVersion target_software_version_number

    Donde --targetVersion identifica la versión de software de destino del parche que se aplicará en Oracle Grid Infrastructure.

    Por ejemplo:
    dbaascli grid patch --targetVersion 19.11.0.0.0
  4. Salga del shell de comandos del usuario root:
    exit

    Para obtener más información sobre las opciones avanzadas soportadas, consulte dbaascli grid patch.

Temas relacionados

Tema principal: Aplicación de parches en Oracle Database y Oracle Grid Infrastructure mediante dbaascli

Aplicación de parches en Oracle Grid Infrastructure (GI) mediante la imagen de software de GI

Para aplicar parches en Oracle Grid Infrastructure (GI) mediante la imagen de software de GI, utilice este procedimiento.

También se pueden aplicar parches en Oracle Grid Infrastructure creando primero una imagen de software con parches y, a continuación, utilizando esa imagen para realizar la operación de aplicación de parches. Esto proporciona la ventaja de que se puede crear una imagen con antelación fuera de la ventana de aplicación de parches. También ayuda en la resolución de conflictos, ya que los conflictos entre los parches se resaltan durante el proceso de creación de imagen sin que esto afecte a la ventana de aplicación de parches.

  1. Cree una imagen de software con parches.
    dbaascli grid patch --targetVersion <target_software_version_number> --createImage
    Una vez completada la creación de la imagen de software con parches, la imagen se puede utilizar para realizar la operación de aplicación de parches.
  2. Realice la operación de aplicación de parches.
    dbaascli grid patch --targetVersion <target_software_version_number> --imageLocation <location_of_patched_software_image>

Lista de imágenes y versiones de software disponibles para la base de datos y Grid Infrastructure

Para generar una lista de las versiones soportadas disponibles para la aplicación de parches, utilice el comando dbaascli cswlib showImages.

  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el siguiente comando:
    dbaascli cswlib showImages --product database

    La salida del comando muestra las imágenes de software de base de datos disponibles.

    dbaascli cswlib showImages --product grid

    La salida del comando muestra las imágenes de software de cuadrícula disponibles.

  4. Salga del shell de comandos del usuario root:
    exit

    Para obtener más información sobre las opciones avanzadas soportadas, consulte dbaascli cswlib showImages.

Ejemplo 6-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

Comprobación previa antes de aplicar parches en bases de datos y Grid Infrastructure

Puede realizar una operación de comprobación de requisitos (también denominada "comprobación previa") de los comandos de este tema utilizando el indicador de comprobación previa correspondiente.

La ejecución de comprobaciones previas permite ejecutar solo la parte de comprobación previa de la operación de aplicación de parche sin realizar la aplicación de parche real. Oracle recomienda ejecutar comprobaciones previas para detectar incidencias de software que puedan impedir la aplicación correcta del parche.

Para realizar comprobaciones previas de aplicación de parche, primero, conéctese a una máquina virtual de la instancia de Exadata Cloud Infrastructure como usuario root.

Comprobación previa de aplicación de parche en directorio raíz de Oracle (aplicación de parches interna)

Utilice el indicador --executePrereqs con el comando dbaascli dbhome patch.

  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el siguiente comando:
    dbaascli dbhome patch --oracleHome dbhome_path --targetVersion Oracle_Database_version --executePrereqs
    Donde:
    • --oracleHome identifica la ruta del directorio raíz de Oracle para la que se va a realizar la comprobación previa.
    • --targetVersion especifica la versión de Oracle Database de destino a la que se va a aplicar el parche, especificada como cinco segmentos numéricos separados por puntos (por ejemplo, 19.12.0.0.0).
  4. Salga del shell de comandos del usuario root:
    exit
Comprobación previa de aplicación de parche moviendo la base de datos (aplicación de parches externa)

Utilice el indicador --executePrereqs con el comando dbaascli database move.

  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el siguiente comando:
    dbaascli database move --oracleHome path_to_target_oracle_home --dbname database_name --executePrereqs
    Donde:
    • --oracleHome identifica la ruta de acceso del directorio raíz de Oracle de destino que utiliza la versión de software de Oracle Database deseada. Tenga en cuenta que el directorio raíz de Oracle de destino debe existir en el sistema antes de utilizar el comando database move.
    • --dbname especifica el nombre de la base de datos que se va a mover
  4. Salga del shell de comandos del usuario root:
    exit
Comprobación previa de aplicación de parche de Oracle Grid Infrastructure

Utilice el indicador --executePrereqs con el comando dbaascli grid patch.

  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el siguiente comando:
    dbaascli grid patch --targetVersion target_software_version_number --executePrereqs

    Donde --targetVersion identifica la versión de software de destino para la que se aplicará el parche en Oracle Grid Infrastructure, especificada como cinco segmentos numéricos separados por puntos, por ejemplo, 19.12.0.0.0

  4. Salga del shell de comandos del usuario root:
    exit

Reanudación o rollback de una operación de aplicación de parches

Puede reanudar o revertir una operación de aplicación de parche fallida. La reversión de un parche se denomina rollback.

Tema principal: Aplicación de parches en Oracle Database y Oracle Grid Infrastructure mediante dbaascli

Reanudación de una operación de aplicación de parche

Para reanudar una operación de aplicación de parche, utilice el indicador --resume con el comando de aplicación de parches original.

  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el comando de aplicación de parche original para reanudar una operación de aplicación de parche:
    Por ejemplo:
    dbaascli dbhome patch --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --targetVersion 19.9.0.0.0 --resume
  4. Salga del shell de comandos del usuario root:
    exit
Rollback de una operación de aplicación de parche

Utilice el indicador --rollback con el comando de aplicación de parches original para realizar un rollback (revertir) de una operación de aplicación de parche.

  1. Conéctese a la máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Ejecute el comando de aplicación de parches original para realizar un rollback (revertir) una operación de aplicación de parche:
    Por ejemplo:
    dbaascli grid patch --targetVersion 19.11.0.0.0 --rollback
    Nota

    • Las operaciones de reanudación y rollback están soportadas para las operaciones de aplicación de parches en el directorio raíz de Oracle, de aplicación de parches de Oracle Grid Infrastructure y de movimiento de base de datos.
    • Al reanudar o realizar un rollback de una operación de aplicación de parches, debe ejecutar el comando de reanudación o rollback desde el mismo nodo que se haya utilizado para ejecutar el comando de aplicación de parches original, y debe ejecutar el comando original con la adición del indicador --resume o --rollback.
  4. Salga del shell de comandos del usuario root:
    exit

Recopilación de registros de herramientas de nube y realización de una comprobación del sistema de las herramientas de nube con dbaascli

El uso del comando dbaascli diag permite recopilar logs de herramientas de dbaas de VM de invitado para sistemas Exadata Database Service on Dedicated Infrastructure y Exadata Database Service on Cloud@Customer. Puede utilizar estos logs para solucionar problemas relacionados con las herramientas de dbaas.

Puede utilizar el comando diag para recopilar logs de dbaastools y realizar una comprobación del sistema en todos los nodos de un cluster de Exadata. Tenga en cuenta que las opciones --waitForCompletion están soportadas a partir de la versión 22.4.1
Nota

  • Los comandos de dbaascli diag se deben ejecutar como usuario root
  • La ejecución del comando dbaascli diag collect en un solo nodo recopilará datos de log para todos los nodos.
  • Recomendamos ejecutar los comandos documentados en este tema mediante la opción --waitForCompletion para comandos de larga ejecución. Consulte los ejemplos para ver la sintaxis de ejemplo.

Para obtener información sobre la actualización de las herramientas de Exadata Cloud, consulte dbaascli admin updateStack.

Temas relacionados

Tema principal: Uso de la utilidad dbaascli en Exadata Cloud Infrastructure

Ejemplos de recopilación de datos de log de herramientas

El comando dbaascli dbaascli diag collect utiliza la sintaxis que se muestra a continuación para recopilar datos de log de herramientas:

Consulte dbaascli diag collect en Referencia de comandos dbaascli para obtener detalles sobre la sintaxis 

# dbaascli diag collect
DBAAS CLI version 24.1.1.0.0
Executing command diag collect
Job id: 92f33125-aa70-4ce2-94fb-64d8f1cbdc93
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_07-20-44-PM_83383.log
Loading PILOT...
Session ID of the current execution is: 10
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_07-20-48-PM_83856
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-1920/diag_cloudlogs_20231214-1920_node1.zip=a0d049b87ab9e9cec2ab7d95ded4903bac818c81c8b6a46d295e1e75f4630e19}"
}
dbaascli execution completed
# dbaascli diag collect --waitForCompletion false
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --waitForCompletion false
Job id: 5b556976-dba1-4be9-a4fe-4b58e69c1d96
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_07-23-26-PM_98107.log
Job accepted. Use "dbaascli job getStatus --jobID 5b556976-dba1-4be9-a4fe-4b58e69c1d96" to check the job status.
Nota

Utilice el comando de estado del trabajo para supervisar el progreso. 
# dbaascli diag collect --dbnames myOracleDatabase19cName
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --dbnames myOracleDatabase19cName
Job id: 8e1d2667-4649-4384-8610-b6348d6548ac
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_08-41-41-PM_88831.log
Loading PILOT...
Session ID of the current execution is: 12
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_08-41-45-PM_89361
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2041/diag_cloudlogs_20231214-2041_node1.zip=9e50500089a74ca7cd8ae08550c06868e26e1cd9c52e808194256594f63397e4}"
}
dbaascli execution completed
# dbaascli diag collect --destLocation /tmp/test/
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --destLocation /tmp/test/
Job id: f992afdf-415e-4b58-ab5b-9e38f8c2079d
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-42-54-PM_16270.log
Loading PILOT...
Session ID of the current execution is: 14
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-42-58-PM_16777
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/tmp/test/diag_collect/artifacts_diag_cloudlogs_20231214-2143/diag_cloudlogs_20231214-2143_node1.zip=8a26cffcfdd72c261660d4f736c615981856e357749d90751b94f3eda19a9a70}"
}
dbaascli execution completed
# dbaascli diag collect --startTime 2023-12-05T10:00:00 --endTime 2023-12-05T11:00:00
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --startTime 2023-12-05T10:00:00 --endTime 2023-12-05T11:00:00
Job id: 70b03e50-98cc-4c2b-9684-1f82070bac88
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-45-17-PM_42856.log
Loading PILOT...
Session ID of the current execution is: 15
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-45-21-PM_43526
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2145/diag_cloudlogs_20231214-2145_node1.zip=b44cf3bfca1ab7a1629dd83098a7772790ab949e50dbb3950f0017e427d7bd05}"
}
dbaascli execution completed
# dbaascli diag collect --nodes node1,node2
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --nodes node1,node2
Job id: fa70da09-3de6-4cc8-854c-a739b4fc2ceb
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-46-58-PM_55884.log
Loading PILOT...
Session ID of the current execution is: 16
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-47-02-PM_56418
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2147/diag_cloudlogs_20231214-2147_node1.zip=de2805c9c6c2af2d602395a84d37747935327b73a6c73052282665a8410eb41f}"
}
# dbaascli diag collect --components dbaastools
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --components dbaastools
Job id: da941d3c-5191-4ced-b1bb-9b083fa75865
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-47-23-PM_68256.log
Loading PILOT...
Session ID of the current execution is: 17
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-47-27-PM_68729
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2147/diag_cloudlogs_20231214-2147_node1.zip=d1f290fb42c981935e1142ec059c2dbba8be2e0a9ffebc9eea83a6336abe2eed}"
}
dbaascli execution completed
# dbaascli diag collect --objectStoreBucketUri https://objectstorage.us-phoenix-1.oraclecloud.com/p/aL-IbIKQ1j6lWNftJc2rLoLh6o9bJgbZm8z0S--BeVuXaipSEEMISrSCfFrVEolG/n/intexadatateam/b/diag_collect_test/o/
DBAAS CLI version 24.1.1.0.0
Executing command diag collect --objectStoreBucketUri https://objectstorage.us-phoenix-1.oraclecloud.com/p/aL-IbIKQ1j6lWNftJc2rLoLh6o9bJgbZm8z0S--BeVuXaipSEEMISrSCfFrVEolG/n/intexadatateam/b/diag_collect_test/o/
Job id: 028151b7-cbc4-409a-9ec6-69affe10f3bb
Session log: /var/opt/oracle/log/diag/collect/dbaastools_2023-12-14_09-51-36-PM_2963.log
Loading PILOT...
Session ID of the current execution is: 20
Log file location: /var/opt/oracle/log/diag/collect/pilot_2023-12-14_09-51-40-PM_3555
-----------------
..
---------- DIAG COLLECT PLUGIN RESULT ----------
{
  "collectedArchive with SHA256 CheckSum" : "{/var/opt/oracle/dbaas_acfs/diag_collect/artifacts_diag_cloudlogs_20231214-2151/diag_cloudlogs_20231214-2151_node1.zip=71633e13ccd06de15cb26850bb0266cf0d869e259550515c5b1fb734c487b470}"
}
dbaascli execution completed

Ejemplos de realización de una comprobación del sistema

Utilice el comando dbaascli dbaascli diag healthcheck para realizar una comprobación del sistema en todos los nodos del sistema.

Consulte dbaascli diag healthcheck para obtener información detallada sobre la sintaxis en la referencia de comandos dbaascli. 

# dbaascli diag healthcheck                
DBAAS CLI version MAIN
Executing command diag healthcheck
INFO: Starting diag healthcheck
INFO: Collected diag logs at: /var/opt/oracle/dbaas_acfs/diag_cloudlogs_20210322-2246.tar.gz
# dbaascli diag healthcheck --destLocation /tmp/test
DBAAS CLI version MAIN
Executing command diag healthcheck --destLocation /tmp/test
INFO: Starting diag healthcheck
INFO: Collected diag logs at: /tmp/test/diag_cloudlogs_20210322-2250.tar.gz
# dbaascli diag healthcheck --nodes rbcl1,rbcl2                   
DBAAS CLI version MAIN
Executing command diag healthcheck --nodes rbcl1,rbcl2
INFO: Starting diag healthcheck
INFO: Collected diag logs at: /var/opt/oracle/dbaas_acfs/diag_cloudlogs_20210421-1915.tar.gz
# dbaascli diag healthcheck --objectStoreBucketUri https://objectstorage.us-phoenix-1.oraclecloud.com/p/t0Z-kRV5pSmFzqnf-y5XhaAbM4LS82epeBnulKnCr31IeHVjxI9tOkntLF2kq7fP/n/MyNamespace/b/MyParBucket/o/
DBAAS CLI version MAIN
Executing command diag healthcheck --objectStoreBucketUri https://objectstorage.us-phoenix-1.oraclecloud.com/p/t0Z-kRV5pSmFzqnf-y5XhaAbM4LS82epeBnulKnCr31IeHVjxI9tOkntLF2kq7fP/n/MyNamespace/b/MyParBucket/o/
INFO: Collected diag logs at: https://objectstorage.us-phoenix-1.oraclecloud.com/p/t0Z-kRV5pSmFzqnf-y5XhaAbM4LS82epeBnulKnCr31IeHVjxI9tOkntLF2kq7fP/n/MyNamespace/b/MyParBucket/o/diag_cloudlogs_20210421-1839.tar.gz

Actualización de las herramientas en la nube mediante dbaascli

Para actualizar la versión de herramientas en la nube para Oracle Exadata Database Service on Dedicated Infrastructure, complete este procedimiento.

Se utilizan herramientas específicas de la nube en las máquinas virtuales de invitado de Exadata Cloud Infrastructure para operaciones locales, incluidos los comandos dbaascli.

Oracle actualiza automáticamente las herramientas en la nube cuando hay nuevas versiones disponibles. Si es necesario, puede seguir los pasos que se indican a continuación para asegurarse de que dispone de la versión más recientes de las herramientas específicas de la nube en todas las máquinas virtuales del cluster de VM.
Nota

Puede actualizar las herramientas específicas de la nube mediante la descarga y la aplicación de un paquete de software que contiene las herramientas actualizadas.
  1. Conéctese a una máquina virtual como usuario opc.

    Para obtener instrucciones detalladas, consulte Conexión a una máquina virtual con SSH.

  2. Inicie un shell de comandos de usuario root:
    sudo -s
  3. Para actualizar a la versión de las herramientas en la nube más reciente que esté disponible, ejecute el siguiente comando: 
    dbaascli admin updateStack

    El comando se encarga de actualizar la versión de herramientas en la nube en todos los nodos del cluster.

    Para obtener más información y otras opciones disponibles, consulte dbaascli admin updateStack --help.

Creación de una base de datos duplicada

Uso de dbaascli para duplicar una base de datos en la nube

Puede crear una base de datos duplicada mediante dbaascli. Esta nueva base de datos puede estar en la misma región de nube que la región de origen o en todas las regiones. En los siguientes pasos se describe cómo crear una base de datos duplicada en la nube.

Nota

Si una base de datos está configurada con OCI Vault para el cifrado de TDE y desea duplicar una base de datos, consulte las siguientes secciones.

Preparación para la duplicación

Asegúrese de que se cumplen los siguientes requisitos previos:

  • Asegúrese de que hay una configuración de ruta de red para acceder a la base de datos origen a través de la cadena EZConnect.
  • Copie el archivo de cartera de TDE (ewallet.p12 ) en el nodo de base de datos de destino. Nodo en el que decide ejecutar el comando dbaascli.
  • Cree un directorio raíz de Oracle en el nodo de destino si es necesario. La versión del directorio raíz de Oracle debe ser la misma que la del origen o de una versión de RU superior.

Ejecutar comprobaciones de requisitos

Para ejecutar comprobaciones de requisitos, utilice la opción de comando --executePrereqs. Solo realizará las comprobaciones de requisitos sin realizar la duplicación real de 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 la base de datos

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

Consideraciones sobre el uso de OCI Vault para la gestión de claves

Esta sección solo se aplica en el caso de que la base de datos esté configurada con OCI Vault para el cifrado de TDE y desee duplicar una base de datos.

Duplicación de una base de datos en la misma región

  • Requisitos previos adicionales

    Asegúrese de configurar las políticas de acceso de OCI Vault para los nodos de base de datos de destino. Los nodos de base de datos de destino deben poder acceder al almacén de claves de OCI de la base de datos de origen junto con su nuevo almacén de claves (si se decide utilizar un almacén de claves independiente).

  • Ejecutar comprobaciones de requisitos
    dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID> --executePrereqs
  • Duplicar la base de datos
    dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID>

    Una vez completado correctamente este comando, la base de datos se duplica.

Duplicación de una base de datos entre regiones

  • Requisitos previos adicionales
  • Ejecutar comprobaciones de requisitos
    dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID> --executePrereqs
  • Duplicar la base de datos
    dbaascli database duplicate --dbName <database name> --oracleHome <Oracle Home Path> --sourceDBConnectionString <source database EZConnect string> --sourceDBTDEWalletLocation <location of copied wallet> --sourceDBTdeConfigMethod KMS --sourceDBKMSKeyOCID <Source Database OCI Vault key OCID> --tdeConfigMethod KMS --kmsKeyOCID <OCI Vault key OCID>

    Una vez completado correctamente este comando, la base de datos se duplica.

Duplicación de una base de datos local

Con dbaascli, puede duplicar una base de datos local en la nube. Esto se puede hacer con el comando dbaascli database duplicate. Con este comando se crea una nueva base de datos en la nube, que es un duplicado de una base de datos local junto con sus datos. Mientras se lleva a cabo este proceso, la base de datos local sigue estando operativa. Puede migrar sus aplicaciones a la base de datos duplicada en la nube después de la verificación debida.

Preparación para la duplicación

El proceso de migración incluye los siguientes requisitos previos que se deben cumplir.
  • Asegúrese de que hay una configuración de ruta de red para acceder a una base de datos local desde el nodo de OCI a través de la cadena EZConnect.
  • Si una base de datos local está configurada con TDE, copie el archivo de cartera de TDE (ewallet.p12) en el nodo de OCI, donde decide ejecutar el comando dbaascli.
  • Cree un directorio raíz de Oracle en el nodo de OCI si es necesario. La versión del directorio raíz de Oracle debe ser la misma que la del origen o de una versión de RU superior.

Verificar los RPM necesarios

Este proceso requiere una versión de RPM dbaastools mínima de 23.3.2.0.0, pero siempre se recomienda actualizar a las últimas RPM dbaastools.

  • Para comprobar la versión instalada actualmente, ejecute:
    dbaascli --version
DBAAS CLI version 23.3.2.0.0
  • Para aplicar el RPM de las herramientas más recientes, como usuario root, ejecute:
    # dbaascli admin updateStack

Ejecutar las comprobaciones de requisitos

Para ejecutar las comprobaciones de requisitos, utilice la opción de comando --executePrereqs. Solo realizará las comprobaciones de requisitos sin realizar la duplicación real de Oracle Database.

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

Duplicar la base de datos

Duplique la base de datos con el siguiente comando:

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

Por ejemplo:

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

Una vez completado correctamente este comando, la base de datos se duplica en la nube y está lista para realizar comprobaciones de validez para el uso de la aplicación. Una vez realizada la verificación, las conexiones de aplicaciones se pueden migrar a la base de datos en la nube.

Consulte dbaascli database duplicate –help para obtener más opciones de configuración.

Pocas consideraciones sobre migración

  • Si prefiere asignar varios canales para el duplicado de RMAN, puede hacerlo especificando el argumento --rmanParallelism.
  • Exadata Cloud Service configura la memoria de la base de datos como gestión automática de memoria compartida (ASMM). Si la base de datos local está configurada con una gestión de memoria diferente, asegúrese de ajustar los valores de parámetros de memoria según corresponda en el lado de OCI proporcionando valores para --sgaSizeInMB y --pgaSizeInMB.
  • Verifique que la base de datos local no contenga parámetros de inicialización anticuados o no válidos.
  • Los parámetros de inicialización de la base de datos relacionados con el almacenamiento de la base de datos (ubicación del archivo de datos, ubicación de redo, destino del área de recuperación, multiplexación del archivo de control) se pueden cambiar mediante el argumento --initParams.

    Por ejemplo, para sustituir el valor db_create_online_log_dest para la base de datos duplicada: --initParams db_create_online_log_dest_1=+DATAC1,db_create_online_log_dest_2=+RECOC1

Solución de problemas de duplicación de base de datos

  • El archivo log de operaciones dbaascli se puede encontrar en /var/opt/oracle/log/<dbname>/database/duplicate
  • Uno de los trabajos del duplicado es ejecutar dbca. Su archivo log se puede encontrar en /u02/app/oracle/cfgtoollogs/dbca y /u02/app/oracle/cfgtoollogs/dbca/<dbuniquename>.

Si la operación falla, tendrá la opción de reanudar la operación proporcionando el argumento --resume al mismo comando. También puede limpiar la base de datos con dbaascli database delete –dbname <dbname> –force y, a continuación, volver a ejecutar el comando de duplicación de base de datos.

Notas de la versión

Revise los cambios realizados en varias versiones de dbaascli.

Tema principal: Uso de la utilidad dbaascli en Exadata Cloud Infrastructure

Versión 25.2.1.0.0 (250522)

  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 25.1.2.0.0 (250325)

  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 25.1.1.0.0 (250107)

  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 24.4.1.0.0 (241104)

  • Se ha mejorado dbaascli database getDetails para incluir los detalles de tde encryption. El comando dbaascli tde status ahora está en desuso.
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 24.3.2.0.0 (240828)

  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 24.3.1.0.0 (240711)

  • Migración de TDE de sqlnet.ora a wallet_root en la actualización de la base de datos a la versión 19c
  • Parche de cuadrícula en el lugar para utilizar la aplicación de parches basada en imágenes como modo por defecto
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 24.2.1.0.0 (240530)

  • Se ha agregado soporte para Oracle Database 23ai.
  • Mejoras en el área de copia de seguridad y recuperación con Zero Data Loss Autonomous Recovery Service (ZRCV) como destino de copia de seguridad.
  • Varias correcciones de bugs y mejoras en la estabilidad.

Tema principal: Notas de la versión

Versión 24.1.2.0.0 (240306)

  • Se ha introducido un nuevo flujo de trabajo optimizado para las operaciones de Data Guard
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

24.1.0.0 (231219)

  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

23.4.1.0.0 (231102)

  • Copia de seguridad y recuperación: la ventana de recuperación de copia de seguridad mínima se ha cambiado a 7 días. Si bien la automatización de partes de copia de seguridad obsoletas considera que la ventana de recuperación es de 7 días si detecta un valor inferior a 7 del sistema.
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 23.3.2.0.0 (230921)

  • Operaciones de base de datos conectable
    • Se ha agregado soporte para definir el OCID de la versión de clave personalizada (Traiga su propia clave - BYOK) de OCI Vault durante las operaciones de creación y clonación. Para obtener más información, consulte la ayuda de los comandos de PDB correspondientes.
  • Aplicación de parches en Grid Infrastructure (GI)
    • Se ha mejorado el flujo de trabajo de aplicación de parches para mejorar el tiempo de aplicación de parches, especialmente en entornos con un gran número de bases de datos.
    • Se introduce una nueva opción --patchInParallel que se puede utilizar para aplicar parches a nodos remotos en paralelo.
  • Aplicación de parches de base de datos
    • Opción proporcionada para ejecutar datapatch en un nodo específico del cluster.
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 23.3.1.0.0 (230712)

  • Nuevos comandos dbaascli
    • dbaascli gridHome create: este comando se puede utilizar para crear un directorio raíz de Grid Infrastructure de una versión soportada. Para obtener más información, consulte dbaascli gridHome create --help.
    • dbaascli system getGridHomes: este comando proporciona detalles sobre los directorios raíz de Grid Infrastructure disponibles en el sistema. Para obtener más información, consulte dbaascli system getGridHomes --help.
    • dbaascli admin updateAHF: este comando se puede utilizar para actualizar AHF a una versión certificada para la nube especificada de AHF. Sin embargo, se recomienda que las actualizaciones de AHF se gestionen implícitamente mediante la automatización en la nube. Para obtener más información, consulte dbaascli admin updateAHF --help.
  • Operaciones de base de datos conectable
    • Mejoras en el área del ciclo de vida de la base de datos conectable de refrescamiento.
  • Copia de seguridad y recuperación de base de datos
    • Se ha agregado soporte para configurar copias de seguridad en ubicaciones en espera en caso de configuraciones de dataguard. La configuración de las copias de seguridad es específica de la ubicación de Data Guard, es decir, el cambio de roles (por ejemplo, con la operación de switchover de Data Guard) no afectará a las operaciones de copia de seguridad de la base de datos en las ubicaciones primaria o en espera. Las copias de seguridad, si se configuran en el sitio principal o en el sitio en espera, continuarán independientemente del cambio de rol.
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

23.2.1.0.0 (230503)

  • Mejoras relacionadas con el ciclo de vida de las bases de datos
    • Se ha introducido dbaascli grid removeTCPSCert para eliminar los certificados TCPS caducados. Para obtener más información, consulte dbaascli grid removeTCPSCert --help.
    • Se ha agregado la opción para excluir PDB específicas durante el duplicado de la base de datos. Para obtener más información, consulte el argumento skipPDBs en dbaascli database duplicate --help.
  • Copia de seguridad y recuperación de base de datos
    • Se ha cambiado el valor por defecto de FILES_PER_SET a 64 para las copias de seguridad de OSS. Esto se puede cambiar con dbaascli database backup --configure. Para obtener más información, consulte dbaascli database backup --help.
    • Las copias de seguridad de archive log continúan desde la ubicación en espera después del switchover de roles en entornos de Data Guard.
    • Para las copias de seguridad que no están gestionadas por Oracle, los programas para las copias de seguridad L0 y L1 no se crean por defecto. Se deben crear explícitamente mediante el comando dbaascli database backup --configure.
  • sysLens

    En la versión 23.2.1.0.0 (235503) se incluye un marco que recopila, analiza e informa datos de recursos del sistema para flotas ExaDB-D. Para obtener más información, consulte Gestión de sysLens.

  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 23.1.2.0.0 (230305)

  • Mejoras relacionadas con el ciclo de vida de las bases de datos
    • Se ha agregado la opción para crear plantillas de base de datos (plantillas de DBCA) en el almacén de objetos. Las plantillas de DBCA se pueden utilizar posteriormente para crear bases de datos. Para obtener más información, consulte dbaascli database createTemplate --help.
  • Operaciones de base de datos conectable
    • Se ha introducido el comando dbaascli pdb refresh para refrescar una base de datos conectable que se haya creado mediante la opción de refrescamiento manual. Para obtener más información, consulte dbaascli pdb refresh --help.
    • Se ha agregado una opción para convertir la base de datos conectable de refrescamiento en una base de datos conectable normal. Para obtener más información, consulte dbaascli pdb open --help.
    • Ahora, la creación de una base de datos conectable de refrescamiento requiere un usuario de base de datos de origen existente para la creación del enlace de base de datos con la base de datos conectable de origen. Para obtener más información, consulte el argumento dblinkUserName en dbaascli pdb remoteClone --help.
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 23.1.1.0.1 (230113)

  • Mejoras relacionadas con el ciclo de vida de las bases de datos
    • Se ha agregado soporte para crear una base de datos duplicada a partir de una base de datos de origen que utiliza servicios de OCI Vault para la gestión de claves de cifrado.
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 22.4.1.0.1 (221122)

  • Operaciones de base de datos conectable
    • Se ha agregado la opción para no abrir la PDB al final de la reubicación. Para obtener más información, consulte el argumento skipOpenPDB en dbaascli pdb relocate --help. Después de utilizar esta opción, la reubicación de la pdb se puede completar ejecutando el comando con el argumento completePDBRelocate.
    • Opción agregada para limpiar los metadatos/servicios de PDB reubicados en la ubicación de origen. Para obtener más información, consulte el argumento cleanupRelocatedPDB en dbaascli pdb delete --help
  • Nuevos comandos dbaascli
    • dbaascli database createTemplate: este comando se puede utilizar para crear plantillas de base de datos (plantillas de DBCA) que se pueden utilizar posteriormente para crear bases de datos. Las plantillas de DBCA se utilizan ampliamente para crear una base de datos de clonación con DBCA, una herramienta que se incluye con el software del servidor de Oracle Database. Para obtener más información, consulte dbaascli database createTemplate --help
    • Se ha introducido dbaascli tde rotateMasterKey para rotar la clave maestra para el cifrado de la base de datos. Para obtener más información, consulte dbaascli tde rotateMasterKey --help. El comando dbaascli tde rotate masterkey ahora está en desuso.
  • Mejoras relacionadas con el ciclo de vida de las bases de datos
    • Se ha agregado soporte para utilizar plantillas de dbca en flujos de trabajo de creación de bases de datos. Para obtener más información, consulte el argumento dbcaTemplateFilePath en dbaascli database create --help
    • Rendimiento mejorado para la creación de bases de datos duplicadas. Para obtener más información sobre cómo crear una base de datos duplicada, consulte dbaascli database duplicate --help
    • Se ha agregado soporte para crear una base de datos duplicada a partir de una base de datos de origen que no está cifrada con TDE.
  • Gestión de TDE
    • Se ha introducido dbaascli tde rotateMasterKey para rotar la clave maestra para el cifrado de la base de datos. Para obtener más información, consulte dbaascli tde rotateMasterKey --help. El comando dbaascli tde rotate masterkey ahora está en desuso.
    • Flujo de trabajo renovado para todas las operaciones de TDE. Para obtener más información, consulte dbaascli tde --help
  • Aplicación de parches en Grid Infrastructure (GI)
    • Se ha agregado soporte para permitir la ejecución en paralelo de la operación de aplicación de parches en los nodos. Esta opción se debe aplicar con cuidado, ya que genera una menor disponibilidad de la base de datos.
  • Copia de seguridad y recuperación de base de datos
    • Flujo de trabajo renovado para crear una base de datos a partir de copias de seguridad independientes
  • Incluye AHF versión 22.2.4
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 22.3.1.1.0 (221003)

  • Nuevos comandos dbaascli
    • dbaascli database getDetails: este comando muestra la información detallada de una base de datos determinada, por ejemplo, el nombre de base de datos, la información de nodo, la información de las bases de datos conectables, etc. Para obtener más información, consulte dbaascli database getDetails --help.
  • Operaciones de base de datos conectable
    • Se ha agregado soporte para crear bases de datos conectables como clonación de refrescamiento mediante el argumento refreshablePDB. Para obtener más información, consulte dbaascli pdb remoteClone --help.
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 22.3.1.0.1 (220721)

  • Nuevos comandos de ciclo de vida de base de datos
    • dbaascli database addInstance: este comando se puede utilizar para agregar una instancia de base de datos a uno de los nodos del cluster en el que la base de datos no está configurada aún. Para obtener más información, consulte dbaascli database addInstance --help.
    • dbaascli database deleteInstance: este comando se puede utilizar para suprimir una instancia de base de datos de uno de los nodos del cluster en el que está configurada la base de datos. Para obtener más información, consulte dbaascli database deleteInstance --help.
    • dbaascli database duplicate: este comando se puede utilizar para crear una nueva base de datos a partir de una base de datos existente dentro de un cluster o entre clusters, siempre que exista una conexión de red entre los clusters. Para obtener más información, consulte dbaascli database duplicate --help.
  • Biblioteca de software en la nube
    • Se ha introducido el comando dbaascli cswlib listLocal para mostrar las imágenes que se descargan de la biblioteca de software localmente en el sistema. Para obtener más información, consulte dbaascli cswlib listLocal --help El comando dbaascli dbimage list ahora está en desuso.
    • Se ha introducido el comando dbaascli cswlib deleteLocal para suprimir imágenes que se descargan de la biblioteca de software en la nube. Para obtener más información, consulte dbaascli cswlib deleteLocal --help El comando dbaascli dbImage purge ahora está en desuso.
  • La ubicación del log del comando dbaascli admin updateStack se ha cambiado para seguir la convención de otros comandos dbaascli. Los logs se pueden encontrar convenientemente en el directorio /var/opt/oracle/log/admin/updateStack. La ubicación anterior era /var/opt/oracle/log/tooling/Update.
  • La ayuda de dbaascli ahora tiene en cuenta la plataforma en la nube en el sentido de que mostrará la salida de ayuda de los comandos aplicables para el entorno en la nube en el que esté operando.
  • Se ha agregado soporte para cambiar la contraseña de TDE en entornos de Dataguard. Para obtener más información, consulte dbaascli tde changePassword --help. Esta compatibilidad no está disponible actualmente para la versión 11.2.0.4.
  • Se ha incluido AHF versión 22.1.5.
  • Se ha renovado el flujo de trabajo para la operación de cambio de versión de base de datos.
  • Se ha renovado el flujo de trabajo para la operación de creación del directorio raíz de base de datos.
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 22.2.1.1.0 (220623)

  • Se ha incluido AHF versión 22.1.1
  • Se ha corregido una incidencia por la que la actualización de rpm de dbaastools en el sistema podría provocar tiempo de inactividad de base de datos con el error ORA-600
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 22.2.1.1.0 (220609)

  • Nuevos comandos dbaascli:
    • dbaascli dbHome getDatabases: este comando muestra todas las bases de datos que se ejecutan desde un directorio raíz de Oracle de base de datos determinado. La salida se devuelve en formato JSON para facilitar la automatización. Para obtener más información, consulte dbaascli dbHome getDatabases --help.
    • dbaascli database getPDBs: este comando muestra todas las bases de datos conectables de una base de datos de contenedores determinada. La salida se devuelve en formato JSON para facilitar la automatización. Para obtener más información, consulte dbaascli database getPDBs --help.
    • dbaascli dbHome delete: este comando suprime un directorio raíz de Oracle de base de datos determinado. Para obtener más información, consulte dbaascli dbHome delete --help.
    • dbaascli dataguard prepareStandbyBlob: este comando genera un archivo blob que contiene varios archivos necesarios en la ubicación de la base de datos en espera para un entorno de Data Guard. Para obtener más información, consulte dbaascli dataguard prepareStandbyBlob --help.
  • Aplicación de parches en Grid Infrastructure (GI):
    • Nuevo flujo de trabajo optimizado
    • Se ha introducido una forma de crear la imagen de software de Grid Infrastructure (GI) antes de la aplicación de parches. Esta imagen de GI se puede utilizar posteriormente para realizar la operación de aplicación de parches de GI. La ventaja de este enfoque es que se reduce la ventana de aplicación de parches, ya que la imagen ya está preparada. La pila GI del nodo no se desactiva para crear la imagen. Para obtener más información, consulte la opción createImage en dbaascli grid patch --help
    • Se ha introducido una forma de aplicar parches en Grid Infrastructure mediante el uso de la imagen de software de GI especificada por el usuario, que se crea mediante la opción createImage del comando dbaascli grid patch. Para obtener más información, consulte la opción imageLocation en dbaascli grid patch --help.
  • Soporte para cambio de contraseña en el entorno de Data Guard:
    • Se ha agregado soporte para cambiar la contraseña en entornos de Data Guard. Para obtener más información, consulte dbaascli database changePassword --help y dbaascli dataguard prepareStandbyBlob --help
  • Configuración de Data Guard:
    • Se ha agregado soporte para actualizar los atributos de automatización de Data Guard (en el archivo /var/opt/oracle/dg/dg.conf). Para obtener más información, consulte dbaascli dataguard --help.
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 22.2.1.0.1 (220423)

  • Nuevos comandos dbaascli
    • Se ha introducido dbaascli admin showLatestStackVersion para mostrar la versión de dbaastools más reciente disponible para que los clientes la descarguen e instalen. La instalación de rpm de dbaastools se puede realizar mediante el comando dbaascli admin updateStack. Para obtener más información, consulte la sección "Referencia de comandos dbaascli".
  • Biblioteca de software en la nube
    • El soporte para la activación de BP (dbaascli cswlib activateBP) ya que los BP (paquetes de parches) ahora se han reemplazado por las RU ("actualizaciones de la versión"). El despliegue en la nube consume las RU en forma de imágenes de software que se identifican con "etiquetas de imagen". Por lo tanto, se recomienda utilizar etiquetas de imagen al interactuar con comandos de la biblioteca de software en la nube (cswlib). Para obtener más información, consulte dbaasscli cswlib download -help.
    • Se ha eliminado la necesidad de descargar imágenes de bases de datos no CDB para crear bases de datos no CDB. Ahora, los usuarios pueden crear la base de datos no CDB utilizando imágenes normales. Para obtener detalles, consulte la opción createAsCDB en dbaascli database create -help.
  • Creación de bases de datos no CDB
    • Se ha mejorado el flujo de trabajo de creación de base de datos para crear una base de datos no CDB utilizando una imagen de software de base de datos estándar. Para obtener detalles, consulte la opción createAsCDB en dbaascli database create -help.
  • Aplicación de paches en el directorio raíz de base de datos
    • Nuevo flujo de trabajo optimizado
  • Cambio de versión de Grid Infrastructure
    • Nuevo flujo de trabajo optimizado
  • Operaciones de base de datos conectable (PDB)
    • La supresión de una PDB en entornos de DataGuard requiere una confirmación explícita que indique que se han completado las operaciones necesarias en la ubicación de la base de datos en espera mediante la transferencia del argumento adicional -allStandByPrepared. Para obtener más información, consulte dbaascli pdb delete --help.
  • Capacidad sucesiva proporcionada para la operación de reinicio de la base de datos. Para obtener más información, consulte dbaascli database bounce -help.
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 22.1.1.2.0 (220405)

  • Se ha agregado soporte para ExaDB-D X9M
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 22.1.1.1.0 (220317)

  • Nuevos comandos dbaascli:
    • Se ha introducido dbaascli system getDBHomes para obtener todos los directorios raíz de Oracle de la base de datos en el cluster. La salida se devuelve en formato JSON para facilitar la automatización.
    • Se ha introducido dbaascli dbhome getDetails para obtener información detallada sobre un directorio raíz de Oracle específico. La salida se devuelve en formato JSON para facilitar la automatización.
  • Biblioteca de software en la nube (cswlib):
    • El soporte para el comando dbaascli cswlib list para operaciones de listado de la biblioteca de software en la nube ha quedado en desuso. El nuevo comando es dbaascli cswlib showImages, que muestra las imágenes junto con ImageTag. Se recomienda utilizar Image tags para descargar las imágenes de la biblioteca de software en la nube. Para obtener más información sobre las descargas mediante etiquetas de imagen, consulte dbaascli cswlib download –help.
    • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 22.1.1.0.1 (220223)

  • Cambio de versión de Grid Infrastructure
    • Nuevo flujo de trabajo optimizado
  • Copia de seguridad y recuperación de base de datos
    • Actualización interna del repositorio de metadatos para la copia de seguridad de los metadatos
    • Se han introducido mensajes de desuso para los comandos bkup_api, ya que ahora se han reemplazado por los comandos dbaascli. Para obtener más información, consulte "dbaascli database backup --help" y "dbaascli database restore -help"
  • Operaciones de base de datos conectable (PDB)
    • La operación de reubicación de PDB está ahora soportada. Para obtener más información, consulte "dbaascli pdb relocate -help".
    • Se ha renovado el flujo de trabajo para la conversión de una base de datos no CDB a una PDB. Para obtener más información, consulte "dbaascli database convertToPDB -help".
  • Gestión de claves de cifrado
    • Los parámetros de inicialización específicos de latido del cifrado de datos transparente (TDE) se definen en los valores recomendados de la nube para bases de datos con "claves gestionadas por el cliente".
  • Gestión de la biblioteca de software en la nube
    • Descarga de artefactos de biblioteca de software renovada mediante imageTags. Se recomienda utilizar imageTags para descargar las imágenes de software de base de datos y cuadrícula. Para obtener más información, consulte "dbaascli cswlib showimages" y "dbaascli cswlib download -help"
  • Se ha incluido AHF versión 21.4.2
  • Varias correcciones de bugs y mejoras en la estabilidad

Tema principal: Notas de la versión

Versión 21.4.1.1.0 (220209)

  • Se ha incluido AHF versión 21.4.1
  • Soluciones de bugs y mejoras de estabilidad

Tema principal: Notas de la versión

Versión 21.4.1.1.0

  • Se ha activado el cifrado de tablespaces de nivel de sistema (SYSTEM, SYSAUX, UNDO y TEMP) para las bases de datos que se crearán con esta versión de dbaastools en adelante. Esta función está activada para Oracle Database versión 19.6.0.0.0 y versiones posteriores.
  • Aplicación de parches de cuadrícula:
    • Se ha agregado la condición de requisito para comprobar que la propiedad del siguiente archivo es del usuario grid. 
      • <gi_home>/suptools/tfa/release/tfa_home/jlib/jdev-rt.jar
      • <gi_home>/suptools/tfa/release/tfa_home/jlib/jewt4.jar
  • Aplicación de parches de base de datos:
    • La operación database move simultánea no está permitida por defecto. Se ha introducido una nueva opción –allowParallelDBMove que se puede utilizar para sustituir el comportamiento por defecto de las versiones 12.2 y posteriores de Oracle Database.
    • Se han corregido incidencias relacionadas con el movimiento de las bases de datos en espera en modo MOUNT.
  • Copia de seguridad y recuperación de base de datos:
    • Se han agregado nuevas opciones de línea de comandos para la copia de seguridad de base de datos. Para obtener más información, consulte la referencia del comando dbaascli database backup.
    • Se han agregado nuevas opciones de línea de comandos para la recuperación de base de datos. Para obtener más información, consulte la referencia del comando dbaascli database Recovery.
    • El uso de bkup_api para las operaciones de copia de seguridad y recuperación quedará en desuso en el futuro.
    • Para alinearse con la práctica recomendada por Oracle de utilizar el privilegio administrativo SYSBACKUP para operaciones de copia de seguridad y recuperación, la automatización en la nube crea un usuario administrativo común C##DBLCMUSER con el rol SYSBACKUP en el nivel de contenedor CDB$ROOT. Por lo tanto, las operaciones de copia de seguridad y recuperación se realizan con el usuario que tiene el menor número de privilegios necesarios. Las credenciales de este usuario se generan aleatoriamente y se gestionan de forma segura mediante la automatización en la nube. Si el usuario no se encuentra o está LOCKED y EXPIRED, la automatización en la nube volverá a crear o a desbloquear este usuario durante la operación de copia de seguridad o recuperación. Este cambio en la automatización en la nube se aplica a partir de dbaastools versión 21.4.1.1.0.
  • Se ha mejorado la funcionalidad dbaascli resume para reanudar cualquier sesión anterior especificando el argumento –sessionID <value> en el comando de reanudación. El identificador de sesión se comparte en la salida dbaascli y en los logs.
  • Se ha mejorado la salida dbaascli help para mostrar el uso del comando.
  • El uso del shell dbaascli (sesión interactiva) ha quedado en desuso. A partir de marzo de 2022 no estará soportado. Se recomienda ejecutar comandos dbaascli completos en el símbolo del sistema, como se sugiere en todos los ejemplos del documento.
  • Se ha incluido Autonomous Health Framework (AHF) versión 21.2.8.
  • Varias correcciones de bugs y mejoras en la estabilidad.

Tema principal: Notas de la versión

Versión 21.3.1.2.0

  • Se ha mejorado la temporización de las operaciones dbaascli con una lógica de sincronización de metadatos de plano de control mejorada.
  • Se han mejorado los logs de dbaascli para tener información de nivel de milisegundos junto con el thread asociado.
  • Se han introducido más comprobaciones de requisitos en las operaciones de aplicación de parches en el directorio raíz de base de datos y traslado de base de datos para detectar posibles escenarios de fallos con sugerencias para la acción correctiva.
  • Las operaciones de aplicación de parches en base de datos ahora conservan el estado de las bases de datos para que sea el mismo que antes de la aplicación del parche. En el caso de las bases de datos conectables, se mantiene el estado guardado de la PDB.
  • Varias correcciones de bugs y mejoras en la estabilidad.

Tema principal: Notas de la versión

Versión 21.3.1.1.0

  • Se ha agregado soporte para desbloquear la cuenta de usuario administrador de PDB como parte de la creación de la PDB, operación localClone o remoteClone. Para obtener más información, consulte la opción --lockPDBAdminAccount en dbaascli pdb create --help.
  • Se ha corregido una incidencia que actualiza el recurso de base de datos registrado con Oracle Grid Infrastructure en entornos existentes con el valor correcto del nombre de base de datos.
  • Se han mejorado las operaciones de ciclo de vida de PDB.
  • Varias correcciones de bugs y mejoras en la estabilidad.

Tema principal: Notas de la versión

Versión 21.3.1.0.1

  • Soporte para los siguientes comandos dbaascli para que se ejecuten como usuario oracle.
    • dbaascli pdb bounce
    • dbaascli pdb close
    • dbaascli pdb connectString
    • dbaascli pdb create
    • dbaascli pdb delete
    • dbaascli pdb getDetails
    • dbaascli pdb list
    • dbaascli pdb localClone
    • dbaascli pdb open
    • dbaascli pdb remoteClone
  • Se ha renovado la aplicación de parches de base de datos externa. Para obtener más información, consulte dbaascli database move –help.
  • Mejoras relacionadas con la temporización del flujo de trabajo de aplicación de parches de Oracle Grid Infrastructure. Para obtener más información, consulte dbaascli grid patch –help.
  • El soporte para exadbcpatchmulti/dbaascli patch para las operaciones de aplicación de parches ha quedado en desuso. Los comandos dbaascli dbhome patch y dbaascli grid patch se proporcionan para la operación de aplicación de parches para directorios raíz de base de datos y Oracle Grid Infrastructure. Consulte las secciones Aplicación de parches en Oracle Grid Infrastructure y Creación de Oracle Database mediante dbaascli para obtener más información. Consulte también la sección Referencia de comandos dbaascli.
  • El soporte para el comando de parche de herramientas de dbaascli para proporcionar consistencia en las convenciones de comandos dbaascli ha quedado en desuso. El nuevo comando es dbaascli admin updateStack. Para obtener más información, consulte la sección Actualización de las herramientas en la nube mediante dbaascli.
  • Capacidad para ejecutar dbaascli en modo desconectado para operaciones de larga ejecución. Al ejecutar el comando dbaascli con --waitForCompletion false se obtiene un identificador de trabajo que se puede consultar posteriormente para obtener el estado de la operación mediante dbaascli job getStatus –jobid job_id. Resulta útil para operaciones de larga ejecución en las que los usuarios deseen recuperar el control inmediatamente después de la ejecución del comando. En esta versión, esta opción solo está disponible para el comando dbaascli database create. Se agregarán más comandos en versiones posteriores con este soporte. La salida de la ayuda de esos comandos reflejará el soporte de la opción --waitForCompletion.
  • El soporte para el shell de dbaascli ha quedado en desuso. Se recomienda que los usuarios ejecuten los comandos dbaascli completos en el símbolo del sistema, como se sugiere en todos los ejemplos del documento. La ejecución solo de dbaascli mostrará la salida de su ayuda de sintaxis en lugar de entrar en un shell de dbaascli.
  • Varias correcciones de bugs y mejoras en la estabilidad.

Tema principal: Notas de la versión

Versión 21.2.1.x.x

  • Se ha rediseñado la operación de aplicación de parches de Oracle Grid Infrastructure y se ha agregado la capacidad de reanudar a partir del punto de fallo, aplicar el parche en el subjuego de nodos o el vaciado de instancias, entre otras mejoras. Para obtener más información, consulte dbaascli grid patch --help. Consulte también la sección Aplicación de parches en Oracle Grid Infrastructure y Oracle Database mediante dbaascli.
  • El soporte para exadbcpatchmulti / dbaascli patch para las operaciones de aplicación de parches ha quedado en desuso. Los comandos dbaascli dbhome patch y dbaascli grid patch se proporcionan para la operación de aplicación de parches para directorios raíz de base de datos y Oracle Grid Infrastructure. Consulte la sección Aplicación de parches en Oracle Grid Infrastructure y Oracle Database mediante dbaascli para obtener más información. Consulte también la sección Referencia de comandos dbaascli.
  • El soporte para el comando dbaascli tools patch para proporcionar consistencia en las convenciones de comandos ha quedado en desuso. El nuevo comando es dbaascli admin updateStack.
  • Se han rediseñado las API de gestión de PDB para las operaciones de creación, clonación local y clonación remota. Para obtener más información, consulte dbaascli pdb --help.
  • Se ha rediseñado la API de supresión de base de datos. Para obtener más información, consulte dbaascli database delete --help.
  • Creación de dbhome renovada (soporte para imagen de software personalizada, operación de escalado horizontal). Para obtener más información, consulte dbaascli dbhome create --help.
  • Soporte para creación de base de datos en un subjuego de nodos de cluster. Para obtener más información, consulte dbaascli database create --help.
  • Capacidad para ejecutar dbaascli en modo desconectado para operaciones de larga ejecución. Al ejecutar el comando dbaascli con --waitForCompletion false se obtiene un identificador de trabajo que se puede consultar posteriormente para obtener el estado de la operación mediante dbaascli job getStatus –jobid job_id. Resulta útil para operaciones de larga ejecución en las que los usuarios deseen recuperar el control inmediatamente después de la ejecución del comando. En esta versión, esta opción solo está disponible para el comando dbaascli database create. Se agregarán más comandos en versiones posteriores con este soporte. La salida de la ayuda de esos comandos reflejará el soporte de la opción --waitForCompletion.
  • Se ha mejorado la experiencia de aplicación de parches en dbhome con la introducción de varias opciones como skipPDBs, continueWithDowntime, etc. Para obtener más información, consulte dbaascli dbhome patch --help.
  • Soporte para recopilación de diagnósticos mejorada. Para obtener más información, consulte dbaascli diag collect --help.
  • Pequeñas mejoras en el área de automatización del cambio de versión de base de datos.
  • Varias correcciones de bugs y mejoras en la estabilidad.

Tema principal: Notas de la versión

Referencia de comandos dbaascli

Debe utilizar dbaascli para crear bases de datos e integrarlas con el marco de automatización en la nube.

dbaascli es una interfaz nativa en la nube que puede aceptar plantillas de DBCA como entradas, llama a la funcionalidad de DBCA para crear bases de datos y, a continuación, llama a las API de OCI para integrar la base de datos en el marco de automatización en la nube. Los clientes que utilicen actualmente DBCA en los scripts pueden actualizar sus scripts existentes para llamar a dbaascli en lugar de a DBCA. Si no se puede utilizar dbaascli porque una función concreta de DBCA no está disponible en dbaascl, los clientes deben abrir una solicitud de My Oracle Support (MOS) para agregar esa funcionalidad a dbaascli.

Para usar la utilidad dbaascli, debe estar conectado a un nodo de cálculo de Exadata Cloud Infrastructure. Consulte Conexión a una instancia de Exadata Cloud Infrastructure para obtener instrucciones.

Algunos comandos dbaascli se pueden ejecutar como usuario oracle u opc, pero muchos comandos requieren los privilegios del administrador root. Consulte cada comando para conocer los requisitos específicos.

  • dbaascli admin updateAHF
    Para instalar o actualizar el marco de estado autónomo (AHF), utilice el comando dbaascli admin updateAHF.
  • dbaascli admin updateStack
    Para instalar o actualizar un RPM de dbaastools, utilice el comando dbaascli admin updateStack.
  • dbaascli cswlib deleteLocal
    Para suprimir la imagen local, utilice el comando dbaascli cswlib deleteLocal.
  • dbaascli cswlib download
    Para descargar las imágenes de software disponibles y hacer que estén disponibles en el entorno de Exadata Cloud Infrastructure, utilice el comando dbaascli cswlib download.
  • dbaascli cswlib listLocal
    Para ver la lista de imágenes de Database y Grid Infrastructure disponibles localmente, utilice el comando dbaascli cswlib listLocal.
  • dbaascli cswlib showImages
    Para ver la lista de imágenes de base de datos y de Grid Infrastructure disponibles, utilice el comando dbaascli cswlib showImages.
  • dbaascli database addInstance
    Para agregar la instancia de base de datos en el nodo especificado, utilice el comando dbaascli database addInstance.
  • dbaascli database backup
    Para configurar Oracle Database con un destino de almacenamiento de copia de seguridad, realizar copias de seguridad de base de datos, consultar copias de seguridad y suprimir una copia de seguridad, utilice el comando dbaascli database backup.
  • devolución de base de datos dbaascli
    Para cerrar y reiniciar una base de datos de Exadata Cloud Infrastructure especificada, utilice el comando dbaascli database bounce.
  • cambiar contraseña de base de datos dbaascli
    Para cambiar la contraseña de un usuario de Oracle Database especificado, utilice el comando dbaascli database changePassword. Cuando se le solicite, introduzca el nombre de usuario para el que desea cambiar la contraseña y, a continuación, introduzca la contraseña.
  • dbaascli database convertToPDB
    Para convertir la base de datos no CDB especificada a PDB, utilice el comando dbaascli database convertToPDB.
  • dbaascli database create
    Para crear una instancia de Oracle Database, utilice el comando dbaascli database create. Cuando se le solicite, introduzca las contraseñas sys y tde.
  • dbaascli database delete
    Para suprimir una instancia de Oracle Database, utilice el comando dbaascli database delete.
  • dbaascli database deleteInstance
    Para suprimir la instancia de base de datos en el nodo especificado, utilice el comando dbaascli database deleteInstance.
  • dbaascli database duplicate
    Para crear una base de datos a partir de una base de datos activa, utilice el comando dbaascli database duplicate.
  • dbaascli database getDetails
    Este comando muestra la información detallada de una base de datos determinada, por ejemplo, el nombre de base de datos, la información de nodo, la información de las bases de datos conectables, etc.
  • dbaascli database getPDBs
    Para ver la lista de todas las bases de datos conectables en una base de datos de contenedores, utilice el comando dbaascli database getPDBs.
  • dbaascli database modifyParameters
    Para modificar o restablecer los parámetros de inicialización de Oracle Database, utilice el comando dbaascli database modifyParameters.
  • dbaascli Database Move
    Para mover la base de datos de un directorio raíz a otro, utilice el comando dbaascli database move.
  • dbaascli database recover
    Para recuperar una base de datos, utilice el comando dbaascli database recover.
  • dbaascli database runDatapatch
    Para aplicar un parche en una instancia de Oracle Database, utilice el comando dbaascli database runDatapatch.
  • dbaascli database createTemplate
    Utilice este comando para crear plantillas de base de datos (plantillas de DBCA) que se pueden utilizar posteriormente para crear bases de datos.
  • dbaascli database start
    Para iniciar una instancia de Oracle Database, utilice el comando dbaascli database start.
  • dbaascli database status
    Para comprobar el estado de una instancia de Oracle Database, utilice el comando dbaascli database status.
  • dbaascli database stop
    Para parar una instancia de Oracle Database, utilice el comando dbaascli database stop.
  • dbaascli database upgrade
    Para cambiar la versión de Oracle Database, utilice el comando dbaascli database upgrade.
  • 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.
  • dbaascli dataguard updateDGConfigAttributes
    Para actualizar los atributos de automatización de Data Guard en todos los nodos del cluster, utilice el comando dbaascli dataguard updateDGConfigAttributes.
  • conmutación por error de dataguard dbaascli
    Para realizar un failover manual a la base de datos en espera, utilice el comando dataguard failover.
  • dbaascli dataguard reinstate
    Para volver a instanciar una base de datos con fallos como base de datos en espera después de un failover, utilice el comando dataguard reinstate.
  • dbaascli dataguard switchover
    Para realizar un switchover a la base de datos en espera, utilice el comando dataguard switchover.
  • dbaascli dataguard prepareForStandby
    Para crear una base de datos en espera de Oracle, utilice el comando dbaascli dataguard prepareForStandby como primer paso.
  • dbaascli dataguard configureStandby
    Para crear una nueva base de datos en espera, utilice el comando dbaascli dataguard configureStandby como un segundo paso después del paso prepareForStandby.
  • 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.
  • 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.
  • 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.
  • 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.
  • dbaascli dbhome create
    Para crear un directorio raíz de Oracle Database de la versión deseada, utilice el comando dbaascli dbhome create.
  • dbaascli dbHome delete
    Para suprimir un directorio raíz de Oracle Database determinado, utilice el comando dbaascli dbHome delete.
  • dbaascli dbhome getDatabases
    Para ver la información sobre todas las instancias de Oracle Database que se ejecutan desde un directorio raíz de Oracle de base de datos determinado, utilice el comando dbaascli dbHome getDatabases. Especifique la ubicación del directorio raíz de Oracle o el nombre del directorio raíz de Oracle.
  • dbaascli dbHome getDetails
    Para ver información sobre un directorio raíz de Oracle específico, utilice el comando dbaascli dbHome getDetails. Especifique la ubicación del directorio raíz de Oracle o el nombre del directorio raíz de Oracle.
  • dbaascli dbHome patch
    Para aplicar un parche en el directorio raíz de Oracle de un nivel de parche a otro, utilice el comando dbaascli dbHome patch.
  • dbaascli dbimage purge
    El comando dbimage purge elimina la imagen de software especificada del entorno de Exadata Cloud Infrastructure.
  • dbaascli diag collect
    Para recopilar diagnósticos, utilice el comando dbaascli diag collect.
  • dbaascli diag healthCheck
    Para ejecutar comprobaciones del sistema de diagnóstico, utilice el comando dbaascli diag healthCheck.
  • dbaascli gridHome create
    Para configurar el directorio raíz de Grid Infrastructure, utilice el comando dbaascli gridHome create.
  • dbaascli grid configureTCPS
    Para configurar TCPS para el cluster existente, utilice el comando dbaascli grid configureTCPS.
  • dbaascli grid patch
    Para aplicar un parche en Oracle Grid Infrastructure a la versión secundaria especificada, utilice el comando dbaascli grid patch.
  • dbaascli grid removeTCPSCert
    Para eliminar certificados TCPS existentes de la cartera de Grid Infrastructure, utilice el comando dbaascli grid removeTCPSCert.
  • dbaascli grid rotateTCPSCert
    Para rotar certificados TCPS, utilice el comando dbaascli grid rotateTCPSCert.
  • dbaascli grid upgrade
    Para cambiar la versión de Oracle Grid Infrastructure de una versión principal a otra, utilice el comando dbaascli grid upgrade.
  • dbaascli job getStatus
    Para ver el estado de un trabajo especificado, utilice el comando dbaascli job getStatus.
  • dbaascli patch db apply
  • dbaascli patch db prereq
  • dbaascli pdb backup
    Para realizar una copia de seguridad de una base de datos conectable (PDB), consultar copias de seguridad de PDB y suprimir una copia de seguridad de PDB, utilice el comando dbaascli pdb backup.
  • dbaascli pdb bounce
    Para reiniciar una base de datos conectable (PDB), utilice el comando dbaascli pdb bounce.
  • dbaascli pdb close
    Para cerrar una base de datos conectable (PDB), utilice el comando dbaascli pdb close.
  • dbaascli pdb getConnectString
    Para mostrar la información de la cadena de conexión de Oracle Net para una base de datos conectable (PDB), ejecute el comando dbaascli pdb getConnectString.
  • dbaascli pdb create
    Para crear una nueva base de datos conectable (PDB), utilice el comando dbaascli pdb create.
  • dbaascli pdb delete
    Para suprimir una base de datos conectable (PDB), ejecute el comando dbaascli pdb delete.
  • dbaascli pdb getDetails
    Para ver los detalles de una base de datos conectable (PDB), utilice el comando dbaascli pdb getDetails.
  • dbaascli pdb list
    Para ver la lista de bases de datos conectables (PDB) en una base de datos de contenedores, utilice el comando dbaascli pdb list.
  • dbaascli pdb localClone
    Para crear una nueva base de datos conectable (PDB) como un clon de una PDB existente en la misma base de datos de contenedores (CDB), utilice el comando dbaascli pdb localClone.
  • dbaascli pdb open
    Para abrir una base de datos conectable (PDB), utilice el comando dbaascli pdb open.
  • dbaascli pdb recover
    Para recuperar una base de datos conectable (PDB), utilice el comando dbaascli pdb recover.
  • dbaascli pdb refresh
    Para crear una nueva base de datos conectable (PDB), utilice el comando dbaascli pdb refresh.
  • dbaascli pdb relocate
    Para reubicar la PDB especificada desde la base de datos remota a la base de datos local, utilice el comando dbaascli pdb relocate.
  • dbaascli pdb remoteClone
    Para crear una nueva base de datos conectable (PDB) como un clon de una PDB existente en otra base de datos de contenedores (CDB), utilice el comando dbaascli pdb remoteClone.
  • dbaascli system getDBHomes
    Para ver información sobre todos los directorios raíz de Oracle, utilice el comando dbaascli system getDBHomes.
  • dbaascli system getGridHomes
    Para mostrar los detalles de todos los directorios raíz de Grid, utilice el comando dbaascli system getGridHomes.
  • dbaascli tde changePassword
    Para cambiar la contraseña del almacén de claves de TDE y la contraseña de la cartera de base de datos para el alias tde_ks_passwd, utilice el comando dbaascli tde changePassword.
  • dbaascli tde addSecondaryHsmKey
    Para agregar una clave de HSM (KMS) secundaria a la configuración de HSM (KMS) existente, utilice el comando dbaascli tde addSecondaryHsmKey.
  • dbaascli tde enableWalletRoot
    Para activar el parámetro de spfile wallet_root para la base de datos existente, utilice el comando dbaascli tde enableWalletRoot.
  • dbaascli tde encryptTablespacesInPDB
    Para cifrar todos los tablespaces en la PDB especificada, utilice el comando dbaascli tde encryptTablespacesInPDB.
  • dbaascli tde fileToHsm
    Para convertir TDE basado en FILE en TDE basado en HSM (KMS/OKV), utilice el comando dbaascli tde fileToHsm.
  • dbaascli tde getHsmKeys
    Para obtener los detalles de la clave activa de TDE, utilice el comando dbaascli tde getHsmKeys.
  • dbaascli tde getMkidForKeyVersionOCID
    Para obtener el identificador de clave maestra asociado al OCID de la versión de clave KMS, utilice el comando dbaascli tde getMkidForKeyVersionOCID.
  • dbaascli tde getPrimaryHsmKey
    Para obtener la clave de HSM (KMS) primaria de la configuración de HSM (KMS) existente, utilice el comando dbaascli tde getPrimaryHsmKey.
  • dbaascli tde hsmToFile
    Para convertir TDE basado en HSM (KMS/OKV) en TDE basado en FILE, utilice el comando dbaascli tde hsmToFile.
  • dbaascli tde listKeys
    Para mostrar las claves maestras de TDE, utilice el comando dbaascli tde listKeys.
  • dbaascli tde removeSecondaryHsmKey
    Para eliminar la clave de HSM (KMS) secundaria de la configuración de HSM (KMS) existente , utilice el comando dbaascli tde removeSecondaryHsmKey.
  • dbaascli tde rotateMasterKey
    Rote la clave maestra para el cifrado de la base de datos.
  • dbaascli tde setKeyVersion
    Para definir la versión de clave primaria que se va a utilizar en la DB/CDB o en la PDB, utilice el comando dbaascli tde setKeyVersion.
  • dbaascli tde setPrimaryHsmKey
    Para cambiar la clave de HSM (KMS) primaria para la configuración de HSM (KMS) existente, utilice el comando dbaascli tde setPrimaryHsmKey.
  • dbaascli tde status
    Para mostrar información sobre el almacén de claves de la base de datos especificada, utilice el comando dbaascli tde status.

Tema principal: Uso de la utilidad dbaascli en Exadata Cloud Infrastructure

dbaascli admin updateAHF

Para instalar o actualizar el marco de estado autónomo (AHF), utilice el comando dbaascli admin updateAHF.

Requisitos

Ejecute el comando con el usuario root.

Sintaxis

dbaascli admin updateAHF
 {
   --targetVersion value | --imageTag value
}
[--resume [--sessionID value]] [--executePrereqs]
Donde:
  • --targetVersion especifica la versión de destino a la que actualizar AHF
  • --imageTag especifica la etiqueta de imagen del artefacto de AHF que se va a instalar
  • --resume reanuda la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --executePrereqs ejecuta comprobaciones de requisitos e informa de los resultados

dbaascli admin updateStack

Para instalar o actualizar un RPM de dbaastools, utilice el comando dbaascli admin updateStack.

Requisitos

Ejecute el comando con el usuario root.

Para usar la utilidad, debe conectarse a una máquina virtual de Exadata Cloud Infrastructure.

Consulte Conexión a una máquina virtual con SSH.

Sintaxis

dbaascli admin updateStack 
[--resume]
[--prechecksOnly]
[--nodes]
Donde:
  • --resume reanuda la ejecución anterior
  • --prechecksOnly solo ejecuta las comprobaciones previas de esta operación
  • --nodes especifica una lista delimitada por comas de nodos en los que se instalará el RPM. Si no transfiere este argumento, el RPM se instalará en todos los nodos del cluster

dbaascli cswlib deleteLocal

Para suprimir la imagen local, utilice el comando dbaascli cswlib deleteLocal.

Ejecute el comando con el usuario root.

Sintaxis

dbaascli cswLib deleteLocal --imageTag <value>

Donde:

  • --imageTag especifica la etiqueta de imagen del directorio raíz de Oracle

Ejemplo 6-4 dbaascli cswlib deletelocal

dbaascli cswlib deletelocal --imagetag 19.15.0.0.0
DBAAS CLI version MAIN
Executing command cswlib deletelocal --imagetag 19.15.0.0.0
Job id: 8b3e71de-4b81-4832-b49c-7f892179bb4f
Log file location: /var/opt/oracle/log/cswLib/deleteLocal/dbaastools_2022-07-18_10-00-02-AM_73658.log
dbaascli execution completed

dbaascli cswlib download

Para descargar las imágenes de software disponibles y hacer que estén disponibles en el entorno de Exadata Cloud Infrastructure, utilice el comando dbaascli cswlib download.

Requisitos

Ejecute el comando con el usuario root.

Para usar la utilidad, debe conectarse a una máquina virtual de Exadata Cloud Infrastructure.

Consulte Conexión a una máquina virtual con SSH.

Sintaxis

dbaascli cswlib download --version | --imageTag
[--product]
Donde:
  • --version especifica la versión de una imagen de directorio raíz de Oracle
  • --imageTag especifica la etiqueta de imagen de la imagen
  • --product especifica el tipo de imagen. Valores válidos: database o grid

Ejemplo 6-5 dbaascli cswlib download --product --imageTag

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

Ejemplo 6-6 dbaascli cswlib download --version 19.9.0.0.0

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

dbaascli cswlib listLocal

Para ver la lista de imágenes de Database y Grid Infrastructure disponibles localmente, utilice el comando dbaascli cswlib listLocal.

Ejecute el comando con el usuario root.

Sintaxis

dbaascli cswLib listLocal [--product <value>]

Donde:

  • --product identifica el tipo de producto del directorio raíz de Oracle. Valores válidos: database o grid.

Ejemplo 6-7 dbaascli cswlib listlocal

dbaascli cswlib listlocal
DBAAS CLI version MAIN
Executing command cswlib listlocal
Job id: bc4f047c-0a34-4d4d-a1ea-21ddc2a9c627
Log file location: /var/opt/oracle/log/cswLib/listLocal/dbaastools_2022-07-18_10-29-53-AM_16077.log
############ List of Available Database Images  #############
1.IMAGE_TAG=12.2.0.1.220419
  IMAGE_SIZE=5GB
  VERSION=12.2.0.1.220419
  DESCRIPTION=12.2 APR 2022 DB Image
2.IMAGE_TAG=18.16.0.0.0
  IMAGE_SIZE=6GB
  VERSION=18.16.0.0.0
  DESCRIPTION=18c OCT 2021 DB Image
3.IMAGE_TAG=19.14.0.0.0
  IMAGE_SIZE=5GB
  VERSION=19.14.0.0.0
  DESCRIPTION=19c JAN 2022 DB Image
dbaascli execution completed

dbaascli cswlib showImages

Para ver la lista de imágenes de base de datos y de Grid Infrastructure disponibles, utilice el comando dbaascli cswlib showImages.

Ejecute el comando con el usuario root.

Sintaxis

dbaascli cswlib showImages 
[--product]

Donde:

  • --product identifica el tipo de producto del directorio raíz de Oracle. Valores válidos: database o grid.

Ejemplo 6-8 dbaascli cswlib showImages

dbaascli cswlib showImages

dbaascli database addInstance

Para agregar la instancia de base de datos en el nodo especificado, utilice el comando dbaascli database addInstance.

Requisito

  • Ejecute el comando con el usuario root.

Sintaxis

dbaascli database addInstance --dbname <value> --node <value> [--newNodeSID <value>]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database
  • --node especifica el nombre de nodo de la instancia de base de datos
    • --newNodeSID especifica el SID de la instancia que agregará al nuevo nodo

dbaascli database backup

Para configurar Oracle Database con un destino de almacenamiento de copia de seguridad, realizar copias de seguridad de la base de datos, consultar copias de seguridad y suprimir una copia de seguridad, utilice el comando dbaascli database backup.

Requisito

  • Ejecute el comando con el usuario root.

Sintaxis

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
        }

Donde:

  • --dbname especifica el nombre de la instancia de Oracle Database
  • --list devuelve información de copia de seguridad de base de datos

    [--backupType | --json]

    [--backupType especifica backupType (REGULAR-L0 | REGULAR-L1 | ARCHIVELOG | LONGTERM) ]

    [--json especifica el nombre de archivo para la salida JSON ]

  • --start empieza la copia de seguridad de la base de datos

    [--level0 crea una copia de seguridad de nivel 0 (completa)]

    [--level1 crea una copia de seguridad de nivel 1 (incremental) ]

    [--archival | --archivelog]

    [--archival crea una copia de seguridad completa de archivo]

    --tag especifica la etiqueta de copia de seguridad

    [--archivelog ]

  • --delete suprime la copia de seguridad de archivo

    --backupTag especifica la etiqueta de copia de seguridad que suprimir

  • --status muestra los detalles de un proceso de trabajo de copia de seguridad

    Identificador único --uuid de la operación de copia de seguridad. Formato de entrada: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

    [--json especifica el nombre de archivo para la salida JSON]

  • --getBackupReport devuelve BackupReport

    --tag | --latest

    --tag especifica la etiqueta de copia de seguridad

    --latest devuelve el informe de copia de seguridad más reciente (todos los tipos de copia de seguridad de base de datos)

    --json especifica el nombre de archivo para la salida de JSON

  • --configure configura la base de datos para la copia de seguridad

    --configFile | --enableRTRT | --disableRTRT | --disableCatalog | --deleteImmutableConfiguration

    --configFile especifica el archivo de configuración de la copia de seguridad de la base de datos

    --enableRTRT activa el transporte de redo en tiempo real

    --disableRTRT desactiva el transporte de redo en tiempo real

    --disableCatalog desactiva el catálogo de recuperación

    --deleteImmutableConfiguration suprime la configuración inmutable

  • --getConfig devuelve la configuración de copia de seguridad de base de datos

    [--configFile | --showOldParams]

    [--configFile especifica el archivo de configuración de la copia de seguridad de la base de datos]

    [--showOldParams devuelve nombres de parámetros antiguos de la configuración de copia de seguridad.]

  • --validate valida que las copias de seguridad estén completas y no estén corruptas

    [--untilTime valida desde la copia de seguridad de nivel 0 (completa) más cercana hasta el tiempo proporcionado. Formato de entrada: DD-MON-YYYY HH24:MI:SS]

  • --showHistory muestra el historial de las operaciones de copia de seguridad

    [--all muestra todas las operaciones de copia de seguridad]

  • --getSchedules devuelve todos los programas de copia de seguridad de la base de datos indicada
Nota

Los parámetros enableRTRT y disableRTRT solo son aplicables para el destino de copia de seguridad ZDLRA en Exadata Database Service on Cloud@Customer.

dbaascli database bounce

Para cerrar y reiniciar una base de datos de Exadata Cloud Infrastructure especificada, utilice el comando dbaascli database bounce.

Requisitos

Ejecute el comando con el usuario oracle.

Sintaxis

dbaascli database bounce
[--dbname][--rolling <value>]
Donde:
  • --dbname especifica el nombre de la base de datos
  • --rolling especifica true o false para reiniciar la base de datos de manera sucesiva. El valor por defecto es false.

El comando realiza un cierre de la base de datos en el modo inmediato. A continuación, la base de datos se reinicia y se abre. En Oracle Database 12c o posterior, también se abren todas las PDB.

Ejemplo 6-9 dbaascli database bounce

dbaascli database bounce --dbname dbname

dbaascli database changepassword

Para cambiar la contraseña de un usuario de Oracle Database especificado, utilice el comando dbaascli database changePassword. Cuando se le solicite, introduzca el nombre de usuario para el que desea cambiar la contraseña y, a continuación, introduzca la contraseña.

Requisitos

Ejecute el comando como usuario root o oracle.

Sintaxis

dbaascli database changePassword [--dbname <value>] [--user <value>]
{
  [--prepareStandbyBlob <value> [--blobLocation <value>]] | [--standbyBlobFromPrimary <value>]
}
[--resume [--sessionID <value>]]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database sobre la que desea actuar
  • --user especifica el nombre de usuario para el que se requiere un cambio de contraseña
  • --prepareStandbyBlob especifica true para generar un archivo blob que contiene los artefactos necesarios para cambiar la contraseña en un entorno de Data Guard. Valores válidos: true|false
  • --blobLocation especifica la ruta de acceso personalizada donde se generará el archivo blob
  • --standbyBlobFromPrimary especifica el archivo blob de base de datos en espera, que se prepara desde la base de datos principal
  • --resume especifica que se reanude la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico

Ejemplo 6-10 dbaascli database changePassword

dbaascli database changepassword --dbname db19

dbaascli database convertToPDB

Para convertir la base de datos no CDB especificada a PDB, utilice el comando dbaascli database convertToPDB.

Sintaxis

dbaascli database convertToPDB --dbname <value> [--cdbName <value>] [--executePrereqs]
        {
            [--copyDatafiles [--keepSourceDB]]|[backupPrepared]
        }
        [--targetPDBName <value>] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database
  • --cdbName especifica el nombre de la CDB de destino en la que se creará la PDB. Si la CDB no existe, se creará en el mismo directorio raíz de Oracle que la base de datos no CDB de origen
  • --executePrereqs especifica que se ejecuten solo las comprobaciones previas a la conversión
  • --copyDatafiles especifica que se cree una nueva copia de los archivos de datos en lugar de utilizar los de la base de datos origen.

    --keepSourceDB: para conservar la base de datos de origen después de completar la operación.

  • --backupPrepared: indicador que confirma que se ha realizado una copia de seguridad de base de datos adecuada para la base de datos sin contenedor antes de realizar la conversión a base de datos conectable.
  • Indicador --backupPrepared para confirmar que existe una copia de seguridad de base de datos adecuada para la base de datos no CDB antes de que se realice la conversión a PDB
  • --targetPDBName especifica el nombre de la PDB que se creará como parte de la operación
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true|false
  • --resume especifica que se reanude la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico

Ejemplo 6-11 dbaascli database convertToPDB

Para ejecutar las comprobaciones previas a la conversión:
dbaascli database convertToPDB --dbname ndb19 --cdbname cdb19 --backupPrepared --executePrereqs
Para ejecutar una conversión completa con una copia de los archivos de datos desde la base de datos no CDB:
dbaascli database convertToPDB --dbname tst19 --cdbname cdb19 --copyDatafiles

dbaascli database create

Para crear una instancia de Oracle Database, utilice el comando dbaascli database create. Cuando se le solicite, introduzca las contraseñas sys y tde.

Utilice este comando para crear una instancia de Oracle Database versión 12.1.0.2 o posterior con la actualización de versión JAN 2021 o posterior. Para las bases de datos con versiones anteriores, se recomienda utilizar la API basada en la consola de OCI.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

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]
Donde:
  • --dbname especifica el nombre de la base de datos
  • --oracleHome especifica la ubicación del directorio raíz de Oracle
  • --oracleHomeName especifica el nombre del directorio raíz de Oracle
  • --dbUniqueName especifica el nombre único de la base de datos
  • -- especifica el SID de la base de datos
  • --createAsCDB especifique true o false para crear la base de datos como CDB o no CDB
  • --pdbName especifique el nombre de la PDB.
  • --pdbAdminUserName especifique el nombre de usuario administrador de la PDB.
  • --dbCharset especifica el juego de caracteres de la base de datos
  • --dbNCharset especifica el juego de caracteres nacional de la base de datos
  • --dbLanguage especifica el idioma de la base de datos
  • --dbTerritory especifica el territorio de la base de datos
  • --sgaSizeInMB especifica el valor sga_target en la unidad de megabytes
  • --pgaSizeInMB especifica el valor pga_aggregate_target en la unidad de megabytes
  • --datafileDestination especifica el nombre del grupo de discos de ASM que se utilizará para los archivos de datos de la base de datos
  • --fraDestination especifica el nombre del grupo de discos de ASM que se se utilizarán para el área de recuperación rápida de la base de datos
  • --fraSizeInMB especifica el valor de tamaño del área de recuperación rápida en la unidad de megabytes
  • --nodeList especifica una lista delimitada por comas de nodos de la base de datos
  • --tdeConfigMethod especifica el método de configuración de TDE. Valores válidos: FILE, KMS
  • --kmsKeyOCID especifica el OCID de clave de KMS que se utilizará para TDE. Solo se aplica si se ha seleccionado KMS para TDE
  • --resume reanuda la ejecución anterior
  • --revert realiza un rollback de la ejecución anterior
  • --sessionID para reanudar o revertir un ID de sesión específico.
  • --executePrereqs especifica yes para ejecutar solo los requisitos de esta operación. Valores válidos: yes o no
  • --honorNodeNumberForInstance especifica true o false para indicar que el nombre de instancia debe tener como sufijo los números de nodo de cluster. Valor por defecto: true
  • --lockPDBAdminAccount especifique true o false para bloquear la cuenta de usuario administrador de la PDB. El valor por defecto es true
  • --dbcaTemplateFilePath especifique la ruta de acceso absoluta del nombre de plantilla de dbca para crear la base de datos.
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true o false

Ejemplo 6-12 dbaascli database create

dbaascli database create --dbName db19 --oracleHomeName myhome19 --dbSid db19sid --nodeList node1,node2 --createAsCDB true

dbaascli database delete

Para suprimir una instancia de Oracle Database, utilice el comando dbaascli database delete.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli database delete --dbname <value>
[--deleteArchiveLogs <value>]
[--deleteBackups <value>]
[--precheckOnly <value>]
[--waitForCompletion <value>]
[--force]
[--dbSID <value>]
[--resume [--sessionID <value>]]
Donde:
  • --dbname especifica el nombre de la base de datos.
  • --deleteArchiveLogs especifica true o false para indicar la supresión de archive logs de base de datos.
  • --deleteBackups especifica true o false para indicar la supresión de copias de seguridad de la base de datos.
  • --precheckOnly especifica yes para ejecutar solo las comprobaciones previas de esta operación. Valores válidos: yes o no.
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true o false.
  • Indicador –-force para forzar la supresión de la base de datos.
  • --dbSID especifique el SID de la base de datos.
  • --resume para reanudar la ejecución anterior.
  • --sessionID para reanudar un ID de sesión específico.

Ejemplo 6-13 dbaascli database delete

dbaascli database delete --dbname db19

dbaascli database deleteInstance

Para suprimir la instancia de base de datos en el nodo especificado, utilice el comando dbaascli database deleteInstance.

Requisito

  • Ejecute el comando con el usuario root.

Sintaxis

dbaascli database deleteInstance --dbname <value> --node <value> [--continueOnUnreachableNode]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database
  • --node especifica el nombre de nodo para la instancia de base de datos
  • --continueOnUnreachableNode especifica que se realice la operación incluso si no se puede acceder al nodo

Ejemplo 6-14 database deleteinstance

database deleteinstance --node test-node

dbaascli database duplicate

Para crear una base de datos a partir de una base de datos activa, utilice el comando dbaascli database duplicate.

Requisito

  • Ejecute el comando con el usuario root.

Sintaxis

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>]
Donde:
  • --dbName especifica el nombre de l instancia de Oracle Database
  • --sourceDBConnectionString especifica la cadena de conexión de la base de datos de origen con el formato <scan_name>:<scan_port>/<database_service_name>
  • --oracleHome especifica la ubicación del directorio raíz de Oracle
  • --oracleHomeName especifica el nombre del directorio raíz de Oracle
  • --dbSID especifica el SID de la base de datos
  • --dbUniqueName especifica el nombre único de la base de datos
  • --sgaSizeInMB especifica el valor de sga_target en la unidad de megabytes
  • --pgaSizeInMB especifica el valor de pga_aggregate_target en la unidad de megabytes
  • --datafileDestination especifica el nombre del grupo de discos de ASM que se utilizará para los archivos de datos de la base de datos
  • --fraDestination especifica el nombre del grupo de discos de ASM que se utilizará para el área de recuperación rápida de la base de datos
  • --fraSizeInMB especifica el valor del tamaño del área de recuperación rápida en la unidad de megabytes
  • --sourceDBWalletLocation especifica la ubicación del archivo de cartera de TDE de la base de datos origen. Es necesario duplicar la base de datos a partir de la base de datos activa
  • --nodeList especifica una lista delimitada por comas de nodos de la base de datos
  • --resume especifica que se reanude la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --revert especifica que se realice un rollback de la ejecución anterior
    • --sessionID especifica que se realice un rollback de un identificador de sesión específico
  • --rmanParallelism especifica el valor parallelsim
  • --rmanSectionSizeInGB especifica el tamaño de la sección de RMAN en GB
  • --tdeConfigMethod especifica el método de configuración de TDE. Los valores permitidos son FILE y KMS.
  • --kmsKeyOCID especifica el OCID de clave de KMS que se utilizará para TDE. Solo se aplica si se ha seleccionado KMS para TDE.
  • --sourceDBTdeConfigMethod especifica el método de configuración de TDE de la base de datos origen. Los valores permitidos son FILE y KMS.
  • --sourceDBKmsKeyOCID especifica el OCID de la clave de KMS de la base de datos de origen que se utilizará para TDE. Solo se aplica si se ha seleccionado KMS para TDE.
  • --executePrereqs especifica yes para ejecutar solo los requisitos de esta operación. Valores válidos: yes|no
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true|false
  • --skipPDBs especifica una lista delimitada por comas de nombres de PDB de base de datos de origen, que se debe excluir de la operación de base de datos duplicada. Ejemplo: pdb1,pdb2...

Ejemplo 6-15 dbaascli database duplicate

dbaascli database duplicate --sourceDBConnectionString test-user-scan.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521/mynew.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2 --dbName newdup --sourceDBWalletLocation /var/opt/oracle/dbaas_acfs/tmp/prim_wallet

dbaascli database getDetails

Este comando muestra la información detallada de una base de datos determinada, por ejemplo, el nombre de base de datos, la información de nodo, la información de las bases de datos conectables, etc.

Requisitos

Ejecute el comando como el usuario root o el usuario oracle

Sintaxis

dbaascli database getDetails --dbname <value>
Donde:
  • --dbname: nombre de la base de datos Oracle.

base de datos dbaascli getPDBs

Para ver la lista de todas las bases de datos conectables de una base de datos de contenedores, utilice el comando dbaascli database getPDBs.

Ejecute el comando como usuario root u oracle.

Sintaxis

dbaascli database getPDBs --dbname <value>
Donde:
  • --dbname especifica el nombre de la base de datos de contenedores

Ejemplo 6-16 dbaascli database getPDBs --dbname

dbaascli database getPDBs --dbname apr_db1

dbaascli database modifyParameters

Para modificar o restablecer los parámetros de inicialización de una instancia de Oracle Database, utilice el comando dbaascli database modifyParameters.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli database modifyParameters --dbname <value> --setParameters <values>| --resetParameters <values> | --responseFile
[--backupPrepared]
[--instance]
[--allowBounce]
Donde:
  • --dbname especifica el nombre de la base de datos.
  • --setParameters especifica una lista delimitada por comas de parámetros que se modificarán con nuevos valores. Por ejemplo: parameter1=valueA,parameter2=valueB, etc. Para los valores en blanco, utilice parameter1=valueA,parameter2='',etc.
  • --resetParameters especifica una lista delimitada por comas de parámetros que se restablecerán a sus valores por defecto correspondientes. Por ejemplo, parameter1,parameter2, etc.
  • --responseFile especifica la ubicación absoluta del archivo JSON de respuesta que modificará los parámetros de la base de datos
  • --backupPrepared confirma que hay una copia de seguridad de base de datos adecuada antes de modificar los parámetros críticos o confidenciales.
  • --instance especifica el nombre de la instancia en la que se procesarán los parámetros. Si no se ha especificado, la operación se realizará en el nivel de base de datos.
  • --allowBounce otorga permiso para reiniciar la base de datos a fin de reflejar los cambios en los parámetros estáticos aplicables.

Ejemplo 6-17 dbaascli database modifyParameters

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

dbaascli database move

Para mover la base de datos de un directorio raíz a otro, utilice el comando dbaascli database move.

Requisitos

  • Antes de realizar una operación de traslado, asegúrese de que todas las instancias de la base de datos asociadas a la misma estén activas y en ejecución.
  • Ejecute el comando con el usuario root.

Sintaxis

dbaascli database move
        {
            --oracleHome <value>
            | --oracleHomeName <value>
        }
        --dbname <value>
        {
            [--resume [--sessionID <value>]]
            | [--rollback [--sessionID <value>]]
        }
[--executePrereqs]
[--nonRolling]
[--skipDatapatch]
[--skipPDBs <value>]
[--skipClosedPDBs]
[--continueWithDbDowntime]
[--drainTimeoutInSeconds <value>]
[--allowParallelDBMove]
[--waitForCompletion <value>]
[--nodeList <value>]

Donde:

  • --oracleHome especifica la ruta del directorio raíz de Oracle
  • --oracleHomeName especifica el nombre del directorio raíz de Oracle
  • --dbname especifica el nombre de la base de datos
  • --executePrereqs ejecuta las comprobaciones de requisitos e informa de los resultados
  • --nonRolling mueve la base de datos en todos los nodos en paralelo.

    Tenga en cuenta que esto provocaría tiempo de inactividad de la base de datos.

  • --resume reanuda la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --rollback realiza un rollback de la base de datos al directorio raíz anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --skipDatapatch omite la ejecución del parche de datos en las bases de datos
  • --skipPdbs omite la ejecución del parche de datos en una lista delimitada por comas de las PDB especificada.

    Por ejemplo: pdb1,pdb2...

  • --skipClosedPDBs omite la aplicación de parches a PDB cerradas
  • --continueWithDbDowntime continúa con la aplicación del parche con tiempo de inactividad de la base de datos.

    Esta opción se puede utilizar en entornos en los que solo hay una instancia activa y la operación de aplicación de parches se puede continuar incluso con un tiempo de inactividad.

  • --drainTimeoutInSeconds especifica el tiempo (en segundos) en el que completar la purga de recursos al parar la base de datos
  • --allowParallelDBMove permite mover la base de datos en paralelo.
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano.

    Valores válidos: true|false

  • --nodeList especifica una lista delimitada por comas de nodos si la operación tiene que realizarse en un subconjunto de nodos

Ejemplo 6-18 dbaascli database move

dbaascli database move --dbname testdb1 --oracleHome /u02/app/oracle/product/12.1.0/dbhome_2

dbaascli database recover

Para recuperar una base de datos, utilice el comando dbaascli database recover.

Requisito

  • Ejecute el comando con el usuario root.
  • La base de datos se debe haber configurado con los detalles del destino de almacenamiento de copia de seguridad donde se almacenan las copias de seguridad.

Sintaxis

dbaascli database recover --dbname <value>
        {
            --start
                {
                    --untilTime <value>
                    | --untilSCN <value>
                    | --latest
                    | --tag <value>
                }
            | --status --uuid <value>
        }
Donde:
--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>

Ejemplo 6-19 Ejemplos

  • Para recuperar la versión más reciente de la base de datos myTestDb:
    dbaascli database recover --dbname myTestDb --start --latest
  • Para consultar el estado de la solicitud de recuperación enviada con el uuid 2508ea18be2911eb82d0020017075151:
    dbaascli database recover --dbname myTestDb --status --uuid 2508ea18be2911eb82d0020017075151

dbaascli database runDatapatch

Para aplicar un parche en Oracle Database, utilice el comando dbaascli database runDatapatch.

Requisitos

  • Antes de realizar una operación runDatapatch, asegúrese de que todas las instancias de base de datos asociadas a la base de datos estén activas y en ejecución.

  • Ejecute el comando con el usuario root.

Sintaxis

dbaascli database runDatapatch --dbname
[--resume]
    [--sessionID]
[--skipPdbs | --pdbs]
[--executePrereqs]
[--patchList]
[--skipClosedPdbs]
[--rollback]

Donde:

  • --dbname especifica el nombre de la base de datos
  • --resume reanuda la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --skipPdbs omite la ejecución del parche de datos en una lista delimitada por comas de las PDB especificada. Por ejemplo: pdb1,pdb2...
  • --PDBs ejecuta datapatch solo en una lista delimitada por comas especificada de PDB. Por ejemplo: pdb1,pdb2...
  • --executePrereqs ejecuta comprobaciones de requisitos
  • --patchList aplica o realiza un rollback de la lista de parches delimitada por comas especificada. Por ejemplo: patch1,patch2...
  • --skipClosedPdbs omite la ejecución del parche de datos en las PDB cerradas
  • --rollback realiza un rollback de los parches aplicados 
dbaascli database runDatapatch --dbname db19

dbaascli database createTemplate

Utilice este comando para crear plantillas de base de datos (plantillas de DBCA) que se pueden utilizar posteriormente para crear bases de datos.

Ejecute el comando como usuario root o oracle.

Sintaxis

Cree una nueva plantilla de DBCA a partir de la base de datos especificada.

dbaascli database createTemplate --dbname <value>
 {
   --templateLocation <value> | --uploadToObjectStorage --objectStorageLoginUser <value> --objectStorageBucketName <value> [--objectStorageUrl <value>]
 }
 [--templateName <value>] [--rmanParallelism <value>]
Donde:
  • --dbname especifica el nombre de la base de datos
  • --templateLocation especifica el nombre de la plantilla
  • --uploadToObjectStorage: especifica que se debe cargar la plantilla en Object Storage
    • --objectStorageLoginUser: especifica el usuario de conexión de Object Storage
    • --objectStorageBucketName: especifica el nombre del cubo de Object Storage
    • --objectStorageUrl: especifica la URL de Object Storage
  • --templateName: especifica el nombre de la plantilla
  • --rmanParallelism: especifica el valor parallelsim

dbaascli database start

Para iniciar una instancia de Oracle Database, utilice el comando dbaascli database start.

Requisitos

Ejecute el comando con el usuario root.

Sintaxis

dbaascli database start
[--dbname]
[--mode]
Donde:
  • --dbname especifica el nombre de la base de datos
  • --mode especifica el modo montada o no montada para iniciar la base de datos en el modo correspondiente

El comando inicia y abre la base de datos. En Oracle Database 12c o posterior, también se abren todas las PDB.

Ejemplo 6-20 dbaascli database start

dbaascli database start --dbname dbname --mode mount

dbaascli database status

Para comprobar el estado de una instancia de Oracle Database, utilice el comando dbaascli database status.

Requisitos

Ejecute el comando con el usuario root.

Sintaxis

dbaascli database status
[--service][--dbname] 
[--user]
[--password]
Donde:
  • --service especifica el nombre del servicio
  • --dbname especifica el nombre de la base de datos
  • --user especifica el nombre de usuario del servicio
  • --password especifica la contraseña del usuario

La salida del comando incluye el modo abierto de la base de datos, la edición y la versión del software de la base de datos y la versión de otros componentes de software.

Ejemplo 6-21 dbaascli database status

dbaascli database status --dbname db19

dbaascli database stop

Para parar una instancia de Oracle Database, utilice el comando dbaascli database stop.

Requisitos

Ejecute el comando con el usuario root.

Sintaxis

dbaascli database stop
[-–dbname <value>]
[--mode <value>]
Donde:
  • --dbname especifica el nombre de la base de datos que desea parar
  • --mode especifica el modo de la base de datos. Valores válidos: abort, immediate, normal, transactional

El comando realiza un cierre de la base de datos en el modo inmediato. No se permiten ni conexiones ni transacciones nuevas. Se realiza rollback a las transacciones activas y se desconectan todos los usuarios conectados.

Ejemplo 6-22 dbaascli database stop

dbaascli database stop --dbname db19

dbaascli database upgrade

Para cambiar la versión de una instancia de Oracle Database, utilice el comando dbaascli database upgrade.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli database upgrade --dbname <value> 
{--targetHome <value> | --targetHomeName <value>}
{ [--executePrereqs | --postUpgrade | --rollback]}
{[--standBy | --allStandbyPrepared]}
{[--upgradeOptions <value>]  | [--standBy]}
[--removeGRP]
[--increaseCompatibleParameter]
[--resume [--sessionID <value>]]
[--waitForCompletion <value>]
Donde:
  • --dbname (obligatorio) especifica el nombre de la base de datos.
  • --targetHome especifica la ubicación del directorio raíz de Oracle de destino
  • --targetHomeName especifica el nombre del directorio raíz de Oracle Database de destino
  • --standBy utilice esta opción para cambiar la versión de las bases de datos en espera en las configuraciones de Data Guard
  • Se necesita --allStandbyPrepared para las bases de datos principales configuradas con Data Guard. Indicadores para confirmar que todas las operaciones necesarias se han realizado en las bases de datos en espera antes de cambiar la versión de la base de datos principal
  • --removeGRP elimina automáticamente la copia de seguridad de punto de restauración garantizado (GRP) solo si el cambio de versión de la base de datos se ha realizado correctamente
  • --increaseCompatibleParameter aumenta automáticamente el parámetro compatible como parte del cambio de versión de la base de datos. El parámetro se aumentará solo si el cambio de versión de la base de datos se ha realizado correctamente
  • --executePrereqs solo ejecuta las comprobaciones previas al cambio de versión
  • --postUpgrade utilice esta opción si fallan los pasos posteriores al cambio de versión y es necesario volver a ejecutarlos
  • --rollback revierte una instancia de Oracle Database a su directorio raíz de Oracle original
  • --upgradeOptions utilice esta opción para transferir argumentos específicos de DBUA para realizar el cambio de versión de Oracle Database. Consulte la documentación de Oracle correspondiente para conocer las opciones y los argumentos soportados.

    --standby

  • --resume para reanudar la ejecución anterior
  • --sessionID para reanudar un ID de sesión específico.
  • --waitForCompletion especifique false para ejecutar la operación en segundo plano. Valores válidos : true|false.

Ejemplo 6-23 dbaascli database upgrade (comprobaciones de requisitos antes del cambio de versión)

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

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>
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database
  • --blobLocation especifica la ubicación del directorio personalizado en la que se generará el archivo blob de base de datos en espera en un entorno 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>
Donde:
  • --attributes contiene los atributos de automatización de Data Guard que se van a modificar. Acepta valores delimitados por comas con el formato <attribute=value>. Los atributos deben estar predefinidos en el archivo de configuración de Data Guard.

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>]]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database.
  • --useImmediateFailover utiliza 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 va a esperar a que finalice la operación. Defina en false para que se ejecute la operación en segundo plano. Valores válidos: true|false.
  • --resume reanuda la operación anterior.
  • --sessionID reanuda una sesión específica por su ID.

Tema principal: Referencia de comandos dbaascli

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.

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

  2. Inicie un shell de comandos de usuario root y, a continuación, cambie al usuario oracle:
    $ sudo -s
# su - oracle
$
  3. Inicie la operación de failover en la base datos en espera.
    $ dbaascli dataguard failover --dbname <db-name>
  4. Vuelva a ser el usuario root.
    $ exit
#
  5. 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>]]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle 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 va a esperar a que finalice la operación. Defina en false para ejecutar la operación en segundo plano. Valores válidos: true|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.

Tema principal: Referencia de comandos dbaascli

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.

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

  2. 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>
  3. 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>]]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle 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 al realizar la operación.
  • --waitForCompletion especifica si se espera a que finalice la operación. Definido en false para ejecutar la operación en segundo plano. Valores válidos: true|false.
  • --resume reanuda la operación anterior.
  • --sessionID reanuda una sesión específica por su ID.

Tema principal: Referencia de comandos dbaascli

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.

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

  2. Inicie un shell de comandos de usuario root y, a continuación, cambie al usuario oracle.
    $ sudo -s
# su - oracle
$
  3. 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>
  4. Vuelva a ser el usuario root.
    $ exit
#
  5. 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 Exadata Cloud@Customer (ExaDB-C@C), 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]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle 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 el 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 al 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 Primaria.
  • --primaryScanIPAddresses especifica una lista delimitada por comas de direcciones IP correspondientes al listener de SCAN o el 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 realiza un rollback de la operación anterior.
  • --waitForCompletion especifica si se va a esperar a que finalice la operación. Defina en false para ejecutar la operación en segundo plano. Valores válidos: true|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).

Tema principal: Referencia de comandos dbaascli

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.

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

  2. Inicie un shell de comandos de usuario root.
    $ sudo -s
  3. 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.

  4. 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>]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database.
  • --oracleHome especifica la ruta del directorio raíz de Oracle.
  • --oracleHomeName especifica el nombre del directorio raíz de Oracle.
  • --standbyDBUniqueName especifica el nombre único de la base en espera.
  • --standbyDBDomain especifica el dominio de base de datos en espera para el 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 el nombre de SCAN de la base datos principal.
  • --primaryScanPort especifica el número del puerto SCAN correspondiente del servicio del sistema de bases de datos principal.
  • --primaryServiceName especifica el nombre del Servicio de Base de Datos Principal para el que se va a configurar la Base de Datos en Espera.
  • --protectionMode especifica el modo del Data Guard que se debe definir al configurar la base de datos en espera. Valores válidos: MAX_PERFORMANCE|MAX_AVAILABILITY.
  • --transportType especifica el tipo del transporte de Data Guard que se debe definir al configurar la base del sistema en espera. Valores válidos: ASYNC|SYNC.
  • --activeDG especifica si la configuración de Data Guard estará activa o no. Valores válidos: true|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 al 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 base 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 se utilizará para los archivos redo log.
  • --fraSizeInMB especifica un valor de tamaño del área en MB de recuperación rápida.
  • --tdeKeyStoreType especifica el tipo de almacén de claves de TDE. Valores válidos: FILE|KMS|AZURE|GOOGLE|AWS|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 realiza un rollback de la operación anterior.
  • --waitForCompletion especifica si se va a esperar a que finalice la operación. Defina en false para ejecutar la operación en segundo plano. Valores válidos: true|false.
  • --enableFIPS especifica si se debe activar FIPS. Defina esta opción en false para desactivarla. Valores válidos: true|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 de Oracle Key Vault. Lista delimitada por comas de varias direcciones IP.
  • --okvAdminUserName especifica el nombre del usuario administrador de la instancia 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.

Tema principal: Referencia de comandos dbaascli

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.

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

  2. Inicie un shell de comandos de usuario root.
    $ sudo -s
  3. 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>
  4. 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>]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database.
  • --standbyDBUniqueName especifica el nombre único de la base datos en espera para que se registre con la configuración del agente de Oracle Data Guard.
  • --standbyDBDomain especifica el dominio de base de datos en espera para el 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 al 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 Primaria.
  • --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 realiza un rollback de la operación anterior.
  • --waitForCompletion especifica si se va a esperar a que finalice la operación. Defina en false para ejecutar la operación en segundo plano. Valores válidos: true|false.

Tema principal: Referencia de comandos dbaascli

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, con exclusión de 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.

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

  2. Inicie un shell de comandos de usuario root.
    $ sudo -s
  3. 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.

  4. 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>]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database.
  • --standbyDBUniqueName especifica el nombre único de bases de datos para que se anule el registro de las bases de datos en espera 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. Definido en false para ejecutar la operación en segundo plano. Valores válidos: true|false.

Tema principal: Referencia de comandos dbaascli

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

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.

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.

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

  2. Inicie un shell de comandos de usuario root.
    $ sudo -s
  3. 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.

  4. 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>]]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database.
  • --action especifica si se debe activar o desactivar 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.

Tema principal: Referencia de comandos dbaascli

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.

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

  2. Inicie un shell de comandos de usuario root.
    $ sudo -s
  3. 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
  4. 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 esta acción como 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>]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database.
  • --protectionMode especifica el modo del Data Guard que se debe definir al configurar la base de datos en espera. Valores válidos: MAX_PERFORMANCE|MAX_AVAILABILITY.
  • --transportType especifica el tipo del transporte de Data Guard que se debe definir al configurar la base del sistema en espera. Valores válidos: ASYNC|SYNC.
  • --standbyDGType especifica el tipo de Data Guard de la base de datos en espera que se va a definir. Valores válidos: ADG|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. Defina en false para que se ejecute la operación en segundo plano. Valores válidos: true|false.

Tema principal: Referencia de comandos dbaascli

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.

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

  2. Inicie un shell de comandos de usuario root.
    $ sudo -s
  3. 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.

dbaascli dbhome create

Para crear un directorio raíz de Oracle Database de la versión deseada, utilice el comando dbaascli dbhome create.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli dbhome create --version <value>
[--oracleHome <value>]
[--oracleHomeName <value>]
[--enableUnifiedAuditing <value>] 
[--imageTag <value>]
[--ImageLocation <value>
Donde:
  • --version especifica la versión del directorio raíz de Oracle especificada como cinco segmentos numéricos separados por puntos, por ejemplo, 19.12.0.0.0
  • --oracleHome especifica la ubicación del directorio raíz de Oracle
  • --oracleHomeName especifica el nombre del directorio raíz de Oracle definido por el usuario. Si no se proporciona, se utilizará el nombre por defecto
  • --enableUnifiedAuditing especifica true o false para activar o desactivar la opción de enlace de auditoría unificada en el directorio raíz de Oracle.
  • --imageTag especifica la etiqueta de imagen del directorio raíz de Oracle
  • --imageLocation: ruta de acceso de la imagen que se utilizará.
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true o false.

Ejemplo 6-24 dbaascli dbhome create

dbaascli dbhome create --version 19.11.0.0.0

También puede utilizar dbaascli dbhome create --version 19.8.0.0.0.0 --imageTag 19.8.0.0.0 para los casos en los que las etiquetas de imagen sean diferentes de la versión.

dbaascli dbHome delete

Para suprimir un directorio raíz de Oracle Database determinado, utilice el comando dbaascli dbHome delete.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli dbHome delete 
{ --oracleHome <value> 
| --oracleHomeName <value> } [--resume [--sessionID <value>]]
Donde:
  • --oracleHome especifica la ubicación del directorio raíz de Oracle
  • --oracleHomeName especifica el nombre del directorio raíz de Oracle
  • --resume reanuda la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico

dbaascli dbhome getDatabases

Para ver la información sobre todas las bases de datos de Oracle que se ejecutan desde un directorio raíz de Oracle de base de datos determinado, utilice el comando dbaascli dbHome getDatabases. Especifique la ubicación del directorio raíz de Oracle o el nombre del directorio raíz de Oracle.

Ejecute el comando con el usuario root.

Sintaxis

dbaascli dbHome getDatabases
{ --oracleHomeName value | --oracleHome value }
Donde:
  • --oracleHomeName especifica el nombre del directorio raíz de Oracle definido por el usuario
  • --oracleHome especifica la ubicación (ruta de acceso) del directorio raíz de Oracle

Ejemplo 6-25 dbaascli dbHome getDatabases --oracleHome

dbaascli dbHome getDatabases --oracleHome /u02/app/mar_home/

dbaascli dbHome getDetails

Para ver la información sobre un directorio raíz de Oracle específico, utilice el comando dbaascli dbHome getDetails. Especifique la ubicación del directorio raíz de Oracle o el nombre del directorio raíz de Oracle.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli dbHome getDetails
{ --oracleHomeName value | --oracleHome value }
Donde:
  • --oracleHomeName especifica el nombre del directorio raíz de Oracle definido por el usuario
  • --oracleHome especifica la ubicación del directorio raíz de Oracle

Ejemplo 6-26 dbaascli dbHome getDetails (utilizando la ubicación del directorio raíz de Oracle)

dbaascli dbHome getDetails --oracleHome /u02/app/home_db19c/

Ejemplo 6-27 dbaascli dbHome getDetails (utilizando el nombre del directorio raíz de Oracle)

dbaascli dbHome getDetails --oracleHomeName home_db19c

dbaascli dbHome patch

Para aplicar un parche en el directorio raíz de Oracle de un nivel de parche a otro, utilice el comando dbaascli dbHome patch.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

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>]
Donde:
  • --oracleHome especifica la ruta del directorio raíz de Oracle
  • --oracleHomeName especifica el nombre del directorio raíz de Oracle
  • --targetVersion especifica la versión de destino del directorio raíz de Oracle especificada como cinco segmentos numéricos separados por puntos, por ejemplo, 19.12.0.0.0.
  • --resume reanuda la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --continueWithDbDowntime continúa con la aplicación del parche con tiempo de inactividad de la base de datos. Esta opción se puede utilizar en entornos en los que solo hay una instancia activa y la operación de aplicación de parches se puede continuar incluso con un tiempo de inactividad.
  • --skipUnreachableNodes omite la operación en nodos inaccesibles
  • --nodes especifica una lista delimitada por comas de nodos si se debe realizar la aplicación de parche en un subjuego de nodos
  • --executePrereqs ejecuta los requisitos
  • --skipDatapatch omite la ejecución de datapatch en las bases de datos
  • --imageFilePath especifica la ruta de acceso absoluta del archivo de imagen que se va a utilizar
  • --skipPDBs omite la ejecución del parche de datos en una lista delimitada por comas de las PDB especificada. Por ejemplo: cdb1:pdb1,cdb2:pdb2, etc.
  • --skipClosedPdbs omite la ejecución de datapatch en las PDB cerradas
  • --rollback realiza un rollback del directorio raíz de Oracle en el que se ha aplicado el parche.
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos : true|false
  • --drainTimeoutInSeconds especifica el tiempo (en segundos) para completar la purga de recursos mientras se para la base de datos
  • --skipUnreachableNodes omite la operación en nodos inaccesibles

Ejemplo 6-28 dbaascli dbhome patch

dbaascli dbhome patch --targetVersion 19.10.0.0.0 --oracleHome /u02/app/oracle/product/19.0.0.0/dbhome_2

dbaascli dbimage purge

El comando dbimage purge elimina la imagen de software especificada del entorno de Exadata Cloud Infrastructure.

Conéctese al nodo de cálculo como usuario opc y ejecute este comando como usuario root. 

# dbaascli dbimage purge --version software_version --bp software_bp [--cdb ( yes | no )]

En el comando anterior:

  • software_version: especifica la versión del software de Oracle Database. Por ejemplo, 11204, 12102, 12201, 18000, 19000.

  • software_bp: identifica la versión del paquete de parches. Por ejemplo, APR2018, JAN2019, OCT2019, etc.

  • --cdb: especifica, de forma opcional, si se desea eliminar la imagen de software que soporta la arquitectura multi-inquilino de Oracle. El valor por defecto es yes. Si especifica --cdb no, la imagen de software que contiene binarios para soportar bases de datos sin contenedor (no CDB) se elimina.

Si el comando va a eliminar una imagen de software que no está disponible actualmente en la biblioteca de imágenes de software y, por lo tanto, no se puede volver a descargar, este se detiene y solicita confirmación.

No se puede eliminar la imagen de software por defecto actual de ninguna versión de software. Para evitar esta restricción, debe convertir otra imagen de software en la imagen por defecto actual.

dbaascli diag collect

Para recopilar diagnósticos, utilice el comando dbaascli diag collect.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli diag collect [--components <value>] [--startTime <value>] [--endTime <value>] [--nodes <value>] [--dbNames <value>]
        {
            [--objectStoreBucketUri <value>]
            | [--destLocation <value>]
        }
        [--waitForCompletion <value>]
Donde:
  • --components especifica una lista de componentes para la recopilación de logs.

    Valores válidos:

    • db
    • gi
    • os
    • dbaastools
    • all
  • --startTime especifica la hora de inicio de la recopilación de logs. Formato de fecha y hora válido: YYYY-MM-DDTHH24:MM:SS
  • --endTime especifica la hora de finalización de la recopilación de logs. Formato de fecha y hora válido: YYYY-MM-DDTHH24:MM:SS
  • --nodes especifica una lista delimitada por comas de nodos para recopilar logs
  • --dbNames especifica el nombre de la base de datos para la que se recopilarán los logs. Solo puede especificar un nombre de base de datos.
  • --objectStoreBucketURI especifica una URL de solicitud autenticada previamente (PAR) del servicio Object Storage que se utiliza para cargar los logs recopilados. Los logs se recopilan de la VM de invitado. Para obtener más información, consulte Uso de solicitudes autenticadas previamente.
  • --destLocation especifica la ubicación en el VM de invitado para recopilar logs. Por defecto: /var/opt/oracle/dbaas_acfs
  • Valores de --waitForCompletion: true|false. Valor por defecto: true. Especifique false para la ejecución en segundo plano.

dbaascli diag healthCheck

Para ejecutar comprobaciones del sistema de diagnóstico, utilice el comando dbaascli diag healthCheck.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli diag healthCheck
[--destLocation]
[--nodes]
[--objectStoreBucketURI]
Donde:
  • --destLocation especifica la ubicación en el VM de invitado para recopilar logs. Por defecto: /var/opt/oracle/dbaas_acfs
  • --nodes especifica una lista delimitada por comas de nodos para recopilar logs
  • --objectStoreBucketURI especifica una URL de solicitud autenticada previamente (PAR) del servicio Object Storage que se utiliza para cargar los logs recopilados. Los logs se recopilan de la VM de invitado. Para obtener más información, consulte Uso de solicitudes autenticadas previamente.

dbaascli gridHome create

Para configurar el directorio raíz de Grid Infrastructure, utilice el comando dbaascli gridHome create.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli gridHome create --version value [--resume [--sessionID value]] [--waitForCompletion value]
Donde:
  • --version especifica la versión del directorio raíz de Grid
  • --resume reanuda la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true|false

dbaascli grid configureTCPS

Para configurar TCPS para el cluster existente, utilice el comando dbaascli grid configureTCPS.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

Nota

Por defecto, TCPS está activado para las bases de datos de sistemas Oracle Exadata Database Service on Dedicated Infrastructure.
Nota

TCPS no está activado para las bases de datos de sistemas Exadata Database Service on Cloud at Customer. Para activar TCPS para una base de datos determinada, actualice el archivo sqlnet.ora específico de la base de datos con WALLET_LOCATION = (SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=/var/opt/oracle/dbaas_acfs/grid/tcps_wallets))) en todos los nodos de base de datos y, a continuación, reinicie la base de datos. Esto activará el uso de TCPS para la base de datos. Sin embargo, al activar TCPS, la conexión ZDLRA fallará. En sistemas Exadata Database Service en Cloud at Customer, puede activar la configuración ZDLRA o TCPS. La activación simultánea de ZDLRA y TCPS no funcionará. 
dbaascli grid configureTCPS
[--pkcs12WalletPath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Donde:
  • --pkcs12WalletPath especifica la ruta del certificado, que tiene el formato de cartera pkcs12
  • --caCertChain es la lista concatenada de certificados, que contienen certificados de CA intermedios y raíz
  • --precheckOnly especifica yes para ejecutar solo las comprobaciones previas de esta operación. Valores válidos: yes o no.
  • --serverCert especifica la ruta del certificado PEM que se utilizará o rotará para la configuración de TCPS.
  • --privateKey especifica la ruta del archivo de claves privadas del certificado.
  • --certType es el tipo del certificado que se agregará a la cartera de Grid Infrastructure. Los valores aceptados son: SELF_SIGNED_CERT, CA_SIGNED_CERT o PKCS12_CERT. Valor por defecto: SELF_SIGNED_CERT
  • --privateKeyPasswordProtected especifica si la clave privada está protegida por contraseña o no. Valores válidos: true o false. Valor por defecto: true.

Ejemplo 6-29 dbaascli grid configureTCPS

Para configurar la cuadrícula mediante el certificado autofirmado:
dbaascli grid configureTCPS
Para configurar la cuadrícula mediante el certificado firmado por una autoridad de certificación (CA):
dbaascli grid configureTCPS --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --private_key_password_protected false

dbaascli grid patch

Para aplicar un parche en Oracle Grid Infrastructure hacia la versión secundaria especificada, utilice el comando dbaascli grid patch.

Requisitos

Ejecute el comando con el usuario root.

Sintaxis

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

Donde:

  • --targetVersion especifica la versión de destino del directorio raíz de Oracle especificada como cinco segmentos numéricos separados por puntos (por ejemplo, 19.12.0.0.0)
  • --targetHome especifica la ruta de acceso completa del directorio raíz de Grid Infrastructure de destino para la aplicación de parche externa
  • --containerURL especifica la URL personalizada para recuperar la imagen de Grid Infrastructure
  • Opción --executePrereqs para ejecutar los requisitos
  • --nodeList especifica una lista delimitada por comas de nodos si la aplicación del parche se debe realizar en un subjuego de nodos
  • --patchInParallel especifica que se apliquen parches a nodos remotos en paralelo
  • --rollback especifica que se realice un rollback del directorio raíz de Oracle con parches
  • --resume reanuda la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --continueWithDbDowntime continúa con la aplicación del parche con tiempo de inactividad de la base de datos. Esta opción se puede utilizar en entornos en los que solo hay 1 instancia activa y la operación de aplicación de parche se puede continuar incluso con un tiempo de inactividad.
  • --drainTimeoutInSeconds especifica el tiempo (en segundos) en el que completar la purga de recursos al parar la base de datos
  • --createImage crea una imagen a partir de una copia del directorio raíz de Grid activo, con parche a la versión de destino especificada
    • --createImageDir especifica la ruta de acceso completa del directorio en el que se creará la imagen
  • --imageFile especifica la ruta de acceso completa de la imagen que se utilizará
  • --patchInParallel aplica parches a los nodos remotos en paralelo
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true|false

Ejemplo 6-30 dbaascli grid patch

dbaascli grid patch --targetVersion 19.12.0.0.0

dbaascli grid removeTCPSCert

Para eliminar certificados TCPS existentes de la cartera de Grid Infrastructure, utilice el comando dbaascli grid removeTCPSCert.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli grid removeTCPSCert --subject <value>
 {
   --userCert | --trustedCert | --requestedCert
 }
 [--serialNumber <value>] [--executePrereqs] [--resume [--sessionID <value>]] [--bounceListeners]
Donde:
  • --subject especifica el asunto del certificado.
  • Indicador --userCert para indicar el certificado del usuario
  • Indicador --trustedCert para indicar un certificado de confianza
  • Indicador --requestedCert para indicar el certificado solicitado
  • --serialNumber especifica el número de serie del certificado
  • --executePrereqs ejecuta las comprobaciones de requisitos e informa de los resultados
  • --resume reanuda la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • Indicador --bounceListeners para reiniciar el listener de Grid Infrastructure y el listener de SCAN

dbaascli grid rotateTCPSCert

Para rotar certificados TCPS, utilice el comando dbaascli grid rotateTCPSCert.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli grid rotateTCPSCert
[--pkcs12WalletPath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Donde:
  • --pkcs12WalletPath especifica la ruta del certificado, que tiene el formato de cartera pkcs12
  • --caCertChain es la lista concatenada de certificados, que contienen certificados de CA intermedios y raíz
  • --precheckOnly especifica yes para ejecutar solo las comprobaciones previas de esta operación. Valores válidos: yes o no.
  • --serverCert especifica la ruta del certificado PEM que se utilizará o rotará para la configuración de TCPS.
  • --privateKey especifica la ruta del archivo de claves privadas del certificado.
  • --certType es el tipo del certificado que se agregará a la cartera de Grid Infrastructure. Los valores aceptados son: SELF_SIGNED_CERT, CA_SIGNED_CERT o PKCS12_CERT. Valor por defecto: SELF_SIGNED_CERT
  • --privateKeyPasswordProtected especifica si la clave privada está protegida por contraseña o no. Valores válidos: true o false. Valor por defecto: true.

Ejemplo 6-31 dbaascli grid rotateTCPSCert

Para rotar un certificado mediante un certificado autofirmado (opción por defecto):
dbaascli grid rotateTCPSCert
Para rotar un certificado mediante un certificado firmado por una autoridad de certificación (CA):
dbaascli grid rotateTCPSCert --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --privateKeyPasswordProtected true

dbaascli grid upgrade

Para cambiar la versión de Oracle Grid Infrastructure de una versión principal a otra, utilice el comando dbaascli grid upgrade.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli grid upgrade --version
[--resume]
[--executePrereqs]
[--containerURL]
[--softwareOnly]
[--targetHome]
[--revert]
Donde:
  • --version especifica la versión de destino
  • --resume reanuda la ejecución anterior
  • --executePrereqs ejecuta los requisitos para el cambio de versión de Grid Infrastrucure
  • --containerUrl especifica la URL personalizada para recuperar la imagen de Grid Infrastrucure
  • --softwareOnly instala solo el software de Grid Infrastrucure
  • --targetHome especifica la ruta del directorio raíz de Grid de destino existente
  • --revert revierte la ejecución fallida

Ejemplo 6-32 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

dbaascli job getStatus

Para ver el estado de un trabajo especificado, utilice el comando dbaascli job getStatus.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli job getStatus --jobID
Donde:
  • --jodID especifica el identificador de trabajo

Ejemplo 6-33 dbaascli job getStatus

dbaascli job getStatus --jobID 13c82031-f202-41b7-9aef-f4a71df0f551
DBAAS CLI version MAIN
Executing command job getStatus --jobID 13c82031-f202-41b7-9aef-f4a71df0f551
{
  "jobId" : "13c82031-f202-41b7-9aef-f4a71df0f551",
  "status" : "Success",
  "message" : "database create job: Success",
  "createTimestamp" : 1628095442431,
  "updatedTime" : 1628095633660,
  "description" : "Service job report for operation database create",
  "appMessages" : {
    "schema" : [ ],
    "errorAction" : "SUCCEED_AND_SHOW"
  },
  "resourceList" : [ ],
  "pct_complete" : "100"
}

dbaascli patch db apply

Nota

Los comandos dbaascli patch db prereq y dbaascli patch db apply han quedado en desuso en la versión 21.2.1.2.0 de dbaascli y se han reemplazado por los comandos dbaascli grid patch, dbaascli dbhome patch y dbaascli database move.
Para obtener más información, consulte:
  • dbaascli grid patch
  • dbaascli dbhome patch
  • dbaascli database move
  • Aplicación de parches en Oracle Database y Oracle Grid Infrastructure mediante dbaascli

dbaascli patch db prereq

Nota

Los comandos dbaascli patch db prereq y dbaascli patch db apply han quedado en desuso en la versión 21.2.1.2.0 de dbaascli y se han reemplazado por los comandos dbaascli grid patch, dbaascli dbhome patch y dbaascli database move.
Para obtener más información, consulte:
  • dbaascli grid patch
  • dbaascli dbhome patch
  • dbaascli database move
  • Aplicación de parches en Oracle Database y Oracle Grid Infrastructure mediante dbaascli

dbaascli pdb backup

Para realizar una copia de seguridad de una base de datos conectable (PDB), consultar las copias de seguridad de PDB y suprimir una copia de seguridad de PDB, utilice el comando dbaascli pdb backup.

Requisito

  • Ejecute el comando con el usuario root.

Sintaxis

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>]
        }
Donde:
--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.]

Ejemplo 6-34 Ejemplos

  • Para realizar una copia de seguridad de nivel 1 para una PDB pdb1 en una CDB myTestDb:
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --start --level1
  • Para consultar el estado de la solicitud de copia de seguridad de PDB enviada con el uuid eef16b26361411ecb13800163e8e4fac:
    dbaascli pdb backup --dbname myTestDb --pdbName pdb1 --status --uuid eef16b26361411ecb13800163e8e4fac

dbaascli pdb bounce

Para reiniciar una base de datos conectable (PDB), utilice el comando dbaascli pdb bounce.

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

dbaascli pdb bounce --dbname --pdbName | --pdbUID
[–openMode]
Donde:
  • --dbname especifica el nombre de la base de datos de contenedores que aloja la PDB.
  • --pdbName especifica el nombre de la PDB
  • --pdbUID especifica el identificador de la PDB
  • --openMode especifica el destino OPEN MODE de la PDB

Ejemplo 6-35 dbaascli pdb bounce

dbaascli pdb bounce --dbname cdb_name --pdbName pdb name associated with the CDB
dbaascli pdb bounce --dbname cdb_name --pdbUID con_uid of that pdb
Opcional:
  • --openMode READ_WRITE
  • --openMode READ_ONLY

dbaascli pdb close

Para cerrar una base de datos conectable (PDB), utilice el comando dbaascli pdb close.

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

dbaascli pdb close --dbname --pdbName | --pdbUID
Donde:
  • --dbname especifica el nombre de la base de datos de contenedores que contiene la PDB.
  • --pdbname especifica el nombre de la PDB que desea cerrar.
  • --pdbUID especifica el identificador de la PDB

Cuando este comando termina de ejecutarse correctamente, la PDB se cierra en todas las instancias de la base de datos de contenedores.

Ejemplo 6-36 dbaascli pdb close

dbaascli pdb close --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb close --dbname cdb name --pdbUID con_uid of that pdb

dbaascli pdb getConnectString

Para mostrar la información de la cadena de conexión de Oracle Net para una base de datos conectable (PDB), ejecute el comando dbaascli pdb getConnectString.

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

dbaascli pdb getConnectString --dbname --pdbName | --pdbUID
Donde:
  • --dbname especifica el nombre de la base de datos de contenedores que aloja la PDB.
  • --pdbname especifica el nombre de la PDB para la que desea mostrar la información de la cadena de conexión.
  • --pdbUID especifica el identificador de la PDB

Ejemplo 6-37 dbaascli pdb getConnectString

dbaascli pdb getConnectString --dbname dbname --pdbName pdbName

dbaascli pdb create

Para crear una nueva base de datos conectable (PDB), utilice el comando dbaascli pdb create.

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

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>]
Donde:
  • --pdbName especifica el nombre de la nueva PDB que desea crear.
  • --dbName especifica el nombre de la base de datos de contenedores que aloja la nueva PDB
  • --maxCPU especifica, de forma opcional, el número máximo de CPU disponibles para la PDB. La definición de esta opción es efectivamente lo mismo que la definición del parámetro CPU_COUNT en la PDB
  • --maxSize especifica, de forma opcional, el tamaño máximo total de los archivos de datos y los archivos temporales de los tablespaces que pertenecen a la PDB. La definición de esta opción es efectivamente lo mismo que la definición de la cláusula de almacenamiento MAXSIZE PDB en el comando de SQL CREATE PLUGGABLE DATABASE. Puede imponer un límite especificando un número entero seguido de una unidad de tamaño (K, M, G o T), o bien puede especificar UNLIMITED para que no se aplique explícitamente ningún límite.
  • --pdbAdminUserName especifica el nuevo nombre de usuario administrador de la PDB
  • --lockPDBAdminAccount especifica true o false para bloquear la cuenta de usuario administrador de la PDB. El valor por defecto es true.
  • --resume reanuda la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --executePrereqs especifica yes para ejecutar solo los requisitos de esta operación. Valores válidos: yes o no
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true o false
  • --blobLocation: ubicación de directorios personalizada donde se generará el archivo blob de base de datos en espera en un entorno de DG.
  • --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 operaciones de PDB de base de datos en espera.
    Nota

    Los parámetros blobLocation y standbyBlobFromPrimary se excluyen mutuamente.

Durante el proceso de creación de la PDB, se le solicitará que especifique la contraseña de administración de la nueva PDB.

Ejemplo 6-38 dbaascli pdb create

Para crear una PDB a partir de valores iniciales de una base de datos estándar en un entorno que no sea de Data Guard:
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --maxsize 5G --maxcpu 2
Para crear una PDB en un entorno de Data Guard:
dbaascli pdb create --dbName db721 --pdbName new_pdb1
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --standbyBlobFromPrimary /tmp/send_db721.tar

dbaascli pdb delete

Para suprimir una base de datos conectable (PDB), ejecute el comando dbaascli pdb delete.

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

dbaascli pdb delete --dbName value 
{ --pdbName value | --pdbUID value }
[--executePrereqs value]
[--waitForCompletion value]
[--resume [--sessionID value]]
[--allStandbyPrepared]
[--cleanupRelocatedPDB]
Donde:
  • --dbName especifica el nombre de la base de datos de contenedores que aloja la PDB
  • --pdbName especifica el nombre de la PDB que desea suprimir.
  • --pdbUID especifica el UID de la PDB que desea suprimir
  • --executePrereqs especifica yes para ejecutar solo los requisitos de esta operación. Valores válidos: yes o no
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true o false
  • --resume especifica que se reanude la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --allStandbyPrepared especifica que se confirme que la operación se ha ejecutado correctamente en todas las bases de datos en espera
  • --cleanupRelocatedPDB: opción para limpiar la base de datos de origen después de que se haya reubicado una PDB.
Ejemplo: dbaascli pdb delete

Para suprimir una PDB de una base de datos estándar en un entorno que no sea de Data Guard o de una base de datos en espera en un entorno de Data Guard. 

dbaascli pdb delete --dbName db721 --pdbName pdb1

Para crear una PDB a partir de la base de datos principal en un entorno de Data Guard: 

dbaascli pdb create --dbName db721 --pdbName pdb1 --allStandbyPrepared

dbaascli pdb getDetails

Para ver los detalles de una base de datos conectable (PDB), utilice el comando dbaascli pdb getDetails.

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

dbaascli pdb getDetails --dbname --pdbName | --pdbUID
Donde:
  • --dbname especifica el nombre de la base de datos de contenedores que aloja la PDB.
  • --pdbname especifica el nombre de la PDB que desea suprimir.
  • --pdbUID especifica el identificador de la PDB

Ejemplo 6-39 dbaascli pdb getDetails

dbaascli pdb getDetails--dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb getDetails--dbname cdb name --pdbUID con_uid of that pdb

dbaascli pdb list

Para ver la lista de bases de datos conectables (PDB) en una base de datos de contenedores, utilice el comando dbaascli pdb list.

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

dbaascli pdb list --dbname
Donde:
  • --dbname especifica el nombre de la base de datos de contenedores que aloja la PDB.

Ejemplo 6-40 dbaascli pdb list

dbaascli pdb list --dbname cdb name

dbaascli pdb localClone

Para crear una nueva base de datos conectable (PDB) como clon de una PDB existente en la misma base de datos de contenedores (CDB), utilice el comando dbaascli pdb localClone.

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

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>]
Donde:
  • --pdbName especifica el nombre de la nueva PDB que desea clonar.
  • --dbName especifica el nombre de la base de datos
  • --targetPDBName especifica el nombre de la PDB de destino (nueva PDB clonada)
  • --powerLimit especifica el grado de paralelismo que se utilizará para la operación de clonación. El valor válido está entre 1 y 128
  • --maxCPU especifica el número máximo de CPU que se van a asignar a la PDB
  • --maxSize especifica el tamaño máximo de almacenamiento en GB para la nueva PDB
  • --resume reanuda la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --executePrereqs especifica yes para ejecutar solo los requisitos de esta operación. Valores válidos: yes o no
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true o false
  • --blobLocation: ubicación de directorios personalizada donde se generará el archivo blob de base de datos en espera en un entorno de DG.
  • --standbyBlobFromPrimary especifica la ubicación del archivo blob de base de datos en espera, que se prepara a partir de la base de datos principal. Solo es necesario para operaciones de PDB de base de datos en espera.
    Nota

    Los parámetros --blobLocation y --standbyBlobFromPrimary se excluyen mutuamente.
  • --excludeUserTablespaces opción para omitir espacios de tabla de usuario, por ejemplo t1,t2,t3.
  • --excludePDBData especifique true/yes para omitir los datos de usuario de la PDB de origen.
  • --pdbAdminUserName especifique el nuevo nombre de usuario administrador de la PDB.
  • --lockPDBAdminAccount especifique true o false para bloquear la cuenta del usuario administrador de la PDB. El valor por defecto es true.
  • --sourcePDBServiceConvertList especifique una lista separada por comas de nombres de servicio de origen a destino que se deben convertir. La sintaxis es source_srv1:new_srv1,source_srv2:new_srv2.

La PDB recién clonada hereda las contraseñas de administración de la PDB de origen.

Ejemplo 6-41 dbaascli pdb localClone

dbaascli pdb localClone --dbName db35 --pdbName PDB35 --targetPDBName local_clone1 --maxCPU 2 --maxSize 15

dbaascli pdb open

Para abrir una base de datos conectable (PDB), utilice el comando dbaascli pdb open.

Ejecute el comando como usuario root o oracle.

Sintaxis

dbaascli pdb open
 {
   --pdbName <value> | --pdbUID <value>
 }
--dbname <value> [--openMode <value>] [--startServices <value>] [--waitForCompletion <value>] [--setPDBRefreshModeNone [--skipPDBRefresh] [--pdbAdminUserName <value>]]
Donde:
  • --pdbName especifica el nombre de la PDB que desea abrir.
  • --pdbUID especifica el identificador de la PDB
  • --dbname especifica el nombre de la base de datos de contenedores que contiene la PDB.
  • --openMode especifica el modo abierto (OPEN MODE) de destino de la PDB
  • --startServices: especifica que se inicien o se muestren todos los servicios correspondientes a una PDB. Los valores aceptados son all o una lista delimitada por comas de los servicios de la PDB.
  • --waitForCompletion: especifica false para que se ejecute la operación en segundo plano. Valores válidos: true|false
  • --setPDBRefreshModeNone: especifica que se convierta una PDB de refrescamiento en una PDB que no es de refrescamiento
    • --skipPDBRefresh: especifica que se omita el refrescamiento de la PDB refrescable
    • --pdbAdminUserName: especifica el nuevo nombre de usuario de administrador de la PDB

Cuando se completa correctamente, la PDB se abre en todas las instancias de la base de datos de contenedores.

Ejemplo 6-42 dbaascli pdb open

dbaascli pdb open --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb open --dbname cdb name --pdbUID con_uid of that pdb

Opcional: --openMode READ_WRITE/READ_ONLY

dbaascli pdb recover

Para recuperar una base de datos conectable (PDB), utilice el comando dbaascli pdb recover.

Requisito

  • Ejecute el comando con el usuario root.
  • La base de datos se debe configurar con los detalles del destino de almacenamiento de copia de seguridad donde se almacenan las copias de seguridad.

Sintaxis

dbaascli pdb recover --pdbName <value> --dbname <value>
        {
            --start
                {
                    --untilTime <value>
                    | --untilSCN <value>
                    | --latest
                    | --tag <value>
                }
            | --status --uuid <value>
        }
Donde:
--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>

Ejemplo 6-43 Ejemplos

  • Para recuperar una PDB pdb1 de una CDB myTestDb a la versión más reciente:
    dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --start --latest
  • Para consultar el estado de la solicitud de recuperación de PDB enviada con el uuid 81a17352362011ecbc3000163e8e4fac:
    dbaascli pdb recover --dbname myTestDb --pdbName pdb1 --status --uuid 81a17352362011ecbc3000163e8e4fac

dbaascli pdb refresh

Para refrescar una base de datos conectable (PDB) especificada, utilice el comando dbaascli pdb open.

Ejecute el comando como usuario root o oracle.

Sintaxis

dbaascli pdb refresh --dbname <value>
   {
      --pdbName <value> | --pdbUID <value>
    }
    [--waitForCompletion <value>]

Donde:

  • --dbname: especifica el nombre de la instancia de Oracle Database
  • --pdbName: especifica el nombre de la base de datos conectable
  • --pdbUID: especifica el identificador de la base de datos conectable
  • --waitForCompletion: especifica false para que se ejecute la operación en segundo plano. Valores válidos: true|false

dbaascli pdb relocate

Para reubicar la PDB especificada desde la base de datos remota a la base de datos local, utilice el comando dbaascli pdb relocate.

Requisito

Ejecute el comando con el usuario oracle. Cuando se le solicite, debe proporcionar la contraseña de usuario SYS para la base de datos origen.

Sintaxis

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]
}
Donde:
  • --pdbName especifica el nombre de la PDB de origen que se va a reubicar
  • --dbName especifica el nombre de la base de datos de destino
  • --sourceDBConnectionString especifica la cadena de conexión de la base de datos origen con el formato <scan_name>:<scan_port>/<database_service_name>
  • --targetPDBName especifica un nombre para la PDB de destino (nueva PDB reubicada)
  • --powerLimit especifica el grado de paralelismo que se utilizará para la operación de reubicación
  • --maxCpu especifica el número máximo de CPU que se van a asignar para la PDB
  • --maxSize especifica el tamaño máximo de almacenamiento en GB para la nueva PDB
  • --resume especifica que se reanude la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --executePrereqs especifica yes para ejecutar solo los requisitos de esta operación. Valores válidos: yes|no
  • --sourcePDBServices especifica una lista de los servicios de PDB de origen delimitados por comas
  • --sourcePDBReadOnlyServices especifica una lista delimitada por comas de servicios de solo lectura de PDB de origen
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true|false
  • --blobLocation: ubicación de directorios personalizada donde se generará el archivo blob de base de datos en espera en un entorno de DG.
  • --standbyBlobFromPrimary especifica la ubicación del archivo blob de base de datos 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.
    Nota

    Los parámetros --blobLocation se excluyen mutuamente.
  • --upgradePDB especifique true para cambiar la versión de la PDB como parte de esta operación. Valores válidos : true | false.
  • --updateDBBlockCachesize: opción para permitir a la aplicación que defina los parámetros de inicialización de tamaño de bloque de caché de la base de datos para soportar la copia de datos con distinto tamaño de bloque.
  • --skipOpenPDB para indicar que la PDB no se debe abrir al final de la operación actual.
  • --completePDBRelocate : la reubicación de la PDB se completará si se hace como una operación de dos pasos.

Ejemplo 6-44 dbaascli pdb relocate

dbaascli pdb relocate --sourceDBConnectionString test-scan.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521/source_cdb_service_name --pdbName source_pdb --dbName target_db

dbaascli pdb remoteClone

Para crear una nueva base de datos conectable (PDB) como clon de una PDB existente en otra base de datos de contenedores (CDB), utilice el comando dbaascli pdb remoteClone.

Ejecute el comando como usuario root o oracle.

Sintaxis

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]
Donde:
  • --pdbName especifica el nombre de la PDB de origen que desea clonar
  • --dbname especifica el nombre (DB_NAME) de la CDB que aloja la PDB recién clonada
  • --sourceDBConnectionString especifica la cadena de conexión de la base de datos origen con el formato scan_name:scan_port/database_service_name
  • --targetPDBName especifica el nombre de la PDB de destino (nueva PDB clonada)
  • --powerLimit especifica el grado de paralelismo que se utilizará para la operación de clonación. El valor válido está entre 1 y 128
  • --maxCPU especifica el número máximo de CPU que se van a asignar a la PDB
  • --maxSize especifica el tamaño máximo de almacenamiento en GB para la nueva PDB
  • --resume reanuda la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --executePrereqs especifica yes para ejecutar solo los requisitos de esta operación. Valores válidos: yes o no
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true o false
  • --sourcePDBExportedTDEKeyFile especifica el archivo de clave exportado de la PDB de origen. Esta variable solo se aplica a la base de datos 12.1.
  • --blobLocation especifica la ruta de acceso personalizada en la que se generará el archivo blob de base de datos en espera en un entorno de Data Guard
  • --standbyBlobFromPrimary especifica la ubicación del archivo blob de base de datos en espera, que se prepara a partir de la base de datos principal. Solo es necesario para las operaciones de PDB de base de datos en espera
    Nota

    Los parámetros --blobLocation y --standbyBlobFromPrimary se excluyen mutuamente.
  • --excludeUserTablespaces opción para omitir espacios de tabla de usuario, por ejemplo t1,t2,t3.
  • --excludePDBData especifique true/yes para omitir los datos de usuario de la PDB de origen.
  • --pdbAdminUserName especifica el nuevo nombre de usuario de administrador de la PDB
  • --lockPDBAdminAccount especifique true o false para bloquear la cuenta de usuario administrador de la PDB. El valor por defecto es true.
  • --sourcePDBServiceConvertList especifique una lista delimitada por comas de nombres de servicio de origen a destino que se deben convertir. La sintaxis es source_srv1:new_srv1, source_srv2:new_srv2.
  • --refreshablePDB especifica que se cree una PDB de refrescamiento
    • --refreshMode especifica el modo de refrescamiento para la PDB de refrescamiento. Valores válidos: AUTO|MANUAL
      • --refreshIntervalInMinutes especifica el intervalo de refrescamiento para refreshablePDB en minutos
    • --dblinkUsername especifica el usuario común de una base de datos remota, que se utiliza para que el enlace de base de datos se conecte a la base de datos remota
      • --honorCaseSensitiveUserName indica que el nombre de usuario especificado es sensible a mayúsculas/minúsculas
  • --updateDBBlockCacheSize: especifica que se permita a la aplicación definir los parámetros de inicialización de db block cache size para soportar la copia de datos con un tamaño de bloque distinto.

Al promocionarse, se debe proporcionar la contraseña de usuario SYS para la PDB de origen. La PDB recién clonada hereda las contraseñas de administración de la PDB de origen. La PDB clonada recibe un nombre con el siguiente formato: dbname_sourcepdbname. Este comando solo está soportado para bases de datos que no están en una configuración de Data Guard y que utilizan Oracle Database versión 12.2.0.1 o posterior.

Ejemplo 6-45 dbaascli pdb remoteClone

dbaascli pdb remoteClone --sourceDBConnectionString test-can.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521 --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2
dbaascli pdb remoteClone --sourceDBConnectionString orcla.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2

dbaascli system getDBHomes

Para ver la información sobre todos los directorios raíz de Oracle, utilice el comando dbaascli system getDBHomes.

Requisito

Ejecute el comando como usuario root o oracle.

Sintaxis

dbaascli system getDBHomes

Ejemplo 6-46 dbaascli system getDBHomes

dbaascli system getDBHomes

sistema dbaascli getGridHomes

Para mostrar los detalles de todos los directorios raíz de Grid, utilice el comando dbaascli system getGridHomes.

Requisito

Ejecute el comando como usuario root o oracle.

Sintaxis

dbaascli system getGridHomes

dbaascli tde changePassword

Para cambiar la contraseña del almacén de claves de TDE y la contraseña de la cartera de base de datos para el alias tde_ks_passwd, utilice el comando dbaascli tde changePassword.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde changePassword [--dbname <value>]
  {            [--prepareStandbyBlob <value> [--blobLocation <value>]]
               | [--standbyBlobFromPrimary <value>]
  }
  [--resume [--sessionID <value>]]
Donde:
  • --dbname especifica el nombre de la base de datos
  • --prepareStandbyBlob: especifique true para generar un archivo blob que contenga los artefactos necesarios para realizar la operación en un entorno de DG.
  • --blobLocation: ruta de acceso personalizada donde se generará el archivo blob de base de datos en espera en un entorno de DG.
  • --standbyBlobFromPrimary: especifique la ubicación del archivo blob de base de datos 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.
  • --resume: para reanudar la ejecución anterior
  • --sessionID: para reanudar un identificador de sesión específico.
Para cambiar la contraseña de TDE en un entorno que no sea de Data Guard
dbaascli tde changepassword --dbname
      <dbname>
Para cambiar la contraseña de TDE en un entorno de Data Guard
  1. Cambie la contraseña de TDE en la base de datos principal.
    dbaascli tde changepassword --dbname
      <dbname> --prepareStandbyBlob true --blobLocation
      <Location where blob file has to be generated>
  2. Copie el blob de base de datos en espera creado en el entorno de base de datos en espera.
  3. Cambie la contraseña de TDE en la base de datos en espera.
    dbaascli tde changepassword --dbname
     <dbname> --standbyBlobFromPrimary <Location of blob generated from
    primary>

dbaascli tde addSecondaryHsmKey

Para agregar una clave de HSM secundaria (KMS) a la configuración de HSM (KMS) existente, utilice el comando dbaascli tde addSecondaryHsmKey.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde addSecondaryHsmKey --dbname <value> --secondaryKmsKeyOCID <value>
[--executePrereqs]
Donde:
  • --secondaryKmsKeyOCID especifica la clave de KMS secundaria que se agregará a la configuración de HSM (KMS) existente.
  • --dbname especifica el nombre de la base de datos
  • --executePrereqs ejecuta las comprobaciones de requisitos e informa de los resultados.

Ejemplo 6-47 dbaascli tde addSecondaryHsmKey

dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --precheckOnly yes

dbaascli tde enableWalletRoot

Para activar el parámetro spfile wallet_root de la base de datos existente, utilice el comando dbaascli tde enableWalletRoot.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde enableWalletRoot --dbname <value>
[--dbRestart <value>]
[--executePrereqs]
[--resume [--sessionID <value>]]
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database.
  • --dbrestart especifica la opción de reinicio de la base de datos. Los valores válidos son: rolling o full. Valor por defecto: rolling

    Si no transfiere el argumento dbrestart, la base de datos se reiniciará de manera rolling.

  • --precheckOnly solo ejecuta la comprobación previa de esta operación. Los valores válidos son: yes o no
  • --resume para reanudar la ejecución anterior
  • --sessionID para reanudar un ID de sesión específico.

Ejemplo 6-48 dbaascli tde enableWalletRoot

dbaascli tde enableWalletRoot --dbname db name --dbrestart rolling|full
dbaascli tde enableWalletRoot --dbname orcl
dbaascli tde enableWalletRoot --dbname orcl--dbrestart full

dbaascli tde encryptTablespacesInPDB

Para cifrar todos los tablespaces en la PDB especificada, utilice el comando dbaascli tde encryptTablespacesInPDB.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde encryptTablespacesInPDB --pdbName
[--dbname]
[--precheckOnly]
[--useSysdbaCredential]
Donde:
  • --pdbName especifica el nombre de la PDB para cifrar todos los tablespaces.
  • --dbname especifica el nombre de la instancia de Oracle Database.
  • --precheckOnly solo ejecuta la comprobación previa de esta operación. Valores válidos: yes o no
  • --useSysdbaCredential utiliza credenciales de SYSDBA para esta operación si el valor transferido es true. Valores válidos: true o false

Ejemplo 6-49 dbaascli tde encryptTablespacesInPDB

dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb
dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb --precheckOnly yes
dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb --useSysdbaCredential true

dbaascli tde fileToHsm

Para convertir TDE basado en FILE en TDE basado en HSM (KMS/OKV), utilice el comando dbaascli tde fileToHsm.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde fileToHsm --kmsKeyOCID <value> --dbname <value> 
[--skipPatchCheck <value>] 
[--executePrereqs ] 
[--primarySuc <value>]
{
    [--resume [--sessionID <value>]] | [--revert [--sessionID <value>]]
}
[--waitForCompletion <value>]
Donde:
  • --kmsKeyOCID especifica el OCID de la clave de KMS que se utilizará para TDE. Solo se aplica si se ha seleccionado KMS para TDE
  • --dbname especifica el nombre de la base de datos
  • --skipPatchCheck omite la comprobación de validación de los parches necesarios si el valor transferido para este argumento es true. Valores válidos: true o false
  • --executePrereqs ejecuta las comprobaciones de requisitos e informa de los resultados.
  • --primarySuc especifique esta propiedad en la base de datos en espera del entorno de Data Guard una vez que el comando se haya ejecutado correctamente en la base de datos principal
  • --resume especifica que se reanude la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --revert especifica que se realice un rollback de la ejecución anterior
    • --sessionID especifica que se realice un rollback de un identificador de sesión específico
  • --waitForCompletion especifique false para ejecutar la operación en segundo plano. Valores válidos : true|false.

Ejemplo 6-50 dbaascli tde fileToHsm --kmsKeyOCID

dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs 
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --resume

dbaascli tde getHsmKeys

Para obtener los detalles de la clave activa de TDE, utilice el comando dbaascli tde getHsmKeys.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde getHsmKeys
[--dbname]
[--infoFile]
Donde:
  • --dbname especifica el nombre de la base de datos
  • --infoFile especifica la ruta de acceso del archivo en el que se guardará la lista de los OCID. La salida tiene el formato JSON

Ejemplo 6-51 dbaascli tde getHsmKeys

dbaascli tde getHsmkeys --dbname dbname
dbaascli tde getHsmkeys --dbname dbname --infoFile infoFilePath

dbaascli tde getMkidForKeyVersionOCID

Para obtener el identificador de clave maestra asociado al OCID de versión de clave de KMS, utilice el comando dbaascli tde getMkidForKeyVersionOCID.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde getMkidForKeyVersionOCID --kmsKeyVersionOCID <value>
[--dbname <value>]
[--waitForCompletion <value>]
Donde:
  • --kmsKeyVersionOCID especifica el OCID de versión de clave de KMS que se va a definir
  • --dbname especifica el nombre de la base de datos
  • --waitForCompletion especifique false para ejecutar la operación en segundo plano. Valores válidos : true|false.

Ejemplo 6-52 dbaascli tde getMkidForKeyVersionOCID

dbaascli tde getMkidForKeyVersionOCID --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha

dbaascli tde getPrimaryHsmKey

Para obtener la clave de HSM (KMS) primaria de la configuración de HSM (KMS) existente, utilice el comando dbaascli tde getPrimaryHsmKey.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde getPrimaryHsmKey
[--dbname]
Donde:
  • --dbname especifica el nombre de la base de datos

Ejemplo 6-53 dbaascli tde getPrimaryHsmKey

dbaascli tde getPrimaryHsmKey --dbname dbname

dbaascli tde hsmToFile

Para convertir TDE basado en HSM (KMS/OKV) en TDE basado en FILE, utilice el comando dbaascli tde hsmToFile.

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde hsmToFile 
[--dbname <value>] 
{
    [--prepareStandbyBlob <value> [--blobLocation <value>]
   | [--standbyBlobFromPrimary <value>]
}
] 
[--skipPatchCheck <value>] 
[--executePrereqs ] 
[--primarySuc <value>] 
{
     [--resume [--sessionID <value>]] |
     [--revert [--sessionID <value>]]
} 
[--waitForCompletion <value>]
Donde:
  • --dbname especifica el nombre de la base de datos
  • --prepareStandbyBlob: especifique true para generar un archivo blob que contenga los artefactos necesarios para realizar la operación en un entorno de DG.
  • --blobLocation: ubicación de directorios personalizada donde se generará el archivo blob de base de datos en espera en un entorno de DG.
  • --standbyBlobFromPrimary especifica la ubicación del archivo blob de base de datos 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.
  • --skipPatchCheck omite la comprobación de validación de los parches necesarios si el valor transferido para este argumento es true. Valores válidos: true o false
  • --executePrereqs ejecuta las comprobaciones de requisitos e informa de los resultados.
  • --primarySuc especifique esta propiedad en la base de datos en espera del entorno de Data Guard una vez que el comando se haya ejecutado correctamente en la base de datos principal
  • --resume reanuda la ejecución anterior
    • --sessionID especifica que se reanude un identificador de sesión específico
  • --revert especifica que se realice un rollback de la ejecución anterior
    • --sessionID especifica que se realice un rollback de un identificador de sesión específico
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true|false

Ejemplo 6-54 dbaascli tde hsmToFile

dbaascli tde hsmToFile --dbname dbname
dbaascli tde hsmToFile --dbname dbname --executePrereqs
dbaascli tde hsmToFile --dbname dbname --resume

dbaascli tde listKeys

Para mostrar las claves maestras de TDE, utilice el comando dbaascli tde listKeys.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde listKeys
[--dbname <value>]
[--infoFilePath <value>]
Donde:
  • --dbname especifica el nombre de la base de datos
  • --infoFilePath especifica la ruta absoluta del archivo donde se guardarán los resultados.

Ejemplo 6-55 dbaascli tde listKeys

dbaascli tde listKeys --dbname dbname
dbaascli tde listKeys --dbname dbname --infoFilePath infoFilePath

dbaascli tde removeSecondaryHsmKey

Para eliminar la clave de HSM (KMS) secundaria de la configuración de HSM (KMS) existente, utilice el comando dbaascli tde removeSecondaryHsmKey.

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde removeSecondaryHsmKey --dbname <value>
[--confirmDeletion]
[--secondaryKmsKeyOCID]
[--executePrereqs]
Donde:
  • --dbname especifica el nombre de la base de datos
  • --confirmDeletion si no se ha especificado, se le pedirá al usuario que suprima todas las claves de HSM(KMS) existentes.
  • Clave KMS secundaria --secondaryKmsKeyOCID que se eliminará de la configuración de HSM(KMS) existente. Si no se especifica, se eliminarán todas las claves de KMS secundarias.
  • --executePrereqs ejecuta las comprobaciones de requisitos e informa de los resultados.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli tde removeSecondaryHsmKey?

R: El comando dbaascli tde removeSecondaryHsmKey se utiliza para eliminar una clave secundaria del módulo de seguridad de hardware (HSM) de la configuración de HSM (KMS) existente en un entorno de Oracle Database.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli tde removeSecondaryHsmKey?

R: Debe:
  • Ejecute el comando con el usuario root.
  • Conéctese a una máquina virtual de Exadata Cloud Infrastructure mediante SSH.

P: ¿Qué hace el parámetro --force en el comando dbaascli tde removeSecondaryHsmKey?

R: El parámetro --force permite la eliminación de la clave de HSM secundaria sin solicitar confirmación al usuario. Si no se especifica, el comando pedirá al usuario que suprima las claves.

P: ¿Qué especifica el parámetro --secondaryKmsKeyOCID?

R: El parámetro --secondaryKmsKeyOCID especifica el OCID (identificador de Oracle Cloud) de la clave de KMS secundaria que desea eliminar de la configuración de HSM existente.

P: ¿Qué hace el parámetro --dbname?

R: El parámetro --dbname especifica el nombre de la base de datos para la que se elimina la clave de HSM secundaria.

P: ¿Cuál es el propósito del parámetro --precheckOnly?

R: Si se define en yes, el parámetro --precheckOnly solo ejecutará las comprobaciones previas para validar la preparación para la operación de eliminación sin eliminar realmente la clave de HSM secundaria. Si se define en no, se realiza la operación de eliminación completa.

P: ¿Es obligatorio el parámetro --force?

R: No, el parámetro --force es opcional. Si no se especifica, el sistema solicitará confirmación al usuario antes de continuar con la eliminación de la clave.

P: ¿Es obligatorio el parámetro --secondaryKmsKeyOCID?

R: Sí, debe proporcionar --secondaryKmsKeyOCID para identificar la clave de HSM secundaria específica que desea eliminar de la configuración.

P: ¿Es obligatorio el parámetro --dbname?

R: No, el parámetro --dbname es opcional. Si no se especifica, el comando intentará eliminar la clave HSM secundaria de la base de datos predeterminada en el sistema.

P: ¿Qué debo hacer si quiero eliminar la clave de HSM secundaria sin ninguna petición de datos de usuario?

R: Debe utilizar el parámetro --force para omitir la petición de confirmación y eliminar la clave de HSM secundaria directamente:

dbaascli tde removeSecondaryHsmKey --force --secondaryKmsKeyOCID <value>

P: ¿Cómo puedo probar si el sistema está listo para eliminar la clave HSM secundaria sin eliminarla realmente?

R: Puede utilizar el parámetro --precheckOnly definido en sí para realizar una comprobación previa:

dbaascli tde removeSecondaryHsmKey --precheckOnly yes --secondaryKmsKeyOCID <value>

P: ¿Qué sucede si no proporciono un nombre de base de datos con --dbname?

R: Si no se especifica el parámetro --dbname, el comando intentará eliminar la clave de HSM secundaria de la base de datos por defecto configurada en el sistema.

P: ¿Qué debo comprobar si el comando no elimina la clave HSM secundaria?

A: Asegúrese de que:
  • Está ejecutando el comando como usuario root.
  • Está conectado a la máquina virtual de Exadata Cloud Infrastructure.
  • Se proporcionan los valores --secondaryKmsKeyOCID y --dbname correctos. Consulte los mensajes de error y los logs para obtener más información sobre el fallo.

P: ¿Qué debo hacer si la operación de eliminación falla parcialmente?

R: Si la operación falla, revise los logs de errores e intente ejecutar el comando con --precheckOnly para asegurarse de que el sistema está listo para la operación. Si es necesario, corrija los problemas antes de volver a intentarlo.

P: ¿Puedo ejecutar el comando dbaascli tde removeSecondaryHsmKey mientras se ejecuta la base de datos?

R: Sí, el comando se puede ejecutar mientras la base de datos está en ejecución, ya que no necesita que la base de datos se pare.

P: ¿Cuál es el propósito de eliminar una clave HSM secundaria?

R: La eliminación de una clave de HSM secundaria se suele realizar cuando la clave ya no es necesaria o cuando desea gestionar las claves de cifrado utilizadas en la configuración de TDE (cifrado de datos transparente).

P: ¿Cómo me conecto a la máquina virtual de Exadata Cloud Infrastructure para ejecutar el comando?

R: Puede conectarse a la máquina virtual mediante SSH. Consulte la documentación de Exadata Cloud Infrastructure para obtener instrucciones sobre cómo establecer una conexión segura.

Ejemplo 6-56 dbaascli tde removeSecondaryHsmKey

dbaascli tde removeSecondaryHsmKey --dbname dbname
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde removeSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs

dbaascli tde rotateMasterKey

Rote la clave maestra para el cifrado de la base de datos.

Requisitos:

Ejecute el comando con el usuario root.

Sintaxis

(Opcional) <Introduzca la información de sintaxis aquí.>

dbaascli tde rotateMasterKey --dbname <value> 
[--rotateMasterKeyOnAllPDBs] 
[--pdbName <value>] 
[--executePrereqs] 
[--resume [--sessionID <value>]]
{
     [--prepareStandbyBlob <value> [--blobLocation <value>]]
     | [--standbyBlobFromPrimary <value>]
 }
Donde:
  • --dbname: nombre de la base de datos Oracle.
  • --rotateMasterKeyOnAllPDBs: especifique true para rotar la clave maestra de todas las PDB en la CDB. Valores válidos: true|false
  • --pdbName - especifica el nombre de la PDB.
  • --executePrereqs: ejecuta las comprobaciones de requisitos e informa de los resultados.
  • --resume: para reanudar la ejecución anterior
  • --sessionID: para reanudar un identificador de sesión específico.
  • --prepareStandbyBlob | --standbyBlobFromPrimary]
  • --prepareStandbyBlob: especifique true para generar un archivo blob que contenga los artefactos necesarios para realizar la operación en un entorno de DG.
  • --blobLocation: ubicación de directorios personalizada donde se generará el archivo blob de base de datos en espera en un entorno de DG.
  • --standbyBlobFromPrimary: especifique la ubicación del archivo blob de base de datos 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

dbaascli tde setKeyVersion

Para definir la versión de la clave primaria que se utilizará en la DB/CDB o en la PDB, utilice el comando dbaascli tde setKeyVersion.

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <value>
[--pdbName <value>]
[--masterKeyID <value>]
[--standbySuc]
[--executePrereqs]
[--waitForCompletion <value>]
Donde:
  • --kmsKeyVersionOCID especifica el OCID de versión de clave de KMS que se va a definir.
  • --dbname especifica el nombre de la base de datos.
  • --pdbName nombre de la PDB para utilizar el OCID de la versión de clave.
  • --masterKeyID especifica el identificador de clave maestra del OCID de versión de clave proporcionado. Esto se aplica al entorno de Data Guard.
  • --standbySuc especifique esta propiedad en la base de datos principal del entorno de Data Guard una vez que el comando se haya ejecutado correctamente en la base de datos en espera
  • --executePrereqs ejecuta las comprobaciones de requisitos e informa de los resultados.
  • --waitForCompletion especifique false para ejecutar la operación en segundo plano. Valores válidos: true|false

Ejemplo 6-57 dbaascli tde setKeyVersion

dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha --executePrereqs
dbaascli tde setKeyVersion --dbname dbname --pdbName pdb --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha

dbaascli tde setPrimaryHsmKey

Para cambiar la clave de HSM (KMS) primaria para la configuración de HSM (KMS) existente, utilice el comando dbaascli tde setPrimaryHsmKey.

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <value> --dbname <value>
[--allStandbyPrepared]
[--bounceDatabase]
[--executePrereqs]
[--resume [--sessionID <value>]]
Donde:
  • --primaryKmsKeyOCID especifica la clave primaria de KMS que se debe definir
  • --dbname especifica el nombre de la base de datos
  • --allStandbyPrepared se especifica para confirmar que la operación se ha ejecutado correctamente en todas las bases de datos en espera.
  • --bounceDatabase especifique este indicador para realizar el reinicio sucesivo de la base de datos para esta operación
  • --executePrereqs ejecuta las comprobaciones de requisitos e informa de los resultados.
  • --resume para reanudar la ejecución anterior
  • --sessionID para reanudar un ID de sesión específico.

Ejemplo 6-58 dbaascli tde setPrimaryHsmKey

dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs

dbaascli tde status

Para mostrar información sobre el almacén de claves de la base de datos especificada, utilice el comando dbaascli tde status.

Requisito

Nota

El comando dbaascli tde status está en desuso en la versión 24.4.1.0.0 de dbaascli. Oracle recomienda utilizar el comando dbaascli database getDetails en su lugar.

Ejecute el comando con el usuario oracle.

Sintaxis

dbaascli tde status --dbname dbname
Donde:
  • --dbname especifica el nombre de la base de datos que desea comprobar.

La salida del comando incluye el tipo de almacén de claves y el estado del almacén de claves.

Ejemplo 6-59 dbaascli tde status

dbaascli tde status --dbname dbname