Freenetis Wiki - Příspěvky uživatele [cs]

Instalace a nastavení serveru adresních bodů

2013-10-29T10:20:50Z

Jeffraska:

[[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

<pre>
CREATE DATABASE `adresses` DEFAULT CHARACTER SET utf8 COLLATE utf8_czech_ci;

CREATE TABLE IF NOT EXISTS `addresses` (
`country` int(11) NOT NULL,
`town_name` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`town_quarter` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`district_name` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`street` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`number` varchar(15) COLLATE utf8_czech_ci NOT NULL,
`zip_code` varchar(10) COLLATE utf8_czech_ci NOT NULL,
UNIQUE KEY `FULLTEXT` (`town_name`,`town_quarter`,`district_name`,`street`,`number`,`zip_code`,`country`),
KEY `country` (`country`),
FULLTEXT KEY `town_name` (`town_name`),
FULLTEXT KEY `town_quarter` (`town_quarter`),
FULLTEXT KEY `district_name` (`district_name`),
FULLTEXT KEY `street` (`street`),
FULLTEXT KEY `number` (`number`),
FULLTEXT KEY `zip_code` (`zip_code`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_czech_ci;

CREATE TABLE IF NOT EXISTS `addresses_tmp` (
`country` int(11) NOT NULL,
`town_name` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`town_quarter` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`district_name` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`street` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`number` varchar(15) COLLATE utf8_czech_ci NOT NULL,
`zip_code` varchar(10) COLLATE utf8_czech_ci NOT NULL,
UNIQUE KEY `FULLTEXT` (`town_name`,`town_quarter`,`district_name`,`street`,`number`,`zip_code`,`country`),
KEY `country` (`country`),
FULLTEXT KEY `town_name` (`town_name`),
FULLTEXT KEY `town_quarter` (`town_quarter`),
FULLTEXT KEY `district_name` (`district_name`),
FULLTEXT KEY `street` (`street`),
FULLTEXT KEY `number` (`number`),
FULLTEXT KEY `zip_code` (`zip_code`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_czech_ci;

CREATE TABLE IF NOT EXISTS `config` (
`name` varchar(100) COLLATE utf8_czech_ci NOT NULL,
`value` text COLLATE utf8_czech_ci NOT NULL,
PRIMARY KEY (`name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_czech_ci;
</pre>

== Instalace ==
Spusťte s právy administrátora instalač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.

= Aktualizace zdrojových kódů =
Po stažení aktualizovaných zdrojových kódů spusťte s právy administrátora instalační skript v složce se zdrojovými kódy

./install.sh

= Odinstalace =
Spusťte s právy administrátora instalační skript v složce se zdrojovými kódy s parametrem -u

./install.sh -u

= Changelog =
'''29.10.2013'''
Přidán příkaz CREATE DATABASE se správným kódováním
Instalační skript nevyžaduje opětovné zadávání informací o DB při aktualizaci
Do instalačního skriptu přidán parametr -u pro odinstalování

'''14.10.2013''' - vyžaduje FreenetIS_1.1.0~beta2
Změna chování validátoru - pokud není zadána část, validátor se pokusí jako část použít město

'''18.9.2013''' - vyžaduje FreenetIS_1.1.0~beta1
Změny kvůli změně chování napovídače

'''17.9.2013'''
Změny kvůli změně chování napovídače

'''16.9.2013''' - vyžaduje FreenetIS_1.1.0~alpha58
Změna řazení města a části

'''13.9.2013'''
Oprava chyby v importovacím skriptu běžícím s --cron parametrem

'''5.9.2013'''
Vypnutí barevného vypisování v CRONu

Instalace a nastavení serveru adresních bodů

2013-10-29T10:20:10Z

Jeffraska:

[[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

<pre>
CREATE DATABASE `adresses` DEFAULT CHARACTER SET utf8 COLLATE utf8_czech_ci;

CREATE TABLE IF NOT EXISTS `addresses` (
`country` int(11) NOT NULL,
`town_name` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`town_quarter` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`district_name` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`street` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`number` varchar(15) COLLATE utf8_czech_ci NOT NULL,
`zip_code` varchar(10) COLLATE utf8_czech_ci NOT NULL,
UNIQUE KEY `FULLTEXT` (`town_name`,`town_quarter`,`district_name`,`street`,`number`,`zip_code`,`country`),
KEY `country` (`country`),
FULLTEXT KEY `town_name` (`town_name`),
FULLTEXT KEY `town_quarter` (`town_quarter`),
FULLTEXT KEY `district_name` (`district_name`),
FULLTEXT KEY `street` (`street`),
FULLTEXT KEY `number` (`number`),
FULLTEXT KEY `zip_code` (`zip_code`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_czech_ci;

CREATE TABLE IF NOT EXISTS `addresses_tmp` (
`country` int(11) NOT NULL,
`town_name` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`town_quarter` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`district_name` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`street` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`number` varchar(15) COLLATE utf8_czech_ci NOT NULL,
`zip_code` varchar(10) COLLATE utf8_czech_ci NOT NULL,
UNIQUE KEY `FULLTEXT` (`town_name`,`town_quarter`,`district_name`,`street`,`number`,`zip_code`,`country`),
KEY `country` (`country`),
FULLTEXT KEY `town_name` (`town_name`),
FULLTEXT KEY `town_quarter` (`town_quarter`),
FULLTEXT KEY `district_name` (`district_name`),
FULLTEXT KEY `street` (`street`),
FULLTEXT KEY `number` (`number`),
FULLTEXT KEY `zip_code` (`zip_code`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_czech_ci;

CREATE TABLE IF NOT EXISTS `config` (
`name` varchar(100) COLLATE utf8_czech_ci NOT NULL,
`value` text COLLATE utf8_czech_ci NOT NULL,
PRIMARY KEY (`name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_czech_ci;
</pre>

== Instalace ==
Spusťte s právy administrátora instalač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.

== Aktualizace zdrojových kódů ==
Po stažení aktualizovaných zdrojových kódů spusťte s právy administrátora instalační skript v složce se zdrojovými kódy

./install.sh

== Odinstalace ==
Spusťte s právy administrátora instalační skript v složce se zdrojovými kódy s parametrem -u

./install.sh -u

== Changelog ==
'''29.10.2013'''
Přidán příkaz CREATE DATABASE se správným kódováním
Instalační skript nevyžaduje opětovné zadávání informací o DB při aktualizaci
Do instalačního skriptu přidán parametr -u pro odinstalování

'''14.10.2013''' - vyžaduje FreenetIS_1.1.0~beta2
Změna chování validátoru - pokud není zadána část, validátor se pokusí jako část použít město

'''18.9.2013''' - vyžaduje FreenetIS_1.1.0~beta1
Změny kvůli změně chování napovídače

'''17.9.2013'''
Změny kvůli změně chování napovídače

'''16.9.2013''' - vyžaduje FreenetIS_1.1.0~alpha58
Změna řazení města a části

'''13.9.2013'''
Oprava chyby v importovacím skriptu běžícím s --cron parametrem

'''5.9.2013'''
Vypnutí barevného vypisování v CRONu

Instalace a nastavení serveru adresních bodů

2013-10-29T09:45:32Z

Jeffraska: /* Příprava databáze */

[[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

<pre>
CREATE DATABASE `adresses` DEFAULT CHARACTER SET utf8 COLLATE utf8_czech_ci;

CREATE TABLE IF NOT EXISTS `addresses` (
`country` int(11) NOT NULL,
`town_name` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`town_quarter` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`district_name` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`street` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`number` varchar(15) COLLATE utf8_czech_ci NOT NULL,
`zip_code` varchar(10) COLLATE utf8_czech_ci NOT NULL,
UNIQUE KEY `FULLTEXT` (`town_name`,`town_quarter`,`district_name`,`street`,`number`,`zip_code`,`country`),
KEY `country` (`country`),
FULLTEXT KEY `town_name` (`town_name`),
FULLTEXT KEY `town_quarter` (`town_quarter`),
FULLTEXT KEY `district_name` (`district_name`),
FULLTEXT KEY `street` (`street`),
FULLTEXT KEY `number` (`number`),
FULLTEXT KEY `zip_code` (`zip_code`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_czech_ci;

CREATE TABLE IF NOT EXISTS `addresses_tmp` (
`country` int(11) NOT NULL,
`town_name` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`town_quarter` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`district_name` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`street` varchar(50) COLLATE utf8_czech_ci NOT NULL,
`number` varchar(15) COLLATE utf8_czech_ci NOT NULL,
`zip_code` varchar(10) COLLATE utf8_czech_ci NOT NULL,
UNIQUE KEY `FULLTEXT` (`town_name`,`town_quarter`,`district_name`,`street`,`number`,`zip_code`,`country`),
KEY `country` (`country`),
FULLTEXT KEY `town_name` (`town_name`),
FULLTEXT KEY `town_quarter` (`town_quarter`),
FULLTEXT KEY `district_name` (`district_name`),
FULLTEXT KEY `street` (`street`),
FULLTEXT KEY `number` (`number`),
FULLTEXT KEY `zip_code` (`zip_code`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_czech_ci;

CREATE TABLE IF NOT EXISTS `config` (
`name` varchar(100) COLLATE utf8_czech_ci NOT NULL,
`value` text COLLATE utf8_czech_ci NOT NULL,
PRIMARY KEY (`name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_czech_ci;
</pre>

== 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-06T10:44:29Z

Jeffraska:

Instalace a nastavení serveru adresních bodů

2013-09-18T13:05:19Z

Jeffraska: /* Příprava databáze */

[[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ý server.

= Nastavení serveru =

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

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

== 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/

Instalace a nastavení serveru adresních bodů

2013-09-18T12:59:50Z

Jeffraska: /* 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ý server.

= Nastavení serveru =

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

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

== 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 -p password 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/

Instalace a nastavení serveru adresních bodů

2013-09-17T11:49:57Z

Jeffraska:

[[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ý server.

= Nastavení serveru =

== Příprava instalace ==
Nainstalujte všechny požadované balíky
unzip
git
php >= 5.2.0
mysql >= 5.1

== 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 -p password 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/

Instalace a nastavení serveru adresních bodů

2013-09-16T13:47:58Z

Jeffraska: Založena nová stránka: 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ý ser...

[[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ý server.

= Nastavení serveru =

== Příprava instalace ==
Nainstalujte všechny požadované balíky
unzip
git
php >= 5.2.0
mysql >= 5.1

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

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

== 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

== 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/

Hlavni strana

2013-09-16T13:23:22Z

Jeffraska:

[[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]]

= 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]]

Instalace ze zdrojových kódů

2013-07-04T11:13:34Z

Jeffraska:

[[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 slouží pro vývoj a testování)

cd /var/www
svn checkout --username=username <nowiki>svn+ssh://username@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

Automatické testování v NetBeans

2013-06-13T10:17:42Z

Jeffraska:

[[en:Automatic testing in NetBeans]]

== Integrace PHPUnit do NetBeans ==

=== Instalace balíků ===

v Ubuntu/Debianu:

sudo apt-get install phpunit

ve Fedoře:

sudo yum install phpunit

=== Nastavení NetBeans ===

Zadat cestu k binárce PHPUnit (obvykle /usr/bin/phpunit) ručně, nebo pomocí tlačítka '''Search''' v okně

Nástroje > Předvolby > PHP > Unit Testing

== Vytvoření testů ==

V kontextovém menu testovaného zdrojového souboru/složky vyberte

Nástroje > Create PHPUnit tests

zadejte cestu ke složce (složka tests v kořenovém adresáři FreenetISu), do které se budou automaticky generovat testovací soubory. Dojde k vygenerování kostry pro vytváření testů vybraného souboru. Do tohoto souboru naimplementujte testy pro jednotlivé metody.

== Spuštění testů ==

Ve vlastnostech projektu povolte v okně PHPUnit '''Use Bootstrap''' a '''Use Bootstrap for Creating New Unit Tests''' a jako Bootstrap soubor vyberte ''index.php'' v kořenovém adresáři FreenetISu.

V kontextovém menu zdrojového souboru, který chcete otestovat, vyberte možnost ''Test''. Případně v menu Run vybrat ''Test project''. Následně proběhne automatická kontrola všech testů a zobrazení výsledků v okně Test Results.

Automatické testování v NetBeans

2013-06-06T09:35:41Z

Jeffraska:

[[en:Automatic testing in NetBeans]]

== Integrace PHPUnit do NetBeans ==

=== Instalace balíků ===

v Ubuntu/Debianu:

sudo apt-get install phpunit

ve Fedoře:

sudo yum install phpunit

=== Nastavení NetBeans ===

Zadat cestu (ručně, nebo pomocí tlačítka '''Search''') k PHPUnit Script v okně

Nástroje > Předvolby > PHP > Unit Testing

== Vytvoření testů ==

V kontextovém menu testovaného zdrojového souboru/složky vyberte

Nástroje > Create PHPUnit tests

zadejte cestu ke složce (složka tests v kořenovém adresáři FreenetISu), do které se budou automaticky generovat testovací soubory. Dojde k vygenerování kostry pro vytváření testů vybraného souboru. Do tohoto souboru naimplementujte testy pro jednotlivé metody.

== Spuštění testů ==

Ve vlastnostech projektu povolte v okně PHPUnit '''Use Bootstrap''' a '''Use Bootstrap for Creating New Unit Tests''' a jako Bootstrap soubor vyberte ''index.php'' v kořenovém adresáři FreenetISu.

V kontextovém menu zdrojového souboru, který chcete otestovat, vyberte možnost ''Test''. Případně v menu Run vybrat ''Test project''. Následně proběhne automatická kontrola všech testů a zobrazení výsledků v okně Test Results.

Automatické testování v NetBeans

2013-06-06T09:33:04Z

Jeffraska: Založena nová stránka: en:Automatic testing in NetBeans == Integrace PHPUnit do NetBeans == === Instalace balíků === v Ubuntu/Debianu: sudo apt-get install phpunit ve Fedoře: sudo ...

[[en:Automatic testing in NetBeans]]

== Integrace PHPUnit do NetBeans ==

=== Instalace balíků ===

v Ubuntu/Debianu:

sudo apt-get install phpunit

ve Fedoře:

sudo yum install phpunit

=== Nastavení NetBeans ===

Zadat cestu (ručně, nebo pomocí tlačítka '''Search''') k PHPUnit Script v okně

Nástroje > Předvolby > PHP > Unit Testing

== Vytvoření testů ==

V kontextovém menu testovaného zdrojového souboru/složky vyberte

Nástroje > Create PHPUnit tests

zadejte cestu ke složce (složka tests v kořenovém adresáři FreenetISu), do které se budou automaticky generovat testovací soubory. Dojde k vygenerování kostry pro vytváření testů vybraného souboru. Do tohoto souboru naimplementujte testy pro jednotlivé metody.

== Spuštění testů ==

Ve vlastnostech projektu povolte v okně PHPUnit '''Use Bootstrap''' a '''Use Bootstrap for Creating New Unit Tests''' a jako Bootstrap soubor vyberte ''index.php'' v kořenovém adresáři FreenetISu.

V kontextovém menu zdrojového souboru, který chcete otestovat, vyberte možnost Test. Následně proběhne automatická kontrola všech testů a zobrazení výsledků v okně Test Results.

Hlavni strana

2013-06-06T08:52:34Z

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

[[en:Main Page]]
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]]

= 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]]

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

* [[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]]

Merge branche do trunku

2012-08-21T12:39:23Z

Jeffraska:

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/kohana 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)

Merge branche do trunku

2012-08-21T12:38:29Z

Jeffraska: Založena nová stránka: 1. Checkout trunku a testingu svn checkout http://freenetis.svn.sourceforge.net/svnroot/freenetis/freenetis/branches/testing testing svn checkout http://freenetis.svn.so...

Hlavni strana

2012-08-21T12:18:35Z

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

Vítáme vás na dokumentační stránce systému FreenetIS!

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

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

= Správci sítě =

* [[Instalace]]
* [[Co je třeba udělat po instalaci]]
* [[Upozorňování]]
* [[Logování]]
* [[Monitoring]]
* [[Zajištění kvality služeb (QoS)]]
* [[VoIP]]

'''Postupy'''
* [[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í]]
* [[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]]
* [[Coding Style Guide]]
* [[IDE]]

----

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

Hlavni strana

2012-08-03T16:47:43Z

Jeffraska: /* Správci sítě */

Vítáme vás na dokumentační stránce systému FreenetIS!

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

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

= Správci sítě =

* [[Instalace]]
* [[Co je třeba udělat po instalaci]]
* [[Přesměrování]]
* [[Mazání člena]]

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

= 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í]]
* [[Profiler]]
* [[Import a export databáze]]
* [[Smazání větve]]

= 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]]
* [[Coding Style Guide]]
* [[IDE]]

----

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

Diskuse:Registrace a přihlášení do systému

2012-08-02T10:28:11Z

Jeffraska: Stránka Diskuse:Registrace a pÅ™ihlÃ¡Å¡enÃ do systÃ©mu přemístěna na stránku Diskuse:Registrace a přihlášení do systému: Špatný název

Vůbec jsem to nepochopil:

* su člen UNART
* do přihlášky jsem vyplnil nějaký nick, ale samozřejmě žádné heslo
* tak jsem se chtěl zaregistrovat jako nový člen
* poctivě jsem vyplnil všechny údaje, nerozhodilo mě to, že to chce i povinnou ulici (kterou navzdory tomu u nás na dědinách ji vůbec povinně nevedeme) a přehlédl jsem i to, že se to ptá na Město, i když lepší by bylo tam psát Obec (holt "slepičínocentrismus" :-) )
* pak mi systém oznámil, že moje telefonní číslo a mail už v db má - a tím jsem skončil
* tož co teď?
* taky by se měl ošetřit nějak certifikát serveru. Normální běloch se lekne, když mu Mozilla při vstupu na https://freenetis.slfree.net/cs/login píše o tom, že je to nezabezpečný server...
[[Soubor:Slfree vyjimka mozilla.gif‎]]

Diskuse:Registrace a pÃ…â„¢ihlÃƒÂ¡Ã…Â¡enÃƒÂ do systÃƒÂ©mu

2012-08-02T10:28:11Z

Jeffraska: Stránka Diskuse:Registrace a pÅ™ihlÃ¡Å¡enÃ do systÃ©mu přemístěna na stránku Diskuse:Registrace a přihlášení do systému: Špatný název

#PŘESMĚRUJ [[Diskuse:Registrace a přihlášení do systému]]

Registrace a přihlášení do systému

2012-08-02T10:28:10Z

Jeffraska: Stránka Registrace a pÅ™ihlÃ¡Å¡enÃ do systÃ©mu přemístěna na stránku Registrace a přihlášení do systému: Špatný název

'''První krůčky s FreenetISem'''

* Pokud máte zájem zaregistrovat se v systému [http://wiki.freenetis.slfree.net/index.php/Co_je_to_Freenetis%3F FreenetIS] a tím se stát členem občanského sdružení [http://www.unart.cz/ Unart] (Z čehož plyne možnost využívat připojení k internetu pomocí [http://www.slfree.net/ Slfree].) navštivte stránky [https://freenetis.slfree.net/cs/members/show/1342 FreenetISu].

''Jsem tu co teď?''

* Po zadání adresy (www.freenetis.slfree.net) do vašeho internetového prohlížeče se vám zobrazí stránka vyžadující po Vás [https://freenetis.slfree.net/cs/members/show/1342 login a heslo].

* Pokud již login s heslem máte můžete se přihlásit, pokud ne musíte se zaregistrovat. Registrace se provádí pomocí formuláře, který se skrývá pod odkazem [https://freenetis.slfree.net/cs/registration Nový člen].
* Aby registrace proběhla úspěšně, je nutnné vyplnit všechny položky ve formuláři (Pouze email není povinný).

Další důležitou podmínkou je existence unikátního loginu (V systému se login musí vyskytovat pouze jednou -
proto je pravděpodobné, že pouze křestní jméno nebo přijmení v systému již budou obsazeny).
Neméně důležité je zvolit si silné a pro Vás zapamatovatelné heslo (Doporučuje se kombinace velkých a malých písmen s čísly,
slovníková slova jsou nedostatečná).

* Po úspěšné registraci se můžete směle přihlásit do systému a využívat všech jeho služeb.

--[[Uživatel:Pap|Pap]] 21:16, 30. 7. 2008 (UTC)

Fio banka

2012-08-02T10:22:57Z

Jeffraska:

FreenetIS podporuje import bankovních výpisů Fio banky ve formátu CSV. V internetovém bankovnictví je potřeba si nejprve definovat vlastní filtr pro strukturu výpisů. Výpis musí obsahovat všechny dostupné sloupce. Je to z důvodu jednoty a úplnosti. Internetové bankovnictví Fio banky má obrovskou výhodu ve velké variabilitě volby období výpisu. Je tedy možné si ručně zvolit libovolné období, to se hodí zejména na začátku. Později je výhodnější využít modul pro automatické denní stahování a import výpisů.

Automatické testování

2012-08-02T10:22:34Z

Jeffraska:

Automatické testování slouží jako zpětná kontrola provedených akcí vývojáře.

== Architektura testů ==

Testy jsou zcela automatizované (programátor nemusí testy programovat, ale jen dodávat data k jejich testovaní) a automaticky přizpůsobitelně změnám ve zdrojových kódech.

Testy umožňují kontrolovat '''modely''', '''helpery''' a '''controllery''', ostatní části systému jsou kontrolovány pouze na jejich syntaktickou správnost.

Testy oproti unit testům neporovnávají výsledné hodnoty daných funkcí ale pouze ověřují zda-li neskončil běh chybou.

'''Testy jsou podporovány na *unix operačních systémech.'''

=== Načtení informací o zdrojových kódech ===

Načtení informací o zdrojových kódech probíhá automaticky pomocí skriptu, který prochází všechny testované subjekty a získává z nich data nutná k volání rutin subjektů. Tyto data jsou ukládána do XML dokumentu (''/application/vendors/unit_tester/unit_testing_config.xml'').

== Instalace testů ==

Instalace potřebných knihoven:

v Ubuntu/Debianu:

sudo apt-get install curl perl libxml-writer-perl libxml-dom-perl

ve Fedoře:

sudo yum install curl perl perl-XML-Writer perl-XML-DOM

'''Přidělení práv:'''

cd /var/www/freenetis
chmod +x ./application/vendors/unit_tester/tester.sh

'''Zamezení posílání e-mailů/SMS apod.:'''

Do config.php přidejte:

$config['unit_tester'] = TRUE;

== Spuštění testů ==

'''Upozornění: Testy spouštějte pouze na lokálním vývojovém serveru!'''

cd /var/www/freenetis/application/vendors/unit_tester
./tester.sh <URL> <LOGIN_NAME> <PASSWORD>

''poznámka: Doba běhu všech testů na Intel Core i5 2.53GHz s Ubuntu 11.04 je cca 4 minuty.''

'''Příklad s argumenty:'''

./tester.sh -o http://localhost/freenetis admin 123456

=== Argumenty testovacího skriptu ===

$ ./tester.sh --help
Script for testing FreenetIS
USAGE: tester.sh [options] URL username password

Options:
-o, --open-browser Opens browser with models or helpers errors
automatically, after error detection.
-s, --skip-syntax Skip syntax check of all files
-m, --skip-models Skip test of models
-h, --skip-helpers Skip test of helpers
-c, --skip-controllers Skip test of controllers
-e, --enable-stats Turn on statistics and benchmarks

== Úprava testovaných informací ==

Automaticky vygenerované testovací hodnoty nejsou pro testování dostatečné, proto je vhodné doplnit některé další hodnoty.

Postupy uvedeme na příkladu modelu, v konfiguračním souboru nalezněte příslušný subjekt (dle názvu tagu a atributu jména).

'''Model po automatickém vygenerování:'''

<model name="test">
<method name="testovaci_funkce" autogenerate="on">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</attributes>
<values>
<input>
<param value="" />
<param value="array()" />
</input>
</values>
</method>
</model>

Velmi důležitý je atribut metody '''autogenerate''', pokud provedete změny v metodě a nenastavíte jej na hodnotu '''off''' změny se při spuštění testování zahodí.

Tag '''input''' lze chápat jako jednu sadu testovaných hodnot dané metody.

'''Pokud si nepřejete aby metoda byla testována vůbec (časté u metod, které jsou závislé na objektech, nebo vkládají data do databáze), lze toho docílit takto:'''

<model name="test">
<method name="testovaci_funkce" autogenerate="off">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</attributes>
<values>
</values>
</method>
</model>

'''Ideální testovací data (snažíme se vkládat i nesmyslné a prázné hodnoty) pro náš testovací model mohou vypadat takto:'''

<model name="test">
<method name="testovaci_funkce" autogenerate="off">
<attributes>
<attribute name="user_id" default_value="" />
<attribute name="filter_values" default_value="array()" />
</attributes>
<values>
<input>
<param value="" />
<param value="" />
</input>
<input>
<param value="" />
<param value="array()" />
</input>
<input>
<param value="1" />
<param value="array('id' => '1')" />
</input>
<input>
<param value="abd'se$#@`" />
<param value="abd'se$#@`" />
</input>
<input>
<param value="1" />
<param value="array('id' => '1sef%se@š`', 'Ijnfsief' => 'se2', 'sef$a;!')" />
</input>
</values>
</method>
</model>

=== Dodatečné vlastnosti pro controllery ===

Pro controllery lze posílat i data pomocí POST a GET HTTP akce, stačí do vstupního parametrů testu přidat parametry ve tvaru:

<param name="post_name" type="post" value="hodnota" />
<param name="get_name" type="get" value="hodnota" />

=== Po-editační testovaní validity dokumentu ===

Po každé editaci konfiguračního souboru je vhodné zkontrolovat jeho validitu pomocí dodaného DTD (''/application/vendors/unit_tester/unit_testing_config.xml''), jelikož samotný test počítá s validní konfigurací!

V IDE Netbeans kontrolu validity provedete pomocí označení konfiguračního souboru a následného vyvolání jeho kontextového menu a položky Validate XML.

== Statistiky a benchmarky ==

Součástí testů jsou i nástroje pro benchmarky modelů a controllerů. Lze je zapnout pomocí parametru <code>-e</code>.

Výsledky benchmarků u modelů je zobrazováno ve výstupním HTML souboru společně s testy.

Výsledky u controllerů jsou ukládány do souboru <code>curl/cstats</code>, který má čtyři sloupce oddělené tabulátorem.

* První slopec obsahuje informaci o době provádění controlleru v sekundách.
* Druhý sloupec obsahuje spotřebu paměti v MB pro dané provádění.
* Třetí sloupec je URL požadavku.
* Čtvrtý obsahuje hodnoty HTTP POST odeslané controlleru.

''' Příklad výpsání 10 požadávků s největší spotřebou paměti: '''

cat curl/cstats | cut -f 1,2,3 | sort -n -r -k 2,2 | head -n 10

''Poznámka: V celém návodu je uvažována cesta k FreenetISu odvozená z [[Instalace FreenetIS]]''

Nový systém přístupových práv

2012-08-02T10:22:06Z

Jeffraska:

Nový systém přístupových práv - náhrada za těžkopádný phpGACL. Možnost úpravy pravidel a skupin přímo srze FreenetIS.

Oproti gaclu pár změn:

- základní jednotka by neměla být člen, ale uživatel
- tabulka operace (ACO) nebude potřeba - už teď je to vázané na kód, spíš řešit pomocí 2 konstant - jedna SHOW|ADD|EDIT|DELETE a druhá OWN|ALL (takže se nabízí zase nějaké řešení pomocí bitů)
- možnost navázat pravidlo na určitý AXO objekt (takže nepovinný parametr s ID?)

Jestli vás něco napadá, napište to sem. Ať se to navrhne co nejlépe, aby se na to (nejlépe) už nikdy nemuselo moc šahat...

Managovatelný switch

2012-08-02T10:21:55Z

Jeffraska:

Switche mají vnitřní síťové rozhraní, připojené k nějakému mikrokontroleru, který realizuje management switche = konfiguraci switching logiky (switching fabric), web/telnet/ssh rozhraní atd.

Toto vnitřní rozhraní je připojené do switching fabric stejně, jako ostatní porty switche:

[[Soubor:freenetis-manageswitch.png]]

Většina managovatelných switchů umí na tom vnitřním rozhraní tvořit libovolný počet VLAN rozhraní, aby bylo možné management switche zpřístupňovat do libovolného VLANu, který si ve switchi vytvořím.

Takže managovatelný switch ve FreenetISu by se zapsal jako zařízení, které má 1 vnitřní (=nedostupný na žádném konektoru) LAN interface a třeba 24 portů.
Pokud bude LAN interface skrytý, pak se u něj segment nemusí evidovat, kterýžto příznak FreenetIS zatím nemá - momentálně je nutné vytvořit i ten skrytý segment, na obrázku to je to šipka mezi "LAN interface" a "Internal port".

Quimi navrhuje postup:

Nebo by šlo vytvořit segment Propoj Interní port - Management LAN. Pak přidat k zařízení port Inerní port a rozhraní Management LAN, které vlastně tímto segmentem propojíme. Nad rozhraním Management LAN pak budeme vytvářet jednotlivé VLAN rozhraní (patřící do určitého VLANu) - až k nim pak budeme přiřazovat managovací IP adresy.

Vývojová prostředí (IDE)

2012-08-02T10:20:54Z

Jeffraska:

=V čem vyvíjíme a proč?=
Část vývojářů FreenetISu používá Eclipse, část Netbeans.

Důvody pro Eclipse:
*Výborný debugger
*Dobrý napovídač kódu
*Pluginy pro SVN i GIT
Ve srovnání s Netbeans má Eclipse tyto výhody:
*lepší odezvy
*menší zátěž CPU
*menší spotřeba paměti

Důvody pro Netbeans:
*Když nemáte rádi Eclipse :-)

=Eclipse=
Momentálně používáme Eclipse 3.5 (Galileo).
Eclipse 3.6 (Helios) má totiž nějakou závadu v napovídači - místo souborové databáze nově používá nějakou Java DB, která způsobuje při psaní kódu velkou zátěž CPU a nepříjemné prodlevy po napsání každého slova/písmena.

==Integrace SVN==
Je možné použít Subclipse i Subversive.
Subversive má funkční graf revizí a hlavně editor rozdílů pro řešení konfliktů, což se mi se Subclipse nepodařilo zprovoznit.

Install/Update site pro Subversive v Eclipse 3.5 je zde:
http://download.eclipse.org/technology/subversive/0.7/update-site/
SVN connectors pro tuto verzi Subversive jsou zde:
http://community.polarion.com/projects/subversive/download/eclipse/archive/I20091009-1900/

=Netbeans=

Často kladené dotazy

2012-08-02T10:20:12Z

Jeffraska:

==Po přihlášení jsem přihlášený, ale nemám žádná práva.==
Ověřte, zda se vaše databáze jmenuje freenetis. Přejmenujte ji a mělo by to fungovat.

==Zobrazí se mi zpráva, že selhal upgrade databáze.==
Příčin může být několik, ale podívejte se do souboru application/upgrade_sql/upgrade_sql.php a zjistěte číslo vaší SVN verze. V phpmyadminovi upravte hodnotu db_schema_revision v tabulce config na hodnotu získanou ze souboru. Zároveň se vyplatí kontrolovat jestli selhaný dotaz již byl proveden v databázi. Typicky tato chyba někdy vzniká v situaci, že se systém pokouší udělat nějaký upgrade víckrát, ale povyšovací dotaz je možné provést jen jednou, takže napodruhé to vyhazuje chybu.

==Prováděl jsem import databáze a zobrazí se neznámá chyba ve formátu frameworku Kohana.==
Ověřte, zda se celý import provedl správně. Import neprovádějte přes phpmyadmin, vzhledem k omezení PHP se nemusí dokončit celý. Použijte import přes konzoli, návod je na této wiki. Pravděpodobnou příčinou mohl být fakt, že se nestihly vytvořit všechny tabulky databáze.

==Během práce na vývoji smažu starou DB, provedu import a systém mi na cokoli hlásí, že nemám práva.==
V prohlížeči je stále aktivní sezení (session) pod starým uživatelem, který již v nové databázi nemusí být přítomen, nebo v ní má jiné heslo. Stačí restartovat prohlížeč.

==Po posledním svn updatu je ve výpisu členů jejich stav kreditu na nule. ==
Ve FreenetISu se původně všechny zůstatky vždy počítaly z převodů daného účtu. Tato operace je drahá, proto je nově zůstatek přímo ukládán u účtu. Pro výpočet zůstatků na účtech z převodů použijte tlačítko pro přepočet zůstatků na účtech v sekci Finance->Podvojné účty->Účetní osnova. Výsledkem je vyšší rychlost některých systémových operací, která je poznat při větším množství ukládaných dat.

Mazání člena

2012-08-02T10:19:53Z

Jeffraska:

== Motivace ==

Jednou za čas je potřeba smazat některého člena, který buď nebyl vůbec nikdy připojený nebo nikdy sdružení nic nezaplatil, takže není potřeba jej mít v evidenci jako člena.

== Varování ==

Důrazně upozorňujeme, že pokud nevíte, co přesně děláte, můžete si svou neopatrností či chybou nevratně smazat data z databáze! Takže jakékoli mazání přímo na databázi mimo rozhraní FreenetISu je plně ve vaší zodpovědnosti.

== Postup ==

FreenetIS sám o sobě takové smazání jedním kliknutím (zatím) neumožňuje. Jediným řešením je pak odstranění odpovídajících záznamů přímo v databázi, ideálně skrz '''phpMyAdmin'''.

Některé záznamy (například zařízení toho člena, jeho neschválené práce, atd.) lze smazat přímo ve FreenetISu.

Smazat '''ručně''' bude třeba:

* '''člena''' - záznam z tabulky '''members''' s odpovídajícím ID (zapamatujeme si hodnotu address_point_id = hodnotu ID jeho adresného bodu)

* '''hlavního uživatele''' - záznam z tabulky '''users''' s hodnotou sloupce member_id rovnajícího se odpovídajícímu ID člena, a také je třeba smazat další případné uživatele mazaného člena

* '''práva''' - záznamy z tabulky '''groups_aro_map''' s hodnotou sloupce aro_id rovnající se ID mazaných uživatelů

* '''kreditní účet''' - záznam z tabulky '''accounts''' s hodnotou sloupce member_id rovnajícího se odpovídajícímu ID člena (zapamatuje si ID tohoto účtu, viz následující)

* '''převody''' - záznam z tabulky '''transfers''' s hodnotou sloupce origin_id nebo destination_id rovnajícího se odpovídajícímu ID účtu člena (viz předchozí)

* '''adresní bod člena''' (pokud byl jediný komu patřil) - záznam z tabulky '''address_points''' s hodnotou ID rovnající se address_point_id z tabulky members

== SQL dotaz ==

TODO: Dopsat jediný SQL dotaz, který toto všechno udělá za vás...

Pošta

2012-08-02T10:19:34Z

Jeffraska:

Modul pošta slouží ke komunikaci členů skrze FreenetIS. S jeho pomocí lze poslat zprávu jakémukoliv členovi (nebo uživatelovi).

= Uživatelský pohled =

== Vzhled ==

Skládá se ze 3 základních částí:

=== Doručená pošta ===

Zobrazuje doručenou počtu uživatele řazenou chronologicky od nejnovější zprávy po tu nejstarší.

Mimo to obsahuje jednoduché ovládání zpráv - je možné je hromadně mazat nebo je hromadně označovat jako přečtené nebo nepřečtené.

Je to vstupní část - dá se sem vstoupit přes kliknutí na obálku v horní části stránky nebo kliknutím na Moje pošta v menu Můj profil.

=== Odeslaná pošta ===

Zobrazuje všechny odeslané zprávy uživatele řazené chronologicky od nejnovější zprávy po tu nejstarší.

Mimo to obsahuje jednoduché ovládání zpráv - je možné je hromadně mazat.

=== Napsat novou zprávu ===

Obsahuje formulář pro napsání nové zprávy. Obsahuje 3 pole:

'''Komu''' - textové pole, musí obsahovat login příjemce; nebo loginy příjemců (oddělené čárkou) TODO: Dodělat nějaké klikátko, kde si člověk bude moct naklikat příjemce.

'''Předmět''' - textové pole předmět zprávy

'''Text''' - samotný text zprávy, ve formě WYSIWYG editoru

Kromě psání nových zpráv se tento formulář používá pro psání odpovědí (automaticky do formuláře doplní login původního odesílatele/příjemce a cituje text původní zprávy).

== Signalizace ==

Na novou doručenou poštu je uživatel upozorněn změnou barvy obálky v horní části stránky (z bílé na zelenou).
[[Soubor:Nova_posta.jpg]]

== Systémové použití ==

Jedním ze základním důvodů, proč zavést poštu do FreenetISu, byla potřeba vytvořit způsob, jakým bude systém upozorňovat na některé události. V praxi to funguje tak, že uživatelovi přijde zpráva od uživatele s ID 1 (freenetis).

Příklady - uživatel upozorněn, když:

- někdo jiný přidal/editoval/smazal jeho práci
- pokud někdo přidal/editoval/smazal práci (může-li hlasovat)
- pokud někdo přidal/editoval/smazal hlas k práci (je-li jeho nebo může-li hlasovat)
- pokud byla práce schválena/zamítnuta (je-li jeho nebo může-li hlasovat)
- atd.

Systém se samozřejmě snaží inteligentně a neposílat zprávu v případech, kdy uzná, že to není nutné. Příklad - nepošle uživatelovi zprávu, přidal-li si práci sám, atd.

= Programátorský pohled =

== Databázový popis ==

Všechny zprávy pošty jsou uloženy v tabulce mail_messages. Ta obsahuje sloupce:

'''id''' - jednoznačný identifikátor zprávy (primární klíč)

'''from_id''' - ID uživatele-odesílatele

'''to_id''' - ID uživatele-příjemce

'''subject''' - předmět zprávy

'''body''' - text zprávy

'''time''' - čas odeslání

'''readed''' - příznak, zda-li byla zpráva přečtená

'''from_deleted''' - odesílatel tuto zprvu smazal

'''to_deleted''' - příjemce tuto zprávu smazal

== Mazání zpráv ==

Protože je každá zpráva pro dvě strany, neprobíhá její mazání jako obvykle. Kdyby totiž uživatel A poslal zprávu uživateli B a poté A zprávu smazal ze svých odeslaných zpráv, zpráva by zmizela i B z jeho doručených.

Z toho důvodu musely být zavedeny sloupce from_deleted a to_deleted. Ty pak popisují, jestli příjemce/odesílatel smazal tuto zprávu. Teprve až v případě, že oba budou pravdivé, dojde ke skutečné smazání zprávy z databáze.

VoIP

2012-08-02T10:18:44Z

Jeffraska:

FreenetIS umožňuje spravovat VoIP účty. Systém lze napojit na asterisk (popř. na [http://www.iptel.org/ser/ SER] a jeho deriváty) a dále na billing.

==Obecné informace==
V systému FreenetIS si může každý uživatel zaregistrovat právě jedno číslo. Pokud je potřeba další účet je třeba zaregistrovat dalšího uživatele. Uživatel si v prostředí FreenetISu může změnit údaje o VoIP ůčtu jako heslo a nastavení hlasové schránky. Pokud je aktivní modul billingu je možné zobrazit i výpis hovorů popřípadě dobíjet kredit.

==Nastavení==
Pro správnou funkci VoIP je potřeba v nastavení FreenetISu nastavit rozsah čísel, které si můžou uživatelé registrovat. Dále je možné nastavit sip proxy, která se bude zobrazovat v uživatelském účtu VoIP. Pokud nějaké z rozsahu čísel nemá být nabízeno k registraci je potřeba jej definovat ve vynechaných čísel.

==Integrace s asteriskem==

Nainstalujeme potřebné balíky(Debian a jeho derivace).

apt-get install mysql asterisk asterisk-mysql

Pro integraci s asteriskem je potřeba vytvořit pohled do tabulky voip_sips:

Nejdříve je potřeba vytvořit databázi pro asterisk:

mysql> create database asterisk;

A pak samotné view do databáze FreenetISu:

CREATE ALGORITHM=UNDEFINED DEFINER=`root`@`localhost` SQL SECURITY DEFINER VIEW `asterisk`.`sip` AS select `freenetis`.`voip_sips`.`id` AS `id`,
`freenetis`.`voip_sips`.`name` AS `name`,
`freenetis`.`voip_sips`.`amaflags` AS `amaflags`,
`freenetis`.`voip_sips`.`accountcode` AS `accountcode`,
`freenetis`.`voip_sips`.`callgroup` AS `callgroup`,
`freenetis`.`voip_sips`.`callerid` AS `callerid`,
`freenetis`.`voip_sips`.`canreinvite` AS `canreinvite`,
`freenetis`.`voip_sips`.`context` AS `context`,
`freenetis`.`voip_sips`.`defaultip` AS `defaultip`,
`freenetis`.`voip_sips`.`dtmfmode` AS `dtmfmode`,
`freenetis`.`voip_sips`.`fromuser` AS `fromuser`,
`freenetis`.`voip_sips`.`fromdomain` AS `fromdomain`,
`freenetis`.`voip_sips`.`fullcontact` AS `fullcontact`,
`freenetis`.`voip_sips`.`host` AS `host`,
`freenetis`.`voip_sips`.`insecure` AS `insecure`,
`freenetis`.`voip_sips`.`language` AS `language`,
`freenetis`.`voip_sips`.`mailbox` AS `mailbox`,
`freenetis`.`voip_sips`.`md5secret` AS `md5secret`,
`freenetis`.`voip_sips`.`nat` AS `nat`,
`freenetis`.`voip_sips`.`deny` AS `deny`,
`freenetis`.`voip_sips`.`permit` AS `permit`,
`freenetis`.`voip_sips`.`mask` AS `mask`,
`freenetis`.`voip_sips`.`pickupgroup` AS `pickupgroup`,
`freenetis`.`voip_sips`.`port` AS `port`,
`freenetis`.`voip_sips`.`qualify` AS `qualify`,
`freenetis`.`voip_sips`.`restrictcid` AS `restrictcid`,
`freenetis`.`voip_sips`.`rtptimeout` AS `rtptimeout`,
`freenetis`.`voip_sips`.`rtpholdtimeout` AS `rtpholdtimeout`,
`freenetis`.`voip_sips`.`secret` AS `secret`,
`freenetis`.`voip_sips`.`type` AS `type`,
`freenetis`.`voip_sips`.`username` AS `username`,
`freenetis`.`voip_sips`.`disallow` AS `disallow`,
`freenetis`.`voip_sips`.`allow` AS `allow`,
`freenetis`.`voip_sips`.`musiconhold` AS `musiconhold`,
`freenetis`.`voip_sips`.`regseconds` AS `regseconds`,
`freenetis`.`voip_sips`.`ipaddr` AS `ipaddr`,
`freenetis`.`voip_sips`.`regexten` AS `regexten`,
`freenetis`.`voip_sips`.`cancallforward` AS `cancallforward`,
`freenetis`.`voip_sips`.`setvar` AS `setvar`,
`freenetis`.`voip_sips`.`auth` AS `auth` from `freenetis`.`voip_sips`;

Dále vytvoříme view pro hlasovou schánku:

CREATE ALGORITHM=UNDEFINED DEFINER=`root`@`localhost` SQL SECURITY DEFINER VIEW `asterisk`.`voicemail_users` AS select `freenetis`.`voip_voicemail_users`.`id` AS `uniqueid`,
`freenetis`.`voip_voicemail_users`.`customer_id` AS `customer_id`,
`freenetis`.`voip_voicemail_users`.`context` AS `context`,
`freenetis`.`voip_voicemail_users`.`mailbox` AS `mailbox`,
`freenetis`.`voip_voicemail_users`.`password` AS `password`,
`freenetis`.`voip_voicemail_users`.`fullname` AS `fullname`,
`freenetis`.`voip_voicemail_users`.`email` AS `email`,
`freenetis`.`voip_voicemail_users`.`pager` AS `pager`,
`freenetis`.`voip_voicemail_users`.`stamp` AS `stamp` from
`freenetis`.`voip_voicemail_users` where (`freenetis`.`voip_voicemail_users`.`active` = _utf8'1');

=== Konfigurace MySQL ===

Asterisk umí přistupovat přímo k mysq.

V '''/etc/asterisk/res_mysql.conf''' přidáme

[general]
dbhost = localhost
dbname = asterisk
dbuser = username
dbpass = password
dbport = 3306
dbsock = /var/run/mysqld/mysqld.sock

=== Konfigurace Asterisku ===

Všechny soubory jsou v /etc/asterisk/

V '''extconfig.conf''' řekneme, že některé věci se čtou z DB - mělo by tam být
<pre>
sippeers => mysql,asterisk,sip
voicemail => mysql,asterisk,voicemail_users
;extensions => mysql,asterisk,extensions - zatím neimplementováno ve FreentISu!!!
</pre>

Pro otestování připojení k MySql se připojíme ke konzoli

asterisk -rvvv

a spustime <b>realtime mysql status</b>

sip*CLI> realtime mysql status
Connected to asterisk@localhost, port 3306 with username asterisk for 4 seconds.

Tím máme funkčnost spojení otestovanou.

V tento okamžik je asterisk integrován s FreentISem a po přidání VoIP účtu ve FreenetISu by mělo být možné se přihlásit k ústředně pomocí SW nebo HW klienta. Status přihlášení lze sledovat ve FreenetISu v nastavení VoIP učtu

Dále už nastavení asterisku záleží na požadavcích uživatele. Vzorová konfigucace pro prunk od NFX s.z.p.o.:

[general]
static=yes
writeprotect=no
userscontext=default

[default]
;defaultni kontext, spada sem vse co neni v jinem kontextu
exten => s,1,Answer()
exten => s,n,Wait(2)
exten => s,n,Playback(slfree-volane-cislo-neexistuje)
exten => s,n,Hangup()

[internal]
;defaultni kontext pro nase cisla

;pokud volame 11 jdeme do vlastni hlasove shranky
exten => 11,1,Goto(mailbox,s,1)

;pokud volame tisnove linky skaceme do kontextu emergency
exten => 112,1,Goto(emergency,${EXTEN},1)
exten => 150,1,Goto(emergency,${EXTEN},1)
exten => 155,1,Goto(emergency,${EXTEN},1)
exten => 158,1,Goto(emergency,${EXTEN},1)

;konverze dlouhych cisel na kratka - jen pro CR
exten => _00420XXXXXXXXX,1,Goto(internal,${EXTEN:5},1)

;hovor je do slfree, prozkoumame kontext slfree
exten => _951020XXX,1,Goto(slfree,${EXTEN},1)

;hovor je do CR, prozkoumame kontext outgoing-nfx
exten => _XXXXXXXXX,1,Goto(outgoing-nfx,00420${EXTEN},1)

;hovor je do sveta, prozkoumame kontext outgoing-nfx
exten => _XXXXXXXXXXXXXX,1,Goto(outgoing-nfx,${EXTEN},1)

;jinak nezname cislo
exten => _X.,1,Goto(default,s,1)

;vse jde na ustrednu do nfx
[outgoing-nfx]
exten => _XXXXXXXXXXXXXX,1,Set(CALLERID(num)=00420${CALLERID(num)})
exten => _XXXXXXXXXXXXXX,n,Dial(SIP/nfx/${EXTEN})
exten => _XXXXXXXXXXXXXX,n,Hangup

[incomming-nfx]
;konverze dlouhych cisel na kratka
exten => _00420XXXXXXXXX,1,Goto(incomming-nfx,${EXTEN:5},1)

;hovor je do slfree, prozkoumame kontext [slfree]
exten => _951020XXX,1,Goto(slfree,${EXTEN},1)

;jinak nezname cislo
exten => _X.,1,Goto(default,s,1)

[slfree]
;kontext pro cisla z slfree, data bereme z db

exten => _951020XXX,1,Macro(safedial,SIP/${EXTEN},30)

;Realtime integrace zatím není ve FreenetISu implementována!!!
;switch => Realtime

Nakonec nastavíme trunk pro odchozí hovory.

[nfx]
type=peer
host=sip.nfx.czf
qualify=no
language=cz
insecure=port,invite
fromdomain=******
canreinvite=no
context=incomming-nfx
nat=no

Tro jiné trunky (např trunk od Havel nebo 802.cz) je potřeba vlastní řešení...

==Billing API==

Billing zapišťuje dobíjení kreditu, tarifikaci hovorů, výpis hovorů aj. Do FreenetISu bylo zaintegrováno LBilling API. LBilling API bylo vyvynuto pro potřeby NFX s.z.p.o. a jeho specifinace je dostupná na interních stránkách NFX. Samotný billing byl ale navržen tak, aby byl univerzální a pouze se měnil ovladač billungu.

Aktuálně je implementován pouze driver pro Lbilling API NFX. Další API lze dle potřeby doprogramovat.

Nastavení

2012-08-02T10:17:11Z

Jeffraska:

Jako každý jiný informační systém i FreenetIS musí mít možnost různých nastavení, jak uživatelských, tak i systémových. V současné době se o to starají dvě knihovny:

application/libraries/settings.php (pro nastavení skrze databázi)
system/core/config.php (pro nastavení skrze konfigurační soubor)

= Původní stav =

V původním stavu framework Kohana podporoval pouze nastavení přes konfigurační soubory, žádné nastavení přes databázi neexistovaly. Z toho plyne, že v systému nešly vytvářet formulář pro nastavení - ty by pak totiž musely tyto soubory přegenerovávat => velké bezpečnostní riziko.

= Současný stav =

Takřka veškerá nastavení byla přesunuta do databáze, v konfiguračním souboru zůstaly pouze přístupové údaje k databázi.

= Samotná implementace =

== Knihovna Settings ==

Všechna nastavení se ukládají do databázové tabulky Config.

=== Proměnné ===

====contact====

====currency====

- měna, které se bude používat v systému

- nastavuje se v Nastavení - Systém - Měna

- '''výchozí hodnota''': CZK

====db_schema_version====

- zřejmě nejdůležitější proměnná - určuje aktuální revizi databázového schématu, používá se pří [[Autoupdate DB struktury]]

- '''nelze nastavit uživatelem v systému, určuje se sama'''

====debtor====
====default_country====
- základní země užívaná v systému (id z tabulky countries)

- '''výchozí hodnota''': 55 (Czech Republic)
====domain====

- doména, na kterém poběží FreenetIS

- pokud je vaše adresa FreenetISu <nowiki>http://www.mojedomena.cz/freenetis/</nowiki>, bude tato proměnná <nowiki>www.mojedomena.cz</nowiki>

- '''výchozí hodnota''': prázdná (pro vytvoření URL se pak používá server::http_host())

====email_default_email====

- výchozí e-mail - na všech e-mailech odeslaných z FreenetISu bude jako odesílatel uvedena tato adresa

- nastavuje se v Nastavení - Systém - Výchozí e-mail

- '''výchozí hodnota''': no-reply@freenetis.org

====email_driver====

- ovladač posílání e-mailu - způsob, jakým se budou odesílat e-maily

- možné možnosti - nativní (pomocí funkce php mail), SMTP a Sendmail

- nastavuje se v Nastavení - E-mail - Ovladač

- '''výchozí hodnota''': nativní

====email_hostname====

- hostitel SMTP serveru

- bere se v potaz, pouze pokud je email_driver nastaven na SMTP

- nastavuje se v Nastavení - E-mail - Název hostitele

- '''výchozí hodnota''': prázdná

====email_port====

- port SMTP serveru

- bere se v potaz, pouze pokud je email_driver nastaven na SMTP

- nastavuje se v Nastavení - E-mail - Port

- '''výchozí hodnota''': 25

====email_password====

- heslo pro přístup na hostitele SMTP serveru

- bere se v potaz, pouze pokud je email_driver nastaven na SMTP

- nastavuje se v Nastavení - E-mail - Heslo

- '''výchozí hodnota''': prázdná

====email_username====

- uživatelské jméno pro přístup na hostitele SMTP serveru

- bere se v potaz, pouze pokud je email_driver nastaven na SMTP

- nastavuje se v Nastavení - E-mail - Uživatelské jméno

- '''výchozí hodnota''': prázdná

====gateway====

====index_page====

- logická proměnná, zda-se má v URL zobrazovat index.php

- 1 => bude se zobrazovat, 0=> nebude se zobrazit

- nastavuje se v Nastavení - Systém - Čistá URL (přes negaci)

- '''výchozí hodnota''': 1

====info====

====interrupt====

====map_google_maps_api_key====

- klíč pro Google maps API, které se v is využívají.

- '''výchozí hodnota''': prázdná

====optional_message====

====payment_notice====

====protocol====

- protokol, na kterém poběží FreenetIS

- pokud je vaše adresa FreenetISu <nowiki>http://www.mojedomena.cz/freenetis/</nowiki>, bude tato proměnná <nowiki>http</nowiki>

- '''výchozí hodnota''': prázdná (pro vytvoření URL se pak používá hodnota http)

====registration_info====

- informace, které se zobrazí na vyexportované přihlášce na horní části

- '''výchozí hodnota''': prázdná

====registration_license====

- licenční podmínky, které se zobrazí na vyexportované přihlášce na dolní části

- '''výchozí hodnota''': prázdná

====self_registration====

- logické proměnná, zda-li povolit samo-registraci zájemců o členství

- nastavuje se v Nastavení - Systém - Samo-registrace

- '''výchozí hodnota''': 1

====suffix====

- přípona za doménou v URL, na které běží FreenetIS

- pokud je vaše adresa FreenetISu <nowiki>http://www.mojedomena.cz/freenetis/</nowiki>, bude tato proměnná <nowiki>/freenetis/</nowiki>

- vždy musí začínat i končit lomítkem (může být i /)

- '''výchozí hodnota''': prázdná (pro vytvoření URL se pak používá substr(server::script_name(),0,-9))

====title====

- titulek stránky, který se zobrazuje v hlavičce (uvnitř HTML atributu title)

- nastavuje se v Nastavení - Systém - Titulek stránky

- '''výchozí hodnota''': FreenetIS

====unknown_device====

====upload_directory====

- určuje adresář, do kterého se budou nehrávat soubory (importy, atd.)

- '''výchozí hodnota:''' upload

====use_javascript====

- logická proměnná, zda-li je používán javascript

- zastaralé, v budoucnu bude odstraněno

- '''výchozí hodnota''': 1

====voip_billing_driver====
- proměnná obsahuje aktuálně zvolený driver pro VoIP

- momentálně je podporovaný pouze drver pro řešení VOIP od NFX z.s.p.o.

- '''výchozí hodnota:''' 0

====voip_billing_partner====

- proměnná obsahuje uživatelské jméno k přihlášení k billingu

- '''výchozí hodnota:''' prázdná

====voip_billing_password====
- proměnná obsahuje uživatelské heslo k přihlášení k billingu

- '''výchozí hodnota:''' prázdná

====voip_number_exclude====
- proměnná obsahuje devíti-místné čísla oddělená středníkem(;)

- čísla uvedená v tomto seznamu nebudou nabídnuta k výberu pro registraci VoIP účtu

- '''výchozí hodnota:''' prázdná

====voip_number_interval====
- proměnná obsahuje rozsah devítimístných čísel ve tvaru XXXXXXXXX-XXXXXXXXX

- čísla uvedená v tomto seznamu budou nabídnuta k výbeřu pro registraci VoIP ůčtu

- '''výchozí hodnota:''' prázdná

====voip_sip_server====
- proměnná uchovává řetezec s hostname SIP serveru. Např. sip.slfree.czf

- zobrazuje se v nastavení VoIP účtu jako doplňující informace. Nemá vliv na funkci ústředny.

- '''výchozí hodnota''': prázdná

====website_after_redirection====

===Metody===

Celá knihovna obsahuje pouze dvě metody - set a get.

V kontrolerech a v pohledech (ve views) se používá dynamický přístup - v záhlaví hlavního kontroleru se vytvoří instance knihovny:

$this->settings = new Settings();

a pak např. hodnotu proměnné suffix získáme takto:

$this->settings->get('suffix');

V ostatních místech aplikace (helpers, atd.) se pak musí používat statický přístup:

$suffix = Settings::get('suffix');

====get====

- vrací hodnotu podle zadaného klíče

- pokud nalezne neprázdnou hodnotu, vrátí ji

- pokud nalezne prázdnou hodnotu nebo nestane neočekávaná chyba, zkontroluje, zda-li existuje stejnojmenný privátní atribut (tj. defaultní hodnota)

- pokud existuje, vrátí jej

- pokud neexistuje, zkusí vrátit stejnojmennou proměnnou z Configu (z konfiguračního souboru)

====set====

- nastaví proměnnou zadanou pomocí klíče na zadanou hodnotu

- pokud nastane neočekávaná chyba, vrátí neúspěch

- jinak pokud proměnná již v databázi existuje, aktualizuje ji

- pokus proměnná v databázi neexistuje, vytvoří ji

== Knihovna Config ==

Jedná se o nastavení, které se zapisují do konfiguračního souboru config.php.

Jde však pouze o proměnné s údaji pro připojení k databázi.

===Proměnné===

====db_type====

- typ databáze (mysql, pgsql)

- zatím je podporováno pouze mysql

- '''výchozí hodnota''': mysql

====db_name====

- název databáze, na které poběží FreenetIS

- '''výchozí hodnota''': freenetis

====db_host====

- adresa hostitele, na kterém poběží FreenetIS

- '''výchozí hodnota''': localhost

====db_user====

- uživatelské jméno pro připojení k databázi

- '''výchozí hodnota''': freenetis

====db_password====

- uživatelské heslo pro připojení k databázi

- '''výchozí hodnota''': freenetis

====db_table_prefix====

- předpona pro tabulky FreenetISu

- užitečné, pokud chcete používat společnou databázi pro FreenetIS a jiný projekt

- '''výchozí hodnota''': prázdná

===Metody===

Na rozdíl od knihovny Settings se u této knihovny používá pouze statický přístup:

$db_name = Config::get('db_name')

====get====

- vrací hodnotu z konfiguračního souboru podle zadaného klíče

====set====

- nastaví zadanou hodnotu na zadaný klíč

Import a export databáze

2012-08-02T10:15:42Z

Jeffraska:

Při vývoji je často potřeba pracovat s daty ostré databáze. Prázdná databáze po instalaci pro mnoho testování nestačí.

== Import dat do databáze ==

Import SQL souboru s obsahem databáze je možné přes uživatelské rozhraní Phpmyadmina. Velké soubory pak ale často narazí na časový a datový limit PHP. Tyto limity je možné do jisté míry měnit v souboru

/etc/php5/apache2/php.ini

U velkých souborů toto nemusí stačit. Proto je snadné použití příkazové řádky. Stačí mít na počítači nekomprimovaný soubor SQL s daty k importu. Je potřeba mít na cílovém MySQL serveru prázdnou databázi. Pro import pak stačí v konzoli napsat

mysql -u username -p freenetis < freenetis.sql

Po importu databáze je nutné v Phpmyadminovi upravit některé položky v tabulce config. Jde o položky
* protocol (na svém PC pro vývoj používáte typicky http místo https)
* domain (na svém PC pro vývoj máte doménu localhost místo třeba freenetis.sdruzeni.net)
* suffix (přípona za doménou, na serveru je to obvykle pouze /, pro localhost to je obvykle /freenetis/, záleží na vašem nastavení virtualhostu v Apachi)
Jestliže nenaběhne FreenetIS na vaší lokální stránce (typicky localhost/freenetis) kvůli selhání upgradu databáze, pak navštivte v phpmyadminu tabulku config a upravte položku db_schema_version na číslo verze, které najdete v souboru application/upgrade_sql/upgrade_sql.php.
Jestliže přihlašovací stránka naběhne, ale přihlášení selže na neznámé chybě, pak ověřte, jestli se celý import dat provedl správně. V případě větší databáze se import nemusí provést správně a některé tabulky se nestihnou vytvořit, například tabulka users klíčová pro přihlášení. V tomto případě používejte import výhradně přes příkazovou řádku a nikoli přes webové rozhraní phpmyadmina.

=== Tip ===
Po importu pusťte v phpmyadminovi následující SQL dotaz
update users, (select password as newpass from users where login='vaslogin') u set password = u.newpass
Můžete tak snadněji testovat práva, protože takto všem uživatelům nastavíte vaše heslo podle vašeho loginu.

=== Tip ===
Výsledný SQL dotaz po importu databáze s produkčními daty na lokální vývojářský počítač:
update config set value = 'http' where name = 'protocol';
update config set value = 'localhost' where name = 'domain';
update config set value = '/freenetis/' where name = 'suffix';
update users, (select password as newpass from users where login='vaslogin') u set password = u.newpass

== Export dat z databáze ==

V příkazové řádce se pak export databáze do souboru provede obdobně:

mysqldump -u username -p freenetis --routines > freenetis.sql

== Skript All in one ==

Následující skript provádí víceméně vše předchozí automaticky za vás. Stačí jenom správně nastavit proměnné, zajít si na kávu a po návratu je váš lokální počítač připraven.

#!/bin/bash

############################################################################################
# #
# Autor: Michal Kliment #
# Popis: Tento skript umoznuje vyvojarum FreenetISu snadnejsi import databaze z jejich #
# ostre instalace FreenetISu na jejich lokalni pocitac. #
# #
# Datum: 26. 7. 2011 #
# #
############################################################################################

############################################################################################
# N A S T A V E N I L O K A L N I I N S T A L A C E F R E E N E T I S U #
############################################################################################

# Nazev lokalni databaze
LOCAL_DB_NAME="freenetis"
# Uzivatel lokalni databaze
LOCAL_DB_USER="freenetis"
# Heslo k lokalni databazi
LOCAL_DB_PASSWORD="freenetis"

# Protokol lokalniho freenetisu, http nebo htts
PROTOCOL="http"
# Domena lokalniho freenetis, pravdepodobne localhost
DOMAIN="localhost"
# Pripona adresy lokalniho freenetisu, pravdepodobne /freenetis/
SUFFIX="/freenetis/"
# Uzivatel freenetisu, jehoz heslo se nastavi vsem uzivatelum v systemu
USER_LOGIN="admin"

############################################################################################
# N A S T A V E N I "O S T R E" I N S T A L A C E F R E E N E T I S U #
############################################################################################

# Nazev "ostre" databaze
REMOTE_DB_NAME="freenetis"
# Uzivatel "ostre" databaze
REMOTE_DB_USER="freenetis"
# Heslo k "ostre" databazi
REMOTE_DB_PASSWORD="freenetis"

# Uzivatel pro pristup na "ostry" freenetis pres SSH
REMOTE_USER="root"
# Adresa "ostreho" freenetisu pro SSH
REMOTE_HOST="host"

############################################################################################
# S A M O T N Y S K R I P T - N E M E N I T ! #
############################################################################################

echo "Vytvarim zalohu lokalni databaze $LOCAL_DB_NAME..."
mysqldump -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME --routines > freenetis-backup-`date +%Y%m%d%H%M`.sql 2>/dev/null

echo "Odstranuji lokalni databazi $LOCAL_DB_NAME..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD -e "DROP DATABASE $LOCAL_DB_NAME;"

echo "Vytvarim novou prazdnou databazi $LOCAL_DB_NAME..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD -e "CREATE DATABASE $LOCAL_DB_NAME DEFAULT CHARACTER SET utf8 COLLATE utf8_czech_ci;"

echo "Importuji do ni data primo z ostre databaze, tato operace chvili potrva..."
ssh $REMOTE_USER@$REMOTE_HOST "mysqldump -u $REMOTE_DB_USER --password=$REMOTE_DB_PASSWORD $REMOTE_DB_NAME --routines" | mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME

echo "Nastavuji protokol na $PROTOCOL..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME -e "update config set value = '$PROTOCOL' where name = 'protocol';"

echo "Nastavuji domenu na $DOMAIN..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME -e "update config set value = '$DOMAIN' where name = 'domain';"

echo "Nastavuji suffic na $SUFFIX..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME -e "update config set value = '$SUFFIX' where name = 'suffix';"

echo "Nastavuji vsem uzivatelum stejne heslo jako je heslo pro uzivatele $USER_LOGIN..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME -e "update users, (select password as newpass from users where login='$USER_LOGIN') u set password = u.newpass"

echo "Vyprazdnuji e-mailovou frontu..."
mysql -u $LOCAL_DB_USER --password=$LOCAL_DB_PASSWORD $LOCAL_DB_NAME -e "TRUNCATE TABLE email_queues;"

Freenetis

2012-08-02T10:15:02Z

Jeffraska:

#! /bin/bash

### BEGIN INIT INFO
# Provides: freenetis
# Required-Start: $remote_fs
# Required-Stop: $remote_fs
# Should-Start: $network $syslog
# Should-Stop: $network $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start and stop FreenetIS synchronization daemon
# Description: FreenetIS synchronization script.
### END INIT INFO

##################################################################################
# #
# This script serves for redirection ip policy of IS FreenetIS #
# #
# auhtor Sevcik Roman 2011 #
# email sevcik.roman@slfree.net #
# #
# name freenetis #
# version 1.9 #
# #
##################################################################################

#Local variable contains path to iptables - mandatory
IPTABLES=/sbin/iptables

#Load variables from config file
CONFIG=/etc/freenetis.cfg

#Path to pid file
PIDFILE=/var/run/freenetis_synchronization.pid

#Load variables
if [ -f ${CONFIG} ]; then
. $CONFIG;
else
echo "No config file - giving up :-(";
exit 0
fi

# Function returns 1 if is ip valid
# @param ip adresa
# return 1 if is ip valid
valid_ip ()
{
local ip=$1
local stat=1

if [[ $ip =~ ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$ ]]; then
OIFS=$IFS
IFS='.'
ip=($ip)
IFS=$OIFS
[[ ${ip[0]} -le 255 && ${ip[1]} -le 255 && ${ip[2]} -le 255 && ${ip[3]} -le 255 ]]
stat=$?
fi;
return $stat
}

start ()
{
if [ -f ${PIDFILE} ]; then
echo "Already started"
return 1
fi

echo "Adding sets.";

ipset -N whitelist iphash --hashsize 10000 --probes 4 --resize 50
ipset -N allowed iphash --hashsize 10000 --probes 8 --resize 50
ipset -N self_cancel iphash --hashsize 10000 --probes 8 --resize 50
ipset -N seen iphash --hashsize 10000 --probes 8 --resize 50
ipset -N ranges nethash --hashsize 1024 --probes 4 --resize 50

echo "Adding firewall rules.";

#Rule for allowing access. If come packet to $IP_TARGET then we add souce address do set allowed and to set seen
#Set seen is used for ip synchronization with FreenetIS.
$IPTABLES -i $INPUT_INTERFACE -t nat -A PREROUTING -m set --set self_cancel src -d $IP_TARGET -j SET --add-set allowed src
$IPTABLES -i $INPUT_INTERFACE -t nat -A PREROUTING -m set --set self_cancel src -d $IP_TARGET -j SET --add-set seen src

#If is IP in set whitelist or allowed then it is not redirected
$IPTABLES -i $INPUT_INTERFACE -t nat -A PREROUTING -m set --set whitelist src -j ACCEPT
$IPTABLES -i $INPUT_INTERFACE -t nat -A PREROUTING -m set --set allowed src -j ACCEPT

#Redirect everything trafic what has destination port $PORT_WEB to $PORT_REDIRECT
$IPTABLES -i $INPUT_INTERFACE -t nat -A PREROUTING -m set --set ranges src -p tcp --dport $PORT_WEB -j REDIRECT --to-port $PORT_REDIRECT

#If is IP in set whitelist or allowed then it is not redirected
$IPTABLES -i $INPUT_INTERFACE -I FORWARD 1 -m set --set whitelist src -j ACCEPT
$IPTABLES -i $INPUT_INTERFACE -I FORWARD 2 -m set --set allowed src -j ACCEPT

#Else everything drop
$IPTABLES -i $INPUT_INTERFACE -I FORWARD 3 -m set --set ranges src -j DROP

#Run update scritp on background
echo "Starting process."
nohup /usr/local/sbin/freenetis_synchronization.sh > /dev/null 2>&1 &

#Parse PID a save to file
ps -fe | grep freenetis_synchronization.sh | head -n1 | cut -d" " -f 6 > $PIDFILE

return 1
}

stop ()
{
if [ ! -f ${PIDFILE} ]; then
echo "Already stopped."
return 1
fi

#Killing of process by sigterm
echo "Killing process."
cat $PIDFILE | xargs kill

#Detete pid file
rm $PIDFILE

echo "Deleting firewall rules.";

#Rule for allowing access. If come packet to $IP_TARGET then we add souce address do set allowed and to set seen
#Set seen is used for ip synchronization with FreenetIS.
$IPTABLES -i $INPUT_INTERFACE -t nat -D PREROUTING -m set --set self_cancel src -d $IP_TARGET -j SET --add-set allowed src
$IPTABLES -i $INPUT_INTERFACE -t nat -D PREROUTING -m set --set self_cancel src -d $IP_TARGET -j SET --add-set seen src

#If is IP in set whitelist or allowed then it is not redirected
$IPTABLES -i $INPUT_INTERFACE -t nat -D PREROUTING -m set --set whitelist src -j ACCEPT
$IPTABLES -i $INPUT_INTERFACE -t nat -D PREROUTING -m set --set allowed src -j ACCEPT

#Redirect everything trafic what has destination port $PORT_WEB to $PORT_REDIRECT
$IPTABLES -i $INPUT_INTERFACE -t nat -D PREROUTING -m set --set ranges src -p tcp --dport $PORT_WEB -j REDIRECT --to-port $PORT_REDIRECT

#If is IP in set whitelist or allowed then it is not redirected
$IPTABLES -i $INPUT_INTERFACE -D FORWARD -m set --set whitelist src -j ACCEPT
$IPTABLES -i $INPUT_INTERFACE -D FORWARD -m set --set allowed src -j ACCEPT

#Else everything drop
$IPTABLES -i $INPUT_INTERFACE -D FORWARD -m set --set ranges src -j DROP

echo "Deleting sets.";

ipset -X whitelist
ipset -X allowed
ipset -X self_cancel
ipset -X seen
ipset -X ranges

return 1
}

# Function shows help
help ()
{
echo "usage : (start | stop | restart)"
echo "start - initialization of firewall rules"
echo "stop - clears firewall rules"
echo "restart - restarts firewall rules"
}

# Is parameter #1 zero length?
if [ -z "$1" ]; then
help
exit 1
fi;

case "$1" in
start)

start
exit 1
;;

restart)

stop
start
exit 1
;;

stop)

stop
exit 1
;;

*)

help
exit 1
;;

esac

exit 0

Aplikační heslo

2012-08-02T10:14:06Z

Jeffraska:

Aplikační heslo slouží k připojení k různým službám jako VPN, FTP, atd. Heslo je v databázi uloženo v clear-textu, protože u většiny služeb je podporovaná jen tato možnost.

'''Pozor!''' Heslo nemá nic společného s přístupovým heslem do FreenetISu.

Při vytvoření nového účtu uživatele FreenetIS vygeneruje heslo náhodně a je možné si jej změnit.

Změna hesla:
* Přihlásíme se do frenetisu pod uživatelem pro kterého chceme heslo změnit (pravděpodobně jako hlavní uživatel člena).
* Vybereme uživatele.
* Vybereme odkaz <i>Změnit aplikační heslo</i> a klikneme na něj.
* Změníme heslo.

Co je třeba udělat po instalaci

2012-08-02T10:13:46Z

Jeffraska:

Předpokládám, že máte úspěšně nainstalovaný FreenetIS a správně jste vyplnili instalační formulář. Většina těchto údajů lze pak změnit v systému, případně ručně změnit v databázi (pokud přesně víte, co děláte). Po instalaci, když jste přihlášený jako admin, tak nevidíte některé funkce, protože první člen je speciální a některé funkce mu logicky nejsou dostupné jako ostatním členům. První člen představuje sdružení samotné, takže mimo počáteční konfigurace by už nikdo neměl používat přihlašování jako admin. Snažíme se psát i vnitřní programovou nápovědu, která se snaží vysvětlit některé funkce nebo koncepty. Tato nápověda je znázorněna malým otazníčkem v modrém kolečku a zobrazí se po najetí myší na ni.

'''Poslední aktualizace únor 2011'''

== Adresní body ==
FreenetIS používá systém adresních bodů. Text, co tu byl dříve a tvrdil, že je nutné nejprve dostat do systému města a ulice už neplatí. Zapracovali jsme na uživatelském rozhraní, takže nové ulice a města lze přidávat během přidávání nových členů i zařízení. Slouží k tomu zelené tlačítko plus.

== Poplatky ==
Pro správný chod systému je potřeba mít vyplněny všechny typy základních poplatků. Věnovali jsme práci tarifům, což je možnost mít různé výše členských příspěvků pro každého člena. Výchozí tarify pro členské příspěvky se ovládají pomocí tarifů člena s ID 1, který reprezentuje sdružení samotné.

== Segmenty a podsítě ==
Opět dříve tu bylo nutné mít dopředu uložené v systému segmenty a podsítě pro přidávání zařízení. Toto teď není nutné, díky lepšímu uživatelskému rozhraní je možné přidávat nové segmenty a podsítě během přidávání rozhraní, IP adres nebo zařízení.

== Zařízení v majetku sdružení ==
Zařízeními v majetku sdružení jsou myšleny všechny aktivní síťové prvky, které vlastní sdružení, jde o přístupové body, routery, switche, servery atd.
Je dobré je mít evidovány před přidáváním zařízení samotných členů. Jedno zařízení může mít více rozhraní, jedno rozhraní může mít více IP adres, toto je výhodné například u AP nebo routerů. Domácí počítače mají obvykle jedno rozhraní a jednu IP adresu.

== Členové ==
Nyní můžete začít přidávat členy. Člen s ID 1 vytvořený po instalaci je speciální, nemá svůj kreditní účet, ale vlastní zbytek účtů, jeho tarify jsou výchozí pro ostatní členy. Tento člen reprezentuje vaše sdružení v systému. Při reálném běhu systému, by žádný uživatel neměl využívat jeho uživatele admin, ale měl by každý správce, technik, člen správní rady, administrátor vystupovat za sebe.

== Zařízení členů ==
Po přidání člena je třeba také uložit jeho zařízení - obvykle krabičku a jeden nebo více PC. Pravděpodobně využijete nejčastěji využijete volbu "Přidat celé zařízení", což znamená vytvoření jednoho zařízení, se jedním rozhraním (MAC adresa) a jednou IP adresou.

== Uživatelé ==
Přidávání nových uživatelů obvykle není nutné. S novým členem je vytvářen vždy jeden uživatel, což většinou stačí.

== Finance ==
Jakmile máte zaevidovány všechny členy, tak je možné provést import bankovních výpisů. Zatím jsou podporovány jen HTML výpisy od Raiffeissenbank. Pak můžete začít přiřazovat některé neidentifikované platby. Jakmile uznáte za vhodné, začněte strhávat členům z jejich kreditních účtu kredit. Tím by jste měli snadno odhalit dlužníky. Strhávání členských příspěvků se dělá každý měsíc v půlce měsíce. Takže bude nutné to takto udělat od začátku fungování sdružení po současnost a pak už jen každý měsíc. Nejvhodnější je 16. den v měsíci. Stržením pak docílíte toho, že u každého člena budete vědět stav jeho kreditu, zda-li má zaplaceno dopředu, nebo dluží.

== Přesměrování ==
Jakmile máte kompletně zaevidovanou vaši síť, zaevidované všechny členy, naimportované platby, tak můžete začít s přesměrováním. Samotným zapnutím přesměrování na dané podsíti zjistíte všechny neidentifikované nebo načerno připojené lidi. Zapnutí na dané podsíti znamená, že tuto podsíť začne centrální brána filtrovat. Jakmile tedy bude v této podsíti IP adresa, která bude chtít do internetu a nebude v databázi, bude zablokována (přesměrována). Pak můžete začít aktivovat přesměrování pro dlužníky, nebo i další lidi, když je chcete o něčem informovat.

Přesměrování

2012-08-02T10:13:21Z

Jeffraska:

== Ú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ý.

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

Import dat z banky

2012-08-02T10:11:10Z

Jeffraska:

=Import výpisů z eBanky=

==Spojování více (netransparentních) výpisů do jednoho==
V systému eBanky si můžete nechat vyhotovit výpisy pro zadané období. Při volbě délky období uvažujete takto:
* Čím kratší období bude, tím častěji budete muset výpisý do FreenetIS-u importovat
* Čím delší období bude, tím déle budou muset uživatelé čekat na připsání kreditu do FreenetISu

Pokud po instalaci FreenetISu potřebujete naimportovat mnoho (např. několik desítek) netransparentních výpisů najednou, pak můžete klikat po jednom, nebo můžete využít skript pro command-line php, který všechny výpisy spojí do jediného velkého souboru:

<?php
$stderr=fopen("php://stderr", "r");
$first=true;
$file_cnt=0;
foreach ($_SERVER["argv"] as $argc=>$argv)
if ($argc>0 && file_exists($argv) && is_file($argv)) {
$file_cnt++;
fprintf($stderr, "Zpracovávám: $argv\n");
$str=file_get_contents($argv, "r");
$start=stripos($str, "Pohyby na");
$table_start=stripos($str, "<table", $start);
$first_row_start=stripos($str, "<tr",$table_start+6);
$second_row_start=stripos($str, "<tr",$first_row_start+3);
if ($first) // je to první soubor?
echo substr($str, 0, $second_row_start); // vytiskni i jeho hlavičku
$first=false;
}
$last_row_end=stripos($str, "</table", $second_row_start);
echo substr($str, $second_row_start, $last_row_end-$second_row_start-8);
}
echo substr($str, $last_row_end); // u posledního souboru vytiskni i konec
fprintf($stderr, "\nZpracováno $file_cnt souborů\n");
?>
Skript uložte do souboru např. "radky.php" a následně spusťte příkazem:
php radky.php *.htm > vysledek.html

Synchronizace FreeNetIS - Mikrotik

2012-08-02T10:10:44Z

Jeffraska:

Nejdříve na úvod mírně vysvětlím, proč vůbec nějaký takový skript vzniknul. V době psaní toho textu se naše sdružení Slfree potýkalo s velkým problémem - databáze všech zařízení ve FreenetISu takřka skoro vůbec neodpovídala stavu na samotných routerech (v té době výlučně s OS RouterOS od Mikrotik) a po spuštění [[Přesměrování]] by tato entropie napáchala nakonec více škody než užitku. Ve volném čase jsem si tedy zkusil napsat jednoduchý parser exportu IP adres z dhcp-serveru z Mikrotiků a ten jsem pak použil při psaní skriptu, který naparserované informace z nich synchronizuje s db FreenetISu.

== Indetifikace majitelů adres ==

Největší problémem bylo, jakým způsobem dosáhnout jednoznačné přiřezaní položek (leases) k majitelům (členům). Nakonec bylo rozhodnuto, že komentář každé položky bude zapsán ve tvaru '''ID 1 - Novák Jan''' (kde 1 je ID člena Jana Nováka) a synchroniční skript podle něho určí ke kterému členovi určitou IP adresu přiřadí.

== Získání exportu ==

Nejdříve se přihlásíme na některé APčko přes ssh:

[user@pc ~]$ ssh user@10.143.10.1
user@10.143.10.1's password:

MMM MMM KKK TTTTTTTTTTT KKK
MMMM MMMM KKK TTTTTTTTTTT KKK
MMM MMMM MMM III KKK KKK RRRRRR OOOOOO TTT III KKK KKK
MMM MM MMM III KKKKK RRR RRR OOO OOO TTT III KKKKK
MMM MMM III KKK KKK RRRRRR OOO OOO TTT III KKK KKK
MMM MMM III KKK KKK RRR RRR OOOOOO TTT III KKK KKK

MikroTik RouterOS 3.7 (c) 1999-2008 http://www.mikrotik.com/

[user@slfree_vlara] >

Vytvoříme export jménem vlara:

[user@slfree_vlara] > /ip dhcp-server lease export file=vlara

Stáhnout si ho nyní můžeme na adrese ftp://user@10.143.10.1/vlara.rsc

== Spuštění skriptu ==

V sekci Zařízení je odkaz Import exportu DHCP z Mikrotiku. Po kliknutí na něj se nám otevře formulář, pomocí něhož nahrajeme náš export do FreenetISu a po jehož odeslání se spustí nejdůležitější synchronizační skript.

== Synchronizační skript ==

Podrobný popis chování - pro lepší přehlednost: data z Mikrotiků jsou označeny jako '''M''', data z FreenetISu jsou označeny jako '''F'''.

Skript je ve skutečnosti callbacková funkce parseru, takže se spustí po každém naparserování jedné položky. Nejdříve identifikuje člena, kterému položka patří a jeho hlavního uživatele. Pak se v databázi IP adres pokusí zjistit, zda IP adresa již v databázi je.

a) pokud existuje - v případě, že zařízení není přiřazeno k žádnému rozhraní => vytvoří pro něj nové zařízení (patřícími uživatelovi, se stejným adresním bodem jako on) a rozhraní a IP adresu k němu přiřadí; v případě nestejnosti původní MAC adresu v db a MAC adresy z Mikrotiku přepíše první tou druhou; v případě, že se majitelé IP adresy v F a v M liší, nastaví majitelem toho z M

b) pokud neexistuje - nejdříve testuje zda-li existuje zadaná MAC adresa z M:

I) pokud existuje - najde všechny IP adresy patřící k rozhraní této MAC adresy, 1 -> použije ji, více -> použije první, žádná -> vytvoří novou => IP adresu z M sem uloží; opět v případě, že se majitelé MAC adresy v F a v M liší, nastaví majitelem toho z M

II) pokud neexistuje - vytvoří úplně nové zařízení, s novým rozhraním a novou IP adresou, patřící majiteli z M

'''Problém "FreenetIS bug jak prase"'''

Skript počítá se stěhováním členů - pokud MAC adresa existuje, pouze změní IP adresu, segmenty, subnety, atd. Jedná se ale o dvojsečnou zbraň - pokud má člen (většinou technik sdružení) stejnou MAC adresu na více APčkách (např. NB použitý při zapojování) a tato IP adresa je "oIDečkována", je reálná možnost, že při spuštění skriptu mu to povolí NB na druhé straně sítě, ale doma bude přesměrováný (viz. Tomáš Dulík :-)).
TODO: Opravit? Jak?

Správcovská příručka

2012-08-02T10:09:47Z

Jeffraska:

= Menu Uživatelé =

Obsahuje přehled všech členů a uživatelů systému. Člen může mít více uživatelů. Člen je brán spíše z pohledu peněz a placení členských příspěvků. Uživatelem je myšlen každý, kdo se může přihlásit do systému, například rodinný příslušník. Na uživatele jsou vázána například zařízení a práce. Práva na tuto sekci mají technici, správní rada, revizní komise a administrátoři.

== Členové ==

Zde jsou všichni členové sdružení. Vyhledávat mezi členy můžete pomocí filtrů. Filtrovat zobrazení lze pomocí jména člena (obvykle jméno a příjmení), města, ulice nebo telefonního čísla. Filtry ignorují háčky a čárky a je možné filtrovat jenom podle pár znaků, není třeba psát celé slovo. Je možné řadit záznamy podle sloupce kliknutím na jeho nadpis. Po opětovném kliknutí jsou záznamy řazeny obráceně.
Je zde také důležitá možnost přidání nového člena. Tato akce vytvoří v systému člena, uživatele přiřazeného k tomuto členovi a podvojný kreditní účet pro evidenci převodů peněz tohoto člena.

== Uživatelé ==

Zobrazí všechny uživatele systému FreenetIS. Jeden člen v systému může mít více uživatelů. Podobně jako u členů je zde možnost filtrování. Každý uživatel má své vlastní přihlašovací údaje do systému. Uživatel může mít své práce, zařízení a může být také technikem nebo správcem zařízení.

= Menu Síť =

Plná práva na tuto sekci mají jen certifikovaní technici a administrátoři. Správní rada, revizní komise a necertifikovaní technici mají jen práva prohlížení záznamů.

== Zařízení ==

Zobrazí všechny zařízení uložené v systému. Opět je možné využívat filtrování výpisu. Je zde možnost přidávat nové celé zařízení - vytvoří se tak nové zařízení (název, typ, atd. a vybere se uživatel a technik), vytvoří se pro něj jedno rozhraní (MAC adresa a vybere se segment) a pro toto rozhraní se vytvoří jedna IP adresa (IP adresa a vybere se podsíť). Každé zařízení může obecně mít více rozhraní. Další možnost je přidat zařízení. Ta vytvoří jen nové zařízení, navazující rozhraní nebo porty je potřeba vytvořit zvlášť.

== Segmenty ==

Zobrazí všechny segmenty v síti. Segmenty charakterizují síť z fyzického pohledu. Ukládá se zde technologie (ethernet, wifi, optika, ...), rychlost technologie a duplexnost přenosu. Segmenty jsou důležité pro přidávání nových rozhraní. U každého rozhraní je třeba určit, do kterého segmentu je rozhraní připojeno.

== Rozhraní ==

Zobrazí všechna rozhraní. Každé zařízení může mít více rozhraní. Rozhraní je reprezentováno hlavně MAC adresou a vždy patří do nějakého segmentu. Rozhraní může mít nejvýše jedno bezdrátové nastavení, kde se ukládá typ (AP, klient), norma (802.11a, 802.11b, 802.11g, 802.11n), kanál, frekvence, anténa a polarizace. Rozhraní může mít více VLAN rozhraní a IP adres.

== Porty ==

Zobrazí všechny porty. Každý port patří nějakému zařízení. Portem je myšlen port v síťovém přepínači (switchi). Port vždy patří do nějakého segmentu. Port může patřit do více VLANů, a zároveň VLAN může mít více portů.

== VLAN rozhraní ==

Zobrazí všechna VLAN rozhraní (rozhraní virtuální sítě). VLAN rozhraní patří vždy k nějakému existujícímu rozhraní a VLANu.

VLAN rozhraní se využívají výhradně u routerů v optické síti. Například jeden takový router má jedno rozhraní, ve kterém může být více VLAN rozhraní, které pak mají své IP adresy.

== VLANY ==

Zobrazí všechny VLANy (virtuální sítě). Virtuální sítě se používají u switchů na spojové (linkové) vrstvě a jsou to domény všesměrového vysílání. Virtuální sítě tvoří na portech přepínačů samostatné logické celky. Přepínače používají v rámci virtuální sítě ke komunikaci protokol spojové vrstvy IEEE 802.1q. VLANy se používají pro evidenci struktury optických sítí a týkají se pouze aktivních síťových prvků routerů a switchů.

== VoIP ==

Zobrazí všechny registrované VOIP účty. Každý uživatel může mít registrovaný právě jeden VoIP účet. Více o VoIP a jeho [[Nastavení VoIP - integrace s ústřednou a billingem | nastavení a integraci s asteriskem]].

== IP adresy ==

Zobrazí všechny IP adresy. Každá IP adresa má aspoň jedno rozhraní, případně VLAN rozhraní (pouze v případě, že je to IP adresa routeru na optické síti). IP adresa vždy patří do nějaké existující podsítě.

== Podsítě ==

Zobrazí všechny podsítě. Podsíť je IP adresa s maskou, např. 192.168.0.0/24. Každá IP adresa v systému patří do nějaké podsítě. Podsítě popisují síť z hlediska síťové (třetí) vrstvy.

Uživatelská příručka

2012-08-02T10:09:32Z

Jeffraska:

=== Upozornění ===
Informace zde uvedené mohou být zastaralé. Postupně doplňujeme uživatelskou nápovědu přímo v systému, která je dostupná po najetí myší na modré kolečko s otazníkem. Jestli něčemu v systému nerozumíte, pak je lepší nám napsat a my toto doplníme do systému.

= Přihlášení =

Pro používání informačního systému FreenetIS je třeba se nejprve přihlásit. K tomu je potřeba být zaregistrovaný. Zaregistrovat člena by měl technik při připojování do sítě, případně v budoucnu by měli mít uživatelé možnost registrovat se sami a přes systém žádat o členství. Členové, kteří byli připojeni dříve, než byl FreenetIS spuštěn, by měli obdržet od sdružení své přidělené přihlašovací údaje. Přihlašovacími údaji je myšlen login a heslo (login je přihlašovací jméno, nebo také přezdívka).

= Můj profil =

Profil člen uvidí hned po přihlášení v pravém panelu. Obsahuje kontaktní údaje a také informace o členství. Pokud některé údaje nesouhlasí z různých důvodů, je třeba to ohlásit. Nejlépe zaměstnanci podpory, správci přístupového bodu nebo připojujícímu technikovi. Důležité jsou zejména telefonní číslo a stav kreditu. Podle telefonního čísla systém přiřazuje platby členských příspěvků. Stav kreditu umožňuje členovi si hlídat, do kdy má zaplaceno.

== Moji uživatelé ==

K profilu člena je standardně po registraci vytvořen jeden uživatel systému. Nicméně člen může přidat další uživatele, například další rodinné příslušníky, kteří budou mít do systému přístup. Jednou vytvořený uživatel již nejde smazat, takže je dobré si dávat pozor, ať nejsou další uživatelé přidáváni zbytečně.

== Moje převody ==

Systém plateb ve FreenetISu funguje na základě účtů a převodů. Účty jsou dvojího druhu - bankovní a podvojné. Člen zde vidí převody peněz na svém kreditním (podvojném) účtu. Platba členských příspěvků na bankovní účet je zpracována tak, že nejprve přijde tato platba na bankovní účet sdružení. Pokud je v daném období ve sdružení zaveden poplatek za platbu, pak je stržen z této platby. Podaří-li se tuto platbu správně přiřadit podle variabilního symbolu (telefonního čísla), pak je odeslána z podvojného účtu bankovních plateb sdružení na kreditní účet člena. Tento převod člen vidí jako příchozí. Každý měsíc je pak z kreditního účtu stržen pravidelný členský příspěvek. Tento převod na provozní účet sdružení je vidět jako odchozí platba. Výsledný stav účtu je dán sečtením všech příchozích převodů a odečtením všech odchozích převodů. Pokud je výsledný stav kladný, pak udává, kolik kreditu ještě člen má. Pokud je záporný, tak udává, kolik peněz člen dluží sdružení. Pokud se blíží vyčerpání kreditu, pak je člen upozorněn (buď mailem, nebo přesměrováním). I když je člen v dluhu, nějakou dobu bude upozorňován na zaplacení. Pokud do dané doby nezaplatí, bude trvale přesměrován nebo přímo odpojen.

== Moje zařízení ==

Zde vidí člen všechna svá zařízení, která používá, jako např: domácí router pro příjem (krabička), počítače, notebooky, atd. Pokud zde nejsou vidět, je nutné požadovat nápravu po připojujícím technikovi, který je nezapsal do systému. Každé nové zařízení zapojené do sítě je třeba hlásit. Nové zařízení nebo chybné údaje je třeba hlásit správci přístupového bodu, který je přidá do systému.

== Moje práce ==

Zde má možnost každý uživatel zadávat práce, které udělal pro sdružení. Tyto práce jsou nepotvrzené. Práce musí potvrdit někdo ze správní rady. Uživatel, i když je sám ve Správní radě, nikdy nemůže potvrdit své vlastní práce. Jakmile je práce potvrzena, je vygenerován převod z provozního účtu sdružení na kreditní účet člena. Tímto způsobem by vykazují práce technici, správci, brigádníci, případně jiní nadšenci. Ve výsledku to znamená, že klidně nemusí platit členské příspěvky, záleží na stavu jejich kreditního účtu.

== Moje pracovní výkazy ==

Zde má možnost každý uživatel zadávat pracovní výkazy, které udělal pro sdružení. Tyto práce jsou nepotvrzené. Pracovní výkaz musí být potvrzen někdo ze správní radou. Uživatel, i když je sám ve Správní radě, nikdy nemůže potvrdit své vlastní pracovní výkazy. Jakmile je práce potvrzena a typ platby výkazu je nastaven na '''Platba kreditem do FreeNetISu''', je vygenerován převod z provozního účtu sdružení na kreditní účet člena.

=== Způsob práce s rozhraním pracovních výkazů ===

Rozhraní pracovních výkazů umožňuje ukládat rozpracované (nedokončené) pracovní výkazy takzvané koncepty. Na konceptu můžete pracovat jakkoliv dlouho (je viditelný pouze pro Vás), dokud neuznáte, že je připraven pro schválení což provedete pomocí tlačítka '''Zaslat tento koncept na hlasování o schválení''', které je dostupné na stránce zobrazující daný pracovní výkaz.

Pracovní výkazy se dělí na dva typy. Prvním typem je takzvaný '''Měsíční pracovní výkaz''', který dostává svému názvu a splňuje funkci výkazu pro daný měsíc daného roku. Druhým typem výkazu jsou takzvané '''Shluklé práce''', které umožňují shlukovat práce podobného ražení z různými daty provádění.

== Moje účty za telefon ==

Zobrazuje se pouze pokud jste držitelem telefonu patřícího sdružení. Zobrazuje informace o poskytovaných službách na daný telefon a umožňuje označovat je za soukromé/firemní.

== Moje VoIP hovory ==

Obsahují výpis vašich VoIP hovorů, pokud jste držitelem VoIP telefonu. Dále umožňuje vypočtení ceny hovoru na jakékoliv číslo.

== Moje pošta ==

Zpřístupňuje vnitřní informační poštu systému, kterou můžete být upozorňován na různé aktivity v systému a popřípadě také komunikaci s jiným uživatelem.

== Změnit heslo ==

Objeví se formulář, který umožňuje změnit vaše heslo do systému.

= Odhlášení =

Po ukončení práce v systému je dobrým zvykem se odhlásit. Odhlášení provedete kliknutím na odkaz vpravo nahoře.

Ekonomika

2012-08-02T10:08:45Z

Jeffraska:

= Úvod =
Evidence členských příspěvků je typická úloha pro podvojné účetnictví. Proč?Protože [http://en.wikipedia.org/wiki/Double-entry_bookkeeping_system#Timeline od 12.-13. století, kdy se podvojné účto poprvé objevuje v písemných zmínkách],  ještě nikdo nevymyslel žádný lepší a jednodušší systém vnitřní evidence financí pro jakýkoli subjekt (živnostník, neziskovka, s.r.o nebo univerzita...).

Princip podvojného účetnictví je opravdu triviální: o každé finanční operaci si pořizujete záznam ve tvaru

______________________    částka    ____________________
|zdrojový podvojný účet| ---------->|cílový podvojný účet|
|______________________|            |____________________|

Např. když Franta Šiška pošle sdružení částku 1000 Kč, lze to podvojně zaúčtovat takto:

______________________ 1000 Kč ____________________
| Franta Šiška | ---------->| náš bankovní účet |
|______________________| |____________________|

anebo třeba takto:
______________________    1000 Kč   ____________________
| Členské příspěvky   | ---------->|Kredit Franta Šiška |
|______________________|            |____________________|

Poznámka: k čemu je ve druhém způsobu účet "Členské příspěvky"?

Peníze v podvojném účtu nemůžou přitéct "odnikud", na obou stranách šipky musí být nějaké účty.

Výhoda tohoto je v tom, že když budeme všechny členské příspěvky převádět z jednoho účtu "Členské příspěvky", bude nám okamžitý stav tohoto účtu říkat, kolik členských příspěvků už jsme vybrali. Stav účtu získáme jediným dotazem ve stylu:
SELECT balance FROM accounts WHERE accounts.name="Členské příspěvky".

= DB Schema =
Podvojné účty si můžeme v podvojném účetnictví tvořit dle vlastní libovůle.

Příklad: chceme zjistit, kolik utrácíme za UTP kabely. Vytvoříme si proto účet "UTP kabely" a na něj budeme převádět částku z každého nákupu UTP kabelu.

Ve FreenetISu jsou podvojné účty, které naše organizace používá, uloženy v '''tabulce accounts'''.

Po instalaci FreenetISu tabulka accounts obsahuje jenom cca 5 účtů, ale s postupem času jejich počet roste, protože každý platící člen má automaticky vytvořen "svůj" podvojný účet, na kterém ukládáme jeho kredit.

Ve FreenetISu může člen mít přiřazeny i další podvojné účty - to jsou účty projektů, ale o tom někdy příště.

Převody mezi podvojnými účty jsou v '''tabulce''' '''transfers'''.Její sloupce jsou:
* origin_id, destination_id : id podvojných účtů z tabulky accounts
* previous_transfer_id : používá se u složitějších podvojných transakcí, které se skládají z více podvojných převodů. Např. zaúčtování faktury se standardně dělá 2ma transakcemi. Aby bylo jasné, že tyto 2 transakce "patří k sobě", nastavíme u té druhé previous_transfer_id tak, aby ukazovalo na tu první transakci.
* member_id : u platby příspěvku je zde ID člena, od něhož transakce pochází. Může se zdát, že tento sloupec je zbytečný, protože peníze přece putují na kreditní účet člena a ten má také údaj member_id. Ale držet si member_id i v tabulce transfers je výhodné při více-krokových převodech. Např. zaúčtování platby členského příspěvku v našem sdružení děláme v 5ti podvojných převodech, z nichž jen jeden cílí na kreditní účet člena. My ale chceme jednoduše vidět, že i ty ostatní převody "způsobil" tento daný člen - mohli bychom to sice složitě odvodit přes previous_transfer_id, ale ten dotaz, to by byla šílenost.
* user_id : id uživatele, který podvojný převod vytvořil. Ve FreenetISu můžete právo přístupu k ekonomické části přidělit více lidem, takže je potřeba vědět, kdo z nich daný převod spáchal.
* type: 1=stržení pravidelného měsíčního příspěvku, 2=vstupní příspěvek, 4=dobití VOIP kreditu, ...
* datetime: datum a čas účetního případu. Např. u řádku bankovního výpisu se zde bere datum a čas tohoto řádku. U faktury zde bude datum zdanitelného plnění.
* creation_datetime: datum a čas, kdy byl převod zadán do FreenetISu
* text, amount - popis platby a částka

Pozn. pro znalce podvojného účetnictví: tabulka transfers je vlastně obyčejný účetní deník - stejný, jaký si můj děda před 50ti lety vedl v papírové podobě...

== Tabulka account_attributes ==
Když už tedy podvojně účtujeme, je dobrý nápad mít naše podvojné účty "kompatibilní" s legislativou našeho státu.

Pak může stavy podvojných účtů ve FreenetISu okamžitě začít využívat pan(í) účetní naší organizace, protože mu (jí) to ušetří spoustu práce.

Abychom dosáhli kombatibilitu s legislativou, musíme ke každému našemu podvojnímu účtu najít nějaký standardní účet dle legislativy.

Standardní účty legislativa definuje ve formě tzv. účetní osnovy (angličani mají lepší termín: chart of accounts).

Účetní osnova je seznam možných podvojných účtů  pro daný typ organizace. U každého účtu je v účetní osnově definován jeho standardní název, standardní číslo a další atributy.

Účetní osnova vypadá nějak pro neziskovky, trochu jinak pro podnikatelské subjekty, trochu jinak pro státní správu.

Ve FreenetISu je účetní osnova uložena v tabulce account_attributes, a to jako účetní osnova pro neziskovky.  Jiné typy účetních osnov (např. podnikatelské) by řešil instalátor FreenetISu, ale zatím to nikdo nechtěl.

Nás asi nejvíc zajímá, na který standardní podvojný účet budeme mapovat kreditní účty členů?

Podvojný účet kreditu člena můžeme dle účetní osnovy pro neziskovky implementovat buď jako
# podúčet standardního účtu "Členské příspěvky" (standardní číslo v účetní osnově = 684000)
# podúčet standardního účtu "Účty v bankách" (číslo 221000)

Ve FreenetISu používáme 2. variantu, protože je stejná pro neziskovky i pro jiné subjekty, jejichž účetní osnova žádné členské příspěvky (684000) nezná.

Podrobnější výklad  najdete v této prezentaci:
* [http://zamestnanci.fai.utb.cz/~dulik/unart/hospodareni_v1_5.pdf formát PDF]
* [http://zamestnanci.fai.utb.cz/~dulik/unart/hospodareni_v1_5.odp formát ODP]

Na slajdu 13 je ukázán způsob, jakým členské příspěvky účtujeme v UnArtu my (při importu z Ebanky).

=== Typy podvojných účtů používaných při importu z banky ===

*Account_attribute_Model::MEMBER_FEES - typ "členské příspěvky"
*Account_attribute_Model::SUPPLIERS - typ "dodavatelé"
*Account_attribute_Model::OPERATING - operační účet, do kterého padají všechny nekategorizované příjmy a výdaje sdružení
*Account_attribute_Model::CASH - účet pro platby v hotovosti (pokladna)

== Evidence bankovních účtů ==
Narozdíl od běžných účetních systémů (Pohoda, Money S3), má FreenetIS dokonalejší evidenci bankovních účtů členů - FreenetIS umožňuje evidovat u každého člena až N jeho bankovních účtů. To nám velmi často pomáhá při identifikaci platby se špatným variabilem - přestože spousta členů(=rodin) platí z bankovního účtu manželky, který nese její dívčí příjmení (odlišné od příjmení rodiny), jsme schopni díky evidenci bankovních účtů okamžitě poznat, který člen je původcem takové platby.

Bankovní účty evidujeme v tabulce '''bank_accounts'''.

Po instalaci FreenetISu zde bude pouze bankovní účet sdružení.

Další bankovní účty členů automaticky vytváří  importer z ebanky. U plateb, které mají správný variabil, také importer nově vytvářenému bank. účtu automaticky přiřadí majitele.

Pokud chcete importovat bankovní výpisy ze zdroje, který bankovní účty neobsahuje, pak budete muset v tabulce "bank_accounts" vytvořit účet "NEIDENTIFIKOVANY"

Proč? Viz další kapitola:

== Evidence bankovních výpisů ==
Bankovní výpisy evidujeme v tabulce '''bank_statement'''.

Každý bankovní výpis sestává z mnoha bankovních transakcí.
Bankovní transakce jsou převody mezi bankovními účty.
Proto je  evidujeme podobně, jako převody mezi podvojnými účty - pomocí tabulky '''bank_transfers''', která obsahuje následující sloupce:
* origin_id, destination_id : id bankovních účtů z tabulky bank_accounts
* transfer_id : id podvojného převodu z tabulky transfers. Každý bankovní převod by měl být podvojně zaúčtovaný, tj. odkazovat na některý podvojný převod. Pokud byste některé bankovní převody nezaúčtovali, vznikne účetní chyba - stav podvojného účtu "bankovní účet" nebude sedět se skutečným stavem bankovního účtu
* bank_statement_id : odkaz do tabulky bank
* number: Line number or number of the bank listing item   
* variable_symbol,   constant_symbol, specific_symbol - to je asi jasné
* comment - případný komentář účetního k dané platbě

Datum, čas a text platby jsme se rozhodli evidovat ne v této tabulce, ale v tabulce transfers - protože každý bank_transfer má vždy přiřazen jeden transfer, byly by stejnomenné sloupce v tabulce bank_transfers redundantní.

=Terminologie=
*V kódu se používá směska anglické "polopatické" a oficiální účetní terminologie.
*Oficiální anglická a jí odpovídající česká účetní terminologie je popsána
**V tomto [http://ofirme.info/ofirmeinfo/frame3/zakazky/banka/1/Czech-English%20Dictionary.doc slovníčku]
**v PhD práci [http://is.muni.cz/th/33061/ff_d/Radek_Vogel_-_Lexical_Hierarchies_in_the_Scientific_Terminology_-_doctoral_thesis_2006.doc Radka Vogela z MUNI Brno].

=Import výpisů z banky=
FreenetIS momentálně umí importovat HTML výpisy z ebanky/Raiffeisen banky a výpisy v libovolném CSV formátu.
Největší díl práce v této oblasti představují parsery - především HTML parser ebanky. Proto jsou parsery napsány tak, aby neměly žádnou závislost na frameworku Kohana ani na FreenetISu - jsou to naprosto samostatné knihovny.

Popis implementace je v následujících článcích:
* [[Příprava pro import dat]]
* [[Raiffeisenbank]]
* [[Fio banka]]
* [[Ukládání dat do databáze]]

Přístupová práva

2012-08-02T10:03:18Z

Jeffraska:

==Popis implementace správy přístupových práv ve FreenetISu==

Aktuální přístupová práva pro FreenetIS jsou založena na PHP GACL. Samotná knihodna byla odstraněna, ale její sytém tabulek byl zachován.

==Popis SQL tabulek knihovny PhpGacl==

V PhpGaclu je všechno postavené na objektech ACO, ARO a AXO.

'''ACO''' - objekty operací

'''ARO''' - objekty (nebo skupiny objektů), které chtějí jednotlivé operace (ACO) vykonávat

'''AXO''' - objekty (nebo skupiny objektů), nad kterými chtějí jednotlivé ARO nějakou operaci (ACO)

===acl===
Tabulka definující jednotlivé přístupová pravidla.

Obsahuje sloupce id, section_value, allow, enabled, return_value, note, updated_date.

'''id''' - identifikátor, důležitý pro propojení s ACO, ARO a AXO

'''section_value''' - název sekce, kam toto pravidlo patří

'''allow''' - 1 => pravidlo operaci povoluje, 0 => pravidlo operaci zakazuje

'''enabled''' - 1 => pravidlo je povolené, 0 => pravidlo je zakázané

'''return_value''' - zatím netuším

'''note''' - komentář, popisující funkci pravidla (např. Administrátoři mohouu dělat vše)

'''updated_date''' - timestamp poslednín aktualizace pravidla

===acl_sections===
Tabulka definující jednotlivé sekce pravidel.

Defaultně jsou v PhpGaclu dvě sekce - System a User, FreenetIS ale používá jen User.

Obsahuje sloupce id, value, order_value, name a hidden.

'''id''' - identifikátor, víceméně zbytečný, protože pravidla se do sekcí přiřazují pomocí hodnoty (value)

'''value''' - krátký název bez mezer, používá se pro přiřazení jednotlivých acl do sekcí

'''order_value''' - zatím netuším

'''name''' - dlouhý název, popis

'''hidden''' - 0 => sekce je viditelná, 1 => je skrytá

===acl_seq===
Tabulka, jejíž jediným účelem je zapamatování si aktuálně posledního id tabulky acl.

PhpGacl (bůhví proč) nepoužívá u tabulek auto increment.

Obsahuje sloupec id.

'''id''' - poslední id v tabulce acl

===aco===
Tabulka definující jednotlivé objekty ACO. Ve FreenetISu jsou buď ACO pro vykreslování menu (sekce menu) a ACO pro obecné operace (sekce freenetis) - view_all, view_own, edit_all, edit_own, delete_all, delete_own, new_all, new_own, confirm_all, confirm_own, ... které se používají '''výhradně''' s AXO objekty.

Obsahuje sloupce id, section_value, value, order_value, name a hidden.

'''id''' - identifikátor, nedůležitý (pro propojení s acl v tabulce aco_map se používá value)

'''section_value''' - jméno sekce, definované v aco_sections

'''value''' - krátký název bez mezer, používá se pro přiřazení jednotlivých aco do sekcí a pro propojení s jednotlivými acl pravidly v aco_map

'''order_value''' - zatím netuším

'''name''' - dlouhý název, popis

'''hidden''' - 0 => sekce je viditelná, 1 => je skrytá

===aco_map===

Propojuje ACO objekty s jednotlivými acl pravidly. ACO jako jediné (z trojice ACO, ARO a AXO) nemá možnost shhlukování do skupin, proto není žádná další dabulka aco_groups_map.

Obsahuje sloupce acl_id, section_value a value.

'''acl_id''' -

'''section_value''' -

'''value''' -

===aco_sections===

Sekce pro jednotlivé ACO, FreenetIS používá pouze dvě: menu - pro ACO objekty týkající se vykreslování menu, a pak freenetis - pro definici obecných ACO operací (zobrazení, editování, mazání a potvrzování).

Obsahuje sloupce id, value, order_value, name a hidden.

'''id''' - identifikátor sekce (není pro nic potřeba)

'''value''' - samotný název sekce (u nás menu a freenetis)

'''order_value''' - zatím netuším

'''name''' - popis sekce

'''hidden''' - 0 => sekce je viditelná, 1 => je skrytá

===aro_groups_map===

přiřazuje k jednotlivým ACL pravidlům skupiny uživatelů.

Příklad:

Vytvoříme pravidlo "Zájemci o členství a řádní členové mohou dělat XYZ".

Toto pravidlo bude v tabulce "acl" reprezentováno novým řádek s id=27, ve kterém je uloženo hodnota "allow";

Pokud "řádní členové" mají id=22 a zájemci o členství id=23, pak v tabulce aro_groups_map při vytvoření tohoto pravidla přibudou 2 nové řádky:

acl_id | group_id
-----------------
27 | 22

27 | 23

===axo_groups_map===

Podobné jako aro_groups_map, ale pro AXO

Změna zapomenutého hesla

2012-08-02T10:00:46Z

Jeffraska:

FreenetIS umožnuje vygenerovat nové heslo skrze e-mail přímo členovi/uživateli, který heslo zapomněl. Tato možnost musí být povolena v nastavení.
Heslo může též uživateli změnit administrátor.

Přimo v databázi lze potom změnit heslo následovně.

UPDATE users SET PASSWORD = sha( 'nejakeHeslo' ) WHERE id = IDuzivatele

kde IDuzivatele je celé číslo a vidíte ho ve Freenetisu u daného uživatele ve sloupci ID

I18n

2012-08-02T09:59:46Z

Jeffraska:

Internacionalizace ve FreenetISu se týká 2 oblastí:

* řetězců, které jsou obsaženy ve zdrojových kódech - tato se provádí pomocí jazykových souborů v adresáři i18n
* řetězců v databázi - řetězce v databázi není ve většině případů nutné překládat. Výjimkou jsou výčtové typy - např. typy členů, zařízení, kontaktů, které lze editovat i přes webové rozhraní. Protože instalace Freenetis-u obsahuje základní hodnoty pro tyto typy, bylo nutné pro ně vymyslet i internacionalizaci.

Výčtové typy jsou implementovány pomocí 2 tabulek:

{| border="1" class="wikitable"
|+ enum_types:
! id !! type_id !! value
|-
| 1 || 1 (=např. typ člena) || Applicant
|-
|2 || 1 || Regular member
|-
|3 || 1 || Honorary member
|-
|4 || 2 (=např. typ kontaktu) || Phone
|-
|5 || 2 || ICQ
|-
|6 || 2 || Skype
|}
Tabulka enum_types obsahuje výpis všech typů v defaultním jazyce (zde je zvolena angličtina)

Překlady k jednotlivým řádkům z enum_types budeme získávat z tabulky translations:

{| border="1" class="wikitable"
|+ translations:
! id !! original_term !! translated_term !! lang
|-
| 1 || Regulary member || Řádný člen || cs
|-
| 2 || Regulary member || Regular member || en
|-
| 3 || Regulary member || Ordentlich Mitglied || de
|-
| 4 || Phone || Telefon || cs
|-
| 5 || Phone || Telefon || de
|-
|}

Díky faktu, že obě tabulky nejsou provázané klíči, můžeme použít tabulky translations i na překlady termínů z jiných tabulek než enum_types.

Běžný dotaz pro získání id a jemu odpovídajícího řetězce určitého jazyka pro typy členů (type_id=1):

SELECT enum_types.id, IFNULL(translations.translated_term,enum_types.value) as value FROM enum_types
LEFT JOIN translations on enum_types.value = translations.original_term
WHERE enum_types.type_id=1 AND translations.lang="cs"

Ukládání dat do databáze

2012-08-02T09:59:27Z

Jeffraska:

=Ochrana proti vícenásobnému importu=
Mohlo by se stát, že uživatel omylem naimportuje jeden výpis 2x. Nemusí to být chyba z nepozornosti typu "import 2x stejného souboru", klidně je možné, že naimportuje týdenní výpis a pak měsíční výpis, ve kterém je ten týden už také obsažen. V každém případě výsledkem bude několik desítek až stovek transakcí v tabulkách transfers a bank_transfers, které tam nepatří.

První řešení, které nás napadlo pro ošetření této chyby, je použití UNIQUE indexu přes všechny sloupce tabulky bank_transfers, které dohromady tvoří unikátní klíč. Bohužel jsme zjistili, že řádky výpisů z ebanky unikátní nejsou - běžně se nám stává, že ve stejné sekundě přijdou 2 platby od jednoho člena, které mají stejnou částku, variabilní symbol i text.

Proto jediné možné řešení spočívá v tomto přístupu:
* při ukládání každé bankovní transakce do databáze je nutné se podívat, jestli stejná transakce už v databázi není z nějakého minulého importu. Čas importu je zaznamenán v podvojném zaúčtování každé bankovní transakce, tj. v záznamu v tabulce transfers, který je s každým bank_transfer-em svázán.
* budeme tedy testovat, zda není splněná podmínka:
bank_transfer_exist() && bank_transfer->transfer->datetime != čas_aktuálního_importu
*test "bank_transfer_exist()" ovšem znamená, že budeme muset procházet všechny bank_transfers (tj. tisíce řádků) a porovnávat údaje ze všech sloupců na shodu. Aby tato operace byla co nejrychlejší, je potřeba tabulku bank_transfers vhodně naindexovat - vytvořit index přes více sloupců. Problematiku vícesloupcových indexů [http://blog.decaresystems.ie/index.php/2007/05/21/how-to-create-a-successful-multi-column-index-from-first-principals/ vysvětluje tento článek], při výrobě tohoto indexu potřebujeme statistiky, o kterých píše [http://blog.decaresystems.ie/index.php/2007/06/11/a-sample-query-to-determine-relative-cardinality/ tento článek].

Ve FreenetISu kontrolu duplicit v tabulkách bank_transfers JOIN transfers řeší funkce
public static function get_duplicities($data)
která je v souboru
freenetis/.../application/models/bank_transfer.php

Tato funkce je dostatečně efektivní.

Příklad: naše tabulka "bank_transfers" má teďka 20684 záznamů, tj. počet bank. převodů za 3 roky. Tabulka "transfers" má kolem 120tis. záznamů.

Přitom SQL dotaz pro hledání duplicitního řádku výpisu je bleskový. Vypadá takto (příklad našich reálných dat):

SELECT t.datetime, t.creation_datetime, t.text, bt . *
FROM bank_transfers AS bt
JOIN transfers AS t ON bt.transfer_id = t.id
AND t.datetime = '2010-10-01 07:54:00'
AND t.text = 'Prispevek 2010 - Karel V., Horní Dolní 23'
AND bt.number = '20'
AND bt.variable_symbol = 1234567

Zobrazeny záznamy 0 - 0 (1 celkem, dotaz trval 0.0211 sekund)

SQL dotaz "explain" vysvětluje, proč je to tak rychlé:
id select_type table type possible_keys key key_len ref rows Extra
1 SIMPLE t ref PRIMARY,datetime datetime 773 const,const 1 Using where
1 SIMPLE bt ref transfer_id,number transfer_id 5 freenetis.t.id 1 Using where

Tj. nejdřív se v tabulce "transfers" pomocí multicolumn indexu (s hloupě zvoleným jménem) "datetime", který je vytvořen nad sloupci "datetime" a "text" najdou všechny transfery ze zadaného data se zadaným textem platby. To je typicky 1, max. 2 záznamy. Multicolumn používám proto, že by to mělo být efektivnější než 2 nezávislé indexy.

S těmito 1-2ma transfery se pak udělá JOIN na bank_transfers, kde jsou velmi rychle dohledány opravdové duplicity. Jak vidíš, multicolumn index "number" nakonec mysql asi nepoužije, protože pro 1-2 joinované položky už je to zbytečné.

==Proč nepoužívám hash==
V některých parserech jsem viděl kontrolu duplicit řešeno pomocí md5 hashe.

Pokud bych použil (md5) hash, pak bych tuto hash v databázi - jako každou součást join podmínky - určitě taky indexoval a abych tam neměl falešné duplicity (jakýkoli hash - tedy i md5 - může mít kolize, tj. že hash(x) == hash(y), přičemž x!=y), stejně bych v tom dotazu v případě shody hashů musel testovat i shodu všech hashovaných údajů.

Tj. ve výsledku by ten dotaz byl ještě o jednu AND podmínku delší a v tabulce bank_transfers bych měl o jeden sloupec víc.

Proto jsem hash nakonec vůbec nepoužil.

=Tvorba převodů mezi podvojnými účty=
Pokud se díváte na kód importu (application/controllers/import.php), tak se prosím radši ani nedívejte na funkci
public function store_transfer_ebanka($data)
neboť to je naprosto strašný kód, vzniklý šílenými nápady naší SR, která chtěla, aby se za každou platbu členovi strhl poplatek 30 Kč, ale zároveň aby bankovní poplatek (teď myslím 7 Kč?) eBanky mu byl "darován" sdružením zpátky a aby to opravdu ve výpise transakcí člen viděl jako 2 řádky (-30 Kč, pak +7 Kč).

Kromě této hrůzy, která naštěstí byla novou SR uznána jako kravina a u FIO účtu už nebude provozvána, je tam další velký kus kódu, který se snaží z kombinací částek, poplatků a textu plateb sám poznat, zda je v položce výpisu členský příspěvek, úrok, bank. poplatek, operace s termínovaným vkladem, platba dodavateli atd.
Rozpoznané typy plateb pak správně podvojně zaúčtuje.

Specifikace

2012-08-02T09:58:32Z

Jeffraska:

== FreenetIS 1.0 ==

[http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/branches/qcodo/wwwroot/doc/FreeNetIS-specifikace_v_0-6.pdf Prvotní specifikace], která byla použita pro zadání dvou diplomových prací a ze které vycházeli také další vývojáři. Tato specifikace ale v současné době neplatí. Bylo provedeno mnoho změn, například platby byly nakonec vyřešeny a implementovány zcela jinak.

Diplomová práce, jejímž výsledkem byla základní implementace členů a plateb.
* [http://zamestnanci.fai.utb.cz/~dulik/diplomky/2007-2008/Danek-MVC-Freenetis.pdf DP Petra Daňka]
Diplomová práce, jejímž výsledkem byla základní implementace zařízení.
* [http://zamestnanci.fai.utb.cz/~dulik/diplomky/2007-2008/Rozehnal-MVC-freenetis.pdf DP Marka Rozehnala]

Dokumentace k dalším rozšířením a úpravám systému, na kterých se podíleli další programátoři, lze nalézt pouze na této wiki nebo přímo ve zdrojovém kódu.

Úvodní prezentace k implementaci ekonomiky je zde:
*[[Media:Hospodareni.odp|formát ODP]]
*[[Media:Hospodareni.pdf|formát PDF]]

== FreenetIS 2.0 ==

Motto FreenetIS 2 je "systém bez kompromisů" - tj. chceme se od začátku vyvarovat všech kompromisních rozhodnutí, které jsme udělali ve FreenetIS 1 a dnes za ně draze platíme nutností dělat další a další kompromisy.

Celý FreenetIS by měl být vytvořen v Java EE.

===Schema databáze===

Poznámka: Pro kreslení ER diagramů existuje několik open source projektů - jejich hodnocení je na stránce [[Editory ERD]].

*[[Adresář|Address book]]
*[[Síť|Network]]

===ORM===

Jeden z frameworků poskytující Java Persistence API (např. Hibernate)

===Views===

Vybrat mezi JPS, JSF, RichFaces, ...

Instalace ze zdrojových kódů

2012-08-02T09:57:44Z

Jeffraska:

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 slouží pro vývoj a testování)

cd /var/www
svn checkout <nowiki>https://freenetis.svn.sourceforge.net/svnroot/freenetis/freenetis/trunk/kohana 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

Registrace a přihlášení do systému

2012-08-02T09:55:56Z

Jeffraska:

Registrace a přihlášení do systému

2012-08-02T09:55:01Z

Jeffraska:

'''První krůčky s FreenetISem'''

* Pokud máte zájem zaregistrovat se v systému [http://wiki.freenetis.slfree.net/index.php/Co_je_to_Freenetis%3F Freenetis] a tím se stát členem občanského sdružení [http://www.unart.cz/ Unart] (Z čehož plyne možnost využívat připojení k internetu pomocí [http://www.slfree.net/ Slfree].) navštivte stránky [https://freenetis.slfree.net/cs/members/show/1342 Freenetisu].

''Jsem tu co teď?''

* Po zadání adresy (www.freenetis.slfree.net) do vašeho internetového prohlížeče se vám zobrazí stránka vyžadující po Vás [https://freenetis.slfree.net/cs/members/show/1342 login a heslo].

* Pokud již login s heslem máte můžete se přihlásit, pokud ne musíte se zaregistrovat. Registrace se provádí pomocí formuláře, který se skrývá pod odkazem [https://freenetis.slfree.net/cs/registration Nový člen].
* Aby registrace proběhla úspěšně, je nutnné vyplnit všechny položky ve formuláři (Pouze email není povinný).

Další důležitou podmínkou je existence unikátního loginu (V systému se login musí vyskytovat pouze jednou -
proto je pravděpodobné, že pouze křestní jméno nebo přijmení v systému již budou obsazeny).
Neméně důležité je zvolit si silné a pro Vás zapamatovatelné heslo (Doporučuje se kombinace velkých a malých písmen s čísly,
slovníková slova jsou nedostatečná).

* Po úspěšné registraci se můžete směle přihlásit do systému a využívat všech jeho služeb.

--[[Uživatel:Pap|Pap]] 21:16, 30. 7. 2008 (UTC)

Administrátorská příručka

2012-08-02T09:53:55Z

Jeffraska:

= Menu Administrace =

Toto menu vidí jen uživatel s nejvyššími právy - administrátor.

== Logy přihlášení ==

Toto je statistika všech uživatelů, kde lze u každého uživatele vidět datum a čas jeho posledního přihlášení.

== Nastavení ==

V této sekci lze nestavovat různé systémové proměnné.

* System

Obsahuje základní systémová nastavení, jako jsou titulek systému, měna, volba dalších možností chování systému podle potřeb konkrétního sdružení.

* VoIP

...někdy se tu něco určitě objeví...

* Brána

Umožňuje nastavit věci týkající se přesměrování. IP adresa brány je IP adresa centrálního routeru, přes který jste připojeni do internetu. Webová stránka po přesměrování je stránka, která se zobrazí členovi po zrušení přesměrování. V kontaktních informacích zadejte text (i s html tagama), který se bude v levém pruhu zobrazovat jako kontaktní informace na vaše sdružení. V dalších textových polích zadávejte texty (i s nadpisem), kde formulejete vašimi slovy důvod přesměrování. Používejte html tagy. Podrobné vysvětlení mechanismu, jak funguje přesměrování, najdete zde [[Přesměrování]].

== Poplatky ==

Poplatky jsou více druhů a jsou platné vždy v určeném časovém období v dané výši.

* Pokuta
* Poplatek za transakci
* Poplatek za bankovní transakci
* Měsíční členský příspěvek
* Vstupní příspěvek

Poplatky mají tu funkci, že ve většině formulářů předvyplňují hodnotu poplatku, ale někde se jejich hodnota používá automaticky. Je proto rozumné si výše poplatků správně nastavit. Pokud poplatek daného typu ve svém sdružení nevedete, pak ho nastavte na nulu.

== Přístupová práva ==

V této sekci má administrátor možnost přidělovat uživatelům různá práva. Každý člen po přidání do systému má buď práva čekatele na členství nebo práva řádného člena. Teprve zde mu lze přidělit práva technika, ceritfikovaného technika, revizní komise, správní rady, případně administrátorská práva.

== Překlady ==

Systém FreenetIS je napsán s podporou internacionalizace, zdrojové kódy jsou v angličtině a je přeložen do češtiny. V této sekci jsou překlady všech výčtových typů uložených v databázi.

== Výčty ==

Umožňuje správu výčtových typů v systému.

== Telefoní faktury ==

V této sekci může admin importovat faktury Vodafone, přiřazovat účtované čísla uživatelům.

'''Import faktury''' probíhá za pomoci programu '''Adobe Reader''', ve kterém otevřeme fakturu a pomocí CTRL+A a CTRL+C/V ji vložíme do pole pro import. ''Pozn.: Import může trvat delší dobu, vkládá do databáze velké množství dat, mějte chvilku strpení.''

Fakturovaná čísla jsou automaticky vyhledávána v databázi uživatelů ''(tabulky: users a contacts)'' a přiřazována uživatelům. Uživatel který může manipulovat s vlastní fakturou za telefon, pokud je v ARO skupině '''telephonists'''.

Čísla s nimiž byl telefonista ve stiku jsou automaticky označována jako:
* Soukromá: Pokud je číslo v soukromých uživatelových kontaktech.
* Firemní: Pokud je číslo nalezeno jako číslo některého uživatele. ''(tabulky users a contacts)''
Pokud neplatí ani jedna podmínka:
* Soukromá: SMS, MMS, Data, Platby, Roaming SMS
* Firemní: VPN

'''Hromadné upozornění''' uživatelům jejichž číslo je v dané faktuře, lze odesílat pokud je faktura nezamčena. Informuje uživatele o možnosti změn v nastavení soukromých a firemních telefonů jejich faktury.

'''Zamčená/Odemčená fatura''' pokud je faktura odemčena nemohou ji upravovat zainteresovaní telefonisté, ale pouze administrátor, který vykonává finální úpravy před zaúčtováním.

= Starší odkazy =

Odkazy na nějaké triky ve FreenetISu.

*[[Root member]]
*[[Editace člena]]
*[[Změna zapomenutého hesla]]

Freenetis Wiki - Příspěvky uživatele [cs]

Instalace a nastavení serveru adresních bodů

Instalace a nastavení serveru adresních bodů

Instalace a nastavení serveru adresních bodů

Instalace a nastavení serveru adresních bodů

Instalace a nastavení serveru adresních bodů

Instalace a nastavení serveru adresních bodů

Instalace a nastavení serveru adresních bodů

Instalace a nastavení serveru adresních bodů

Hlavni strana

Instalace ze zdrojových kódů

Automatické testování v NetBeans

Automatické testování v NetBeans

Automatické testování v NetBeans

Hlavni strana

Merge branche do trunku

Merge branche do trunku

Hlavni strana

Hlavni strana

Diskuse:Registrace a přihlášení do systému

Diskuse:Registrace a pÃ…â„¢ihlÃƒÂ¡Ã…Â¡enÃƒÂ­ do systÃƒÂ©mu

Registrace a přihlášení do systému

Fio banka

Automatické testování

Nový systém přístupových práv

Managovatelný switch

Vývojová prostředí (IDE)

Často kladené dotazy

Mazání člena

Pošta

VoIP

Nastavení

Import a export databáze

Freenetis

Aplikační heslo

Co je třeba udělat po instalaci

Přesměrování

Import dat z banky

Synchronizace FreeNetIS - Mikrotik

Správcovská příručka

Uživatelská příručka

Ekonomika

Přístupová práva

Změna zapomenutého hesla

I18n

Ukládání dat do databáze

Specifikace

Instalace ze zdrojových kódů

Registrace a přihlášení do systému

Registrace a přihlášení do systému

Administrátorská příručka

Diskuse:Registrace a pÃ…â„¢ihlÃƒÂ¡Ã…Â¡enÃƒÂ do systÃƒÂ©mu