Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 5

changes.mady.by.user Haidi Carolina Baumer Branco

Gravado em

comparado com

Nova versão 6

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

  • Versão 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:

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

taskmanager
  • Conceder permissões caso ainda não estja configurado:
    • 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
    title
    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&
    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

    [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


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

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

    • 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
    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&

  •  Conceder permissões caso ainda não esteja configurado

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

  • 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

    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