Proyecto Fortalecimiento de las capacidades TIC en PyMEs y Gobiernos Locales mediante el uso de software libre Manual de Instalación Openbravo POS

Transcripción

1 Proyecto Fortalecimiento de las capacidades TIC en PyMEs y Gobiernos Locales mediante el uso de software libre Elaborado por Setiembre, 2011

2 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 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 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 2

3 1. TERMINOLOGÍA Y ACRÓNIMOS INTRODUCCIÓN ACTUALIZACIÓN UBUNTU INSTALACIÓN JAVA SOLUCIÓN DE PROBLEMAS INSTALACIÓN OPENBRAVO POS IDIOMA INGRESAR OPENBRAVO POS CONSIDERACIONES RESPALDO DE BASE DE DATOS RESTAURAR BASE DE DATOS CONSIDERACIONES

4 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 4

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

6 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 6

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

8 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 linuxinstaller.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. 8

9 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 comando 9

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

11 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 11

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

13 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 13

14 Openbravo POS. 14

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

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

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

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

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

20 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 R, escribiendo la ruta donde se instaló la aplicación en este caso /opt/openbravopos En este punto ya se puede cerrar la ventana Terminal que se abrió al inicio. 20

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

22 4. Se desplaza a la carpeta donde se instaló el Openbravo POS, la cual tiene una carpeta locales, en este caso /opt/openbravopos /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. 22

23 6. Se desplaza a la carpeta donde se instaló el Openbravo POS, la cual tiene una carpeta reports, en este caso /opt/openbravopos /reports/com/openbravo/reports. Ahora se da clic derecho y da clic en Pegar. 23

24 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 24

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

26 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 26

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

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

29 Sobre la carpeta openbravopos-database de da clic derecho y Copiar. Nuevamente se abre una ventana por medio del menú Lugares/Equipo. 29

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

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

32 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 32

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