ERP 2.50:Openbravo ERP installation/es

Needs help/review

Introducción

Este artículo explica cómo instalar Openbravo ERP. Antes de empezar, por favor asegúrese de que haya instalado correctamente el ambiente de Openbravo, i.e.:

• Base de datos PostgreSQL u Oracle
• Sun Java Development Kit (JDK)
• Apache Tomcat
• Apache Ant

Vea en las especificaciones las versiones correctas.

Openbravo ERP puede ser instalado de dos formas diferentes:

• De forma más rápida pero usando la línea de comandos descargando y compilando el código fuente que está en Subversion.
• De forma gráfica pero más lento descargando el instalador Bitrock.

Licencia

Openbravo ERP está licenciado bajo la Licencia Pública Openbravo Versión 1.1:

Los contenidos de este archivo están sujetos a la Licencia Pública Openbravo Versión 1.1 (the "License"), que es la Licencia Pública Mozilla version 1.1 con una cláusula de atribución permitida; usted no puede usar este archivo a menos que sea en conformidad con la licencia. Puede obtener una copia de la licencia en inglés en http://www.openbravo.com/product/legal/license/.

El software que se distribuye bajo esta Licencia se distribuye "TAL CUAL", SIN GARANTÍAS DE NINGÚN TIPO, ya sea expresa o implícita. Vea la Licencia para el lenguaje específico que rige los derechos y limitaciones bajo la Licencia.

El Código Original es de Openbravo ERP. El Desarrolladodr Inicial del Código Origial es Openbravo SLU. Todas las porciones son Copyright (C) 2001-2008 Openbravo SLU. Todos los derechos reservados.

Código fuente desde Subversion

Para poder descargar el código fuente de Openbravo ERP del repositorio Openbravo en Subversion usted necesita instalar el cliente del sistema de control de versiones Subversion (SVN).

Cuando el cliente de Subversion esté instalado, diríjase al directorio en el que quiere desgargar la etiqueta del código fuente más reciente y escriba en la línea de comandos:

svn co https://dev.openbravo.com/svn/openbravo/tags/r2.40beta openbravo-240beta

Diríjase al directorio openbravo-240beta y configure los archivos Openbravo.properties y log4j.lcf usando el asistente gráfico (wizard) dentro del directorio config/setup-tool:

• Linux: setup-properties-linux.bin
• Windows: setup-properties-windows.exe

Note que estos asistentes también pueden ser ejecutados en modo texto sin un sistema gráfico. Esto se detecta de forma automática.

Antes de empezar con la compilación, por favor revise que Openbravo.properties (dentro del directorio config) haya sido configurado de forma correcta. Si no, editelo manualmente.

Cree la base de datos desde archivos *.xml e instalar Openbravo ERP en un único paso escribiendo en la línea de comandos:

ant install.source

Finalmente, haga el deploy del archivo openbravo.war al directorio de contexto de Apache Tomcat (usualmente webapps) escribiendo en la línea de comandos:

ant deploy

Antes de que Openbravo ERP pueda se accedido de forma correcta, es necesario limpiar la base de datos usand el siguiente comando:

vacuumdb -f -z -h hostname -d dbname -U username

Reemplace hostname por el nombre de su servidor de base de datos, dbname por el nombre de la base de datos (el nombre predeterminado es openbravo), y username por el nombre del usuario de la base de datos (el nombre predeterminado es tad).

Instalador de Bitrock

Descargue el último Instalador de Openbravo ERP.

• Si está usando Windows, haga doble clic en él.
• Si está usando Linux, hágalo ejecutable y ejecútelo:

chmod +x OpenbravoERP_2.40beta-linux-installer.bin
./OpenbravoERP_2.40beta-linux-installer.bin

Un asistente («wizard») de instalación aparece:

Lea y acepte la Licencia Pública de Openbravo Versión 1.1 antes de seguir con el proceso de instalación.

Al hacer clic en el botón «Forward» está aceptando los términos y condiciones de la licencia.

Indique el directorio en el que Openbravo ERP se va a instalar.

Luego de hacer clic en el botón «Forward» seleccione también el directorio para los adjuntos.

Luego escoja el tipo de instalación:

• Una instalación Completa(«Complete») incluye la base de datos y la aplicación.
• Una instalación Distribuida(«Distributed») permite seleccionar sólo uno de los componentes.

La instalación Completa ofrece dos modos:

• Estándar(«Standard»): La base de datos se crea y la aplicación se instala. Esta es la instalación más rápida y es recomendada para empezar con Openbravo ERP.
• Desarrollo(«Development»): La base de datos se crea, la aplicación se compila y los archivos generados se instalan. Esta instalación es más lenta pero es recomendada para desarrolladores.

Brinde el directorio en el que el Java Development Kit (JDK) está instalado.

Si el JDK ha sido instalado de forma correcta, el directorio de instalación debería ser reconocido automáticamente.

Brinde la ruta completa del binario de Apache Ant.

Si Apache Ant ha sido instalado de forma correcta, la ruta del binario debería ser reconocida automáticamente.

Brinde el directorio en el que Apache Tomcat está instalado.

Si Apache Tomcat ha sido instalado de forma correcta, el directorio de instalación debería ser reconocido automáticamente.

Indique cuál base de datos quiere usar.

Actualmente, Oracle y PostgreSQL son soportadas.

Brinde la ruta completa de los binarios de la base de datos.

Estos binarios son psql, vacuumbd y pg_restore en PostgreSQL, e imp, sqlplus en el caso de Oracle.

Brinde los parámetros de la base de datos que permiten al instalador conectarse a la base de datos. Su base de datos debe estar siendo ejecutada durante este paso, ya que las credenciales de la base de datos se verifican. Los siguientes parámetros son requeridos:

• Servidor de base de datos(«Database host»): La dirección IP o el nombre del servidor en el que el servicio de la base de datos se está ejecutando.
• Puerto de base de datos(«Database port»): El puerto en el que la base de datos está escuchando (De forma predeterminada, 5432 en PostgreSQL y 1521 en Oracle).

Luego de hacer clic en el botón Forward', si está usando una base de datos Oracle, SID (Oracle System Identifier) y TNS (Transparent Network Substrate) son requeridos.

En la siguiente ventana, si está usando una base de datos PostgreSQL.

Escriba dos veces la contraseña para el usuario administrador postgres. Si está usando una base de datos Oracle escriba dos veces la contraseña para el usuario system. En realidad, Openbravo ERP requiere privilegios de administrador para crear elementos de la base de datos.

Si está usando PostgreSQL:

Especifique el nombre de la base de datos que mantendrá el modelo de datos de Openbravo ERP. Luego escriba el nombre de usuario y contraseña de la base de datos que contendrá los objetos de la base de datos de Openbravo ERP.

Dele un nombre de contexto a su aplicación.

Esto será usado para acceder a Openbravo ERP a través de Tomcat: http://<dirección_ip>:<puerto>/<nombre_de_contexto>

Luego, seleccione los formatos de hora y fecha preferidos:

Finalmente, escoja entre tener los datos de demostración (BigBazaar) o no:

Haga clic en «Forward» dos veces para continuar con la instalación de Openbravo ERP.

Este proceso puede durar entre 10 y 30 minutos para el modo Estándar y entre 30 y 90 minutos para el modo Desarrollo, dependiendo de las capacidades de procesamiento de la máquina en la que Openbravo ERP se está instalando.

Ejecutar Openbravo ERP

En ambos casos, detenga e inicie el servicio de Tomcat para finalizar el proceso de instalación.

En este punto, usted debe tener dentro del directorio webapps de Apache Tomctat (C:\Apache Software Foundation\Tomcat5.5\webapps\ o C:\Tomcat5.5\webapps\ en Microsoft Windows y /var/lib/tomcat5.5/webapps/ en Linux):

• el archivo su_nombre_de_contexto.war.

Si ese no es el caso:

• Detenga el servicio de Tomcat.
• Copie el archivo su_nombre_de_contexto.war desde el directorio lib de la instalación.
• Péguelo en el directorio webapps de Apache Tomcat.
• Inicie el servicio de Tomcat de nuevo.

Acceda a Openbravo ERP con su navegador web escribiendo la URL exacta del contexto, por ejemplo, http://localhost:8180/openbravo/.

Revise que el directorio su_nombre_de_contexto esté creado dentro de el directorio webapps de Apache Tomcat.

 <property name="context.url" value="http://localhost:8180/openbravo/"/> 

 context.url=http://localhost:8180/openbravo/ 

Escriba Openbravo en el cuadro de texto «Username» y openbravo en el cuadro de texto «Password». Luego haga clic en el botón Login.

¡Felicidades! Ha terminado con la instalación de Openbravo ERP :)

Configuraciones después de la instalación

Después de que Openbravo ERP sea instalado y esté ejecutando apropiadamente, hay unos cuantos parámetros que usted puede personalizar para adaptar mejor Openbravo ERP a su país o región.

Instalar una traducción

Siempre es más divertido obtener Openbravo ERP traducido a su idioma :)

Configurar los formatos de hora y fecha predeterminados

Para cambiar el formato de fecha predeterminado de Openbravo ERP ejecute la herramienta de configuración que está en el directorio config/setup-tool.

Cuando haya hecho todos los cambios, recompile y haga el «deploy» de Openbravo ERP:

ant compile.complete
ant war
ant deploy

Configurar el formato de los números

Puede modificar el formato de números predeterminado editando el archivo Format.xml que está en el directorio config. Usted debería tener decimal="." grouping="," para cada categoría. Cuando esté listo, usted debe reiniciar Tomcat y los reportes se mostrarán como usted desea.

Problemas conocidos

Aquí hay una lista de problemas comunes con la instalación de Openbravo ERP.

Problemas de «hot-deployment» de Tomcat en Windows

Hay un problema conocido con Tomcat trabajando en Windows. Openbravo ERP hace un «hot-deploy» del archivo openbravo.war a Tomcat, pero en Windows con frecuencia encuentra problemas porque el archivo está no puede ser usado por otros procesos. Windows no permitirá retirar la vieja aplicación porque los archivos están protegidos por el Sistema Operativo. Tomcat tiene mecanismos para evitar esta protección. En Tomcat 5.5 y 6.0, este mecanismo está desabilitado de forma predeterminada. Para activarlo edite %CATALINA_BASE%\conf\context.xml. Encuentre la raíz <context> y agregue estos dos atributos:

<context antiJARLocking="true" antiResourceLocking="true" />

Proplema con Jasper Reports

Al compilar el código fuente, el servidor de la aplicación necesita conección a Internet para compilar correctamente los archivos *.jrxml. Si no, los reportes dde Jasper no trabajarán en la aplicación.

En Windows, un «firewall» puede también bloquear la compilación de los reportes de Jasper, entonces desactivelos temporalmente.

El encabezado de estos .jrxml es así:

<?xml version="1.0" encoding="UTF-8"  ?>
<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">

Si el servidor de la aplicación no tiene conexión a Internet, usted tendrá algunos errores al compilar los fuente aún cuando la el «build» sea exitoso. Cuando usted llama a alguno de estos reportes en la aplicación, usted obtendrá algo similar a esto:

org.xml.sax.SAXParseException: Premature end of file.

Si usted edita todos los archivos files (hasta 58) y borra la línea en la que llama la conexión a Internet,

<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">

la compilación no reportará errores, pero la traducción será muy mal hecha, y cuando llame uno de estos reportes en la aplicación, obtendrá una ventana de error:

Language "null" not supported by this report compiler. Expecting "java" instead.

Así que, la solución final para este problema es que reemplace la línea

<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">

por esta

<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "/tmp/jasperreport.dtd">

en todos los 58 archivos .jrxml para evitar contacto con la URL anterior, y así la compilación y los reportes de la aplicación funcionarán bien.

Error de enlace insatisfecho al ejecutar un Jasper Report

En algunas distribuciones de GNU/Linux hay un problema al usar Java SDK 1.5.0_13 or 1.5.0_15 y Tomcat ejecutando como demonio [jsvc]. Cuando un Jasper Report se ejecuta, un error aparece indicando que no pueden encontrar una biblioteca. La forma más sencilla de arreglar esto es editando el guión /etc/init.d/tomcat y exportar la variable LD_LIBRARY_PATH a la ruta en que la biblioteca (libawt.so) se encuentra.

Por ejemplo:

LD_LIBRARY_PATH=/usr/lib/jvm/java-1.5.0-sun-1.5.0.13/jre/lib/i386/
export LD_LIBRARY_PATH

En Ubuntu hay una ruta más corta que trabaja para todas las subversiones de 1.5 (i.e. 1.5.0_13 and 1.5.0_15). Funciona usando un enlace simbólico que automáticamente apunta al directorio correcto:

LD_LIBRARY_PATH=/usr/lib/jvm/java-1.5.0-sun/jre/lib/i386/
export LD_LIBRARY_PATH

Internet Explorer 6

El problema principal es que IE6 no soporta PNG con un canal de alfa. IE7 y Mozilla Firefox sí.

Primera solución: reemplazar las imágenes PNG por GIFs

• No es posible sólo reemplazar las imágenes PNG por GIFs, porque PNG tiene un canal de alfa por cada píxel y GIF no. GIF soporta solo un subgrupo de 256 colores, pero ese no es el problema más grande. Con GIFs usted sólo tiene la posibilidad de definir un color como totalmente transparente o no. Esto significa que el gradiente de negro a transparente es imposible.

Segunda solución: evite usar transparencias

• Esto implica que las imágenes superpuestas no pueden ser usadas. Pro ejemplo, el icono en la barra de herramientas tiene un rectángulo redondeado al pasar el ratón sobre él y al hacer clic. Este uso es sencillo ahora, porque podemos sobreponer estas imágenes en el icono. Pero sin transparencias, necesitaríamos tres iconos diferentes. tres veces la misma con diferentes fondos. Esto requiere que se construyan muchos iconos.
• El problema en este caso no es sólo que tengamos que reconstruir todos los iconos con cada posible fondo, el problema también está en el lado de la implementación de reconstruir su estructura de HTML y CSS.

Tercera solución: filtros

• Bueno, no es del todo imposible mostrar PNGs transparentes con IE6, incluso IE5.5. Hay un mecanismo de filtros que maneja esto, y puede ser aplicado con JavaScript.
• http://www.twinhelix.com/css/iepngfix/demo/ y http://redvip.homelinux.net/varios/explorer-png.html son unos pocos ejemplos de esto.

Hemos probado muchas soluciones de filtros, pero no pueden ser aplicados sin un gran cambio de los archivos css y html.

Así que la única solución factible sería construir una nueva piel con imágenes gif, perdiendo calidad en la interfaz. Usted puede encontrar información sobre cómo construir una nueva piel.

Usted siempre tiene la opción de instalar Mozilla Firefox o actualizar a IE7 (si es un usuario de Windows XP).

Preguntas frecuentes de Openbravo ERP

Preguntas frecuentes de Openbravo ERP («FAQ»).

Resumen

La instalación de Openbravo ERP no debería presentar ningún problema especial si el ambiente de Openbravo ha sido correctamente instalado antes.

Soporte

Para cualquier pregunta o duda con respecto a la instalación de Openbravo ERP, escríbalas en el foro de ayuda de Openbravo o únase al canal de IRC #openbravo en Freenode.