manual instalación openbravo pos

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


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

http://solcr.org/descargar

http://creativecommons.org/licenses/by-nc/3.0/cr/


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




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




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.




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




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




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.




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



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.




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




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.




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




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.




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”.




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”.




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”.




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.




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.




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”.




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”.




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”.




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




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.




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




“jdbc:derby:/home/efibs/openbravopos-database;create=true”.




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”.




Sobre la carpeta “openbravopos-database” de da clic derecho y “Copiar”.

Nuevamente se abre una ventana por medio del menú Lugares/Equipo.




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.




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.




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




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.



manual instalación openbravo pos

Documents