DPServer - Serviço

📖 MANUAL DE DEPLOY E ATUALIZAÇÃO: Matriz de Responsabilidades (dpServer)

Este documento define claramente o escopo de atuação da equipe de Desenvolvimento e da equipe de Atendimento/Suporte no processo de geração de versões, instalação e atualização do serviço dpServer.

💻 1. ESCOPO DO DESENVOLVIMENTO

1.1. Alteração da Versão do Executável (Assembly)

• Incrementar o número da versão física do arquivo sempre que houver modificações.
• Como fazer: No Visual Studio, acesse as propriedades do projeto dpServerService -> Aba Aplicativo -> Botão Informações do Assembly... -> Incremente a Versão do assembly e Versão do arquivo (Ex: 1.0.0.0 para 1.1.0.0).

  

• Nota: Nunca utilize a aba "Publicar" (ClickOnce), pois o serviço não lê essa numeração.

1.2. Compilação em Modo Release

• Alterar o seletor do Visual Studio de Debug para Release e executar o comando Recompilar Solução (Rebuild Solution) dos dois projetos.

1.3. Compilação e Geração do Instalador (.msi)

Separar apenas os arquivos necessários para a atualização e disponibilizá-los para a equipe de Atendimento.

O projeto possui um projeto de Setup integrado (usando Microsoft Visual Studio Installer Projects).

1. Na janela do Solution Explorer, localize o projeto de instalação (dpServerService.Setup) .
2. Clique com o botão direito sobre o projeto dpServerService.Setupe selecione Compilar (Build) ou Rebuild.
3. O Visual Studio gerará os arquivos de instalação na pasta de saída do setup.
4. Navegue até a pasta física do projeto de setup (Ex: ...\dpServerService.Setup\Release\) e copie o arquivo dpServerService.Setup.msi (e o setup.exe se houver).
5. Disponibilize estes arquivos para a equipe de Atendimento.

⚠️ REGRA: NUNCA inclua o arquivo dpServerService.exe.config (App.Config) no pacote de atualização. O envio deste arquivo destrói as configurações customizadas do cliente, pois é lá que fica configurado o caminho dos arquivos de atualização.

🛠️ 2. ESCOPO DO ATENDIMENTO / SUPORTE

O Atendimento é responsável pela implantação no servidor do cliente, configuração dos ambientes, parametrização dos arquivos locais e aplicação de atualizações enviadas pelo desenvolvimento.

2.1. Primeira Instalação e Configuração do Ambiente

• O que fazer: Instalar o serviço e parametrizar o arquivo (dpServerService.exe.config) de configuração de acordo com a realidade de cada cliente.
• Como fazer: 1. Executar o instalador .msi padrão no servidor do cliente.

Clique em avançar:

Escolha o caminho de instalação e clique em avançar:

Clique em avançar:

Aguarde a instalação concluir e clique em fechar.

• 2. Abrir o arquivo dpServerService.exe.config com o Bloco de Notas na pasta de instalação C:\Program Files (x86)\...\dpServerService.Setup.
• 3. Configurar a chave CaminhoArquivos apontando para a pasta raiz acordada (Ex: value="C:\DpServer\").

  

• 4. Verificar se as credenciais do email estão corretas.

2.2. Gestão do Arquivo DpSettings.xml

• O que fazer: Garantir que o arquivo de conexão com o banco de dados esteja no local correto determinado pela configuração (Deve ser disponibilizado na pasta de instalação).

Como fazer: Copiar o arquivo DpSettings.xml do cliente e colá-lo dentro da pasta raiz configurada na chave CaminhoArquivos (Ex: dentro de C:\DpServer\).

2.3. Iniciando o serviço.

Primeira Instalação: > Após concluir as configurações nos arquivos (incluindo o DpSettings.xml), será necessário iniciar o serviço do Windows. Siga os passos abaixo:

1. Pressione Win + R, digite services.msc e pressione Enter.
2. Procure pelo serviço dpServer (caso não o encontre, clique em "Atualizar").
3. Clique em Iniciar.
4. Certifique-se de que o status na coluna correspondente mudou para "Em execução".

   

2.4. Aplicação de Atualizações (Update de Versão)

• Certificar-se de que a subpasta Atualizacao existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: C:\DpServer\Atualizacao).
• Pegar os arquivos liberados pelo desenvolvimento (.exe e .dlls) e colá-los dentro dessa pasta \Atualizacao.
• O serviço detectará os arquivos novos, fará a substituição e reiniciará de forma 100% automatizada em até 5 minutos.

🔍 3. GUIA DE RESOLUÇÃO DE PROBLEMAS

Se a atualização falhar ou o serviço não iniciar, o Atendimento deve seguir este roteiro de checagem:

O serviço não atualizou automaticamente?

• Causa 1: Os arquivos foram colocados na pasta errada. Certifique-se de que estão dentro da subpasta \Atualizacao.
• Causa 2: O Desenvolvimento esqueceu de mudar a versão do Assembly. Abra as propriedades do arquivo .exe enviado pelo Dev, vá na aba Detalhes e verifique se a versão é realmente maior do que a que já está rodando.

  

Onde verificar o que aconteceu?

1. Logs do dpServer: Para visualizar os logs, basta dar um duplo clique sobre o ícone de status.:

   

2. No arquivo de texto: Abra o arquivo dpServerApp.log localizado diretamente na pasta raiz configurada do cliente

   

3. E-mail de avisos: Diferente dos outros logs, o log de e-mail será enviado somente quando ocorrerem erros no processamento: