Configuração Automação de Tarefas Datasul - Novo RPW

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

Editar o arquivo "/service/Windows/install.bat"

:default
@echo on

chcp 65001

set JAVA_HOME=C:/Java/jdk-11 
set TASKMANAGER_HOME=C:/TOTVS/TaskManager

mkdir "%TASKMANAGER_HOME%/log"

JavaService.exe -install "TOTVS TaskManager-RPW" "%JAVA_HOME%/bin/server/jvm.dll" -path %JAVA_HOME%/bin
-Djava.class.path="%TASKMANAGER_HOME%/lib/TaskManager.jar" -Xms32m -Xmx64m -start org.springframework.boot.loader.JarLauncher -current %TASKMANAGER_HOME% -manual -description "Serviço para a execução do RPW em AppServer"

@echo off

:eof

@echo .
@echo .
@echo .
PAUSE.

Instalação do serviço:

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

Editar o arquivo "/service/Windows/uninstall.bat"

• Informe o nome do serviço definido na etapa anterior (Instalador de serviço para Windows)

Desinstalação do serviço:

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

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

   PATH_JAR=/usr/local/TaskManager/
   PID_PATH_NAME=/usr/local/TaskManager/TaskManager-pid
   nohup java -jar $PATH_TO_JAR &

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

   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

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

   sudo vi /etc/systemd/system/TaskManager.service

2.  Conteúdo do arquivo TaskManager.service

   [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

   PATH_JAR=/usr/local/TaskManager/
   PID_PATH_NAME=/usr/local/TaskManager/TaskManager-pid
   nohup java -jar $PATH_TO_JAR &

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

   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)

   /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

Altere o arquivo application.properties e informe as propriedades appserver_url e server.port conforme exemplo abaixo, demais propriedades já possuem valores padrões que podem ser ajustados conforme a necessidade

appserver_url=AppServer://localhost:5162/Broker10
server.port=1095
refresh_interval=10
logging.file.name=log/taskmanager.log
logging.file.max-size=100MB

• appserver_url: Deve ser preenchido com o nome do servidor de aplicação que atenderá as requisições do orquestrador. Pode ser preenchido com informação de um servidor de aplicação já utilizado no ERP. 
• server.port: Porta que será utilizada para subir o serviço. Esta propriedade é opcional, e caso não seja preenchida será assumida a porta padrão 8080.
• refresh_interval: Esta propriedade indica o intervalo em segundos que o orquestrador fará a verificação se existem novos pedidos a serem executados. Esta propriedade é opcional, e caso não seja preenchida será assumido o valor padrão de 10 segundos. 
• logging.file.name: Sub-diretório de geração dos logs, com base no diretório raiz onde foi instalado o TaskManager. Ex: C:\totvs\TaskManager.
• logging.file.max: Limite de tamanho de cada arquivo de log, após alcançar o limite é criado um novo arquivo. Arquivos de logs anteriores são mantidos no diretório.

No Automação de Tarefas Datasul 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 ao menos um broker para cada empresa existente no ERP. 

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

Sugere-se que os brokers criados sejam criados com a configuração de Pool Range - Minimum servers com valor 0 (zero). Desta forma, não ficarão agents no ar quando não houver pedidos em execução.

Para começar a utilizar o Automação de Tarefas Datasul, é necessário habilitar o uso através de uma propriedade, para isso:

• Acesse o Datasul
• Acesse o programa propriedades-rpw
• Marque como ativo a propriedade 'Habilita Automação de Tarefas Datasul'
• Salve a alteração realizada

Após fazer isso, os pedidos não serão mais executados através do programa btb908za, somente através do Automação de Tarefas Datasul. Porém é possível desabilitar essa configuração caso seja necessário.

• Acesse o Datasul
• Acesse o programa btb962aa

Os passos a seguir devem ser feitos para todas empresas cadastradas no 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 deste servidor e revisando as informações preenchidas na migração (selecione o botão 'Config. RPW) para ver algumas configurações específicas.
• Caso os registros não existam, será necessário criar novos registros, instruções detalhadas podem ser encontradas em Cadastro de servidores

Caso no passo anterior tenha sido utilizado os servidores criados pela migração, os pedidos de execução existentes já serão direcionados para os brokers criados para a execução de pedidos através do Automação de Tarefas Datasul. 

Caso tenham sido criados novos servidores com código diferentes, será necessário criar novos pedidos de execução para os pedidos pendentes utilizando o código dos novos servidores criados.