Instalación del adempiere en Windows

Estas instrucciones son específicas para instalar Adempiere 3.6.0 LTS con java 1.6.0.20 y postgres 8.4.4.1 en un sistema Windows.  Para versiones de java o postgres posteriores, reemplace el número de versión correspondiente donde se requiera.

1 - Instalar prerequisitos

1.1 - Instalar java jdk version 1.6
Ejecute jdk-6u20-windows-i586.exe y siga las instrucciones de instalación
NOTA: En Windows Vista o 7 debe ejecutar con click derecho y seleccionar "Ejecutar como Administrador"
Normalmente solo basta con dar Siguiente y Aceptar

1.2 - Instalar base de datos postgresql
Ejecute postgresql-8.4.4-1-windows.exe y siga las instrucciones de instalación
NOTA: En Windows Vista o 7 debe ejecutar con click derecho y seleccionar "Ejecutar como Administrador"
Por favor tome nota cuando se le pida el password a asignar al usuario postgres, este password será utilizado más adelante
Normalmente solo basta con dar Siguiente y Aceptar

1.3 - Configurar variable de ambiente PATH
El programa de instalación requiere acceso a los comandos java y a los comandos de postgresql, para esto se debe configurar la variable PATH añadiendo al final las rutas correspondientes.
En Windows-XP -> Inicio -> Panel de Control -> Sistema -> Opciones Avanzadas -> Variables de Entorno
En Windows 7 -> Inicio -> Panel de Control -> Sistema y Seguridad -> Sistema -> Configuración Avanzada del Sistema -> Opciones Avanzadas -> Variables de Entorno
En la sección Variables del sistema seleccione la variable PATH, de click en Modificar, y añada al final de Valor de variable la siguiente cadena:
;C:\Archivos de programa\PostgreSQL\8.4\bin;C:\Archivos de programa\Java\jdk1.6.0_20\bin
guarde con Aceptar -> Aceptar -> Aceptar

1.4 - Configurar acceso a postgres en pg_hba.conf
Si el sistema solamente va a ser utilizado en forma local no es necesario efectuar cambios aquí.
Si va a ser usado por usuarios externos entonces debe configurar el archivo pg_hba.conf
Con su editor de texto preferido abra para edición el archivo C:\Archivos de programa\PostgreSQL\8.4\data\pg_hba.conf
Al final del archivo adicione la línea (ejemplo para habilitar acceso a la dirección IP 192.168.0.25):
host    all         all         192.168.0.25/32          md5
puede añadir una línea por cada equipo, o puede dar acceso a todo el rango de direcciones 192.168.0.NNN con la línea
host    all         all         192.168.0.0/24           md5
Tenga cuidado pues una edición incorrecta de este archivo puede hacer que su instalación de postgres no inicie correctamente.
Cuando haya finalizado guarde el archivo y ejecute Inicio -> Todos los programas -> PostgreSQL 8.4 -> Reload Configuration

1.5 Descomprima el archivo Adempiere360lts_LCO_QSS_20100619.zip en el directorio raíz C:\ - al finalizar de descomprimir debe haberse creado una carpeta C:\Adempiere con los archivos necesarios para continuar

2 - Instalar Adempiere RUN_setup

2.1 - Configuración del servidor
Abra el navegador de windows y vaya al directorio C:\Adempiere
Ejecute el archivo RUN_setup.bat
Aparecerá una ventana de configuración del servidor que debe diligenciar así:
Java Home: C:\Archivos de programa\Java\jdk1.6.0_20
Java VM: sun
Contraseña Key Store: se puede dejar la que presenta
Adempiere Home: C:\Adempiere
Servidor Aplicación: el sistema presenta el nombre de su máquina, se puede dejar o cambiar por la dirección IP, ej: mimaquina
Puerto JNP: 1099
Puerto Web: se recomienda 8082, puede presentar conflictos si el puerto está en uso, en ese caso seleccione un puerto libre
SSL: se recomienda 8444, puede presentar conflictos si el puerto está en uso, en ese caso seleccione un puerto libre
Servidor de base de datos: localhost
Tipo de base de datos: postgresql
Nombre de base de datos: adempiere
Puerto de base de datos: 5432
Contraseña Admin BD: aquí se debe escribir la contraseña que seleccionó en el paso 1.2 al instalar postgres
Usuario Base de Datos: adempiere (no se debe cambiar, se requiere que sea adempiere)
Contraseña Base de Datos: adempiere
Los cuatro campos bajo Servidor Correo los puede dejar sin modificar
Oprima el botón Guardar (si el botón Guardar no está habilitado, debe primero dar click en Probar hasta que todas las validaciones sean exitosas y se encenderá el botón Guardar)

2.2 - Key Store Dialog
La primera vez que ejecute el RUN_setup aparecerá una ventana Key Store Dialog para configurar los valores de una clave de seguridad, puede diligenciarla así:
(ON) Common Name: el nombre de su organización, ej: QSS
(OU) Organization Unit: puede usar el mismo
(O) Organization: puede usar el mismo
(L) Locale/Town: nombre de su ciudad, ej: Bogotá
(S) State: nombre de su estado, ej: DC
(C) Country (2 Char): sigla de su país, ej: CO
Oprima el botón verde OK

2.3 - Acuerdo de Licencia
Aparece una ventana mostrando la licencia GPLv2, debe oprimir el botón "Si, entiendo y acepto"

2.4 - Inicio del deployment
Por último aparece una ventana de confirmación indicando que se va a iniciar el proceso de configuración y deployment del servidor jboss, de click en Aceptar
El proceso puede tardar unos minutos

3 - Importar base de datos semilla RUN_ImportAdempiere

3.1 - Importar base de datos
Abra el navegador de windows y vaya al directorio C:\Adempiere\utils
Ejecute el archivo RUN_ImportAdempiere.bat
El sistema mostrará un mensaje, oprima la tecla ENTER y si todo está bien configurado se iniciará la importación de la base de datos, debe tardar unos minutos y mostrar mensajes de avance indicando la creación y alteración de tablas e índices, al final presione ENTER para finalizar.
Si el proceso termina demasiado rápido o muestra muchos errores puede ser que haya problemas de configuración del postgres, revise los pasos 1.3 y 1.4 de este instructivo.

4 - Ejecutar cliente Adempiere
Se puede ejecutar el cliente Adempiere sin requerir subir el servidor, para esto
Abra el navegador de windows y vaya al directorio C:\Adempiere
Ejecute el archivo RUN_Adempiere.bat
La primera vez que se ejecute aparecerá la licencia GPLv2, de click en "Si, entiendo y acepto"
A continuación aparecerá una ventana de configuración de acceso a la base de datos, que debe diligenciar así:
Servidor de Aplicaciones: puede dejar el MyAppsServer que se presenta por defecto, si va a usar el servidor de aplicaciones puede escribir el nombre de "Servidor Aplicación" que seleccionó en el paso 2.1
Puerto de Aplicación: puede dejar el 1099, a no ser que haya modificado el "Puerto JNP" en el paso 2.1
Tipo de Base de Datos: PostgreSQL
Servidor de Base de Datos: localhost (o el que haya seleccionado en el paso 2.1)
Puerto de Base de Datos: 5432 (o el que haya seleccionado en el paso 2.1)
Nombre de Base de datos: adempiere (o la que haya seleccionado en el paso 2.1)
Usuario: adempiere
Contraseña: adempiere (o la que haya seleccionado en el paso 2.1)
De click en "Prueba de Base de Datos", si el botón se pone verde es porque la conexión fue exitosa, puede dar click entonces en el botón verde Aceptar y proceder con el uso del aplicativo:
Para este demo puede iniciar sesión con los siguientes usuarios:
Administración Sistema: Usuario System / Contraseña System
Administración Sistema o cualquier rol/compañía: Usuario SuperUser / Contraseña System
Administración compañía ejemplo GardenWorld: Usuario GardenAdmin / Contraseña GardenAdmin
Usuario compañía ejemplo GardenWorld: Usuario GardenUser / Contraseña GardenUser

5 - Ejecutar el servidor RUN_Server2
NOTA: No es necesario ejecutar el servidor de Adempiere a menos que se quieran activar funcionalidades del servidor como tienda web, solicitudes, motor de workflow, motor de alertas, etc.
Para subir el servidor abra el navegador de windows y vaya al directorio C:\Adempiere\utils
Ejecute el archivo RUN_Server2.bat
El proceso abre una ventana de consola (negra) y debe tardar unos minutos mientras sube el servidor de Adempiere, al finalizar indica un mensaje como:
... Started in 4m:24s:283ms
IMPORTANTE: La ventana de consola (negra) se debe dejar abierta mientras se utiliza el servidor adempiere, si se cierra el servidor se detendrá

6 - Probar servidor
Abra su navegador favorito de internet (recomendado chrome o firefox) y navegue a la dirección
http://[maquina]:[puerto]
donde máquina es el nombre de "Servidor Aplicación" que seleccionó en el paso 2.1 y el puerto corresponde al "Puerto Web" que seleccionó en este mismo paso, por ejemplo:
http://mimaquina:8082
Cuando se conecte puede ingresar a la aplicación siguiendo el link "ADempiere ZK webUI", o navegando directamente a la ruta webui del servidor, por ejemplo:
http://mimaquina:8082/webui

7 - Detener el servidor RUN_Server2Stop
Cuando desee detener el servidor abra el navegador de windows y vaya al directorio C:\Adempiere\utils
Ejecute el archivo RUN_Server2Stop.bat
En caso que el servidor no se detenga puede navegar a la ventana de consola donde se encuentra el servidor corriendo y oprimir las teclas CONTROL-C