PHSYS - Wiki

Conceito

O servidor de aplicação suporta a utilização de diversas bases de dados, responsáveis por armazenar as informações do sistema. Cada base de dados é cadastrada no ServerConf com o banco de dados em que está, o diretório do sistema e os limites de uso de conexões e de registros.

O que é

É a tela Bases de Dados, disponível no menu lateral do ServerConf, onde é realizado o cadastro das bases, possibilitando adicionar os sistemas com os respectivos bancos de dados utilizados. Para cadastrar uma nova base de dados, deve ser selecionado o botão Nova Base de Dados; após, é aberto um formulário para preencher as informações necessárias, sendo necessário confirmar o cadastro pelo botão Salvar.

A mesma tela acompanha cada base: a situação da versão, os processos em andamento, os usuários conectados e a atualização do sistema.

Para que serve

Serve para definir quais bases de dados o servidor de aplicação atende e como cada uma é acessada, e para acompanhar e atualizar essas bases sem precisar entrar em cada uma delas.

Quais os benefícios e/ou ganhos de uso

• Atende várias bases de dados, em bancos de dados diferentes, pelo mesmo servidor de aplicação.
• Ajusta por base de dados o pool de conexões e os limites de registros das consultas e das grades.
• Mostra quais bases estão com a versão em dia e quais aguardam a atualização do sistema.
• Atualiza o sistema de uma ou de várias bases de uma vez, com o andamento acompanhado na própria tela.
• Mostra os usuários conectados e as licenças em uso, permitindo desconectar uma sessão.

Quando as alterações passam a valer

As alterações no cadastro das bases de dados passam a valer somente após reiniciar o serviço do servidor de aplicação.

Situação da versão

A coluna Versão da grade compara a versão da base de dados com a versão recebida no Diretório Instalação, na pasta bin:

• Em dia: a base de dados está na versão recebida.
• Pendente: a versão recebida é mais nova que a da base de dados. Enquanto a atualização do sistema não roda, somente o desenvolvedor da PH Sys entra na base; os demais usuários recebem o aviso de que a base aguarda a atualização do sistema.
• Sem versão: o diretório de instalação não está informado ou não contém a versão recebida.

Atualização do sistema

A opção Atualizar sistema importa a versão recebida e atualiza a base de dados. Ela vale para uma base ou para várias bases marcadas na grade, e considera somente as bases ativas com versão recebida; as demais marcadas ficam de fora, informadas na confirmação.

• Cada base atualiza em um processo próprio, e as bases marcadas atualizam ao mesmo tempo.
• Enquanto atualiza, a base de dados fica bloqueada e os usuários conectados são desconectados.
• A atualização entra na base com o Usuário da atualização do cadastro. A empresa e a filial dele valem durante a atualização.
• A base de dados cuja atualização termina com erro continua bloqueada para os usuários; somente o desenvolvedor da PH Sys entra, para corrigir e atualizar novamente.
• A base com atualização em andamento responde com o processo existente, sem iniciar outra.

Acompanhamento dos processos

Nas bases de dados ativas, o ícone da coluna Processos mostra a última atualização: neutro quando concluída ou sem atualização, laranja girando durante a atualização e vermelho quando terminou com erro. O clique no ícone abre o acompanhamento dos processos da base:

• À esquerda, os processos do período, que por padrão é o dia atual, separados em Em andamento, Com erro e Concluídos; os processos em andamento aparecem qualquer que seja a data de início. A opção Mostrar concluídos exibe ou oculta os concluídos.
• À direita, o log do processo escolhido, com o percentual, a busca no log e a opção Só erros e avisos. As linhas novas aparecem enquanto o processo roda.
• Os processos terminados podem ser excluídos com o log, um a um ou pelo Excluir todos do grupo.
• O processo que ficou em andamento pela queda do serviço pode ser encerrado como erro pelo botão Encerrar processo interrompido.

Sessões e licenças

A sessão do usuário fica aberta enquanto há comunicação com o servidor, e o PHERP avisa o servidor periodicamente enquanto está aberto. A sessão sem comunicação por mais de 3 minutos, como quando o programa ou o navegador é fechado, a rede cai ou o computador é suspenso, é encerrada, e a licença volta a ficar disponível. O PHERP desktop e o PHApp retomam a sessão automaticamente na próxima requisição, quando há licença disponível; no PHERP web, o usuário volta para a tela de login.

Exemplos

• Nova versão do sistema recebida: as bases passam a Pendente na coluna Versão. Marcar as bases na grade e escolher Atualizar sistema atualiza todas de uma vez, com o andamento acompanhado pelo ícone da coluna Processos.
• Usuário sem conseguir entrar por falta de licença: a opção Usuários Conectados mostra as sessões abertas e as licenças em uso, e permite desconectar a sessão esquecida aberta.
• Base de dados nova em outro servidor de banco: cadastrar o servidor de banco, cadastrar a base informando esse servidor e usar Testar Conexão antes de liberar o acesso.
• Base de testes com os dados da produção: a opção Copiar Base de Dados a partir da base de produção, com Excluir Registros da Base de Dados de Destino marcado, deixa a base de testes igual à de produção.
• Lentidão por falta de conexões: quando o log do servidor avisa conexões criadas fora do pool de uma base, aumentar o Pool de Conexões dela.

Cadastro

Campo	Finalidade
Código	Identificação numérica da base de dados.
Nome	Nome da base de dados.
Legenda	Legenda da base de dados.
Ativo	Situação da base de dados. Inativa, a base de dados não é acessada pelo sistema.
Servidor de Banco	Servidor de banco de dados utilizado para a conexão com a base de dados. Sem nenhum cadastrado, é necessário realizar o cadastro.
Diretório Instalação	Diretório em que o sistema está instalado no servidor de aplicação. A versão recebida do sistema fica na pasta bin desse diretório.
Pool de Conexões	Número máximo de conexões no pool de conexões da base de dados. Com todas em uso, a requisição é atendida por uma conexão avulsa, e o log do servidor registra um aviso para aumentar este valor. Com o valor zero, a base de dados não utiliza pool, e cada conexão é fechada ao término da requisição.
Minutos Permanência Pool	Tempo, em minutos, que uma conexão sem uso permanece no pool antes de ser fechada.
Máximo Registros de Consulta em Campos	Número máximo de registros retornados nas consultas dos campos de lista.
Máximo Registros Grade	Número máximo de registros retornados nas grades do sistema.
Data Base	Nome da base de dados junto ao banco de dados.
Usuário da atualização	Usuário do ERP com que a atualização do sistema entra na base de dados. Vazio utiliza o usuário PH.
Agendamento	Marcado, o serviço executa os processos agendados desta base de dados, distribuindo as execuções entre os subprocessos de execução dos agendamentos definidos nas Configurações.

Grade e ações

A grade apresenta o código, o nome, a legenda, se a base de dados está ativa e executa agendamentos, a situação da versão e o ícone dos processos. Cada base de dados possui as ações de editar e excluir e, pelo botão Ações, as opções abaixo. Com várias bases marcadas, o botão Ações apresenta somente Atualizar sistema.

Opção	Finalidade
Atualizar sistema	Importa a versão recebida e atualiza as bases de dados escolhidas, conforme a seção Atualização do sistema.
Usuários Conectados	Lista as sessões conectadas à base de dados, com usuário, IP, computador, sistema, versão, sessão e data/hora de início, permitindo desconectar uma sessão. A versão é a do PHERP desktop ou do PHApp que abriu a sessão, e no PHERP web o computador é identificado pelo navegador e pelo sistema operacional. O rodapé informa a quantidade de usuários conectados e as licenças utilizadas do PHERP e do PHApp. No PHERP, cada usuário ocupa uma licença por computador com o PHERP desktop aberto, e no mínimo uma, que também atende o uso no PHERP web.
Processos	Lista os processos da base de dados no período informado.
Testar Conexão	Verifica se o servidor de aplicação consegue se conectar ao banco de dados da base.
Copiar Base de Dados	Copia os registros de todas as tabelas da base de dados de origem para a base de dados de destino selecionada. Com a opção Excluir Registros da Base de Dados de Destino marcada, os registros existentes no destino são excluídos antes da cópia.

Conclusão

As Bases de Dados concentram no ServerConf o cadastro, a situação da versão e a atualização de cada base atendida pelo servidor de aplicação. Com a coluna Versão e o ícone de processos, fica visível quais bases precisam de atenção, e a atualização de várias bases é feita de uma só vez, sem entrar em cada uma delas.