{{{
#!div class=important
Se você esta querendo usar Vulpes na sua empresa, por favor considere os soluções de suporte do [http://www.linfox.com.br/ LinFox].
}}}
= Guia de Instalação do Vulpes =

== Prerrequisitos ==
 * 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:
{{{
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.

'''1. Instalar Dependências:'''
{{{
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 o configuração default para usar porta 80:
{{{
sudo nano /etc/apache2/sites-enabled/000-default
}}}
[remover a primeira regra (!NameVirtualHost *)][[BR]]
[mudar '<!VirtualHost *>' para '<!VirtualHost *:80>'][[BR]]

  Depois criar um link 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 modificar 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 permissoes para www-data:'''
{{{
sudo touch /etc/firewall
sudo chown www-data:www-data /etc/firewall
}}}

'''9. Criar /etc/tcrc com permissoes 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:
{{{
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 para o seu instalação de vulpes):
{{{
*/5 *  *   *   *     /var/www/vulpes/backend/cron.sh
}}}

'''13. Preparar banco de dados:'''
{{{
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: [[BR]]
 !http://10.0.0.1/vulpes/ [[BR]]
 Onde 10.0.0.1 é o IP do seu servidor.

 O login e senha padrão para acesso são: admin e admin.

Pronto!