Guia de Instalao

TOTVS Datasul
Planning

Servidor de Aplicao
Bases de Dados
Estaes Client

Contedo
1. Prefcio ....................................................................................................................... 4
1.1.

Finalidade .......................................................................................................................... 4

1.2.

Pblico Alvo ....................................................................................................................... 4

1.3.

Organizao deste Guia ................................................................................................... 4

2. Introduo ................................................................................................................... 5
2.1.

Arquitetura Distribuda do Produto .................................................................................... 5

2.2.

Tipos de Instalao ........................................................................................................... 5

2.2.1.

Instalao Corporativa ................................................................................................................ 6

2.2.2.

Instalao Administrativa ............................................................................................................ 7

2.2.3.

Instalao Client.......................................................................................................................... 8

2.2.4.

Instalao Stand-Alone ............................................................................................................... 8

3. Requisitos Mnimos ..................................................................................................... 9

3.1.

Requisitos Mnimos de Hardware e Software ................................................................... 9

3.2.

Requisitos de Usurio (Servidor) .................................................................................... 10

4. Detalhes da Mdia de Instalao ............................................................................... 12

5. Instalao .................................................................................................................. 13
5.1.

Planejando a Instalao .................................................................................................. 13

5.1.1.

Gerando chave de licena no modelo legado ........................................................................... 13

5.1.2.

Gerando chave de licena no modelo padro (com Hard Lock). .............................................. 14

5.2.

Instalao Corporativa .................................................................................................... 15

5.2.1.

Seleo do Idioma .................................................................................................................... 15

5.2.2.

Pasta de Destino ....................................................................................................................... 16

5.2.3.

Selecionar Componentes .......................................................................................................... 17

5.2.4.

Integrao Oramento EMS ...................................................................................................... 19

5.2.5.

Parmetros do servidor de aplicao ........................................................................................ 21

5.2.6.

Parmetros do servidor de dados ............................................................................................. 23

5.2.7.

Escopos das reas do Datasul BI ............................................................................................. 24

5.2.8.

Pronto para Instalar................................................................................................................... 25

5.3.

Instalao Corporativa Multi-instncia ............................................................................ 26

TOTVS S.A.

5.4.

Instalao Client .............................................................................................................. 28

5.4.1.

Seleo do Idioma .................................................................................................................... 28

5.4.2.

Pasta de Destino ....................................................................................................................... 28

5.4.3.

Selecionar Componentes .......................................................................................................... 30

5.4.4.

Parmetros de instalao ......................................................................................................... 30

5.4.5.

Tarefas Adicionais..................................................................................................................... 31

5.4.6.

Pronto para Instalar................................................................................................................... 32

5.5.

Instalao Client Multi-instncia ...................................................................................... 32

5.6.

Instalao Stand-alone ................................................................................................... 34

6. Verificao do ambiente aps a instalao................................................................ 35

6.1.

Servidor de aplicao ...................................................................................................... 35

6.2.

Servidor de banco de dados ........................................................................................... 35

6.3.

Estaes client ................................................................................................................ 35

6.4.

Atribuir contas de logon para os servios da aplicao .................................................. 35

7. Atualizao de Pacotes ............................................................................................. 37

8. Desinstalao ............................................................................................................ 38

TOTVS S.A.

1. Prefcio
1.1.Finalidade
Este guia tem como finalidade descrever de forma objetiva, os procedimentos
necessrios para a instalao do produto Datasul Planning, bem como configurar o
produto nas plataformas suportadas. A mdia de instalao tambm poder ser
utilizada para atualizao de programas.

1.2.Pblico Alvo
Por este processo de instalao no ser trivial, a instalao requer pessoal
capacitado na rea de TI que tenham conhecimentos de banco de dados e do
ambiente de rede.

1.3.Organizao deste Guia

Captulo 2, Introduo
Este captulo apresenta uma viso geral da arquitetura distribuda, tipos de
instalao e exemplos de topologias no uso do produto.
Captulo 3, Requisitos Mnimos
Este captulo apresenta a lista de requisitos mnimos de hardware e software
exigidos na instalao e configurao do produto.
Captulo 4, Detalhes da Mdia de Instalao
Este captulo descreve os detalhes dos discos de instalao.
Captulo 5, Instalao
Este captulo descreve os procedimentos que devero ser executados para a
instalao do produto. Abrange desde o planejamento da instalao, ou seja,
escolher o tipo de instalao adequado, at as configuraes necessrias para
acesso remoto.
Captulo 6, Verificao do ambiente aps da instalao
Este captulo descreve os procedimentos para validao das instalaes descritas
no captulo anterior.
Captulo 6, Atualizao de Pacotes
Este captulo descreve os procedimentos a serem executados para a reinstalao
de cada componente, bem como os cuidados necessrios para a execuo dessa
rotina.
Captulo 7, Desinstalao
Este captulo descreve os procedimentos necessrios para a desinstalao do
produto.

TOTVS S.A.

2. Introduo
2.1.Arquitetura Distribuda do Produto
Arquitetura distribuda consiste em separar os componentes em plataformas
independentes que interagem entre si, permitindo que os recursos sejam
compartilhados enquanto se obtm ao mximo os benefcios de cada dispositivo.
Basicamente, funciona da seguinte forma: as mquinas dos usurios estaro
conectadas aos servidores pela rede; cada servidor fornecer recursos diferentes
para que os programas possam ser executados da mquina do usurio.
Viso da arquitetura completa mostrando todos os servidores separados:

Servidor de
Licenas

Servidor de
Atualizao
Automtica

Estao Client

Servidor de
Banco de Dados
Planning
Servidor de
Banco de Dados
ERP

Servidor de
Aplicao

possvel ter uma configurao dessa arquitetura de forma mais simples como, por
exemplo, o servidor de banco de dados, de aplicao e de atualizao automtica
todos atuando em uma nica mquina.

2.2.Tipos de Instalao
A instalao do produto divida nas seguintes partes:
Estaes Clientes
Permite a instalao dos programas para utilizao do produto pelos usurios
finais. Isso necessrio porque os usurios no acessam os dados atravs de um
navegador web. No caso de optar por atualizao automtica das estaes cliente,
tambm instalado um servio na estao cliente.
Servidor de Banco de Dados

TOTVS S.A.

Permite a instalao e configurao dos bancos de dados utilizados pelo produto,

assim como os scripts para atualizar estruturas e dados nesses bancos.
Servidor de Aplicao
Permite a instalao e configurao dos servios do produto, sendo esses
componentes essenciais. Os servios so: Servios Bsicos da Aplicao
(controlador de identificadores de planos, pastas e clulas; controle de acesso
multiusurio; registro de alteraes dos usurios; manuteno de agendamentos e
integrao com o mdulo de oramento do Datasul 11), Servios de Agendamento
de Clculo, Servio de Metadados e Servio do Framework.
Servio de Atualizao das Estaes Clientes
Configura o servio web para ser utilizado na atualizao automticas das
estaes clientes.
Servidor de Licenas
Responsvel por manter o controle de licena dos produtos TOTVS. Essa
instalao feita de forma separada e no atendida pelo instalador desse
produto. Caso no tenha instalado esse servidor no seu ambiente, contate seu
Executivo de Atendimento e Relacionamento ou a rea de suporte para mais
informaes sobre esse componente.
ALERTA: A partir da verso 11, o controle de licenas pode ser feito via
License Server que requer o uso de um Hard Lock para garantia de
integridade. Se voc ainda no recebeu seu guia de relacionamento,
instalador do License Server e Hard Lock, favor entrar em contato com
seu Executivo de Atendimento e Relacionamento ou com o suporte para
solicitar estes itens.
Para que exista comunicao entre estes componentes, necessrio que os servios
de rede, como TCP/IP, estejam funcionando corretamente.
2.2.1. Instalao Corporativa
Esse tipo de instalao realizado para o(s) equipamento(s) do tipo servidor. A
instalao corporativa pode ser feita inteiramente em uma maquina que faz o
papel de servidor de aplicao, servidor de atualizao automtica e servidor de
banco de dados ou em um ambiente multiserver onde os servidores de aplicao e
atualizao automtica podem estar em um computador, e o servidor de banco de
dados em outro.
Essa instalao contempla automaticamente todas as caractersticas da instalao
administrativa e instalao client, descritas nos tpicos seguintes.

TOTVS S.A.

Durante o processo de instalao, para permitir a comunicao entre as estaes

client e o servidor, o instalador registra automaticamente as seguintes excees no
Firewall do Windows do servidor:
Servios do Datasul Planning, adicionando o programa {pasta de
instalao}\DM\Bin\Datasul.BusinessIntelligence.Metadata.MMOService.exe;
Servios de Metadados do Datasul Planning, adicionando o programa {pasta
de
instalao}\DM\Bin\Datasul.BusinessIntelligence.DecisionModeling.DMServices.
exe;
Servios do Datasul .NET Framework, adicionando o programa {pasta de
instalao}\Framework\Bin\Datasul.Framework.Services.exe
Caso exista uma ferramenta de firewall adquirida de outro fornecedor instalada no
servidor, esse registro deve ser feito manualmente. Se no for possvel liberar os
programas acima mencionados, as seguintes portas devem ser adicionadas:
TCP/8090 e TCP/8091;
TCP/8095 TCP/8099;
O firewall tambm deve suportar redirecionamento de portas e traduo de
endereos.
Caso seja feita a opo por instalao do servio de atualizao automtica, deve
estar configurado no servidor de aplicao os servios do MS Internet Information
Services (IIS) para que diretrio virtual seja configurado de forma que as estaes
cliente possam realizar o download dos pacotes de atualizaes.
O ambiente onde o servidor de aplicao ser instalado deve fazer parte de um
domnio de rede Microsoft e os usurios das estaes clients tambm devem estar
autenticados no mesmo domnio.
Para configurar e controlar o acesso dos usurios aos planos e painis,
necessrio que o protocolo de consultas ao servidor do domnio
conhecido por LDAP esteja disponvel. Se no estiver, deve-se alterar a
configurao do servidor de aplicao para utilizar diretamente o
protocolo NTLM, conforme descrito no manual de referncia do produto.
2.2.2. Instalao Administrativa
Esse tipo de Instalao realizado em estaes de trabalho, depois que j foi
realizado o processo de instalao corporativa, para os casos onde o usurio
exerce o papel de administrador do sistema.
Basicamente, essa instalao diferencia-se das demais instalaes pelas
seguintes caractersticas:

TOTVS S.A.

 No so instalados os servios nem as bases de dados;

So instalados todos os componentes da instalao client, com as seguintes
funes adicionais de administrao do produto:
Acesso irrestrito a todos os planos e pastas, com possibilidade de alterao
dos usurios proprietrios;
Funes para manuteno de agendamentos de clculo e duplicao de
estrutura, bem como e visualizao e manuteno dos registros de alterao
de planos;
Disponibilidade da ferramenta Datasul Metadata Manager;
2.2.3. Instalao Client
Esse tipo de Instalao realizado nas estaes de trabalho depois que j foi
realizado o processo de instalao corporativa, para os casos onde o usurio ter
acesso s ferramentas de edio de planos e painis do produto.
Caso o usurio faa a opo pela atualizao automtica durante a instalao,
ser instalado um servio na mquina que ir baixar os pacotes de atualizao
toda vez que o produto for atualizado no servidor.
2.2.4. Instalao Stand-Alone
Esse tipo de instalao realizado em um equipamento que servir, ao mesmo
tempo, como client e server para a realizao, por exemplo, de demonstraes e
testes.
Para esse tipo de instalao, alm da instalao dos servios e do servidor de
banco de dados na mesma mquina, deve ser instalado tambm o License Server
e solicitada uma chave de demonstrao que substituir o Hard Lock.

TOTVS S.A.

3. Requisitos Mnimos
Este captulo tem por objetivo divulgar recomendaes sobre o uso de hardware e
software e algumas informaes sobre a configurao dos mesmos. Estas
recomendaes tm por inteno ajudar os clientes na configurao do ambiente. Porm,
no representam compromissos com algum fornecedor em especial por parte da TOTVS.
A deciso sobre o fornecedor de competncia do cliente, bem como o nvel de servio,
segurana e confiabilidade que deseja do seu ambiente. As posies deste guia tambm
podem ser alteradas, isto devido evoluo das tecnologias e dos nossos produtos.
A correta configurao e tuning do ambiente (servidores, redes, clients, banco de dados,
etc.) so importantes para o funcionamento do produto, pois caso parte do ambiente
esteja mal configurado, o desempenho do produto como um todo ser afetado.
As recomendaes e exemplos citados adiante levam em considerao somente os
softwares relacionados ao produto. Caso sejam instalados outros softwares no mesmo
ambiente, os mesmos devem ser levados em considerao, sendo que os requisitos
descritos podem no ser o suficiente para a execuo de todas as rotinas.

3.1.Requisitos Mnimos de Hardware e Software

Servidor de Aplicao / Servidor Web
At 5 usurios
Disco
Memria
Processador

Hardware
80 Gbytes de espao disponveis
4 Gbytes ou superior
2 CPUs Intel Pentium Dual Core 2.4 GHz

Software
Sistemas Operacionais Homologados
Windows 2008 R2 (32/64 Bits)
Windows 2003 Server (SP1) (32/64 Bits)
Windows 2000 Server (SP4) (32/64 Bits)
.NET Framework
2.0
Servidor Web (de acordo com o SO)
Microsoft Internet Information Services

Servidor de Banco de Dados

At 5 usurios
Disco
Memria
Processador

Hardware
80 Gbytes de espao disponveis
2 Gbytes ou superior
2 CPUs Intel Pentium Dual Core 2.4 GHz

Software
Sistemas Operacionais Homologados
Windows 2008 R2 (32/64 Bits)
Windows 2003 Server (SP1) (32/64 Bits)

TOTVS S.A.

.NET Framework
Banco de Dados Homologados

Windows 2000 Server (SP4) (32/64 Bits)

2.0
MS SQL Server Standard 2008 (SP1)
MS SQL Server Standard 2005 (SP2)
MS SQL Server Standard 2000 (SP4)

Estao Client
Memria
Processador

Hardware
1 Gbyte ou superior
Intel Pentium Dual Core 2.4 GHz

Software
Sistemas Operacionais Homologados Windows Vista Business (32/64 Bits)
Windows XP Professional (SP2) (32/64 Bits)
Windows 2000 Professional (SP4) (32/64
Bits)
.NET Framework
2.0

As informaes acima indicam uma configurao mnima para funcionamento no

ambiente corporativo e pode ser utilizada para pequenos volumes de dados (at 5
Gbytes) e poucos usurios (at 5 usurios). Todo ambiente varia de acordo com o
volume e complexidade das consultas. Use essa informao como referncia para o
melhor dimensionamento do ambiente.
No caso das placas de rede, recomendam-se placas de fornecedores de primeira
linha. Isto porque estas placas so mais performticas e tm menos problemas de
compatibilidade. Ou seja, a confiabilidade, desempenho e qualidade so mais altos,
com um acrscimo pequeno de custo.
Para a instalao do tipo stand-alone, a mquina que vai receber a instalao deve
ter memria RAM de no mnimo 2Gbytes para que possa o sistema possa rodar de
forma satisfatria em uma apresentao ou teste. indicada a utilizao de bancos
de dados de pequenos volumes nessa situao.
No est includa, nos requisitos mnimos, a instalao do servidor de licenas da
TOTVS (License Server) porque o mesmo tem um guia de instalao prprio.

3.2.Requisitos de Usurio (Servidor)

Recomenda-se que a instalao do produto seja efetuada com o usurio
administrador, ou com um usurio que esteja incluso no grupo de administradores
do servidor.
As fontes de dados suportadas pelo produto so: Excel 2003, Oracle,
Progress e SQL. Para a fonte de dados Oracle mesmo o ambiente sendo

TOTVS S.A.

10

64Bits se faz necessrio ter instalado a verso 32 Bits do Client Oracle

TOTVS S.A.

11

4. Detalhes da Mdia de Instalao

A mdia de instalao do produto disponibilizada em DVD e pelo Portal de Clientes.
Nesta mdia esto disponveis:
Guia de Instalao do produto;
Guia de Suporte ao Cliente;
Setup e arquivos necessrios para instalao do produto.

TOTVS S.A.

12

5. Instalao
5.1.Planejando a Instalao
Mostraremos agora as etapas que devem ser seguidas para a instalao e
configurao do produto, de acordo com os tipos de instalao.
Certifique-se de j ter em mos os dados necessrios para a chave de licena do
produto. No caso de uma nova instalao e no ter um servidor de licena TOTVS
instalado e configurado no seu ambiente com as licenas do produto, ser
necessrio ter a chave de instalao. Entre em contato com seu gerente de
atendimento caso no tenha essa chave. No caso de no fazer parte do modelo
FULL TOTVS de licenciamento, ser necessrio fazer a instalao do servidor de
aplicao para que possa rodar o utilitrio de gerao de licena. Nesse caso,
consulte o tpico Gerando chave de licena no modelo legado.
Defina a topologia do ambiente. Nesta etapa, deve ser definido onde cada
componente ser instalado. Escolha o hardware que ser utilizado como servidor
de banco de dados e servidor de aplicao e tambm as mquinas que estaro
disponveis aos usurios. Para cada um destes componentes, verifique se os
requisitos de hardware e software so atendidos;
Execute o instalador no servidor de aplicao;
Execute o instalador no servidor de bancos de dados (caso seja separado do
servidor de aplicao);
Aps a concluso destas etapas, o produto estar pronto para utilizao.
5.1.1. Gerando chave de licena no modelo legado
Ao utilizar o produto no modelo de licenciamento legado, aps a instalao do
servidor de aplicao, o usurio deve identificar o aplicativo gerador de licena na
pasta
{pasta
de
instalao}\Framework\Bin\Datasul.LicenseManager.ServerInfo.exe
Ao rodar esse utilitrio e gerar o arquivo XML de informaes de licena, o usurio
dever compactar esse arquivo em formato ZIP e anexar esse arquivo em um
chamado a ser aberto no portal da TOTVS em http://www.totvs.com/suporte
(opo CST) informando os dados e solicitando a licena do produto.
Ao receber os arquivos de licena atravs desse chamado, dever descompactar
o arquivo e copiar os itens Datasul.BusinessIntelligence.license e
Datasul.BusinessIntelligence.Users.xml
para
a
pasta
{pasta
de
instalao}\Framework\Bin\Licenses. Aps esse procedimento, reiniciar o servio
Servios do Datasul .NET Framework no servidor de aplicao.

TOTVS S.A.

13

5.1.2. Gerando chave de licena no modelo padro (com Hard Lock).

Ao utilizar o produto no modelo de licenciamento padro, preciso configurar o
produto para que aponte corretamente para o servidor de licenas e no caso de
uma nova instalao preciso configurar tambm a Chave de Instalao.
O modelo de licenas da TOTVS possui 3 formas para licenciamento do produto:
1. Chave de Inicializao: Chave fornecida para clientes atuais que migraram de
contrato e para novos clientes. Esta chave vlida por 20 dias. Dever ser
utilizada at o recebimento do Hard Lock. Aps instalar o produto, procure o
diretrio do Framework em {pasta de instalao}\Framework\Bin e execute um
aplicativo chamado Datasul.LicenseManager.Forms.RequestInitialKey.exe. O
aplicativo ir solicitar o CNPJ e a Chave de Inicializao.

2. Chave de Emergncia: Esta chave disponibilizada quando ocorre um

problema com o Hard Lock ou a chave de inicializao expirou e ainda no foi
entregue o Hard Lock. Sua validade de a data de solicitao + 01 dia. Aps
instalar o produto, procure o diretrio do Framework em {pasta de
instalao}\Framework\Bin
e
execute
o
aplicativo
chamado
Datasul.LicenseManager.Forms.RequestEmergencyKey.exe. O aplicativo ir
solicitar o CNPJ e a Chave de Inicializao.

TOTVS S.A.

14

3. Hard Lock: Dispositivo USB fornecido pela TOTVS, dever ser conectado a
uma mquina servidora, podendo ou no ser a mesma mquina dos servios do
Datasul Planning. Este dispositivo responsvel por liberar o acesso ao
Datasul Planning e dos demais produtos TOTVS. Para configurar o dispositivo
corretamente, acesse o diretrio do Framework em {pasta de
instalao}\Framework\Bin
e
edite
o
arquivo
Datasul.ApplicationManager.config, inserindo as seguintes tags no arquivo:
<totvsserverport> porta_do_servidor_do_hardlock</totvsserverport>
<totvsserverip> ip_do_servidor_do_hardlock</totvsserverip>

5.2.Instalao Corporativa
Para realizar a instalao do produto no servidor de aplicao ou no servidor de
banco de dados, necessrio executar o programa ServerSetup.exe, o qual se
encontra localizado na raiz da mdia de instalao.
Caso a opo de execuo automtica (AutoRun) estiver ativa, somente ser
necessrio inserir a mdia na unidade de leitura para que o programa
ServerSetup.exe seja executado.
A seguir so descritas as etapas para as instalaes corporativa, administrativa e
stand-alone do produto.
5.2.1. Seleo do Idioma
A opo de idioma disponvel no instalador serve apenas para as
informaes e mensagens exibidas durante o processo de instalao e
no indica o idioma a ser exibido durante a utilizao do produto.
Atualmente o Planning est disponvel somente no idioma
Portugus/Brasil.

TOTVS S.A.

15

Nessa etapa possvel selecionar o idioma a ser utilizado durante a instalao do

produto. As opes disponveis so Portugus (Brasil) e Ingls.

5.2.2. Pasta de Destino

Essa etapa no ser apresentada nos casos de atualizao do produto,
ou ento quando for detectada a existncia de uma instalao do produto
Datasul BI no mesmo ambiente.
Nesta etapa o usurio pode escolher a pasta de destino, para criao da estrutura
de pastas e gravao dos arquivos e componentes necessrios para o
funcionamento do produto, conforme opes de instalao selecionadas nas
etapas seguintes do processo.

Como padro, o instalador sugere a pasta C:\Datasul, que pode ser alterada
utilizando o boto Procurar. Nesse caso, o instalador apresenta um formulrio
com a relao das pastas existentes para seleo.

TOTVS S.A.

16

Durante a instalao do produto, ser criada a seguinte estrutura de pastas e

arquivos:
Contm as pastas de instalao dos produtos Datasul BI e
Datasul Planning
Contm as pastas e arquivos do produto Datasul Planning
Contm arquivos executveis, componentes, scripts e arquivos
de configurao
Contm arquivos de ajuda
Contm os arquivos para instalao da verso client do produto
nas estaes de trabalho
Contm informaes e histricos de execuo dos agendamento
Contm arquivos para execuo dos agendamentos
Contm arquivos temporrios utilizados pelas rotinas de
integrao com o mdulo de oramento do EMS
Contm os arquivos de configurao do produto e de
configurao do servio de atualizao automtica.
Contm os arquivos executveis e componentes do Framework
Datasul .NET.

5.2.3. Selecionar Componentes

Nesta etapa o usurio seleciona os componentes que deseja instalar, definindo
assim o tipo de instalao a ser realizada em determinado ambiente.
A seguir, so descritos os componentes disponveis para seleo e a forma como
devem ser selecionados de acordo com o tipo de instalao desejada:

TOTVS S.A.

17

Componente

Descrio

Componentes
Administrativos

Instala e configura as os componentes administrativos, bem

como as ferramentas bsicas de edio de planos e painis
do produto

Escopos das reas do BI

Instala e configura automaticamente os escopos para as

reas do Datasul BI na ferramenta Metadata Manager.
Sua seleo opcional e deve ser utilizada somente quando
o Datasul BI utilizado pelo usurio

Servios da aplicao

Instala e configura os servios acessados pelas verses

client instaladas nas demais estaes

Servios de atualizao
automtica

Instala e configura a estrutura para atualizao automtica

das verses client do produto, sempre que houver uma
atualizao do produto no servidor.
Caso essa opo no seja selecionada, a atualizao nas
estaes client dever ser efetuada manualmente

Base de Dados

Instala e configura as bases de dados responsveis por

manter os dados do usurio, como por exemplo: planos,
painis e objetos.
Essa opo deve ser sempre selecionada na ocasio da
primeira instalao do servidor de dados e recomenda-se
mant-la selecionada a cada nova atualizao

5.2.3.1.

Selecionar o tipo de instalao

Uma lista com os tipos de instalaes existentes est disponvel no campo

localizado acima da relao de componentes. A seleo do tipo de instalao
atravs desse campo far com que os componentes sejam marcados ou
desmarcados automaticamente, facilitando a instalao do produto.

TOTVS S.A.

18

A tabela abaixo relaciona os componentes selecionados para cada tipo de

instalao:
Tipo

Componentes para instalao

Instalao Completa

Componentes Administrativos
1
Escopos das reas do BI
Servios da aplicao
Servios de atualizao automtica
Bases de Dados

Instalao do servidor de
dados

Bases de dados

Instalao do servidor de
aplicao

Componentes Administrativos
1
Escopos das reas do BI
Servios da aplicao

Instalao do servidor de
atualizao automtica

Servios de atualizao automtica

Esse tipo de instalao possibilita selecionar

manualmente os componentes de acordo com sua
necessidade, e pode ser utilizada nos seguintes
cenrios:
Instalao personalizada

Combinar dois ou mais tipos de instalao,

instalando, por exemplo, o servidor de dados e
aplicao no mesmo computador;
Executar instalaes administrativas, marcando
apenas os componentes administrativos para
instalao;
No instalar os componentes opcionais

1. A instalao desses componentes opcional, e podem ser desmarcados sem descaracterizar o

tipo de instalao selecionado

5.2.4. Integrao Oramento EMS

TOTVS S.A.

19

Essa etapa somente ser apresentada se ao menos um dos componentes

Servios da aplicao ou Bases de Dados fora selecionado na etapa
de instalao Selecionar Componentes.
Nesta etapa, se desejar, o usurio poder habilitar e configurar a integrao do
Datasul Planning com o mdulo de oramento do EMS. Caso tenha selecionado a
opo para habilitar a integrao, ser necessrio preencher todas as informaes
constantes na tela, onde:

5.2.4.1.

Configurao de Ambiente

Contm as informaes do ambiente Progress onde se encontram os dados e

as rotinas de integrao do mdulo de oramentos do EMS, onde:
Verso Progress: permite ao usurio selecionar a verso do Progress
utilizado para integrao com o EMS. As opes disponveis so: 10.1A,
10.1B e 10.1C;
Arquivo PF: o usurio deve informar a localizao e o nome do arquivo PF
da base de dados do EMS;
Arquivo INI: o usurio deve informar a localizao e o nome do arquivo INI
da base de dados do EMS;
5.2.4.2.

Conexo ODBC

Contm as informaes para conexo com a base de dados Progress para

integrao dos dados do Planning com o EMS:
Servidor: nome do servidor contendo a base de dados do EMS 5 que ser
utilizada para a integrao;
Porta: nmero da porta disponvel no servidor para conexo com a base de
dados;

TOTVS S.A.

20

 Usurio/Senha: nome e senha de um usurio com acesso base de

dados do EMS.
Caso a base de dados Progress se encontre em outro servidor,
para conseguir configurar a integrao com o mdulo de
Oramento do EMS, ser necessrio primeiramente instalar os
drivers de conexo a dados ODBC especficos para a verso do
Progress no mesmo computador.
5.2.5. Parmetros do servidor de aplicao
Essa etapa somente no ser apresentada quando for selecionado
apenas o componente Bases de Dados na etapa de instalao
Selecionar Componentes
Nesta etapa devem ser fornecidas as informaes correspondentes ao servidor de
aplicao responsvel pela comunicao entre o servidor de dados e estaes
client.

5.2.5.1.

Servios da aplicao

Servidor: nesse campo fornecido o nome do servidor onde se encontram

instalados os servios do produto e somente estar habilitado quando o
componente Servios no tiver sido selecionado na etapa Selecionar
Componentes ou quando no for detectada a existncia de uma instalao
do produto Datasul BI no mesmo ambiente;

Se o servidor de aplicao informado for o mesmo da instalao, o

instalador ir verificar a configurao e, se no conseguir estabelecer
comunicao com os servios, ir exibir uma mensagem solicitando a

TOTVS S.A.

21

correo antes de prosseguir com a instalao.

Se o servidor de aplicao informado for diferente da instalao, o
instalador ir apenas apresentar uma mensagem de advertncia
informando no ser possvel verificar os dados, permitindo que a
instalao prossiga normalmente.
Instncia: nesse campo apresentado o nome da instncia configurada
para a instalao em andamento e seu valor no pode ser alterado. Para
maiores informaes sobre instalao de instncias, consulte o tpico
Instalao Corporativa Multi-instncia
Porta: nesse campo pode-se atribuir novos valores para as portas
utilizadas pelo produto, sendo que, a diferena existente entre o novo valor
informado e o valor padro 8090 ser automaticamente aplicada para as
demais portas utilizadas pelo produto, descritas no tpico Instalao
Corporativa. Somente estar habilitado quando o componente Servios
no tiver sido selecionado na etapa Selecionar Componentes ou quando
no for detectada a existncia de uma instalao do produto Datasul BI no
mesmo ambiente.
Durante a instalao de uma nova instncia, ao definir as portas,
deve-se tomar cuidado para no utilizar valores que porventura j
estejam em uso, seja por outra instncia do produto ou outras
aplicaes instaladas no computador.
Recomenda-se no utilizar intervalos inferiores a 20 unidades entre
as instncias (Ex. 8070, 8050, 8110, 8130), visto que, novas portas
podero ser utilizadas pelo produto em verses futuras.
5.2.5.2.

Servios de atualizao automtica

Servidor IIS: nesse campo apresentado o nome do servidor onde ser

configurado o servidor web Internet Information Services, necessrio para
instalao dos servios de atualizao automtica do produto;
Diretrio Virtual IIS: informe o local para instalao dos componentes e
arquivos necessrios para a atualizao automtica. Como padro, o
instalador sugere a pasta c:\inetpub\wwwroot, porm deve-se verificar se o
caminho est correto antes de prosseguir.
As informaes para configurao da atualizao automtica estaro
disponveis somente se o componente Servios de atualizao
automtica fora selecionado na etapa de instalao Selecionar
Componentes.

TOTVS S.A.

22

5.2.6. Parmetros do servidor de dados

Essa etapa no ser apresentada quando for selecionado apenas o
componente Servio de Atualizao Automtica na etapa de instalao
Selecionar Componentes

Nesta etapa devem ser fornecidas as informaes para configurao e instalao

das bases de dados utilizadas pelo produto.
Servidor de dados: nesse campo informado o nome do servidor onde esto
armazenadas as bases de dados utilizadas pelo produto. Quando for
detectada a existncia de uma instalao do produto Datasul BI no mesmo
ambiente, esse campo estar desabilitado e no poder ser alterado.
Se o componente Bases de dados for selecionado na etapa de
instalao Selecionar Componentes, esse campo dever ser
preenchido com o nome da mquina onde est ocorrendo a instalao
do produto, podendo-se apenas acrescentar o nome da instncia
desejada, quando for utilizada um instncia no padro do servidor de
dados.
Local de armazenamento: informe o local para criao e armazenamento das
bases de dados utilizadas pelo produto. Esse campo somente ser
apresentado se o componente Base de Dados for selecionado na etapa de
instalao Selecionar Componentes;
5.2.6.1.

Tipo de autenticao

Contm as opes para configurar a conexo com as bases de dados.

Autenticao Windows: selecione essa opo quando a conexo for
realizada atravs de uma conta de usurio disponvel no servidor de
domnio do Windows;

TOTVS S.A.

23

 Autenticao SQL Server: selecione essa opo quando a conexo for

realizada atravs de um usurio e senha informados no prprio banco de
dados SQL Server;
Usurio e senha: quando selecionada a autenticao SQL Server, informe
nesses campos o nome do usurio e a senha de conexo ao banco de
dados.
Para verificar se os dados de autenticao esto corretos, pode-se
utilizar o boto Testar conexo, porm, essa verificao feita
automaticamente durante o processo de instalao assim que o boto
Avanar for pressionado.
5.2.7. Escopos das reas do Datasul BI
Essa etapa ser apresentada somente se o componente Escopos das
reas do BI fora selecionado na etapa de instalao Selecionar
Componentes.

Nome do servidor: nesse campo informado o nome do servidor onde se

encontra a base de dados DTS_DataWarehouse do Datasul BI, e somente no
estar habilitado quando for detectada a existncia de uma instalao do
produto Datasul BI no mesmo ambiente;
5.2.7.1.

Tipo de autenticao

Contm as opes para configurar a conexo com a base de dados, tendo a

mesma funo e utilizao descrita no tpico Tipo de autenticao da etapa
anterior.

TOTVS S.A.

24

5.2.8. Tarefas Adicionais

Nesta etapa o usurio pode selecionar duas opes para facilitar o acesso ao
programa, atravs da criao de cones do produto na rea de Trabalho e/ou
Barra de Inicializao Rpida do Windows.

5.2.9. Pronto para Instalar

Nessa etapa apresentado um resumo contendo todos os parmetros definidos
para a instalao em andamento para consulta antes se iniciar a instalao e
configurao do Datasul Planning.

TOTVS S.A.

25

5.3.Instalao Corporativa Multi-instncia

No caso de querer instalar vrias instncias da verso server na mesma mquina, por
exemplo, para um ambiente ASP, preciso executar o instalador utilizando a
seguinte linha de comando:
serversetup /instance=Nome_da_instncia
O valor informado para o argumento instance no deve conter aspas ou espaos
em branco, e servir para identificar cada instncia, sendo utilizado como sufixo nas
seguintes situaes:
Nomes dos servios e pastas de instalao;
Atalhos no Menu Iniciar, rea de Trabalho e Barra de Inicializao Rpida;
Nome do programa na relao de programas instalados do Painel de Controle
Embora as etapas e procedimentos para instalao de uma instncia nomeada sejam
semelhantes instalao da instncia padro descritas anteriormente, alguns
detalhes devem ser observados durante o processo de instalao:
Na etapa Pasta de Destino:
Deve ser informada uma pasta de destino
diferente para cada nova instncia;
O instalador sugere automaticamente a
criao de uma pasta com o nome da
instncia informado dentro da pasta de
instalao padro.
Essa etapa no ser apresentada nos
casos de atualizao do produto, ou
quando for detectada a existncia de uma
instalao do produto Datasul BI utilizando
mesmo nome de instncia no mesmo
ambiente.
Na etapa Parmetros do servidor de
aplicao:
O nome da instncia exibido no campo
Instncia
Deve-se informar uma porta diferente para
cada nova instncia. Este campo somente
no ser habilitado caso seja detectada a
existncia de uma instalao do produto
Datasul BI utilizando mesmo nome de

TOTVS S.A.

26

instncia no mesmo ambiente.

Recomenda-se
no
utilizar
intervalos
inferiores a 20 unidades entre as instncias
(Ex. 8070, 8050, 8110, 8130), visto que,
novas portas podero ser utilizadas pelo
produto em verses futuras.

Na etapa Parmetros do servidor de dados:

Deve-se utilizar instncias separadas do
servidor de dados, bem como informar
locais de armazenamento distintos para
cada instncia; O campo servidor de
dados somente no ser habilitado caso
seja detectada a existncia de uma
instalao do produto Datasul BI utilizando
mesmo nome de instancia no mesmo
ambiente.
O instalador sugere automaticamente a
criao de uma pasta com o nome da
instncia informado dentro da pasta de
instalao padro.
Na etapa Escopos das reas do Datasul BI:
Deve-se utilizar o nome da instncia do
servidor de dados onde esto disponveis
os dados corretos do DataWarehouse do
BI para a instncia que est sendo
instalada.
Este campo somente no ser habilitado
caso seja detectada a existncia de uma
instalao do produto Datasul BI utilizando
mesmo nome de instancia no mesmo
ambiente.

Ao definir os nomes das instncias, deve-se ficar atento para no repetir

os nomes em instncias diferentes, pois o instalador no capaz de
identificar a existncia de outra instncia, e conseqentemente far a
instalao da nova instncia sobre a instncia j existente.
Tambm possvel realizar a instalao multi-instncia no modo multiserver, objetivando instalar vrias instncias dos servidores de dados e
aplicao em equipamentos distintos. Para isso, basta executar o

TOTVS S.A.

27

instalador via linha de comando, tanto no servidor de dados quanto no

servidor de aplicao, e selecionar o tipo de instalao mais adequado
para cada computador.

5.4.Instalao Client
Para realizar uma nova instalao da verso client do produto, necessrio executar
nas estaes de trabalho o programa ClientSetup.exe, o qual se encontra na pasta
{pasta de instalao\DM\InstClient criada no processo de instalao do servidor. A
seguir so descritas as etapas para a instalao client do produto.
5.4.1. Seleo do Idioma
A opo do idioma disponvel no instalador serve apenas para as
informaes e mensagens exibidas durante o processo de instalao e
no indica o idioma a ser exibido durante a utilizao do produto.
Atualmente o Planning est disponvel somente no idioma
Portugus/Brasil.
Nessa etapa possvel selecionar o idioma a ser utilizado durante a instalao do
produto. As opes disponveis so Portugus (Brasil) e Ingls.

5.4.2. Pasta de Destino

Essa etapa no ser apresentada nos casos de atualizao do produto,
ou ento quando for detectada a existncia de uma instalao do produto
Datasul BI 2.0 no mesmo ambiente.
Nesta etapa o usurio pode escolher a pasta de destino, para criao da estrutura
de pastas e gravao dos arquivos e componentes necessrios para o
funcionamento do produto, conforme opes de instalao selecionadas nas
etapas seguintes do processo.

TOTVS S.A.

28

Como padro, o instalador sugere a pasta C:\Datasul, que pode ser alterada
utilizando o boto Procurar. Nesse caso, o instalador apresenta um formulrio
com a relao das pastas existentes para seleo.

Durante a instalao do produto, ser criada a seguinte estrutura de pastas e

arquivos:
Contm as pastas de instalao dos produtos Datasul BI e
Datasul Planning
Contm as pastas e arquivos do produto Datasul Planning
Contm arquivos executveis, componentes, scripts e arquivos
de configurao
Contm arquivos de ajuda
Contm os arquivos de configurao do produto e de
configurao do servio de atualizao automtica.

TOTVS S.A.

29

Contm os arquivos executveis e componentes do Framework

Datasul .NET.

5.4.3. Selecionar Componentes

Nesta etapa o usurio seleciona os componentes que deseja instalar, sendo que
nessa verso, somente est disponvel uma opo para instalao dos servios de
atualizao automtica, conforme descrito a seguir.

Componente

Descrio

Servios de atualizao
automtica

Instala e configura o servio para atualizao automtica

das instalaes existentes nas estaes client, a partir de
atualizaes realizadas na verso Server do produto.

5.4.4. Parmetros de instalao

Nesta etapa devem ser fornecidas as informaes necessrias para que as
estaes de trabalho consigam acessar os servidores de dados e aplicao
previamente configurados.

TOTVS S.A.

30

5.4.4.1.

Servidores

Contm os nomes dos servidores de dados e de atualizao automtica

utilizados pelo produto:
Servidor de dados: nesse campo deve ser informado o nome do servidor
de dados, conforme configurado na instalao corporativa;
Servidor de aplicao e porta: nesses campos deve ser informado o
nome do servidor de aplicao e a porta, conforme configurados na
instalao corporativa. Estes campos somente no sero habilitados caso
seja detectada a existncia de uma instalao do produto Datasul BI no
mesmo ambiente;
Servidor de atualizao: esse campo somente estar disponvel se o
componente Servios de atualizao automtica fora selecionado na
etapa anterior, devendo ser informado o nome do servidor de atualizao
automtica, conforme configurado na instalao corporativa.
5.4.4.2.

Tipo de autenticao

Contm as opes para configurar a conexo com a base de dados existente

no servidor de dados, tendo a mesma funo e utilizao descrita no tpico
Tipo de autenticao da etapa Parmetros do servidor de dados.
5.4.5. Tarefas Adicionais
Nesta etapa o usurio pode selecionar duas opes para facilitar o acesso ao
programa, atravs da criao de cones do produto na rea de Trabalho e/ou
Barra de Inicializao Rpida do Windows.

TOTVS S.A.

31

5.4.6. Pronto para Instalar

Nessa etapa apresentado um resumo contendo todos os parmetros definidos para a
instalao em andamento para consulta antes se iniciar a instalao e configurao do
Datasul Planning.

5.5.Instalao Client Multi-instncia

No caso de querer instalar vrias instncias da verso client na mesma mquina, por
exemplo, para um ambiente ASP, preciso executar o instalador utilizando a
seguinte linha de comando:

TOTVS S.A.

32

clientsetup /instance=Nome_da_instncia
O valor informado para o argumento instance no deve conter aspas ou espaos
em branco, e servir para identificar cada instncia, sendo utilizado como sufixo nas
seguintes situaes:
Nomes dos servios e pastas de instalao;
Atalhos no Menu Iniciar, rea de Trabalho e Barra de Inicializao Rpida;
Nome do programa na relao de programas instalados do Painel de Controle
Embora as etapas e procedimentos para instalao de uma instncia nomeada sejam
semelhantes instalao da instncia padro descritas anteriormente, alguns
detalhes devem ser observados durante o processo:
Na etapa Pasta de Destino:
Deve ser informada uma pasta de
destino diferente para cada instncia;
O instalador sugere automaticamente a
criao de uma pasta com o nome da
instncia informado dentro da pasta de
instalao padro.
Essa etapa no ser apresentada nos
casos de atualizao do produto, ou
ento quando for detectada a existncia
de uma instalao do produto Datasul
BI utilizando mesmo nome de instancia
no mesmo ambiente.
Na etapa Parmetros de instalao:
Deve-se utilizar o nome da instncia do
servidor de dados, aplicao e
atualizao automtica, onde esto
disponveis os dados corretos e
componentes para a instncia que est
sendo instalada;
Deve-se informar uma porta diferente
para cada nova instncia, conforme
configurado no servidor de aplicao.
Os campos servidor de aplicao e
porta somente no sero habilitados
caso seja detectada a existncia de
uma instalao do produto Datasul BI

TOTVS S.A.

33

no mesmo ambiente;

5.6.Instalao Stand-alone
A instalao stand-alone utilizada normalmente em equipamentos de testes ou
demonstraes. Nesse caso, basta seguir os passos da instalao corporativa,
descritos no tpico Instalao Corporativa, selecionando o tipo de instalao
Instalao completa e em seguida desmarcando o componente Servios de
atualizao automtica.
Para o caso de instalao stand-alone preciso obter uma chave de demonstrao
especial e tambm fazer a instalao do servidor de licenas (License Server) na
mesma mquina.

TOTVS S.A.

34

6. Verificao do ambiente aps a instalao

Depois de concludo o processo de instalao, recomenda-se validar cada ambiente com
o intuito de detectar e solucionar falhas na instalao. A seguir, disponibilizamos um
check-list que poder ser utilizado como guia para facilitar essa verificao.

6.1.Servidor de aplicao
Verificar se os itens apresentados no captulo de requisitos foram atendidos;
Verificar a estrutura de pastas dos programas instalados;
Verificar se os seguintes servios esto instalados e iniciados:

Servios do Datasul .NET Framework

Servios de consulta do Datasul Business Intelligence 2.0
Servios do Datasul Planning
Servios de Metadados do Datasul Planning

Atribuir uma conta de logon para o servio Servios do Datasul Planning,

necessrio quando a Integrao com o Oramento do EMS estiver habilitada ou
quando os servidores de aplicao e de dados forem instalados em computadores
diferentes. Para obter mais informaes, consulte o tpico Atribuir contas de logon
para os servios da aplicao a seguir.

6.2.Servidor de banco de dados

Verificar a estrutura de pastas dos programas instalados.
Verificar a existncia e atividade dos bancos de dados DecisionModeling,
Datasul_BI_Metadata, DTS_LOG_BI e Framework
Verificar se o servio SQL Server Agent est iniciado.
Atribuir uma conta de logon para o servio SQL Server Agent, necessrio para o
correto funcionamento dos agendamentos de clculo e duplicao de estrutura de
planos Para obter mais informaes, consulte o tpico Atribuir contas de logon
para os servios da aplicao a seguir.

6.3.Estaes client
Caso tenha escolhido pela atualizao automtica, verificar se o servio Servios
de Atualizao automtica foi instalado e est iniciado;
Verificar a estrutura de pastas dos programas instalados.

6.4.Atribuir contas de logon para os servios da aplicao

Para que o produto funcione corretamente, determinados servios necessitam
acessar alguns recursos como arquivos e pastas protegidas. Para isso, devem
executar no contexto de segurana de um usurio do domnio, com privilgios

TOTVS S.A.

35

superiores a conta padro Sistema Local geralmente utilizada na instalao de

servios no sistema.
A seguir, so descritos os procedimentos para atribuir uma conta de logon para um
servio:
1. Acesse a ferramenta de gerenciamento de servios do Windows, disponvel em
Ferramentas Administrativas ou atravs da linha de comando services.msc;
2. Localize o servio a ser configurado. Para identificar o servio a ser configurado,
consulte o check-list de verificao do ambiente acima;
3. Clique duas vezes sobre o nome do servio para exibir as suas propriedades;
4. Clique na aba Logon e informe uma conta de usurio para o servio, conforme
exemplo abaixo:

5. Clique no boto OK para confirmar as alteraes.

Recomenda-se utilizar uma conta exclusiva para o servio, que no esteja
ligada a nenhum usurio do domnio e cuja senha nunca expire. Essa conta
no deve ser membro do nenhum grupo administrativo do domnio, ao
mesmo tempo em que tenha acesso a pastas e arquivos locais e na rede.

TOTVS S.A.

36

7. Atualizao de Pacotes
Sempre que um pacote de atualizaes for disponibilizado no portal, para que a
atualizao seja completa, o administrador do sistema deve executar primeiro o pacote no
servidor de aplicao e depois nas estaes client. Para isso basta executar os arquivos
de setup correspondente.
Caso tenha selecionado a instalao do servio de atualizao automtica, no
necessria a instalao do client nas estaes. O servio de atualizao automtica nas
estaes far o download automtico do pacote e quando o usurio fizer o acesso ao
client ser avisado da atualizao e permitir que a estao seja atualizada.
Para o correto funcionamento do servio de atualizao automtica, necessrio
que o servio do Windows conhecido como Servio de transferncia inteligente
de plano de fundo (BITS) esteja instalado e em execuo na mquina onde o
client do Planning est instalado.
O tempo padro de 10 minutos para a verificao e download de atualizaes
pode ser alterado conforme necessidade atravs de uma configurao localizada
no arquivo {pasta de instalao}\Framework\Datasul.UpdateManager.config
da mquina onde est instalado a verso client do produto.
Antes de executar um processo de atualizao, deve-se fazer a leitura completa do
release notes observando tanto as atualizaes disponibilizadas como observaes
tcnicas. Alm disso, importante ficar atento para as seguintes recomendaes:
Antes de atualizar um pacote, sempre execute um backup do ambiente atual, tanto
dos bancos de dados (Administrativo e Data Warehouse) como da pasta de
programas.
Tenha sempre a disposio um ambiente de testes onde possa aplicar os pacotes
de atualizao de forma a verificar e garantir que as opes selecionadas sejam
aplicadas sem surpresas quando forem executadas no ambiente de produo. O
ambiente de testes pode ser utilizado tambm para execuo de testes em
correes solicitadas pelo cliente.

TOTVS S.A.

37

8. Desinstalao
O procedimento de desinstalao deve ser executado somente quando no so mais
necessrios os componentes instalados em cada servidor, sendo que essa rotina deve
ser executada a partir do servidor onde foi instalado cada componente.
Para desinstalar o produto deve ser selecionada a opo remover no painel de controle
em Iniciar > Configuraes > Painel de Controle > Adicionar ou Remover Programas.
Durante esse processo ser solicitada a confirmao de excluso e posteriormente ser
apresentada uma tela de concluso do processo.
Esse procedimento no elimina todos os arquivos criados no processo de instalao,
como logs e arquivos temporrios, configuraes e bancos de dados. Nesse caso
verifique os diretrios utilizados para instalao dos componentes e remova os objetos
restantes manualmente conforme necessidade.
Caso esteja desinstalando o produto, para realizar uma nova instalao no mesmo
ambiente, preciso garantir que todos os arquivos e bancos de dados estejam
desinstalados e seus arquivos respectivos tenham sido removidos de forma a diminuir a
possibilidade de erros durante a nova instalao.

TOTVS S.A.

38