Download e instalação do sistema (Windows e Linux) : Sup... http://esusaps.bridge.ufsc.br/support/solutions/articles/480...

Download e instalação do sistema (Windows e Linux)

Criado por: Wagner J. Nascimento
Modificado em: Qua, 23 Set, 2020 at 10:22 AM

O Ministério da Saúde (MS), junto à Secretaria de Atenção Primária à Saúde (SAPS),

disponibiliza o download da instalação (https://aps.saude.gov.br/ape/esus/versao4) em seu
portal para os sistemas operacionais Windows e Linux. Contudo, antes de realizar o
download os arquivos para a instalação do sistema e-SUS AB é de extrema importância que
os requisitos mínimos para a instalação sejam validados. No Portal da SAPS é possível
validar os requisitos de instalação com base no quantitativo de usuários logados
simultaneamente ao sistema.

Tais informações também podem ser obtidas

através do artigo Cenários de Implantação do
Sistema (https://esusaps.bridge.ufsc.br/pt-
BR/support/solutions/articles/48001155726-cen%C3
%A1rios-de-implanta%C3%A7%C3%A3o-do-
sistema)

Imagem 1: Download do instalador e-SUS APS

Após o download do instalador do e-SUS AB em sua versão mais atual, o profissional deve

1 of 10 09/02/2021 16:41
Download e instalação do sistema (Windows e Linux) : Sup... http://esusaps.bridge.ufsc.br/support/solutions/articles/480...

validar se o servidor possui o Java 8 já instalado. A verificação quanto a instalação e versão do

java pode ser confirmada no terminal no Linux ou prompt de comando no Windows, com o
comando java -version. Caso não esteja instalado, o Java 8 de 64 bits pode ser obtido através do
seguinte link: Java SE Runtime Environment 8 Downloads (https://www.oracle.com
/java/technologies/javase-jre8-downloads.html).

Imagem 2: Validando a versão do Java através do prompt de comando

Iniciando a instalação do sistema

Para a nova versão 4.0 do e-SUS APS, os passos para a instalação são semelhantes em
ambos sistemas operacionais (Windows e Linux). Antes de iniciar a instalação é necessário
validar se o usuário logado no computador possui privilégios de administrador.

Para a execução do arquivo de extensão .jar basta que o profissional dê um duplo

clique no arquivo. Caso a execução do arquivo não ocorra com o duplo clique, a execução
deverá ser realizada via linha de comando, executado em modo de interface gráfica. Abaixo
são apresentadas as etapas de instalação conforme o tipo de execução do arquivo realizada.

Instalação do sistema através do duplo clique no arquivo instalador

2 of 10 09/02/2021 16:41
Download e instalação do sistema (Windows e Linux) : Sup... http://esusaps.bridge.ufsc.br/support/solutions/articles/480...

Após o duplo clique no arquivo instalador, a interface gráfica (modal/wizard) será

aberta com as 6 etapas da instalação, conforme as imagens e descrições apresentadas a
seguir.

Imagem 3: etapas da instalação do e-SUS APS

1ª etapa: apresenta informações quanto ao assistente de instalação e algumas

recomendações para o processo de instalação;

2ª etapa: é onde o Tipo da instalação é selecionado. É apresentada a informação "Escolha o

seu tipo de instalação", apresentando as opções “Produção e Treinamento”;

3ª etapa: é onde o banco de dados é configurado. Se o município já possui um banco de

dados instalado, outras configurações como a “URL de conexão”, “Nome de usuário” e
“Senha” são habilitadas para preenchimento. Se o município não tiver banco de dados
próprio é instalado um banco de dados Postgres automaticamente;

4ª etapa: é para a confirmação das informações da instalação. É apresentada a informação

"Verifique as ações a serem realizadas", além de orientações e recomendações para iniciar
o processo de instalação. Caso esteja tudo certo, é só clicar em “Instalar”;

3 of 10 09/02/2021 16:41
Download e instalação do sistema (Windows e Linux) : Sup... http://esusaps.bridge.ufsc.br/support/solutions/articles/480...

5ª etapa: apresenta a descrição dos processos executados e a barra de progresso da

instalação;

6ª e última etapa: mostra que a “Instalação foi concluída” e o botão para finalizar este
processo. Ao clicar em “Finalizar” iniciamos o uso do sistema e-SUS APS.

Após a finalização do processo de instalação, o profissional deve aguardar 1 minuto e,

posteriormente abrir o seu navegador padrão (preferencialmente o Google Chrome)
acessando a página “http://localhost:8080” (http://localhost:8080%E2%80%9D) ou clicando
no ícone do e-SUS na área de trabalho.

Instalação do sistema via linha de comando

Para ambos os sistemas operacionais Linux ou Windows, o processo de instalação

pode ser realizado a partir do terminal ou prompt através de linhas de comando. Abaixo é
apresentado descritivamente os passos e regras para a instalação do e-SUS AB APS via
linha de comando. Reiteramos a importância de verificar se o Java 8 está instalado, o qual
pode ser confirmado com o comando java -version.

1. para iniciar a instalação é necessário abrir o terminal ou prompt de comando;

2. deve ser localizado o diretório/pasta onde está o arquivo de instalação do e-SUS APS. O
nome do arquivo inicia com eSUS-APS-PEC e varia de acordo com a versão a ser instalada
e com o sistema operacional, finalizando com a extensão .jar;

3. o comando para iniciar a instalação do sistema é o java -jar mais a [classe principal] que,
neste caso é o nome do arquivo com a extensão .jar. O parâmetro "[classe principal]" é
obrigatório e representa o arquivo da classe principal, que possui extensão .jar;

4 of 10 09/02/2021 16:41
Download e instalação do sistema (Windows e Linux) : Sup... http://esusaps.bridge.ufsc.br/support/solutions/articles/480...

java -jar eSUS-APS-PEC-4.0.00-Win64.jar

java -jar eSUS-APS-PEC-4.0.00-Linux64.jar

4. se o instalador estiver sendo executado no Linux é necessário executar o comando como

super usuário ou root. É recomendado solicitar esse tipo de acesso apenas neste caso. No
Windows a ferramenta irá requisitar automaticamente os privilégios de administrador,
quando necessário.

5. o comando com o parâmetro “-help” apresenta algumas informações importantes no

processo de instalação ou atualização ou atualização do sistema java -jar eSUS-APS-
PEC-4.0.00-Win64.jar -help

5 of 10 09/02/2021 16:41
Download e instalação do sistema (Windows e Linux) : Sup... http://esusaps.bridge.ufsc.br/support/solutions/articles/480...

Imagem 4: Prompt com o resultado do comando “java -jar eSUS-APS-PEC-4.0.00-Win64.jar -help”

6. no Linux, se o sistema operacional utilizado for Debian, o profissional deve executar os

seguintes passos:

o arquivo /etc/locale.gen deve ser editado e o caractere “#” da linha “# pt_BR.UTF-8

UTF-8” deve ser apagado. Após a edição o seguinte comando deve ser executado:

$> sudo locale-gen

por fim, para a consolidação das ações realizadas pelo profissional, será necessário reiniciar
o computador.

7. a seguir são apresentados exemplos de comandos utilizados para a instalação do e-SUS

APS via terminal para o Linux e para o Windows.

java -jar eSUS-AB-PEC-4.0.1-Linux64.jar -console

-url="jdbc:postgresql://localhost:5432/database" -username="admin"
-password="123456"

6 of 10 09/02/2021 16:41
Download e instalação do sistema (Windows e Linux) : Sup... http://esusaps.bridge.ufsc.br/support/solutions/articles/480...

Para o exemplo no Linux, foram usados os parâmetros "url=<url>", "username=

<username>" e "password=<password>" caracterizando assim que o município já
possui um banco de dados instalado.

java -jar eSUS-AB-PEC-4.0.1-Win64.jar -console

No exemplo do Windows, o comando executa a instalação mostrando os processos e

informações da instalação no prompt de comando.

9. ao executar o comando são apresentadas as informações do e-SUS APS, o número e o

tipo da versão que será instalada e a confirmação para continuar o processo.

Imagem 5: no Windows, o comando executa a instalação mostrando os processos e informações da instalação no prompt de
comando

Caso tenha sido configurado um banco de dados para a instalação, o sistema fornece a
seguinte informação: “O Banco de Dados foi configurado manualmente”. Caso contrário, a
informação: “Um banco de dados (PostgreSQL) será instalado automaticamente” é
exibida. Todos os passos apresentados na interface gráfica (wizard/modal) são apresentados
descritivamente no prompt ou terminal conforme a execução sequencial dos processos.

Ao final do processo de instalação será exibida a seguinte mensagem: “Instalação

concluída. Pressione ENTER para continuar…”. Por fim, o profissional deve aguardar 1

7 of 10 09/02/2021 16:41
Download e instalação do sistema (Windows e Linux) : Sup... http://esusaps.bridge.ufsc.br/support/solutions/articles/480...

minuto e, posteriormente abrir o seu navegador padrão (preferencialmente o Google

Chrome) acessando a página “http://localhost:8080” (http://localhost:8080%E2%80%9D).

Acesso ao e-SUS APS nas Unidades Básicas de Saúde

Após a finalização da instalação e, considerando a instalação do e-SUS APS

centralizada na Secretaria Municipal de Saúde (SMS), é de responsabilidade da própria
SMS e da Empresa Técnica de Implantação disponibilizar o Domain Name System (DNS) e
um IP válido para que os profissionais de saúde possam ter acesso ao e-SUS APS nas
Unidades Básicas de Saúde do município. Com isso, o e-SUS APS será disponibilizado
através de um endereço web e precisa ter a combinação do IP válido e de um nome de
domínio associado.

Banco de Dados (Postgres / Postgres Próprio / Oracle)

O banco de dados padrão do e-SUS APS é o Postgres, uma solução opensource, sem
custos e instalado automaticamente junto com o sistema e-SUS APS. Inicialmente, não é
necessário conhecimento especializado quanto as configurações deste tipo de solução de
tecnologia referente ao banco de dados.

Porém, quando o município trabalha com DBA (Administrador de Banco de Dados), e

com profissionais da tecnologia da informação participando da implantação e instalação do
e-SUS APS, existe a possibilidade do município ter um banco de dados próprio, seja ele
Postgres ou Oracle. Em ambos os casos, o município fica responsável pela administração e
configuração do banco de dados.

O banco de dados Oracle é uma solução paga e exige conhecimento especializado de

gerenciamento de banco de dados. Portanto, é indicado em situações que o DBA e
profissionais da tecnologia da informação com conhecimento especializado em
gerenciamento de banco de dados estejam participando do projeto de implantação do
e-SUS APS.

8 of 10 09/02/2021 16:41
Download e instalação do sistema (Windows e Linux) : Sup... http://esusaps.bridge.ufsc.br/support/solutions/articles/480...

Quando um município opta por utilizar um banco de dados próprio, algumas

considerações são importantes quanto às configurações da URL de conexão, nome de
usuário e senha, entre outros. Nas versões a partir da 4.0 existe o arquivo
application.properties que o Springboot acessa para executar a conexão entre o e-SUS e o
banco de dados.

Imagem 6: Arquivo “application.properties” e configurações de URL, usuário e senha

Para banco de dados Postgres normalmente é configurado da seguinte forma:

jdbc:postgresql://localhost:5433/esus, onde:

o “jdbc:postgresql” é referente ao banco de dados;

o “//localhost” é o IP do servidor que está rodando o banco de dados;

seguido de dois pontos (:) e a porta, que neste caso, utilizamos a porta 5433 do
Postgres e, por último barra (/) e nome_da_database.

Genericamente, esse é o padrão do postgres:

jdbc:postgresql:[<//host>[:<5432>/]]<database>

*As alterações, tanto para Postgres quanto para o Oracle, normalmente ocorrem entre os <
e>.

9 of 10 09/02/2021 16:41
Download e instalação do sistema (Windows e Linux) : Sup... http://esusaps.bridge.ufsc.br/support/solutions/articles/480...

Para banco de dados Oracle, normalmente é configurado da seguinte forma:

jdbc:oracle:thin:@localhost:1521:XE, onde:

o “jdbc:oracle:thin” se refere ao banco;

o “@localhost” se refere ao IP ao qual a aplicação vai se conectar com o banco de

dados. Nesse caso do exemplo é localhost (ou seja, 127.0.0.1); mas pode ser qualquer
outro valor, ex: 150.162.18.154;

depois vem dois pontos seguido da porta, que neste caso, usamos a padrão do oracle
1521, mas pode ser qualquer porta desde que o banco esteja disponibilizando essa
porta pra uso;

por último vem a database XE utilizada no exemplo acima.

Genericamente, o padrão para o oracle é:

jdbc:oracle:thin:@<server>[:<1521>]:<database_name>

10 of 10 09/02/2021 16:41