2.15.2013

INSTALANDO ADEMPIERE EN DEBIAN LINUX

Saludos a tod@s!

Retomando un poco la actividad en el blog en esta ocación voy a poner a disposición una guía de instalación del ERP Adempiere en Debian GNU/Linux testing. La documentación oficial si bien es bastante completa, en lo que se refiere a la instalación puede ser un tanto confusa y no he encontrado tutoriales o guias actuales excepto para Ubuntu 10.10 y 11.04 pero como probablemente saben, eso no es lo mismo que Debian :)

La versión de Adempiere en esta guía es la 3.7.0LTS que es la última que ha visto la luz y como su nombre lo indica es versión con soporte extendido (Long Time Support), el Debian usado es la rama testing por razones de versiones de java y postgresql principalmente, se puede usar la rama stable pero habría que ver que versiones hay en los backports o hacer apt pinning o usar una versión anterior de Adempiere, pero para no complicarnos la vida, mejor Debian testing :)

A continuación enumero los pasos que se van a seguir:
  1. Instalación y configuración de Java.
  2. Instalación y configuración de PostgresSQL.
  3. Instalación y configuración de Adempiere.
  4. Inicialización de la Base de datos de Adempiere.
  5. Iniciación del Servidor de Aplicación Adempiere.
  6. Iniciación del Cliente localmente. 


OJO: todos los comandos son ejecutados como root salvo que se indique lo contrario!

 Instalación y configuración de Java.
La instalación de Java es super sencilla, luego será necesario configurar un par de parámetros en las variables de entorno para no tener ningún inconveniente más adelante.
apt-get install default-jdk
Esto instalará todas las dependencias para tener tanto el JRE como el JVM. Lo que debemos hacer ahora es definir de antemano un par de variables de entorno:
export JAVA_HOME=/usr/lib/jvm/defult-java
export ADEMPIERE_HOME=/opt/Adempiere
 Instalación y configuración de PostgreSQL.
La instalación del servidor de base de datos PostgreSQL es igualmente sencilla, así mismo definiremos una variable de entorno y por último crearemos un cluster de bases y lo inicializaremos.
apt-get install postgresql
Esto instalará la última versión disponible en los repositorios así como todas las dependencias, también durante la instalación se crea un usario "postgres" al cual por razones de facilidad cambiaremos su contraseña a "postgres", luego se puede volver a poner una más seguro o mejor aún bloquearla para que sólo se pueda usar el usuario dentro del servidor postgresql.
passwd postgres
Con esto ya podremos iniciar sesión en el shell con el usuario postgres:
sudo - postgres
 Ahora a este usario le añadimos una variable de entorno para más adelante poder iniciar el cluster.
postgres$: export PATH=$PATH:/usr/lib/postgresql/9.1/bin
 Para iniciar el cluster antes creamos la ubicación o ponemos al usuario postgres como propietario.
mkdir -p /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data
Con esto podemos iniciar el cluster desde el usuario postgres.
postgres$: initdb -D /usr/local/pgsql/data
 Instalación de Adempiere
Descargamos Adepiemre de su ubicación oficial, al momento de escribir esto la última versión es la 3.7.0LTS, una vez que la tenemos en nuestro equipo la descomprimos y movemos la carpeta creada a la ubicación segura.
tar xvzf Adempiere_370LTS.tar.gz
mv Adempiere /opt/.
cd /opt/Adempiere
Una vez en la ubicación de la aplicación, corremos el script de instalación
sh RUN_setup.sh
Esto mostrará una ventana con algunos campos, a continuación resumo que valores debemos cambiar, los que no se mencionen se deben dejar tal cual.

  • Java home: /usr/lib/jvm/java-6-openjdk-<ARCH>
  • Adempiere home: /opt/Adempiere
  • Puerto web: 8082
  • Puerto JNP: 1099
  • Puerto SSL: 4443
  • Servidor base de datos: 127.0.0.1
  • Nombre base de datos: adempiere
  • Puerto base de datos: 5432
  • Usuario base de datos: postgres
  • Tipo base de datos: PostgreSQL
  • Contraseña administrador: postgres
  • Contraseña base de datos: postgres
 Inicialización de la Base de datos de Adempiere
cd /opt/Adempiere/utils
sh RUN_ImportAdempiere.sh
 Iniciación del Servidor de Aplicación Adempiere
sh RUN_Server2.sh
 Iniciación del Cliente localmente
Como usuario normal, por ejemplo el que creamos durante la instalación en mi caso "adempiere", pero no el usuario "postgres" podemos ya ejecutar el cliente local.
adempiere$: cd /opt/Adempiere/utils
adempiere$: sh RUN_Adempiere.sh
Debemos configurar ciertos parámetros del cliente para que este sepa a que base de datos apuntar y en qué servidor. Esto resulta util si tenemos un usuario que requiere ingresar a distintas bases. Los datos a comprobar son:
  • Servidor de Aplicaciones: adempiere
  • Servidor base de datos: adempiere
  • Usuario / Contraseña: postgres/ postgres

Una vez configurado esto, podemos ingresar al sistema, por ahora con las credenciales del usuario administrador (no super usuario)
  • Usuario: System
  • Contraseña: System

Con esto estamos dentro del sistema y listo para ser usado!
Documentación sobre su uso y administración hay y bastante, wikis, guias, videos, he encontrado mucha información que nunca es suficiente con una plataforma tan extensa y completa.

Espero ser de utilidad con esta pequeña guía y haré lo posible por responder lo más rápido cualquier inquietud que comenten.

Saludos!