Software Público Brasileiro

Roteiro para instalação e configuração do SAIKU para uso com o i3Geo (testado no Ubuntu).

Para mais informações veja em: http://docs.analytical-labs.com/

Importante:

	A integração do SAIKU com o i3GEO é experimental.

	Por questões de segurança, modifique o arquivo de configuração do Apache incluindo as seguintes diretivas:

		<Directory /var/www/ms_tmp/saiku-datasources>
			Order Deny,Allow
			Deny from All
		</Directory>

	No caso o texto "/var/www/ms_tmp" deve ser alterado para refletir as configurações do seu servidor, indicando corretamente a pasta temporária

-------------------
	Edite o arquivo

	saiku-server/tomcat/webapps/saiku/WEB-INF/users.properties

	Para remover o usuario anonimo ou acrescentar novos usuarios
-------------------

Utilize uma das opções abaixo para instalar o servidor saiku-server

1) Download do software diretamente de http://meteorite.bi/saiku/download

		- Faça o download do SAIKU Server no endereço: http://meteorite.bi/saiku/download

		- Descompacte os arquivos em uma pasta em seu servidor (no Linux /var por exemplo)

		- Edite o arquivo saiku-server/tomcat/conf/server.xml para definir a porta utilizada pelo SAIKU

			Procure por

				<Connector port="9090" protocol="HTTP/1.1"

			e modifique o valor da porta se achar necessário

		- Fontes de dados

			O i3Geo cria arquivos de fontes de dados em uma pasta temporária. Essa pasta é criada quando o i3Geo é inicializado.
			(/tmp/ms_tmp/saiku-datasources por padrão)

			Para que o SAIKU veja essa pasta é necessário editar o arquivo

			saiku-server/tomcat/webapps/saiku/WEB-INF/saiku-beans.xml

			Procure pela linha:

			<property name="path" value="res:saiku-datasources" />

			Altere para:

			<property name="path" value="file:///tmp/ms_tmp/saiku-datasources/"/>

		- Arquivos alterados

			Alguns dos códigos do SAIKU originais foram alterados. As alterações estão na pasta i3geo/ferramentas/saiku/saiku-server
			O conteúdo dessa pasta deve ser copiado para a pasta onde o saiku for instalado (saiku-server)

2) Download via Git do saiku-server com as alterações já realizadas

		Veja as orientações sobre uso do Git e sobre como obter o código do i3geo. A obtenção do código do saiku-server segue a mesma lógica, no entanto você deve usar como exemplo os comandos abaixo:

		mkdir /var/saiku-server
		cd /var/saiku-server
		git -c http.sslVerify=false clone http://softwarepublico.gov.br/gitlab/i3geo/saiku-server.git .


Após a obtenção dos arquivos, inicialize o servidor

	Procure na pasta saiku-server o programa start-saiku.bat (para Windows) ou start-saiku.sh para Linux.

	Execute esse programa. No caso do linux, digite no terminal (importante: inicie como administrador):

		sudo ./start-saiku.sh

	Abra o navegador e digite:

		http://localhost:9090/

	(Se aparecer a tela de login. Utilize admin como usuário e admin como senha)

Ajustes nas variáveis de inicialização do i3geo/ms_configura.php

	No arquivo i3geo/ms_configura.php existem duas variáveis que são utilizadas na integração com o SAIKU.

	Edite esse arquivo caso seja necessário adaptar os parâmetros conforme suas necessidades.

	Observe principalmente o endereço de acesso ao SAIKU e os parâmetros de conexão com o banco de dados e tabela com a dimensão temporal

Banco de dados

	O banco de dados PostgreSQL a ser utilizado pode ser qualquer um já existente e que esteja cadastrado como uma conexão no
	sistema de metadados estatísticos.

	Esse banco deve ter as funções Postgis e deve também conter a tabela com a dimensão tempo.

	Essa tabela pode ser obtida fazendo-se o RESTORE do banco de dados default. Para obter o arquivo de backup utilize:

	https://softwarepublico.gov.br/gitlab/i3geo/i3geosaude/blob/master/databasei3geosaude.backup

	Por padrão, esse banco de ve ser restaurado em um DATABASE chamado "i3geosaude" com usuário "postgres" e senha "postgres"

	Se o banco de dados "i3geosaude" não for utilizado, apenas copie a tabela i3geo_metaestat.dim_tempo
	para dentro do banco de dados que será utilizado



Observação:

Para testar o uso do SAIKU e aprender mais sobre sua instalação, dê preferência ao uso do arquivo de instalação do SVN
e utilize o database i3geosaude.

Após se assegurar que está tudo funcionando, faça os ajustes necessários.

O banco de dados de administração do i3Geo, localizado em i3geo/admin/admin.db, contém as definições de variáveis que são compatíveis com
o banco de dados i3geosaude, permitindo o teste do funcionamento do SAIKU.

Para acionar o SAIKU utilize o menu suspenso do i3Geo (item Análise).

Importante:

Altere as permissões da pasta saiku-server de forma a impedir a escrita.

O SAIKU utiliza os arquivos de fonte de dados que são criados de forma dinâmica na pasta ms_tmp/saiku-datasources.
Esses arquivos apontam para o arquivo XML com o esquema utilizado para construir os cubos, que também são criados de forma dinâmica.
Como o SAIKU precisa ler esse arquivo XML, o mesmo deve ter permissões de leitura de forma que o Apache consiga carregar esse arquivo XML.
É importante destacar que ao fazer isso o arquivo xml fica exposto, o que pode permitir que um usuário qualquer tenha acesso a esse XML.
Esse XML contém os SQL utilizados para acessar o banco de dados. Ao usar o SAIKU é necessário avaliar se essa característica pode
apresentar-se como um problema de segurança