Uso del cliente de administración

El cliente de administración es una utilidad de línea de comandos para controlar y configurar tareas en Oracle GoldenGate y OCI GoldenGate.

Acceder a AdminClient

Utilice el cliente de administración para conectarse a OCI GoldenGate para configurar tareas y ver la información del proceso y los mensajes de log. Puede iniciar el cliente de administración de una de estas dos formas:

• Seleccione Iniciar cliente de administración en la página del despliegue.

• Inicie CloudShell y, a continuación, ejecute el cliente de administración.

  Nota: Si tiene una versión de Oracle GoldenGate Marketplace que se ejecute en una instancia informática, puede acceder a su cliente de administración para conectarse al despliegue de OCI GoldenGate.

Para los despliegues con autenticación de IAM activada, primero debe generar un token de acceso para utilizar AdminClient. Para generar un token de acceso e iniciar sesión en el cliente de administración:

1. En la barra de navegación global de Oracle Cloud, seleccione Perfil y, a continuación, Mi perfil.

2. En la página de perfil, en Recursos, seleccione Mis tokens de acceso.

3. En Generar token de acceso personal, seleccione Llama a otras API.

4. Seleccione el despliegue al que conectarse mediante el cliente de administración.

5. Defina la caducidad del token en 30 minutos.

6. Seleccione Descargar token.

7. Abra el archivo de token descargado y copie el contenido.

8. En Admin Client, ejecute el siguiente comando para conectarse al despliegue. Asegúrese de sustituir <deployment_url> por la URL de la consola desde la página de detalles del despliegue y <token> por el contenido del token descargado.

   connect <deployment_url> <token> !

Para obtener más información, consulte Cómo conectarse a GoldenGate con Federación de IDCS mediante AdminClient.

Conexión al cliente de administración a través de Cloud Shell

Para conectarse a un despliegue de OCI GoldenGate con un punto final público en Cloud Shell, ejecute los siguientes comandos:

adminclient
connect <deployment-public-url-or-ip> as <goldengate-user> password <goldengate-password> !

Nota:

• Puede encontrar la dirección IP pública y la URL del despliegue en la página de detalles del despliegue.

• Si encuentra el error, bash: adminclient: command not found, utilice los siguientes pasos para cambiar la arquitectura de Cloud Shell:

  1. En el menú Acciones de Cloud Shell, seleccione Arquitectura.

  2. En el cuadro de diálogo Arquitectura, seleccione X86_64 para la arquitectura preferida y, a continuación, seleccione Confirmar.

Si el despliegue tiene un punto final privado, debe crear un bastión, una sesión de bastión y un túnel SSH.

Nota: Por defecto, Cloud Shell limita el acceso de red a los recursos internos de OCI en la región principal de su arrendamiento a menos que haya activado la red pública gestionada de Cloud Shell. El administrador debe configurar una política de identidad para activar la red pública de Cloud Shell. Para obtener más información, consulte Redes de Cloud Shell.

Para conectarse a un despliegue de OCI GoldenGate privado en el cliente de administración:

1. En la barra del navegador global de la consola de Oracle Cloud, seleccione Cloud Shell. Si esta es la primera vez que se conecta a Cloud Shell, la conexión tardará unos instantes.

2. Puede ejecutar el siguiente comando para generar claves SSH, o bien omitir este paso y generar las claves al crear el bastión:

   ssh-keygen -t rsa

   Mantenga el nombre de archivo por defecto y no introduzca una frase de contraseña cuando se le solicite. La clave privada está en ~/ssh/id_rsa y la clave pública está en ~/ssh/id_rsa.pub.

3. En la página del despliegue, tome nota de la información de IP privada y Subred del despliegue.

4. Cree un bastión.

   1. En el menú de consola de Oracle Cloud, seleccione Identity & Security y, a continuación, seleccione Bastión.

   2. Seleccione Crear bastión.

   3. En el panel Crear bastión, introduzca un nombre y, a continuación, seleccione la misma subred en la que reside el despliegue.

   4. Para ver la lista de permitidos del bloque de CIDR, introduzca 0.0.0.0/0.

   5. Seleccione Crear bastión.

5. Crear una sesión.

   1. Cuando el bastión esté en estado Activo, en la página de detalles del bastión, seleccione Crear sesión.

   2. En Tipo de sesión, seleccione la sesión de reenvío de puerto SSH.

   3. Introduzca un nombre para la sesión.

   4. En Conectarse al destino mediante, seleccione Dirección IP y, a continuación, introduzca la IP privada del despliegue.

   5. En Puerto, introduzca 443.

   6. En Agregar clave SSH, copie y pegue el contenido de la clave pública (~/ssh/id_rsa.pub) desde Cloud Shell.

   7. Seleccione Crear sesión.

6. Cuando el estado de las sesiones de bastión esté activo, seleccione Ver comando SSH en el menú Acción (icono de puntos suspensivos).

7. En el recuadro de diálogo Ver comando SSH, introduzca la ruta a la clave privada (~/ssh/id_rsa) en lugar de <private-key> y sustituya <local-port> por el puerto de Cloud Shell que reenviará la conexión al bastión.

   Nota: Cloud Shell no permite la reenvío de puertos en un puerto con privilegios de acceso sudo, por lo que debe utilizar un puerto sin privilegios como 7443. Después de que el comando se haya realizado una vez en primer plano para agregar el host bastión a known_hosts, puede añadir un amperst y (&) al final del comando, para que se pueda ejecutar en segundo plano la siguiente vez.

8. Copie el comando y, a continuación, ejecútelo en Cloud Shell. Puede ignorar los mensajes bind: Cannot assign requested address.

9. Inicie el cliente de administración.

   adminclient

10. Conéctese al despliegue de OCI GoldenGate.

    connect 127.0.0.1:7443 as <goldengate-user> password <goldengate-password> !

    Nota: el signo de exclamación (!) al final del comando es muy importante. Sin ella, el comando falla y devuelve un error.

Uso del cliente de administración

Después de conectarse correctamente, puede ejecutar cualquiera de los siguientes comandos:

• Mostrar el estado de los procesos de OCI GoldenGate:

  info all

• Ver estadísticas del Extract:

  view stats

• Ver el contenido del archivo log ggserror:

  view messages

• Depurar archivos de pista que ya no utilicen los Extracts:

  purge exttrail <trail-file-name>

Consulte Comandos de la interfaz de línea de comandos del cliente de administración para obtener la lista completa de comandos.

Incidencias conocidas

AdminClient: Problema con el comando de perfil de información

El uso del comando de perfil de información en AdminClient devuelve el error 302.

Solución alternativa: utilice el siguiente comando de la API de REST:

GET https://<deployment URL>/services/adminsrvr/v2/config/types/ogg:managedProcessSettings/values/ogg:managedProcessSettings:Default

AdminClient: No se ha podido negociar: no se ha encontrado ningún tipo de clave de host coincidente

Cuando utilice AdminClient en Cloud Shell para conectarse al despliegue, puede que aparezca el siguiente mensaje:

FIPS mode initialized.
Unable to negotiate with <ip-address> port 22: no matching host key type found. Their offer: ssh-ed25519
Action completed. Waiting until the work request has entered state: ('SUCCEEDED',)
FIPS mode initialized.
Unable to negotiate with <ip-address> port 22: no matching host key type found. Their offer: ssh-ed25519
Cannot create ssh tunnelnel

Solución alternativa: realice los siguientes pasos:

1. Abra una nueva sesión de Cloud Shell.

2. Cree un archivo con el siguiente comando:

   cat .ssh/config

3. Introduzca lo siguiente en el archivo .ssh/config y guárdelo a continuación:

   HostkeyAlgorithms ssh-rsa,ssh-ed25519
   PubkeyAcceptedKeyTypes ssh-ed25519,ssh-rsa

4. Si hay un archivo .ssh/known_hosts existente, suprímalo.

5. Cierre la sesión de Cloud Shell.

6. Seleccione Iniciar Cliente de Administración en la página de detalles del despliegue.