Documentação do Oracle Cloud Infrastructure

Criar um Conector Local do Oracle Data Safe

Crie um conector local do Oracle Data Safe para conectar o Oracle Data Safe a um banco de dados on-premises da Oracle, um banco de dados da Oracle em uma instância de computação, um banco de dados do Oracle Cloud@Customer ou um banco de dados do Amazon RDS for Oracle.

Você pode criar até 5 conectores locais do Oracle Data Safe por região na página Conectores locais no serviço Oracle Data Safe no Oracle Cloud Infrastructure. Uma instância do conector local pode suportar até 192 conexões ativas.

Pré-requisitos para Criar um Conector Local do Oracle Data Safe

Antes de criar um conector local do Oracle Data Safe, conclua as seguintes tarefas de pré-requisito:

  • Obtenha permissão para criar um conector local do Oracle Data Safe. Consulte Recursos de Registro de Destino.

  • Certifique-se de que o(s) host(s) no qual você planeja instalar o conector local do Oracle Data Safe atenda aos requisitos de hardware e software.

Requisitos de Hardware

A Oracle recomenda que você instale o conector on-premises em uma máquina host diferente de sua máquina host de banco de dados. No entanto, você pode instalá-lo na máquina host de banco de dados, se necessário. Em um ambiente de produção, a Oracle recomenda a instalação do conector local em dois hosts Linux para alta disponibilidade. Se um dos seus hosts ficar inativo por causa de falha ou manutenção no sistema, as conexões Oracle Data Safe farão failover automaticamente para o conector local em execução no outro host e as operações contínuas do Oracle Data Safe não serão afetadas.

Certifique-se de que a máquina host na qual você instalará o conector on-premises atenda aos seguintes requisitos de hardware:

  • Mínimo de CPU: 2

  • Mínimo de RAM: 16 GB

  • Armazenamento em disco local mínimo no sistema de arquivos em que você planeja instalar o conector local:

    • 5 GB (o software de conector local mais logs exigem 100 MB)

    • /tmp espaço: 100 MB

      A recomendação de 5 GB se aplica ao local de instalação, não necessariamente ao sistema de arquivos raiz (/). Por exemplo, se o sistema de arquivos raiz tiver menos de 5 GB disponível, mas outro sistema de arquivos (como /home ou /opt) tiver espaço livre suficiente, você poderá instalar o conector nesse local. O software e os logs do conector exigem aproximadamente 100 MB.

  • Largura de banda da interface de rede: 1 Gbps

  • Conectividade de rede:

    • Conectividade de saída para o Oracle Data Safe (accesspoint.datasafe.<region>.oci.oraclecloud.com:443). Substitua <region> pela sua região; por exemplo, accesspoint.datasafe.us-ashburn-1.oci.oraclecloud.com.

    • Conectividade local com hosts/portas do listener do banco de dados de destino

Requisitos de Software

Certifique-se de que a máquina host na qual você instalará o conector on-premises atenda aos seguintes requisitos de software:

  • Sistema operacional:

    • Oracle Linux 7 ou mais recente (Linux x86-64) ou

    • Red Hat Enterprise Linux (RHEL) 8

  • Python 3.5 ou superior. Se você tiver várias versões do Python instaladas, defina o padrão para Python 3.5 ou superior ou forneça explicitamente o caminho do Python ao executar comandos.

  • Java versão 7 ou mais recente com um Java Home válido (JAVA_HOME). Antes de executar o instalador do conector, verifique se a variável de ambiente JAVA_HOME está definida como uma instalação Java suportada (a Oracle recomenda o Java 11 ou posterior). Se o JAVA_HOME não estiver definido, o instalador falhará. Veja um exemplo de Java 11:

    export JAVA_HOME=/usr/lib/jvm/java-11
export PATH=$JAVA_HOME/bin:$PATH

echo $JAVA_HOME
java -version

Observação

Observação: Para obter instruções sobre como desinstalar, atualizar, interromper e mostrar o status, consulte o arquivo README que acompanha o pacote do instalador.

Criar um Conector Local do Oracle Data Safe

  1. No menu de navegação do Oracle Cloud Infrastructure, selecione Oracle AI Database e, em Data Safe - Database Security, selecione Bancos de Dados de Destino.

    A página Banco de dados de destino é aberta.

  2. À esquerda, selecione Conectores On-Premises.

  3. À direita, selecione Criar conector on-premises.

    O painel Criar conector on-premises é aberto.

  4. Na lista drop-down, selecione o compartimento no qual você deseja armazenar o conector local.

  5. Digite um nome para o conector local.

  6. (Opcional) Digite uma descrição para o conector local.

  7. (Opcional) Para configurar a tag, selecione Adicionar tag e configure uma tag.

  8. Selecione Criar conector on-premises.

    O conector local é criado e listado na tabela. O estado do ciclo de vida inicial do conector local agora é definido como INACTIVE.

Fazer Download do Pacote de Instalação para o Conector Local do Oracle Data Safe

Você pode fazer download do pacote de instalação do conector local na página Detalhes do conector no serviço Oracle Data Safe.

  1. No menu de navegação do Oracle Cloud Infrastructure, selecione Oracle AI Database e, em Data Safe - Database Security, selecione Bancos de Dados de Destino.

    A página Banco de dados de destino é aberta.

  2. À esquerda, selecione Conectores On-Premises.

  3. À direita, selecione o conector on-premises que você criou.

    A página Informações do conector on-premises é aberta.

  4. Selecione Fazer download do pacote de instalação.

    O painel Fazer download do pacote de instalação é aberto.

  5. Informe uma senha para o bundle de instalação, confirme-a e selecione Fazer Download.

    Mantenha essa senha disponível porque você a precisa mais tarde ao instalar o conector local em um host da rede. O download do bundle de instalação é feito no local de download padrão do navegador.

  6. Copie o arquivo ZIP do pacote de instalação para uma máquina host na sua rede.

  7. Descompacte o arquivo e confirme se você tem os seguintes arquivos:

    • README - Arquivo Readme com instruções de instalação

    • connector.conf - Arquivo de configuração do Connection Manager

    • downloads/orapki.zip - Arquivo ZIP contendo um script orapki e arquivos JAR necessários

    • downloads/cman.zip - Arquivo ZIP contendo arquivos binários do Connection Manager

    • downloads/cmanora.template - Modelo de configuração do Connection Manager

    • util/datasafe_privileges.sql - Script SQL de privilégios do Oracle Data Safe. Você também pode fazer download desse script no serviço Oracle Data Safe no Oracle Cloud Infrastructure.

    • wallet/ewallet.p12 - wallet P12

    • setup.py - Script de configuração do Python para instalar o conector local

Instalar um Conector do Oracle Data Safe On-Premises

O Connection Manager, como parte da instalação do conector local, estabelece um túnel TLS para um Connection Manager na nuvem. Você pode controlar o tráfego de saída da sua máquina host para o endereço IP do Connection Manager na nuvem, que faz listening na porta 443. O endereço de um Connection Manager na nuvem é accesspoint.datasafe.REGIONNAME.oci.oraclecloud.com. Por exemplo, para a região Ashburn, o endereço é accesspoint.datasafe.us-ashburn-1.oci.oraclecloud.com. Você pode obter o endereço IP do Connection Manager na nuvem fazendo uma pesquisa de DNS.

Os itens a seguir também são instalados. Para obter mais informações sobre esses itens, consulte o Database Administrator's Guide.

  • Utilitário de controle do listener (lsnrctl)

  • Utilitário de teste de conexão (tnsping)

  1. Abra um prompt de comando em uma máquina host na qual você deseja instalar o conector local.

  2. Verifique se o JAVA_HOME está configurado e aponta para a instalação do Java.

    echo $JAVA_HOME
java -version

  3. Altere o diretório no qual você planeja instalar o conector local e execute o comando a seguir para verificar se o sistema de arquivos tem pelo menos 5 GB de espaço em disco disponível.

    df -h .

  4. Como um usuário diferente do usuário root, digite o comando a seguir para instalar o conector local.

    Não execute o instalador como o usuário root.

    Forneça um número de porta para o conector local. O argumento https-proxy é opcional. Você poderá ignorar o argumento https-proxy se o host de implantação tiver acesso público à internet. O conector local não suporta um nome de usuário e uma senha proxy.

    O proxy HTTP pode não ser suficiente, dependendo da configuração de rede e das políticas de segurança da sua organização. Por exemplo, algumas redes exigem um nome de usuário e uma senha para o proxy HTTP. Nesses casos, contate o administrador de rede para abrir conexões de saída para hosts no domínio accesspoint.oraclecloud.com usando o porta 443 sem passar por um proxy HTTP.

    O argumento create-osservice também é opcional. Ao definir essa opção como Yes, você designará o conector local como um serviço do sistema operacional. Essa designação garantirá que o conector local seja reiniciado automaticamente sempre que o sistema operacional da máquina host for reinicializado. Se esse argumento não for incluído ou definido como No, o conector local terá que ser reiniciado manualmente sempre que o sistema operacional da máquina host for reinicializado.

    O script de instalação inicia automaticamente o conector local. Este script assume que Python é alias ou symlinked para apontar para Python 3.

    $ python setup.py install --connector-port=`<port>` [--https-proxy=`<proxy:port>` --create-osservice=`<Yes or No>`]

    Exemplos:

    $ python setup.py install --connector-port=1560
$ python setup.py install --connector-port=1560 --https-proxy=https://www-proxy.exampledomain.com:80 --create-osservice=Yes

  5. No prompt, informe a senha criada quando você fez download do pacote de instalação.

    O conector local é instalado no diretório atual e iniciado automaticamente. O status do conector local no serviço Oracle Data Safe no Oracle Cloud Infrastructure agora é definido como Active.

  6. (Opcional) Para diagnosticar problemas de instalação ou executar comandos adicionais (como desinstalar, atualizar, iniciar, interromper e status), consulte o arquivo README que vem com o pacote de instalação.

Alta Disponibilidade de um Conector Local

Se você quiser aumentar a resiliência do seu conector local e torná-lo altamente disponível, instale outra instância do conector usando o mesmo pacote de instalação que você baixou para a primeira instalação em outro host ou VM. É possível iniciar ou instalar até três instâncias do mesmo conector local. Cada conector fará check-in com o Oracle Data Safe e, se uma instância do conector falhar ou estiver inacessível, o Data Safe tentará automaticamente um dos conectores restantes. Você pode ter até três cópias do conector em execução simultaneamente.

Verificar o Status de um Conector Local

Para verificar o status de um conector on-premises, informe o seguinte comando:

python setup.py status

Reiniciar um Conector Local

Para reiniciar um conector local, execute o seguinte comando:

python setup.py restart

Criando Serviço de Usuário do SO para Conectores Locais Existentes

Ao designar o conector local como um serviço de sistema operacional (SO), você pode impedir que o conector local exija uma reinicialização manual após uma reinicialização do sistema operacional da máquina host do conector local.

Para designar um conector local existente como um serviço do sistema operacional, execute o seguinte comando no conector local:

setup.py osservice --command=create

Esse comando garantirá que o conector local seja reiniciado sempre que o sistema operacional da máquina host for reinicializado.

Atualizar um Conector do Oracle Data Safe On-Premises

Você pode atualizar um conector local do Oracle Data Safe fazendo download de uma nova cópia do pacote de instalação e, em seguida, executando o script de configuração para executar a atualização.

O procedimento de download para criar e atualizar conectores on-premises é o mesmo e o pacote inclui o mesmo conjunto de arquivos. No entanto, no procedimento de atualização, você deve descompactar os arquivos do bundle no mesmo diretório em que o conector já está instalado, substituindo os arquivos existentes. Além disso, para executar uma atualização, informe o argumento update para o script setup.py em vez do argumento install.

Observação

Observação: Durante a atualização, o conector local não pode estabelecer conexão com bancos de dados de destino que possam estar usando-o. A conexão é restabelecida quando a atualização é concluída.

  1. Faça download do pacote de instalação no seu computador local na página Informações do conector local no serviço Oracle Data Safe.

    Consulte Fazer Download do Pacote de Instalação do Oracle Data Safe On-Premises Connector para obter instruções de download.

  2. Faça upload do bundle para o host no qual você deseja atualizar o conector.

  3. Descompacte o pacote no diretório em que o conector local está instalado. Isso substitui os arquivos atuais.

  4. Como usuário diferente de root, execute setup.py com o argumento update.

    $ python setup.py update

  5. Informe a senha do bundle quando solicitado.

    Enter bundle password:

Você deverá ver as seguintes mensagens:

Data Safe on-premises connector update in progress...
Updating wallet...
Data Safe on-premises connector successfully updated

Isso conclui a atualização do conector local.

Se você encontrar erros durante a atualização, consulte Solucionando Problemas de Instalação ou Atualização.

Desinstalar um Oracle Data Safe On-Premises Connector

Você pode usar o script setup.py para desinstalar um conector local do Oracle Data Safe.

  1. Faça log-on no host em que o conector local está instalado.

  2. Navegue até o diretório em que o conector local está instalado. Localize o script setup.py.

  3. Como usuário diferente de raiz, execute setup.py com o argumento uninstall.

    $ python setup.py uninstall

    No prompt, confirme se deseja desinstalar o conector:

    This will remove the Data Safe on-premises connector, please confirm (Yes/No): yes

Data Safe on-premises connector successfully uninstalled

Localizar os Arquivos de Log de um Conector Local

Os logs de configuração e gerenciamento de um conector on-premises podem ser encontrados em:

`<script_directory>`/log/

Um log de runtime do conector on-premises pode ser encontrado em:

`<script_directory>`/oracle_cman_home/log/diag/netcman/<hostName>/cust_cman/trace/cust_cman.log

Solucionando Problemas de Instalação ou Atualização

  1. Mensagem de erro: Failed to create the tunnels to Data Safe connection manager - for more details check <log file name>

    Após a instalação ou atualização, o conector local do Oracle Data Safe tenta se conectar (ou se reconectar) ao Gerenciador de Conexões do Oracle Data Safe. Esta mensagem pode não indicar um erro real. Pode aparecer se a criação do túnel for lenta. Para confirmar se o conector está funcionando, execute o comando show tunnels. Se houver um ou mais túneis (conexões), o conector local poderá se comunicar com o Connection Manager e você poderá ignorar essa mensagem.

    $ ./oracle_cman_home/bin/cmctl show tunnels -c cust_cman
    CMCTL for Linux: Version 20.0.0.0.0 - Production on 09-OCT-2021
    10:45:34
Copyright (c) 1996, 2020, Oracle. All rights reserved.
Current instance cust_cman is already started
Connecting to (address_list=(address=(protocol=TCPS)(host=localhost)(port=1520)))

Number of connections: 12.
The command completed successfully.

  2. Se ocorrer um erro durante uma update (por exemplo, se show tunnels mostrar que não há túneis), tente executar novamente o comando update. Execute uninstall e, em seguida, execute install novamente se update falhar novamente. Isso ocorre porque, depois de executar uninstall, talvez seja necessário reimportar os certificados do banco de dados se a configuração TCPS fizesse parte da instalação original.