Download TDA

W5 Solutions
TDA
Manual de Instalación y Actualización
Versión 2.71
12
Manual de Instalación y Actualización
1.
Instalación TDA .................................................................................................................................................... 3
a.
Prerrequisitos ....................................................................................................................................................... 3
b.
Creación de la base de datos “TDA” en Microsoft SQL Server ....................................................................... 3
c.
Preparar directorio de instalación de TDA ...................................................................................................... 3
d.
Verificar versión de IIS - Internet Information Services ................................................................................. 3
e.
Realizar las configuraciones en IIS................................................................................................................... 3
f.
Configurar los archivos web.config ................................................................................................................. 4
2.
Actualización de TDA ........................................................................................................................................... 4
a.
Prerrequisitos ................................................................................................................................................... 4
b.
Actualizar base de datos .................................................................................................................................. 4
c.
Actualizar archivos del sistema ....................................................................................................................... 4
3.
Configuración de IIS para un nuevo Sub-Site ...................................................................................................... 5
a.
Prerrequisitos ................................................................................................................................................... 5
b.
Configuración necesaria. ................................................................................................................................. 5
4.
Performance ......................................................................................................................................................... 5
a.
Funcionamiento ............................................................................................................................................... 5
b.
Configuración ................................................................................................................................................... 5
1.
Instalación TDA
a. Prerrequisitos
i. Microsoft Windows Server 2003, 2008 o 2008 R2
ii. Internet Information Service (IIS) instalado y habilitado: versión: 6, 7 ó 7.5
1 Habilitar la ejecución de archivos .asp (Active Server Pages).
iii. Microsoft .Net Framework 3.5 – Instalado y habilitado en IIS.
iv. Microsoft SQL Server 2005, 2008 ó 2008 R2.
b.
Creación de la base de datos “TDA” en Microsoft SQL Server
i. Crear una base de datos llamada “TDA” en Microsoft SQL Server.
ii. Crear un usuario en SQL Server para acceder a la aplicación. Ejemplo: “tdausr”
iii. Este usuario deberá ser “db_owner” de la base de datos “TDA”.
iv. Crear las tablas del sistema TDA ejecutando en la base de datos “TDA” el script:
1 “Script_TDA_Create_DataBase.sql.txt”
c.
Preparar directorio de instalación de TDA
i. Crear el directorio de instalación de TDA. Ejemplo: “D:\Applications\TDA”
ii. Copiar y descompactar las carpetas y archivos en el directorio de instalación.
d.
Verificar versión de IIS - Internet Information Services
i. Abrir IIS Manager y visualizar “About”.
e.
Realizar las configuraciones en IIS
i. Seguir el procedimiento conforme a la documentación de la versión utilizada:
- Microsoft IIS v7.x: http://technet.microsoft.com/en-us/library/cc731784(v=WS.10).aspx
- Microsoft IIS v6.x: http://technet.microsoft.com/en-us/library/cc757073(v=WS.10).aspx
ii.
Crear Applications Pools de acuerdo a la configuración descripta debajo:
Configuración:
Application Pool
TDA
Pivot
iii.
.NET Framework Version
v2.0
v2.0
Enable 32-Bit Application
True
True
Managed Pipeline Mode
Classic
Classic
Crear Web Applications de acuerdo a la configuración descripta debajo:
Configuración:
Virtual Path
/tda
/tda.pivot
/tda.dash
Application Pool
TDA
Pivot
TDA
Physical Path
<Carpeta de instalación de TDA>
< Carpeta de instalación de TDA>/pivot
< Carpeta de instalación de TDA>
MIME Type
.json – “text/plain”
.json – “text/plain”
Identity
f.
Configurar los archivos web.config
i. Ejecutar el archivo TDA_Configuration.bat
ii. Al ejecutar dicho archivo se abrirá una pantalla llamada “GXConfiguration”
1
2
3
4
5
6
7
iii.
2.
Seleccionar la opción Default
Server/DS: ingresar el nombre del servidor o la dirección IP en que
fue creada la base de datos TDA.
Base de datos: Ingresar el mismo nombre de la base de datos que fue creado.
Name: Ingresar el usuario para la conexión con la base de datos.
Password: Ingresar la contraseña del usuario para el acceso a la base de datos.
Save: Salvar la configuración ingresada.
Close: Cerrar la aplicación.
En la carpeta de instalación de TDA existe una carpeta llamada Pivot y en ella se encuentra un archivo que
necesita ser configurado con los parámetros correspondientes. El mismo se llama web.config.
1 En la línea 104 hay un tag <value> que contiene la dirección del servicio donde funcionará el
componente Pivot.
2 Debe ser modificado con la URL que corresponda a la instalación.
Actualización de TDA
a. Prerrequisitos
i. Es necesario estar actualizado a la versión 2.60 de TDA para poder realizar el upgrade a la versión 2.70 o 2.71.
ii. Para verificar en qué versión se encuentra su instalación, consulte la tabla TDA_Version en la base de datos
“TDA”. Esta tabla contiene un registro con el número de versión de la instalación.
b.
Actualizar base de datos
i. Ejecutar el script en la base de datos de TDA para realizar la actualización de las tablas y los registros.
ii. En caso de que se encuentre en la versión 2.50, primero deberá ejecutar el script que transforma la base de
datos hacia la versión 2.60. Luego podrá ejecutar el script que transforma la base de datos hacia la versión
2.70 y versión 2.7.1
iii. Archivo TDA Versión 2.60: “Script_TDA_V260.sql.txt”
iv. Archivo TDA Versión 2.70: “Script_TDA_V270.sql.txt”
v. Archivo TDA Versión 2.71: “Script_TDA_V271.sql.txt”
c.
Actualizar archivos del sistema
i. Realizar backup de la carpeta actual de la instalación de TDA.
ii. Copiar y/o descompactar carpetas y archivos en la carpeta de instalación, sustituyendo los archivos
existentes.
iii. Ejecutar el archivo TDA_Configuration.bat para configurar el archivo web.config del sistema.
1 Puede usar el archivo web.config del backup realizado anteriormente.
iv. En las carpetas Web y Bin de la aplicación existe un archivo llamado cliente.exe.config.
Este archivo contiene información de la base de datos, del servidor, usuario y contraseña, etc. Dicha
información debe ser actualizada para que quede igual a lo realizado sobre el archivo web.config.
1 Renombrar el archivo bin/web.config como bin/web.config.aux
2 Renombrar el archivo bin/client.exe.config como bin/web.config.
3 Editar el archivo bin/web.config utilizando la aplicación GxConfig.exe, como se menciona en el
punto 1.f.
4 Modificar los parámetros correspondientes.
5 Renombrar el archivo bin/web.config como bin/client.exe.config.
6 Renombrar el archivo bin/web.config.aux como bin/web.config.
7 Copiar el archivo bin/client.exe.config a la carpeta web (un nivel superior).
d.
Actualización a la versión 2.70 / 2.71.
i. Configuración IIS.
1 La versión 2.70 y 2.71 requiere la creación de un nuevo directorio virtual en IIS.
2 Crear un nuevo directorio virtual, con el mismo nombre del directorio principal más la extensión
.dash (ej: tda.dash) conforme a lo explicado en el punto 1.e.
Virtual Path
/tda.dash
3
Application Pool
TDA
Physical Path
<Carpeta de instalación de TDA>
MIME Type
.json – “text/plain”
Registrar Menú de parámetros generales.
a. En esta versión debemos registrar un nuevo punto de menú dentro del portal de
Administración: Parámetros Generales.
b. Realizar los siguientes pasos:
i. Administrar -> Sitios
ii. Menú
iii. Insertar
iv. Descripción: Parámetros Generales / Type: Link / Link: ../parms.aspx
v. Colocar este nuevo ítem dentro del grupo Administrar
ii.
3.
Configuración de IIS para un nuevo Sub-Site
a. Prerrequisitos
i. Es necesario tener instalado y funcionando el portal TDA.
ii. El sub-site debe registrarse y configurarse en el portal TDA.
iii. El sub-site debe tener una URL registrada en el portal TDA para ser usada en la configuración de IIS.
b.
4.
Aumentando el Timeout
1 La carpeta de instalación de TDA contiene un archivo llamado: “AddHttpRuntime2WebConfig.exe”
Al ejecutar este archivo, se aumenta el timeout de la aplicación a 10 minutos.
2 Para aumentar el timeout basta con ejecutar este archivo.
3 En caso de que 10 minutos no sea suficiente, podemos expandir este tiempo directamente en el
archivo web.config.
a. Para esto, debemos abrir el archivo web.config que se encuentra en la carpeta de
instalación de TDA.
b. La línea 79 contiene el siguiente string: “<httpRuntime maxRequestLength="409600"
executionTimeout="600" />” que fue generada a partir de la ejecución del archivo
“AddHttpRuntime2WebConfig.exe”
c. El valor 600 es el tiempo de timeout en segundos (10 minutos). Podemos aumentar este
valor a 1800 segundos (por ejemplo), que serán 30 minutos.
d. Luego de modificar el valor grabe el archivo web.config modificado.
Configuración necesaria.
i. Realizar los siguientes pasos:
1 Verificar versión do IIS.
2 Configurar los servicios en IIS.
Puede utilizar los Applications Pools creados durante la instalación de TDA.
Performance
a. Funcionamiento
i. Las consultas ejecutadas y su resultado será almacenado en una tabla (TDAXML) para acelerar el renderizado
de la pantalla.
ii. Siempre que el usuario solicite una visión y/o un filtro, la tabla será consultada. La consulta a ser ejecutada
será comparada con las consultas previas existentes en la tabla. Si se encuentra el registro significará que la
consulta ya fue realizada previamente, entonces el proceso retornará lo que ya se encuentra almacenado en
la tabla como resultado de esa consulta, sin que sea necesario volver a ejecutar la sentencia SQL contra el
motor de base de datos que corresponda, sumado a la posterior construcción de la gráfica de la visión.
iii. Una tabla de Log (TDALOGXML) donde serán almacenados todos los accesos a los gráficos y los filtros. Esta
información se utilizará para poder calcular cuales son las consultas y/o filtros que tardan más tiempo en
devolver los resultados, como así también aquellas que son más accedidas por los usuarios.
iv. La tabla (TDAXML) registrará todo acceso a una visión o dashboard.
v. Los datos serán cargados en un proceso automático de carga que será definido por el usuario.
vi. Los filtros no serán renderizados a no ser que el usuario solicite visualizar el tooltip de la visión o mostrar los
filtros.
vii. Siempre que se realice un cambio en la configuración de una visión, filtro, campo o cualquier cambio en los
parámetros de performance, la tabla (TDAXML) será borrada para que no existan problemas de datos
inconsistentes.
b.
Configuración
i. En el registro del sub-site el usuario debe activar la performance y configurarla de acuerdo con las
necesidades del sub-site.
ii.
iii.
iv.
v.
El usuario deberá definir los valores de los parámetros que se muestran en la figura superior, tanto para las
visiones como para los filtros. Esta información será tomada por un proceso automático que se encarga de
actualizar los datos a mostrar para cada visión y/o filtro que tenga activada la propiedad correspondiente.
Por ejemplo, para el caso de los filtros se podría definir que se carguen los 100 filtros que más demoran y los
200 más accedidos en los últimos 30 días.
Es posible hacer una visualización de los datos en el registro del subsite.
Parámetros.
1 En la tabla TDAPRM se deben configurar algunos parámetros. Estos datos serán utilizados para la
ejecución del proceso de carga que se ejecutará automáticamente.
2 Estos datos se encuentran almacenados por default en los scripts de actualización de la versión.
3 La información de base de datos (Usuario, contraseña, idioma) se deben actualizar para un buen
funcionamiento del proceso de carga.
4
Para actualizar los datos podemos utilizar la opción Parámetros Generales que se encuentra en el
menú Administrar, de acuerdo a lo descripto en el punto 2.d.
vi. Visiones
1 En cada visión se puede configurar en forma independiente la opción Type Query. Para el caso de
trabajar con visiones dinámicas (sus datos son actualizados en todo momento), basta con desactivar
la opción (valor Disable) y la consulta se ejecutará contra el motor de base de datos cada vez que
sea solicitada.
c.
Ejecución
i. Todo acceso a una visión o a un dashboard genera una actualización de los datos que contienen las tablas
TDALOGXML y TDAXML.
1
ii.
TDALOGXML – Almacena un registro (Log) de cualquier ejecución, tiempo de ejecución, usuario y
valor XML que permite armar la visión o el filtro.
2 TDAXML – Almacena las consultas y los resultados en formato XML, que serán consultados para
cargar los datos en la visión y/o filtro.
Siempre que se realice una actualización de la base de datos que contiene la información que consultan los
usuarios a través de visiones y filtros, debemos insertar en la tabla TDAUPD el código del Site y el código del
Subsite que corresponda. Esto permite que un proceso llamado aProcessTDAUPD.exe recargue la tabla
TDAXML con los valores actualizados.
1
5.
aProcessTDAUPD.exe – Este proceso lee la tabla TDAUPD y de acuerdo con los datos de site y
subsite que contenga, recupera de la tabla de subsites (TDASUS) los parámetros relacionados con la
cantidad de visiones, filtros y la cantidad de días que serán usado para efectuar la carga de las
consultas actualizadas en la tabla TDAXML.
PDF / Imagen
a. Instalación
i. La carpeta Setup / PDF contiene un archivo ejecutable (W5PDFSetup.exe)
ii. Al ser instalado, un servicio (w5pdf) será agregado en los servicios de Windows.
iii. Dicho servicio debe ser iniciado para que el proceso de generación de PDF quede disponible.
b.
Configuración
i. La carpeta web de la aplicación contiene un archivo llamado PDFConfig.
ii.
iii.
iv.
v.
c.
Este archivo guarda la ruta física de la instalación de la aplicación TDA.
Esta ruta deberá ser actualizado siempre que la ruta de instalación de TDA fuera modificado.
Por ejemplo: D:\aplicacion\TDA\
La ruta siempre debe finalizar con la barra invertida (\).
Utilización
i. Para utilizar la generación de PDF o imagen basta con acceder al menu de usuario, localizado del lado derecho
de la pantalla.
.
ii.
Luego, hacer click en la opción deseada (PDF / Imagen). Aguarde por la generación del archivo, que será
abierto en una nueva ventana.