Guia de Instalação e Configuração do Noosfero

Transcrição

1 Guia de Instalação e Configuração do Noosfero

2 Índice Instalação e Configuração do Noosfero...3 Instalação das dependências principais do Noosfero no Debian Instalação do PostFix e SASL...3 Configuração do backup do banco de dados...5 Agendamento do backup para ser realizado todos os dias às 00h Realizando backup em uma máquina remota...6 Instalação do Varnish...7 Configurando o APACHE para ouvir a porta 8080 ao invés da porta Configuração do Varnish...7 Ativação do log do Varnish...7 Execução do Noosfero...8 Migração de dados...8

3 1. Instalação e Configuração do Noosfero O Vim é o editor de texto padrão que será utilizado nesse tutorial sempre que for necessário editar um arquivo. Caso deseje utilizar um outro editor de texto, substitua vim nos comandos desse tutorial pelo comando do editor de texto de sua preferência. Todos os comandos desse tutorial devem ser executados em um terminal. Os comandos são precedidos por: $: quando deve ser executado como usuário comum #: quando deve ser executado como super-usuário(administrador, root) 1. Instalação das dependências principais do Noosfero no Debian 7 a) Abra o arquivo sources do debian: $ sudo vim /etc/apt/sources.list b) Adicione a seguinte linha ao final do arquivo: $ deb c) Baixe a chave do repositório $ wget -O - sudo apt-key add - d) Atualize a lista de pacotes do debian $ sudo apt-get update e) Instale o postgresql $ sudo apt-get install postgresql f) Instale o noosfero: $ sudo apt-get install noosfero noosfero-apache 2. Instalação do PostFix e SASL a) Instale o Postfix e SASL $ sudo aptitude install postfix libsasl2 ca-certificates libsasl2-modules b) Realize a copia do certificado para pasta do PostFix $ cat /etc/ssl/certs/thawte_premium_server_ca.pem sudo tee -a /etc/postfix/cacert.pem c) Abra o arquivo main.cf para habilitar o SASL com o editor de texto Vim $ sudo vim /etc/postfiz/main.cf d) Procure a linha 'mydestination' e adicione o domínio do site a ser hospedado mydestination = <exemplo-dominio.com.br> Obs: Subtitua <exemplo-dominio.com.br> removendo <> As informações já contidas devem ser mantidas, deve-se apenas acrescentar a URL desejada separada por vírgula. e) Adicione as seguintes linhas de configuração no final do arquivo: relayhost = [smtp.gmail.com]:587 smtp_use_tls = yes smtp_sasl_auth_enable = yes smtp_sasl_password_maps = hash:/etc/postfix/sasl/sasl_ smtp_sasl_security_options = noanonymous smtp_sasl_tls_security_options = noanonymous smtp_tls_cafile = /etc/postfix/cacert.pem virtual_alias_maps = hash:/etc/postfix/virtual 3

4 Obs: O tutorial está especificado para o gmail, se estiver utilizando de outro domínio verifique suas configurações (SMTP e porta) e altere a linha relayhost. Para realizar os próximos passos deste tutorial é necessário que já esteja disponível o e senha da organização que utilizará a plataforma noosfero. Este será o mecanismo de comunicação entre os usuários da plataforma e o administrador. f) Crie a pasta SASL para armazenar o e senha do $ sudo mkdir /etc/postfix/sasl g) Crie o arquivo onde ficará armazenado o e senha do $ sudo touch /etc/postfix/sasl/sasl_passwd h) Abra o arquivo com editor de texto Vim $ sudo vim /etc/postfix/sasl/sasl_passwd i) Adicione e senha no arquivo [smtp.gmail.com]:587 < da instituição>:<senha de acesso ao > Obs: substitua < da instituição> e <senha de acesso ao > removendo os: <> O tutorial está especificado para o gmail, se estiver utilizando de outro domínio verifique suas configurações (SMTP e porta) e modifique a linha acima conforme as especificações. j) Dê permissão apenas de leitura para o arquivo $ sudo chmod 400 /etc/postfix/sasl/sasl_passwd k) Coloque o arquivo na base de dados do PostFix $ sudo postmap /etc/postfix/sasl/sasl_passwd l) Abra o arquivo 'virtual' utilizando editor de texto Vim $ sudo vim /etc/postfix/virtual m)ao final do arquivo adicione as seguintes linhas de da máquina> < da organização> Obs: substitua <domínio da máquina> e < da organização> removendo os: <> n) Dê permissão de leitura para o arquivo $ sudo chmod 400 /etc/postfix/virtual o) Coloque o arquivo na base de dados do PostFix $ sudo postmap /etc/postfix/virtual p) Reinicie o PostFix para habilitar as alterações $ sudo service postfix restart 4

5 3. Configuração do backup do banco de dados a) Abra arquivo noosfero-backup.sh com editor de texto Vim $ sudo vim /usr/bin/noosfero-backup.sh b) Adicione as linhas seguintes para criação do script #!/bin/bash BKP_DIR=<Local do Backup> date=$(date +backup_%y_%m_%d_%h_%m) mkdir $BKP_DIR/$date chmod 777 $BKP_DIR echo "Data do backup: " $(date +%Y/%m/%d-%H:%M) cd $BKP_DIR #Backup dos arquivos tar zcvpf $BKP_DIR/$date/noosferotar zcvpf $BKP_DIR/$date/noosfero-data. tar zcvpf $BKP_DIR/$date/noosfero-etc. sudo -u postgres pg_dump noosfero > $BKP_DIR/$date/noosfero_ scp -P21 -r $BKP_DIR/$date root@ :$bkp_dir #Apaga os backups com mais de 7 dias cd $BKP_DIR for i in `find $BKP_DIR/ -maxdepth 1 -type d -mtime +6 -print`; do rm -rf $i; done echo "Local do backup: " $BKP_DIR/$date Obs: Atenção para a linha BKP_DIR=<local do backup>, deve ser especificada a pasta onde o backup será realizado. 4. Agendamento do backup para ser realizado todos os dias às 00h30 a) Logue comoroot $ sudo su b) Edite o agendador de tarefas cron # crontab -e c) Adicione ao final do arquivo, a linha abaixo 30 0 * * * sh /usr/bin/noosfero-backup.sh d) Saia do modo super usuário # exit e) Caso a pasta especificada para o backup não exista, crie uma pasta $ sudo mkdir -p <pasta local para backup> Obs: substitua <pasta local para backup> pela pasta de backup de sua preferência, removendo os: <> 5

6 5. Realizando backup em uma máquina remota Os seguintes passos devem ser executados na máquina que esteja executando o Noosfero: a) Gere a chave ssh $ ssh-keygen -t dsa b) Copie a chave pública gerada para a pasta Home $ cp.ssh/id_dsa.pub. c) Envie a chave ssh para a máquina que irá armazenar os backups $ scp id_dsa.pub <usuario da máquina destino>@<ip da maquina destino>: Os seguintes passos devem ser executados na máquina que armazenará os backups: d) Acesse a máquina remotamente através do comando $ ssh <usuário da máquina de destino>@<ip da máquina de destino> e) Coloque a chave pública na lista de chaves autorizadas para que seja possível logar sem a necessidade de senha $ cat id_dsa.pub >>.ssh/authorized_keys f) Crie o diretório onde o backup será realizado mkdir -p <diretório do backup> g) Abra o arquivo noosfero-backup.sh com o editor de texto Vim $ sudo vim /usr/bin/noosfero-backup.sh h) Adicione as linhas abaixo no script para apagar os backups antigos #!/bin/bash BKP_DIR=/var/backups/portal #Apaga os backups com mais de 7 dias cd $BKP_DIR for i in `find $BKP_DIR/ -maxdepth 1 -type d -mtime +3 -print`; do rm -rf $i; done i) Agende o script de backup para executar todos os dias às 06:30 evitando a exclusão de algum backup Logue como root $ sudo su Edite o agendador de tarefas cron # crontab -e Adicione ao final do arquivo o agendamento # 30 6 * * * sh /usr/bin/noosfero-backup.sh Sair do modo super usuário # exit 6

7 6. Instalação do Varnish a) Instale o vanish $ apt-get install varnish b) Instale o módulo apache RPAF $ sudo apt-get install libapache2-mod-rpaf 7. Configurando o APACHE para ouvir a porta 8080 ao invés da porta 80 a) Abra o arquivo de configuração de portas do apache $ sudo vim /etc/apache2/ports.conf b) Altere as seguintes linhas do arquivo NameVirtualHost *:80 para NameVirtualHost *:8080 Listen 80 para Listen :8080 c) Abra o arquivo sites-enabled do apache $ sudo vim /etc/apache2/sites-enabled/* d) Altere a seguinte linha do arquivo <VirtualHost *:80> para <VirtualHost *:8080> e) Reinicie o Apache $ sudo service apache2 restart 8. Configuração do Varnish a) Abra o arquivo de configuração do varnish $ sudo vim /etc/default/varnish b) Altere as seguintes linhas START=no para say START=yes -a :6081 para -a :80 c) Abra o arquivo dafault.vcl do Varnish $ sudo /etc/varnish/default.vcl d) Inclua as seguintes linhas no final do arquivos na mesma ordem include "/etc/noosfero/varnish-noosfero.vcl"; include "/etc/noosfero/varnish-accept-language.vcl"; e) Reinicie o Varnish $ sudo service varnish restart 9. Ativação do log do Varnish a) Abra o arquivo varnishncsa $ sudo vim /etc/default/varnishncsa b) Descomente a seguinte linha VARNISHNCSA_ENABLED=1 Obs: O log do varnish será gravado em /var/log/varnish/varnishncsa.log c) Reinicie o varnish para que as mudanças tenham efeito: $ sudo service varnish restart 7

8 2. Execução do Noosfero 1. Para iniciar o noosfero, execute o comando $ sudo service noosfero start 2. Para paralisar o noosfero, execute o comando $ sudo service noosfero stop 3. Para reiniciar o noosfero, execute o comandopara $ sudo service noosfero restart 3. Migração de dados 1. Pare o serviço do noosfero $ sudo service noosfero stop 2. Crie uma pasta para o backup do banco de dados $ mkdir -p <nome da pasta de backup> 3. Dê permissão total a todos os usuários para a pasta $ sudo chmod 777 <nome da pasta de backup> 4. Realize o backup do banco de dados $ sudo -u postgres pg_dump noosfero_database > noosfero_bkp.sql Obs: substitua noosfero_database pelo nome do banco de dados que se deseja realizar o backuop. Por padrão, o noosfero utiliza: noosfero_test para o ambiente de produção noosfero_development para o ambiente de desenvolvimento noosfero_production para o ambiente de produção. 5. Entre na página de backup criada no passo 2 $ cd <nome da pasta de backup> 6. Compacte o arquivo sql com o gzip $ gzip noosfero_bkp.sql 7. Realize o backup dos dados/arquivos do noosfero $ tar zcvf noosfero-data.tgz /var/lib/noosfero-data/ 8. Envie os backups para a nova VM $ scp -P22 noosfero-data.tgz noosfero_bkp.sql.gz usuario@ip_de_destino Obs: não esqueça de substituir corretamente o usuário e o ip de destino corretamente. 9. Pare o serviço da nova VM, caso esteja em execução $ sudo service noosfero stop 10. Descompacte o noosfero-data.tgz $ tar -xzf noosfero-data.tgz -C / 11. Altere o dono na pasta $ sudo chown -R noosfero. /var/lib/noosfero-data Obs: altere noosfero caso o usuário do banco de dados da nova VM seja outro. 12. Descompacte o arquivo noosfero_bkp.sql.gz $ gunzip noosfero_bkp.sql.gz 13. Derrube o database atual $ sudo -u postgres psql -c "DROP DATABASE noosfero_database" Obs: substitua noosfero_database pelo nome do banco de dados que se deseja derrubar. Por padrão, o noosfero utiliza: noosfero_test para o ambiente de produção noosfero_development para o ambiente de desenvolvimento noosfero_production para o ambiente de produção. 8

9 14. Crie o novo database $ sudo -u postgres psql -c "CREATE DATABASE noosfero_database WITH OWNER = noosfero" Obs: substitua noosfero_database pelo nome do banco de dados que se deseja criar. Por padrão, o noosfero utiliza: noosfero_test para o ambiente de produção noosfero_development para o ambiente de desenvolvimento noosfero_production para o ambiente de produção. Altere também noosfero caso o usuário do banco de dados deva ser outro. 9