Upload
dangliem
View
213
Download
0
Embed Size (px)
Citation preview
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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