Segue passos para instalação:
Pre-requisitos
- Linux (Testado no Ubuntu 6.06+/Debian 4.0+)
- Apache 2.0 ou superior
- PHP 5 ou superior
- MySQL 5.0 ou superior
- ISC DHCP Server versão 3
- Sudo
Instalação
0. Primeiro é importante decidir onde vai colocar o vulpes.Durante essa guia vamos usar um variável do ambiente:1. Instalar Dependências:
export VULPES_PATH="/var/www/vulpes"
Se você deseja instalar o Vulpes em um outro caminho, modifique essa variável. IMPORTANTE: Se você fecha o terminal antes de terminar essa guia, lembre-se de exportar essa variável de novo.
sudo apt-get install apache2 mysql-server php5 php5-mysql php5-cli dhcp3-server
2. Baixar e descompactar o Vulpes: sudo wget http://launchpad.net/vulpes/0.3.1/0.3.1/+download/vulpes-0.3.1.tar.gz
sudo tar xvf vulpes-0.3.1.tar.gz
sudo mv vulpes-0.3.1 $VULPES_PATH
3. Ativar mod_rewrite no apache: sudo a2enmod rewrite
4. Configurar apache para escutar nas portas 80 e 82: sudo nano /etc/apache2/ports.conf
5. Colocar captive portal na porta 82 Primeiro modifica a configuração default para usar porta 80:[remover a primeira regra (NameVirtualHost *)]
sudo nano /etc/apache2/sites-enabled/000-default
[mudar '
Depois criar um link símbolico para o apache.conf do Vulpes,
sudo cp $VULPES_PATH/backend/apache_dist.conf $VULPES_PATH/backend/apache.conf
sudo nano $VULPES_PATH/backend/apache.conf
sudo ln -s $VULPES_PATH/backend/apache.conf /etc/apache2/sites-enabled/001-vulpes
e depois editar ele e mudar os IPs para o IP do teu servidor.
6. Cria backup do dhcpd.conf:
sudo cp /etc/dhcp3/dhcpd.conf /etc/dhcp3/dhcpd.conf-old
7. Mudar permissões de dhcpd.conf: sudo chown www-data:www-data /etc/dhcp3/dhcpd.conf
sudo chmod 664 /etc/dhcp3/dhcpd.conf
8. Criar /etc/firewall com permissões para www-data: sudo touch /etc/firewall
sudo chown www-data:www-data /etc/firewall
9. Criar /etc/tcrc com permissões para www-data: sudo touch /etc/tcrc
sudo chown www-data:www-data /etc/tcrc
sudo chmod +x /etc/tcrc
10. Mudar permissões do access.log do squid: sudo chown proxy:www-data /var/log/squid/access.log
11. Liberar iptables, iptables-restore, tc e dhcp3-server para apache no sudo: sudo visudo
Adicione as seguintes regras:
www-data ALL=(ALL) NOPASSWD: /sbin/iptables
www-data ALL=(ALL) NOPASSWD: /sbin/iptables-restore
www-data ALL=(ALL) NOPASSWD: /sbin/tc
www-data ALL=(ALL) NOPASSWD: /etc/init.d/dhcp3-server
12. Configurar o cron: Primeiro modifica o cron.sh para configurar o caminho:13. Preparar banco de dados:
sudo cp $VULPES_PATH/backend/cron_dist.sh $VULPES_PATH/backend/cron.sh sudo nano $VULPES_PATH/backend/cron.sh sudo chmod +x $VULPES_PATH/backend/cron.sh
Depois adicionar cron.sh no crontab:
sudo crontab -e
Adicione seguinte regra (modifica o caminho de acordo com a instalação do vulpes):
*/5 * * * * /var/www/vulpes/backend/cron.sh
mysql -u root -p < $VULPES_PATH/backend/vulpes.sql
14. Configurar o backend para usar o banco de dados: sudo cp $VULPES_PATH/backend/config_dist.php $VULPES_PATH/backend/config.php
sudo nano $VULPES_PATH/backend/config.php
15. Confgurar o frontend para usar o backend: sudo cp $VULPES_PATH/config-dist.xml $VULPES_PATH/config.xml
sudo nano $VULPES_PATH/config.xml
16. Acesse o Vulpes: Agora pode acessar o Vulpes corsac no seu servidor no caminho:
http://10.0.0.1/vulpes/
Onde 10.0.0.1 é o IP do seu servidor.
O login e senha padrão para acesso são: admin e admin.