Pular para o conteúdo principal

Requisitos de Infraestrutura para a instalação do e-SUS APS

Esta etapa trata do fornecimento da infraestrutura tecnológica necessária para sustentar o ambiente do e-SUS APS, seja em servidores próprios ou em soluções de computação em nuvem.

Nela, definem-se os requisitos fundamentais do sistema, tais como hardware, sistema operacional, banco de dados e outras parametrizações.

Servidores locais ou em nuvem​

Os servidores do e-SUS APS (aplicação e banco de dados) podem ser instalados de duas formas:

  • Servidores locais (próprios): equipamentos físicos mantidos pelo próprio ente, em sala de servidores ou datacenter próprio;
  • Servidores em nuvem: recursos computacionais contratados de um provedor de computação em nuvem, acessados pela internet e pagos conforme o uso.

Servidores locais​

Nesse modelo, o ente tem controle direto sobre os equipamentos e os dados. Em contrapartida, assume toda a responsabilidade pela infraestrutura física: aquisição e substituição dos servidores, rede elétrica dimensionada, dispositivos de continuidade de energia (no-break/UPS), climatização da sala, proteção contra incêndio, controle de acesso físico, além da manutenção do hardware e da capacidade de crescimento conforme o aumento de usuários.

Servidores em nuvem​

A computação em nuvem é definida como um modelo que permite o acesso pela rede, sob demanda, a um conjunto compartilhado de recursos computacionais configuráveis, que podem ser rapidamente provisionados e liberados com mínimo esforço de gestão (MELL; GRANCE, 2011). Para a instalação do e-SUS APS, esse modelo traz benefícios importantes:

  • Elasticidade e escalabilidade: os recursos de processamento, memória e armazenamento podem ser ampliados ou reduzidos rapidamente, inclusive de forma automática, acompanhando o crescimento do número de usuários simultâneos;
  • Alta disponibilidade: os provedores operam datacenters com redundância de energia, refrigeração e conectividade, reduzindo o risco de indisponibilidade do sistema;
  • Infraestrutura física sob responsabilidade do provedor: questões como rede elétrica, no-breaks, geradores, climatização, combate a incêndio e segurança física das instalações deixam de ser responsabilidade direta do ente;
  • Segurança da informação: os provedores contam com controles de segurança e auditorias independentes. No âmbito da administração pública federal, a Instrução Normativa GSI/PR nº 5/2021 estabelece requisitos mínimos de segurança para o uso de nuvem, como criptografia, segregação dos dados, recuperação de desastres e hospedagem dos dados em território nacional, servindo como boa referência também para estados e municípios;
  • Pagamento conforme o uso: o custo acompanha os recursos efetivamente utilizados, evitando investimentos antecipados em equipamentos que podem ficar subutilizados ou obsoletos.
atenção

Mesmo em nuvem, o ente continua responsável pela gestão do ambiente do e-SUS APS e pelos dados dos cidadãos, conforme a Lei Geral de Proteção de Dados (LGPD) (ver item Proteção de dados pessoais e segurança da informação, na página Orientações Gerais). Por isso, recomenda-se:

  • Exigir em contrato que os dados sejam hospedados no Brasil, com cláusulas de confidencialidade, níveis mínimos de serviço e devolução e exclusão dos dados ao final do contrato;
  • Garantir que as Unidades de Saúde tenham conexão de internet estável e adequada, já que todo o acesso ao sistema passa a depender dela;
  • Manter rotinas de backup também sob controle do ente, além das oferecidas pelo provedor.

Acesso externo à instalação: IP público e domínio​

Para que o e-SUS APS seja acessado pelas Unidades de Saúde e pelos profissionais fora da rede local do servidor, a instalação precisa estar disponível externamente. Esse acesso pode ocorrer de duas formas:

  • IP público: o servidor de aplicação recebe um endereço IP público, fornecido pelo provedor de internet ou pelo provedor de nuvem, e o sistema é acessado pelo endereço http://IP-PUBLICO:8080 (exemplo: http://191.35.23.52:8080). Recomenda-se que o IP público seja fixo, pois a alteração do IP exige a atualização do endereço da instalação e de todos os acessos que dependem dele;
  • Domínio: um nome de domínio é apontado para o IP público da instalação, permitindo o acesso por um endereço próprio, como https://esusaps.municipio.uf.gov.br. O acesso por domínio é fortemente recomendado, pois é pré-requisito para a habilitação do HTTPS e, consequentemente, para funcionalidades como Integração CADSUS, Videochamada, Prescrição e Atestado Digitais e Autorizações do Programa Dignidade Menstrual (ver página Habilitações).

Quando for utilizado um domínio, é fortemente preferencial que ele seja um subdomínio gov.br do próprio ente, como esusaps.municipio.uf.gov.br. Esse tipo de endereço reforça a identidade institucional do serviço e transmite mais segurança e confiança aos profissionais e aos cidadãos.

atenção

Conforme a Portaria SGD/MGI nº 7.076, de 2 de outubro de 2024, em seu art. 3º, "para realizar a solicitação de integração à Conta gov.br [...], é imprescindível que o sistema a ser integrado esteja hospedado em um domínio oficial de governo", ou seja, domínios com final GOV.BR. Desta forma, apenas as solicitações de integração que atendam a essa premissa receberão chaves de produção para a conclusão da integração, o que impacta diretamente a habilitação do Login GOV.BR no e-SUS APS (ver página Habilitações). Vale destacar que a mesma Portaria, em seu parágrafo único, alerta que "os órgãos que não estiverem em conformidade com o disposto [...] terão o prazo de um ano, a partir da publicação desta Portaria, para se adequarem, sob pena de revogação das credenciais de acesso".

O subdomínio pode ser solicitado ao responsável pela administração do domínio da prefeitura ou do estado (por exemplo, o setor de Tecnologia da Informação), desde que a instalação já esteja disponível via IP público, pois o domínio será configurado (apontado) para esse endereço.

dica

Sequência recomendada: 1) disponibilizar a instalação via IP público, preferencialmente fixo; 2) solicitar ao administrador do domínio da prefeitura ou do estado a criação do subdomínio gov.br apontado para esse IP; 3) habilitar o HTTPS na instalação (ver página Habilitações). O endereço definido deverá ser informado no campo Link da minha instalação, na Etapa 3 da página Instalação, Configuração e Ativação.

Sistema Operacional​

O e-SUS APS foi criado para ser compatível com diversas plataformas, permitindo sua instalação em variados sistemas operacionais, incluindo distribuições Linux (software livre sem nenhum custo de licença ou de aquisição).

No momento, existem instaladores disponíveis especificamente para as seguintes plataformas, que funcionam apenas na arquitetura x64 (64 bits):

Linux​

Alt ou título da imagem

Distribuições e versões mínimas recomendadas (com atualizações ainda disponibilizadas pelo desenvolvedor):

  • Ubuntu Server LTS (versão 22.04 ou superior)
  • Debian (versão 12 ou superior)
  • Red Hat Enterprise Linux (versão 8 ou superior)
  • CentOS Stream (versão 10 ou superior)

Microsoft Windows​

Alt ou título da imagem

Versões mínimas recomendadas (com suporte e atualizações disponibilizados pela Microsoft):

  • Versão Server: 2019 ou superior
  • Versão Desktop/Cliente: Windows 11 ou superior

Versões mínimas compatíveis com o instalador (não recomendadas):

  • Versão Server: 2008 R2 ou superior
  • Versão Desktop/Cliente: Windows 7 ou superior
atenção

Versões anteriores às mínimas recomendadas não recebem mais atualizações de segurança da Microsoft, ou deixarão de recebê-las em breve, e não são recomendadas. Utilize-as somente em caráter temporário, planejando a migração para uma versão com suporte.

Banco de dados​

Por padrão, o e-SUS APS vem com o banco de dados PostgreSQL na versão 9.6 (mínima recomendada). Esse banco de dados é adequado tanto para instalações descentralizadas (servidores locais nas Unidades de Saúde) quanto para instalações centralizadas (única instalação no Município). Sendo um software livre, o PostgreSQL não envolve custos de licença ou de aquisição. Para obter mais detalhes sobre o PostgreSQL, clique aqui.

Também é possível utilizar o banco de dados Oracle, nas edições Oracle Standard Edition e Oracle Enterprise Edition, a partir da versão 12c Release 2 (12.2). Para mais informações, consulte a página oficial do Oracle Database.

nota

O Oracle Express Edition (XE) é uma edição gratuita, porém com limitações de uso de recursos, como processamento, memória e volume de dados armazenados. Por isso, é indicada principalmente para ambientes de testes e homologação, e não para ambientes de produção. Caso seja utilizada, recomenda-se a versão 18c ou superior.

Especificações técnicas mínimas de hardware por acessos simultâneos​

Instalações do e-SUS APS da modalidade "Prontuário"​

Até 40 usuários simultâneos​

AmbienteServidor único para aplicação e banco de dados
Sistema OperacionalUbuntu Server 64 bits ou Windows Server 64 bits
Memória RAM - Aplicação:8 GB - Barramento DDR4 - Mínimo 1.600MHz
Processador:Quad Core 2.20 GHz - Pontuação mínima de 2.500 pontos no PassMark/CPUBenchmark
Disco:100 GB - Velocidade de escrita mínima 80 MB/seg / Velocidade de leitura mínima 350 MB/seg
Banco de Dados PostgreSQL:Versão mínima: 9.6
Banco de Dados Oracle:Versão mínima: 12c Release 2 (12.2)

Até 100 usuários simultâneos​

Ambiente2 servidores (aplicação e banco de dados)
Sistema OperacionalLinux ou Windows (versão Server) x64
Memória RAM - Aplicação:8 GB - Barramento DDR4 - Mínimo 1.600MHz
Memória RAM - Banco de Dados:8 GB - Barramento DDR4 - Mínimo 1.600MHz
Processador:Quad Core 2.20 GHz - Pontuação mínima de 5.000 pontos no PassMark/CPUBenchmark
Disco Aplicação:100 GB - Velocidade de escrita mínima 200 MB/seg / Velocidade de leitura mínima 350 MB/seg
Disco Banco de dados:120 GB - Velocidade de escrita mínima 700 MB/seg / Velocidade de leitura mínima 1.000 MB/seg
Banco de Dados PostgreSQL:Versão mínima: 9.6
Banco de Dados Oracle:Versão mínima: 12c Release 2 (12.2)

Até 1.000 usuários simultâneos​

Ambiente2 servidores (aplicação e banco de dados)
Sistema OperacionalLinux ou Windows (versão Server) x64
Memória RAM - Aplicação:8 GB - Barramento DDR4 - Mínimo 1.600MHz
Memória RAM - Banco de Dados:16 GB - Barramento DDR4 - Mínimo 1.600MHz
Processador:Octa Core 2.20 GHz - Pontuação mínima de 10.000 pontos no PassMark/CPUBenchmark
Disco Aplicação:100 GB - Velocidade de escrita mínima 400 MB/seg / Velocidade de leitura mínima 700 MB/seg
Disco Banco de dados:750 GB - Velocidade de escrita mínima 700 MB/seg / Velocidade de leitura mínima 1.000 MB/seg
Parametrização do PostgreSQL:Utilizar PGConfig 2.0
Banco de Dados PostgreSQL:Versão mínima: 9.6
Banco de Dados Oracle:Versão mínima: 12c Release 2 (12.2)

Até 2.500 usuários simultâneos​

Ambiente2 servidores (aplicação e banco de dados)
Sistema OperacionalLinux ou Windows (versão Server) x64
Memória RAM - Aplicação:16 GB - Barramento DDR4 - Mínimo 1.600MHz
Memória RAM - Banco de Dados:16 GB - Barramento DDR4 - Mínimo 1.600MHz
Processador:Octa Core 2.20 GHz - Pontuação mínima de 13.000 pontos no PassMark/CPUBenchmark
Disco Aplicação:100 GB - Velocidade de escrita mínima 700 MB/seg / Velocidade de leitura mínima 1.000 MB/seg
Disco Banco de dados:1 TB - Velocidade de escrita mínima 700 MB/seg / Velocidade de leitura mínima 1.000 MB/seg
Parametrização do PostgreSQL:Utilizar PGConfig 2.0
Parametrização JVM:set "JAVA_OPTS=-Xms2048M -Xmx8192M -XX:MetaspaceSize=512M -XX:MaxMetaspaceSize=1024M -XX:ReservedCodeCacheSize=300M"
Banco de Dados PostgreSQL:Versão mínima: 9.6
Banco de Dados Oracle:Versão mínima: 12c Release 2 (12.2)

Até 4.000 usuários simultâneos​

Ambiente2 servidores (aplicação e banco de dados)
Sistema OperacionalLinux ou Windows (versão Server) x64
Memória RAM - Aplicação:16 GB - Barramento DDR4 - Mínimo 2.133MHz
Memória RAM - Banco de Dados:32 GB - Barramento DDR4 - Mínimo 2.133MHz
Processador:Octa Core 2.20 GHz - Pontuação mínima de 15.000 pontos no PassMark/CPUBenchmark
Disco Aplicação:100 GB - Velocidade de escrita mínima 700 MB/seg / Velocidade de leitura mínima 1.000 MB/seg
Disco Banco de dados:2 TB - Velocidade de escrita mínima 700 MB/seg / Velocidade de leitura mínima 1.000 MB/seg
Parametrização do PostgreSQL:Utilizar PGConfig 2.0
Parametrização JVM:set "JAVA_OPTS=-Xms2048M -Xmx10240M -XX:MetaspaceSize=512M -XX:MaxMetaspaceSize=1024M -XX:ReservedCodeCacheSize=300M"
Banco de Dados PostgreSQL:Versão mínima: 9.6
Banco de Dados Oracle:Versão mínima: 12c Release 2 (12.2)
dica

Para instalações com mais de 4.000 usuários simultâneos, solicite apoio pelo Canal de Suporte dos sistemas da Estratégia e-SUS APS.

Instalações do e-SUS APS da modalidade "Centralizadora"​

Centralizadores Municipais​

Ambiente2 servidores (aplicação e banco de dados)
Sistema OperacionalLinux ou Windows (versão Server) x64
Memória RAM - Aplicação:16 GB - Barramento DDR4 - Mínimo 2.133MHz
Memória RAM - Banco de dados:16 GB - Barramento DDR4 - Mínimo 2.133MHz
Processador:Octa Core 2.20 GHz - Pontuação mínima de 13.000 pontos no PassMark/CPUBenchmark
Disco Aplicação:100 GB - Velocidade de escrita mínima 700 MB/seg / Velocidade de leitura mínima 1.000 MB/seg
Disco Banco de dados:1 TB - Velocidade de escrita mínima 700 MB/seg / Velocidade de leitura mínima 1.000 MB/seg
Parametrização do PostgreSQL:Utilizar PGConfig 2.0
Banco de Dados PostgreSQL:Versão mínima: 9.6
Banco de Dados Oracle:Versão mínima: 12c Release 2 (12.2)

Centralizadores Estaduais​

Ambiente2 servidores (aplicação e banco de dados)
Sistema OperacionalLinux ou Windows (versão Server) x64
Memória RAM - Aplicação:16 GB - Barramento DDR4 - Mínimo 2.133MHz
Memória RAM - Banco de dados:32 GB - Barramento DDR4 - Mínimo 2.133MHz
Processador:Octa Core 2.20 GHz - Pontuação mínima de 13.000 pontos no PassMark/CPUBenchmark
Disco Aplicação:100 GB - Velocidade de escrita mínima 700 MB/seg / Velocidade de leitura mínima 1.000 MB/seg
Disco Banco de dados:3 TB - Velocidade de escrita mínima 700 MB/seg / Velocidade de leitura mínima 1.000 MB/seg
Parametrização do PostgreSQL:Utilizar PGConfig 2.0
Banco de Dados PostgreSQL:Versão mínima: 9.6
Banco de Dados Oracle:Versão mínima: 12c Release 2 (12.2)

Estações de trabalho e conectividade das Unidades de Saúde​

Além dos servidores, é fundamental que os computadores utilizados pelos profissionais nas Unidades de Saúde (estações de trabalho) estejam em condições adequadas para o uso do Prontuário Eletrônico e-SUS APS. Como o sistema é acessado pelo navegador de internet, não há uma especificação mínima de hardware definida para as estações de trabalho. Porém, recomenda-se que:

  • os computadores não sejam muito antigos e consigam acessar páginas da web de forma satisfatória, sem lentidão;
  • o sistema operacional esteja em uma versão com suporte do fabricante e com as atualizações de segurança em dia;
  • esteja instalado um navegador de internet atualizado, sendo o Google Chrome o navegador recomendado para o uso do e-SUS APS. Outros navegadores, como o Mozilla Firefox e o Microsoft Edge, também podem ser utilizados, desde que atualizados;
  • os computadores contem com medidas básicas de segurança, como antivírus atualizado e acesso protegido por senha.

Da mesma forma, a conexão das Unidades de Saúde, seja com a internet ou com a rede local (no caso de instalações descentralizadas), deve ser estável e ter velocidade adequada para o acesso a páginas da web nos dias atuais, considerando a quantidade de computadores conectados ao mesmo tempo.

Recursos adicionais para funcionalidades específicas​

Videochamada: para realizar atendimentos mediados por tecnologia, as estações de trabalho precisam ter câmera e microfone (ou fone de ouvido com microfone). Além disso, o atendimento deve ocorrer em um ambiente adequado, reservado e seguro, que garanta a privacidade do cidadão e o sigilo das informações compartilhadas. Mais detalhes no Capítulo 11 - Videochamadas.

Painel de chamadas: para as Unidades de Saúde que desejam utilizar o painel de chamadas dos cidadãos, é necessária a seguinte infraestrutura mínima:

  • dispositivo capaz de operar um navegador de internet (por exemplo, computador, notebook, tablet ou smart TV), com conexão de rede que permita acessar o endereço (URL) da instalação do e-SUS APS;
  • dispositivo(s) de áudio e vídeo para a exibição visual e o alerta sonoro das chamadas (por exemplo, televisor, monitor e caixa de som).

Mais detalhes no Capítulo 2 - Administração e Configurações do Sistema: Painel de chamadas.

Dispositivos móveis para os aplicativos da Estratégia e-SUS APS​

Os aplicativos da Estratégia e-SUS APS são utilizados em dispositivos móveis (tablets ou smartphones), tanto pelos profissionais que realizam ações fora da Unidade de Saúde, como visitas domiciliares, atividades coletivas, vacinação e atendimentos domiciliares (exclusivo para as equipes do Programa Melhor em Casa do Serviço de Atenção Domiciliar), quanto pelas pessoas na gestão, para o acompanhamento de informações da APS. Recomenda-se que esses dispositivos:

  • sejam compatíveis com os requisitos de cada aplicativo, descritos em seu manual específico;
  • estejam com o sistema operacional e o aplicativo atualizados;
  • tenham acesso à rede (internet ou rede local) para realizar a sincronização periódica dos registros com a instalação do e-SUS APS;
  • estejam protegidos por senha ou outro método de bloqueio de tela, por armazenarem dados de saúde dos cidadãos.

Os requisitos e orientações de uso de cada aplicativo estão disponíveis em seus manuais:

Ajuste fino (tuning) para aplicação e banco de dados​

perigo

Atenção: procedimento técnico avançado.

Os ajustes desta seção alteram arquivos de configuração da aplicação e do banco de dados do e-SUS APS. Valores incorretos ou erros de digitação podem impedir a inicialização do sistema ou prejudicar o desempenho de toda a instalação. Por isso:

  • Realize estes procedimentos somente se você tiver conhecimento técnico em administração de servidores, Java e PostgreSQL.
  • Antes de qualquer alteração, faça um backup completo do banco de dados e uma cópia dos arquivos que serão editados (standalone.bat e postgresql.conf), para que seja possível desfazer as mudanças.
  • Execute os ajustes em horário sem uso do sistema, pois os serviços precisarão ser reiniciados e o e-SUS APS ficará indisponível por alguns minutos.
  • Em caso de dúvidas, ou em cenários não descritos nesta seção, não realize as alterações e solicite apoio pelo Canal de Suporte dos sistemas da Estratégia e-SUS APS.

O ajuste fino (tuning) da memória da aplicação e do banco de dados é destinado principalmente a instalações grandes, que possuem tabelas com grandes quantidades de registros e muitos acessos simultâneos. Os valores indicados a seguir seguem as especificações técnicas mínimas por acessos simultâneos descritas nesta página.

Parametrização da memória da JVM (aplicação)​

O uso inadequado de configurações da JVM (Java Virtual Machine) pode trazer grandes transtornos a aplicações com grande quantidade de acessos e/ou requisições. Por isso, saber configurar o espaço em memória utilizado pela JVM é essencial para se ter um bom desempenho.

Antes de iniciar a configuração, é importante conhecer os principais espaços de memória utilizados pela JVM:

  • Heap: armazena os objetos criados pela aplicação durante o seu funcionamento. O termo HeapSize refere-se à quantidade de memória alocada para esse espaço.
  • Metaspace: armazena as classes, métodos, interfaces e atributos estáticos da aplicação, também conhecidos como metadados. No Java 8, versão utilizada pelo e-SUS APS, o Metaspace substituiu o antigo espaço Perm (Perm Gen), utilizando a memória nativa do servidor.

Em resumo, os parâmetros utilizados são:

ParâmetroDescrição
-XmsTamanho inicial do espaço alocado para o Heap.
-XmxTamanho máximo do espaço alocado para o Heap.
-XX:MetaspaceSizeTamanho inicial de referência do espaço alocado para o Metaspace.
-XX:MaxMetaspaceSizeTamanho máximo do espaço alocado para o Metaspace.
-XX:ReservedCodeCacheSizeTamanho do espaço reservado para o código compilado pela JVM (cache de código).

Valores por cenário de instalação​

CenárioParametrização JVM
Até 40 usuários simultâneosManter as configurações padrão de memória.
Até 100 usuários simultâneosManter as configurações padrão de memória.
Até 1.000 usuários simultâneosManter as configurações padrão de memória.
Até 2.500 usuários simultâneosset "JAVA_OPTS=-Xms2048M -Xmx8192M -XX:MetaspaceSize=512M -XX:MaxMetaspaceSize=1024M -XX:ReservedCodeCacheSize=300M"
Até 4.000 usuários simultâneosset "JAVA_OPTS=-Xms2048M -Xmx10240M -XX:MetaspaceSize=512M -XX:MaxMetaspaceSize=1024M -XX:ReservedCodeCacheSize=300M"
Centralizadores Municipais e EstaduaisManter as configurações padrão de memória.
nota

O valor máximo do Heap (-Xmx) deve ser sempre menor que a memória RAM total do servidor de aplicação, pois o sistema operacional e os demais serviços também precisam de memória. Respeite a memória RAM mínima indicada para cada cenário nas tabelas desta página.

Passo a passo (Windows)​

Passo 1 - No servidor de aplicação, abra o Bloco de notas como administrador (procure o Bloco de notas no menu Iniciar, clique com o botão direito e selecione Executar como administrador). Isso é necessário para conseguir salvar arquivos dentro da pasta Program Files.

Passo 2 - No Bloco de notas, acesse Arquivo > Abrir, navegue até o diretório padrão da instalação do e-SUS APS, altere o filtro para "Todos os arquivos (*.*)" e abra o arquivo standalone.bat:

C:\Program Files\e-SUS\webserver\

Passo 3 - Localize a linha que inicia com set "JAVA_OPTS= e substitua-a pela linha correspondente ao seu cenário de instalação, conforme a tabela acima. Altere somente esta linha do arquivo.

Passo 4 - Salve o arquivo.

Passo 5 - Reinicie o serviço do e-SUS APS: no menu Iniciar, procure por Serviços, localize o serviço do e-SUS APS, clique com o botão direito e selecione Reiniciar. Os novos parâmetros só serão utilizados pela aplicação a partir do momento em que o serviço for reiniciado.

Passo 6 - Aguarde a inicialização (pode levar alguns minutos) e confirme, pelo navegador, que o e-SUS APS está acessível normalmente. Caso o sistema não inicie, restaure a cópia do arquivo standalone.bat feita antes da alteração e reinicie novamente o serviço.

nota

O diretório e o arquivo indicados acima correspondem à instalação padrão no Windows. Em instalações Linux, o diretório de instalação e o arquivo de inicialização da aplicação são diferentes, assim como a forma de declarar os parâmetros da JVM. Nesses casos, ou se não localizar o arquivo na sua instalação, solicite orientação pelo Canal de Suporte dos sistemas da Estratégia e-SUS APS antes de realizar qualquer alteração.

Tuning do PostgreSQL (banco de dados)​

Uma forma de melhorar o desempenho do usuário em sua experiência com o e-SUS APS é tunando o PostgreSQL, ajuste destinado principalmente a instalações grandes, que possuem tabelas com grandes quantidades de registros e muitos acessos ao banco de dados.

O tuning do PostgreSQL é feito por meio de um arquivo do próprio banco chamado postgresql.conf, que contém diversos parâmetros de conexão, utilização de memória, cache, entre outros.

Localização do arquivo postgresql.conf​

Tipo de instalaçãoDiretório do arquivo postgresql.conf
Servidor único, Windows (instalação padrão)C:\Program Files\e-SUS\database\postgresql-9.6.13-4-windows-x64\data\
Dois servidores, Windows (PostgreSQL instalado manualmente)Provavelmente C:\Program Files\PostgreSQL\VERSAO-DO-POSTGRESQL\data
Dois servidores, Linux (PostgreSQL instalado manualmente)Provavelmente /etc/postgresql/VERSAO-DO-POSTGRESQL/main
Servidor único, Linux (instalação padrão)O arquivo fica dentro da pasta de instalação do banco de dados do e-SUS APS. Para localizá-lo, execute no terminal: sudo find / -name postgresql.conf 2>/dev/null

Valores por cenário de instalação​

CenárioParametrização do PostgreSQL
Até 40 usuários simultâneosManter as configurações padrão.
Até 100 usuários simultâneosManter as configurações padrão.
Até 1.000 usuários simultâneosPGConfig 2.0
Até 2.500 usuários simultâneosPGConfig 2.0
Até 4.000 usuários simultâneosPGConfig 2.0
Centralizadores Municipais e EstaduaisPGConfig 2.0

O PGConfig 2.0 é uma ferramenta online e gratuita que calcula os parâmetros recomendados para o PostgreSQL a partir das características do servidor de banco de dados. Para utilizá-la, informe, entre outros dados, a versão do PostgreSQL, o sistema operacional, a quantidade de memória RAM, a quantidade de processadores (CPUs) e o tipo de armazenamento do servidor de banco de dados. A ferramenta gera os parâmetros que deverão ser aplicados no arquivo postgresql.conf.

dica

Utilize como base a memória RAM mínima indicada para o servidor de banco de dados no seu cenário (tabelas desta página). Se o servidor possuir uma quantidade de memória RAM diferente, os parâmetros podem ser ajustados, se necessário, informando no PGConfig a memória RAM real do servidor.

Passo a passo​

Passo 1 - Faça uma cópia de segurança do arquivo postgresql.conf (por exemplo, postgresql.conf.original), na mesma pasta.

Passo 2 - Abra o arquivo postgresql.conf com permissão de administrador:

  • Windows: com o Bloco de notas executado como administrador, conforme indicado na parametrização da JVM.
  • Linux: com o comando sudo nano CAMINHO-DO-ARQUIVO/postgresql.conf.

Passo 3 - Para cada parâmetro gerado pelo PGConfig, localize a linha correspondente no arquivo e altere o seu valor. Se a linha iniciar com o caractere #, retire-o para ativá-la. Caso o parâmetro não exista no arquivo, adicione-o ao final.

nota

Se um mesmo parâmetro aparecer mais de uma vez no arquivo, o PostgreSQL considera apenas a última ocorrência. Evite duplicidades para não haver dúvidas sobre qual valor está em uso.

Passo 4 - Salve o arquivo.

Passo 5 - Reinicie o serviço do banco de dados para que todos os parâmetros sejam atualizados corretamente:

  • Windows: no menu Iniciar, procure por Serviços, localize o serviço do PostgreSQL, clique com o botão direito e selecione Reiniciar.
  • Linux: em instalações com o PostgreSQL instalado manualmente, utilize o comando sudo service postgresql restart. Na instalação padrão em servidor único, o banco de dados é gerenciado pelo serviço do e-SUS APS. Em caso de dúvida sobre qual serviço reiniciar, solicite apoio pelo canal de suporte.

Passo 6 - Confirme que o e-SUS APS está acessível e funcionando normalmente. Caso o banco de dados não inicie, restaure a cópia do arquivo postgresql.conf feita no Passo 1 e reinicie novamente o serviço.

nota

Em caso de dúvidas sobre a localização dos arquivos, a reinicialização dos serviços ou os valores a serem aplicados, solicite apoio pelo Canal de Suporte dos sistemas da Estratégia e-SUS APS.

Referências​