Instalace ze zdrojových kódů
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
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ď.
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:
cd /var/www svn checkout https://freenetis.svn.sourceforge.net/svnroot/freenetis/freenetis/trunk/kohana freenetis
Povolte zápis do složek freenetis, freenetis/upload a freenetis/static:
cd /var/www/freenetis chmod ugo+w . upload static
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 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ý 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
