Projekt

Obecné

Profil

Instalace » Historie » Revize 2

Revize 1 (Michal Kliment, 2012-06-19 11:34) → Revize 2/4 (Michal Kliment, 2012-06-19 11:36)

h1. Instalace 

 Freenetis můžete provozovat na jakémkoli serveru (včetně Windows), ale doporučená platforma je Linux. 

 h2. h1. Linux 

 Tento návod předpokládá použití distribuce Debian. U jiných distribucí bude postup podobný. 

 h3. h2. 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šší 

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

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