Manual do Usuário. Instalação via Terminal. SIGA-ADM versão 12.06

Transcrição

1 Manual do Usuário Instalação via Terminal SIGA-ADM versão 12.06

2 Projeto SIGA-EPT Manual do Usuário Instalação via Terminal Introdução Este manual objetiva explicitar os procedimentos e ferramentas necessárias para a instalação e configuração do subsistema SIGA-ADM num sistema operacional Linux x86, via terminal. O sistema não é compatível com o Ubuntu LTS e nem com o Debian Squeeze, devido a problemas de dependências da versão 8.3 do Postgresql, que ainda é utilizada oficialmente pelo SIGA-ADM. Porém, ele roda perfeitamente no Ubuntu 12.04, utilizando o postgresql-9.1. Nas demais versões ainda suportadas do Ubuntu, a 10.04, a e a 11.10, ele é totalmente compatível. O sistema também é compatível com o Java 7 da Oracle. Neste manual foi utilizada a versão do Ubuntu. O SIGA-ADM é um subsistema do SIGA-EPT (Sistema Integrado de Gestão Acadêmica da Educação Profissional e Tecnológica), desenvolvido com tecnologias livres e de forma colaborativa por várias instituições federais de ensino. Este projeto tem o apoio do Ministério da Educação MEC ( através da Secretaria da Educação Profissional e Tecnológica SETEC ( Para mais informações sobre o projeto, visite: Versão Junho/2012

3 Índice de capítulos Parte I Observações Parte II Instalação Softwares necessários Configurando o repositório Instalando o Apache Instalando e configurando o PHP Instalando o Java 6 da Sun Instalando e configurando o PostgreSQL Obtendo e configurando o sistema SIGA-ADM Obtendo a aplicação Configurando a aplicação Configurando a base de dados Configurando o Apache Parte III Atualização Obtendo e configurando o sistema SIGA-ADM Obtendo a aplicação Atualizando a aplicação Atualizando a base de dados Parte IV Configurações especiais Utilizando a base de dados em outra máquina Configurando o servidor do banco de dados Configurando o servidor da aplicação Parte V Desinstalação Parte VI Considerações finais

4 Parte I Observações Para que você possa instalar os softwares sem problema, recomendamos utilizar um usuário que tenha permissão de root (super-usuário). Caso não esteja logado no terminal com tal usuário, execute o comando abaixo para alterar para root: $ su O carácter # no início do comando indica que o mesmo deve ser executado pelo usuário root. Parte II Instalação 1. Softwares necessários! Para que a instalação do SIGA-ADM seja possível, é necessário que os seguintes softwares estejam instalados na máquina: PHP5, Apache2, PostgreSQL 8.3 e Java 6 da Sun Configurando o repositório Confira atentamente os comandos add-apt-repository antes de executá-los, para não adicionar repositórios incorretos. Não os copie e cole deste pdf, pois há quebra de linha, que deve ser substituída por espaço em ubuntu hardy-security e removida em sun-java-community-team. Digite-os no terminal para evitar problemas. Antes de instalar os softwares precisamos adicionar dois repositórios; um para o PostgreSQL 8.3 e outro para o Java 6 da Sun. Para isso, execute os comandos abaixo: # add-apt-repository deb hardy-security main # add-apt-repository deb lucid main # apt-get update 1.2. Instalando o Apache 2 Para instalar o servidor web apache2, execute o comando abaixo: # apt-get install apache2 04

5 Depois de instalar o servidor, você precisará da libapache2-mod-php5, que é uma biblioteca do Apache2 para interpretação de código PHP5. Para instalar execute o comando a seguir: # apt-get install libapache2-mod-php Instalando e configurando o PHP5 Execute o comando abaixo para instalar o PHP5: # apt-get install php5 Você precisará instalar também o módulo php5-pgsql, para que o interpretador PHP5 possa se conectar com o PostgreSQL. Para isso execute o comando abaixo: # apt-get install php5-pgsql Depois disso, verifique a memória disponibilizada ao PHP5 em /etc/php5/apache2/php.ini. O ideal é que seja 128 Mb. Abra o arquivo com o editor de sua preferência e altere o valor, caso seja necessário: # vim /etc/php5/apache2/php.ini A variável a ser alterada está próxima à linha 458 do arquivo. Descomente-a caso esteja comentada: memory limit = 128M 1.4. Instalando o Java 6 da Sun Para instalar a máquina virtual Java, execute o comando a seguir: # apt-get install sun-java6-jre Verifique a instalação, digitando o comando java -version no terminal. Deve ser retornado algo parecido com: java version "1.6.0_21" Java(TM) SE Runtime Environment (build 1.6.0_21-b06) Java HotSpot(TM) Client VM (build 17.0-b16, mixed mode, sharing) 1.5. Instalando e configurando o PostgreSQL 8.3 O SIGA-ADM foi homologado para a versão 8.3 do PostgreSQL. Para instalá-lo, execute o comando a seguir: # apt-get install postgresql

6 Durante a instalação será criado um usuário chamado postgres, esse é o usuário padrão do PostgreSQL. Ele terá acesso a todos os recursos do SGBD, porém para trabalhar conectado com o usuário postgres, após o término da instalação, é necessário alterar sua senha, pois ela é gerada automaticamente durante a instalação. Estando logado como root, utilize o seguinte comando para logar como "postgres": # su - postgres Estando logado como postgres, entre no terminal iterativo do PostgreSQL (psql) com o comando: $ psql Após esse comando, será mostrada uma mensagem de boas vindas ao terminal psql, acompanhado de alguns comandos que poderão ser úteis. Para alterar a senha do usuário postgres, utilize o seguinte comando no terminal psql, substituindo <senha> pela senha escolhida por você: postgres=# ALTER USER postgres WITH ENCRYPTED PASSWORD '<senha>'; Se a alteração ocorreu de forma correta, logo abaixo do comando executado deverá ser apresentada a seguinte mensagem: ALTER ROLE Saia do terminal interativo utilizando o comando: postgres=# \q Encerre a sessão com o usuário postgres utilizando o comando: $ exit Para poder logar no PostgreSQL com o usuário "postgres" é necessário alterar uma linha no arquivo: /etc/postgresql/8.3/main/pg_hba.conf: # vim /etc/postgresql/8.3/main/pg_hba.conf 06

7 Localize a seguinte linha: Database administrative login by UNIX sockets # Database administrative login by UNIX sockets local all postgres ident sameuser E substitua ident sameruser por md5, de forma a ficar: Database administrative login by UNIX sockets # Database administrative login by UNIX sockets local all postgres md5 Reinicie o PostgreSQL, com os comandos abaixo para fazer valer as alterações: # /etc/init.d/postgresql-8.3 stop # /etc/init.d/postgresql-8.3 start Agora já é possível logar no PostgreSQL. Para testar, utilize o comando abaixo: # psql -U postgres Forneça a senha do usuário postgres. Será aberto o terminal interativo psql. 2. Obtendo e configurando o sistema SIGA-ADM 2.1. Obtendo a aplicação Utilize o diretório temporário /tmp para armazenar os arquivos baixados. Posteriormente eles serão movidos para o local adequado: # cd /tmp Para obter o pacote do SIGA-ADM, execute o comando a seguir, observando que a url deve ficar na mesma linha e sem espaços: # wget Descompacte a aplicação com o comando abaixo: # dpkg-deb -x renapi-sigaadm_12.06_all.deb./ Vamos agora mover a aplicação para o seu local definitivo e configurar as permissões de acesso. Aqui vou colocá-la em /var/www, porém, ela pode ficar em qualquer outro diretório à sua escolha. 07

8 # cd var/www # mv miolo /var/www/miolo # chown -R www-data /var/www/miolo # chmod -R 700 /var/www/miolo 2.2. Configurando a aplicação Esta etapa consiste em substituir valores pré-definidos em alguns arquivos do SIGA-ADM. São esses valores que a aplicação irá utilizar para comunicar-se com cada programa envolvido. Aqui serão utilizadas <VARIAVEIS> que deverão ser substituidas pelos valores definidos por você conforme! Confira atentamente os comandos sed antes de executá-los, para não alterar os dados de maneira incorreta. Não os copie e cole deste pdf, pois há quebra de linha, que deve ser substituída por espaço. Digite-os no terminal para evitar problemas. achar conveniente. Os caracteres < e > também deverão ser substituidos. Deverá ser observado também, o diretório em que se encontra a aplicação, substituindo o /var/www pelo endereço escolhido anteriormente, caso diferente deste. ATENÇÃO: Caso o diretório da aplicação não seja o /var/www, e somente neste caso, rode o comando abaixo para substituir o endereço no arquivo de configuração do sistema: # sed -i s,/var/www,<diretorio_aplicacao>,g /var/www/miolo/etc/miolo.conf O primeiro valor a ser informado é a senha do usuário padrão do banco de dados, o postgres (aquela que foi alterada anteriormente). Faça isso, executando o comando abaixo: # sed -i s,postgres,<senha_postgres>,g /var/www/miolo/etc/passwd.conf Depois, substitua o valor da URL em que o sistema estará disponível. O padrão é # sed -i s, /var/www/miolo/etc/miolo.conf A seguir, substitua o valor do de suporte, que estará visível na tela inicial do sistema: # sed -i s,suporte-adm.sigaept@renapi.gov.br,< _suporte>,g /var/www/miolo/etc/miolo.conf Agora é a vez do nome e da sigla da instituição: # sed -i s,sigla_instituicao,<sigla_instituicao>,g /var/www/miolo/etc/miolo.conf 08 # sed -i s,nome_instituicao,<nome_instituicao>,g /var/www/miolo/etc/miolo.conf

9 2.3. Configurando a base de dados Nesta seção criaremos a base de dados do SIGA-ADM. Para isso execute o comando abaixo para criar o banco dbsiga: # psql -U postgres -c CREATE DATABASE dbsiga WITH TEMPLATE = template0 ENCODING='UTF8' OWNER postgres Agora acesse o diretório com os scripts sql : # cd /var/www/miolo/modules/config/sql Veja que existem vários diretórios, um para cada versão do SIGA-ADM. Começaremos então pelo 11.07, onde criaremos e popularemos as tabelas do banco dbsiga. Depois vamos passar por cada uma das versões subseqüentes efetuando os ajustes necessários: # cd 11.07/ Para criar as tabelas do banco, execute o comando a seguir: # psql dbsiga -U postgres -f new_schema_sigaepct_adm_1107.sql Dê o comando abaixo para popular as tabelas do banco dbsiga: # psql dbsiga -U postgres -f new_data_sigaepct_adm_1107.sql Utilize agora os comandos a seguir para atualizar o banco para a versão 11.11: # cd../11.11/ # psql dbsiga -U postgres -f ajustes11.11.sql Vamos atualizar agora o banco para a versão 11.12: # cd../11.12/ # psql dbsiga -U postgres -f ajustes11.12.sql Depois atualizaremos o banco para a versão 12.02: # cd../12.02/ # psql dbsiga -U postgres -f update12.02.sql Após isto, atualizaremos o banco para a versão # cd../12.05/ # psql dbsiga -U postgres -f update12.05.sql E por último, atualizaremos o banco para a versão Depois disto a base de dados estará pronta! # cd../12.06/ # psql dbsiga -U postgres -f update12.06.sql 09

10 2.4. Configurando o Apache2 Primeiramente vamos habilitar os módulos do PHP5: # cd /etc/apache2/mods-available # a2enmod php5 Agora vamos criar o virtualhost que permitirá que a aplicação seja acessada pela URL definida no miolo.conf: # cd /etc/apache2/sites-available # vim siga Será aberto um arquivo vazio. Coloque o conteúdo abaixo nele, sempre lembrando de configurar o endereço da aplicação, caso necessário. Salve e saia após: <VirtualHost *:80> ServerAdmin webmaster@localhost DocumentRoot /var/www/miolo/html/ <Directory /var/www/miolo/html/> Options Indexes FollowSymLinks MultiViews AllowOverride None Order allow,deny allow from all </Directory> ErrorLog /var/log/apache2/error-siga.log CustomLog /var/log/apache2/access-siga.log combined LogLevel warn ServerSignature off </VirtualHost> Adicione o mesmo virtual host no arquivo /etc/apache2/httpd.conf: # cat siga >../httpd.conf Vamos agora habilitar o virtual host criado. Para isso execute o comando a seguir: # a2ensite siga Depois disso, reinicie o apache2 para fazer valer as alterações: # /etc/init.d/apache2 stop # /etc/init.d/apache2 start 10 Pronto! A aplicação já pode ser acessada. Abra um browser e digite a URL da aplicação. O usuário padrão é: admin com senha adm-009

11 Parte III Atualização Caso você já possua uma versão anterior do SIGA-ADM instalada, utilize esta seção para fazer a atualização para a versão atual, a Será um procedimento bastante simples, pois o ambiente já está todo configurado. Vamos, apenas, substituir os arquivos da versão antiga pelos da atual e atualizar a base de dados. 1. Obtendo e configurando o sistema SIGA-ADM 1.1. Obtendo a aplicação Utilize o diretório temporário /tmp para armazenar os arquivos baixados. Posteriormente elses serão movidos para o local adequado: # cd /tmp Para obter o pacote do SIGA-ADM, execute o comando a seguir, observando que a url deve ficar na mesma linha e sem espaços: # wget Descompacte a aplicação com o comando abaixo: # dpkg-deb -x renapi-sigaadm_12.06_all.deb./ 1.2. Atualizando a aplicação O próximo passo é substituir os arquivos antigos pelos da nova versão. Mas antes, vamos manter alguns arquivos da aplicação antiga que não precisam ser atualizados. Para ficar mais fácil, mude para o diretorio onde se encontra o miolo baixado anteriormente: # cd var/www Atenção: Aqui vou supor que a aplicação antiga está em /var/www. Caso a sua não esteja neste endereço, altere os comandos substituindo o diretório em que se encontra sua aplicação. Vamos mover os arquivos de configuração miolo.conf e passwd.conf. Para isso, execute os comando abaixo: 11

12 # mv /var/www/miolo/etc/miolo.conf miolo/etc/ # mv /var/www/miolo/etc/passwd.conf miolo/etc/ Outros arquivos, que também não necessitam ser atualizados são os de configuração dos módulos adm e protocolo. Nestes arquivos estão dados como as configurações de , para aviso de determinados eventos no sistema: # mv /var/www/miolo/modules/adm/etc/module.conf miolo/modules/adm/etc/ # mv /var/www/miolo/modules/protocolo/etc/module.conf miolo/modules/protocolo/etc/ Pronto! Depois do backup destes arquivos, já podemos substituir a aplicação antiga. Para isso utilize o comando abaixo: # rm -fr /var/www/miolo # mv miolo /var/www/ E por último, vamos configurar as permissões de acesso: # chown -R www-data /var/www/miolo # chmod -R 700 /var/www/miolo 1.3. Atualizando a base de dados Vamos agora, fazer os ajustes necessários para atualizar a base de dados do sistema. Mude para o diretório onde se encontram os scripts sql: # cd /var/www/miolo/modules/config/sql Note que há vários diretórios, um para cada versão do sistema. Para fazer a atualização, você deverá se atentar à versão atual do seu banco. Se ele está na versão anterior, a 12.05, basta executar o script que está dentro do diretório 12.06: # cd../12.06/ # psql dbsiga -U postgres -f update12.06.sql Agora, se o seu banco é mais antigo, está na versão 12.02, você deverá executar antes o script que está no diretório e depois o script que está no diretório 12.06: # cd../12.05/ # psql dbsiga -U postgres -f update12.05.sql # cd../12.06/ # psql dbsiga -U postgres -f update12.06.sql Se o seu banco é ainda mais antigo, siga esta mesma lógica até chegar à versão atual. 12

13 Manual SIGA-ADM Instalação Via Via Terminal Parte VI Configurações especiais 1. Utilizando a base de dados em outra máquina Esta seção visa auxiliar o usuário a, caso necessário, fazer as configurações para utilizar o SIGA-ADM, com a base de dados estando num servidor diferente da aplicação. Em muitos institutos acontece de se ter todos os bancos de dados centralizados num único servidor Configurando o servidor do banco de dados! Pressupõe-se que já esteja instalado e configurado o PostgreSQL 8.3 no servidor de banco de dados. Caso não esteja, execute antes os procedimentos da sessão 1.5 da Parte II deste manual. Primeiramente, vamos configurar a máquina em que ficará o banco de dados. Siga a sessão 2.3 da Parte II deste manual para criar e configurar a base de dados do SIGA-ADM. Para isto você precisará copiar os scripts do banco que estão no diretório /var/www/miolo/modules/config/sql para a máquina onde serão executados, adapte o comando abaixo à sua situação: # scp -r /var/www/miolo/modules/config/sql <usuario_destino>@<ip_destino>:<diretorio_destino> Agora que a base de dados já está pronta, abra o arquivo /etc/postgresql/8.3/main/postgresql.conf: # vim /etc/postgresql/8.3/main/postgresql.conf Descomente a linha abaixo e substitua 'localhost' por '*', para que o servidor seja capaz de receber conexões de qualquer IP: #listen_addresses = localhost A linha ficará: listen_addresses = * Depois disso, abra o arquivo /etc/postgresql/8.3/main/ pg_hba.conf e crie uma regra para os IPs que poderão se conectar ao servidor: # vim /etc/postgresql/8.3/main/pg_hba.conf Acrescente esta regra ao arquivo, substituindo <IP_SERVIDOR_SIGA> pelo IP do servidor em que o SIGA-ADM está rodando: 13

14 host all all <IP_SERVIDOR_SIGA>/32 trust Pronto, reinicie o PostgreSQL para fazer valer as alterações: # /etc/init.d/postgresql-8.3 stop # /etc/init.d/postgresql-8.3 start Configurando o servidor da aplicação Vamos fazer agora os ajustes no servidor em que está instalada a aplicação SIGA-ADM.! Confira atentamente os comandos sed antes de executá-los, para não alterar os dados de maneira incorreta. Não os copie e cole deste pdf, pois há quebra de linha, que deve ser substituída por espaço. Digite-os no terminal para evitar problemas. O que precisamos fazer é alterar os dados de conexão à base de dados do SIGA-ADM nos arquivos de configuração da aplicação. Para isso rode os comandos abaixo, os alterando de acordo com o seu cenário: Alterar o endereço do servidor do banco de dados: # sed -i s,<host>localhost</host>,<host><ip_servidor_bd></host>,g /var/www/miolo/etc/miolo.conf # sed -i s,<jdbc_db>jdbc:postgresql://localhost:5432/dbsiga</jdbc_db>, <jdbc_db>jdbc:postgresql:// <IP_SERVIDOR_BD>:5432/dbsiga</jdbc_db>,g /var/www/miolo/etc/miolo.conf Configure a senha do postgres do servidor de banco de dados no arquivo /var/www/miolo/etc/passwd.conf: # vim /var/www/miolo/etc/passwd.conf: Parte V Desinstalação Para desinstalar a aplicação, basta apagar o seu diretório, remover o virtualhost criado e desinstalar os pacotes instalados anteriormente e que não estejam sendo usados por outra aplicação: # rm -fr /var/www/miolo # cd /etc/apache2/sites-available # a2dissite siga # >../httpd.conf # rm siga # aptitude remove <pacotes_nao_utilizados_por_outra_aplicacao> 14

15 Parte VI Considerações finais Agradecemos sua participação no projeto como usuário do sistema! É através da sua experiência que podemos torná-lo cada vez melhor! Esperamos que o conteúdo deste manual possa lhe auxiliar na instalação do SIGA-ADM. Caso encontre problemas, possíveis erros ou ainda gostaria de contribuir para melhorar o projeto e também a documentação, abra um ticket de suporte no Redmine ( Toda a documentação referente aos módulos do SIGA-ADM estão disponíveis em: 15