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

De 5.001 a 30.000 domiclios.

De 30.001 a 100.000 domiclios.

Acima de 100.000 domiclios.

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

De 5.001 a 30.000 domiclios.

De 30.001 a 100.000 domiclios.

Acima de 100.000 domiclios.

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. 2) Para instalar, basta digitar a seguinte linha de comando abaixo.
# ./instalar.sh

sendo

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.

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

Fig. 27

39