Instalace ze zdrojových kódů

Freenetis můžete provozovat na jakémkoli serveru (včetně Windows), ale doporučená platforma je Linux. Tento návod předpokládá použití distribuce Debian. U jiných distribucí bude postup podobný.

Linux

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 mysql-server phpmyadmin

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

Ve web serveru Apache musíte mít nainstalovaný a povolený modul mod_rewrite. V Linux distribucích, založených na Debian-u, je tento modul nainstalovaný defaultně, pokud jej nemáte povolený, tak jej povolte:

a2enmod rewrite

Poté ještě musíte v konfiguraci virtualhost-a Apache, na kterém budete freenetis provozovat, povolit pro adresář Freenetis možnost přenastavování konfigurace Apache pomocí souboru .htaccess. Za tímto účelem si poeditujte 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/

V konfiguraci virtualhost-a najděte sekci Directory definující vlastnosti adresáře, pod který jste Freenetis umístili, a přidejte tam direktivu "AllowOverride All". Výsledek bude vypadat třeba takto:

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

Celé pak

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

Nakonec restartuje Apache příkazem:

apache2ctl graceful

nebo

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

PhpMyAdmin je pokročilý nástroj pro správu MySQL databázi přes webové rozhraní. Po instalaci je dostupný na

http://IP adresa serveru/phpmyadmin/

nebo pokud pracujete na localhostu, tak i na

http://localhost/phpmyadmin/

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ř 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ď.

Stažení

Stažení z SVN

Pokud nemáte SVN klienta, pak

apt-get install subversion

teď už si můžete freenetis stáhnout do adresáře /var/www/freenetis:

cd /var/www
svn checkout https://freenetis.svn.sourceforge.net/svnroot/freenetis/freenetis/trunk/kohana freenetis

Pro snadnější instalaci je vhodné nastavit složku freenetis pro zápis:

chmod +w freenetis

Freenetis se neustále vyvíjí, chyby jsou opravovány, takže pokud vám něco nefunguje, updaty si můžete stáhnout příkazem:

svn update

(což stáhne pouze modifikované soubory)

Log oprav je dostupný 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 instalaci nemusí fungovat korektně!

Povolení uploadu

Aby bylo možné provádět importy souborů, je potřeba, aby webový server měl možnost zapisovat do složky upload. Toho lze docílit například změnou majitele složky na www-data.

Konec instalace

Na stránce vašeho serveru by měl nyní naběhnout instalátor Freenetisu.