1.

INTRODUCCIN

Muchos de los desarrolladores que trabajamos en inteligencia de negocios y hemos usado

saiku nos han dejado encantados gracias a su facilidad de uso y su llamativa interfaz. El
problema viene a la hora de instalarlo y configurarlo, pues en Internet encontramos
muchsima documentacin de como instalar el plugin de pentaho pero no de como instalar
saiku standalone.

El presente documento muestra el proceso que se debe llevar a cabo para instalar y
configurar SAIKU STANDALONE, es decir independiente de pentaho. Adems el
documento expone algunos errores que se comenten a la hora de tratar de instalarlo y
configurarlo con su respectiva sugerencia o solucin.

La idea de que el manual este anclado a una wiki es para que todos los expertos de saiku
aporten su granito de arena para corregirlo, mejorarlo o actualizarlo. De esta manera todos
nos podremos beneficiar de l pues seguro que en algn momento alguien escribir algo
que no conozcamos de esta fabulosa herramienta.

Este manual fue desarrollado por:

Ivan Felipe Molano Ardila (ivanfelipe@outlook.com).

Andres Camilo Ramirez Gaita (a_kmilo@hotmail.es).
 2. SAIKU

Es un visor OLAP Open Source, el cual permite visualizar los cubos realizados por
Pentaho Data Intigration (PDI) y Pentaho Schema Workbench (PSW) y presentarlos de una
forma amigable y sencilla, ya que:

1. Para crear las consulta se usa el mtodo drag and drop.

2. Posee diversidad de grficos elegantes y llamativos a la hora de presentar datos con
posibilidad de exportarlos a jpg, png, pdf y svg,
3. Posibilidad de exportar los datos a un Excel para poder crear sus propios grficos.
4. Posee un repositorio donde podemos almacenar consultas frecuentes.

En esta pgina puedes ver un demo para que te diviertas y veas el potencial que tiene esta
herramienta http://demo.analytical-labs.com , solo debes dejar el correo y poner tu cabeza a
crear indicadores.
 3. INSTALACIN DE SAIKU

3.1 Java

Saiku necesita el entorno de desarrollo de Java para funcionar, es por esto que antes de
iniciar se debe comprobar que nuestro computador o servidor tenga instalado java.

Para esto vamos a revisar si el dispositivo posee java.

Dar clic en el botn inicio.

Introducir la palabra cmd en el campo de bsqueda con el fin de abrir la consola
de comandos de Windows.
Utilizar el comando "java -version" con el fin de que el sistema informe si tiene o
no una versin de java instalado (recomendado java 1.7.1_051).

Imagen 1: java instalado

De verificarse que el computador no tiene java instalado, puede descargarlo de su pgina

principal. https://www.java.com/es/download

1.2 Configuracin de las variables de entorno.

Cuando se haya verificado que nuestro dispositivo tiene java, se procede a configurar dos
variables de entorno,

CLASSPATH: Se encarga de mantener una lista de directorios, los cuales contienen

varias clases propias de Java y a su vez un archivo JAR. De esta manera, al iniciar
algn programa asociado a esta variable, el compilador de Java, busca en su lista de
directorios, todas las clases de Java referenciadas en el programa, para finalmente
 ejecutar la aplicacin.

JAVA_HOME: tiene como labor almacenar el directorio en el cual se ha instalado

el JDK, y por medio de este, acceder a las diversas herramientas utilizadas por Java.

El proceso de configuracin es el siguiente:

Clic botn inicio.

Clic derecho en la opcin de equipo.
Propiedades.
Configuracin avanzada de sistema.
Variables de entorno.

En el panel Variables de usuario se crean las dos nuevas variables con la siguiente
informacin (dependiendo de la ruta en la que est instalado Java)

Primera variable:

Nombre de la Variable: CLASSPATH

Valor de la Variable: C:\Program Files\Java\jre7\bin

Segunda variable:

Nombre de la Variable: JAVA_HOME

Valor de la Variable: C:\Program Files\Java\jdk1.7.0_51

Para evitar errores de escritura se recomienda copiar la ruta directamente desde la barra
de navegacin de Windows.

Imagen 2: Variables de entorno

 1.3 Inicio de saiku.

Ahora que se ha configurado las herramientas necesarias. Procedemos a instalar saiku.

El proceso es el siguiente.

ingrese a la siguiente direccin http://meteorite.bi/saiku/download

Descargar Saiku server 2.5 para la plataforma windows
Descomprimir el archivo en el disco local C o en el de su preferencia.
Ingrese a C:\saiku-server-2.5\saiku-server
Ejecute start-saiku.bat
Si la respuesta de la consola es algo as como Server startup in 7686 ms. Es por
que el servicio ha subido correctamente.

Imagen 3: subida satisfactoria de saiku

De no ser as se debe devolver y revisar que tenga el java indicado y las variables
de entorno bien configuradas. (Este tutorial se prob en Windows 7)

Ingrese a la direccin http://localhost:8080/ e ingrese a la aplicacin con el usuario

administrador de la plataforma (usuario admin, contrasea admin).

Si la pantalla que le aparece en el navegador es la siguiente, felicitaciones acaba de instalar

correctamente saiku

Imagen 4: Saiku instalado correctamente

De no ser as, revise que otras aplicaciones no estn ocupando el puerto 8080, de ser as
detenga los procesos que ocupen este puerto y reinicie los servicios de saiku.
 4. CUBO PROPIO EN SAIKU

Luego de que hemos instalado correctamente saiku es hora de incluir nuestro modelo de BI.
Para esto debemos tener a la mano un modelo bi preferiblemente que haya sido probado en
pentaho con jpivot para tener la certeza de que el cubo funciona a la perfeccin, para este
caso se usar el modelo de la base de datos Classicmodels

ClassicModels es una base de datos proporcionada por eclipse para trabajar en su aplicacin
BIRT http://www.eclipse.org/birt/ sin embargo se usar para realizar el modelo
correspondiente a ella. Si deseas saber ms acerca de esta base de datos les dejo la direccin
http://www.eclipse.org/birt/documentation/sample-database.php
Bien, lo primero es tener el cubo en xml y el DataWarehouse con sus respectivas
conexiones.
4.1 Almacenar el cubo o schema

El primer paso es extraer de pentaho el cubo realizado en xml. Este xml lo genera el Schema
Workbench y lo almacena en el siguiente directorio
C:\Pentaho\biserver-ce-3.8.0-stable\biserver-ce\pentaho-solutions dependiendo de la versin de
pentaho que uses.

Ahora se debe crear un directorio llamado cubos en la siguiente direccin

C:\saiku-server-2.5\saiku-server\tomcat\webapps\saiku.

Imagen 5: Creacin del directorio cubos

Ahora incluya dentro del directorio cubos el cubo que vayas a utilizar para mi caso se llama
Classicmodels.xml

Imagen 6: Almacenamiento del cubo

4.2 Configuracin de la conexin del cubo con el DataWarehouse.

Para conectarse a la fuente de datos se determinan los siguientes pasos.

Ingrese a
C:\saiku-server-2.5\saiku-server\tomcat\webapps\saiku\WEB-INF\classes\saiku-datas
ources

Realizar una copia del archivo README y nombrarlo como

conn_classicmodels.txt

Abrir el archivo con un editor de texto como worpad o notepad++, no abrir con bloc
de notas ya que el texto no se observar correctamente.

Lo primero que se encuentra en el archivo es una advertencia de que dependiendo

de la base de datos a la que se vaya conectar necesita almacenar el conector
correspondiente en el directorio WEB-INF/lib. Para este caso el DataWarehouse se
encuentra en mySql. Estos conectores los puede descargar de la web gratuitamente o
incluso usar los que usas en el Schema workbench de pentaho.

Eliminar los smbolos # de toda la seccin de mondrian on MySQL, para

habilitar estas lneas de cdigo.

Configurar las variables.

 Type: Es el tipo de conexin, para nuestro caso OLAP
Name: Es el nombre de la conexin, para nuestro caso Classicmodels
Driver: Es el driver que conecta a mondrian, por defecto lo trae saiku ya
incorporado.
Location: es la direccin donde se encuentra nuestro DataWarehouse, nuestro cubo
y el driver de conexin.
Username: Es el usuario que conecta a la base de datos.
Password: Contrasea del usuario.

El ejemplo de la configuracin se puede evidenciar en la siguiente imagen

Imagen 7: Conexin a la base de datos y al cubo

Ahora reiniciamos saiku para que tome los cambios. Ingresamos a saiku y podemos
observar que el modelo se encuentra incorporado satisfactoriamente.

Imagen 8: Ejemplo 1- ventas por lnea de producto

 Imagen 9: Ejemplo 2- ventas por oficina a lo largo de los periodos

Imagen 10: Grfica - ventas por oficina a lo largo de los periodos

Si no has podido ingresar:

1. Revisa que hayas reiniciado saiku.

2. Revisa detenidamente la conexin a la base de datos.
3. Revisa que el usuario tenga permisos sobre la base de datos y que sta tengas los
servicios arriba.
4. Revisa detenidamente que el lugar donde estas almacenado el cubo en xml sea el
mismo que estas poniendo en la variable location.
5. Revisa que tengas el driver en el directorio adecuado. Y en la variable loctation se
haga referencia a este. (JdbcDrivers=com.mysql.jdbc.Driver;)
 6. Revisa que el cubo funcione en pentaho.

5. ROLES, USUARIO Y PERMISOS EN SAIKU

Se tiene la necesidad en algunas ocasiones, restringir los cubos a personas o departamentos

laborales de una empresa, con el fin de mantener la confidencialidad de la informacin.

Saiku permite crear usuarios, roles y permisos de acceso a determinados cubos, siendo
totalmente seguro y confiable.

5.1 Crear usuarios y roles

Para crear usuarios se deben realizar los siguientes pasos

Abrir la siguiente ruta: C:\saiku-server\tomcat\webapps\saiku\WEB-INF

Abrir el archivo users.propierties utilizando Notepad++.

Este archivo contiene la informacin de los usuarios que pueden acceder mediante un
Login a la interfaz de Saiku.

Al abrir archivo se puede observar la siguiente informacin de los usuarios, en el que se

definen los nombres de usuario con su respectiva contrasea de logueo, y el rol que
posee dentro de Saiku. (Estos roles viene por defecto de Saiku). Actualmente con
cualquiera de ellos puedes ingresar al modelo creado con todos los permisos.

Imagen 11: Configuracin de usuarios y roles

Para adicionar un usuario o un rol basta con escribirlo debajo de las lneas.
 Imagen 12: Adicin de usuarios y roles

Ahora reinicia saiku e ingresa con los datos del nuevo usuario.

Imagen 13: Adicin de usuarios y roles

5.2 permisos de acceso a los modelos.

A continuacin, se explica cmo habilitar la seguridad para la asignacin de permisos a los

modelos.

Lo primero que hay que hacer es asignarle un alias a cada role con el fin Saiku pueda
diferenciar un rol de otro, ya que no se puede implcitamente utilizar el nombre que tienen
por defecto en el archivo de configuracin de usuarios. Para esto realizar los siguientes
pasos

Ir a la siguiente direccin:
C:\saiku-server\tomcat\webapps\saiku\WEB-INF\classes\saiku-datasources.
Abrir el archivo de conexin, para este caso conn_calsicmodels.
Dirigirse a la seccin de configuracin de seguridad.

Imagen 14: Configuracin de seguridad por defecto

Y habilitar las siguientes lneas

security.enabled=true - Se define que la seguridad en Saiku ha sido habilitada

security.type=lookup Define el tipo de seguridad que utiliza Saiku.
security.mapping - Se asignan los permisos para cada tipo de rol.

Imagen 15: Configuracin de seguridad

Luego de configurar el archivo de conexin, se procede a configurar los roles de usuario por
medio de la lnea de texto security.mapping. Como se observa en la imagen, existen dos tipos
de roles definidos en las configuraciones predeterminadas de Saiku, estos son ROLE_USER y
ROLE_ADMIN. Para cada uno de estos role, se crea un alias con el cual van a ser
reconocidos al momento de permitir o denegar el acceso a un cubo. ROLE_USER, ser
nombrado como usuario, ROLE_ADMIN ser nombrado como administrador y
ROLE_PRESIDENCIA como presidencia.

Imagen 16: Configuracin de seguridad

Ahora vamos al cubo hecho en xml y vamos a restringir el acceso de cada rol.

Ingresar al cubo ubicado dentro del siguiente directorio

C:\saiku-server-2.5\saiku-server\tomcat\webapps\saiku\cubos
Dirigirse a la finalizacin del cubo (/cube).
Y escriba lo siguiente
 Imagen 17: Configuracin de acceso al cubo

Role es una etiqueta donde se determinan los permisos que se le van a asignar o denegar a a
cada rol, en este caso usuario

SchemaGrant es la etiqueta donde se determina el acceso al cubo. Para este caso

access=none implica que no se dan permisos al rol usuario, si por el contrario se le
desea dar acceso, se pone access=all.

Ahora reiniciamos saiku y podemos ver que los usuarios andres, bob, krishna y smith no
podrn ingresar al cubo debido a que los usuarios tienes rol de usuario, mientras que el
usuario admin y pedro podrn ver el cubo ya que tienen rol administrador y presidencia,
respectivamente.

Imagen 18: Ingreso al cubo con role administrador o presidencia

 Imagen 19: Ingreso al cubo con role usuario

Si deseas saber ms acerca de las etiquetas de los cubos puedes consultar la siguiente
pgina. http://mondrian.pentaho.com/documentation/schema.php