Ministrio do

Desenvolvimento Social e
Combate Fome

MANUAL DE INSTALAO
APLICATIVO CADASTRAMENTO NICO
ENTRADA E MANUTENO DE DADOS
VERSO 6.0.5

Manual de Instalao da V. 6.0.5

Ministrio do
Desenvolvimento Social e
Combate Fome

1. Apresentao ..............................................................................................................4
2. Conceitos ....................................................................................................................4
2.1. Computador sem rede........................................................................................4
2.2. Computador em rede .........................................................................................4
2.2.1. Servidor ....................................................................................................5
2.2.2. Cliente.......................................................................................................5
2.3. Segurana...........................................................................................................5
2.3.1. Permisses ................................................................................................5
2.3.2. Grupo ........................................................................................................5
2.3.3. Usurio......................................................................................................6
3. Instalao e atualizao de verso ..............................................................................6
3.1. Instalao ...........................................................................................................7
3.1.1. Pr-requisitos ............................................................................................7
3.1.2. Instalao em computadores sem rede ...................................................10
3.1.3. Instalao em computadores em rede .....................................................10
3.1.3.1. Cliente............................................................................................10
3.1.3.2. Servidor .........................................................................................11
3.1.4. Instalao em Windows..........................................................................12
3.1.4.1. Configurar como cliente e servidor ...............................................14
3.1.4.2. Configurar somente servidor .........................................................19
3.1.4.3. Configurar cliente em rede. ...........................................................19
3.1.4.4. Instalao em Windows NT. .........................................................20
3.1.4.5. Restaurar senha do administrador..................................................21
3.1.5. Instalao em Linux................................................................................22
3.1.5.1. Otimizao do funcionamento do servidor de base de dados no
Linux...........................................................................................................27
3.2. Atualizao ......................................................................................................30
3.2.1. Cpia de Segurana ................................................................................30
3.2.2. No Windows ...........................................................................................30
3.2.3. No Linux.................................................................................................33
4. Acesso ao sistema pela primeira vez. .......................................................................36
5. Desinstalao ............................................................................................................36
5.1. Em Windows ...................................................................................................36
2

Ministrio do
Desenvolvimento Social e
Combate Fome

5.2. Em Linux .........................................................................................................36

6. Excees ...................................................................................................................37
6.1. Verso anterior a 6.0 instalada. .......................................................................37
6.2. Sair do sistema antes do trmino da instalao ...............................................37
6.3. Instalar por sobre uma verso anterior atual e superior a 5.0.x ....................38
6.4. Sem selecionar alguma UF para configurao. ...............................................38
6.5. O servio pgsql-cadunico no foi reiniciado. ...............................................39
6.6. Atualizar sobre uma verso inferior a 6.0.4.....................................................39

Ministrio do
Desenvolvimento Social e
Combate Fome

1. Apresentao
O presente manual visa apresentar os procedimentos para a instalao da verso
6.0.5 do aplicativo do Cadastramento nico.
Este manual indica ao usurio as formas de execuo da instalao do
aplicativo e/ou a execuo da atualizao de uma verso anterior do aplicativo
existente na mquina.
Apresentaremos tambm, os conceitos dos termos que sero utilizados no
processo de instalao do aplicativo.
2. Conceitos
O aplicativo foi desenvolvido com o intuito de atender s diversas necessidades
operacionais das prefeituras. Abaixo so descritas as configuraes distintas.
2.1. Computador sem rede
Nessa configurao, o cliente e o servidor so instalados em um mesmo
computador.
2.2. Computador em rede
Nessa configurao, o servidor instalado em um computador, e os
clientes so instalados em computadores diferentes.
Os clientes e o servidor acessam uma nica base de dados.
2.2.1. Rede
a integrao de dois ou mais computadores que possibilita a
troca de informaes entre si, fornecendo aos usurios o
compartilhamento de equipamentos e recursos (aplicaes, ferramentas
de comunicao, bases de dados, perifricos).
A figura (Fig. 01) abaixo apresenta um exemplo de rede.

Fig. 01

Ministrio do
Desenvolvimento Social e
Combate Fome

2.2.1. Servidor
um computador que possui grande capacidade de
armazenamento e processamento. Tem a funo de centralizar a
base de dados da prefeitura, sendo responsvel pelas respostas s
solicitaes dos computadores clientes.
O computador servidor o componente-chave pelo acesso
rede.
2.2.2. Cliente
um computador pelo qual o usurio acessa a base de
dados da prefeitura armazenada no computador servidor.
Um cliente deve estar, obrigatoriamente, conectado a um
servidor.
2.3. Segurana
Este aplicativo implementa um mecanismo de controle de acesso base
de dados da prefeitura, que envolve autenticao, que executada por meio de
um login e senha para cada usurio, e autorizao, que configurado por meio
de grupos e permisses.
2.3.1. Permisses
a autorizao de acesso s funcionalidades do aplicativo,
fornecido pelo administrador.
2.3.2. Grupo
uma forma de agrupar as permisses concedidas s
funcionalidades do sistema. Desta forma, a usabilidade para controle de
acesso torna-se mais fcil.

Ministrio do
Desenvolvimento Social e
Combate Fome

2.3.3. Usurio
Usurio do sistema, que associado a um grupo para obter
permisses de acesso.
3. Instalao e atualizao de verso
Para cada Sistema Operacional, Windows ou Linux, so disponibilizados dois
arquivos, um para Instalao e outro para Atualizao. Esses arquivos devem ser
obtidos na pgina da internet da Caixa Econmica Federal, atravs no endereo
abaixo:
http://www.caixa.gov.br Governo Municipal Cadastramento nico
Documentos para Download - Programa.

As verses de Sistemas Operacionais e opes de configurao suportadas pelo

aplicativo so descritas a seguir:
Windows:
Modo Cliente e/ou Servidor:

Windows NT

Windows 2000

Windows XP
Somente modo Cliente:

Windows Millenium Edition (ME)1

Linux:
Somente modo Servidor:

Conectiva Linux 102

Fedora Core 3

RedHat Enterprise Linux 4

Open Suse Linux 10.2

Kurumin 7.0

1
2

Devido a limitaes tcnicas, o servidor no pode ser instalado no Sistema Operacional Windows Millenium.
Estas sofreram uma unificao recente. O nome da distribuio resultante Mandriva.

Ministrio do
Desenvolvimento Social e
Combate Fome

3.1. Instalao
3.1.1. Pr-requisitos
A instalao exige que algumas providncias sejam tomadas em
relao preparao do ambiente. So elas:
O usurio que estiver acessando o computador deve ter perfil de
administrador, ou seja, deve pertencer ao grupo Administradores
desse computador;
A configurao de data do computador deve estar,
obrigatoriamente, no formato dd/MM/aaaa. Caso a configurao no
esteja conforme descrito neste item, o instalador apresenta a seguinte
tela (Fig. 02) informativa. Esta alterao pode ser feita atravs das
Opes Regionais do Painel de Controle.

Fig. 02

A porta 65432, utilizada pelo banco de dados, no pode estar

obstruda por um Firewall. Por esse motivo necessrio que, antes
da instalao, os passos abaixo sejam seguidos para verificao do
bloqueio 3:
-

No Servidor, abrir o Painel de Controle 4.

Abrir Conexes de Rede.
Abrir Conexo local ou outro item similar.
Na guia Geral, abrir Propriedades.
Na guia Avanado, verificar se a caixa Proteger o
computador e a rede... est marcada. Em caso positivo, o
computador est bloqueado para acesso externo.

Para efetuar o desbloqueio da porta 65432, dever ser adicionada

uma permisso de acesso especfica para o aplicativo Cadastramento
nico, descrita a seguir:

3
4

Exemplo utilizando-se Windows XP

Para executar os procedimentos, o usurio precisa ser administrador da mquina

Ministrio do
Desenvolvimento Social e
Combate Fome

- Continuando a partir dos passos descritos anteriormente e com a

caixa de seleo marcada, abrir Configuraes.
- Clicar sobre o boto Adicionar.
- Criar um novo servio, conforme exemplo da tela abaixo (Fig. 03),
colocando no campo Nome ou Endereo IP, o IP do prprio
computador.
- Clicar sobre o boto Ok.

Fig. 03

- Clicar sobre o boto Ok na janela de Configuraes avanadas

(lembrando que a caixa de seleo do Cad. nico dever estar
marcada, conforme sugesto de nome no passo anterior).
- Com este procedimento a porta 65432 estar liberada e os
computadores clientes devero ter acesso ao servidor.
- Se o computador tiver mais de uma conexo configurada, pode ser
necessrio verificar todas e descobrir qual delas est com o
Firewall ativado e impedindo o acesso ao banco de dados do
Cadastramento nico, devendo os procedimentos acima ser
executados em relao a essa(s) conexo(es).
Durante o processo de instalao do servidor, um usurio do
sistema operacional criado e associado com o servidor de base de
dados. Este usurio precisa ser um usurio sem nenhum privilgio (e
criado dessa forma pelo programa de instalao). Em alguns casos
possvel que, devido polticas de rede, o grupo "Todos" esteja
associado ao grupo de usurios "Administradores".
Nesse caso todos os usurios, mesmo o criado pelo instalador, tero
direitos de administrador e isso far com que o servidor no possa ser
iniciado corretamente.

Ministrio do
Desenvolvimento Social e
Combate Fome

Devido a isso necessrio, antes da instalao, que se tenha certeza

de que o grupo "Todos" no esteja associado ao grupo
"Administradores", seguindo-se os passos abaixo 5:
- Acessado o Painel de Controle, efetuando-se um duplo clique no
cone Usurios e Senhas, abrir-se- uma janela de mesmo nome
com vrias abas, na aba indicando Avanado, localizar o grupo
Gerenciamento avanado de usurios e clicar no boto
Avanado.
- Ser aberta a janela Usurios e grupos locais. Selecionar a pasta
Grupos. Ser exibido, no lado direito da janela, alguns grupos.
Selecionar o grupo Administradores efetuando um duplo clique.
- Uma nova janela chamada Propriedades de Administradores
ser aberta. Localizar na lista de participantes se existe o Grupo
Todos.
- Se existir o grupo mencionado acima, remov-lo, atravs do boto
Remover. Para concluir o processo, clicar no boto OK.
O processo de instalao do aplicativo cria, automaticamente, uma
conta de Usurios denominada cadunico no painel de controle /
Ferramentas Administrativas / Gerenciamento do Computador /
Usurios e Grupos Locais.
No computador do cliente no deve haver conta com nome idntico
criada pelo usurio, a fim de evitar problema de conexo com o
banco de dados.
Caso ocorra o problema, necessria a excluso dessa conta e,
posteriormente, a reinstalao do aplicativo.

Exemplo utilizando-se Windows XP

Ministrio do
Desenvolvimento Social e
Combate Fome

3.1.2. Instalao em computadores sem rede

Para a instalao do aplicativo como Cliente e Servidor, a configurao
mnima recomendvel do equipamento varia de acordo com o nmero de
domiclios existentes, conforme quadro a seguir:
Quantidade de domiclios
De 1 a 5.000 domiclios.

Configurao Mnima
Pentium IV 1 Gigahertz
256 MB de memria RAM
30 GB de Espao em disco
Pentium IV 1,7 Gigahertz

De 5.001 a 30.000 domiclios.

512 MB de memria RAM

50 GB de Espao em disco

recomendvel que, caso a prefeitura possua acima de 30.000

domiclios, utilize-se da configurao em rede, possuindo, portanto, um
servidor e computadores clientes.
3.1.3. Instalao em computadores em rede
3.1.3.1. Cliente
Para a instalao do aplicativo, como Cliente, a
configurao mnima recomendvel do equipamento varia com o
nmero de domiclios, conforme quadro a seguir:
Quantidade de domiclios
De 1 a 5.000 domiclios.

De 5.001 a 30.000 domiclios.

De 30.001 a 100.000 domiclios.

Acima de 100.000 domiclios.

Configurao Mnima
Pentium III 300 Megahertz
128 MB de memria RAM
300 MB de Espao em disco
Pentium III - 800 Megahertz
128 MB de memria RAM
500 MB de Espao em disco
Pentium III - 800 Megahertz
256 MB de memria RAM
10 GB de Espao em disco
Pentium III - 800 Megahertz
256 MB de memria RAM
10 GB de Espao em disco

10

Ministrio do
Desenvolvimento Social e
Combate Fome

3.1.3.2. Servidor
Para a instalao do aplicativo em um computador
designado como Servidor, a configurao mnima recomendvel
do equipamento varia com o nmero de domiclio da Base,
conforme quadro a seguir:
Quantidade de domiclios
De 1 a 5000 domiclios.

De 5.001 a 30.000 domiclios.

De 30.001 a 100.000 domiclios.

Acima de 100.000 domiclios.

Configurao Mnima
Pentium III 800 Megahertz
256 MB de memria RAM
20 GB de Espao em disco
Pentium IV 1 Gigahertz
512 MB de memria RAM
40 GB de Espao em disco
Pentium IV 1,5 Gigahertz
1 GB de memria RAM
40 GB de Espao em disco SCSI Nvel 2
Pentium IV 2,8 Gigahertz
2 GB de memria RAM
40 GB de Espao em disco SCSI Nvel 3

11

Ministrio do
Desenvolvimento Social e
Combate Fome

3.1.4. Instalao em Windows

Ao iniciar a instalao, exibida a seguinte tela (Fig. 04):

Fig. 04

12

Ministrio do
Desenvolvimento Social e
Combate Fome

Em seguida, exibida a tela (Fig. 05) informando o caminho onde

ser instalado o aplicativo. O usurio poder instalar o aplicativo em
outro diretrio. Para isso, basta clicar no boto Procurar e indicar o novo
caminho.

Fig. 05

13

Ministrio do
Desenvolvimento Social e
Combate Fome

A tela seguinte (Fig. 06) solicita ao usurio qual a configurao a ser

instalada.

Fig. 06

Em seguida, apresentamos as diferentes seqncias com para cada opo

apresentada na fig. 06.
3.1.4.1. Configurar como cliente e servidor
Aps ter selecionado as duas opes, Cliente e Servidor,
e clicado no boto Prximo, a tela seguinte (Fig. 07) solicita ao
usurio que seja informado um identificador, com um valor dentro
do intervalo 1 a 9999, para o servidor que est sendo instalado.
Esta identificao deve ser nica para cada servidor onde
instalado o sistema na prefeitura. atravs desta identificao, que
os clientes devem conectar-se.

14

Ministrio do
Desenvolvimento Social e
Combate Fome

Fig. 07

15

Ministrio do
Desenvolvimento Social e
Combate Fome

A tela seguinte (Fig. 08) solicita que sejam selecionadas as

UF que se deseja instalar as tabelas de CEP, INEP e CNPJ.

Fig. 08

Esta tela no apresentada em instalaes no servidor com sistema operacional Windows NT. Para configurar
CEP, INEP e CNPJ, o usurio deve executar o Atualizador de Tabelas.

16

Ministrio do
Desenvolvimento Social e
Combate Fome

Aps realizar a seleo e pressionar o boto Prximo, o

instalador inicia a cpia de arquivos, conforme tela seguinte (Fig.
09).

Fig. 09

A tela seguinte (Fig. 10) exibe mensagem ao usurio

informando que est realizando a carga inicial das tabelas do
sistema.

Fig. 10

A prxima mensagem (Fig. 11) informa ao usurio que as

tabelas de CEP, INEP e CNPJ esto sendo configuradas.

17

Ministrio do
Desenvolvimento Social e
Combate Fome

Fig. 11

Ao fim da configurao, apresentada a seguinte mensagem

(Fig. 12), sugerindo a troca da senha do administrador.

Fig. 12

Em seguida, a tela de finalizao (Fig. 13) apresentada.

Fig. 13

18

Ministrio do
Desenvolvimento Social e
Combate Fome

Em seguida a tela (Fig. 14), apresentada.

Fig. 14

3.1.4.2. Configurar somente servidor

Selecione apenas a opo Servidor e clique em Prximo,
os demais passos sero os mesmo da combinao Cliente e
Servidor.
3.1.4.3. Configurar cliente em rede.
Seguindo a partir da tela de definio de configurao (Fig.
06), selecionando apenas a opo Cliente, a tela seguinte (Fig. 15)
apresentada, solicitando que seja informado em qual servidor est
instalada a base de dados do aplicativo.
O servidor pode ser informado atravs do seu nome ou do
endereo IP.
No exemplo abaixo, informado o nome Servidor como
localizao da instalao do banco de dados.

19

Ministrio do
Desenvolvimento Social e
Combate Fome

Fig. 15
A partir desta configurao, apresentada a tela durante a
cpia de arquivos (Fig. 09) e em seguida, a tela de finalizao (Fig.
13).
3.1.4.4. Instalao em Windows NT.
Devido s diferenas de configurao no sistema operacional,
a instalao no Windows NT um pouco diferenciada.
Aps todos os passos existentes da instalao citada
anteriormente, os passos listados abaixo devem ser executados para
se concluir a instalao no Windows NT. Note que a tentativa de
utilizao do servidor de base de dados sem a execuo correta dos
passos listados abaixo resultar em erros.
Crie um usurio do Windows NT sem privilgios de
administrador (usurio restrito), este usurio no pode mudar
a senha e a senha nunca expira, crie conforme abaixo:
Nome
Cadunico

Senha
C4dun1c0v62oo5

Abra um prompt de comando, digite passo1.bat e

pressione enter.

20

Ministrio do
Desenvolvimento Social e
Combate Fome

Ao fim da execuo do comando, efetue o login com o

usurio cadunico criado anteriormente, abra o prompt de
comando novamente, digite passo2.bat e pressione enter
logo depois.
Quando a execuo chegar ao fim, efetue o login com o
usurio administrador novamente.
Acesse a funcionalidade Servios do Windows NT e inicie
o servio pgsql-cadunico.
Aps este passo, execute o prompt de comando, digite
passo3.bat e pressione enter.
Ao fim da instalao e desta configurao, execute o
Atualizador de Tabelas a fim de configurar as tabelas de CEP, INEP e
CNPJ da base.
3.1.4.5. Restaurar senha do administrador
Quando o usurio requer restaurar a senha do
administrador, basta selecionar a opo descrita e pressionar o
boto Prximo.
O aplicativo executa o comando necessrio para restaurar a
senha e exibe a seguinte mensagem (Fig. 16).

Fig. 16

Para verificar o sucesso da operao, basta tentar acessar o

sistema com a configurao original.
Login
Senha

ADMINISTRADOR
administrador

21

Ministrio do
Desenvolvimento Social e
Combate Fome

3.1.5. Instalao em Linux

O kit de instalao para LINUX distribudo como um arquivo
compactado no formato .ZIP. Descompacte o arquivo .ZIP para obter o
arquivo no formato tar.gz. Aps a obteno do arquivo no formato tar.gz,
abra uma janela de Terminal, v para o diretrio onde baixou o arquivo de
instalao (usando o comando cd) e siga os passos abaixo. Note que a
operao de instalao deve ser executada pelo usurio root:
1)

Digite a linha de comando abaixo para descompactar o arquivo:

# tar xzf CadUnico605L.tar.gz

Esse procedimento resultar em dois arquivos sendo

descompactados. Um deles o instalador, propriamente dito.
2)

Para instalar, basta digitar a seguinte linha de comando abaixo.

# ./instalar.sh

3) Seguir as instrues apresentadas na tela:

** Servidor do Cadastramento Unico v6 (Linux) **
** Verso 6.0.5 **
Este programa ira instalar o servidor do Cadastramento Unico v6 para
Linux. Siga as instrucoes apresentadas para concluir o processo de
instalacao.
Tem certeza de que deseja continuar (S/N)? S

Se o usurio digitar S, ser dada continuidade na instalao. Se

o usurio digitar N, o processo de instalao ser interrompido.
Neste exemplo, o usurio digitou S (conforme demonstrado
acima).

22

Ministrio do
Desenvolvimento Social e
Combate Fome

4) O sistema verifica se j existe um servidor do Cadastramento nico

v6 instalado. Caso exista, a seguinte mensagem ser exibida em
tela:
Criando usuario cadunico

... Existente.

O servidor do Cadastramento Unico v6 parece ja estar instalado.

Selecione a operacao que deseja executar:
1 - Desinstalar
2 - Restaurar senha do Administrador
3 - Sair

Se o usurio digitar 1, o sistema antigo ser desinstalado. A

seguinte mensagem ser exibida em tela:
Limpando instalacao

... Ok.

Se o usurio digitar 2, o sistema ir restaurar a senha do

Administrador. A seguinte mensagem ser exibida em tela:
Restaurando senha do Administrador

... Ok.

Se o usurio digitar 3, o processo de instalao ser cancelado.

5) Se o sistema no localizar a existncia de um servidor do
Cadastramento nico v6 instalado, as seguintes mensagens sero
exibidas em tela:
Criando usuario cadunico
... Ok.
Descompactando programa
... Ok.
Configurando permissoes
... Ok.
Inicializando base de dados
... Ok.
Configurando servidor de base de dados ... Ok.
Iniciando servidor de base de dados ... Ok.
Executando carga inicial
... Ok.

23

Ministrio do
Desenvolvimento Social e
Combate Fome

6) O prximo passo solicita ao usurio que seja informado um ID

para o servidor:
Informe o ID que sera utilizado por esse servidor. O ID deve
ser um valor numerico entre 1 e 9999.
ID do Servidor: 1

Caso seja informado um valor que no esteja no intervalo de 1 a

9999, ser exibida, novamente, a solicitao para informar o ID do
servidor. No exemplo, foi informado um ID do Servidor igual a 1.
7) Aps informado um ID, o sistema atualizar as informaes no
sistema:
Aplicando configuracoes do sistema

... Ok.

8) O prximo passo solicita ao usurio que seja informado qual UF

ser utilizada. Nada impede que mais de uma UF seja carregada.
Para carregar as tabelas de CEP/INEP da UF mencionada, digite
"S" e pressione a tecla ENTER. Digite "N" ou qualquer outro valor
e pressione a tecla ENTER para nao carregar as mesmas.

24

Ministrio do
Desenvolvimento Social e
Combate Fome

9)

Sero
exibidas, uma a uma, as UF com a opo (S/N). Se a UF em
questo for a que o usurio deseja carregar na base de dados, basta
digitar S e pressionar o Enter. Se no for, basta digitar N e
pressionar o Enter. No exemplo abaixo, o usurio optou por
carregar a UF RJ.
Carregar AC (S/N)? n
Carregar AL (S/N)? n
Carregar AM (S/N)? n
Carregar AP (S/N)? n
Carregar BA (S/N)? n
Carregar CE (S/N)? n
Carregar DF (S/N)? n
Carregar ES (S/N)? n
Carregar GO (S/N)? n
Carregar MA (S/N)? n
Carregar MG (S/N)? n
Carregar MS (S/N)? n
Carregar MT (S/N)? n
Carregar PA (S/N)? n
Carregar PB (S/N)? n
Carregar PE (S/N)? n
Carregar PI (S/N)? n
Carregar PR (S/N)? n
Carregar RJ (S/N)? s
Carregar RN (S/N)? n
Carregar RO (S/N)? n
Carregar RR (S/N)? n
Carregar RS (S/N)? n
Carregar SC (S/N)? n
Carregar SE (S/N)? n
Carregar SP (S/N)? n
Carregar TO (S/N)? n
Carregando UF

...

25

Ministrio do
Desenvolvimento Social e
Combate Fome

10) Feitos todos os passos descritos acima, o servidor de base de

dados Linux j est em execuo e pronto para ser utilizado. Ser
exibida a mensagem:
** Instalacao Concluida **
[root@centro cadunico]#

11) Para que o servidor de base de dados seja iniciado

automaticamente sempre que este for reiniciado, voc dever
adicionar o script /usr/local/cadunico/inicia.sh a sua seqncia
de inicializao do sistema.
Por exemplo, no caso de um computador rodando o Linux Fedora
Core 3, o procedimento seria criar links especficos com os
comandos abaixo:
# ln s /usr/local/cadunico/inicia.sh /etc/rc.d/rc3.d/S90cadunico
# ln s /usr/local/cadunico/inicia.sh /etc/rc.d/rc5.d/S90cadunico

12) Para que o servidor de base de dados seja finalizado

automaticamente sempre que este for desligado, voc dever
adicionar o script /usr/local/cadunico/termina.sh a sua seqncia
de desligamento do sistema.
Por exemplo, no caso de um computador rodando o Linux Fedora
Core 3, o procedimento seria criar links especficos com os
comandos abaixo:
# ln s /usr/local/cadunico/termina.sh /etc/rc.d/rc3.d/K10cadunico
# ln s /usr/local/cadunico/termina.sh /etc/rc.d/rc5.d/K10cadunico

26

Ministrio do
Desenvolvimento Social e
Combate Fome

3.1.5.1. Otimizao do funcionamento do servidor de base de

dados no Linux
Ao executar a instalao do servidor do Cadastramento
nico Offline v6 no Linux, existem algumas providncias que podem
ser tomadas de forma a otimizar o funcionamento do servidor de base
de dados. Note que essas mudanas no so executadas
automaticamente pelo instalador devido ao fato de que a mesma
pressupe uma mudana na configurao do kernel do Linux, que
deve ser executada pelo administrador do sistema, se o mesmo
considerar que a mudana no vai afetar possveis outros servios
rodando no mesmo servidor.
Os seguintes passos devem ser executados para se determinar a
configurao ideal:
1 - Obtenha a quantidade de memria fsica disponvel no servidor em
megabytes (por exemplo, 512 Mb).
2 - Abra o arquivo "/usr/local/cadunico/data/postgresql.conf" no seu
editor de textos preferido.
3 - Localize o parmetro "shared_buffers". O valor padro do mesmo
deve ser 1000 ("shared_buffers = 1000").
4 - Altere esse valor seguindo a seguinte frmula:
quantidade_de_memria * 1024 * 15
--------------------------------------------800
Por exemplo, no caso de 512 Mb de memria:
512 * 1024 * 15
-------------------- = 9831 (Valor inteiro. Arredondado pra cima)
800
5 - Localize o parmetro "effective_cache_size". O valor padro do
mesmo deve ser 20000 ("effective_cache_size = 20000").
6 - Altere esse valor seguindo a seguinte frmula:
quantidade_de_memria * 1024 * 25
--------------------------------------------800
27

Ministrio do
Desenvolvimento Social e
Combate Fome

Por exemplo, no caso de 512 Mb de memria:

512 * 1024 * 25
-------------------- = 16384 (Valor inteiro. Arredondado pra cima)
800
7 - Antes de fechar o arquivo, localize o parmetro
"max_connections" e anote o valor do mesmo (normalmente, 100).
8 - Grave o arquivo.
Aps a execuo dessas alteraes, tentar reiniciar o servidor de base
de dados. Provavelmente resultar em falha na execuo do mesmo. Para
que isso no ocorra, devemos aumentar a quantidade mxima de memria
compartilhada por aplicao permitida pelo kernel do Linux. Execute os
seguintes passos:
9 - Determine o valor ideal usando a seguinte frmula:
250 + 8.2 * shared_buffers + 14.2 * max_connections
Por exemplo, no caso da mquina com 512 Mb mencionada acima:
250 * 8.2 * 9831 + 14.2 * 100 = 20154970
10 - De posse desse valor, altere o parmetro shmmax do kernel
utilizando o seguinte comando:
echo "valor_ideal" > /proc/sys/kernel/shmmax
Por exemplo, no caso descrito acima:
echo "20154970" > /proc/sys/kernel/shmmax
Note que a alterao, com o comando mencionado acima, s
vlida enquanto o computador no for reiniciado. Quando isso
ocorrer, o valor inicializado para o seu valor padro original. Para
garantir que esse valor esteja sempre correto quando o servidor de
base de dados for iniciado, recomendamos que se edite o arquivo
"/usr/local/cadunico/inicia.sh" e que se coloque a linha mencionada
logo abaixo da primeira linha nesse arquivo. Em outras palavras,
mude o contedo do arquivo (no caso do nosso exemplo) de:
#!/bin/sh
28

Ministrio do
Desenvolvimento Social e
Combate Fome

DIR=/usr/local/cadunico
su
cadunico
-c
"$DIR/bin/pg_ctl
-D
$DIR/log/cadunico.log start"
Para:
#!/bin/sh
echo "20154970" > /proc/sys/kernel/shmmax
DIR=/usr/local/cadunico
su
cadunico
-c
"$DIR/bin/pg_ctl
-D
$DIR/log/cadunico.log start"

$DIR/data

-l

$DIR/data

-l

IMPORTANTE:
O processo acima pode resultar em problemas caso executado
por algum que no esteja familiarizado com o Linux.
Recomendamos que o processo todo seja executado ou
acompanhado por algum com conhecimento tcnico.

29

Ministrio do
Desenvolvimento Social e
Combate Fome

3.2. Atualizao
3.2.1. Cpia de Segurana
Na execuo da atualizao de verso do aplicativo, imprescindvel
que seja feita uma cpia de segurana da base de dados. Este procedimento
permitir que a prefeitura mantenha todas as informaes cadastradas at a
data da cpia de segurana e, inclusive, permitir a importao de todos os
arquivos retorno que ainda, porventura, estejam pendentes de importao.
Para realizar a cpia de segurana, verifique o respectivo item no
manual operacional deste aplicativo.
3.2.2. No Windows
S ser permitida a atualizao para a verso 6.0.5, caso a verso
atualmente instalada seja a 6.0.4. Caso possua uma verso anterior, proceda
com a atualizao para a 6.0.4 e posteriormente para a 6.0.5.
A tela inicial (Fig. 17), apresentada logo aps a solicitao de
atualizao, informa ao usurio algumas recomendaes necessrias.
Na parte inferior da tela, o aplicativo identifica qual(is) a(s)
configurao(es) encontrada(s) na mquina em que est sendo realizada a
atualizao. Neste caso, informado que, a configurao da mquina
composta de servidor e cliente.

Fig. 17

30

Ministrio do
Desenvolvimento Social e
Combate Fome

A mensagem seguinte exibida (Fig. 18), informando ao usurio que

todas as outras estaes de trabalho (clientes), devem ser atualizadas para a
mesma verso do servidor.

Fig. 18

A mensagem exibida a seguir (Fig. 19), informa ao usurio que

recomendvel realizar uma cpia de segurana antes de proceder com a
atualizao do aplicativo.

Fig. 19

Ao prosseguir com a atualizao, a mensagem a seguir exibida

(Fig. 20), informando que o servio pgsql-cadunico est sendo parado e
logo em seguida ser reiniciado.

Fig. 20

31

Ministrio do
Desenvolvimento Social e
Combate Fome

A tela a seguir (Fig. 21), apresenta ao usurio a evoluo da cpia

dos arquivos necessrios para realizar a atualizao do aplicativo.

Fig. 21

32

Ministrio do
Desenvolvimento Social e
Combate Fome

Ao trmino da cpia de arquivos, a tela abaixo (Fig. 22)

apresentada.

3.2.3. No Linux

Fig. 22

O kit de atualizao distribudo como um arquivo compactado no formato

zip. Descompacte este arquivo para obter o arquivo no formato .tar.gz. Aps a
obteno do arquivo no formato .tar.gz, abra uma janela de Terminal, v para o
diretrio onde baixou o arquivo de instalao (usando o comando cd) e siga os
passos abaixo. Note que a operao de instalao deve ser executada pelo usurio
root:
1) Digite a linha de comando abaixo para descompactar o arquivo:
# tar xzf CadUnicoAtualizacao605L.tar.gz

Esse procedimento resultar em dois arquivos

descompactados. Um deles o atualizador propriamente dito.

sendo

2) Para instalar, basta digitar a seguinte linha de comando abaixo.

# ./instalar.sh

33

Ministrio do
Desenvolvimento Social e
Combate Fome

3) Seguir as instrues apresentadas na tela:

** Atualizao do Servidor do Cadastramento nico v6 (Linux) **
** Verso 6.0.5 **
Este programa ir atualizar o Servidor do Cadastramento nico v6
para Linux. Tenha certeza de que nenhum Cliente do Cadastramento
nico v6 esteja conectado a base durante o processo de atualizao.
Tem certeza de que deseja continuar (S/N)? s

Se o usurio digitar S, ser dada continuidade na atualizao. Se o

usurio digitar N, o processo de atualizao ser interrompido. Neste
exemplo, o usurio digitou S (conforme demonstrado acima).
4) O sistema verifica se j existe um servidor do Cadastramento nico v6
instalado.
Caso exista, a seguinte mensagem ser exibida em tela:
Checando instalao do Servidor
Obtendo verso da base instalada
Executando instalao

... Ok.
... Ok.
... Ok.

Caso no exista um servidor instalado, ser exibida a seguinte mensagem

em tela:
Checando instalao do Servidor

... Falha.

O servidor do Cadastramento nico v6 para Linux no parece estar

instalado. Impossvel executar atualizao.

34

Ministrio do
Desenvolvimento Social e
Combate Fome

5) O sistema verifica se o servidor j foi atualizado anteriormente, ou seja,

se j se encontra em uma verso igual ou posterior a disponvel. Ser
exibida a seguinte mensagem em tela:
Nenhuma atualizao foi aplicada, pois sua base j se encontra em uma
verso igual ou posterior a disponvel neste atualizador.

Caso contrrio, ser exibida a seguinte mensagem em tela:

Atualizao concluda com sucesso.

35

Ministrio do
Desenvolvimento Social e
Combate Fome

4. Acesso ao sistema pela primeira vez.

Para primeiro acesso ao sistema, deve ser utilizado o usurio e a senha padro
conforme informado anteriormente:
Login
Senha

ADMINISTRADOR
administrador

Aps o primeiro acesso, recomenda-se alterar a senha do administrador do

sistema e criar usurios e grupos, conforme indicado no manual operacional do
sistema.
5. Desinstalao
5.1. Em Windows
A desinstalao do aplicativo deve ser efetuada a partir do Painel de
Controle, no item Adicionar e Remover Programas.
5.2. Em Linux
Para desinstalar em sistema Linux, deve-se seguir as orientaes a partir
do item 3.7, e no passo 4, informar a opo 1 Desinstalao.

36

Ministrio do
Desenvolvimento Social e
Combate Fome

6. Excees
6.1. Verso anterior a 6.0 instalada.
Caso o aplicativo de instalao constate a presena de uma verso
anterior a 6.0, a tela seguinte apresentada (Fig. 23) ao usurio.

Fig. 23

6.2. Sair do sistema antes do trmino da instalao

Caso o usurio pressione o boto Cancelar durante a instalao ou
atualizao, a tela seguinte (Fig. 24) exibida.

Fig. 24

37

Ministrio do
Desenvolvimento Social e
Combate Fome

6.3. Instalar por sobre uma verso anterior atual e superior a 5.0.x
Caso o instalador verifique que uma verso anterior atual est instalada
no sistema, a seguinte mensagem (Fig. 25) apresentada.

Fig. 25
6.4. Sem selecionar alguma UF para configurao.
Caso o usurio no selecione alguma UF para configurao conforme
apresentado na fig. 08, a mensagem seguinte (Fig. 26) exibida ao usurio.

Fig. 26

38

Ministrio do
Desenvolvimento Social e
Combate Fome

6.5. O servio pgsql-cadunico no foi reiniciado.

Quando o atualizador no consegue iniciar o servio, a tela (Fig. 27)
apresentada ao usurio. Pressione OK para continuar o processo de atualizao.

Fig. 27

6.6. Atualizar sobre uma verso inferior a 6.0.4.

Caso o instalador verifique que uma verso anterior 6.0.4 est instalada
no sistema, a seguinte mensagem (Fig. 27) apresentada.

Fig. 27

39