Guia de instalao Logix BI

Maio /2012




Copyright 2012 TOTVS. Todos os direitos reservados.
Nenhuma parte deste documento pode ser copiada, reproduzida, traduzida ou transmitida por qualquer meio
eletrnico ou mecnico, na sua totalidade ou em parte, sem a prvia autorizao escrita da TOTVS, que se reserva o
direito de efetuar alteraes sem aviso prvio. A TOTVS no assume qualquer responsabilidade pelas consequncias
de quaisquer erros ou inexatides que possam aparecer neste documento.

TOTVS S.A.
Av. Braz Leme, 1717 So Paulo-SP
Brasil www.totvs.com

Guia de instalao



2 Guia de instalao
Verso 1.0
Sumrio
Prefcio .......................................................................................................................... 3
Captulo 1: Requisitos de instalao................................................................................. 4
Captulo 2: Instalao ...................................................................................................... 5
2.1 Instalao da plataforma no Windows ....................................................................... 5
2.1.1 Instalao do pacote do Logix BI .................................................................................................................... 6
2.1.2 Inicializando o Logix BI .................................................................................................................................... 7
2.2 Instalao da plataforma no Linux .............................................................................. 10
2.2.1 Instalao do pacote do Logix BI .................................................................................................................... 11
Captulo 3: Instalando atualizaes .................................................................................. 12





Guia de instalao



3 Guia de instalao
Verso 1.0
Prefcio

Este documento contm os procedimentos necessrios para fazer a correta instalao e atualizao do
Logix BI 11.
As informaes deste Guia de instalao esto organizadas em captulos, conforme estrutura abaixo:
Requisitos de instalao: so apresentados os requisitos para instalao do Logix BI.
Instalao: apresentado os procedimentos para a instalao da plataforma e da aplicao.
Instalando atualizaes: apresentado os procedimentos para a atualizao do Logix BI.



Guia de instalao



4 Guia de instalao
Verso 1.0
Captulo 1: Requisitos de instalao

Para o bom funcionamento do sistema alguns requisitos mnimos devem ser contemplados, abaixo so
listados esses requisitos.

Navegadores:

Mozilla Firefox 5 ou superior.
IE 8 ou superior.
Nota: No IE 9 deve estar ativo o modo de compatibilidade.

Hardware:

Espao em disco: 1 GB
Memria RAM: 2 GB
Processador: 2 GHz
Arquitetura: 32 ou 64 bits
Nota: Recomenda-se a arquitetura de 64 bits, devido ao melhor gerenciamento da memria.

Sistema Operacional:

Windows 7, Windows Server
Linux (Red Hat, Suse 10 ou CentOS)
Bancos de dados:

Informix 11.10 ou 11.50
Oracle 10 ou 11
SQL Server 2005 ou 2008
DB2 9.5









Guia de instalao



5 Guia de instalao
Verso 1.0
Captulo 2: Instalao

Neste captulo apresentado o processo de instalao para as diferentes plataformas de sistema
operacional.
2.1 Instalao da plataforma no Windows

Para fazer a instalao do Logix BI em ambiente Windows necessrio fazer o download do pacote
compatvel com a plataforma. O pacote esta disponvel na Central de Downloads que pode ser acessada no
endereo http://suporte.totvs.com, aps fazer o login acesse a opo Download e em filtros informe os
seguintes valores:
Linha: Logix
Verso: Logix BI
Ambiente: Logix
Plataforma: Windows

Selecione o item referente plataforma do servidor que receber a instalao do Logix BI, conforme a
figura abaixo.


1 - Pesquisa plataforma Windows

Aps ter realizado o download do arquivo coloque-o no diretrio C:\ e faa a extrao.

2 - Descompactao da plataforma TOTVS BI 11
Guia de instalao



6 Guia de instalao
Verso 1.0
Nota: Se a instalao for realizada em outra unidade necessrio editar o arquivo configuracao.bat, alterando a
varivel set PASTA_PADRAO=c:\totvsbi11 para o caminho onde foi realizado a instalao.


3 - Arquivo configuracao.bat

A instalao padro far com que o servio do Tomcat seja executado na porta 8080, caso seja necessrio
alterar essa configurao, o arquivo server.xml que encontra-se no diretrio
C:\totvsbi11\tomcat\tomcat6.0.29\conf\ deve ser editado. Abaixo so mostrados os trs pontos que devem
ser alterados no arquivo.

...<Server port="8005" shutdown="SHUTDOWN">...
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />...
...<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />...


2.1.1 Instalao do pacote do Logix BI

O pacote de atualizao tambm deve ser obtido na Central de Download com os mesmos filtros
informados para a obteno da plataforma. Deve ser selecionado o item conforme mostra a figura 4, escolha
sempre o pacote mais atual.

Nota: Pacotes com a nomenclatura 11.01.XX-RCx so candidatos a release, contendo correes emergenciais que
foram disponibilizadas. O pacote final tem a nomenclatura 11.01.XX e disponibilizado sempre no final do
ms.


4 - Pacote de instalao/atualizao


Guia de instalao



7 Guia de instalao
Verso 1.0
Aps realizar o download, o pacote deve ser descompactado dentro do diretrio
C:\totvsbi11\tomcat\tomcat6.0.29\webapps\.


5 - Descompactao do pacote de atualizao

Nota: O arquivo .zip deve ser excludo no diretrio, permanecendo apenas o arquivo bi.war.

2.1.2 Inicializando o Logix BI

No ambiente Windows existe duas formas de iniciarmos o servio do Logix BI, iremos explicar cada uma
delas.
2.1.2.1 Inicializao pelo console

Para iniciar o Logix BI pelo console deve ser executado o arquivo de lote chamado atalho_inicia_bi.bat
que esta no diretrio C:\totvsbi11\ .


6 - Tomcat iniciado via console

Guia de instalao



8 Guia de instalao
Verso 1.0
Aps o servio ser inicializado possvel entrar no navegador web e digitar o endereo http://ip-
servidor:porta/bi/, com isso a tela de login do Logix BI ser exibida e uma janela popup ser aberta solicitando a
configurao da conexo para acesso ao banco de dados, conforme mostra a figura 7. Aps realizar a
configurao da conexo ser possvel entrar no Logix BI utilizando o usurio demo com senha demo.


7 - Configurao da conexo de acesso ao banco de dados

2.1.2.2 Inicializao como servio

Para instalar o Tomcat como servio do Windows necessrio abrir um prompt de comando como
administrador, em seguida entrar no diretrio C:\totvsbi11\tomcat\tomtcat6.0.29\bin\ e executar o
comando service install tomcat6, conforme mostra a figura 8.


8 - Instalando o Tomcat como servio

Guia de instalao



9 Guia de instalao
Verso 1.0
Em seguida, execute como administrador o aplicativo tomcat6w.exe que tambm esta no diretrio
C:\totvsbi11\tomcat\tomtcat6.0.29\bin\.
Na aba Java deve ser configurado o caminho da Virtual Machine, em Java Options deve ser adicionado a
opo -Dconfigdir=C:\totvsbi11\configuracoes e o campo Maximum memory pool deve ser configurado para
1024, conforme a figura abaixo.


9 - Configurao do Tomcat

Agora possvel entrar no gerenciador de servios do Windows e iniciar o servio do Apache Tomcat, em
propriedades do servio possvel configurar para o tipo de inicializao automtica, assim o Logix BI estar
disponvel sempre que o servidor carregar o Windows.


10 - Tomcat instalado como servio

Guia de instalao



10 Guia de instalao
Verso 1.0
2.2 Instalao da plataforma no Linux

Para fazer a instalao do Logix BI em ambiente Linux necessrio fazer o download do pacote
compatvel com a plataforma. O pacote esta disponvel na Central de Downloads que pode ser acessada no
endereo http://suporte.totvs.com, aps fazer o login acesse a opo Download e em filtros informe os
seguintes valores:
Linha: Logix
Verso: Logix BI
Ambiente: Logix
Plataforma: Linux

Selecione o item referente plataforma do servidor que receber a instalao do Logix BI, conforme a
figura abaixo.


11 - Pesquisa plataforma Linux

Aps ter realizado o download do arquivo coloque-o no diretrio /usr/ e faa a extrao. Entre no
diretrio /usr/totvsbi11/tomcat/tomcat6.0.29/bin/ e execute os seguintes comandos:
dos2unix *.sh
chmod 777 *.sh
Em seguida, entre no diretrio /usr/totvsbi11/ e execute os comandos:
dos2unix *.sh
chmod 777 *.sh
chmod 777 R java
Nota: Se a instalao for realizada em outro diretrio, necessrio editar o arquivo configuracao.sh, alterando a
varivel export PASTA_PADRAO=/usr/totvsbi11 para o caminho onde foi realizado a instalao.

A instalao padro far com que o servio do Tomcat seja executado na porta 8080, caso seja necessrio
alterar essa configurao, o arquivo server.xml que encontra-se no diretrio
/usr/totvsbi11/tomcat/tomcat6.0.29/conf/ deve ser editado. Abaixo so mostrados os trs pontos que
devem ser alterados no arquivo.
...<Server port="8005" shutdown="SHUTDOWN">...
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />...
...<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />...
Guia de instalao



11 Guia de instalao
Verso 1.0
2.2.1 Instalao do pacote do Logix BI

O pacote de atualizao tambm deve ser obtido na Central de Download com os mesmos filtros
informados para a obteno da plataforma. Deve ser selecionado o item conforme mostra a figura 12, escolha
sempre o pacote mais atual.

Nota: Pacotes com a nomenclatura 11.01.XX-RCx so candidatos a release, contendo correes emergenciais que
foram disponibilizadas. O pacote final tem a nomenclatura 11.01.XX e disponibilizado sempre no final do
ms.


12 - Pacote de instalao/atualizao

Aps realizar o download, o pacote deve ser descompactado dentro do diretrio
/usr/totvsbi11/tomcat/tomcat6.0.29/webapps/.

Nota: O arquivo .zip deve ser excludo do diretrio.

Em seguida entre no diretrio /usr/totvsbi11/ e execute o comando sh atalho_inicia_bi.sh para iniciar
o servio do Tomcat.
Aps o servio ser inicializado possvel entrar no navegador web e digitar o endereo http://ip-
servidor:porta/bi/, com isso a tela de login do Logix BI ser exibida e uma janela popup ser aberta solicitando a
configurao da conexo para acesso ao banco de dados, conforme mostra a figura 13. Aps realizar a
configurao da conexo ser possvel entrar no Logix BI utilizando o usurio demo com senha demo.


13 - Configurao da conexo de acesso ao banco de dados

Guia de instalao



12 Guia de instalao
Verso 1.0
Captulo 3: Instalando atualizaes

Neste captulo, so apresentados os procedimentos necessrios para a atualizao do Logix BI. Estes
procedimentos devem ser realizados a cada atualizao de pacotes para que o produto apresente todas as
funcionalidades e correes liberadas.

Toda a instalao deve ser feita no servidor onde o produto est instalado. Para baixar o pacote de
atualizao, devem ser seguidos os seguintes procedimentos:

Passo 1: Digitar a URL http://suporte.totvs.com para acesso ao Portal de Clientes TOTVs e informar seu
cdigo e senha para acesso.

Passo 2: Selecionar a opo Download e informar a Linha: Logix, Verso: Logix BI, Ambiente: Logix e no
campo Plataforma selecionar Windows ou Linux, conforme a plataforma em que o sistema esta instalado.
Realizar o download do ltimo pacote disponibilizado.

Para realizar a atualizao devem ser seguidos os procedimentos abaixo, conforme o sistema operacional.

Ambiente Windows:

Nota: Os passos abaixo devem ser executados com o usurio Administrador, que tem permisso total sobre o sistema
e nenhuma estao pode estar utilizando o BI para que nenhum arquivo fique bloqueado pelo Windows.

Passo 1: Parar o servio do Tomcat.
Passo 2: Apagar os arquivos que esto na pasta C:\totvsbi11\tomcat\tomcat6.0.29\logs.
Passo 3: Remover a pasta C:\totvsbi11\tomcat\tomcat6.0.29\work.
Passo 4: Extrair o arquivo de atualizao dentro da pasta C:\totvsbi11\tomcat\tomcat6.0.29\webapps,
com isso ser criado um arquivo chamado bi.war. Observao: o arquivo de atualizao .zip, no dever
permanecer nesta pasta.
Passo 5: Iniciar o servio do Tomcat.

Ambiente Linux:

Nota: Os passos abaixo devem ser executados com o usurio root, que tem permisso total sobre o sistema e
nenhuma estao pode estar utilizando o BI para que nenhum arquivo fique bloqueado.

Passo 1: Parar o servio do Tomcat, executando o comando /usr/totvsbi11/sh atalho_finaliza_bi.sh.
Passo 2: Apagar os arquivos que esto na pasta /usr/totvsbi11/tomcat/tomcat6.0.29/logs.
Passo 3: Remover o diretrio work que esta na pasta /usr/totvsbi11/tomcat/tomcat6.0.29/.
Passo 4: Remover o diretrio bi que esta na pasta /usr/totvsbi11/tomcat/tomcat6.0.29/webapps/.
Guia de instalao



13 Guia de instalao
Verso 1.0
Passo 5: Extrair o arquivo de atualizao dentro da pasta /usr/totvsbi11/tomcat/tomcat6.0.29/webapps,
com isso ser criado um diretrio bi dentro desta pasta. Observao: o arquivo de atualizao .zip, no dever
permanecer nesta pasta.
Passo 6: Ir no diretrio /usr/totvsbi11/tomcat/tomcat6.0.29/webapps/bi/WEB-INF/classes e executar os
comandos:
dos2unix *.sh
chmod 777 *.sh
Passo 7: Iniciar o servio do Tomcat, executando o comando /usr/totvsbi11/sh atalho_inicia_bi.sh.