Manual de Instalacao Do Cockpit V5
Manual de Instalacao Do Cockpit V5
Manual de Instalacao Do Cockpit V5
Instalação do
Cockpit
Victor Siqueira
Alterdata Software
22/04/2016
Sumário
Introdução..........................................................................................................................3
Pré-requisitos.....................................................................................................................3
Informações importantes:...............................................................................................4
Instalação...........................................................................................................................6
Instalação Geral Cockpit................................................................................................6
Instalação Postgres.........................................................................................................9
Instalação Vistra...........................................................................................................16
Instalação DCL............................................................................................................22
CockpitCfg.......................................................................................................................25
Ferramentas / Opções...................................................................................................26
Ferramentas / Executar Carga......................................................................................28
Criação de agendamento para carga diária..................................................................29
Gerando uma licença (SGDL).........................................................................................30
Como obter a Chave do Servidor:................................................................................30
Instalando Cerificado – SGDL........................................................................................31
Login no Cockpit.............................................................................................................33
Configurações do Cockpit...............................................................................................34
Cadastro de usuários:.......................................................................................................36
Alerta por e-mail:.............................................................................................................40
Configurando o envio de e-mail..................................................................................40
Criando um Agendamento:..........................................................................................41
Aba Geral.....................................................................................................................42
Aba Periodicidade........................................................................................................43
Aba Destinatários.........................................................................................................44
2
Introdução
Esta apostila tem como objetivo demonstrar a parte da instalação automática do Cockpit e as
configurações iniciais necessárias para que haja integração entre o Cockpit e o Bimer.
Não será abordado como utilizar o Cockpit, caso deseje saber sobre isto clique aqui.
Pré-requisitos
Antes de começar a instalação e configuração do Cockpit será necessário atender os seguintes
requisitos abaixo e determinar qual máquina será o Servidor do Cockpit.
• A base de dados do Bimer deve ser de versão igual ou superior à 6.09.00.00. Caso a
base seja de versão inferior, é necessário executar um Database Manager de versão
6.09.00.00 ou superior e Atualizar Somente “Tabelas Novas” e “Tabelas que Possuam
Campos Novos”;
Para isto vá em: Iniciar >> Painel de controle >> Programas e recursos >> ativar e
desativar recursos do Windows >> Serviço de Informações da Internet:
Caso algum recurso necessário não esteja marcado, deverá marcá-los e dar “Ok”.
ATENÇÃO: Faça a expansão de todos os recursos através do botão (+) e confira se todas
as opções estão marcadas. É comum que um recurso sintético esteja marcado mas por
dentro, podem estar desmarcados os recursos analíticos. Isso fará com que o Cockpit
não funcione. Marque todos os sintéticos e analíticos.
3
• No IIS deverá verificar com o TI da empresa se porta 9000 está livre, caso contrário
deverá verificar quais portas já estão sendo utilizadas para selecionar uma que esteja
disponível e anotá-la para uso futuro durante a instalação. Esta porta será utilizada
pelo WebService do Cockpit;
Observação: Para instalação dentro da Alterdata Matriz possivelmente essa porta já esteja
liberada.
• Manter contato com o Suporte Bimer para credenciamento do cliente no SCA que será
explicado abaixo.
Informações importantes:
Para realizar a instalação do Cockpit, será necessário acionar o Suporte Bimer em dois
momentos. Esse suporte poderá ser acionado pelo Telefone ou Chat através da opção
“Cockpit”.
Primeiro momento:
5
Instalação
Para iniciar a instalação deverá clicar com o botão direito sobre o instalador
“Cockpit_setup.exe” e selecionar a opção “Executar como administrador”.
6
Nesta etapa da instalação, deverá selecionar quais componentes do Cockpit serão instalados:
O cronograma da instalação ocorrerá de acordo com a ordem das opções exibidas na tela.
1. Instalação do Postgres;
Observação: Caso seja necessário pausar a instalação, verifique em que ponto o progresso foi
interrompido, para dar continuidade posteriormente.
• Opção “Instalar Postgres” - Esta opção ao ser marcada instalará o banco de dados
Postgres.
Caso já possua o Postgres na máquina com a versão 9.3 ou superior, deverá desmarcar
esta opção.
Caso tenha o Postgres já instalado com a versão inferior a 9.3 deverá desmarcar esta
opção e realizar a instalação manual do Postgres com a versão 9.3 ou superior
utilizando uma porta diferente da instalação anterior do Postgres.
O Cockpit trabalha com uma base de dados Data Warehouse que consolida
informações para disponibilizar resultados de maneira mais ágil, por este motivo não
utiliza diretamente a base de dados do Bimer no SQL Server.
7
• Opção “Instalar Base modelo Postgres” - Marcando esta opção, no Postgres será
instalada a base padrão do Cockpit;
• Opção “Instalar Cockpit” - Marcando esta opção, fará com que o Cockpit seja instalado
na máquina. Neste momento também serão instalados o Vistra e DCLicenseSGUL.
8
Instalação Postgres
Em seguida será apresentada a tela do DOS que inicializará o instalador do Postgres, passando
automaticamente algumas configurações padrões como: porta, locale, usuário e senha.
9
Após a tela do DOS, será apresentado o instalador do Postgres conforme a imagem abaixo.
Nesta primeira tela, clique em “Next”.
Na próxima tela será apresentado o local em que será instalado o Postgres. Por padrão este
campo já vem preenchido. Clique em “Next”.
10
Nesta tela é onde se define em qual pasta os dados do banco de dados do Postgres serão
armazenados. Este campo por padrão é apresentado preenchido. Clique em “Next”.
Observação: Aconselhamos não alterar esta senha, pois é uma senha padrão a ser utilizada em
todos os clientes de Cockpit para futuro suporte.
11
Nesta tela deverá informar o número da porta que o Postgres utilizará, por padrão este campo
vem preenchido com 5444, mas caso esta porta já esteja sendo utilizada por outro serviço,
deverá informar uma outra porta que esteja disponível e liberá-la no firewall caso necessário.
Após isso clique em “Next”.
Observação: Caso apresente a mensagem abaixo que a porta selecionada já está sendo
utilizada, poderá utilizar a porta 5445.
12
Nesta tela será solicitada a localização/língua. Por padrão já será apresentada “Portuguese,
Brazil”, que é a configuração compatível com o Cockpit. Clicar em “Next”.
13
Após ter escolhido as opções e configurações para a instalação clique em “Next” para iniciar o
processo de instalação do Postgres.
14
Após a instalação ter sido concluída será apresentado a tela abaixo, nesta tela possui a opção
“Stack Builder may be used to download and install additional tools, drivers and applications
to complement your PostgreSQL installation.”, esta opção não é necessária, portanto poderá
simplesmente deixá-la desmarcada e clicar em “Finish”.
15
Instalação Vistra
Após a instalação do banco de dados Postgres, será iniciado automaticamente o instalador do
VistraBI. O Vistra é uma ferramenta de um parceiro da Alterdata, utilizada para criação da parte
gráfica do Cockpit. Para continuar a instalação clique em “Avançar”.
Na tela seguinte, deverá informar em qual diretório o Vistra será instalado. É recomendado
colocar o mesmo dentro da pasta do Cockpit para melhor organização e facilitar manutenções
futuras caso necessário. Após isso clique em “Avançar”.
16
Nesta tela deverá selecionar os componentes que serão instalados, para o correto
funcionamento do Cockpit, todas estas opções necessitam ser instaladas.
• Opção “Instalar Serviço Cliente SCA”- É o serviço responsável por realizar a atualização
do Vistra no cliente de forma automática, de acordo com a versão que a Alterdata
liberou para o cliente;
• Opção “Instalar Firebird 2.5”- É o banco de dados utilizado pelo Vistra para
suas rotinas internas;
• Opção “.Net”- O Vistra utiliza o .Net Framework, por este motivo deve ser/estar
instalado;
• Opção “Criar Banco de Dados”- Com esta opção marcada faz com que o Firebird crie o
seu próprio banco de dados para uso. Neste momento o sistema acessará o
endereço 186.233.142.10:13221 (Servidor Alterdata) fará download de todos os
painéis iniciais do Cockpit;
• Opção “Sistema Web (online)”- É o web service do Cockpit que rodará no IIS;
17
Nesta tela deverá configurar as informações de conexão do SCA para que o cliente se
autentique no servidor da Alterdata.
Observação: Caso a instalação esteja sendo feita a nível de teste dentro da rede da Alterdata,
em vez de utilizar o IP 186.233.142.10, utilizar NT10.
• Campo “Cliente SCA” - Deverá informar o nome atribuído a esse cliente conforme
credenciamento realizado pelo Suporte (início do manual: Informações Importantes).
18
Será necessário criar o banco de dados para o Vistra, com os painéis à serem utilizados para
representação gráfica no próximo passo da instalação.
Para criar o banco deverá clicar em “Criar Banco de Dados”, e aguardar enquanto os painéis
são baixados do servidor da Alterdata e gravados no diretório apontado no campo “Caminho
do Banco de Dados”.
19
Nesta tela deverá informar o número da porta a qual será executada a interface web do
Cockpit e deverá ser acessada por todos para utilizar os recursos do Cockpit. Será a porta
utilizada pelo Web Service.
Por padrão se utilizará a porta 9000, caso o cliente queira utilizar outra porta, o TI da empresa
deverá verificar a disponibilidade desta outra porta, liberá-la no firewall e deverá anotar este
outro número de porta, pois a mesma será utilizado mais adiante.
20
Após clicar em “Avançar” serão mostradas as informações da instalação, basta clicar em
“Instalar” para começar a instalação do Vistra.
Durante a instalação abrirá e fechará várias telas, até que no final aparecerá a tela abaixo,
bastando clicar em “Concluir” para finalizar a instalação do Vistra.
21
Instalação DCL
Após a instalação do Vistra será iniciado o instalador do DCL automaticamente.
Na tela seguinte deverá informar a porta que o SGUL utilizará para obter a licença, a porta
padrão é “34566” e em seguida clique em “Avançar”.
22
Nesta tela deverá informar o local onde será instalado o DCL, por padrão o campo já vem
preenchido, bastando apenas clicar em “Avançar”.
23
Após finalizar a instalação do mesmo bastará clicar em “Concluir”.
24
CockpitCfg
Em seguida abrirá o a tela de login do configurador do Cockpit. Para se logar deverá usar as
credenciais do usuário padrão do Cockpit para possíveis manutenções:
• Usuário: vip
• Senha: 654321
25
Ferramentas / Opções
Após o login será necessário realizar algumas configurações iniciais no Cockpit para integração.
Para isto vá em Ferramentas >> Opções.
26
Por padrão, os dados da conexão de Destino (quadro “Informe a conexão de DESTINO”) virão
preenchidos de acordo com as configurações preenchidas durante a instalação. Porém, é
necessário certificar-se das informações para o pleno funcionamento do Cockpit.
• No campo “Database name” - Informe o nome da Base de dados Cockpit que foi
restaurada no Postgres automaticamente na instalação: alterdata_cockpit;
Password: Cockpit_dev
No quadro “Informe a conexão de ORIGEM” deverá configurar de acordo com a base de dados
do Bimer para que seja possível realizar a carga de dados.
• No campo “Database name SQL Server” - Informe o nome da Base de dados Bimer de
onde serão exportadas as informações para a base do Cockpit (Postgres);
• No campo “User name SQL Server” - Informe o usuário de acesso e sua senha no
campo “Password SQL Server”. Poderá utilizar o usuário supervisor e sua respectiva
senha do Bimer;
Observação: Nos campos que possuem '\\' é gravado desta forma, pois ao gravar em txt, será
lido por uma aplicação que utiliza esta sintaxe para interpretar (kettle).
27
Ferramentas / Executar Carga
Para alimentar a base de dados do Cockpit deverá realizar a carga de dados, a qual existem dois
tipos:
• Inicial – É a primeira carga de dados que se deve realizar no sistema após a instalação
do sistema, com este tipo de carga, primeiro será zerado o banco de dados do Cockpit
e em seguida alimentará o banco de dados de acordo com a base do Bimer;
• Diária – Este tipo de carga alimentará a base do Cockpit com os dados da base do
Bimer. O período que será substituído na carga diária é configurável (CockpitCfg >>
Ferramentas >> Opções), porém, por padrão a carga apaga os dados dos últimos 90
dias do Faturamento e Pedido de Venda e todos os dados dos demais módulos
(Financeiro, etc) e preenche com os novos dados até a data atual. Após esta carga de
dados o sistema armazenará esta data da última carga no arquivo log_cockpit, dentro
da pasta raiz do Cockpit.
28
Criação de agendamento para carga diária
Para que a carga diária seja realizada de forma automática, será necessário criar um
agendamento no Windows, para isto siga os seguintes passos:
Vá em Iniciar >> Painel de Controle >> Sistema e Segurança >> Ferramentas Administrativas
>> Agendador de Tarefas.
Digite o nome “Carga Diária Cockpit” e uma descrição opcional da tarefa e clique em Avançar.
29
Gerando uma licença (SGDL)
Para o funcionamento do Cockpit é necessária a licença SGDL responsável por autenticar o
cliente no servidor Vistra. Entre em contato com o Suporte Bimer e solicite a licença. Tenha em
mãos a “Chave do Servidor” (vide adiante como obter), CNPJ e Nome da Empresa.
Após o suporte habilitar a licença, será necessário instalar um certificado que fará a ligação
entre a licença gerada e o servidor do Cockpit no cliente.
Deverá fazer login utilizando o usuário “plain” e senha “plain”. Em seguida, logo na tela inicial
há o campo “Chave do servidor” na parte superior da tela.
Nesse momento com o Chave do servidor, CNPJ e Nome da empresa, mantenha contato com o
suporte para que possam habilitar a Licença SGDL para prosseguir com as configurações.
30
Instalando Cerificado – SGDL
Após o suporte ter habilitado a licença será necessário instalar o certificado de autenticação.
Para instalar o certificado deverá acessar a página http://nomedoservidor:34566 ou
http://localhost:34566 e clicar em “Configurações”.
Em seguida deverá clicar em “Executar Atualização” para que o certificado seja baixado e
atualizado no servidor automaticamente.
31
Para confirmar se tudo ocorreu corretamente clique em “Monitor de licenças”, informe no
campo “Produto” o “Vistra BI” e no campo “Pacote Funcionalidade” a opção “Todos os
pacotes”. Será exibido na grid “Licenças” a licença inserida no passo anterior.
Caso a licença do cliente não apareça no quadro de Licenças, verifique com o Suporte.
32
Login no Cockpit
Para acessar a página web do Cockpit basta abrir o navegador e acessar http://localhost:9000
(acesso local) ou http://nomedoservidor:9000. Caso não tenha alterado a porta padrão
durante a instalação. Caso tenha utilizado outra porta durante a instalação do Vistra, altere no
endereço acima.
Por padrão o usuário abaixo é criado no Cockpit para utilização exclusiva do Analista VIP.
• Usuário: vip
• Senha: 654321
ATENÇÃO: Estes dados de login não podem ser passados ao Cliente, por ter PERFIL SUPERVI-
SOR (possui acesso total).
Aconselhamos não excluir este usuário pois poderá ser utilizado pelos analistas Vip que visita-
rão a empresa.
33
Configurações do Cockpit
No primeiro acesso ao Cockpit será apresentada a tela abaixo. Neste momento será necessário
editar a empresa e alterar os campos “Nome” e “CNPJ”, com as mesmas informações utilizadas
na geração da licença no SGDL.
34
Atenção aos cenários visualizados pelo usuário Vip
Logado com o Usuário Vip, ao clicar em “Cenários” será apresentada a tela de Cenários Favori-
tos, por padrão. Clicando para expandir as categorias de painéis, somente deverá utilizar o pai -
nel Geral >> Alterdata Cockpit, conforme imagens abaixo.
Todas as outras opções apresentadas neste menu não podem ser utilizadas, pois são desdobra-
mentos de outros painéis e serão acessados apenas pelos painéis principais. Também podem
existir painéis que foram descartados e que não tenham informações corretas.
Por este motivo, aconselhamos logo em seguida cadastrar um usuário específico para a
utilização pelo cliente em que não terá a visualização desses outros painéis.
35
Cadastro de usuários:
Após logar no sistema com usuário Vip, deverá criar o primeiro usuário para o cliente. Veja
abaixo como cadastrar o usuário o que envolverá 3 etapas.
1ª – Cadastro de usuário:
IMPORTANTE: No campo “Perfil” deverá ser informado PRO e no campo “Tipo” deverá ser
informado Administrador para a principal pessoa responsável pelo Cockpit na empresa.
Quando o cliente cadastrar outros usuários, deve ser orientado a utilizar o Tipo Padrão pois
este possuirá apenas permissões de visualização.
36
2ª – Permissão por usuário:
Nesta etapa será concedida a permissão ao painel principal ao usuário cadastrado no passo
anterior.
É muito importante que o usuário criado possua acesso somente ao cenário abaixo descrito, para
que não utilize cenários indevidos, conforme alertado anteriormente quanto ao usuário Vip.
C) Marque a opção Leitura para o cenário “Alterdata Cockpit”. Esta configuração é necessária
para que o cliente tenha acesso somente ao painel devido e não visualize todos os painéis,
como acontece com Usuário Vip;
37
D) Acesse a aba “Formulários” e marque todas as opções para Leitura e Escrita, para que o cli-
ente possa configurar metas pelo Cockpit.
E) Clique em “Salvar”.
38
3ª – Conexões por usuário:
Nesta etapa será configurado o acesso do usuário em questão à base de dados do Postgres.
C) Selecione o usuário a esquerda e clique na seta indicada abaixo para selecioná-lo, movendo-
o para o quadro a direita:
D) Clique em “Salvar”.
39
Alerta por e-mail:
É muito importante incentivar o acesso do cliente ao Cockpit diariamente. Para que se torne
uma ferramenta de uso frequente é obrigatório utilizar o recurso de “Agendamento” que
notificará o cliente diariamente por e-mail com o link de acesso a um painel pré-definido.
40
Criando um Agendamento:
Em Opções >> Ferramentas >> Agendamento:
41
Aba Geral
Informe a Descrição (Sugestão “Lembrete de Utilização”). Informe o cenário que deseja enviar
no e-mail (Sugestão “Alterdata Cockpit”).
Logo abaixo informe os parâmetros do cenário que serão pré-definidos para o envio do e-mail.
Utilize variáveis de “Ano Corrente” e “Mês Corrente” clicando na opção “…” para que o link
enviado por e-mail tenha informações sempre atualizadas conforme o mês atual.
42
Aba Periodicidade
Informe quando deseja enviar o e-mail do Agendamento, inserindo os dados de Periodicidade.
Informe os dias que deseja enviar o e-mail e seu devido horário de envio.
43
Aba Destinatários
No campo “Destinatários”, informe quais os usuários receberão a mensagem deste
Agendamento.
44