Cómo instalar Openbravo ERP en Debian Etch

Versión 1.0
Autor: Oliver Meyer

Descripción

Este documento describe cómo configurar Openbravo ERP (sistema de gestión empresarial) en Debian Etch. Según Openbravo: “Openbravo es una solución ERP de código abierto diseñada específicamente para la pyme. Desarrollada en un entorno web, incluye funcionalidades como gestión de compras y almacén, gestión de proyectos y servicios, gestión de producción y gestión financiera.”

No intento listar todas las funcionalidades; consulte http://www.openbravo.com/product/product-features/ para el catálogo completo. Esta guía es práctica y no cubre los conceptos teóricos ni todas las alternativas posibles. Explica la ruta que yo elegí y ofrece consejos y listas de verificación que facilitan la réplica del proceso.

Contenido

• Preparación del sistema
• Instalación de paquetes necesarios
• Instalación de Openbravo ERP
• Acceso web y comprobaciones
• Listas de comprobación y criterios
• Solución de problemas y seguridad

1 Preparación

Antes de instalar Openbravo, prepare el sistema y las dependencias. Use una cuenta con privilegios sudo o root.

1.1 Debian Backports

Backports contiene el JDK de Sun necesario para este procedimiento.

Abra el archivo de fuentes de apt:

vi /etc/apt/sources.list

Añada las siguientes líneas:

# Debian Backports
deb http://www.backports.org/debian etch-backports main contrib non-free

Actualice la caché de paquetes:

apt-get update

E importe la clave GPG:

apt-get install debian-backports-keyring

Importante: asegúrese de que su servidor tenga acceso a Internet y que los repositorios sean aptos para su política de seguridad.

1.2 Paquetes necesarios

Las subsecciones siguientes instalan y configuran PostgreSQL, Java JDK, Apache Tomcat y Apache Ant.

1.2.1 PostgreSQL

Instale PostgreSQL 8.2:

apt-get install postgresql-8.2

Configure la autenticación para establecer la contraseña del administrador:

sed -i 's/ident sameuser$/trust/' /etc/postgresql/8.2/main/pg_hba.conf
/etc/init.d/postgresql-8.2 restart

Abra un shell de PostgreSQL para cambiar la contraseña del rol postgres:

psql -U postgres
alter role postgres with password '%new_PostgreSQL_admin_passowrd%';
\q

Luego restaure la autenticación a md5 y recargue el servicio:

sed -i 's/trust$/md5/' /etc/postgresql/8.2/main/pg_hba.conf
/etc/init.d/postgresql-8.2 reload

Nota: reemplace %new_PostgreSQL_admin_passowrd% por una contraseña segura.

Consejo: use contraseñas largas y únicas. Si el servidor va a recibir tráfico externo, limite el acceso a la base de datos desde la red local solamente.

1.2.2 Java JDK

Instale Sun JDK desde backports:

apt-get install sun-java6-jdk

Haga el JDK disponible a nivel de sistema:

update-java-alternatives -s java-6-sun
echo 'JAVA_HOME="/usr/lib/jvm/java-6-sun"' | tee -a /etc/environment

Cierre la sesión e inicie otra para que las variables de entorno surtan efecto.

1.2.3 Apache Tomcat

Instale Tomcat 5.5 y sus paquetes administrativos:

apt-get install tomcat5.5 tomcat5.5-admin tomcat5.5-webapps

Ajuste la configuración de arranque si es necesario:

rm /var/log/tomcat5.5/catalina.out
vi /etc/init.d/tomcat5.5

Cambie:

TOMCAT5_SECURITY=yes

A:

TOMCAT5_SECURITY=no

Reinicie Tomcat:

/etc/init.d/tomcat5.5 restart

Verifique que Tomcat esté escuchando (por defecto se espera en el puerto 8180):

netstat -tap | grep java

Ejemplo esperado:

tcp6 0 0 *:8180 *:* LISTEN 3571/java

Si necesita forzar variables del entorno del contenedor:

echo 'CATALINA_HOME="/usr/share/tomcat5.5"' | tee -a /etc/environment
echo 'CATALINA_BASE="/var/lib/tomcat5.5"' | tee -a /etc/environment
echo 'CATALINA_OPTS="-server -Xms384M -Xmx512M"' | tee -a /etc/environment

Vuelva a iniciar sesión para aplicar los cambios.

1.2.4 Apache Ant

Ant normalmente se instala como dependencia. Configure su variable de entorno:

echo 'ANT_HOME="/usr/share/ant"' | tee -a /etc/environment

Cierre sesión y abra una nueva para aplicar las variables.

2 Openbravo

2.1 Obtener el instalador

Visite http://sourceforge.net/projects/openbravo/ para verificar la última versión. En el momento de redactar esta guía era la 2.35mp1.

Descargue el instalador a /tmp y hágalo ejecutable:

cd /tmp/
wget http://mesh.dl.sourceforge.net/sourceforge/openbravo/OpenbravoERP-2.35-MP1-linux-installer.bin
chmod +x OpenbravoERP-2.35-MP1-linux-installer.bin

2.2 Instalación

Ejecute el instalador en modo texto:

./OpenbravoERP-2.35-MP1-linux-installer.bin

El instalador mostrará el contrato de licencia en pantalla; presione Enter para avanzar y escriba “yes” si acepta.

Responda a las preguntas del instalador. Las respuestas recomendadas en este documento son las siguientes (puede adaptar rutas y puertos a su política de despliegue):

• Directorio de instalación: presione Enter para aceptar /opt/OpenbravoERP
• Directorio de attachments: presione Enter para aceptar /opt/OpenbravoERP/AppsOpenbravo/attach
• Tipo de instalación: presione Enter para Full (standard)
• Base de datos: PostgreSQL
• Java home: presione Enter para aceptar /usr/lib/jvm/java-6-sun
• Apache Ant home: presione Enter para aceptar /usr/share/ant
• Directorio Tomcat: presione Enter para aceptar /var/lib/tomcat5.5
• Dominio del servidor web: escriba su dominio (por ejemplo server1.example.com)
• Puerto HTTP: 8180
• Contexto: presione Enter para aceptar openbravo
• Ruta binarios de PostgreSQL: /usr/bin
• Servidor de base de datos: presione Enter para aceptar localhost
• Puerto de PostgreSQL: presione Enter para aceptar 5432
• Nombre de la base de datos: presione Enter para aceptar openbravo
• Introduzca la contraseña del administrador de PostgreSQL (la que creó antes)
• Usuario de la base de datos para Openbravo: presione Enter para aceptar tad
• Introduzca la contraseña para el nuevo usuario database (dos veces)
• Escriba y para iniciar la instalación y espere a que termine

La instalación puede tardar varios minutos. El instalador descargará dependencias, desplegará la aplicación y configurará la base de datos.

2.3 Interfaz web

Acceda a Openbravo desde:

http://%servername%:8180/openbravo

Credenciales por defecto tras una instalación estándar:

• Usuario: Openbravo
• Contraseña: openbravo

Importante: cambie las credenciales por defecto al primer acceso y limite el acceso al puerto 8180 mediante firewall o proxy inverso si el servidor está accesible desde Internet.

3 Enlaces útiles

• Debian: http://www.debian.org/
• Openbravo: http://www.openbravo.com/
• Manual de usuario Openbravo: http://wiki.openbravo.com/wiki/User_Manual_2.3

Comprobaciones posinstalación rápidas

• Verifique que Tomcat se esté ejecutando y atienda en el puerto configurado.
• Compruebe que la base de datos openbravo exista y que el usuario tad tenga privilegios.
• Asegúrese de que JAVA_HOME, ANT_HOME y CATALINA_HOME estén presentes en /etc/environment.
• Compruebe los logs de Tomcat (/var/log/tomcat5.5/) y los de Openbravo dentro del directorio de instalación si hay errores.

Criterios de aceptación

• El servicio web responde en http://%servername%:8180/openbravo
• Inicio de sesión exitoso con credenciales cambiadas del usuario administrador
• La base de datos contiene los esquemas esperados para Openbravo
• Los procesos Java (Tomcat) no consumen memoria excesiva durante el arranque

Lista de comprobación por rol

Administrador del sistema:

• Repositorios y claves apt actualizados
• PostgreSQL configurado con autenticación md5
• [ ] Variables de entorno JAVAHOME, ANT_HOME y CATALINA* definidas
• Sistema de arranque y permisos de archivos revisados

DBA:

• Usuario de base de datos creado con contraseña fuerte
• Copia de seguridad inicial de la base de datos tomada
• Restricción de acceso de red a Postgres aplicada

Operaciones/SO:

• Monitorización básica habilitada (uso CPU/RAM/IO)
• Rotación de logs configurada
• Políticas de respaldo y restauración documentadas

Seguridad y privacidad

• Cambie inmediatamente las contraseñas por defecto.
• Coloque Tomcat detrás de un proxy inverso (ej. Apache o Nginx) si necesita TLS. Tomcat 5.5 no trae una configuración TLS segura por defecto.
• Aplique reglas de firewall para limitar el acceso a 8180 solo a direcciones necesarias.
• Si maneja datos personales, documente el flujo de datos y aplique medidas de cumplimiento locales (por ejemplo, tratamiento de datos personales según la normativa vigente en su país).

Nota: esta guía no sustituye a una auditoría de seguridad completa.

Solución de problemas común

• Tomcat no arranca: revise /var/log/tomcat5.5/catalina.out y los permisos del directorio de Tomcat.
• Error de conexión a PostgreSQL: compruebe pg_hba.conf, reinicie PostgreSQL y asegúrese de que el puerto y la dirección son correctos.
• Instalador se detiene por errores de Java: verifique que JAVA_HOME apunta al JDK correcto y que java -version muestra Java 6 (Sun).
• Instalación de paquetes fallida: valide la conectividad a los repositorios y que backports está habilitado.

Comandos útiles para depuración:

systemctl status tomcat5.5 || /etc/init.d/tomcat5.5 status
tail -n 200 /var/log/tomcat5.5/catalina.out
psql -U postgres -l
netstat -tulpen | grep 8180

Alternativas y cuándo no usar este método

• Si su entorno requiere versiones recientes de Java o Tomcat, considere instalar una versión moderna de Debian/Ubuntu con paquetes actualizados. Esta guía está orientada a Debian Etch y componentes en las versiones mencionadas.
• Para despliegues en producción con alta disponibilidad, esta instalación básica no es suficiente; planifique replicación de base de datos, balanceo de carga y copias de seguridad periódicas.

Resumen

• Añada backports y actualice apt.
• Instale y configure PostgreSQL, Sun JDK, Tomcat y Ant.
• Descargue y ejecute el instalador de Openbravo.
• Configure el acceso web y cambie contraseñas por defecto.
• Revise logs, aplique seguridad y valide con las listas de comprobación.

Puntos clave:

• Respalde la base de datos antes de cambios importantes.
• Use contraseñas seguras y controles de acceso de red.
• Mantenga un entorno de pruebas antes de actualizar producción.

Fin del documento.