Instalace¶

• Obsah
• Instalace
  • Linux
    • Příprava
    • Locale
    • Apache
      • Volitelné: Povolení mod_rewrite
    • MySQL
      • Pomocí phpMyAdmin
      • Pomocí konzole
  • Stažení
    • Stažení z SVN
    • Commit log
  • Instalace
    • Nastavení konfigurace
      • Volitelné: Ruční vytvoření config.php
    • Samotná instalace
      • Volitelné: Ruční vytvoření .htaccess
    • Zprovoznění "plánovače"

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

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 https://freenetis.svn.sourceforge.net/svnroot/freenetis/freenetis/trunk/kohana freenetis

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 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 ze všech větví 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 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