Uso de la utilidad dbaascli en Oracle Exadata Database Service en infraestructura de Exascale

Descubra cómo utilizar la utilidad dbaascli en Oracle Exadata Database Service en la infraestructura de Exascale.

Acerca del uso de la utilidad dbaascli en Oracle Exadata Database Service en infraestructura de Exascale

Puede utilizar la utilidad dbaascli para realizar varias operaciones de administración y ciclo de vida de la base de datos en Oracle Exadata Database Service en la infraestructura de Exascale

Por ejemplo, con dbaascli, puede cambiar la contraseña de un usuario de base de datos, iniciar una base de datos o gestionar bases de datos de conexión (PDB) y mucho más.

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

Para usar la utilidad, debe estar conectado a una máquina virtual de Oracle Exadata Database Service on Exascale Infrastructure.

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

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

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

Creación de bases de datos mediante dbaascli

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

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

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

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

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

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

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

    dbaascli cswlib showImages --product grid

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

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

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

Ejemplo 6-1 dbaascli cswlib showImages

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

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

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

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

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

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

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

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

Creación del directorio raíz de Oracle Database

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

Nota

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 Oracle Exadata Database Service en la infraestructura de Exascale se define como la contraseña para las credenciales SYS, SYSTEM, cartera de TDE y administrador de PDB. Utilice los siguientes procedimientos si necesita cambiar las contraseñas de una base de datos existente.

Nota

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

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

Cambio de la contraseña SYS de una base de datos de Oracle Exadata Database Service en la infraestructura de Exascale

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

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

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

Cambio de la contraseña de cartera de TDE de una base de datos de Oracle Exadata Database Service en la infraestructura de Exascale

  1. Conéctese a la máquina virtual de Oracle Exadata Database Service on Exascale Infrastructure 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 en infraestructura de Exascale con la utilidad dbaascli

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

Nota

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

Puede controlar la versión de los binarios de Oracle instalada al aprovisionar una nueva base de datos en una instancia de Oracle Exadata Database Service en la infraestructura de Exascale 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 6-2 dbaascli cswlib showImages

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

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

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

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

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

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

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

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

Descarga de una imagen de software

Puede descargar las imágenes de software disponibles en la instancia de Oracle Exadata Database Service on Exascale Infrastructure 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 en la infraestructura de Exascale.

    Los parámetros opcionales son:

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

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

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

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

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

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

Ejemplos de recopilación de datos de log de herramientas

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

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

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

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

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

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

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

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

Actualización de las herramientas en la nube mediante dbaascli

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

Se utilizan herramientas específicas de la nube en las máquinas virtuales de invitado de Oracle Exadata Database Service en la infraestructura de Exascale 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.

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

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

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

  • Requisitos previos adicionales

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

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

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

Duplicación de una base de datos entre regiones

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

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

Referencia de comandos dbaascli

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

Para usar la utilidad dbaascli, debe estar conectado a un nodo de cálculo de Oracle Exadata Database Service en la infraestructura de Exascale.

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

dbaascli admin 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 Oracle Exadata Database Service en la infraestructura de Exascale.

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 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 6-3 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 Oracle Exadata Database Service en la infraestructura de Exascale, 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 Oracle Exadata Database Service en la infraestructura de Exascale.

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 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 con el 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 del directorio raíz 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 6-4 dbaascli cswlib download --product --imageTag

dbaascli cswlib download --product database --imageTag 19.14.0.0.0

Ejemplo 6-5 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 6-6 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 6-7 dbaascli cswlib showImages

dbaascli cswlib showImages

dbaascli database addInstance

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

Requisito

  • Ejecute el comando con el usuario root.

Sintaxis

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

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 en el que 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 destinos de almacenamiento de copia de seguridad de Oracle Database, realizar copias de seguridad, consultar copias de seguridad y suprimir copias de seguridad 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 6-8 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 Oracle Exadata Database Service especificada en la infraestructura de Exascale, 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 6-9 dbaascli database bounce

dbaascli database bounce --dbname dbname

dbaascli database changepassword

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

Requisitos

Ejecute el comando como usuario root o oracle.

Sintaxis

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

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 6-10 dbaascli database changePassword

dbaascli database changepassword --dbname db19

dbaascli database convertToPDB

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

Sintaxis

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

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

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

Ejemplo 6-11 dbaascli database convertToPDB

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

dbaascli database create

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

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

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli database create --dbName {--oracleHome | --oracleHomeName}
[--dbUniqueName <value>]
[--dbSID <value>]
[--createAsCDB <value>]
[--pdbName <value>]
[--pdbAdminUserName <value>]
[--dbCharset <value>]
[--dbNCharset <value>]
[--dbLanguage <value>]
[--dbTerritory <value>]
[--sgaSizeInMB <value>]
[--pgaSizeInMB <value>]
[--datafileDestination <value>]
[--fraDestination <value>]
[--fraSizeInMB <value>]
[--nodeList <value>]
[--tdeConfigMethod <value>]
[--kmsKeyOCID <value>]
{
            [--resume [--sessionID <value>]]
            | [--revert [--sessionID <value>]]
        }
[--executePrereqs]
[--honorNodeNumberForInstance <value>]
[--lockPDBAdminAccount <value>]
[--dbcaTemplateFilePath <value>]
[--waitForCompletion]
Donde:
  • --dbname especifica el nombre de la base de datos
  • --oracleHome especifica la ubicación del directorio raíz de Oracle
  • --oracleHomeName especifica el nombre del directorio raíz de Oracle
  • --dbUniqueName especifica el nombre único de la base de datos
  • -- especifica el SID de la base de datos
  • --createAsCDB 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 --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 6-12 dbaascli database create

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

dbaascli database delete

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

Requisito

Ejecute el comando con el usuario root.

Sintaxis

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

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 el 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 6-13 dbaascli database delete

dbaascli database delete --dbname db19

dbaascli database deleteInstance

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

Requisito

  • Ejecute el comando con el usuario root.

Sintaxis

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

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 el 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 6-14 database deleteinstance

database deleteinstance --node test-node

dbaascli database Duplicate (Depurar base de datos)

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 instancia de Oracle Database duplicando una base de datos activa existente.

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

R: Debe ejecutar el comando con el 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 de 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 origen, que es necesario para duplicar la base de datos desde una base de datos 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 requisitos 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 6-15 dbaascli database duplicate

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

dbaascli database getDetails

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

Requisitos

Ejecute el comando como el usuario root o el usuario oracle

Sintaxis

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

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.

base de datos dbaascli getPDBs

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

Ejecute el comando como usuario root u oracle.

Sintaxis

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

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 usuario root o como 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 6-16 dbaascli database getPDBs --dbname

dbaascli database getPDBs --dbname apr_db1

dbaascli database modifyParameters

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

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli database modifyParameters --dbname <value> 
{
--setParameters <values>[--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 6-17 dbaascli database modifyParameters

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

dbaascli database move

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

Requisitos

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

Sintaxis

dbaascli database move
{
  --oracleHome <value> | --oracleHomeName <value>
}
--dbname <value> 
[--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 el 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 se utiliza 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 movimiento.

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.

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 6-18 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 createTemplate

Para crear plantillas de base de datos (plantillas de DBCA) que se puedan utilizar posteriormente para crear bases de datos, utilice el comando dbaascli database createTemplate.

Requisitos:

Ejecute el comando con el usuario root.

Sintaxis

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

dbaascli database createTemplate --dbname <value> --templateLocation <value> 
[--templateName <value>] 
[--rmanParallelism <value>]
Donde:
  • --dbname especifica el nombre de la base de datos.
  • --templateLocation especifica el nombre de la plantilla.
  • --rmanParallelism especifica el valor parallelsim.

dbaascli database start

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

Requisitos

Ejecute el comando con el usuario root.

Sintaxis

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

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

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 el 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 6-19 dbaascli database start

dbaascli database start --dbname dbname --mode mount

dbaascli database status

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

Requisitos

Ejecute el comando con el usuario root.

Sintaxis

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

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

Ejemplo 6-20 dbaascli database status

dbaascli database status --dbname db19

dbaascli database stop

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

Requisitos

Ejecute el comando con el usuario root.

Sintaxis

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

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

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 utilizará el modo inmediato predeterminado.

Ejemplo 6-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 actualizar 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 bases de datos en espera en 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 del punto de restauración garantizado (GRP) si la actualización de la base de datos se realiza correctamente.

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 la actualizació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 6-22 dbaascli database upgrade (comprobaciones de requisitos antes del cambio de versión)

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

dbaascli dataguard prepareStandbyBlob

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

Ejecute el comando como usuario root o oracle.

Sintaxis

dbaascli dataguard prepareStandbyBlob --dbname <value> --blobLocation <value>
Donde:
  • --dbname especifica el nombre de la instancia de Oracle Database
  • --blobLocation especifica la ubicación del directorio personalizado en la que se generará el archivo blob de base de datos en espera en un entorno de Data Guard.

Preguntas frecuentes

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

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

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

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

P: ¿Cómo puedo especificar el nombre de la 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 del cluster.

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

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

P: ¿Cómo 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.

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 el 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: Compruebe los logs de salida para ver los 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 6-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 el 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 información sobre todas las bases de datos 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 del directorio raíz de Oracle 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 6-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: 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: 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 6-25 dbaascli dbHome getDetails (utilizando la ubicación del directorio raíz de Oracle)

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

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

dbaascli dbHome getDetails --oracleHomeName home_db19c

dbaascli dbHome patch

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

Requisito

Ejecute el comando con el usuario root.

Sintaxis

dbaascli dbHome patch

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

Preguntas frecuentes

P: ¿Para qué se utiliza el comando de parche dbaascli dbHome?

R: El comando dbaascli dbHome patch se utiliza para aplicar parches al 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 con el 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 básicos de directorio raíz de Oracle por ruta de acceso de 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 dbimage purge

El comando dbimage purge elimina la imagen de software especificada del entorno de Oracle Exadata Database Service en la infraestructura de Exascale.

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

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

En el comando anterior:

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

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

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

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

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

dbaascli diag collect

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

Requisito

Ejecute el comando con el usuario root.

Sintaxis

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

    Valores válidos:

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

dbaascli diag healthCheck

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

Requisito

Ejecute el comando con el usuario root.

Sintaxis

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

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 previos 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 nodo sean correctos si se especifica.

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.

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 el 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 contienen 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 6-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 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 deben realizar parches en 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 a Oracle Grid Infrastructure en 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 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 el 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 el 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 6-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 6-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

dbaascli job getStatus

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

Requisito

Ejecute el comando con el usuario root.

Sintaxis

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

Ejemplo 6-30 dbaascli job getStatus

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

dbaascli patch db prereq

Nota

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

dbaascli pdb backup

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

Requisito

  • Ejecute el comando con el usuario root.

Sintaxis

dbaascli pdb backup --pdbName <value> --dbname <value>
        {
            --start
                {
                    [--level1]
                    | [--archival --tag <value>]
                }
            | --delete --backupTag <value>
            | --status --uuid <value>
            | --getBackupReport --json <value> --tag <value>
            | --list [--json <value>]
        }
Donde:
--pdbName: PDB name.
--dbname: Oracle Database name.
--start | --delete | --status | --getBackupReport | --list
--start: Begins PDB backup.
      [--level1 | --archival]
      [--level1: Creates a Level-1 (incremental) backup.]
      [--archival: Creates an archival full backup.]
          --tag: Specify backup tag.
--delete: Deletes archival backup.
          --backupTag: Specify backup tag to delete.
--status
          --uuid <value>
--getBackupReport: Returns backup report.
         --json: Specify the file name for JSON output.
         --tag: Specify backup tag.
--list: Returns PDB backup information.
         [--json: Specify the file name for JSON output.]

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 6-31 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 sólo 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 6-32 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 conectable (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. Si se completa 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 6-33 dbaascli pdb close

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

dbaascli pdb getConnectString

Para mostrar la información de la cadena de conexión de Oracle Net 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 cadena de conexión de Red de Oracle para 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 6-34 dbaascli pdb getConnectString

dbaascli pdb getConnectString --dbname dbname --pdbName pdbName

dbaascli pdb create

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

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

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

    Los parámetros blobLocation y standbyBlobFromPrimary se excluyen mutuamente.

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

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 conectable (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 sin 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 6-35 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 createSnapshot

Para crear una instantánea de una base de datos de conexión (PDB) determinada, utilice el comando dbaascli pdb createSnapshot.

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

dbaascli pdb createSnapshot
{
    --pdbName <value> | --pdbUID <value>
}
--dbName <value>
--snapshotName <value>
[--pdbAdminUserName <value>]
[--executePrereqs] [--resume [--sessionID <value>]]
[--waitForCompletion true|false]

Donde:

  • --pdbName especifica el nombre de la PDB a partir del cual se va a crear la instantánea.
  • --pdbUID especifica el ID de usuario (UID) de la PDB desde la que se va a crear la instantánea.
  • --dbName Nombre de Oracle Database.
  • --snapshotName especifica el nombre de la instantánea de PDB.
  • --pdbAdminUserName especifica el nombre de usuario del administrador de la PDB.
  • --executePrereqs ejecuta las comprobaciones de requisitos e informa de los resultados.
  • --resume [--sessionID <value>] reanuda la operación anterior. Puede utilizar el indicador --sessionID <value> para especificar que se reanude desde un ID de sesión específico (<value>).
  • --waitForCompletion true|false especifica si se debe ejecutar la operación en primer plano (true) o en segundo plano (false). Valores válidos: true, false.

Ejemplo 6-36 dbaascli pdb createSnapshot

En el siguiente ejemplo, se crea una instantánea a partir de la base de datos denominada db721, en el nombre de PDB pdb1. El nombre de instantánea que se proporciona es snap1.

dbaascli pdb createSnapshot --dbName db721 --pdbName pdb1 --snapshotName snap1

dbaascli pdb configureSnapshot

Para configurar instantáneas automáticas para una base de datos de conexión (PDB) determinada, utilice el comando dbaascli pdb configureSnapshot.

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

dbaascli pdb configureSnapshot
{
    --pdbName <value> | --pdbUID <value>
}
--dbName <value>
--snapshotIntervalInMins <value>
[--executePrereqs]
[--maxPDBSnapshots <value>]
[--waitForCompletion <value>]

Donde:

  • --pdbName <value> especifica el nombre de la PDB para la que se definirá la configuración de instantánea automática.
  • --pdbUID <value> especifica el ID de usuario (UID) de la PDB para la que se definirá la configuración de instantánea automática.
  • --dbName Nombre de Oracle Database.
  • --snapshotIntervalInMins <value> especifica el intervalo, en minutos, para el momento en que se realizarán las instantáneas automáticas de PDB.
  • --executePrereqs ejecuta las comprobaciones de requisitos e informa de los resultados.
  • --maxPDBSnapshots <value>] especifica el número máximo de instantáneas que se van a crear para la PDB indicada. .
  • --waitForCompletion true|false especifica si se debe ejecutar la operación en primer plano (true) o en segundo plano (false). Valores válidos: true, false.

Ejemplo 6-37 dbaascli pdb configureSnapshot

En el siguiente ejemplo, se configura un plan de instantánea automática en la base de datos denominada db721, en el nombre de PDB pdb1. El intervalo de instantáneas se define para ejecutar la creación automática de instantáneas cada 60 minutos.

dbaascli pdb configureSnapshot --dbName db721 --pdbName pdb1 --snapshotIntervalInMins 60

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 deleteSnapshot

Para suprimir una instantánea de una base de datos de conexión (PDB) determinada, utilice el comando dbaascli pdb deleteSnapshot.

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

dbaascli pdb deleteSnapshot
{
    --pdbName <value> | --pdbUID <value>
}
{
    --snapshotName <value> | --snapshotUID <value>
}
--dbName <value>
[--executePrereqs]
[--waitForCompletion <value>
[--resume [--sessionID <value>]
]
]

Donde:

  • --pdbName <value> especifica el nombre de la PDB para la que se definirá la configuración de instantánea automática.
  • --pdbUID <value> especifica el ID de usuario (UID) de la PDB para la que se definirá la configuración de instantánea automática.
  • --snapshotName <value> especifica el nombre de la instantánea de PDB que desea suprimir.
  • --snapshotUID <value> especifica el ID de usuario (UID) de la instantánea de PDB que desea suprimir.
  • --dbName especifica el nombre de la instancia de Oracle Database.
  • --executePrereqs ejecuta las comprobaciones de requisitos e informa de los resultados.
  • --waitForCompletion true|false especifica si se debe ejecutar la operación en primer plano (true) o en segundo plano (false). Valores válidos: true, false.
  • --resume [sessionID <value>] especifica que se reanude la operación anterior. Para especificar la reanudación desde un ID de sesión concreto, agregue el indicador sessionID y proporcione el número de ID de sesión.

Ejemplo 6-38 dbaascli pdb configureSnapshot

En el siguiente ejemplo, la instantánea de PDB snap1 se especifica para su supresión en la PDB denominada pdb1, para la base de datos denominada db721:

dbaascli pdb deleteSnapshot --dbName db721 --pdbName pdb1 --snapshotName snap1

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 6-39 dbaascli pdb getDetails

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

dbaascli pdb getSnapshot

Para obtener detalles de una instantánea de base de datos conectable (PDB) determinada, utilice el comando dbaascli pdb getSnapshot.

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

dbaascli pdb getSnapshot
{
    --pdbName <value>| --pdbUID <value>
}
{
    --snapshotName <value> | --snapshotUID <value>
}
--dbName <value>

Donde:

  • --pdbName <value> especifica el nombre de la PDB para la que desea obtener detalles.
  • --pdbUID <value> especifica el ID de usuario (UID) de la PDB para la instantánea para la que desea obtener detalles.
  • --snapshotName <value> especifica el nombre de la instantánea para la que desea obtener detalles
  • --snapshotUID <value> especifica el ID de usuario (UID) de la instantánea para la que desea obtener detalles.
  • --dbName especifica el nombre de la instancia de Oracle Database.

Ejemplo 6-40 dbaascli pdb configureSnapshot

En el siguiente ejemplo, se obtienen los detalles de la instantánea denominada snap1 en la base de datos denominada db721, en el nombre de PDB pdb1:

dbaascli pdb getSnapshot --dbName db721 --pdbName pdb1 --snapshotName snap1

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 6-41 dbaascli pdb list

dbaascli pdb list --dbname cdb name

dbaascli pdb listSnapshots

Para mostrar las instantáneas de una base de datos conectable (PDB) determinada, utilice el comando dbaascli pdb listSnapshots.

Requisito

Ejecute el comando con el usuario oracle.

Sintaxis

dbaascli pdb listSnapshots
{
    --pdbName <value> | --pdbUID <value>
}
--dbName <value>

Donde:

  • --pdbName <value> especifica el nombre de la PDB para la que se mostrarán las instantáneas.
  • --pdbUID <value> especifica el UID de la PDB para la que se mostrarán las instantáneas.
  • --dbName <value> especifica el nombre de la instancia de Oracle Database.

Ejemplo 6-42 dbaascli pdb listSnapshots

En el siguiente ejemplo, el comando muestra las instantáneas de la base de datos db721 y el nombre de la PDB pdb1:

dbaascli pdb listSnapshots --dbName db721 --pdbName pdb1

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>]
    {
      [--createFromSnapshot
        {
          --snapshotName <value>
          | --snapshotUID <value>
        }
        [--copyDataFiles]]
      | [--snapshot]
    }
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.
  • --createFromSnapshot | --snapshot
    • --createFromSnapshot especificar para crear una PDB desde una instantánea de PDB

      --snapshotName | --snapshotUID

      • --snapshotName especifique el nombre de la instantánea para crear una PDB desde una PDB.
      • --snapshotUID especifique el UID de instantánea para crear una PDB a partir de una PDB.

      --copyDataFiles especifique esta opción para omitir la copia de la instantánea.

    • --snapshot especifique para crear PDB con una copia de instantánea.

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 primaria. 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 6-43 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: Una vez completada 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 6-44 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 el 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 en una etiqueta de archivado 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 6-45 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 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] [--sourcePDBServices <value>] [--sourcePDBReadOnlyServices <value>] [--relocateAvailabilityType <value>] [--waitForCompletion <value>]
        {
            [--blobLocation <value>]
            | [--standbyBlobFromPrimary <value>]
        }
        [--upgradePDB] [--updateDBBlockCacheSize]
        {
            [--skipOpenPDB [--enableRefreshMode --refreshMode <value> [--refreshIntervalInMinutes <value>]]]
            | [--completePDBRelocate]
        }
        {
            [--dblinkUsername <value> [--honorCaseSensitiveUserName]]
            | [--dbLinkName <value>]
        }

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
  • --relocateAvailabilityType especifica una disponibilidad MAX|NORMAL para activar el reenvío de conexión del listener
  • --waitForCompletion especifica false para que se ejecute la operación en segundo plano. Valores válidos: true|false
  • --blobLocation especifica una ubicación del directorio personalizado donde se generará el archivo BLOB de base de datos en espera en un entorno 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 las operaciones de base de datos en espera.
    Nota

    Los parámetros --blobLocation se excluyen mutuamente.
  • --upgradePDB especifica true para cambiar la versión del PDB como parte de esta operación. Valores válidos : true | false.
  • --updateDBBlockCachesize especifica que la aplicación permita definir los parámetros del inicialización de db block cache size para soportar la copia del dato con distinto tamaño del bloque
  • --skipOpenPDB especifica que la PDB no se debe abrir al final de la operación actual.
    • --enableRefreshMode especifica que se active el soporte del refrescamiento de PDB en el primer paso de reubicación de PDB.
      • --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
  • --completePDBRelocate especifica que se debe completar la reubicación de la PDB si se hace como una operación de dos paso.

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 conectable (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 para el 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 del tamaño de la caché de bloques 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 hace 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 6-46 dbaascli pdb relocate

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

dbaascli pdb remoteClone

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

Ejecute el comando como usuario root o oracle.

Sintaxis

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

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

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

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 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 claves 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 primaria. 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 distingue entre mayúsculas y 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 del tamaño de la caché de bloques 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 completar la operación de clonación.

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

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 6-48 dbaascli system getDBHomes

dbaascli system getDBHomes

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 el 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 conectable (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 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 (KMS) secundaria 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 el 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 6-49 dbaascli tde addSecondaryHsmKey

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

dbaascli tde enableWalletRoot

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

Requisito

Ejecute el comando con el usuario root.

Sintaxis

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

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

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

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 el 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 6-50 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 el 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 6-51 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 el 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 6-52 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 el 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 acceso del archivo sea correcta y que tenga permisos de escritura para 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 6-53 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?

R: 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 6-54 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?

R: 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 6-55 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?

R: 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 6-56 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?

R: 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 la 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 con el 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 6-57 dbaascli tde listKeys

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

dbaascli tde removeSecondaryHsmKey

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

Requisito

Ejecute el comando con el usuario root.

Sintaxis

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

Preguntas frecuentes

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

R: 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 en la que 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 primaria. 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 ID 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 6-59 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 6-60 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 para 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 6-61 dbaascli tde status

dbaascli tde status --dbname dbname