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).

Aktuálně není podporována instalace na podsložku (t.j. http://is.sdruzeni.cz/dir/) s vyjímkou u instalací na localhost.

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í, které je součástí systému upozorňování.

!!! Teto balík je podporován aktuálně pouze na Debian 6 (Squeeze) !!!

Instalace

1) Ve Vašem FreenetISu v sekci Nastavení v záložce Upozorňování vyplňte údaje v sekci přesměrování:

• IP adresa brány - adresa počítače, na který budeme instalovat přesměrování
• Port pro samozrušení - doporučeno nastavit na 36001 (musí být shodné s nastavením v konfiguračním souboru přesměrování)
• Logo - logo zobrazované v hlavičce přesměrování
• Text pro odkaz na samozrušení přesměrování - pokud je přesměrování samozrušitelné, tento text je určen pro odkaz zobrazený v patičce stránky s přesměrování a po kliknutí na něj je přesměrování zrušeno.

2) Předvyplňte jednotlivé zprávy pro přesměrování (sekce upozornění -> zprávy).

3) Nainstalujte balík freenetis-redirection. Během instalace budete vyzváni, aby jste zadali URL k Vašemu FreenetISu a vstupní rozhraní, na které budou aplikována přesměrovací pravidla. Dále potom IP adresu pro samozrušení přesměrování (libovolná, klidně neexistující IP adresa v síti, na kterou bude aplikováno pravidlo samozrušení přesměrování).

apt-get install freenetis-redirection

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

/etc/init.d/freenetis-redirection start

Pokud je vypsán řetězec:

Starting FreenetIS redirection sync daemon: OK
Starting FreenetIS redirection HTTP deamon: OK

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

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

less /var/log/freenetis-redirection.log
less /var/log/freenetis-http-redirection.log

Konfigurace

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

• PORT_WEB - číslo portu, který je presměrován
• PORT_REDIRECT - port, na který se přesměrovává provoz z PORT_WEB
• PORT_SELF_CANCEL - port pro samozrušení přesměrování (musí být shidný s hodnotou nastavenou ve FreenetISu)
• DELAY - počet sekund mezi aktualizací dat z FreenetISu (defaultně 60 - doporučeno ponechat)

Po změně konfigurace je nutné zastavit přesměrování a znovu jej spustit.

Ovládání

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

• Spuštění přesměrování (automaticky se startuje po každém bootu)

/etc/init.d/freenetis-redirection start

• Zastavení přesměrování (okamžité)

/etc/init.d/freenetis-redirection stop

• Zjištění stavu

/etc/init.d/freenetis-redirection status

Balík freenetis-qos

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

!!! Teto balík je podporován aktuálně pouze na Debian 6 (Squeeze) !!!

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 QoS 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í QoSu

/etc/init.d/freenetis-qos stop

• Zjištění stavu

/etc/init.d/freenetis-qos status

Balík freenetis-ssh-keys

Tento balík umožňuje ovládání zařízení skrze SSH. Správci jednotlivých zařízení představují uživatele, kteří na toto zařízení mají přístup. Skript obsažený v tomto balíku si z FreenetISu stahuje jejich veřejné klíče a vkládá je do povolených v nastavení ssh.

Instalace sestává pouze z nainstalování balíku freenetis-ssh-keys a s konfigurace dvou hodnot:

• cesta k FreenetISu, ze kterého se stahují klíče
• ID zařízení z FreenetISu na něž se balík instaluje