agCAP – Controle de Atualizações do Protheus

Versão 1.1

MANUAL DE UTILIZAÇÃO

O que é o agCAP?

O agCAP nasceu da necessidade que eu tinha para atualizar o Protheus na empresa onde trabalho, temos várias

customizações que precisam ser compiladas diariamente, e temos vários serviços no Windows e vários RPOs, ficar

parando serviço por serviço, e atualizar RPO por RPO era trabalhoso, então resolvi criar o agCAP para facilitar este

processo, usamos aqui na empresa e me ajuda muito, então resolvi compartilhar este programa com todos, o agCAP

possui versão Windows e versão Android, lembrando que para usar a versão Android é necessário ter a versão Windows

configurada, usando a versão Android você terá acesso as funcionalidades da versão Windows, só que de qualquer lugar

que você estiver.

Obrigado por fazer o download do agCAP.

Visite o meu site e faça seu cadastro é rápido e gratuito, e você ficará por dentro das novidades do agCAP.

www.alexandre-goncalves.com

Veja abaixo como utilizar o programa.

INSTALAÇÃO:

Sugestão de instalação: Crie uma pasta chamada agCAP dentro do mesmo servidor que contêm os repositórios

que serão atualizados, os seguintes arquivos deverão estar dentro desta pasta agCAP.

Caso queira fazer backup da configuração do agCAP, faça cópia do arquivo .SQL3 (banco de dados).

Os arquivos DLL´S e OCX são necessários para comunicação com o banco de dados, servidores de e-mails e o

Protheus por isso precisam estar na mesma pasta.

E abrirá a tela para as configurações necessárias, são elas:

SERVIÇOS:

Nesta seção, você deverá cadastrar todos os serviços do Windows envolvidos com o Protheus.

Utilize o nome do serviço registrado no Windows e não o nome de exibição ou descrição, essa configuração fica

dentro do .INI do seu server.

Veja no exemplo acima, o nome do serviço é .Totvs1

Ou abra a lista de serviços do Windows e clique em propriedades do serviço para ver o nome real que foi instalado.

Os serviços serão parados e iniciados respeitando a ordem cadastrada aqui, e não esqueça de cadastrar também

o nome do executável (.exe) pois no caso do serviço ficar travado, o agCAP irá forçar o encerramento do processo

automaticamente.

Se você usa balanceamento, é necessário renomear o executável (.exe) de cada balanceamento, não pode haver processos (.exe) com o mesmo nome iniciados no Windows, senão todos serão encerrados ao mesmo tempo sem respeitar a ordem cadastrada.

Exemplo: TotvsAppServerLicense.exe / TotvsAppServerMaster.exe / TotvsAppServer1.exe / TotvsAppServer2.exe Os campos domínio\usuário e senha são obrigatórios para acessar os serviços/processos (.exe) do Windows, o

usuário precisa ter permissão de administrador.

Quando você cadastrar um novo serviço o campo ATIVO é automaticamente colocado como SIM ( ) caso

queira desativar algum serviço clique no ícone e ele irá alterar para NÃO ( ).

Os serviços que estiverem desativados, o agCAP irá ignorá-los quando iniciar a atualização.

Após cadastrar os serviços, clique em Salvar Serviços, para gravar as informações.

REPOSITÓRIOS:

Nesta seção você tem que cadastrar todos os RPO que são utilizados no Protheus e que serão atualizados. Você precisa de um RPO (origem) onde só as equipes de programadores terão acesso, onde seus programas serão compilados a qualquer hora do dia, pois ninguém estará usando. No dia e horário agendado, o agCAP irá parar todos os serviços e processos, depois irá copiar os arquivos de (origem) para os arquivos de (destino), e por último irá iniciar todos os serviços novamente. Caso queira fazer uma cópia de segurança antes da cópia, deixe marcada a opção de fazer backup, assim o arquivo de destino não é substituído. Para os backups não ficarem ocupando muito espaço em disco, marque a opção deletar backup e configure um número de dias que será mantido de backup. Após cadastro, clique em Salvar Repositórios.

AGENDAMENTO:

Aqui você pode agendar os dias e o horário que a atualização será iniciada. Para ativar ou desativar, clique no botão correspondente. Marque a opção ativar automaticamente, caso queira que o agendamento se inicie quando entrar no agCAP. Após ativar a atualização, o sistema ficará em execução na área de notificação do Windows, aguardando pra

iniciar a atualização. Após cadastro, clique em Salvar Agendamento.

HISTÓRICO:

Nesta seção você poderá manter um histórico das atualizações que foram feitas no Protheus.

Após cadastro, clique em Salvar Histórico.

LOG:

Aqui ficará todo os logs de atualizações do sistema, você pode utilizar os botões mostrar hoje ou mostrar tudo

para controlar o que será visto ou clicar em Limpar LOG para excluir os registros.

REMOTO:

Nesta seção você irá configurar uma porta e os usuários que terão acesso externo usando o agCAP versão

Android. Após cadastro, clique em Salvar Remoto.

EMAIL:

Nesta seção você irá configurar um servidor smtp, para envio de e-mails.

Você receberá um email de log, depois de cada atualização, na conta do email informado.

E tem opção para definir um horário e enviar um email de alerta para algum email, ou grupo de emails.

No meu caso eu cadastrei um grupo de email da filial 01 e da 02, e esse grupo de emails é disparado para todos

os usuários das filiais. Após cadastro, clique em Salvar Email.

MONITOR:

Nesta seção você pode configurar um usuário, senha e ambiente Protheus, para que o agCAP acesse o Protheus

e receba informações de usuários conectados, possibilitando enviar mensagens de alerta ou derrubar os usuários.

Você pode também agendar um horário para envio de um alerta automático antes da atualização para todos os

usuários conectados no Protheus.

Poderá também agendar um horário para derrubar todos os usuários conectados e bloquear o acesso do

sistema, até o final da atualização.

Após cadastro, clique em Salvar Monitor.

Depois de fazer o cadastro em todas as seções e ativar o agendamento, basta minimizar o aplicativo e ele ficará na área

de notificação do Windows, aguardando para ser executado.

Mais uma vez, obrigado por fazer o download do agCAP.

Visite o meu site e faça seu cadastro é rápido e gratuito, e você ficara por dentro das novidades do agCAP.

www.alexandre-goncalves.com

Caso ainda resta dúvida na configuração, ou tem alguma sugestão ou bug, acesse o site e deixe seu recado.

www.alexandre-goncalves.com/duvidas-sugestoes-bugs/