Guía de Instalación. Versiones del documento

Transcripción

1 Guía de Instalación Versiones del documento Autor Fecha Observaciones Pablo J. Urbano Santos 03/12/08 Cambio de logos Luis Ig. Bacas Riveiro Pablo J. Urbano Santos Versiones anteriores 1

2 Índice de contenido Introducción...3 Antes de empezar...3 Base de datos...3 Máquina virtual de Java...4 Instalación...4 De binarios...4 De código fuente...7 Ejecución...8 2

3 Introducción El presente documento ofrece las guías para ejecutar por primera vez la aplicación Opentpv, una modificación de Openbravo POS especializada en restaurantes de comida rápida. Antes de empezar Base de datos La aplicación almacena toda la información en una Base de datos, por lo que antes de ejecutar la aplicación es necesario disponer de un Sistema gestor de Base de datos. Opentpv soporta los siguientes gestores de Bases de datos: Oracle MySQL hsql PostgreSQL Recomendamos usar MySQL porque está especialmente probado y permite conexiones simultáneas y por red. Se incluye un script de creación de las tablas. Una vez elegido e instalado el Sistema gestor de Bases de datos a utilizar, se procederá a crear una Base de datos para la aplicación, el nombre de esta puede ser cualquiera quedando a elección del usuario. Es aconsejable también crear un usuario que no sea 'root' pero no es imprescindible, en caso de crearlo se le deben dar permisos para el uso de la Base de datos. Ejemplo para MySQL: mysql> create user opentpv; mysql> create database opentpv; mysql> grant all on opentpv.* to 'opentpv'@'%' identified by xxxx; Donde xxxx es la contraseña que se quiera establecer para el usuario en la BD. 3

4 Máquina virtual de Java Se necesita una máquina virtual de Java versión 1.5. Instalación De binarios Para instalar la aplicación, hay que seguir los siguientes pasos: 1. Descargar el fichero con los binarios (ejemplo: opentpv_version_bin.zip). 2. Descomprimir el archivo de la aplicación. Ejemplo unzip opentpv_version_bin.zip -d /opt/opentpv 3. Ejecutar el archivo configure.sh e indicar los datos de configuración de la Base de datos, así como datos referentes al aspecto del programa, caja registradora, impresoras de tickets, así como del lector de tarjetas bancarias. Driver (librería): Debe indicarse donde se encuentra el empaquetado.jar de JDBC para el uso del sistema gestor de Bases de datos. Driver (clase): Clase de Java para el uso de la base de datos. En el ejemplo para MySQL sería com.mysql.jdbcdriver. Cadena de conexión: cadena que localiza la Base de datos, puede ser en el mismo ordenador o en otro por red. Usuario y clave de acceso: Los creados en el paso anterior. Caja registradora: En este apartado se configura desde el nombre de la caja registradora, hasta el aspecto (del programa) y si se ejecuta en modo ventana o a pantalla completa, así como la(s) impresora(s) y otros dispositivos externos. Localización: Permite adaptar a gusto del usuario el formato de número, moneda y otras cantidades. Pagos: Permite introducir los datos para el lector de tarjetas magnéticas. 4. En cualquier caso siempre podremos volver a la pantalla de configuración desde el panel lateral de la pantalla principal de la aplicación a través del menú Configuración. 4

5 5

6 De código fuente Otra manera de tener la aplicación es compilar el código fuente disponible. Para ello, seguiremos los pasos: 1. Descargar el fichero con los binarios (ejemplo: opentpv_version_src.zip). 2. Descomprimir el archivo de la aplicación. Ejemplo: unzip opentpv_version_src.zip -d /opt/opentpv 3. Compilar el proyecto: 4. ant 5. A partir de aquí, configurar y como se hacía en el apartado anterior (desde 3). Para instrucciones para la modificación del código fuente, el mejor recurso es: 6

7 Ejecución Una vez configurada nuestra aplicación podremos pasar a usarla normalmente, para ello utilizaremos el ejecutable start.sh (start.bat en Windows). Si no hay una base de datos correspondiente a la configuración, ofrecerá al inicio crear una base de datos automáticamente. Una base de datos creada así estará vacía y tendrá el formato de tickets y los logos por defecto de Opentpv. En la primera pantalla se nos pedirá que nos identifiquemos que usuario somos, pulsaremos sobre el usuario Administrator para poder acceder a toda la aplicación. La pantalla nos aparecerá dividida en 2 partes, en la parte derecha se encuentra la pantalla de ventas y en la parte izquierda el menú de configuración. Desde el menú configuración podremos (según los permisos de que disponga el usuario): Menú principal: Realizar ventas, así como editarlas, devolverlas o borrarlas. Operaciones relacionadas con la caja: cierres, movimientos,... Menú Administración: Administración de clientes: altas, modificaciones,.. Gestión del inventario: altas, bajas, modificaciones de productos, tipos de impuesto, descuentos, zonas de tarificación, stockaje, movimiento de existencias,... Informes de ventas Mantenimiento: en esta sección se pueden definir que tipos de roles habrá en la aplicación, así como los permisos de estos, los usuarios de la aplicación, la apariencia de los tickets, y el logo de la empresa. También se encuentra aquí la gestión de almacenes. Menú Sistema: Cambio de clave del usuario. Acceso al panel de configuración que vimos en el apartado anterior. Posibilidad de ver en la aplicación los tickets que se han vendido o devuelto desde que se arrancó la aplicación. Cada vez que se cierra la aplicación está sección será vaciada. Salir de la sesión. Volvemos a la pantalla de selección de usuario. 7