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.

Acceda a AdminClient

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

  • Haga clic en Iniciar AdminClient en la página de detalles del despliegue.
  • Inicie CloudShell y, a continuación, ejecute AdminClient.

Note:

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

Para despliegues con la 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, haga clic en Perfil y, a continuación, en Mi perfil.
  2. En la página de perfil, en Recursos, haga clic en Mis tokens de acceso.
  3. En Generar token de acceso personal, seleccione Llama a otras API.
  4. Seleccione el despliegue al que conectarse mediante AdminClient.
  5. Defina la caducidad del token en 30 minutos.
  6. Haga clic en Descargar token.
  7. Abra el archivo de token descargado y copie el contenido.
  8. En AdminClient, 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 How to connect to GoldenGate with IDCS Federation using 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> !

Note:

  • Puede encontrar la dirección URL y la dirección IP pública 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, haga clic en 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.

Note:

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 de navegación global de la consola de Oracle Cloud, haga clic en 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 de detalles 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 la consola de Oracle Cloud, seleccione Identidad y seguridad y, a continuación, seleccione Bastión.
    2. Haga clic en 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. Haga clic en 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, haga clic en Crear sesión.
    2. En Tipo de sesión, seleccione 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. Haga clic en Crear sesión.
  6. Cuando el estado de la sesión de bastión esté activo, seleccione Ver comando SSH en el menú Acción (ícono de puntos suspensivos).
  7. En el cuadro de diálogo Ver comando SSH, introduzca la ruta de acceso a la clave privada (~/ssh/id_rsa) en lugar de <private-key> y sustituya <localport> por el puerto de Cloud Shell que reenviará la conexión al bastión.

    Note:

    Cloud Shell no permite el reenvío del puerto en un puerto con privilegios con acceso sudo, por lo que debe utilizar un puerto sin privilegios como 7443. Después de que el comando se haya ejecutado una vez en primer plano para agregar el host bastión a known_hosts, puede agregar un amperstand (&) 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> !

    Note:

    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: no se puede negociar con <ip-address> puerto 22: no se ha encontrado ningún tipo de clave de host coincidente.

Al utilizar 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: complete 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, a continuación, guárdelo:
    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. Haga clic en Iniciar cliente de administración en la página de detalles del despliegue.