Usando o Admin Client

O Admin Client é um utilitário de linha de comando para controlar e configurar tarefas no Oracle GoldenGate e no OCI GoldenGate.

Acessar AdminClient

Use o Admin Client para estabelecer conexão com o OCI GoldenGate para configurar tarefas e exibir informações de processo e mensagens de log. Você pode iniciar o Admin Client de duas maneiras:

• Selecione Iniciar Admin Client na página Detalhes da Disponibilização.

• Inicie o CloudShell e execute o Admin Client.

  Observação: Se você tiver uma versão do Oracle GoldenGate Marketplace em execução em uma instância do serviço Compute, poderá acessar seu Admin Client para estabelecer conexão com sua implantação do OCI GoldenGate.

Para implantações com a autenticação do IAM ativada, você deve primeiro gerar um token de acesso para usar o AdminClient. Para gerar um token de acesso e fazer log-in no Admin Client:

1. Na barra de navegação global do Oracle Cloud, selecione Perfil e Meu perfil.

2. Na página do seu perfil, em Recursos, selecione Meus tokens de acesso.

3. Para Gerar token de acesso pessoal, selecione Chama outras APIs.

4. Selecione a implantação à qual estabelecer conexão usando o Admin Client.

5. Defina a expiração do token como 30 minutos.

6. Selecione Fazer download do token.

7. Abra o arquivo de token baixado e copie o conteúdo.

8. No Admin Client, execute o comando a seguir para se conectar à sua implantação. Certifique-se de substituir o <deployment_url> pelo URL da Console na página de detalhes da implantação e o <token> pelo conteúdo do token submetido a download.

   connect <deployment_url> <token> !

Para obter mais informações, consulte Como estabelecer conexão com o GoldenGate com o IDCS Federation usando o AdminClient.

Estabelecer Conexão com o Admin Client por meio do Cloud Shell

Para estabelecer conexão com uma implantação do OCI GoldenGate com um ponto final público no Cloud Shell, execute os seguintes comandos:

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

Observação:

• Você pode encontrar o url e o endereço IP público da implantação em sua página de detalhes da implantação.

• Se você encontrar o erro, bash: adminclient: command not found, use as seguintes etapas para alterar a arquitetura do Cloud Shell:

  1. No menu Ações do Cloud Shell, selecione Arquitetura.

  2. Na caixa de diálogo Arquitetura, selecione X86_64 para arquitetura preferencial e, em seguida, selecione Confirmar.

Se a implantação tiver um ponto final privado, crie um bastion, uma sessão bastion e um túnel SSH.

Observação: Por padrão, o Cloud Shell limita o acesso à rede aos recursos internos do OCI na região home da sua tenancy, a menos que você tenha ativado a Rede Pública gerenciada pelo Cloud Shell. Seu administrador deve configurar uma política de Identidade para ativar a Rede Pública do Cloud Shell. Para obter mais informações, consulte Rede do Cloud Shell.

Para estabelecer conexão com uma implantação privada do OCI GoldenGate no Admin Client:

1. Na barra do Oracle Cloud Console Global, selecione Cloud Shell. Se essa for a primeira vez que você se conecta ao Cloud Shell, será necessário algum tempo para se conectar.

2. Você pode executar o seguinte comando para gerar chaves SSH ou ignorar esta etapa e gerar as chaves quando criar o bastion:

   ssh-keygen -t rsa

   Mantenha o nome de arquivo padrão e não digite uma frase-senha quando solicitado. A chave privada está localizada em ~/ssh/id_rsa e a chave pública está localizada em ~/ssh/id_rsa.pub.

3. Na página Detalhes da Implantação, anote as informações de IP Privado e Sub-rede da implantação.

4. Crie um Bastion.

   1. No menu da console do Oracle Cloud, selecione Identidade & Segurança e, em seguida, Bastion.

   2. Selecione Criar Bastion.

   3. No painel Criar Bastion, digite um nome e selecione a mesma sub-rede na qual a implantação reside.

   4. Para a lista de permissões do bloco CIDR, digite 0.0.0.0/0.

   5. Selecione Create bastion.

5. Criar uma sessão.

   1. Depois que o bastion estiver no estado Ativo, na página de detalhes do bastion, selecione Criar Sessão.

   2. Para o tipo de Sessão, selecione a sessão de encaminhamento da Porta SSH.

   3. Digite um nome para a sessão.

   4. Para Conectar ao destino usando, selecione Endereço IP e, em seguida, informe o IP privado da implantação.

   5. Para Porta, digite 443.

   6. Para Adicionar Chave SSH, copie e cole o conteúdo da chave pública (~/ssh/id_rsa.pub) do Cloud Shell.

   7. Selecione Criar Sessão.

6. Depois que o estado de sessão do bastion estiver ativo, selecione Exibir comando SSH no menu Ação (ícone de reticências).

7. No diálogo de comando Exibir SSH, informe o caminho para a chave privada (~/ssh/id_rsa) no lugar de <private-key> e substitua <local-port> pela porta no Cloud Shell que encaminhará a conexão para o bastion.

   Observação: O Cloud Shell não permite encaminhamento de porta em uma porta privilegiada com acesso sudo; portanto, você deve usar uma porta sem privilégios como 7443. Depois que o comando for executado uma vez em primeiro plano para adicionar o Bastion host a known_hosts, você poderá anexar um E comercial (&) ao final do comando, de modo que ele possa ser executado em segundo fundo da próxima vez.

8. Copie o comando e execute-o no Cloud Shell. Você pode ignorar mensagens bind: Cannot assign requested address.

9. Inicie o Admin Client.

   adminclient

10. Conecte-se à implantação do OCI GoldenGate.

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

    Observação: O ponto de exclamação (!) no final do comando é muito importante. Sem ele, o comando falha e retorna um erro.

Usar o Admin Client

Após a conexão bem-sucedida, você pode executar qualquer um dos seguintes comandos:

• Exiba o status dos processos do OCI GoldenGate:

  info all

• Visualizar estatísticas de seu processo Extract:

  view stats

• Exiba o conteúdo do arquivo de log ggserror:

  view messages

• Expurgar arquivos de trilha que não são mais usados pelos processos Extract:

  purge exttrail <trail-file-name>

Consulte Comandos da Interface de linha de Comando do Admin Client para obter a lista completa de comandos.

Problemas conhecidos

AdminClient: Problema com comando do perfil de informações

O uso do comando info profile no AdminClient retorna o erro 302.

Solução alternativa: Use o seguinte comando da API REST:

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

AdminClient: Não é possível negociar: nenhum tipo de chave de host correspondente encontrado

Quando você usa AdminClient no Cloud Shell para estabelecer conexão com sua implantação, pode encontrar a seguinte mensagem:

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

Solução alternativa: Conclua as seguintes etapas:

1. Abra uma nova sessão do Cloud Shell.

2. Crie um arquivo usando o seguinte comando:

   cat .ssh/config

3. Informe o seguinte no arquivo .ssh/config e salve-o:

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

4. Se houver um arquivo .ssh/known_hosts existente, exclua-o.

5. Feche a sessão do Cloud Shell.

6. Selecione Iniciar Admin Client na página de detalhes da implantação.