Manual de Instalação do Agrotis Plataforma Versão 1.7 (Appliance)

Conteúdo

Manual de Instalação Procedimentos padrões para todos os Módulos

Contexto

O Agrotis Plataforma é o conjunto de tecnologias que a Agrotis utiliza para criar manter e entregar seus sistemas para os clientes.

Ele é comercializado de duas maneiras: hospedado no Datacenter da Agrotis ou instalado em um servidor nas dependências do Cliente. Este manual considera que a instalação do Agrotis Plataforma está sendo executada na modalidade Cliente.

Para funcionar, o Agrotis Plataforma precisa ter acesso à Internet (somente para os IP's  da Agrotis). Isto é necessário por questões de controle de licença, atualização das bases de dados de Produtos, sincronização de data e hora, envio de alertas e suporte remoto.

Após a instalação inicial, o Agrotis Plataforma deve ser sempre atualizado (via opção disponível no Menu de Administração).

Para fins de suporte e atualização, é  necessário que a Agrotis tenha acesso a este servidor via SSH e HTTP. Isto é imprescindível para o correto funcionamento da solução.


Este manual é complementado pelos manuais dos módulos contratados.
Após seguir as instruções deste manual, procure na mídia de instalação os manuais adicionais.


Pré-requisitos (Responsabilidade do Cliente)

Hardware Mínimo

  • Processador Quad-Core
  • 8 Gb de Memória RAM
  • 50 Gb de Disco
  • BIOS com suporte para ACPI
  • BIOS com suporte para boot via CDROM
  • Controladora de Discos SAS ou SATA
  • Disco conectado à primeira porta da primeira controladora
  • Recomenda-se RAID 1 para os discos


Hardware deve ser compatível com Linux CentOS 6 x86_64

Observação: o hardware mínimo é válido para servidores físicos e virtuais.

Rede Local

  • Definir um endereço IP e nome (FQDN) para o Agrotis Plataforma na rede interna. Anotar este endereço IP, a máscara de rede, o servidor de DNS e o default gateway.
  • Ajustar o DNS e o Reverso do DNS da rede interna para que o nome FQDN seja resolvido para o endereço IP.
  • Definir o IP do Agrotis Plataforma via DHCP Reservation ou IP Fixo (informado no momento da instalação) é uma política definida pelo Cliente.
  • Anote estas informações, já que serão necessárias mais tarde.
  • No caso em que o Agrotis Plataforma estiver sendo instalado em uma Máquina Virtual (VM), recomenda-se que a interface de rede seja configurada em modo Bridge.
  • Também recomenda-se que testes de velocidade de I/O de Disco e Rede sejam feitos na máquina virtual e no host físico, comparando os resultados. Em caso de baixa performance da Máquina Virtual, deve-se corrigir o problema antes do uso do Agrotis Plataforma em ambiente de produção.

Importante: o cabo de rede local deve estar conectado na primeira interface do  barramento (eth0).

Internet

Link de dados com banda disponível e compatível com o volume de transações do Cliente.

Firewall - Regras de Saída (Outgoing)


Firewall - Regras de Entrada (Incoming)


Importante: as regras de Firewall/Roteador deverão ser criadas antes do início da instalação. A instalação irá testar se as regras de firewall de Saída estão corretas e não irá prosseguir se as conexões não forem bem sucedidas.

MUITO IMPORTANTE: não libere acesso para qualquer IP da Internet. Libere acesso somente para os IP's da Agrotis. Evitar ataques da Internet é fundamental para a disponibilidade e performance do serviço do Agrotis Plataforma.


Banco de Dados

  • Consultar documentação específica para o produto que estará sendo ativado no Agrotis Plataforma.
  • Certifique-se de que o servidor de banco de dados esteja configurado para receber conexões TCP/IP e que o firewall esteja permitindo estas conexões.
  • Não se esqueça de definir uma política de backup para este banco. Ela é de responsabilidade do Cliente e não da Agrotis.
  • Lembrando que a Agrotis também disponibiliza um serviço de Guarda de Dados em seu Datacenter. Dados, arquivos XML e até documentos de usuários podem armazenados fora das dependências do Cliente.

A falta de algum dos pré-requisitos irá afetar o correto funcionamento do Agrotis Plataforma. Como consequência, atualizações não poderão ser instaladas e/ou o Suporte da Agrotis não conseguirá prestar auxílio adequadamente.


Procedimentos de Instalação

1. Baixar a mídia (arquivo ISO) do Site da Agrotis, conforme link disponibilizado na contratação do produto;

2. Criar o banco de dados, conforme o item Pré-requisitos (Módulo Agrowin somente);

3. Efetuar as alterações no Firewall/Roteador, conforme o item Pré-requisitos;

4. Iniciar o servidor solicitando o boot pela mídia (iso) (Atenção: todos os dados vão ser apagados !);

5. Aguardar pela tela abaixo:

6. Selecionar uma das opções, conforme as seguintes orientações;

  • Instalar pelo disco local (nao instalar): o instalador irá aguardar por 60 segundos. Caso nenhuma opção seja selecionada, a instalação será abortada um boot pelo primeiro disco interno será tentado.
  • Instalar sem Drivers Adicionais: é a opção que deve ser tentada inicialmente. A instalação será feita sem a utilização de drivers proprietários do fornecedor do hardware e/ou virtualização.
  • Instalar com Drivers Adicionais: a instalação irá solicitar drivers adicionais, que deverão ter sido previamente gravados em um pendrive com formatação FAT32.
  • Devem ser seguidas as orientações do fornecedor do hardware e/ou virtualização para o Sistema Operacional Red Hat Enterprise Linux 6.7 ou CentOS 6.7
  • Instalar com Drivers Adicionais (sem AHCI): é a mesma opção do que a anterior, só que os drivers de controladores AHCI não serão carregados. Isto é necessário para alguns modelos de controladoras de disco (ver Anexo I).

7. Aguardar a inicialização da instalação;

8. Informar as configurações de IP previamente anotadas. Os endereços das telas são  meramente ilustrativos;

9. Caso não tenha optado por DHCP, informe os detalhes da interface de rede manualmente.

  • IPv4 address: informe o IP que foi definido para o Agrotis Plataforma no formato IP/Máscara de Rede
  • Gateway: informe o IP do roteador/firewall de Internet de sua rede interna
  • Name Server: informe o IP do servidor de DNS da sua rede interna

10. Ler a primeira página do Contrato de Licença, pressionar ENTER;

11. Ler a segunda página do Contrato de Licença, digitar CONCORDO e dar um ENTER;

12. Todos os dados de todos os discos vão ser apagados. Digite CONCORDO e pressione ENTER;

13. A instalação irá prosseguir. Tenha à mão os dados que foram preparados na etapa de pré-requisitos.

Na imagem abaixo, mensagem de erro devido a problemas de DNS.

Caso não seja possível resolver o nome do IP que foi atribuído para o Agrotis Plataforma no início da instalação, é possível informar o nome do servidor (Host) manualmente, conforme exemplo na imagem abaixo:

Observar somente que se o DNS não estiver corretamente configurado, as outras estações não irão conseguir acessar o Agrotis Plataforma via nome de host e/ou o Agrotis Plataforma não irá se conectar com a Agrotis.

14Não havendo problemas de DNS ou após informar manualmente o nome do servidor, as conexões de Internet para o Datacenter da Agrotis são testadas.

Abaixo uma imagem de exemplo de um teste bem sucedido:

Abaixo uma imagem de exemplo de um teste mal sucedido. Sem conectividade com a o Datacenter da Agrotis, a instalação não irá prosseguir. Verifique os pré-requisitos e efetua as correções necessárias.

15. Finalizados os testes de conexão da Plataforma para a Agrotis, serão feitos os testes de conexão da Agrotis para a Plataforma (sentido inverso);

Informe o IP real de Internet e porta redirecionada para o serviço SSH, exatamente como foram feitas as liberações no firewall/roteador. Abaixo imagem de exemplo bem sucedido:

Abaixo um exemplo de conexão da Agrotis para a Plataforma mal sucedido:

Se a opção for por não liberar as conexões da Agrotis para o Plataforma, a instalação não irá abortar e ao apertar alguma tecla diferente de [ENTER], irá continuar.

Observar somente que neste cenário, deve ficar claro que as opções para um correto suporte remoto por parte da Agrotis, ficam seriamente prejudicadas.

Abaixo um exemplo de conexão da Agrotis para a Plataforma bem sucedido:

Dependendo dos módulos contratados, testes adicionais de conexão da Agrotis para a Plataforma serão executados.

Devem ser informado o IP de Internet e a posta que foi redirecionada, à exemplo do serviço SSH.

16. Após os testes de conexão de entrada, os discos serão formatados e o sistema instalado. Aguardar a finalização de todas as etapas;

17. Ao final da instalação, o CD será ejetado e o servidor reinicializado. Remova o CD antes que o servidor comece a inicialização. A tela abaixo é mostrada ao final da inicialização;

18. Caso queira acessar o Agrotis Plataforma remotamente, via SSH, acesse a opção Alterar Senha do Usuário Administrador e informe uma senha de seu uso exclusivo.

19. Utilizando sempre o Menu do Console de administração, execute os seguintes passos:

  • Atualizar o Agrotis Plataforma;
  • Ao final da atualização, Reiniciar o Agrotis Plataforma;
  • Para finalizar a instalação, siga os passos do manual dos módulos que foram contratados;

20. Teste o acesso a partir da aplicação cliente. O Agrotis Plataforma disponibiliza um compartilhamento Windows com os Clientes dos módulos.

Eles podem ser acessados digitando-se:

\\[FQDN ou IP do Agrotis Plataforma]\[Pasta do módulo]

no Windows Explorer de uma estação que esteja na mesma rede local.

Exemplo: \\teste.agrotis.com.br\bcpp\clf.exe

  • Módulos BCPP e OS: executar CLF.exe ou OS.exe. Informar admin/admin para usuário/senha
  • Módulo Receituário: executar ReceitaAgrowin.exe
  • Módulo Pesquisa: executar AgrPesquisa.exe


Tarefas Administrativas

O Agrotis Plataforma possuiu um Menu para facilitar a sua administração. Configurações e manutenções são feitas por intermédio deste Menu.

Opções do Menu com código 90 e acima devem ser utilizadas sob orientação do Suporte da Agrotis.

Caso ocorra algum problema com o hardware do servidor, os procedimentos para recuperação de desastres são:

  1. Reinstalar o Agrotis Plataforma, seguindo os passos deste manual;
  2. Ajustar as conexões de banco de Dados via Menu de Administração;
  3. Executar uma atualização via Menu de Administração;
  4. Reiniciar o Agrotis Plataforma;
  5. Exibir Log Atualizador Banco;
  6. Exibir Log do JBoss;

Para desligar o Agrotis Plataforma, utilize a respectiva opção no Menu.

Mudanças na infraestrutura do Cliente devem prever possíveis ajustes no Agrotis Plataforma e devem ser planejadas com antecedência para evitar a parada dos serviços. Exemplos:

  • Troca de firewall (default gateway e regras de entrada/saída);
  • Troca de servidor de Banco e Dados;

Não execute nenhuma outra atividade no Agrotis Plataforma enquanto o mesmo estiver rodando uma atualização.

As atualizações do Agrotis Plataforma devem ser sincronizadas (feitas na mesma data) com as atualizações do Agrotis Gerencial (SafeBD).

Update de Versões

  • Acessar o Menu no console Local do Agrotis Plataforma;
  • Opção Atualizar o Agrotis Plataforma;
  • Exibir Log de Atualizações;
  • Se no log estiver constando as atualizações na data corrente, Reiniciar o Agrotis Plataforma;


Anexo I

Compatibilidade com Hardwares Específicos

Controladora RAID B120i/B320i HP Generation 8

Para o Agrotis Plataforma reconhecer esta controladora, é necessário o uso de um driver proprietário da HP. O driver e instruções encontra-se disponível no Site da HP (link validado em 28/11/2014):

http://h20564.www2.hp.com/hpsc/swd/public/detail?sp4ts.oid=5379528&swItemId=MTX_a206cb65c4924c5a9a8312b2f8&swEnvOid=4103

Utilizar driver para Red Hat Enterprise Linux 6 ou CentOS 6.

AP 1.5 = CentOS 6.5

AP 1.6 = CentOS 6.6

AP 1.7 = CentOS 6.7

Como fazer:

  1. Formatar um pendrive no formato FAT32;
  2. Baixar o arquivo do site da HP (hpvsa-1.2.12-110.rhel6u5.x86_64.dd.gz), observando a versão do AA que está sendo instalada;
  3. Utilize gunzip para descompactar o driver previamente baixado;
  4. Gravar o arquivo .dd no pendrive;
  5. Desmontar o drive;
  6. Iniciar a instalação do Agrotis Plataforma com o ISO e o pendrive conectados no servidor;
  7. Controladora B320i: iniciar a instalação com a opção Instalar com Drivers Adicionais
  8. Controladora B120i: iniciar a instalação com a opção Instalar com Drivers Adicionais (sem AHCI)
  9. A instalação irá solicitar para escolher o dispositivo do pendrive e selecionar um driver. Selecione o arquivo .dd previamente gravado;
  10. Informe que não deseja mais carregar nenhum driver adicional para que a instalação continue conforme instruções deste manual;


Artigos relacionados