Pré-requisitos:

• Linux (Testado no Ubuntu 6.06+/Debian 3.1+)
• Apache 2.0 ou superior
• PHP 5 ou superior
• MySQL 5.0 ou superior
• ISC DHCP Server versão 3
• Sudo

Instalação

Primeiro é importante decidir onde colocar o Vulpes e o Corsac. Durante essa guia vamos usar 2 variáveis do ambiente:

# export VULPES_PATH="/var/www/vulpes"
# export CORSAC_PATH="/var/www/corsac"

Se você deseja instalar o Vulpes em outro caminho, modifique essas variáveis.

IMPORTANTE: Se você fechar o terminal antes de terminar esse guia, lembre-se de exportar essas duas variáveis de novo.

Instalar dependências:

# apt-get install apache2 mysql-server php5 php5-mysql php5-cli subversion dhcp3-server

Baixar o Vulpes:

# svn co svn://svn.linfox.com.br/vulpes/vulpes/branches/0.3 $VULPES_PATH
# svn co svn://svn.linfox.com.br/vulpes/corsac/releases/0.3 $CORSAC_PATH

Ativar mod_rewrite no Apache:

# a2enmod rewrite

Configurar Apache para escutar nas portas 80 e 82:

# vim /etc/apache2/ports.conf

Colocar captive portal na porta 82:

Primeiro modificar o configuração default para usar porta 80:

# vim /etc/apache2/sites-enabled/000-default

• remover a primeira regra (NameVirtualHost *)
• mudar '<VirtualHost *>' para '<VirtualHost *:80>'

Depois criar um link para o apache.conf do Vulpes:

# cp $VULPES_PATH/apache_dist.conf $VULPES_PATH/apache.conf
# vim $VULPES_PATH/apache.conf
# ln -s $VULPES_PATH/apache.conf /etc/apache2/sites-enabled/001-vulpes

Depois modificar ele e mudar os IPs para o IP do teu servidor.

Criar backup do dhcpd.conf:

# cp /etc/dhcp3/dhcpd.conf /etc/dhcp3/dhcpd.conf-dist

Mudar permissões de dhcpd.conf:

# chown www-data:www-data /etc/dhcp3/dhcpd.conf
# chmod 664 /etc/dhcp3/dhcpd.conf

Criar /etc/firewall com permissões para www-data:

# touch /etc/firewall
# chown www-data:www-data /etc/firewall

Criar /etc/tcrc com permissões para www-data:

# touch /etc/tcrc
# chown www-data:www-data /etc/tcrc
# chmod +x /etc/tcrc

Mudar permissões do access.log do Squid:

# chown proxy:www-data /var/log/squid/access.log

Liberar iptables, iptables-restore, tc e dhcp3-server para Apache no sudo:

# visudo

Adicione as seguintes regras:


Configurar o cron:

Primeiro modificar o cron.sh para configurar o caminho:

# cp $VULPES_PATH/cron_dist.sh $VULPES_PATH/cron.sh
# vim $VULPES_PATH/cron.sh

Depois adicionar cron.sh no crontab:

# crontab -e

Adicione a seguinte regra (modifica o caminho para o da instalação de vulpes):


Preparar banco de dados:

# mysql -u root -p < $VULPES_PATH/vulpes.sql

Configurar o backend para usar o banco de dados:

# cp $VULPES_PATH/config-dist.php $VULPES_PATH/config.php
# vim $VULPES_PATH/config.php

Configurar o frontend para usar o backend:

# cp $CORSAC_PATH/config-dist.xml $CORSAC_PATH/config.xml
# vim $CORSAC_PATH/config.xml

Acesse o Vulpes:

Agora pode acessar o Vulpes corsac no seu servidor no caminho:

http://11.0.0.1/corsac/

Onde 11.0.0.1 é o IP do seu servidor.

Pronto!

A LinFox disponibiliza para todos da comunidade que quiserem instalar o Vulpes e contribuir com o mesmo um projeto que está em desenvolvimento a mais de um ano, então fiquem a vontade para instalar e ajudar no desenvolvimento.

Até breve...