De openXpertya Wiki

Partiendo del final del artículo que habla de la instalación del servidor de OpenXpertya en un Ubuntu 8.04 Server, vamos ahora a explicar la instalación, de manera sencilla, del cliente pesado en Java para trabajar desde un equipo remoto dentro de la misma red que nuestro servidor. La instalación la vamos a realizar utilizando Ubuntu 8.04 Desktop como sistema operativo base. Hay que tener en cuenta que los dos equipos, tanto el cliente como el servidor, deben estar en la misma red y deben poder verse, es decir, no debe haber nada que se interponga entre estos dos equipos, ya sean cortafuegos, configuraciones de red erróneas, etc.

Instalación de Java

De serie, Ubuntu viene con una versión actualizada de Java, concretamente la 1.6. OpenXpertya, tanto el cliente como el servidor, necesita la versión 1.5 del JDK para poder trabajar de manera correcta, por ello vamos a instalarnos dicha versión en el sistema. Para ello, abriremos una ventana de Terminal (Aplicaciones > Accesorios > Terminal) y ejecutaremos:

   cliente@opx$ sudo apt-get install sun-java5-jdk

Aceptamos la licencia de uso y seguimos con la instalación. Ahora nos encontramos que tenemos dos (o más) versiones de Java instaladas en nuestro sistema, así que tendremos que indicarle qué versión vamos a querer utilizar por defecto. Desde la misma terminal ejecutamos ahora:

   cliente@opx$ sudo update-alternatives --config java

eligiendo nuestra versión (1.5) para poder trabajar.

Descargando ClienteOXP.zip

Después de finalizar nuestra instalación del servidor de OXP y de configurarlo con los datos necesarios (recordamos que se realiza con el comando ./Configurar.sh de la carpeta ServidorOXP/ y bajo entorno gráfico), el própio servidor nos creará un archivo llamado ClienteOXP.zip con todos los archivos necesarios del cliente de OXP para poder trabajar, a través de Java, directamente con nuestro servidor. Para poder acceder a dicho zip, lo primero que haremos será acceder a nuestro servidor a través del navegador poniendo su dirección IP y su puerto, si es que lo hemos cambiado en la configuración. Si no hemos cambiado el puerto y lo hemos dejado en el 80, con tan solo indicar la IP será suficiente.

Una vez dentro, nos ofrecerá cuatro posibilidades:

• Cliente ligero por Java Web: Acceso a openXpertya mediante cliente ligero Java Web Start. Se descargarán los archivos necesarios para el uso de la la aplicación.
• Cliente pesado por Java: Acceso a openXpertya mediante el cliente pesado Java, comprimido, disponible para su descarga en uno o varios equipos.
• Cliente ligero por web: Acceso a openXpertya mediante el cliente ligero Web. Esta opción incluye la práctica totalidad de las funcionalidades del cliente pesado Java openXpertya.
• Aplicación de comercio electrónico: Entrada a la aplicación de comercio electrónico B2B, B2C, B2E y B2F, con acceso en tiempo real a la base de datos de la aplicación.

Para el caso que nos ocupa elegiremos la segunda opción y descargaremos el ClienteOXP.zip en la carpeta que queramos. Una vez lo tengamos descargado (no suele tardar mucho) lo descomprimimos y nos vamos a la carpeta lib/, allí encontraremos un archivo llamado OXPDirect.jnlp que será el que ejecutaremos para arrancar el cliente.

Si hacemos doble clic, que sería lo normal, se nos abrirá el GEdit con el contenido del archivo. Como nosotros no queremos hacer eso puesto que queremos ejecutarlo, lo que haremos es hacer clic sobre el archivo con el botón derecho del ratón y lo ejecutaremos con el "Java Web Start". De esta manera, se iniciará el Java y con él nuestro cliente de openXpertya.

Primeros Pasos

Lo primero que veremos será pantalla de configuración del acceso. Por defecto no viene configurada con los datos de nuestro servidor, asi que tendremos que introducir nuestros datos de la siguiente:

• Servidor de Aplicación: Pondremos la IP de nuestro servidor.
• Puerto de Aplicación: Normalmente es el 1099, aunque esto se puede haber cambiado según la configuración que hayamos indicado al servidor con el script Configurar.sh
• Tipo de Base de Datos: Generalmente PostgreSQL, sobreotod si se ha seguido el artículo anterior sobre la instalación en Ubuntu Server.
• Usuario / Contraseña: Datos de acceso a la base de datos, normalmente se configura por defecto en openxp/openxp. Si durante la instalación hemos indicado una configuración distinta, debemos cambiar estos datos para poder acceder a la base de datos.

Por lo general, rellenando los datos del servidor de aplicación y haciendo clic sobre el botón de "Test de Aplicación" se nos configurará por defecto el resto de datos, habilitando, de esta manera, el botón de acceso (tic verde). Al clicar sobre él, entraremos en la pestaña de "Valores Por Defecto" , pudiendo elegir el perfil de acceso a nuestra aplicación, la compañía, la organización, el almacén, la fecha y la impresora.

Ahora ya tendremos nuestro cliente configurado por defecto para trabajar con nuestro servidor. A partir de aquí, tendremos que configurar nuestra compañía, importar el plan contable, introducir artículos, impuestos, entidades financieras, etc.

Problemas con el cliente

Por experiencia propia, me he encontrado con algunos problemas con el cliente, sobretodo al utilizarlo en un equipo remoto dentro de una misma red donde se encuentre el servidor cuando éste estaba instalado en un Ubuntu Server debido a que, durante la instalación, la configuración coje por defecto el nombre del equipo en lugar de su ip. Por eso es habitual que, pasado el test del servidor de aplicación, el test del servidor de la base de datos nos de error. Este problema es muy sencillo de solucionar, pues sólo tendremos que añadir el nombre del servidor y su ip al archivo de hosts del sistema.

Para hacer esto, haremos lo siguiente. Abrimos una ventana de Terminal (Aplicaciones > Accesorios > Terminal) y ejecutamos:

   cliente@opx$ sudo vi /etc/hosts

En este archivo indicaremos la ip del servidor y el nombre del servidor. Debería quedar tal que así:

127.0.0.1       localhost
192.168.1.34    openxp #Esta es la linea que debemos añadir. En nuestro caso, la ip del servidor es 192.168.1.34 y su nombre es openxp.

# The following lines are desirable for IPv6 capable hosts
::1     ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
ff02::3 ip6-allhosts

Una vez esto, necesitaremos reiniciar la conexión de la red para que los cambios tengan efecto:

   cliente@opx$ sudo /etc/init.d/networking restart

A continuación volvemos a comprobar el acceso al servidor y, ahora sí, podremos ver como ya accede sin problemas a la base de datos

Notas y aclaraciones sobre el artículo

Este artículo ha sido escrito por Fran Martín <frankiepd[arroba]gmail.com> tomando de referencia mi propia experiencia.

He intentado que sea lo más fácil de seguir y de entender, partiendo desde una instalación limpia de Ubuntu Server e indicando el máximo posible de datos para que el usuario inexperto pueda llevar a cabo la instalación. Como se puede apreciar por la extensión del mismo, no es una tarea fácil, por ello he procurado ser lo más riguroso posible y utilizar un lenguage sencillo a la par que preciso para su confección.

Para cualquier queja, aclaración, rectificación, sugerencia y/o agradecimiento, estaría gratamente agradecido que se me comunicara a través de correo electronico a la dirección frankiepd<arroba>gmail.com

NOTA: Si se quieren realizar preguntas sobre la instalación, por favor, mándelas por correo electrónico a la dirección indicada arriba. Además, cabe informar que este artículo sólo pretende servir de ayuda para realizar la instalación básica. Para otras ayudas, os aconsejo el propio foro de OpenXpertya o su servicio técnico.

--Frankie 10:32 13 may 2008 (CEST)