Download Instalación de empweb sobre Ubuntu 08 1. Instalación de JDK 1.5

Instalación de empweb sobre Ubuntu 08
1. Instalación de JDK 1.5
Iniciar como root y bajar el aplicativo JDK 1.5
sudo apt-get install sun-java5-jdk
Comenzará el proceso de instalación y en un momento dado se detendrá para pedir
confirmación en dos pasos.
Finalizado esto, puede considerarse la instalación de JDK 1.5 de sun finalizado.
Para finalizar debería instalarse en caso de no haberse realizado, la librería GD para
PHP y las fotos.
sudo apt-get install php5-gd
2. Descarga de archivos a través de SSH o FTP.
Copiar la carpeta empweb al destino donde quiera depositarse. En este caso se ha
seleccionado /var/empweb.
Elimino la copia Windows local que viene con empweb para que no haya interferencias
(Opcional).
# rm -rf jdk1.5.0_17/
Descargar CISIS 16/60 para Linux de BIREME, en ese caso se ha copiado y
descomprimido en /var/empweb/cisis, quedando el contenido de /var/empweb de la
siguiente forma.
3. Hallar la ubicación de la JVM instalada por Ubuntu
Ubicar la posición física real de la aplicación javac instalada en el paso 1. Esto se ha
realizado haciendo
#find / -name “javac”
En este caso en particular, la instalación del JDK ha quedado en
/usr/lib/jvm/java-1.5.0-sun-1.5.0.16/bin
Este paso resulta importante para definir la máquina virtual de Java que empweb
usará, dado que hasta el momento ha sido testeado hasta esta versión (1.5xx).
4. Correcta instalación de ABCD 0.85
En la presente instalación en una VM Ubuntu, se contaba con una versión antigua de
ABCD 0.85. Los pasos para verificar la misma son:



Existencia del archivo abcd.def en la carpeta bases
Ultima versión de la carpeta central
Existencia de los siguientes archivos en la carpeta raíz

Existencia de las bases de datos marc, users y loanobjects en formato
linux (y ansi), procesables por ABCD e indexadas cada una de ellas
desde la carpeta data con la instrucción:
mx <bdd> fst=@ fullinv/ansi=<bdd> -all now
En este caso en particular, ABCD 0.85 se halla corriendo en el Puerto 9001, en la
carpeta abcd.
5. Adaptaciones varias de archivos.
Adapto empweb.sh de acuerdo a la configuración actual. En este caso
# The root directory of the Empweb installation
EMPWEB_HOME="/var/empweb"
ABCD_URL=http://192.168.228.137:9001/abcd/
La URL que viene por default en empweb.sh o .bat incluye aquí un localhost. En
este caso, al ser una VM Ubuntu, la misma tiene una IP interna asignada, por tanto
esta URL debe ser la URL de acceso a ABCD.
# Specify the Jetty configuration files for all the parts of Empweb that this server
must run.
# If you want to run everything in one machine, then specify ewdbws, ewengine,
ewgui configurations.
CONFIGS="$EMPWEB_HOME/common/etc/ewdbws-jetty.xml
$EMPWEB_HOME/common/etc/ewengine-jetty.xml
$EMPWEB_HOME/common/etc/ewgui-jetty.xml"
# Variables used by Jetty
JETTY_HOME="/var/empweb/jetty"
JETTY_START="$EMPWEB_HOME/common/etc/start.config"
JETTY_CONSOLE="$EMPWEB_HOME/logs/jetty-console.log"
# Java variables.
JAVA_HOME="/usr/lib/jvm/java-1.5.0-sun-1.5.0.16/bin"
JAVA="$JAVA_HOME/java"
# CISIS Wrapper
CISIS_LOCATION="/var/empweb/cisis/"
CISIS_COMMAND="mx"
OS=linux
# Logging settings.
LOGGING_CONF=$EMPWEB_HOME/common/etc/logging.properties
# For large memory machines, dedicated to Empweb, -Xms = initial heap size, Xmx = maximum heap size
#JAVA_OPTIONS="-server -DSTART=$JETTY_START Djetty.home=$JETTY_HOME -Dempweb.home=$EMPWEB_HOME Djava.util.logging.config.file=$LOGGING_CONF -Daxis.xml.reuseParsers=true Xms128M -Xmx512M -Xincgc"
Los parámetros señalados en rojo, pueden ser alterados para una mejora en la
velocidad de acceso y funcionamiento general.
En la línea 198 puede verse que se ha agregado una opción:
#####################################################
# Add jetty properties to Java VM options.
#####################################################
JAVA_OPTIONS="$JAVA_OPTIONS -Djetty.home=$JETTY_HOME Djava.library.path=$EMPWEB_HOME/common/ext -Dfile.encoding=ISO8859_1"
Esta opción resulta importante para la conversión de los acentos que provienen de
las bases de datos ISIS, dado que las mismas se entregan en ISO-8859-1 y la
plataforma estándar de Ubuntu es UTF-8.
6. Modificaciones en los puertos default de empweb (opcional)
En la presente instalación los puertos por default que la distro de empweb usa se
hallan anteriormente ocupados, por tanto se han alterado los siguientes archivos:
Archivos .xml de configuración de los servlets (/var/empweb/common/etc)
En cada uno de estos archivos se ha modificado la sección del port:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Configure PUBLIC "-//Mort Bay Consulting//DTD Configure 1.2//EN"
"http://jetty.mortbay.org/configure_1_2.dtd">
<Configure class="org.mortbay.jetty.Server">
<Set name="requestsPerGC">50</Set>
<Call name="addListener">
<Arg>
<New class="org.mortbay.http.SocketListener">
<Set name="Port">9080</Set>
Quedando:
ewgui-jetty.xml
Ewengine-jetty.xml
ewdbws-jetty.xml
9080
8091
8090
De igual forma deben modificarse otros tres archivos:
Archivo engine.conf (/var/empweb/engine/WEB-INF/conf)
la sección:
<base name="isis" type="users">
<uri>http://127.0.0.1:8090/ewdbws/services/ABCDUsersService</uri>
<wsdlFile>/dbws/users/v1/empweb-users-service-1-0.wsdl</wsdlFile>
</base>
<base name="objetos" type="objects">
<uri>http://127.0.0.1:8090/ewdbws/services/ABCDMarcObjectsService</uri>
<wsdlFile>/dbws/objects/v1/empweb-objects-service-1-0.wsdl</wsdlFile>
</base>
Estos se apuntarán al port que se halla seleccionado para los webservices de base
de datos.Por otro lado, en este mismo archivo deberá definirse el acceso a MySQL
en líneas posteriores (No opcional).
<empweb class="net.kalio.empweb.engine.db.ew15db.Empweb15DB">
<base name="TRANSA" type="transa">
<uri>jdbc:mysql://localhost/transa</uri>
<user>root</user>
<password>Emi1802</password>
<schema>ew15db-schema.sql</schema> <!-- It's a resource inside
ew15db.jar -->
<backupDir>C:/ABCD/empweb/db</backupDir>
Archivo config.properties(/var/empweb/gui/WEB-INF/conf)
La sección inicial, que hace referencia a los webservices de acceso al engine por
parte del GUI.
ewengine.query_service=http://localhost:8091/ewengine/services/EmpwebQuerySe
rvice
ewengine.admin_service=http://localhost:8091/ewengine/services/EmpwebAdminS
ervice
ewengine.trans_service=http://localhost:8091/ewengine/services/EmpwebTransacti
onService
7. Configuraciones de las bases de datos users, marc y loanobjects.
Esto puede realizarse como se ha indicado en anteriores manuales, corrigiendo los
archivos siguientes:
Dependiendo de la ubicación de la carpeta bases (esto depende de la instalación de
ABCD). Se corregirán las ubicaciones de los archivos de objetos y usuarios, en el caso
de marc_objectsconfig:
<location>/var/bases-femeba/marc/data/</location>
<collection>marc</collection>
<join>/var/bases-femeba/loanobjects/data/loanobjects,959='MARC-',v1</join>
<altlocation>/var/bases-femeba/loanobjects/data/</altlocation>
<altcollection>loanobjects</altcollection>
<altjoin>/var/bases-femeba/marc/data/marc,1/958=v1</altjoin>
Como es claro, en este caso, las bases de datos se hallan en la carpeta
/var/bases-femeba.
En el caso de los usuarios, resulta mas simple:
<location>/var/bases-femeba/users/data/</location>
<collection>users</collection>
Con esto, ambas bases de datos, quedan disponibilizadas.
8. Comprobación del funcionamiento de empweb.
Esto se hará con la URL del servidor y el port en el cual se halla definido la GUI.
Para el inicio de empweb deberá correrse desde consola
./empweb.sh start
Si dicho comando no falla y las configuraciones están bien realizadas, al ingresar a la
URL y port definido por el GUI aparecerá lo siguiente.
La URL solicitada en el caso de la pantalla anterior ha sido:
http://192.168.228.137:9080
con lo que Jetty me informa que empweb está atendiendo en el contexto de la carpeta
empweb, podemos seguir el link o la URL correcta es
http://192.168.228.137:9080/empweb/
Es importante destacar que empweb a como se entrega en la distro, siempre
atiende en la carpeta empweb, aunque esto es posible modificarlo.
9. Comprobación del correcto funcionamiento de empweb.
Luego de iniciada la sesión con empweb, puede inicializarse la base de datos como es
explicado en los manuales previos, con lo que las transacciones deben quedar todas
en 0 para la biblioteca corriente. Empweb puede considerarse corriendo correctamente
si en la sección de consultas, la siguiente secuencia de pantallas responde de la
siguiente forma:
Y la respuesta es:
Para los objetos:
Y la respuesta obtenida debe ser:
10. Uso del mySite
Para el correcto uso del mysite, y en el caso (como el presentado aquí) que deban
alterarse los puertos por hallarse ocupados, debe modificarse el archivo config.php de
central de ABCD:
$empwebservicequerylocation =
"http://localhost:8091/ewengine/services/EmpwebQueryService";
$empwebservicetranslocation =
"http://localhost:8091/ewengine/services/EmpwebTransactionService";
También y para la correcta presentación de las fotos, es importante que en el
mismo esté definido:
//Path to the images
$img_path="/var/bases-femeba/";
La ubicación de las fotografías.
Para comprobar si es que el mysite se halla funcionando OK y posee correcta
comunicación con empweb, puede invocarse la siguiente URL
http://<abcd>/indexmysite.php
en este caso, es:
http://192.168.228.137:9001/abcd/indexmysite.php
A lo que debería dar correcto login y presentar la foto y transacciones del usuario.
11. Uso del bridge con la bdd university.
La configuración del bridge debe realizarse como es indicado en los manuales
indicados, deberían configurarse los siguientes archivos:
Archivo config.inc.php (/var/femeba-www/abcd/central/bridge)
LOGFILE="/var/bases-femeba/logbridge.txt"
Achivo engineconf.xml
<base name="corporate" type="users">
<uri>http://127.0.0.1:9001/abcd/central/bridge/endpointusers.php</uri>
<wsdlFile>/dbws/users/v1/empweb-users-service-1-0.wsdl</wsdlFile>
</base>
En este último deberá incluírse la URL de ABCD.
Notas adicionales:




Por un error en la interpretación de un comando mx, un archivo .jar de la distro
de empweb ha sido modificado, el mismo sirve para Windows y para Linux con
lo que la última distro ha sido subida al FTP de BIREME.
El bridge de conexión con MySQL ha sido levemente modificado para admitir
caracteres especiales (como acentos y demás) cosa que no había sido
testeado en versiones anteriores.
Sobre Ubuntu, dado que la plataforma estándar es UTF-8, el archivo abcd.def
debe ser corregido con las entidades apropiadas (&x#valor;) para su correcta
visualización.
El archivo empweb.sh ha sido agregado a la distro.
Todas estas observaciones han sido incluídas en la distro de empweb, la cual resulta
única para plataforma Win32 como para Linux.