manual de instalaÇÃo - e furukawa...5.2.4 instalaÇÃo do java nessa etapa do processo é...
TRANSCRIPT
1
MANUAL DE INSTALAÇÃO
SISTEMA DE GERÊNCIA
CONSCIUS
2
ÍNDICE
ÍNDICE ................................................................................................................................................................................. 2
1. INTRODUÇÃO ............................................................................................................................................................. 3
2. REQUISITOS ................................................................................................................................................................ 3
2.1 Requisitos mínimos para utilização do instalador ................................................................................................... 3
2.2 Requisitos mínimos para instalação do sistema de gerência ................................................................................... 3
3. PROCEDIMENTO PARA EXECUÇÃO DO INSTALADOR ................................................................................................. 4
4. PARÂMETROS NECESSÁRIOS PARA INSTALAÇÃO DO SISTEMA ................................................................................. 5
5. INSTALAÇÃO DO SISTEMA .......................................................................................................................................... 5
5.1 Verificação dos requisitos mínimos para instalação do sistema .............................................................................. 8
5.2 Inicialização do processo de Instalação ................................................................................................................. 10
5.2.1 Configuração das variáveis de ambiente ......................................................................................................... 12
5.2.2 Instalação do banco de dados ......................................................................................................................... 13
5.2.3 Configuração do banco de dados .................................................................................................................... 14
5.2.4 Instalação do JAVA........................................................................................................................................... 15
5.2.5 Instalação do sistema (JBoss) .......................................................................................................................... 16
6. ACESSO AO SISTEMA DE GERÊNCIA CONSCIUS ........................................................................................................ 18
7. DESINSTALAÇÃO DO SISTEMA ................................................................................................................................. 19
8. SOBRE O INSTALADOR ............................................................................................................................................. 22
9. INFORMAÇÕES COMPLEMENTARES ........................................................................................................................ 23
3
1. INTRODUÇÃO
Este manual apresenta as instruções para instalação do sistema de gerência Conscius. O
instalador é um aplicativo do tipo wizard que pode ser executado em qualquer máquina que
possua interface gráfica e conexão com o servidor de gerência.
2. REQUISITOS
2.1 REQUISITOS MÍNIMOS PARA UTILIZAÇÃO DO INSTALADOR
Para execução do instalador é necessário:
Máquina com Java 1.6, ou superior, instalado e configurado;
Sistema operacional Windows ou Linux (com interface gráfica instalada).
2.2 REQUISITOS MÍNIMOS PARA INSTALAÇÃO DO SISTEMA DE GERÊNCIA
Para instalação do sistema de gerência é necessário que o servidor tenha:
No mínimo de 8GB de memória;
Usuário “ems” criado (com permissões de root);
Linux previamente instalado e configurado (SO Linux 64 bits - Ubuntu Server
14.04 LTS);
“Locale” do sistema operacional configurado para “en_US”;
SSH Server instalado e configurado no servidor;
4
Especificação de hardware1 compatível com o tipo da licença Conscius.
ATENÇÃO: Quando o sistema Conscius estiver configurado como solução de alta disponibilidade
o usuário “asga” também precisará ser criado e com permissão de root.
3. PROCEDIMENTO PARA EXECUÇÃO DO INSTALADOR
O arquivo de instalação do sistema não deve ser executado diretamente no CD, deve ser
copiado para uma máquina e depois executado.
Máquina com Windows:
o Copiar o arquivo para uma pasta;
o Descompactar (extrair) os arquivos de instalação;
o Acessar o diretório raiz do pacote de instalação e com duplo clique executar o
arquivo "InstallerConscius.jar".
Máquina Linux com interface gráfica:
o Copiar o arquivo para uma pasta;
o Descompactar (extrair) os arquivos de instalação;
o Através do terminal de comandos, entrar no diretório onde o pacote de
instalação foi descompactado;
o Executar o comando "java -jar InstallerConscius.jar". O arquivo deve ser
executado no mesmo local onde foi descompactado.
1 Para informações adicionais sobre o hardware necessário para instalação do sistema, contatar o suporte técnico Furukawa ([email protected]).
5
4. PARÂMETROS NECESSÁRIOS PARA INSTALAÇÃO DO SISTEMA
Endereço IP do servidor;
Login/senha do usuário Conscius no servidor (o padrão utilizado pela Furukawa é
ems/ems e criado no momento da instalação do sistema);
Senha de Root (o padrão utilizado pela Furukawa é ems).
5. INSTALAÇÃO DO SISTEMA
Por padrão a versão do sistema de gerência Conscius definida para instalação é sempre a
última em produção.
A instalação pode ser realizada através da tela principal do instalador, ou através do menu
Opções → Instalação.
Figura 1: Menu de opções de instalação do sistema.
6
Figura 2: Tela inicial do instalador.
Antes da execução de cada uma das etapas de instalação do sistema será solicitada a
configuração dos parâmetros de acesso ao servidor (Figura 3). Esses dados possibilitarão
estabelecer uma conexão SSH com o servidor e consequentemente o envio de arquivos e
comandos necessários em cada uma das etapas de instalação.
7
Figura 3: Tela para configuração dos parâmetros de acesso ao servidor.
ATENÇÃO: Para que a base de dados do Conscius seja instalada corretamente, é extremamente
necessário que o “locale” do sistema operacional instalado no servidor esteja configurado como
en_US. Essa configuração deve ser realizada no momento da instalação do sistema operacional
Linux. Caso esse parâmetro não esteja configurado corretamente deve-se editar o arquivo
/etc/default/locale (no servidor), antes de iniciar a instalação, modificando a opção “pt_BR”
para a opção “en_US” (LANG=“en_US.UTF-8").
Preenchidas as configurações de acesso ao servidor, verificar se a versão selecionada é
realmente a versão que se deseja instalar, em seguida selecionar o botão “CONTINUAR”.
8
Figura 4: Indicação da versão do sistema a ser instalado.
5.1 VERIFICAÇÃO DOS REQUISITOS MÍNIMOS PARA INSTALAÇÃO DO SISTEMA
Antes de iniciar o processo de instalação do sistema a ferramenta verifica se todos os
requisitos e parâmetros necessários estão sendo obedecidos. Caso qualquer um dos itens
checados não seja validado uma mensagem de advertência é apresentada ao usuário (indicando
o problema encontrado) e o processo de instalação é interrompido.
9
Figura 5: Tela de validação apresentada quando os requisitos necessários à instalação não é obedecida.
Durante o processo de instalação podem ocorrer dois tipos de falha: quantidade de
memória do servidor não pode ser obtida e valor do “locale“ do sistema operacional diferente
do esperado.
Falha na obtenção da quantidade de memória do servidor
Essa falha indica que a conexão SSH para o servidor foi recusada. Antes continuar o
processo de instalação deve-se garantir que o problema de conexão com o servidor foi
resolvido.
Erro no valor do locale obtido do sistema operacional
Locale é um conjunto de parâmetros relacionados às preferências regionais do usuário que
inclui idioma, país, moeda, formatos de hora e medida. O banco de dados utilizado pelo
sistema precisa que o locale esteja configurado corretamente .
10
O banco de dados somente será instalado se o locale do sistema operacional estiver
configurado para “en_US”. Caso o locale esteja configurado com um valor diferente de “en_US”,
uma mensagem de erro será exibida no momento da instalação do banco de dados, conforme
mostrado na figura abaixo.
Figura 6: Mensagem de erro na instalação do banco de dados quando há erro de Locale.
Para resolver o problema deve-se acessar o servidor e editar o arquivo
“/etc/default/locale”. seguida deve-se alterar o item locale para “en_US” (LANG="en_US.UTF-
8").
Importante: Para qualquer problema encontrado no processo de validação do ambiente será
indicado ao usuário uma forma de resolver o problema, para posteriormente iniciar a instalação
do sistema.
5.2 INICIALIZAÇÃO DO PROCESSO DE INSTALAÇÃO
Após validação dos requisitos mínimos o processo de instalação é iniciado, ocorrendo de
forma automática seguindo a sequencia abaixo:
1. Configuração das variáveis de ambiente;
2. Instalação do banco de dados (Postgres);
3. Configuração do banco de dados (Postgres);
4. Instalação do Java;
5. Instalação do Servidor (JBoss).
11
Figura 7: Status do processo de instalação do sistema.
O status do processo de instalação é descrito da seguinte forma:
Sequencia das etapas de instalação do sistema
Total de memória identificado no servidor
Status do processo (log) de cada etapa de instalação
Identificação do progresso total da instalação do sistema
Identificação do progresso de cada etapa de instalação do sistema
1
3
4
5
2
12
Para iniciar o processo deve-se selecionar o botão “INICIAR INSTALAÇÃO”.
O processo de instalação do sistema é simples e automático sendo necessária a mínima
intervenção do usuário, com exceção para os casos de erro que possam ocorrer ao logo do
processo.
Na sequencia são apresentadas as telas visualizadas em cada etapa da instalação:
5.2.1 CONFIGURAÇÃO DAS VARIÁVEIS DE AMBIENTE
A configuração das variáveis de ambiente (caminhos utilizados pelo Java) é necessária para
que a compilação e execução dos aplicativos ocorram corretamente.
Figura 8: Tela de progresso para configuração das variáveis de ambiente.
13
5.2.2 INSTALAÇÃO DO BANCO DE DADOS
Nessa etapa é realizada a instalação do sistema de gerenciamento de banco de dados
(SGBD) utilizado pelo Conscius. O SGBD utilizado é o PostgreSQL versão 9.1.
Figura 9: Tela de progresso da instalação do banco de dados.
14
5.2.3 CONFIGURAÇÃO DO BANCO DE DADOS
O processo de configuração do banco de dados é responsável pela criação das regras e pelo
“dump” do banco de dados utilizado pelo sistema.
Figura 10: Processo de configuração do banco de dados.
15
5.2.4 INSTALAÇÃO DO JAVA
Nessa etapa do processo é realizada a instalação do JAVA, necessária para utilização da
aplicação. A versão utilizada pelo sistema é a JAVA 64 bits 1.7.0_45.
Figura 11: Processo de instalação do Java.
16
5.2.5 INSTALAÇÃO DO SISTEMA (JBOSS)
Esse processo é o responsável pela instalação do servidor de aplicação utilizado pelo
sistema de gerência. Ele também é responsável por prover recursos de clusterização, segurança
e integração. O servidor utilizado é o JBoss-EAP-6.1.
Figura 12: Processo de instalação do sistema de gerência.
O JBoss é a último componente a ser instalado. Ao final desse processo o servidor é
reiniciado iniciando automaticamente o sistema de gerência Conscius.
17
Figura 13: Tela indicando que o processo de instalação do sistema ocorreu com sucesso.
Importante: toda vez que uma instalação for cancelada será necessário fazer a desinstalação de
todas as etapas já realizadas e uma nova instalação será necessária.
Ao final da instalação é disponibilizado ao usuário o acesso ao log da instalação. Para
exportá-lo deve-se selecionar o botão “Exportar log da instalação” e selecionar o diretório
desejado para download do arquivo.
18
Figura 14: Exportação do log de instalação.
6. ACESSO AO SISTEMA DE GERÊNCIA CONSCIUS
Ao final do processo de instalação o sistema deverá ser acessado digitando-se o IP do
servidor de gerência através de qualquer um dos browsers recomendados2 pela Furukawa.
O link do sistema será automaticamente direcionado para um acesso seguro, com
credenciais geradas pelo próprio servidor.
2 Browsers compatíveis com o sistema Conscius: Mozilla Firefox: 20.0.0, Chrome: 30.0.0 e Internet Explorer: 9.0
19
Figura 15: Exportação do log de instalação.
7. DESINSTALAÇÃO DO SISTEMA
O processo de desinstalação do sistema necessita dos mesmos parâmetros utilizados na
instalação:
IP Servidor: IP do servidor onde o sistema Conscius será desinstalado;
Login: usuário linux do servidor (utilizado para conexão SSH);
20
Senha: senha utilizada no login (utilizada na conexão SSH);
Senha de root: senha do usuário root do servidor (utilizada durante as etapas de
desinstalação do sistema).
Figura 16: Tela de desinstalação do sistema.
21
Para iniciar o processo de desinstalação deve-se selecionar o botão “INICIAR
DESINSTALAÇÃO”.
Figura 17: Processo de desinstalação iniciado.
Ao final desse processo será disponibilizado ao usuário o log da desinstalação através do
botão “EXPORT LOG DA INSTALAÇÃO”.
Figura 18: Finalização do processo de desinstalação do sistema.
22
8. SOBRE O INSTALADOR
Através do menu Ajuda → Sobre o Instalador tem-se as informações adicionais
relacionadas ao instalador tais como versão e compatibilidade.
Figura 19: Tela de Ajusta do Instalador.
23
9. INFORMAÇÕES COMPLEMENTARES
Para informações adicionais relacionadas ao acesso ao sistema de gerência Conscius
(arquivos, diretórios, logins de acesso, etc) podem ser encontradas no documento Anexo 01 -
Requisitos de Rede e Infraestrutura.pdf.
Mais informações sobre acesso e operação consultar o manual de operações do Conscius.
Revisão 5 - 02/2017
24