Supervisión y gestión de los servidores Exadata Storage Server con ExaCLI

La utilidad de línea de comandos ExaCLI le permite realizar funciones de supervisión y gestión en los servidores de almacenamiento Exadata en una instancia de Exadata Cloud Infrastructure.

Acerca del comando ExaCLI

El comando ExaCLI proporciona un subjuego de los comandos que se encuentran en la utilidad de línea de comandos de Exadata local.

ExaCLI ofrece un subjuego de comandos que se encuentran en la utilidad de línea de comandos local de Exadata utilidad CellCLI. Esta utilidad se ejecuta en las máquinas virtuales de base de datos de Exadata Cloud Service.

Consulte la lista Comando ExaCLI de este tema para obtener información sobre los comandos disponibles.

Nombre de usuario y contraseña de Exadata Storage Server

Necesita un nombre de usuario y una contraseña para conectarse a Exadata Storage Server.

En Exadata Cloud Infrastructure, el usuario preconfigurado para Exadata Storage Server es cloud_user_clustername, donde clustername es el nombre del cluster de máquina virtual (VM) que se utilizará.

Puede determinar el nombre del cluster de VM ejecutando el siguiente comando crsctl con el usuario grid en cualquier nodo del cluster:
crsctl get cluster name

El comando IThis devuelve CRS-6724: Current cluster name is <cluster_name>

La contraseña de cloud_user_clustername está inicialmente definida en un valor aleatorio, que podrá ver al ejecutar el siguiente comando con el usuario root en cualquier nodo del cluster:
/opt/exacloud/get_cs_data.py

Devuelve una contraseña <pwd>

A continuación, pruebe con ExaCLI como raíz:
exacli -l cloud_user_<clusternmae> -c 192.168.136.14
Password: ****************************
exacli cloud_user_<cluster_name>@192.168.136.14>

Sintaxis de comandos ExaCLI

Para los destinos de Exadata Storage Server, cree los comandos utilizando la sintaxis siguiente.

Tenga en cuenta que en el ejemplo de sintaxis se asume que usted es el usuario opc de un nodo de cálculo.
exacli -c [username@]remotehost[:port] [-l username] [--xml] [--cookie-jar filename] [-e {command | 'command; command' | @batchfile}]
En este ejemplo, se muestra al usuario de un nodo de recursos informáticos de Exadata que emite el comando cómo conectarse a ExaCLI e iniciar una sesión interactiva de ExaCLI en un servidor de almacenamiento:
[opc@exacs-node1 ~]$ exacli -l cloud_user_clustername -c 192.168.136.7

Consulte Conexión a un servidor de almacenamiento con ExaCLI para obtener información sobre cómo determinar la dirección IP del servidor de almacenamiento.

Una vez conectado, ejecute comandos adicionales de la siguiente manera:
exacli cloud_user_clustername@192.168.136.7> LIST DATABASE
ASM
HRCDB
Ejemplo 2

En este ejemplo, se muestra la emisión de un único comando en un nodo de recursos informáticos que realiza lo siguiente:

  • Realiza la conexión a un servidor de almacenamiento
  • Lleva a cabo una acción LIST
  • Sale de la sesión (se especifica con el indicador "-e")
[opc@exacs-node1 ~]$ exacli -l cloud_user_clustername -c 192.168.136.7 --xml --cookie-jar -e list griddisk detail
Opción Descripción

-c [username@]remotehost o

--connect [username@]remotehost[:port]

Especifica el nodo remoto al que desea conectarse. ExaCLI solicita el nombre de usuario si no se ha especificado.

-l username o

--login-name username

Especifica el nombre de usuario con el que conectarse al nodo remoto. El usuario preconfigurado es cloud_user_clustername.
--xml Muestra la salida en formato XML.
--cookie-jar [filename]

Especifica el nombre de archivo del depósito de cookies que se va a utilizar. Si no se especifica el nombre de archivo, la cookie se almacena en un archivo JAR de cookies por defecto ubicado en HOME/.exacli/cookiejar, donde HOME es el directorio de inicio del usuario del sistema operativo que ejecuta el comando ExaCLI.

La presencia de una cookie válida permite al usuario de ExaCLI ejecutar comandos sin necesidad de conectarse a las sesiones posteriores de ExaCLI.

-e command o

-e 'command[; command]' o

-e @batchFile

Especifica los comandos ExaCLI que se deben ejecutar o un archivo por lotes. ExaCLI se cierra después de ejecutar los comandos.

Si se especifican varios comandos para que se ejecuten, debe incluirlos entre comillas simples para evitar que el shell interprete el punto y coma.

Omita esta opción para iniciar una sesión interactiva de ExaCLI.

--cert-proxy proxy[:port] Especifica el servidor proxy que se utilizará al descargar certificados. Si se omite port, se utiliza el puerto 80 por defecto.

-n o

--no-prompt

Suprime las peticiones de entradas del usuario.
  • Notas para la opción --cookie-jar:

    • El nombre de usuario y la contraseña se envían al nodo remoto para su autenticación. Si la autenticación se realiza correctamente, el nodo remoto emite una cookie (las credenciales de conexión) que se almacena en el filename especificado en el nodo de base de datos. Si no se especifica filename, la cookie se almacena en un archivo JAR de cookies por defecto ubicado en HOME/.exacli/cookiejar, donde HOME es el directorio raíz del usuario del sistema operativo que ejecuta el comando ExaCLI. Para el usuario opc, el directorio raíz es /home/opc.
    • El usuario del sistema operativo que ejecuta el comando ExaCLI es el propietario del archivo cookie-jar.
    • Un depósito de cookies puede contener varias cookies de varios usuarios en varios nodos en sesiones paralelas.
    • Las cookies se invalidan después de 24 horas.
    • Si no se encuentra la cookie o esta ya no es válida, ExaCLI solicita la contraseña. La nueva cookie se almacena en el depósito de cookies identificado con filename o en el depósito de cookies por defecto si no se especifica filename.
    • Incluso sin la opción --cookie-jar, ExaCLI busca igualmente cookies en el depósito de cookies por defecto. Sin embargo, si la cookie no existe o ya no es válida, la nueva cookie no se almacenará en el depósito de cookies por defecto si no se ha especificado la opción --cookie-jar.

  • Notas para la opción -e:

    • ExaCLI se cierra después de ejecutar los comandos.
    • Si se especifican varios comandos para que se ejecuten, asegúrese de incluirlos entre comillas simples para evitar que el shell interprete el punto y coma.
    • El archivo por lotes es un archivo de texto que contiene uno o varios comandos de ExaCLI para su ejecución.
  • Notas para la opción -n (--no-prompt):

    • Si ExaCLI necesita información adicional del usuario, por ejemplo, si necesita solicitar la contraseña al usuario (posiblemente porque no había cookies válidas en cookie-jar) o solicitar al usuario que confirme la identidad del nodo remoto, imprimirá un mensaje de error y se cerrará.

Conexión a un servidor de almacenamiento con ExaCLI

Para utilizar ExaCLI en los servidores de almacenamiento, deberá conocer la dirección IP del servidor de almacenamiento de destino.

Si no conoce la dirección IP del nodo al que desea conectarse, podrá encontrarla consultando el contenido del archivo cellip.ora.

En el siguiente ejemplo, se muestra cómo llevarlo a cabo en la línea de comandos de UNIX para un sistema de cuarto de rack. (Tenga en cuenta que un cuarto de rack tiene tres celdas de almacenamiento y que cada celda tiene dos conexiones, por lo que se mostrará un total de seis direcciones IP).
cat /etc/oracle/cell/
network-config/cellip.oracle
cell="192.168.136.5;cell="192.168.136.6"
cell="192.168.136.7;cell="192.168.136.8"
cell="192.168.136.9;cell="192.168.136.10"
Si se va a conectar a una celda de almacenamiento por primera vez mediante ExaCLI, es posible que se le solicite que acepte un certificado SSL. La salida de ExaCLI en este caso será similar a la siguiente:
exacli -l cloud_user_clustername -c 192.168.136.7 --cookie-jar
No cookies found for cloud_user_clustername@192.168.136.7
Password: *********
EXA-30016: This connection is not secure. You have asked ExaCLI to connect to cell 192.168.136.7 securely. The identity of 192.168.136.7 cannot be verified.
Got certificate from server:
C=US,ST=California,L=Redwood City,O=Oracle Corporation,OU=Oracle Exadata,CN=ed1cl03clu01-priv2.usdc2.oraclecloud.com
Do you want to accept and store this certificate? (Press y/n)

Acepte el certificado autofirmado de Oracle pulsando "y" para seguir utilizando ExaCLI.

Referencia de comandos ExaCLI

Puede ejecutar varios comandos ExaCLI para supervisar y gestionar Exadata Storage Servers asociados al cluster de VM de Oracle Cloud Infrastructure Exadata. ExaCLI le permite obtener información actualizada en tiempo real sobre Exadata Cloud Service.

Utilice el comando LIST con los siguientes servicios y objetos:

  • ACTIVEREQUEST: muestra todas las solicitudes activas que sirven actualmente los servidores de almacenamiento.
  • ALERTDEFINITION: muestra todas las alertas posibles y sus orígenes para el servidor de almacenamiento.
  • ALERTHISTORY: muestra todas las alertas que se han emitir para los servidores de almacenamiento.
  • CELL: muestra los detalles de los atributos de los servidores de almacenamiento (celdas).
    • Para mostrar atributos específicos:
      LIST CELL ATTRIBUTES A, B, C

      Muestra los valores de los atributos especificados.

    • Para mostrar todos los atributos:
      LIST CELL ATTRIBUTES ALL

      Muestra los valores de todos los atributos disponibles.

  • CELLDISK: Muestra los atributos de los discos del almacenamiento.
    LIST CELLDISK cell_disk_name DETAIL

    Muestra información detallada para el disco de celda especificado.

  • DATABASE: muestra los detalles de las bases de datos.
    LIST DATABASE

    Muestra un resumen de todas las bases de datos.

    LIST DATABASE DETAIL

    Muestra información detallada de todas las bases de datos.

    LIST DATABASE ATTRIBUTES NAME

    Muestra el atributo especificado (en este caso, el nombre) para cada base de datos.

  • FLASHCACHE: muestra los detalles de la caché flash del sistema Exadata.
    LIST FLASHCACHE DETAIL

    Muestra información detallada de la caché flash.

    LIST FLASHCACHE ATTRIBUTES attribute_name

    Muestra el atributo especificado para la caché flash.

  • FLASHCACHECONTENT: muestra los detalles de todos las páginas de la caché flash o los detalles de un identificador del objeto especificado.
    LIST FLASHCACHECONTENT DETAIL

    Muestra información detallada de todos los objetos de la caché flash.

    LIST FLASHCACHECONTENT WHERE objectNumber=12345 DETAIL

    Muestra información detallada para el objeto con el objectNumber especificado.

    Nota

    Para buscar el identificador de objeto de un objeto específico, consulte user_objects mediante el nombre del objeto para recuperar el data_object_id de una partición o tabla.

  • FLASHLOG: muestra los atributos del log flash inteligente de Oracle Exadata.
  • GRIDDISK: muestra los detalles de un disco del grid determinado. La sintaxis es similar al comando CELLDISK.
    LIST GRIDDISK grid_disk_name DETAIL

    Muestra todos los atributos del disco de cuadrícula especificado.

    LIST GRIDDISK grid_disk_name ATTRIBUTES size, name

    Muestra sólo los atributos especificados (tamaño, nombre) del disco de cuadrícula.

  • IBPORT: muestra los detalles de los puertos InfiniBand.
    LIST IBPORT DETAIL

    Muestra información detallada para todos los puertos InfiniBand.

  • IORMPROFILE: muestra cualquier perfil de IORM que se ha definido en los servidores de almacenamiento. También puede consultar el atributo de perfil en el objeto DATABASE para ver si una base de datos tiene un perfil de IORM asociado.
    LIST IORMPROFILE

    Muestra los perfiles de IORM configurados en los servidores de almacenamiento.

  • LUN: representa los números de unidad lógica (LUN) de los discos físicos en los servidores de almacenamiento.
    LIST LUN

    Muestra un resumen de todos los LUN.

    LIST LUN lun_number DETAIL

    Muestra información detallada para el LUN especificado.

  • METRICCURRRENT: muestra las métricas actuales de un tipo del objeto determinado.
    LIST METRICCURRENT WHERE objectType = 'CELLDISK'

    Muestra las métricas actuales para el tipo de objeto especificado (en este caso, CELLDISK).

    LIST METRICCURRENT ATTRIBUTES name, metricObjectName 
    ORDER BY metricObjectName ASC, name DESC LIMIT 5

    Muestra los atributos seleccionados, ordenados por metricObjectName (ascendente) y name (descendente), limitados a los 5 resultados principales.

  • METRICDEFINITION: muestra las definiciones de métricas disponibles para un tipo de objeto determinado. A continuación, estas definiciones se pueden utilizar para recuperar detalles de métricas específicas.
    LIST METRICDEFINITION WHERE objectType = cell

    Muestra todas las definiciones de métricas para el tipo de objeto (celda) especificado.

    LIST METRICDEFINITION WHERE name = IORM_MODE DETAIL

    Muestra información detallada para la métrica especificada (IORM_MODE).

  • METRICHISTORY: muestra las métricas recopiladas durante un período de tiempo especificado.
    LIST METRICHISTORY WHERE ageInMinutes < 30

    Muestra todas las métricas recopiladas en los últimos 30 minutos.

    LIST METRICHISTORY WHERE collectionTime > '2018-04-01T21:12:00-10:00'

    Muestra todas las métricas recopiladas después del registro de hora especificado.

    LIST METRICHISTORY CT_FD_IO_RQ_SM

    Muestra el historial de una métrica específica por nombre.

    LIST METRICHISTORY WHERE name LIKE 'CT_.*'

    Muestra todas las métricas con nombres que coinciden con el patrón especificado.

  • OFFLOADGROUP: muestra los atributos de los grupos de descarga que se ejecutan en los servidores de almacenamiento.
    LIST OFFLOADGROUP DETAIL

    Muestra información detallada de todos los grupos de descarga.

    LIST OFFLOADGROUP offloadgroup4

    Muestra los detalles de un grupo de descarga específico (offloadgroup4).

    LIST OFFLOADGROUP ATTRIBUTES name

    Muestra solo los atributos especificados, como el nombre, para todos los grupos de descarga.

  • PHYSICALDISK: muestra todos los discos físicos de los servidores de almacenamiento. Utilice los resultados para identificar un disco específico para una investigación más detallada.
    LIST PHYSICALDISK

    Muestra un resumen de todos los discos físicos.

    LIST PHYSICALDISK 20:10 DETAIL

    Muestra información detallada para un disco específico (20:10).

    LIST PHYSICALDISK FLASH_1_0 DETAIL

    Muestra información detallada para un disco flash específico (FLASH_1_0).

  • PLUGGABLEDATABASE: muestra todas las bases de datos conectables (PDB) del entorno.
    LIST PLUGGABLEDATABASE

    Muestra un resumen de todas las bases de datos conectables.

    LIST PLUGGABLEDATABASE pdb_name

    Muestra información detallada para la base de datos conectable especificada (pdb_name).

  • QUARANTINE: muestra todas las sentencias SQL con las que ha impedido utilizar exploraciones inteligentes.
    LIST QUARANTINE DETAIL

    Muestra información detallada de todas las sentencias SQL en cuarentena.

    LIST QUARANTINE WHERE attribute = value

    Filtra los resultados por atributos específicos mediante una cláusula WHERE.

Utilice los comandos ExaCLI CREATE, ALTER, DROP y LIST para que actúen en los siguientes objetos de Exadata Storage Server:

  • DIAGPACK: muestra los paquetes de diagnóstico y su estado en el sistema de Exadata.
    LIST DIAGPACK
    LIST DIAGPACK DETAIL

    Muestra todos los paquetes de diagnóstico, y DETAIL proporciona información ampliada.

    CREATE DIAGPACK packStartTime=2019_12_15T00_00_00

    Crea un paquete de diagnóstico a partir de la hora especificada. También puede utilizar now para capturar diagnósticos inmediatamente:

    CREATE DIAGPACK packStartTime=now
    DOWNLOAD DIAGPACK cfclcx2647_diag_2018_06_03T00_44_24_1 /tmp

    Descarga el paquete de diagnóstico especificado en el directorio /tmp (u otra ruta local).

  • IORMPLAN: gestione planes de gestor de recursos de E/S (IORM) en servidores de almacenamiento de Exadata. Puede mostrar, crear, modificar y borrar planos de IORM mediante ExaCLI.
    LIST IORMPLAN DETAIL

    Muestra todos los planes de IORM con información detallada.

    También puede utilizar CREATE IORMPLAN, ALTER IORMPLAN o DROP IORMPLAN para gestionar planes y aplicarlos a los servidores de almacenamiento según sea necesario.

    select object_name, data_object_id from user_objects where object_name = 'BIG_CENSUS';
    OBJECT_NAME               DATA_OBJECT_ID
    ----------------------------------------
    BIG_CENSUS                29152