Instalace

FreenetIS aktuálně podporuje instalaci skrze balíčkovací systém pro DEBIAN a jeho deriváty (instalace na jiné platformy je možná pomocí instalace ze zdrojových kódů). FreenetIS rozdělen do několika samostatných balíků, kde každý je na sebe nezávislý.

Instalace probíha v několika krocích:

1) Přidáme repozitář (následující řádky) do souboru /etc/apt/sources.list. (Pokud chceme aktuální vývojovou verzi použijeme místo kanálu final kanál dev. Tento kanál ovšem není určen k běžnému užívání, ale pouze k testovacím účelům.)

## FreenetIS final repository
deb http://repository.freenetis.org/debian/final/ <codename> main

<codename> nahraďte kódovým označením nainstalované verze debianu (např. squeeze).

2) Stáhneme si klíč pro ověření balíků.

wget -O - http://repository.freenetis.org/debian/freenetis_repo.gpg.key | apt-key add -

3) Nainstalujeme některý z balíků (např. freenetis)

apt-get update && apt-get install freenetis

Balík freenetis

Balík freenetis obsahuje samotnou webovou aplikaci. Při instalaci tohoto balíku budete vyzváni, aby jste zadali jméno serveru a protokol. Po zadání těchto informací instalátor sám nastaví zbytek (nastavení serveru apache2, cronu, generování locales, ...). Po nainstalování spusťte v prohlížečí adresu, kterou jste vyplnily při instalaci a postupujte dle instrukcí (budete zadávat údaje k připojení k MySQL databázi a základní informace o Vašem sdružení).

Balík jen konfigurovatelný v souboru /etc/freenetis/freenetis.conf. Změny v konfiguračním tomto souboru musí být potvrzeny pomocí příkazu dpkg-reconfigure freenetis, jinak se konfigurace nezmění.

Jméno serveru

Jméno serveru je URL cesta k instanci FreenetISu bez úvodní informace o protokolu. (t.j. pokud chcete FreenetIS umístit na http://is.sdruzeni.cz/ vyplníme tuto položku na hodnotu is.sdruzeni.cz).

Protokol

Protokol je možné vyplnit buď na HTTP nebo na HTTPS. Pokud nechcete mít zabezpečenou verzi zvolte HTTP.

V opačném případě je nutné ještě po samotné instalaci vygenerovat pro FreenetIS bezpečnostní klíče (pokud již nějaký samozřejmě nemáte). Postup pro vytvoření klíčů je například zde. Vytvořené klíče (*.crt a *.key) po instalaci balíku zkopírujte do složky /etc/freenetis/https/ (existuje až po instalaci) a přejmenujte je na ssl.crt a ssl.key. Pokud máte klíče v podepsány certifikační autoritou (CA) dolňte do stejné složky ještě soubory sub.class1.server.ca.pem a ca.pem. Po vložení všech potřebných souborů proveďte rekonfiguraci balíku (dpkg-reconfigure freenetis).

Balík freenetis-monitoring

Balík freenetis-monitoring obsahuje nástroje pro monitoring zařízení.

Instalace

1) Ve Vašem FreenetISu v sekci Nastavení v záložce Monitoring povolte monitoring a vyplňte IP adresu serveru, na který hodláte nainstalovat monitoring.

2) Nainstalujte balík freenetis-monitoring. Během instalace budete vyzváni, aby jste zadalu URL k Vašemu FreenetISu.

apt-get install freenetis-monitoring

3) Spusťte deamon (při dalších startech operačního systému již bude spoustěn automaticky)

/etc/init.d/freenetis-monitoring start

Pokud je vypsán řetězec:

Starting FreenetIS monitor daemon: OK

Vše je nainstalováno v pořádku a ve Vašem FreenetISu by měl být indikátor monitoringu aktivní.

Pokud je vypsán jiný řetězec, nastala nějaká chyba. Její detaily lze nalést následovně:

less /var/log/freenetis-monitoring.log

Konfigurace

V konfiguračním souboru (/etc/freenetis/freenetis-monitoring.conf) lze nastavit chování priorit (proměnná MAX_PRIORITY). Pokud nastavíte proměnnou na hodnotu 0, všechny proměnné se budou spouštět ve stejném procesu. Pokud nastavíte číslo na hodnotu větší než 0, budou monitorovány všechny priority do nastaveného čísla v samostatném procesu pro každou prioritu. Defaultně je tato hodnota nastavená na nulu.

Po změně konfigurace je nutné zastavit monitoring a znovu jej spustit.

Ovládání

Jsou k dospozici následující příkazy:

• Spuštění monitoringu (automaticky se startuje po každém bootu)

/etc/init.d/freenetis-monitoring start

• Zastavení monitoringu

/etc/init.d/freenetis-monitoring stop

• Zjištění stavu

/etc/init.d/freenetis-monitoring status

Balík freenetis-redirection

Balík freenetis-redirection obsahuje nástroje pro přesměrování.

Balík freenetis-qos

Balík freenetis-qos obsahuje nástroje pro zajištění kvality služeb (QoS).

Instalace

1) Ve Vašem FreenetISu v sekci Nastavení v záložce QoS povolte QoS a vyplňte údaje o vaší síti a zadejte globální omezení. (QoS lze nastavovat i u jednotlivých členů)

2) Nainstalujte balík freenetis-qos. Během instalace budete vyzváni, aby jste zadalu URL k Vašemu FreenetISu a vstupní a výstupní rozhraní, na které budou aplikována QoS pravidla pro download a upload.

apt-get install freenetis-qos

3) Spusťte deamon (při dalších startech operačního systému již bude spoustěn automaticky)

/etc/init.d/freenetis-qos start

Pokud je vypsán řetězec:

Starting FreenetIS QoS daemon: OK

Vše je nainstalováno v pořádku a ve Vašem FreenetISu by měl být indikátor QoSu aktivní.

Pokud je vypsán jiný řetězec, nastala nějaká chyba. Její detaily lze nalést následovně:

less /var/log/freenetis-qos.log

Konfigurace

V konfiguračním souboru (/etc/freenetis/freenetis-qos.conf) lze nastavit chování QoSu, k dispozici jsou následující možnosti (zbytek nastavení je načítáno z FreenetISu):

• DELAY - počet sekund mezi aktualizací dat z FreenetISu (defaultně 60 - doporučeno ponechat)

Po změně konfigurace je nutné zastavit monitoring a znovu jej spustit.

Ovládání

Jsou k dospozici následující příkazy:

• Spuštění QoSu (automaticky se startuje po každém bootu)

/etc/init.d/freenetis-qos start

• Zastavení monitoringu

/etc/init.d/freenetis-qos stop

• Zjištění stavu

/etc/init.d/freenetis-qos status