Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 6

changes.mady.by.user Haidi Carolina Baumer Branco

Gravado em

comparado com

Nova versão 7

changes.mady.by.user Haidi Carolina Baumer Branco

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

CONTEÚDO

  1. Visão Geral
  2. Objetivo
  3. Pré-requisito
  4. Instalação
  5. Configuração
  6. Novidades


01. VISÃO GERAL



02. Objetivo

Esta documentação tem a finalidade de servir como uma guia no momento da migração do RPW padrão para o Novo RPW (Task Manager). 


03. Pré-requisito

  • Datasul versão 12.1.2205 ou superior
  • Java 11


04. Instalação

Copiar arquivo compactado

O arquivo está localizado no diretório do Foundation fnd/interfac/TaskManager/TaskManager.zip.

Extrair os arquivos do arquivo compactado

Expandir
titleProcedimento

Extrair os arquivos em um diretório de sua escolha. 

Exemplo: "C:/TOTVS/TaskManager"

Como resultado obtém-se a estrutura abaixo:

  • C:\TOTVS\TaskManager\application.properties
  • C:\TOTVS\TaskManager\README.txt
  • C:\TOTVS\TaskManager\lib\TaskManager.jar
  • C:\TOTVS\TaskManager\service\Linux\taskmanager
  • C:\TOTVS\TaskManager\service\Linux\TaskManager.sh
  • C:\TOTVS\TaskManager\service\Windows\install.bat
  • C:\TOTVS\TaskManager\service\Windows\JavaService.exe
  • C:\TOTVS\TaskManager\service\Windows\uninstall.bat

Instalador de serviço para Windows

Expandir
titleProcedimento

Criar uma variável de ambiente TASKMANAGER_HOME, a variável deve apontar para o diretório onde foi realizado a descompactação.

Exemplo:

Image Modified

Instalação do serviço:

  • Execute Prompt de Comando como administrador
  • Execute o arquivo "TaskManager/service/Windows/install.bat"

Desinstalador de serviço para Windows

Expandir
titleProcedimento

Desinstalação do serviço:

  • Execute Prompt de Comando como administrador
  • Execute o arquivo "TaskManager/service/Windows/uninstall.bat"

Instalador de serviço para Linux

Expandir
titleProcedimento - Linux Java Service Wrapper
  1. Copiar o arquivo TaskManager/service/Linux/taskmanager em /etc/init.d/

  2. Modificar as linhas abaixo do arquivo TaskManager/service/Linux/taskmanager caso seja alterado o diretório do .jar

    Bloco de código
    PATH_JAR=/usr/local/TaskManager/
PID_PATH_NAME=/usr/local/TaskManager/TaskManager-pid
nohup java -jar $PATH_TO_JAR >> /usr/local/TaskManager/log/TaskManager.out 2>&1&
  3. Conceder permissões caso ainda não estja configurado:
Bloco de código
 - sudo chmod +x /etc/init.d/taskmanager


  • Comandos para testes
      - Runs:      sudo service taskmanager start
      - Stops:     sudo service taskmanager stop
      - Restarts: sudo service taskmanager restart
Expandir
titleProcecedimento - Ubuntu 16+ Java Service Wrapper

Ubuntu 16+ Java Service Wrapper

  1. Criar um arquivo em /etc/systemd/system/ 

    Bloco de código
    sudo vi /etc/systemd/system/TaskManager.service

  2.  Conteúdo do arquivo TaskManager.service

    Bloco de código
    [Unit]
Description = TaskManager Java Service
After network.target = TaskManager.service

[Service]
Type = forking
ExecStart = /usr/local/bin/TaskManager.sh start
ExecStop = /usr/local/bin/TaskManager.sh stop
ExecReload = /usr/local/bin/TaskManager.sh reload

[Install]
WantedBy=multi-user.target

  3.  Copiar o arquivo TaskManager/service/Linux/TaskManager.sh em /usr/local/bin/ 

  4.  Modificar as linhas abaixo caso seja alterado o diretório do .jar

    Bloco de código
    PATH_JAR=/usr/local/TaskManager/
PID_PATH_NAME=/usr/local/TaskManager/TaskManager-pid
nohup java -jar $PATH_TO_JAR >> /usr/local/TaskManager/log/TaskManager.out 2>&1&

  5.  Conceder permissões caso ainda não esteja configurado

    Bloco de código
    sudo chmod +x /usr/local/bin/TaskManager.sh

  6. Criar o diretório de log (alterar o caminho caso a instalação seja em outro local)

    Bloco de código
    /usr/local/TaskManager/log


Comandos para testes

  -
  • Runs:        /usr/local/bin/./TaskManager.sh start
  -
  • Stops:       /usr/local/bin/./TaskManager.sh stop
  -
  • Restarts: /usr/local/bin/./TaskManager.sh restart
  • Habilitar o serviço: sudo systemctl enable TaskManager
  • Iniciar o serviço:     sudo systemctl start TaskManager.service
  • Parar o serviço:      sudo systemctl stop TaskManager.service

Desinstalador de serviço para Linux


04. Configuração


Arquivo de configuração

Arquivo de configuração application.yml.

Utilizando a pasta de exemplo dos passos anteriores, podemos encontrar o arquivo em: "/client/application.yml"



Criação dos brokers 

Expandir
titleProcedimento

No Task Manager os pedidos serão executados em brokers específicos para o RPW, por isso é necessário que esses brokers sejam criados para que no próximo passo seja possível fazer o vínculo de Servidor x Broker. 

Deve ser criado um broker para cada empresa existente no ERP. 

Link para documentação de como criar um appserver.

Criar/alterar servidor de execução

Expandir
titleProcedimento
  • Acesse o programa btb962aa
  • Selecione a aba 'Servidores'
  • No momento da migração, são criados automaticamente servidores do Novo RPW para todos os servidores que já existiam na base e não possuíam relação com nenhuma empresa. Por isso, podem aparecer alguns registros já criados com o aplicativo definido 'RPW'
  • Caso já existam os registros, é necessário apenas alterá-los, preenchendo o campo "Servidor de aplicação" com o valor do nome do servidor que será responsável pela execução dos pedidos de execução e revisando as informações existentes
  • Caso os registros não existam, será necessário criar novos registros, instruções detalhadas podem ser encontradas em Cadastro de servidores