Instalación y Configuración. Libertya BI 1.0

Transcripción

1 Instalación y Configuración Libertya BI 1.0 1

2 Índice 1. Instalación Configuración de Instalación Configuración conexión a base de datos PostgreSQL Configuración conexión a base de datos JasperServer Configuración de ETL Otros parámetros de configuración Configuración post-instalación...6 2

3 1. Instalación 1) Descargar el archivo zip y descomprimirlo donde se desee. 2) Versiones Jasperserver compatibles: 3.7.0, ) Versiones Libertya compatibles: ) Luego de descomprimida, deberíamos ver una carpeta Install que es donde se encuentran los scripts de instalación para windows y ambientes unix, denominados Install-LYBI_1.0.bat y Install-LYBI_1.0.sh respectivamente. 5) A su vez, podemos encontrar una carpeta denominada config que posee dos archivos de configuración de instalación, también una para ambientes windows y unix, denominados configlybi.bat y configlybi.sh respectivamente. 6) La instalación requiere de esa configuración, algunas opciones son opcionales y otras obligatorias. En la sección siguiente se explicarán los campos de configuración. 7) Como pre-requisitos de ejecución del script de instalación debemos tener instalado Java 1.5 o preferiblemente superior y los clientes de PostgreSQL 8.3 o inferior (comando psql debe existir) y MySQL (comando mysql debe existir, la instalación típica de Jasperserver posee el cliente MySQL). 8) Luego de realizada la configuración, ejecutar el script de instalación. 9) Realizar la configuración ETL en caso que sea necesario. NOTA: Es posible ejecutar varias veces el script de instalación, tener en cuenta que se eliminará la base de datos de libertya BI en cada ejecución. 2. Configuración de Instalación La instalación requiere una configuración que se encuentra en la carpeta config del directorio Install. Allí encontraremos los dos archivos mencionados configlybi.bat y configlybi.sh para entornos windows y unix respectivamente. Estos archivos contienen parámetros de configuración formateados por secciones. A continuación, se detallan las secciones y los parámetros Configuración conexión a base de datos PostgreSQL La configuración de esta conexión no se debería modificar si esta instalación se realiza en la misma PC donde se realizó la instalación de Libertya. En el caso que se haya realizado la instalación de Libertya en otra PC, se deberían modificar algunos de los parámetros. Esta configuración nos permitirá acceder al servidor de base de datos, generalmente se debería instalar en el mismo servidor donde se encuentra instalado la base de datos de Libertya, pero es posible cambiarlo a gusto. A continuación se presentan las variables de configuración en caso que se requiera, es bastante explicativo el archivo de configuración, pero se detalla a continuación para más información: ACLARACIÓN: Si la instalación se realizará en la misma PC donde se instaló Libertya, no se deberían modificar estos datos de conexión. 3

4 LYBI_SERVER: Servidor de base de datos donde se realizará la instalación de la base de datos de Libertya BI 1.0, en caso que sea el mismo servidor donde se instaló Libertya previamente, colocar el nombre de host o ip correspondiente. LYBI_PORT: Puerto del servidor de base de datos. Por defecto se toma el puerto por defecto de PostgreSQL. LYBI_USER: Usuario de acceso a la base de datos, debe tener permisos para crear y eliminar bases de datos. Por defecto, se utiliza el usuario es libertya, que vale aclarar que es necesario que ese usuario exista en el servidor de base de datos. LYBI_USERPASS: Clave del usuario de acceso. Por defecto, es libertya, pero se debería cambiar si no es esa la clave. LYBI_DB: Nombre de la base de datos de Libertya BI a crear, preferiblemente este dato no se debería cambiar, pero si se desea es posible. LYBI_DELTABLE: Este dato nos permite eliminar la base de datos Libertya BI si es que existe, muy usado en el caso de re-instalaciones, preferiblemente no se debería modificar este dato ya que una re-instalación de la aplicación que encuentre que la base de datos existe puede tirar errores Configuración conexión a base de datos JasperServer La configuración de esta conexión no se debería modificar si esta instalación se realiza en la misma PC donde se realizó la instalación de Libertya. En el caso que se haya realizado la instalación de Libertya en otra PC, se deberían modificar algunos de los parámetros. Estos parámetros nos permitirán cargar los reportes y cubo de Libertya BI 1.0. Esta configuración nos permitirá acceder a la base de datos que accede el japerserver. Si la instalación de JasperServer se realizó con el MySQL que trae por defecto, estos parámetros deberían coincidir con la PC donde se encuentra instalado. Si, en cambio, se utilizó un MySQL existente, se debería modificar esta configuración. A continuación se presentan las variables de configuración en caso que se requiera, es bastante explicativo el archivo de configuración, pero se detalla a continuación para más información: ACLARACIÓN: Si la instalación se realizará en la misma PC donde se instaló Jasperserver y se utilizó el MySQL que viene por defecto, no se deberían modificar estos datos de conexión. JASPER_SERVER: Servidor de base de datos MySQL que utiliza el Jasperserver, por defecto es la PC local. JASPER_PORT: Puerto del servidor de base de datos. Por defecto se toma el puerto por defecto de MySQL. JASPER_USER: Usuario de acceso a la base de datos. El MySQL que viene por defecto con Jasper, crea un usuario llamado jasperdb, este usuario es el utilizado por defecto en la instalación Libertya BI, cambiar en caso que se requiera. JASPER_USERPASS: Clave del usuario de acceso a la base de datos. El MySQL que viene por defecto con Jasper, crea el usuario llamado jasperdb con clave 'password', este usuario es el utilizado por defecto en la instalación Libertya BI, cambiar en caso que se requiera. A su vez, este MySQL por defecto crea el usuario root con la misma clave. JASPER_DB: Nombre de la base de datos de Jasper. Por defecto está tomado la base de datos que se crea en la instalación por defecto de Jasper, cambiar en caso que se requiera. 4

5 2.3. Configuración de ETL Esta configuración nos permite indicar a priori una configuración inicial de ETL, aunque es posible modificarlo manualmente luego de la instalación. A continuación se realizará un detalle de cada campo de configuración: LY_SERVER: Servidor de base de datos PostgreSQL donde se encuentra instalada la base de datos de Libertya. Descomentar y modificar en caso que sea distinto al servidor PostgreSQL de instalación de Libertya BI en la variable previamente descrita LYBI_SERVER. LY_PORT: Puerto del servidor de base de datos de Libertya. Descomentar y modificar en caso que sea diferente al puerto de la instalación de Libertya BI en la variable descrita LYBI_PORT. LY_USER: Usuario de acceso a la base de datos de Libertya. Por defecto el usuario es el mismo dela instalación de Libertya BI, libertya, preferiblemente no se debería modificar este dato aunque no coincida con ese usuario. Descomentar y modificar en caso que no sea igual a la variable LYBI_USER. LY_USERPASS: Clave de usuario de la base de datos. Por defecto se toma la misma clave que la utilizada en la instalación de Libertya BI en la variable LYBI_USERPASS. Descomentar y modificar en caso que se requiera. LY_DB: Nombre de la base de datos de Libertya. En instalaciones típicas, la base de datos se denomina libertya. Descomentar y modificar en caso que se haya modificado ese nombre en algún momento. initial_dimension_fecha: Esta variable, en formato yyyy-mm-dd (año-mes-día), permite configurar el inicio de las dimensiones de fechas para los datos. Esto permite la visualización de la información de nuestra empresa desde una fecha inicial, las operaciones de ventas anteriores a esta fecha no se mostrarán en los reportes y cubos. Por defecto está colocada la fecha , modificar en caso que se requiera, generalmente debería coincidir con la fecha de inauguración de la empresa. value_default: Valor por defecto de las claves de búsqueda cuando no se tiene la información cargada en Libertya, por ejemplo si tenemos una Familia de Artículos sin valor en el campo Clave de búsqueda, se tomará este valor por defecto. name_default: Valor por defecto del nombre cuando no se tiene la información cargada en Libertya, por ejemplo si tenemos una Familia de Artículos sin valor en el campo Nombre, se tomará este valor por defecto. AD_Client_ID: ID de la Compañía, en una instalación típica es el mismo valor de la compañía Libertya que viene por defecto en la instalación. No modificar en caso que se esté utilizando dicha compañía, si se está utilizando otra compañía creada es necesario cambiar este valor. Este valor es posible obtenerlo en la tabla AD_Client, columna AD_Client_ID de la base de datos de Libertya. log_file_path: Path donde colocar el archivo de log de la ejecución de los ETL. all_records: Este campo es muy importante para el inicio de la ejecución ya que permite cargar toda la información de la empresa hasta la fecha. Luego de la ejecución exitosa inicial de información, se debería modificar a 'N' para que sólo tenga en cuenta la información actual, la contenida en el período de fechas que se indica también como configuración en los campos Fecha_inicio e Interval que se explicarán en detalle a continuación. Fecha_inicio: Fecha de inicio del intervalo de pasaje y carga de la información desde Libertya a Jasperserver. Esta fecha de inicio es tomada cuando no se deben importar todos los registros (all_records=n). Si no se indica ninguna fecha se toma siempre la fecha actual por defecto, descomentar y modificar si se desea un rango específico de fechas. Interval: Cantidad de días hacia atrás desde la fecha de inicio configurada. Esto nos permite indicar una cantidad de días hacia atrás desde la fecha de inicio para la importación de la información de Libertya a Jasperserver. Recordar que si no se indica una fecha de inicio específica se toma siempre 5

6 la fecha actual y si dejamos 30 como cantidad de días hacia atrás en este intervalo, se tomará la información de Libertya desde la fecha actual a 30 días hacia atrás, actualizando y agregando información en cada caso. smtp_server: Servidor SMTP que permite el envío de mails de la ejecución ETL en caso que haya producido algún error. El error viaja como cuerpo del mail enviado. smtp_user_auth: Usuario de autorización del servidor SMTP para el envío de mails. smtp_pass_auth: Clave del usuario de autorización del servidor SMTP para el envío de mails. mail_from: Dirección de correo electrónico emisor del mail. mail_to: Direcciones de correo electrónico receptores del mail, las direcciones deben ir separadas por ; Otros parámetros de configuración LYBI_ROOT: Directorio raíz del sistema (No modificar). LYBI_CONF_LOADED: Variable que determina si la configuración se cargó con éxito en la instalación (No modificar). MYSQL_HOME: Directorio home de la instalación de Mysql (en caso que el comando 'mysql' no se pueda ejecutar desde la línea de comandos). La instalación usará el directorio bin de ese directorio HOME para insertarla en el PATH de búsqueda de comandos y pueda ejecutarse el comando mysql sin problemas. Si la instalación tira un error similar a no se reconoce el comando mysql se debe configurar este parámetro. POSTGRESQL_HOME: Directorio home de la instalación de PostgreSQL(en caso que el comando 'psql' no se pueda ejecutar desde la línea de comandos). La instalación usará el directorio bin de ese directorio HOME para insertarla en el PATH de búsqueda de comandos y pueda ejecutarse el comando psql sin problemas. Si la instalación tira un error similar a no se reconoce el comando psql se debe configurar este parámetro. JAVA_HOME: Directorio home de la instalación de Java (en caso que el comando javal' no se pueda ejecutar desde la línea de comandos). La instalación usará el directorio bin de ese directorio HOME para insertarla en el PATH de búsqueda de comandos y pueda ejecutarse el comando java sin problemas. Si la instalación tira un error similar a no se reconoce el comando java se debe configurar este parámetro. 3. Configuración post-instalación La configuración post-instalación sólo tiene en cuenta la configuración del ETL. Las tareas post-instalación comprenden: 1) Programar ETL: Programar la ejecución del ETL desde los scripts llamados ETL_LYBI_run.bat y ETL_LYBI_run.sh para entornos windows y unix respectivamente. Estos scripts se encuentran en la carpeta ETL_LYBI del directorio de instalación del ETL. Es recomendable programar estos scripts cuando no se están utilizando ninguno de los dos sistemas (Libertya y Jasperserver), generalmente se programan a la madrugada. 2) Configuración ETL: La configuración del ETL se realiza en base a los mismos parámetros indicados en la configuración del ETL para la instalación. El archivo con los parámetros para el ETL se denomina Default.properties y se encuentra en la carpeta ETL_LYBI/lybi/etl_lybi_1_0/contexts del directorio de instalación del ETL. Luego de una ejecución e importación inicial con todos la información hasta la fecha, es preferible 6

7 cambiar el parámetro all_records a N para que sólo se importe la información del intervalo de tiempo especificado y no toda la información ya cargada. Es posible configurar los demás parámetros a gusto, envío de mails por errores, etc. 3) Configuración usuarios Jasperserver: Jasperserver trae la opción de cambio de clave por defecto desactivada, esto es, los usuarios no pueden cambiar su propia clave por defecto. Para poder realizar esto, en el archivo jasperserver-servlets.xml del directorio jasperserver/web-inf en la carpeta pública del servidor tomcat (generalmente apachetomcat/webapps), debemos buscar la propiedad llamada allowuserpasswordchange y cambiar el valor de false a true. Luego, reiniciar el jasperserver y aparecerá la opción de cambio de clave en la página de login. A su vez, poseemos una propiedad llamada passwordexpirationindays que determina la cantidad de días en que se expirará la clave. 4) Drivers PostgreSQL: A menudo cuando deseamos ver la información dentro de Jasperserver por medio de algún reporte o el cubo, la instalación de Jasperserver no trae por defecto los drivers para la comunicación con la base de datos de PostgreSQL. El error que se produce generalmente es similar a no se encuentra la clase org.postgresql.driver. Para solucionar esto, simplemente debemos copiar esos mismos drivers a una carpeta de la instalación del tomcat. Los drivers de postgresql los pueden encontrar en la carpeta lib de la instalación del ETL, el archivo se denomina postgresql jdbc3.jar. Este archivo se debe copiar dentro de la carpeta apache-tomcat/common/lib o apache-tomcat/lib (para el caso que no exista la carpeta common). Reiniciar el Jasperserver o Tomcat (para una instalación de Jasperserver que utiliza un Tomcat existente y no el que trae Jasperserver). 5) Imágenes Jasperserver: (a) Imágenes en Reportes: Al ejecutar un reporte o en las imágenes vistas dentro del documento Guía de Usuario, podemos notar que se encuentra un logo de Libertya. Para que sea posible modificarla y que muestre una imágen proporcionada por nosotros debemos loguearnos a Jasperserver con algún usuario administrador, como ser el usuario jasperadmin (clave por defecto jasperadmin) e ir a la carpeta Recursos dentro del repositorio de Jasper. Dentro de ella hay varios elementos, el que debemos modificar es el denominado Logo. Al editarlo (botón derecho sobre el elemento Edit o Editar) nos permite subir una nueva desde nuestra PC, debemos tener en cuenta el tamaño de la misma y que tiene soporte para los formatos de imágen más comunes, png, jpg y gif. Una vez modificado, podemos ver en los reportes la nueva imágen subida. (b) Imágenes en cabecera de página: En la cabecera de la página de Jasperserver, podemos ver algo similar a la siguientes imágenes (a la derecha y a la izquierda), puede ser distinta para las distintas versiones de Jasper: Estas dos imágenes se encuentran en la carpeta jasperserver/images (para JasperServer o inferior) o jasperserver/themes/default/images (para JasperReports 4.0 o superior) del directorio público del tomcat (generalmente apache-tomcat/webapps) donde reside el JasperServer (o JasperReports para la versión 4.0 en adelante). Para cambiar estas imágenes y permitir la visualización de imágenes propias, debemos ir a esa carpeta y almacenar la imágen deseada. A esta imágen debemos colocarle el mismo nombre que la que deseemos cambiar. Por ejemplo, si nuestra imagen se denomina 7

8 libertya.gif y el logo de la carpeta de Jasper se denomina jaspersoft-logo.gif (Jasper o inferior) o logo.png (Jasper 4.0 o superior), entonces a nuestra imagen libertya.gif debemos renombrarla a jaspersoft-logo.gif (tener en cuenta la extensión de la imagen a modificar, debe ser la misma). Cuando presionamos tales logos en las versiones o inferior (Jasper 4.0 no tiene esta funcionalidad), por defecto están linkeados a y jasperforge.org, para modificar dichos destinos y colocar a nuestro gusto debemos modificar el archivo decorator.jsp de la carpeta jasperserver/web-inf/decorators de la carpeta pública del Tomcat donde se encuentra instalado el Jasperserver (generalemente apachetomcat/webapps). Buscar las direcciones mencionadas dentro del archivo y modificarlas a gusto, a su vez pueden modificar el nombre del archivo de la imágen si no desean renombrar el logo anteriormente descrito. 8