Manual de Instalao

Instalao via apt-get

SIGA-ADM verso 12.02

ndice de captulos
1 - Pr-requisitos para instalao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 05

2 - Instalando o SIGA-ADM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 05 2.1 - Preparando a instalao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 05 2.2 - Instalando e configurando o SIGA-ADM . . . . . . . . . . . . . . . . . . 06 2.3 - Acessando o SIGA-ADM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 08

3 - Removendo o SIGA-ADM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 08

4 - Atualizao da base de dados de verses anteriores . . . . . . . . . . . . . . . . . . . . . .. . . . . . 09 4.1 Introduo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .09 4.2 - Permisses de acesso do postgresql .. . . . . . . . . . . . . . . . . . . . . .11 4.3 - Realizar backup do Schema e dos dados em formato (UTF8 ACII). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 4.4 - O que fazer para atualizar uma base anterior verso 10.12 para a verso atual. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

5 - Consideraes finais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4

ndice de figuras
Fig.01 - Confirmao da instalao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .06 Fig.02 - Licena do JAVA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .06

Fig.03 - Concordando com os termos da licena do JAVA . . . . . . . . . . . . . . . . . . . . . 07

Fig.04 - Concordando com a licena do SIGA-ADM

. . . . . . . . . . . . . . . . . . . . . . . . 07

Fig.05 - Campo para insero do nome da Instituio

. . . . . . . . . . . . . . . . . . . . . . 07

Fig.06 - Campo para insero da sigla da Instituio . . . . . . . . . . . . . . . . . . . . . . . . 07

Fig.07 - Campo para insero do endereo IP do servidor . . . . . . . . . . . . . . . . . . . . 08

Fig.08 - Tela inicial da aplicao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 08

Projeto SIGA-EPCT

Introduo
O SIGA-ADM um subsistema do SIGA-EPT (Sistema Integrado de Gesto Acadmica da Educao Profissional e Tecnolgica), desenvolvido com tecnologias livres pela Rede Nacional de Pesquisa e Inovao em Tecnologias Digitais - RENAPI. http://www.renapi.gov.br

Manual de Instalao via apt-get

Este projeto tem o apoio do Ministrio da Educao - MEC (http://portal.mec.gov.br), atravs da Secretaria da Educao Profissional e Tecnolgica- SETEC. http://portal.mec.gov.br/setec

Para mais informaes sobre o projeto visite: http://www.renapi.gov.br/sigaepct/o-projeto

Objetivos
Este manual objetiva explicitar os procedimentos e ferramentas necessrias a instalao e configurao do subsistema SIGAADM (Sistema Integrado de Gesto Acadmica) em um sistema operacional Linux atravs de um terminal, utilizando comando apt-get.
SISTEMA INTEGRADO DE GESTO ACADMICA

Verso fevereiro/2012

Instalao
1 - Pr-requisitos para instalao

!
Lembramos que este manual destina-se a explicar como realizar a instalao do SIGA-ADM em um sistema operacional Linux de 32 ou 64 bits, baseado nas distribuies Debian Lenny e Ubuntu Server 10.04.

Para que voc possa efetuar as instalaes sem problemas recomendamos utilizar um usurio que tenha permisso de root (super usurio). Estando logado no terminal com um usurio que possua a permisso, basta executar o comando abaixo para alterar para root: $ sudo su Caso no consiga logar como super usurio, voc ter de entrar em contato com o administrador do computador, pois s ele poder lhe conceder a permisso. Tambm necessrio que voc tenha acesso a uma Internet banda larga, pois todos os arquivos mencionados neste documento so obtidos atravs de download. 2 - Instalando o SIGA-ADM
2.1 - Preparando a instalao

Manual SIGA-ADM - Manual de Instalao via apt-get

Para que o sistema possa ser instalado via o comando aptget necessrio adicionar o link do repositrio ao arquivo /etc/apt/sources.list. Use o editor de texto de sua preferncia e adicione a linha abaixo no final do arquivo. deb http://mirror-ifrn.renapi.gov.br/sigaept/apt/linux sigaepct/ Para Debian Lenny que no possuir repositrio para as dependncias na sources.list, adicione tambm ao arquivo a linha abaixo. deb http://download.unesp.br/linux/debian lenny main contrib non-free Por ltimo, atualize a lista de pacotes executando este comando: # apt-get update

05
v e r s o 11 . 12

2.2 - Instalando e configurando o SIGA-ADM

Manual SIGA-ADM - Manual de Instalao via apt-get

Aps executar os passos da seo anterior, inicie a instalao atravs deste comando: # apt-get install renapi-sigaadm Ser exibida a mensagem da figura 1 questionando se voc deseja instalar o sistema. Confirme pressionando Y ou S, dependendo da linguagem de seu sistema operacional.
Fig. 01 - Confirmao da Instalao

Em seguida, ser exibida outra mensagem, desta vez questionando se os pacotes devem ser instalados sem verificao. Novamente pressione Y ou S para concordar. A partir deste momento, ser efetuado o download de todos os pacotes necessrios. Este passo poder ser demorado, dependendo da velocidade de sua conexo Internet. Durante o download voc ser questionado a concordar com termos de licena dos softwares envolvidos. Uma das licenas exibidas a do Java (figura 2). Pressione A tecla TAB para acessar o OK.
Fig. 02 - Licena do JAVA

06
v e r s o 11 . 12

Aps ter lido a licena, concorde selecionado Sim (figura 3):

Fig. 03 - Concordando com os termos da licena do JAVA

Ser exibida a licena do SIGA-ADM. Pressione Sim para concordar (figura 4):
Fig. 04 - Concordando com a licena do SIGA-ADM

Manual SIGA-ADM - Manual de Instalao via apt-get

Quando for solicitado, digite o nome completo da Instituio.

Fig. 05 - Campo para insero do nome da Instituio

Quando for solicitado, digite a sigla da instituio.

Fig. 06 - Campo para insero da sigla da Instituio

07
v e r s o 11 . 12

Em seguida, insira o endereo IP do computador no qual a aplicao est rodando.

Fig. 07 - Campo para insero do endereo IP do servidor

Manual SIGA-ADM - Manual de Instalao via apt-get

Por fim, defina uma senha para o banco de dados da aplicao. Aps ter digitado as configuraes, o banco de dados ser criado e populado com algumas informaes necessrias. Este procedimento poder levar algum tempo.
2.3 - Acessando o SIGA-ADM

Para acessar o sistema, voc poder abrir um browser no servidor e digitar a seguinte URL: http://localhost/
Fig. 08 - Tela inicial da aplicao

3 - Removendo o SIGA-ADM Para remover a aplicao execute: #apt-get remove renapi-sigaadm Caso deseje remover a aplicao por completo, inclusive as dependncias, execute #apt-get autoremove renapi-sigaadm

v e r s o 11 . 12

08

4 - Atualizao da base de dados de verses anteriores

4.1 - Introduo

Este manual prev uma instalao nova ou uma atualizao de verso do sistema SigaEPCT-ADM.

!
Embora seja a instalao seja homologada pela equipe de desenvolvimento para sistema em plataforma Linux com base Ubuntu e/ou Debian, possvel a sua instalao em qualquer outro sistema operacional que oferea uma

Nesta verso mudamos o modo de atualizao da base: antes, realizvamos a migrao de dados de uma estrutura antiga para a nova estrutura do banco.

Agora quando existir uma base j alimentada da verso 10.12 ou superior, esta ser atualizada automaticamente pelo script de instalao.

No entanto, caso queira ou prefira, poder tambm utilizar o script de atualizao ajustesXX.XX.sql, que se encontra no caminho /var/www/miolo/modules/config/sql/XX.XX , onde XX.XX o nmero da verso, por exemplo 12.02. Ao fim deste manual tambm daremos instrues para migraes de verses anteriores a 10.12.

Manual SIGA-ADM - Manual de Instalao via apt-get

ambiente Apache 2.2, PHP5 e PostgreSQL8.3, ficando a critrio do administrador local resolver qualquer disparidade quando a configurao de ambiente fora do homologado por esta equipe.

Recomendamos utilizar um usurio que tenha permisso de ambiente do Shell do Linux, SSH e PostgreSQL.
CONSIDERAES

Os caracteres "<" e ">" sero utilizados apenas por questes didticas para indicar onde, no comando, dever ser alterado. Eles no devero permanecer aps a
v e r s o 11 . 12

09

substituio dos valores.

<host> - dever ser substitudo pelo endereo da mquina onde est o banco de dados instalado. Em caso de estar na mesma mquina, utilizar a referncia "localhost". Em caso de estar em outra mquina dever ser informado o IP da mquina, no se esquecendo de dar permisso de acesso ao IP que voc est utilizando como cliente. Para isto, dever ser dado este privilgio na sesso "# IPv4 local connections:" do arquivo /etc/postgresql/8.3/main/pg_hba.conf da mquina servidora do banco. <porta> - informasse a porta de listener do PostgreSQL, normalmente 5432. Porm, caso queira trocar esta porta, a mesma dever ser informada.

Manual SIGA-ADM - Manual de Instalao via apt-get

<usurio do postgres> Por padro, o usurio "postgres"; Se acaso for diferente, trocar pelo usurio que utilizado em seu banco customizado;

<caminho> - dever ser indicado o diretrio onde ser gravado o arquivo. No esquecer este caminho, pois ser necessrio para a futura recuperao dos dados;

<nome da base> - nome da base de dados, por padro "dbsiga"; se houver sido alterada informar o novo nome;

10

4.2 - Permisses de acesso do postgresql

Para acessar a base do postgresql de um computador remoto necessrio trabalhar as permisses do banco no arquivo /etc/postgresql/8.3/main/pg_hba.conf.

Para isso,encontre a sesso do arquivo identificada como #IPv4 local connections e insira a permisso de confivel (trust) para seu ip e mscara: host all all 127.0.0.1/32 trust #para acesso local host all all <IP>/<MASK> trust #para acesso remoto O <IP> dever ser substitudo pelo endereo da mquina que voc quer utilizar como cliente de acesso ao banco. <MASK> representa a viso de endereos dada pela mscara de subrede que, por padro, seriam /0, /8,

Manual SIGA-ADM - Manual de Instalao via apt-get

/16 , /24 e /32.

4.3 - Realizar backup do Schema (estrutura do banco de dados) e dos dados (UTF8 ASCII):

Dados do banco: /usr/bin/pg_dump --host <host> --port <porta> -username <usurio_do_postgres> --format plain --dataonly --disable-triggers --column-inserts --disable-dollarquoting --verbose --file "<caminho>/dbsiga_dados.sql" <nome da base>

Schema do banco: /usr/bin/pg_dump --host <host> --port <porta> -username <usurio_do_postgres> --format plain --schemaonly --no-owner --create --column-inserts --disable-dollarquoting --verbose --file "<caminho>/dbsiga_schema.sql" <nome da base>
s 1

11

4.4 - O que fazer para atualizar uma base anterior a verso 10.12 para a verso atual

Manual SIGA-ADM - Manual de Instalao via apt-get

Baseado em aes tomadas em ambientes de testes, afirmamos que:

se exportados os dados antigos para um arquivo (sugerido aqui como "<caminho>/dbsiga_dados.sql");

se destruirmos o banco dbsiga anterior e construirmos um novo com o novo esquema;

importarmos os dados do arquivo sugerido;

os dados entraro na nova estrutura tranquilamente.

Para realizar a migrao de uma base anterior verso 10.12, devemos, primeiramente, levar a base verso 11.07 e, posteriormente, executar o script de ajuste para a verso atual.
Verso do banco anterior verso 10.12

upgrade_sigaepct_adm_old_4_11.07.sql upgade_sequences_sigaepct_adm_11.07.sql

Verso do banco 10.12 ou superior

ajustesXX.XX.sql onde XX.XX representa a verso atual do sistema

Lembrando que os scripts se encontram em /var/www/miolo/modules/config/sql/XX.XX , como dito na introduo deste captulo.

12

Segue um exemplo de como seria: sudo su postgres # Abrir uma sesso com o usurio postgres, necessrio na manipulao e administrao do banco pelo cliente psql; caminho=/var/www/miolo/modules/config/sql/11.07/ #define uma varivel caminho para simplificao na execuo do script usr/bin/pg_dump --host <host> --port <porta> --username <usurio_do_postgres> --format plain --schema-only --no-owner --create --column-inserts --disable-dollar-quoting --verbose --file "$caminho/dbsiga_schema.sql" <nome da base> # exporta os dados no dbsiga para recuperao futura psql -U <nome do usurio do banco> -c drop database <nome da base>; #destri o banco de dados anterior psql -U <usurio_do_postgres> -f $caminho/new_schema_sigaepct_adm_11.07.sql # executa o script que cria o database dbsiga e sua estrutura de objetos psql -U <usurio_do_postgres> -d <nome da base> -f $caminho/dbsiga_schema.sql # executa o script que alimenta os dados no dbsiga exportados previamente; psql -U <usurio_do_postgres> -d <nome da base> -f $caminho/upgrade_sigaepct_adm_old_4_11.07.sql # executa o script que atualiza os valores de algumas tabelas conforme necessidades da verso 11.07; psql -U <usurio_do_postgres> -d <nome da base> -f $caminho/upgrade_sequences_sigaepct_adm_11.07.sql # executa o script que atualiza os valores das sequences a partir dos valores mximos nas tabelas correspondentes. Atualizando para a verso atual XX.XX caminhoXXXX=/var/www/miolo/modules/config/sql/XX.XX, onde XX.XX representa a verso atual. psql -U <usurio_do_postgres> -d <nome da base> -f $caminhoXXXX/ajustesXX.XX.sql # executa o script que atualiza estrutura e dados da base para a verso atual.

Manual SIGA-ADM - Manual de Instalao via apt-get

13

5 - Consideraes finais
A RENAPI agradece a voc por ter instalado o SIGAADM. Sua participao no desenvolvimento deste sistema fundamental para o sucesso do projeto. Envie-nos um email (suporte-adm.sigaept@renapi.gov.br). Faa parte desta equipe, colaborando com

sugestes ou contando sua experincia. Desta forma, poderemos tornar o SIGA-ADM um sistema cada vez melhor.

realmente ter lhe auxiliado na instalao do SIGAADM.

Se voc encontrou problemas, possveis erros ou gostaria de nos ajudar a melhor-lo, abra um ticket de suporte no REDMINE (http://redmine.renapi.gov.br).

Gostaramos

ainda

de

lembrar

que

toda

documentao relativa ao uso dos mdulos do SIGA-ADM est disponvel em www.renapi.gov.br/sigaepct/download/versoes. Visite o portal da RENAPI e conhea outros projetos: http://www.renapi.gov.br.

Manual SIGA-ADM - Manual de Instalao via apt-get

14

Esperamos que o contedo deste manual possa