# Instalar o SAP Java Connector

Para trabalhar com o conector do SAP Extractor, você precisa instalar o SAP Java Connector no servidor Qlik Talend Data Integration.

Nota informativa

A configuração de um driver apenas será necessária se você optar por trabalhar com o Gateway do Data Movement. Para obter informações sobre os benefícios do Gateway do Data Movement e quando ele é necessário, consulte [Qlik Data Gateway - Data Movement](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm).

## Configuração do SAP Java Connector

Você pode instalar o SAP Java Connector usando o utilitário de instalação do driver (recomendado) ou manualmente. A instalação manual só deve ser tentada no caso improvável de você encontrar um problema com o utilitário de instalação do driver.

### Usando o utilitário de instalação do driver para instalar o conector SAP Java

Esta seção descreve como instalar o SAP Java Connector necessário. O processo envolve o download do SAP Java Connector, sua cópia para a pasta necessária (veja abaixo) e a execução de um script que o instalará e configurará automaticamente. Você também pode executar scripts para atualizar e desinstalar o SAP Java Connector como necessário.

### Preparando a instalação

* Certifique-se de que o Python 3.6.x ou mais recente esteja instalado no servidor de gateway do Data Movement.

  O Python vem pré-instalado na maioria das distribuições do Linux. Você pode verificar qual versão do Python está instalada em seu sistema executando o seguinte comando:

  python3 --version

* Baixe o arquivo &lt;version&gt; "sapjco&lt;version&gt;.zip" do SAP Java Connector no Portal de suporte SAP. Você pode encontrar a versão compatível em binary-artifacts em /opt/qlik/gateway/movement/drivers/manifests/sapextractor.yaml. Assim que o download for concluído, copie o arquivo para:

  /opt/qlik/gateway/movement/drivers/sapextractor

### Instalando o SAP Java Connector

Para o SAP Java Connector:

1. Pare o serviço do Gateway Data Movement:

   sudo systemctl stop repagent

2. Opcionalmente, confirme se o serviço foi interrompido:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: inactive (dead) since &lt;timestamp&gt; ago

3. Na máquina do gateway do Data Movement, altere o diretório de trabalho para:

   opt/qlik/gateway/movement/drivers/bin

4. Execute o seguinte comando:

   Sintaxe:

   ./install sapextractor

   O SAP Java Connector será instalado.

5. Aguarde a conclusão da instalação (indicada por "Concluído!") e inicie o serviço do Gateway Data Movement:

   sudo systemctl start repagent

6. Opcionalmente, confirme se o serviço foi iniciado:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: active (running) since &lt;timestamp&gt; ago

### Atualizando o SAP Java Connector

Execute o comando de atualização se quiser desinstalar versões anteriores do SAP Java Connector antes de instalar o SAP Java Connector fornecido.

Para atualizar o SAP Java Connector:

1. Pare o serviço do Gateway Data Movement:

   sudo systemctl stop repagent

2. Opcionalmente, confirme se o serviço foi interrompido:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: inactive (dead) since &lt;timestamp&gt; ago

3. Na máquina do gateway do Data Movement, altere o diretório de trabalho para:

   opt/qlik/gateway/movement/drivers/bin

4. Execute o seguinte comando:

   Sintaxe:

   ./update sapextractor

   O SAP Java Connector antigo será desinstalado, e o novo SAP Java Connector será instalado.

5. Aguarde a conclusão da instalação (indicada por "Concluído!") e inicie o serviço do Gateway Data Movement:

   sudo systemctl start repagent

6. Opcionalmente, confirme se o serviço foi iniciado:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: active (running) since &lt;timestamp&gt; ago

### Desinstalando o SAP Java Connector

Execute o comando de desinstalação se quiser desinstalar o SAP Java Connector.

Para desinstalar o SAP Java Connector:

1. Pare todas as tarefas configuradas para usar esse conector.

2. Na máquina do gateway do Data Movement, altere o diretório de trabalho para:

   opt/qlik/gateway/movement/drivers/bin

3. Execute o seguinte comando:

   Sintaxe:

   ./uninstall sapextractor

   O SAP Java Connector será desinstalado.

### Instalando o SAP Java Connector manualmente

Você só deve tentar instalar o SAP Java Connector manualmente se a instalação automática do driver não for concluída com êxito.

Baixe o SAP Java Connector 3.x (64 bits) para Linux de https://support.sap.com/en/product/connectors/jco.html.

Em seguida, abra um prompt do shell e faça o seguinte:

1. Pare o serviço do Gateway Data Movement:

   sudo systemctl stop repagent

2. Opcionalmente, confirme se o serviço foi interrompido:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: inactive (dead) since &lt;timestamp&gt; ago

3. Altere o diretório de trabalho para opt/qlik/gateway/movement/bin e execute o seguinte comando:

   source arep\_login.sh

   Isso definirá o caminho de instalação do gateway Data Movement.

4. Descompacte o arquivo que você baixou em uma pasta de sua escolha.

   A pasta deve conter os arquivos Sapjco3.jar e libsapjco3.so.

5. Copie esses arquivos para o seguinte local no diretório de instalação do Gateway Data Movement:

   &lt;Gateway Data Movement\_Install\_Dir&gt;/endpoint\_srv/endpoints/SAP.

6. Inicie o serviço do Gateway Data Movement:

   sudo systemctl start repagent

7. Opcionalmente, confirme se o serviço foi iniciado:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: active (running) since &lt;timestamp&gt; ago

Nota informativa

O conector do SAP Extractor não estará disponível para seleção até que as bibliotecas de conectores Java tenham sido instaladas e o serviço Gateway Data Movement tenha sido reiniciado.