Zobrazení zdroje stránky Instalace ze zdrojových kódů

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