Download - Manual Instalación Openbravo POS.pdf
Proyecto “Fortalecimiento de las capacidades TIC en PyMEsy Gobiernos Locales mediante el uso de software libre”
Manual de Instalación Openbravo POS
Elaborado por
Setiembre, 2011
Manual de Instalación Openbravo POS
Este documento se desarrolló en el marco del Proyecto Fortalecimiento de las Capacidades en Tecnologías de Información y Comunicación en Pequeñas y Medianas Empresas y
Gobiernos Locales Mediante el Uso del Software Libre, iniciativa conjunta del Programa de Naciones Unidas para el Desarrollo en Costa Rica, la Universidad Nacional (UNA) de Costa Rica a través de su Posgrado en Gestión de la Tecnología de Información y Comunicación
(ProGesTIC) de la Escuela de Informática y el Ministerio de Economía, Industria y Comercio.
El texto del presente documento, así como las fotos, gráficos y otros elementos (a menos que se indique explícitamente) están disponibles de acuerdo con las condiciones de la
Licencia Atribución-NoComercial 3.0 Costa Rica (CC BY-NC 3.0) de Creative Commons que se puede consultar en http://creativecommons.org/licenses/by-nc/3.0/cr/
Para citar este documento:
Formación y Soluciones Informáticas EFIBS S.A; Programa de Naciones Unidas para el Desarrollo; Universidad Nacional de Costa Rica; Ministerio de Economía, Industria y Comercio de Costa Rica. 2011. Manual de Instalación Openbravo POS. Elaborado en el marco del proyecto Fortalecimiento de las Capacidades en Tecnologías de Información y Comunicación en Pequeñas y Medianas Empresas y Gobiernos Locales Mediante el Uso del Software Libre.
Tabla de Contenido
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar2
Manual de Instalación Openbravo POS
1. TERMINOLOGÍA Y ACRÓNIMOS ............................................................................................. 4
2. INTRODUCCIÓN ................................................................................................................... 5
3. ACTUALIZACIÓN UBUNTU .................................................................................................... 6
4. INSTALACIÓN JAVA .............................................................................................................. 7
4.1 SOLUCIÓN DE PROBLEMAS ............................................................................................................................. 11
5. INSTALACIÓN OPENBRAVO POS ......................................................................................... 14
5.1 IDIOMA ....................................................................................................................................................... 20
6. INGRESAR OPENBRAVO POS .............................................................................................. 23
6.1 CONSIDERACIONES ........................................................................................................................................ 25
7. RESPALDO DE BASE DE DATOS .......................................................................................... 27
8. RESTAURAR BASE DE DATOS ............................................................................................. 30
8.1 CONSIDERACIONES ....................................................................................................................................... 31
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar3
Manual de Instalación Openbravo POS
1. Terminología y Acrónimos
EFIBS Formación y Soluciones Informáticas EFIBS S.A.
Terminal Opción que brinda Ubuntu para realizar todo tipo de tareas. Se accede por
medio del menú Aplicaciones/Accesorios.
POS Punto de Venta
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar4
Manual de Instalación Openbravo POS
2. Introducción
Este documento describe los pasos a seguir para la instalación de Openbravo POS, como
una guía técnica para realizar la instalación desde cero con las herramientas necesarias
que se mencionan a continuación, además de respaldar y restaurar la base de datos.
Se deben instalar las siguientes herramientas:
Java JRE
OpenBravo POS
La versión de base de datos a utilizar es la que por defecto instala Openbravo POS la
llamada Apache Derby, para la cual no se requiere instalar nada. Esta base de datos solo
permite el acceso de un usuario a la vez, por lo que si fuera necesario ingresar a la base de
datos con alguna herramienta de administración, se debe salir primero de Openbravo POS.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar5
Manual de Instalación Openbravo POS
3. Actualización Ubuntu
Inicialmente se puede actualizar Ubuntu con el fin de tener las últimas actualizaciones
disponibles, este primer paso es opcional y se requiere que el equipo tenga acceso a
internet.
Los pasos que se deberán de seguir son los siguientes:
1. Se abre una ventana Terminal por medio del menú Aplicaciones/Accesorios.
2. El ejecuta el siguiente comando:sudo apt-get update
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar6
Manual de Instalación Openbravo POS
4. Instalación Java
A continuación se detallan los pasos a seguir para realizar la instalación del java.
1. Inicialmente se debe revisar la versión de java que tiene instalado el equipo,
para lo cual:
a. Se abre una ventana Terminal en el menú Aplicaciones/Terminal
b. Se ejecuta el siguiente comando: java –versión
c. Lo que se debe esperar es lo siguiente o una versión superior.
NOTA: Para la correcta ejecución de Openbravo POS se debe tener la versión Sun
Java Runtime Environment (JRE) 1.6 o superior.
2. Abra una ventana Terminal.
3. Para realizar la instalación se debe realizar con el usuario root. Si no se tiene
la cuenta del usuario root activa, se ejecuta el comando “sudo –s” para tener
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar7
Manual de Instalación Openbravo POS
los permisos necesario e instalar sin problemas. Como se puede ver en la
imagen se cambio del usuario efibs al root (de efibs@ a root@)
4. Se ejecuta el siguiente comando cd /opt
5. Se crea una carpeta con el nombre java, con el comando mkdir java
6. Se ejecuta el comando cd java para ingresar dentro de la carpeta.
7. Los archivos “jre-6u27-linux-i586.bin”, “openbravopos-2.30.2-linux-
installer.bin” y “etiquetas-openbravoposEspanol_es.zip” se copian en la
carpeta creada, si se tienen en un dispositivo USB, se utiliza el menú
Lugares/Equipo.
8. Se busca el archivo en el dispositivo de da clic derecho Copiar, de la misma
forma se abre otra ventana Lugares/Equipo y se busca la carpeta /opt/java en
Sistema de archivos y se da clic derecho Pegar.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar8
Manual de Instalación Openbravo POS
9. Una vez el archivo “jre-6u27-linux-i586.bin” esté en la carpeta indicada,
volvemos a la Terminal, y se le dan permisos de ejecución con el siguiente
comando:
chmod a+x jre-6u27-linux-i586.bin
10.Se inicia la instalación mediante el comando
./jre-6u27-linux-i586.bin
11. Si se presenta el contrato de licencia, con la tecla barra espaciadora se pasa
de página y al final se escribe “yes” y se presiona la tecla Enter.
12. Al finalizar se puede ver la palabra “Done”, indicando el final de la
instalación.
13.Una vez instalado Java, se debe configurar las variables de entorno, para lo
cual se debe editar un archivo con el siguiente comandoEste documento está disponible para descarga y libre uso en http://solcr.org/descargar
9
Manual de Instalación Openbravo POS
gedit /etc/bash.bashrc
14.Con el comando anterior de abre una ventana con el editor y el archivo.
15.Al final del archivo se agregan las siguientes líneas indicando las carpetas
donde se realizó la instalación.
export JAVA_HOME=/opt/java/jre1.6.0_27
export PATH=$PATH:$JAVA_HOME/bin
En la imagen se muestra un ejemplo con otra ruta.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar10
Manual de Instalación Openbravo POS
16. Se guardan las modificaciones realizadas.
17. Se cierra el editor.
18. Para verificar la correcta configuración, volvemos a la Terminal y se ejecuta el
siguiente comando:
echo $JAVA_HOME
Esto muestra la ruta donde que se configuró (/opt/java/jre1.6.0_27)
Si no se muestra la ruta, verificamos el paso anterior, que la ruta esté correcta y
reiniciamos la máquina.
4.1 Solución de problemas
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar11
Manual de Instalación Openbravo POS
En caso de tener problemas con el archivo jre-6u27-linux-i586.bin se puede descargar
Java siguiendo los siguientes pasos:
Ingresar en Aplicaciones >> Centro de software de Ubuntu
Se presenta la siguiente pantalla
En el campo de la derecha se ingresa la palabra “java” y se presiona la tecla Enter, para obtener los resultados
Seleccionar la opción “OpenJDK Java 6 ejecutable”y presionar el botón Instalar.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar12
Manual de Instalación Openbravo POS
Se debe ingresar la clave del usuario y presionar “Autenticar”
Se inicia el proceso de instalación
Al finalizar la instalación de Java se presenta la siguiente pantalla.
Una vez finalizado este paso, se puede continuar con el proceso de instalación de
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar13
Manual de Instalación Openbravo POS
Openbravo POS.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar14
Manual de Instalación Openbravo POS
5. Instalación Openbravo POS
A continuación se detallan los pasos a seguir para realizar la instalación del Openbravo
POS.
1. Sobre el archivo “openbravopos-2.30.2-linux-installer.bin”, que
previamente se había copiado en la carpeta /opt/java inicialmente se le da clic
derecho y Propiedades, se selecciona la sección de permisos y se marca la
opción de “Permitir ejecutar el archivo como un programa”.
2. Para realizar la instalación se debe tener permiso del superusuario (root) de lo
contrario durante la instalación se presentará el siguiente mensaje.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar15
Manual de Instalación Openbravo POS
3. Si no se tiene la cuenta del usuario root activa se ejecuta el comando “sudo –
s” para tener los permisos necesario e instalar sin problemas. Como se puede
ver en la imagen se cambio del usuario efibs al root (de efibs@ a root@)
4. Se abre una ventana terminal y se arrastra el archivo dentro de la ventana, en
a la ventana queda la ruta donde está el archivo, como se muestra en la
siguiente imagen. Luego de esto se presiona la tecla Enter.
5. Se presenta la siguiente ventana donde se selecciona el idioma y se da clic en
“Aceptar”.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar16
Manual de Instalación Openbravo POS
6. Se presenta una pantalla de bienvenida donde se da clic en “Adelante”.
7. Se acepta la licencia marcando la opción “Acepto los términos del acuerdo” y
se da clic en “Adelante”.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar17
Manual de Instalación Openbravo POS
8. En la siguiente ventana se debe seleccionar la ruta donde se instalará el
software, donde por defecto es en /opt, la cual es recomendable dejar como
se presenta. Se da clic en “Adelante”.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar18
Manual de Instalación Openbravo POS
9. El proceso de instalación ya tiene los datos suficientes por lo que se da clic en
“Adelante” para iniciar.
10.La instalación finaliza, y se da clic en “Terminar” para cerrar la ventana como
se muestra en la siguiente imagen.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar19
Manual de Instalación Openbravo POS
Si se deja marcada la opción “Ver el archivo Leéme” se abre un archivo de texto con
información sobre Openbravo POS.
11. Ahora en la ventana Terminal se dan los permisos a los usuarios para ejecutar
la aplicación, paso que se realiza con el usuario root por lo que se ejecuta
inicialmente “sudo –s”. Se modifican los permisos por medio del comando
“chmod a+rwx /opt/openbravopos-2.30.2 -R”, escribiendo la ruta donde se
instaló la aplicación en este caso “/opt/openbravopos-2.30.2”
En este punto ya se puede cerrar la ventana Terminal que se abrió al inicio.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar20
Manual de Instalación Openbravo POS
5.1 Idioma
A continuación se detallan los pasos a seguir para realizar la instalación del idioma español.
1. Se da clic derecho sobre el archivo “etiquetas-
openbravoposEspanol_es.zip”, que se copió en /opt/java previamente y se
da clic en “Extraer aquí”.
2. Esto deja una carpeta con el mismo nombre a la cual se ingresa y se observan
otras dos carpetas.
3. Se ingresa en la carpeta “locales” se marcan los archivos, se da clic derecho y
“Copiar”.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar21
Manual de Instalación Openbravo POS
4. Se desplaza a la carpeta donde se instaló el Openbravo POS, la cual tiene una
carpeta “locales”, en este caso /opt/openbravopos-2.30.2/locales.
Ahora se da clic derecho y da clic en “Pegar”.
5. De igual forma, dentro de la carpeta “reports” que se descomprimió
ingresamos hasta /reports/com/openbravo/reports, se marcan todos los
archivos, clic derecho y se da clic en “Copiar”.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar22
Manual de Instalación Openbravo POS
6. Se desplaza a la carpeta donde se instaló el Openbravo POS, la cual tiene una
carpeta “reports”, en este caso /opt/openbravopos-
2.30.2/reports/com/openbravo/reports.
Ahora se da clic derecho y da clic en “Pegar”.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar23
Manual de Instalación Openbravo POS
6. Ingresar Openbravo POS
A continuación se indican los pasos a seguir para poder ingresar al Openbravo POS.
1. Se abre una ventana Terminal por medio del menú Aplicaciones/Accesorios.
2. Se digita el comando “openbravopos” y se presiona la tecla Enter
NOTA: Si se cierra esta ventana, se cierra Openbravo Pos.
3. Al ingresar por primera vez se presenta el siguiente mensaje.
Para crear la base de datos se da clic en “Sí”. Esta acción implica que la bases de datos se
crea en la carpeta del usuario de Ubuntu con el que se esté conectado en ese momento.
Así por ejemplo a Ubuntu se ingresa con el usuario Efibs, en el momento de ingresar por
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar24
Manual de Instalación Openbravo POS
primera vez en Openbravo POS, se crea la base de datos, la cual queda en la carpeta
/home/Efibs/openbravopos-database.
Se despliega la siguiente pantalla para ingresar a Openbravo POS, donde se puede
selecciona el usuario “Administrador” para ingresar y proceder a configurar lo necesario
para el correcto funcionamiento de la aplicación, cosas que se ven en el siguiente
documento.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar25
Manual de Instalación Openbravo POS
6.1 Consideraciones
Para ingresar al Openbravo POS con otros usuarios de Ubuntu, se debe dar permisos a la
carpeta donde se creó la base de datos, paso que se realiza en la ventana Terminal (menú
Aplicaciones/Accesorios), con el usuario root, por lo que se ejecuta inicialmente “sudo –s”
sobre una ventana Terminal, luego se desplaza a la carpeta donde está la base de datos, en
este caso /home/efibs para ejecutar el comando “chmod 777 /openbravopos-database - R”
como se muestra en la imagen.
Al ingresar con cualquier otro usuario de Ubuntu igualmente se presenta el siguiente
mensaje.
En este caso como la base de datos ya fue creada previamente con otro usuario se da clic
en No. Seguidamente se presenta la ventana de configuración, donde se debe modificar el
campo “Cadena de conexión” ya que este campo tiene la ruta de la carpeta donde se creó
la base de datos. Así por ejemplo, se ingresa a Ubuntu con el usuario lamagia, entonces
parte del contenido de este campo es “/home/ lamagia/openpenbravopos-database”, el
cual debe ser modificado por la ruta donde se creó la base de datos con el usuario
anterior, que sería para el caso del ejemplo “/home/efibs/openbravopos-database” y el
resto del contenido del campo se deja como está, es decir
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar26
Manual de Instalación Openbravo POS
“jdbc:derby:/home/efibs/openbravopos-database;create=true”.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar27
Manual de Instalación Openbravo POS
7. Respaldo de base de datos
Para sacar un respaldo de la base de datos del punto de venta, en la máquina donde se
instaló la base de datos, se debe copiar la carpeta donde se creó la base de datos a un
dispositivo USB o quemar esta carpeta en un CD.
Para realizar el respaldo se deberá de realizar de la siguiente manera:
Conectar un dispositivo USB a la máquina.
Abrir una ventana para examinar las carpetas del equipo. Esto por medio del
menú Lugares/Equipo.
La acción anterior abre la siguiente ventana donde se da clic en “Sistema de
archivos” y se busca la carpeta donde se instaló la base de datos, para el caso de
ejemplo en “/home/efibs”.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar28
Manual de Instalación Openbravo POS
Sobre la carpeta “openbravopos-database” de da clic derecho y “Copiar”.
Nuevamente se abre una ventana por medio del menú Lugares/Equipo.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar29
Manual de Instalación Openbravo POS
Se selecciona el dispositivo USB, se da clic derecho y “Pegar” en la carpeta.
Con esto ya se tiene un respaldo de la base de datos de Openbravo POS, para ya sea
recuperarse de cualquier fallo o instalar en otro equipo.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar30
Manual de Instalación Openbravo POS
8. Restaurar base de datos
Para restaurar la base de datos del punto de venta a partir de un respaldo, es necesario
copiar la carpeta respaldada en una ruta específica e ingresar a Openbravo POS y modificar
el campo “Cadena de conexión”, en la opción de configuración.
Los pasos a seguir para realizar la restauración de la base de datos es la siguiente:
Conectar el dispositivo USB a la máquina y abrir una ventana por medio del
menú Lugares/Equipo.
Seleccionar el dispositivo USB, se deberá de buscar la carpeta que contiene el
respaldo de la base de datos, sobre ella dar clic derecho “Copiar a” y dentro
de esta opción “Carpeta personal”. Esto envía la carpeta a la ruta
/home/USUARIO/ donde USUARIO corresponde a usuario con que ingresó a
Ubuntu, para este caso de ejemplo /home/lamagia.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar31
Manual de Instalación Openbravo POS
Ahora es necesario otorgar los permisos a la carpeta de base de datos, para lo cual,
se abre una ventana Terminal (menú Aplicaciones/Accesorios) paso que se realiza con el
usuario root por lo que se ejecuta inicialmente “sudo –s” sobre una ventana Terminal, luego
se desplaza a la carpeta donde está la base de datos /home/USUARIO/ (donde USUARIO
corresponde a usuario con que ingresó a Ubuntu), en este caso /home/lamagia para
ejecutar el comando “chmod 777 /openbravopos-database - R” como se muestra en la
imagen.
En este punto ya se puede ingresar a Openbravo POS, si tiene algún problema, revise los
datos de la opción de configuración de Openbravo POS.
8.1 Consideraciones
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar32
Manual de Instalación Openbravo POS
Si existe una carpeta previamente con el mismo nombre en la ruta donde se va mantener
la base de datos se presentará el siguiente mensaje, donde se marca la opción “Aplicar
esta acción a todos los archivos” y se da clic en Mezclar.
Este documento está disponible para descarga y libre uso en http://solcr.org/descargar33