Repuacuteblica de Moccedilambique

MINISTEacuteRIO DA SAUacuteDE Direcccedilatildeo de Planificaccedilatildeo e

Cooperaccedilatildeo

Departamento de Informaccedilatildeo para a

Sauacutede

MOZAMBICAN OPEN

ARCHITECTURES STANDARDS AND

INFORMATION SYSTEMS Avenida Julius Nyerere nordm 3326 ndash

Condomiacutenio Diplomatic Village Casa nordm 1

Tels 21902424 - 823069636 -

843069636 - web

httpwwwmoasisorgmz - Maputo

ndash Moccedilambique

Physical Address Unit D11 Westlake

Square Bell Crescent Westlake Cape

Town

Postal Postnet Suite 280 Private Bag X26

Tokai 7966 South Africa

Tel+27 (0)21 701 0939 Fax+27 (0)21

701 1979

E-mai linfojembiorg

Websitewwwjembiorg

Manual de Administraccedilatildeo do SISMA Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Junho de 2015

Versatildeo 11

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

2 | P Aacute G I N A

AGRADECIMENTOS

O MOASIS (mozambican open architectures standards and information systems) expressa os seus agradecimentos a

- Jembi Health Systems

- Departamento de Informaccedilatildeo para a Sauacutede do Ministeacuterio da Sauacutede da Repuacuteblica de Moccedilambique

- Pessoal das Direcccedilotildees Provinciais de Sauacutede e respectivos Serviccedilos Distritais de Sauacutede Mulher e Acccedilatildeo Social (SDSMAS)

em particular os teacutecnicos dos Nuacutecleos de Estatiacutestica e Planificaccedilatildeo (NEPs) e Meacutedicos Chefes Distritais de Sauacutede incluindo

o pessoal das unidades sanitaacuterias envolvidas

- CDC (US Centers for Disease Control and Prevention)

- e a todos aqueles que directa ou indirectamente contribuiacuteram pessoal ou institucionalmente e de forma desinteressada

mas preciosa para a produccedilatildeo e divulgaccedilatildeo do presente manual e para o sucesso deste projecto em geral

O desenvolvimento do presente manual e do respectivo projecto beneficiaram do apoio do Acordo de Cooperaccedilatildeo entre o

Departamento de Sauacutede e Serviccedilos Humanos Centros para o Controle de Doenccedilas e Prevenccedilatildeo - Divisatildeo de HIVSIDA

Global e Jembi Health SystemsMOASIS [Co-operative Agreement Nordm U2GPS002815-02] O seu conteuacutedo eacute da exclusiva

responsabilidade dos autores e natildeo representa necessariamente a posiccedilatildeo oficial do CDC

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

3 | P Aacute G I N A

Iacutendice

1 Introduccedilatildeo 4 11 Objectivo 4 12 Acircmbito 4 13 Audiecircncia 4 14 Definiccedilotildees e Acroacutenimos 4

2 Enquadramento 5 3 Servidor Central 6

31 Preacute-requisitos do Servidor 6 32 Instalaccedilatildeo e Configuraccedilatildeo 6 33 Acesso ao SISMA 12

4 Maacutequinas Cliente 13 411 Preacute-requisitos das maacutequinas cliente 13 412 Instalaccedilatildeo e Configuraccedilatildeo 13 413 Acesso ao sisma 13

5 Continuidade e Manutenccedilatildeo 14

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

4 | P Aacute G I N A

1 Introduccedilatildeo

11 Objectivo

O presente documento tem como objectivo fornecer as informaccedilotildees para instalaccedilatildeo e configuraccedilatildeo das

ferramentas necessaacuterias para o funcionamento do SISMA a niacutevel de servidor central e de clientes

12 Acircmbito

O acircmbito deste documento eacute consolidar a informaccedilatildeo e passos usados necessaacuterios para a instalaccedilatildeo e

configuraccedilatildeo do SISMA em um servidor central e nos clientes

13 Audiecircncia

A audiecircncia deste documento eacute constituiacuteda pela entidade contratante JembiMOASIS responsaacutevel pela

especificaccedilatildeo e validaccedilatildeo do sistema bem como pela equipa de projecto que venha a ser designada para

participar no projecto e pelos elementos da Critical Software que seratildeo responsaacuteveis pelos trabalhos a

desenvolver

14 Definiccedilotildees e Acroacutenimos

Acroacutenimo Descriccedilatildeo

CSW Critical Software SA

MISAU Ministeacuterio da Sauacutede

SGBD Sistema de Gestatildeo de Base de Dados

SISMA Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

TBC A confirmar

Tabela 1 Acroacutenimos

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

5 | P Aacute G I N A

2 Enquadramento O presente documento pretende sistematizar os passos necessaacuterios para a instalaccedilatildeo do SISMA a niacutevel de

servidor central No caso do servidor central a instalaccedilatildeo seraacute efectuada em modo on-line (com conectividade agrave

internet) 2 instacircncias da aplicaccedilatildeo SISMA sendo uma para a produccedilatildeo e outra para consulta de dados histoacutericos

No caso dos clientes a mesma seraacute on-line

O SISMA suporta sistemas operativos que possuam uma versatildeo do Java Runtime Environment 6 ou superior onde

se incluem o Windows Linux ou Mac A niacutevel de base de dados o SISMA suporta diferentes tipos de base de dados

relacionais como o PostgreSQL MySQL H2 ou Derby

Apesar do SISMA suportar diferentes sistemas operativos motores de base de dados e servidores aplicacionais o

foco deste documento eacute o ambiente especificado para o Ministeacuterio da Sauacutede de Moccedilambique no acircmbito do

presente projecto sendo o mesmo constituiacutedo pelas seguintes componentes

Servidor Central

o Sistema Operativo Ubuntu 1204 LTS

o Motor de BD PostgreSQL

o Servidor Aplicacional Tomcat

Clientes On-Line

o Sistema Operativo Windows XP ou superior

o Motor de BD Natildeo Aplicaacutevel (acesso on-line agrave bd central via browser)

Nos capiacutetulos seguintes satildeo detalhados os passos a seguir para a correcta instalaccedilatildeo do SISMA a niacutevel central e

acesso a niacutevel provincial e distrital A niacutevel do servidor central dada a quantidade de tecnologias e dependecircncias a

instalaccedilatildeo deveraacute ser manual e seguindo os passos detalhados neste documento

Para informaccedilotildees mais avanccediladas sugere-se a leitura da documentaccedilatildeo oficial das tecnologias em causa1

1 httpwwwubuntucom httpwwwpostgresqlorg httptomcatapacheorg

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

3 | P Aacute G I N A

Iacutendice

1 Introduccedilatildeo 4 11 Objectivo 4 12 Acircmbito 4 13 Audiecircncia 4 14 Definiccedilotildees e Acroacutenimos 4

2 Enquadramento 5 3 Servidor Central 6

31 Preacute-requisitos do Servidor 6 32 Instalaccedilatildeo e Configuraccedilatildeo 6 33 Acesso ao SISMA 12

4 Maacutequinas Cliente 13 411 Preacute-requisitos das maacutequinas cliente 13 412 Instalaccedilatildeo e Configuraccedilatildeo 13 413 Acesso ao sisma 13

5 Continuidade e Manutenccedilatildeo 14

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

4 | P Aacute G I N A

1 Introduccedilatildeo

11 Objectivo

O presente documento tem como objectivo fornecer as informaccedilotildees para instalaccedilatildeo e configuraccedilatildeo das

ferramentas necessaacuterias para o funcionamento do SISMA a niacutevel de servidor central e de clientes

12 Acircmbito

O acircmbito deste documento eacute consolidar a informaccedilatildeo e passos usados necessaacuterios para a instalaccedilatildeo e

configuraccedilatildeo do SISMA em um servidor central e nos clientes

13 Audiecircncia

A audiecircncia deste documento eacute constituiacuteda pela entidade contratante JembiMOASIS responsaacutevel pela

especificaccedilatildeo e validaccedilatildeo do sistema bem como pela equipa de projecto que venha a ser designada para

participar no projecto e pelos elementos da Critical Software que seratildeo responsaacuteveis pelos trabalhos a

desenvolver

14 Definiccedilotildees e Acroacutenimos

Acroacutenimo Descriccedilatildeo

CSW Critical Software SA

MISAU Ministeacuterio da Sauacutede

SGBD Sistema de Gestatildeo de Base de Dados

SISMA Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

TBC A confirmar

Tabela 1 Acroacutenimos

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

5 | P Aacute G I N A

2 Enquadramento O presente documento pretende sistematizar os passos necessaacuterios para a instalaccedilatildeo do SISMA a niacutevel de

servidor central No caso do servidor central a instalaccedilatildeo seraacute efectuada em modo on-line (com conectividade agrave

internet) 2 instacircncias da aplicaccedilatildeo SISMA sendo uma para a produccedilatildeo e outra para consulta de dados histoacutericos

No caso dos clientes a mesma seraacute on-line

O SISMA suporta sistemas operativos que possuam uma versatildeo do Java Runtime Environment 6 ou superior onde

se incluem o Windows Linux ou Mac A niacutevel de base de dados o SISMA suporta diferentes tipos de base de dados

relacionais como o PostgreSQL MySQL H2 ou Derby

Apesar do SISMA suportar diferentes sistemas operativos motores de base de dados e servidores aplicacionais o

foco deste documento eacute o ambiente especificado para o Ministeacuterio da Sauacutede de Moccedilambique no acircmbito do

presente projecto sendo o mesmo constituiacutedo pelas seguintes componentes

Servidor Central

o Sistema Operativo Ubuntu 1204 LTS

o Motor de BD PostgreSQL

o Servidor Aplicacional Tomcat

Clientes On-Line

o Sistema Operativo Windows XP ou superior

o Motor de BD Natildeo Aplicaacutevel (acesso on-line agrave bd central via browser)

Nos capiacutetulos seguintes satildeo detalhados os passos a seguir para a correcta instalaccedilatildeo do SISMA a niacutevel central e

acesso a niacutevel provincial e distrital A niacutevel do servidor central dada a quantidade de tecnologias e dependecircncias a

instalaccedilatildeo deveraacute ser manual e seguindo os passos detalhados neste documento

Para informaccedilotildees mais avanccediladas sugere-se a leitura da documentaccedilatildeo oficial das tecnologias em causa1

1 httpwwwubuntucom httpwwwpostgresqlorg httptomcatapacheorg

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

4 | P Aacute G I N A

1 Introduccedilatildeo

11 Objectivo

O presente documento tem como objectivo fornecer as informaccedilotildees para instalaccedilatildeo e configuraccedilatildeo das

ferramentas necessaacuterias para o funcionamento do SISMA a niacutevel de servidor central e de clientes

12 Acircmbito

O acircmbito deste documento eacute consolidar a informaccedilatildeo e passos usados necessaacuterios para a instalaccedilatildeo e

configuraccedilatildeo do SISMA em um servidor central e nos clientes

13 Audiecircncia

A audiecircncia deste documento eacute constituiacuteda pela entidade contratante JembiMOASIS responsaacutevel pela

especificaccedilatildeo e validaccedilatildeo do sistema bem como pela equipa de projecto que venha a ser designada para

participar no projecto e pelos elementos da Critical Software que seratildeo responsaacuteveis pelos trabalhos a

desenvolver

14 Definiccedilotildees e Acroacutenimos

Acroacutenimo Descriccedilatildeo

CSW Critical Software SA

MISAU Ministeacuterio da Sauacutede

SGBD Sistema de Gestatildeo de Base de Dados

SISMA Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

TBC A confirmar

Tabela 1 Acroacutenimos

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

5 | P Aacute G I N A

2 Enquadramento O presente documento pretende sistematizar os passos necessaacuterios para a instalaccedilatildeo do SISMA a niacutevel de

servidor central No caso do servidor central a instalaccedilatildeo seraacute efectuada em modo on-line (com conectividade agrave

internet) 2 instacircncias da aplicaccedilatildeo SISMA sendo uma para a produccedilatildeo e outra para consulta de dados histoacutericos

No caso dos clientes a mesma seraacute on-line

O SISMA suporta sistemas operativos que possuam uma versatildeo do Java Runtime Environment 6 ou superior onde

se incluem o Windows Linux ou Mac A niacutevel de base de dados o SISMA suporta diferentes tipos de base de dados

relacionais como o PostgreSQL MySQL H2 ou Derby

Apesar do SISMA suportar diferentes sistemas operativos motores de base de dados e servidores aplicacionais o

foco deste documento eacute o ambiente especificado para o Ministeacuterio da Sauacutede de Moccedilambique no acircmbito do

presente projecto sendo o mesmo constituiacutedo pelas seguintes componentes

Servidor Central

o Sistema Operativo Ubuntu 1204 LTS

o Motor de BD PostgreSQL

o Servidor Aplicacional Tomcat

Clientes On-Line

o Sistema Operativo Windows XP ou superior

o Motor de BD Natildeo Aplicaacutevel (acesso on-line agrave bd central via browser)

Nos capiacutetulos seguintes satildeo detalhados os passos a seguir para a correcta instalaccedilatildeo do SISMA a niacutevel central e

acesso a niacutevel provincial e distrital A niacutevel do servidor central dada a quantidade de tecnologias e dependecircncias a

instalaccedilatildeo deveraacute ser manual e seguindo os passos detalhados neste documento

Para informaccedilotildees mais avanccediladas sugere-se a leitura da documentaccedilatildeo oficial das tecnologias em causa1

1 httpwwwubuntucom httpwwwpostgresqlorg httptomcatapacheorg

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

5 | P Aacute G I N A

2 Enquadramento O presente documento pretende sistematizar os passos necessaacuterios para a instalaccedilatildeo do SISMA a niacutevel de

servidor central No caso do servidor central a instalaccedilatildeo seraacute efectuada em modo on-line (com conectividade agrave

internet) 2 instacircncias da aplicaccedilatildeo SISMA sendo uma para a produccedilatildeo e outra para consulta de dados histoacutericos

No caso dos clientes a mesma seraacute on-line

O SISMA suporta sistemas operativos que possuam uma versatildeo do Java Runtime Environment 6 ou superior onde

se incluem o Windows Linux ou Mac A niacutevel de base de dados o SISMA suporta diferentes tipos de base de dados

relacionais como o PostgreSQL MySQL H2 ou Derby

Apesar do SISMA suportar diferentes sistemas operativos motores de base de dados e servidores aplicacionais o

foco deste documento eacute o ambiente especificado para o Ministeacuterio da Sauacutede de Moccedilambique no acircmbito do

presente projecto sendo o mesmo constituiacutedo pelas seguintes componentes

Servidor Central

o Sistema Operativo Ubuntu 1204 LTS

o Motor de BD PostgreSQL

o Servidor Aplicacional Tomcat

Clientes On-Line

o Sistema Operativo Windows XP ou superior

o Motor de BD Natildeo Aplicaacutevel (acesso on-line agrave bd central via browser)

Nos capiacutetulos seguintes satildeo detalhados os passos a seguir para a correcta instalaccedilatildeo do SISMA a niacutevel central e

acesso a niacutevel provincial e distrital A niacutevel do servidor central dada a quantidade de tecnologias e dependecircncias a

instalaccedilatildeo deveraacute ser manual e seguindo os passos detalhados neste documento

Para informaccedilotildees mais avanccediladas sugere-se a leitura da documentaccedilatildeo oficial das tecnologias em causa1

1 httpwwwubuntucom httpwwwpostgresqlorg httptomcatapacheorg

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

6 | P Aacute G I N A

3 Servidor Central

31 Preacute-requisitos do Servidor

O SISMA eacute uma aplicaccedilatildeo com uma base de dados intensiva e requer que o servidor tenha memoacuteria RAM nuacutemero

de nuacutecleos de CPU e disco riacutegido adequados Estas recomendaccedilotildees devem ser consideradas como regras de ouro

e natildeo como medidas exactas O SIS-MA escalona linearmente de acordo com a quantidade de RAM e nuacutemero de

nuacutecleos de CPU disponiacuteveis entatildeo quanto mais se puder ter melhor seraacute o funcionamento da aplicaccedilatildeo

Memoacuteria RAM Pelo menos 1 GB de memoacuteria por cada 1 milhatildeo de registo de dados colectados por mecircs ou

por 1000 usuaacuterios concorrentes Pelo menos 4 GB por uma instacircncia pequena 12 GB para uma instacircncia

meacutedia

Nuacutecleo de CPU 4 Nuacutecleos de CPU para instacircncia pequena e 8 para meacutedia ou larga instacircncia

Disco Idealmente use o disco SSD caso contraacuterio use um disco de 7200 rpm

Velocidade miacutenima de leitura de 150 Mbs 200 Mbs eacute bom 350 Mbs ou superior eacute o ideal

32 Instalaccedilatildeo e Configuraccedilatildeo

Esta secccedilatildeo descreve como configurar uma instacircncia SISMA em um sistema operativo Linux Ubuntu 1404 de 64

Bits usando postgreSQL como sistema de base de dados e Tomcat como recipiente (container) Servlet

O termo ldquoinvocarrdquo refere-se a execuccedilatildeo de comandos em um terminal

Para um servidor central a especificaccedilatildeo recomendada eacute

Processador quad-core 2Ghz ou superior

Memoacuteria RAM de 12 GB ou superior

Note que eacute necessaacuterio o uso de um sistema operativo de 64 bits para o uso de mais de 4 GB de memoacuteria RAM

Para este manual assume-se que 8 GB de RAM eacute alocado para PostgreSQL e 8 GB de RAM eacute alocado para

TomcatJVM e eacute usado um sistema operativo de 64 bits Se for a usar configuraccedilotildees diferentes ajuste de acordo

com os seus valores

Eacute Recomendado que a memoacuteria disponiacutevel seja dividida mais ou menos igualmente entre a base de dados e o JVM

Lembre-se de deixar um pouco da memoacuteria fiacutesica para o sistema operativo para o desempenho das suas tarefas

por exemplo em torno de 2 GB

Os passos marcados como ldquoopcionalrdquo como o passo para o ajuste de desempenho podem ser efectuados em

uma fase posterior

1 Criaccedilatildeo de um novo utilizador

Deve-se criar um utilizador dedicado para correr o SIS-MA natildeo eacute recomendado correr o SIS-MA usando o utilizador

ldquorootrdquo Criar um novo utilizador chamado ldquosismardquo invocando os seguintes comando

useradd ndashd homesisma ndashm sisma ndashs binbash

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

7 | P Aacute G I N A

Atribuir ao utilizador a execuccedilatildeo temporaacuteria de operaccedilotildees como root

usermod ndashG sudo sisma

Atribuir uma palavra passe para a conta

Passwd sisma

Certifique-se que introduz uma palavra passe forte com pelo menos 15 caracteres aleatoacuterios Se pretender

desabilitar o login remoto para a conta root invoque o comando

sudo passwd ndashl root

2 Ajuste do Kernel do Sistema operativo

Estas configuraccedilotildees satildeo completamente opcionais e natildeo devem ser modificadas para servidores de tamanho

normal

Para abrir o ficheiro de configuraccedilotildees Kernel invoque

sudo nano etcsysctlconf

No final do ficheiro adicione as seguintes linhas

kernelshmmax = 4294967296

netcorermem_max = 8388608

netcorewmem_max = 8388608

Faccedila com que as alteraccedilotildees tenham efeito invocando

sudo sysctl -p

3 Definir fuso horaacuterio do servidor e regiatildeo (locale)

Pode ser necessaacuterio reconfigurar o fuso horaacuterio no servidor para coincidir com o fuso horaacuterio do local que o

servidor SIS-MA vai cobrir Se estiver a utilizar um servidor virtual privado o fuso horaacuterio por defeito pode natildeo

coincidir com o fuso horaacuterio do local do seu SIS-MA Pode reconfigurar facilmente o fuso horaacuterio invocando o

abaixo e seguindo as instruccedilotildees

sudo dpkg-reconfigure tzdata

O PostgreSQL eacute sensiacutevel as regiotildees entatildeo pode ter que instalar a sua regiatildeo primeiro Para verificar que regiotildees

existem e instalar novas (como por exemplo Portuguecircs) invoque os seguintes comandos

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

8 | P Aacute G I N A

locale ndasha

sudo locale-gen pt_PTUTF-8

4 Instalaccedilatildeo do motor de base de dados PostgreSQL

Para a instalaccedilatildeo do motor de base de dados PostgreSQL versatildeo 93 invoque o seguinte comando

sudo apt-get install postgresql-93

Mude para o utilizador postgres usando

sudo su postgres

Crie um utilizador natildeo previlegiado chamado ldquosismardquo

createuser -SDRP sisma

Introduza uma palavra passe segura no prompt

Crie duas bases de dados uma para a aplicaccedilatildeo sisma em produccedilatildeo e outra para o sisma com dados histoacutericos

invocando

createdb -O sisma sisma-prd

createdb -O sisma sisma-hist

Retorne a sessatildeo executando

exit

Apoacutes execuccedilatildeo dos comandos acima citados o motor de base de dados PostgreSQL estaraacute instalado com um

utilizador postgreSQL ldquosismardquo e uma base de dados ldquosisma2rdquo

5 Definir fuso horaacuterio do servidor e regiatildeo (locale)

Faccedila o ajuste de desempenho abrindo o seguinte arquivo ldquopostgresqlconfrdquo

sudo nano etcpostgresql93mainpostgresqlconf

e defina as seguintes propriedades

shared_buffers = 3200MB

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

9 | P Aacute G I N A

Determine quanta memoacuteria PostgreSQL pode usar para o cache de dados Esta configuraccedilatildeo controla como o

tamanho da memoacuteria compartilhada do kernel deve ser reservada para o PostgreSQL Deve ser ajustado para

cerca de 40 do total da memoacuteria designada para o PostgreSQL

work_mem = 20MB

Determine a quantidade de memoacuteria usada para operaccedilotildees internas de ordenaccedilatildeo e Hash Esta configuraccedilatildeo eacute por

conexatildeo por consulta para que uma quantidade de memoacuteria possa ser consumida se elevar demasiado Ajustar

correctamente este valor eacute essencial para o desemepenho da agregaccedilatildeo do SIS-MA

maintenance_work_mem = 512MB

Determine a quantidade de memoacuteria PostgreSQL possa ser utilizada para operaccedilotildees de manutenccedilatildeo como criar

iacutendices correr o vaccum adicionar chaves estrangeiras Aumentar este valor pode melhorar o desempenho da

criaccedilatildeo de iacutendices durante a anaacutelise e processos de geraccedilatildeo de data mart

effective_cache_size = 8000MB

Uma estimativa da quantidade de memoacuteria que eacute disponibilizada para cache de disco pelo sistema operativo (natildeo

uma alocaccedilatildeo) e eacute usada pelo PostgreSQL para determinar se um plano de consulta vai caber na memoacuteria ou natildeo

Defini-lo para um valor maior do que o que estaacute disponiacutevel iraacute resultar num mau desempenho Este valor deve ser

inclusivo da definiccedilatildeo do shared_buffers O PostgreSQL tem 2 camadas de cache a primeira camada utiliza a

memoacuteria partilhada kernel e eacute controlado pelo configuraccedilatildeo do shared_buffers O PostgreSQL delega a segunda

camada para o cache de disco do sistema operativo e o tamanho da memoacuteria disponiacutevel pode ser dado com a

configuraccedilatildeo do effective_cache_size

checkpoint_segments = 32

PostgreSQL escreve novas operaccedilotildees em um arquivo de log chamado ldquoWAL segmentsrdquo que tem um tamanho de

16 MB Quando um nuacutemero de segmentos eacute escrito um checkpoint ocorre Definir este nuacutemero para um nuacutemero

maior iraacute melhorar o desempenho de escrita

checkpoint_completion_target = 08

Determina a percentagem da conclusatildeo do segment antes que o checkpoint ocorra Defini-lo para um valor maior

iraacute difundir as gravaccedilotildees para fora e reduzir a sobrecarga meacutedia de gravaccedilatildeo

wal_buffers = 16MB

Define a memoacuteria usada para o buffer durante o processo de gravaccedilatildeo WAL Aumentando este valor pode melhorar

o rendimento em sistemas de gravaccedilatildeo pesada

synchronous_commit = off

Especifica se a transaccedilatildeo confirmada vai esperar por os registros WAL serem gravados no disco antes de retornar

para o cliente ou natildeo Configuranda-o para ldquooffrdquo iraacute melhorar consideravelmente o desempenho Implica tambeacutem

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

que haacute um ligeiro atraso entre informar ao cliente que a transaccedilatildeo foi com sucesso e transaccedilatildeo estar segura mas

o estado da base de dados natildeo pode ser corrompido e esta eacute uma boa alternativa para sistemas de desempenho

intensivo e gravaccedilatildeo pesada como o SIS-MA

wal_writer_delay = 10000ms

Especifique o atraso entre as operaccedilotildees de escrita WAL Defini-lo para um valor maior iraacute aumentar o desempenho

em sistema de escrita em massa uma vez que potencialmente muitas operaccedilotildees de escrita podem ser executadas

em uma uacutenica descarga para o disco

Faccedila o restart do PostgreSQL invocando

sudo etcinitdpostgresql restart

6 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraveacutes da configuraccedilatildeo do ficheiro chamado

ldquohibernatepropertiesrdquo

Crie 2 ficheiros conforme especificado abaixo e guarde eacute um local conveniente Os ficheiros correspondentes tem

as seguintes propriedades

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma produccedilatildeo

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-prd

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernatehbm2ddlauto = update

Um erro comum eacute ter um espaccedilo em branco apoacutes o uacuteltimo valor da propriedade Certifique-se que natildeo haacute espaccedilo

em branco no final de qualquer linha Lembre-se tambeacutem que este ficheiro conteacutem a senha em texto natildeo

criptografado para a sua base de dados logo eacute preciso proteger contra acessos natildeo autorizados Para isso

invoque

chmod 0600 hibernateproperties

Garantindo assim que somente o utilizador sisma que eacute o dono do ficheiro tem permissotildees de leitura do ficheiro

7 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte comando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invocando

java ndashversion

8 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat a partir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil para descarregar ficheiros da web eacute o ldquowgetrdquo

Extrai para uma localizaccedilatildeo conveniente Este manual pressupotildee que se tenha navegado para o diretoacuterio root do

arquivo extraiacutedo

Limpe todas as aplicaccedilotildees web preacute-instaladas invocando

rm -rf webapps

Crie 2 pastas idecircnticas para as 2 instacircncias SISMA a criar contendo os ficheiros tomcat

A partir da pasta do projecto SISMA na dropbox SISMA - Management RepositorydeliverablesPhase 4 -

Software development copie os ficheiros ldquoSISMAWARrdquo e ldquoROOTwarrdquo para o directoacuterio webapps dos 2 ambientes

Para cada um dos ambientes crie um ficheiro chamado setenvsh no directoacuterio bin do tomcat e adicione as linhas

abaixo A primeira vai definir a localizaccedilatildeo do seu Java Runtime Environment o segundo vai dedicar memoacuteria para

o Tomcat e o terceiro iraacute definir o local para onde SIS-MA vai procurar o ficheiro de configuraccedilatildeo

hibernateproperties

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

7 | P Aacute G I N A

Atribuir ao utilizador a execuccedilatildeo temporaacuteria de operaccedilotildees como root

usermod ndashG sudo sisma

Atribuir uma palavra passe para a conta

Passwd sisma

Certifique-se que introduz uma palavra passe forte com pelo menos 15 caracteres aleatoacuterios Se pretender

desabilitar o login remoto para a conta root invoque o comando

sudo passwd ndashl root

2 Ajuste do Kernel do Sistema operativo

Estas configuraccedilotildees satildeo completamente opcionais e natildeo devem ser modificadas para servidores de tamanho

normal

Para abrir o ficheiro de configuraccedilotildees Kernel invoque

sudo nano etcsysctlconf

No final do ficheiro adicione as seguintes linhas

kernelshmmax = 4294967296

netcorermem_max = 8388608

netcorewmem_max = 8388608

Faccedila com que as alteraccedilotildees tenham efeito invocando

sudo sysctl -p

3 Definir fuso horaacuterio do servidor e regiatildeo (locale)

Pode ser necessaacuterio reconfigurar o fuso horaacuterio no servidor para coincidir com o fuso horaacuterio do local que o

servidor SIS-MA vai cobrir Se estiver a utilizar um servidor virtual privado o fuso horaacuterio por defeito pode natildeo

coincidir com o fuso horaacuterio do local do seu SIS-MA Pode reconfigurar facilmente o fuso horaacuterio invocando o

abaixo e seguindo as instruccedilotildees

sudo dpkg-reconfigure tzdata

O PostgreSQL eacute sensiacutevel as regiotildees entatildeo pode ter que instalar a sua regiatildeo primeiro Para verificar que regiotildees

existem e instalar novas (como por exemplo Portuguecircs) invoque os seguintes comandos

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

8 | P Aacute G I N A

locale ndasha

sudo locale-gen pt_PTUTF-8

4 Instalaccedilatildeo do motor de base de dados PostgreSQL

Para a instalaccedilatildeo do motor de base de dados PostgreSQL versatildeo 93 invoque o seguinte comando

sudo apt-get install postgresql-93

Mude para o utilizador postgres usando

sudo su postgres

Crie um utilizador natildeo previlegiado chamado ldquosismardquo

createuser -SDRP sisma

Introduza uma palavra passe segura no prompt

Crie duas bases de dados uma para a aplicaccedilatildeo sisma em produccedilatildeo e outra para o sisma com dados histoacutericos

invocando

createdb -O sisma sisma-prd

createdb -O sisma sisma-hist

Retorne a sessatildeo executando

exit

Apoacutes execuccedilatildeo dos comandos acima citados o motor de base de dados PostgreSQL estaraacute instalado com um

utilizador postgreSQL ldquosismardquo e uma base de dados ldquosisma2rdquo

5 Definir fuso horaacuterio do servidor e regiatildeo (locale)

Faccedila o ajuste de desempenho abrindo o seguinte arquivo ldquopostgresqlconfrdquo

sudo nano etcpostgresql93mainpostgresqlconf

e defina as seguintes propriedades

shared_buffers = 3200MB

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

9 | P Aacute G I N A

Determine quanta memoacuteria PostgreSQL pode usar para o cache de dados Esta configuraccedilatildeo controla como o

tamanho da memoacuteria compartilhada do kernel deve ser reservada para o PostgreSQL Deve ser ajustado para

cerca de 40 do total da memoacuteria designada para o PostgreSQL

work_mem = 20MB

Determine a quantidade de memoacuteria usada para operaccedilotildees internas de ordenaccedilatildeo e Hash Esta configuraccedilatildeo eacute por

conexatildeo por consulta para que uma quantidade de memoacuteria possa ser consumida se elevar demasiado Ajustar

correctamente este valor eacute essencial para o desemepenho da agregaccedilatildeo do SIS-MA

maintenance_work_mem = 512MB

Determine a quantidade de memoacuteria PostgreSQL possa ser utilizada para operaccedilotildees de manutenccedilatildeo como criar

iacutendices correr o vaccum adicionar chaves estrangeiras Aumentar este valor pode melhorar o desempenho da

criaccedilatildeo de iacutendices durante a anaacutelise e processos de geraccedilatildeo de data mart

effective_cache_size = 8000MB

Uma estimativa da quantidade de memoacuteria que eacute disponibilizada para cache de disco pelo sistema operativo (natildeo

uma alocaccedilatildeo) e eacute usada pelo PostgreSQL para determinar se um plano de consulta vai caber na memoacuteria ou natildeo

Defini-lo para um valor maior do que o que estaacute disponiacutevel iraacute resultar num mau desempenho Este valor deve ser

inclusivo da definiccedilatildeo do shared_buffers O PostgreSQL tem 2 camadas de cache a primeira camada utiliza a

memoacuteria partilhada kernel e eacute controlado pelo configuraccedilatildeo do shared_buffers O PostgreSQL delega a segunda

camada para o cache de disco do sistema operativo e o tamanho da memoacuteria disponiacutevel pode ser dado com a

configuraccedilatildeo do effective_cache_size

checkpoint_segments = 32

PostgreSQL escreve novas operaccedilotildees em um arquivo de log chamado ldquoWAL segmentsrdquo que tem um tamanho de

16 MB Quando um nuacutemero de segmentos eacute escrito um checkpoint ocorre Definir este nuacutemero para um nuacutemero

maior iraacute melhorar o desempenho de escrita

checkpoint_completion_target = 08

Determina a percentagem da conclusatildeo do segment antes que o checkpoint ocorra Defini-lo para um valor maior

iraacute difundir as gravaccedilotildees para fora e reduzir a sobrecarga meacutedia de gravaccedilatildeo

wal_buffers = 16MB

Define a memoacuteria usada para o buffer durante o processo de gravaccedilatildeo WAL Aumentando este valor pode melhorar

o rendimento em sistemas de gravaccedilatildeo pesada

synchronous_commit = off

Especifica se a transaccedilatildeo confirmada vai esperar por os registros WAL serem gravados no disco antes de retornar

para o cliente ou natildeo Configuranda-o para ldquooffrdquo iraacute melhorar consideravelmente o desempenho Implica tambeacutem

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

que haacute um ligeiro atraso entre informar ao cliente que a transaccedilatildeo foi com sucesso e transaccedilatildeo estar segura mas

o estado da base de dados natildeo pode ser corrompido e esta eacute uma boa alternativa para sistemas de desempenho

intensivo e gravaccedilatildeo pesada como o SIS-MA

wal_writer_delay = 10000ms

Especifique o atraso entre as operaccedilotildees de escrita WAL Defini-lo para um valor maior iraacute aumentar o desempenho

em sistema de escrita em massa uma vez que potencialmente muitas operaccedilotildees de escrita podem ser executadas

em uma uacutenica descarga para o disco

Faccedila o restart do PostgreSQL invocando

sudo etcinitdpostgresql restart

6 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraveacutes da configuraccedilatildeo do ficheiro chamado

ldquohibernatepropertiesrdquo

Crie 2 ficheiros conforme especificado abaixo e guarde eacute um local conveniente Os ficheiros correspondentes tem

as seguintes propriedades

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma produccedilatildeo

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-prd

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernatehbm2ddlauto = update

Um erro comum eacute ter um espaccedilo em branco apoacutes o uacuteltimo valor da propriedade Certifique-se que natildeo haacute espaccedilo

em branco no final de qualquer linha Lembre-se tambeacutem que este ficheiro conteacutem a senha em texto natildeo

criptografado para a sua base de dados logo eacute preciso proteger contra acessos natildeo autorizados Para isso

invoque

chmod 0600 hibernateproperties

Garantindo assim que somente o utilizador sisma que eacute o dono do ficheiro tem permissotildees de leitura do ficheiro

7 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte comando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invocando

java ndashversion

8 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat a partir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil para descarregar ficheiros da web eacute o ldquowgetrdquo

Extrai para uma localizaccedilatildeo conveniente Este manual pressupotildee que se tenha navegado para o diretoacuterio root do

arquivo extraiacutedo

Limpe todas as aplicaccedilotildees web preacute-instaladas invocando

rm -rf webapps

Crie 2 pastas idecircnticas para as 2 instacircncias SISMA a criar contendo os ficheiros tomcat

A partir da pasta do projecto SISMA na dropbox SISMA - Management RepositorydeliverablesPhase 4 -

Software development copie os ficheiros ldquoSISMAWARrdquo e ldquoROOTwarrdquo para o directoacuterio webapps dos 2 ambientes

Para cada um dos ambientes crie um ficheiro chamado setenvsh no directoacuterio bin do tomcat e adicione as linhas

abaixo A primeira vai definir a localizaccedilatildeo do seu Java Runtime Environment o segundo vai dedicar memoacuteria para

o Tomcat e o terceiro iraacute definir o local para onde SIS-MA vai procurar o ficheiro de configuraccedilatildeo

hibernateproperties

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

8 | P Aacute G I N A

locale ndasha

sudo locale-gen pt_PTUTF-8

4 Instalaccedilatildeo do motor de base de dados PostgreSQL

Para a instalaccedilatildeo do motor de base de dados PostgreSQL versatildeo 93 invoque o seguinte comando

sudo apt-get install postgresql-93

Mude para o utilizador postgres usando

sudo su postgres

Crie um utilizador natildeo previlegiado chamado ldquosismardquo

createuser -SDRP sisma

Introduza uma palavra passe segura no prompt

Crie duas bases de dados uma para a aplicaccedilatildeo sisma em produccedilatildeo e outra para o sisma com dados histoacutericos

invocando

createdb -O sisma sisma-prd

createdb -O sisma sisma-hist

Retorne a sessatildeo executando

exit

Apoacutes execuccedilatildeo dos comandos acima citados o motor de base de dados PostgreSQL estaraacute instalado com um

utilizador postgreSQL ldquosismardquo e uma base de dados ldquosisma2rdquo

5 Definir fuso horaacuterio do servidor e regiatildeo (locale)

Faccedila o ajuste de desempenho abrindo o seguinte arquivo ldquopostgresqlconfrdquo

sudo nano etcpostgresql93mainpostgresqlconf

e defina as seguintes propriedades

shared_buffers = 3200MB

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

9 | P Aacute G I N A

Determine quanta memoacuteria PostgreSQL pode usar para o cache de dados Esta configuraccedilatildeo controla como o

tamanho da memoacuteria compartilhada do kernel deve ser reservada para o PostgreSQL Deve ser ajustado para

cerca de 40 do total da memoacuteria designada para o PostgreSQL

work_mem = 20MB

Determine a quantidade de memoacuteria usada para operaccedilotildees internas de ordenaccedilatildeo e Hash Esta configuraccedilatildeo eacute por

conexatildeo por consulta para que uma quantidade de memoacuteria possa ser consumida se elevar demasiado Ajustar

correctamente este valor eacute essencial para o desemepenho da agregaccedilatildeo do SIS-MA

maintenance_work_mem = 512MB

Determine a quantidade de memoacuteria PostgreSQL possa ser utilizada para operaccedilotildees de manutenccedilatildeo como criar

iacutendices correr o vaccum adicionar chaves estrangeiras Aumentar este valor pode melhorar o desempenho da

criaccedilatildeo de iacutendices durante a anaacutelise e processos de geraccedilatildeo de data mart

effective_cache_size = 8000MB

Uma estimativa da quantidade de memoacuteria que eacute disponibilizada para cache de disco pelo sistema operativo (natildeo

uma alocaccedilatildeo) e eacute usada pelo PostgreSQL para determinar se um plano de consulta vai caber na memoacuteria ou natildeo

Defini-lo para um valor maior do que o que estaacute disponiacutevel iraacute resultar num mau desempenho Este valor deve ser

inclusivo da definiccedilatildeo do shared_buffers O PostgreSQL tem 2 camadas de cache a primeira camada utiliza a

memoacuteria partilhada kernel e eacute controlado pelo configuraccedilatildeo do shared_buffers O PostgreSQL delega a segunda

camada para o cache de disco do sistema operativo e o tamanho da memoacuteria disponiacutevel pode ser dado com a

configuraccedilatildeo do effective_cache_size

checkpoint_segments = 32

PostgreSQL escreve novas operaccedilotildees em um arquivo de log chamado ldquoWAL segmentsrdquo que tem um tamanho de

16 MB Quando um nuacutemero de segmentos eacute escrito um checkpoint ocorre Definir este nuacutemero para um nuacutemero

maior iraacute melhorar o desempenho de escrita

checkpoint_completion_target = 08

Determina a percentagem da conclusatildeo do segment antes que o checkpoint ocorra Defini-lo para um valor maior

iraacute difundir as gravaccedilotildees para fora e reduzir a sobrecarga meacutedia de gravaccedilatildeo

wal_buffers = 16MB

Define a memoacuteria usada para o buffer durante o processo de gravaccedilatildeo WAL Aumentando este valor pode melhorar

o rendimento em sistemas de gravaccedilatildeo pesada

synchronous_commit = off

Especifica se a transaccedilatildeo confirmada vai esperar por os registros WAL serem gravados no disco antes de retornar

para o cliente ou natildeo Configuranda-o para ldquooffrdquo iraacute melhorar consideravelmente o desempenho Implica tambeacutem

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

que haacute um ligeiro atraso entre informar ao cliente que a transaccedilatildeo foi com sucesso e transaccedilatildeo estar segura mas

o estado da base de dados natildeo pode ser corrompido e esta eacute uma boa alternativa para sistemas de desempenho

intensivo e gravaccedilatildeo pesada como o SIS-MA

wal_writer_delay = 10000ms

Especifique o atraso entre as operaccedilotildees de escrita WAL Defini-lo para um valor maior iraacute aumentar o desempenho

em sistema de escrita em massa uma vez que potencialmente muitas operaccedilotildees de escrita podem ser executadas

em uma uacutenica descarga para o disco

Faccedila o restart do PostgreSQL invocando

sudo etcinitdpostgresql restart

6 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraveacutes da configuraccedilatildeo do ficheiro chamado

ldquohibernatepropertiesrdquo

Crie 2 ficheiros conforme especificado abaixo e guarde eacute um local conveniente Os ficheiros correspondentes tem

as seguintes propriedades

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma produccedilatildeo

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-prd

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernatehbm2ddlauto = update

Um erro comum eacute ter um espaccedilo em branco apoacutes o uacuteltimo valor da propriedade Certifique-se que natildeo haacute espaccedilo

em branco no final de qualquer linha Lembre-se tambeacutem que este ficheiro conteacutem a senha em texto natildeo

criptografado para a sua base de dados logo eacute preciso proteger contra acessos natildeo autorizados Para isso

invoque

chmod 0600 hibernateproperties

Garantindo assim que somente o utilizador sisma que eacute o dono do ficheiro tem permissotildees de leitura do ficheiro

7 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte comando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invocando

java ndashversion

8 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat a partir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil para descarregar ficheiros da web eacute o ldquowgetrdquo

Extrai para uma localizaccedilatildeo conveniente Este manual pressupotildee que se tenha navegado para o diretoacuterio root do

arquivo extraiacutedo

Limpe todas as aplicaccedilotildees web preacute-instaladas invocando

rm -rf webapps

Crie 2 pastas idecircnticas para as 2 instacircncias SISMA a criar contendo os ficheiros tomcat

A partir da pasta do projecto SISMA na dropbox SISMA - Management RepositorydeliverablesPhase 4 -

Software development copie os ficheiros ldquoSISMAWARrdquo e ldquoROOTwarrdquo para o directoacuterio webapps dos 2 ambientes

Para cada um dos ambientes crie um ficheiro chamado setenvsh no directoacuterio bin do tomcat e adicione as linhas

abaixo A primeira vai definir a localizaccedilatildeo do seu Java Runtime Environment o segundo vai dedicar memoacuteria para

o Tomcat e o terceiro iraacute definir o local para onde SIS-MA vai procurar o ficheiro de configuraccedilatildeo

hibernateproperties

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

9 | P Aacute G I N A

Determine quanta memoacuteria PostgreSQL pode usar para o cache de dados Esta configuraccedilatildeo controla como o

tamanho da memoacuteria compartilhada do kernel deve ser reservada para o PostgreSQL Deve ser ajustado para

cerca de 40 do total da memoacuteria designada para o PostgreSQL

work_mem = 20MB

Determine a quantidade de memoacuteria usada para operaccedilotildees internas de ordenaccedilatildeo e Hash Esta configuraccedilatildeo eacute por

conexatildeo por consulta para que uma quantidade de memoacuteria possa ser consumida se elevar demasiado Ajustar

correctamente este valor eacute essencial para o desemepenho da agregaccedilatildeo do SIS-MA

maintenance_work_mem = 512MB

Determine a quantidade de memoacuteria PostgreSQL possa ser utilizada para operaccedilotildees de manutenccedilatildeo como criar

iacutendices correr o vaccum adicionar chaves estrangeiras Aumentar este valor pode melhorar o desempenho da

criaccedilatildeo de iacutendices durante a anaacutelise e processos de geraccedilatildeo de data mart

effective_cache_size = 8000MB

Uma estimativa da quantidade de memoacuteria que eacute disponibilizada para cache de disco pelo sistema operativo (natildeo

uma alocaccedilatildeo) e eacute usada pelo PostgreSQL para determinar se um plano de consulta vai caber na memoacuteria ou natildeo

Defini-lo para um valor maior do que o que estaacute disponiacutevel iraacute resultar num mau desempenho Este valor deve ser

inclusivo da definiccedilatildeo do shared_buffers O PostgreSQL tem 2 camadas de cache a primeira camada utiliza a

memoacuteria partilhada kernel e eacute controlado pelo configuraccedilatildeo do shared_buffers O PostgreSQL delega a segunda

camada para o cache de disco do sistema operativo e o tamanho da memoacuteria disponiacutevel pode ser dado com a

configuraccedilatildeo do effective_cache_size

checkpoint_segments = 32

PostgreSQL escreve novas operaccedilotildees em um arquivo de log chamado ldquoWAL segmentsrdquo que tem um tamanho de

16 MB Quando um nuacutemero de segmentos eacute escrito um checkpoint ocorre Definir este nuacutemero para um nuacutemero

maior iraacute melhorar o desempenho de escrita

checkpoint_completion_target = 08

Determina a percentagem da conclusatildeo do segment antes que o checkpoint ocorra Defini-lo para um valor maior

iraacute difundir as gravaccedilotildees para fora e reduzir a sobrecarga meacutedia de gravaccedilatildeo

wal_buffers = 16MB

Define a memoacuteria usada para o buffer durante o processo de gravaccedilatildeo WAL Aumentando este valor pode melhorar

o rendimento em sistemas de gravaccedilatildeo pesada

synchronous_commit = off

Especifica se a transaccedilatildeo confirmada vai esperar por os registros WAL serem gravados no disco antes de retornar

para o cliente ou natildeo Configuranda-o para ldquooffrdquo iraacute melhorar consideravelmente o desempenho Implica tambeacutem

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

que haacute um ligeiro atraso entre informar ao cliente que a transaccedilatildeo foi com sucesso e transaccedilatildeo estar segura mas

o estado da base de dados natildeo pode ser corrompido e esta eacute uma boa alternativa para sistemas de desempenho

intensivo e gravaccedilatildeo pesada como o SIS-MA

wal_writer_delay = 10000ms

Especifique o atraso entre as operaccedilotildees de escrita WAL Defini-lo para um valor maior iraacute aumentar o desempenho

em sistema de escrita em massa uma vez que potencialmente muitas operaccedilotildees de escrita podem ser executadas

em uma uacutenica descarga para o disco

Faccedila o restart do PostgreSQL invocando

sudo etcinitdpostgresql restart

6 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraveacutes da configuraccedilatildeo do ficheiro chamado

ldquohibernatepropertiesrdquo

Crie 2 ficheiros conforme especificado abaixo e guarde eacute um local conveniente Os ficheiros correspondentes tem

as seguintes propriedades

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma produccedilatildeo

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-prd

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernatehbm2ddlauto = update

Um erro comum eacute ter um espaccedilo em branco apoacutes o uacuteltimo valor da propriedade Certifique-se que natildeo haacute espaccedilo

em branco no final de qualquer linha Lembre-se tambeacutem que este ficheiro conteacutem a senha em texto natildeo

criptografado para a sua base de dados logo eacute preciso proteger contra acessos natildeo autorizados Para isso

invoque

chmod 0600 hibernateproperties

Garantindo assim que somente o utilizador sisma que eacute o dono do ficheiro tem permissotildees de leitura do ficheiro

7 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte comando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invocando

java ndashversion

8 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat a partir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil para descarregar ficheiros da web eacute o ldquowgetrdquo

Extrai para uma localizaccedilatildeo conveniente Este manual pressupotildee que se tenha navegado para o diretoacuterio root do

arquivo extraiacutedo

Limpe todas as aplicaccedilotildees web preacute-instaladas invocando

rm -rf webapps

Crie 2 pastas idecircnticas para as 2 instacircncias SISMA a criar contendo os ficheiros tomcat

A partir da pasta do projecto SISMA na dropbox SISMA - Management RepositorydeliverablesPhase 4 -

Software development copie os ficheiros ldquoSISMAWARrdquo e ldquoROOTwarrdquo para o directoacuterio webapps dos 2 ambientes

Para cada um dos ambientes crie um ficheiro chamado setenvsh no directoacuterio bin do tomcat e adicione as linhas

abaixo A primeira vai definir a localizaccedilatildeo do seu Java Runtime Environment o segundo vai dedicar memoacuteria para

o Tomcat e o terceiro iraacute definir o local para onde SIS-MA vai procurar o ficheiro de configuraccedilatildeo

hibernateproperties

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

que haacute um ligeiro atraso entre informar ao cliente que a transaccedilatildeo foi com sucesso e transaccedilatildeo estar segura mas

o estado da base de dados natildeo pode ser corrompido e esta eacute uma boa alternativa para sistemas de desempenho

intensivo e gravaccedilatildeo pesada como o SIS-MA

wal_writer_delay = 10000ms

Especifique o atraso entre as operaccedilotildees de escrita WAL Defini-lo para um valor maior iraacute aumentar o desempenho

em sistema de escrita em massa uma vez que potencialmente muitas operaccedilotildees de escrita podem ser executadas

em uma uacutenica descarga para o disco

Faccedila o restart do PostgreSQL invocando

sudo etcinitdpostgresql restart

6 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraveacutes da configuraccedilatildeo do ficheiro chamado

ldquohibernatepropertiesrdquo

Crie 2 ficheiros conforme especificado abaixo e guarde eacute um local conveniente Os ficheiros correspondentes tem

as seguintes propriedades

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma produccedilatildeo

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-prd

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernatehbm2ddlauto = update

Um erro comum eacute ter um espaccedilo em branco apoacutes o uacuteltimo valor da propriedade Certifique-se que natildeo haacute espaccedilo

em branco no final de qualquer linha Lembre-se tambeacutem que este ficheiro conteacutem a senha em texto natildeo

criptografado para a sua base de dados logo eacute preciso proteger contra acessos natildeo autorizados Para isso

invoque

chmod 0600 hibernateproperties

Garantindo assim que somente o utilizador sisma que eacute o dono do ficheiro tem permissotildees de leitura do ficheiro

7 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte comando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invocando

java ndashversion

8 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat a partir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil para descarregar ficheiros da web eacute o ldquowgetrdquo

Extrai para uma localizaccedilatildeo conveniente Este manual pressupotildee que se tenha navegado para o diretoacuterio root do

arquivo extraiacutedo

Limpe todas as aplicaccedilotildees web preacute-instaladas invocando

rm -rf webapps

Crie 2 pastas idecircnticas para as 2 instacircncias SISMA a criar contendo os ficheiros tomcat

A partir da pasta do projecto SISMA na dropbox SISMA - Management RepositorydeliverablesPhase 4 -

Software development copie os ficheiros ldquoSISMAWARrdquo e ldquoROOTwarrdquo para o directoacuterio webapps dos 2 ambientes

Para cada um dos ambientes crie um ficheiro chamado setenvsh no directoacuterio bin do tomcat e adicione as linhas

abaixo A primeira vai definir a localizaccedilatildeo do seu Java Runtime Environment o segundo vai dedicar memoacuteria para

o Tomcat e o terceiro iraacute definir o local para onde SIS-MA vai procurar o ficheiro de configuraccedilatildeo

hibernateproperties

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernatehbm2ddlauto = update

Um erro comum eacute ter um espaccedilo em branco apoacutes o uacuteltimo valor da propriedade Certifique-se que natildeo haacute espaccedilo

em branco no final de qualquer linha Lembre-se tambeacutem que este ficheiro conteacutem a senha em texto natildeo

criptografado para a sua base de dados logo eacute preciso proteger contra acessos natildeo autorizados Para isso

invoque

chmod 0600 hibernateproperties

Garantindo assim que somente o utilizador sisma que eacute o dono do ficheiro tem permissotildees de leitura do ficheiro

7 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte comando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invocando

java ndashversion

8 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat a partir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil para descarregar ficheiros da web eacute o ldquowgetrdquo

Extrai para uma localizaccedilatildeo conveniente Este manual pressupotildee que se tenha navegado para o diretoacuterio root do

arquivo extraiacutedo

Limpe todas as aplicaccedilotildees web preacute-instaladas invocando

rm -rf webapps

Crie 2 pastas idecircnticas para as 2 instacircncias SISMA a criar contendo os ficheiros tomcat

A partir da pasta do projecto SISMA na dropbox SISMA - Management RepositorydeliverablesPhase 4 -

Software development copie os ficheiros ldquoSISMAWARrdquo e ldquoROOTwarrdquo para o directoacuterio webapps dos 2 ambientes

Para cada um dos ambientes crie um ficheiro chamado setenvsh no directoacuterio bin do tomcat e adicione as linhas

abaixo A primeira vai definir a localizaccedilatildeo do seu Java Runtime Environment o segundo vai dedicar memoacuteria para

o Tomcat e o terceiro iraacute definir o local para onde SIS-MA vai procurar o ficheiro de configuraccedilatildeo

hibernateproperties

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

12 | P Aacute G I N A

Por favor verifique se o caminho dos binaacuterios do Java estatildeo corretas jaacute que podem variar de sistema para sistema

por exemplo em sistemas AMD pode-se ver em java-7-openjdk-amd64 Note que deveraacute ajustar esta ao seu

ambiente

export JAVA_HOME=usrlibjvmjava-7-openjdk

export JAVA_OPTS=-Xmx7500m -Xms4000m -XXMaxPermSize=500m -XXPermSize=300m

export DHIS2_HOME=homesismaconfig (directoacuterio do ficheiro hibernateproperties)

Configure a porta do Tomcat que atende a pedidos abra o ficheiro de configuraccedilatildeo do Tomcat confserverxml

localize o elemento ltConnectorgt que natildeo eacute comentada e altere o valor do atributo da porta para o nuacutemero da

porta desejada para que as 2 instacircncias SISMA funcionem em portas diferentes

Para monitorar o comportamento do Tomcat o log eacute a principal fonte de informaccedilatildeo Os registros podem ser

facilmente visualizados a partir do comando

tail -f logscatalinaout

9 Executar o SISMA

Faccedila o script do executaacutevel de inicializaccedilatildeo invocando

chmod 755 bin

O SISMA pode ser iniciadointerrompido invocando

binstartupsh

binshutdownsh

O ficheiro log pode ser monitorado atraveacutes do comando

tail -f logscatalinaout

33 Acesso ao SISMA

Para aceder as instacircncias SISMA abra um browser preferencialmente o google chrome e coloque o seguinte link

httplocalhost8080 para o sisma produccedilatildeo

httplocalhost8082 para o sisma histoacuterico

Para aceder a partir de um outro computador na rede use

httpIP do servidor8080 ou httpDNS8080 para o sisma produccedilatildeo

httpIP do servidor8082 ou httpDNS80802 para o sisma histoacuterico

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

4 Maacutequinas Cliente Este capiacutetulo sistematiza os passos necessaacuterios para a instalaccedilatildeo do SIS-MA em clientes

411 Preacute-requisitos das maacutequinas cliente

Os preacute-requisitos miacutenimos necessaacuterios para instalaccedilatildeo do SIS-MA nos Distritos com ligaccedilatildeo agrave internet (instalaccedilatildeo

online) satildeo os seguintes

Sistema Operativo Windows XP ou superior

Ligaccedilatildeo estaacutevel a internet

Uso do browser Google Chrome

412 Instalaccedilatildeo e Configuraccedilatildeo

Para os casos em que os clientes tem acesso a internet estes natildeo necessitam de nenhuma instalaccedilatildeo e

configuraccedilatildeo Devem apenas aceder a aplicaccedilatildeo SISMA a partir do browser Google Chrome para o link

disponibilizado

413 Acesso ao sisma

Para aceder ao SISMA deve-se usar o link disponibilizado

httprsquoDNSrsquorsquoportarsquo onde o DNS e porta satildeo os detalhes definidos pelo administrador do sistema para a aplicaccedilatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

14 | P Aacute G I N A

5 Continuidade e Manutenccedilatildeo Este capiacutetulo pretende especificar algumas acccedilotildees importantes e necessaacuterias durante o uso da aplicaccedilatildeo SISMA

online

1 Como efectuar um backup de base de dados no servidor central

Periodicamente deve-se efectuar um backup da base de dados da aplicaccedilatildeo SISMA online Este podem ser feitos

de 2 formas

o Exportaccedilatildeo de dados e metadados (configuraccedilotildees) a partir da aplicaccedilatildeo SISMA

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gt ltnome ficheiro outputgtgz

2 Como fazer backup da aplicaccedilatildeo SISMA no servidor central

Para fazer um backup geral da aplicaccedilatildeo SISMA (sem base de dados) deve-se copiar o directoacuterio criado para a

aplicaccedilatildeo contendo os ficheiros Tomcat e o ficheiro Hibernateproperties

3 A aplicaccedilatildeo SISMA apresenta erros durante o seu uso

Para interpretar a proveniecircncia dos erros eacute importante que se visualize os logs da aplicaccedilatildeo

Para a aplicaccedilatildeo SISMA on-line verifique no directoacuterio

logscatalinaout

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

Ficha Teacutecnica

Tiacutetulo Manual de Administraccedilatildeo do Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo - SISMA

Editor Ministeacuterio da Sauacutede - Direcccedilatildeo de Planificaccedilatildeo e Cooperaccedilatildeo (DPC) ndash Departamento de Informaccedilatildeo para Sauacutede ndash DIS

Direcccedilatildeo Ceacutelia Gonccedilalves ndash Directora Nacional de Planificaccedilatildeo e Cooperaccedilatildeo

Coordenaccedilatildeo Cidaacutelia Baloi

Revisatildeo da versatildeo 213 - 218

Oreste Parlatano Adelino Covane Joatildeo Machiana Antoacutenio Sitoacutei Marcelino Mugai Nayo Macamo Joseacute Chauacuteque Martins Miranda

Apoio teacutecnico UEM-MOASIS Jembi Health Systems Critical Software

Financiamento CDC Moccedilambique Design

Criacutetical Software

Impressatildeo e acabamentos

UEM-MOASIS Jembi Health Systems httpwwwjembiorg httpwwwmoasisorgmz

Endereccedilo Direcccedilatildeo de Planificaccedilatildeo e Cooperaccedilatildeo ndash Departamento de Informaccedilatildeo para Sauacutede Ministeacuterio da Sauacutede Av Eduardo MondlaneSalvador Allende 1008 wwwmisaugovmz

Maputo ndash Moccedilambique

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

Ficha Teacutecnica

Tiacutetulo Manual de Administraccedilatildeo do Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo - SISMA

Editor Ministeacuterio da Sauacutede - Direcccedilatildeo de Planificaccedilatildeo e Cooperaccedilatildeo (DPC) ndash Departamento de Informaccedilatildeo para Sauacutede ndash DIS

Direcccedilatildeo Ceacutelia Gonccedilalves ndash Directora Nacional de Planificaccedilatildeo e Cooperaccedilatildeo

Coordenaccedilatildeo Cidaacutelia Baloi

Revisatildeo da versatildeo 213 - 218

Oreste Parlatano Adelino Covane Joatildeo Machiana Antoacutenio Sitoacutei Marcelino Mugai Nayo Macamo Joseacute Chauacuteque Martins Miranda

Apoio teacutecnico UEM-MOASIS Jembi Health Systems Critical Software

Financiamento CDC Moccedilambique Design

Criacutetical Software

Impressatildeo e acabamentos

UEM-MOASIS Jembi Health Systems httpwwwjembiorg httpwwwmoasisorgmz

Endereccedilo Direcccedilatildeo de Planificaccedilatildeo e Cooperaccedilatildeo ndash Departamento de Informaccedilatildeo para Sauacutede Ministeacuterio da Sauacutede Av Eduardo MondlaneSalvador Allende 1008 wwwmisaugovmz

Maputo ndash Moccedilambique