Gua de Instalacin

Versiones del documento

Autor

Fecha

Observaciones

PabloJ.UrbanoSantos

03/12/08

Cambiodelogos

LuisIg.BacasRiveiro
PabloJ.UrbanoSantos

Versionesanteriores

ndice de contenido
Introduccin.........................................................................................................3
Antes de empezar...............................................................................................3
Base de datos..................................................................................................3
Mquina virtual de Java...................................................................................4
Instalacin...........................................................................................................4
De binarios.......................................................................................................4
De cdigo fuente.............................................................................................7
Ejecucin.............................................................................................................8

Introduccin
El presente documento ofrece las guas para ejecutar por primera vez la
aplicacin Opentpv, una modificacin de Openbravo POS especializada en
restaurantes de comida rpida.

Antes de empezar
Base de datos
La aplicacin almacena toda la informacin en una Base de datos, por lo que
antes de ejecutar la aplicacin 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 simultneas y por red. Se incluye un script de creacin 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 aplicacin, el nombre de esta
puede ser cualquiera quedando a eleccin del usuario. Es aconsejable tambin
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 contrasea que se quiera establecer para el usuario en la BD.

Mquina virtual de Java

Se necesita una mquina virtual de Java versin 1.5 .

Instalacin
De binarios
Para instalar la aplicacin, hay que seguir los siguientes pasos:
1. Descargar el fichero con los binarios (ejemplo: opentpv_version_bin.zip).
2. Descomprimir el archivo de la aplicacin. Ejemplo
unzip opentpv_version_bin.zip -d /opt/opentpv
3. Ejecutar el archivo configure.sh e indicar los datos de configuracin 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 (librera): 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 sera com.mysql.jdbcDriver.

Cadena de conexin: 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.

Localizacin: Permite adaptar a gusto del usuario el formato de

nmero, moneda y otras cantidades.

Pagos: Permite introducir los datos para el lector de tarjetas

magnticas.

4. En cualquier caso siempre podremos volver a la pantalla de configuracin

desde el panel lateral de la pantalla principal de la aplicacin a travs del
men Configuracin.

De cdigo fuente
Otra manera de tener la aplicacin es compilar el cdigo 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 aplicacin. Ejemplo:
unzip opentpv_version_src.zip -d /opt/opentpv
3. Compilar el proyecto:
4. ant
5. A partir de aqu, configurar y como se haca en el apartado anterior
(desde 3).
Para instrucciones para la modificacin del cdigo fuente, el mejor recurso es:
http://wiki.openbravo.com/wiki/OpenbravoPOS_Developer_guide

Ejecucin
Una vez configurada nuestra aplicacin 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 configuracin, ofrecer al
inicio crear una base de datos automticamente. Una base de datos creada as
estar vaca 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
aplicacin. 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
configuracin.
Desde el men configuracin podremos (segn 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 Administracin:

Administracin de clientes: altas, modificaciones, ..

Gestin del inventario: altas, bajas, modificaciones de productos, tipos

de impuesto, descuentos, zonas de tarificacin, stockaje, movimiento
de existencias, ...

Informes de ventas

Mantenimiento: en esta seccin se pueden definir que tipos de roles

habr en la aplicacin, as como los permisos de estos, los usuarios de
la aplicacin, la apariencia de los tickets, y el logo de la empresa.
Tambin se encuentra aqu la gestin de almacenes.

Men Sistema:

Cambio de clave del usuario.

Acceso al panel de configuracin que vimos en el apartado anterior.

Posibilidad de ver en la aplicacin los tickets que se han vendido o

devuelto desde que se arranc la aplicacin. Cada vez que se cierra la
aplicacin est seccin ser vaciada.

Salir de la sesin. Volvemos a la pantalla de seleccin de usuario.