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.

Acesse 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:

  • Clique em Iniciar Admin Client na página de detalhes da implantação.
  • Inicie 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, primeiro gere um token de acesso para usar AdminClient. Para gerar um token de acesso e fazer log-in no Admin Client:

  1. Na barra de navegação global do Oracle Cloud, clique em Perfil e, em seguida, em Meu perfil.
  2. Em sua página de perfil, em Recursos, clique em Meus tokens de acesso.
  3. Para Gerar token de acesso pessoal, selecione Chama outras APIs.
  4. Selecione a implantação com a qual estabelecer conexão usando o Admin Client.
  5. Defina a expiração do token como 30 minutos.
  6. Clique em 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 estabelecer conexão com 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 GoldenGate com o IDCS Federation usando 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 a arquitetura preferencial e clique em Confirmar.
Se a implantação tiver um ponto final privado, você deverá criar um bastion, uma sessão bastion e um túnel SSH.
Observação

Por padrão, o Cloud Shell limita o acesso da rede aos recursos internos do OCI na região home da 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 Cloud Shell Networking.

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

  1. Na barra de navegação global da console do Oracle Cloud, clique em 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 de 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 e Segurança e, em seguida, selecione Bastion.
    2. Clique em 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. Clique em Criar bastion.
  5. Criar uma sessão.
    1. Depois que o bastion estiver em um estado Ativo, na página de detalhes do bastion, clique em Criar Sessão.
    2. Para o tipo de sessão, selecione a sessão Porta SSH para encaminhamento.
    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. Clique em Criar Sessão.
  6. Depois que o estado da sessão bastion estiver ativo, selecione Exibir comando SSH no menu Ação (ícone de reticências).
  7. Na caixa de diálogo Exibir comando SSH, informe o caminho para a chave privada (~/ssh/id_rsa) no lugar de <private-key> e substitua <localport> pela porta no Cloud Shell que encaminhará a conexão ao bastion.
    Observação

    O Cloud Shell não permite o encaminhamento de porta em uma porta privilegiada com acesso sudo; portanto, você deve usar uma porta não privilegiada como 7443. Depois que o comando for executado uma vez no primeiro plano para adicionar o Bastion host a known_hosts, você poderá anexar um e comercial (&) ao final do comando para que ele possa ser executado em segundo plano na próxima vez.
  8. Copie o comando e execute-o no Cloud Shell. Você pode ignorar mensagens bind: Cannot assign requested address.
  9. Inicialize 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.