Boletim Tcnico de Instalao TOTVS BA

Migrao da Verso do Cognos para 10.2.1

Boletim Tcnico
2

Sumrio

1. Objetivo ..................................................................................................................................................... 3
2. Escopo das Atividades ................................................................................................................................ 3
3. Instalao do IBM Cognos .......................................................................................................................... 4
3.1. Instalao Cognos Apptier ......................................................................................................................... 4
3.2. Instalao Cognos Language Pack .............................................................................................................. 9
3.3. Instalao Cognos Data Manager Runtime ................................................................................................ 13
3.4. Instalao Cognos Framework Manager.................................................................................................... 18
3.5. Instalao Cognos Data Manager Designer ............................................................................................... 23
4. Instalao da Base de Dados para TOTVS BA ............................................................................................. 28
4.1. Criao da Base de Dados .......................................................................................................................... 28
4.2. Criao das Tabelas .................................................................................................................................... 29
4.3. Configurao das Conexes entre os Servidores ....................................................................................... 30
5. Configurao do IBM Cognos para TOTVS BA ............................................................................................ 39
5.1. Configurao do IBM Cognos BI SERVER ................................................................................................. 39
5.2. Configurao IBM Cognos FRAMEWORK MANAGER .............................................................................. 48
5.3. Configurao IBM Cognos DATA MANAGER DESIGNER .......................................................................... 49
6. Configurao Web Server (IIS) para TOTVS BA .......................................................................................... 52
6.1. Configurao Web Server (IIS) ................................................................................................................... 52
7. Configurao IBM Cognos .......................................................................................................................... 53
7.1. Configurao das Conexes com as bases de dados ................................................................................. 53
7.2. Importao de Pacotes .............................................................................................................................. 63
7.3. Aplicao do Skin TOTVS ............................................................................................................................ 72
7.4. Configurao de JOBS ................................................................................................................................ 76
7.5. Permisso de Acessos ................................................................................................................................ 78
7.6. Configurao do Logotipo TOTVS para Relatrios ..................................................................................... 84
7.7. Variveis de Ambiente ............................................................................................................................... 85





3
Boletim Tcnico

1. Objetivo


Este documento tem por objetivo descrever os procedimentos para a instalao do produto TOTVS BA. Nele est
descrito a instalao e configurao do IBM Cognos bem como uso da interface TOTVS.


2. Escopo das Atividades


Os procedimentos necessrios para a completa atualizao do IBM Cognos esto divididos em etapas e devem ser
realizados na seguinte ordem:

Instalao IBM Cognos
Configurao IBM Cognos
Criao de Bases de Dados para TOTVS BA
Instalao e configurao do Web Server (IIS)


Antes de iniciar o processo, certifique-se de ter acesso aos arquivos abaixo:
















Boletim Tcnico
4

3. Instalao do IBM Cognos


3.1. Instalao Cognos Apptier


1. Copie os arquivos de instalao para o servidor onde a aplicao ser instalada.

2. Execute como administrador: \bi_svr_64b_10.2_win_ml\winx64h\issetup.exe.














5
Boletim Tcnico

3. Defina Ingls como idioma padro e clique no boto Prximo:




4. Aceite os termos de contratao e clique no boto Next:








Boletim Tcnico
6
5. Escolha a unidade de instalao seguindo o padro de pasta \TOTVSBA\C102SRV, conforme exemplo a
seguir. Ao definir o caminho, clique em Next:




C102SRV = Cognos, Verso 10.2, Server


6. Selecione todos os componentes de instalao, exceto Cognos Content Database:





7
Boletim Tcnico

7. Altere o nome da pasta do programa para TOTVSBA 10.2 BI SERVER:



8. Confira o sumrio da instalao e clique em Next:







Boletim Tcnico
8
9. A mensagem abaixo indica a necessidade de efetuar a instalao do pacote de linguagem, que ser instalado
posteriormente. Apenas clique em OK para fechar a janela.



10. Finalize a instalao clicando em Finish:





No starte o servio de configurao neste momento.












9
Boletim Tcnico



3.2. Instalao Cognos Language Pack


1. Execute como administrador: \slp_10.2_mp_ml\winx64h\issetup.exe.



2. Defina Ingls como idioma padro de instalao:





Boletim Tcnico
10
3. Aceite os termos da licena e clique em Next:



4. No Local de Instalao, selecione a pasta onde foi instalado o Apptier (Neste caso, \TOTVSBA\C102SRV):










11
Boletim Tcnico

5. Selecione apenas IBM Cognos Supplementary Language Documentation e clique em Next:



6. Selecione a pasta de trabalho TOTVSBA 10.2 BI SERVER:




Marque a seleo para deixar o atalho visvel para todos os usurios no checkbox: Make the shortcuts visible
to all users.


Boletim Tcnico
12
7. Confira o sumrio da instalao e clique em Next:



8. Finalize a instalao clicando em Finish:








13
Boletim Tcnico


3.3. Instalao Cognos Data Manager Runtime


1. Execute como administrador: \bi_dmgr_64b_10.2_win_en\winx64h\issetup.exe.



2. Defina Ingls como Idioma Padro:





Boletim Tcnico
14
3. Aceite os termos da licena e clique em Next:



4. No Local de Instalao, selecione a pasta onde foi instalado o Apptier (Neste caso, :\TOTVSBA\C102SRV):






15
Boletim Tcnico

5. A mensagem abaixo alerta que est sendo instalado o Data Manager no mesmo local do Server. Clique Yes
para continuar:




6. Selecione todos os componentes de instalao, exceto Data Manager Designer. Em seguida, clique em
Next:
















Boletim Tcnico
16
7. Selecione a pasta de trabalho TOTVSBA 10.2 BI SERVER:





Marque a seleo para deixar o atalho visvel para todos os usurios no checkbox: Make the shortcuts visible
to all users.

8. Confira o Sumrio da Instalao e clique em Next:






17
Boletim Tcnico

9. Finalize a instalao clicando em Finish:

























Boletim Tcnico
18

3.4. Instalao Cognos Framework Manager

1. Execute como administrador: \fm_10.2_win_ml\win32\issetup.exe.



2. Defina Ingls como Idioma Padro:






19
Boletim Tcnico

3. Aceite os termos da licena e clique Next:



4. No Local de Instalao, altere o local para D:\TOTVSBA\C102FM:





Boletim Tcnico
20
5. Ser exibida a mensagem de alerta de que o diretrio criado no existe e a pergunta se deseja criar.
Clique em Yes:



6. Nos componentes de instalao, selecione IBM Cognos Framework Manager:

















21
Boletim Tcnico

7. Altere a pasta de trabalho para TOTVSBA 10.2 FRAMEWORK MANAGER:




Marque a seleo para deixar o atalho visvel para todos os usurios no checkbox: Make the shortcuts visible
to all users.

8. Confira o Sumrio da Instalao e clique em Next:




Boletim Tcnico
22

9. A mensagem abaixo alerta que se deve instalar o pacote de linguagem na pasta de instalao do
Framework Manager. Clique em OK:




10. Finalize a instalao clicando em Finish:



11. Repita o item 3.2 para instalar o pacote de linguagem para o Framework Manager. Lembre-se de alterar
o local de instalao para D:\TOTVSBA\C102FM.












23
Boletim Tcnico


3.5. Instalao Cognos Data Manager Designer



Esta aplicao s dever ser instalada para os clientes que adquirirem o pacote Developer do TOTVS BA.

Realize o procedimento a seguir.


1. Execute como administrador: \bi_dmgr_64b_10.2_win_en\win64h\issetup.exe.











Boletim Tcnico
24
2. Defina Ingls como Idioma Padro:



3. Aceite os termos da licena e clique em Next:








25
Boletim Tcnico

4. No Local de Instalao, altere para D:\TOTVSBA\C102DMD:



5. A mensagem abaixo alerta que o diretrio no existe e pergunta se deseja criar. Clique em Yes:



















Boletim Tcnico
26
6. Nos componentes de instalao, selecione Data Manager Designer:



7. Altere a pasta de trabalho para TOTVSBA 10.2 DATA MANAGER DESIGNER:




Marque a seleo para deixar o atalho visvel para todos os usurios no checkbox: Make the shortcuts visible
to all users.




27
Boletim Tcnico

8. Confira o Sumrio da Instalao e clique em Next:



9. Finalize a instalao clicando em Finish:






Boletim Tcnico
28

4. Instalao da Base de Dados para TOTVS BA

4.1. Criao da Base de Dados

Verifique a seguir os detalhes de um exemplo de bases em SQL Server. Pode-se utilizar tambm Oracle, DB2 e
Informix. O importante a utilizao correta de nomenclatura dos bancos.

Para isso, realize o procedimento a seguir:

1. Crie bases de dados CS, BIDW e BISTAGE conforme padro abaixo:



Database Name: CS
Owner: cs
Senha: cs
Collation: SQL_Latin1_General_CP1_CI_AS

Database Name: BIDW
Owner: bidw
Senha: bidw
Collation: Utilizar o Collation da base do ERP

Database Name: BISTAGE
Owner: bistage
Senha: bistage
Collation: Utilizar o Collation da base do ERP





29
Boletim Tcnico


4.2. Criao das Tabelas


1. Criar tabelas na base BIDW:

1.1 Execute o script (correspondente ao banco de dados) que est localizado em Cognos_Fase2\scripts
dw - v2.16_a002\Scripts DW e Stage - V2.16_a.



Neste exemplo, utilizado o SQL Server, ento deve-se usar o script DB_Warehouse_MSSQL.sql.


1.2 Confira se as tabelas foram criadas na base BIDW:





A sequncia de tabelas inicia em HG0 e termina em HQZ.













Boletim Tcnico
30

4.3. Configurao das Conexes entre os Servidores

1. Instale o SQL Native Client na mquina de aplicao TOTVS BA.

2. Clique com o boto direito do mouse na opo Install:



3. Clique em Avanar:







31
Boletim Tcnico

4. Aceite os termos da licena e clique em Avanar:




5. Preencha as informaes no padro e clique em Avanar:






Boletim Tcnico
32
6. Deixe as informaes no padro e clique em Avanar:




7. Clique em Instalar:






33
Boletim Tcnico

8. Aps a instalao, clique em Concluir:




9. Configure conexes ODBC para a base BISTAGE na mquina de aplicao TOTVS BA. Para isso:
























Boletim Tcnico
34

9.1. Clique na opo do Windows: Iniciar/Todos os Programas/Ferramentas Administrativas/Fontes
de Dados (ODBC):



9.2. Clique a opo System DSN e em seguida Add:







35
Boletim Tcnico

9.3. Selecione SQL Server Native Client 10.0 e clique em Finish:




9.4. Selecione Nome, Descrio (Opcional) e Servidor. Em seguida, clique em Next:




Boletim Tcnico
36
9.5. Selecione o mtodo de Autenticao SQL Server, insira usurio e senha e em seguida Next:



9.6. Altere o banco de dados padro para a base em questo. Deixe o restante no padro e clique em
Next:








37
Boletim Tcnico

9.7. Deixe todas as opes no padro e clique em Finish:



9.8. Clique em Testar Fonte de Dados:





Boletim Tcnico
38
9.9. Verifique se o teste foi concludo com xito e clique OK:

































39
Boletim Tcnico


5. Configurao do IBM Cognos para TOTVS BA


5.1. Configurao do IBM Cognos BI SERVER


1. Abra o IBM Cognos Configuration (Em Iniciar/Todos os Programas/TOTVSBA 10.2 BI SERVER).

2. Selecione a opo Environment:



Altere os campos conforme abaixo:

Sort buffer size in MB: 32
Gateway URL: http://<IP>/TOTVSba/cgi-bin/cognosisapi.dll
Dispatcher URLs For Gateway: http:// <IP> /p2pd/servlet/dispatch/ext


Boletim Tcnico
40
Controller URL For Gateway: http://<IP>/TOTVSba/controllerServer
External dispatcher URL: http://<IP>/p2pd/servlet/dispatch
Internal dispatcher URL: http://<IP>/p2pd/servlet/dispatch
Dispatcher URL for external applications: http://<IP>/p2pd/servlet/dispatch
Content Manager URLs: http://<IP>/p2pd/servlet
Data Manager SOAP Server URL: http://<IP>/axis


3. Em Environment/IBM Cognos Services:

















41
Boletim Tcnico


4. Em Environment/Portal Services, efetue as seguintes alteraes:

Location of application.xml: http://<IP>/samples/cps4/applications.xml




















Boletim Tcnico
42

5. Em Environment/Data Manager/Data Manager Network Services/Client/Localhost, efetue as seguintes
alteraes:

Renomeie sesso Localhost para <IP>





















43
Boletim Tcnico


6. Em Security/Authentication/Cognos efetue as seguintes alteraes:

Allow anonymous access? False


Esta alterao indica que ser proibido o login annimo, ou seja, ser exigido usurio e senha para
utilizar a ferramenta.
(Neste boletim, sero exibidos os procedimentos para instalao com o login integrado com o AD).













Boletim Tcnico
44

7. Em Security/Authentication, clique com o boto direito em Authetication/New Resource/Namespace:



Name: Active Diretctory
Type: Active Directory



Namespace ID: Nome do domnio
Host and Port: IP ou Hostname do servidor AD e porta (389)
Binding credentials: Usurio e senha de login no AD.




45
Boletim Tcnico

8. Em Security/IBM Application Firewall, efetue as seguintes alteraes:

Enable CAF validation? False





















Boletim Tcnico
46
9. Em DataAcces/Content Manager/Content Store:

9.1. Delete o Content Store j existente. (Clique com o boto direito em DataAcces/Content
Manager/Content Store e escolha a opo delete).

9.2. Confirme clicando em YES.




9.3. Crie um novo Content Store com Base em SQL Server. (Clique com o boto direito em
DataAcces/Content Manager e escolha a opo New Resource/Database).




Name: Content Store
Type: Microsoft SQL Server database







47
Boletim Tcnico



Database Server with port number or ip: <ip>:1433
User ID and Password: usurio e senha utilizados
Database Name: CS



















Boletim Tcnico
48
10. Em DataAcces/Notification:





5.2. Configurao IBM Cognos FRAMEWORK MANAGER


1. Abra o IBM Cognos Configuration (Em Iniciar/Todos os Programas/TOTVSBA 10.2 FRAMEWORK
MANAGER).













49
Boletim Tcnico

2. Em Environment altere os campos conforme abaixo:

Gateway URL: http://<IP>/TOTVSba/cgi-bin/cognosisapi.dll




5.3. Configurao IBM Cognos DATA MANAGER DESIGNER


1. Abra o IBM Cognos Configuration (Em Iniciar/Todos os Programas/TOTVSBA 10.2 DATA MANAGER
DESIGNER).










Boletim Tcnico
50
2. Em Environment altere os campos conforme abaixo:

Gateway URL: http://<IP>/TOTVSba/cgi-bin/cognosisapi.dll






















51
Boletim Tcnico

3. Em Environment/Data Manager/Data Manager Network Services/Client/localhost, efetue as seguintes
alteraes:

Renomeie sesso Localhost para <IP>




















Boletim Tcnico
52

6. Configurao Web Server (IIS) para TOTVS BA

6.1. Configurao Web Server (IIS)


Para configurao do IIS, siga o passo-a-passo disponibilizado no site da IBM:

http://www.ibm.com/developerworks/br/data/library/cognos/infrastructure/web_servers/page599.html

1. Aps a configurao, efetue os testes de conexo utilizando o navegador Internet Explorer:
http://localhost/TOTVSba

A tela inicial da aplicao possui a seguinte aparncia:









53
Boletim Tcnico

Running - Indica que o servio est no ar: http://localhost:9300/p2pd/servlet





7. Configurao IBM Cognos

7.1. Configurao das Conexes com as bases de dados


Nesta etapa, necessrio configurar no Cognos as conexes das bases BIDW e BISTAGE, cujas origens de dados
so previamente criadas na importao do pacote TOTVS BA Content Store.

Para isso, realize os procedimentos a seguir:























Boletim Tcnico
54
1. Abra o IBM Cognos Software (http://localhost/TOTVSba) e clique em Administrar o contedo do IBM
Cognos:



2. Em Conexes de Fontes de Dados, clique na origem de dados correspondente:











55
Boletim Tcnico

3. Crie uma nova conexo e preencha os campos conforme baixo. Em seguida, clique em Avanar:



4. Selecione o tipo da conexo (neste exemplo utilizado o SQL Server). Desmarque a opo Configurar
conexo ODBC e clique em Avanar:
























Boletim Tcnico
56

5. Preencha os campos conforme indicado abaixo:



5.1. Nome do servidor: HostName ou IP do servidor de banco de dados.
5.2. Nome do banco de Dados: Informe o nome do banco de dados (no caso de conexo ODBC,
indique o nome da fonte de dados ODBC. Neste caso o item 4 deve ser alterado para ODBC
tambm).
5.3. Em Conexes, marque a opo Senha e informe o ID e senha utilizados na conexo.
5.4. Clique em Testar a Conexo.















57
Boletim Tcnico

6. Clique em Testar:




7. Verificar se o teste foi bem-sucedido e clique em Fechar:



8. O sistema dever retornar tela anterior. Clique em Fechar:












Boletim Tcnico
58
9. O sistema dever retornar tela das Configuraes. Clique em Concluir:



10. Verifique se o idioma do servidor de banco de dados SQL est definido com o idioma diferente do Ingls.

10.1. Se NO, pular para o item 14 deste documento.
10.2. Se SIM, seguir os passos abaixo.

11. Volte tela de Conexo de Fontes de Dados, clique em Configurar propriedades da base BIDW:










59
Boletim Tcnico

12. Abra a guia Conexo, selecione Abrir comando de conexo e clique em Configurar:



13. Digite os comandos abaixo no quadro Comandos dos Bancos de dados XML e clique em OK:



Linhas de comando:

<commandBlock>
<commands>
<sqlCommand>
<sql>SET LANGUAGE 'English'</sql>
</sqlCommand>
</commands>
</commandBlock>










Boletim Tcnico
60
14. Repita os passos 2 a 9 para configurar a conexo BISTAGE.




15. Volte tela de Conexo de Fontes de Dados e clique em Configurar propriedades da base BISTAGE:















61
Boletim Tcnico

16. Abra a guia Conexo e clique em Incluir:



17. Expanda o diretrio Cognos:
















Boletim Tcnico
62
18. Procure o grupo Todos e clique no boto Incluir:



19. Clique em OK para concluir a configurao:




















63
Boletim Tcnico


7.2. Importao de Pacotes

1. Copie os pacotes Content Store, Templates e Back Office para a pasta /TOTVSBA/C1021SRV/Deployment:



2. Abra o IBM Cognos Administration e clique em Configurao, depois em Administrao de Contedo:



3. Clique em Nova Importao:












Boletim Tcnico
64
4. Clique no pacote Content Store e Avanar:



5. Insira a senha TOTVS!BA e clique em OK:



6. Clique em Avanar:















65
Boletim Tcnico


7. Clique em Avanar:



8. Selecione Salvar e executar uma vez e clique em Concluir:











Boletim Tcnico
66
9. Selecione Agora e clique em Executar:



10. Marque a opo Visualizar os detalhes desta importao depois de fechar este dilogo e em seguida
clique em OK:











67
Boletim Tcnico

11. Clique em Atualizar at aparecer o status indicando que a importao foi finalizada:



12. Clique em Fechar:



13. Clique em Nova Importao:




14. Clique no pacote Templates e Avance as etapas at concluir o processo. No final, clique em Concluir.





Boletim Tcnico
68
15. Clique em Nova Importao:



16. Clique no pacote Back Office e Avanar:



17. Confira as informaes e clique em Avanar:


















69
Boletim Tcnico

18. Selecione todas as opes da caixa superior e selecione Avanar:



19. Selecione as opes conforme figura abaixo e clique em Avanar:







Boletim Tcnico
70
20. Apenas confira o que ser executado e clique em Avanar:



21. Selecione Salvar e executar uma vez e clique em Concluir:





















71
Boletim Tcnico

22. Selecione Agora e clique em Executar:



23. Marque a opo Visualizar os detalhes desta importao depois de fechar esta caixa de dilogo e clique em
OK.



24. Quando o sistema finalizar a importao, sero exibidos os detalhes da execuo e o Status:











Boletim Tcnico
72

7.3. Aplicao do Skin TOTVS

1. Copie a pasta SkinTOTVSba para \TOTVSBA\C102SRV\webcontent\skins:



2. Abra o IBM Cognos Administrator e entre na opo Configurao/Estilos. Clique em Novo Estilo :



















73
Boletim Tcnico

3. Preencha os campos conforme abaixo e clique em Avanar:



4. Preencha os campos conforme abaixo e clique em Concluir:



Local dos recursos de estilo: skinTOTVSba
Recurso de visualizao: preview.htm


Ao concluir, o novo estilo dever aparecer na lista conforme figura abaixo:












Boletim Tcnico
74
5. Clique em (Minhas opes de rea/Minhas preferncias):



6. Na guia Geral, defina o Estilo como TOTVS BA e clique em OK:



7. Verifique que a interface da aplicao foi alterada assumindo o Logotipo TOTVS, conforme figura abaixo:














75
Boletim Tcnico

8. Clique na guia Segurana e em seguida em Cognos:







9. Clique em Editar Perfil do usurio padro :






















Boletim Tcnico
76
10. Na guia Preferncias defina o estilo como TOTVS BA e clique em OK:



Neste momento, ser definido que todos os prximos usurios j iniciaro no sistema com a interface
TOTVS.



7.4. Configurao de JOBS

1. Abra a ferramenta IBM Cognos Administrator e clique em Incio :










77
Boletim Tcnico

2. Na guia Pastas Pblicas, abra dataMovementTasks:



3. Clique no boto Configurar Propriedades do primeiro JOB listado (JOB_MAN_ALL):



4. Na guia Variveis, clique em Incluir uma varivel:


5. Inclua as variveis conforme abaixo e clique em OK:



INSTALL_CODE = 0
STAGE = BISTAGE


6. Repita os passos 4 e 5 para todos os JOBs da lista.
7.




Boletim Tcnico
78

7.5. Permisso de Acessos

1. Abra a ferramenta IBM Cognos Administrator, clique na guia Segurana, opo Usurios, Grupos e
Funes e clique em Cognos:



2. Clique em TOTVS - Funes:



3. Selecione o grupo Administrao do Sistema e clique no boto Configurar propriedades :











79
Boletim Tcnico

4. Na guia Membros, clique em Incluir:



5. Marque a opo Mostrar usurios na lista e abra a pasta Cognos:




























Boletim Tcnico
80
6. Selecione o usurio e clique em Incluir :



7. Clique em OK:







81
Boletim Tcnico

8. Clique em OK:



9. Volte guia Segurana, opo Usurios, Grupos e Funes, pasta Cognos. Abra a pasta TOTVS Grupos
de Acesso:



10. Abra a pasta Back Office:















Boletim Tcnico
82
11. Selecione o grupo TOTVS BA e clique no boto Configurar propriedades :




12. Na guia Membros, clique em Incluir:




13. Marque a opo Mostrar usurios na lista e abra a pasta Cognos:






83
Boletim Tcnico

14. Selecione o usurio e clique em Incluir :



15. Clique em OK:





Boletim Tcnico
84
16. Clique em OK:



17. Repita os passos 1 a 16 para o usurio que foi fornecido pelo cliente para a integrao LDAP ou de
qualquer outra ferramenta provedora de logins. Ou seja, o usurio utilizado na integrao deve ser
includo nos Grupos TOTVS BA e Administrao do Sistema.


7.6. Configurao do Logotipo TOTVS para Relatrios


1. Copie o arquivo ..Logotipo\TOTVS.jpg para ..\TOTVSBA\C102SRV\Webcontent\Samples\Images.

Crie a pasta images, se necessrio e no altere o nome do arquivo.






85
Boletim Tcnico


7.7. Variveis de Ambiente


1. Abra a tela de Propriedades do Computador onde est instalada a aplicao TOTVS BA:






















Boletim Tcnico
86
2. Clique na opo Advanced System Settings:



3. Na guia Advanced, clique em Environment Variables:






87
Boletim Tcnico

4. Na caixa inferior System Variables, clique em New:



5. Insira a varivel COG_UDA_ENSURE_ROW_ON_NULLCOUNT com valor T conforme figura abaixo:



6. Feche todas as janelas que restaram clicando em OK.