Acessando o DB2 no AIX usando LC LSX

Muitas aplicações em Lotus Notes precisam acessar bancos de dados relacionais para buscar informações ou enviar informações. Esse acesso pode ser feito via ODBC ou via LC LSX. A utilização do ODBC, teoricamente é mais fácil, mas existem alguns problemas, como por exemplo, a velocidade de acesso.

A Lotus disponibiliza dentro do Lotus Domino alguns conectores para acesso direto aos principais bancos de dados relacionais, essa biblioteca é chamada LC LSX (LotusScript Extensions for Lotus Connectors). A vantagem da utilização desta biblioteca começa pelo acesso que é mais rápido aos dados dos bancos de dados e existe uma camada de abstração para trabalhar com os dados. A utilização desta camada de abstração pode facilitar em muito a utilização de fontes de dados diferentes (Oracle, Db2, Sybase, SAP) sem a necessidade de alteração do código já construído. Nesse caso você terá que mudar somente a forma de conexão, passando os dados necessários para estabelecer a mesma.

Alguns componentes da Lotus que trabalham com a biblioteca LC LSX são o Lotus Enterprise Integrator e o Domino Enterprise Connection Services (DECS).

Após esta breve explicação sobre a biblioteca LC LSX, vou estar demonstrando como configurar o servidor Lotus Domino no AIX para utilizar esse poderoso recurso para acesso a bancos relacionais.

Como Configurar o Ambiente para usar o LC LSX no AIX

Para utilizar a biblioteca LC LSX em ambiente AIX é preciso seguir alguns passos simples de configuração, então vamos lá:

Pré-requisitos

• Instalar o Lotus Domino no AIX;
• Instalar o DB2 runtime no AIX;
• Certificar-se que o servidor onde está o Lotus Domino consegue acessar o servidor de Banco de Dados.

Os passos para a instalação do Lotus Domino e do DB2 eu não vou estar colocando aqui pois são bastante simples. Caso você tenha algum problema, poderá consultar a seguinte documentação:

• DB2 Infocenter
• Lotus Domino Infocenter
• Usando o Domino LDAP com Websphere Portal 6.1 (Parte I - Instalando o Lotus Domino) - Esse post ensina a instalar o Domino no Linux e você pode seguir como referência para o AIX, porem não deixe de consultar o Infocenter para ver as diferenças dos ambientes.

Após a instalação dos dois produtos, é necessário catalogar e testar o acesso ao banco de dados que você deseja utilizar.

Para catalogar um banco, basta fazer o login no AIX utilizando o usuário que foi criando na instalação do DB2 runtime. Por padrão o usuário é db2inst1.

Após o login digite db2 na linha de comando para acessar o utilitário do DB2.

Figura 01 - Utilitário db2

Para fazer o catálogo do banco de dados utilize o comando CATALOG DATABASE.

> catalog db remote_db_name_release as release_alias_name at node remote_db_node_alias

Após esse processo ser realizado com sucesso, o banco de dados estará catalogado em seu ambiente.

O próximo passo é fazer uma configuração no ambiente do Lotus Domino para que ele possa acessar o DB2, veja os passos abaixo:

1. Inserir o usuário utilizado pelo Lotus Domino dentro do grupo do DB2. Por padrão o nome do grupo é db2grp1.
2. Alterar o .profile localizado no diretório home do usuário utilizado pelo Lotus Domino para inserir as seguintes variáveis:

# The following three lines have been added by UDB DB2.
if [ -f /home/db2inst1//sqllib/db2profile ]; then
    . /home/db2inst1//sqllib/db2profile
fi

export LOTUS=/opt/ibm/lotus
export Notes_ExecDirectory=/opt/ibm/lotus/notes/latest/ibmpow
export PATH=/opt/ibm/lotus/bin:/lotus/data:$PATH:$LOTUS/notes/latest/ibmpow/res/$LANG:$Notes_ExecDirectory
export LIBPATH=$Notes_ExecDirectory:/usr/lib:/lib:/home/db2inst1/sqllib/lib

Figura 02 - Edição do arquivo .profile do usuário utilizado pelo Lotus Domino

Após essas alterações no ambiente, se você fez o login com o usuário do Lotus Domino faça um logout e login novamente para ele assumir as novas variáveis de ambiente.

Para você testar seu ambiente, existem dois utilitários no Lotus Domino, o LDD e o DCTEST. Esses utilitários são encontrados no seguinte diretório (usando instalação padrão):

/opt/ibm/lotus/notes/latest/ibmpow

O primeiro utilitário, LDD, verifica se todas as bibliotecas necessárias estão disponíveis para que a LC LSX funcione. Quando você executa esse utilitário e não ocorre nenhum erro o resultado deve ser algo como o apresentado abaixo:

Figura 03 - Resultado da execução do comando ldd db2.dcx

Para executar o comando basta digitar ldd <arquivo.dcx>. No caso do DB2 será ldd db2.dcx, para o Oracle ldd oracle.dcx.

O segundo passo é verificar se é possível acessar o banco de dados catalogado, para isso utilize o DCTEST. Veja abaixo:

Figura 04 - Resultado da execução do comando dctest

• No passo 1 selecione a opção DB2;
• No passo 2 informe o nome do Database catalogado, o usuário e senha para acessar o banco.

Após confirmar os dados, o utilitário irá retornar Sucesso ou Erro. Caso seja SUCESSO, você já poderá utilizar a LC LSX em suas aplicações Lotus Domino para acessar os dados de banco de dados no DB2.

Para maiores informações de como utilizar a LC LSX em sua aplicação, clique aqui.