Instalace ze zdrojových kódů: Porovnání verzí

Z Freenetis Wiki
Přejít na: navigace, hledání
m (Quimi přesunul stránku Instalace ze zdrojových kódů na Instalace ze zdrojových kódů bez založení přesměrování)
 
(Není zobrazeno 68 mezilehlých verzí od 7 dalších uživatelů.)
Řádek 1: Řádek 1:
−
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ý.
+
[[en:Instalation from source code]]
 +
[[ru:Установка из исходного кода]]
  
−
=Příprava OS=
+
'''Tento návod je určen pro vývojáře FreenetISu, pro distribuční účely je k dispozici [http://wiki.freenetis.org/index.php/Instalace instalace z balíčkovacích sytémů].'''
  
−
Instalace PHP, Apache a MySQL
+
FreenetIS můžete provozovat na jakémkoli serveru (včetně Windows), ale doporučená platforma je Linux.
−
apt-get install apache2 php5 php5-mysql mysql-server
 
  
−
==Locale==
+
=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:
 
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
 
  dpkg-reconfigure locales
Řádek 19: Řádek 33:
 
  apache2ctl graceful
 
  apache2ctl graceful
  
−
==Apache==
+
===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
+
Pro správný běh Apache upravte soubor s konfigurací virtualhost-a, který na Debianu najdete takto:
−
 
 
−
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 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/
 
*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:
+
Do tohoto souboru přidejte následující řádky:
−
 
 
−
        <Directory /var/www/freenetis>
 
−
                Options Indexes FollowSymLinks MultiViews
 
−
                AllowOverride All
 
−
                Order allow,deny
 
−
                allow from all
 
−
        </Directory>
 
−
 
 
−
Celé pak
 
 
   
 
   
 
  <VirtualHost *>
 
  <VirtualHost *>
Řádek 45: Řádek 47:
 
         <Directory /var/www/freenetis>
 
         <Directory /var/www/freenetis>
 
                 Options Indexes FollowSymLinks MultiViews
 
                 Options Indexes FollowSymLinks MultiViews
−
                AllowOverride All
 
 
                 Order allow,deny
 
                 Order allow,deny
 
                 allow from all
 
                 allow from all
Řádek 51: Řádek 52:
 
  </VirtualHost>
 
  </VirtualHost>
  
−
Nakonec udělejte obligátní restart Apache:
+
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ď.
  
−
  apache2ctl graceful
+
==== 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';
  
−
=Instalace Freenetis-u a databáze=
+
==Stažení==
−
==Stažení z Freenetisu z SVN==
+
===Stažení z GITu===
  
−
Pokud nemáte SVN klienta, pak
+
Pokud nemáte GIT klienta, pak
−
  apt-get install subversion
+
  apt-get install git
  
−
teď už si můžete freenetis stáhnout do některého adresáře pod /var/www/freenetis/:
+
teď si můžete FreenetIS stáhnout do adresáře /var/www/freenetis (ve větvi master je nejstabilnější verze, další větve slouží pro vývoj a testování)
  
 
  cd /var/www
 
  cd /var/www
−
  svn checkout https://freenetis.svn.sourceforge.net/svnroot/freenetis/freenetis/trunk/kohana
+
  git clone <nowiki>https://github.com/freenetis/freenetis.git 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í, chyby jsou opravovány, takže pokud vám něco nefunguje, updaty si můžete stáhnout příkazem:
+
FreenetIS se neustále vyvíjí, aktualizace si stáhnete příkazem:
  
−
  svn update
+
  cd /var/www/freenetis
 +
git pull
  
 
(což stáhne pouze modifikované soubory)
 
(což stáhne pouze modifikované soubory)
  
−
Log oprav je [http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/trunk/?view=log 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.
  
−
==Vytvoření databáze a import minimálně potřebných dat==
+
===Nastavení konfigurace===
  
−
Připojte se k databázi
+
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.
  
−
mysql -p{root heslo do databaze} -u root
+
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.
  
−
a vytvořte databázi freenetis
+
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ů.
  
−
mysql> create database freenetis;
+
Až se vám podaří tyto chyby opravit, klikněte na tlačítko Další krok.
  
−
přidejte uživatele freenetis
+
====Volitelné: Ruční vytvoření config.php====
  
−
mysql>  USE mysql; 
+
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!'''
−
mysql> INSERT INTO user VALUES('localhost', 'freenetis', PASSWORD('heslo'), 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N', 'N');
 
  
−
a nastavte mu práva pro databázi freenetis
+
===Samotná instalace===
−
mysql> INSERT INTO db VALUES('localhost','freenetis','freenetis','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y'); 
 
−
mysql>  FLUSH PRIVILEGES;
 
  
−
==Nastavení konfigurace==
+
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.
  
−
Tady je potřeba udělat trochu víc věcí a to zejména proto, že ve Freenetis-u ještě není knihovna pro správu přístupových práv - phpgacl - zaintegrována tak, aby ji nebylo nutné konfigurovat zvlášť.
+
====Volitelné: Ruční vytvoření .htaccess====
  
−
Musíte nastavit v kohana/application/config/config.php svoji doménu a protokol(http/https)
+
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ě!'''
  
−
Musíte nastavit jméno a heslo k SQL databázi v těchto souborech:
+
===Zprovoznění "plánovače"===
−
* kohana/application/config/database.php
 
−
* kohana/application/vendors/phpgacl/gacl.class.php
 
−
* kohana/application/vendors/phpgacl/gacl.ini.php
 
  
−
Dále změnte název kohana/.htaccess.dist na kohana/.htaccess
+
FreenetIS má v sobě vlastní scheduler který je potřeba pravidelně zpouštět z cronu. Do cronu přidejte tento řádek:
  
−
Následně by se měl na stránce zobrazit instalátor freenetisu.
+
#FreenetIS scheduler
−
   
+
  <nowiki>* *    * * *  root    wget -O /dev/null  http://<hostname>/cs/scheduler/run</nowiki>
−
==Správa přístupových práv==
+
 
−
Ve Freenetisu doposud není implementováno žádné rozhraní pro správu přístupových práv (nebylo by to až zas tak složité, ale není na to čas).
+
Pokud používáte SSL s neověřeným nebo s neplatným certifikátem použijte:
  
−
Proto pokud chcete přidělovat uživatelům práva, máte 2 možnosti:
+
#FreenetIS scheduler
−
#můžete k tomu použít administrační rozhraní, které je součástí knihovny phpgacl. Bohužel kohana je implementovaná tak, že nelze přistupovat na žádné její podadresáře, takže je potřeba nainstalovat phpgacl ještě do nějakého adresáře dostupného z webu.
+
<nowiki>* *    * * *  root    wget -O /dev/null  https://<hostname>/cs/scheduler/run --no-check-certificate</nowiki>
−
#práva lze přidělovat i přímo v databázi. Například: pokud chcete nějakému uživateli přidělit práva administrátora, pak v databázi v tabulce users najděte jeho id. V tabulce groups_aro_map pak toto id najděte ve sloupci aro_id a upravte ten záznam tak, že group_id změníte na 32 (skupina administrators).
 

Aktuální verze z 31. 1. 2018, 14:12


Tento návod je určen pro vývojáře FreenetISu, pro distribuční účely je k dispozici instalace z balíčkovacích sytémů.

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 GITu

Pokud nemáte GIT klienta, pak 

apt-get install git

teď si můžete FreenetIS stáhnout do adresáře /var/www/freenetis (ve větvi master je nejstabilnější verze, další větve slouží pro vývoj a testování) 

cd /var/www
git clone https://github.com/freenetis/freenetis.git 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
git pull

(což stáhne pouze modifikované soubory)

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
Citováno z „https://wiki.freenetis.org/index.php?title=Instalace_ze_zdrojových_kódů&oldid=2236“