Context Navigation

Instalação Básica do EMPWEB

Instalação Básica do EMPWEB

1 Introdução

Este documento tem como objetivo instruir na instalação do EMPWEB em ambiente LINUX, prevendo a instalação do MySQL como uma dependência adicional do aplicativo. O documento leva em consideração um ambiente Ubuntu 9.10 atualizado com Apache 2.2.12, PHP 5.2.10 e JAVA instalados pelo gerenciador de pacotes da distribuição. Leva-se em conta a existência do cliente SVN no sistema e uma instancia já instalada e operacional no ABCD.

2 Download

Para obter o pacote do EMPWEB é preciso ter o cliente SVN instalado no sistema, desta forma o download do aplicativo fica:

svn export http://svn.reddes.bvsalud.org/empweb/trunk/empweb/

É preciso baixar o scritp-shell que esta no mesmo nível:

svn export http://svn.reddes.bvsalud.org/empweb/trunk/empweb.sh

3 Configuração

A configuração do EMPWEB se baseia em arquivos XML e no script-shell baixado anteriormente. Iniciamos a configuração por este último, empweb.sh.

EMPWEB_HOME="/home/aplicacoes-bvs/empweb"
ABCD_URL="http://ubuntu.abcd.br/"

Este é o primeiro trecho a se configurar no EMPWEB. Na primeira linha coloca-se o caminho onde estão os arquivos baixados. Na segunda linha, coloca-se a URL de acesso ao ABCD previamente instalado no computador.

JETTY_HOME="/home/aplicacoes-bvs/empweb/jetty"
JETTY_START="$EMPWEB_HOME/common/etc/start.config"
JETTY_CONSOLE="$EMPWEB_HOME/logs/jetty-console.log"

Este é o segundo trecho. Nele alteramos apenas a primeira linha, na qual colocamos o caminho onde estão os arquivos baixados do Jetty.

JAVA_HOME="/usr/lib/jvm/java-6-openjdk/bin"
JAVA="$JAVA_HOME/java"

No terceiro trecho, alteramos a primeira linha para o caminho onde se encontram os executáveis do JAVA. Podemos descobrir isto fazendo a seguinte busca no sistema:

sudo find / -name "javac"

A saída a ser usada é aquela que aponta a pasta BIN, assim como na linha de configuração.

CISIS_LOCATION="/home/aplicacoes-bvs/ABCD/cgi-bin/"
CISIS_COMMAND="mx"
OS=linux

Neste trecho, alteramos a primeira linha para o caminho onde se encontram os utilitários CISIS. A pasta cgi-bin do ABCD conta com todos os utilitários. Com isso finalizamos a configuração do arquivo empweb.sh. O próximo passo é ajustar os caminhos para as bases do ABCD nos arquivos:

dbws/WEB-INF/conf/isis_ABCDmarc_objectsconfig.xml

dbws/WEB-INF/conf/isis_ABCD_usersconfig.xml

No primeiro arquivo alteramos o seguinte trecho, logo no inicio do arquivo:

<location>/home/aplicacoes-bvs/ABCD/bases/marc/data/</location>
<collection>marc</collection>
<join>
/home/aplicacoes-bvs/ABCD/bases/loanobjects/data/loanobjects,959='MARC-',v1
</join>

<altlocation>/home/aplicacoes-bvs/ABCD/bases/loanobjects/data/</altlocation>
<altcollection>loanobjects</altcollection>
<altjoin>/home/aplicacoes-bvs/ABCD/bases/marc/data/marc,1/958=v1</altjoin>

Os valores alterados foram colocados em negrito para ajudar em sua identificação. O segundo arquivo listado (isis_ABCD_usersconfig.xml), também precisa ser alterado no seguinte trecho onde apontamos para a base de usuários do ABCD:

<location>/home/aplicacoes-bvs/ABCD/bases/users/data/</location>

<collection>users</collection>

O valor alterado esta em negrito para ajudar a identifica-lo. Com estas configurações é possível ver o EMPWEB funcionando parcialmente pelo navegador, para isso execute o script empweb.sh com o parametro start:

./empweb.sh start

Acesse no navegador o endereço http://127.0.0.1:8080/empweb/ e já será possível logar no sistema com o usuário “abcd” e senha “adm”.

4 Instalação do MySQL

Para o total funcionamento do sistema é preciso realizar a instalação do MySQL. No Ubuntu a instalação do mesmo pode ser feita da seguinte forma:

sudo apt-get install mysql-server-5.1 mysql-client-5.1

Depois disso é preciso alterar apenas o seguinte arquivo para criação das bases necessárias no MySQL:

engine/WEB-INF/conf/engineconf.xml

Neste arquivo, próximo de seu final, deve-se alterar a senha do MySQL e o diretório de backup no seguinte trecho:

<base name="TRANSA" type="transa">
        <uri>jdbc:mysql://127.0.0.1:3306/transa</uri>
        <user>root</user>
        <password>SuaSenhaDoMYSQL</password>
        <schema>ew15db-schema.sql</schema>  
	  <backupDir>/home/aplicacoes-bvs/empweb/db</backupDir>  
        …
</base>

Depois desta configuração é só reiniciar as bases pela interface do EMPWEB e ele estará instalado.

Documentação extraa