Usando o Admin Client

Acesse AdminClient

Use AdminClient para se conectar ao OCI GoldenGate para configurar tarefas e exibir informações de processo e mensagens de log. Você pode iniciar AdminClient de duas maneiras:

Clique em Iniciar AdminClient na página de detalhes da implantação.
Inicie CloudShell e, em seguida, execute AdminClient.

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:

Na barra de navegação global do Oracle Cloud, clique em Perfil e em Meu perfil.
Em sua página de perfil, em Recursos, clique em Meus tokens de acesso.
Para Gerar token de acesso pessoal, selecione Chama outras APIs.
Selecione a implantação com a qual estabelecer conexão usando AdminClient.
Defina a expiração do token como 30 minutos.
Clique em Fazer download do token.
Abra o arquivo de token baixado e copie o conteúdo.
Em AdminClient, 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 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:

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.
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.
Na página de detalhes da implantação, anote as informações de IP Privado e Sub-rede da implantação.
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.
Criar uma sessão.
1. Depois que o banco de dados estiver em estado Ativo, clique em Criar Sessão na página de detalhes do banco de dados.
2. Para o tipo de sessão, Selecione a sessão 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. Clique em Criar Sessão.
Depois que o estado da sessão bastion estiver ativo, selecione Exibir comando SSH no menu Ação (ícone de reticências).
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.
Copie o comando e execute-o no Cloud Shell. Você pode ignorar mensagens bind: Cannot assign requested address.
Inicialize o Admin Client.
```
adminclient
```
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: Não é possível negociar com <ip-address> porta 22: nenhum tipo de chave de host correspondente foi 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: execute as seguintes etapas:

Abra uma nova sessão do Cloud Shell.
Crie um arquivo usando o seguinte comando:
```
cat .ssh/config
```

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

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

Se houver um arquivo .ssh/known_hosts existente, exclua-o.
Feche a sessão do Cloud Shell.
Clique em Iniciar Admin Client na sua página de detalhes da implantação.