Instructivo Instalacion Queryx 7

INSTRUCTIVO DE INSTALACIÓN

Queryx 7

2011-01-11 Página I

Código

Nombre del documento Instalación del Módulo Java Queryx 7

Estado del documento Entregado – Sin ingresar al Sistema de Calidad

Responsables Departamento de Desarrollo Queryx 7

Departamento de Diseño de Presentación

Control de Versiones del Documento

Versión Fecha

liberación Modificación hecha por Descripción del cambio

1.0 2010-12-13 Departamento de Diseño de

Presentación

Versión inicial


Queryx 7

2011-01-11 Página 1 de 46

CONTENIDO Pág

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

4

1.2 CREACIÓN DE LOS “TABLESPACES” PROPIOS DE LA APLICACIÓN

4

1.3 CREACIÓN DE LOS USUARIOS DUEÑOS DE LA APLICACIÓN 5 1.3.1 Permisos

6

1.4 CREACIÓN DE LOS OBJETOS DE LA APLICACIÓN 9 1.4.1 Cargue de datos para usuarios de Producción y/o pruebas 9 1.4.2 Creación de un Usuario de Prueba o Producción 10 1.4.2.1 Cargue de Usuario de Pruebas

10

2. PUBLICACIÓN EN EL SERVIDOR WEB 11 2.1 INSTALACIÓN JAVA DEVELOPMENT KIT (JDK) 11 2.2 INSTALACIÓN APACHE TOMCAT 14 2.2.1 Copiar Librerías 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. ADMINISTRACIÓN PARAMETRO TIMEOUT 32 4. EDICIÓN ORDENADA DE SALIDA REPORTES SQL DESDE INTERNET

EXPLORER 37

5. ACTIVACIÓN DE LA LICENCIA PARA JAPPLICATION SERVER (JAS) 40 5.1 ACTIVACIÓN EN LÍNEA 40 5.2 ACTIVACIÓN FUERA DE LÍNEA 40 6. ADMINISTRACIÓN DE LA MEMORIA 42 6.1 TOMCAT RUNNER 42


Queryx 7

2011-01-11 Página 2 de 46

1. INSTALACIÓN DEL SERVIDOR DE BASE DE DATOS La instalación de la aplicación comprende dos etapas principales: La instalación del software (RDBMS), usuario y datos en el servidor de base de

datos. La instalación software (Queryx7) en el cliente, y configuración del mismo para

que éste pueda correr la aplicación como tal. 1.1 INSTALACIÓN 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 Creación 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 instalarán los objetos del Sistema de Recursos Humanos Queryx7.


Queryx 7

2011-01-11 Página 3 de 46

En lo que sigue se utilizarán 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 instalación de los productos ORACLE.

{HOME de la aplicación SRH} = Se refiere al directorio de trabajo que utiliza la aplicación de recursos humanos Queryx7.

{nombre_instancia_srh} = Se refiere al nombre de la instancia en la que se instalará la aplicación de recursos humanos. Se sugiere como nombre de la instancia la cadena “srh”.

1.1.2.1 Archivos a configurar Para la creación de dicha instancia se deben configurar los siguientes archivos de parámetros: spfile.ora pfile.ora 1.1.2.2 Creación y Configuración del archivo spfile.ora, pfile.ora. Estos archivos se crean desde el momento de la creación de la instancia. Deben ser configurados, conectados con el usuario sys desde SQL*Plus. Para que el desempeño de la aplicación 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”


Queryx 7

2011-01-11 Página 4 de 46

1.1.3 Creación de la instancia de base de datos ORACLE Se aconseja utilizar el WIZARD de oracle de creación de Base de Datos y se debe escoger el set de caracteres: WE8ISO8859P15 1.1.3.1 SGA Óptima El tamaño del SGA sugerido debe ser entre 35% y el 40% del total de memoria RAM disponible. Ver documento (parametros modificados.rtf)

1.2 CREACIÓN DE LOS “TABLESPACES” PROPIOS DE LA APLICACIÓN Se deben crear los “tablespaces” de datos, índices llamados TS_RH_DATOS y TS_RH_INDICES respectivamente. En estos “tablespaces” se crearán todos los objetos de la aplicación. Estos también se pueden crear por medio de la consola de administración o por medio del siguiente script ubicado en el archivo: Instal\Uno.sql, Uno.sql el cual contiene el siguiente código: 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


Queryx 7

2011-01-11 Página 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 CREACIÓN DE LOS USUARIOS DUEÑOS DE LA APLICACIÓN. 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 creación de estos objetos se encuentra ubicado en el archivo: Instal\cuatro.sql cuatro.sql, el cual contiene el siguiente código: 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}


Queryx 7

2011-01-11 Página 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 Después de creado el Usuario del Sistema de Recursos Humanos de producción, 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 código: 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


Queryx 7

2011-01-11 Página 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 código: El contenido es el Siguiente: /******************************************************************************


Queryx 7

2011-01-11 Página 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 están 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


Queryx 7

2011-01-11 Página 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 aplicación se planeen instalar en una única instancia o en instancias separadas, se tendrá el siguiente estándar para la creación de los usuarios: SRHADMIN Para el usuario de Producción. DSRHADMIN Para el usuario de Desarrollo / Pruebas 1.4 CREACIÓN DE LOS OBJETOS DE LA APLICACIÓN. Una vez creado el usuario, es necesario crear todos los objetos como tablas, vistas, procedimientos, etc. que hacen parte de la aplicación. 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 Producción 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 aplicación está ubicado en el directorio \Instal\IMPORT.BAT Imp = Comando de Oracle ejecutado desde DOS


Queryx 7

2011-01-11 Página 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 definición de todos los objetos que hacen parte de la aplicación 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 información: 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 Creación de un Usuario de Prueba o Producción Se requiere crear un usuario Oracle de prueba en el cual se cargarán los primeros datos de prueba, se ingresaran los parámetros propios a la instalación de cada cliente como los son los datos básicos de los empleados, así como los conceptos de pago correspondientes a cada tipo de empleado y se harán las primeras pruebas. Por lo tanto el usuario tendrá que tener inicialmente los parámetros básicos de la aplicación. 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).

Después 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


Queryx 7

2011-01-11 Página 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. PUBLICACIÓN EN EL SERVIDOR WEB:

2.1. INSTALACIÓN JAVA DEVELOPMENT KIT (JDK) Java Development Kit, también conocido como JDK, es un software que provee herramientas de desarrollo para la creación y ejecución 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 instalación suministrado. NOTA: Dependiendo del Sistema Operativo se debe realizar la descarga seleccionando la plataforma correspondiente (actualmente se encuentra certificado para S.O. Windows). La instalación inicia de la siguiente manera: Se ejecuta el archivo para iniciar la instalación.

http://www.oracle.com/technetwork/java/javase/downloads/index.html


Queryx 7

2011-01-11 Página 12 de 46

El sistema comienza a preparar la instalación del JDK.

Se aceptan los términos de la licencia para la instalación del JDK.


Queryx 7

2011-01-11 Página 13 de 46

Se selecciona la ruta para la instalación del JDK y continuar con la instalación.

Comienza el proceso de instalación del JDK.


Queryx 7

2011-01-11 Página 14 de 46

Finaliza la instalación.

2.2. INSTALACIÓN 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 convirtiéndolas en servlets. El motor de servlets de Tomcat a menudo se presenta en combinación 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 instalación 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 instalación inicia de la siguiente manera: Se ejecuta el archivo para iniciar la instalación.

http://es.wikipedia.org/wiki/Servidor_web

http://es.wikipedia.org/wiki/Servlets

http://es.wikipedia.org/wiki/Servidor_de_aplicaciones

http://es.wikipedia.org/wiki/JBoss

http://es.wikipedia.org/wiki/JOnAS

http://es.wikipedia.org/wiki/Servidor_web_Apache

http://tomcat.apache.org/


Queryx 7

2011-01-11 Página 15 de 46

Se comienza el proceso de instalación.

Se aceptan los términos de licencia.


Queryx 7

2011-01-11 Página 16 de 46

Se seleccionan los componentes por defecto.

Se instala en la ruta por defecto.


Queryx 7

2011-01-11 Página 17 de 46

Se asigna el puerto, el usuario y contraseña del administrador.

Se deja la ruta por defecto.


Queryx 7

2011-01-11 Página 18 de 46

Comienza el proceso de instalación.

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


Queryx 7

2011-01-11 Página 19 de 46

Consola de Administración (Monitor Tomcat)

Se puede validar la instalación ingresando la siguiente URL en el navegador: http://nombremaquina:8080/ y se visualizará lo siguiente:

2.2.1. Copiar Librerías Requeridas

Detener el servicio desde la consola de administración ubicada en la barra de tareas.

Seleccionar las librerías ubicadas en la ruta %%\Instalación Queryx7\Librerias y copiarlas en el directorio %%\Apache Software Foundation\Tomcat 6.0\lib\.

http://nombremaquina:8080/


Queryx 7

2011-01-11 Página 20 de 46

Reiniciar el servicio del servidor de aplicaciones desde la consola de

administración.

Verificar que se hayan copiado todas las librerías en la ruta señalada.


Queryx 7

2011-01-11 Página 21 de 46

2.3. INSTALAR QUERYX 7 EN EL SERVIDOR DE APLICACIONES

Ejecutar el script instal.sql que se encuentra en el directorio %%\Instalación Queryx7\Scripts\

Realizar el despliegue de Queryx 7 en el servidor de aplicaciones. Está operación 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/

http://servidor:8080/


Queryx 7

2011-01-11 Página 22 de 46

ii. Seleccionar la opción Tomcat Manager.

iii. Ingresar el usuario y contraseña, definidos en el momento de la instalación de Apache Tomcat.


Queryx 7

2011-01-11 Página 23 de 46

iv. Seleccionar el archivo Queryx7.war para cargar y hacer clic sobre el botón “Desplegar”.

v. Verificar que se haya realizado correctamente el despliegue de la aplicación.


Queryx 7

2011-01-11 Página 24 de 46

2.3.2. Desde el despliegue:

i. Detener el servicio del servidor de aplicaciones desde la consola de administración.

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 administración.


Queryx 7

2011-01-11 Página 25 de 46

iv. Verificar que se haya realizado correctamente el despliegue de la aplicación, 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 contraseña 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 aplicación.

c. Detener el servidor de aplicaciones desde la consola de administración. 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 administración.

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


Queryx 7

2011-01-11 Página 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 aplicación.

queryx.jforms.programa=/www/com.aspsolutions.gwtjforms.GWTJForms/GWTJForms.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 parámetros para el URL de las formas a


Queryx 7

2011-01-11 Página 27 de 46

invocar. El timeout es el tiempo de espera para que el servidor envié una respuesta al cliente, esté parámetro 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 conexión 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 conexión a la base de datos para los objetos de la aplicación. Para la generación del archivo jdbc.properties se deben seguir los siguientes pasos:

a. Ejecutar el archivo Generador_jdb.bat ubicado en la ruta %%\Instalación Queryx7\Herramientas\

b. Ingresar los parámetros necesarios para generar el archivo, así: Server IP: Dirección IP del servidor de base de datos. Data Base Name: Nombre de la base de datos. Server Port: Número del puerto de la base de datos. User Name: Nombre del usuario de base de datos dueño de los objetos de la aplicación.


Queryx 7

2011-01-11 Página 28 de 46

Password: Contraseña del usuario de base de datos dueño de los objetos de la aplicación. Presionar el botón “Test Conexión” para validar que la conexión a la base de datos sea exitosa con los parámetros ingresados.

c. Presionar el botón “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


Queryx 7

2011-01-11 Página 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 código de la empresa (enterpriseCode) y el número 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 aplicación. Para esto es necesario modificar el valor para los directorios No. 18 del código de plataforma No. 4, con la ruta en donde se encuentra el directorio de salidas ubicado en el contexto de la aplicación 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 ubicación una carpeta con el nombre en minúsculas por cada usuario de la aplicación.

Reiniciar el servidor de aplicaciones desde la consola de administración. Ingresar a la aplicación invocando el URL http://servidor:8080/Queryx7/

http://servidor:8080/Queryx7/


Queryx 7

2011-01-11 Página 30 de 46

La aplicación 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 Configuración 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 dirección IP de la máquina 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.


Queryx 7

2011-01-11 Página 31 de 46


Queryx 7

2011-01-11 Página 32 de 46

3. ADMINISTRACIÓN PARAMETRO TIMEOUT El error presentado es el siguiente:

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


Queryx 7

2011-01-11 Página 33 de 46

Luego abrimos el árbol de software.

Y dentro de este abrimos en de Microsoft.


Queryx 7

2011-01-11 Página 34 de 46

Y aquí buscamos Windows.

Y dentro buscamos CurrentVersion.


Queryx 7

2011-01-11 Página 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).


Queryx 7

2011-01-11 Página 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 más 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.


Queryx 7

2011-01-11 Página 37 de 46

4. EDICIÓN ORDENADA DE SALIDA REPORTES SQL DESDE INTERNET EXPLORER

Para la edición de los archivos generados como salida desde la aplicación 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 opción “Opciones de Internet” - Seleccionar la pestaña “Seguridad”.


Queryx 7

2011-01-11 Página 38 de 46

Seleccionar la zona “Internet” y hacer clic sobre el botón “Nivel personalizado”.


Queryx 7

2011-01-11 Página 39 de 46

Seleccionar o chequear la opción “Deshabilitar” en el ítem “Abrir archivos basándose en el contenido, no en la extensión del archivo”.

Hacer clic sobre el botón “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 opción “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.


Queryx 7

2011-01-11 Página 40 de 46

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

5. ACTIVACIÓN DE LA LICENCIA PARA JAPPLICATION SERVER (JAS)

5.1. ACTIVACIÓN EN LÍNEA.

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 información de la licencia para el JAS, indicando el código de la empresa (enterpriseCode), código 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. ACTIVACIÓN FUERA DE LÍNEA.

Este método de activación se debe realizar en caso de tener problemas con el proceso de activación en línea, 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 máquina en el momento de realizar la instalación. Es importante que este proceso se realice desde la máquina en la cual quedará instalada la aplicación, teniendo en cuenta los siguientes pasos:

i. Verificar que no existan residuos de una instalación anterior, para ello comprobar que en la ruta de la licencia (licencesPath) configurada en el archivo licencesActivation.properties no se encuentre ningún 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


Queryx 7

2011-01-11 Página 41 de 46

donde se almacenarán los archivos de licencia.

iii. Ingresar la información 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 almacenarán los archivos de la licencia.

Código de Activación: Corresponde al código de licencia (activationKey) configurado en el archivo licencesActivacion.properties.

Empresa: Corresponde al código de la empresa (enterpriseCode) configurado en el archivo licencesActivation.properties.

iv. Presionar el botón “Activar”, con lo cual se generará automáticamente un código numérico. Este código debe enviarse por correo electrónico al Departamento de Diseño de Presentación de SQL Software, solicitando la activación de la licencia. En la ruta (licencesPath) configurada en el archivo licencesActivation.properties, se creará la carpeta “licContainer”.


Queryx 7

2011-01-11 Página 42 de 46

v. SQL Software entregará mediante correo electrónico un archivo llamado “licence.lic”, que debe ser copiado en la ruta (licencesPath) configurada en el archivo licencesActivation.properties.

6. ADMINISTRACIÓN DE LA MEMORIA.

6.1. TOMCAT RUNNER.

“Tomcat Runner” es una herramienta que permite la administración de Apache Tomcat. Para realizar la asignación de los parametros de memoria se deben serguir los siguientes pasos: Detener el servicio de Apache Tomcat.


Queryx 7

2011-01-11 Página 43 de 46

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


Queryx 7

2011-01-11 Página 44 de 46

Modificar los siguientes parametros en la pestaña “Preferences”, así:

a. Tomcat dir: Corresponde a la ruta física 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 máxima de memoria, se debe asignar el valor 1024 MB.

b. Xmx (Maximum size of the memory allocation pool): Establece la cantidad máxima 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 tamaño 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


Queryx 7

2011-01-11 Página 45 de 46

i. XX: PermSize=128m

Presionar el botón “SHOW CONSOLE”, con el fin de visualizar el log de Apache

Tomcat. Posteriormente, presionar el botón para iniciar el servicio de Apache Tomcat. Deberá iniciarse el servicio correctamente como se visualiza en la siguiente imagen:

Instructivo Instalacion Queryx 7

Documents

Transcript of Instructivo Instalacion Queryx 7