Uso de la herramienta dbaascli con Oracle Exadata Database Service on Cloud@Customer

Descubra cómo utilizar la utilidad dbaascli en Oracle Exadata Database Service on Cloud@Customer.

Acerca del uso de la utilidad dbaascli en Oracle Exadata Database Service on Cloud@Customer

Puede utilizar la utilidad dbaascli para realizar diversas operaciones de administración y ciclo de vida de la base de datos en Oracle Exadata Database Service on Cloud@Customer, como crear una instancia de Oracle Database, aplicar parches a una instancia de Oracle Database, gestionar bases de datos conectables (PDB), escalar el recuento de núcleos de CPU en modo desconectado, etc.

Para escalar recursos, debe utilizar la consola DBaaS o la interfaz de línea de comandos. Las capacidades de la utilidad dbaascli son adicionales e independientes de la consola de Oracle Cloud Infrastructure, 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 at Customer. Consulte Conexión a una máquina virtual con SSH.

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.

Creación de Oracle Database 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.

Lista de versiones e imágenes de software disponibles para la base de datos

Para obtener una lista de las versiones soportadas disponibles para crear una instancia de Oracle Database, 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

    La salida del comando muestra las imágenes de software de base de datos 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 7-1 dbaascli cswlib showImages

dbaascli cswlib showImages

DBAAS CLI version MAIN Executing command cswlib showImages 
INFO : Log file => /var/opt/oracle/log/list/list_2021-05-10_10:11:00.56966610630.log 

############ List of Available DB Images #############
1.IMAGE_TAG=19.8.0.0.0
VERSION=19.8.0.0.0
DESCRIPTION=19c JUL 2020 DB Image
IMAGE_ALIASES=19000-19800,19000-JUL2020

2.IMAGE_TAG=19.8.0.0.0-NC
VERSION=19.8.0.0.0
DESCRIPTION=19c JUL 2020 Non CDB Image
IMAGE_ALIASES=19000-NC19800,19000-NCJUL2020

3.IMAGE_TAG=19.9.0.0.0
VERSION=19.9.0.0.0
DESCRIPTION=19c OCT 2020 DB Image
IMAGE_ALIASES=19000-19900,19000-OCT2020

4.IMAGE_TAG=19.9.0.0.0-NC
VERSION=19.9.0.0.0
DESCRIPTION=19c OCT 2020 Non CDB Image
IMAGE_ALIASES=19000-NC19900,19000-NCOCT2020
Nota

Puede especificar la versión de destino en el comando dbaascli dbhome create como valor --version de la salida del comando dbaascli cswlib showImages.

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.

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 Database Service on Cloud at Customer se define como la contraseña para las credenciales de administrador de SYS, SYSTEM, cartera de TDE y 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.

Para cambiar la contraseña de SYS de una base de datos de Exadata Database Service on Cloud at Customer

  1. Conéctese a la máquina virtual de Exadata Database Service on Cloud at Customer 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>

Para cambiar la contraseña de la cartera de TDE para una base de datos de Exadata Database Service on Cloud at Customer

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

Gestión de imágenes de software de Oracle Exadata Database Service on Cloud@Customer con la utilidad dbaascli

Puede mostrar y descargar las imágenes de software de base de datos Oracle en una instancia de Oracle Exadata Database Service on Cloud@Customer, que se puede utilizar 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 Oracle Exadata Database Service on Cloud@Customer 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 que se instala al aprovisionar una nueva base de datos en una instancia de Oracle Exadata Database Service on Cloud@Customer 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.

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 7-2 dbaascli cswlib showImages

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

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

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

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

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

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

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

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

Descarga de una imagen de software

Puede descargar las imágenes de software disponibles en la instancia de Oracle Exadata Database Service on Cloud@Customer mediante el subcomando cswlib download de la utilidad dbaascli.

  1. Conéctese a un nodo de recursos informáticos con el 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 Oracle Exadata Database Service on Cloud@Customer.

    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 del 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 de Oracle Grid Infrastructure y Oracle Database en un sistema Exadata Cloud at Customer.

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

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 7-3 dbaascli cswlib showImages

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

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

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

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

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

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

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

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

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, conéctese en primer lugar a una máquina virtual de la instancia de Exadata Cloud at Customer 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.

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

Actualización de las herramientas en la nube mediante dbaascli

Para actualizar la versión de las herramientas en la nube de Oracle Exadata Database Service en Cloud at Customer, complete este procedimiento.

Las herramientas específicas de la nube se utilizan en las VM de invitado de Exadata Cloud at Customer 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
Nota

Si la base de datos de origen utiliza OKV para la gestión del almacén de claves de TDE, la operación de base de datos duplicada actual no soporta esta configuración.

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.

Versión 25.2.1.0.0 (250612)

  • Incluye AHF 25.2.4
  • Incluye syslens 25.1.4.0
  • Varias correcciones de bugs y mejoras en la estabilidad

Versión 25.1.2.0.0 (250505)

  • Incluye AHF 25.2.4
  • Incluye syslens 25.1.1.0
  • Varias correcciones de bugs y mejoras en la estabilidad

Versión 25.1.1.0.0 (250220)

  • Incluye AHF 24.11.0
  • Incluye syslens 24.4.2.0
  • Varias correcciones de bugs y mejoras en la estabilidad

Versión 24.4.1.0.0 (241212)

  • Incluye AHF 24.9.1
  • Incluye syslens 24.3.3.1
  • Varias correcciones de bugs y mejoras en la estabilidad

Versión 24.3.2.0.0 (240912)

  • Incluye AHF versión 24.7
  • Incluye syslens versión 24.3.1.0
  • Varias correcciones de bugs y mejoras en la estabilidad

Versión 24.3.1.0.0 (240730)

  • Migración de TDE de sqlnet.ora a wallet_root al actualizar la base de datos a la versión 19c
  • Parche de cuadrícula in situ para utilizar la aplicación de parches basada en imágenes como modo por defecto
  • Incluye AHF versión 24.6.1
  • Incluye syslens versión 24.1.2.0
  • Varias correcciones de bugs y mejoras en la estabilidad

24.2.1.0.0 (240620)

  • Se ha agregado soporte para Oracle Database 23ai.
  • Incluye AHF versión 24.4.3
  • Incluye syslens versión 24.1.2.0
  • Varias correcciones de bugs y mejoras en la estabilidad.

Versión 24.1.2.0.0 (240327, 240424, 240502)

  • Incluye AHF versión 24.1.1.
  • Incluye syslens versión 2.6.8.0.
  • Varias correcciones de bugs y mejoras en la estabilidad

Versión 24.1.1.0.0 (240118, 240219)

  • Incluye AHF versión 23.11.1.
  • Incluye syslens versión 2.6.4.3.
  • Varias correcciones de bugs y mejoras en la estabilidad
  • (240219) Corrección de bug 36309260 aplicable a la versión 21.2 o anterior del agente de DBCS: la comunicación entre el plano de control de OCI y el agente de DBCS no funciona en algunas máquinas virtuales.

23.4.1.0.0 (231219)

  • Incluye AHF versión 23.9.5.
  • Incluye syslens versión 2.6.4.2.
  • Varias correcciones de bugs y mejoras en la estabilidad

Versión 23.3.2.0.0 (231115)

  • 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.
  • Incluye AHF versión 23.7
  • Incluye syslens versión 2.3.6.10
  • Varias correcciones de bugs y mejoras en la estabilidad

Versión 23.3.1.0.0 (230817, 231020)

  • 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.
  • 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 Data Guard. 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.
    • Incluye AHF versión 23.5.2 - Versión 23.3.1.0.0 (230817)
    • Incluye AHF versión 23.5.4 - Versión 23.3.1.0.0 (231020)
  • Incluye syslens versión 2.3.6.9
  • Varias correcciones de bugs y mejoras en la estabilidad
  • Correcciones de producto críticas adicionales (231020)

Versión 23.2.1.0.0 (230708, 230724)

  • 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.
    • Incluye AHF versión 23.3.4 - Versión 23.2.1.0.0 (230708)
    • Incluye AHF versión 23.3.5 - Versión 23.2.1.0.0 (230724)
  • Varias correcciones de bugs y mejoras en la estabilidad

Versión 23.1.2.0.0 (2304411, 230616)

  • 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.
  • Incluye AHF versión 23.2.0
  • Varias correcciones de bugs y mejoras en la estabilidad

Versión 23.1.1.0.1 (230302)

  • 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.
  • Incluye AHF versión 22.2.5
  • Varias correcciones de bugs y mejoras en la estabilidad

Versión 22.4.1.0.1 (221214)

  • 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

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

Versión 22.3.1.0.1 (220831)

  • 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

Versión 22.2.1.1.0 (220713)

  • 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

Versión 22.2.1.0.1 (220504)

  • Nuevos comandos dbaascli:
    • Se ha introducido dbaascli admin showLatestStackVersion para mostrar la versión más reciente de dbaastools disponible para que los clientes puedan descargarla e instalarla. La instalación del RPM de dbaastools se puede realizar mediante el comando dbaascli admin updateStack. Para obtener más información, consulte la sección Referencia del comando dbaascli.
  • Biblioteca de software en la nube:
    • El soporte para activación de BP (dbaascli cswlib activateBP) ha quedado en desuso 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 Image Tags. 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 mediante imágenes normales. Para obtener más información, 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 más información, 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 Data Guard 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

Versión 22.1.1.1.0 (220301)

  • 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

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 recover –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.
    • Flujo de trabajo renovado 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 del latido de 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

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.

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.

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.

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.

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.

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 tomar 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 utilizan DBCA en los scripts actuales pueden actualizar sus scripts existentes para llamar a dbaascli en lugar de a DBCA. Si no se puede utilizar dbaascli debido a que 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.

Administración y configuración

En esta sección se tratan las tareas esenciales para gestionar y configurar entornos de Oracle Database. Incluye comandos como dbaascli admin updateStack para instalar o actualizar el RPM dbaastools y dbaascli job getStatus para comprobar el estado de trabajos específicos.

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 Database Service en Cloud at Customer.

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

Preguntas frecuentes

P: ¿Para qué se utiliza el comando dbaascli admin updateStack?

R: El comando dbaascli admin updateStack se utiliza para instalar o actualizar un RPM de dbaastools en Exadata Cloud Infrastructure.

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli admin updateStack?

R: debe ejecutar el comando como usuario raíz y conectarse a una máquina virtual de Exadata Cloud Infrastructure.

P: ¿Qué hace la opción --resume?

R: la opción --resume reanuda la ejecución anterior del comando updateStack si se ha interrumpido o está incompleta.

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

R: La opción --prechecksOnly solo ejecuta las comprobaciones previas de la operación sin realizar realmente la instalación o actualización.

P: ¿Cómo se utiliza el parámetro --nodes?

R: El parámetro --nodes especifica una lista delimitada por comas de nodos en los que se debe instalar el RPM. Si no se proporciona, el RPM se instalará en todos los nodos del cluster.

P: ¿Qué debo hacer si encuentro problemas con el comando dbaascli admin updateStack?

R: Asegúrese de que está ejecutando el comando como usuario raíz y de que está conectado a una máquina virtual de Exadata Cloud Infrastructure. Compruebe si hay mensajes de error específicos y consulte la documentación del comando o los Servicios de Soporte Oracle si es necesario.

P: ¿Cómo me conecto a una máquina virtual de Exadata Cloud Infrastructure para utilizar el comando dbaascli admin updateStack?

R: Debe utilizar SSH para conectarse a la máquina virtual. Consulte la sección sobre la conexión a una máquina virtual con SSH en la documentación para obtener instrucciones detalladas.

Ejemplos de casos de uso

Ejemplo 1: Instalación o actualización del RPM de dbaastools en todos los nodos

dbaascli admin updateStack

Instala o actualiza el RPM dbaastools en todos los nodos del entorno de Exadata Cloud@Customer.

Ejemplo 2: Ejecución de comprobaciones previas solo antes de instalar o actualizar el RPM

dbaascli admin updateStack --prechecksOnly

Ejecuta solo las comprobaciones previas para la actualización de RPM dbaastools, sin realizar realmente la instalación. Garantiza que se cumplan todos los requisitos previos antes de continuar con la actualización.

Ejemplo 3: Reanudación de una operación updateStack previamente interrumpida

dbaascli admin updateStack --resume

Reanuda una operación de actualización de RPM dbaastools anterior que se interrumpió o no se completó correctamente.

Ejemplo 4: Instalación o actualización de dbaastools en nodos específicos

dbaascli admin updateStack --nodes node1,node2

Instala o actualiza el RPM dbaastools solo en los nodos especificados node1 y node2, sin afectar a otros nodos del cluster.

Ejemplo 5: reanudación del proceso updateStack en nodos específicos

dbaascli admin updateStack --resume --nodes node3,node4

Reanuda el proceso de actualización para dbaastools solo en los nodos específicos node3 y node4 si se ha interrumpido la ejecución anterior.

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.

Para utilizar la utilidad, debe conectarse a una máquina virtual de Exadata Cloud at Customer.

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

Sintaxis

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

Preguntas frecuentes

P: ¿Para qué se utiliza el comando dbaascli job getStatus?

R: El comando dbaascli job getStatus se utiliza para ver el estado

Ejemplos de casos de uso

Ejemplo 1: Comprobación del estado de un trabajo específico mediante el ID de trabajo

dbaascli job getStatus --jobID 12345

Comprueba el estado del trabajo con el ID 12345. La salida mostrará el estado actual del trabajo (por ejemplo, en curso, completado o con fallos).

Ejemplo 2: Comprobación del estado de un trabajo de aplicación de parches mediante el ID de trabajo

dbaascli job getStatus --jobID 98765

Recupera el estado de un trabajo de aplicación de parches con el ID 98765 para ver si el parche se ha aplicado correctamente o si aún se está ejecutando.

Ejemplo 3: Comprobación del estado de un trabajo de copia de seguridad de base de datos

dbaascli job getStatus --jobID 45678

Comprueba el estado de un trabajo de copia de seguridad de base de datos con el ID 45678. La salida proporcionará detalles sobre el progreso o la finalización de la copia de seguridad.

Ejemplo 4: Comprobación del progreso de un trabajo de larga ejecución

dbaascli job getStatus --jobID 23456

Compruebe el progreso de un trabajo de larga ejecución (ID 23456) para ver si aún se está ejecutando o si ha terminado.

Ejemplo 5: Visualización del estado de un trabajo de creación de base de datos

dbaascli job getStatus --jobID 67890

Comprueba el estado de un trabajo de creación de base de datos identificado por el ID de trabajo 67890.

Ampliación de CPU

Esta sección se centra en el ajuste de recursos de CPU en un cluster de VM. Incluye comandos como dbaascli cpuscale get_status para comprobar el estado de las solicitudes de escala actuales o pasadas, y dbaascli cpuscale update para aumentar o reducir el número de núcleos de CPU asignados a una máquina virtual, lo que permite una gestión de recursos flexible basada en las demandas de carga de trabajo.

dbaascli cpuscale get_status

Para comprobar el estado de la solicitud de escalado actual o más reciente cuando se interrumpe la conectividad de red entre el servidor del plano de control y la región de OCI, utilice el comando dbaascli cpuscale get_status.

Requisitos

Ejecute el comando con el usuario root.

Para utilizar la utilidad, debe conectarse a una máquina virtual de Exadata Cloud at Customer.

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

Sintaxis

Muestra varios estados de ejecución de comandos a medida que avanzan de scheduled (programado) a running (en ejecución) y, por último, a success (correcto) o failure (fallo).
dbaascli cpuscale get_status

Preguntas frecuentes

P: ¿Para qué se utiliza el comando dbaascli cpuscale get_status?

R: El comando dbaascli cpuscale get_status se utiliza para comprobar el estado de la solicitud de escalado de CPU actual o última, especialmente cuando se interrumpe la conectividad de red entre el servidor del plano de control y la región de OCI.

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli cpuscale get_status?

R: Debe ejecutar el comando como usuario root y conectarse a una máquina virtual de Exadata Cloud@Customer.

P: ¿Qué debo hacer si encuentro problemas al ejecutar el comando dbaascli cpuscale get_status?

R: Asegúrese de que está ejecutando el comando como usuario root y de que está conectado a una máquina virtual de Exadata Cloud@Customer. Si los problemas persisten, consulte la documentación del comando o busque soporte de Oracle.

P: ¿Qué ocurre si el comando muestra un estado de fallo?

R: Si el comando muestra un estado de fallo, compruebe los logs detallados en busca de mensajes de error y solucione problemas en función del error específico. Puede que tenga que solucionar problemas de red o revisar los detalles de la solicitud de escala.

Ejemplos de casos de uso

Ejemplo 1: Comprobación del estado de la operación de escala de CPU más reciente

dbaascli cpuscale get_status

Comprueba el estado de la solicitud de escala de CPU actual o última. Proporcionará información sobre si la escala está programada, en ejecución o se ha completado con éxito o fallo.

Ejemplo 2: Comprobación del estado después de un fallo en una solicitud de escala

Se ha solicitado una operación de escala, pero se han encontrado problemas de red entre el servidor del plano de control y la región de OCI.

dbaascli cpuscale get_status

Comprueba el estado de la solicitud de escala. Dado que el proceso de escalado falló debido a problemas de red, la salida proporcionará detalles sobre el estado de fallo.

Ejemplo 3: Comprobación del estado cuando la escala está en curso

Una operación de ampliación de CPU está en curso y el usuario desea supervisar su progreso.

dbaascli cpuscale get_status

Comprueba el estado actual, que muestra que la solicitud de escala está en estado "en ejecución". Permite al usuario realizar un seguimiento de la operación hasta que se complete o falle.

Ejemplo 4: Comprobación del estado después de la finalización correcta de la escala

Se ha realizado y completado correctamente una operación de escala.

dbaascli cpuscale get_status

Comprueba el estado y confirma que la operación de escala se ha completado correctamente. Informa del estado final como "éxito".

dbaascli cpuscale update

Para escalar o reducir verticalmente el recuento de núcleos de CPU de una máquina virtual en un cluster de VM cuando se interrumpe la conectividad de red entre el servidor del plano de control y la región de OCI, utilice el comando dbaascli cpuscale update.

Requisitos

Para escalar o reducir verticalmente las OCPU de un cluster de VM en modo desconectado, ejecute los comandos dbaascli cpuscale update y dbaascli cpuscale get_status desde cualquier nodo de un cluster de VM para cambiar el recuento de núcleos de CPU de ese cluster. Si tiene más de un cluster de VM, ejecute un comando independiente desde cualquier nodo de cada cluster de VM que desee escalar o reducir verticalmente. Estos comandos están diseñados de modo que no funcionen si se emiten durante el modo de conexión normal y sufrirán un timeout después de 600 segundos (10 minutos).

Ejecute el comando con el usuario root.

Para utilizar la utilidad, debe conectarse a una máquina virtual de Exadata Cloud at Customer.

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

Sintaxis

Se considera que Exadata Database Service en Cloud at Customer está en modo Desconectado cuando se produce una pérdida de conectividad con el plano de control de DBaaS que se ejecuta en Oracle Cloud Infrastructure (OCI).

dbaascli cpuscale update --coreCount coreCount --message message
Donde:
  • --coreCount especifica el número de destino de las CPU que desea escalar o reducir hacia abajo para cada VM en el cluster
  • --message Si lo desea, puede incluir un mensaje para su referencia

Preguntas frecuentes

P: ¿Para qué se utiliza el comando dbaascli cpuscale update?

R: El comando dbaascli cpuscale update se utiliza para escalar o reducir verticalmente el recuento de núcleos de CPU de una máquina virtual en un cluster de VM cuando se produce una interrupción de la conectividad de red entre el servidor del plano de control y Oracle Cloud Infrastructure (OCI).

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli cpuscale update?

R: Antes de utilizar este comando, asegúrese de ejecutarlo en modo desconectado, lo que significa que hay una pérdida de conectividad con el plano de control DBaaS en OCI. Ejecute el comando desde cualquier nodo dentro del cluster de VM y tenga en cuenta que se agotará el tiempo de espera después de 600 segundos (10 minutos) si se utiliza en modo conectado. El comando se debe ejecutar como usuario raíz.

P: ¿Cómo me conecto a una máquina virtual para usar este comando?

R: Para utilizar el comando dbaascli cpuscale update, debe conectarse a una máquina virtual de Exadata Cloud@Customer mediante SSH. Consulte "Conexión a una máquina virtual con SSH" para obtener instrucciones detalladas.

P: ¿Qué especifica la opción --coreCount en el comando?

R: la opción --coreCount especifica el número de destino de las CPU que desea escalar o reducir para cada VM del cluster.

P: ¿Puedo incluir un mensaje con el comando dbaascli cpuscale update?

R: Sí, puede incluir un mensaje opcional con la opción --message como referencia.

P: ¿Cómo puedo comprobar el estado de una operación de escala de CPU?

R: Para comprobar el estado de una operación de escala de CPU, utilice el comando dbaascli cpuscale get_status. También se debe ejecutar desde cualquier nodo dentro del cluster de VM.

P: ¿Qué sucede si ejecuto el comando dbaascli cpuscale update en modo conectado?

R: El comando está diseñado para no funcionar en modo conectado y se agotará el tiempo de espera después de 600 segundos (10 minutos). Solo se debe utilizar en modo desconectado.

P: ¿Cómo amplío los núcleos de CPU para varios clusters de VM?

R: Si tiene más de un cluster de VM, debe ejecutar el comando dbaascli cpuscale update por separado desde cualquier nodo de cada cluster de VM que desee escalar o reducir.

Ejemplos de casos de uso

Ejemplo 1: ampliación de núcleos de CPU a 20

El cluster de VM se está ejecutando con 16 núcleos y desea aumentarlo a 20.

dbaascli cpuscale update --coreCount 20 --message "Scaling up for increased demand"

Escala el recuento de núcleos de CPU hasta 20 e incluye un mensaje de referencia "Escalando para aumentar la demanda".

Ejemplo 2: reducción de núcleos de CPU a 8

El cluster de VM está utilizando actualmente 12 núcleos, pero desea reducir el recuento a 8 para ahorrar recursos.

dbaascli cpuscale update --coreCount 8 --message "Reducing CPU for maintenance period"

Reduce el número de núcleos de CPU a 8 y proporciona un mensaje para futuras referencias sobre el motivo por el que se realizó la operación de escala.

Ejemplo 3: Escalado de CPU sin mensaje

Debe escalar los núcleos de CPU de 32 a 24, pero no es necesario ningún mensaje adicional.

dbaascli cpuscale update --coreCount 24

Este comando escala el recuento de núcleos a 24 sin ningún mensaje. La operación se llevará a cabo con el registro por defecto de acciones.

Ejemplo 4: verificación del estado después de escalar la CPU

Después de ejecutar el comando de escala, desea comprobar si la actualización se ha realizado correctamente.

dbaascli cpuscale get_status

Comprueba el estado de la solicitud de ampliación actual o última, lo que le permite confirmar si la operación de ampliación o reducción vertical se ha realizado correctamente.

Ejemplo 5: Intento de escala cuando la VM ya está en un máximo de núcleos

El cluster de VM ya tiene el máximo permitido de núcleos de CPU (48), pero se intenta ampliar.

dbaascli cpuscale update --coreCount 50 --message "Attempt to scale beyond limit"

Fallo porque el cluster de VM no puede superar el máximo de núcleos permitidos. El estado reflejará el fallo después de intentar escalar a 50 núcleos.

Gestión de la biblioteca de software en la nube (CSWLIB)

En esta sección se proporcionan herramientas para gestionar imágenes de software en entornos de Exadata Database Service on Cloud@Customer. Comandos como dbaascli cswlib deleteLocal permiten la eliminación de imágenes locales, mientras que dbaascli cswlib download permite la descarga de nuevas imágenes de software. También puede ver las imágenes disponibles localmente con dbaascli cswlib listLocal o comprobar todas las imágenes de Database y Grid Infrastructure disponibles mediante dbaascli cswlib showImages. Estos comandos ayudan a gestionar y mantener eficazmente las bibliotecas de software.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli cswlib deleteLocal?

R: El comando dbaascli cswlib deleteLocal se utiliza para suprimir una imagen del directorio raíz de Oracle local del sistema.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli cswlib deleteLocal?

R: El comando se debe ejecutar como usuario root para garantizar que estén disponibles los permisos necesarios para suprimir la imagen local.

P: ¿Cómo especifico qué imagen local borrar?

R: utilice la opción --imageTag para especificar la etiqueta de imagen del directorio raíz de Oracle que desea suprimir.

P: ¿Qué representa la opción --imageTag en el comando?

R: la opción --imageTag representa el identificador o la etiqueta asociados a la imagen del directorio raíz de Oracle que desea suprimir.

P: ¿Puedo eliminar varias imágenes locales a la vez con este comando?

R: No, el comando dbaascli cswlib deleteLocal permite suprimir solo una imagen local a la vez, especificada por su etiqueta de imagen.

P: ¿Qué sucede si ejecuto el comando dbaascli cswlib deleteLocal sin especificar --imageTag?

R: El comando fallará porque se necesita --imageTag para identificar qué imagen local se debe suprimir.

P: ¿Es posible recuperar una imagen local después de que se haya suprimido con este comando?

R: No, una vez que se suprime la imagen local mediante el comando dbaascli cswlib deleteLocal, no se puede recuperar. Asegúrese de verificar la etiqueta de imagen antes de continuar.

P: ¿Cuándo necesitaría utilizar el comando dbaascli cswlib deleteLocal?

R: Utilice este comando cuando necesite eliminar una imagen del directorio raíz de Oracle no utilizada u obsoleta del sistema local para liberar espacio o limpiar el entorno.

Ejemplo 7-4 dbaascli cswlib deletelocal

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

Para descargar las imágenes de software disponibles y hacer que estén disponibles en el entorno de Exadata Database Service on Cloud at Customer, 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 Database Service en Cloud at Customer.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli cswlib download?

R: El comando dbaascli cswlib download se utiliza para descargar las imágenes de software disponibles y hacer que estén disponibles en Exadata Cloud Infrastructure.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli cswlib download?

R: Debe ejecutar el comando como usuario root. Además, debe estar conectado a una máquina virtual de Exadata Cloud Infrastructure.

P: ¿Cómo me conecto a la máquina virtual necesaria para este comando?

R: Debe utilizar SSH para conectarse a la máquina virtual de Exadata Cloud Infrastructure. Puede encontrar instrucciones detalladas en la documentación en "Conexión a una máquina virtual con SSH".

P: ¿Qué especifica la opción --version en el comando?

R: la opción --version especifica la versión de la imagen de inicio de Oracle que desea descargar.

P: ¿Cómo puedo utilizar la opción --imageTag en el comando dbaascli cswlib download?

R: La opción --imageTag se utiliza para especificar la etiqueta de imagen de la imagen de software que desea descargar.

P: ¿Cuál es el propósito de la opción --product en el comando?

R: La opción --product especifica el tipo de imagen que desea descargar. Los valores válidos son database o grid.

P: ¿Puedo descargar imágenes de base de datos y de cuadrícula simultáneamente?

R: No, debe especificar database o grid mediante la opción --product, por lo que cada operación de descarga es específica de un tipo de imagen.

P: ¿Qué sucede si no especifico una versión o etiqueta de imagen?

R: Es probable que el comando falle o le solicite la información necesaria, ya que las opciones --version o --imageTag son necesarias para identificar la imagen de software específica que desea descargar.

P: ¿Es necesario especificar ambos --version y --imageTag juntos?

R: No, normalmente especifica --version o --imageTag en función de cómo desea identificar la imagen que desea descargar, pero no ambos al mismo tiempo.

P: ¿Cuándo utilizaría el comando dbaascli cswlib download?

R: Debe utilizar este comando cuando necesite descargar imágenes de software del directorio raíz de Oracle para entornos database o grid en la configuración de Exadata Cloud Infrastructure.

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

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli cswlib listLocal?

R: El comando dbaascli cswlib listLocal se utiliza para ver la lista de imágenes de Database y Grid Infrastructure disponibles localmente en el sistema.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli cswlib listLocal?

R: El comando se debe ejecutar como usuario root para tener los permisos necesarios para acceder a las imágenes disponibles y mostrarlas.

P: ¿Cómo puedo especificar qué tipo de imágenes mostrar con este comando?

R: utilice la opción --product para especificar el tipo de imágenes del directorio raíz de Oracle que desea mostrar. Los valores válidos son database o grid.

P: ¿Qué representa la opción --product en el comando dbaascli cswlib listLocal?

R: la opción --product identifica el tipo de producto del directorio raíz de Oracle, lo que permite filtrar la lista de imágenes disponibles a los tipos database o grid.

P: ¿Puedo enumerar tanto imágenes de base de datos como de cuadrícula simultáneamente?

R: No, la opción --product permite mostrar imágenes database o grid a la vez. Debe ejecutar el comando dos veces con diferentes valores --product para ver ambas listas.

P: ¿Qué sucede si no especifico la opción --product en el comando?

R: Si no se especifica la opción --product, es posible que el comando muestre todas las imágenes disponibles localmente o que necesite especificar el tipo de producto. El comportamiento puede depender de la configuración del entorno.

P: ¿Cuándo debo utilizar el comando dbaascli cswlib listLocal?

R: Debe utilizar este comando cuando desee comprobar qué imágenes de Database o Grid Infrastructure están disponibles localmente en el sistema.

P: ¿Cómo puedo diferenciar entre imágenes de cuadrícula y de base de datos en la lista?

R: La opción --product le permite filtrar la lista, por lo que al especificar database o grid, solo verá las imágenes relevantes para ese tipo de producto, lo que facilita la diferenciación.

P: ¿Existe algún riesgo asociado a la ejecución del comando dbaascli cswlib listLocal?

R: No, este comando no es destructivo y solo muestra información sobre las imágenes disponibles localmente. No modifica ni suprime ningún archivo.

P: ¿Este comando muestra imágenes remotas o almacenadas en la nube?

R: No, el comando dbaascli cswlib listLocal solo muestra imágenes que están disponibles localmente en el sistema, no las almacenadas de forma remota o en la nube.

Ejemplo 7-7 dbaascli cswlib listlocal

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli cswlib showImages?

R: El comando dbaascli cswlib showImages se utiliza para ver la lista de imágenes de Database y Grid Infrastructure disponibles que se pueden descargar o gestionar en el entorno de Oracle Exadata Database Service.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli cswlib showImages?

R: El comando se debe ejecutar como usuario root para asegurarse de que tiene los permisos necesarios para ver las imágenes disponibles.

P: ¿Cómo puedo filtrar las imágenes enumeradas por este comando?

R: Puede filtrar las imágenes especificando la opción --product con database o grid para mostrar solo las imágenes relacionadas con ese tipo de producto.

P: ¿Qué representa la opción --product en el comando dbaascli cswlib showImages?

R: la opción --product identifica el tipo de producto del directorio raíz de Oracle, lo que permite filtrar la lista de imágenes a la base de datos o a la cuadrícula.

P: ¿Puedo ver tanto imágenes de base de datos como de cuadrícula en una sola ejecución de comando?

R: No, debe ejecutar el comando dos veces con diferentes valores --product (database y grid) para ver ambos tipos de imágenes.

P: ¿Qué sucede si no especifico la opción --product en el comando?

R: Si no se especifica la opción --product, el comando puede mostrar todas las imágenes disponibles o puede solicitarle que especifique el tipo de producto, según la configuración de su entorno.

P: ¿Cuándo debo utilizar el comando dbaascli cswlib showImages?

R: utilice este comando cuando desee ver la lista de imágenes de Database o Grid Infrastructure que están disponibles para su descarga o despliegue en el entorno de Oracle Exadata Database Service.

P: ¿Hay alguna diferencia entre los comandos dbaascli cswlib showImages y dbaascli cswlib listLocal?

R: Sí, dbaascli cswlib showImages muestra todas las imágenes disponibles que puede descargar o gestionar, mientras que dbaascli cswlib listLocal muestra solo las imágenes que ya se han descargado y que están disponibles localmente en el sistema.

P: ¿Se puede usar este comando para ver imágenes almacenadas en la nube?

R: Sí, este comando puede mostrar imágenes que están disponibles para su descarga desde los repositorios de Oracle, no solo las que se almacenan localmente.

P: ¿Qué tipo de imágenes puedo esperar ver con este comando?

R: Puede ver imágenes relacionadas con Oracle Database y Grid Infrastructure, que son componentes esenciales para gestionar y ejecutar bases de datos Oracle en plataformas de Exadata.

Ejemplo 7-8 dbaascli cswlib showImages

dbaascli cswlib showImages

Database Management

En esta sección se tratan las tareas completas para gestionar las bases de datos Oracle. Incluye comandos para crear (dbaascli database create), suprimir (dbaascli database delete) y actualizar bases de datos (dbaascli database upgrade). Otras tareas clave incluyen agregar y suprimir instancias (dbaascli database addInstance, dbaascli database deleteInstance), gestionar copias de seguridad (dbaascli database backup) y gestionar la recuperación de la base de datos (dbaascli database recover). También puede modificar parámetros de base de datos, gestionar bases de datos de conexión, aplicar parches a bases de datos y convertir bases de datos no CDB en PDB. Estos comandos garantizan un control eficaz de todo el ciclo de vida de la base de datos.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database addInstance?

R: El comando dbaascli database addInstance se utiliza para agregar una nueva instancia de base de datos a un nodo especificado en un entorno de Oracle Exadata Database Service.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli database addInstance?

R: El comando se debe ejecutar como usuario root para tener los permisos necesarios para agregar una instancia de base de datos.

P: ¿Qué representa la opción --dbname en este comando?

R: la opción --dbname especifica el nombre de la instancia de Oracle Database para la que desea agregar una nueva instancia.

P: ¿Para qué se utiliza la opción --node en el comando dbaascli database addInstance?

R: La opción --node especifica el nombre del nodo donde se agregará la nueva instancia de base de datos.

P: ¿Cuál es la finalidad de la opción --newNodeSID en este comando?

R: La opción --newNodeSID permite especificar el SID (identificador del sistema) para la nueva instancia de base de datos que se creará en el nodo especificado.

P: ¿Es obligatorio especificar la opción --newNodeSID al agregar una nueva instancia?

R: La opción --newNodeSID es opcional. Si no se proporciona, Oracle generará automáticamente un SID para la nueva instancia de base de datos.

P: ¿Cuándo debo utilizar el comando dbaascli database addInstance?

R: Utilice este comando cuando desee escalar la base de datos agregando una nueva instancia a un nodo adicional en una configuración de Oracle Database de varios nodos.

P: ¿Puedo agregar varias instancias de base de datos a diferentes nodos mediante este comando?

R: Sí, puede ejecutar el comando varias veces para agregar instancias de base de datos a diferentes nodos especificando los valores --node y --dbname adecuados.

P: ¿Qué sucede si el nodo especificado en la opción --node no está disponible?

R: El comando fallará si el nodo especificado no está disponible o no se puede acceder a él. Asegúrese de que el nodo esté correctamente configurado y sea accesible antes de ejecutar el comando.

P: ¿Se puede utilizar este comando en un entorno de Data Guard?

R: Sí, puede utilizar el comando dbaascli database addInstance en un entorno de Data Guard para agregar instancias, pero se recomienda seguir las directrices de Data Guard necesarias para dichas configuraciones.

P: ¿Este comando provocará tiempo de inactividad de la base de datos?

R: Agregar una instancia a un nuevo nodo normalmente no causa tiempo de inactividad para las instancias de base de datos existentes, pero se recomienda comprobar el entorno en busca de dependencias específicas.

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 specifies Oracle Database name         
--list returns database backup information
            [--backupType | --json]
            [--backupType specifies backupType (REGULAR-L0 | REGULAR-L1 | ARCHIVELOG | LONGTERM). ]
            [--json specifies file Name for JSON output. ]        
--start begins database backup.
            [--level0 creates a Level-0 (full) backup. ]
            [--level1 creates a Level-1 (incremental) backup. ]
            [--archival | --archivelog]
            [--archival creates an archival full backup. ]
                --tag specifies backup tag. 
            [--archivelog ]       
--delete deletes Archival backup. 
            --backupTag specifies backup tag to delete.        
--status displays the details about a backup job process. 
            --uuid unique identifier of the backup operation. Input format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
                [--json specifies file Name for JSON output. ]       
--getBackupReport returns BackupReport. 
            --tag | --latest
            --tag specifies backup tag. 
            --latest returns latest backup report (all types of database backup). 
            --json specifies file Name for JSON output.         
--configure configures database for backup. 
            --configFile | --enableRTRT | --disableRTRT | --disableCatalog | --deleteImmutableConfiguration
            --configFile specifies database backup configuration file. 
            --enableRTRT enables Real Time Redo Transport. 
            --disableRTRT disables Real Time Redo Transport. 
            --disableCatalog disables recovery catalog. 
            --deleteImmutableConfiguration         
--getConfig returns database backup configuration. 
            [--configFile | --showOldParams]
            [--configFile specifies database backup configuration file. ]
            [--showOldParams returns old parameter names of backup configuration. ]        
--validate validates that backups are complete and corruption-free. 
            [--untilTime validates from closest Level-0 (full) backup until time provided. Input format: DD-MON-YYYY HH24:MI:SS.]        
--showHistory displays history of backup operations.
            [--all displays all backup operations. ]        
--getSchedules returns all backup schedules for a given database.
Nota

enableRTRT y disableRTRT solo son aplicables para el destino de copia de seguridad ZDLRA en Exadata Database Service on Cloud at Customer.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database backup?

R: El comando dbaascli database backup se utiliza para configurar los destinos de almacenamiento de copia de seguridad de Oracle Database, realizar copias de seguridad, consultar copias de seguridad y suprimir las existentes.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli database backup?

R: El comando se debe ejecutar como usuario root para tener los permisos necesarios para la gestión de copias de seguridad.

P: ¿Cómo puedo iniciar una copia de seguridad completa de Oracle Database con este comando?

R: Para iniciar una copia de seguridad completa (Nivel-0), utilice la siguiente sintaxis:

dbaascli database backup --dbname <value> --start --level0

P: ¿Cómo puedo realizar una copia de seguridad incremental con el comando dbaascli database backup?

R: Para realizar una copia de seguridad incremental de nivel 1, utilice esta sintaxis:

dbaascli database backup --dbname <value> --start --level1

P: ¿Cuál es la diferencia entre las copias de seguridad de nivel 0 y nivel 1?

R: Una copia de seguridad de nivel 0 es una copia de seguridad completa de la base de datos, mientras que una copia de seguridad de nivel 1 es una copia de seguridad incremental que solo captura los cambios realizados desde la última copia de seguridad de nivel 0 o nivel 1.

P: ¿Puedo realizar una copia de seguridad de archivo con este comando?

R: Sí, puede crear una copia de seguridad de archivado mediante la opción --archival junto con el comando --start:

dbaascli database backup --dbname <value> --start --archival --tag <backup_tag>

P: ¿Cómo elimino una copia de seguridad de archivo existente?

R: Para suprimir una copia de seguridad de archivado, utilice la siguiente sintaxis:

dbaascli database backup --dbname <value> --delete --backupTag <tag_value>

P: ¿Cómo puedo comprobar el estado de una copia de seguridad específica con el comando?

R: Puede comprobar el estado de una copia de seguridad mediante la opción --status con el parámetro --uuid, como se muestra a continuación:

dbaascli database backup --dbname <value> --status --uuid <backup_uuid>

P: ¿Cómo puedo mostrar todas las copias de seguridad de una base de datos?

R: Para mostrar todas las copias de seguridad disponibles para una base de datos específica, utilice la opción --list:

dbaascli database backup --dbname <value> --list

Para la salida de JSON, agregue la opción --json:

dbaascli database backup --dbname <value> --list --json <file_name>

P: ¿Cómo puedo recuperar un informe de copia de seguridad?

R: Puede obtener un informe de copia de seguridad mediante la opción --getBackupReport, ya sea para una etiqueta específica o para la última copia de seguridad:

dbaascli database backup --dbname <value> --getBackupReport --tag <backup_tag> --json <file_name>

O para recuperar el último informe:

dbaascli database backup --dbname <value> --getBackupReport --latest --json <file_name>

P: ¿Cómo configuro los valores de copia de seguridad de la base de datos?

R: Utilice la opción --configure para especificar el archivo de configuración de copia de seguridad o para activar/desactivar el transporte de redo en tiempo real (RTRT):

dbaascli database backup --dbname <value> --configure --configFile <config_file>

Para activar RTRT:

dbaascli database backup --dbname <value> --configure --enableRTRT

P: ¿Cómo puedo comprobar la configuración de copia de seguridad actual de mi base de datos?

R: Para ver la configuración de copia de seguridad de la base de datos actual, utilice la opción --getConfig:

dbaascli database backup --dbname <value> --getConfig

P: ¿Qué hace la opción --validate en el comando dbaascli database backup?

R: la opción --validate comprueba si las copias de seguridad están completas y libres de daños. Puede especificar un rango de tiempo mediante la opción --untilTime:

dbaascli database backup --dbname <value> --validate --untilTime "DD-MON-YYYY HH24:MI:SS"

P: ¿Cómo puedo ver el historial de todas las operaciones de copia de seguridad de una base de datos?

R: Utilice la opción --showHistory para mostrar el historial de todas las operaciones de copia de seguridad:

dbaascli database backup --dbname <value> --showHistory

Para un historial completo, incluidas todas las operaciones:

dbaascli database backup --dbname <value> --showHistory --all

P: ¿Qué son las opciones de RTRT (transporte de redo en tiempo real) y cuándo debo utilizarlas?

R: Las opciones de RTRT (--enableRTRT y --disableRTRT) se utilizan para controlar el transporte de redo en tiempo real, aplicable solo a destinos de copia de seguridad de ZDLRA (Zero Data Loss Recovery Appliance) en entornos de Exadata Cloud@Customer. Active RTRT para garantizar el envío de redo logs en tiempo real.

Ejemplo 7-9 Ejemplos

  • Para cambiar el período de retención de archive log, siga estos pasos:
    dbaascli database backup --getConfig --dbname <dbname>

    Esto generará un archivo de configuración de copia de seguridad .cfg.

    Actualice el valor bkup_archlog_fra_retention en este archivo de configuración.

    Ejecute el comando configure:

    dbaascli database backup --configure --dbname <dbname> --configfile <config file generated above>
  • Para obtener la configuración de copia de seguridad de una base de datos myTestDB:
    dbaascli database backup --dbName myTestDB --getConfig --configFile /tmp/configfile_1.txt
  • Para definir la configuración de copia de seguridad de una base de datos myTestDB modificando el archivo de configuración con detalles de configuración:
    dbaascli database backup --dbName myTestDB --configure --configFile /tmp/configfile_1_modified.txt
  • Para realizar una copia de seguridad de la base de datos myTestDB:
    dbaascli database backup --dbName myTestDB --start
  • Para consultar el estado de la solicitud de copia de seguridad enviada con el uuid 58fdcae0bd1c11eb92bc020017075151:
    dbaascli database backup --dbName myTestDB --status --uuid 58fdcae0bd1c11eb92bc020017075151
  • Para activar RTRT para la base de datos myTestDB:
    dbaascli database backup --dbName myTestDB --configure —enableRTRT
dbaascli database bounce

Para cerrar y reiniciar una base de datos de Exadata Database Service en Cloud at Customer 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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database bounce?

R: El comando dbaascli database bounce se utiliza para cerrar y reiniciar una instancia de Oracle Database en Exadata Cloud Infrastructure. Soporta el reinicio de la base de datos de forma sucesiva, lo que garantiza una interrupción mínima.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli database bounce?

R: El comando se debe ejecutar como usuario oracle, que tiene los privilegios necesarios para cerrar y reiniciar la base de datos.

P: ¿Qué especifica la opción --dbname en este comando?

R: la opción --dbname especifica el nombre de la Oracle Database que desea cerrar y reiniciar.

P: ¿Para qué se utiliza la opción --rolling en el comando dbaascli database bounce?

R: La opción --rolling especifica si se debe reiniciar (reiniciar) la base de datos de forma sucesiva. Si se define en true, las instancias de base de datos se reinician una por una, lo que garantiza un tiempo de inactividad mínimo. El valor por defecto es false, que reinicia todas las instancias a la vez.

P: ¿Qué significa "rebotar la base de datos"?

R: El rebote de la base de datos hace referencia al cierre y, a continuación, al reinicio. Esta operación se puede utilizar para el mantenimiento, la aplicación de cambios o la recuperación de determinados tipos de problemas.

P: ¿El comando dbaascli database bounce realiza un cierre controlado?

R: Sí, el comando realiza un cierre en modo "inmediato", que cierra la base de datos y realiza un rollback de las transacciones sin confirmar sin esperar a que los usuarios se desconecten.

P: ¿Abrirá este comando automáticamente todas las PDB en una base de datos Oracle 12c o posterior?

R: Sí, si la base de datos ejecuta Oracle Database 12c o una versión posterior, el comando abrirá automáticamente todas las bases de datos conectables (PDB) después de reiniciar la base de datos.

P: ¿Se puede utilizar el comando dbaascli database bounce en un entorno de varios nodos o RAC (Real Application Clusters)?

R: Sí, en un entorno RAC o de varios nodos, puede utilizar la opción --rolling para reiniciar las instancias de base de datos una por una, lo que minimiza el tiempo de inactividad.

P: ¿Qué sucede si no especifico la opción --rolling?

R: Si no se especifica la opción --rolling o si se define en false, el comando se cerrará y reiniciará todas las instancias de base de datos al mismo tiempo, lo que puede provocar un breve tiempo de inactividad.

P: ¿Existe un valor por defecto para la opción --rolling en el comando dbaascli database bounce?

R: Sí, el valor por defecto de la opción --rolling es false, lo que significa que la base de datos se devolverá de forma no sucesiva a menos que se especifique lo contrario.

P: ¿Cómo reinicio una base de datos en modo de acumulación?

R: Para reiniciar la base de datos en modo dinámico, utilice la siguiente sintaxis:

dbaascli database bounce --dbname <value> --rolling true

P: ¿Es seguro ejecutar el comando dbaascli database bounce durante las sesiones activas?

R: Mientras que el comando utiliza un cierre inmediato, que realiza un rollback de transacciones sin confirmar, siempre se recomienda asegurarse de que no haya sesiones críticas o activas antes de reiniciar la base de datos.

P: ¿Se puede utilizar este comando para PDB específicas en una base de datos multi-inquilino?

R: No, el comando dbaascli database bounce funciona en toda la base de datos. En Oracle 12c o posterior, reiniciará la base de datos de contenedores (CDB) y abrirá todas las PDB, pero no permite el reinicio de PDB individuales.

P: ¿Qué debo hacer si la base de datos no vuelve a estar en línea después de rebotarla?

R: Si la base de datos no se reinicia, compruebe los logs en busca de errores durante el proceso de cierre o inicio. La investigación de los logs de alertas de Oracle puede proporcionar información sobre la causa del problema.

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

Preguntas frecuentes

P: ¿Qué hace el comando dbaascli database changePassword?

R: El comando dbaascli database changePassword se utiliza para cambiar la contraseña de un usuario de Oracle Database especificado. Se le pedirá que introduzca el nombre de usuario y, a continuación, la nueva contraseña.

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli database changePassword?

R: Debe ejecutar el comando como usuario root o oracle para cambiar la contraseña de un usuario de base de datos.

P: ¿Cómo especifico la base de datos al utilizar este comando?

R: utilice la opción --dbname para especificar el nombre de la Oracle Database sobre la que desea actuar. Por ejemplo:

dbaascli database changePassword --dbname <db_name>

P: ¿Cómo especifico el usuario cuya contraseña quiero cambiar?

R: utilice la opción --user para especificar el nombre de usuario cuya contraseña se debe cambiar. Por ejemplo:

dbaascli database changePassword --user <username>

P: ¿Cuál es la finalidad de la opción --prepareStandbyBlob en el comando dbaascli database changePassword?

R: La opción --prepareStandbyBlob se utiliza en entornos de Data Guard para generar un archivo blob que contenga los artefactos necesarios para el cambio de contraseña en la base de datos en espera. Esto garantiza la sincronización de contraseñas en el entorno de Data Guard.

P: ¿Qué especifica la opción --blobLocation?

R: La opción --blobLocation permite especificar una ruta de acceso personalizada en la que se debe generar el archivo blob en espera. Si no se proporciona, el archivo se guardará en la ubicación predeterminada.

P: ¿Cómo puedo utilizar el blob generado desde la base de datos primaria para cambiar la contraseña en la base de datos en espera?

R: Puede utilizar la opción --standbyBlobFromPrimary para especificar el archivo blob preparado desde la base de datos primaria para aplicar el cambio de contraseña a la base de datos en espera. Por ejemplo:

dbaascli database changePassword --standbyBlobFromPrimary <blob_file_path>

P: ¿Para qué se utiliza la opción --resume en este comando?

R: La opción --resume se utiliza para reanudar una operación de cambio de contraseña interrumpida anteriormente. Puede especificar el ID de sesión si es necesario mediante la opción --sessionID.

P: ¿Puedo reanudar una sesión específica con el comando dbaascli database changePassword?

R: Sí, puede utilizar la opción --resume junto con --sessionID para reanudar una sesión de cambio de contraseña específica especificando el ID de sesión.

P: ¿Es aplicable el comando dbaascli database changePassword en un entorno de Data Guard?

R: Sí, lo es. La opción --prepareStandbyBlob se puede utilizar para garantizar que los cambios de contraseña se propaguen a la base de datos en espera en una configuración de Data Guard.

P: ¿Qué sucede si no proporciono un --blobLocation al utilizar --prepareStandbyBlob?

R: Si no se proporciona --blobLocation, el archivo blob que contiene los artefactos de cambio de contraseña se guardará en la ubicación por defecto.

P: ¿Cómo puedo comprobar el estado de una sesión reanudada mediante la base de datos dbaascli changePassword?

R: Puede especificar el ID de sesión mediante la opción --sessionID para reanudar una sesión específica. El sistema retomará donde lo dejó al cambiar la contraseña.

P: ¿Se puede utilizar este comando tanto para bases de datos normales como para las de un entorno de Data Guard?

R: Sí, el comando funciona tanto para bases de datos Oracle normales como para bases de datos en un entorno de Data Guard. En entornos de Data Guard, se pueden utilizar opciones adicionales como --prepareStandbyBlob para gestionar los cambios de contraseña en las bases de datos principal y en espera.

Ejemplo 7-11 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]
            | [--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.
  • 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

Preguntas frecuentes

P: ¿Qué hace el comando dbaascli database convertToPDB?

R: El comando dbaascli database convertToPDB convierte una Oracle Database no CDB especificada en una base de datos conectable (PDB) dentro de una base de datos de contenedores (CDB).

P: ¿Cómo especifico qué base de datos convertir?

R: utilice la opción --dbname para especificar el nombre de la instancia de Oracle Database que no es CDB que desea convertir. Por ejemplo:

dbaascli database convertToPDB --dbname <db_name>

P: ¿Cómo puedo especificar la CDB de destino para la conversión de PDB?

R: utilice la opción --cdbName para especificar el nombre de la base de datos de contenedores (CDB) de destino en la que se creará la nueva PDB. Si la CDB no existe, se creará una nueva en el mismo directorio raíz de Oracle que la no CDB de origen.

P: ¿Qué hace la opción --executePrereqs?

R: La opción --executePrereqs ejecuta comprobaciones previas a la conversión para asegurarse de que la base de datos está lista para la conversión. No se realizarán cambios en la base de datos durante este paso.

P: ¿Cómo puedo copiar los archivos de datos durante la conversión?

R: Puede utilizar la opción --copyDatafiles para crear una nueva copia de los archivos de datos en lugar de utilizar los archivos originales de la base de datos origen.

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

R: La opción --keepSourceDB permite conservar la base de datos no CDB de origen original una vez finalizada la operación de conversión. Si no utiliza esta opción, la base de datos origen se eliminará después de la conversión.

P: ¿Cómo confirmo que una copia de seguridad está preparada antes de la conversión?

R: Utilice el indicador --backupPrepared para confirmar que ha realizado una copia de seguridad adecuada de la base de datos no CDB antes de realizar la conversión. Este paso es crucial para evitar la pérdida de datos.

P: ¿Cómo puedo especificar un nombre personalizado para la nueva PDB?

R: utilice la opción --targetPDBName para proporcionar un nombre específico para la nueva PDB que se creará como parte de la conversión. Por ejemplo:

dbaascli database convertToPDB --dbname <db_name> --targetPDBName <pdb_name>

P: ¿Puedo ejecutar la conversión en segundo plano?

R: Sí, puede utilizar la opción --waitForCompletion para especificar si la operación se debe ejecutar en segundo plano. Utilice false para ejecutarse en segundo plano y true para esperar a que finalice la operación antes de continuar. El valor por defecto es true.

P: ¿Cómo puedo reanudar una conversión interrumpida previamente?

R: Puede utilizar la opción --resume para reanudar un proceso de conversión interrumpido anteriormente. Opcionalmente, puede proporcionar --sessionID para reanudar una sesión específica.

P: ¿Qué sucede si no especifico un nombre de CDB?

R: Si no se proporciona la opción --cdbName, el sistema creará la nueva PDB en el mismo directorio raíz de Oracle que la base de datos no CDB de origen.

P: ¿Puedo continuar la conversión después de una interrupción sin conocer el ID de sesión?

R: Sí, el uso de la opción --resume sin especificar un ID de sesión reanudará la última sesión conocida. Si desea reanudar una sesión específica, puede proporcionar --sessionID.

P: ¿Qué hace la opción --sessionID?

R: La opción --sessionID se utiliza junto con --resume para especificar una sesión concreta para reanudar, en caso de que haya varias sesiones interrumpidas.

P: ¿Es obligatorio tener una copia de seguridad antes de convertir una base de datos no CDB en una PDB?

R: Aunque el indicador --backupPrepared es opcional, se recomienda realizar una copia de seguridad de la base de datos no CDB antes de realizar la conversión a PDB. Esto garantiza que puede restaurar la base de datos en caso de problemas durante la conversión.

Ejemplo 7-12 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 especifica true o false para crear la base de datos como CDB o no CDB
  • --pdbName especifica 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 reanuda o revierte a 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 especifica true o false para bloquear la cuenta de usuario administrador de la PDB. El valor por defecto es true
  • --dbcaTemplateFilePath especifica 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

Preguntas frecuentes

P: ¿Qué hace el comando dbaascli database create?

R: El comando dbaascli database create se utiliza para crear una nueva instancia de Oracle Database. Soporta la creación de Oracle Database versión 12.1.0.2 o posterior con la actualización de versión JAN 2021 o posterior.

P: ¿Cómo se especifica el nombre de Oracle Database que se va a crear?

R: utilice la opción --dbName para especificar el nombre de Oracle Database. Por ejemplo:

dbaascli database create --dbName <db_name>

P: ¿Cómo puedo crear una base de datos de contenedores (CDB)?

R: utilice la opción --createAsCDB y especifique true para crear la base de datos como una CDB. Por ejemplo:

dbaascli database create --dbName <db_name> --createAsCDB true

P: ¿Cómo puedo especificar el directorio raíz de Oracle para la base de datos?

R: Puede utilizar la opción --oracleHome para especificar la ubicación del directorio raíz de Oracle o la opción --oracleHomeName para especificar el nombre del directorio raíz de Oracle.

P: ¿Cómo especifico un nombre de base de datos único o SID?

R: utilice la opción --dbUniqueName para especificar un nombre único para la base de datos y la opción --dbSID para especificar el SID de la base de datos.

P: ¿Cómo puedo crear una base de datos conectable (PDB) junto con una CDB?

R: Puede utilizar la opción --pdbName para especificar el nombre de la PDB y la opción --pdbAdminUserName para definir el nombre de usuario administrador de la PDB. Por ejemplo:

dbaascli database create --dbName <db_name> --createAsCDB true --pdbName <pdb_name> --pdbAdminUserName <admin_user>

P: ¿Cómo puedo especificar el juego de caracteres de la base de datos y el juego de caracteres nacional?

R: Utilice la opción --dbCharset para especificar el juego de caracteres de la base de datos y la opción --dbNCharset para especificar el juego de caracteres nacional. Por ejemplo:

dbaascli database create --dbName <db_name> --dbCharset AL32UTF8 --dbNCharset AL16UTF16

P: ¿Cómo puedo definir la configuración de memoria (SGA y PGA) para la base de datos?

R: Utilice la opción --sgaSizeInMB para especificar el tamaño de SGA y la opción --pgaSizeInMB para especificar el tamaño de PGA, ambos en megabytes.

P: ¿Cómo puedo especificar el destino de los archivos de datos y el área de recuperación rápida (FRA)?

R: Utilice la opción --datafileDestination para especificar el grupo de discos de ASM para los archivos de datos y la opción --fraDestination para especificar el grupo de discos de ASM para el FRA. También puede definir el tamaño de FRA con la opción --fraSizeInMB.

P: ¿Puedo configurar el cifrado de datos transparente (TDE) durante la creación de la base de datos?

R: Sí, puede configurar TDE mediante la opción --tdeConfigMethod. Los valores válidos son FILE (para el cifrado basado en archivos) o KMS (para utilizar Oracle Key Management Service). Si utiliza KMS, proporcione el OCID de clave de KMS con la opción --kmsKeyOCID.

P: ¿Cómo puedo crear la base de datos en una lista específica de nodos?

R: utilice la opción --nodeList para especificar una lista separada por comas de nodos en los que se debe crear la base de datos.

P: ¿Cómo puedo reanudar o revertir un intento anterior de creación de base de datos?

R: utilice la opción --resume para reanudar la ejecución anterior o la opción --revert para realizar un rollback de la ejecución anterior. También puede especificar un --sessionID para reanudar o revertir una sesión específica.

P: ¿Qué hace la opción --executePrereqs?

R: La opción --executePrereqs solo ejecuta los requisitos para la operación de creación de base de datos, sin crear realmente la base de datos. Utilice yes o no para activar o desactivar esta opción.

P: ¿Puedo especificar una plantilla de DBCA personalizada para la creación de la base de datos?

R: Sí, utilice la opción --dbcaTemplateFilePath para proporcionar la ruta de acceso absoluta del archivo de plantilla de DBCA que se debe utilizar para crear la base de datos.

P: ¿Puedo ejecutar la operación de creación de base de datos en segundo plano?

R: Sí, puede utilizar la opción --waitForCompletion para especificar si el comando debe esperar a que finalice la creación de la base de datos (true) o ejecutar la operación en segundo plano (false).

P: ¿Qué sucede si no especifico la opción --dbUniqueName?

R: Si no especifica un nombre único para la base de datos mediante --dbUniqueName, el sistema generará automáticamente uno basado en el --dbName proporcionado.

P: ¿Puedo bloquear la cuenta de administrador de PDB durante la creación de una CDB?

R: Sí, puede utilizar la opción --lockPDBAdminAccount y definirla en true para bloquear la cuenta de administrador de PDB después de crear la base de datos. Por defecto, este valor se define en true.

Ejemplo 7-13 dbaascli database create

dbaascli database create --dbName db19 --oracleHomeName myhome19 --dbSid db19sid --nodeList node1,node2 --createAsCDB true
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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database createTemplate?

R: El comando dbaascli database createTemplate se utiliza para crear plantillas de base de datos (plantillas de DBCA) a partir de una base de datos especificada, que se puede utilizar más adelante para crear nuevas bases de datos.

P: ¿Cómo especifico el nombre de la base de datos para la que quiero crear una plantilla?

R: utilice la opción --dbname para especificar el nombre de la instancia de Oracle Database desde la que se creará la plantilla. Por ejemplo:

dbaascli database createTemplate --dbname <db_name>

P: ¿Cómo especifico dónde se debe guardar la plantilla?

R: Utilice la opción --templateLocation para especificar la ubicación en la que se guardará la plantilla de DBCA. Por ejemplo:

dbaascli database createTemplate --dbname <db_name> --templateLocation /path/to/template

P: ¿Puedo cargar la plantilla directamente en Object Storage?

R: Sí, puede utilizar la opción --uploadToObjectStorage para cargar la plantilla DBCA en Object Storage. Deberá especificar el usuario de conexión y el nombre del cubo de Object Storage con las opciones --objectStorageLoginUser y --objectStorageBucketName, respectivamente.

P: ¿Cómo puedo especificar los detalles de conexión de Object Storage al cargar la plantilla?

R: Utilice las siguientes opciones para especificar los detalles de Object Storage:

--objectStorageLoginUser: especifica el usuario de conexión de Object Storage.

--objectStorageBucketName: especifica el nombre del cubo de Object Storage.

--objectStorageUrl: (opcional) especifica la URL de Object Storage si es diferente de la predeterminada.

Por ejemplo:

dbaascli database createTemplate --dbname <db_name> --uploadToObjectStorage --objectStorageLoginUser <user> --objectStorageBucketName <bucket_name>

P: ¿Cómo puedo especificar un nombre personalizado para la plantilla de DBCA?

R: utilice la opción --templateName para especificar un nombre personalizado para la plantilla de DBCA. Por ejemplo:

dbaascli database createTemplate --dbname <db_name> --templateName <template_name>

P: ¿Para qué se utiliza la opción --rmanParallelism?

R: la opción --rmanParallelism especifica el nivel de paralelismo de las operaciones de RMAN durante el proceso de creación de plantillas. Por ejemplo:

dbaascli database createTemplate --dbname <db_name> --rmanParallelism 4

P: ¿Qué sucede si no especifico las opciones --templateLocation o --uploadToObjectStorage?

R: Si no especifica una ubicación de plantilla con --templateLocation o decide cargarla en Object Storage con --uploadToObjectStorage, el comando no sabrá dónde almacenar la plantilla creada y no se podrá completar.

P: ¿Puedo usar tanto --templateLocation como --uploadToObjectStorage al mismo tiempo?

R: No, debe seleccionar --templateLocation para guardar la plantilla localmente o --uploadToObjectStorage para cargarla en Object Storage, pero no ambos.

P: ¿Es obligatoria la opción --objectStorageUrl al cargar la plantilla en Object Storage?

R: No, la opción --objectStorageUrl es opcional. Si no se especifica, se utilizará la URL por defecto de Object Storage. Solo tiene que especificar esto si utiliza una URL personalizada de Object Storage.

P: ¿Qué privilegios de usuario se necesitan para ejecutar el comando dbaascli database createTemplate?

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

P: ¿Puedo reanudar un proceso de creación de plantillas con fallos anteriores?

R: No, el comando dbaascli database createTemplate no admite la reanudación de un proceso fallido. Deberá reiniciar el comando desde el principio.

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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database delete?

R: El comando dbaascli database delete se utiliza para suprimir una instancia de Oracle Database en Exadata Cloud Infrastructure.

P: ¿Cómo especifico la base de datos que quiero eliminar?

R: utilice la opción --dbname para especificar el nombre de la Oracle Database que desea suprimir. Por ejemplo:

dbaascli database delete --dbname <db_name>

P: ¿Cómo suprimo los archive logs al suprimir una base de datos?

R: Puede suprimir los archive logs definiendo la opción --deleteArchiveLogs en true. Por ejemplo:

dbaascli database delete --dbname <db_name> --deleteArchiveLogs true

P: ¿Puedo suprimir copias de seguridad al suprimir la base de datos?

R: Sí, utilice la opción --deleteBackups y defínala en true para suprimir todas las copias de seguridad asociadas. Por ejemplo:

dbaascli database delete --dbname <db_name> --deleteBackups true

P: ¿Cómo puedo ejecutar solo las comprobaciones previas para la operación de supresión sin suprimir realmente la base de datos?

R: Puede utilizar la opción --precheckOnly y definirla en sí para ejecutar las comprobaciones previas sin suprimir la base de datos. Por ejemplo:

dbaascli database delete --dbname <db_name> --precheckOnly yes

P: ¿Cómo forzo la supresión de una base de datos?

R: Para forzar la supresión de una base de datos, utilice el indicador --force. Esto omite las comprobaciones y fuerza el proceso de supresión. Por ejemplo:

dbaascli database delete --dbname <db_name> --force

P: ¿Cómo puedo ejecutar la operación de supresión en segundo plano?

R: Utilice la opción --waitForCompletion y defínala en false para ejecutar la operación en segundo plano. Por ejemplo:

dbaascli database delete --dbname <db_name> --waitForCompletion false

P: ¿Puedo especificar el SID de la base de datos que quiero eliminar?

R: Sí, puede especificar el SID de la base de datos mediante la opción --dbSID. Por ejemplo:

dbaascli database delete --dbname <db_name> --dbSID <sid>

P: ¿Cómo puedo reanudar una operación de supresión interrumpida anteriormente?

R: Para reanudar una ejecución de supresión anterior, utilice la opción --resume. También puede especificar un ID de sesión mediante la opción --sessionID si es necesario. Por ejemplo:

dbaascli database delete --dbname <db_name> --resume --sessionID <session_id>

P: ¿Qué privilegios de usuario se necesitan para ejecutar el comando dbaascli database delete?

R: El comando se debe ejecutar como usuario root.

P: ¿Qué hace la opción --precheckOnly en el comando dbaascli database delete?

R: La opción --precheckOnly permite ejecutar solo las comprobaciones previas de la operación de supresión sin suprimir realmente la base de datos. Garantiza que todas las comprobaciones se aprueben antes de continuar con la supresión real.

P: ¿Puedo suprimir una base de datos sin esperar a que se complete la operación?

R: Sí, al definir la opción --waitForCompletion en false, la operación de supresión se ejecutará en segundo plano y no tendrá que esperar a que se complete.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database deleteInstance?

R: El comando dbaascli database deleteInstance se utiliza para suprimir una instancia de Oracle Database específica en un nodo especificado en un entorno de Exadata Cloud Infrastructure.

P: ¿Cómo puedo especificar qué instancia de Oracle Database suprimir?

R: Puede especificar la instancia de Oracle Database que desea suprimir mediante la opción --dbname para proporcionar el nombre de la base de datos y la opción --node para proporcionar el nombre del nodo. Por ejemplo:

dbaascli database deleteInstance --dbname <db_name> --node <node_name>

P: ¿Puedo suprimir la instancia aunque no se pueda acceder al nodo?

R: Sí, puede utilizar la opción --continueOnUnreachableNode para continuar con la supresión, incluso si no se puede acceder al nodo especificado. Por ejemplo:

dbaascli database deleteInstance --dbname <db_name> --node <node_name> --continueOnUnreachableNode

P: ¿Qué sucede si no se puede acceder al nodo especificado durante la operación de supresión de instancia?

R: Si no se puede acceder al nodo y no se utiliza la opción --continueOnUnreachableNode, la operación fallará. Si se utiliza la opción, la operación continuará aunque no se pueda acceder al nodo.

P: ¿Cómo suprimo una instancia de base de datos de un nodo específico?

R: Utilice el siguiente comando para suprimir una instancia de base de datos de un nodo específico:

dbaascli database deleteInstance --dbname <db_name> --node <node_name>

P: ¿Qué privilegios de usuario se necesitan para ejecutar el comando dbaascli database deleteInstance?

R: El comando se debe ejecutar como usuario root.

P: ¿Puedo suprimir una instancia sin especificar el nodo?

R: No, se necesita la opción --node para especificar de qué nodo se debe suprimir la instancia de base de datos.

P: ¿Qué hace la opción --continueOnUnreachableNode?

R: La opción --continueOnUnreachableNode permite que la operación continúe incluso si no se puede acceder al nodo especificado, lo que garantiza que la supresión de la instancia continúe en casos en los que el nodo podría estar caído.

P: ¿Es posible suprimir varias instancias de base de datos a la vez con este comando?

R: No, el comando dbaascli database deleteInstance se utiliza para suprimir una única instancia de base de datos en un nodo especificado a la vez. Debería ejecutar el comando por separado para cada instancia que desee suprimir.

Ejemplo 7-15 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...

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database duplicado?

R: El comando dbaascli database duplicate se utiliza para crear una nueva Oracle Database mediante la duplicación de una base de datos activa existente.

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli database duplicado?

R: Debe ejecutar el comando como usuario root.

P: ¿Cómo especifico la base de datos de origen para la duplicación?

R: utilice la opción --sourceDBConnectionString para proporcionar la cadena de conexión de la base de datos origen con el formato <scan_name>:<scan_port>/<database_service_name>. Por ejemplo:

--sourceDBConnectionString <scan_name>:<scan_port>/<database_service_name>

P: ¿Cómo puedo especificar la ubicación del directorio raíz de Oracle para la nueva base de datos?

R: Puede especificar la ubicación del directorio raíz de Oracle mediante la opción --oracleHome o el nombre del directorio raíz de Oracle mediante la opción --oracleHomeName. Por ejemplo:

--oracleHome <value>

o

--oracleHomeName <value>

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

R: La opción --sourceDBWalletLocation especifica la ubicación del archivo de cartera de TDE de la base de datos de origen, que es necesario para duplicar la base de datos a partir de una base de datos de origen activa.

P: ¿Puedo omitir la duplicación de PDB específicas de la base de datos de origen?

R: Sí, puede utilizar la opción --skipPDBs para especificar una lista delimitada por comas de nombres de PDB que se deben excluir de la operación duplicada. Por ejemplo:

--skipPDBs pdb1,pdb2

P: ¿Cómo configuro TDE para la nueva base de datos?

R: utilice la opción --tdeConfigMethod para especificar el método de configuración de TDE (FILE o KMS). Si selecciona KMS, puede proporcionar el OCID de clave KMS mediante la opción --kmsKeyOCID. Por ejemplo:

--tdeConfigMethod FILE

o

--tdeConfigMethod KMS --kmsKeyOCID <value>

P: ¿Qué hace la opción --executePrereqs?

R: la opción --executePrereqs especifica si se deben ejecutar solo las comprobaciones de requisitos para la operación. Los valores válidos son yes solo para ejecutar las solicitudes previas o no para continuar con la operación completa.

P: ¿Cómo puedo reanudar una operación duplicada previamente interrumpida?

R: Utilice la opción --resume junto con la opción --sessionID para reanudar una operación de duplicado interrumpida anteriormente. Por ejemplo:

--resume --sessionID <value>

P: ¿Qué hace la opción --waitForCompletion?

R: la opción --waitForCompletion especifica si se debe esperar a que finalice la operación. Si se define en true, se espera la finalización, mientras que false ejecuta la operación en segundo plano. Por ejemplo:

--waitForCompletion true

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

R: La opción --rmanParallelism especifica el valor de paralelismo para RMAN (Recovery Manager) durante el proceso de duplicación. Esto puede mejorar la velocidad de la operación de duplicación mediante el uso de varios procesos paralelos.

P: ¿Cómo puedo especificar el tamaño de SGA y PGA para la nueva base de datos?

R: Utilice las opciones --sgaSizeInMB y --pgaSizeInMB para especificar los tamaños de SGA (Área Global del Sistema) y PGA (Área Global del Programa) en megabytes, respectivamente. Por ejemplo:

--sgaSizeInMB <value>

--pgaSizeInMB <value>

P: ¿Qué hace la opción --revert?

R: La opción --revert se utiliza para realizar un rollback de una operación duplicada anterior. Debe proporcionar --sessionID para especificar la sesión que desea revertir.

Ejemplo 7-16 dbaascli database duplicate

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database getDetails?

R: El comando dbaascli database getDetails muestra información detallada sobre una base de datos Oracle especificada, incluido el nombre de la base de datos, la información del nodo y los detalles de la base de datos conectable (PDB).

P: ¿Quién puede ejecutar el comando dbaascli database getDetails?

R: El comando lo puede ejecutar el usuario root o el usuario oracle.

P: ¿Qué especifica la opción --dbname en el comando dbaascli database getDetails?

R: la opción --dbname especifica el nombre de la base de datos Oracle para la que se está recuperando información detallada.

P: ¿Qué tipo de información proporciona el comando dbaascli database getDetails?

R: El comando proporciona detalles como el nombre de la base de datos, la información del nodo y la información sobre las bases de datos conectables (PDB) asociadas a la base de datos de contenedores.

dbaascli database 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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database getPDBs?

R: El comando dbaascli database getPDBs se utiliza para mostrar todas las bases de datos de conexión (PDB) dentro de una base de datos de contenedor (CDB) especificada.

P: ¿Cómo puedo especificar la base de datos de contenedores para el comando getPDBs?

R: Utilice la opción --dbname para especificar el nombre de la base de datos de contenedores. Por ejemplo:

--dbname <value>

P: ¿Necesito ejecutar el comando dbaascli database getPDBs como usuario específico?

R: Sí, debe ejecutar el comando como el usuario root o el usuario oracle.

P: ¿Puedo ver las PDB en una base de datos que no sea CDB mediante el comando getPDBs?

R: No, el comando getPDBs solo se aplica a bases de datos de contenedor (CDB). No puede utilizar este comando para bases de datos que no sean CDB.

P: ¿Cuál es el formato de la salida del comando dbaascli database getPDBs?

R: El comando devuelve una lista de todas las PDB de la base de datos de contenedores especificada. La salida suele incluir nombres de PDB, estados y otros detalles relevantes sobre cada base de datos de conexión.

P: ¿Se puede utilizar este comando para varias bases de datos a la vez?

R: No, el comando dbaascli database getPDBs funciona con una única base de datos de contenedores a la vez, especificada por la opción --dbname.

P: ¿Es necesario cerrar la base de datos para utilizar el comando getPDBs?

R: No, el comando getPDBs no necesita que la base de datos se cierre. Se puede ejecutar mientras la base de datos de contenedores está operativa.

Ejemplo 7-17 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>[--instance <value>] [--backupPrepared] [--allowBounce]|
--resetParameters <values> [--instance <value>] [--backupPrepared] [--allowBounce]
}
--responseFile
[--backupPrepared]
[--instance]
[--allowBounce]
[--waitForCompletion]
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.
  • --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.
  • --backupPrepared confirma que hay una copia de seguridad de base de datos adecuada antes de modificar los parámetros críticos o confidenciales.
  • --allowBounce otorga permiso para reiniciar la base de datos a fin de reflejar los cambios en los parámetros estáticos aplicables.
  • --waitForCompletion especifique false para ejecutar la operación en segundo plano. Valores válidos : true|false.]

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database modifyParameters?

R: El comando dbaascli database modifyParameters se utiliza para modificar o restablecer los parámetros de inicialización de Oracle Database.

P: ¿Cómo especifico la base de datos para la que quiero modificar los parámetros?

R: Debe utilizar la opción --dbname para especificar el nombre de la base de datos para la que desea modificar o restablecer los parámetros.

P: ¿Cómo puedo modificar los parámetros de la base de datos mediante el comando modifyParameters?

R: utilice la opción --setParameters seguida de una lista delimitada por comas de parámetros y sus nuevos valores. Por ejemplo:

--setParameters parameter1=valueA,parameter2=valueB

P: ¿Cómo restablezco los parámetros a sus valores predeterminados con este comando?

R: Utilice la opción --resetParameters seguida de una lista delimitada por comas de parámetros para restablecer sus valores por defecto. Por ejemplo:

--resetParameters parameter1,parameter2

P: ¿Puedo modificar parámetros mediante un archivo de respuesta?

R: Sí, puede especificar la ubicación absoluta de un archivo JSON de respuesta mediante la opción --responseFile. El archivo debe contener los parámetros que desea modificar.

P: ¿Es necesario realizar una copia de seguridad antes de modificar los parámetros?

R: Aunque no es obligatorio para todos los cambios, si está modificando parámetros críticos o confidenciales, se recomienda tener una copia de seguridad en su lugar. Puede utilizar la opción --backupPrepared para confirmar que se ha preparado una copia de seguridad.

P: ¿Puedo aplicar cambios solo a una instancia específica en una base de datos de varias instancias?

R: Sí, puede especificar el nombre de la instancia mediante la opción --instance. Si no se utiliza esta opción, los cambios se aplicarán a nivel de base de datos.

P: ¿Es necesario reiniciar la base de datos (reiniciarla) después de modificar los parámetros?

R: Para algunos parámetros estáticos, es necesario un reinicio de la base de datos. Puede utilizar la opción --allowBounce para otorgar permiso para que la base de datos se reinicie si es necesario.

P: ¿Qué sucede si no permito que la base de datos se reinicie al cambiar los parámetros estáticos?

R: Si no utiliza la opción --allowBounce al modificar parámetros estáticos, los cambios no se aplicarán hasta el siguiente reinicio manual de la base de datos.

P: ¿Puedo reanudar la modificación de parámetros si se interrumpió una sesión anterior?

R: No, este comando no admite la reanudación de la sesión. Deberá volver a ejecutar el comando desde el principio.

Ejemplo 7-18 dbaascli database modifyParameters

dbaascli database modifyParameters --dbname dbname --setParameters "log_archive_dest_state_17=ENABLE"
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>

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database recover?

R: El comando dbaascli database recover se utiliza para recuperar una instancia de Oracle Database a partir de copias de seguridad almacenadas en un destino de almacenamiento de copia de seguridad.

P: ¿Cómo especifico qué base de datos recuperar?

R: Puede especificar la base de datos que desea recuperar mediante la opción --dbname seguida del nombre de la base de datos. Por ejemplo:

--dbname <database_name>

P: ¿Cuáles son las opciones de recuperación disponibles con el comando dbaascli database recover?

R: Las opciones de recuperación son:

--untilTime: recupere la base de datos a una hora específica.

--untilSCN: recupere la base de datos a un número de cambio del sistema (SCN) específico.

--latest: recupere la base de datos al último estado conocido.

--tag: recupere la base de datos mediante una etiqueta de archivo.

P: ¿Cómo recupero la base de datos a una hora específica?

R: utilice la opción --untilTime seguida de la hora con el formato DD-MON-YYYY HH24:MI:SS. Por ejemplo:

--untilTime 05-SEP-2024 15:30:00

P: ¿Cómo puedo recuperar la base de datos a un SCN específico?

R: Utilice la opción --untilSCN seguida del valor SCN. Por ejemplo:

--untilSCN 123456789

P: ¿Cómo puedo recuperar la base de datos al último estado conocido?

R: Utilice la opción --latest para recuperar la base de datos al estado más reciente posible. Por ejemplo:

--latest

P: ¿Cuál es el uso de la opción --tag en el proceso de recuperación?

R: La opción --tag permite recuperar la base de datos mediante una etiqueta de archivado asociada a las copias de seguridad. Por ejemplo:

--tag <backup_tag>

P: ¿Cómo puedo comprobar el estado de una operación de recuperación?

R: Utilice la opción --status junto con el valor --uuid para comprobar el estado de una operación de recuperación en curso o anterior. Por ejemplo:

--status --uuid <recovery_uuid>

P: ¿Qué hace la opción --start en el proceso de recuperación?

R: la opción --start inicia la operación de recuperación según el método de recuperación seleccionado (--untilTime, --untilSCN, --latest o --tag).

P: ¿Existe alguna forma de recuperar la base de datos sin especificar una hora o un SCN?

R: Sí, puede recuperar la base de datos a su último estado conocido mediante la opción --latest, que no necesita especificar una hora ni un SCN.

P: ¿Puedo realizar una recuperación parcial?

R: Sí, puede recuperar la base de datos a un punto en el tiempo o SCN específico mediante las opciones --untilTime o --untilSCN, respectivamente.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database runDatapatch?

R: El comando dbaascli database runDatapatch se utiliza para aplicar parches a una instancia de Oracle Database.

P: ¿Qué se debe garantizar antes de ejecutar el comando dbaascli database runDatapatch?

R: Antes de ejecutar el comando, asegúrese de que todas las instancias de la base de datos están activas y en ejecución.

P: ¿Cómo puedo especificar a qué base de datos aplicar parches?

R: utilice la opción --dbname seguida del nombre de la base de datos. Por ejemplo:

--dbname myDatabase

P: ¿Cómo puedo reanudar una operación runDatapatch interrumpida anteriormente?

R: utilice la opción --resume para reanudar la ejecución anterior o la opción --sessionID para especificar un ID de sesión específico. Por ejemplo:

--resume

--sessionID 12345

P: ¿Cómo puedo omitir determinadas PDB al ejecutar el parche?

R: Utilice la opción --skipPdbs seguida de una lista delimitada por comas de nombres de PDB para omitir. Por ejemplo:

--skipPdbs pdb1,pdb2

P: ¿Cómo puedo ejecutar el parche solo en determinadas PDB?

R: utilice la opción --pdbs seguida de una lista delimitada por comas de nombres de PDB para incluir. Por ejemplo:

--pdbs pdb1,pdb2

P: ¿Cómo puedo aplicar o realizar un rollback de un juego específico de parches?

R: utilice la opción --patchList seguida de una lista delimitada por comas de nombres de parches para aplicar o realizar un rollback. Por ejemplo:

--patchList patch1,patch2

P: ¿Qué hace la opción --rollback?

R: la opción --rollback realiza un rollback de los parches aplicados durante la operación de aplicación de parches.

P: ¿Qué sucede si se cierran algunas PDB durante la operación de aplicación de parches?

R: Si algunas PDB están cerradas, puede utilizar la opción --skipClosedPdbs para omitir la aplicación de parches a esas PDB cerradas.

P: ¿Puedo ejecutar comprobaciones de requisitos antes de aplicar parches?

R: Sí, utilice la opción --executePrereqs para ejecutar comprobaciones de requisitos antes de aplicar el parche.

P: ¿Cómo puedo averiguar qué ID de sesión reanudar un parche?

R: Después de una operación runDatapatch, el ID de sesión se registra normalmente. Utilice la opción --sessionID para especificar ese ID al reanudar un parche. Por ejemplo:

--sessionID 67890

dbaascli database runDatapatch --dbname db19
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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database start?

R: El comando dbaascli database start se utiliza para iniciar una instancia de Oracle Database.

P: ¿Qué se debe hacer antes de ejecutar el comando dbaascli database start?

R: El comando se debe ejecutar como usuario root.

P: ¿Cómo especifico la base de datos que quiero iniciar?

R: utilice la opción --dbname seguida del nombre de la base de datos. Por ejemplo:

--dbname myDatabase

P: ¿Cuáles son los modos posibles en los que puedo iniciar la base de datos?

R: Puede iniciar la base de datos en modo mount o nomount mediante la opción --mode. Por ejemplo:

--mode mount

P: ¿Cuál es el modo predeterminado si no especifico uno?

R: Si no especifica un modo, la base de datos se iniciará en el modo open por defecto.

P: ¿Abrirá este comando todas las PDB en Oracle Database 12c o posterior?

R: Sí, al iniciar la base de datos en Oracle Database 12c o posterior, también se abrirán todas las bases de datos conectables (PDB).

P: ¿Cómo puedo iniciar una base de datos en modo nomount?

R: Utilice la opción --mode y defínala en nomount. Por ejemplo:

--mode nomount

P: ¿Cómo puedo iniciar una base de datos en modo de montaje?

R: Utilice la opción --mode y configúrela para que se monte. Por ejemplo:

--mode mount

P: ¿Es obligatorio especificar un nombre de base de datos al ejecutar el comando dbaascli database start?

R: Sí, se recomienda especificar el nombre de la base de datos mediante la opción --dbname para garantizar que se inicia la base de datos correcta.

Ejemplo 7-20 dbaascli database start

dbaascli database start --dbname dbname --mode mount
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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database stop?

R: El comando dbaascli database stop se utiliza para parar una instancia de Oracle Database.

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli database stop?

R: Debe ejecutar el comando como usuario root y debe conectarse a una máquina virtual de Exadata Cloud@Customer mediante SSH.

P: ¿Cómo especifico qué base de datos parar?

R: Puede especificar la base de datos mediante la opción --dbname seguida del nombre de la base de datos. Por ejemplo:

--dbname myDatabase

P: ¿Cuáles son los modos de cierre válidos para el comando dbaascli database stop?

R: Los modos de cierre válidos son:

abort

immediate

normal

transactional

P: ¿Cuál es el modo de cierre predeterminado si no se especifica ningún modo?

R: Si no se especifica ningún modo, la base de datos se cerrará en modo immediate por defecto.

P: ¿Qué sucede en el modo de cierre inmediato?

R: En el modo immediate, no se permiten nuevas conexiones ni transacciones, se realiza un rollback de las transacciones activas y se desconectan todos los usuarios conectados.

P: ¿Cómo puedo parar la base de datos en modo de anulación?

R: Para parar la base de datos en modo de anulación, utilice la opción --mode con la anulación. Por ejemplo:

--mode abort

P: ¿Qué hace el modo normal al parar la base de datos?

R: En modo normal, la base de datos permite que las sesiones de usuario actuales se completen y, a continuación, se detengan sin afectar a las transacciones activas.

P: ¿Para qué se utiliza el modo transaccional en el comando dbaascli database stop?

R: En el modo transactional, la base de datos se para solo después de que se hayan completado todas las transacciones activas, pero no se permiten nuevas transacciones.

P: ¿Es obligatorio especificar el modo de cierre en el comando dbaascli database stop?

R: No, especificar un modo shutdown es opcional. Si no se proporciona, se usará el modo inmediato predeterminado.

Ejemplo 7-21 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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli database upgrade?

R: El comando dbaascli database upgrade se utiliza para cambiar la versión de una instancia de Oracle Database a una nueva versión.

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli database upgrade?

R: Debe ejecutar el comando como usuario root y conectarse a una máquina virtual de Exadata Cloud@Customer mediante SSH.

P: ¿Cómo especifico la base de datos que se debe actualizar?

R: utilice la opción --dbname seguida del nombre de la base de datos. Por ejemplo:

--dbname myDatabase

P: ¿Cómo puedo especificar el directorio raíz de Oracle de destino para la actualización?

R: Puede especificar la ubicación del directorio raíz de Oracle de destino con la opción --targetHome o el nombre del directorio raíz de Oracle Database de destino con la opción --targetHomeName.

P: ¿Qué hace la opción --standBy?

R: La opción --standBy se utiliza para actualizar las bases de datos en espera en las configuraciones de Data Guard.

P: ¿Cuál es la finalidad del indicador --allStandbyPrepared?

R: el indicador --allStandbyPrepared reconoce que se han realizado todas las operaciones necesarias en las bases de datos en espera antes de actualizar la base de datos primaria en una configuración de Data Guard.

P: ¿Qué hace la opción --removeGRP?

R: La opción --removeGRP elimina automáticamente la copia de seguridad de punto de restauración garantizado (GRP) si el cambio de versión de la base de datos es correcto.

P: ¿Cuándo debo utilizar la opción --increaseCompatibleParameter?

R: utilice la opción --increaseCompatibleParameter para aumentar automáticamente el parámetro compatible durante la actualización de la base de datos, siempre que la actualización se realice correctamente.

P: ¿Qué hace la opción --executePrereqs?

R: la opción --executePrereqs solo ejecuta las comprobaciones previas al cambio de versión para garantizar que la base de datos esté lista para el cambio de versión.

P: ¿Cómo puedo manejar un paso posterior a la actualización fallido?

R: Utilice la opción --postUpgrade para volver a ejecutar los pasos posteriores a la actualización si falla el intento inicial posterior a la actualización.

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

R: la opción --revert revierte la instancia de Oracle Database a su directorio raíz de Oracle original, deshaciendo el cambio de versión.

P: ¿Cómo puedo transferir argumentos adicionales específicos de DBUA para la actualización?

R: Utilice la opción --upgradeOptions para transferir argumentos específicos de DBUA para el cambio de versión de Oracle Database. Consulte la documentación de Oracle para obtener información sobre las opciones y los argumentos soportados.

P: ¿Es obligatorio especificar el directorio raíz de Oracle de destino para la actualización?

R: Sí, debe especificar --targetHome o --targetHomeName para indicar el directorio raíz de Oracle de destino para el cambio de versión.

P: ¿Qué debo hacer si necesito realizar una comprobación previa a la actualización pero no continuar con la actualización?

R: Utilice la opción --executePrereqs para realizar solo las comprobaciones previas al cambio de versión sin continuar con el cambio de versión real.

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

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

Data Guard Management

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

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.

Preguntas frecuentes

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

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

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

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

P: ¿Cómo puedo especificar el nombre de la instancia de Oracle Database para la que deseo preparar el blob en espera?

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

--dbname myDatabase

P: ¿Cómo especifico la ubicación donde se generará el archivo blob en espera?

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

--blobLocation /path/to/standby_blob

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

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

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

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

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

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

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

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

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

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

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

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

dbaascli dataguard updateDGConfigAttributes

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

Ejecute el comando como usuario root u oracle.

Sintaxis

dbaascli dataguard updateDGConfigAttributes --attributes <value>
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.

Preguntas frecuentes

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

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

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

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

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

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

--attributes attribute1=value1,attribute2=value2

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

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

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

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

--attributes attribute1=value1,attribute2=value2

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

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

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

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

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

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

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

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

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

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

Failover de Data Guard de dbaascli

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

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

Sintaxis

dbaascli dataguard failover --dbname <value> [--useImmediateFailover] [--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]]
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.
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 del comando del 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 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.

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

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

  • En el nuevo cluster primario:

    ORA-16661: Se debe volver a instanciar la base de datos de espera

  • En el cluster primario anterior:

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

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

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

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

  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 el 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 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.
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 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.
  • --skipDRConfiguration especifica si se debe omitir la configuración de Disaster Recovery (DR) como parte de la configuración de la base de datos en espera. Valores válidos: true (omitir configuración de DR) o false (configurar DR).
Realización de la Operación PrepareForStandby con la Utilidad dbaascli

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

  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 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.
  • --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.
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 que se ejecute la operación en segundo plano. Valores válidos: true|false.
Realización de la Operación registerStandby con la Utilidad dbaascli

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

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

Sin embargo, en las configuraciones con varias bases de datos en espera, debe ejecutar el comando registerStandby tanto en el cluster primario como en todos los clusters en espera existentes, 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 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.
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.
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. Definido en false para ejecutar la operación en segundo plano. Valores válidos: true|false.
Realización de la Operación updateConfiguration con la Utilidad dbaascli

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

  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.

Gestión del directorio raíz de base de datos

En esta sección se proporcionan herramientas para gestionar directorios raíz de Oracle Database. Incluye comandos como dbaascli dbhome create para crear un nuevo directorio raíz de Oracle Database y dbaascli dbHome delete para eliminar uno existente. También puede ver información detallada sobre un directorio raíz de Oracle específico con dbaascli dbHome getDetails y comprobar qué bases de datos se están ejecutando desde un directorio raíz de Oracle determinado mediante dbaascli dbhome getDatabases. Estos comandos garantizan una gestión eficaz de los entornos de base de datos.

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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli dbhome create?

R: El comando dbaascli dbhome create se utiliza para crear un nuevo directorio raíz de Oracle Database con la versión deseada.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli dbhome create?

R: El comando se debe ejecutar como usuario root.

P: ¿Cómo puedo especificar la versión de Oracle Database al crear un nuevo directorio raíz de Oracle?

R: utilice la opción --version seguida de la versión de Oracle Database con el formato de cinco segmentos numéricos separados por puntos, como 19.11.0.0.0.

P: ¿Qué especifica la opción --oracleHome?

R: la opción --oracleHome especifica la ubicación en la que desea instalar el directorio raíz de Oracle. Si no se indica, se usará la ubicación por defecto.

P: ¿Puedo asignar un nombre personalizado al nuevo directorio raíz de Oracle?

R: Sí, puede utilizar la opción --oracleHomeName para especificar un nombre definido por el usuario para el directorio raíz de Oracle. Si no se especifica, se utilizará un nombre por defecto.

P: ¿Cómo puedo activar o desactivar la auditoría unificada en el nuevo directorio raíz de Oracle?

R: utilice la opción --enableUnifiedAuditing y especifique true para activar o false para desactivar la auditoría unificada para el directorio raíz de Oracle.

P: ¿Qué hace la opción --imageTag?

R: la opción --imageTag especifica la etiqueta de imagen del directorio raíz de Oracle, que se puede utilizar en casos en los que la etiqueta de imagen difiere de la versión.

P: ¿Cuál es un ejemplo del uso del comando dbaascli dbhome create con la etiqueta version e image?

R: Un ejemplo del comando con versión y etiqueta de imagen es:

dbaascli dbhome create --version 19.8.0.0.0 --imageTag 19.8.0.0.0

Esto crea un directorio raíz de Oracle para la versión 19.8.0.0.0 con la etiqueta de imagen correspondiente.

P: ¿Qué sucede si no proporciono las opciones --oracleHome o --oracleHomeName?

R: Si no se proporciona --oracleHome, el directorio raíz de Oracle se instalará en la ubicación por defecto. Si no se especifica --oracleHomeName, se asignará un nombre por defecto al directorio raíz de Oracle.

P: ¿Cómo puedo verificar si la creación del directorio raíz de Oracle se ha realizado correctamente?

R: Después de ejecutar el comando, compruebe los logs de salida para ver si hay mensajes o errores correctos. También puede verificar el directorio raíz de Oracle navegando a la ubicación especificada o utilizando herramientas de Oracle como orainstRoot.sh.

P: ¿Es posible crear varios directorios raíz de Oracle con diferentes versiones en el mismo sistema?

R: Sí, puede crear varios directorios raíz de Oracle con diferentes versiones especificando diferentes valores para las opciones --version y --oracleHomeName.

P: ¿Qué debo hacer si falla la creación del directorio raíz de Oracle?

R: Consulte los logs de salida para obtener mensajes de error detallados. Verifique que tiene el formato de versión correcto, los permisos necesarios y suficiente espacio en disco. Corrija los problemas e intente ejecutar el comando de nuevo.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli dbHome delete?

R: El comando dbaascli dbHome delete se utiliza para suprimir un directorio raíz de Oracle Database especificado del sistema.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli dbHome delete?

R: El comando se debe ejecutar como usuario root.

P: ¿Cómo se especifica el directorio raíz de Oracle que se va a suprimir?

R: Puede especificar el directorio raíz de Oracle que desea suprimir mediante una de las siguientes opciones:

--oracleHome <value> para proporcionar la ruta de acceso absoluta de la ubicación del directorio raíz de Oracle.

--oracleHomeName <value> para proporcionar el nombre del directorio raíz de Oracle.

P: ¿Cuál es la diferencia entre las opciones --oracleHome y --oracleHomeName?

A:

--oracleHome especifica la ubicación física o la ruta del directorio raíz de Oracle que se va a suprimir.

--oracleHomeName especifica el nombre definido por el usuario del directorio raíz de Oracle que se va a suprimir.

P: ¿Cómo puedo reanudar un proceso de eliminación previamente interrumpido?

R: Puede utilizar la opción --resume para reanudar un proceso de supresión anterior. Si conoce el ID de sesión específico del proceso, puede incluirlo con la opción --sessionID.

P: ¿Para qué se utiliza la opción --sessionID en el comando dbaascli dbHome delete?

R: La opción --sessionID se utiliza para reanudar una sesión específica que se interrumpió o falló anteriormente durante el proceso de supresión.

P: ¿Qué sucede si no proporciono las opciones --resume o --sessionID?

R: Si no se proporcionan las opciones --resume o --sessionID, el comando iniciará un nuevo proceso de supresión en lugar de reanudar uno interrumpido.

P: ¿Hay alguna forma de confirmar la supresión del directorio raíz de Oracle después de ejecutar el comando?

R: Para verificar la supresión, compruebe los logs de salida para ver si hay mensajes correctos y asegúrese de que el directorio raíz de Oracle ya no está presente en la ubicación especificada.

P: ¿Puedo suprimir un directorio raíz de Oracle que está utilizando actualmente una base de datos en ejecución?

R: No, el directorio raíz de Oracle no debe estar en uso por ninguna base de datos o servicio en ejecución durante el proceso de supresión. Asegúrese de parar cualquier base de datos relacionada antes de ejecutar el comando delete.

P: ¿Qué debo hacer si falla el comando dbaascli dbHome delete?

R: Revise los logs de salida para ver los mensajes de error. Asegúrese de que el directorio raíz de Oracle no está en uso, verifique la ubicación o el nombre correctos del directorio raíz de Oracle y confirme que tiene los permisos necesarios. Después de resolver cualquier problema, vuelva a ejecutar el comando o utilice la opción --resume si es necesario.

P: ¿Puedo suprimir varios directorios raíz de Oracle a la vez mediante el comando dbaascli dbHome delete?

R: No, el comando solo permite suprimir un directorio raíz de Oracle a la vez especificando la opción --oracleHome o --oracleHomeName.

P: ¿Cuál es un ejemplo de supresión de un directorio raíz de Oracle por su nombre?

R: A continuación se muestra un ejemplo de supresión de un directorio raíz de Oracle por nombre:

dbaascli dbHome delete --oracleHomeName myOracleHome

Este comando suprime el directorio raíz de Oracle con el nombre myOracleHome.

P: ¿Cuál es un ejemplo de supresión de un directorio raíz de Oracle por su ubicación?

R: A continuación se muestra un ejemplo de supresión de un directorio raíz de Oracle especificando su ubicación:

dbaascli dbHome delete --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

Este comando suprime el directorio raíz de Oracle ubicado en /u01/app/oracle/product/19.0.0/dbhome_1.

P: ¿Puedo cancelar el proceso de eliminación una vez que ha comenzado?

R: No, una vez que se ha iniciado el proceso de eliminación, no se puede cancelar. Asegúrese de que el directorio raíz de Oracle está listo para la supresión antes de ejecutar el comando.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli dbHome getDatabases?

R: El comando dbaascli dbHome getDatabases se utiliza para ver la información sobre todas las bases de datos de Oracle que se ejecutan desde un directorio raíz de Oracle Database especificado.

P: ¿Cómo puedo especificar el directorio raíz de Oracle Database que debo comprobar?

R: Puede especificar el directorio raíz de Oracle Database mediante una de las siguientes opciones:

--oracleHomeName <value> para especificar el nombre definido por el usuario del directorio raíz de Oracle.

--oracleHome <value> para especificar la ubicación completa (ruta) del directorio raíz de Oracle.

P: ¿Cuál es la diferencia entre las opciones --oracleHomeName y --oracleHome?

A:

--oracleHomeName hace referencia a un nombre definido por el usuario para el directorio raíz de Oracle.

--oracleHome hace referencia a la ubicación física (o ruta de acceso de directorio) del directorio raíz de Oracle en el sistema.

P: ¿Cómo puedo ejecutar el comando dbaascli dbHome getDatabases?

R: Para ejecutar el comando, utilice la siguiente sintaxis:

dbaascli dbHome getDatabases --oracleHomeName <value>

o

dbaascli dbHome getDatabases --oracleHome <value>

Asegúrese de ejecutar el comando con el usuario root.

P: ¿Puedo especificar el nombre y la ubicación del directorio raíz de Oracle en el mismo comando?

R: No, solo puede especificar --oracleHomeName o --oracleHome en una única ejecución de comando. Seleccione una opción según cómo identifique el directorio raíz de Oracle.

P: ¿Qué tipo de información devuelve el comando dbaascli dbHome getDatabases?

R: El comando devuelve información sobre todas las bases de datos Oracle que se ejecutan desde el directorio raíz de Oracle especificado. Esto incluye detalles como los nombres y estados de la base de datos.

P: ¿Cuál es un ejemplo de uso de dbaascli dbHome getDatabases con la ubicación del directorio raíz de Oracle?

R: A continuación se muestra un ejemplo del uso del comando con la ubicación del directorio raíz de Oracle:

dbaascli dbHome getDatabases --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

Este comando recupera la lista de bases de datos que se ejecutan desde el directorio raíz de Oracle ubicado en /u01/app/oracle/product/19.0.0/dbhome_1.

P: ¿Cuál es un ejemplo de uso de dbaascli dbHome getDatabases con el nombre del directorio raíz de Oracle?

R: A continuación se muestra un ejemplo del uso del comando con el nombre del directorio raíz de Oracle:

dbaascli dbHome getDatabases --oracleHomeName myOracleHome

Este comando recupera la lista de bases de datos que se ejecutan desde el directorio raíz de Oracle denominado myOracleHome.

P: ¿Necesito algún permiso especial para ejecutar este comando?

R: Sí, debe ejecutar el comando como usuario raíz para ver la información sobre las bases de datos Oracle que se ejecutan desde un directorio raíz de Oracle especificado.

P: ¿Qué debo comprobar si el comando dbaascli dbHome getDatabases no devuelve ninguna base de datos?

R: Asegúrese de que ha especificado el nombre o la ubicación del directorio raíz de Oracle correctos y de que hay bases de datos en ejecución desde ese directorio raíz de Oracle. Además, confirme que el directorio raíz de Oracle está correctamente configurado y activo.

P: ¿Puedo utilizar el comando dbaascli dbHome getDatabases en varios directorios raíz de Oracle a la vez?

R: No, el comando funciona en un único directorio raíz de Oracle a la vez. Debe ejecutar el comando por separado para cada directorio raíz de Oracle que desee consultar.

P: ¿Existe alguna forma de verificar que el directorio raíz de Oracle especificado en el comando es correcto?

R: Puede verificar el directorio raíz de Oracle comprobando la estructura de directorios o los detalles de configuración del sistema para asegurarse de que la ruta o el nombre proporcionados coinciden con el directorio raíz de Oracle real.

P: ¿Qué sucede si ejecuto el comando sin especificar un directorio raíz de Oracle o un nombre de directorio raíz de Oracle?

R: El comando necesita que se especifique la opción --oracleHome o --oracleHomeName. Si no se proporciona ninguna opción, el comando no se ejecutará.

P: ¿Puede este comando recuperar bases de datos que están actualmente detenidas?

R: Sí, el comando mostrará todas las bases de datos asociadas al directorio raíz de Oracle especificado, independientemente de si están actualmente en ejecución o paradas.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli dbHome getDetails?

R: El comando dbaascli dbHome getDetails se utiliza para ver información detallada sobre un directorio raíz de Oracle específico en el sistema.

P: ¿Cómo puedo especificar el directorio raíz de Oracle sobre el que quiero obtener detalles?

R: Puede especificar el directorio raíz de Oracle mediante una de las siguientes opciones:

--oracleHomeName <value> para especificar el nombre definido por el usuario del directorio raíz de Oracle.

--oracleHome <value> para especificar la ubicación completa (ruta) del directorio raíz de Oracle.

P: ¿Cuál es la diferencia entre --oracleHomeName y --oracleHome?

A:

--oracleHomeName es el nombre definido por el usuario para un directorio raíz de Oracle.

--oracleHome hace referencia a la ruta de acceso completa del directorio donde se encuentra el directorio raíz de Oracle.

P: ¿Cómo puedo ejecutar el comando dbaascli dbHome getDetails?

R: Para ejecutar el comando, utilice la siguiente sintaxis:

dbaascli dbHome getDetails --oracleHomeName <value>

o

dbaascli dbHome getDetails --oracleHome <value>

Asegúrese de ejecutar el comando con el usuario root.

P: ¿Puedo especificar --oracleHomeName y --oracleHome en el mismo comando?

R: No, solo puede usar una opción por ejecución de comando. Debe especificar el nombre del directorio raíz de Oracle o la ubicación del directorio raíz de Oracle, no ambos.

P: ¿Qué información devuelve el comando dbaascli dbHome getDetails?

R: El comando proporciona información detallada sobre el directorio raíz de Oracle especificado, como su versión, estado y cualquier otro detalle de configuración asociado al directorio raíz de Oracle.

P: ¿Cuál es un ejemplo del uso del comando dbaascli dbHome getDetails con una ubicación de directorio raíz de Oracle?

A: A continuación se muestra un ejemplo:

dbaascli dbHome getDetails --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1

Este comando recupera información detallada sobre el directorio raíz de Oracle ubicado en /u01/app/oracle/product/19.0.0/dbhome_1.

P: ¿Cuál es un ejemplo del uso del comando dbaascli dbHome getDetails con un nombre de directorio raíz de Oracle?

A: A continuación se muestra un ejemplo:

dbaascli dbHome getDetails --oracleHomeName myOracleHome

Este comando recupera información detallada sobre el directorio raíz de Oracle denominado myOracleHome.

P: ¿Necesito algún permiso especial para ejecutar este comando?

R: Sí, debe ejecutar el comando como usuario root para ver detalles sobre el directorio raíz de Oracle.

P: ¿Qué debo hacer si el comando dbaascli dbHome getDetails no devuelve información?

R: Asegúrese de que ha especificado correctamente el nombre o la ubicación del directorio raíz de Oracle y de que el directorio raíz de Oracle está configurado correctamente y existe en el sistema.

P: ¿Puedo utilizar el comando dbaascli dbHome getDetails en varios directorios raíz de Oracle simultáneamente?

R: No, el comando solo funciona en un único directorio raíz de Oracle a la vez. Debe ejecutar el comando por separado para cada directorio raíz de Oracle.

P: ¿Es posible verificar el nombre del directorio raíz de Oracle antes de ejecutar el comando?

R: Sí, puede verificar el nombre del directorio raíz de Oracle comprobando los archivos de configuración del sistema o mostrando todos los directorios raíz de Oracle disponibles en el sistema.

P: ¿Qué sucede si no especifico un nombre o una ubicación del directorio raíz de Oracle en el comando?

R: El comando necesita que se especifique la opción --oracleHome o --oracleHomeName. Si no se proporciona ninguno, el comando no se ejecutará.

P: ¿Puedo recuperar información sobre los directorios raíz de Oracle que actualmente no están en uso?

R: Sí, el comando dbaascli dbHome getDetails proporciona detalles sobre los directorios raíz de Oracle independientemente de si están en uso o inactivos.

P: ¿Qué debo comprobar si el comando devuelve un error?

R: Asegúrese de que el nombre o la ubicación del directorio raíz de Oracle son correctos, de que el directorio raíz de Oracle existe y de que está ejecutando el comando como usuario root. Compruebe si hay errores ortográficos o rutas incorrectas.

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

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

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

dbaascli dbHome getDetails --oracleHomeName home_db19c

Diagnósticos y Comprobaciones del Sistema

En esta sección se tratan las herramientas para mantener el estado y diagnosticar problemas en entornos de Oracle Database. Los comandos como dbaascli diag collect se utilizan para recopilar datos de diagnóstico, mientras que dbaascli diag healthCheck permite ejecutar comprobaciones del sistema para identificar posibles problemas. Estas herramientas ayudan a garantizar la estabilidad y el rendimiento del sistema al supervisar y abordar las preocupaciones de forma proactiva.

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.

Preguntas frecuentes

P: ¿Cuál es el propósito del comando dbaascli diag collect?

R: El comando dbaascli diag collect se utiliza para recopilar logs de diagnóstico para Oracle Database y componentes asociados, como el sistema operativo, Grid Infrastructure (GI) y las herramientas DBaaS.

P: ¿Cómo puedo especificar para qué componentes recopilar diagnósticos?

R: Puede especificar los componentes mediante la opción --components. Los valores válidos son:

db (para logs de base de datos)

gi (para logs de Grid Infrastructure)

os (para logs del sistema operativo)

dbaastools (para logs de herramientas DBaaS)

all (para recopilar logs de todos los componentes)

P: ¿Cómo puedo recopilar logs para un rango de tiempo específico?

R: Utilice las siguientes opciones para especificar un rango temporal:

--startTime <value> para definir la hora de inicio de la recopilación de logs.

--endTime <value> para definir la hora de finalización de la recopilación de logs.

La hora debe tener el formato: YYYY-MM-DDTHH24:MM:SS.

P: ¿En qué formato deben estar las horas de inicio y finalización?

R: Tanto --startTime como --endTime deben tener el formato YYYY-MM-DDTHH24:MM:SS. Por ejemplo, 2024-09-01T15:30:00.

P: ¿Cómo puedo especificar de qué nodos recopilar diagnósticos?

R: Puede utilizar la opción --nodes para especificar una lista de nodos delimitada por comas. Por ejemplo:

--nodes node1,node2

P: ¿Cómo puedo recopilar logs para una base de datos específica?

R: utilice la opción --dbNames para especificar el nombre de la base de datos para la que desea recopilar logs. Sólo se puede especificar un nombre de base de datos a la vez.

P: ¿Cómo puedo almacenar los logs recopilados en Object Storage?

R: utilice la opción --objectStoreBucketUri para especificar la URL de solicitud autenticada previamente (SAP) para el cubo de Object Storage donde se cargarán los logs.

P: ¿Puedo recopilar logs en un directorio local en lugar de en Object Storage?

R: Sí, puede utilizar la opción --destLocation para especificar un directorio en la VM de invitado donde se recopilarán los logs. La ubicación por defecto es /var/opt/oracle/dbaas_acfs.

P: ¿Qué sucede si no especifico un destino para los logs?

R: Si no se especifica ningún destino, los logs recopilados se almacenarán en la ubicación por defecto /var/opt/oracle/dbaas_acfs en la VM de invitado.

P: ¿Qué hace la opción --waitForCompletion?

R: la opción --waitForCompletion especifica si se debe esperar a que finalice el comando antes de devolver el control al usuario. El valor por defecto es true. Si especifica false, la operación se ejecuta en segundo plano.

P: ¿Cómo puedo ejecutar la recopilación de logs en segundo plano?

R: Defina la opción --waitForCompletion en false para ejecutar el proceso de recopilación de logs en segundo plano:

dbaascli diag collect --waitForCompletion false

P: ¿Puedo reanudar una sesión de recopilación de logs anterior con este comando?

R: No, el comando dbaascli diag collect no soporta la reanudación de sesiones anteriores. Tendrá que iniciar un nuevo proceso de recopilación de logs.

P: ¿Cómo puedo garantizar que los logs se carguen directamente en Object Storage?

R: Puede proporcionar un --objectStoreBucketUri válido (URL de solicitud autenticada previamente de Object Storage) donde los logs se cargarán después de la recopilación.

P: ¿Puedo recopilar logs para varias bases de datos a la vez?

R: No, solo puede especificar un nombre de base de datos a la vez mediante la opción --dbNames.

P: ¿Qué debo hacer si quiero recopilar todos los logs disponibles para todos los componentes?

R: Utilice --components all para recopilar logs de todos los componentes, incluidas las herramientas de base de datos, Grid Infrastructure, sistema operativo y DBaaS.

P: ¿Cuál es un comando de ejemplo para recopilar logs para el componente de base de datos de un rango temporal específico?

R: A continuación se muestra un comando de ejemplo:

dbaascli diag collect --components db --startTime 2024-09-01T12:00:00 --endTime 2024-09-01T14:00:00 --dbname orcl

P: ¿Cuál es un comando de ejemplo para recopilar logs y cargarlos en Object Storage?

R: A continuación se muestra un comando de ejemplo:

dbaascli diag collect --components db --objectStoreBucketUri https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL

P: ¿Cuál es el comportamiento predeterminado si no se especifica la opción --components?

R: Si no especifica la opción --components, es posible que el comando no sepa qué logs recopilar y que falle. Se recomienda especificar siempre los componentes de los que desea recopilar logs.

P: ¿Puedo especificar las opciones --objectStoreBucketUri y --destLocation en el mismo comando?

R: No, debe seleccionar un destino: Object Storage mediante --objectStoreBucketUri o un directorio local mediante --destLocation.

P: ¿Qué debo hacer si encuentro un error al usar el comando dbaascli diag collect?

R: Compruebe que ha proporcionado nombres de componentes válidos, formatos de fecha/hora y opciones de destino. Además, asegúrese de ejecutar el comando como usuario root.

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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli diag healthCheck?

R: El comando dbaascli diag healthCheck se utiliza para realizar comprobaciones del sistema de diagnóstico en una instancia de Oracle Database que se ejecuta en un entorno de Exadata Cloud@Customer.

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli diag healthCheck?

R: El comando se debe ejecutar como usuario root y debe estar conectado a una máquina virtual de Exadata Cloud@Customer.

P: ¿Cómo puedo especificar un directorio personalizado para recopilar los logs?

R: utilice la opción --destLocation para especificar el directorio en el que se recopilarán los logs de comprobación del sistema. La ubicación por defecto es /var/opt/oracle/dbaas_acfs.

P: ¿Cuál es la ubicación por defecto para la recopilación de logs si no especifico --destLocation?

R: El directorio por defecto para la recopilación de logs es /var/opt/oracle/dbaas_acfs.

P: ¿Puedo especificar en qué nodos ejecutar la comprobación del sistema?

R: Sí, puede utilizar la opción --nodes para especificar una lista delimitada por comas de nodos en los que se debe ejecutar la comprobación del sistema.

P: ¿Cómo puedo cargar los logs de comprobación del sistema en Object Storage?

R: utilice la opción --objectStoreBucketURI para proporcionar una URL de solicitud autenticada previamente (SAP) del servicio Object Storage. De esta forma, se cargarán los logs recopilados en el cubo especificado.

P: ¿Puedo recopilar logs de varios nodos?

R: Sí, puede especificar varios nodos mediante la opción --nodes en un formato delimitado por comas. Por ejemplo: --nodes node1,node2.

P: ¿Cuál es un comando de ejemplo para ejecutar una comprobación del sistema en un nodo específico?

R: A continuación, se muestra un comando de ejemplo para ejecutar la comprobación del sistema en un nodo específico:

dbaascli diag healthCheck --nodes node1

P: ¿Cómo puedo almacenar los logs en Object Storage en lugar de en la máquina local?

R: Puede proporcionar una URL de solicitud autenticada previamente (SAP) mediante la opción --objectStoreBucketURI para almacenar los logs en Object Storage.

P: ¿Puedo especificar --destLocation y --objectStoreBucketURI al mismo tiempo?

R: Sí, puede especificar --destLocation para el almacenamiento local y --objectStoreBucketURI para cargar logs en Object Storage.

P: ¿Qué debo hacer si encuentro un error al ejecutar el comando dbaascli diag healthCheck?

R: Asegúrese de ejecutar el comando como usuario root y de que ha proporcionado opciones válidas para --destLocation, --nodes o --objectStoreBucketURI. Verifique que los nombres de los nodos sean correctos si se especifican.

P: ¿Puedo ejecutar la comprobación del sistema en segundo plano?

R: El comando dbaascli diag healthCheck no tiene un modo de fondo explícito, pero puede ejecutarlo en segundo plano agregando & al final del comando.

P: ¿Qué sucede si no proporciono la opción --nodes?

R: Si no se proporciona la opción --nodes, la comprobación del sistema se realizará en todos los nodos del cluster por defecto.

P: ¿Puedo reanudar una sesión de comprobación del sistema anterior con este comando?

R: No, el comando dbaascli diag healthCheck no soporta la reanudación de sesiones anteriores. Debe iniciar una nueva comprobación del sistema cada vez.

P: ¿Cuál es un comando de ejemplo para ejecutar una comprobación del sistema y cargar logs en Object Storage?

R: A continuación se muestra un comando de ejemplo:

dbaascli diag healthCheck --objectStoreBucketURI https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL

P: ¿Cuál es el comportamiento por defecto si no especifico --destLocation o --objectStoreBucketURI?

R: Si no se especifica --destLocation ni --objectStoreBucketURI, los logs de comprobación del sistema se recopilarán en el directorio por defecto /var/opt/oracle/dbaas_acfs de la máquina local.

P: ¿Puedo limitar la comprobación del sistema a componentes o logs específicos?

R: No, el comando dbaascli diag healthCheck no permite especificar componentes o logs individuales. Realiza una comprobación de estado de diagnóstico general para el sistema.

P: ¿Qué debo verificar antes de ejecutar el comando dbaascli diag healthCheck?

R: Asegúrese de estar conectado a una máquina virtual de Exadata Cloud@Customer y de ejecutar el comando como usuario root.

Gestión de Infraestructura de Grid

Esta sección se centra en la gestión de Oracle Grid Infrastructure, que soporta la agrupación en clusters y la alta disponibilidad. Entre las tareas clave se incluyen la configuración de un directorio raíz de Grid Infrastructure (dbaascli gridHome create), la actualización de Grid Infrastructure (dbaascli grid upgrade) y la gestión de certificados TCPS (seguridad de capa de transporte) mediante la configuración (dbaascli grid configureTCPS), la eliminación (dbaascli grid removeTCPSCert) o la rotación de los mismos (dbaascli grid rotateTCPSCert). Estos comandos garantizan una configuración, mantenimiento y seguridad eficientes de Grid Infrastructure.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli gridHome create?

R: El comando dbaascli gridHome create se utiliza para configurar un directorio raíz de Grid Infrastructure para Oracle Grid Infrastructure en un entorno de Exadata Cloud@Customer.

P: ¿Cuál es el requisito para ejecutar el comando dbaascli gridHome create?

R: El comando se debe ejecutar como usuario root.

P: ¿Cómo puedo especificar la versión del directorio raíz de Grid Infrastructure que se va a crear?

R: utilice la opción --version para especificar la versión del directorio raíz de Grid. Esta es una opción obligatoria al crear el directorio raíz de Grid.

P: ¿Puedo reanudar una sesión de creación de dbaascli gridHome anterior?

R: Sí, puede utilizar la opción --resume para reanudar una sesión anterior. Opcionalmente, puede especificar el ID de sesión mediante la opción --sessionID para reanudar una sesión específica.

P: ¿Qué hace la opción --resume en el comando dbaascli gridHome create?

R: La opción --resume permite reanudar una operación interrumpida o incompleta anteriormente.

P: ¿Cómo puedo ejecutar la operación en segundo plano?

R: Puede definir la opción --waitForCompletion en false para ejecutar la operación en segundo plano. Los valores válidos para esta opción son true (por defecto) o false.

P: ¿Cuál es el comportamiento por defecto si no se especifica --waitForCompletion?

R: Si no se especifica --waitForCompletion, la operación se ejecutará en primer plano y el comando esperará a que se complete la operación antes de devolver el control al usuario.

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

R: La opción --sessionID se utiliza para especificar el ID de una sesión anterior que desea reanudar, en caso de una operación incompleta o interrumpida.

P: ¿Puedo utilizar el comando dbaascli gridHome create para actualizar un directorio raíz de Grid existente?

R: No, este comando se utiliza específicamente para configurar un nuevo directorio raíz de Grid Infrastructure, no para actualizar uno existente.

P: ¿Cuál es un comando de ejemplo para crear un directorio raíz de Grid con la versión 19.9.0.0.0?

R: A continuación se muestra un comando de ejemplo:

dbaascli gridHome create --version 19.9.0.0.0

P: ¿Qué debo hacer si se interrumpe el comando dbaascli gridHome create?

R: Puede reanudar la operación mediante la opción --resume. Si tiene el ID de sesión, puede proporcionarlo mediante la opción --sessionID para reanudar una sesión específica.

P: ¿Puedo especificar la opción --resume sin un ID de sesión?

R: Sí, puede utilizar la opción --resume sin especificar un ID de sesión. En este caso, el sistema intentará reanudar la sesión más reciente.

P: ¿Qué sucede si especifico --waitForCompletion false?

R: Si especifica --waitForCompletion false, la operación se ejecutará en segundo plano, lo que le permite seguir utilizando la línea de comandos mientras finaliza la operación.

P: ¿Es posible realizar un seguimiento del progreso de una operación en segundo plano?

R: El comando dbaascli no proporciona una forma directa de realizar un seguimiento de las operaciones en segundo plano. Puede que necesite comprobar manualmente los logs del sistema o el estado de la sesión.

P: ¿Puedo especificar una versión de directorio raíz de Grid no válida al crearla?

R: No, la opción --version debe contener una versión válida de Grid Infrastructure. Si se proporciona una versión no válida, el comando devolverá un error.

P: ¿Cómo puedo determinar la versión del directorio raíz de Grid que se utilizará para la creación?

R: Puede consultar la documentación de Oracle o consultar con el administrador de la base de datos para determinar la versión correcta del directorio raíz de Grid que se utilizará para su entorno.

P: ¿Qué debo verificar antes de ejecutar el comando dbaascli gridHome create?

R: Asegúrese de que está conectado como usuario root y de que la versión que desea utilizar para Grid Infrastructure es compatible con su entorno.

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
[--pkcs12WalletFilePath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Donde:
  • --pkcs12WalletFilePath especifica la ruta de acceso absoluta del archivo de 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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli grid configureTCPS?

R: El comando dbaascli grid configureTCPS se utiliza para configurar la seguridad de capa de transporte (TCPS) para el cluster existente en un entorno de Oracle Exadata.

P: ¿Cuál es el requisito para ejecutar el comando dbaascli grid configureTCPS?

R: El comando se debe ejecutar como usuario root.

P: ¿Está activado TCPS por defecto en sistemas Exadata Database Service on Dedicated Infrastructure?

R: Sí, TCPS está activado por defecto para las bases de datos de sistemas Oracle Exadata Database Service on Dedicated Infrastructure.

P: ¿Está activado TCPS por defecto en los sistemas Exadata Database Service on Cloud@Customer?

R: No, TCPS no está activado por defecto en los sistemas Exadata Database Service on Cloud@Customer. Para activar TCPS, debe actualizar el archivo sqlnet.ora para la base de datos específica y reiniciar la base de datos.

P: ¿Cuál es la consecuencia de activar TCPS en sistemas Exadata Cloud@Customer?

R: Al activar TCPS en sistemas Exadata Cloud@Customer, las conexiones de Zero Data Loss Recovery Appliance (ZDLRA) fallarán. Solo puede activar la configuración de ZDLRA o TCPS, pero no ambas simultáneamente.

P: ¿Qué especifica la opción --pkcs12WalletFilePath?

R: La opción --pkcs12WalletFilePath especifica la ruta de acceso absoluta al archivo de certificado en el formato de cartera PKCS12, que se utiliza para la configuración de TCPS.

P: ¿Para qué se utiliza la opción --caCertChain?

R: la opción --caCertChain especifica una lista concatenada de certificados que contiene certificados de CA intermedios y el certificado de CA raíz.

P: ¿Qué hace la opción --precheckOnly?

R: La opción --precheckOnly especifica si se deben ejecutar solo las comprobaciones previas para la operación de configuración de TCPS. Los valores aceptados son yes o no.

P: ¿Qué especifica la opción --serverCert?

R: La opción --serverCert especifica la ruta al certificado PEM que se usará o rotará para la configuración de TCPS.

P: ¿Cómo especifico la clave privada para la configuración de TCPS?

R: utilice la opción --privateKey para especificar la ruta de acceso al archivo de clave privada asociado al certificado del servidor.

P: ¿Cuáles son los valores aceptados para la opción --certType?

R: Los valores aceptados para la opción --certType son:

SELF_SIGNED_CERT

CA_SIGNED_CERT

PKCS12_CERT

El valor por defecto es SELF_SIGNED_CERT.

P: ¿La contraseña de la clave privada está protegida por defecto?

R: Sí, la opción --privateKeyPasswordProtected está definida en true por defecto, lo que indica que la clave privada está protegida con contraseña. Puede definirla en false si la clave privada no está protegida por contraseña.

P: ¿Puedo ejecutar una comprobación previa antes de configurar TCPS?

R: Sí, solo puede ejecutar las comprobaciones previas de la operación definiendo la opción --precheckOnly en sí. Esto ayuda a validar el entorno antes de realizar cambios.

P: ¿Qué sucede si proporciono una ruta de acceso incorrecta para el archivo de cartera PKCS12?

R: Si --pkcs12WalletFilePath contiene una ruta incorrecta, el comando fallará y la configuración de TCPS no continuará.

P: ¿Qué debo hacer si la clave privada está protegida con contraseña?

R: Si la clave privada está protegida por contraseña, asegúrese de que la opción --privateKeyPasswordProtected esté definida en true (que es el valor por defecto).

P: ¿Puedo especificar mi propio certificado firmado por CA para la configuración de TCPS?

R: Sí, puede especificar su propio certificado firmado por una CA mediante las opciones --serverCert y --privateKey, y definiendo --certType en CA_SIGNED_CERT.

P: ¿Cuál es un comando de ejemplo para configurar TCPS mediante un certificado autofirmado?

A: Ejemplo:

dbaascli grid configureTCPS --serverCert /path/to/self_signed_cert.pem --privateKey /path/to/private_key.pem --certType SELF_SIGNED_CERT

P: ¿Puedo usar un certificado PKCS12 para la configuración de TCPS?

R: Sí, puede utilizar un certificado PKCS12 especificando la opción --pkcs12WalletFilePath y definiendo --certType en PKCS12_CERT.

P: ¿Qué debo verificar antes de ejecutar el comando dbaascli grid configureTCPS?

R: Verifique que tiene los archivos de certificado correctos, los archivos de clave privada y que ha iniciado sesión como usuario root. Además, asegúrese de comprender las implicaciones si está utilizando ZDLRA, ya que no se puede ejecutar simultáneamente con TCPS.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli grid removeTCPSCert?

R: El comando dbaascli grid removeTCPSCert se utiliza para eliminar certificados TCPS existentes de la cartera de Grid Infrastructure en un entorno de Oracle Exadata.

P: ¿Cuál es el requisito para ejecutar el comando dbaascli grid removeTCPSCert?

R: El comando se debe ejecutar como usuario root.

P: ¿Qué especifica la opción --subject en el comando dbaascli grid removeTCPSCert?

R: la opción --subject especifica el asunto del certificado que se va a eliminar de la cartera de Grid Infrastructure.

P: ¿Cuál es la finalidad del indicador --userCert?

R: El indicador --userCert indica que el certificado que se va a eliminar es un certificado de usuario.

P: ¿Cuándo debo utilizar el indicador --trustedCert?

R: utilice el indicador --trustedCert al eliminar un certificado de confianza de la cartera de Grid Infrastructure.

P: ¿Qué hace el indicador --requestedCert?

R: El indicador --requestedCert indica que el certificado que se está eliminando es un certificado solicitado.

P: ¿Qué especifica la opción --serialNumber?

R: la opción --serialNumber especifica el número de serie del certificado que se va a eliminar. Es útil para identificar de forma única un certificado cuando hay varios certificados con el mismo asunto.

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

R: la opción --executePrereqs ejecuta comprobaciones de requisitos antes de eliminar el certificado e informa de los resultados, lo que garantiza que el entorno esté preparado correctamente para la operación.

P: ¿Qué hace la opción --resume?

R: la opción --resume reanuda la operación de eliminación si se interrumpió anteriormente.

P: ¿Cómo puedo especificar un ID de sesión al reanudar una operación interrumpida?

R: Utilice la opción --sessionID para especificar el ID de sesión de la operación interrumpida que desea reanudar.

P: ¿Qué hace el indicador --bounceListeners?

R: El indicador --bounceListeners se utiliza para reiniciar el listener de Grid Infrastructure y el listener de exploración después de eliminar el certificado TCPS.

P: ¿Puedo eliminar un certificado TCPS sin devolver los listeners?

R: Sí, el indicador --bounceListeners es opcional. Si no lo especifica, los listeners no se devolverán automáticamente.

P: ¿Cómo puedo asegurarme de que la operación se ejecute de manera segura?

R: Puede utilizar la opción --executePrereqs para realizar comprobaciones de requisitos antes de ejecutar el comando, asegurándose de que todo esté en orden antes del proceso de eliminación.

P: ¿Qué debo hacer si necesito eliminar un certificado de usuario específico por número de serie?

R: Utilice la opción --subject para especificar el asunto del certificado, el indicador --userCert para indicar que es un certificado de usuario y la opción --serialNumber para especificar el número de serie del certificado.

P: ¿Puedo eliminar varios certificados a la vez?

R: No, el comando está diseñado para eliminar un único certificado a la vez según el asunto proporcionado y otros parámetros.

P: ¿Qué sucede si se interrumpe el proceso de eliminación del certificado?

R: Puede reanudar la operación mediante la opción --resume junto con --sessionID del proceso interrumpido.

P: ¿Necesito ejecutar el comando como usuario root?

R: Sí, el comando dbaascli grid removeTCPSCert se debe ejecutar como usuario root para tener los privilegios necesarios para eliminar certificados TCPS.

P: ¿Cómo puedo identificar el certificado que quiero eliminar?

R: Puede identificar el certificado por su asunto y, opcionalmente, por su número de serie para asegurarse de que está dirigiendo el certificado correcto para su eliminación.

P: ¿Cuál es un comando de ejemplo para eliminar un certificado de confianza?

A: Ejemplo:

dbaascli grid removeTCPSCert --subject "CN=example_cert" --trustedCert

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
[--pkcs12WalletFilePath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]
Donde:
  • --pkcs12WalletFilePath especifica la ruta de acceso absoluta del archivo de 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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli grid rotateTCPSCert?

R: El comando dbaascli grid rotateTCPSCert se utiliza para rotar certificados TCPS (protocolo de seguridad de capa de transporte) en la cartera de Grid Infrastructure en entornos de Oracle Exadata.

P: ¿Cuál es el requisito para ejecutar el comando dbaascli grid rotateTCPSCert?

R: El comando se debe ejecutar como usuario root.

P: ¿Qué especifica la opción --pkcs12WalletFilePath?

R: la opción --pkcs12WalletFilePath especifica la ruta de acceso absoluta al archivo de certificado en el formato de cartera PKCS12 para la configuración de TCPS.

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

R: La opción --caCertChain especifica una lista concatenada de certificados, incluidos certificados de CA intermedios y certificados de CA raíz, para la configuración de TCPS.

P: ¿Qué hace la opción --precheckOnly?

R: La opción --precheckOnly permite ejecutar comprobaciones previas sin realizar ningún cambio real. Los valores válidos son "yes" para ejecutar solo las comprobaciones previas y "no" para continuar con la rotación.

P: ¿Cómo se utiliza la opción --serverCert?

R: La opción --serverCert especifica la ruta al certificado del servidor PEM (Privacy Enhanced Mail) que se utiliza o rota para la configuración de TCPS.

P: ¿Qué especifica la opción --privateKey?

R: la opción --privateKey especifica la ruta al archivo de clave privada correspondiente al certificado de servidor utilizado para la rotación de TCPS.

P: ¿Cuáles son los valores válidos para la opción --certType?

R: La opción --certType acepta los siguientes valores para especificar el tipo de certificado que se va a agregar a la cartera de Grid Infrastructure:

SELF_SIGNED_CERT (valor por defecto)

CA_SIGNED_CERT

PKCS12_CERT

P: ¿Qué hace la opción --privateKeyPasswordProtected?

R: La opción --privateKeyPasswordProtected indica si la clave privada está protegida por contraseña. Los valores válidos son true (por defecto) y false

P: ¿Puedo ejecutar el comando dbaascli grid rotateTCPSCert sin rotar los certificados?

R: Sí, con la opción --precheckOnly yes, solo puede ejecutar las comprobaciones previas sin rotar los certificados.

P: ¿Cuál es un ejemplo de un comando para rotar un certificado mediante una cartera PKCS12?

R: A continuación se muestra un comando de ejemplo:

dbaascli grid rotateTCPSCert --pkcs12WalletFilePath /path/to/wallet.p12 --certType PKCS12_CERT

P: ¿Cómo roto un certificado de servidor con una cadena de certificados firmada por una CA?

R: Utilice las opciones --serverCert y --caCertChain como se muestra a continuación:

dbaascli grid rotateTCPSCert --serverCert /path/to/serverCert.pem --caCertChain /path/to/caChain.pem

P: ¿Qué sucede si no especifico --privateKeyPasswordProtected?

R: Si no especifica la opción --privateKeyPasswordProtected, el comando asume que la clave privada está protegida por contraseña (valor por defecto: true).

P: ¿Puedo rotar un certificado autofirmado?

R: Sí, puede rotar un certificado autofirmado mediante la opción --certType SELF_SIGNED_CERT por defecto o especificándolo explícitamente.

P: ¿Cómo puedo rotar un certificado sin proporcionar una clave privada?

R: Para determinados tipos de certificados, como PKCS12, puede que no necesite proporcionar un archivo de clave privada independiente, ya que se incluye en la cartera. Sin embargo, si se necesita una clave privada, se debe proporcionar mediante la opción --privateKey.

P: ¿Qué pasa si quiero rotar un certificado en segundo plano?

R: El comando dbaascli grid rotateTCPSCert no proporciona una opción explícita para la ejecución en segundo plano. Puede ejecutar el comando directamente en una sesión en segundo plano (por ejemplo, mediante nohup o herramientas similares).

P: ¿Cuál es el tipo de certificado predeterminado si no se especifica?

R: El tipo de certificado por defecto es SELF_SIGNED_CERT.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli grid upgrade?

R: El comando dbaascli grid upgrade se utiliza para actualizar Oracle Grid Infrastructure de una versión principal a otra en una máquina virtual de Exadata Cloud@Customer.

P: ¿Cuál es el requisito previo para ejecutar el comando dbaascli grid upgrade?

R: El comando se debe ejecutar como usuario root y debe estar conectado a una máquina virtual de Exadata Cloud@Customer.

P: ¿Qué especifica la opción --version?

R: la opción --version especifica la versión de destino de Oracle Grid Infrastructure a la que desea actualizar.

P: ¿Qué hace la opción --resume?

R: la opción --resume reanuda un proceso de cambio de versión de Grid Infrastructure interrumpido o con fallos anteriormente.

P: ¿Cómo se utiliza la opción --executePrereqs?

R: la opción --executePrereqs solo ejecuta las comprobaciones de requisitos para el cambio de versión de Grid Infrastructure sin realizar el cambio de versión real.

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

R: la opción --containerURL especifica una URL personalizada para recuperar la imagen de software de Grid Infrastructure para la actualización.

P: ¿Qué hace la opción --softwareOnly?

R: la opción --softwareOnly instala solo el software de Grid Infrastructure sin configurar ni actualizar el entorno de Grid.

P: ¿Cuándo utilizaría la opción --targetHome?

R: la opción --targetHome especifica la ruta de acceso al directorio raíz de Grid de destino existente donde se realizará la actualización.

P: ¿Qué sucede si falla la actualización?

R: Si la actualización falla, puede utilizar la opción --revert para realizar un rollback de la actualización a su estado anterior.

P: ¿Puedo realizar una actualización de Grid Infrastructure por etapas?

R: Sí, con la opción --softwareOnly, primero puede instalar el software y, luego, completar la actualización completa, lo que permite actualizaciones temporales.

P: ¿Cómo puedo utilizar el comando dbaascli grid upgrade para actualizar solo el software?

R: Utilice la siguiente sintaxis para actualizar solo el software:

dbaascli grid upgrade --version <target_version> --softwareOnly

P: ¿Puedo comprobar los requisitos de actualización sin realizar la actualización?

R: Sí, solo puede ejecutar las comprobaciones de requisitos mediante:

dbaascli grid upgrade --version <target_version> --executePrereqs

P: ¿Cómo puedo actualizar Grid Infrastructure mediante una URL de contenedor personalizada?

R: Puede especificar la URL para recuperar la imagen de Grid Infrastructure de la siguiente forma:

dbaascli grid upgrade --version <target_version> --containerURL <custom_url>

P: ¿Cómo puedo reanudar un proceso de actualización interrumpido anteriormente?

R: Para reanudar una actualización interrumpida o fallida anteriormente, utilice:

dbaascli grid upgrade --version <target_version> --resume

P: ¿Qué hace la opción --revert en el comando dbaascli grid upgrade?

R: la opción --revert realiza un rollback de una actualización de Grid Infrastructure fallida o interrumpida a su estado original.

P: ¿Puedo realizar una actualización completa sin configurar Grid Infrastructure inmediatamente?

R: Sí, primero puede instalar solo el software mediante la opción --softwareOnly y, a continuación, configurarlo más tarde.

P: ¿Qué debo hacer si falla una actualización y quiero deshacer los cambios?

R: Utilice la opción --revert para realizar un rollback de la actualización con fallos:

dbaascli grid upgrade --version <target_version> --revert

Ejemplo 7-29 dbaascli grid upgrade

daascli grid upgrade --version 19.11.0.0.0 --executePrereqs
DBAAS CLI version MAIN
Executing command grid upgrade --version 19.11.0.0.0 --executePrereqs

Aplicación de parches y actualizaciones

En esta sección, se proporcionan herramientas para actualizar y mantener entornos de Oracle mediante la aplicación de parches y las actualizaciones. Incluye comandos como dbaascli grid patch para aplicar parches a Oracle Grid Infrastructure, dbaascli dbHome patch para aplicar parches a directorios raíz de Oracle y dbaascli database move para mover bases de datos entre directorios raíz durante actualizaciones o procesos de aplicación de parches. Estos comandos ayudan a garantizar que los sistemas permanezcan seguros, estables y actualizados.

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

Preguntas frecuentes

P: ¿Qué hace el comando dbaascli grid patch?

R: El comando dbaascli grid patch se utiliza para aplicar parches en Oracle Grid Infrastructure a una versión secundaria especificada.

P: ¿Necesito permisos especiales para ejecutar el comando dbaascli grid patch?

R: Sí, debe ejecutar el comando dbaascli grid patch como usuario root.

P: ¿Puedo especificar una versión de destino al aplicar parches a Oracle Grid Infrastructure?

R: Sí, puede especificar la versión de destino mediante la opción --targetVersion.

P: ¿Cómo puedo especificar la versión de destino del parche?

R: Utilice la opción --targetVersion seguida del número de versión con el formato 19.12.0.0.0.

P: ¿Qué hace la opción --containerURL en el comando dbaascli grid patch?

R: La opción --containerURL permite especificar una URL personalizada para recuperar la imagen de Grid Infrastructure.

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

R: La opción --executePrereqs se utiliza para ejecutar comprobaciones de requisitos antes de aplicar el parche.

P: ¿Cómo puedo aplicar parches a un subjuego de nodos mediante el comando dbaascli grid patch?

R: Utilice la opción --nodeList seguida de una lista delimitada por comas de nombres de nodo para aplicar parches solo a un subjuego de nodos.

P: ¿Qué sucede si utilizo la opción --rollback?

R: la opción --rollback revertirá el directorio raíz de Oracle con parches a su estado anterior.

P: ¿Puedo reanudar una sesión de aplicación de parches anterior?

R: Sí, puede utilizar la opción --resume para reanudar la última sesión de aplicación de parches. Si tiene un ID de sesión específico, puede especificarlo con la opción --sessionID.

P: ¿Para qué se utiliza la opción --continueWithDbDowntime?

R: La opción --continueWithDbDowntime permite seguir aplicando parches incluso si hay tiempo de inactividad de la base de datos, que se suele utilizar en entornos en los que solo hay una instancia activa.

P: ¿Cómo puedo crear una imagen a partir de un directorio raíz de Grid con parches?

R: Utilice la opción --createImage para crear una imagen. Puede especificar el directorio en el que se debe crear la imagen mediante la opción --createImageDir.

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

R: La opción --imageFile permite especificar la ruta de acceso completa del archivo de imagen que se utilizará para la aplicación de parches.

P: ¿Cómo puedo ejecutar el comando dbaascli grid patch en segundo plano?

R: Puede utilizar la opción --waitForCompletion definida en false para ejecutar la operación en segundo plano.

P: ¿Puedo utilizar una URL personalizada para recuperar la imagen del parche?

R: Sí, puede utilizar la opción --containerURL para especificar una URL personalizada para recuperar la imagen de Grid Infrastructure.

P: ¿Cómo puedo especificar los nodos a los que aplicar parches si no quiero aplicarlos a todos?

R: Puede especificar los nodos a los que desea aplicar parches mediante la opción --nodeList con una lista separada por comas de nombres de nodo.

P: ¿Qué debo hacer para realizar un rollback de un parche?

R: Utilice la opción --rollback del comando dbaascli grid patch para realizar un rollback del parche.

P: ¿Cómo puedo manejar una operación de aplicación de parches si mi entorno solo tiene una instancia activa y necesito continuar con el tiempo de inactividad?

R: utilice la opción --continueWithDbDowntime para seguir aplicando parches incluso con tiempo de inactividad de la base de datos.

P: ¿Puedo crear una imagen del directorio raíz de Grid con parches?

R: Sí, puede utilizar la opción --createImage para crear una imagen del directorio raíz de Grid con parches. Si es necesario, especifique el directorio en el que se debe guardar la imagen mediante --createImageDir.

P: ¿Qué debo hacer si deseo reanudar una sesión de aplicación de parches después de una interrupción?

R: utilice la opción --resume para reanudar la sesión de aplicación de parches. Si conoce el ID de sesión, puede especificarlo con --sessionID.

P: ¿Qué ocurre si el proceso de aplicación de parches falla a mitad de camino?

R: Si el proceso de aplicación de parches falla, puede utilizar la opción --resume para reiniciar el proceso. También puede utilizar la opción --rollback para volver al estado anterior.

P: ¿Cómo puedo asegurarme de que se cumplen todos los requisitos previos antes de aplicar parches?

R: utilice la opción --executePrereqs para ejecutar todas las comprobaciones de requisitos antes de aplicar el parche.

P: ¿Puedo realizar la aplicación de parches en segundo plano para evitar la retención del terminal?

R: Sí, puede utilizar la opción --waitForCompletion false para ejecutar el proceso de aplicación de parches en segundo plano.

P: ¿Cómo puedo crear una imagen de directorio raíz de Grid después de aplicar parches?

R: utilice la opción --createImage para crear una nueva imagen desde el directorio raíz de Grid con parches. Especifique el directorio mediante --createImageDir si es necesario.

P: ¿Cómo puedo utilizar un archivo de imagen existente para la aplicación de parches?

R: Puede utilizar la opción --imageFile para especificar la ruta de acceso completa al archivo de imagen que desea utilizar para la aplicación de parches.

P: ¿Qué debo hacer para evitar el tiempo de inactividad de la base de datos durante la aplicación de parches?

R: Asegúrese de que su entorno tenga más de una instancia activa en ejecución. Puede evitar el uso de la opción --continueWithDbDowntime, que está pensada para entornos con una sola instancia activa.

P: ¿Cómo puedo saber el progreso de un parche que se ejecuta en segundo plano?

R: Si ejecuta el parche con --waitForCompletion false, puede comprobar el estado del trabajo en segundo plano mediante comandos del sistema operativo como ps o comprobar los logs ubicados en el directorio raíz de Grid.

P: ¿Es posible aplicar parches a una versión principal superior mediante dbaascli grid patch?

R: No, dbaascli grid patch solo permite aplicar parches a una versión secundaria de la versión principal actual. Para las actualizaciones principales, deberá seguir un proceso de actualización diferente.

P: ¿Puedo omitir comprobaciones de requisitos específicas durante la aplicación de parches?

R: No, al utilizar --executePrereqs, se ejecutarán todas las comprobaciones de requisitos. Sin embargo, puede revisar los resultados de las comprobaciones de requisitos y manejar manualmente cualquier problema antes de continuar.

P: ¿Qué debo hacer si el proceso de aplicación de parches está bloqueado o bloqueado?

R: Si el proceso de aplicación de parches no responde, puede detenerlo mediante comandos del sistema operativo y, a continuación, reanudarlo mediante la opción --resume. Si eso no funciona, intente utilizar la opción --rollback para revertir el parche.

P: ¿Puedo automatizar el proceso de aplicación de parches en varios clusters?

R: Sí, mediante scripts que incluyen el comando dbaascli grid patch con las opciones adecuadas, puede automatizar la aplicación de parches en diferentes clusters.

P: ¿Dónde puedo encontrar logs para el proceso de aplicación de parches?

R: Los logs se encuentran normalmente en el directorio raíz de logs de Oracle Grid o en la ubicación por defecto especificada durante la configuración. Puede supervisar estos logs para obtener más información sobre el proceso de aplicación de parches.

P: ¿Es posible crear un proceso de parche silencioso sin interacción del usuario?

R: Sí, al especificar todas las opciones necesarias en el comando y ejecutarlo en segundo plano (--waitForCompletion false), puede crear un proceso de aplicación de parches no interactivo.

P: ¿Puedo comprobar si hay actualizaciones de parches disponibles antes de aplicar un parche?

R: El comando dbaascli grid patch en sí no tiene una opción para mostrar los parches disponibles. Sin embargo, puede utilizar los métodos estándar de Oracle, como Oracle Support, para identificar los parches más recientes.

P: ¿Puedo utilizar dbaascli para aplicar parches a varios directorios raíz de Oracle?

R: No, el comando dbaascli grid patch está diseñado para aplicar parches a un directorio raíz de Oracle Grid Infrastructure específico a la vez. Debería ejecutar el comando por separado para cada directorio raíz.

P: ¿Existe alguna forma de evitar por completo el tiempo de inactividad al aplicar parches a Grid Infrastructure?

R: Para minimizar el tiempo de inactividad, asegúrese de que su entorno tenga varias instancias de base de datos activas (configuración de RAC) para que la aplicación de parches se pueda realizar nodo por nodo. En este caso, no se debe utilizar la opción --continueWithDbDowntime.

P: ¿Cómo puedo gestionar la aplicación de parches para entornos RAC One Node?

R: En entornos RAC One Node, debe tener cuidado con la opción --continueWithDbDowntime, ya que puede haber solo una instancia activa. Revise la documentación de Oracle para obtener directrices de aplicación de parches específicas para RAC One Node.

P: ¿Puedo ver el historial de sesiones de parches anteriores?

R: La utilidad dbaascli no proporciona una forma directa de ver el historial de sesiones. Sin embargo, los logs de sesiones de aplicación de parches anteriores se pueden encontrar en el directorio raíz de logs de Grid.

Ejemplos de casos de uso

Ejemplo 1: aplicación básica de parches de cuadrícula

dbaascli grid patch --targetVersion 19.12.0.0.0

Aplica parches a Oracle Grid Infrastructure en la versión 19.12.0.0.0.

Ejemplo 2: Aplicación de parches con una URL de contenedor personalizada

dbaascli grid patch --targetVersion 19.12.0.0.0 --containerURL https://example.com/custom/url

Aplica parches a Grid Infrastructure en la versión 19.12.0.0.0, utilizando una URL de contenedor personalizada para recuperar la imagen de Grid Infrastructure.

Ejemplo 3: Aplicación de parches con comprobaciones de requisitos

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs

Aplica parches a Grid Infrastructure en la versión 19.12.0.0.0 después de ejecutar las comprobaciones de requisitos.

Ejemplo 4: Aplicación de parches en un subjuego de nodos

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2,node3

Aplica parches a Grid Infrastructure en la versión 19.12.0.0.0 en los nodos especificados (node1, node2 y node3).

Ejemplo 5: Rollback del parche

dbaascli grid patch --rollback

Realiza un rollback del último parche aplicado en Oracle Grid Infrastructure.

Ejemplo 6: Reanudación de una operación de parche anterior

dbaascli grid patch --resume

Reanuda la operación de aplicación de parches anterior desde donde se detuvo.

Ejemplo 7: Reanudación de una Operación de Parche con un ID de Sesión Específico

dbaascli grid patch --resume --sessionID 12345

Reanuda la operación de aplicación de parches con el ID de sesión 12345.

Ejemplo 8: Aplicación de parches con tiempo de inactividad de base de datos permitido

dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime

Aplica parches a Grid Infrastructure en la versión 19.12.0.0.0, al tiempo que permite el tiempo de inactividad de la base de datos si es necesario.

Ejemplo 9: Creación de una imagen con parches

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir

Crea una imagen del directorio raíz de Grid con parches (versión 19.12.0.0.0) y la almacena en el directorio especificado.

Ejemplo 10: Uso de un archivo de imagen existente

dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /path/to/image/file.zip

Aplica parches a Grid Infrastructure en la versión 19.12.0.0.0 mediante un archivo de imagen existente ubicado en /path/to/image/file.zip.

Ejemplo 11: Ejecución de la operación de aplicación de parches en segundo plano

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false

Aplica parches a Grid Infrastructure en la versión 19.12.0.0.0 y ejecuta la operación en segundo plano.

Ejemplo 12: Combinación de requisitos previos, URL personalizada y subjuego de nodos

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --containerURL https://example.com/custom/url --nodeList node1,node2

Aplica parches a Grid Infrastructure en la versión 19.12.0.0.0, ejecuta comprobaciones de requisitos, utiliza una URL personalizada para la imagen y aplica el parche solo en node1 y node2.

Ejemplo 13: Creación de una imagen con parches con un archivo de imagen existente

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir --imageFile /path/to/existing/image.zip

Crea una imagen con parches y la almacena en el directorio especificado al utilizar un archivo de imagen existente para el parche.

Ejemplo 14: Verificación de requisitos sin aplicación de parches

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs

Verifica si se cumplen todos los requisitos para aplicar parches a la versión 19.12.0.0.0 sin aplicar realmente el parche.

Ejemplo 15: Ejecución de parches e ignoración de fallos de requisitos previos

dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime --executePrereqs

Ejecuta el parche incluso si fallan algunas comprobaciones de requisitos. Esto resulta útil en casos en los que se permite el tiempo de inactividad y se pueden ignorar determinados requisitos.

Ejemplo 16: comprobación de problemas en los logs de parches

tail -f /u01/app/grid/logs/grid_patch.log

Supervisa el log de parches en tiempo real para diagnosticar cualquier problema durante el proceso de aplicación de parches.

Ejemplo 17: Aplicación del Parche en un Entorno Paralelo

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2 --waitForCompletion false

Aplica parches a Grid Infrastructure en un subjuego de nodos (node1 y node2) y ejecuta el proceso en segundo plano.

Ejemplo 18: Uso de un archivo de imagen específico de un origen externo

dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /mnt/images/grid_patch_19.12.zip

Aplica parches a Grid Infrastructure mediante un archivo de imagen descargado previamente ubicado en un dispositivo de almacenamiento externo.

Ejemplo 19: Ejecución de un parche con un ID de sesión personalizado

dbaascli grid patch --targetVersion 19.12.0.0.0 --resume --sessionID 67890

Reanuda una operación de aplicación de parches que se interrumpió con el ID de sesión 67890.

Ejemplo 20: programación de la aplicación de parches para su ejecución más adelante

echo "dbaascli grid patch --targetVersion 19.12.0.0.0" | at 02:00

Programa el comando de aplicación de parches para que se ejecute a las 2:00 a. m. mediante el comando at en Linux.

Ejemplo 21: especificación de timeout para finalización

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion true --continueWithDbDowntime --timeout 7200

Aplica parches a Grid Infrastructure al tiempo que permite el tiempo de inactividad, pero espera hasta 7200 segundos (2 horas) para su finalización antes del timeout.

Ejemplo 22: Creación de una imagen personalizada para otro entorno

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /backups/images/grid_patch

Crea una imagen personalizada de la infraestructura de grid con parches para almacenarla en el directorio /backups/images/grid_patch para su uso en otros entornos.

Ejemplo 23: Recuperación de parches después de una interrupción

dbaascli grid patch --resume --continueWithDbDowntime

Recupera y reanuda el proceso de aplicación de parches si se ha interrumpido, con tiempo de inactividad de la base de datos permitido.

Ejemplo 24: combinación de comprobación de requisitos con ejecución en segundo plano

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --waitForCompletion false

Comprueba los requisitos y ejecuta el parche en segundo plano.

Ejemplo 25: omisión de la creación de imágenes para una aplicación de parches más rápida

dbaascli grid patch --targetVersion 19.12.0.0.0 --patchInParallel --continueWithDbDowntime --waitForCompletion false

Aplica parches a Grid Infrastructure en la versión 19.12.0.0.0 en paralelo entre nodos, con tiempo de inactividad de base de datos permitido y sin crear una imagen para acelerar el proceso.

Ejemplo 26: Supervisión del Progreso de Parches a través de Logs

tail -f /u01/app/grid/logs/grid_patch_progress.log

Supervisa el archivo log para detectar el progreso de la aplicación de parches en tiempo real y proporciona información sobre cada paso del proceso de aplicación de parches.

Ejemplo 27: Aplicación de parches con timeout de drenaje personalizado

dbaascli grid patch --targetVersion 19.12.0.0.0 --drainTimeoutInSeconds 3600 --continueWithDbDowntime

Aplica parches a Grid Infrastructure y define un timeout personalizado de 1 hora (3600 segundos) para permitir el vaciado de recursos controlado durante el tiempo de inactividad de la base de datos.

Ejemplo 28: Aplicación de un Parche a Nodos Específicos con Comprobaciones de Requisitos

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node4 --executePrereqs

Aplica parches solo a los nodos node1 y node4 en la versión 19.12.0.0.0 y ejecuta las comprobaciones de requisitos de antemano.

Ejemplo 29: Aplicación de parches sin esperar a la finalización

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false

Comienza a aplicar parches a Grid Infrastructure en la versión 19.12.0.0.0 en segundo plano, lo que permite que se realicen otras tareas sin esperar a que se complete el proceso.

Ejemplo 30: Reaplicación de un parche fallido después de un problema de timeout de vaciado

dbaascli grid patch --resume --drainTimeoutInSeconds 7200

Reanuda la sesión de aplicación de parches anterior y amplía el timeout de vaciado de recursos a 2 horas (7200 segundos) en caso de que falle debido a un tiempo insuficiente en el intento anterior.

Ejemplo 31: Visualización de Logs de Parches en Tiempo Real con un ID de Sesión Específico

tail -f /u01/app/grid/logs/grid_patch_12345.log

Supervisa el archivo log para la sesión de aplicación de parches con el ID de sesión 12345 en tiempo real.

Ejemplo 32: Aplicación de Parches a un Nuevo Directorio Raíz de Destino

dbaascli grid patch --targetHome /u01/app/grid_home_19c --executePrereqs

Realiza un parche externo a un nuevo directorio raíz de Oracle Grid ubicado en /u01/app/grid_home_19c, con comprobaciones de requisitos.

Ejemplo 33: Parada de un Trabajo de Parche en Segundo Plano

ps -ef | grep dbaascli | grep patch | awk '{print $2}' | xargs kill -9

Para un trabajo de parche en segundo plano, busque y mate el ID de proceso (PID) asociado.

Ejemplo 34: Verificación de la finalización de parches sin logs

dbaascli grid status --targetVersion 19.12.0.0.0

Verifica si el parche de la versión 19.12.0.0.0 se ha aplicado correctamente comprobando el estado de la versión actual de Grid Infrastructure.

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

Preguntas frecuentes

P: ¿Para qué se utiliza el comando de parche dbaascli dbHome?

R: El comando dbaascli dbHome patch se utiliza para aplicar parches en el directorio raíz de Oracle de un nivel de parche a otro.

P: ¿Necesito permisos especiales para ejecutar el comando dbaascli dbHome patch?

R: Sí, debe ejecutar el comando como usuario root.

P: ¿Cómo puedo especificar la ruta o el nombre del directorio raíz de Oracle para el parche?

R: utilice la opción --oracleHome para especificar la ruta de acceso del directorio raíz de Oracle o --oracleHomeName para especificar el nombre del directorio raíz de Oracle.

P: ¿Cómo puedo definir la versión de destino para el parche?

R: Utilice la opción --targetVersion seguida del número de versión con el formato 19.12.0.0.0.

P: ¿Qué hace la opción --resume?

R: La opción --resume permite reanudar una sesión de aplicación de parches anterior.

P: ¿Cómo puedo especificar un ID de sesión concreto al reanudar un parche?

R: utilice la opción --sessionID para especificar el ID de sesión de la sesión de aplicación de parches que desea reanudar.

P: ¿Para qué se utiliza la opción --continueWithDbDowntime?

R: La opción --continueWithDbDowntime permite que la aplicación de parches continúe incluso si hay tiempo de inactividad de la base de datos, útil en entornos con una sola instancia activa.

P: ¿Cómo puedo omitir la aplicación de parches en nodos inaccesibles?

R: utilice la opción --skipUnreachableNodes para omitir operaciones en nodos a los que no se puede acceder.

P: ¿Cómo puedo aplicar parches solo a nodos específicos de un cluster?

R: Utilice la opción --nodes seguida de una lista delimitada por comas de nombres de nodo para aplicar parches a un subjuego de nodos.

P: ¿Para qué sirve la opción --executePrereqs?

R: la opción --executePrereqs ejecuta comprobaciones de requisitos antes de aplicar el parche.

P: ¿Cómo puedo omitir la ejecución de datapatch en las bases de datos?

R: utilice la opción --skipDatapatch para omitir el proceso de parche de datos durante la aplicación de parches.

P: ¿Puedo especificar una ubicación personalizada para la imagen de la base de datos?

R: Sí, utilice la opción --imageLocation para especificar una ubicación personalizada para la imagen de base de datos.

P: ¿Qué hace la opción --skipPDBs?

R: La opción --skipPDBs permite omitir la ejecución de datapatch en una lista delimitada por comas especificada de bases de datos de conexión (PDB).

P: ¿Cómo puedo omitir datapatch en PDB cerradas?

R: utilice la opción --skipClosedPDBs para omitir el parche de datos en las PDB cerradas.

P: ¿Qué sucede si utilizo la opción --rollback?

R: la opción --rollback revertirá el directorio raíz de Oracle a su estado anterior antes de aplicar el parche.

P: ¿Cómo puedo especificar la ruta de acceso del directorio raíz de Oracle para la aplicación de parches?

R: Utilice la opción --oracleHome seguida de la ruta al directorio raíz de Oracle.

P: ¿Cómo puedo aplicar parches a un directorio raíz de Oracle por su nombre en lugar de por la ruta?

R: utilice la opción --oracleHomeName seguida del nombre del directorio raíz de Oracle.

P: ¿Cómo puedo reanudar una operación de aplicación de parches si se ha interrumpido?

R: Utilice la opción --resume junto con la opción --sessionID para reanudar una sesión interrumpida específica.

P: ¿Puedo continuar con el proceso de aplicación de parches si la base de datos está caída?

R: Sí, utilice la opción --continueWithDbDowntime para continuar con la aplicación de parches incluso si la base de datos está caída.

P: ¿Qué debo hacer si no se puede acceder a algunos nodos durante el proceso de aplicación de parches?

R: Utilice la opción --skipUnreachableNodes para omitir los nodos inaccesibles.

P: ¿Cómo puedo aplicar el parche solo a determinados nodos?

R: Especifique los nodos a los que desea aplicar parches mediante la opción --nodes con una lista separada por comas de nombres de nodo.

P: ¿Cómo puedo comprobar los requisitos previos antes de aplicar el parche?

R: utilice la opción --executePrereqs para ejecutar comprobaciones de requisitos antes de aplicar el parche.

P: ¿Qué debo hacer si quiero evitar aplicar datapatch durante el proceso de aplicación de parches?

R: Utilice la opción --skipDatapatch para omitir el paso datapatch.

P: ¿Cómo puedo especificar una ubicación diferente para la imagen de base de datos utilizada en el proceso de aplicación de parches?

R: utilice la opción --imageLocation para especificar una ubicación personalizada para la imagen.

P: ¿Qué ocurre si necesito omitir datapatch en determinadas PDB?

R: Utilice la opción --skipPDBs para omitir datapatch en una lista de PDB delimitada por comas especificada.

P: ¿Puedo omitir datapatch en PDB que no están abiertas actualmente?

R: Sí, utilice la opción --skipClosedPDBs para omitir el parche de datos en las PDB cerradas.

P: ¿Qué debo hacer si la aplicación de parches falla a mitad de camino?

R: Puede utilizar la opción --rollback para volver al estado anterior o intentar reanudar el proceso de aplicación de parches con la opción --resume.

P: ¿Cómo puedo comprobar si se cumplen todos los requisitos previos antes de aplicar el parche?

R: Ejecute el comando patch con la opción --executePrereqs para asegurarse de que se cumplen todos los requisitos.

P: ¿Qué ocurre si la operación de aplicación de parches no se completa correctamente y necesito volver a intentarlo?

R: utilice la opción --resume para volver a intentar la operación de aplicación de parches desde donde se dejó. Si es necesario, puede especificar --sessionID para reanudar una sesión específica.

P: ¿Cómo puedo verificar si el parche se aplicó correctamente?

R: Puede verificar el proceso de aplicación de parches comprobando la versión del directorio raíz de Oracle mediante el comando opatch lsinventory una vez finalizado el parche.

P: ¿Puedo ejecutar el comando de aplicación de parches en modo de ejecución simulada para obtener una vista previa de las acciones?

R: No, el comando dbaascli dbHome patch no tiene una función de ejecución simulada. Sin embargo, puede utilizar la opción --executePrereqs para ejecutar comprobaciones de requisitos antes de aplicar realmente el parche.

P: ¿Es posible aplicar varios parches en una sola ejecución?

R: El comando dbaascli dbHome patch solo permite una versión de destino a la vez. Debería ejecutar el comando por separado para cada versión de parche.

P: ¿Cómo puedo gestionar la aplicación de parches si el entorno utiliza varios directorios raíz de Oracle?

R: Puede especificar el directorio raíz de Oracle al que desea aplicar el parche mediante las opciones --oracleHome o --oracleHomeName, en función de si está especificando la ruta o el nombre del directorio raíz de Oracle.

P: ¿Puedo omitir el parche de datos de PDB y CDB en un solo comando?

R: Sí, puede combinar las opciones --skipPDBs y --skipDatapatch para omitir el parche de datos tanto para las PDB como para la CDB en una sola ejecución de parche.

P: ¿Puedo aplicar un parche y realizar un rollback inmediatamente si causa problemas?

R: Sí, después de aplicar un parche, puede utilizar la opción --rollback para volver al nivel de parche anterior si se produce algún problema.

P: ¿Puedo aplicar parches a varios directorios raíz de Oracle simultáneamente?

R: No, debe ejecutar el comando dbaascli dbHome patch individualmente para cada directorio raíz de Oracle.

P: ¿Cómo puedo realizar un seguimiento del progreso de la operación de aplicación de parches?

R: Durante el proceso de aplicación de parches, el comando proporciona mensajes de salida que muestran el progreso. También puede consultar los archivos log para obtener información detallada.

P: ¿Puedo ejecutar la aplicación de parches en paralelo en un entorno de cluster?

R: Las operaciones de aplicación de parches se pueden aplicar a un subjuego de nodos mediante la opción --nodes. Sin embargo, la aplicación simultánea de parches se debe manejar con cuidado y debe asegurarse de que no se superpongan sesiones.

P: ¿Cómo puedo identificar qué parches están disponibles para mi directorio raíz de Oracle?

R: Puede comprobar los parches disponibles mediante el portal de soporte de Oracle o mediante la ejecución del comando opatch lsinventory para ver los parches actuales aplicados al directorio raíz de Oracle.

P: ¿Puedo especificar un timeout para vaciar recursos al parar la base de datos durante la aplicación de parches?

R: Sí, puede utilizar la opción --drainTimeoutInSeconds para especificar el tiempo en segundos para el vaciado de recursos al parar la base de datos.

P: ¿Qué sucede si el parche falla en uno de los nodos de un entorno de varios nodos?

R: Puede utilizar la opción --skipUnreachableNodes para omitir el nodo con fallos y continuar el proceso de aplicación de parches en los nodos restantes. A continuación, puede solucionar el problema en el nodo con fallos por separado.

P: ¿Cómo puedo hacer que el proceso de aplicación de parches se ejecute en segundo plano?

R: utilice la opción --waitForCompletion con el valor false para permitir que el proceso de aplicación de parches se ejecute en segundo plano. De esta manera, no es necesario esperar a que el proceso se complete de forma interactiva.

P: ¿Puedo realizar una operación de rollback en un subjuego de nodos de un entorno de cluster?

R: Sí, puede utilizar la opción --nodes junto con la opción --rollback para realizar un rollback de la aplicación de parches en un juego específico de nodos.

P: ¿Qué sucede si necesito actualizar la ubicación de la imagen después de iniciar el proceso de parche?

R: La opción --resume no permite cambiar la ubicación de la imagen. Sin embargo, puede parar la sesión e iniciar un nuevo proceso de parche con el --imageLocation actualizado.

P: ¿Existe alguna forma de comprobar qué ID de sesión están disponibles para reanudar un parche?

R: Puede consultar los archivos log o utilizar las herramientas de Oracle Cloud para identificar las sesiones de aplicación de parches activas o en pausa y sus ID de sesión.

P: ¿Puedo limitar el tiempo de inactividad durante la aplicación de parches?

R: Si necesita limitar el tiempo de inactividad, utilice la opción --continueWithDbDowntime con cuidado. Esto le permite continuar incluso cuando se espera tiempo de inactividad, pero requiere planificación para un impacto mínimo en el servicio.

Ejemplos de casos de uso

Ejemplo 1: Aplicación de parches en el directorio raíz de Oracle básico por ruta de acceso al directorio raíz de Oracle

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

Aplica parches al directorio raíz de Oracle ubicado en /u01/app/oracle/product/19.0.0/dbhome_1 a la versión 19.12.0.0.0.

Ejemplo 2: Aplicación de parches por nombre de directorio raíz de Oracle

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0

Aplica parches al directorio raíz de Oracle denominado DB_HOME_NAME en la versión 19.12.0.0.0.

Ejemplo 3: Reanudación de una operación de parche anterior

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --resume

Reanuda la operación de aplicación de parches anterior para el directorio raíz de Oracle ubicado en /u01/app/oracle/product/19.0.0/dbhome_1.

Ejemplo 4: Reanudación de un parche con un ID de sesión específico

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --resume --sessionID 12345

Reanuda la operación de aplicación de parches para el directorio raíz de Oracle DB_HOME_NAME mediante el ID de sesión 12345.

Ejemplo 5: Aplicación de parches con tiempo de inactividad de base de datos permitido

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --continueWithDbDowntime

Aplica parches al directorio raíz de Oracle ubicado en /u01/app/oracle/product/19.0.0/dbhome_1 a la versión 19.12.0.0.0, al tiempo que permite el tiempo de inactividad de la base de datos.

Ejemplo 6: omisión de nodos inaccesibles

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes

Aplica parches al directorio raíz de Oracle en la versión 19.12.0.0.0 al omitir los nodos inaccesibles.

Ejemplo 7: Aplicación de parches a un subjuego de nodos

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --nodes node1,node2

Aplica parches al directorio raíz de Oracle solo en la versión 19.12.0.0.0 en node1 y node2.

Ejemplo 8: ejecución de comprobaciones de requisitos antes de aplicar parches

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --executePrereqs

Aplica parches al directorio raíz de Oracle DB_HOME_NAME a la versión 19.12.0.0.0 después de ejecutar comprobaciones de requisitos.

Ejemplo 9: Omisión del Paso Datapatch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch

Aplica parches al directorio raíz de Oracle en la versión 19.12.0.0.0 sin ejecutar datapatch en las bases de datos.

Ejemplo 10: Uso de un archivo de imagen para aplicar parches

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --imageFilePath /path/to/image/file.zip

Aplica parches al directorio raíz de Oracle en la versión 19.12.0.0.0 mediante un archivo de imagen ubicado en /path/to/image/file.zip.

Ejemplo 11: Omisión de PDB Específicas durante Datapatch

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2

Aplica parches al directorio raíz de Oracle en la versión 19.12.0.0.0 y omite la ejecución del parche de datos en las PDB especificadas (pdb1 en cdb1 y pdb2 en cdb2).

Ejemplo 12: Omisión de Datapatch en PDB cerradas

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipClosedPDBs

Aplica parches al directorio raíz de Oracle en la versión 19.12.0.0.0 mientras se omite la ejecución de datapatch en cualquier PDB cerrada.

Ejemplo 13: Rollback del directorio raíz de Oracle

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback

Realiza un rollback del último parche aplicado en el directorio raíz de Oracle denominado DB_HOME_NAME.

Ejemplo 14: Combinación de aplicación de parches con comprobaciones de requisitos y nodos específicos

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --executePrereqs --nodes node1,node2

Aplica parches al directorio raíz de Oracle en la versión 19.12.0.0.0, ejecuta comprobaciones de requisitos y aplica el parche solo en node1 y node2.

Ejemplo 15: omisión de nodos inaccesibles y PDB específicas

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --skipUnreachableNodes --skipPDBs cdb1:pdb1

Aplica parches al directorio raíz de Oracle DB_HOME_NAME a la versión 19.12.0.0.0 mientras se omiten los nodos inaccesibles y se evita la ejecución del parche de datos en pdb1 en cdb1.

Ejemplo 16: Comprobación de la versión posterior al parche del directorio raíz de Oracle

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

opatch lsinventory

En este ejemplo se muestra cómo comprobar la versión del directorio raíz de Oracle después de un parche correcto ejecutando opatch lsinventory.

Ejemplo 17: Rollback de la aplicación de parches con un ID de sesión específico

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --sessionID 67890

Realiza un rollback de la aplicación de parches del directorio raíz de Oracle para un ID de sesión de 67890.

Ejemplo 18: Aplicación de parches con omisión de comprobaciones de requisitos

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPrereqs

Aplica parches al directorio raíz de Oracle, pero omite las comprobaciones de requisitos antes de aplicar el parche.

Ejemplo 19: Aplicación de un Parche a una Imagen del Directorio Raíz de Oracle Personalizada

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --imageLocation /custom/location/image.zip

Aplica parches al directorio raíz de Oracle mediante un archivo de imagen personalizado ubicado en /custom/location/image.zip.

Ejemplo 20: omisión de nodos específicos y ejecución de requisitos

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipUnreachableNodes --executePrereqs

omite la aplicación de parches a nodos inaccesibles y ejecuta comprobaciones de requisitos antes de aplicar el parche.

Ejemplo 21: Omisión de Datapatch en Todas las PDB en Varias CDB

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipPDBs cdb1:pdb1,cdb2:pdb2,cdb3:pdb3

Aplica parches al directorio raíz de Oracle pero omite el parche de datos en las PDB especificadas en varias CDB.

Ejemplo 22: Continuación de la aplicación de parches con tiempo de inactividad en varios nodos

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.12.0.0.0 --continueWithDbDowntime --nodes node3,node4

Continúa con la aplicación de parches en node3 y node4 con tiempo de inactividad de base de datos permitido.

Ejemplo 23: Omisión de Datapatch en PDB y PDB cerradas

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0 --skipDatapatch --skipClosedPDBs

Aplica parches al directorio raíz de Oracle al omitir el parche de datos y las PDB cerradas.

Ejemplo 24: Rollback y Nueva Aplicación de Parches

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.12.0.0.0

Realiza un rollback del parche actual y, a continuación, vuelve a aplicar el parche al directorio raíz de Oracle.

Ejemplo 25: Omisión de Datapatch y Permiso de Tiempo de Inactividad en un Nodo Específico

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipDatapatch --continueWithDbDowntime --nodes node1

Aplica parches al directorio raíz de Oracle en la versión 19.13.0.0.0 en node1, omitiendo el paso de parche de datos y permitiendo el tiempo de inactividad.

Ejemplo 26: Especificación del timeout de vaciado durante el cierre de la base de datos

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --targetVersion 19.13.0.0.0 --drainTimeoutInSeconds 300

Aplica un parche al directorio raíz de Oracle DB_HOME_NAME a la versión 19.13.0.0.0 y permite un timeout de 5 minutos (300 segundos) para vaciar recursos durante el cierre.

Ejemplo 27: Ejecución de parches en segundo plano

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --waitForCompletion false

Aplica parches al directorio raíz de Oracle en la versión 19.13.0.0.0 y ejecuta el proceso de aplicación de parches en segundo plano sin esperar a que termine.

Ejemplo 28: Rollback del parche en un subjuego de nodos

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --rollback --nodes node1,node2

Realiza un rollback del último parche aplicado en node1 y node2 solo para el directorio raíz de Oracle especificado.

Ejemplo 29: omisión de requisitos previos y aplicación de parches a varios nodos

dbaascli dbHome patch --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --targetVersion 19.13.0.0.0 --skipPrereqs --nodes node3,node4

Aplica parches al directorio raíz de Oracle en la versión 19.13.0.0.0 en node3 y node4 sin ejecutar comprobaciones de requisitos.

Ejemplo 30: Rollback del parche y omisión de nodos inaccesibles

dbaascli dbHome patch --oracleHomeName DB_HOME_NAME --rollback --skipUnreachableNodes

Realiza un rollback del último parche en el directorio raíz de Oracle DB_HOME_NAME y omite los nodos inaccesibles durante el proceso de rollback.

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> 
[--executePrereqs] 
[--resume [--sessionID <value>]] 
[--rollback [--sessionID <value>]] 
[--skipDatapatch] 
[--skipPDBs <value>] 
[--skipClosedPDBs] 
[--continueWithDbDowntime] 
[--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
  • --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.
  • --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

Preguntas frecuentes

P: ¿Para qué se utiliza el comando dbaascli database move?

R: El comando dbaascli database move se utiliza para mover una base de datos de un directorio raíz de Oracle a otro.

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli database move?

R: Antes de realizar una operación de movimiento, asegúrese de que todas las instancias de base de datos asociadas a la base de datos estén activas y en ejecución. Además, el comando se debe ejecutar como usuario root.

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

R: el parámetro --oracleHome especifica la ruta de acceso del directorio raíz de Oracle al que se moverá la base de datos.

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

R: el parámetro --oracleHomeName especifica el nombre del directorio raíz de Oracle al que se moverá la base de datos.

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

R: El parámetro --dbname especifica el nombre de la base de datos que desea mover.

P: ¿Qué hace la opción --executePrereqs?

R: La opción --executePrereqs ejecuta las comprobaciones de requisitos e informa de los resultados.

P: ¿Para qué se utiliza la opción --resume?

R: la opción --resume reanuda una operación de movimiento interrumpida o incompleta anteriormente.

P: ¿Cómo se utiliza --sessionID en el comando?

R: --sessionID especifica el ID de sesión para reanudar una ejecución o rollback anteriores.

P: ¿Qué hace la opción --rollback?

R: la opción --rollback realiza un rollback de la base de datos al directorio raíz de Oracle anterior.

P: ¿Qué hace la opción --skipDatapatch?

R: la opción --skipDatapatch omite la ejecución del parche de datos en las bases de datos durante la operación de movimiento.

P: ¿Cuál es la función de la opción --skipPDBs?

R: la opción --skipPDBs omite la ejecución del parche de datos en una lista delimitada por comas de las PDB especificada (por ejemplo, pdb1, pdb2).

P: ¿Qué hace la opción --skipClosedPDBs?

R: La opción --skipClosedPDBs omite la aplicación de parches de PDB cerradas.

P: ¿Qué significa --continueWithDbDowntime?

R: La opción --continueWithDbDowntime permite que la operación de movimiento continúe incluso si solo hay una instancia activa, lo que permite el tiempo de inactividad durante el proceso.

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

R: La opción --allowParallelDBMove permite que el movimiento de la base de datos se realice en paralelo, lo que podría acelerar el proceso.

P: ¿Qué especifica --waitForCompletion?

R: la opción --waitForCompletion especifica si se debe esperar a que finalice la operación. Si se define en false, se ejecuta la operación en segundo plano.

P: ¿Cómo utilizo el parámetro --nodeList?

R: El parámetro --nodeList especifica una lista delimitada por comas de nodos en los que se realizará la operación de movimiento, si no se va a aplicar a todos los nodos.

P: ¿Qué debo hacer si encuentro problemas con el comando dbaascli database move?

R: Asegúrese de que todas las instancias de base de datos se están ejecutando y verifique que está ejecutando el comando como usuario root. Si los problemas persisten, consulte la documentación detallada del comando o abra un ticket de soporte con Oracle.

P: ¿Puedo realizar una operación de movimiento si una de las instancias de base de datos está caída?

R: No, todas las instancias de base de datos asociadas deben estar activas y en ejecución antes de realizar la operación de traslado.

P: ¿Qué sucede si se interrumpe la operación de movimiento?

R: Puede utilizar la opción --resume para continuar la operación de movimiento desde el punto en el que se dejó utilizando la misma sesión o especificando --sessionID.

P: ¿Qué hace la opción --allowParallelDBMove?

R: Permite que el movimiento de la base de datos se realice en paralelo, lo que puede reducir el tiempo que se tarda en completar la operación, especialmente en entornos más grandes.

P: ¿Cómo puedo supervisar el progreso de una operación de movimiento que se ejecuta en segundo plano?

R: Al utilizar --waitForCompletion false, el comando no espera a que se complete la operación. Puede comprobar el estado de la operación manualmente mediante los logs o comandos de estado de Oracle adecuados.

P: ¿Cuál es la importancia de la opción --skipClosedPDBs?

R: Se omite la aplicación de parches para las PDB cerradas, lo que reduce el tiempo de operación si hay PDB a las que no es necesario aplicar parches.

P: ¿Se puede realizar un rollback del movimiento de la base de datos en cualquier momento?

R: Sí, se puede realizar un rollback de la operación de movimiento mediante la opción --rollback, ya sea especificando el ID de sesión o simplemente realizando un rollback al directorio raíz de Oracle anterior.

P: ¿Cuál es el rol de --nodeList en un entorno de varios nodos?

R: En un entorno de varios nodos, puede restringir la operación de movimiento a nodos específicos proporcionando una lista delimitada por comas de nombres de nodo con --nodeList.

P: ¿Puedo mover la base de datos a un nuevo directorio raíz de Oracle omitiendo nodos específicos en un entorno de varios nodos?

R: Sí, puede utilizar la opción --nodeList para especificar qué nodos incluir en la operación de movimiento. Se omitirá cualquier nodo que no aparezca en la lista.

P: ¿Cuál es el número máximo de nodos que puedo especificar con el parámetro --nodeList?

R: El parámetro --nodeList permite especificar una lista delimitada por comas de tantos nodos como sea necesario, limitada solo por la configuración del entorno. Asegúrese de que todos los nodos son válidos y accesibles.

P: ¿Cómo puedo saber qué PDB se cierran antes de utilizar la opción --skipClosedPDBs?

R: Puede consultar la vista v$pdbs para comprobar el estado de las PDB. Cualquier PDB con el estado "MOUNTED" o "CLOSED" se omitirá al utilizar --skipClosedPDBs.

P: ¿Cómo puedo verificar si un rollback ha finalizado correctamente?

R: Después de ejecutar el comando de rollback, puede revisar los logs de la base de datos o utilizar los logs de alertas de Oracle para verificar que se ha realizado correctamente un rollback de la base de datos al directorio raíz de Oracle anterior.

P: ¿Existe alguna forma de forzar la operación de movimiento si fallan algunos requisitos previos?

R: El comando move fuerza las comprobaciones de requisitos para la estabilidad del sistema. No puede omitir fallos de requisitos críticos. Resuelva los problemas informados por la opción --executePrereqs antes de continuar con el movimiento.

Ejemplos de casos de uso

Ejemplo 1: Movimiento de base de datos básico por ruta de acceso del directorio raíz de Oracle

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL

Mueve la base de datos ORCL al directorio raíz de Oracle ubicado en /u01/app/oracle/product/19.0.0/dbhome_1.

Ejemplo 2: Movimiento de base de datos por nombre de directorio raíz de Oracle

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL

Mueve la base de datos ORCL al directorio raíz de Oracle denominado DB_HOME_NAME.

Ejemplo 3: Ejecución de comprobaciones de requisitos antes del movimiento

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --executePrereqs

Mueve la base de datos ORCL al directorio raíz de Oracle mientras ejecuta previamente las comprobaciones de requisitos.

Ejemplo 4: Reanudación de una operación de movimiento anterior

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --resume

Reanuda una operación de movimiento anterior para la base de datos ORCL.

Ejemplo 5: Reanudación de una Operación de Movimiento con un ID de Sesión Específico

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --resume --sessionID 12345

Reanuda la operación de movimiento para la base de datos ORCL con el ID de sesión 12345.

Ejemplo 6: Rollback de una operación de movimiento

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --rollback

Realiza un rollback de la operación de movimiento para la base de datos ORCL, restaurándola en el directorio raíz de Oracle anterior.

Ejemplo 7: Rollback de una operación de movimiento con un ID de sesión

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --rollback --sessionID 67890

Realiza un rollback de la operación de movimiento para ORCL con el ID de sesión 67890.

Ejemplo 8: omisión de Datapatch

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipDatapatch

Mueve la base de datos ORCL sin ejecutar datapatch en las bases de datos.

Ejemplo 9: Omisión de PDB Específicas durante Datapatch

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipPDBs pdb1,pdb2

Mueve la base de datos ORCL a un nuevo directorio raíz de Oracle, pero omite la ejecución del parche de datos en las PDB especificadas (pdb1 y pdb2).

Ejemplo 10: Omisión de Datapatch en PDB cerradas

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --skipClosedPDBs

Mueve la base de datos ORCL y omite la ejecución de datapatch en cualquier PDB cerrada.

Ejemplo 11: permiso de tiempo de inactividad de la base de datos durante el movimiento

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --continueWithDbDowntime

Mueve la base de datos ORCL al directorio raíz de Oracle especificado al tiempo que permite el tiempo de inactividad de la base de datos durante el proceso de movimiento.

Ejemplo 12: Movimiento de bases de datos en paralelo

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --allowParallelDBMove

Mueve la base de datos ORCL al directorio raíz de Oracle especificado con la opción de ejecutar el movimiento en paralelo para obtener un mejor rendimiento.

Ejemplo 13: Ejecución de la operación en segundo plano

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --waitForCompletion false

Mueve la base de datos ORCL a un nuevo directorio raíz de Oracle, pero ejecuta la operación en segundo plano.

Ejemplo 14: Especificación de nodos para el movimiento

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --nodeList node1,node2.

Mueve la base de datos ORCL al directorio raíz de Oracle especificado, pero realiza la operación solo en node1 y node2.

Ejemplo 15: combinación de movimiento con comprobaciones de requisitos, omisión de PDB específicas y permiso de tiempo de inactividad

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname ORCL --executePrereqs --skipPDBs pdb1 --continueWithDbDowntime

Mueve la base de datos ORCL al directorio raíz de Oracle especificado, ejecuta comprobaciones de requisitos, omite la ejecución de datapatch en pdb1 y permite el tiempo de inactividad de la base de datos durante la operación.

Ejemplo 16: Combinación de movimiento en paralelo y ejecución en segundo plano

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --allowParallelDBMove --waitForCompletion false

Mueve la base de datos ORCL a un nuevo directorio raíz de Oracle, ejecuta el movimiento en paralelo y ejecuta la operación en segundo plano.

Ejemplo 17: combinación de movimiento con ejecución en paralelo y omisión de PDB cerradas

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname TESTDB --allowParallelDBMove --skipClosedPDBs

Mueve la base de datos TESTDB al nuevo directorio raíz de Oracle /u02/app/oracle/product/19.0.0/dbhome_2 mientras ejecuta la operación en paralelo y omite el parche de datos en las PDB cerradas.

Ejemplo 18: ejecución de comprobación de requisitos

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname PRODDB --executePrereqs

Comprueba los requisitos para mover la base de datos PRODDB al directorio raíz de Oracle ubicado en /u02/app/oracle/product/19.0.0/dbhome_2 sin realizar realmente el movimiento.

Ejemplo 19: Omisión de Datapatch para PDB Específicas

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname HRDB --skipPDBs pdb1,pdb3

Mueve la base de datos HRDB al nuevo directorio raíz de Oracle, pero omite la ejecución de datapatch para pdb1 y pdb3.

Ejemplo 20: ejecución del movimiento en nodos específicos

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname FINDB --nodeList node1,node3

Mueve la base de datos FINDB al nuevo directorio raíz de Oracle solo en node1 y node3.

Ejemplo 21: Movimiento de base de datos con tiempo de inactividad permitido

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname ORCL --continueWithDbDowntime

Mueve la base de datos ORCL al directorio raíz de Oracle especificado al tiempo que permite el tiempo de inactividad durante la operación de movimiento.

Ejemplo 22: Combinación de Movimiento Paralelo y Omisión de Datapatch

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname CRMDB --allowParallelDBMove --skipDatapatch

Mueve la base de datos CRMDB en paralelo, omitiendo el proceso de parche de datos.

Ejemplo 23: Operación de movimiento en segundo plano con una lista de nodos

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname SALESDB --waitForCompletion false --nodeList node2,node3

Mueve la base de datos SALESDB al directorio raíz de Oracle especificado en segundo plano y la operación solo se aplica en node2 y node3.

Ejemplo 24: Movimiento de base de datos con comprobación de requisitos y permiso de movimiento en paralelo

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_2 --dbname ORCL --executePrereqs --allowParallelDBMove

Mueve la base de datos ORCL al nuevo directorio raíz de Oracle después de realizar las comprobaciones de requisitos y ejecutar la operación de movimiento en paralelo.

Ejemplo 25: Rollback de una operación de movimiento y omisión de PDB cerradas

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname DEVDB --rollback --skipClosedPDBs

Realiza un rollback de la operación de movimiento para la base de datos DEVDB, omitiendo cualquier PDB cerrada.

Ejemplo 26: Movimiento de la Base de Datos con Tiempo de Inactividad Específico y Ejecución en Paralelo

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname FINDB --allowParallelDBMove --continueWithDbDowntime

Mueve la base de datos FINDB al directorio raíz de Oracle especificado al tiempo que permite el tiempo de inactividad de la base de datos y la ejecución en paralelo para acelerar el proceso.

Ejemplo 27: Comprobación de los requisitos previos del movimiento de base de datos sin ejecutar el movimiento

dbaascli database move --oracleHome /u01/app/oracle/product/19.0.0/dbhome_1 --dbname HRDB --executePrereqs

Ejecuta comprobaciones de requisitos para validar que la base de datos HRDB se puede mover al directorio raíz de Oracle especificado sin ejecutar el propio movimiento.

Ejemplo 28: movimiento de base de datos y ejecución del comando en segundo plano en nodos específicos

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_3 --dbname PRODDB --waitForCompletion false --nodeList node1,node4

Mueve la base de datos PRODDB a un nuevo directorio raíz de Oracle, ejecutando la operación en segundo plano y aplicándola solo en node1 y node4.

Ejemplo 29: Combinación de Comprobaciones de Requisitos, Omisión de PDB Cerradas y Permiso de Ejecución Paralela

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_2 --dbname CRMDB --executePrereqs --skipClosedPDBs --allowParallelDBMove

Realiza comprobaciones de requisitos antes de mover la base de datos CRMDB al nuevo directorio raíz de Oracle, omite la aplicación de parches a PDB cerradas y permite que la operación se ejecute en paralelo para una ejecución más rápida.

Ejemplo 30: Movimiento de Base de Datos con Rollback en un ID de Sesión Específico y Omisión de Datapatch

dbaascli database move --oracleHomeName DB_HOME_NAME --dbname DEVDB --rollback --sessionID 45678 --skipDatapatch

Realiza un rollback de una operación de movimiento ejecutada anteriormente para la base de datos DEVDB en su directorio raíz de Oracle anterior mediante el ID de sesión 45678, omitiendo el proceso de parche de datos durante el rollback.

Ejemplo 31: Movimiento de Base de Datos con Permitir Ejecución en Paralelo y Especificación de Omisión de Parche de Datos para PDB

dbaascli database move --oracleHome /u02/app/oracle/product/19.0.0/dbhome_3 --dbname ANALYTICDB --allowParallelDBMove --skipPDBs pdb2,pdb4

Mueve la base de datos ANALYTICDB en paralelo al directorio raíz de Oracle especificado y omite el proceso de parche de datos para pdb2 y pdb4.

Varios

P: ¿Cómo puedo omitir la ejecución de catbundle al aplicar parches a Oracle Database 11.2.0.4.0?

R: Para omitir la ejecución de catbundle durante el proceso de aplicación de parches de Oracle Database, utilice la opción --skipDatapatch con el comando dbaascli database move o dbaascli dbHome patch.

P: ¿Cuáles son las mejores prácticas que se deben seguir durante la aplicación de parches en Oracle Database?

R: Oracle recomienda realizar la aplicación de parches externa mediante el comando dbaascli database move para minimizar la ventana de aplicación de parches.

Oracle recomienda utilizar la opción --allowParallelDBMove para activar la aplicación de parches en paralelo, lo que puede acelerar el proceso.

P: ¿Se pueden ignorar las advertencias informadas durante los requisitos de parches de Oracle Database?

R: Se recomienda abordar y resolver las advertencias informadas durante la comprobación de requisitos antes de continuar con el proceso de aplicación de parches. Ignorar las advertencias puede generar problemas durante la aplicación de parches real.

P: ¿Cómo puedo continuar con la aplicación de parches de Oracle Database si solo hay una instancia de base de datos activa y en ejecución?

R: Se recomienda tener al menos dos instancias en ejecución para evitar el tiempo de inactividad de la base de datos. Si no es posible ejecutar dos instancias, puede utilizar la opción --continueWithDbDowntime con el comando dbaascli database move o dbaascli dbHome patch para continuar con la aplicación de parches a pesar del tiempo de inactividad.

P: En un entorno de Data Guard, ¿se ejecuta datapatch en las bases de datos primaria y en espera?

R: No, en un entorno de Data Guard, el parche de datos se ejecuta solo como parte del proceso de aplicación de parches de la base de datos primaria.

P: ¿Se pueden aplicar manualmente actualizaciones de software provisionales (parches puntuales) o parches individuales en directorios raíz de Oracle en entornos de Exadata Cloud@Customer (ExaDB-C@C)?

R: Sí, los parches puntuales o los parches individuales se pueden aplicar manualmente a los directorios raíz de Oracle en entornos ExaDB-C@C. Sin embargo, se recomienda utilizar la opción Imagen de Software de Oracle Database para un proceso de aplicación de parches más optimizado y soportado.

P: ¿Cómo puedo aplicar parches a varias bases de datos Oracle que se ejecutan desde el mismo directorio raíz de Oracle cuando cada base de datos se ejecuta en un solo nodo?

R: Utilice el comando dbaascli dbHome patch para aplicar parches en el directorio raíz de Oracle especificado, que aplicará el parche a todas las bases de datos que se ejecuten desde ese directorio raíz. Se recomienda tener varias instancias en ejecución para evitar el tiempo de inactividad. Si no es posible ejecutar varias instancias, puede utilizar la opción --continueWithDbDowntime para continuar con la aplicación de parches a pesar del tiempo de inactividad.

Gestión de bases de datos conectables (PDB)

En esta sección se trata la gestión de bases de datos conectables (PDB) dentro de una base de datos de contenedor (CDB). Incluye comandos para crear (dbaascli pdb create), suprimir (dbaascli pdb delete) y clonar PDB (dbaascli pdb localClone, dbaascli pdb remoteClone). Puede gestionar estados de PDB con comandos para abrir, cerrar o reiniciar PDB y recuperar los detalles de conexión (dbaascli pdb getConnectString). Los comandos adicionales soportan la copia de seguridad, la recuperación y la reubicación de PDB, lo que garantiza un control completo del ciclo de vida y las operaciones de la PDB.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli pdb backup?

R: El comando dbaascli pdb backup se utiliza para crear copias de seguridad para una base de datos conectable (PDB), consultar el estado de la copia de seguridad, generar informes de copia de seguridad y suprimir copias de seguridad de PDB en un entorno de Exadata Cloud@Customer.

P: ¿Cuál es el requisito previo para utilizar el comando dbaascli pdb backup?

R: El comando se debe ejecutar como usuario root y debe estar conectado a una máquina virtual de Exadata Cloud@Customer.

P: ¿Cómo puedo iniciar una copia de seguridad de PDB mediante el comando dbaascli PDB backup?

R: Puede iniciar una copia de seguridad de PDB mediante la opción --start. Por ejemplo:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start

P: ¿Qué opciones se pueden utilizar con el indicador --start?

R: Con el indicador --start, puede especificar:

--level1 para una copia de seguridad incremental de nivel 1

--archival para una copia de seguridad de archivado completa (que también necesita --tag para especificar la etiqueta de copia de seguridad)

P: ¿Cómo puedo crear una copia de seguridad incremental de PDB de nivel 1?

R: Utilice el indicador --level1 con la opción --start para crear una copia de seguridad incremental de nivel 1:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --level1

P: ¿Cómo puedo crear una copia de seguridad de PDB de archivado?

A: utilice el indicador --archival con la opción --start y especifique una etiqueta de copia de seguridad mediante --tag:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --archival --tag <backup_tag>

P: ¿Cómo puedo suprimir una copia de seguridad de PDB específica?

R: Para suprimir una copia de seguridad específica, utilice el indicador --delete y especifique la etiqueta de copia de seguridad mediante --backupTag:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --delete --backupTag <backup_tag>

P: ¿Cómo puedo comprobar el estado de una copia de seguridad de PDB?

R: Utilice el indicador --status junto con la copia de seguridad --uuid para comprobar el estado de una copia de seguridad específica:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --status --uuid <backup_uuid>

P: ¿Cómo recupero un informe de copia de seguridad de PDB en formato JSON?

R: Para obtener un informe de copia de seguridad en formato JSON, utilice la opción --getBackupReport, especifique el nombre del archivo con --json y proporcione la etiqueta de copia de seguridad con --tag:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --getBackupReport --json <file_name> --tag <backup_tag>

P: ¿Cómo puedo mostrar todas las copias de seguridad de PDB para una PDB específica?

R: Utilice la opción --list para obtener una lista de todas las copias de seguridad de una PDB determinada:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list

Opcionalmente, puede mostrar la lista en formato JSON mediante el indicador --json:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list --json <file_name>

P: ¿Qué hace la opción --pdbName?

R: la opción --pdbName especifica el nombre de la base de datos conectable (PDB) para la que desea realizar una copia de seguridad, consultar o suprimir copias de seguridad.

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

R: la opción --dbname especifica el nombre de la base de datos Oracle Database a la que pertenece la PDB.

P: ¿Cómo especifico una etiqueta de copia de seguridad para una copia de seguridad de PDB?

R: Especifique una etiqueta de copia de seguridad mediante la opción --tag al iniciar una copia de seguridad de archivado o al recuperar un informe de copia de seguridad:

--tag <backup_tag>

P: ¿Puedo ejecutar copias de seguridad de PDB en modo JSON?

R: Sí, tanto el informe de copia de seguridad (--getBackupReport) como la lista de copias de seguridad (--list) soportan la salida en formato JSON. Especifique un nombre de archivo JSON mediante la opción --json.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli pdb bounce?

R: El comando dbaascli pdb bounce se utiliza para reiniciar (reiniciar) una base de datos conectable (PDB) en un entorno de Exadata Cloud@Customer.

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli pdb bounce?

R: El comando se debe ejecutar como usuario oracle y debe estar conectado a una máquina virtual de Exadata Cloud@Customer.

P: ¿Cómo puedo devolver una PDB especificando su nombre?

R: Para reiniciar una PDB especificando su nombre, utilice la siguiente sintaxis:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name>

P: ¿Cómo puedo devolver una PDB mediante el identificador único (UID)?

R: Para reiniciar una PDB con su identificador único (UID), utilice la siguiente sintaxis:

dbaascli pdb bounce --dbname <CDB_Name> --pdbUID <PDB_UID>

P: ¿Para qué se utiliza la opción --dbname?

R: la opción --dbname especifica el nombre de la base de datos de contenedores (CDB) que aloja la base de datos conectable (PDB) que se va a devolver.

P: ¿Para qué se utiliza la opción --pdbName?

R: la opción --pdbName especifica el nombre de la base de datos conectable (PDB) que desea reiniciar.

P: ¿Para qué se utiliza la opción --pdbUID?

R: la opción --pdbUID especifica el identificador único (UID) de la base de datos conectable (PDB) que desea devolver.

P: ¿Cómo puedo especificar el modo de apertura de destino para la PDB al devolverla?

R: Puede utilizar la opción --openMode para especificar el modo abierto deseado para la PDB después del reinicio. Los valores válidos son READ_WRITE y READ_ONLY. Por ejemplo:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE

P: ¿Puedo abrir la PDB en modo de solo lectura después de devolverla?

R: Sí, puede utilizar la opción --openMode READ_ONLY para abrir la PDB en modo de solo lectura después del reinicio:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_ONLY

P: ¿Cuál es el modo de apertura predeterminado si no se especifica --openMode?

R: Si no se especifica --openMode, la PDB se abrirá en su modo abierto por defecto, que suele ser READ_WRITE.

P: ¿Puedo utilizar --pdbName y --pdbUID en el mismo comando?

R: No, debe especificar --pdbName o --pdbUID, pero no ambos en el mismo comando.

P: ¿Cómo puedo reiniciar una PDB y asegurarme de que se abre en modo de lectura-escritura?

R: Para reiniciar una PDB y asegurarse de que se abre en modo de lectura-escritura, utilice la opción --openMode READ_WRITE:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE

P: ¿Es obligatorio especificar el modo abierto al utilizar el comando dbaascli pdb bounce?

R: No, la especificación de --openMode es opcional. Si no se proporciona, la PDB se abrirá en su modo por defecto.

P: ¿Qué sucede si no especifico el indicador --openMode?

R: Si no se especifica el indicador --openMode, la PDB se abrirá en su modo por defecto, que suele ser READ_WRITE.

Ejemplo 7-31 dbaascli pdb bounce

dbaascli pdb bounce --dbname cdb_name --pdbName pdb name associated with the CDB
dbaascli pdb bounce --dbname cdb_name --pdbUID con_uid of that pdb
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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli pdb close?

R: El comando dbaascli pdb close se utiliza para cerrar una base de datos conectable (PDB) en un entorno de Exadata Cloud@Customer.

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli pdb close?

R: El comando se debe ejecutar como usuario oracle y debe estar conectado a una máquina virtual de Exadata Cloud@Customer.

P: ¿Cómo puedo cerrar una PDB especificando su nombre?

R: Para cerrar una PDB especificando su nombre, utilice la siguiente sintaxis:

dbaascli pdb close --dbname <CDB_Name> --pdbName <PDB_Name>

P: ¿Cómo puedo cerrar una PDB especificando su identificador único (UID)?

R: Para cerrar una PDB con su identificador único (UID), utilice la siguiente sintaxis:

dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>

P: ¿Qué hace la opción --dbname en el comando dbaascli pdb close?

R: la opción --dbname especifica el nombre de la base de datos de contenedores (CDB) que aloja la base de datos conectable (PDB) que desea cerrar.

P: ¿Qué hace la opción --pdbName en el comando dbaascli pdb close?

R: la opción --pdbName especifica el nombre de la base de datos de conexión (PDB) que desea cerrar.

P: ¿Cuál es la finalidad de la opción --pdbUID en el comando dbaascli pdb close?

R: La opción --pdbUID permite especificar el identificador único (UID) de la base de datos conectable (PDB) que desea cerrar.

P: ¿Puedo cerrar la PDB en una instancia específica de la CDB?

R: No, una vez completada correctamente, la PDB se cierra en todas las instancias de la base de datos de contenedores (CDB).

P: ¿Es posible especificar --pdbName y --pdbUID en el mismo comando?

R: No, puede especificar --pdbName o --pdbUID, pero no ambos en el mismo comando.

P: ¿Qué sucede cuando el comando dbaascli pdb close se completa correctamente?

R: Cuando el comando se completa correctamente, la base de datos conectable (PDB) se cierra en todas las instancias de la base de datos de contenedores (CDB).

P: ¿Cómo puedo cerrar una PDB específica en una CDB mediante su UID?

R: Puede cerrar una PDB específica mediante su UID ejecutando:

dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>

P: ¿Qué sucede si olvido especificar --pdbName o --pdbUID?

R: Debe especificar --pdbName o --pdbUID en el comando. Si no se proporciona ninguno, el comando no se ejecutará.

P: ¿Puedo utilizar el comando dbaascli pdb close para una CDB directamente?

R: No, el comando está diseñado para cerrar una base de datos de conexión (PDB) dentro de una base de datos de contenedor (CDB), no la propia CDB.

Ejemplo 7-32 dbaascli pdb close

dbaascli pdb close --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb close --dbname cdb name --pdbUID con_uid of that pdb
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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli pdb create?

R: El comando dbaascli pdb create se utiliza para crear una nueva base de datos conectable (PDB) en una base de datos de contenedores (CDB) en un entorno de Exadata Cloud@Customer.

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli pdb create?

R: El comando se debe ejecutar como usuario oracle y debe estar conectado a una máquina virtual de Exadata Cloud@Customer.

P: ¿Qué hace la opción --pdbName en el comando dbaascli pdb create?

R: la opción --pdbName especifica el nombre de la nueva base de datos de conexión (PDB) que desea crear.

P: ¿Qué hace la opción --dbName en el comando dbaascli pdb create?

R: la opción --dbName especifica el nombre de la base de datos de contenedores (CDB) que alojará la nueva base de datos conectable (PDB).

P: ¿Puedo limitar los recursos de CPU para la nueva PDB?

R: Sí, puede utilizar la opción --maxCPU para especificar el número máximo de CPU que puede utilizar la PDB. Esto es equivalente a definir el parámetro CPU_COUNT en la PDB.

P: ¿Cómo puedo limitar el tamaño de almacenamiento de una PDB?

R: Puede utilizar la opción --maxSize para especificar el tamaño total máximo de archivos de datos y archivos temporales para la PDB. Puede definir un límite de tamaño (en K, M, G o T) o especificar UNLIMITED para que no haya límite.

P: ¿Para qué se utiliza la opción --pdbAdminUserName?

R: la opción --pdbAdminUserName especifica el nombre del usuario administrador para la nueva PDB. Este usuario tendrá privilegios administrativos en la PDB.

P: ¿Es posible bloquear la cuenta de usuario administrador durante la creación de la PDB?

R: Sí, puede utilizar la opción --lockPDBAdminAccount para especificar si se debe bloquear la cuenta de administrador de PDB. El valor predeterminado es true (bloqueado).

P: ¿Qué hace la opción --resume en el comando dbaascli pdb create?

R: La opción --resume permite reanudar un proceso de creación de PDB con fallos anteriores.

P: ¿Cómo puedo especificar un ID de sesión para reanudar una ejecución anterior?

R: Puede especificar un ID de sesión mediante la opción --sessionID para reanudar una sesión específica del proceso de creación de PDB.

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

R: la opción --executePrereqs especifica si se deben ejecutar solo las comprobaciones de requisitos para la creación de PDB. Puede definir esta opción en yes o no.

P: ¿Puedo ejecutar el proceso de creación de PDB en segundo plano?

R: Sí, puede utilizar la opción --waitForCompletion y definirla en false para ejecutar la operación en segundo plano.

P: ¿Para qué se utiliza la opción --standbyBlobFromPrimary?

R: la opción --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. Es necesario para las operaciones de PDB de base de datos en espera.

P: ¿Cómo se me solicitará la contraseña de administrador de PDB durante el proceso de creación?

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

P: ¿Puedo crear una PDB en espera mediante el comando dbaascli PDB create?

R: Sí. Si está creando una PDB en espera, puede utilizar la opción --standbyBlobFromPrimary para especificar la ubicación del archivo blob en espera de la base de datos primaria.

P: ¿Qué sucede si no utilizo la opción --maxSize?

R: Si no especifica la opción --maxSize, la PDB no tendrá un límite de tamaño de almacenamiento a menos que las políticas de CDB definan lo contrario.

P: ¿Qué sucede si no proporciono la opción --pdbAdminUserName?

R: Si no proporciona la opción --pdbAdminUserName, la PDB se creará sin un usuario administrador especificado y deberá configurar manualmente el usuario administrador después de la creación.

P: ¿Puedo reanudar una creación de PDB fallida en cualquier momento del proceso?

R: Sí, siempre que no se haya terminado la sesión, puede reanudar una creación de PDB fallida mediante las opciones --resume y --sessionID.

Ejemplo 7-33 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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli pdb delete?

R: El comando dbaascli pdb delete se utiliza para suprimir una base de datos conectable (PDB) de una base de datos de contenedores (CDB) en un entorno de Exadata Cloud@Customer.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli pdb delete?

R: El comando se debe ejecutar como usuario oracle y debe estar conectado a una máquina virtual de Exadata Cloud@Customer.

P: ¿Qué especifica la opción --dbName en el comando dbaascli pdb delete?

R: la opción --dbName especifica el nombre de la base de datos de contenedores (CDB) que aloja la PDB que desea suprimir.

P: ¿Cómo puedo especificar qué PDB suprimir mediante el comando dbaascli PDB delete?

R: Puede especificar la PDB que desea suprimir mediante la opción --pdbName (especifica el nombre de la PDB) o la opción --pdbUID (especifica el UID de la PDB).

P: ¿Puedo ejecutar las comprobaciones de requisitos sin suprimir realmente la PDB?

R: Sí, puede utilizar la opción --executePrereqs y definirla en yes para ejecutar solo las comprobaciones de requisitos para la operación de supresión de PDB.

P: ¿Cómo puedo ejecutar el proceso de supresión de PDB en segundo plano?

R: Utilice la opción --waitForCompletion y defínala en false para ejecutar el proceso de supresión en segundo plano.

P: ¿Qué hace la opción --resume en el comando dbaascli pdb delete?

R: La opción --resume permite reanudar un proceso de supresión de PDB con fallos anteriores.

P: ¿Cómo puedo reanudar una sesión específica para una supresión de PDB?

R: Puede especificar un ID de sesión mediante la opción --sessionID para reanudar una sesión específica para el proceso de supresión de PDB.

P: ¿Qué hace la opción --allStandbyPrepared?

R: La opción --allStandbyPrepared se utiliza para confirmar que la operación de supresión se ha ejecutado correctamente en todas las bases de datos en espera antes de continuar con la supresión de la PDB principal.

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

R: la opción --cleanupRelocatedPDB limpia la base de datos de origen después de que se haya reubicado una PDB, lo que garantiza que no quede ningún residuo después de la reubicación.

P: ¿Puedo suprimir una PDB que ya se ha reubicado?

R: Sí, puede utilizar la opción --cleanupRelocatedPDB para suprimir una PDB que ya se ha reubicado en una nueva CDB.

P: ¿Cómo puedo asegurarme de que la operación de supresión se ejecuta correctamente en las bases de datos en espera?

R: Utilice la opción --allStandbyPrepared para confirmar que la operación se ha ejecutado correctamente en todas las bases de datos en espera antes de continuar.

P: ¿Qué sucede si el proceso de eliminación falla y se debe reanudar?

R: Puede reanudar el proceso de supresión mediante la opción --resume y, si es necesario, especifique el ID de sesión con --sessionID.

P: ¿Qué hace establecer --waitForCompletion en falso?

R: La configuración de --waitForCompletion en false permite que el proceso de supresión se ejecute en segundo plano, lo que le permite seguir trabajando sin esperar a que finalice la operación.

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 getConnectString

Para mostrar la información de la cadena de conexión de Oracle Net de 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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli pdb getConnectString?

R: El comando dbaascli pdb getConnectString se utiliza para mostrar la información de la cadena de conexión de Oracle Net de una base de datos conectable (PDB) en un entorno de Exadata Cloud@Customer.

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli pdb getConnectString?

R: El comando se debe ejecutar como usuario oracle y debe estar conectado a una máquina virtual de Exadata Cloud@Customer.

P: ¿Cómo recupero la cadena de conexión de una PDB especificando su nombre?

R: Para recuperar la cadena de conexión especificando el nombre de la PDB, utilice la siguiente sintaxis:

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbName <PDB_Name>

P: ¿Cómo recupero la cadena de conexión de una PDB especificando su identificador único (UID)?

R: Para recuperar la cadena de conexión mediante el identificador único (UID) de la PDB, utilice la siguiente sintaxis:

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>

P: ¿Qué hace la opción --dbname en el comando dbaascli pdb getConnectString?

R: la opción --dbname especifica el nombre de la base de datos de contenedores (CDB) que aloja la base de datos de conexión (PDB) para la que desea mostrar la información de la cadena de conexión.

P: ¿Qué hace la opción --pdbName en el comando dbaascli pdb getConnectString?

R: la opción --pdbName especifica el nombre de la base de datos conectable (PDB) para la que desea recuperar la información de cadena de conexión de Red de Oracle.

P: ¿Cuál es la finalidad de la opción --pdbUID en el comando dbaascli pdb getConnectString?

R: La opción --pdbUID permite especificar el identificador único (UID) de la base de datos conectable (PDB) para la que desea mostrar la cadena de conexión.

P: ¿Puedo utilizar --pdbName y --pdbUID en el mismo comando?

R: No, puede utilizar --pdbName o --pdbUID, pero no ambos en el mismo comando.

P: ¿Qué tipo de información devuelve el comando dbaascli pdb getConnectString?

R: El comando devuelve la información de cadena de conexión de Red de Oracle para la base de datos conectable (PDB) especificada.

P: ¿Puedo recuperar la cadena de conexión para una PDB en una instancia de base de datos de contenedores específica?

R: No, la cadena de conexión es para la PDB en su conjunto, no para una instancia específica de la base de datos de contenedores.

P: ¿Cómo puedo obtener la información de la cadena de conexión si solo conozco el identificador único (UID) de la PDB?

R: Puede recuperar la cadena de conexión mediante el UID de la PDB ejecutando:

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>

P: ¿Qué sucede si no proporciono --pdbName o --pdbUID?

R: Debe especificar --pdbName o --pdbUID para recuperar la cadena de conexión. El comando no se ejecutará sin una de estas opciones.

P: ¿La información de la cadena de conexión para la PDB es siempre la misma en todas las instancias de la CDB?

R: Sí, la información de la cadena de conexión es consistente para la PDB en todas las instancias de la base de datos de contenedor (CDB).

Ejemplo 7-34 dbaascli pdb getConnectString

dbaascli pdb getConnectString --dbname dbname --pdbName pdbName
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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli pdb getDetails?

R: El comando dbaascli pdb getDetails se utiliza para ver los detalles de una base de datos conectable (PDB) alojada en una base de datos de contenedores (CDB) en un entorno de Exadata Cloud@Customer.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli pdb getDetails?

R: El comando se debe ejecutar como usuario oracle y debe estar conectado a una máquina virtual de Exadata Cloud@Customer.

P: ¿Qué especifica la opción --dbname en el comando dbaascli pdb getDetails?

R: la opción --dbname especifica el nombre de la base de datos de contenedores (CDB) que aloja la PDB para la que desea ver los detalles.

P: ¿Cómo especifica la PDB para la que desea ver los detalles?

R: Puede especificar la PDB mediante la opción --pdbName (para proporcionar el nombre de la PDB) o la opción --pdbUID (para proporcionar el UID de la PDB).

P: ¿Cuál es la diferencia entre --pdbName y --pdbUID?

R: La opción --pdbName utiliza el nombre de la PDB para recuperar detalles, mientras que la opción --pdbUID utiliza el identificador único (UID) de la PDB para recuperar sus detalles.

P: ¿Puedo utilizar tanto --pdbName como --pdbUID juntos en el comando dbaascli pdb getDetails?

R: No, puede especificar la opción --pdbName o --pdbUID para obtener detalles de la PDB, pero no ambos al mismo tiempo.

P: ¿Cuáles son algunos casos de uso del comando dbaascli pdb getDetails?

R: Puede utilizar el comando dbaascli pdb getDetails para:
  • Recuperar detalles sobre una PDB específica en una CDB.
  • Verifique la configuración de una PDB.
  • Compruebe el estado de una PDB en una CDB.

P: ¿Cómo puedo ver los detalles de una PDB en función de su nombre?

R: Para ver los detalles de una PDB según su nombre, utilice la siguiente sintaxis:

dbaascli pdb getDetails --dbname <CDB_Name> --pdbName <PDB_Name>

P: ¿Cómo puedo ver los detalles de una PDB en función de su UID?

R: Para ver los detalles de una PDB según su UID, utilice la siguiente sintaxis:

dbaascli pdb getDetails --dbname <CDB_Name> --pdbUID <PDB_UID>

P: ¿Se puede utilizar este comando para varias PDB en una sola ejecución?

R: No, el comando se puede utilizar para recuperar detalles de una PDB a la vez especificando su nombre o UID.

Ejemplo 7-35 dbaascli pdb getDetails

dbaascli pdb getDetails--dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb getDetails--dbname cdb name --pdbUID con_uid of that pdb
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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli pdb list?

R: El comando dbaascli pdb list se utiliza para ver la lista de bases de datos conectables (PDB) en una base de datos de contenedor (CDB) especificada en un entorno de Exadata Cloud@Customer.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli pdb list?

R: El comando se debe ejecutar como usuario oracle y debe estar conectado a una máquina virtual de Exadata Cloud@Customer.

P: ¿Qué especifica la opción --dbname en el comando dbaascli pdb list?

R: la opción --dbname especifica el nombre de la base de datos de contenedor (CDB) que aloja las bases de datos de conexión (PDB) para las que desea ver la lista.

P: ¿Puedo ver la lista de PDB de varias bases de datos de contenedores a la vez?

R: No, el comando dbaascli pdb list permite mostrar las PDB solo de una base de datos de contenedores (CDB) a la vez, especificadas por la opción --dbname.

P: ¿Cómo enumero las PDB en una base de datos de contenedores (CDB) específica?

R: Puede mostrar las PDB en una CDB específica mediante la siguiente sintaxis:

dbaascli pdb list --dbname <CDB_Name>

P: ¿Qué información se muestra al utilizar el comando dbaascli pdb list?

R: El comando devuelve una lista de todas las bases de datos de conexión (PDB) dentro de la base de datos de contenedor (CDB) especificada. La lista suele incluir los nombres de las PDB y, posiblemente, otros detalles como su estado.

P: ¿Puedo filtrar la lista de PDB con opciones adicionales?

R: No, el comando dbaascli pdb list no admite opciones de filtrado adicionales. Simplemente devuelve la lista completa de PDB en la CDB especificada.

P: ¿Qué sucede si el --dbname especificado no existe o es incorrecto?

R: Si el --dbname especificado es incorrecto o no existe, el comando devolverá un error y no se mostrará ninguna lista de PDB.

P: ¿Se puede utilizar el comando dbaascli pdb list para cualquier entorno de base de datos Oracle?

R: No, el comando dbaascli pdb list está diseñado específicamente para su uso en entornos de Exadata Cloud@Customer.

Ejemplo 7-36 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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli pdb localClone?

R: El comando dbaascli pdb localClone se utiliza para crear una nueva base de datos conectable (PDB) como clon de una PDB existente en la misma base de datos de contenedores (CDB) en un entorno de Exadata Cloud@Customer.

P: ¿Cuáles son los requisitos para ejecutar el comando dbaascli pdb localClone?

R: El comando se debe ejecutar como usuario oracle y debe estar conectado a una máquina virtual de Exadata Cloud@Customer. Además, la PDB de origen ya debe existir en la CDB especificada.

P: ¿Qué especifica la opción --dbName en el comando dbaascli pdb localClone?

R: la opción --dbName especifica el nombre de la base de datos de contenedores (CDB) que aloja la PDB de origen desde la que se clonará la nueva PDB.

P: ¿Qué especifica la opción --pdbName en el comando dbaascli pdb localClone?

R: la opción --pdbName especifica el nombre de la nueva PDB que desea crear como clon de la PDB existente en la misma CDB.

P: ¿Puedo clonar una PDB con un nombre diferente mediante el comando dbaascli PDB localClone?

R: Sí, puede especificar un nombre diferente para la PDB clonada mediante la opción --targetPDBName. Si no se proporciona esta opción, la PDB clonada heredará el nombre de la PDB de origen.

P: ¿Qué hace la opción --resume en el comando dbaascli pdb localClone?

R: La opción --resume permite reanudar una operación de clonación de PDB interrumpida anteriormente.

P: ¿Cómo puedo limitar los recursos de CPU disponibles para la PDB clonada?

R: Puede limitar los recursos de CPU para la PDB clonada mediante la opción --maxCPU, que especifica el número máximo de CPU que se asignarán a la nueva PDB.

P: ¿Puedo ejecutar la operación de clonación de PDB en segundo plano?

R: Sí, puede ejecutar la operación en segundo plano definiendo la opción --waitForCompletion en false. Si lo define en true, la operación se ejecutará en primer plano y esperará a que se complete.

P: ¿Cuál es la finalidad de la opción --maxSize en el comando dbaascli pdb localClone?

R: la opción --maxSize especifica el tamaño máximo de almacenamiento (en GB) para la PDB recién clonada. Si no se especifica ningún tamaño, la PDB clonada hereda los mismos límites de almacenamiento que la PDB de origen.

P: ¿Puedo controlar el paralelismo de la operación de clonación de PDB?

R: Sí, puede controlar el grado de paralelismo de la operación de clonación mediante la opción --powerLimit. Esta opción acepta valores entre 1 y 128 para definir el grado de paralelismo.

P: ¿Para qué se utiliza la opción --primaryDBWalletTar?

R: La opción --primaryDBWalletTar especifica la ubicación del archivo tar de cartera de la base de datos principal. Esta opción solo es necesaria si la operación de clonación implica operaciones de PDB de base de datos en espera.

P: ¿Puedo ejecutar solo las comprobaciones de requisitos para la operación de clonación?

R: Sí, solo puede ejecutar las comprobaciones de requisitos mediante la opción --executePrereqs y definirla en yes. Los valores válidos son yes y no.

P: ¿Qué sucede si la operación de clonación de PDB falla o se interrumpe?

R: Si la operación de clonación falla o se interrumpe, puede reanudarla mediante la opción --resume para continuar desde donde se detuvo la operación.

Ejemplo 7-37 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.

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli pdb open?

R: El comando dbaascli pdb open se utiliza para abrir una base de datos conectable (PDB) en una base de datos de contenedores (CDB) de Oracle en un entorno de Exadata Cloud@Customer.

P: ¿Quién puede ejecutar el comando dbaascli pdb open?

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

P: ¿Qué especifica la opción --pdbName en el comando dbaascli pdb open?

R: la opción --pdbName especifica el nombre de la PDB que desea abrir.

P: ¿Qué especifica la opción --pdbUID en el comando dbaascli pdb open?

R: la opción --pdbUID especifica el identificador único (UID) de la PDB que desea abrir.

P: ¿Qué especifica la opción --dbname en el comando dbaascli pdb open?

R: la opción --dbname especifica el nombre de la base de datos de contenedores (CDB) que aloja la PDB.

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

R: la opción --openMode especifica el modo en el que se abrirá la PDB. Los valores válidos son READ_WRITE y READ_ONLY.

P: ¿Puedo iniciar servicios al abrir la PDB?

R: Sí, puede utilizar la opción --startServices para iniciar todos los servicios asociados a la PDB especificando todos o proporcionando una lista delimitada por comas de servicios específicos para iniciar.

P: ¿Qué sucede si configuro la opción --waitForCompletion en false?

R: Si --waitForCompletion se define en false, el comando se ejecutará en segundo plano y el usuario no tendrá que esperar a que finalice la operación. Si se define en true, el comando esperará a que se complete antes de salir.

P: ¿Qué hace la opción --setPDBRefreshModeNone?

R: La opción --setPDBRefreshModeNone convierte una PDB de refrescamiento (una que se actualiza regularmente desde una base de datos primaria) en una PDB no de refrescamiento.

P: ¿Cuál es la función de la opción --skipPDBRefresh?

R: La opción --skipPDBRefresh permite omitir la operación de refrescamiento al abrir una PDB de refrescamiento, lo que impide que la PDB se sincronice con la base de datos primaria en ese momento.

P: ¿Qué hace la opción --pdbAdminUserName en el comando dbaascli pdb open?

R: La opción --pdbAdminUserName permite especificar un nuevo nombre de usuario administrador de PDB al abrir la PDB.

P: ¿Qué sucede si el comando dbaascli pdb open es correcto?

R: Si se completa correctamente, la PDB especificada se abrirá en todas las instancias de la base de datos de contenedores (CDB).

P: ¿Es posible ejecutar el comando dbaascli PDB open para una PDB de refrescamiento?

R: Sí, el comando se puede utilizar para las PDB de refrescamiento. La opción --setPDBRefreshModeNone convierte la PDB en no actualizable y la opción --skipPDBRefresh omite la operación de refrescamiento durante el proceso de apertura.

P: ¿Cuál es el modo de apertura por defecto para una PDB si no se especifica --openMode?

R: Si no se especifica --openMode, la PDB normalmente se abre en modo READ_WRITE por defecto.

Ejemplo 7-38 dbaascli pdb open

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

Opcional: --openMode READ_WRITE/READ_ONLY

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>

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli pdb recover?

R: El comando dbaascli pdb recover se utiliza para recuperar una base de datos conectable (PDB) a un estado anterior mediante copias de seguridad almacenadas en un destino de almacenamiento de copia de seguridad configurado.

P: ¿Quién puede ejecutar el comando dbaascli pdb recover?

R: El comando se debe ejecutar como usuario root.

P: ¿Qué se necesita antes de ejecutar el comando dbaascli pdb recover?

R: Antes de ejecutar el comando, 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.

P: ¿Qué especifica la opción --pdbName en el comando dbaascli pdb recover?

R: la opción --pdbName especifica el nombre de la base de datos conectable (PDB) que desea recuperar.

P: ¿Qué especifica la opción --dbname en el comando dbaascli pdb recover?

R: la opción --dbname especifica el nombre de la base de datos de contenedores (CDB) que aloja la PDB.

P: ¿Cuáles son las opciones posibles para iniciar una recuperación de PDB mediante la opción --start?

R: Puede recuperar la PDB mediante una de las siguientes opciones:
  • --untilTime <value>: recupera la PDB hasta una hora especificada (formato: DD-MON-YYYY HH24:MI).
  • --untilSCN <value>: recupera la PDB hasta un número de cambio del sistema (SCN) especificado.
  • --latest: recupera la PDB al último estado conocido.
  • --tag <value>: recupera la PDB a una etiqueta de archivo específica.

P: ¿Cuál es el formato necesario para especificar la hora en la opción --untilTime?

R: La hora debe tener el formato DD-MON-YYYY HH24:MI:SS.

P: ¿Cómo puedo recuperar una PDB al último estado mediante dbaascli PDB recover?

R: Para recuperar la PDB al último estado conocido, utilice la opción --latest:

dbaascli pdb recover --pdbName <value> --dbname <value> --start --latest

P: ¿Cómo recupero una PDB en una etiqueta de archivado específica?

R: Puede recuperar la PDB en una etiqueta específica mediante la opción --tag:

dbaascli pdb recover --pdbName <value> --dbname <value> --start --tag <tag_value>

P: ¿Puedo recuperar una PDB mediante un SCN específico?

R: Sí, puede recuperar la PDB en un SCN específico mediante la opción --untilSCN:

dbaascli pdb recover --pdbName <value> --dbname <value> --start --untilSCN <SCN_value>

P: ¿Qué hace la opción --status en el comando dbaascli pdb recover?

R: La opción --status se utiliza para comprobar el estado de una operación de recuperación. Debe proporcionar --uuid para especificar la sesión de recuperación.

P: ¿Cómo puedo comprobar el estado de una recuperación de PDB?

R: Para comprobar el estado de una operación de recuperación, utilice la opción --status con --uuid de la sesión de recuperación:

dbaascli pdb recover --pdbName <value> --dbname <value> --status --uuid <uuid_value>

P: ¿Qué sucede si especifico la opción --latest en el comando de recuperación?

R: Si especifica la opción --latest, la PDB se recuperará al estado más reciente disponible en la copia de seguridad.

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

Preguntas frecuentes

P: ¿Cuál es la finalidad del comando dbaascli pdb refresh?

R: El comando dbaascli pdb refresh se utiliza para refrescar una base de datos conectable (PDB) especificada en una base de datos de contenedores (CDB).

P: ¿Quién puede ejecutar el comando dbaascli pdb refresh?

R: El comando puede ejecutarlo el usuario root o oracle.

P: ¿Qué especifica la opción --dbname en el comando dbaascli pdb refresh?

R: la opción --dbname especifica el nombre de la base de datos de contenedores (CDB) que aloja la base de datos de conexión (PDB) que se va a refrescar.

P: ¿Qué especifica la opción --pdbName en el comando dbaascli pdb refresh?

R: la opción --pdbName especifica el nombre de la base de datos de conexión (PDB) que desea refrescar.

P: ¿Qué especifica la opción --pdbUID en el comando dbaascli pdb refresh?

R: la opción --pdbUID especifica el identificador único (UID) de la base de datos conectable (PDB) que desea refrescar.

P: ¿Qué hace la opción --waitForCompletion en el comando dbaascli pdb refresh?

R: la opción --waitForCompletion especifica si la operación se debe ejecutar en primer plano o en segundo plano. Si se define en true, la operación se ejecutará en primer plano y esperará a que se complete. Si se define en false, la operación se ejecutará en segundo plano.

P: ¿Cómo puedo refrescar una PDB y ejecutar la operación en segundo plano?

R: Para refrescar una PDB y ejecutar la operación en segundo plano, utilice la opción --waitForCompletion false:

dbaascli pdb refresh --dbname <value> --pdbName <value> --waitForCompletion false

P: ¿Cómo puedo refrescar una PDB mediante su identificador único (UID)?

R: Puede refrescar la PDB mediante la opción --pdbUID:

dbaascli pdb refresh --dbname <value> --pdbUID <value>

P: ¿Puedo especificar --pdbName y --pdbUID juntos en el comando dbaascli pdb refresh?

R: No, debe especificar --pdbName o --pdbUID, pero no ambos, al refrescar una PDB.

P: ¿Qué sucede si no incluyo la opción --waitForCompletion en el comando?

R: Si no especifica la opción --waitForCompletion, el comportamiento por defecto será esperar a que se complete la operación antes de devolver el control al usuario.

P: ¿Puedo refrescar una PDB mientras se está ejecutando la base de datos?

R: Sí, puede refrescar una PDB mientras se ejecuta la base de datos, siempre que el comando lo ejecute un usuario con los privilegios adecuados.

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.

Preguntas frecuentes

P: ¿Para qué se utiliza el comando dbaascli pdb remoteClone?

R: El comando dbaascli pdb remoteClone se utiliza para crear una nueva base de datos conectable (PDB) como clon de una PDB existente en otra base de datos de contenedores (CDB).

P: ¿Qué usuario debe ejecutar el comando dbaascli pdb remoteClone?

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

P: ¿Qué se necesita cuando se le solicita durante la operación dbaascli pdb remoteClone?

R: Debe proporcionar la contraseña de usuario SYS para la PDB origen.

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

R: El parámetro --pdbName especifica el nombre de la PDB de origen que desea clonar.

P: ¿Qué representa el parámetro --dbName?

R: El parámetro --dbName representa el nombre (DB_NAME) de la CDB que alojará la PDB recién clonada.

P: ¿Cómo se debe formatear el --sourceDBConnectionString?

R: El formato de --sourceDBConnectionString debe ser <scan_name>:<scan_port>/<database_service_name>.

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

R: el parámetro --targetPDBName especifica el nombre de la PDB recién clonada.

P: ¿Qué controla --powerLimit?

R: El parámetro --powerLimit controla el grado de paralelismo utilizado para la operación de clonación. El valor válido está entre 1 y 128.

P: ¿Qué define el parámetro --maxCPU?

R: El parámetro --maxCPU define el número máximo de CPU que se asignarán para el proceso de clonación de PDB.

P: ¿Cuál es la función de --maxSize?

R: El parámetro --maxSize especifica el tamaño máximo de almacenamiento en GB para la nueva PDB.

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

R: el parámetro --resume reanuda la operación de clonación anterior.

P: ¿Qué debe proporcionar con la opción --resume?

R: Puede especificar un --sessionID para reanudar una sesión específica si está reanudando una operación anterior.

P: ¿Qué controla --executePrereqs?

R: El parámetro --executePrereqs determina si solo se deben ejecutar los requisitos para la operación de clonación. Los valores válidos son yes o no.

P: ¿Cómo afecta --waitForCompletion a la operación?

R: El parámetro --waitForCompletion especifica si se debe esperar a que finalice la operación o si se debe ejecutar en segundo plano. Los valores válidos son true o false.

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

R: El parámetro --sourcePDBExportedTDEKeyFile especifica el archivo de clave exportado de la PDB de origen. Este parámetro solo es aplicable a Oracle Database versión 12.1.

P: ¿Qué define el parámetro --blobLocation?

R: El parámetro --blobLocation especifica la ruta de acceso personalizada en la que se generará el archivo BLOB en espera en un entorno de Data Guard.

P: ¿Cuándo se utiliza --standbyBlobFromPrimary?

R: El parámetro --standbyBlobFromPrimary especifica la ubicación del archivo BLOB en espera preparado a partir de la base de datos principal. Solo es necesario para operaciones de PDB de base de datos en espera.

P: ¿Se pueden utilizar --blobLocation y --standbyBlobFromPrimary juntos?

R: No, --blobLocation y --standbyBlobFromPrimary se excluyen mutuamente y no se pueden utilizar juntos.

P: ¿Qué hace la opción --excludeUserTablespaces?

R: La opción --excludeUserTablespaces permite omitir la clonación de tablespaces de usuario específicos. Por ejemplo, t1,t2,t3.

P: ¿Cuál es el efecto de --excludePDBData?

R: la opción --excludePDBData especifica si se deben omitir los datos de usuario de la PDB de origen durante la clonación. Los valores válidos son true o yes.

P: ¿Qué especifica --pdbAdminUserName?

R: El parámetro --pdbAdminUserName especifica el nuevo nombre de usuario administrador para la PDB clonada.

P: ¿Qué controla la opción --lockPDBAdminAccount?

R: la opción --lockPDBAdminAccount especifica si se debe bloquear la cuenta de usuario administrador de PDB. El valor por defecto es true.

P: ¿Qué especifica --sourcePDBServiceConvertList?

R: El parámetro --sourcePDBServiceConvertList especifica una lista delimitada por comas de conversiones de nombre de servicio de origen a destino. Por ejemplo, source_srv1:new_srv1,source_srv2:new_srv2.

P: ¿Cuál es el propósito de --refreshablePDB?

R: El parámetro --refreshablePDB especifica si se debe crear una PDB de refrescamiento.

P: ¿Qué controla --refreshMode?

R: El parámetro --refreshMode controla el modo de refrescamiento para una PDB de refrescamiento. Los valores válidos son AUTO o MANUAL.

P: ¿Cómo funciona --refreshIntervalInMinutes?

R: El parámetro --refreshIntervalInMinutes especifica el intervalo en minutos para refrescar la PDB de refrescamiento.

P: ¿Para qué se utiliza --dblinkUsername?

R: El parámetro --dblinkUsername especifica un 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.

P: ¿Qué indica la opción --honorCaseSensitiveUserName?

R: La opción --honorCaseSensitiveUserName indica que el nombre de usuario especificado es sensible a mayúsculas/minúsculas.

P: ¿Cuál es el efecto de --updateDBBlockCacheSize?

R: la opción --updateDBBlockCacheSize permite a la aplicación definir 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 un tamaño de bloque diferente.

P: ¿Qué debo hacer si encuentro un error con el comando dbaascli pdb remoteClone?

R: Revise el mensaje de error para obtener detalles, asegúrese de que todos los parámetros estén especificados correctamente y verifique que tiene los permisos y credenciales necesarios. Además, compruebe que las bases de datos de origen y destino cumplen todos los requisitos.

P: ¿Qué ocurre si olvido la contraseña de usuario SYS para la PDB de origen?

R: Tendrá que restablecer o recuperar la contraseña de usuario SYS para la PDB de origen. Sin ella, no se puede realizar la operación de clonación.

Ejemplo 7-40 dbaascli pdb remoteClone

dbaascli pdb remoteClone --sourceDBConnectionString test-can.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521 --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2
dbaascli pdb remoteClone --sourceDBConnectionString orcla.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2
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 especifica la ubicación de un directorio personalizado en el que se generará el archivo BLOB en espera en un entorno de Data Guard.
  • --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.
    Nota

    Los parámetros --blobLocation se excluyen mutuamente.
  • --upgradePDB especifica true para cambiar la versión de la PDB como parte de esta operación. Valores válidos : true | false.
  • Opción --updateDBBlockCachesize para permitir que la aplicación defina los parámetros de inicialización db block cache size para soportar la copia de datos con un tamaño de bloque diferente.
  • --skipOpenPDB: indica que la PDB no se debe abrir al final de la operación actual.
  • --completePDBRelocate: completa la reubicación de PDB si se realiza como una operación de dos pasos.

Preguntas frecuentes

P: ¿Para qué se utiliza el comando dbaascli pdb relocate?

R: El comando dbaascli pdb relocate se utiliza para reubicar una base de datos de conexión (PDB) de una base de datos remota a una base de datos local.

P: ¿Qué usuario debe ejecutar el comando dbaascli pdb relocate?

R: El comando se debe ejecutar como usuario Oracle.

P: ¿Qué se necesita cuando se le solicita durante la operación dbaascli pdb relocate?

R: Debe proporcionar la contraseña de usuario SYS para la base de datos origen.

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

R: El parámetro --pdbName especifica el nombre de la PDB de origen que se va a reubicar.

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

R: El parámetro --dbName especifica el nombre de la base de datos destino donde se reubicará la PDB.

P: ¿Cómo se debe formatear el --sourceDBConnectionString?

R: El formato de --sourceDBConnectionString debe ser <scan_name>:<scan_port>/<database_service_name>.

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

R: El parámetro --targetPDBName especifica un nuevo nombre para la PDB reubicada.

P: ¿Cuál es el uso de --powerLimit?

R: El parámetro --powerLimit especifica el grado de paralelismo que se utilizará durante la operación de reubicación.

P: ¿Cómo afecta --maxCpu al proceso de reubicación?

R: El parámetro --maxCpu especifica el número máximo de CPU que se van a asignar al proceso de reubicación de PDB.

P: ¿Qué define el parámetro --maxSize?

R: El parámetro --maxSize define el tamaño máximo de almacenamiento en GB para la nueva PDB.

P: ¿Cuál es la función de --resume?

R: El parámetro --resume indica que la operación de reubicación debe reanudarse desde donde se dejó.

P: ¿Qué debo proporcionar con la opción --resume?

R: Puede especificar un --sessionID para reanudar una sesión específica si está reanudando una operación anterior.

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

R: El parámetro --executePrereqs determina si solo se deben ejecutar los requisitos para la operación. Los valores válidos son sí o no.

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

R: El parámetro --sourcePDBServices especifica una lista de los servicios de PDB de origen delimitados por comas.

P: ¿Qué hace la lista de parámetros --sourcePDBReadOnlyServices?

R: El parámetro --sourcePDBReadOnlyServices muestra una lista delimitada por comas de servicios de solo lectura de PDB de origen.

P: ¿Cuál es el efecto de --waitForCompletion?

R: El parámetro --waitForCompletion especifica si se debe ejecutar la operación en segundo plano. Los valores válidos son true o false.

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

R: El parámetro --blobLocation especifica la ubicación de un directorio personalizado en el que se generará el archivo BLOB en espera en un entorno de Data Guard.

P: ¿Cuándo debo utilizar --standbyBlobFromPrimary?

R: Utilice --standbyBlobFromPrimary para especificar 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.

P: ¿Puedo usar --blobLocation y --standbyBlobFromPrimary juntos?

R: No, los parámetros --blobLocation y --standbyBlobFromPrimary se excluyen mutuamente y no se pueden utilizar juntos.

P: ¿Qué hace --upgradePDB?

R: El parámetro --upgradePDB especifica si se debe actualizar la PDB como parte de la operación de reubicación. Los valores válidos son true o false.

P: ¿Cuál es el propósito de --updateDBBlockCacheSize?

R: la opción --updateDBBlockCacheSize permite a la aplicación definir 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 un tamaño de bloque diferente.

P: ¿Qué hace la opción --skipOpenPDB?

R: La opción --skipOpenPDB indica que la PDB no se debe abrir al final de la operación de reubicación.

P: ¿Cuándo debo utilizar --completePDBRelocate?

R: Utilice --completePDBRelocate para completar la reubicación de la PDB si se realiza como una operación de dos pasos.

P: ¿Qué debo hacer si encuentro un error al utilizar el comando dbaascli pdb relocate?

R: Compruebe el mensaje de error para obtener detalles, asegúrese de que todos los parámetros estén especificados correctamente y verifique que tiene los permisos y credenciales necesarios. También puede que necesite revisar los requisitos y las configuraciones.

P: ¿Qué ocurre si olvido la contraseña de usuario SYS para la base de datos origen?

R: Deberá restablecer o recuperar la contraseña de usuario SYS para la base de datos origen. Sin ella, no puede completar la operación de reubicación.

Ejemplo 7-41 dbaascli pdb relocate

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

Gestión del Sistema

Esta sección se centra en supervisar y gestionar los directorios raíz de Oracle dentro del sistema. Incluye comandos como dbaascli system getDBHomes para ver detalles sobre todos los directorios raíz de Oracle Database y dbaascli system getGridHomes para mostrar los detalles de todos los directorios raíz de Grid Infrastructure. Estos comandos proporcionan información esencial para el mantenimiento y la resolución de problemas del entorno general del sistema.

sistema dbaascli 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

Preguntas frecuentes

P: ¿Para qué se utiliza el comando dbaascli system getDBHomes?

R: El comando dbaascli system getDBHomes se utiliza para ver información sobre todos los directorios raíz de Oracle de un sistema.

P: ¿Qué usuario debe ejecutar el comando dbaascli system getDBHomes?

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

P: ¿Hay algún parámetro para el comando dbaascli system getDBHomes?

R: No, el comando dbaascli system getDBHomes no tiene ningún parámetro.

P: ¿Qué tipo de información proporciona el comando dbaascli system getDBHomes?

R: El comando proporciona detalles sobre todos los directorios raíz de Oracle del sistema, incluidas sus rutas de acceso y otra información relevante.

P: ¿Cómo puedo interpretar la salida del comando dbaascli system getDBHomes?

R: La salida mostrará todos los directorios raíz de Oracle con información como la ubicación de cada directorio raíz de Oracle. Esta información puede ayudar a gestionar y configurar entornos de Oracle.

P: ¿Qué debo hacer si el comando dbaascli system getDBHomes no devuelve ninguna salida?

R: Asegúrese de ejecutar el comando como usuario root o oracle y verifique que los directorios raíz de Oracle están instalados correctamente en el sistema. También puede que desee comprobar los permisos y las configuraciones del sistema.

P: ¿Qué ocurre si recibo un mensaje de error al ejecutar el comando dbaascli system getDBHomes?

R: Compruebe el mensaje de error para obtener detalles específicos, verifique que tiene los permisos adecuados y asegúrese de que la herramienta dbaascli esté correctamente instalada y configurada.

P: ¿Puedo ejecutar el sistema dbaascli getDBHomes en un sistema que no sea de Oracle?

R: No, el comando dbaascli system getDBHomes es específico de los sistemas Oracle y requiere que se instale el software de Oracle.

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

Preguntas frecuentes

P: ¿Para qué se utiliza el comando dbaascli system getGridHomes?

R: El comando dbaascli system getGridHomes se utiliza para mostrar los detalles de todos los directorios raíz de Grid de un sistema.

P: ¿Qué usuario debe ejecutar el comando dbaascli system getGridHomes?

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

P: ¿Hay algún parámetro para el comando dbaascli system getGridHomes?

R: No, el comando dbaascli system getGridHomes no tiene ningún parámetro.

P: ¿Qué tipo de información proporciona el comando dbaascli system getGridHomes?

R: El comando proporciona detalles sobre todos los directorios raíz de Grid del sistema, incluidas sus ubicaciones y otra información relevante.

P: ¿Cómo puedo interpretar la salida del comando dbaascli system getGridHomes?

R: La salida mostrará todos los directorios raíz de Grid con información como sus rutas y configuraciones. Esto ayuda a gestionar y configurar la infraestructura de grid de Oracle.

P: ¿Qué debo hacer si el comando dbaascli system getGridHomes no devuelve ninguna salida?

R: Asegúrese de ejecutar el comando como usuario root o oracle y verifique que los directorios raíz de Oracle Grid están instalados correctamente en el sistema. Compruebe los permisos y las configuraciones del sistema si es necesario.

P: ¿Qué ocurre si recibo un mensaje de error al ejecutar el comando dbaascli system getGridHomes?

R: Revise el mensaje de error para obtener detalles específicos, asegúrese de tener los permisos adecuados y verifique que la herramienta dbaascli esté correctamente instalada y configurada.

P: ¿Puedo ejecutar dbaascli system getGridHomes en un sistema sin la infraestructura de Oracle Grid?

R: No, el comando dbaascli system getGridHomes es específico de los sistemas con la infraestructura de Oracle Grid instalada. Si no hay ningún directorio raíz de Grid, es posible que el comando no devuelva ningún resultado.

Gestión del cifrado de datos transparente (TDE)

Esta sección abarca la gestión del cifrado de datos transparente (TDE) para proteger los datos de la base de datos. Incluye comandos para manejar claves de cifrado y almacenes de claves, como dbaascli tde addSecondaryHsmKey para agregar claves de HSM secundarias, dbaascli tde rotateMasterKey para rotar la clave maestra y dbaascli tde encryptTablespacesInPDB para cifrar tablespaces dentro de una base de datos conectable. También puede convertir entre FILE y TDE basado en HSM (dbaascli tde fileToHsm, dbaascli tde hsmToFile), gestionar versiones de clave y recuperar detalles de clave con varios comandos. Estas herramientas garantizan una gestión eficaz del cifrado y la seguridad de los datos.

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.

Preguntas frecuentes

P: ¿Qué hace el comando dbaascli tde addSecondaryHsmKey?

R: El comando dbaascli tde addSecondaryHsmKey agrega una clave de HSM secundaria (KMS) a la configuración de HSM (KMS) existente para una base de datos de Exadata Cloud@Customer.

P: ¿Quién debe ejecutar el comando dbaascli tde addSecondaryHsmKey?

R: El comando se debe ejecutar como usuario root.

P: ¿En qué máquina debo ejecutar el comando dbaascli tde addSecondaryHsmKey?

R: Debe conectarse a una máquina virtual de Exadata Cloud@Customer mediante SSH para ejecutar este comando.

P: ¿Dónde puedo encontrar más detalles sobre la conexión a una máquina virtual para ejecutar este comando?

R: Puede consultar la guía "Conexión a una máquina virtual con SSH" para obtener instrucciones sobre cómo conectarse.

P: ¿Qué especifica la opción --secondaryKmsKeyOCID?

R: la opción --secondaryKmsKeyOCID especifica el OCID (identificador de Oracle Cloud) de la clave de KMS secundaria que se agregará a la configuración de HSM (KMS) existente.

P: ¿Qué hace la opción --dbname?

R: La opción --dbname permite especificar el nombre de la base de datos para la que se debe agregar la clave de KMS secundaria. Es opcional.

P: ¿Qué hace la opción --precheckOnly?

R: La opción --precheckOnly, cuando se define en yes, ejecuta una comprobación previa de la operación sin realizar ningún cambio real. Los valores válidos son yes o no.

P: ¿Puedo ejecutar la comprobación previa solo sin realizar cambios?

R: Sí, puede utilizar la opción --precheckOnly yes para ejecutar solo la comprobación previa sin realizar cambios.

P: ¿Puede dar un ejemplo de cómo ejecutar este comando para agregar una clave de HSM secundaria?

A: Ejemplo:

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example

P: ¿Cómo ejecuto el comando para una base de datos específica?

R: Puede especificar el nombre de la base de datos de la siguiente manera:

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --dbname mydatabase

P: ¿Cómo puedo ejecutar el comando solo con una comprobación previa?

R: Para ejecutar la comprobación previa, utilice la siguiente sintaxis:

dbaascli tde addSecondaryHsmKey --secondaryKmsKeyOCID ocid1.kms.key.oc1..example --precheckOnly yes

P: ¿Qué debo hacer si el comando falla?

R: Asegúrese de que está ejecutando el comando como usuario root y de que se ha conectado a la máquina virtual de Exadata Cloud@Customer correcta. Además, verifique el OCID de la clave de KMS y compruebe si se otorgan los permisos necesarios.

P: ¿Cómo puedo comprobar si tengo el OCID correcto para la clave de KMS secundaria?

R: Puede recuperar el OCID de la clave de KMS desde la consola de Oracle Cloud Infrastructure, en la sección Key Management Service (KMS).

P: ¿Qué permisos se necesitan para agregar una clave de KMS secundaria?

R: Necesita los permisos adecuados en Oracle Cloud Infrastructure para las operaciones de KMS, incluida la capacidad de gestionar claves de KMS para el compartimento correspondiente.

P: ¿Puedo utilizar el comando dbaascli tde addSecondaryHsmKey sin especificar la opción --dbname?

R: Sí, la opción --dbname es opcional. Si se omite, el comando se aplica a todas las bases de datos que utilizan la configuración de HSM (KMS) existente.

P: ¿Qué sucede si agrego una clave de KMS secundaria?

R: La clave de KMS secundaria se agregará a la configuración existente, lo que proporciona una capa adicional de redundancia de gestión de claves de cifrado.

P: ¿Puedo eliminar una clave de KMS secundaria una vez que se agrega?

R: No, una vez que se agrega una clave de KMS secundaria, no se puede eliminar. Solo puede rotar o actualizar claves en el futuro.

Ejemplo 7-43 dbaascli tde addSecondaryHsmKey

dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde addSecondaryHsmKey --dbname dbname --secondaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --precheckOnly yes
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.

Preguntas frecuentes

P: ¿Qué hace el comando dbaascli tde changePassword?

R: El comando dbaascli tde changePassword cambia la contraseña del almacén de claves de cifrado de datos transparente (TDE), así como la contraseña de cartera de base de datos para el alias tde_ks_passwd.

P: ¿Quién debe ejecutar el comando dbaascli tde changePassword?

R: El comando se debe ejecutar como usuario root.

P: ¿Cuándo debo utilizar el comando dbaascli tde changePassword?

R: utilice este comando cuando necesite cambiar la contraseña del almacén de claves de TDE o la contraseña de cartera de base de datos para una base de datos de Exadata Cloud@Customer.

P: ¿Qué hace la opción --dbname?

R: la opción --dbname especifica el nombre de la base de datos para la que desea cambiar la contraseña del almacén de claves de TDE.

P: ¿Qué hace la opción --pdbName?

R: la opción --pdbName especifica el nombre de la base de datos de conexión (PDB) para la que se debe cambiar la contraseña del almacén de claves de TDE. Esta opción se utiliza para bases de datos multi-inquilino.

P: ¿Puede dar un ejemplo de cómo ejecutar este comando para una base de datos específica?

R: A continuación, se muestra un ejemplo para cambiar la contraseña del almacén de claves de TDE para una base de datos específica:

dbaascli tde changePassword --dbname mydatabase

P: ¿Cómo puedo ejecutar el comando para una PDB específica dentro de una base de datos multi-inquilino?

R: Puede especificar el nombre de la PDB con esta sintaxis:

dbaascli tde changePassword --dbname mydatabase --pdbName mypdb

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

R: Debe ejecutar el comando como usuario root y tener acceso a la máquina virtual de Exadata Cloud@Customer en la que se ejecuta la base de datos.

P: ¿Necesito parar la base de datos para cambiar la contraseña del almacén de claves de TDE?

R: No, no es necesario parar la base de datos para cambiar la contraseña del almacén de claves de TDE.

P: ¿Qué debo hacer si el comando falla?

R: Asegúrese de que está ejecutando el comando como usuario raíz y de que el nombre de la base de datos (--dbname) y el nombre de la PDB (--pdbName, si procede) son correctos.

P: ¿Qué ocurre si recibo un error de "contraseña no válida" al cambiar la contraseña del almacén de claves de TDE?

R: Asegúrese de que la nueva contraseña cumple con los requisitos de complejidad de contraseña del sistema y de que está introduciendo la contraseña antigua correcta si se le solicita.

P: ¿Cómo puedo comprobar si la contraseña del almacén de claves de TDE se ha cambiado correctamente?

R: Puede comprobar los logs de la base de datos o utilizar las vistas Oracle Database Vault y Key Management para verificar que el cambio de contraseña del almacén de claves de TDE se ha realizado correctamente.

P: ¿Puedo cambiar la contraseña del almacén de claves de TDE para una base de datos multi-inquilino y todas las PDB a la vez?

R: No, el comando dbaascli tde changePassword se debe ejecutar para cada PDB individualmente si necesita cambiar la contraseña para varias PDB.

P: ¿Qué sucede si olvido la nueva contraseña del almacén de claves de TDE?

R: Si se olvida la nueva contraseña, puede que necesite restaurar el almacén de claves a partir de una copia de seguridad o seguir el proceso de recuperación de Oracle para restablecerla, según la configuración.

P: ¿Puedo automatizar el proceso de cambio de la contraseña del almacén de claves de TDE?

R: Si bien el comando dbaascli tde changePassword en sí no está diseñado para la automatización, puede crear un script como parte de los procedimientos regulares de mantenimiento de la base de datos si es necesario.

P: ¿Con qué frecuencia debo cambiar la contraseña del almacén de claves de TDE?

R: Oracle recomienda cambiar periódicamente la contraseña del almacén de claves de TDE según las políticas de seguridad de su organización. Las mejores prácticas suelen implicar la rotación regular de claves de cifrado y contraseñas de almacén de claves.

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

Preguntas frecuentes

P: ¿Qué hace el comando dbaascli tde enableWalletRoot?

R: El comando dbaascli tde enableWalletRoot activa el parámetro wallet_root en spfile para una base de datos Oracle existente en Exadata Cloud@Customer.

P: ¿Quién debe ejecutar el comando dbaascli tde enableWalletRoot?

R: El comando se debe ejecutar como usuario root.

P: ¿En qué máquina debo ejecutar el comando dbaascli tde enableWalletRoot?

R: Debe conectarse a una máquina virtual de Exadata Cloud@Customer mediante SSH para ejecutar este comando.

P: ¿Dónde puedo encontrar instrucciones para conectarme a la máquina virtual?

R: Puede consultar la guía "Conexión a una máquina virtual con SSH" para obtener instrucciones sobre la conexión.

P: ¿Qué hace la opción --dbRestart?

R: la opción --dbRestart especifica cómo se debe reiniciar la base de datos después de activar wallet_root. Los valores válidos son:
  • rolling: reinicia la base de datos de forma sucesiva (comportamiento por defecto).
  • full: realiza un reinicio completo de la base de datos.

P: ¿Qué hace la opción --dbname?

R: La opción --dbname permite especificar el nombre de la instancia de Oracle Database para la que se debe activar el parámetro wallet_root.

P: ¿Qué hace la opción --precheckOnly?

R: La opción --precheckOnly ejecuta una comprobación previa de la operación sin realizar cambios reales. Los valores válidos son yes o no.

P: ¿Qué sucede si no especifico la opción --dbRestart?

R: Si no especifica la opción --dbRestart, la base de datos se reiniciará de forma sucesiva por defecto.

P: ¿Puede dar un ejemplo de cómo activar wallet_root para una base de datos específica?

R: A continuación, se muestra un ejemplo para activar wallet_root para una base de datos denominada mydatabase:

dbaascli tde enableWalletRoot --dbname mydatabase

P: ¿Cómo activo wallet_root y especifico un reinicio completo de la base de datos?

R: Puede activar wallet_root con un reinicio completo de la base de datos mediante el siguiente comando:

dbaascli tde enableWalletRoot --dbname mydatabase --dbRestart full

P: ¿Cómo puedo ejecutar el comando solo con una comprobación previa?

R: Para realizar una comprobación previa sin realizar cambios, utilice la siguiente sintaxis:

dbaascli tde enableWalletRoot --dbname mydatabase --precheckOnly yes

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

R: Debe ejecutar el comando como usuario root y estar conectado a la máquina virtual de Exadata Cloud@Customer correcta.

P: ¿Necesito reiniciar la base de datos para activar wallet_root?

R: Sí, la base de datos deberá reiniciarse de forma sucesiva (por defecto) o por completo, según la opción que elija.

P: ¿Qué debo hacer si el comando falla?

R: Asegúrese de ejecutar el comando como usuario root y verifique que el nombre de la base de datos (--dbname) es correcto. Compruebe si hay errores de comprobación previa si se está ejecutando con --precheckOnly.

P: ¿Qué ocurre si la base de datos no se reinicia después de ejecutar el comando?

R: Verifique que se ha utilizado la opción de reinicio correcta (rolling o full) y compruebe si hay errores en los logs de la base de datos. Puede que tenga que reiniciar manualmente la base de datos si falla el reinicio automático.

P: ¿Cómo puedo comprobar si wallet_root se ha activado correctamente?

R: Puede verificar el cambio comprobando spfile de la base de datos o utilizando consultas SQL de Oracle para confirmar que el parámetro wallet_root está activado.

P: ¿Puedo activar wallet_root sin reiniciar la base de datos?

R: No, la base de datos debe reiniciarse para que el cambio surta efecto. Puede elegir entre un reinicio sucesivo o un reinicio completo.

P: ¿Cuál es la diferencia entre un reinicio de base de datos sucesivo y completo?

R: Un reinicio sucesivo reinicia la base de datos de una instancia a la vez, lo que permite que la base de datos permanezca parcialmente disponible durante la operación. Un reinicio completo cierra y reinicia toda la base de datos, lo que provoca un tiempo de inactividad total.

P: ¿Puedo ejecutar este comando para varias bases de datos simultáneamente?

R: Debe ejecutar el comando dbaascli tde enableWalletRoot por separado para cada base de datos en la que desee activar wallet_root.

P: ¿Cómo afecta la activación de wallet_root a la configuración del almacén de claves de TDE existente?

R: Al activar wallet_root, se actualiza la ubicación del almacén de claves de TDE al nuevo directorio raíz de cartera, lo que facilita la gestión de varios almacenes de claves y carteras en las bases de datos Oracle.

Ejemplo 7-44 dbaascli tde enableWalletRoot

dbaascli tde enableWalletRoot --dbname db name --dbrestart rolling|full
dbaascli tde enableWalletRoot --dbname orcl
dbaascli tde enableWalletRoot --dbname orcl--dbrestart full
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 --dbname <value> --pdbName <value>
[--executePrereqs]
Donde:
  • --pdbName especifica el nombre de la PDB para cifrar todos los tablespaces.
  • --dbname especifica el nombre de la instancia de Oracle Database.
  • --executePrereqs ejecuta las comprobaciones de requisitos e informa de los resultados.

Preguntas frecuentes

P: ¿Qué hace el comando dbaascli tde encryptTablespacesInPDB?

R: El comando dbaascli tde encryptTablespacesInPDB cifra todos los tablespaces en la base de datos conectable (PDB) especificada para una instancia de Oracle Database en Exadata Cloud@Customer.

P: ¿Quién debe ejecutar el comando dbaascli tde encryptTablespacesInPDB?

R: El comando se debe ejecutar como usuario root.

P: ¿En qué máquina debo ejecutar el comando dbaascli tde encryptTablespacesInPDB?

R: Debe conectarse a una máquina virtual de Exadata Cloud@Customer mediante SSH para ejecutar este comando.

P: ¿Dónde puedo encontrar instrucciones para conectarme a la máquina virtual?

R: Consulte la guía "Conexión a una máquina virtual con SSH" para obtener instrucciones de conexión.

P: ¿Qué especifica la opción --pdbName?

R: la opción --pdbName especifica el nombre de la base de datos conectable (PDB) cuyos tablespaces se deben cifrar.

P: ¿Qué hace la opción --dbname?

R: La opción --dbname permite especificar el nombre de la base de datos Oracle Database a la que pertenece la PDB.

P: ¿Qué hace la opción --precheckOnly?

R: La opción --precheckOnly ejecuta una comprobación previa de la operación de cifrado sin realizar ningún cambio real. Los valores válidos son yes o no.

P: ¿Qué hace la opción --useSysdbaCredential?

R: la opción --useSysdbaCredential especifica si se deben utilizar credenciales SYSDBA para la operación. Los valores válidos son true o false.

P: ¿Puede dar un ejemplo de cómo cifrar tablespaces en una PDB específica?

A: A continuación se muestra un ejemplo para cifrar todos los tablespaces en una PDB denominada mypdb:

dbaascli tde encryptTablespacesInPDB --pdbName mypdb

P: ¿Cómo cifro los tablespaces en una PDB específica dentro de una base de datos?

R: Utilice el siguiente comando para especificar tanto la PDB como la base de datos:

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --dbname mydatabase

P: ¿Cómo puedo ejecutar una comprobación previa sin realizar el cifrado?

R: Puede ejecutar una comprobación previa solo con esta sintaxis:

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --precheckOnly yes

P: ¿Cómo puedo utilizar las credenciales SYSDBA para cifrar los tablespaces?

R: Puede utilizar las credenciales SYSDBA agregando la opción --useSysdbaCredential true:

dbaascli tde encryptTablespacesInPDB --pdbName mypdb --useSysdbaCredential true

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

R: Debe ejecutar el comando como usuario root y tener acceso a la máquina virtual de Exadata Cloud@Customer.

P: ¿Necesito reiniciar la base de datos para cifrar los tablespaces?

R: No, el comando no requiere un reinicio de la base de datos. El cifrado se realiza mientras la base de datos está en línea.

P: ¿Necesito credenciales SYSDBA para cifrar tablespaces?

R: Puede que necesite credenciales SYSDBA para esta operación si se especifica mediante la opción --useSysdbaCredential.

P: ¿Qué debo hacer si el comando falla?

R: Asegúrese de que está ejecutando el comando como usuario raíz y verifique que el nombre de la PDB (--pdbName) y el nombre de la base de datos (--dbname) son correctos. También puede ejecutar el comando con --precheckOnly yes para comprobar si hay problemas antes de ejecutar el cifrado completo.

P: ¿Qué debo hacer si falla el cifrado de los tablespaces?

R: Compruebe los logs de la base de datos y asegúrese de tener los privilegios y recursos necesarios para realizar el cifrado. También puede que necesite verificar que haya suficiente espacio para manejar el proceso de cifrado.

P: ¿Cómo puedo comprobar si los tablespaces de una PDB están cifrados?

R: Puede consultar las vistas de base de datos relacionadas con el cifrado, como V$ENCRYPTED_TABLESPACES, para verificar si los tablespaces se han cifrado correctamente.

P: ¿Cómo puedo verificar si la comprobación previa se realizó correctamente?

R: Si ha ejecutado el comando con --precheckOnly yes, puede comprobar la salida en busca de advertencias o errores que indiquen posibles problemas con el proceso de cifrado.

P: ¿Puedo cifrar los tablespaces para varias PDB simultáneamente?

R: No, debe ejecutar el comando dbaascli tde encryptTablespacesInPDB por separado para cada PDB.

P: ¿Puedo cifrar parcialmente algunos tablespaces en una PDB?

R: No, este comando cifra todos los tablespaces dentro de la PDB especificada. Para el cifrado parcial, debe utilizar diferentes comandos de gestión de bases de datos.

P: ¿El cifrado de tablespaces afecta al rendimiento de la base de datos?

R: El cifrado de tablespaces puede tener un impacto temporal en el rendimiento durante el proceso de cifrado. Sin embargo, el impacto debe ser mínimo una vez que se complete el cifrado.

P: ¿Puedo deshacer el cifrado de tablespaces?

R: No, una vez que los tablespaces están cifrados, el cifrado no se puede deshacer. Solo puede rotar o volver a cifrar las claves según sea necesario.

P: ¿Qué sucede si la operación se interrumpe durante el proceso de cifrado?

R: Si se interrumpe la operación, es posible que deba volver a ejecutar el comando. El sistema reanudará el cifrado desde donde lo dejó, y puede verificar el estado mediante las vistas de base de datos.

Ejemplo 7-45 dbaascli tde encryptTablespacesInPDB

dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb
dbaascli tde encryptTablespacesInPDB --dbname dbname --pdbName pdb --executePrereqs 
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.

Preguntas frecuentes

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

R: El comando dbaascli tde fileToHsm se utiliza para convertir un cifrado de datos transparente (TDE) basado en FILE en un TDE basado en el módulo de seguridad de hardware (HSM), como KMS o OKV, en un entorno de Oracle Database Cloud Service.

P: ¿Quién puede ejecutar el comando dbaascli tde fileToHsm?

R: El comando se debe ejecutar como usuario root.

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

R: El parámetro --kmsKeyOCID especifica el OCID de clave de KMS que se utilizará para el cifrado de TDE al realizar la transición de TDE basado en archivos a TDE basado en HSM.

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

R: El parámetro --dbname especifica el nombre de la base de datos para la que está convirtiendo el TDE de basado en archivos a basado en HSM.

P: ¿Puedo omitir la comprobación de validación de parches al convertir TDE?

R: Sí, mediante el parámetro --skipPatchCheck con el valor true, puede omitir la comprobación de validación de los parches necesarios.

P: ¿Para qué se utiliza el parámetro --executePrereqs?

R: El parámetro --executePrereqs permite ejecutar solo las comprobaciones previas para el proceso de conversión de TDE sin realizar la conversión real. Los valores válidos son yes o no.

P: ¿Qué hace el parámetro --primarySuc en una configuración de Data Guard?

R: El parámetro --primarySuc se utiliza en un entorno de Data Guard para indicar que el comando se ha ejecutado correctamente en la base de datos primaria. Se debe especificar en la base de datos en espera una vez finalizada la conversión primaria.

P: ¿Cómo puedo reanudar una conversión de TDE anterior?

R: Puede reanudar una conversión de TDE incompleta anteriormente mediante el parámetro --resume. Opcionalmente, puede especificar un ID de sesión específico con --sessionID.

P: ¿Cómo puedo revertir una conversión de TDE?

R: Para revertir una conversión de TDE anterior, utilice el parámetro --revert. También puede proporcionar el ID de sesión específico que desea revertir mediante --sessionID.

P: ¿Cómo puedo especificar un ID de sesión al reanudar o revertir una conversión de TDE?

R: Puede utilizar el parámetro --sessionID para especificar el ID de la sesión que desea reanudar o revertir. Ejemplo: --resume --sessionID <ID> o --revert --sessionID <ID>.

P: ¿Qué sucede si configuro --waitForCompletion en false?

R: Si define --waitForCompletion en false, el proceso de conversión de TDE se ejecutará en segundo plano y el símbolo del sistema se devolverá inmediatamente. Si se define en true, el comando esperará a que finalice el proceso antes de devolver el control al usuario.

P: ¿Cuáles son los valores válidos para el parámetro --waitForCompletion?

A: Los valores válidos son true o false. Si se define en true, el comando espera hasta que se complete el proceso; si se define en false, se ejecuta el proceso en segundo plano.

P: ¿Puedo ejecutar dbaascli TDE fileToHsm sin convertir el TDE inmediatamente?

R: Sí, puede utilizar el parámetro --executePrereqs yes para realizar solo las comprobaciones previas de la conversión, sin realizar ningún cambio en el TDE.

P: En un entorno de Data Guard, ¿cómo puedo manejar la base de datos en espera después de convertir el TDE en la base de datos primaria?

R: Después de ejecutar correctamente la conversión en la base de datos primaria, debe especificar --primarySuc al ejecutar el comando en la base de datos en espera.

P: ¿Qué debo hacer si falla el proceso de conversión de TDE?

R: Si el proceso falla, puede utilizar el parámetro --resume para intentar reanudar desde donde lo dejó. Si es necesario, puede utilizar el parámetro --revert para realizar un rollback de los cambios realizados durante la sesión fallida.

Ejemplo 7-46 dbaascli tde fileToHsm --kmsKeyOCID

dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs 
dbaascli tde fileToHSM --dbname dbname --kmsKeyOCID ocid1.key.oc1.eu-frankfurt-.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --resume
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

Preguntas frecuentes

P: ¿Qué hace el comando dbaascli tde getHsmKeys?

R: El comando dbaascli tde getHsmKeys recupera detalles de claves de cifrado de datos transparente (TDE) activas del módulo de seguridad de hardware (HSM) para una base de datos especificada.

P: ¿Quién debe ejecutar el comando dbaascli tde getHsmKeys?

R: El comando se debe ejecutar como usuario root.

P: ¿En qué máquina debo ejecutar el comando dbaascli tde getHsmKeys?

R: Debe conectarse a una máquina virtual de Exadata Cloud@Customer mediante SSH para ejecutar este comando.

P: ¿Dónde puedo encontrar instrucciones para conectarme a la máquina virtual?

R: Consulte la guía "Conexión a una máquina virtual con SSH" para obtener instrucciones sobre la conexión.

P: ¿Qué hace la opción --dbname?

R: La opción --dbname permite especificar el nombre de la instancia de Oracle Database para la que desea recuperar los detalles de clave de TDE.

P: ¿Qué hace la opción --infoFile?

R: la opción --infoFile especifica la ruta de acceso del archivo en la que se guardará la lista de OCID clave (identificadores de Oracle Cloud). La salida tiene el formato JSON.

P: ¿Puede dar un ejemplo de cómo recuperar los detalles de clave de TDE para una base de datos específica?

R: A continuación, se muestra un ejemplo para obtener los detalles de clave de TDE para una base de datos denominada mydatabase:

dbaascli tde getHsmKeys --dbname mydatabase

P: ¿Cómo guardo los detalles de la clave de TDE en un archivo?

R: Puede especificar una ruta de archivo mediante la opción --infoFile para guardar la salida en formato JSON:

dbaascli tde getHsmKeys --dbname mydatabase --infoFile /path/to/output.json

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

R: Debe ejecutar el comando como usuario root y estar conectado a la máquina virtual de Exadata Cloud@Customer.

P: ¿Necesito credenciales SYSDBA para recuperar los detalles de clave de TDE?

R: No, no se necesitan credenciales SYSDBA para ejecutar el comando dbaascli tde getHsmKeys.

P: ¿En qué formato se guarda la información de clave de TDE al utilizar la opción --infoFile?

R: La salida se guarda en formato JSON.

P: ¿Qué información se incluye en los detalles clave de TDE?

R: Los detalles incluyen los OCID de clave y otros metadatos sobre las claves de cifrado activas almacenadas en el HSM para la base de datos especificada.

P: ¿Qué debo hacer si el comando no recupera los detalles de la clave?

R: Asegúrese de que está ejecutando el comando como usuario root y de que el nombre de la base de datos (--dbname) es correcto. Compruebe la conexión a la máquina virtual de Exadata Cloud@Customer.

P: ¿Cómo puedo comprobar si el archivo de salida se ha creado correctamente?

R: Puede comprobar la ruta de archivo especificada para el archivo JSON de salida. Si falta el archivo, verifique que la ruta de archivo sea correcta y que tenga permisos de escritura en el directorio.

P: ¿Qué debo hacer si el archivo de salida está vacío?

R: Asegúrese de que la base de datos especificada contiene claves de TDE activas y de que el parámetro --dbname es correcto. También puede que necesite comprobar si hay errores en los logs de la base de datos.

P: ¿Puedo recuperar detalles de clave de TDE para varias bases de datos a la vez?

R: No, debe ejecutar el comando dbaascli tde getHsmKeys por separado para cada base de datos.

P: ¿Cómo puedo utilizar el archivo de salida de la opción --infoFile en otras operaciones?

R: Dado que la salida está en formato JSON, puede analizar el archivo mediante programación o utilizarlo como entrada para otras tareas de gestión de cifrado o base de datos.

P: ¿Puedo obtener detalles de claves de TDE históricas con este comando?

R: No, el comando solo recupera detalles sobre las claves activas actualmente en el HSM.

P: ¿Cómo puedo verificar que las claves recuperadas son correctas?

R: Puede verificar las claves haciendo referencia cruzada a ellas con la consola de Oracle Cloud Infrastructure (OCI) o utilizando vistas de base de datos relacionadas con la gestión de cifrado.

Ejemplo 7-47 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.

Preguntas frecuentes

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

R: el comando dbaascli tde getMkidForKeyVersionOCID recupera el ID de clave maestra (MKID) asociado a un OCID de versión de clave de KMS específico en entornos de Oracle Database Cloud Service.

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

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

P: ¿Quién puede ejecutar el comando dbaascli tde getMkidForKeyVersionOCID?

R: Solo el usuario root puede ejecutar este comando.

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

R: el parámetro --kmsKeyVersionOCID especifica el OCID de versión de clave de KMS para el que desea recuperar el ID de clave maestra (MKID) asociado.

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

R: el parámetro --dbname especifica el nombre de la base de datos para la que se consulta el OCID de versión de clave de KMS.

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

R: No, el parámetro --dbname es opcional. Si no especifica un nombre de base de datos, el comando recuperará el MKID de la base de datos por defecto en el sistema.

P: ¿Qué debo hacer si no conozco el OCID de la versión de clave de KMS?

R: Debe recuperar el OCID de versión de clave de KMS de la consola de gestión de KMS o del proveedor de servicios antes de utilizar este comando. Sin ella, el comando no puede recuperar el ID de clave maestra (MKID).

P: ¿Puedo ejecutar este comando en un entorno que no sea de Exadata Cloud@Customer?

R: No, este comando es específico para su uso en un entorno de Exadata Cloud@Customer y necesita conectarse a una máquina virtual mediante SSH para ejecutarlo.

P: ¿Qué sucede si ejecuto el comando sin especificar un nombre de base de datos mediante --dbname?

R: Si no se proporciona el parámetro --dbname, el comando intentará recuperar el MKID de la base de datos por defecto configurada en el sistema.

P: ¿Qué debo hacer si encuentro un error al recuperar el MKID?

A: Asegúrese de que:
  • Está ejecutando el comando como usuario root.
  • Está conectado correctamente a la máquina virtual de Exadata Cloud@Customer.
  • El OCID de versión de clave de KMS que ha proporcionado es válido. Si el error persiste, compruebe los logs del sistema para obtener más información.

P: ¿Cómo me conecto a la máquina virtual de Exadata Cloud@Customer?

R: Puede conectarse a la máquina virtual a través de SSH. Consulte la documentación de Exadata Cloud@Customer para obtener información sobre cómo conectarse de forma segura.

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

Preguntas frecuentes

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

R: El comando dbaascli tde getPrimaryHsmKey recupera la clave principal 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 getPrimaryHsmKey?

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

P: ¿Quién puede ejecutar el comando dbaascli tde getPrimaryHsmKey?

R: Solo el usuario root puede ejecutar este comando.

P: ¿Qué especifica el parámetro --dbname en este comando?

R: el parámetro --dbname especifica el nombre de la base de datos para la que desea recuperar la clave HSM principal.

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

R: No, el parámetro --dbname es opcional. Si no se proporciona, el comando recuperará la clave HSM principal para la base de datos predeterminada en el sistema.

P: ¿Qué debo hacer si no especifico un nombre de base de datos con --dbname?

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

P: ¿Puedo ejecutar este comando en un entorno que no sea de Exadata Cloud@Customer?

R: No, este comando está diseñado específicamente para su uso en un entorno de Exadata Cloud@Customer y debe estar conectado a la máquina virtual mediante SSH para ejecutarlo.

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

R: Puede conectarse a la máquina virtual a través de SSH. Consulte la documentación de Exadata Cloud@Customer para obtener instrucciones sobre cómo conectarse de forma segura.

P: ¿Qué debo comprobar si encuentro un error al recuperar la clave HSM principal?

R: Si encuentra un error, asegúrese de que:
  • Está ejecutando el comando como usuario root.
  • Está conectado correctamente a la máquina virtual de Exadata Cloud@Customer.
  • El nombre de la base de datos (si se especifica) es válido. Si el problema continúa, consulte los logs del sistema o los mensajes de error para obtener más información.

P: ¿Necesito parar la base de datos para ejecutar el comando dbaascli tde getPrimaryHsmKey?

R: No, no es necesario parar la base de datos para ejecutar este comando. Puede ejecutarlo mientras se ejecuta la base de datos.

P: ¿Cuál es la finalidad de recuperar la clave HSM principal?

R: La recuperación de la clave de HSM principal permite identificar la clave de HSM actual que se utiliza para el cifrado en la configuración de HSM (KMS) existente de la base de datos.

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

Preguntas frecuentes

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

R: El comando dbaascli tde hsmToFile se utiliza para convertir un cifrado de datos transparente (TDE) basado en el módulo de seguridad de hardware (HSM) en un TDE basado en archivos en entornos de Oracle Database Cloud Service.

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

A: Debe:
  • Ejecute el comando con el usuario root.
  • Asegúrese de que tiene los permisos y configuraciones necesarios definidos en el entorno de base de datos.

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

R: El parámetro --dbname especifica el nombre de la base de datos para la que está convirtiendo TDE de basado en HSM a basado en archivos.

P: ¿Cuándo es necesario el parámetro --primaryDBWalletTar?

R: El parámetro --primaryDBWalletTar solo es necesario al realizar la conversión hsmToFile en una base de datos en espera. Especifica el archivo tar de la cartera de la base de datos primaria.

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

R: El parámetro --skipPatchCheck permite omitir la comprobación de validación de los parches necesarios. Defina esta opción en true para omitir la comprobación o en false para aplicarla.

P: ¿Cómo puedo ejecutar solo comprobaciones previas para el proceso de conversión sin realizar la conversión real?

R: Puede utilizar el parámetro --executePrereqs y definirlo en yes para ejecutar solo las comprobaciones previas. Defínalo en no para realizar la conversión completa.

P: ¿Qué hace el parámetro --primarySuc en un entorno de Data Guard?

R: El parámetro --primarySuc se utiliza en una configuración de Data Guard para indicar que la conversión se ha ejecutado correctamente en la base de datos primaria. Se debe utilizar al ejecutar la conversión en la base de datos en espera.

P: ¿Cómo puedo reanudar una conversión hsmToFile anterior?

R: Puede reanudar una conversión anterior mediante el parámetro --resume. Opcionalmente, puede especificar el ID de sesión de la ejecución anterior con --sessionID.

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

R: El parámetro --revert se utiliza para realizar un rollback de un proceso de conversión iniciado anteriormente en caso de fallo o si necesita deshacer la operación.

P: ¿Qué sucede si configuro --waitForCompletion en false?

R: Si define --waitForCompletion en false, la operación se ejecutará en segundo plano, lo que le permitirá continuar con otras tareas. Si se define en true, el comando esperará a que finalice el proceso antes de devolver el control al usuario.

P: ¿Qué debo hacer para convertir el TDE en una base de datos en espera en una configuración de Data Guard?

R: En una configuración de Data Guard, después de convertir TDE en la base de datos primaria, debe ejecutar el comando en la base de datos en espera mediante el parámetro --primaryDBWalletTar, especificando el archivo tar de cartera de la base de datos primaria e incluyendo --primarySuc.

P: ¿Qué debo hacer si quiero omitir la comprobación de los parches necesarios durante la conversión?

R: Puede omitir la comprobación de parches mediante el parámetro --skipPatchCheck y definirlo en true.

P: ¿Cómo puedo comprobar si el sistema está listo para la conversión hsmToFile sin realizar cambios?

R: Puede realizar solo las comprobaciones previas mediante el parámetro --executePrereqs y definirlo en yes.

P: ¿Qué debo hacer si se interrumpe el proceso de conversión?

R: Puede utilizar el parámetro --resume para reiniciar el proceso desde donde lo dejó. Opcionalmente, puede especificar un ID de sesión concreto con --sessionID.

P: ¿Qué debo hacer si el proceso de conversión falla?

R: Si la conversión falla, puede realizar un rollback del proceso mediante el parámetro --revert. Además, revise los mensajes de error y compruebe los logs del sistema para obtener más información.

P: ¿Puedo ejecutar el comando dbaascli tde hsmToFile en un entorno que no sea de Exadata?

R: este comando está diseñado para su uso en entornos de Exadata Cloud@Customer. Si no utiliza Exadata, asegúrese de que está en un entorno soportado para que el comando funcione correctamente.

Ejemplo 7-50 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.

Preguntas frecuentes

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

R: El comando dbaascli tde listKeys se utiliza para mostrar todas las claves maestras del cifrado de datos transparente (TDE) para una base de datos especificada en un entorno de Oracle Database.

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

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

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

R: El parámetro --file especifica la ruta de archivo en la que se debe guardar la lista de claves maestras de TDE. Si no se proporciona este parámetro, los resultados se mostrarán directamente en el terminal.

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

R: El parámetro --dbname especifica el nombre de la base de datos para la que desea mostrar las claves maestras de TDE.

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

R: No, el parámetro --file es opcional. Si no se proporciona, la lista de claves de TDE se mostrará en la salida del terminal en lugar de guardarse en un archivo.

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

R: No, el parámetro --dbname es opcional. Si no se especifica, el comando mostrará las claves maestras de TDE para la base de datos por defecto configurada en el sistema.

P: ¿Qué debo hacer si quiero guardar la lista de claves en un archivo?

R: Debe proporcionar el parámetro --file junto con la ruta de archivo deseada. Por ejemplo:

dbaascli tde listKeys --file /path/to/output.txt

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

R: Si no se proporciona el parámetro --dbname, el comando mostrará las claves maestras de TDE para la base de datos por defecto en el sistema.

P: ¿Puedo utilizar este comando en entornos que no sean Exadata Cloud@Customer?

R: este comando está diseñado específicamente para entornos de Exadata Cloud@Customer. Asegúrese de que está conectado a la máquina virtual adecuada para ejecutarla.

P: ¿Qué debo hacer si el comando no muestra las claves?

A: Asegúrese de que:
  • Está ejecutando el comando como usuario root.
  • Está conectado a la máquina virtual de Exadata Cloud@Customer.
  • El nombre de base de datos (si se especifica) es correcto. Consulte los mensajes de error y los logs para obtener más información sobre el fallo.

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

R: Sí, el comando se puede ejecutar mientras se ejecuta la base de datos. Simplemente muestra las claves maestras de TDE y no modifica el estado de la base de datos.

P: ¿Necesito permisos especiales para ejecutar este comando?

R: Debe ejecutar este comando como usuario root. Sin permisos root, no podrá ejecutar el comando.

P: ¿Cuál es la finalidad de mostrar las claves maestras de TDE?

R: La lista de claves maestras de TDE permite revisar las claves de cifrado que se utilizan para proteger los datos de la base de datos. Es esencial para supervisar y gestionar la configuración de cifrado.

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

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

Ejemplo 7-51 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?

A: Debe:
  • Ejecute el comando con el usuario root.
  • Conéctese a una máquina virtual de Exadata Cloud@Customer 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 solicitará 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@Customer.
  • 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@Customer para ejecutar el comando?

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

Ejemplo 7-52 dbaascli tde removeSecondaryHsmKey

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

Para rotar la clave maestra para el cifrado de la base de datos, utilice el comando dbaascli tde rotateMasterKey.

Requisitos:

Ejecute el comando con el usuario root.

Sintaxis

dbaascli tde rotateMasterKey --dbname <value> 
[--rotateMasterKeyOnAllPDBs] 
[--pdbName <value>] 
[--executePrereqs] 
[--resume [--sessionID <value>]]
{
     [--prepareStandbyBlob <value> [--blobLocation <value>]]
     | [--standbyBlobFromPrimary <value>]
 }
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database
  • --rotateMasterKeyOnAllPDBs especifica 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 especifica que se reanude la ejecución anterior
  • --sessionID especifica que se reanude un identificador de sesión específico
  • --prepareStandbyBlob especifica true para generar un archivo BLOB que contiene los artefactos necesarios para realizar la operación en un entorno de Data Guard
  • --blobLocation especifica la ubicación del directorio personalizado en el que se generará el archivo BLOB en espera en un entorno de Data Guard
  • --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.

Preguntas frecuentes

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

R: El comando dbaascli tde rotateMasterKey se utiliza para rotar la clave maestra utilizada para el cifrado de datos transparente (TDE) en una instancia de Oracle Database. Este proceso garantiza que las claves de cifrado se actualicen para mejorar la seguridad.

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

A: Debe:
  • Ejecute el comando con el usuario root.
  • Asegúrese de que la base de datos está configurada correctamente para TDE.

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

R: el parámetro --dbname especifica el nombre de la Oracle Database para la que desea rotar la clave de cifrado maestra.

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

R: El parámetro --rotateMasterKeyOnAllPDBs especifica si rotar la clave maestra para todas las bases de datos conectables (PDB) en una base de datos de contenedores (CDB). Los valores válidos son true o false.

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

R: El parámetro --pdbName especifica el nombre de una base de datos conectable (PDB) concreta si desea rotar la clave maestra para una PDB específica en lugar de todas las PDB.

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

R: El parámetro --executePrereqs ejecuta comprobaciones de requisitos para validar si el entorno está listo para la rotación de clave maestra sin realizar la rotación real.

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

R: El parámetro --resume se utiliza para reanudar una operación iniciada anteriormente. También puede proporcionar un ID de sesión específico mediante --sessionID para reanudar una sesión concreta.

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

R: Si se define en true, el parámetro --prepareStandbyBlob genera un archivo BLOB que contiene los artefactos necesarios para realizar la rotación de claves maestras en un entorno de Data Guard.

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

R: El parámetro --blobLocation especifica una ruta de directorio personalizada donde se generará el archivo BLOB en espera. Esto se aplica cuando --prepareStandbyBlob se define en true.

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

R: el parámetro --standbyBlobFromPrimary especifica la ubicación del archivo BLOB en espera que se ha generado a partir de la base de datos principal. Este parámetro se utiliza al realizar la rotación de claves maestras en una base de datos en espera en un entorno de Data Guard.

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

R: No, el parámetro --rotateMasterKeyOnAllPDBs es opcional. Si no se especifica, la clave maestra solo se rotará para la base de datos (o PDB específica) proporcionada en los parámetros --dbname o --pdbName.

P: ¿Es necesario el parámetro --pdbName si estoy rotando claves para una CDB?

R: No, el parámetro --pdbName solo es necesario si desea rotar la clave maestra para una base de datos conectable (PDB) específica. Es opcional al rotar la clave para toda la CDB.

P: ¿Necesito utilizar los parámetros --prepareStandbyBlob y --standbyBlobFromPrimary para bases de datos independientes?

R: No, estos parámetros solo son relevantes en un entorno de Data Guard en el que interviene una base de datos en espera.

P: ¿Cómo puedo rotar la clave maestra para todas las PDB en una CDB?

R: Debe utilizar el parámetro --rotateMasterKeyOnAllPDBs definido en true para rotar la clave maestra para todas las PDB en la CDB. Por ejemplo:

dbaascli tde rotateMasterKey --dbname CDB_NAME --rotateMasterKeyOnAllPDBs true

P: ¿Cómo puedo ejecutar una comprobación para validar que el sistema está listo para la rotación de claves maestras sin realizar la operación real?

R: Puede utilizar el parámetro --executePrereqs para ejecutar las comprobaciones de requisitos. Se informará de cualquier problema que pueda impedir la rotación de claves maestras:

dbaascli tde rotateMasterKey --dbname DB_NAME --executePrereqs

P: ¿Qué debo hacer si se interrumpe la operación y quiero reanudarla?

R: Puede utilizar el parámetro --resume para reanudar la operación interrumpida anteriormente. Si tiene un ID de sesión, proporcione el parámetro --sessionID:

dbaascli tde rotateMasterKey --dbname DB_NAME --resume --sessionID <value>

P: ¿Cómo puedo prepararme para la rotación de claves en un entorno de Data Guard?

R: Debe utilizar el parámetro --prepareStandbyBlob para generar un archivo BLOB que contenga los artefactos necesarios para rotar la clave maestra en un entorno en espera:

dbaascli tde rotateMasterKey --dbname DB_NAME --prepareStandbyBlob true --blobLocation /path/to/blob

P: ¿Cómo puedo aplicar el archivo BLOB en espera desde la base de datos primaria al rotar claves en una base de datos en espera?

R: Utilice el parámetro --standbyBlobFromPrimary para especificar la ubicación del archivo BLOB que se ha preparado en la base de datos primaria:

dbaascli tde rotateMasterKey --dbname DB_NAME --standbyBlobFromPrimary /path/to/blob

P: ¿Qué debo comprobar si falla la rotación de la clave maestra?

A: Asegúrese de que:
  • Está ejecutando el comando como usuario root.
  • El nombre de la base de datos (--dbname) es correcto.
  • Cualquier comprobación de requisitos se ha ejecutado mediante --executePrereqs para garantizar la preparación. Revise los logs de errores para obtener información más detallada sobre el fallo.

P: ¿Qué debo hacer si la operación no se completa correctamente en un entorno de Data Guard?

R: Asegúrese de que el archivo BLOB de la base de datos primaria se ha preparado correctamente mediante --prepareStandbyBlob y, a continuación, utilice --standbyBlobFromPrimary para aplicarlo en la base de datos en espera.

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

R: Sí, el comando se puede ejecutar mientras se ejecuta la base de datos. Sin embargo, se recomienda ejecutar comprobaciones de requisitos de antemano mediante la opción --executePrereqs.

P: ¿Por qué es importante rotar la clave maestra?

R: La rotación de la clave maestra mejora la seguridad de la base de datos al garantizar que las claves de cifrado utilizadas para la protección de datos se actualicen periódicamente, lo que reduce el riesgo de compromiso de claves.

P: ¿Necesito reiniciar la base de datos después de rotar la clave maestra?

R: No, no es necesario reiniciar la base de datos después de rotar la clave maestra. La rotación de claves entrará en vigor inmediatamente sin ninguna interrupción del servicio.

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

Preguntas frecuentes

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

R: El comando dbaascli tde setKeyVersion se utiliza para definir la versión de la clave de cifrado principal que se debe utilizar para el cifrado de datos transparente (TDE) en una base de datos o una base de datos conectable (PDB). Esto permite asignar la versión específica de una clave de KMS a la base de datos.

P: ¿Cuáles son los requisitos para utilizar el comando dbaascli tde setKeyVersion?

R: Debe ejecutar el comando como usuario root y asegurarse de que está conectado a una máquina virtual de Exadata Cloud@Customer.

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

R: el parámetro --kmsKeyVersionOCID especifica el OCID de versión de clave de KMS (identificador de Oracle Cloud) que desea definir para la base de datos o la PDB.

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

R: el parámetro --dbname especifica el nombre de la instancia de Oracle Database para la que se definirá la versión de clave.

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

R: El parámetro --pdbName especifica el nombre de la base de datos conectable (PDB) dentro de una base de datos de contenedores (CDB) en la que desea definir la versión de clave de KMS específica.

P: ¿Para qué se utiliza el parámetro --masterKeyID?

R: El parámetro --masterKeyID especifica el identificador de clave maestra que está asociado al OCID de versión de clave de KMS proporcionado. Esto es especialmente importante en un entorno de Data Guard.

P: ¿Cuál es el rol del parámetro --standbySuc?

R: El parámetro --standbySuc se utiliza en un entorno de Data Guard. Especifica que esta propiedad se debe definir en la base de datos primaria después de ejecutar correctamente el comando en la base de datos en espera.

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

R: El parámetro --executePrereqs especifica si se deben ejecutar comprobaciones de requisitos antes de ejecutar la operación. Los valores válidos son yes o no.

P: ¿Qué controla el parámetro --waitForCompletion?

R: El parámetro --waitForCompletion determina si la operación se ejecutará de forma síncrona (en espera de finalización) o asíncrona (en segundo plano). Los valores válidos son true o false.

P: ¿Es necesario el parámetro --pdbName si se define la versión de clave para una CDB?

R: No, el parámetro --pdbName solo es necesario si está definiendo la versión de clave para una base de datos conectable (PDB) específica. Es opcional si está definiendo la versión de clave para toda la base de datos de contenedores (CDB).

P: ¿Es necesario el parámetro --masterKeyID para entornos que no sean de Data Guard?

R: No, el parámetro --masterKeyID normalmente solo se utiliza en entornos de Data Guard. Para bases de datos independientes, este parámetro no es necesario.

P: ¿Cómo puedo establecer la versión de clave para una base de datos?

R: Puede definir la versión de clave para una base de datos ejecutando:

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME>

P: ¿Cómo puedo definir la versión de clave para una PDB específica?

R: Para definir la versión de clave para una base de datos conectable (PDB) específica, utilice el parámetro --pdbName junto con el nombre de la base de datos:

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME> --pdbName <PDB_NAME>

P: ¿Cómo puedo asegurarme de que se cumplan todos los requisitos previos antes de configurar la versión de la clave?

R: Puede ejecutar las comprobaciones de requisitos mediante el parámetro --executePrereqs:

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --executePrereqs yes

P: ¿Cómo puedo definir la versión de clave en un entorno de Data Guard?

R: En un entorno de Data Guard, debe:
  • Ejecute el comando en la base de datos en espera:

    dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --masterKeyID <keyID> --dbname <DB_NAME>

  • Después de ejecutar correctamente el comando en la base de datos en espera, ejecute el comando en la base de datos primaria mediante el parámetro --standbySuc:

    dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --dbname <DB_NAME> --standbySuc yes

P: ¿Cómo puedo ejecutar la operación en segundo plano sin esperar a que se complete?

R: Puede ejecutar la operación de forma asíncrona definiendo --waitForCompletion en false:

dbaascli tde setKeyVersion --kmsKeyVersionOCID <value> --waitForCompletion false

P: ¿Qué debo hacer si la versión de la clave no se configura?

A: Asegúrese de que:
  • Está ejecutando el comando como usuario root.
  • El OCID de versión de clave de KMS es correcto.
  • Cualquier comprobación de requisitos se ha ejecutado mediante --executePrereqs para garantizar la preparación. Revise los logs de errores para obtener detalles específicos y vuelva a ejecutar la operación si es necesario.

P: ¿Qué debo comprobar si la operación no se completa correctamente en un entorno de Data Guard?

R: Asegúrese de que el parámetro --masterKeyID se ha especificado correctamente al ejecutar el comando en la base de datos en espera. Una vez finalizado en la base de datos en espera, se debe utilizar el parámetro --standbySuc al ejecutar el comando en la base de datos primaria.

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

R: Sí, el comando se puede ejecutar mientras se ejecuta la base de datos. Sin embargo, se recomienda ejecutar previamente las comprobaciones de requisitos mediante --executePrereqs.

P: ¿Por qué es importante establecer la versión de clave de KMS correcta para una base de datos?

R: La configuración de la versión de clave de KMS correcta garantiza que la base de datos esté utilizando la versión de clave de cifrado adecuada para TDE, lo que ayuda a mantener la seguridad de los datos y el cumplimiento de las políticas de la organización.

P: ¿Qué sucede si utilizo el OCID de versión de clave de KMS incorrecto?

R: Si se utiliza un OCID de versión de clave de KMS incorrecto, el cifrado puede fallar y la base de datos no podrá utilizar la clave incorrecta para las operaciones de cifrado. Debe asegurarse de que se proporciona el OCID de versión de clave correcto.

P: ¿Necesito reiniciar la base de datos después de definir la versión de clave?

R: No, no es necesario reiniciar la base de datos después de definir la versión de clave. La nueva versión de clave se aplicará inmediatamente sin necesidad de reiniciar.

Ejemplo 7-53 dbaascli tde setKeyVersion

dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
dbaascli tde setKeyVersion --dbname dbname --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha --executePrereqs
dbaascli tde setKeyVersion --dbname dbname --pdbName pdb --kmsKeyVersionOCID ocid1.keyversion.oc1.eu-frankfurt-1.bjqnwclvaafak.bc4hmd3olgaaa.abtheljsyxtgn4vzi2bbpcej6a7abcwvylkd2lx56lu2s6iwnxwgigu23nha
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.

Preguntas frecuentes

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

R: El comando dbaascli tde setPrimaryHsmKey se utiliza para cambiar la clave principal de HSM (módulo de seguridad de hardware) o KMS (servicio de gestión de claves) en una configuración de HSM/KMS existente para cifrado de datos transparente (TDE).

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

R: El comando se debe ejecutar como usuario root y el entorno debe ser una máquina virtual de Exadata Cloud@Customer.

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

R: El parámetro --primaryKmsKeyOCID especifica el OCID (identificador de Oracle Cloud) de la clave de KMS principal que se va a definir para el entorno de TDE.

P: ¿Cuál es la función del parámetro --dbname?

R: El parámetro --dbname especifica el nombre de la Oracle Database para la que se definirá la clave principal de HSM/KMS.

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

R: El parámetro --standbySuc se utiliza en un entorno de Data Guard. Especifica que el comando se debe ejecutar en la base de datos primaria después de ejecutarlo correctamente en la base de datos en espera.

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

R: El parámetro --precheckOnly permite ejecutar solo las comprobaciones previas de esta operación. Valida el entorno sin realizar ningún cambio real. Los valores válidos son yes o no.

P: ¿Qué controla el parámetro --bounceDatabase?

R: El parámetro --bounceDatabase especifica si la base de datos se debe reiniciar (reiniciar) de forma dinámica como parte de la operación. Esto garantiza un tiempo de inactividad mínimo reiniciando partes de la base de datos una por una.

P: ¿Cómo configuro la clave de KMS principal para mi base de datos?

R: Para configurar la clave de KMS principal, ejecute el siguiente comando:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME>

P: ¿Cómo puedo asegurarme de que la operación se pueda ejecutar sin problemas?

R: Ejecute la operación con el parámetro --precheckOnly para verificar que se cumplen todos los requisitos:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --precheckOnly yes

P: ¿Cómo puedo definir la clave de KMS primaria en un entorno de Data Guard?

R: En primer lugar, ejecute el comando en la base de datos en espera:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME>

A continuación, ejecute el comando en la base de datos primaria con el parámetro --standbySuc:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --dbname <DB_NAME> --standbySuc yes

P: ¿Cómo minimizo el tiempo de inactividad al cambiar la clave de KMS principal?

R: Puede utilizar el parámetro --bounceDatabase para realizar un reinicio sucesivo, minimizando el tiempo de inactividad:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --bounceDatabase

P: ¿Es necesario el parámetro --dbname para todas las bases de datos?

R: Sí, debe especificar el parámetro --dbname para indicar la base de datos de destino para la que se debe definir la clave de KMS principal.

P: ¿Es obligatorio utilizar el parámetro --standbySuc en un entorno de Data Guard?

R: Sí, se debe utilizar el parámetro --standbySuc al ejecutar el comando en la base de datos primaria después de ejecutarlo correctamente en la base de datos en espera.

P: ¿Puedo omitir la operación de reinicio para la base de datos?

R: Sí, si no especifica el parámetro --bounceDatabase, la base de datos no se devolverá (se reiniciará) como parte de la operación.

P: ¿Qué debo hacer si el comando falla durante la ejecución?

R: Si el comando falla, asegúrese de:
  • Lo está ejecutando como usuario root.
  • Se proporcionan los valores --primaryKmsKeyOCID y --dbname correctos.
  • El entorno supera todas las comprobaciones de requisitos (se ejecuta con --precheckOnly).

P: ¿Qué ocurre si falla la operación en un entorno de Data Guard?

R: Asegúrese de que el comando se ha ejecutado correctamente en la base de datos en espera antes de ejecutarlo en la base de datos primaria. Compruebe si hay errores en los logs y vuelva a ejecutar la operación con los parámetros correctos.

P: ¿Puedo ejecutar el comando dbaascli tde setPrimaryHsmKey en una base de datos activa?

R: Sí, el comando se puede ejecutar mientras la base de datos está activa. Sin embargo, el uso del parámetro --bounceDatabase reiniciará la base de datos de forma sucesiva, lo que minimiza el impacto.

P: ¿Cómo ejecuto el comando de forma sucesiva para evitar un tiempo de inactividad completo?

R: Utilice el parámetro --bounceDatabase para realizar un reinicio sucesivo de la base de datos mientras cambia la clave de KMS principal:

dbaascli tde setPrimaryHsmKey --primaryKmsKeyOCID <key_OCID> --bounceDatabase

P: ¿Cuál es la importancia de cambiar la clave de KMS principal?

R: Cambiar la clave de KMS principal garantiza que la base de datos utilice una clave de cifrado actualizada o diferente para el cifrado de datos transparente (TDE). Esto puede ser necesario por razones de seguridad o cumplimiento.

P: ¿Con qué frecuencia se debe rotar o cambiar la clave de KMS principal?

R: Si bien no hay una regla estricta, las organizaciones pueden rotar la clave de KMS principal según las políticas de seguridad, como los intervalos de rotación de claves o los requisitos de cumplimiento.

P: ¿Qué sucede si la clave de KMS principal está configurada incorrectamente?

R: Si se define el OCID de clave incorrecto, es posible que fallen las operaciones de cifrado de la base de datos y que tenga que volver a la clave correcta o rectificar la configuración definiendo el OCID de clave de KMS correcto.

P: ¿Necesito reiniciar la base de datos después de cambiar la clave de KMS principal?

R: No, no es necesario reiniciar la base de datos a menos que elija utilizar el parámetro --bounceDatabase, que reiniciará automáticamente la base de datos para aplicar el cambio.

Ejemplo 7-54 dbaascli tde setPrimaryHsmKey

dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza
dbaascli tde setPrimaryHsmKey --dbname dbname --primaryKmsKeyOCID ocid1.key.oc1.eu-frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krxwllk5uxainvvxza --executePrereqs
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

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.

Preguntas frecuentes

P: ¿Qué hace el comando dbaascli tde status?

R: El comando dbaascli tde status muestra información sobre el almacén de claves de una base de datos especificada. Esto incluye detalles sobre el tipo de almacén de claves y su estado.

P: ¿Quién debe ejecutar el comando dbaascli tde status?

R: El comando se debe ejecutar como usuario oracle.

P: ¿Dónde se debe ejecutar el comando dbaascli tde status?

R: El comando se debe ejecutar en una máquina virtual de Exadata Cloud@Customer. Debe conectarse a la máquina virtual mediante SSH para ejecutar la utilidad.

P: ¿Cuál es la función del parámetro --dbname?

R: El parámetro --dbname especifica el nombre de la base de datos para la que se comprobará el estado del almacén de claves de TDE.

P: ¿Qué información devuelve el comando dbaascli tde status?

R: La salida del comando incluye el tipo de almacén de claves (por ejemplo, basado en HSM o basado en archivos) y el estado actual del almacén de claves, como si está abierto, cerrado o en algún otro estado.

P: ¿Cómo puedo saber si el almacén de claves está abierto o cerrado mediante el comando dbaascli tde status?

R: El estado del almacén de claves, incluido si está abierto o cerrado, forma parte de la salida devuelta por el comando dbaascli tde status.

P: ¿Cómo puedo comprobar el estado del almacén de claves de TDE para una base de datos específica?

R: Para comprobar el estado del almacén de claves de TDE para una base de datos específica, ejecute:

dbaascli tde status --dbname <DB_NAME>

P: ¿Puedo comprobar el estado del almacén de claves para varias bases de datos?

R: Sí, pero debe ejecutar el comando por separado para cada base de datos, especificando su nombre mediante el parámetro --dbname.

P: ¿Se puede ejecutar el comando dbaascli tde status como usuario root?

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

P: ¿Necesito permisos especiales para ejecutar el comando dbaascli tde status?

R: Sí, necesita tener privilegios de usuario de oracle y estar conectado a una máquina virtual de Exadata Cloud@Customer para ejecutar el comando.

P: ¿Qué debo hacer si recibo un error al ejecutar el comando dbaascli tde status?

R: Asegúrese de ejecutar el comando como usuario oracle y verifique que tiene los permisos necesarios y que está conectado a la máquina virtual correcta.

P: ¿Cómo puedo saber qué tipo de almacén de claves utiliza mi base de datos?

R: El tipo de almacén de claves, como si está basado en archivos o en HSM/KMS, se muestra en la salida del comando dbaascli tde status.

P: ¿Qué debo hacer si el almacén de claves está cerrado?

R: Si el almacén de claves está cerrado, es posible que deba abrirlo manualmente, según la operación que esté intentando realizar. El proceso exacto dependerá del tipo de almacén de claves y del entorno.

P: ¿Puedo ver el estado del almacén de claves para una CDB (base de datos de contenedor) o PDB (base de datos conectable)?

R: Sí, al especificar el nombre de base de datos adecuado mediante el parámetro --dbname, puede ver el estado del almacén de claves tanto para las CDB como para las PDB.

P: ¿Qué significa si el comando devuelve un error sobre la conectividad de la base de datos?

R: Esto podría indicar un problema con la conexión a la base de datos o un problema con su entorno. Asegúrese de que la base de datos se está ejecutando y de que se puede acceder a ella, y verifique la conexión SSH a la máquina virtual de Exadata Cloud@Customer.

P: ¿Qué sucede si el nombre de la base de datos es incorrecto?

R: Si el parámetro --dbname especifica una base de datos incorrecta o inexistente, el comando fallará y recibirá un mensaje de error que indica el problema.

P: ¿Cómo puedo solucionar problemas si el estado del almacén de claves indica un estado inesperado?

R: Si el estado del almacén de claves indica un estado inesperado, revise los logs de la base de datos para obtener más detalles y compruebe la configuración del almacén de claves para asegurarse de que está configurado correctamente.

P: ¿Puedo automatizar la comprobación del estado del almacén de claves para fines de supervisión?

R: Sí, puede crear un script del comando dbaascli tde status para comprobar el estado del almacén de claves periódicamente o integrarlo en las herramientas de supervisión de la base de datos.

P: ¿Cómo puedo verificar que el cifrado de datos transparente (TDE) está activado correctamente?

R: Puede verificar que TDE esté activado correctamente comprobando el estado del almacén de claves mediante el comando dbaascli tde status. Un almacén de claves válido y abierto indica que TDE está configurado correctamente.

Ejemplo 7-55 dbaascli tde status

dbaascli tde status --dbname dbname

Comandos dbaascli en desuso

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.

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

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.

Preguntas frecuentes

P: ¿Qué hace el comando dbaascli tde status?

R: El comando dbaascli tde status muestra información sobre el almacén de claves de una base de datos especificada. Esto incluye detalles sobre el tipo de almacén de claves y su estado.

P: ¿Quién debe ejecutar el comando dbaascli tde status?

R: El comando se debe ejecutar como usuario oracle.

P: ¿Dónde se debe ejecutar el comando dbaascli tde status?

R: El comando se debe ejecutar en una máquina virtual de Exadata Cloud@Customer. Debe conectarse a la máquina virtual mediante SSH para ejecutar la utilidad.

P: ¿Cuál es la función del parámetro --dbname?

R: El parámetro --dbname especifica el nombre de la base de datos para la que se comprobará el estado del almacén de claves de TDE.

P: ¿Qué información devuelve el comando dbaascli tde status?

R: La salida del comando incluye el tipo de almacén de claves (por ejemplo, basado en HSM o basado en archivos) y el estado actual del almacén de claves, como si está abierto, cerrado o en algún otro estado.

P: ¿Cómo puedo saber si el almacén de claves está abierto o cerrado mediante el comando dbaascli tde status?

R: El estado del almacén de claves, incluido si está abierto o cerrado, forma parte de la salida devuelta por el comando dbaascli tde status.

P: ¿Cómo puedo comprobar el estado del almacén de claves de TDE para una base de datos específica?

R: Para comprobar el estado del almacén de claves de TDE para una base de datos específica, ejecute:

dbaascli tde status --dbname <DB_NAME>

P: ¿Puedo comprobar el estado del almacén de claves para varias bases de datos?

R: Sí, pero debe ejecutar el comando por separado para cada base de datos, especificando su nombre mediante el parámetro --dbname.

P: ¿Se puede ejecutar el comando dbaascli tde status como usuario root?

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

P: ¿Necesito permisos especiales para ejecutar el comando dbaascli tde status?

R: Sí, necesita tener privilegios de usuario de oracle y estar conectado a una máquina virtual de Exadata Cloud@Customer para ejecutar el comando.

P: ¿Qué debo hacer si recibo un error al ejecutar el comando dbaascli tde status?

R: Asegúrese de ejecutar el comando como usuario oracle y verifique que tiene los permisos necesarios y que está conectado a la máquina virtual correcta.

P: ¿Cómo puedo saber qué tipo de almacén de claves utiliza mi base de datos?

R: El tipo de almacén de claves, como si está basado en archivos o en HSM/KMS, se muestra en la salida del comando dbaascli tde status.

P: ¿Qué debo hacer si el almacén de claves está cerrado?

R: Si el almacén de claves está cerrado, es posible que deba abrirlo manualmente, según la operación que esté intentando realizar. El proceso exacto dependerá del tipo de almacén de claves y del entorno.

P: ¿Puedo ver el estado del almacén de claves para una CDB (base de datos de contenedor) o PDB (base de datos conectable)?

R: Sí, al especificar el nombre de base de datos adecuado mediante el parámetro --dbname, puede ver el estado del almacén de claves tanto para las CDB como para las PDB.

P: ¿Qué significa si el comando devuelve un error sobre la conectividad de la base de datos?

R: Esto podría indicar un problema con la conexión a la base de datos o un problema con su entorno. Asegúrese de que la base de datos se está ejecutando y de que se puede acceder a ella, y verifique la conexión SSH a la máquina virtual de Exadata Cloud@Customer.

P: ¿Qué sucede si el nombre de la base de datos es incorrecto?

R: Si el parámetro --dbname especifica una base de datos incorrecta o inexistente, el comando fallará y recibirá un mensaje de error que indica el problema.

P: ¿Cómo puedo solucionar problemas si el estado del almacén de claves indica un estado inesperado?

R: Si el estado del almacén de claves indica un estado inesperado, revise los logs de la base de datos para obtener más detalles y compruebe la configuración del almacén de claves para asegurarse de que está configurado correctamente.

P: ¿Puedo automatizar la comprobación del estado del almacén de claves para fines de supervisión?

R: Sí, puede crear un script del comando dbaascli tde status para comprobar el estado del almacén de claves periódicamente o integrarlo en las herramientas de supervisión de la base de datos.

P: ¿Cómo puedo verificar que el cifrado de datos transparente (TDE) está activado correctamente?

R: Puede verificar que TDE esté activado correctamente comprobando el estado del almacén de claves mediante el comando dbaascli tde status. Un almacén de claves válido y abierto indica que TDE está configurado correctamente.

Ejemplo 7-56 dbaascli tde status

dbaascli tde status --dbname dbname