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ý.
Obsah
Linux
Příprava OS
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
Příprava databáze
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í Freenetisu
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
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
V souboru
kohana/application/config/config.php
je třeba nastavit svoji doménu (například localhost/freenetis nebo freenetis.sdruzeni.cz) a protokol (http/https).
Dále nastavte přihlašovací údaje k Mysql databázi v souboru
kohana/application/config/database.php
Údaje musí odpovídat přihlašovacímu jménu a heslu, které jste zadali při vytváření databáze, viz výše.
Dále změnte vytvořte kopii souboru
kohana/.htaccess.dist
na
kohana/.htaccess
V souboru .htaccess je nutné ještě opravit první řádek podle složky v které máte nainstalován freenetis. Například máte-li freenetis v umístění localhost/freenetis, pak je potřeba změnit RewriteBase z původního / na /freenetis.
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.