Projekt

Obecné

Profil

Instalace » Historie » Verze 3

Michal Kliment, 2012-06-19 11:45

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