Guia de Conexão do IBM DB2i¶

Visão Geral¶

Este guia descreve os requisitos do sistema e o que é necessário para ser instalado no aplicativo ou servidor Vinyl, para que sua instância Vinyl se comunique com seu servidor IBM DB2i series.

Pré-requisitos¶

• Para conectar seus servidores é necessário ter o Vinyl 3.2 instalado.
• É necessário um ID IBM válido para instalar o IBM i Access Client Solutions ACS Windows App Pkg English. É possível criar uma conta IBM gratuita para fazer download desse pré-requisito, caso ainda não tenha uma.

Requisitos de Sistema¶

Servidor de Banco de Dados¶

• Servidor da série IBM DB2i

Navegador da Web do Cliente¶

• Chrome: 84+
• Firefox: 73+
• Safari: 13.0.1+
• Edge: 84

Instruções de Conexão¶

Instalando o Pré-requisito IBM¶

Antes de iniciar a configuração do Vinyl para a conexão, é necessário instalar o IBM i Access Client Solutions ACS Windows App Pkg English no aplicativo ou no servidor Vinyl.

1. Acesse IBM i Access - Soluções de Cliente
2. Clique no link Downloads para IBM i Access Client Solutions
3. Efetue login com seu ID IBM
4. Na página de downloads, localize a entrada IBMiAccess_v1r1_WindowsAP_English.zip e clique no link Download
5. Após a conclusão do download, extraia o conteúdo da pasta no Vinyl ou no servidor de aplicativos
6. Na pasta raiz, navegue até Image64a e localize o arquivo executável setup.exe

7. Clique duas vezes no arquivo setup.exe e passe pelo Assistente do InstallShield

   • Para Tipo de configuração, deixe a seleção padrão como Típica:

     

   • A instalação pode levar vários minutos para ser concluída. Quando o assistente indicar que foi concluído, clique no botão Concluir para sair do assistente.

     

8. Reinicie o servidor

Configuração de Vinyl¶

Após a instalação do Pacote de Aplicativos de Soluções de Cliente do IBM i Access, será possível configurar o DB2i Data Server no Vinyl.

Adicionando um Servidor de Dados¶

1. Navegue até Vinyl IDE
2. Clique em Servidores de dados no menu Conectar

3. Clique no botão + Servidor no canto superior esquerdo do painel Servidores de Dados. Isso abrirá a página Servidor. Providencie a seguinte informação:

   

   • Nome do Servidor: Nome identificável para conexão do servidor. Por exemplo: DB2i
   • Tipo: IBM DB2 para i
   • Nome do host: O nome do hospedar do servidor Vinyl. Por exemplo: vinyldev.example.com
   • Porta: 446
   • Nome da Instância: Se você instalou o servidor com uma Instância nomeada, insira o Nome fornecido para essa Instância. Por exemplo: vinyldev

4. Expanda a seção Configurações de segurança e forneça o Nome de usuário e a Senha para o usuário do DB2i

5. Clique no botão Salvar
6. Expanda a seção Teste e clique no botão Testar Conexão. Uma conexão configurada corretamente retornará uma mensagem Sucesso!.

Solução de Problemas¶

• Se não tiver o Pacote de Aplicativos da Solução Cliente IBM i Access instalado no servidor de aplicativos, você verá a seguinte mensagem de erro ao tentar testar uma conexão com seu servidor DB2i:

  An unexpected exception occurred. Type: System.DllNotFoundException, Message: Unable to load DLL 'cwbdc.dll': The specified module could not be found. (Exception from HRESULT: 0x8007007E).
  

• A porta 446 (a porta DRDA) deve estar aberta entre o Vinyl (ou o servidor de aplicação) e o servidor DB2i. Se esta porta for bloqueada por algum firewall ou configuração de segurança, a conexão falhará e exibirá uma mensagem de erro:

  An error occurred while testing the connection.
  

Para resolver esse erro de conexão, verifique as configurações de rede ao longo do caminho do Vinyl ou do servidor de aplicativos até o servidor DB2i e certifique-se de que ele possa alcançar o IP ou nome do host e também que a porta 446 não esteja bloqueada.