mozambican open república de...

22
República de Moçambique MINISTÉRIO DA SAÚDE Direcção de Planificação e Cooperação Departamento de Informação para a Saúde MOZAMBICAN OPEN ARCHITECTURES, STANDARDS AND INFORMATION SYSTEMS Avenida Julius Nyerere, nº 3326 Condomínio Diplomatic Village, Casa nº 1 Tels: 21902424 - 823069636 - 843069636 - web: http://www.moasis.org.mz - Maputo Moçambique 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 l[email protected] Websitewww.jembi.org Manual de Administração do SISMA Sistema de Informação de Saúde para Monitoria e Avaliação Abril de 2014 Versão 1.0

Upload: dangliem

Post on 10-Nov-2018

213 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

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

linfojembiorgWebsitewwwjembiorg

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

Avaliaccedilatildeo

Abril de 2014

Versatildeo 10

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

2 | P Aacute G I N A

AGRADECIMENTOS

A 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 13

4 Maacutequinas Cliente 14 41 Modo On-line 14

411 Preacute-requisitos das maacutequinas cliente 14 412 Instalaccedilatildeo e Configuraccedilatildeo 14 413 Acesso ao sisma 14

42 Modo Off-line 14 421 Preacute-requisitos das maacutequinas cliente 14 422 Instalaccedilatildeo e Configuraccedilatildeo 15 423 Acesso ao sisma 19

5 Continuidade e Manutenccedilatildeo 21 6 Ficha Teacutecnica 22

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

Tabela1 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 e a niacutevel de cliente 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 histoacutericosNo caso dos clientes a mesma poderaacute ser on-line ou off-line dependendo se existe ou natildeo

conectividade agrave internet

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

foacutecus deste documento e do respectivo instalador 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)

Clientes Off-Line

o Sistema Operativo Windows XP ou superior

o Memoacuteria RAM 1 GB ou Superior

o Motor de BD H2

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

provincial e distrital A instalaccedilatildeo do sistema ao niacutevel cliente deveraacute ser sempre efectuada utilizando o instalador

concebido em Inno Setup1 ferramenta open source usada para criar instaladores para o Sistema Operativo

Windows 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 causa2

1httpwwwjrsoftwareorgisinfophp

2httpwwwubuntucom 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 nuacutecleos

de CPU e disco riacutegido adequados Quanto mais potente o servidor for nas caracteriacutesticas anteriormente

especificadas melhor a aplicaccedilatildeo funcionaraacute

Memoacuteria RAM 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 1204 de 64

Bits usando postgreSQL como sistema de base de dados e Tomcat como recepiente 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 do 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 seje dividida mais ou menos igualmente entre o banco 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 assim como o passo para o ajuste de desempenho podem ser efectuados

em uma fase posterior

1 Criaccedilatildeo de um novo utilizador (Opcional)

Natildeo eacute recomendada a execuccedilatildeo usando o utilizador ldquorootrdquo Se pretender criar um novo utilizador para a execuccedilatildeo

do SISMA invoque os seguintes comandos

Criar um novo utilizador chamado ldquosismardquo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

7 | P Aacute G I N A

useradd ndashd homesisma ndashm sisma ndashs binbash

Se natildeo existe um grupo admin criado este deve ser criado da seguinte forma

groupadd admin

Atribuir ao utlizador a execuccedilatildeo temporaacuteria de operaccedilotildees como root

usermod ndashG admin sisma

Atribuir uma palavra passe para a conta

Passwd sisma

Certifique que introduza uma palavra passe forte Se pretender desabilitar o login remoto para a conta root invoque

o comando

sudo passwd ndashl root

2 Ajuste do Sistema operativo Kernel

Estas configuraccedilotildees satildeo opcionais excepto a configuraccedilatildeo da memoacuteria partilhada pois eacute necessaacuterio para a

alocaccedilatildeo em postgreSQL

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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

8 | P Aacute G I N A

3 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte commando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invoncado

java ndashversion

4 Instalaccedilatildeo do motorde base de dados PostgreSQL

Para a instalaccedilatildeo do motor de base de dados PostgreSQL versatildeo 91 primeiramente deve-se adicionar o

repositoacuterio de pacotes Ubuntu para o sistema em uso

sudo apt-get install python-software-properties

sudo add-apt-repository ppapittipostgresql

sudo apt-get update

Invoque o seguinte comando para instalar o PostgreSQL

sudo apt-get install postgresql-91

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 base 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

9 | P Aacute G I N A

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

Faccedila o ajuste de desempenho abrindo o seguinte arquivo ldquopostgresqlconfrdquo

sudo nano etcpostgresql91mainpostgresqlconf

e defina as seguintes propriedades

shared_buffers = 2400MB

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 30 do total da memoacuteria designada para o PostgreSQL

work_mem = 20MB

Determine a quantidade de memoacuteria usada para para ordenaccedilatildeo interna e operaccedilotildees hash Esta configuraccedilatildeo eacute

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

maintenance_work_mem = 256MB

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 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_buffersOPostgreSQL tem 2 camadas de cache a primeira camada utiliza a

memoacuteria partilhada kernel e eacute controlado pelo configuraccedilatildeo do shared_buffers OPostgreSQL 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 MBQuando um nuacutemero de segmentos eacute escrito um checkpoint ocorre Definir este nuacutemero para um nuacutemero

maior iraacute melhorar o desempenho de escrita

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

checkpoint_completion_target = 08

Determine 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

Defina amemoacuteria usada parao bufferduranteo processo de gravaccedilatildeoWAL Aumentar este valorpodemelhorar o

rendimentoem sistemas degravaccedilatildeopesada

synchronous_commit = off

Especifique se a transaccedilatildeo for confirmadavai esperar por os registros WAL seremgravados no discoantes de

retornar parao clienteou natildeoConfigurando-o paraldquooffrdquoiraacute melhorarconsideravelmenteo desempenhoImplica

tambeacutem quehaacute um ligeiroatraso do relatoacuterio de transaccedilatildeo com sucesso para o cliente mas o estado do banco de

dadosnatildeo pode sercorrompidoe esta eacute umaboa alternativa para o desempenho intensivo e escrita em sistema

pesados 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

5 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraacuteves 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Um erro comumeacute ter umespaccedilo em brancoapoacutes o uacuteltimovalor da propriedade Certifique-seque natildeo haacuteespaccedilo em

brancono final dequalquer linhaLembre-se tambeacutemque este ficheiroconteacutem asenha em textoclaro para o

seubanco de dadoslogo eacute preciso protegercontra acessosnatildeo autorizadosPara isso invoque

chmodinvoke0600hibernateproperties

Garantindo assim quesomente o utilizadorsismatem permissotildees de leitura e escrita sobre o ficheiro

6 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat apartir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil paradownload de ficheiros dawebeacute o ldquowgetrdquo

Extrai parauma localizaccedilatildeo conveniente Este manualpressupotildee que se tenhanavegadopara o diretoacuterio rootdo

arquivoextraiacutedo

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

Apartir 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

12 | P Aacute G I N A

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

abaixo A primeiravai definira localizaccedilatildeo do seuJavaRuntime Environment o segundo vai dedicarmemoacuteriapara o

Tomcate o terceiroiraacute definiro local paraondeSIS-MA vaiprocuraro ficheiro de configuraccedilatildeohibernateproperties

Por favorverifique se ocaminhodos binaacuterios doJavaestatildeo corretas jaacute que podem variar de sistemapara sistemapor

exemploemsistemas AMDpode-sever em java-7-openjdk-amd64 Note quedeveraacuteajustar estaao seu ambiente

export JAVA_HOME=usrlibjvmjava-7-openjdk

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

exportDHIS2_HOME=homesismaconfig (directoacuterio do ficheiro hibernateproperties)

Configure a portaqueo Tomcatatende a pedidosabraoficheirode configuraccedilatildeo do Tomcat confserverxml localize

o elemento ltConnectorgtque natildeoeacute comentadae altereo valor do atributoda porta parao nuacutemero da portadesejada

para que as 2 instacircncias SISMA funcionem em portas diferentes

Para monitoraro comportamento doTomcatologeacute a principal fontede informaccedilatildeoOs registros podemser facilmente

visualizadosa partir do comando

tail -f logscatalinaout

7 Definiccedilatildeo do tempo doservidor

Deve-sedefinir correctamente a datado servidorde acordo como fuso horaacuterio emquea parte

principaldosutilizadores do sistemaestatildeo localizadosIsso vai afectar por exemplo quandoas tarefas

agendadassatildeo executadas

8 Executar o SISMA

Faccedila o script do executaacutevelde inicializaccedilatildeoinvocando

chmod 755bin

O SISMA pode ser iniciadointerrompido invocando

binstartupsh

binshutdownsh

O ficheiro log pode ser monitorado atraveacutes do comando

tail -f logscatalinaout

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

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

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 2: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

2 | P Aacute G I N A

AGRADECIMENTOS

A 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 13

4 Maacutequinas Cliente 14 41 Modo On-line 14

411 Preacute-requisitos das maacutequinas cliente 14 412 Instalaccedilatildeo e Configuraccedilatildeo 14 413 Acesso ao sisma 14

42 Modo Off-line 14 421 Preacute-requisitos das maacutequinas cliente 14 422 Instalaccedilatildeo e Configuraccedilatildeo 15 423 Acesso ao sisma 19

5 Continuidade e Manutenccedilatildeo 21 6 Ficha Teacutecnica 22

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

Tabela1 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 e a niacutevel de cliente 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 histoacutericosNo caso dos clientes a mesma poderaacute ser on-line ou off-line dependendo se existe ou natildeo

conectividade agrave internet

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

foacutecus deste documento e do respectivo instalador 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)

Clientes Off-Line

o Sistema Operativo Windows XP ou superior

o Memoacuteria RAM 1 GB ou Superior

o Motor de BD H2

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

provincial e distrital A instalaccedilatildeo do sistema ao niacutevel cliente deveraacute ser sempre efectuada utilizando o instalador

concebido em Inno Setup1 ferramenta open source usada para criar instaladores para o Sistema Operativo

Windows 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 causa2

1httpwwwjrsoftwareorgisinfophp

2httpwwwubuntucom 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 nuacutecleos

de CPU e disco riacutegido adequados Quanto mais potente o servidor for nas caracteriacutesticas anteriormente

especificadas melhor a aplicaccedilatildeo funcionaraacute

Memoacuteria RAM 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 1204 de 64

Bits usando postgreSQL como sistema de base de dados e Tomcat como recepiente 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 do 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 seje dividida mais ou menos igualmente entre o banco 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 assim como o passo para o ajuste de desempenho podem ser efectuados

em uma fase posterior

1 Criaccedilatildeo de um novo utilizador (Opcional)

Natildeo eacute recomendada a execuccedilatildeo usando o utilizador ldquorootrdquo Se pretender criar um novo utilizador para a execuccedilatildeo

do SISMA invoque os seguintes comandos

Criar um novo utilizador chamado ldquosismardquo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

7 | P Aacute G I N A

useradd ndashd homesisma ndashm sisma ndashs binbash

Se natildeo existe um grupo admin criado este deve ser criado da seguinte forma

groupadd admin

Atribuir ao utlizador a execuccedilatildeo temporaacuteria de operaccedilotildees como root

usermod ndashG admin sisma

Atribuir uma palavra passe para a conta

Passwd sisma

Certifique que introduza uma palavra passe forte Se pretender desabilitar o login remoto para a conta root invoque

o comando

sudo passwd ndashl root

2 Ajuste do Sistema operativo Kernel

Estas configuraccedilotildees satildeo opcionais excepto a configuraccedilatildeo da memoacuteria partilhada pois eacute necessaacuterio para a

alocaccedilatildeo em postgreSQL

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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

8 | P Aacute G I N A

3 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte commando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invoncado

java ndashversion

4 Instalaccedilatildeo do motorde base de dados PostgreSQL

Para a instalaccedilatildeo do motor de base de dados PostgreSQL versatildeo 91 primeiramente deve-se adicionar o

repositoacuterio de pacotes Ubuntu para o sistema em uso

sudo apt-get install python-software-properties

sudo add-apt-repository ppapittipostgresql

sudo apt-get update

Invoque o seguinte comando para instalar o PostgreSQL

sudo apt-get install postgresql-91

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 base 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

9 | P Aacute G I N A

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

Faccedila o ajuste de desempenho abrindo o seguinte arquivo ldquopostgresqlconfrdquo

sudo nano etcpostgresql91mainpostgresqlconf

e defina as seguintes propriedades

shared_buffers = 2400MB

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 30 do total da memoacuteria designada para o PostgreSQL

work_mem = 20MB

Determine a quantidade de memoacuteria usada para para ordenaccedilatildeo interna e operaccedilotildees hash Esta configuraccedilatildeo eacute

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

maintenance_work_mem = 256MB

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 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_buffersOPostgreSQL tem 2 camadas de cache a primeira camada utiliza a

memoacuteria partilhada kernel e eacute controlado pelo configuraccedilatildeo do shared_buffers OPostgreSQL 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 MBQuando um nuacutemero de segmentos eacute escrito um checkpoint ocorre Definir este nuacutemero para um nuacutemero

maior iraacute melhorar o desempenho de escrita

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

checkpoint_completion_target = 08

Determine 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

Defina amemoacuteria usada parao bufferduranteo processo de gravaccedilatildeoWAL Aumentar este valorpodemelhorar o

rendimentoem sistemas degravaccedilatildeopesada

synchronous_commit = off

Especifique se a transaccedilatildeo for confirmadavai esperar por os registros WAL seremgravados no discoantes de

retornar parao clienteou natildeoConfigurando-o paraldquooffrdquoiraacute melhorarconsideravelmenteo desempenhoImplica

tambeacutem quehaacute um ligeiroatraso do relatoacuterio de transaccedilatildeo com sucesso para o cliente mas o estado do banco de

dadosnatildeo pode sercorrompidoe esta eacute umaboa alternativa para o desempenho intensivo e escrita em sistema

pesados 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

5 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraacuteves 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Um erro comumeacute ter umespaccedilo em brancoapoacutes o uacuteltimovalor da propriedade Certifique-seque natildeo haacuteespaccedilo em

brancono final dequalquer linhaLembre-se tambeacutemque este ficheiroconteacutem asenha em textoclaro para o

seubanco de dadoslogo eacute preciso protegercontra acessosnatildeo autorizadosPara isso invoque

chmodinvoke0600hibernateproperties

Garantindo assim quesomente o utilizadorsismatem permissotildees de leitura e escrita sobre o ficheiro

6 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat apartir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil paradownload de ficheiros dawebeacute o ldquowgetrdquo

Extrai parauma localizaccedilatildeo conveniente Este manualpressupotildee que se tenhanavegadopara o diretoacuterio rootdo

arquivoextraiacutedo

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

Apartir 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

12 | P Aacute G I N A

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

abaixo A primeiravai definira localizaccedilatildeo do seuJavaRuntime Environment o segundo vai dedicarmemoacuteriapara o

Tomcate o terceiroiraacute definiro local paraondeSIS-MA vaiprocuraro ficheiro de configuraccedilatildeohibernateproperties

Por favorverifique se ocaminhodos binaacuterios doJavaestatildeo corretas jaacute que podem variar de sistemapara sistemapor

exemploemsistemas AMDpode-sever em java-7-openjdk-amd64 Note quedeveraacuteajustar estaao seu ambiente

export JAVA_HOME=usrlibjvmjava-7-openjdk

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

exportDHIS2_HOME=homesismaconfig (directoacuterio do ficheiro hibernateproperties)

Configure a portaqueo Tomcatatende a pedidosabraoficheirode configuraccedilatildeo do Tomcat confserverxml localize

o elemento ltConnectorgtque natildeoeacute comentadae altereo valor do atributoda porta parao nuacutemero da portadesejada

para que as 2 instacircncias SISMA funcionem em portas diferentes

Para monitoraro comportamento doTomcatologeacute a principal fontede informaccedilatildeoOs registros podemser facilmente

visualizadosa partir do comando

tail -f logscatalinaout

7 Definiccedilatildeo do tempo doservidor

Deve-sedefinir correctamente a datado servidorde acordo como fuso horaacuterio emquea parte

principaldosutilizadores do sistemaestatildeo localizadosIsso vai afectar por exemplo quandoas tarefas

agendadassatildeo executadas

8 Executar o SISMA

Faccedila o script do executaacutevelde inicializaccedilatildeoinvocando

chmod 755bin

O SISMA pode ser iniciadointerrompido invocando

binstartupsh

binshutdownsh

O ficheiro log pode ser monitorado atraveacutes do comando

tail -f logscatalinaout

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

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

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 3: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

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 13

4 Maacutequinas Cliente 14 41 Modo On-line 14

411 Preacute-requisitos das maacutequinas cliente 14 412 Instalaccedilatildeo e Configuraccedilatildeo 14 413 Acesso ao sisma 14

42 Modo Off-line 14 421 Preacute-requisitos das maacutequinas cliente 14 422 Instalaccedilatildeo e Configuraccedilatildeo 15 423 Acesso ao sisma 19

5 Continuidade e Manutenccedilatildeo 21 6 Ficha Teacutecnica 22

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

Tabela1 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 e a niacutevel de cliente 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 histoacutericosNo caso dos clientes a mesma poderaacute ser on-line ou off-line dependendo se existe ou natildeo

conectividade agrave internet

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

foacutecus deste documento e do respectivo instalador 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)

Clientes Off-Line

o Sistema Operativo Windows XP ou superior

o Memoacuteria RAM 1 GB ou Superior

o Motor de BD H2

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

provincial e distrital A instalaccedilatildeo do sistema ao niacutevel cliente deveraacute ser sempre efectuada utilizando o instalador

concebido em Inno Setup1 ferramenta open source usada para criar instaladores para o Sistema Operativo

Windows 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 causa2

1httpwwwjrsoftwareorgisinfophp

2httpwwwubuntucom 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 nuacutecleos

de CPU e disco riacutegido adequados Quanto mais potente o servidor for nas caracteriacutesticas anteriormente

especificadas melhor a aplicaccedilatildeo funcionaraacute

Memoacuteria RAM 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 1204 de 64

Bits usando postgreSQL como sistema de base de dados e Tomcat como recepiente 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 do 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 seje dividida mais ou menos igualmente entre o banco 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 assim como o passo para o ajuste de desempenho podem ser efectuados

em uma fase posterior

1 Criaccedilatildeo de um novo utilizador (Opcional)

Natildeo eacute recomendada a execuccedilatildeo usando o utilizador ldquorootrdquo Se pretender criar um novo utilizador para a execuccedilatildeo

do SISMA invoque os seguintes comandos

Criar um novo utilizador chamado ldquosismardquo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

7 | P Aacute G I N A

useradd ndashd homesisma ndashm sisma ndashs binbash

Se natildeo existe um grupo admin criado este deve ser criado da seguinte forma

groupadd admin

Atribuir ao utlizador a execuccedilatildeo temporaacuteria de operaccedilotildees como root

usermod ndashG admin sisma

Atribuir uma palavra passe para a conta

Passwd sisma

Certifique que introduza uma palavra passe forte Se pretender desabilitar o login remoto para a conta root invoque

o comando

sudo passwd ndashl root

2 Ajuste do Sistema operativo Kernel

Estas configuraccedilotildees satildeo opcionais excepto a configuraccedilatildeo da memoacuteria partilhada pois eacute necessaacuterio para a

alocaccedilatildeo em postgreSQL

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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

8 | P Aacute G I N A

3 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte commando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invoncado

java ndashversion

4 Instalaccedilatildeo do motorde base de dados PostgreSQL

Para a instalaccedilatildeo do motor de base de dados PostgreSQL versatildeo 91 primeiramente deve-se adicionar o

repositoacuterio de pacotes Ubuntu para o sistema em uso

sudo apt-get install python-software-properties

sudo add-apt-repository ppapittipostgresql

sudo apt-get update

Invoque o seguinte comando para instalar o PostgreSQL

sudo apt-get install postgresql-91

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 base 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

9 | P Aacute G I N A

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

Faccedila o ajuste de desempenho abrindo o seguinte arquivo ldquopostgresqlconfrdquo

sudo nano etcpostgresql91mainpostgresqlconf

e defina as seguintes propriedades

shared_buffers = 2400MB

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 30 do total da memoacuteria designada para o PostgreSQL

work_mem = 20MB

Determine a quantidade de memoacuteria usada para para ordenaccedilatildeo interna e operaccedilotildees hash Esta configuraccedilatildeo eacute

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

maintenance_work_mem = 256MB

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 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_buffersOPostgreSQL tem 2 camadas de cache a primeira camada utiliza a

memoacuteria partilhada kernel e eacute controlado pelo configuraccedilatildeo do shared_buffers OPostgreSQL 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 MBQuando um nuacutemero de segmentos eacute escrito um checkpoint ocorre Definir este nuacutemero para um nuacutemero

maior iraacute melhorar o desempenho de escrita

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

checkpoint_completion_target = 08

Determine 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

Defina amemoacuteria usada parao bufferduranteo processo de gravaccedilatildeoWAL Aumentar este valorpodemelhorar o

rendimentoem sistemas degravaccedilatildeopesada

synchronous_commit = off

Especifique se a transaccedilatildeo for confirmadavai esperar por os registros WAL seremgravados no discoantes de

retornar parao clienteou natildeoConfigurando-o paraldquooffrdquoiraacute melhorarconsideravelmenteo desempenhoImplica

tambeacutem quehaacute um ligeiroatraso do relatoacuterio de transaccedilatildeo com sucesso para o cliente mas o estado do banco de

dadosnatildeo pode sercorrompidoe esta eacute umaboa alternativa para o desempenho intensivo e escrita em sistema

pesados 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

5 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraacuteves 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Um erro comumeacute ter umespaccedilo em brancoapoacutes o uacuteltimovalor da propriedade Certifique-seque natildeo haacuteespaccedilo em

brancono final dequalquer linhaLembre-se tambeacutemque este ficheiroconteacutem asenha em textoclaro para o

seubanco de dadoslogo eacute preciso protegercontra acessosnatildeo autorizadosPara isso invoque

chmodinvoke0600hibernateproperties

Garantindo assim quesomente o utilizadorsismatem permissotildees de leitura e escrita sobre o ficheiro

6 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat apartir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil paradownload de ficheiros dawebeacute o ldquowgetrdquo

Extrai parauma localizaccedilatildeo conveniente Este manualpressupotildee que se tenhanavegadopara o diretoacuterio rootdo

arquivoextraiacutedo

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

Apartir 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

12 | P Aacute G I N A

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

abaixo A primeiravai definira localizaccedilatildeo do seuJavaRuntime Environment o segundo vai dedicarmemoacuteriapara o

Tomcate o terceiroiraacute definiro local paraondeSIS-MA vaiprocuraro ficheiro de configuraccedilatildeohibernateproperties

Por favorverifique se ocaminhodos binaacuterios doJavaestatildeo corretas jaacute que podem variar de sistemapara sistemapor

exemploemsistemas AMDpode-sever em java-7-openjdk-amd64 Note quedeveraacuteajustar estaao seu ambiente

export JAVA_HOME=usrlibjvmjava-7-openjdk

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

exportDHIS2_HOME=homesismaconfig (directoacuterio do ficheiro hibernateproperties)

Configure a portaqueo Tomcatatende a pedidosabraoficheirode configuraccedilatildeo do Tomcat confserverxml localize

o elemento ltConnectorgtque natildeoeacute comentadae altereo valor do atributoda porta parao nuacutemero da portadesejada

para que as 2 instacircncias SISMA funcionem em portas diferentes

Para monitoraro comportamento doTomcatologeacute a principal fontede informaccedilatildeoOs registros podemser facilmente

visualizadosa partir do comando

tail -f logscatalinaout

7 Definiccedilatildeo do tempo doservidor

Deve-sedefinir correctamente a datado servidorde acordo como fuso horaacuterio emquea parte

principaldosutilizadores do sistemaestatildeo localizadosIsso vai afectar por exemplo quandoas tarefas

agendadassatildeo executadas

8 Executar o SISMA

Faccedila o script do executaacutevelde inicializaccedilatildeoinvocando

chmod 755bin

O SISMA pode ser iniciadointerrompido invocando

binstartupsh

binshutdownsh

O ficheiro log pode ser monitorado atraveacutes do comando

tail -f logscatalinaout

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

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

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 4: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

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

Tabela1 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 e a niacutevel de cliente 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 histoacutericosNo caso dos clientes a mesma poderaacute ser on-line ou off-line dependendo se existe ou natildeo

conectividade agrave internet

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

foacutecus deste documento e do respectivo instalador 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)

Clientes Off-Line

o Sistema Operativo Windows XP ou superior

o Memoacuteria RAM 1 GB ou Superior

o Motor de BD H2

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

provincial e distrital A instalaccedilatildeo do sistema ao niacutevel cliente deveraacute ser sempre efectuada utilizando o instalador

concebido em Inno Setup1 ferramenta open source usada para criar instaladores para o Sistema Operativo

Windows 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 causa2

1httpwwwjrsoftwareorgisinfophp

2httpwwwubuntucom 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 nuacutecleos

de CPU e disco riacutegido adequados Quanto mais potente o servidor for nas caracteriacutesticas anteriormente

especificadas melhor a aplicaccedilatildeo funcionaraacute

Memoacuteria RAM 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 1204 de 64

Bits usando postgreSQL como sistema de base de dados e Tomcat como recepiente 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 do 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 seje dividida mais ou menos igualmente entre o banco 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 assim como o passo para o ajuste de desempenho podem ser efectuados

em uma fase posterior

1 Criaccedilatildeo de um novo utilizador (Opcional)

Natildeo eacute recomendada a execuccedilatildeo usando o utilizador ldquorootrdquo Se pretender criar um novo utilizador para a execuccedilatildeo

do SISMA invoque os seguintes comandos

Criar um novo utilizador chamado ldquosismardquo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

7 | P Aacute G I N A

useradd ndashd homesisma ndashm sisma ndashs binbash

Se natildeo existe um grupo admin criado este deve ser criado da seguinte forma

groupadd admin

Atribuir ao utlizador a execuccedilatildeo temporaacuteria de operaccedilotildees como root

usermod ndashG admin sisma

Atribuir uma palavra passe para a conta

Passwd sisma

Certifique que introduza uma palavra passe forte Se pretender desabilitar o login remoto para a conta root invoque

o comando

sudo passwd ndashl root

2 Ajuste do Sistema operativo Kernel

Estas configuraccedilotildees satildeo opcionais excepto a configuraccedilatildeo da memoacuteria partilhada pois eacute necessaacuterio para a

alocaccedilatildeo em postgreSQL

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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

8 | P Aacute G I N A

3 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte commando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invoncado

java ndashversion

4 Instalaccedilatildeo do motorde base de dados PostgreSQL

Para a instalaccedilatildeo do motor de base de dados PostgreSQL versatildeo 91 primeiramente deve-se adicionar o

repositoacuterio de pacotes Ubuntu para o sistema em uso

sudo apt-get install python-software-properties

sudo add-apt-repository ppapittipostgresql

sudo apt-get update

Invoque o seguinte comando para instalar o PostgreSQL

sudo apt-get install postgresql-91

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 base 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

9 | P Aacute G I N A

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

Faccedila o ajuste de desempenho abrindo o seguinte arquivo ldquopostgresqlconfrdquo

sudo nano etcpostgresql91mainpostgresqlconf

e defina as seguintes propriedades

shared_buffers = 2400MB

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 30 do total da memoacuteria designada para o PostgreSQL

work_mem = 20MB

Determine a quantidade de memoacuteria usada para para ordenaccedilatildeo interna e operaccedilotildees hash Esta configuraccedilatildeo eacute

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

maintenance_work_mem = 256MB

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 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_buffersOPostgreSQL tem 2 camadas de cache a primeira camada utiliza a

memoacuteria partilhada kernel e eacute controlado pelo configuraccedilatildeo do shared_buffers OPostgreSQL 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 MBQuando um nuacutemero de segmentos eacute escrito um checkpoint ocorre Definir este nuacutemero para um nuacutemero

maior iraacute melhorar o desempenho de escrita

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

checkpoint_completion_target = 08

Determine 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

Defina amemoacuteria usada parao bufferduranteo processo de gravaccedilatildeoWAL Aumentar este valorpodemelhorar o

rendimentoem sistemas degravaccedilatildeopesada

synchronous_commit = off

Especifique se a transaccedilatildeo for confirmadavai esperar por os registros WAL seremgravados no discoantes de

retornar parao clienteou natildeoConfigurando-o paraldquooffrdquoiraacute melhorarconsideravelmenteo desempenhoImplica

tambeacutem quehaacute um ligeiroatraso do relatoacuterio de transaccedilatildeo com sucesso para o cliente mas o estado do banco de

dadosnatildeo pode sercorrompidoe esta eacute umaboa alternativa para o desempenho intensivo e escrita em sistema

pesados 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

5 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraacuteves 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Um erro comumeacute ter umespaccedilo em brancoapoacutes o uacuteltimovalor da propriedade Certifique-seque natildeo haacuteespaccedilo em

brancono final dequalquer linhaLembre-se tambeacutemque este ficheiroconteacutem asenha em textoclaro para o

seubanco de dadoslogo eacute preciso protegercontra acessosnatildeo autorizadosPara isso invoque

chmodinvoke0600hibernateproperties

Garantindo assim quesomente o utilizadorsismatem permissotildees de leitura e escrita sobre o ficheiro

6 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat apartir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil paradownload de ficheiros dawebeacute o ldquowgetrdquo

Extrai parauma localizaccedilatildeo conveniente Este manualpressupotildee que se tenhanavegadopara o diretoacuterio rootdo

arquivoextraiacutedo

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

Apartir 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

12 | P Aacute G I N A

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

abaixo A primeiravai definira localizaccedilatildeo do seuJavaRuntime Environment o segundo vai dedicarmemoacuteriapara o

Tomcate o terceiroiraacute definiro local paraondeSIS-MA vaiprocuraro ficheiro de configuraccedilatildeohibernateproperties

Por favorverifique se ocaminhodos binaacuterios doJavaestatildeo corretas jaacute que podem variar de sistemapara sistemapor

exemploemsistemas AMDpode-sever em java-7-openjdk-amd64 Note quedeveraacuteajustar estaao seu ambiente

export JAVA_HOME=usrlibjvmjava-7-openjdk

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

exportDHIS2_HOME=homesismaconfig (directoacuterio do ficheiro hibernateproperties)

Configure a portaqueo Tomcatatende a pedidosabraoficheirode configuraccedilatildeo do Tomcat confserverxml localize

o elemento ltConnectorgtque natildeoeacute comentadae altereo valor do atributoda porta parao nuacutemero da portadesejada

para que as 2 instacircncias SISMA funcionem em portas diferentes

Para monitoraro comportamento doTomcatologeacute a principal fontede informaccedilatildeoOs registros podemser facilmente

visualizadosa partir do comando

tail -f logscatalinaout

7 Definiccedilatildeo do tempo doservidor

Deve-sedefinir correctamente a datado servidorde acordo como fuso horaacuterio emquea parte

principaldosutilizadores do sistemaestatildeo localizadosIsso vai afectar por exemplo quandoas tarefas

agendadassatildeo executadas

8 Executar o SISMA

Faccedila o script do executaacutevelde inicializaccedilatildeoinvocando

chmod 755bin

O SISMA pode ser iniciadointerrompido invocando

binstartupsh

binshutdownsh

O ficheiro log pode ser monitorado atraveacutes do comando

tail -f logscatalinaout

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

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

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 5: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

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 e a niacutevel de cliente 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 histoacutericosNo caso dos clientes a mesma poderaacute ser on-line ou off-line dependendo se existe ou natildeo

conectividade agrave internet

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

foacutecus deste documento e do respectivo instalador 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)

Clientes Off-Line

o Sistema Operativo Windows XP ou superior

o Memoacuteria RAM 1 GB ou Superior

o Motor de BD H2

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

provincial e distrital A instalaccedilatildeo do sistema ao niacutevel cliente deveraacute ser sempre efectuada utilizando o instalador

concebido em Inno Setup1 ferramenta open source usada para criar instaladores para o Sistema Operativo

Windows 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 causa2

1httpwwwjrsoftwareorgisinfophp

2httpwwwubuntucom 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 nuacutecleos

de CPU e disco riacutegido adequados Quanto mais potente o servidor for nas caracteriacutesticas anteriormente

especificadas melhor a aplicaccedilatildeo funcionaraacute

Memoacuteria RAM 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 1204 de 64

Bits usando postgreSQL como sistema de base de dados e Tomcat como recepiente 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 do 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 seje dividida mais ou menos igualmente entre o banco 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 assim como o passo para o ajuste de desempenho podem ser efectuados

em uma fase posterior

1 Criaccedilatildeo de um novo utilizador (Opcional)

Natildeo eacute recomendada a execuccedilatildeo usando o utilizador ldquorootrdquo Se pretender criar um novo utilizador para a execuccedilatildeo

do SISMA invoque os seguintes comandos

Criar um novo utilizador chamado ldquosismardquo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

7 | P Aacute G I N A

useradd ndashd homesisma ndashm sisma ndashs binbash

Se natildeo existe um grupo admin criado este deve ser criado da seguinte forma

groupadd admin

Atribuir ao utlizador a execuccedilatildeo temporaacuteria de operaccedilotildees como root

usermod ndashG admin sisma

Atribuir uma palavra passe para a conta

Passwd sisma

Certifique que introduza uma palavra passe forte Se pretender desabilitar o login remoto para a conta root invoque

o comando

sudo passwd ndashl root

2 Ajuste do Sistema operativo Kernel

Estas configuraccedilotildees satildeo opcionais excepto a configuraccedilatildeo da memoacuteria partilhada pois eacute necessaacuterio para a

alocaccedilatildeo em postgreSQL

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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

8 | P Aacute G I N A

3 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte commando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invoncado

java ndashversion

4 Instalaccedilatildeo do motorde base de dados PostgreSQL

Para a instalaccedilatildeo do motor de base de dados PostgreSQL versatildeo 91 primeiramente deve-se adicionar o

repositoacuterio de pacotes Ubuntu para o sistema em uso

sudo apt-get install python-software-properties

sudo add-apt-repository ppapittipostgresql

sudo apt-get update

Invoque o seguinte comando para instalar o PostgreSQL

sudo apt-get install postgresql-91

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 base 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

9 | P Aacute G I N A

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

Faccedila o ajuste de desempenho abrindo o seguinte arquivo ldquopostgresqlconfrdquo

sudo nano etcpostgresql91mainpostgresqlconf

e defina as seguintes propriedades

shared_buffers = 2400MB

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 30 do total da memoacuteria designada para o PostgreSQL

work_mem = 20MB

Determine a quantidade de memoacuteria usada para para ordenaccedilatildeo interna e operaccedilotildees hash Esta configuraccedilatildeo eacute

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

maintenance_work_mem = 256MB

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 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_buffersOPostgreSQL tem 2 camadas de cache a primeira camada utiliza a

memoacuteria partilhada kernel e eacute controlado pelo configuraccedilatildeo do shared_buffers OPostgreSQL 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 MBQuando um nuacutemero de segmentos eacute escrito um checkpoint ocorre Definir este nuacutemero para um nuacutemero

maior iraacute melhorar o desempenho de escrita

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

checkpoint_completion_target = 08

Determine 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

Defina amemoacuteria usada parao bufferduranteo processo de gravaccedilatildeoWAL Aumentar este valorpodemelhorar o

rendimentoem sistemas degravaccedilatildeopesada

synchronous_commit = off

Especifique se a transaccedilatildeo for confirmadavai esperar por os registros WAL seremgravados no discoantes de

retornar parao clienteou natildeoConfigurando-o paraldquooffrdquoiraacute melhorarconsideravelmenteo desempenhoImplica

tambeacutem quehaacute um ligeiroatraso do relatoacuterio de transaccedilatildeo com sucesso para o cliente mas o estado do banco de

dadosnatildeo pode sercorrompidoe esta eacute umaboa alternativa para o desempenho intensivo e escrita em sistema

pesados 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

5 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraacuteves 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Um erro comumeacute ter umespaccedilo em brancoapoacutes o uacuteltimovalor da propriedade Certifique-seque natildeo haacuteespaccedilo em

brancono final dequalquer linhaLembre-se tambeacutemque este ficheiroconteacutem asenha em textoclaro para o

seubanco de dadoslogo eacute preciso protegercontra acessosnatildeo autorizadosPara isso invoque

chmodinvoke0600hibernateproperties

Garantindo assim quesomente o utilizadorsismatem permissotildees de leitura e escrita sobre o ficheiro

6 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat apartir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil paradownload de ficheiros dawebeacute o ldquowgetrdquo

Extrai parauma localizaccedilatildeo conveniente Este manualpressupotildee que se tenhanavegadopara o diretoacuterio rootdo

arquivoextraiacutedo

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

Apartir 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

12 | P Aacute G I N A

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

abaixo A primeiravai definira localizaccedilatildeo do seuJavaRuntime Environment o segundo vai dedicarmemoacuteriapara o

Tomcate o terceiroiraacute definiro local paraondeSIS-MA vaiprocuraro ficheiro de configuraccedilatildeohibernateproperties

Por favorverifique se ocaminhodos binaacuterios doJavaestatildeo corretas jaacute que podem variar de sistemapara sistemapor

exemploemsistemas AMDpode-sever em java-7-openjdk-amd64 Note quedeveraacuteajustar estaao seu ambiente

export JAVA_HOME=usrlibjvmjava-7-openjdk

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

exportDHIS2_HOME=homesismaconfig (directoacuterio do ficheiro hibernateproperties)

Configure a portaqueo Tomcatatende a pedidosabraoficheirode configuraccedilatildeo do Tomcat confserverxml localize

o elemento ltConnectorgtque natildeoeacute comentadae altereo valor do atributoda porta parao nuacutemero da portadesejada

para que as 2 instacircncias SISMA funcionem em portas diferentes

Para monitoraro comportamento doTomcatologeacute a principal fontede informaccedilatildeoOs registros podemser facilmente

visualizadosa partir do comando

tail -f logscatalinaout

7 Definiccedilatildeo do tempo doservidor

Deve-sedefinir correctamente a datado servidorde acordo como fuso horaacuterio emquea parte

principaldosutilizadores do sistemaestatildeo localizadosIsso vai afectar por exemplo quandoas tarefas

agendadassatildeo executadas

8 Executar o SISMA

Faccedila o script do executaacutevelde inicializaccedilatildeoinvocando

chmod 755bin

O SISMA pode ser iniciadointerrompido invocando

binstartupsh

binshutdownsh

O ficheiro log pode ser monitorado atraveacutes do comando

tail -f logscatalinaout

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

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

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 6: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

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 nuacutecleos

de CPU e disco riacutegido adequados Quanto mais potente o servidor for nas caracteriacutesticas anteriormente

especificadas melhor a aplicaccedilatildeo funcionaraacute

Memoacuteria RAM 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 1204 de 64

Bits usando postgreSQL como sistema de base de dados e Tomcat como recepiente 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 do 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 seje dividida mais ou menos igualmente entre o banco 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 assim como o passo para o ajuste de desempenho podem ser efectuados

em uma fase posterior

1 Criaccedilatildeo de um novo utilizador (Opcional)

Natildeo eacute recomendada a execuccedilatildeo usando o utilizador ldquorootrdquo Se pretender criar um novo utilizador para a execuccedilatildeo

do SISMA invoque os seguintes comandos

Criar um novo utilizador chamado ldquosismardquo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

7 | P Aacute G I N A

useradd ndashd homesisma ndashm sisma ndashs binbash

Se natildeo existe um grupo admin criado este deve ser criado da seguinte forma

groupadd admin

Atribuir ao utlizador a execuccedilatildeo temporaacuteria de operaccedilotildees como root

usermod ndashG admin sisma

Atribuir uma palavra passe para a conta

Passwd sisma

Certifique que introduza uma palavra passe forte Se pretender desabilitar o login remoto para a conta root invoque

o comando

sudo passwd ndashl root

2 Ajuste do Sistema operativo Kernel

Estas configuraccedilotildees satildeo opcionais excepto a configuraccedilatildeo da memoacuteria partilhada pois eacute necessaacuterio para a

alocaccedilatildeo em postgreSQL

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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

8 | P Aacute G I N A

3 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte commando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invoncado

java ndashversion

4 Instalaccedilatildeo do motorde base de dados PostgreSQL

Para a instalaccedilatildeo do motor de base de dados PostgreSQL versatildeo 91 primeiramente deve-se adicionar o

repositoacuterio de pacotes Ubuntu para o sistema em uso

sudo apt-get install python-software-properties

sudo add-apt-repository ppapittipostgresql

sudo apt-get update

Invoque o seguinte comando para instalar o PostgreSQL

sudo apt-get install postgresql-91

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 base 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

9 | P Aacute G I N A

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

Faccedila o ajuste de desempenho abrindo o seguinte arquivo ldquopostgresqlconfrdquo

sudo nano etcpostgresql91mainpostgresqlconf

e defina as seguintes propriedades

shared_buffers = 2400MB

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 30 do total da memoacuteria designada para o PostgreSQL

work_mem = 20MB

Determine a quantidade de memoacuteria usada para para ordenaccedilatildeo interna e operaccedilotildees hash Esta configuraccedilatildeo eacute

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

maintenance_work_mem = 256MB

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 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_buffersOPostgreSQL tem 2 camadas de cache a primeira camada utiliza a

memoacuteria partilhada kernel e eacute controlado pelo configuraccedilatildeo do shared_buffers OPostgreSQL 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 MBQuando um nuacutemero de segmentos eacute escrito um checkpoint ocorre Definir este nuacutemero para um nuacutemero

maior iraacute melhorar o desempenho de escrita

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

checkpoint_completion_target = 08

Determine 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

Defina amemoacuteria usada parao bufferduranteo processo de gravaccedilatildeoWAL Aumentar este valorpodemelhorar o

rendimentoem sistemas degravaccedilatildeopesada

synchronous_commit = off

Especifique se a transaccedilatildeo for confirmadavai esperar por os registros WAL seremgravados no discoantes de

retornar parao clienteou natildeoConfigurando-o paraldquooffrdquoiraacute melhorarconsideravelmenteo desempenhoImplica

tambeacutem quehaacute um ligeiroatraso do relatoacuterio de transaccedilatildeo com sucesso para o cliente mas o estado do banco de

dadosnatildeo pode sercorrompidoe esta eacute umaboa alternativa para o desempenho intensivo e escrita em sistema

pesados 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

5 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraacuteves 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Um erro comumeacute ter umespaccedilo em brancoapoacutes o uacuteltimovalor da propriedade Certifique-seque natildeo haacuteespaccedilo em

brancono final dequalquer linhaLembre-se tambeacutemque este ficheiroconteacutem asenha em textoclaro para o

seubanco de dadoslogo eacute preciso protegercontra acessosnatildeo autorizadosPara isso invoque

chmodinvoke0600hibernateproperties

Garantindo assim quesomente o utilizadorsismatem permissotildees de leitura e escrita sobre o ficheiro

6 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat apartir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil paradownload de ficheiros dawebeacute o ldquowgetrdquo

Extrai parauma localizaccedilatildeo conveniente Este manualpressupotildee que se tenhanavegadopara o diretoacuterio rootdo

arquivoextraiacutedo

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

Apartir 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

12 | P Aacute G I N A

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

abaixo A primeiravai definira localizaccedilatildeo do seuJavaRuntime Environment o segundo vai dedicarmemoacuteriapara o

Tomcate o terceiroiraacute definiro local paraondeSIS-MA vaiprocuraro ficheiro de configuraccedilatildeohibernateproperties

Por favorverifique se ocaminhodos binaacuterios doJavaestatildeo corretas jaacute que podem variar de sistemapara sistemapor

exemploemsistemas AMDpode-sever em java-7-openjdk-amd64 Note quedeveraacuteajustar estaao seu ambiente

export JAVA_HOME=usrlibjvmjava-7-openjdk

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

exportDHIS2_HOME=homesismaconfig (directoacuterio do ficheiro hibernateproperties)

Configure a portaqueo Tomcatatende a pedidosabraoficheirode configuraccedilatildeo do Tomcat confserverxml localize

o elemento ltConnectorgtque natildeoeacute comentadae altereo valor do atributoda porta parao nuacutemero da portadesejada

para que as 2 instacircncias SISMA funcionem em portas diferentes

Para monitoraro comportamento doTomcatologeacute a principal fontede informaccedilatildeoOs registros podemser facilmente

visualizadosa partir do comando

tail -f logscatalinaout

7 Definiccedilatildeo do tempo doservidor

Deve-sedefinir correctamente a datado servidorde acordo como fuso horaacuterio emquea parte

principaldosutilizadores do sistemaestatildeo localizadosIsso vai afectar por exemplo quandoas tarefas

agendadassatildeo executadas

8 Executar o SISMA

Faccedila o script do executaacutevelde inicializaccedilatildeoinvocando

chmod 755bin

O SISMA pode ser iniciadointerrompido invocando

binstartupsh

binshutdownsh

O ficheiro log pode ser monitorado atraveacutes do comando

tail -f logscatalinaout

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

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

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 7: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

7 | P Aacute G I N A

useradd ndashd homesisma ndashm sisma ndashs binbash

Se natildeo existe um grupo admin criado este deve ser criado da seguinte forma

groupadd admin

Atribuir ao utlizador a execuccedilatildeo temporaacuteria de operaccedilotildees como root

usermod ndashG admin sisma

Atribuir uma palavra passe para a conta

Passwd sisma

Certifique que introduza uma palavra passe forte Se pretender desabilitar o login remoto para a conta root invoque

o comando

sudo passwd ndashl root

2 Ajuste do Sistema operativo Kernel

Estas configuraccedilotildees satildeo opcionais excepto a configuraccedilatildeo da memoacuteria partilhada pois eacute necessaacuterio para a

alocaccedilatildeo em postgreSQL

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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

8 | P Aacute G I N A

3 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte commando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invoncado

java ndashversion

4 Instalaccedilatildeo do motorde base de dados PostgreSQL

Para a instalaccedilatildeo do motor de base de dados PostgreSQL versatildeo 91 primeiramente deve-se adicionar o

repositoacuterio de pacotes Ubuntu para o sistema em uso

sudo apt-get install python-software-properties

sudo add-apt-repository ppapittipostgresql

sudo apt-get update

Invoque o seguinte comando para instalar o PostgreSQL

sudo apt-get install postgresql-91

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 base 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

9 | P Aacute G I N A

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

Faccedila o ajuste de desempenho abrindo o seguinte arquivo ldquopostgresqlconfrdquo

sudo nano etcpostgresql91mainpostgresqlconf

e defina as seguintes propriedades

shared_buffers = 2400MB

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 30 do total da memoacuteria designada para o PostgreSQL

work_mem = 20MB

Determine a quantidade de memoacuteria usada para para ordenaccedilatildeo interna e operaccedilotildees hash Esta configuraccedilatildeo eacute

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

maintenance_work_mem = 256MB

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 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_buffersOPostgreSQL tem 2 camadas de cache a primeira camada utiliza a

memoacuteria partilhada kernel e eacute controlado pelo configuraccedilatildeo do shared_buffers OPostgreSQL 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 MBQuando um nuacutemero de segmentos eacute escrito um checkpoint ocorre Definir este nuacutemero para um nuacutemero

maior iraacute melhorar o desempenho de escrita

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

checkpoint_completion_target = 08

Determine 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

Defina amemoacuteria usada parao bufferduranteo processo de gravaccedilatildeoWAL Aumentar este valorpodemelhorar o

rendimentoem sistemas degravaccedilatildeopesada

synchronous_commit = off

Especifique se a transaccedilatildeo for confirmadavai esperar por os registros WAL seremgravados no discoantes de

retornar parao clienteou natildeoConfigurando-o paraldquooffrdquoiraacute melhorarconsideravelmenteo desempenhoImplica

tambeacutem quehaacute um ligeiroatraso do relatoacuterio de transaccedilatildeo com sucesso para o cliente mas o estado do banco de

dadosnatildeo pode sercorrompidoe esta eacute umaboa alternativa para o desempenho intensivo e escrita em sistema

pesados 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

5 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraacuteves 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Um erro comumeacute ter umespaccedilo em brancoapoacutes o uacuteltimovalor da propriedade Certifique-seque natildeo haacuteespaccedilo em

brancono final dequalquer linhaLembre-se tambeacutemque este ficheiroconteacutem asenha em textoclaro para o

seubanco de dadoslogo eacute preciso protegercontra acessosnatildeo autorizadosPara isso invoque

chmodinvoke0600hibernateproperties

Garantindo assim quesomente o utilizadorsismatem permissotildees de leitura e escrita sobre o ficheiro

6 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat apartir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil paradownload de ficheiros dawebeacute o ldquowgetrdquo

Extrai parauma localizaccedilatildeo conveniente Este manualpressupotildee que se tenhanavegadopara o diretoacuterio rootdo

arquivoextraiacutedo

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

Apartir 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

12 | P Aacute G I N A

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

abaixo A primeiravai definira localizaccedilatildeo do seuJavaRuntime Environment o segundo vai dedicarmemoacuteriapara o

Tomcate o terceiroiraacute definiro local paraondeSIS-MA vaiprocuraro ficheiro de configuraccedilatildeohibernateproperties

Por favorverifique se ocaminhodos binaacuterios doJavaestatildeo corretas jaacute que podem variar de sistemapara sistemapor

exemploemsistemas AMDpode-sever em java-7-openjdk-amd64 Note quedeveraacuteajustar estaao seu ambiente

export JAVA_HOME=usrlibjvmjava-7-openjdk

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

exportDHIS2_HOME=homesismaconfig (directoacuterio do ficheiro hibernateproperties)

Configure a portaqueo Tomcatatende a pedidosabraoficheirode configuraccedilatildeo do Tomcat confserverxml localize

o elemento ltConnectorgtque natildeoeacute comentadae altereo valor do atributoda porta parao nuacutemero da portadesejada

para que as 2 instacircncias SISMA funcionem em portas diferentes

Para monitoraro comportamento doTomcatologeacute a principal fontede informaccedilatildeoOs registros podemser facilmente

visualizadosa partir do comando

tail -f logscatalinaout

7 Definiccedilatildeo do tempo doservidor

Deve-sedefinir correctamente a datado servidorde acordo como fuso horaacuterio emquea parte

principaldosutilizadores do sistemaestatildeo localizadosIsso vai afectar por exemplo quandoas tarefas

agendadassatildeo executadas

8 Executar o SISMA

Faccedila o script do executaacutevelde inicializaccedilatildeoinvocando

chmod 755bin

O SISMA pode ser iniciadointerrompido invocando

binstartupsh

binshutdownsh

O ficheiro log pode ser monitorado atraveacutes do comando

tail -f logscatalinaout

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

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

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 8: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

8 | P Aacute G I N A

3 Instalaccedilatildeo de JAVA

Para instalar o Java invoque o seguinte commando

sudo apt-get install openjdk-7-jdk

Verifique se a instalaccedilatildeo correu bem invoncado

java ndashversion

4 Instalaccedilatildeo do motorde base de dados PostgreSQL

Para a instalaccedilatildeo do motor de base de dados PostgreSQL versatildeo 91 primeiramente deve-se adicionar o

repositoacuterio de pacotes Ubuntu para o sistema em uso

sudo apt-get install python-software-properties

sudo add-apt-repository ppapittipostgresql

sudo apt-get update

Invoque o seguinte comando para instalar o PostgreSQL

sudo apt-get install postgresql-91

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 base 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

9 | P Aacute G I N A

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

Faccedila o ajuste de desempenho abrindo o seguinte arquivo ldquopostgresqlconfrdquo

sudo nano etcpostgresql91mainpostgresqlconf

e defina as seguintes propriedades

shared_buffers = 2400MB

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 30 do total da memoacuteria designada para o PostgreSQL

work_mem = 20MB

Determine a quantidade de memoacuteria usada para para ordenaccedilatildeo interna e operaccedilotildees hash Esta configuraccedilatildeo eacute

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

maintenance_work_mem = 256MB

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 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_buffersOPostgreSQL tem 2 camadas de cache a primeira camada utiliza a

memoacuteria partilhada kernel e eacute controlado pelo configuraccedilatildeo do shared_buffers OPostgreSQL 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 MBQuando um nuacutemero de segmentos eacute escrito um checkpoint ocorre Definir este nuacutemero para um nuacutemero

maior iraacute melhorar o desempenho de escrita

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

checkpoint_completion_target = 08

Determine 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

Defina amemoacuteria usada parao bufferduranteo processo de gravaccedilatildeoWAL Aumentar este valorpodemelhorar o

rendimentoem sistemas degravaccedilatildeopesada

synchronous_commit = off

Especifique se a transaccedilatildeo for confirmadavai esperar por os registros WAL seremgravados no discoantes de

retornar parao clienteou natildeoConfigurando-o paraldquooffrdquoiraacute melhorarconsideravelmenteo desempenhoImplica

tambeacutem quehaacute um ligeiroatraso do relatoacuterio de transaccedilatildeo com sucesso para o cliente mas o estado do banco de

dadosnatildeo pode sercorrompidoe esta eacute umaboa alternativa para o desempenho intensivo e escrita em sistema

pesados 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

5 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraacuteves 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Um erro comumeacute ter umespaccedilo em brancoapoacutes o uacuteltimovalor da propriedade Certifique-seque natildeo haacuteespaccedilo em

brancono final dequalquer linhaLembre-se tambeacutemque este ficheiroconteacutem asenha em textoclaro para o

seubanco de dadoslogo eacute preciso protegercontra acessosnatildeo autorizadosPara isso invoque

chmodinvoke0600hibernateproperties

Garantindo assim quesomente o utilizadorsismatem permissotildees de leitura e escrita sobre o ficheiro

6 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat apartir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil paradownload de ficheiros dawebeacute o ldquowgetrdquo

Extrai parauma localizaccedilatildeo conveniente Este manualpressupotildee que se tenhanavegadopara o diretoacuterio rootdo

arquivoextraiacutedo

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

Apartir 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

12 | P Aacute G I N A

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

abaixo A primeiravai definira localizaccedilatildeo do seuJavaRuntime Environment o segundo vai dedicarmemoacuteriapara o

Tomcate o terceiroiraacute definiro local paraondeSIS-MA vaiprocuraro ficheiro de configuraccedilatildeohibernateproperties

Por favorverifique se ocaminhodos binaacuterios doJavaestatildeo corretas jaacute que podem variar de sistemapara sistemapor

exemploemsistemas AMDpode-sever em java-7-openjdk-amd64 Note quedeveraacuteajustar estaao seu ambiente

export JAVA_HOME=usrlibjvmjava-7-openjdk

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

exportDHIS2_HOME=homesismaconfig (directoacuterio do ficheiro hibernateproperties)

Configure a portaqueo Tomcatatende a pedidosabraoficheirode configuraccedilatildeo do Tomcat confserverxml localize

o elemento ltConnectorgtque natildeoeacute comentadae altereo valor do atributoda porta parao nuacutemero da portadesejada

para que as 2 instacircncias SISMA funcionem em portas diferentes

Para monitoraro comportamento doTomcatologeacute a principal fontede informaccedilatildeoOs registros podemser facilmente

visualizadosa partir do comando

tail -f logscatalinaout

7 Definiccedilatildeo do tempo doservidor

Deve-sedefinir correctamente a datado servidorde acordo como fuso horaacuterio emquea parte

principaldosutilizadores do sistemaestatildeo localizadosIsso vai afectar por exemplo quandoas tarefas

agendadassatildeo executadas

8 Executar o SISMA

Faccedila o script do executaacutevelde inicializaccedilatildeoinvocando

chmod 755bin

O SISMA pode ser iniciadointerrompido invocando

binstartupsh

binshutdownsh

O ficheiro log pode ser monitorado atraveacutes do comando

tail -f logscatalinaout

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

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

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 9: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

9 | P Aacute G I N A

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

Faccedila o ajuste de desempenho abrindo o seguinte arquivo ldquopostgresqlconfrdquo

sudo nano etcpostgresql91mainpostgresqlconf

e defina as seguintes propriedades

shared_buffers = 2400MB

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 30 do total da memoacuteria designada para o PostgreSQL

work_mem = 20MB

Determine a quantidade de memoacuteria usada para para ordenaccedilatildeo interna e operaccedilotildees hash Esta configuraccedilatildeo eacute

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

maintenance_work_mem = 256MB

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 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_buffersOPostgreSQL tem 2 camadas de cache a primeira camada utiliza a

memoacuteria partilhada kernel e eacute controlado pelo configuraccedilatildeo do shared_buffers OPostgreSQL 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 MBQuando um nuacutemero de segmentos eacute escrito um checkpoint ocorre Definir este nuacutemero para um nuacutemero

maior iraacute melhorar o desempenho de escrita

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

checkpoint_completion_target = 08

Determine 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

Defina amemoacuteria usada parao bufferduranteo processo de gravaccedilatildeoWAL Aumentar este valorpodemelhorar o

rendimentoem sistemas degravaccedilatildeopesada

synchronous_commit = off

Especifique se a transaccedilatildeo for confirmadavai esperar por os registros WAL seremgravados no discoantes de

retornar parao clienteou natildeoConfigurando-o paraldquooffrdquoiraacute melhorarconsideravelmenteo desempenhoImplica

tambeacutem quehaacute um ligeiroatraso do relatoacuterio de transaccedilatildeo com sucesso para o cliente mas o estado do banco de

dadosnatildeo pode sercorrompidoe esta eacute umaboa alternativa para o desempenho intensivo e escrita em sistema

pesados 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

5 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraacuteves 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Um erro comumeacute ter umespaccedilo em brancoapoacutes o uacuteltimovalor da propriedade Certifique-seque natildeo haacuteespaccedilo em

brancono final dequalquer linhaLembre-se tambeacutemque este ficheiroconteacutem asenha em textoclaro para o

seubanco de dadoslogo eacute preciso protegercontra acessosnatildeo autorizadosPara isso invoque

chmodinvoke0600hibernateproperties

Garantindo assim quesomente o utilizadorsismatem permissotildees de leitura e escrita sobre o ficheiro

6 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat apartir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil paradownload de ficheiros dawebeacute o ldquowgetrdquo

Extrai parauma localizaccedilatildeo conveniente Este manualpressupotildee que se tenhanavegadopara o diretoacuterio rootdo

arquivoextraiacutedo

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

Apartir 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

12 | P Aacute G I N A

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

abaixo A primeiravai definira localizaccedilatildeo do seuJavaRuntime Environment o segundo vai dedicarmemoacuteriapara o

Tomcate o terceiroiraacute definiro local paraondeSIS-MA vaiprocuraro ficheiro de configuraccedilatildeohibernateproperties

Por favorverifique se ocaminhodos binaacuterios doJavaestatildeo corretas jaacute que podem variar de sistemapara sistemapor

exemploemsistemas AMDpode-sever em java-7-openjdk-amd64 Note quedeveraacuteajustar estaao seu ambiente

export JAVA_HOME=usrlibjvmjava-7-openjdk

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

exportDHIS2_HOME=homesismaconfig (directoacuterio do ficheiro hibernateproperties)

Configure a portaqueo Tomcatatende a pedidosabraoficheirode configuraccedilatildeo do Tomcat confserverxml localize

o elemento ltConnectorgtque natildeoeacute comentadae altereo valor do atributoda porta parao nuacutemero da portadesejada

para que as 2 instacircncias SISMA funcionem em portas diferentes

Para monitoraro comportamento doTomcatologeacute a principal fontede informaccedilatildeoOs registros podemser facilmente

visualizadosa partir do comando

tail -f logscatalinaout

7 Definiccedilatildeo do tempo doservidor

Deve-sedefinir correctamente a datado servidorde acordo como fuso horaacuterio emquea parte

principaldosutilizadores do sistemaestatildeo localizadosIsso vai afectar por exemplo quandoas tarefas

agendadassatildeo executadas

8 Executar o SISMA

Faccedila o script do executaacutevelde inicializaccedilatildeoinvocando

chmod 755bin

O SISMA pode ser iniciadointerrompido invocando

binstartupsh

binshutdownsh

O ficheiro log pode ser monitorado atraveacutes do comando

tail -f logscatalinaout

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

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

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 10: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

10 | P Aacute G I N A

checkpoint_completion_target = 08

Determine 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

Defina amemoacuteria usada parao bufferduranteo processo de gravaccedilatildeoWAL Aumentar este valorpodemelhorar o

rendimentoem sistemas degravaccedilatildeopesada

synchronous_commit = off

Especifique se a transaccedilatildeo for confirmadavai esperar por os registros WAL seremgravados no discoantes de

retornar parao clienteou natildeoConfigurando-o paraldquooffrdquoiraacute melhorarconsideravelmenteo desempenhoImplica

tambeacutem quehaacute um ligeiroatraso do relatoacuterio de transaccedilatildeo com sucesso para o cliente mas o estado do banco de

dadosnatildeo pode sercorrompidoe esta eacute umaboa alternativa para o desempenho intensivo e escrita em sistema

pesados 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

5 Definir a configuraccedilatildeo da base de dados

A informaccedilatildeo da conexatildeo a base de dados eacute fornecida no SISMA atraacuteves 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Um erro comumeacute ter umespaccedilo em brancoapoacutes o uacuteltimovalor da propriedade Certifique-seque natildeo haacuteespaccedilo em

brancono final dequalquer linhaLembre-se tambeacutemque este ficheiroconteacutem asenha em textoclaro para o

seubanco de dadoslogo eacute preciso protegercontra acessosnatildeo autorizadosPara isso invoque

chmodinvoke0600hibernateproperties

Garantindo assim quesomente o utilizadorsismatem permissotildees de leitura e escrita sobre o ficheiro

6 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat apartir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil paradownload de ficheiros dawebeacute o ldquowgetrdquo

Extrai parauma localizaccedilatildeo conveniente Este manualpressupotildee que se tenhanavegadopara o diretoacuterio rootdo

arquivoextraiacutedo

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

Apartir 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

12 | P Aacute G I N A

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

abaixo A primeiravai definira localizaccedilatildeo do seuJavaRuntime Environment o segundo vai dedicarmemoacuteriapara o

Tomcate o terceiroiraacute definiro local paraondeSIS-MA vaiprocuraro ficheiro de configuraccedilatildeohibernateproperties

Por favorverifique se ocaminhodos binaacuterios doJavaestatildeo corretas jaacute que podem variar de sistemapara sistemapor

exemploemsistemas AMDpode-sever em java-7-openjdk-amd64 Note quedeveraacuteajustar estaao seu ambiente

export JAVA_HOME=usrlibjvmjava-7-openjdk

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

exportDHIS2_HOME=homesismaconfig (directoacuterio do ficheiro hibernateproperties)

Configure a portaqueo Tomcatatende a pedidosabraoficheirode configuraccedilatildeo do Tomcat confserverxml localize

o elemento ltConnectorgtque natildeoeacute comentadae altereo valor do atributoda porta parao nuacutemero da portadesejada

para que as 2 instacircncias SISMA funcionem em portas diferentes

Para monitoraro comportamento doTomcatologeacute a principal fontede informaccedilatildeoOs registros podemser facilmente

visualizadosa partir do comando

tail -f logscatalinaout

7 Definiccedilatildeo do tempo doservidor

Deve-sedefinir correctamente a datado servidorde acordo como fuso horaacuterio emquea parte

principaldosutilizadores do sistemaestatildeo localizadosIsso vai afectar por exemplo quandoas tarefas

agendadassatildeo executadas

8 Executar o SISMA

Faccedila o script do executaacutevelde inicializaccedilatildeoinvocando

chmod 755bin

O SISMA pode ser iniciadointerrompido invocando

binstartupsh

binshutdownsh

O ficheiro log pode ser monitorado atraveacutes do comando

tail -f logscatalinaout

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

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

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 11: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

11 | P Aacute G I N A

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Ficheiro Hibernateproperties para a aplicaccedilatildeo sisma histoacuterico

hibernatedialect = orghibernatedialectPostgreSQLDialect

hibernateconnectiondriver_class = orgpostgresqlDriver

hibernateconnectionurl = jdbcpostgresqlsisma-hist

hibernateconnectionusername = sisma

hibernateconnectionpassword = xxxx

hibernatehbm2ddlauto = update

Um erro comumeacute ter umespaccedilo em brancoapoacutes o uacuteltimovalor da propriedade Certifique-seque natildeo haacuteespaccedilo em

brancono final dequalquer linhaLembre-se tambeacutemque este ficheiroconteacutem asenha em textoclaro para o

seubanco de dadoslogo eacute preciso protegercontra acessosnatildeo autorizadosPara isso invoque

chmodinvoke0600hibernateproperties

Garantindo assim quesomente o utilizadorsismatem permissotildees de leitura e escrita sobre o ficheiro

6 Instalaccedilatildeo do serviccedilo aplicacional Tomcat

Faccedila Download do Tomcat apartir do link

httptomcatapacheorgdownload-70cgi

Uma ferramenta uacutetil paradownload de ficheiros dawebeacute o ldquowgetrdquo

Extrai parauma localizaccedilatildeo conveniente Este manualpressupotildee que se tenhanavegadopara o diretoacuterio rootdo

arquivoextraiacutedo

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

Apartir 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

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

12 | P Aacute G I N A

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

abaixo A primeiravai definira localizaccedilatildeo do seuJavaRuntime Environment o segundo vai dedicarmemoacuteriapara o

Tomcate o terceiroiraacute definiro local paraondeSIS-MA vaiprocuraro ficheiro de configuraccedilatildeohibernateproperties

Por favorverifique se ocaminhodos binaacuterios doJavaestatildeo corretas jaacute que podem variar de sistemapara sistemapor

exemploemsistemas AMDpode-sever em java-7-openjdk-amd64 Note quedeveraacuteajustar estaao seu ambiente

export JAVA_HOME=usrlibjvmjava-7-openjdk

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

exportDHIS2_HOME=homesismaconfig (directoacuterio do ficheiro hibernateproperties)

Configure a portaqueo Tomcatatende a pedidosabraoficheirode configuraccedilatildeo do Tomcat confserverxml localize

o elemento ltConnectorgtque natildeoeacute comentadae altereo valor do atributoda porta parao nuacutemero da portadesejada

para que as 2 instacircncias SISMA funcionem em portas diferentes

Para monitoraro comportamento doTomcatologeacute a principal fontede informaccedilatildeoOs registros podemser facilmente

visualizadosa partir do comando

tail -f logscatalinaout

7 Definiccedilatildeo do tempo doservidor

Deve-sedefinir correctamente a datado servidorde acordo como fuso horaacuterio emquea parte

principaldosutilizadores do sistemaestatildeo localizadosIsso vai afectar por exemplo quandoas tarefas

agendadassatildeo executadas

8 Executar o SISMA

Faccedila o script do executaacutevelde inicializaccedilatildeoinvocando

chmod 755bin

O SISMA pode ser iniciadointerrompido invocando

binstartupsh

binshutdownsh

O ficheiro log pode ser monitorado atraveacutes do comando

tail -f logscatalinaout

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

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

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 12: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

12 | P Aacute G I N A

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

abaixo A primeiravai definira localizaccedilatildeo do seuJavaRuntime Environment o segundo vai dedicarmemoacuteriapara o

Tomcate o terceiroiraacute definiro local paraondeSIS-MA vaiprocuraro ficheiro de configuraccedilatildeohibernateproperties

Por favorverifique se ocaminhodos binaacuterios doJavaestatildeo corretas jaacute que podem variar de sistemapara sistemapor

exemploemsistemas AMDpode-sever em java-7-openjdk-amd64 Note quedeveraacuteajustar estaao seu ambiente

export JAVA_HOME=usrlibjvmjava-7-openjdk

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

exportDHIS2_HOME=homesismaconfig (directoacuterio do ficheiro hibernateproperties)

Configure a portaqueo Tomcatatende a pedidosabraoficheirode configuraccedilatildeo do Tomcat confserverxml localize

o elemento ltConnectorgtque natildeoeacute comentadae altereo valor do atributoda porta parao nuacutemero da portadesejada

para que as 2 instacircncias SISMA funcionem em portas diferentes

Para monitoraro comportamento doTomcatologeacute a principal fontede informaccedilatildeoOs registros podemser facilmente

visualizadosa partir do comando

tail -f logscatalinaout

7 Definiccedilatildeo do tempo doservidor

Deve-sedefinir correctamente a datado servidorde acordo como fuso horaacuterio emquea parte

principaldosutilizadores do sistemaestatildeo localizadosIsso vai afectar por exemplo quandoas tarefas

agendadassatildeo executadas

8 Executar o SISMA

Faccedila o script do executaacutevelde inicializaccedilatildeoinvocando

chmod 755bin

O SISMA pode ser iniciadointerrompido invocando

binstartupsh

binshutdownsh

O ficheiro log pode ser monitorado atraveacutes do comando

tail -f logscatalinaout

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

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

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 13: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

13 | P Aacute G I N A

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

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 14: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

14 | P Aacute G I N A

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

modo on-line (com acesso a internet) ou off-line (sem acesso agrave internet) Conforme referido anteriormente este

tipo de instalaccedilotildees deveratildeo ser efectuadas utilizando o instalador e seleccionando o respectivo modo de

instalaccedilatildeo pretendido

41 Modo On-line

Nos casos de clientes on-line apenas seraacute necessaacuteria a instalaccedilatildeo do browser definido (Chrome) O instalador do

sistema estaacute jaacute preparado para esta necessidade devendo para tal ser seleccionada a opccedilatildeo respectiva

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

Ligaccedilao estaacutevel a internet

Uso do browse 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 apartir 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

42 Modo Off-line

A instalaccedilatildeo do SISMA em modo off-line deveraacute ser efectuada uma vez mais utilizando o instalador offline

421 Preacute-requisitos das maacutequinas cliente

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

offline) satildeo os seguintes

Sistema operativo Windows XP ou 7

Memoacuteria RAM 1 GB ou superior

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 15: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

15 | P Aacute G I N A

422 Instalaccedilatildeo e Configuraccedilatildeo

Para a instalaccedilatildeoda instacircncia offline do SIS-MA decirc duplo clique no executaacutevel com o nome setupexe que se

encontra na pasta do instalador e a tela seguinte seraacute exibida

Clique em Seguinte

Esta tela apresenta a possibilidade de escolher a instalaccedilatildeo da instacircncia Online ou Offline

Seleccione a opccedilatildeo offline para fazer uma instalaccedilatildeo do sis-ma offline

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 16: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

16 | P Aacute G I N A

Nesta secccedilatildeo apresenta-se a possibilidade de escolher as seguintes opccedilotildees de importaccedilatildeo de configuraccedilotildees

Base de dados limpa- Criaccedilatildeo de uma base de dados limpa sem dados

Base de dados com configuraccedilotildees- Criaccedilatildeo de base de dados com configuraccedilotildees

Base de dados com configuraccedilotildees e histoacuterico- Criaccedilatildeo de uma base de dados com a possibilidade de

escolha da Proviacutencia e seu respectivo histoacuterico de dados

Caso pretenda criar uma base de dados com histoacuterico de dados para uma proviacutencia especifica Seleccione a

proviacutencia

Clique em Seguinte

Em seguida apresenta-se o directoacuterio onde o SIS-MA seraacute instalado Este deve ser instalado na directoria

apresentada

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 17: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

17 | P Aacute G I N A

Clique em Seguinte

O Google Chorme eacute o browser oficial e ideal para uso da aplicaccedilatildeo SIS-MA O ecratilde mostra a possibilidade de

instalar o browser google chrome caso natildeo tenha instalado

Clique em Seguinte

A tela seguinte ilustra a opccedilatildeo de criaccedilatildeo de um iacutecone do SISMA no ambiente de trabalho do computador

Clique em Seguinte

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 18: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

18 | P Aacute G I N A

De seguida eacute apresentado um breve resumo sobre o directoacuterio onde seraacute feita a instalaccedilatildeo e os componentes a

instalarClique em instalar para efectuar a instalaccedilatildeo

Apoacutes a instalaccedilatildeo das componentes seleccionadas (Java Chrome) eacute apresentada a tela final de conclusatildeo

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 19: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

19 | P Aacute G I N A

Para concluir a instalaccedilatildeo clique no botatildeo Concluir

Apoacutes a instalaccedilatildeo uma pasta com o nome SIS-MA seraacute criada no directoacuterio C com a seguinte estrutura de

ficheiros

database Onde estaacute localizada a base de dados do SISMA dhis2h2db

log Onde estaacute localizado o ficheiro log que possui todas as acccedilotildees efectuadas na aplicaccedilatildeo

423 Acesso ao sisma

Para iniciar o SISMA seleccione o iacutecon SISMA criado no ambiente de trabalho

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 20: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

20 | P Aacute G I N A

Para fazer o login no SISMA use as credenciais do administrador

Utilizador admin

Palavra-passe district

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 21: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

21 | 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 e offline

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

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

de 2 formas

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

o Invocando o seguinte comando a partir da terminal do servidor

pg_dump ltnome base de dadosgt -U dhis | gzip gtltnome 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 Como efectuar um backup de base de dados para a aplicaccedilatildeo Offline

Apoacutes a instalaccedilatildeo do SISMA offline eacute criado um conjunto de ficheiros no directoacuterio CSISMA

Para fazer o backup da base de dados copie a pasta database que inclue a base de dados com extensatildeo h2db

4 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

Para a aplicaccedilatildeo SISMA off-line

CSISMAlog

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER
Page 22: MOZAMBICAN OPEN República de Moçambiquesis-ma.in/wp-content/uploads/2014/06/CSWMZ-SISMA-2014-MAN-00029... · A nível de base de dados, o SISMA suporta diferentes tipos de base

Sistema de Informaccedilatildeo de Sauacutede para Monitoria e Avaliaccedilatildeo

Manual de Administraccedilatildeo do SISMA

22 | P Aacute G I N A

6 Ficha Teacutecnica

Repuacuteblica de Moccedilambique

Ministeacuterio da Sauacutede

Projecto

SISMA ndash Sistema de Informaccedilatildeo de Sauacutede para Monitoria e

Avaliaccedilatildeo

Titulo

Manual de Adminstraccedilatildeo do SISMA

Data

Abril de 2014

Versatildeo

10

Editores

Critical Software ndash wwwcriticalsoftwarecom

Colaboraccedilatildeo

MISAU ndash httpwwwmisaugovmz

MOASIS ndash httpwwwmoasisorgmz

Jembi Health Systems ndash httpwwwjembiorg

CDC - httpwwwcdcgov

  • CSW_MT_START_BACK_COVER