Vous êtes sur la page 1sur 46

INSTRUCTIVO DE INSTALACIN

Queryx 7


2011-01-11 Pgina I



Cdigo
Nombre del documento
Instalacin del Mdulo Java Queryx 7
Estado del documento Entregado Sin ingresar al Sistema de Calidad
Responsables
Departamento de Desarrollo Queryx 7
Departamento de Diseo de Presentacin

Control de Versiones del Documento


Versin
Fecha
liberacin
Modificacin hecha por Descripcin del cambio
1.0 2010-12-13 Departamento de Diseo de
Presentacin
Versin inicial


INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 1 de 46

CONTENIDO


Pg
1. INSTALACIN DEL SERVIDOR DE BASE DE DATOS 2
1.1 INSTALACIN EN UN SERVIDOR UNIX/LINUX/WINDOWS 2
1.1.1 Requerimientos de Hardware y software para Queryx 7 2
1.1.2 Creacin de la Instancia de Base de Datos ORACLE 2
1.1.2.1 Archivos a configurar 3
1.1.2.2 Creacin y Configuracin del archivo spfile.ora, pfile.ora. 3
1.1.3 Creacin de la instancia de base de datos ORACLE 4
1.1.3.1 SGA ptima

4
1.2 CREACIN DE LOS TABLESPACES PROPIOS DE LA APLICACIN

4
1.3 CREACIN DE LOS USUARIOS DUEOS DE LA APLICACIN 5
1.3.1
Permisos

6
1.4 CREACIN DE LOS OBJETOS DE LA APLICACIN 9
1.4.1 Cargue de datos para usuarios de Produccin y/o pruebas 9
1.4.2 Creacin de un Usuario de Prueba o Produccin 10
1.4.2.1 Cargue de Usuario de Pruebas

10
2. PUBLICACIN EN EL SERVIDOR WEB 11
2.1 INSTALACIN JAVA DEVELOPMENT KIT (JDK) 11

2.2 INSTALACIN APACHE TOMCAT 14
2.2.1 Copiar Libreras Requeridas 19

2.3 INSTALAR QUERYX 7 EN EL SERVIDOR DE APLICACIONES 21
2.3.1 Desde Tomcat Manager 21
2.3.2 Desde Despliegue 24

3. ADMINISTRACIN PARAMETRO TIMEOUT 32

4. EDICIN ORDENADA DE SALIDA REPORTES SQL DESDE INTERNET
EXPLORER
37

5. ACTIVACIN DE LA LICENCIA PARA JAPPLICATION SERVER (JAS) 40
5.1 ACTIVACIN EN LNEA 40
5.2 ACTIVACIN FUERA DE LNEA 40

6. ADMINISTRACIN DE LA MEMORIA 42
6.1 TOMCAT RUNNER 42



INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 2 de 46

1. INSTALACIN DEL SERVIDOR DE BASE DE DATOS

La instalacin de la aplicacin comprende dos etapas principales:

La instalacin del software (RDBMS), usuario y datos en el servidor de base de
datos.
La instalacin software (Queryx7) en el cliente, y configuracin del mismo para
que ste pueda correr la aplicacin como tal.


1.1 INSTALACIN EN UN SERVIDOR UNIX/LINUX/WINDOWS

1.1.1 Requerimientos de Hardware y software para Queryx 7

Ver Documento D-VTA-013


1.1.2 Creacin de la Instancia de Base de Datos ORACLE

Una vez instalado el software del manejador de bases de datos ORACLE (RDBMS),
se debe crear la instancia en la que se instalarn los objetos del Sistema de
Recursos Humanos Queryx7.

























INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 3 de 46

En lo que sigue se utilizarn las siguientes abreviaturas:

{HOME de Oracle} = Se refiere al directorio de trabajo que utiliza el
manejador (RDBMS) y que se define en el momento de la instalacin de los
productos ORACLE.
{HOME de la aplicacin SRH} = Se refiere al directorio de trabajo que utiliza la
aplicacin de recursos humanos Queryx7.
{nombre_instancia_srh} = Se refiere al nombre de la instancia en la que se
instalar la aplicacin de recursos humanos. Se sugiere como nombre de la
instancia la cadena srh.

1.1.2.1 Archivos a configurar

Para la creacin de dicha instancia se deben configurar los siguientes archivos de
parmetros:

spfile.ora
pfile.ora

1.1.2.2 Creacin y Configuracin del archivo spfile.ora, pfile.ora.

Estos archivos se crean desde el momento de la creacin de la instancia. Deben
ser configurados, conectados con el usuario sys desde SQL*Plus.

Para que el desempeo de la aplicacin de recursos humanos sea ptimo se
requiere que los archivos (spfile.ora, pfile.ora ), tengan configurados los
siguientes parametros


NLS_DATE_FORMAT=YYYY-MM-DD
NLS_DATE_LANGUAGE= Spanish
NLS_ LANGUAGE= Spanish
NLS_ TERRITORY=America
NLS_ NUMERIC_CHARACTERS= .,
NLS_ CURRENCY=$
OPEN_CURSORS=2000
OPTIMIZER_MODE=CHOOS
DB_BLOCK_BUFFERS= Depende de la memoria disponible
SHARED_POOL_SIZE= Depende de la memoria disponible






INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 4 de 46

1.1.3 Creacin de la instancia de base de datos ORACLE

Se aconseja utilizar el WIZARD de oracle de creacin de Base de Datos y se debe
escoger el set de caracteres: WE8ISO8859P15

1.1.3.1 SGA ptima

El tamao del SGA sugerido debe ser entre 35% y el 40% del total de memoria
RAM disponible.

Ver documento (parametros modificados.rtf)



1.2 CREACIN DE LOS TABLESPACES PROPIOS DE LA APLICACIN

Se deben crear los tablespaces de datos, ndices llamados TS_RH_DATOS y
TS_RH_INDICES respectivamente. En estos tablespaces se crearn todos los
objetos de la aplicacin. Estos tambin se pueden crear por medio de la consola
de administracin o por medio del siguiente script ubicado en el archivo:
Instal\Uno.sql,

Uno.sql el cual contiene el siguiente cdigo:

REM * Este script crea los tablespaces de el usuario: datos, indices
REM * [nombre de empresa].
REM * Por sugerencia, el default storage no debe superar los 12K de INITIAL
REM * y 12 k de NEXT
REM * Estos scrip deben ser actualizados para LINUX y/o UNIX.
REM *Los paths deben ser actualizados con sus respectivos Valores.

create tablespace TS_RH_DATOS
datafile 'd:\ORACLE\DATABASE\SRH10g\srhdatos1.dbf' size XXXM
autoextend on next XXXM maxsize unlimited
default storage
(initial 16k
next 16k
minextents 1
maXextents 121
pctincrease 0)
online


INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 5 de 46

/
create tablespace TS_RH_INDICES
datafile 'd:\ORACLE\DATABASE\SRH10g\srhindic1.dbf' size XXXM
autoextend on next XXXM maxsize unlimited
default storage
(initial 16k
next 16k
minextents 1
maXextents 121
pctincrease 0)
online


1.3 CREACIN DE LOS USUARIOS DUEOS DE LA APLICACIN.

Se requiere crear un usuario de sistema operativo, lo cual deber ser realizado
por el administrador del sistema y dependiendo de la plataforma del servidor bien
sea esta Unix, Linux y Windows.

Se requiere crear un usuario Oracle lo cual se realiza desde SQL*Plus y conectado
como el usuario system/{password} mediante el siguiente script:

El script de creacin de estos objetos se encuentra ubicado en el archivo:
Instal\cuatro.sql

cuatro.sql, el cual contiene el siguiente cdigo:

SPOOL cuatro.log
CONN SYSTEM/<password de system>@<nombre_instancia>
SHOW USER
create user {nombre_usuario}
identified by {password_usuario}
default tablespace TS_RH_DATOS
temporary tablespace {Tablespace_Temporal}
quota unlimited on TS_RH_DATOS
quota temporary tablespace {Tablespace_Temporal}
quota unlimited on TS_RH_INDICES
/
grant connect, resource to {nombre_usuario}
/
grant alter any table to {nombre_usuario}
/
grant drop any table to {nombre_usuario}


INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 6 de 46

/
grant create any table to {nombre_usuario}
/
grant drop any view to {nombre_usuario}
/
grant create any view to {nombre_usuario}
/
grant select any table to {nombre_usuario}
/
SPOOL OFF

@cuatro-1.sql

Nota:
A partir de Oracle 9i no es necesario (temporary tablespace
{Tablespace_Temporal}), es solo hasta Oracle 8i.


1.3.1 Permisos

Despus de creado el Usuario del Sistema de Recursos Humanos de produccin,
se debe correr los script (cuatro-1.sql y cuatro-2.sql), el cual esta ubicado
Instal\cuatro-1.sql

Cuatro-1.sql, el cual contiene el siguiente cdigo:

El contenido es el Siguiente:

spool CUATRO-1.LOG

CONN SYS/<password de sys>@<nombre_instancia> AS SYSDBA

Show user

grant all on sys.user_col_comments to {nombre_usuario} with grant option
/
grant all on cols to {nombre_usuario} with grant option
/
grant all on sys.user_constraints to {nombre_usuario} with grant option
/
grant all on sys.all_users to {nombre_usuario} with grant option
/
grant select on sys.user_cons_columns to {nombre_usuario} with grant option


INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 7 de 46

/
grant all on sys.user_objects to {nombre_usuario} with grant option
/
grant select on sys.user_tab_columns to {nombre_usuario} with grant option
/
grant all on sys.all_col_comments to {nombre_usuario} with grant option
/
grant all on sys.dba_tables to {nombre_usuario} with grant option
/
--correr como usuario system

CONN SYSTEM//<password de system>@<nombre_instancia>

grant create user to {nombre_usuario} with admin option
/
grant drop user to {nombre_usuario} with admin option
/
grant alter user to {nombre_usuario} with admin option
/
grant connect to {nombre_usuario} with admin option
/
grant create synonym to {nombre_usuario} with admin option
/
grant create any synonym to {nombre_usuario} with admin option
/
grant drop any synonym to {nombre_usuario} with admin option
/
grant execute any procedure to {nombre_usuario} with admin option
/
spool off

@Cuatro-2.sql

Llamado script cuatro-2.sql

Instal\cuatro-2.sql,

Cuatro-2.sql, el cual contiene el siguiente cdigo:

El contenido es el Siguiente:

/****************************************************************
**************


INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 8 de 46

* En oracle 9i en adelante, se deben adicionar estos permisos para que se pueda
dajar *
* compilar todos los objetos de la base de Datos. *
* Esto es por que los objetos de la Base de Datos estn encriptados *
*****************************************************************
*************/

SPOOL CUATRO-2.LOG

CONN SYS/<password de sys>@<nombre_instancia> AS SYSDBA

SHOW USER


GRANT ALL ON dba_users TO PUBLIC
/
GRANT ALL ON dba_profiles TO PUBLIC
/
GRANT ALL ON V_$SESSION TO PUBLIC
/
GRANT ALL ON v_$parameter TO PUBLIC
/
GRANT ALL ON DBA_ROLES TO PUBLIC
/
GRANT ALL ON DBA_ROLE_PRIVS TO PUBLIC
/
GRANT ALL ON DBA_SYNONYMS TO PUBLIC
/
GRANT ALL ON DBA_FREE_SPACE TO PUBLIC
/
GRANT ALL ON dbms_pipe TO PUBLIC
/
GRANT ALL ON dba_jobs TO PUBLIC
/
GRANT ALL ON dba_objects TO PUBLIC
/
GRANT ALL ON USER$ TO PUBLIC
/
GRANT ALL ON OBJ$ TO PUBLIC
/
GRANT ALL ON CON$ TO PUBLIC
/
GRANT ALL ON CDEF$ TO PUBLIC


INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 9 de 46

/
GRANT ALL ON DBA_CONS_COLUMNS TO PUBLIC
/

SPOOL OFF

Recomendable adicionar los siguientes scripts
\Instal\mnprvdob.sql
\Instal\mnprvusg.sql

Bien sea que todos los usuarios de la aplicacin se planeen instalar en una nica
instancia o en instancias separadas, se tendr el siguiente estndar para la
creacin de los usuarios:

SRHADMIN Para el usuario de Produccin.
DSRHADMIN Para el usuario de Desarrollo / Pruebas


1.4 CREACIN DE LOS OBJETOS DE LA APLICACIN.

Una vez creado el usuario, es necesario crear todos los objetos como tablas,
vistas, procedimientos, etc. que hacen parte de la aplicacin.

Esto se logra mediante la herramienta import de la B.D. el cual recupera de un
archivo todas las estructuras necesarias, al usuario especificado. Esta herramienta
se ejecuta mediante el comando imp en el servidor de B.D, o desde un cliente
(Windows 9X en adelante) si es que se han instalado las herramientas
correspondientes.

1.4.1 Cargue de datos para usuarios de Produccin y/o pruebas

Esto se logra mediante el comando imp, (imp si se est ejecutando con las
herramientas para DOS o equivalente) el cual tiene la siguiente sintaxis:

imp USERID=system/<password>@<nombre_instanacia>
file=<nombre_archivo.dmp> burrfer=3000000
fromuser=<nombre_usuario_origen> touser=<nombre_usuario_destino>
grants=n rows=y ignore=y commit=y log=<nombre_archivo_salida>.log

El archivo de datos del cual se recuperan las estructuras de la aplicacin est
ubicado en el directorio \Instal\IMPORT.BAT

Imp = Comando de Oracle ejecutado desde DOS


INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 10 de 46

USERID= system/<password>@<nombre_instanacia> Nombre del usuario con
privilegios de DBA para poder realizar un import

file = <nombre_archivo.dmp >: Archivo binario que contiene la definicin de
todos los objetos que hacen parte de la aplicacin a nivel de base de datos.
Generalmente este archivo tiene el nombre del usuario <ORIGEN> de donde se
realiza el Export

fromuser =<nombre_usuario_origen>: Especifica el usuario a partir del cual se
realiz el archivo binario.

touser = =<nombre_usuario_destino>: Especifica el usuario en el que se esta
realizando el import o se esta cargando la informacin:

log = =<nombre_archivo_salida>.log: Especifica el archivo de log que se
generar al momento de realizar el import. Este archivo contiene un log de todos
los mensajes generados por el proceso de import.

1.4.2 Creacin de un Usuario de Prueba o Produccin

Se requiere crear un usuario Oracle de prueba en el cual se cargarn los primeros
datos de prueba, se ingresaran los parmetros propios a la instalacin de cada
cliente como los son los datos bsicos de los empleados, as como los conceptos
de pago correspondientes a cada tipo de empleado y se harn las primeras
pruebas. Por lo tanto el usuario tendr que tener inicialmente los parmetros
bsicos de la aplicacin.

1.4.2.1 Cargue de Usuario de Pruebas

Cuando se va a cargar el usuario de pruebas, antes debemos correr el siguiente
script Crea_Ymn_Comb.sql que contiene tablas anidadas, luego se ejecuta el
import. (IMPORT.BAT).


Despus de haber cargado el usuario de pruebas se deben ejecutar los siguientes
script ubicados en directorio /instal/Usuarios.sql
TMN_NIV_PERF_X_USU.sql
TMN_VAR_APLIC.sql
Seis.sql



INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 11 de 46



Usuarios.sql Actualiza la Tabla usuarios.
TMN_NIV_PERF_X_USU.sql Actualiza la Tabla TMN_NIV_PERF_X_USU
TMN_VAR_APLIC.sql Actualiza la Tabla TMN_VAR_APLIC
Seis.sql Compila objetos descompilados



2. PUBLICACIN EN EL SERVIDOR WEB:


2.1. INSTALACIN JAVA DEVELOPMENT KIT (JDK)

Java Development Kit, tambin conocido como JDK, es un software que provee
herramientas de desarrollo para la creacin y ejecucin de un programa escrito en
Java. Se debe instalar JDK 6.0 update 14 o superior y se puede descargar del
sitio:
http://www.oracle.com/technetwork/java/javase/downloads/index.html

De igual forma, se puede tomar el archivo ejecutable de la carpeta Software
incluida dentro del paquete de instalacin suministrado.

NOTA: Dependiendo del Sistema Operativo se debe realizar la descarga
seleccionando la plataforma correspondiente (actualmente se encuentra
certificado para S.O. Windows).

La instalacin inicia de la siguiente manera:

Se ejecuta el archivo para iniciar la instalacin.










INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 12 de 46

El sistema comienza a preparar la instalacin del JDK.






Se aceptan los trminos de la licencia para la instalacin del JDK.












INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 13 de 46

Se selecciona la ruta para la instalacin del JDK y continuar con la instalacin.




Comienza el proceso de instalacin del JDK.





INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 14 de 46

Finaliza la instalacin.





2.2. INSTALACIN APACHE TOMCAT

Tomcat es un servidor web con soporte de servlets y JSPs. Tomcat no es un
servidor de aplicaciones, como JBoss o JOnAS. Incluye el compilador Jasper, que
compila JSPs convirtindolas en servlets. El motor de servlets de Tomcat a
menudo se presenta en combinacin con el servidor web Apache. Se debe instalar
Apache Tomcat 6.0 y se puede descargar del sitio: http://tomcat.apache.org/

De igual forma, se puede tomar el archivo ejecutable de la carpeta Software
incluida dentro del paquete de instalacin suministrado.

NOTA: Dependiendo del Sistema Operativo se debe realizar la descarga
seleccionando el archivo correspondiente (actualmente se encuentra certificado
para S.O. Windows y se debe descargar el .exe Windows Service Installer).

La instalacin inicia de la siguiente manera:

Se ejecuta el archivo para iniciar la instalacin.



INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 15 de 46


Se comienza el proceso de instalacin.




Se aceptan los trminos de licencia.





INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 16 de 46

Se seleccionan los componentes por defecto.




Se instala en la ruta por defecto.







INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 17 de 46

Se asigna el puerto, el usuario y contrasea del administrador.




Se deja la ruta por defecto.





INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 18 de 46

Comienza el proceso de instalacin.




Finaliza el proceso de instalacin. Luego de finalizado el proceso de instalacin se
debe verificar que exista en la barra de tareas el icono de la consola de
administracin para el servidor de aplicaciones indicando que el servicio ha
iniciado.





INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 19 de 46



Consola de Administracin (Monitor Tomcat)

Se puede validar la instalacin ingresando la siguiente URL en el navegador:
http://nombremaquina:8080/ y se visualizar lo siguiente:





2.2.1. Copiar Libreras Requeridas

Detener el servicio desde la consola de administracin ubicada en la barra
de tareas.


Seleccionar las libreras ubicadas en la ruta %%\Instalacin
Queryx7\Librerias y copiarlas en el directorio %%\Apache Software
Foundation\Tomcat 6.0\lib\.



INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 20 de 46



Reiniciar el servicio del servidor de aplicaciones desde la consola de
administracin.



Verificar que se hayan copiado todas las libreras en la ruta sealada.





INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 21 de 46

2.3. INSTALAR QUERYX 7 EN EL SERVIDOR DE APLICACIONES

Ejecutar el script instal.sql que se encuentra en el directorio %%\Instalacin
Queryx7\Scripts\



Realizar el despliegue de Queryx 7 en el servidor de aplicaciones. Est
operacin se puede realizar de dos (2) maneras:


2.3.1 . Desde Tomcat Manager:

i. Ingresar al navegador y digitar en la barra de direcciones la URL
http://servidor:8080/






INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 22 de 46



ii. Seleccionar la opcin Tomcat Manager.




iii. Ingresar el usuario y contrasea, definidos en el momento de la
instalacin de Apache Tomcat.










INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 23 de 46


iv. Seleccionar el archivo Queryx7.war para cargar y hacer clic sobre
el botn Desplegar.





v. Verificar que se haya realizado correctamente el despliegue de la
aplicacin.



INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 24 de 46



2.3.2. Desde el despliegue:

i. Detener el servicio del servidor de aplicaciones desde la consola de
administracin.



ii. Copiar en la ruta %%\Apache Software Foundation\Tomcat
6.0\webapps\ el archivo Queryx7.war.




iii. Reiniciar el servicio del servidor de aplicaciones desde la consola
de administracin.



INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 25 de 46



iv. Verificar que se haya realizado correctamente el despliegue de la
aplicacin, validando que exista un directorio con el mismo nombre
del archivo WAR desplegado.

Configurar el datasource en Tomcat para conectar a la base de datos, as:

La siguiente imagen describe el contenido de context.xml. Los cuadros en
rojo indican los valores que deben corresponder con el nombre del archivo
XML.

a. Editar el archivo context.xml en cualquier editor. La siguiente imagen
describe el contenido de context.xml. Los cuadros en rojo indican los
valores que deben corresponder con el nombre del archivo XML, el
nombre de usuario y contrasea de base de datos. Para este caso,
el archivo se debe llamar Queryx7.xml.



b. Ajustar los valores del datasource y guardar como <contexto>.xml.
Donde <contexto> es el nombre del contexto Web de la aplicacin.
c. Detener el servidor de aplicaciones desde la consola de administracin.
d. Copiar el archivo <contexto>.xml en la ruta %%\Apache Software
Foundation\Tomcat 6.0\conf\Catalina\localhost\.
e. Reiniciar el servidor de aplicaciones desde la consola de administracin.


Editar el archivo Queryx.properties ubicado en la ruta %%\Apache Software
Foundation\Tomcat 6.0\wepapps\Queryx7\WEB-INF\classes\conf\



INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 26 de 46


Queryx.properties

Este archivo contiene las siguientes variables:

queryx.bd.driver=oracle.jdbc.driver.OracleDriver

La anterior variable define el driver a usar para autenticar. Si se cambia de
driver, se debe cambiar el valor de esta variable.

queryx.forma.inicio=com.qmn.form.JQrxWeb

La anterior variable define el nombre con ruta de la forma JQrxWeb, forma
JForms encargada de conectar a la BD e iniciar las variables globales de la
aplicacin.

queryx.jforms.programa=/www/com.aspsolutions.gwtjforms.GWTJForms/G
WTJForms.html

La anterior variable registra el nombre del programa JForms usado para
invocar las formas.

queryx.jforms.parametros=timeout=900000&cn=<FORMA_QUERYX>&war=
Queryx7

La anterior variable registra los parmetros para el URL de las formas a


INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 27 de 46

invocar. El timeout es el tiempo de espera para que el servidor envi una
respuesta al cliente, est parmetro esta dado en milisegundos. El tag
<FORMA_QUERYX> se debe mantener. Este tag indica que en esta parte se
debe poner el nombre de la forma a invocar.

queryx.bd.url=jdbc:oracle:thin:@190.72.100.101:1521:MIGJAVA

La anterior variable define el URL de la BD para el driver.

queryx.string.conexion=MIGJAVA

La variable anterior guarda el string de conexin usado por SQLPLUS para
ejecutar los reportes SQL.

Los cuadros en rojo indican las variables que deben ser modificadas.

Generar y reemplazar el archivo jdbc.properties ubicado en la ruta
%%\Apache Software Foundation\Tomcat 6.0\wepapps\Queryx7\WEB-
INF\classes\jdbc\. Este archivo contiene los datos de conexin a la base de
datos para los objetos de la aplicacin.

Para la generacin del archivo jdbc.properties se deben seguir los siguientes
pasos:

a. Ejecutar el archivo Generador_jdb.bat ubicado en la ruta %%\Instalacin
Queryx7\Herramientas\




b. Ingresar los parmetros necesarios para generar el archivo, as:

Server IP: Direccin IP del servidor de base de datos.
Data Base Name: Nombre de la base de datos.
Server Port: Nmero del puerto de la base de datos.
User Name: Nombre del usuario de base de datos dueo de los objetos
de la aplicacin.


INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 28 de 46

Password: Contrasea del usuario de base de datos dueo de los objetos
de la aplicacin.

Presionar el botn Test Conexin para validar que la conexin a la base
de datos sea exitosa con los parmetros ingresados.



c. Presionar el botn Export to file para generar el archivo en la ruta
definida en el campo Route of jdbc.

d. Validar que se haya creado el archivo jdbc.properties en la ruta
correspondiente.




jdbc.properties


INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 29 de 46


e. Reemplazar el archivo jdbc.properties existente con el nuevo archivo
generado.

Editar el archivo licencesActivation.properties ubicado en la ruta
%%\Apache Software Foundation\Tomcat 6.0\wepapps\Queryx7\WEB-
INF\classes\. En este archivo se administra el cdigo de la empresa
(enterpriseCode) y el nmero de licencia (activationKey) suministrado por ASP
Solutions.


licencesActivation.properties


Directorio de Salidas: El directorio de salidas debe existir dentro del mismo
contexto en donde se encuentra instalada la aplicacin. Para esto es necesario
modificar el valor para los directorios No. 18 del cdigo de plataforma No. 4,
con la ruta en donde se encuentra el directorio de salidas ubicado en el
contexto de la aplicacin en Apache Tomcat %%\Apache Software
Foundation\Tomcat 6.0\webapps\Queryx7\salidas\.

NOTA: Si existen espacios en blanco en la ruta de salidas, debe definirse de la
forma abreviada asignada por el Sistema Operativo. Por ejemplo:
C:\PROGRA~1\APACHE~1\TOMCAT~1.0\webapps\Queryx7\salidas\".
Es necesario crear en esta ubicacin una carpeta con el nombre en minsculas
por cada usuario de la aplicacin.

Reiniciar el servidor de aplicaciones desde la consola de administracin.

Ingresar a la aplicacin invocando el URL http://servidor:8080/Queryx7/



INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 30 de 46




La aplicacin trabaja nicamente con las variables definidas por usuario en la
base de datos y es necesario que el valor para la constante No. 2 de
Queryx*Menu Variables del Registro de Configuracin de Windows siempre
sea igual a N. De igual forma, se deben modificar inicialmente los valores
para las siguientes variables, as:

QRX_PLUS: Nombre del archivo para ejecutar SQL Plus.
HOST_SERVAPL: Nombre o direccin IP de la mquina en la cual se encuentra
instalado el servidor de aplicaciones. Ej.:
http://<servidor_de_aplicaciones>:<puerto>
SALIDAS_WEB: Se debe definir el valor /Queryx7/salidas/.
FORMATO_FECHA: El formato de fecha debe ser yyyy-MM-dd.




INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 31 de 46











INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 32 de 46

3. ADMINISTRACIN PARAMETRO TIMEOUT

El error presentado es el siguiente:



Lo primero es ingresar al REGEDIT.
Luego abrimos el rbol de HKEY_CURRENT_USER






INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 33 de 46

Luego abrimos el rbol de software.



Y dentro de este abrimos en de Microsoft.




INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 34 de 46

Y aqu buscamos Windows.



Y dentro buscamos CurrentVersion.




INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 35 de 46


Ya estando dentro de currentVersion nos ubicamos sobre Internet Settings.



Y en la parte derecha creamos un valor DWORD, hacemos clic derecho sobre la
parte blanca seleccionamos Nuevo y luego Valor DWORD (dependiendo el
sistema operativo que se tenga).




INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 36 de 46


Creamos esta clave con el nombre ReceiveTimeout y le asignamos el valor en
decimal de (300000) cuyo equivalente es de 5 minutos, (si deseamos que sea
ms el tiempo hay que tener en cuenta que el valor esta en milisegundo, es
decir, multiplicamos es valor que queremos por 60000 y este sera nuestro valor;
Ejemplo: 5 (Min) * 60000 = 300000)



Luego de esto reiniciamos la maquina.






INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 37 de 46

4. EDICIN ORDENADA DE SALIDA REPORTES SQL DESDE INTERNET
EXPLORER

Para la edicin de los archivos generados como salida desde la aplicacin se
ajust el archivo web.xml a nivel del despliegue, incluyendo las extensiones de
archivos *.txt, *.lis, *.log, *.bad, *.csv; dicho cambio ya se encuentra dentro del
archivo Queryx7.war. De igual manera, se deben realizar los siguientes ajustes en
Internet Explorer:

Ingresar al men Herramientas en el navegador.



Seleccionar la opcin Opciones de Internet - Seleccionar la pestaa
Seguridad.





INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 38 de 46

Seleccionar la zona Internet y hacer clic sobre el botn Nivel
personalizado.












INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 39 de 46

Seleccionar o chequear la opcin Deshabilitar en el tem Abrir archivos
basndose en el contenido, no en la extensin del archivo.



Hacer clic sobre el botn Aceptar y Aplicar para salvar los cambios.
Cerrar el navegador para aplicar los cambios realizados.

Se deben asociar las extensiones de los archivos al programa correspondiente,
as:

Ingresar a Panel de Control/Programas predeterminados.
Ingresar a la opcin Asociar un tipo de archivo o protocolo con un
programa
Ubicar los tipos de extensiones *.txt, *.lis, *.log, *.bad y cambiar el
programa predeterminado a WordPad para cada uno.
Cerrar la ventana para aplicar los cambios y salir de Panel de Control.



INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 40 de 46

Estos ajustes deben realizarse en cada uno de los equipos que vayan a ser
utilizados para ingresar a la aplicacin.

5. ACTIVACIN DE LA LICENCIA PARA JAPPLICATION SERVER (JAS)

5.1. ACTIVACIN EN LNEA.

Editar el archivo licencesActivation.properties ubicado en la ruta
%%\Apache Software Foundation\Tomcat 6.0\wepapps\Queryx7\WEB-
INF\classes\. En este archivo se configura la informacin de la licencia
para el JAS, indicando el cdigo de la empresa (enterpriseCode), cdigo
de licencia (activationKey) suministrado por ASP Solutions y se define la
ruta (licencesPath) donde se almacenan los archivos de licencia. Dicha
ruta debe ser creada previamente.


licencesActivation.properties

5.2. ACTIVACIN FUERA DE LNEA.

Este mtodo de activacin se debe realizar en caso de tener problemas
con el proceso de activacin en lnea, carecer de salida a internet para
conectarse con el servidor de ASP Solutions o por restricciones de
seguridad. Cabe anotar que el proceso de licenciamiento solamente se
realiza una nica vez por mquina en el momento de realizar la
instalacin. Es importante que este proceso se realice desde la mquina
en la cual quedar instalada la aplicacin, teniendo en cuenta los
siguientes pasos:

i. Verificar que no existan residuos de una instalacin anterior, para
ello comprobar que en la ruta de la licencia (licencesPath)
configurada en el archivo licencesActivation.properties no se
encuentre ningn archivo/carpeta, en caso contrario deben
eliminarse.

ii. Ejecutar el archivo JActivatorLicences.exe ubicado en la
ruta%%\Queryx7\Utilidades\, que permitir escoger la
herramienta que se va a licenciar (JApplication Server) y la ruta


INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 41 de 46

donde se almacenarn los archivos de licencia.



iii. Ingresar la informacin para los campos resaltados en color rojo,
as:

Producto: Se selecciona 5 JApplication Server.
Ruta de la Licencia: Corresponde a la ruta (licencesPath)
definida en el archivo licencesActivation.properties. En esta ruta
se almacenarn los archivos de la licencia.
Cdigo de Activacin: Corresponde al cdigo de licencia
(activationKey) configurado en el archivo
licencesActivacion.properties.
Empresa: Corresponde al cdigo de la empresa
(enterpriseCode) configurado en el archivo
licencesActivation.properties.

iv. Presionar el botn Activar, con lo cual se generar
automticamente un cdigo numrico. Este cdigo debe enviarse
por correo electrnico al Departamento de Diseo de Presentacin
de SQL Software, solicitando la activacin de la licencia. En la ruta
(licencesPath) configurada en el archivo
licencesActivation.properties, se crear la carpeta
licContainer.



INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 42 de 46





v. SQL Software entregar mediante correo electrnico un archivo
llamado licence.lic, que debe ser copiado en la ruta (licencesPath)
configurada en el archivo licencesActivation.properties.




6. ADMINISTRACIN DE LA MEMORIA.

6.1. TOMCAT RUNNER.

Tomcat Runner es una herramienta que permite la administracin de Apache
Tomcat. Para realizar la asignacin de los parametros de memoria se deben
serguir los siguientes pasos:

Detener el servicio de Apache Tomcat.



INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 43 de 46

Ejecutar el archivo TomcatRunner.exe ubicado en (%%\Instalacin
Queryx7\Utilidades). Deber visualizarse la siguiente ventana:







INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 44 de 46

Modificar los siguientes parametros en la pestaa Preferences, as:




a. Tomcat dir: Corresponde a la ruta fsica en la cual se instal
Apache Tomcat. Ej.: C:\Program Files\Apache Software
Foundation\Tomcat 6.0 Xmx (Maximum size of the memory
allocation pool): Establece la cantidad mxima de memoria, se
debe asignar el valor 1024 MB.

b. Xmx (Maximum size of the memory allocation pool):
Establece la cantidad mxima de memoria, se debe asignar el valor
1024 MB

c. Xms (Startup size of the memory allocation pool): Establece
la cantidad inicial de memoria, se debe asignar el valor 1024 MB.

d. Xss: Establece el tamao de pila del hilo JAVA, se debe asignar el
valor 256K.

e. XX: SurvivorRatio=6

f. Xmn: =450m

g. XX: MaxNewSize=450m

h. XX: MaxPermSize=128m


INSTRUCTIVO DE INSTALACIN
Queryx 7



2011-01-11 Pgina 45 de 46


i. XX: PermSize=128m

Presionar el botn SHOW CONSOLE, con el fin de visualizar el log de Apache
Tomcat. Posteriormente, presionar el botn para iniciar el servicio de
Apache Tomcat. Deber iniciarse el servicio correctamente como se visualiza en la
siguiente imagen: