Projekt

Obecné

Profil

Instalace » Historie » Verze 2

Michal Kliment, 2012-06-19 11:36

1 2 Michal Kliment
h1. Instalace
2
3 1 Michal Kliment
Freenetis můžete provozovat na jakémkoli serveru (včetně Windows), ale doporučená platforma je Linux.
4
5 2 Michal Kliment
h2. Linux
6 1 Michal Kliment
7
Tento návod předpokládá použití distribuce Debian. U jiných distribucí bude postup podobný.
8
9 2 Michal Kliment
h3. Příprava
10 1 Michal Kliment
11
Instalace PHP, Apache, MySQL a phpMyAdmina. Je potřeba být přihlášen jako root.
12
13
 apt-get install apache2 php5 php5-mysql php5-curl mysql-server phpmyadmin
14
15
*Podporované verze nástrojů*
16
17
* *PHP* verze 5.1.2 a vyšší
18
* *MySQL* verze 5.1.0 a vyšší
19
20
h3. Locale
21
22
Pro správnou funkci porovnání českých řetězců v PHP musíte mít nainstalované české UTF-8 locale. Takže:
23
24
 dpkg-reconfigure locales
25
26
Vybrat:
27
28
 cs_CZ.UTF-8
29
en_US.UTF-8
30
31
a restartovat apache:
32
33
 apache2ctl graceful
34
35
h3. Apache
36
37
Pro správný běh Apache upravte soubor s konfigurací virtualhost-a, který na Debianu najdete takto:
38
*pokud jste žádný virtualhost zatím nenastavovali, jedná se o soubor /etc/apache2/sites-available/default
39
*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/
40
41
Do tohoto souboru přidejte následující řádky:
42
 
43
 <VirtualHost *>
44
         ServerAdmin webmaster@example.org
45
         ServerName  freenetis.example.org
46
         DocumentRoot /var/www/freenetis
47
         <Directory /var/www/freenetis>
48
                 Options Indexes FollowSymLinks MultiViews
49
                 Order allow,deny
50
                 allow from all
51
         </Directory>
52
 </VirtualHost>
53
54
kde samozřejmě místo ServerAdmin a ServerName zadejte vaše údaje.
55
56
Nakonec restartujte Apache příkazem:
57
58
 /etc/init.d/apache2 restart
59
60
====Volitelné: Povolení mod_rewrite====
61
62
Pokud jej nemáte povolený, tak jej povolte:
63
64
 a2enmod rewrite
65
66
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:
67
68
        <Directory /var/www/freenetis>
69
                Options Indexes FollowSymLinks MultiViews
70
                AllowOverride All
71
                Order allow,deny
72
                allow from all
73
        </Directory>
74
75
Nakonec restartujte Apache příkazem:
76
77
 /etc/init.d/apache2 restart
78
79
===MySQL===
80
81
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í
82
83
 dpkg-reconfigure mysql-server-VERZE
84
85
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.
86
87
====Pomocí phpMyAdmin====
88
89
[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
90
91
 <nowiki>http://IP adresa serveru/phpmyadmin/</nowiki>
92
93
nebo pokud pracujete na localhostu, tak i na
94
95
 <nowiki>http://localhost/phpmyadmin/</nowiki>
96
97
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ď.
98
99
==== Pomocí konzole====
100
101
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.
102
103
 mysql -u root -p
104
105
Po přihlášení v konzoli mysql pak napište tyto příkazy:
106
107
 create database freenetis;
108
 create user 'freenetis'@'localhost' identified by 'heslo';
109
 grant all on freenetis.* to 'freenetis'@'localhost';
110
111
==Stažení==
112
===Stažení z SVN===
113
114
Pokud nemáte SVN klienta, pak
115
 apt-get install subversion
116
117
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í)
118
119
 cd /var/www
120
 svn checkout <nowiki>https://freenetis.svn.sourceforge.net/svnroot/freenetis/freenetis/trunk/kohana freenetis</nowiki>
121
122
Povolte zápis do složek freenetis, freenetis/upload a vytvořte složku pro logování freenetis/logs:
123
124
 cd /var/www/freenetis
125
 chmod ugo+w . upload
126
 mkdir -m 0777 logs
127
128
Freenetis se neustále vyvíjí, aktualizace si stáhnete příkazem:
129
130
 cd /var/www/freenetis
131
 svn update
132
133
(což stáhne pouze modifikované soubory)
134
135
===Commit log===
136
137
Log oprav stable verze (trunk) je [http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/trunk/kohana/?view=log dostupný zde]. 
138
139
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.
140
141
Souhrnný [http://freenetis.svn.sourceforge.net/viewvc/freenetis/freenetis/?view=log log commitů do všech větví je zde].
142
143
==Instalace==
144
145
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.
146
147
===Nastavení konfigurace===
148
149
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.
150
151
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.
152
153
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ů.
154
155
Až se vám podaří tyto chyby opravit, klikněte na tlačítko Další krok.
156
157
====Volitelné: Ruční vytvoření config.php====
158
159
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!'''
160
161
===Samotná instalace===
162
163
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.
164
165
====Volitelné: Ruční vytvoření .htaccess====
166
167
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ě!'''
168
169
===Zprovoznění "plánovače"===
170
171
Freenetis má v sobě vlastní scheduler který je potřeba pravidelně zpouštět z cronu. Do cronu přidejte tento řádek:
172
173
 #Freenetis scheduler
174
 * *     * * *   root    wget -O /dev/null  http://<hostname>/cs/scheduler/run
175
176
Pokud používáte SSL s neověřeným nebo s neplatným certifikátem použijte:
177
178
 #Freenetis scheduler
179
 * *     * * *   root    wget -O /dev/null  https://<hostname>/cs/scheduler/run --no-check-certificate