Conteúdo


Configure o IBM Informix Web DataBlade Module 4.13 com Servidor da Web Apache (2) no UNIX ou Linux

Configure um Aplicativo da Web Básico Utilizando a Ferramenta de Administração de Módulo Web DataBlade

Comments

Antes de Iniciar

Sobre este Tutorial

Este tutorial começa com uma pequena revisão sobre os princípios básicos da arquitetura e dos componentes do Módulo Informix Web DataBlade para mostrar como eles trabalham juntos em uma solução de banco de dados ativada pela Web. Depois, o núcleo deste tutorial explica as etapas que você deve seguir para instalar e configurar o servidor da Web Apache (2) no Linux ou UNIX para trabalhar com o Informix Web DataBlade.

Neste tutorial, você vai

  • Obter uma introdução aos elementos básicos na arquitetura de um aplicativo Informix Web DataBlade no UNIX ou Linux
  • Instalar o produto Informix Web DataBlade no servidor de banco de dados e nas máquinas servidores da Web
  • Configurar um banco de dados no Informix para armazenar e entregar páginas da Web dinâmicas
  • Executar o utilitário Websetup no banco de dados e no servidor da Web para configurar o DataBlade neles
  • Configurar o servidor da Web Apache (2) para utilizar o driver Informix Web DataBlade para um diretório virtual específico que corresponda à Ferramenta de Administração do Web DataBlade

A Ferramenta de Administração do Módulo Web DataBlade é um dos poucos aplicativos da Web dinâmicos pré-construídos, desenvolvidos no Web DataBlade, que são utilizados para configurar todos os aplicativos da Web armazenados em um determinado banco de dados. Você opta por instalar esta ferramenta quando executa o utilitário de configuração do Web DataBlade (Websetup) com relação ao banco de dados onde você registrou anteriormente o Informix Web DataBlade.

Introduzindo o Módulo Informix Web DataBlade

O módulo IBM Informix Web DataBlade é uma coleta de ferramentas e funções com componentes instalados no servidor de banco de dados Informix e em servidores da Web de terceiros que ajudam a facilitar o desenvolvimento de aplicativos de banco de dados Informix inteligentes, interativos e dinâmicos ativados para Web.

Utilizando o Informix Web DataBlade, você pode construir páginas da Web utilizando suas ferramentas de desenvolvimento da Web/HTML favoritas e integrar o código específico para transação de banco de dados dinâmica e processamento de consulta. Você grava essas partes dinâmicas naquilo que chamamos de tags do Web DataBlade— cuja sintaxe é semelhante à das tags HTML normais.

Quando um cliente da Web solicita uma página, o Informix recupera a página da Web de onde ela está armazenada em um banco de dados e resolve (ou ‘explode’) essas partes de código de banco de dados dinâmico em tags do Web DataBlade no tempo de execução, substituindo essas tags por seus resultados formatados em forma de código HTML e deixando o restante do código não-Web DataBlade da página intacto. Portanto, no final, o Informix retorna o servidor da Web como página HTML pura onde as partes relacionadas ao banco de dados foram resolvidas on the fly, enquanto as partes que não são do banco de dados foram mantidas intocadas pelo Informix. O servidor da Web pode entender a página da Web resultante recebida de volta do Informix. O servidor da Web retorna esta página — entregue de fato pelo Informix — de volta para o cliente da Web que fez o pedido original.

Você pode fazer consultas (instruções SELECT), mas também outros tipos de processamento (como INSERT, DELETE, UPDATE, executar procedimento/função) nas tags do Web DataBlade. Além dessas tags SQL, esse DataBlade fornece outras tags e funções para o gerenciamento dinâmico de variáveis, persistência de sessão, loops, condições, fluxos de processamento de aplicativo e erros.

O código da página da Web original não resolvido que combina tags HTML normais ou não de banco de dados (tags não-Web DataBlade) com tags de processamento de banco de dados dinâmico (tags do Web DataBlade) é chamado AppPage e é armazenado como um objeto de tipo de dados HTML em uma tabela Informix em um banco de dados onde você registrou o Informix Web DataBlade utilizando a ferramenta Blade Manager (bladiemgr). Quando você registra o Web DataBlade em um banco de dados, ele cria o tipo de dados HTML (que pode ser visto como um CLOB ou LVARCHAR) e todas as funções para gerenciá-lo nesse banco de dados.

Embora o AppPages seja armazenado em um banco de dados com um módulo Web DataBlade registrado, essas páginas podem conter processamento de transação e SQL remoto ou distribuído com relação a outros bancos de dados transacionais que não têm o Módulo Web DataBlade registrado neles.

Cada AppPage é processado em uma transação: Todo código relacionado a banco de dados dentro dessa página é processado com sucesso ou retrocedido. Isso garante que você não terá níveis diferentes de sucesso e falha para partes de um único pedido de página. O sucesso da página é uma questão atômica para o Informix Web DataBlade. Além disso, você tem a capacidade de determinar como tratar uma operação de banco de dados com falha em seu aplicativo da Web — por exemplo, enviando uma mensagem específica de volta para o usuário ou tomando uma ação. Uma consequência desse fato é que o Web DataBlade trabalha com bancos de dados que suportam transações (modo de criação de log ativado).

A Figura 1 ilustra com o que uma página da Web dinâmica do Informix Web DataBlade (AppPage) se parece em cada estágio da resolução. Primeira ela mostra como um AppPage típico do Informix Web DataBlade aparece antes de ser resolvido por um pedido do cliente da Web com tags HTML e Informix AppPage. Depois ela mostra a página após o Informix retorná-la como resolvida apenas com tags HTML e, por fim, a última caixa mostra como a mesma página seria exibida pelo navegador da Web.

Figura 1. Estágios de Resolução de uma Página da Web Dinâmica do Informix DataBlade
How an Informix Web DataBlade dynamic web page (AppPage) looks like at every resolution stage
How an Informix Web DataBlade dynamic web page (AppPage) looks like at every resolution stage

Processe um Pedido de AppPage Dinâmico

Quando um cliente da Web pergunta ao servidor da Web sobre uma página específica em uma URL, o servidor da Web já está preparado e configurado para saber que a página fornecida nessa URL não está armazenada em seus diretórios locais, mas que está armazenada de fato no Informix e é entregue pelo servidor de banco de dados. O servidor da Web Apache sabe que uma página está em um AppPage localizado no Informix e sabe até qual banco de dados a possui, com base nas informações nesses dois arquivos na máquina servidor da Web:

  • O arquivo de configuração do Apache (httpd.conf)
  • O arquivo de configuração do Web DataBlade (web.cnf)

O servidor da Web solicita essa página do Informix, utilizando o driver CGI/API do Web DataBlade (que geralmente é chamado de Webdriver, mas o arquivo real para o Apache (2) é drvapch2.so) para estabelecer uma nova conexão com o banco de dados ou utilizar uma existente - caso o conjunto de conexões seja utilizado. Como o Webdriver é um cliente Informix, é muito importante garantir que a instalação e a configuração do Informix Client SDK no servidor da Web, incluindo acesso à rede para o servidor de banco de dados, para as variáveis de ambiente e para as configurações de SQLHOSTS, estejam corretas.

Quando o servidor de banco de dados Informix recebe esse pedido do Informix Webdriver, ele examina a configuração do aplicativo da Web (na tabela WebConfigs) para localizar qual tabela contém o AppPage solicitado. Então, o Informix recupera o código AppPage não resolvido e utiliza a função webExplode() para resolver as tags do Web DataBlade nesse AppPage. Ele processa as instruções SQL e o conteúdo dinâmico nelas para gerar a página resultante final como HTML puro.

Por fim, o Informix retorna esta página HTML pura para o servidor da Web com todas as operações de banco de dados e dinâmicas resolvidas. Não existem tags do Web DataBlade nesta página retornada, mas apenas código HTML puro. O servidor da Web recebe esta página da Web e a retorna de volta para o solicitante do cliente da Web, que interage com a página baseada nos resultados. Como esse é um aplicativo de banco de dados ativado para Web, a página retornada pode ter uma boa interface e conteúdo não-Informix (HTML, Java/JSP, Javascript, Flash, XML e outro conteúdo MIME) combinados com dados dinâmicos. A aparência e o comportamento são baseados em consultas de banco de dados, informações de sessão e operações de banco de dados no Informix. Essa página resultante pode ter controles dinâmicos (formulários e links) que permitem que o usuário faça mais processamentos com relação aos bancos de dados Informix.

A Figura 2 ilustra o pedido de AppPage e a função de cada elemento desta arquitetura de solução da Web no processo de resolução AppPage.

Figura 2. Resolução de Processo da Página da Web Dinâmica (AppPage) do Informix Web DataBlade
Informix Web DataBlade dynamic web page (AppPage) resolution process
Informix Web DataBlade dynamic web page (AppPage) resolution process

Clique aqui para uma versão grande da Figura 2.

Entenda os Componentes e a Arquitetura de Três Camadas do Módulo Informix Web DataBlade

Embora as três camadas da solução da Web possam não estar fisicamente separadas, este tutorial supõe que cada camada esteja localizada em uma máquina diferente para ilustrar melhor o processo de instalação e configuração.

A Figura 3 mostra esta arquitetura de 3 camadas e os produtos que devem ser instalados e configurados em cada nível.

Figura 3. A Arquitetura e os Produtos em uma Solução Informix Web DataBlade com Servidor Apache (2)
The 3-tier architecture and products in an Informix Web DataBlade solution with Apache (2) server
The 3-tier architecture and products in an Informix Web DataBlade solution with Apache (2) server

A Tabela 1 mostra os principais componentes do Informix Web DataBlade, onde eles estão instalados e o utilitário que você utilizar para sua configuração.

Tabela 1. Componentes do Módulo Informix Web DataBlade e as Ferramentas Utilizadas para Instalá-los e Configurá-los
ComponenteDescriçãoPara onde ele vaiUtilitário para instalação
WebdriverUm aplicativo cliente de banco de dados que compila as consultas SQL para recuperar AppPages do banco de dadosServidor da Web./websetup

(instala o componente de servidor da Web)

A função WebExplodeUma função SQL em execução no banco de dados que compila páginas HTML dinâmicas nos dados armazenados no banco de dadosBanco de dados IDSblademgr

(registra o Web DataBlade no banco de dados)

Tags e atributosUm conjunto de atributos e tags compatíveis com SGML que marcam as instruções SQL para serem executadas dinamicamente dentro de AppPages. Essas tags são chamadas de AppPage.Banco de dados IDSblademgr

(registra o Web DataBlade no banco de dados)

AppPage Builder (APB e APB2)Uma ferramenta de desenvolvimento que fornece uma interface com o usuário para criar e atualizar AppPages e para gerenciar o conteúdo do banco de dados multimídiaBanco de dados IDS./websetup

(instala o componente de banco de dados)

A Ferramenta de Administração do Módulo Web DataBlade (Admin)Uma interface baseada em navegador para criar e atualizar configurações e mapeamentos de WebdriverBanco de dados IDS./websetup

(instala o componente de banco de dados)

websetup e outros utilitáriosUtilitários para configurar e gerenciar o aplicativoO IDS e os servidores da Web./install>

(instala o Web DataBlade no INFORMIXDIR)

A seguir está a descrição de cada camada e seus produtos.

Camada do banco de dados: O Informix Dynamic Server (IDS)

A camada do banco de dados consiste na máquina servidor de banco de dados Informix nas plataformas Linux ou UNIX. Este tutorial refere-se a ela como dbserverhost.

Os produtos que você deve estalar aqui são:

Informix Dynamic Server Versão 9.40, 10.00, 11.10 ou 11.50

A instalação e a configuração deste produto não são cobertas neste artigo. Você pode consultar o guia de instalação do Informix Dynamic Server no UNIX e Linux, da versão específica que você está instalando, para obter instruções detalhadas.

Você deve ter INFORMIXDIR e PATH=$INFORMIXDIR/bin:$PATH configurados corretamente antes da instalação do IDS Certifique-se de que o IDS, o Web DataBlade e o CSDK sejam compatíveis uns com os outros. Além disso, certifique-se de que sua instância do IDS esteja configurada e ajustada corretamente para um bom desempenho.

A Tabela 2 fornece valores de referência sobre as principais informações utilizadas para nossa instância do IDS e banco de dados ativado para Web:

Tabela 2. Informações de Referência para a Parte do IDS da Solução da Web
Variável ou InformaçãoValor
INFORMIXDIR/opt/IBM/informix/iif1000
PATHInclui $INFORMIXDIR/bin: /opt/IBM/informix/iif1000/bin
Alias do TCP INFORMIXSERVERdbserver_tcp
Nome do banco de dados (para registrar o Web DataBlade)stu5
Modo de criação de log escolhido para o BDCriação de log sem buffer
Dbspace de dados onde o BD será criadodatadbs
Proprietário do ID do usuário do BDinformix
Pequeno Blob Space que vai armazenar as páginas da Websbspace1 (criado como criação de log: -Df “LOGGING=ON”)

IBM Informix Client SDK Versão: 2.90 ou Posterior (opcional)

A instalação e a configuração deste produto não são cobertas neste artigo. Você pode consultar o guia de instalação do Informix Client, da versão específica que você está instalando, para obter instruções detalhadas.

Este produto é recomendado na máquina servidor de banco de dados, embora não seja obrigatório como no caso da máquina Servidor da Web. Você deve instalar uma versão recente do Informix CSDK no mesmo INFORMIXDIR que o servidor de Banco de Dados, principalmente se esta for uma das versões clientes mais recentes.

A Tabela 3 fornece as informações de referência utilizadas para o produto Informix CSDK instalado na máquina servidor de banco de dados.

Tabela 3. Informações de Referência para Parte do Informix Client SDK no Servidor de Banco de Dados
Variável ou InformaçãoValor
INFORMIXDIR/opt/IBM/informix/iif1000

Informix Web DataBlade Versão 4.13 ou Posterior

A instalação deste produto não é coberta neste artigo. O processo de instalação para o Web DataBlade é o mesmo para ambas as máquinas, o Servidor de Banco de Dados e o Servidor da Web, embora o processo de configuração mude, já que este produto possui um componente no servidor de Banco de Dados e outro componente no servidor da Web.

O instalador Web DataBlade solicitará o diretório INFORMIXDIR para instalar o produto. O INFORMIXDIR no caso do Servidor de Banco de Dados é o diretório de instalação do IDS. Este tutorial se concentra apenas em como configurar o banco de dados de amostra ‘stu5’ para suportar funções do Web DataBlade e tipos de dados e para armazenar AppPages de aplicativos da Web. Ele não aborda o desenvolvimento de novos AppPages neste banco de dados.

No final deste tutorial, saiba como configurar seu servidor da Web Apache 2 para se conectar à Ferramenta de Administração do Web DataBlade neste banco de dados 'stu5'. A Ferramenta de Administração do Web DataBlade é um aplicativo da Web criado pelo Web DataBlade no registro que permite configurar todos os aplicativos da Web nesse banco de dados.

A Tabela 4 fornece uma referência das principais informações utilizadas para o Módulo Informix Web DataBlade instalado no servidor de banco de dados.

Tabela 4. Informações de Referência para o Módulo Informix Web DataBlade
Variável ou InformaçãoValor
INFORMIXDIR/opt/IBM/informix/iif1000
Diretório do Web DataBlade que é criado pelo instalador/opt/IBM/Informix/iif1000/extend/web.4.13.UC3
Banco de dados do IDS onde você registra o Módulo Web DataBladestu5@dbserver_tcp
Aplicativos Web DataBlade pré-configurados / empacotados que você vai instalar no banco de dados para suportar o Desenvolvimento e a Administração de Aplicativos da Web do Informix
  • admin (Ferramenta de Administração do Web DataBlade)
  • apb2 (APB2)
  • ddw (DDW)
  • apb (esquema APB –old)

Camada do Servidor da Web: O Servidor da Web de Terceiros (Apache 2)

A camada do banco de dados consiste na máquina servidor de banco de dados Informix nas plataformas Linux ou UNIX. Este tutorial refere-se a este camada como Webserverhost.

Os produtos que você deve estalar aqui são:

Servidor da Web Compatível com Apache 2: IBM HTTP Server Apache 2.0.47 (32 Bits)

Nesse caso, você instala o servidor HTTP compatível com Apache da IBM: IBM HTTP Server Apache 2.0.47 (32 bits), que é compatível com Informix Web DataBlade 4.13.UC3.

Para instalar este servidor Apache 2 específico, você precisará ter o Java 1.4.2 ou posterior instalado (e seu diretório binário incluído na variável de ambiente PATH), pois o servidor HTTP IBM utiliza um instalador baseado em Java.

No computador cliente (desktop) que você utiliza para se conectar ao host webserverhost, você vai precisar de um emulador de terminal (como PuTTY) e de um software X-Server. Esse emulador e software permitirão que você exporte a exibição de um X-Session (xterm) para sua própria máquina para ver o instalador da GUI do servidor da Web exibido em seu próprio desktop/laptop.

A Tabela 5 exibe os principais valores utilizados para nossa configuração do servidor da Web de amostra:

Tabela 5. Informações de Referência para Parte do Apache (2) da Solução da Web Instalada
Variável ou InformaçãoValor
Onde fazer o download do servidor Apache 2http://www14.software.ibm.com/webapp/download/product.jsp?s=p&id=RBAR-5LER2T&v=2.0.47.1
Local onde fizemos o download do instalador do Apache 2 no webserverhost/home/informix/apache2/HTTPServer.linux.2047.tar
Java 1.5 está localizado em/opt/java1.5/jdk32/jre/(PATH inclui /opt/java1.5/jdk32/jre/bin)
WEBSERVERDIR (Diretório de destino para nossa instalação do Apache 2)/home/informix/stu5/IHS-2.0.47.1
Porta HTTP7070
Endereço IP do desktop/laptop9.10.10.9

Informix Client SDK Versão: 2.90 ou Posterior

A instalação e a configuração deste produto não são cobertas neste artigo. Você pode consultar o guia de instalação do produto IBM Informix Client para Unix, Linux e Windows, para a versão específica que você está instalando, para obter instruções detalhadas. Este produto é obrigatório para a máquina servidor da Web. Neste servidor, você decide qual diretório de destino é seu INFORMIXDIR para esta máquina. Este é o diretório de destino para o I-CSDK e para as instalações do Informix Web DataBlade nesta máquina servidor da Web.

Após instalar o I-CSDK no INFORMIXDIR escolhido, você deve configurar essas variáveis de ambiente para permitir a conexão com o Servidor de Banco de Dados:

  • INFORMIXDIR
  • PATH=$INFORMIXDIR/bin:$PATH
  • INFORMIXSQLHOSTS
  • LD_LIBRARY_PATH (se Solaris ou Linux), LIBPATH (se AIX) ou SHLIB_PATH (se HP-UX)

O Caminho da Biblioteca deve estar apontando para este valor (exemplo com LD_LIBRARY_PATH):

LD_LIBRARY_PATH=$INFORMIXDIR/lib:$INFORMIXDIR/lib/esql:$INFORMIXDIR/lib/dmi:$LD_LIBRARY_PATH

Além disso, certifique-se de que o arquivo SQLHOSTS esteja configurado corretamente para incluir o alias TCP para o servidor Informix e de que você esteja preparado para estabelecer uma conexão a partir do webserverhost com o dbserverhost através da porta TCP/IP onde o servidor Informix está atendendo novas conexões. TCP/IP é o protocolo de comunicação recomendado entre o servidor da Web e o servidor de banco de dados. TCP/IP é recomendado através de Shared Memory (SHM), mesmo quando ambos os servidores estão na mesma máquina.

A Tabela 6 fornece os valores de amostra que utilizamos para a configuração do Informix CSDK na máquina servidor da Web:

Tabela 6. Informações para o Informix CSDK Instalado no Servidor da Web
Variável ou InformaçãoValor
INFORMIXDIR/opt/IBM/informix/iif1000
LD_LIBRARY_PATH$INFORMIXDIR/lib:$INFORMIXDIR/lib/esql:$INFORMIXDIR/lib/dmi

IBM Informix Web DataBlade Versão 4.13 ou Posterior

Se seu servidor da Web estiver localizado em uma máquina diferente do servidor de banco de dados Informix, será necessário considerar seu servidor da Web como um cliente Informix. Portanto, após instalar o Informix Client SDK (I-CSDK) em um diretório de destino de sua escolha (o diretório INFORMIXDIR nesta máquina), você precisará instalar o Informix Web DataBlade neste INFORMIXDIR também.

Certifique-se de que a versão do Web DataBlade que você está instalando seja compatível com o servidor da Web de terceiros que você instalou (Apache 2 neste caso). As versões dos servidores da Web que são suportadas por uma versão específica do Web DataBlade são documentadas nas Notas sobre o Release do Web DataBlade. Nesse caso específico, vamos instalar e fazer uma configuração básica para este servidor HTTP compatível com Apache 2: IBM HTTP Server Apache 2.0.47 (32 bits), que é indicado como certificado com o Informix Web DataBlade versão 4.13.UC3 (32 bits).

O módulo Web DataBlade suporta a maioria das interfaces de programação de aplicativos (APIs) do Servidor da Web. Cada uma dessas APIs é fornecida com o Informix Web DataBlade como um driver que, neste tutorial, é referido como Webdriver. A forma do Webdriver e o nome de seu executável ou programa binário depende do servidor da Web utilizado.

A Tabela 7 fornece os principais valores utilizamos para nossa configuração de amostra do servidor da Web:

Tabela 7. Drivers Informix Web DataBlade (Programas Webdriver) Disponíveis por Software de Servidor da Web
Servidor da WebWebdriver (API) recomendado para usoNome do arquivo
Servidores da Web Netscape/Sun iPlanet anterioresVersão NSAPI do Informix Webdriverdrivernsapi35.so
Servidores da Web Microsoft Internet Information ServerVersão ISAPI do Informix Webdriverdrvisapi.dll
Servidores da Web Apache 1 ou 2API apropriada do Apache Webdriver para Apache 1 ou 2drvapch1.o, drvapch1.so, drvapch1_ssi.o ou drvapch2.so
Todos os servidores da Web / servidores da Web não listadosDriver CGI genéricoWebdriver ou webdriver.exe

É muito importante se certificar de que você esteja utilizando a mesma arquitetura (32 bits ou 64 bits) para todos esses programas na máquina webserverhost:

  • O daemon de serviço da Web do Apache (httpd)
  • O programa do Informix Webdriver (drvapch2.so)
  • O Informix Client SDK

Por exemplo, não é possível combinar o programa do servidor da Web em 32 bits com o programa do Informix Webdriver em 64 bits ou de outra forma. Você precisa ser consistente ao utilizar a mesma arquitetura.

A Tabela 8 contém as principais informações que serão utilizadas para a instalação e a configuração do Web DataBlade no webserverhost.

Tabela 8. Informações de Referência para o Componente do Web DataBlade no Servidor da Web
Variável ou InformaçãoValor
INFORMIXDIR/opt/IBM/informix/iif1000
Diretório do Web DataBlade que é gerado/opt/IBM/Informix/iif1000/extend/web.4.13.UC3
WEBSERVERDIR (Diretório de destino para nossa instalação do Apache 2)/home/informix/stu5/IHS-2.0.47.1
WEBSERVER_TYPE (Tipo de API do Webdriver que será utilizada)APACHE
Nome do binário do Informix Webdriver para Apache 2drvapch2.so
MI_WEBCONFIG (Caminho para o arquivo de configuração do Web DataBlade)/home/informix/stu5/web.cnf
MI_WEBCONFIGDIR (Diretório onde o web.cnf vai residir)/home/informix/stu5

Camada do Cliente: O Cliente da Web de Terceiros (Navegador da Web) nas Plataformas Unix, Linux ou Windows

Finalmente, você tem uma máquina que é seu cliente da Web, que interage e faz os pedidos da página da Web para o servidor da Web. Esse computador cliente é referido aqui como ‘webclienthost’ e pode ter qualquer navegador da Web instalado. Esse é um cliente thin, portanto, nenhum produto cliente Informix é necessário. Este tutorial não mostrará nenhum processo de instalação de navegador da Web. Não existem limitadores, em termos deste tutorial, sobre o produto do navegador da Web ou Sistema Operacional no qual este cliente é executado.

Instale e Configure o IBM Informix Web DataBlade

As etapas nesta seção mostram como instalar e configurar o Informix Web DataBlade até onde você pode renderizar a Ferramenta de Administração do Informix Web DataBlade pré-construída para um determinado banco de dados em um navegador da Web.

Você pode consultar os materiais na seção Recursos para conhecer as etapas detalhadas e obter explicações adicionais sobre como instalar e configurar diferentes partes da solução Informix Web DataBlade com o servidor Apache 2.

1. Instalar e Configurar o IBM Informix Dynamic Server e uma Instância com Serviço TCP

Nós acreditamos que você já tenha discutido esta etapa, já que ela está fora do escopo deste artigo. Esta etapa deve ser executada em dbserverhost, com base nas diretrizes e nos valores de amostra mencionados anteriormente.

2. Instalar o IBM Informix Web DataBlade no dbserverhost e webserverhost

Independentemente de você instalar o produto Web DataBlade na máquina servidor de Banco de Dados (dbserverhost) ou na máquina servidor da Web (webserverhost), o procedimento para instalar o software não varia. Esta etapa precisa ser executada em ambos os servidores; ambos os hosts são referidos como serverhost..

  1. Efetue logon no host do servidor como usuário informix ou root.
  2. Certifique-se de que a variável de ambiente INFORMIXDIR esteja configurada corretamente:
     $ echo $INFORMIXDIR
     /opt/IBM/informix/iif1000
  3. Acesse o diretório onde o produto Web DataBlade foi transferido por download e execute seu instalador:

    No UNIX, normalmente, a distribuição binária do Módulo IBM Informix Web DataBlade tem a forma de um arquivo .tar. Descompacte esse arquivo .tar utilizando o comando tar com a opção -xvf e execute o script ‘install’ localizado em um diretório da Web gerado através da descompactação do pacote. Por exemplo:

     $ cd /home/products
     $ tar –vf  web.4.13.UC3.tar
     $ cd web
     $ ./install

    No Linux, o módulo Informix Web DataBlade geralmente em a forma de um arquivo de pacote .rpm (Ex.: web.4.13.UC3.LINUX.rpm). Instale-o utilizando um comando rpm com a opção -i. Você pode utilizar a opção --relocate para substituir o diretório de instalação de destino padrão para seu próprio valor INFORMIXDIR. Exemplo:

     $ rpm -i --relocate /opt/informix=/opt/IBM/informix/iif1000 web.4.13.UC3.LINUX.rpm
  4. Siga as etapas de instalação simples e mantenha os valores-padrão.
  5. Após a instalação, observe que o Informix Web DataBlade é instalado em seu diretório $INFORMIXDIR/extend. Por exemplo:
     $ cd $INFORMIXDIR/extend
     $ pwd
     /opt/IBM/informix/iif1000/extend
     $ ls -l
     total 1
     drwxr-xr-x  2 informix informix 256 2007-04-16 01:36 binaryudt.1.0
     drwxr-xr-x  2 informix informix 152 2007-04-16 01:36 ifxbuiltins.1.1
     drwxr-xr-x  2 informix informix 240 2007-04-16 01:36 ifxmngr
     drwxr-xr-x  2 informix informix 296 2007-04-16 01:36 ifxrltree.2.00
     drwxr-xr-x  4 informix informix 480 2007-04-16 01:36 krakatoa
     drwxr-xr-x  4 informix informix 408 2007-04-16 01:36 LLD.1.20.UC2
     drwxr-xr-x  2 informix informix 256 2007-04-16 01:36 mqblade.2.0
     drwxr-xr-x 11 informix informix 904 2007-08-10 16:37 web.4.13.UC3
     $

3. Criar um Banco de Dados com Criação de Log e Registrar o Web DataBlade Nele

Execute estas etapas na instância do IDS criada e configurada anteriormente.

  1. Efetue login no dbserverhost como usuário informix (nesse caso, esse usuário é proprietário de nosso banco de dados).
  2. Crie um banco de dados, nesse caso chamado stu5, com criação de log sem buffer no dbspace datadbs. Por exemplo:
     $ dbaccess
     Select: Database
     Select: Create
     Enter name: stu5
     Enter dbspace: datadbs
     Select Log type: Log

    Após essa etapa, você terá criado o banco de dados stu5@dbserver_tcp com criação de log.

  3. Antes de registrar o Web DataBlade no banco de dados stu5 recém-criado, certifique-se de que exista um espaço smart-blob- padrão configurado no parâmetro SBSPACENAME na instância ONCONFIG do IDS:
      $ onstat -c | grep SBSPACENAME
      SBSPACENAME       sbpace1     # Nome do espaço smartblob padrão
  4. Utilize o utilitário blademgr para registrar o Web DataBlade no BD stu5 recém-criado e certifique-se de que ele tenha sido registrado com sucesso:
     $ blademgrdbserver_tcp>list stu5
     Não existem módulos registrados no banco de dados stu5.
     dbserver_tcp>show modules
     6 módulos DataBlade instalados no servidor dbserver_tcp:
     ifxrltree.2.00             mqblade.2.0
     binaryudt.1.0              web.4.13.UC3
     ifxbuiltins.1.1            LLD.1.20.UC2
     Se um módulo não aparecer, verifique o log de preparação.
     dbserver_tcp>register web.4.13.UC3 stu5
     Registrar módulo web.4.13.UC3 no banco de dados stu5? [S/n]s
     Registrando módulo DataBlade... (pode levar algum tempo).
     DataBlade web.4.13.UC3 foi registrado com sucesso no banco de dados stu5.
     dbserver_tcp>list stu5
     Módulos DataBlade registrados no banco de dados stu5:
     web.4.13.UC3
     dbserver_tcp>bye
     Desconectando...

    Após essa etapa, o tipo de dados HTML e as funções do Web DataBlade, como WebExplode(), WebLint(), etc. existirão no banco de dados stu5.

4. Executar Websetup para o Componente de Banco de Dados no Banco de Dados do Informix

O utilitário Websetup é utilizado para instalar e preparar aplicativos Web DataBlade pré-construídos que você utiliza para administrar ou desenvolver novos aplicativos da Web com Informix.

A Ferramenta de Administração do Web DataBlade (um aplicativo da Web verde e amarelo abreviado como 'admin') é um aplicativo Web DataBlade em si. Entretanto, todos os seus AppPages são armazenados no banco de dados, dentro de tabelas do Web DataBlade pré-determinadas (como wbPages). Para instalar esse aplicativo administrativo, utilize o utilitário Websetup e indique que você quer instalar a ferramenta de administração no banco de dados.

Para desenvolver novos aplicativos da Web em um Web DataBlade, você pode utilizar o aplicativo baseado na Web Application Builder (APB versões 1 ou 2) ou a ferramenta de cliente/servidor Data Director for Web (DDW). Se utilizar o APB ou APB2, você só precisa indicar o utilitário Websetup para instalar os aplicativos da Web APB ou APB2, não havendo necessidade de instalar nada mais para a criação de novos aplicativos Web DataBlade. Se utilizar a ferramenta DDW para desenvolver seus novos aplicativos Web DataBlade, você precisará indicar o Websetup para instalar o esquema para as tabelas do DDW e, além disso, instalar a ferramenta de cliente/servidor (apenas Windows) DDW.

O utilitário Websetup dá a você a opção de instalar estes aplicativos:

  • admin (Ferramenta de Administração do Web DataBlade) - esquema e aplicativo
  • apb2 (APB2) - esquema e aplicativo
  • ddw (DDW) - apenas esquema (você precisa instalar a ferramenta DDW, no Windows, separadamente)
  • apb (APB - esquema old) - esquema e aplicativo

Execute o utilitário Websetup apenas com o componente de Banco de Dados na máquina servidor de banco de dados dbserverhost.

  1. Efetue login na máquina dbserverhost como usuário informix
  2. Acesse o diretório do Web DataBlade:
     $ cd $INFORMIXDIR/extend/web*
     $ pwd
     /opt/IBM/informix/iif1000/extend/web.4.13.UC3
  3. Acesse o subdiretório de instalação. Liste o conteúdo:
     $ cd install
     $ ls -l
  4. Lá, você verá o utilitário Websetup e também o arquivo web.cnf.example. Copie o web.cnf.example no diretório e altere seu nome de web.cnf.example para web.cnf utilizando este código:
     $ cp web.cnf.example /home/informix/stu5/web.cnf
  5. Execute o utilitário Websetup e siga as instruções conforme indicado (suas respostas não padrão estão em negrito). Note que a resposta padrão está entre colchetes ([]). Consulte Listagem 1 para obter essas instruções.
  6. Verifique se a variável de ambiente MI_WEBCONFIG está configurada corretamente:
     $ echo MI_WEBCONFIG/home/informix/stu5/web.cnf
  7. Agora, edite o arquivo web.cnf apontado por $MI_WEBCONFIG para remover o comentário e corrigir os valores para: INFORMIXDIR e INFORMIXSERVER na seção <setvar>:
     $ vi $MI_WEBCONFIG

    Substitua:

     <setvar>
     #INFORMIXDIR [caminho completo do S.O. para $INFORMIXDIR]
     #INFORMIXSERVER [valor de $INFORMIXSERVER]
     </setvar>

    por:

     <setvar>
     INFORMIXDIR     /opt/IBM/informix/iif1000
     INFORMIXSERVER  dbserver_tcp
     </setvar>
  8. Além disso, se for necessário, inclua uma nova linha no final do arquivo, após a área de mapeamentos, e salve o arquivo web.cnf.

5. Instalar o IBM HTTP Apache Server (IHS) 2.0.47 em um Diretório Diferente do Padrão e Iniciá-lo com uma Configuração Simples (Não-Informix Webdriver)

As etapas a seguir mostram como instalar o software IBM IHS 2.0.47, um servidor da Web compatível com Apache 2, em um diretório diferente de seu caminho da instalação padrão.

  1. Efetue logon no webserverhost utilizando um emulador de terminal como usuário informix ou root.
  2. Acesse o diretório onde o produto foi transferido por download, onde o arquivo .tar está. Por exemplo:
     $ cd /home/products/apache2
     $ ls –l
     ...
     -rw-r--r--  1 informix informix 20377600 2007-08-13 21:47 HTTPServer.linux.2047.tar
     ...
  3. Descompacte o arquivo tar IHS no diretório-pai do diretório desejado para o servidor Apache (2). Por exemplo, /home/informix/stu5/ é o diretório-pai do seu subdiretório IHS desejado IHS-2.0.47.1, portanto, executamos tar –xvf como:
     $ cd /home/informix/stu5/IHS-2.0.47.1
     $ tar –xvf /home/products/apache2/HTTPServer.linux.2047.tar .

    O comando tar -xvf cria o subdiretório IHS-2.0.47.1 sob o diretório atual /home/informix/stu5. Nós supomos que /home/informix/stu5/IHS-2.0.47.1 seja seu diretório de instalação do Servidor da Web.

  4. Altere para o diretório do servidor da Web, nesse caso, /home/informix/stu5/IHS-2.0.47.1, criado pelo arquivo .tar:
     $ cd /home/informix/stu5/IHS-2.0.47.1
  5. Neste subdiretório, você vai encontrar o arquivo setup.jar. Esse é o instalador do IHS Java. Antes de executar o instalador, verifique se você tem a versão Java™ correta instalada e visível através das configurações de PATH.

    Você precisa de Java para o instalador de GUI do servidor IHS para facilitar a mudança de um diretório de instalação de destino pré-determinado. Portanto, inclua o diretório bin para Java 1.4 ou superior na variável de ambiente PATH e verifique se você consegue ver a versão Java executando o comando java -version:

     $ PATH=/opt/java1.5/jdk32/jre/bin:$PATH
     $ java –version
  6. Como você vai executar o instalador Java baseado em GUI, será necessário alterar as configurações de EXIBIÇÃO para a configuração do seu desktop ou laptop, conforme ilustrado nas listagens de código abaixo.
     $ export DISPLAY=9.10.10.9:0.0
  7. Em seu laptop ou desktop, inicie uma Xsession utilizando software de terceiros para poder executar xterm a partir de webserverhost; esta janela do terminal aparecerá de fato em seu desktop/laptop. Por exemplo, se estiver utilizando um produto como WinaXe Plus, você poderá seguir estas etapas no desktop/laptop para iniciar uma Xsession:
    Iniciar -> WinaXe Plus -> Xsession
  8. De volta ao webserverhost, ative um x-terminal:
     $ xterm &
  9. Na janela pop-up xterm no desktop/laptop, certifique-se de que você esteja no diretório do servidor da Web (nesse caso, /home/informix/stu5/IHS-2.0.47.1) e, lá, execute o instalador baseado em GUI para o servidor da Web IHS:
    $ java -jar setup.jar
  10. Após algum tempo, um instalador GUI Java para IHS aparecerá na tela. Siga as instruções:

    Escolha o idioma desejado (escolhemos o inglês) e clique em OK.

    Figura 4. Instalador do IHS - Selecionar Idioma
    IHS Installer - Select Language
    IHS Installer - Select Language

    Quando você vir a seguinte tela Bem-vindo, clique em Avançar.

    Figura 5. Instalador do IHS - Janela Bem-vindo
    IHS Installer - Welcome window
    IHS Installer - Welcome window

    Aceite o contrato de licença, conforme ilustra a Figura 6.

    Figura 6. Instalador do IHS - Contrato de Licença
    IHS Installer - License Agreement
    IHS Installer - License Agreement

    Edite o Nome do Diretório para inserir seu caminho de destino desejado para o diretório do servidor da Web e clique em Avançar.

    Exemplo: /home/informix/stu5/IHS-2.0.47.1

    Figura 7. Instalador do IHS - Diretório de Instalação
    IHS Installer - Installation Directory
    IHS Installer - Installation Directory

    Selecione Instalação Típica e clique em Avançar como mostra a Figura 8.

    Figura 8. Instalador do IHS - Tipo de Instalação
    IHS Installer - Installation Type
    IHS Installer - Installation Type

    Após clicar em Avançar, será apresentado a você um resumo do que vai acontecer na instalação, como indica a Figura 9.

    Figura 9. Instalador do IHS - Resumo
    IHS Installer - Summary
    IHS Installer - Summary

    Selecione Avançar novamente e o processo de instalação será iniciado. A Figura 10 mostra o processo de instalação.

    Figura 10. Instalador do IHS - Instalação em Andamento (Iniciando)
    IHS Installer - Installation in Progress (beginning)
    IHS Installer - Installation in Progress (beginning)

    Após a instalação ser concluída, você receberá uma notificação de que o servidor foi instalado com sucesso (Figura 11).

    Figura 11. Instalador do IHS - Instalação Concluída com Sucesso
    IHS Installer - Installation Successfully Completed
    IHS Installer - Installation Successfully Completed

    Clique em Concluir e feche a janela xterm (emita o comando exit).

  11. Agora, no diretório do servidor da Web (/home/informix/stu5/IHS-2.0.47.1), você deverá ver o produto IHS instalado.
  12. Acesse o subdiretório bin e execute o script updateinstallpath. Esse script faz com que todos os arquivos no diretório bin se refiram ao novo diretório de instalação de destino não padrão. Esse script utiliza o diretório do IHS não padrão como entrada:
     $ cd /home/informix/stu5/IHS-2.0.47.1/bin
     $ ./updateinstallpath /home/informix/stu5/IHS-2.0.47.1
     $
  13. Edite o arquivo conf/httpd.conf do servidor da Web (no nosso caso, /home/informix/stu5/IHS-2.0.47.1/conf/httpd.conf), que é o arquivo de configuração do Apache, para fazer essas mudanças.

    Indique o nome do host do servidor da Web (no nosso caso, webserverhost) e sua porta TCP designada para o serviço httpd. Por exemplo, altere ServerName webserverhost para ServerName webserverhost:7070.

    Indique o grupo e usuário certos que iniciam o serviço Apache httpd:

    Substitua:

     Usuário nenhum
     Grupo nenhum

    Por:

     Usuário informix
     Grupo informix

    Configure a porta listener TCP/IP para HTTPD (serviço HTTP). Para isso, altere Listen 0.0.0.0:80 para Listen 0.0.0.0:7070.

  14. Inicie o IHS Apache (2) pela primeira vez, ainda sem nenhuma configuração Web DataBlade, mas apenas como um servidor da Web básico. Altere para o diretório do servidor da Web, onde você instalou o servidor IHS, e execute o script bin/apachectl start. Exemplo:
     $ cd /home/informix/stu5/IHS-2.0.47.1
     $ bin/apachectl start
     $
  15. Em sua máquina, abra uma navegador da Web e tente atingir a porta 7070 em webserverhost:

    http://webserverhost:7070/

    Esta página padrão para o servidor IHS deve ser exibida no navegador da Web:

    Figura 12. Página Padrão do IHS
    IHS Installer - Default page
    IHS Installer - Default page

    Agora você sabe que o servidor IBM IHS Apache 2 é iniciado quando não está utilizando Web DataBlade. As próximas etapas são para fazer o servidor IHS trabalhar com o Informix Web DataBlade e, especificamente, como o Informix Webdriver.

6. Executar Websetup para Instalar o Componente de Servidor da Web (Informix Webdriver para APACHE2) do Web DataBlade

Esta etapa atualiza o arquivo <webserver dir>/conf/httpd.conf (ou seja, /home/Informix/stu5/IHS-2.0.47.1/conf/httpd.conf) para fazer o servidor IHS Apache 2 carregar e reconhecer o Informix Webdriver (API do Apache 2, no nosso caso).

O Websetup também altera o arquivo web.cnf para incluir o mapeamento para o diretório virtual da Ferramenta de Administração do aplicativo Web DataBlade para um determinado banco de dados: /<dbname>/admin (isto é, /stu5/admin) que você já configurou no lado do servidor de Banco de Dados (utilizando o Websetup com o Componente de Banco de Dados na etapa anterior). Esse mapeamento no arquivo web.cnf contém todas as informações para o Webdriver para estabelecer uma conexão com o banco de dados certo do Informix e para recuperar os AppPages da Ferramenta de Administração do Web DataBlade. Depois, você configura o servidor IHS Apache 2 (alterando o arquivo httpd.conf) para configurar esse diretório virtual como URL do Webdriver.

  1. Efetue logo no webserverhost como usuário informix ou root.
  2. Desative o servidor da Web Apache. Acesse o diretório do servidor IHS Apache 2 e execute bin/apachectl stop conforme indicado pela listagem abaixo:
     $ cd /home/Informix/stu5/IHS-2.0.47.1
     $ bin/apachectl stop$
  3. Verifique se a variável de ambiente para o Caminho da Biblioteca (LD_LIBRARY_PATH para Linux, Solaris; LIBPATH para AIX e SHLIB_PATH para HP-UX) está configurada corretamente. Se não estiver, configure-a com o valor sugerido de $INFORMIXDIR/lib:$INFORMIXDIR/lib/esql:$INFORMIXDIR/lib/dmi. Por exemplo:
     $ env |grep LIB
    
     $ export LD_LIBRARY_PATH=
          $INFORMIXDIR/lib:$INFORMIXDIR/lib/esql:$INFORMIXDIR/lib/dmi:$LD_LIBRARY_PATH
    
     $ env |grep LIB
     LD_LIBRARY_PATH=/opt/IBM/informix/iif1000/lib:/opt/IBM/informix/iif1000/lib/esql:
          /opt/IBM/informix/iif1000/lib/dmi:
  4. Execute Websetup apenas para o Componente da Web e siga as instruções abaixo. Suas respostas não padrão estão em negrito. Consulte Listagem 2 para obter instruções.
  5. Verifique o arquivo web.cnf apontado pela variável de ambiente $MI_WEBCONFIG. Se deve conter o novo mapeamento para o diretório virtual correspondente à Ferramenta de Administração do Web DataBlade para o banco de dados stu5.

    Verifique se a seção de mapeamentos do arquivo web.cnf contém um novo mapeamento para o diretório virtual da Ferramenta de Administração do Web DataBlade no banco de dados stu5: /stu5/admin, com todas as informações corretas para conexão com o banco de dados stu5 e obtenha informações de configuração (da tabela WebConfigs, filtrando por config_name='admin') para o aplicativo da Web de administração. Por exemplo:

     $ more $MI_WEBCONFIG
     …
     <map path=/stu5/admin>
     database stu5
     user informix
     password 154f70bb8e80d8b91f2fb4e81169469a
     password_key 46c0d8be
     config_name admin
     config_security on
     </map>
  6. Agora que o mapeamento para o diretório virtual da ferramenta de administração, /stu5/admin, foi criado no arquivo web.cnf, antes de incluí-lo como um diretório virtual no servidor Apache, você precisa verificar a configuração do servidor da Web IHS Apache 2 para ver se o Apache está reconhecendo e carregando o módulo Informix Webdriver, que, no nosso caso, é o driver drvapch2.so.

    Abra o arquivo do IHS Apache 2, <webserver dir>/conf/httpd.conf (ou seja, /home/informix/stu5/IHS-2.0.47.1/conf/httpd.conf):

     $ cd /home/informix/stu5/IHS-2.0.47.1/
     $ vi conf/httpd.conf

    Verifique se ele contém estas linhas para garantir que o Webdriver do Apache 2 esteja sendo reconhecido e carregado pelo Apache:

     #LoadModule status_module modules/mod_status.so
     <IfModule mod_status.c>
     #Módulo IBM Informix Web DataBlade DSO Incluído
     LoadModule        informix_module       /home/informix/stu5/drvapch2.so
     ExtendedStatus On
     </IfModule>
  7. Você poderia retirar LoadModule do IfModule condicional, de modo que o módulo Web DataBlade Webdriver seja sempre carregado. Você pode substituir o IfModule anterior ou incluir esta linha depois dele:
     #Módulo IBM Informix Web DataBlade DSO Incluído
     LoadModule        informix_module       /home/informix/stu5/drvapch2.so
  8. Neste arquivo httpd.conf, inclua estas linhas para indicar que o aplicativo da Web para a ferramenta de administração, com URL /stu5/admin, é uma URL do Webdriver, entregue pelo módulo Informix Webdriver:

    Talvez você precise incluir manualmente o novo diretório virtual para a ferramenta de administração, /stu5/admin, como URL do Webdriver. Isso pode ser feito agora que existe um mapeamento para este diretório virtual no arquivo web.cnf. Se não estiverem presentes, inclua essas linhas no arquivo httpd.conf do Apache:

     <Location /instructor/admin>
     SetHandler informix_explode
     </Location>

    Salve o arquivo httpd.conf e saia.

  9. Reinicie o servidor da Web Apache no diretório do servidor da Web (/home/informix/stu5/IHS-2.0.47.1/ no nosso caso):
    $ cd /home/informix/stu5/IHS-2.0.47.1/
    $ bin/apachectl stop
    $ bin/apachectl start
  10. No navegador da Web, abra a Ferramenta de Administração para o banco de dados stu5, abrindo a URL deste Webdriver: /stu5/admin:

    http://webserverhost:7070/stu5/admin

    Aqui está um exemplo da tela que você verá. Essa amostra é para a Ferramenta de Administração localizada na URL /instructor/admin:

    Figura 13. O Aplicativo Ferramenta de Administração do Informix Web DataBlade (por Banco de Dados)
    The Informix Web DataBlade Admin Tool application
    The Informix Web DataBlade Admin Tool application

    Parabéns! Você instalou e configurou com sucesso o Módulo IBM Informix Web DataBlade 4.13.UC3 e o servidor da Web compatível com Apache 2 IHS 2.0.47 no UNIX para trabalharem juntos. Você também ativou o servidor da Web para acessar a Ferramenta de Administração do Web DataBlade instalada em um banco de dados ativado para Web no Informix.

Conclusão

Você viu como instalar e configurar um servidor da Web compatível com Apache 2, como um IBM HTTP Server 2.0.47, com o IBM Informix Web DataBlade 4.13.UC3, no Unix ou Linux. Esse processo envolve a instalação e a configuração de quatro produtos principais em diferentes camadas da arquitetura. No servidor de banco de dados, você deve ter o IDS e o Web DataBlade instalados no mesmo diretório de destino INFORMIXDIR. O Informix Client SDK é um componente opcional aqui. No servidor da Web, você deve ter o servidor da Web compatível com Apache 2 (como IHS), além do Web DataBlade e do Informix Client SDK; esses dois últimos devem estar instalados em um INFORMIXDIR de sua escolha. O Informix Web DataBlade, como você viu, deve ser instalado em ambas as máquinas — banco de dados e servidores da Web. A verdadeira configuração desse produto varia, dependendo do tipo de servidor. O Web DataBlade possui um componente de Banco de Dados e um componente de Servidor da Web.

Este tutorial explica as etapas para se obter um aplicativo da Web predefinido, chamado Ferramenta de Administração do Web DataBlade (ou ferramenta admin), que é instalado em um determinado banco de dados pelo Web DataBlade, para ser acessado a partir de um cliente do navegador da Web, configurando o servidor da Web Apache 2 para trabalhar com o Informix Webdriver (também instalado pelo Web DataBlade, no servidor da Web) e para entender que a URL fornecida para a ferramenta admin é um aplicativo Web DataBlade entregue pelo Informix, não pelo servidor da Web.


Recursos para download


Temas relacionados


Comentários

Acesse ou registre-se para adicionar e acompanhar os comentários.

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=80
Zone=Linux, Software livre
ArticleID=386928
ArticleTitle=Configure o IBM Informix Web DataBlade Module 4.13 com Servidor da Web Apache (2) no UNIX ou Linux
publish-date=08282008