Septiembre de 2016

Manual de instalacin en
ambiente de desarrollo Virtual
Market.
Instalar Linux distribucin Debian v. Jessie, lo puede descargar de la siguiente
url: https://www.debian.org/distrib/

Se debe realizar un git clone del repositorio

https://bitbucket.org/toeska/virtualmarket/src
para esto debe ingresar a la url y en el men del costado izquierdo debe
pinchar el botn clone.
Usuario: xxxxx
Password: xxxxx
Este le dar el siguiente comando: git clone
https://rtorres_unab@bitbucket.org/toeska/virtualmarket.git

A travs de un terminal de Debian ejecute el comando mencionado, ejemplo de

un terminal:

Esto creara una carpeta llamada virtual market en Descargas o donde se

especifique.
Instalacin y configuracin

Prerrequisitos

virtualmarket.war (sigue las instrucciones de Compilacin para generar

este archivo)
Dump base de datos: virtualmarket.sql
Apache Tomcat 7
ElasticSearch 0.90.3
Postgresql 9.1

Grails
Para poder correr la aplicacin es necesario tener instalado el framework Grails
v2.3.6, el cual se instala de la siguiente manera:
En la terminal de Debian, se debe instalar JDK, curl y groovy environment
manager (GVM) ejecute los siguientes comandos:

sudo apt-get install openjdk-6-jdk

sudo apt-get install curl
curl -s get.gvmtool.net | bash

Cuando la instalacin termine, ejecute el comando que proporciona la terminal,

que deberia ser algo como: source "/home/username/.gvm/bin/gvm-init.sh"
Y finalmente para instalar Grails:

gvm install grails 2.3.6

Introduccin
VirtualMarket busca un archivo de configuracin, opcional, que permite
personalizar los valores por defecto. El archivo puede ser
virtualmarket-config.groovy o virtualmarket-config.properties y se busca en el
classpath o en $HOME/.grails/ (donde $HOME es el directorio del usuario del
proceso). Por lo tanto las ubicaciones posibles son:
classpath:virtualmarket-config.groovy
classpath:virtualmarket-config.properties
$HOME/.grails/virtualmarket-config.groovy
$HOME/.grails/virtualmarket-config.properties
Alternativamente, se puede especificar un archivo (.properties o .groovy) con
path arbitrario a travs de la propiedad JVM virtualmarket.config.location
Tomcat
La aplicacin se despliega en Tomcat7. Lo relevante es proveer el archivo de
configuracin a travs de la propiedad virtualmarket.config.location.
En tomcat, se estila utilizar el script setenv.sh para configurar como se lanza la
JVM. Por ejemplo:

#!/bin/sh
export CATALINA_OPTS="$CATALINA_OPTS
-Dvirtualmarket.config.location=/etc/virtualmarket/config.groovy"
PostgreSQL
Crea una base de datos y carga primero virtualmarket.sql y luego
virtualmarket-datos.sql
Por defecto, el sistema trata de conectarse a una base de datos con las
siguientes propiedades:

url: jdbc:postgresql://localhost:5432/virtualmarket
username: virtualmarket
password: vm13927

Puedes cambiar la configuracin de la base de datos en el archivo de

configuracin:
Por legibilidad, es recomendable crear la configuracin como un archivo groovy.
dataSource {
url = 'jdbc:postgresql://dbserver:5432/vmproduccion'
username = 'vm'
password = 'secreto'
}
Luego se descargar de la pgina oficial de elasticSeach la versin 0.90.3 con
extensin tar.gz.
Editar el archivo elasticSearch.yml y cambiar cluster.name=
elasticSearch.cluster por cluster.name= vm.
Este debe ser dejado en comentado para que sea tomado, si se borra el signo
# se tomara como ambiente de produccin lo cual no se requiere.
Luego ejecutar el comando dbm-update para actualizar la base de datos.
Actualizada la base de datos se debe ir al directorio opt/elasticsearch# y
ejecutar el comando bin/elasticsearch -f para inicializar o arrancar el servicio.
Despus hay que 'logearse' como virtualmarket (virtualmarket@debian) con el
comando sudo su virtualmarket.
Ir a psql y ejecutar el comando create database vm20141215; Lo ltimo es el
nombre de la base de datos, que en este caso es la del 15 de diciembre del
2014.
Creada la base de datos se debe ir al directorio del archivo .sql y ejecutar el
comando psql vm20141215 < vm20141215.sql (Se debe descargar el
archivo .sql de vm. Este es vm20141215.sql).
Ahora, en los archivos de configuracin de virtualmarket, en la carpeta conf
dentro de grails-app. Se debe editar el archivo DataSource.groovy con los
nombres de las bases de datos. (vm20141215).

Actualizada la base de datos, ir a bulkindexAtStart y cambiar false por true,

esto habilitara el indexado para las licitaciones de elasticSearch.
Esto toma harto tiempo, aproximadamente 8 horas, se recomienda dejar la
maquina trabajando sola.
Terminado el indexado, cambiar bulkIndexAtStart por false. Esto deshabilitara
el indexado, ya que solo se requiere una vez por ambiente.
Si se dispone de las licitaciones ya indexadas, se puede descomprimir el
archivo en opt/elasticsearch y as evitar tantas horas de espera.
NOTA: Si apaga el computador al finalizar todos los pasos anteriores, recuerde
que debe iniciar el servicio de elasticSearch, se debe ir al directorio
opt/elasticsearch# y ejecutar el comando bin/elasticsearch -f para inicializar o
arrancar el servicio.
Ahora para correr la aplicacin, debe ingresar a traves de la terminal de Debian
al directorio de virtualmarket: Por ej PC/Descargas/virtualmarket
Aqu ejecutar los siguientes comandos:
Para entrar en grails
grails
Y luego de que se cargo grails, ejecute el comando
run-app
Espere a que termine de cargar todo, y entre al enlace que le proporciona la
terminal, algo como: http://localhost:8080/virtualmarket
Cabe destacar que para observar el correcto funcionamiento de Virtual market
debe ser ejecutado desde el browser Safari.