VISÃO GERAL
Abordaremos as etapas necessárias para o processo de instalação / atualização do TOTVS Agro Mobilidade Manfro, por meio da ferramenta Instalador/Atualizador Mobilidade Manfro em modo silencioso (modo não interativo) e modo padrão (gráfico).
PRÉ-REQUISITOS
1. Instalação do RabbitMQ
- Instalação do RabbitMQ em Linux, deverá ser realizado através dos procedimentos descritos no link https://www.rabbitmq.com/docs/install-rpm
- Criação de um novo usuário no RabbitMQ para acesso remoto ao painel de gerenciamento das Queues;
- sudo rabbitmqctl add_user admin "senha"
- sudo rabbitmqctl set_permissions -p / admin "." "." ".*"
- sudo rabbitmqctl set_user_tags admin administrator
- sudo rabbitmqctl list_users
- Habilitar o pluing de Gerenciamento das Queues
- sudo rabbitmq-plugins enable rabbitmq_management
- sudo systemctl restart rabbitmq-server
- sudo rabbitmq-plugins list
- Modificação a porta padrão RAbbitMQ
2. Instalação do TOTVS Connector Client
- Processo de Instalação
- Configurações TCC
- Modifique a propriedade -Dtcclient.standalone, onde deverá atribuir o valor true conforme descrito abaixo
- -Dtcclient.standalone=true
- Em seguida, será necessário alterar as propriedades relacionadas ao RabbitMQ. Os valores dessas propriedades devem ser ajustados conforme especificado no item 1: Instalação do RabbitMQ.
- -Dspring.rabbitmq.host=127.0.0.1 \
- -Dspring.rabbitmq.username=guest \
- -Dspring.rabbitmq.password=guest \
- -Dspring.rabbitmq.port=5672 \
- -Dspring.rabbitmq.management-port=15672 \
3. Versão Mínima para Atualização
A versão mínima necessária do TOTVS Agro Mobilidade Manfro, para o processo de atualização, para utilizar o instalador é a 12.1.2512.
PACOTE DE INSTALAÇÃO / ATUALIZAÇÃO
O pacote do instalador do TOTVS Agro Mobilidade Manfro está disponível na Central de Download da TOTVS, o modo de instalação silencioso está disponível a partir da Release 12.1.2512
EXECUÇÃO DO INSTALADOR PADRÃO (GRÁFICO)
PROCESSO DE INSTALAÇÃO PADRÃO
Após realizar o download e extrair o instalador, execute o arquivo install.bat com privilégios de administrador para iniciar o processo de instalação.
O processo de instalação do TOTVS Agro Mobilidade Manfro consiste em XXXXX passos a serem seguidos. Ao iniciar, o usuário deverá selecionar o idioma desejado para prosseguir com a instalação.
Em seguida, selecione os produtos que queira instalar.
- TOTVS Agro Manfro Shared Kernel: Habilita a instalação do produto TOTVS Agro Shared Kernel;
- TOTVS Agro Mobilidade Manfro: Habilita a instalação do produto TOTVS Agro Mobilidade Manfro;
- RabbitMQ: Habilita a instalação do RabbitMQ (Opcional)
Em seguida, será exibida a tela para definições dos diretórios onde os programas serão instalados.
Na próxima etapa, serão configurados os serviços necessários para a aplicação TOTVS Agro Mobilidade Manfro, se foi selecionado para instalação.
Preencha os campos conforme as informações do ambiente onde o sistema será executado:
- Endereço IP: Informe o IP do servidor onde o serviço será executado;
- Porta: Defina a porta de comunicação utilizada pelo serviço;
- Contexto da Aplicação (Ppcional): Caso necessário, especifique o contexto adicional utilizado pela aplicação;
- Nome do Serviço: Insira o nome pelo qual o serviço será identificado;
- Descrição do Serviço: Forneça uma breve descrição para facilitar a identificação e finalidade do serviço;
- Informe qual produto ira se integrar: Selecione qual produto o TOTVS Agro Mobilidade Manfro vai integrar;
- Informe o TCODE: Forneça o TCODE;
- Informe o Client Secret Token: Forneça o Client Secret Token;
- Host do RabbitMQ: Forneça o IP/Host do RabbitMQ;
- Usuário do RabbitMQ: Forneça o usuário que vai conectar no RabbitMQ;
- Senha do RabbitMQ: Forneça a senha que vai conectar no RabbitMQ;
- Porta do RabbitMQ: Forneça a porta do RabbitMQ;
- Informa o virtual host do Rabbit: Forneça o virtual host utilizado no RabbitMQ;
Nesta etapa, podemos configurar no produto TOTVS Agro Mobilidade Manfro, a utilização de certificado SSL, sendo opcional está utilização.
- SSL estará habilitado para conexões HTTPS (Opcional): Utilizará certificado SSL;
- Informe o caminho do keystore: Informe o caminho do keystore/certficado;
- Informe a senha do keystore: Informe a senha do keystore/certificado;
- Informe o tipo do keystore: Informe o tipo do keystore/certificado;
- Informe o alias do keystore: Informe o alias do keystore/certificado;
Nesta etapa, será configurada a conexão com o banco de dados Oracle, necessário para o funcionamento da aplicação. Preencha os parâmetros conforme o ambiente de instalação:
- Base de Dados: Oracle (única opção disponível);
- Tipo de Conexão: escolha entre SID ou Service Name;
- Dialeto da Conexão: selecione a versão correspondente (Oracle12cDialect, Oracle11cDialect ou Oracle10cDialect);
- Servidor (Nome ou IP): informe o endereço do servidor Oracle;
- Porta: defina a porta de comunicação com o banco de dados (padrão: 1521);
- Nome da Base de Dados: informe o nome da instância ou serviço;
- Usuário: usuário autorizado para acesso ao banco;
- Senha: senha correspondente ao usuário informado;
- URL JDBC: endereço de conexão.
Nesta etapa, é necessário informar os dados de integração com o TOTVS Agro Plataforma, que serão utilizados para comunicação entre os sistemas. Preencha os campos conforme suas credenciais de acesso:
- Tcode: código identificador do cliente/serviço no TOTVS Agro Plataforma;
- Email: endereço de e-mail utilizado para autenticação;
- URL: endereço do serviço do TOTVS Agro Plataforma;
- Nome: identificação do serviço ou ambiente configurado.
Nesta etapa, serão exibidos os componentes disponíveis para instalação.
Os seguintes pacotes já vêm selecionados por padrão, sendo obrigatórios para o funcionamento do sistema:
Não é possível desmarcar esses itens.
Após concluir essas etapas, basta aguardar o processo de instalação.
EXECUÇÃO DO INSTALADOR EM MODO SILENCIOSO (NÃO INTERATIVO)
O instalador em modo silencioso visa permitir a instalação automatizada do software sem a necessidade de interação do usuário. Isso facilita a implantação em ambientes corporativos, reduz erros humanos, agiliza o processo e garante consistência nas instalações. Além disso, o modo silencioso é ideal para integrações com scripts e ferramentas de gerenciamento de sistemas.
ESTRUTURA DE ARQUIVOS
Ao finalizar o instalador do TOTVS Agro Mobilidade Manfro, haverá a seguinte estrutura de arquivos.
CONFIGURAÇÃO DE LOGS
SUGESTÕES DE MELHORIAS
Para sugestões de melhorias no processo de atualização, acesse a Central Colaborativa TOTVS