[[en:Main Page]]
[[ru:главная страница]]
Vítáme vás na dokumentační stránce systému FreenetIS!

* [http://www.freenetis.org/ Co je to FreenetIS?]
* [[Často kladené dotazy]]

* [[Speciální:Poslední změny]]

= Uživatelé =
* [[Uživatelská příručka]]
* [[Správcovská příručka]]
* [[Hospodářská příručka]]
* [[Administrátorská příručka]]

* [[Registrace nového uživatele - zájemce]]
* [[Změnit heslo]]
* [[Zobrazit zařízení]]
* [[Zobrazit práce]]
* [[Vyplnění žádosti o registraci zařízení do sítě]]

= Správci sítě =

* [[Instalace]]
* [[Co je třeba udělat po instalaci]]
* [[DHCP]] - pouze 1.1 a vyšší
* [[Upozorňování]]
* [[Logování]]
* [[Monitoring]]
* [[Zajištění kvality služeb (QoS)]]
* [[VoIP]]
* [[SNMP]]
* [[CGI_skripty]] - zjištění MAC adresy připojeného zařízení

'''Postupy'''
* [[Admin - nastavení nového uživatele - zájemce]] (Catman)
* [[Admin - přijetí zájemce za člena]] (Catman)
* [[Admin - přidat vysílací zařízení]] - Access point (AP) (Catman)
* [[Uživatel - přidat zařízení - připojen bezdrátově s NATem ]] (Catman)
* [[Uživatel - přidat zařízení - připojen bezdrátově s bridgem ]] - více zařízení na domácí síti (Catman)
* [[Uživatel - přidat zařízení - připojen kabelem na LAN ]] - např. domácí router (Catman)
* [[Změnit heslo]] (Catman)
* [[Zobrazit zařízení]] (Catman)
* [[Zobrazit práce]] (Catman)

'''Nastavení systému'''
* [[SystemAdmin - nastavení Systém]] (Catman)
* [[SystemAdmin - nastavení Email]] (Catman)
* [[SystemAdmin - nastavení Odesílání upozornění]] (Catman)
* [[SystemAdmin - nastavení Export přihlášky]] (Catman)
* [[SystemAdmin - nastavení Uživatelská role Pokladník]] (Catman)

* [[Instalace a nastavení serveru adresních bodů]]

* [[Managovatelný switch]] - popis vnitřní logiky (Dulík)
* [[Jak vložit switch na optické síti]] - včetně managementu (Catman)

'''H@cky'''
* [[Mazání člena]]

= Vývojáři - hotové vlastnosti a pomůcky =

* [[Specifikace]]
* [[Ekonomika]]
* [[i18n|i18n - internacionalizace]]
* [[Nastavení]]
* [[Verzování]]
* [[Přístupová práva]]
* [[Instalace ze zdrojových kódů]]
* [[Automatická změna struktury databáze]]

* [[Automatické testování]]
* [[Automatické testování v NetBeans]]
* [[Profiler]]
* [[Import a export databáze]]
* [[Smazání větve]]
* [[Vytvoření tagu]]
* [[Merge branche do trunku]]

= Vývojáři - postupy =

* [[Tvorba parseru bankovních výpisů]]

= Vývojáři - budoucí možnosti a vlastnosti systému =

* [[Integrace s QGIS]]
* [[Nový systém přístupových práv]]

= Vývojáři - organizační údaje a štábní kultura =

* [[Štábní kultura]]
* [[Příručka stylu psaní]]
* [[Vývojová prostředí (IDE)]]

----

[[Speciální:Allpages|Všechny články na této wiki]]

Logování

2014-03-23T13:38:59Z

Dzolo: /* Logování akcí */

[[en:Login]]
[[ru:Логин]]
FreenetIS obsahuje několik druhů logování. Některá jsou defaultně součástí systému, jiné je nutné dodatečně doinstalovat.

Nastavení logování je dostupné v nastavní FreenetISu v sekci logování.

== Logování akcí (audit) ==

Logování akcí umožňuje logovat uživatelské akce v systému a uchovávat je po dobu 31 dní. Obsahuje informaci o provedené akci, čas akce, modifikovaná data a uživatele, který ji provedl.

== Logování přihlášení ==

Logování uživatelských přístupů k systému a zaznaménávání přístupových IP adres.

== Logování provozu ==

Logování provozu jednotlivých členů a jejich IP adres je podporován pomocí nástroje '''ulogd'''. Pomocí provozu se potom odvozuje rozdělení členů na aktivní a ostatní (aktivní = stahovač), hranice rozdělení lze konfigurovat v nastavení. Různé statistiky lze potom sledovat v sekci provoz.

Instalace '''ulogu''' je posána [http://wiki.slavicin.unart.cz/index.php/Ulogd zde]. Jako přístupové údaje k databázi uveďte údaje o Vaší FreenetISové databázi a hodnotu procedure na '''UPDATE_CT'''.

== Logování zařízení (Syslog) ==

FreenetIS lze napojit na logování zařízení pomocí Syslogu. Návod na instalaci API pro syslog-ng je [http://dev.quimi.cz/projects/syslog-ng-mysql-api/wiki zde].

Návod pro instalaci a konfiguraci syslog-ng je [http://wiki.slavicin.unart.cz/index.php/Syslog-ng zde].

'''Jak nastavit Mikrotik RB'''
/system logging action add name=fisremote remote=10.133.xx.xx src-address=10.133.yy.yy target=remote
/system logging add action=fisremote prefix=vysilac_RB1 topics=warning,wireless,error,info, interface

(remote je adresa stroje s běžícím syslog-ng + API, src-address je adresa sledovaného RBčka, prefix je pojmenování, ale není nutné)

Po nainstalování a konfiguraci v nastavení FreenetISu jsou logovací zprávy dostupné u jednotlivých zařízení - objeví se nový odkaz.

Vytvoření tagu

2014-03-19T22:24:34Z

Dzolo:

CGI skripty

2014-02-11T15:42:17Z

Dzolo: /* Získání MAC adresy z ISC DHCP serveru */

[[en: CGI script]]
[[ru: CGI скрипт]]

Podporu pro CGI skripty je možné zapnout v sekci nastavení.

= Získání MAC adresy =

FreenetIS umožňuje aktuálně získávat MAC adresu kromě SNMP i pomocí vlastních CGI skriptů, které si umístíte přímo na dotyčný router. Daný skript musí vracet pouze MAC adresu.

Cesta ke skriptu je definována po povolení CGI skriptů v nastavení, přesněji v záložce Síť položkou '''URL pro ARP tabulku'''. Výchozí hodnota je '''<nowiki>http://{GATEWAY_IP_ADDRESS}/cgi-bin/arp.cgi?ip_address={IP_ADDRESS}</nowiki>''', kde parametry '''{GATEWAY_IP_ADDRESS}''' a '''{IP_ADDRESS}''' budou nahrazeny za IP adresu brány a IP adresu, ke kterému je hledána MAC adresa.

== Získání MAC adresy z ISC DHCP serveru ==

=== Bash skript ===

Instalace:

* Zkopírujte skript do složky s CGI skripty
* Vytvořte log
touch /var/log/arp.cgi.log && chmod 0777 /var/log/arp.cgi.log
* Upravte konfiguraci (proměnná '''DHCP_LEASES_FILE''')

Skript:

#!/bin/bash
################################################################################
# This is a CGI script that allows to obtain MAC address from DHCP leases
# by IP address that id retrieved via URL parameter.
#
# Authors:
# Michal Kliment <kliment@freenetis.org>
# Ondrej Fibich <fibich@freenetis.org>
#
# Version:
# 0.1.2
################################################################################

# config part ##################################################################

# log (must be chmoded to 0777)
LOG_FILE=/var/log/arp.cgi.log

# DHCP leases file (change this according to your system)
DHCP_LEASES_FILE=/var/lib/dhcp/dhcpd.leases
#DEBIAN lenny:# DHCP_LEASES_FILE=/var/lib/dhcp3/dhcpd.leases

# execute part #################################################################

# get IP address from URL param
ip_address=`echo $QUERY_STRING | sed 's/ip_address\=$[^&]\+$.*/\1/'`

# print header
echo "Content-type: text/plain"
echo ""

# DHCP leases file not exist/not readable
if [ ! -r "$DHCP_LEASES_FILE" ]; then
echo "$DHCP_LEASES_FILE cannot be readed"
exit 1
else
# get MAC
mac=`cat "$DHCP_LEASES_FILE" | grep -A6 "$ip_address" |
grep "hardware ethernet" | sed -e 's/^[ \t]*//' |
cut -d " " -f 3 | sed 's/;//'`
# print MAC
echo $mac
# log if writable
if [ -w "$LOG_FILE" ]; then
echo "`date -u` [INFO] IP=$ip_address, MAC=$mac" >> "$LOG_FILE"
fi
fi

CGI skripty

2014-02-10T09:47:54Z

Dzolo: /* Získání MAC adresy z ISC DHCP serveru */

CGI skripty

2014-02-10T09:35:13Z

Dzolo: /* Získání MAC adresy z ISC DHCP serveru */

CGI skripty

2014-02-10T09:15:33Z

Dzolo: /* Získání MAC adresy z ISC DHCP serveru */

2014-01-17T09:41:55Z

Dzolo: Přesměrování na Povýšení verze FreenetISu

#PŘESMĚRUJ [[Povýšení verze FreenetISu]]

Povýšení verze FreenetISu

2014-01-17T09:40:21Z

Dzolo: Založena nová stránka: Tato stránka pojednává o povýšení verzí FreenetISu pomocí [http://repository.freenetis.org/ Debian repozitářů]. == Povýšení z 1.0 na 1.1 == Pro povýšení...

Instalace

2014-01-17T09:35:21Z

Dzolo:

[[en:Installation]]
[[ru:Установка]]
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ý.

__TOC__

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

1) Přidáme repozitář (následující řádky) do souboru ''/etc/apt/sources.list''.

## FreenetIS final repository
deb <nowiki>http://repository.freenetis.org/debian/stable/</nowiki> <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 - <nowiki>http://repository.freenetis.org/debian/freenetis_repo.gpg.key</nowiki> | 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 vybrali typ serveru.

Po konfiguraci a nainstalování balíku spusťte v prohlížeči 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í.

Pokud chcete povýšit FreenetIS 1.0 na 1.1, přejděte prosím na článek o [[povýšení systému]].

=== Typ serveru ===

Jsou zde dvě možnosti:

* '''localhost''' - obvykle pokud chcete instalovat pro testovací účely
* '''ostatní (other)''' - nasazení na ostrý server s veřejným doménovým jménem (např. is.sdruzeni.cz)

Pokud vyberete jako typ serveru hodnotu localhost, nastavení pro vás končí a po samotné instalaci je FreenetIS dostupný na: '''http://localhost/freenetis'''.

Pokud vyberete jako typ serveru hodnotu ostatní, budete vyzváni k zadání '''jména serveru''' a '''protokolu'''.

==== 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 (a není ani plánována) instalace na podsložku (t.j. ''http://is.sdruzeni.cz/dir/'').

==== 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 [http://www.akadia.com/services/ssh_test_certificate.html 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 [http://wiki.freenetis.org/index.php/Monitoring 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

Pro verzi debianu squeeze a niží ještě zpusťte:

module-assistant auto-install ipset-source

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, monitoring všech zařízení se bude spouštět ve stejném procesu. Pokud nastavíte hodnotu větší než 0, budou monitorována všechna zařízení s prioritou menší nebo rovnou této hodnotě v samostatném procesu pro každou z těchto priorit. Defaultně je tato hodnota nastavena 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í]].

=== 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
module-assistant auto-install ipset-source

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 '''Systém''' povolte QoS a poté v záložce '''QoS''' 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 přistupovat k zařízení na němž je nainstalován 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 uložené ve FreenetISu a vkládá je do povolených klíčů 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

Stav lze pozorovat v logu: ''/var/log/freenetis-ssh-keys.log''

=== Návod pro ostatní platformy nebo distribuce ===

Ve složce ''/application/vendors/ssh-keys'' obsažené ve zdrojových kódech FreenetISu se nachází soubory: '''freenetis-ssh-keys-sync.sh''' a '''freenetis-ssh-keys.conf'''. Proveďte následující úkony:

1) Připravte soubory

cd <složka se sdrojáky>
mkdir -p /etc/freenetis/
cp ./application/vendors/ssh-keys/freenetis-ssh-keys-sync.sh /usr/sbin/freenetis-ssh-keys-sync
chmod u+x /usr/sbin/freenetis-ssh-keys-sync
cp ./application/vendors/ssh-keys/freenetis-ssh-keys.conf /etc/freenetis/freenetis-ssh-keys.conf

2) Nastavte konfigurační soubor (''/etc/freenetis/freenetis-ssh-keys.conf'')

3) Nastavte CRON (skript se bude spouštět každou minutu)

echo "# /etc/cron.d/freenetis-ssh-keys: Regular CRON file for freenetis-ssh-keys package (triggered each minute)" > /etc/cron.d/freenetis-ssh-keys
echo "" >> /etc/cron.d/freenetis-ssh-keys
echo "SHELL=/bin/sh" >> /etc/cron.d/freenetis-ssh-keys
echo "PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin" >> /etc/cron.d/freenetis-ssh-keys
echo "* * * * * root /usr/sbin/freenetis-ssh-keys-sync 1>>\"$LOG_FILE\"" >> /etc/cron.d/freenetis-ssh-keys

4) Restartujte CRON

/etc/init.d/cron restart

Merge branche do trunku

2014-01-16T16:39:12Z

Dzolo:

[[en:Branch merge to trunk]]
1. Checkout trunku a testingu

svn checkout http://freenetis.svn.sourceforge.net/svnroot/freenetis/freenetis/branches/testing testing
svn checkout http://freenetis.svn.sourceforge.net/svnroot/freenetis/freenetis/trunk trunk

2. Ve složce trunk odstranit všechny soubory kromě svn

rm `find trunk -type f | grep -v [.]svn`

3. Ve složce testing odstranit všechny složky .svn

rm -rf `find testing -type d -name .svn`

4. Manuálně překopírovat soubory z testingu do trunku

5. Commitnout do trunku (kvůli smazaným souborům je nutno commitnout dvakrát)

Přesměrování

2013-11-07T18:39:44Z

Dzolo: /* Instalace ze zdrojových souborů */

== Úvod ==

Toto je finální verze k právě dodělanému modulu přesměrování (červenec 2011). V Unartu Slavičín jsme používali přesměrování napsané s poněkud provizorním návrhem, protože jsme poměrně akutně potřebovali blokovat lidi, kteří neplatili internet. Dříve jsme k tomuto účelu používali přesměrování pomocí firewallu v Mikrotiku, ale toto bylo velmi nešťastné a nepraktické řešení. Konfigurace více než stovky Mikrotiků byla problematická a v praxi to nebylo dlouhodobě použitelné. V roce 2008 během prázdnin, kdy jsme ve FreenetISu dopsali finanční část, která je založená na podvojném účetnictví, jsme potřebovali informace získané o kreditech členů nějak využít. Rozhodli jsme se zabudovat přesměrování do FreenetISu. Výsledný modul tehdy nebyl úplně nejlíp navržený, ale velmi nám pomohl udělat pořádek. Po čase začali růst požadavky a rostla potřeba nových vlastností. Do vývoje FreenetISu se zapojil Lubomír Buben z Hkfree a jeden z modulů, na kterém chtěl pracovat, bylo právě přesměrování. Bohužel ani jemu se nepodařilo dotáhnout výsledek do konce.
Dokumentace na této stránce je napsaná až v červenci 2011, kdy konečně nová verze přesměrování byla dokončená.

== K čemu to je dobré? ==

Přesměrování lze využít k blokování přístupu členů na internet z různých důvodů. Jednak je možné takto blokovat lidi, jejichž IP adresa zařízení není v databázi. Dále je možné zablokovat internet lidem, kteří si přerušili členství, anebo nemají zaplaceny členské příspěvky. Přesměrování lze také využít k informování členů o blížící se valné hromadě, o plánovaném výpadku připojení, o možnosti přechodu na novou bezdrátovou technologii apod.

== Jak to funguje? ==

Na jedné straně je FreenetIS, ve kterém je kompletní evidence o tom, čí IP adresy mají být přesměrovány. Toto všechno spravuje administrátor FreenetISu nebo hospodář nebo jiný člověk, který tyto věci ve sdružení řeší. On si určí, kdy koho chce zablokovat, kdy komu povolí internet a kdy dá někomu privilegium, aby se na něj přesměrování nevztahovalo.

Na druhé straně je centrální router nebo také brána do internetu. Obvykle je to nějaký stroj s Linuxem, přes který teče provoz ze sítě do internetu a na kterém běží firewall, případně další služby jako DNS atd. Na tomto stroji je cronem spouštěn synchronizační skript v pravidelném intervalu (u nás jedna minuta). Tento skript si stáhne ze speciálních stránek FreenetISu dvě informace. Seznam síťových adres s maskou a seznam povolených IP adres. Skript vezme tyto rozsahy a IP adresy a naplní jimi ipsety v jádře (k tomuto je modul ipset). Následně vygeneruje pravidla pro firewall iptables, na základě kterých pak dochází k přesměrování. Firewall tedy přesměruje ty IP adresy, které chtějí jít na internet, spadají do načtených rozsahů, ale nejsou v seznamu povolených IP adres. To znamená, že přesměrování se uplatňuje jen pro ty podsítě v systému, pro které chce administrátor. Přesměrovány jsou jednak neznámé IP adresy (jinak by byly poslány s v seznamu povolených) a pak ty, které chceme přesměrovat (z pohledu centrálního routeru jde o vyřazení ze seznamu povolených). Toto přesměrování provádí firewall na jiný port (u nás to je 36000) centrálního routeru. Na tomto portu běží lehký webový server,
který na tomto portu dělá jednoduchý HTTP redirect na jinou stránku. V našem případě jde o stránku FreenetISu vyhrazenou k tomuto účelu, např. freenetis.domena.cz/redirection.

Vracíme se zpět k FreenetISu. FreenetIS si podle IP adresy návštěvníka na této stránce dohledá ve své databázi důvod přesměrování a uživateli zobrazí příslušnou zprávu. Některé zprávy si může uživatel sám zrušit, toto se hodí pro zprávy pouze informativního charakteru. Uživatel v tomto případě klikne na příslušný odkaz a je mu zobrazen rozcestník, na kterém může pokračovat do internetu. Musí ovšem počkat dobu trvání synchronizačního cyklu (u nás jedna minuta) než dojde k aktualizaci informace přesměrování na centrálním routeru.

== Typy zpráv ==

Existuje několik zpráv, které mají různé vlastnosti. Po instalaci obsahuje systém pouze systémové zprávy. Není možné je mazat, protože jsou vázané na konkrétní funkcionalitu v systému.

* Neznámé zařízení
* Přerušené členství
* Dlužník
* Upozornění na placení - člen ho může sám vypnout oproti přesměrování "Dlužník"

* Uživatelské zprávy - administrátor si může nadefinovat vlastní zprávy s libovolnými vlastnostmi

Při úpravě zpráv je možné použít html tagy i speciální tagy FreenetISu. Například {member_name} je speciální tag napsaný v editoru zprávy.
Uživateli se však místo toho zobrazí jeho jméno, v případě, že IP adresa návštěvníka patří nějakému členovi, jinak jsou zobrazeny tři otazníky ???. Lze použít tagy

* {ip_address} - IP adresa návštěvníka
* {subnet_name} - jméno podsítě IP adresy návštěvníka
* {member_name} - jméno člena
* {member_id} - ID člena
* {balance} - stav kreditu člena
* {variable_symbol} - variabilní symbol člena
* {comment} - osobní komentář přesměrovanému konkrétnímu členovi od administrátora

Dalším konceptem je bílá listina. Na bílou listinu jsou umísťovány IP adresy členů, na něž se nemá přesměrování používat. Existuje trvalá bílá listina určená pro důležité partnery, obecní úřady apod.

Dále pak dočasná bílá listina, kdy člen je přesměrován, protože neměl zaplaceno. On ale potřebuje aktivovat internet hned, aby mohl zaplatit třeba přes internetové bankovnictví nebo i z jiného důvodu. Je proto umístěn na dočasnou bílou listinu, ze které bude smazán při příštím importu výpisu. Výhledově je možné tuto funkcionalitu rozšířit o nějaký pevný čas, např. 3 dny při každodenním importu plateb nebo o individuální čas. Účel bílé listiny ale zůstává stejný.

== Instalace ze zdrojových souborů ==

'''Tento postup instalace je zde pro vývojářské účely. Koncový uživatelé by měli instalovat pomocí balíku [http://wiki.freenetis.org/index.php/Instalace#Bal.C3.ADk_freenetis-redirection frenetis-redirection].'''

UPOZORNĚNÍ: Tento text je zastaralý, aktuální zdrojové kódy k přesměrování jsou [https://github.com/freenetis/freenetis-redirection zde].

=== Co je potřeba nastavit na straně FreenetISu? ===

Je potřeba vyplnit nastavení v menu Přesměrování. Informace o jednotlivých položkách je v programové nápovědě. Dále je potřeba napsat texty minimálně pro systémové zprávy. Je možné využít html tagů i speciálních tagů ve složených závorkách.

Pokud máte již FreenetIS nainstalovaný, tak musíte ještě upravit váš soubor .htaccess. V něm přidejte povolení přístupu pro stránku redirection a smažte povolení přístupu pro stránku static. Výsledné pravidlo pak může vypadat např. takto:

# URL containing these strings will not be rewrited.
RewriteCond $1 ^(index\.php|robots\.txt|favicon\.ico|media|redirection|backuppc)
RewriteRule ^(.*)$ - [PT,L]

Toto se netýká nových instalací FreenetISu, jim by už měl být .htaccess vygenerován správně instalátorem.

=== Co je potřeba nastavit na straně centrálního routeru? ===

Toto nastavení je už komplikovanější, ale člověk trochu znalý Linuxu by to měl zvládnout. Je potřeba nainstalovat

* ipset (v Debianu 6 je už dostupný přes repozitář, jinak je nutná ruční instalace)
* lighttpd (nebo jiný nenáročný web server pro HTTP redirect)

Do vhodného umístění (např. /usr/local/sbin) umístit synchronizační skript a nastavit jeho pravidelné spouštění v cronu.

Náš současný skript obsahuje zastaralé funkce a zatím nám na starém Debianu funguje. V novém Debianu bude potřebovat menší upgrade, aby fungoval. Současné verze je ve složce

application/redirection/vendors/redirection/frnts_ipset

Co se týče nastavení skriptu je potřeba určit vnitřní a veřejné IP adresy brány a port, na který bude firewallem přesměrován uživatel. Seznam rozsahů je stahován z adresy

<domena>/cs/web_interface/redirected_ranges

Seznam povolených IP adres pak z adresy

<domena>/cs/web_interface/allowed_ip_addresses

* je potřeba mít na centrálním routeru linux, kde jeho jádro bude zkompilováno spolu s modulem ipset
* na centrálním routeru je potřeba mít správně nakonfigurovaný firewall
* je pořeba řádně nastavit synchronizační skript

Instalace [http://ipset.netfilter.org/ ipsetu] v bebianu lze z balíků

apt-get install ipset ipset-source
m-a a-i ipset

v jiných distrech dle možností a v neposlední řadě je vlastní kompilace.

Sychronizační skript by měl být nekonfliktní s vaším aktuálně nastaveným firewallem. Pokud nastanou problém, je nutné je řešit individuálně.

Do /etc/init.d/freenetis dáme spouštěcí skript z application/vendors/redirection/[[freenetis]]

upravíme práva

chmod 755 /etc/init.d/freenetis

a spust9me po startu

update-rc.d freenetis defaults

Do /usr/local/sbin/freenetis_synchronization.sh dáme skript z application/vendors/redirection/[[freenetis_synchronization.sh]]

chmod "a+x" /usr/local/sbin/freenetis_synchronization.sh

Do /etc/freenetins.cfg dáme skript z application/vendors/redirection/[[freenetis.cfg]] a dle potřeby upravíme.

Při samotném přesměrování se předpokládá, že na centrálním routeru naslouchá na portu 36000(lze kdykoliv změnit v /etc/freenetis.cfg) démon, který veškeré příchozí http dotazy přesměruje pomoci http redirect na stránku FreenetISu.

Pro naši potřebu je dostatečný server lighttpd. V debianu nainstalujema pomocí

apt-get install lighttpd

a v /etc/lighttpd/lighttpd.conf přidáme/upravíme:

server.port = 36000

url.redirect = ( "." => "http://freenetis.domain.ltd" )

Defaultně nám server startuje i na ipv6 což nepotřebuje, takže zakomentujeme

#include_shell "/usr/share/lighttpd/use-ipv6.pl"

Takovéto přesměrování ale bude mít kód 301, moved permanently. Pro bezproblémový chd doporučuji přesměrovávát s kódem 307, tj. temporary redirect. V lighttpd od verze 1.5.0 lze změnit kód [http://redmine.lighttpd.net/wiki/1/Docs:ModRedirect malou úpravou]

url.redirect-code = 307

Je možné použít jakýkoliv http server - i vlastní řešení.

TODO: Plánuji vlastní "server" založený na nějakém malém http serveru - např. [http://tinyhttpd.sourceforge.net/ TinyHTTPd]. Na jakýkoliv dotaz odpoví temporary redirect na freenetis a nic víc. Eazy.

Synchronizační skript startuje automaticky po startu systému. Je pomžné jej zastavit, nastartovat nebo restartovat pomocí příkazu /etc/init.d/freenetis start|stop|restart

'''POZOR!''' Pokud budete jakoliv měnit konfigurační soubor ujistěte se, že je skript ukončen a až pak soubor editujte. Vyhnete se tím nanuálnímu odstaňování starých pravidel z iptables.

Vytvoření tagu

2013-11-03T22:20:16Z

Dzolo:

Vytvoření tagu

2013-11-03T22:19:49Z

Dzolo: Založena nová stránka: Tag se vytváří při vydání stabilní verze z trunku, pomocí svn copy. svn copy --username=<váš login> svn+ssh://<váš login>@svn.code.sf.net/p/freenetis/code/fre...

Hlavni strana

2013-11-03T22:15:35Z

Dzolo: /* Vývojáři - hotové vlastnosti a pomůcky */

[[en:Main Page]]
[[ru:главная страница]]
Vítáme vás na dokumentační stránce systému FreenetIS!

* [http://www.freenetis.org/ Co je to FreenetIS?]
* [[Často kladené dotazy]]

* [[Speciální:Poslední změny]]

= Uživatelé =
* [[Uživatelská příručka]]
* [[Správcovská příručka]]
* [[Hospodářská příručka]]
* [[Administrátorská příručka]]

* [[Registrace nového uživatele - zájemce]]
* [[Změnit heslo]]
* [[Zobrazit zařízení]]
* [[Zobrazit práce]]
* [[Vyplnění žádosti o registraci zařízení do sítě]]

= Správci sítě =

* [[Instalace]]
* [[Co je třeba udělat po instalaci]]
* [[DHCP]] - pouze 1.1 a vyšší
* [[Upozorňování]]
* [[Logování]]
* [[Monitoring]]
* [[Zajištění kvality služeb (QoS)]]
* [[VoIP]]
* [[SNMP]]
* [[CGI_skripty]] - zjištění MAC adresy připojeného zařízení

'''Postupy'''
* [[Admin - nastavení nového uživatele - zájemce]] (Catman)
* [[Admin - přijetí zájemce za člena]] (Catman)
* [[Admin - přidat vysílací zařízení]] - Access point (AP) (Catman)
* [[Uživatel - přidat zařízení - připojen bezdrátově s NATem ]] (Catman)
* [[Uživatel - přidat zařízení - připojen bezdrátově s bridgem ]] - více zařízení na domácí síti (Catman)
* [[Uživatel - přidat zařízení - připojen kabelem na LAN ]] - např. domácí router (Catman)
* [[Změnit heslo]] (Catman)
* [[Zobrazit zařízení]] (Catman)
* [[Zobrazit práce]] (Catman)

'''Nastavení systému'''
* [[SystemAdmin - nastavení Systém]] (Catman)
* [[SystemAdmin - nastavení Email]] (Catman)
* [[SystemAdmin - nastavení Odesílání upozornění]] (Catman)
* [[SystemAdmin - nastavení Export přihlášky]] (Catman)
* [[SystemAdmin - nastavení Uživatelská role Pokladník]] (Catman)

* [[Instalace a nastavení serveru adresních bodů]]

* [[Managovatelný switch]] - popis vnitřní logiky (Dulík)
* [[Jak vložit switch na optické síti]] - včetně managementu (Catman)

'''H@cky'''
* [[Mazání člena]]

= Vývojáři - hotové vlastnosti a pomůcky =

* [[Specifikace]]
* [[Ekonomika]]
* [[i18n|i18n - internacionalizace]]
* [[Nastavení]]
* [[Verzování]]
* [[Přístupová práva]]
* [[Instalace ze zdrojových kódů]]
* [[Automatická změna struktury databáze]]

* [[Automatické testování]]
* [[Automatické testování v NetBeans]]
* [[Profiler]]
* [[Import a export databáze]]
* [[Smazání větve]]
* [[Vytvoření tagu]]
* [[Merge branche do trunku]]

= Vývojáři - budoucí možnosti a vlastnosti systému =

* [[Integrace s QGIS]]
* [[Nový systém přístupových práv]]

= Vývojáři - organizační údaje a štábní kultura =

* [[Štábní kultura]]
* [[Příručka stylu psaní]]
* [[Vývojová prostředí (IDE)]]

----

[[Speciální:Allpages|Všechny články na této wiki]]

Instalace ze zdrojových kódů

2013-11-03T22:09:36Z

Dzolo: /* Stažení z SVN */

[[en:Instalation from source code]]
'''Tento návod je určen pro vývojáře FreenetISu, pro distribuční účely je k dispozici [http://wiki.freenetis.org/index.php/Instalace instalace z balíčkovacích sytémů].'''

FreenetIS můžete provozovat na jakémkoli serveru (včetně Windows), ale doporučená platforma je Linux.

=Linux=

Tento návod předpokládá použití distribuce Debian. U jiných distribucí bude postup podobný.

==Příprava==

Instalace PHP, Apache, MySQL a phpMyAdmina. Je potřeba být přihlášen jako root.
apt-get install apache2 php5 php5-mysql php5-curl mysql-server phpmyadmin

'''Podporované verze nástrojů'''

* '''PHP''' verze 5.1.2 a vyšší
* '''MySQL''' verze 5.1.0 a vyšší

===Locale===
Pro správnou funkci porovnání českých řetězců v PHP musíte mít nainstalované české UTF-8 locale. Takže:
dpkg-reconfigure locales

Vybrat:

cs_CZ.UTF-8
en_US.UTF-8

a restartovat apache:

apache2ctl graceful

===Apache===

Pro správný běh Apache upravte soubor s konfigurací virtualhost-a, který na Debianu najdete takto:
*pokud jste žádný virtualhost zatím nenastavovali, jedná se o soubor /etc/apache2/sites-available/default
*pokud už nějaký virtualhost máte, pak bude nejspíš nakonfigurovaný v některém dalších souboru v adresáři /etc/apache2/sites-available/

Do tohoto souboru přidejte následující řádky:

<VirtualHost *>
ServerAdmin webmaster@example.org
ServerName freenetis.example.org
DocumentRoot /var/www/freenetis
<Directory /var/www/freenetis>
Options Indexes FollowSymLinks MultiViews
Order allow,deny
allow from all
</Directory>
</VirtualHost>

kde samozřejmě místo ServerAdmin a ServerName zadejte vaše údaje.

Nakonec restartujte Apache příkazem:

/etc/init.d/apache2 restart

====Volitelné: Povolení mod_rewrite====

Pokud jej nemáte povolený, tak jej povolte:

a2enmod rewrite

V konfiguraci virtualhost-a Apache (z přecházející bodu), povolte pro adresář FreenetIS možnost přenastavování konfigurace Apache pomocí souboru .htaccess - do sekce Directory přidejte direktivu "AllowOverride All". Tato sekce Directory by pak měl nakonec vypadat asi takto:

<Directory /var/www/freenetis>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>

Nakonec restartujte Apache příkazem:

/etc/init.d/apache2 restart

===MySQL===

Pro nastavení MySQL databáze je možné použít nespočet nástrojů a postupů. Pro každý z nich ale budete potřebovat uživatelské jméno a heslo pro přihlášení k vašemu MySQL serveru. Po instalaci existuje pouze jediný uživatel - root a jeho heslo je prázdné. Pokud jej zapomenete, změníte ho pomocí

dpkg-reconfigure mysql-server-VERZE

kde VERZE označuje číslo verze MySQL serveru. U novějších verzích je to obvykle 5.1, u těch starších pak 5.0.

====Pomocí phpMyAdmin====

[http://cs.wikipedia.org/wiki/PhpMyAdmin PhpMyAdmin] je pokročilý nástroj pro správu MySQL databázi přes webové rozhraní. Po instalaci je dostupný na

<nowiki>http://IP adresa serveru/phpmyadmin/</nowiki>

nebo pokud pracujete na localhostu, tak i na

<nowiki>http://localhost/phpmyadmin/</nowiki>

Kliknětě na Oprávnění a pak na Přidat nového uživatele. Jméno uživatele zadejte libovolné (doporučeno freenetis). Počítač vyberte lokální (důležité z hlediska bezpečnosti). Heslo nastavte silné, pokud možno náhodně vygenerované (dobrý generátor je např [http://www.converter.cz/passgen/pswdgen.php zde]. Vyberte volbu "Vytvořit databázi stejného jména a přidělit všechna oprávnění" a vpravo dole klikněte na Proveď.

==== Pomocí konzole====

Phpmyadmin nemusíte využít, pak lze databázi vytvořit ručně. Nejprve je nutné se přihlásit do databáze, budete vyzváni na heslo databázového superuživatele.

mysql -u root -p

Po přihlášení v konzoli mysql pak napište tyto příkazy:

create database freenetis;
create user 'freenetis'@'localhost' identified by 'heslo';
grant all on freenetis.* to 'freenetis'@'localhost';

==Stažení==
===Stažení z SVN===

Pokud nemáte SVN klienta, pak
apt-get install subversion

teď si můžete FreenetIS stáhnout do adresáře /var/www/freenetis (v trunku je nejstabilnější verze, další SVN větve slouží pro vývoj a testování)

cd /var/www
svn checkout <nowiki>svn+ssh://svn.code.sf.net/p/freenetis/code/freenetis/trunk freenetis</nowiki>

Povolte zápis do složek freenetis, freenetis/upload a vytvořte složku pro logování freenetis/logs:

cd /var/www/freenetis
chmod ugo+w . upload
mkdir -m 0777 logs

FreenetIS se neustále vyvíjí, aktualizace si stáhnete příkazem:

cd /var/www/freenetis
svn update

(což stáhne pouze modifikované soubory)

===Commit log===

Log oprav stable verze (trunk) je [http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/trunk/kohana/?view=log dostupný zde].

V současné době již používáme systém vývoje pomocí různých větvích (např. testing a další) a do hlavní větve (trunk) posíláme jen fungující změny, takže počet chyb je nižší než v situaci pouze jedné vývojové větve, jako tomu bylo dříve.

Souhrnný [http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/?view=log log commitů do všech větví je zde].

==Instalace==

Nyní by se po zadání vámi zvolené adresy FreenetISu do prohlížeče měl objevit instalátor s uvítáním.

===Nastavení konfigurace===

V první části vás instalátor informuje, že je potřeba vytvořit soubor konfigurační soubor config.php. Klikněte na tlačítko Další krok.

Nyní vás instalátor vyzve na zadání údajů pro přístup k MySQL serveru. Použijte údaje, které jste použili u přípravy MySQL a klikněte na Odeslat.

Pokud jste zadali správné údaje, instalátor vás informuje, že nastavení konfigurace bylo dokončeno. Jinak vás upozorní, že se nepodařilo připojit k databázi s návrhy možných problémů.

Až se vám podaří tyto chyby opravit, klikněte na tlačítko Další krok.

====Volitelné: Ruční vytvoření config.php====

Pokud nemáte práva zápisu do adresáře freenetis, instalátor vám vygeneruje kód, který zkopírujte a uložte jako config.php do adresáře freenetis. '''Dokud tak neučiníte, v instalaci nebude možno pokračovat!'''

===Samotná instalace===

Nyní by se před vámi měla objevit samotná instalace s formulářem s informacemi o vašem sdružení. Po jeho vyplnění by měla být instalace hotova.

====Volitelné: Ruční vytvoření .htaccess====

Pokud jste zatrhli možnost Čistá URL a nemáte práva zápisu do adresáře freenetis, instalátor vám vygeneruje kód, který zkopírujte a uložte jako .htaccess do adresáře freenetis. '''Pokud tak neučiníte, vaše instalace nemusí fungovat korektně!'''

===Zprovoznění "plánovače"===

FreenetIS má v sobě vlastní scheduler který je potřeba pravidelně zpouštět z cronu. Do cronu přidejte tento řádek:

#FreenetIS scheduler
* * * * * root wget -O /dev/null http://<hostname>/cs/scheduler/run

Pokud používáte SSL s neověřeným nebo s neplatným certifikátem použijte:

#FreenetIS scheduler
* * * * * root wget -O /dev/null https://<hostname>/cs/scheduler/run --no-check-certificate

Instalace a nastavení serveru adresních bodů

2013-10-24T08:47:53Z

Dzolo:

[[en:Instalation and settings of address point server]]

= Informace =
Pro provoz serveru databáze adres je ideální z důvodu zátěže vyhradit pro něj samostatný/virtuální server s alespoň 512MB RAM a 1GB swapem.

= Nastavení serveru =

== Příprava instalace ==
Nainstalujte všechny požadované balíky

apt-get install unzip git apache2 php5 php5-mysql mysql-server

Restartujte apache

service apache2 restart

== Získání zdrojových kódů ==
Stáhněte si zdrojové kódy webové aplikace do libovolné složky

git clone https://github.com/freenetis/freenetis-address.git

== Příprava databáze ==
Vytvořte databázi pomocí sql skriptu v souboru db_structure.sql

mysql -u username -ppassword jmeno_database < db_structure.sql

== Instalace ==
Spusťte s právy administrátora inslatační skript v složce se zdrojovými kódy

./install.sh

zadejte přihlašovací údaje k databázi. Následně se soubory nakopírují do /var/www/freenetis-addresses a vygeneruje se úloha pro CRON, která bude každý den v 5:00 kontrolovat aktuálnost databáze adres a případně ji aktualizuje na nejnovější verzi

== Prvotní stažení databáze ==

Spusťte importovací skript

./import.sh

Import může v závoslosti na rychlosti disků a počtu adres v databázi trvat i více než 30 minut. Průběh importu se bude zobrazovat v konzoli.

= Nastavení FreenetISu =
V nastavení FreenetISu v sekci systém vyplňte adresu webové aplikace včetně podložky, např.

http://sdruzeni.net/freenetis-addresses/

= Chybová hlášení import scriptu =
Config file not found - Nepodařilo se najít soubor /etc/freenetis-addresses.ini, řešením je znovu spuštění skriptu ./install.sh.

Cannot get latest database date - Nepodařilo se zjistit datum databáze ze serveru cuzk.cz. Buď jsou stránky nedostupné, nebo je změněna struktura stránky tak, že z ní není možné zjistit datum.

Database is up to date - Databáze je aktuální a nebude aktualizována.

Databasse is not up to date and will be update - Databáze není aktuální a bude aktualizována.

Cannot download addresses - Nepodařilo se stáhnout archiv s databází ze serveru cuzk.cz.

Cannot extract addresses - Chyba při rozbalování databáze do dočasné složky.

Cannot prepare addresses - Chyba při odstraňování nepotřebných sloupců, změně kódování nebo přípravě čísla popisného. Chybou může být změna formátu dat v databázi.

Cannot clean temporary table - Nastala chyba při mazání dočasné tabulky.

Cannot import addresses - Nepodařilo se naimportovat databázi adres. Chybou může být změna formátu dat v databázi.

CAnnot update database - Nastala chyba při záměně dočasné a produkční tabulky databáze adres.

Instalace a nastavení serveru adresních bodů

2013-10-07T21:24:13Z

Dzolo: /* Příprava instalace */

[[en:Instalation and settings of address point server]]

= Informace =
Pro provoz serveru databáze adres je ideální z důvodu zátěže vyhradit pro něj samostatný/virtuální server s alespoň 512MB RAM.

= Nastavení serveru =

== Příprava instalace ==
Nainstalujte všechny požadované balíky

apt-get install unzip git apache2 php5 php5-mysql mysql-server

Restartujte apache

service apache2 restart

== Získání zdrojových kódů ==
Stáhněte si zdrojové kódy webové aplikace do libovolné složky

git clone https://github.com/freenetis/freenetis-address.git

== Příprava databáze ==
Vytvořte databázi pomocí sql skriptu v souboru db_structure.sql

mysql -u username -ppassword jmeno_database < db_structure.sql

== Instalace ==
Spusťte s právy administrátora inslatační skript v složce se zdrojovými kódy

./install.sh

zadejte přihlašovací údaje k databázi. Následně se soubory nakopírují do /var/www/freenetis-addresses a vygeneruje se úloha pro CRON, která bude každý den v 5:00 kontrolovat aktuálnost databáze adres a případně ji aktualizuje na nejnovější verzi

== Prvotní stažení databáze ==

Spusťte importovací skript

./import.sh

Import může v závoslosti na rychlosti disků a počtu adres v databázi trvat i více než 30 minut. Průběh importu se bude zobrazovat v konzoli.

= Nastavení FreenetISu =
V nastavení FreenetISu v sekci systém vyplňte adresu webové aplikace včetně podložky, např.

http://sdruzeni.net/freenetis-addresses/

= Chybová hlášení import scriptu =
Config file not found - Nepodařilo se najít soubor /etc/freenetis-addresses.ini, řešením je znovu spuštění skriptu ./install.sh.

Cannot get latest database date - Nepodařilo se zjistit datum databáze ze serveru cuzk.cz. Buď jsou stránky nedostupné, nebo je změněna struktura stránky tak, že z ní není možné zjistit datum.

Database is up to date - Databáze je aktuální a nebude aktualizována.

Databasse is not up to date and will be update - Databáze není aktuální a bude aktualizována.

Cannot download addresses - Nepodařilo se stáhnout archiv s databází ze serveru cuzk.cz.

Cannot extract addresses - Chyba při rozbalování databáze do dočasné složky.

Cannot prepare addresses - Chyba při odstraňování nepotřebných sloupců, změně kódování nebo přípravě čísla popisného. Chybou může být změna formátu dat v databázi.

Cannot clean temporary table - Nastala chyba při mazání dočasné tabulky.

Cannot import addresses - Nepodařilo se naimportovat databázi adres. Chybou může být změna formátu dat v databázi.

CAnnot update database - Nastala chyba při záměně dočasné a produkční tabulky databáze adres.

Instalace a nastavení serveru adresních bodů

2013-10-04T08:35:58Z

Dzolo: /* Informace */

Vyplnění žádosti o připojení

2013-09-24T19:20:23Z

Dzolo: Přesměrování na Vyplnění žádosti o registraci zařízení do sítě

#REDIRECT [[Vyplnění žádosti o registraci zařízení do sítě]]

Vyplnění žádosti o registraci zařízení do sítě

2013-09-24T19:19:36Z

Dzolo: Založena nová stránka: Žádost o připojení umožňuje stávajícímu členovi přidat u nás neregistrované zařízení pomocí svého účtu ve FreenetISu. Skutečnost, že zařízení nen...

Žádost o připojení umožňuje stávajícímu členovi přidat u nás neregistrované zařízení pomocí svého účtu ve FreenetISu.
Skutečnost, že zařízení není u nás registrováno, lze detekovat tím, že je Vám zobrazena v internetovém prohlížeči stránka s informací o '''neznámém (neregistrovaném) zařízení'''.

Následující návod Vás provede celou procedurou vyplnění a schválení žádosti o připojení.

== 1) Zadání žádosti ==

* Zobrazila se Vám stránka s informací o '''neznámém (neregistrovaném) zařízení''' ve Vašem prohlížeči.

[[Soubor:Cr-zprava.png|thumb|center]]

* V zápatí této stránky naleznete odkaz s textem '''ZAŽÁDAT O PŘIPOJENÍ TOHOTO ZAŘÍZENÍ'''. Na tento odkaz klikněte.

* Jste přesměrován na přihlašovací stránku FreenetISu (pokud již nejste přihlášen). Přihlašte se prosím ke svému účtu (přihlašovací údaje jste s největší pravděpodobností získali při vstupu do sdružení). Pokud neznáte své přihlašovací údaje, kontaktujte prosím podporu (kontakty ve sloupci vlevo) pro jejich získání.

[[Soubor:Cr-login.png|thumb|center]]

* Je Vám zobrazen formulář pro přidání žádosti. Postačí když vyplníte '''typ zařízení''', které není registrováno.
:::- Pokud například máte nový počítač nebo máte v počítači novou síťovou kartu, pak zvolíte typ PC.
:::- Pokud jste si zakoupili nový router (domácí wifi), vyplňte typ na domácí AP.
:Pokud si nejste typem zařízení jistí, vyplňte nejvíce pravděpodobný typ a podrobně popište do pole '''poznámka''' událost, po které Vám byla stránka s informací o '''neznámém (neregistrovaném) zařízení''' zobrazena.

[[Soubor:Cr-vyplneni_zadosti.png|thumb|center]]

* Formulář odešlete.

[[Soubor:Cr-ulozeni_zadosti.png|thumb|center]]

== 2) Schvalovací proces žádosti ==

Vaši žádost musí schválit náš správce, což obvykle trvá několik minut - hodin - maximálně 1 den. O schválení/zamítnutí Vaší žádosti budete informováni skrze Vaši e-mailovou schránku, kterou máte vloženou ve FreenetISu. Pokud nemáte ve FreenetISu vloženou žádnou e-mailovou adresu, nebo nemáte k internetu přistup vůbec, můžete stav Vaši žádosti sledovat přímo ve FreenetISu. Vaše žádosti jsou dostupné skrze nabídku '''Moje žádosti o připojení''' v hlavním menu FreenetISu.

[[Soubor:Cr-menu_zadosti.png|thumb|center]]

Hlavni strana

2013-09-24T19:19:20Z

Dzolo: /* Uživatelé */

[[en:Main Page]]
[[ru:главная страница]]
Vítáme vás na dokumentační stránce systému FreenetIS!

* [http://www.freenetis.org/ Co je to FreenetIS?]
* [[Často kladené dotazy]]

* [[Speciální:Poslední změny]]

= Uživatelé =
* [[Uživatelská příručka]]
* [[Správcovská příručka]]
* [[Hospodářská příručka]]
* [[Administrátorská příručka]]

* [[Registrace nového uživatele - zájemce]]
* [[Změnit heslo]]
* [[Zobrazit zařízení]]
* [[Zobrazit práce]]
* [[Vyplnění žádosti o registraci zařízení do sítě]]

= Správci sítě =

* [[Instalace]]
* [[Co je třeba udělat po instalaci]]
* [[DHCP]] - pouze 1.1 a vyšší
* [[Upozorňování]]
* [[Logování]]
* [[Monitoring]]
* [[Zajištění kvality služeb (QoS)]]
* [[VoIP]]
* [[SNMP]]
* [[CGI_skripty]] - zjištění MAC adresy připojeného zařízení

'''Postupy'''
* [[Admin - nastavení nového uživatele - zájemce]] (Catman)
* [[Admin - přijetí zájemce za člena]] (Catman)
* [[Admin - přidat vysílací zařízení]] - Access point (AP) (Catman)
* [[Uživatel - přidat zařízení - připojen bezdrátově s NATem ]] (Catman)
* [[Uživatel - přidat zařízení - připojen bezdrátově s bridgem ]] - více zařízení na domácí síti (Catman)
* [[Uživatel - přidat zařízení - připojen kabelem na LAN ]] - např. domácí router (Catman)
* [[Změnit heslo]] (Catman)
* [[Zobrazit zařízení]] (Catman)
* [[Zobrazit práce]] (Catman)

'''Nastavení systému'''
* [[SystemAdmin - nastavení Systém]] (Catman)
* [[SystemAdmin - nastavení Email]] (Catman)
* [[SystemAdmin - nastavení Odesílání upozornění]] (Catman)
* [[SystemAdmin - nastavení Export přihlášky]] (Catman)
* [[SystemAdmin - nastavení Uživatelská role Pokladník]] (Catman)

* [[Instalace a nastavení serveru adresních bodů]]

* [[Managovatelný switch]] - popis vnitřní logiky (Dulík)
* [[Jak vložit switch na optické síti]] - včetně managementu (Catman)

'''H@cky'''
* [[Mazání člena]]

= Vývojáři - hotové vlastnosti a pomůcky =

* [[Specifikace]]
* [[Ekonomika]]
* [[i18n|i18n - internacionalizace]]
* [[Nastavení]]
* [[Verzování]]
* [[Přístupová práva]]
* [[Instalace ze zdrojových kódů]]
* [[Automatická změna struktury databáze]]

* [[Automatické testování]]
* [[Automatické testování v NetBeans]]
* [[Profiler]]
* [[Import a export databáze]]
* [[Smazání větve]]
* [[Merge branche do trunku]]

= Vývojáři - budoucí možnosti a vlastnosti systému =

* [[Integrace s QGIS]]
* [[Nový systém přístupových práv]]

= Vývojáři - organizační údaje a štábní kultura =

* [[Štábní kultura]]
* [[Příručka stylu psaní]]
* [[Vývojová prostředí (IDE)]]

----

[[Speciální:Allpages|Všechny články na této wiki]]

Vyplnění žádosti o připojení

2013-09-24T16:40:31Z

Dzolo: /* 1) Zadání žádosti */

Žádost o připojení umožňuje stávajícímu členovi přidat u nás neregistrované zařízení pomocí svého účtu ve FreenetISu.
Skutečnost, že zařízení není u nás registrováno, lze detekovat tím, že je Vám zobrazena v internetovém prohlížeči stránka s informací o '''neznámém (neregistrovaném) zařízení'''.

Následující návod Vás provede celou procedurou vyplnění a schválení žádosti o připojení.

== 1) Zadání žádosti ==

* Zobrazila se Vám stránka s informací o '''neznámém (neregistrovaném) zařízení''' ve Vašem prohlížeči.

[[Soubor:Cr-zprava.png|thumb|center]]

* V zápatí této stránky naleznete odkaz s textem '''ZAŽÁDAT O PŘIPOJENÍ TOHOTO ZAŘÍZENÍ'''. Na tento odkaz klikněte.

* Jste přesměrován na přihlašovací stránku FreenetISu (pokud již nejste přihlášen). Přihlašte se prosím ke svému účtu (přihlašovací údaje jste s největší pravděpodobností získali při vstupu do sdružení). Pokud neznáte své přihlašovací údaje, kontaktujte prosím podporu (kontakty ve sloupci vlevo) pro jejich získání.

[[Soubor:Cr-login.png|thumb|center]]

* Je Vám zobrazen formulář pro přidání žádosti. Postačí když vyplníte '''typ zařízení''', které není registrováno.
:::- Pokud například máte nový počítač nebo máte v počítači novou síťovou kartu, pak zvolíte typ PC.
:::- Pokud jste si zakoupili nový router (domácí wifi), vyplňte typ na domácí AP.
:Pokud si nejste typem zařízení jistí, vyplňte nejvíce pravděpodobný typ a podrobně popište do pole '''poznámka''' událost, po které Vám byla stránka s informací o '''neznámém (neregistrovaném) zařízení''' zobrazena.

[[Soubor:Cr-vyplneni_zadosti.png|thumb|center]]

* Formulář odešlete.

[[Soubor:Cr-ulozeni_zadosti.png|thumb|center]]

== 2) Schvalovací proces žádosti ==

Vaši žádost musí schválit náš správce, což obvykle trvá 1 den. O schválení/zamítnutí Vaší žádosti budete informováni skrze Vaši e-mailovou schránku, kterou máte vloženou ve FreenetISu. Pokud nemáte ve FreenetISu vloženou žádnou e-mailovou adresu, nebo nemáte k internetu přistup vůbec, můžete stav Vaši žádosti sledovat přímo ve FreenetISu. Vaše žádosti jsou dostupné skrze nabídku '''Moje žádosti o připojení''' v hlavním menu FreenetISu.

[[Soubor:Cr-menu_zadosti.png|thumb|center]]