Utilisation du client d'administration

Le client d'administration est un utilitaire de ligne de commande permettant de contrôler et de configurer des tâches dans Oracle GoldenGate et GoldenGate pour OCI.

Accédez à AdminClient

Utilisez AdminClient pour vous connecter à OCI GoldenGate afin de configurer les tâches et de voir les informations sur les processus et les messages de journal. Vous pouvez lancer AdminClient de l'une des deux façons suivantes :

  • Cliquez sur Lancer AdminClient dans la page des détails du déploiement.
  • Lancez CloudShell, puis exécutez AdminClient.

Note :

Si une version du marché des applications Oracle GoldenGate s'exécute sur une instance de calcul, vous pouvez accéder à son client d'administration pour vous connecter à votre déploiement OCI GoldenGate.

Pour les déploiements avec l'authentification IAM activée, vous devez d'abord générer un jeton d'accès pour utiliser AdminClient. Pour générer un jeton d'accès et vous connecter au client d'administration :

  1. Dans la barre de navigation globale d'Oracle Cloud, cliquez sur Profil, puis sur Mon profil.
  2. Dans la page de votre profil, sous Ressources, cliquez sur Mes jetons d'accès.
  3. Pour Générer un jeton d'accès personnel, sélectionnez Appelle d'autres API.
  4. Sélectionnez le déploiement auquel vous connecter à l'aide de AdminClient.
  5. Réglez l'expiration du jeton à 30 minutes.
  6. Cliquez sur Télécharger le jeton.
  7. Ouvrez le fichier de jeton téléchargé et copiez le contenu.
  8. Dans AdminClient, exécutez la commande suivante pour vous connecter à votre déploiement. Assurez-vous de remplacer <deployment_url> par l'URL de la console à partir de la page de détails du déploiement et <token> par le contenu du jeton téléchargé.
    connect <deployment_url> <token> !

Pour plus d'informations, voir Comment se connecter à GoldenGate avec la fédération IDCS à l'aide de AdminClient.

Connexion au client d'administration au moyen de Cloud Shell

Pour vous connecter à un déploiement d'OCI GoldenGate avec un point d'extrémité public dans Cloud Shell, exécutez les commandes suivantes :
adminclient
connect <deployment-public-url-or-ip> as <goldengate-user> password <goldengate-password> !

Note :

  • Vous pouvez trouver l'URL et l'adresse IP publique du déploiement dans la page des détails du déploiement.
  • Si vous rencontrez l'erreur, bash: adminclient: command not found, utilisez les étapes suivantes pour modifier l'architecture de Cloud Shell :
    1. Dans le menu Actions de Cloud Shell, sélectionnez Architecture.
    2. Dans la boîte de dialogue Architecture, sélectionnez X86_64 pour l'architecture préférée, puis cliquez sur Confirmer.
Si le déploiement comporte un point d'extrémité privé, vous devez créer un hôte bastion, une session d'hôte bastion et un tunnel SSH.

Note :

Par défaut, Cloud Shell limite l'accès réseau aux ressources internes OCI dans la région principale de votre location, sauf si vous avez activé le réseau public géré par Cloud Shell. Votre administrateur doit configurer une politique d'identité pour activer le réseau public Cloud Shell. Pour plus d'informations, voir Réseau Cloud Shell.

Pour vous connecter à un déploiement de GoldenGate pour OCI privé dans le client d'administration :

  1. Dans la barre de navigation globale de la console Oracle Cloud, cliquez sur Cloud Shell. S'il s'agit de votre première connexion à Cloud Shell, la connexion prend quelques minutes.
  2. Vous pouvez exécuter la commande suivante pour générer des clés SSH, ou ignorer cette étape et générer les clés lorsque vous créez l'hôte bastion :
    ssh-keygen -t rsa

    Conservez le nom de fichier par défaut et n'entrez pas de phrase secrète lorsque vous y êtes invité. La clé privée se trouve dans ~/ssh/id_rsa et la clé publique, dans ~/ssh/id_rsa.pub.

  3. Dans la page des détails du déploiement, notez les informations sur l'adresse IP privée et le sous-réseau du déploiement.
  4. Créez un hôte bastion.
    1. Dans le menu de la console Oracle Cloud, sélectionnez Identité et sécurité, puis Hôte bastion.
    2. Cliquez sur Créer un hôte bastion.
    3. Dans le panneau Créer un hôte bastion, entrez un nom, puis sélectionnez le sous-réseau où réside le déploiement.
    4. Pour Liste d'autorisation du bloc CIDR, entrez 0.0.0.0/0.
    5. Cliquez sur Créer un hôte bastion.
  5. Créez une session.
    1. Une fois l'hôte bastion actif, dans sa page de détails, cliquez sur Créer une session.
    2. Pour Type de session, sélectionnez Session de réacheminement de port SSH.
    3. Entrez un nom pour la session.
    4. Pour Connexion à la cible à l'aide de, sélectionnez Adresse IP, puis entrez l'adresse IP privée du déploiement.
    5. Pour Port, entrez 443.
    6. Pour Ajouter une clé SSH, copiez et collez le contenu de la clé publique (~/ssh/id_rsa.pub) à partir de Cloud Shell.
    7. Cliquez sur Créer une session.
  6. Après l'état de la session d'hôte bastion, sélectionnez Voir la commande SSH dans le menu d'actions (icône de suspension) associé.
  7. Dans la boîte de dialogue Voir la commande SSH, entrez le chemin d'accès à la clé privée (~/ssh/id_rsa) au lieu de <private-key> et remplacez <localport> par le port de Cloud Shell qui transmettra la connexion à l'hôte bastion.

    Note :

    Cloud Shell ne permet pas le réacheminement de port sur un port privilégié avec un accès sudo. Vous devez donc utiliser un port sans privilège, par exemple 7443. Après une exécution de la commande au premier plan pour ajouter l'hôte bastion à known_hosts, vous pouvez ajouter une perluète (&) à la fin de la commande afin qu'elle puisse s'exécuter en arrière-plan la prochaine fois.
  8. Copiez la commande, puis exécutez-la dans Cloud Shell. Vous pouvez ignorer les messages bind: Cannot assign requested address.
  9. Démarrez le client d'administration.
    adminclient
  10. Connectez-vous au déploiement GoldenGate pour OCI .
    connect 127.0.0.1:7443 as <goldengate-user> password <goldengate-password> !

    Note :

    Le point d'exclamation (!) à la fin de la commande est très important. Sans lui, la commande échoue et renvoie une erreur.

Utiliser le client d'administration

Une fois la connexion établie, vous pouvez exécuter l'une des commandes suivantes :

  • Afficher le statut des processus GoldenGate pour OCI :
    info all
  • Afficher les statistiques relatives à l'extraction :
    view stats
  • Consulter le contenu du fichier journal ggserror :
    view messages
  • Éliminer les fichiers de piste qui ne sont plus utilisés par les extractions :
    purge exttrail <trail-file-name>

Voir Commandes de l'interface de ligne de commande du client d'administration pour obtenir la liste complète des commandes.

Problèmes connus

AdminClient : Impossible de négocier avec <ip-address> port 22 : aucun type de clé d'hôte correspondant n'a été trouvé.

Lorsque vous utilisez AdminClient dans Cloud Shell pour vous connecter à votre déploiement, le message suivant peut s'afficher :
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

Solution de rechange : Effectuez les étapes suivantes :

  1. Ouvrez une nouvelle session Cloud Shell.
  2. Créez un fichier à l'aide de la commande suivante :
    cat .ssh/config
  3. Entrez ce qui suit dans le fichier .ssh/config, puis enregistrez-le :
    HostkeyAlgorithms ssh-rsa,ssh-ed25519
PubkeyAcceptedKeyTypes ssh-ed25519,ssh-rsa
  4. S'il existe un fichier .ssh/known_hosts, supprimez-le.
  5. Fermez la session Cloud Shell.
  6. Cliquez sur Lancer le client d'administration dans la page des détails du déploiement.