1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
|
-------------------------------------------------------------------------------
------------------ INSTALL - Ampache v.3.2 - 08/11/2004 -----------------------
-------------------------------------------------------------------------------
Ich gehe davon aus, dass Apache, PHP und MySQL bereits laufen, wenn du hier
angelangt bist.
Falls du von 3.0 auf 3.1 upgradest, schau dir bitte die MIGRATION Hinweise
an. Die Datenbank kann nicht weitergenutzt werden, aber gl�cklicherweise
haben wir einige Scripts entwickelt, um die Datenbank in das neue Format
zu konvertieren. (Daf�r gibts ein extra Bier :P)
Falls w�hrend der Installation irgendetwas schieflaufen sollte, schau dir
zun�chst die /test.php an, um an Hilfe zu gelangen.
1. Schnellinstallation:
mysql -u <Benutzername> -p <Datenbankname> < $root/ampache/sql/ampache.sql
Editiere die /etc/apache/httpd.conf
Lass das Webroot auf $root/ampache/docs zeigen.
[snip]
Alias /ampache/ /usr/share/ampache/docs/
<Directory /usr/share/ampache/docs>
Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all
</Directory>
[snip]
Starte danach Apache neu.
Verschiebe $root/ampache/config/ampache.cfg.dist nach
$root/ampache/config/ampache.cfg
Editiere $root/ampache/config/ampache.cfg
Besuche $web_adresse/login.php und melde dich mit den folgenden Daten an:
Benutzername: admin
Passwort: changeme
2. Der l�ngere Weg
2.1 Apache konfigurieren
An dieser Stelle gibt es zwei M�glichkeiten. Etnweder kannst du einen
Virtual Server f�r Ampache konfigurieren, oder du kannst Amapche einfach
in ein freies Verzeichnis installieren. Beide Wege besitzen Vor- und
Nachteile.
Wenn du einen Virtual Server einrichtest, besitzt er seine eigenen
Logfiles, die hilfreich beim Berechnen des Traffics sein k�nnten
(Unterscheidung von Ampache- und normalem Traffic).
Wenn du ein neues Verzeichnis f�r Ampache nutzt, wird der Traffic von
Ampache zusammen mit dem der anderen Anwendungen brechnet. Der Vorteil
hier ist, dass die Installation u.U. einfacher ist.
We've included cronolog lines. These are not required, but for
troubleshooting we recommend them.
Der Eintrag f�r einen eigenen Virtual Server lautet folgenderma�en:
[snip]
<VirtualHost 192.168.100.2:80>
ServerName tunes.ampache.org
ServerAdmin webmaster@ampache.org
DocumentRoot /data/www/ampache/docs
DirectoryIndex index.php
</VirtualHost>
[snip]
Nac einem Neustart sollte Ampache nun richtig konfiguriert sein.
2.2 MySQL konfigurieren
Wir legen an dieser Stelle einen eigenen User f�r Ampache an.
Dazu ist folgender Befehl erforderlich:
'mysql -u user -p pass < sql/ampache.sql'
2.3 Konfiguration von Ampache
2.3.1 Konfiguration der ampache.cfg
Kopiere zu�chst die config/ampache.cfg.dist nach
config/ampache.cfg.
�ffne dann die config/ampache.cfg.dist und editiere die
Vairablen:
# Hostname des Datenbankservers
local_host = localhost
# Datenbankname
local_db = ampache
# Datenbank-Benutzername
local_username = <mysql_login_name>
# Datenbank-Passwort
local_pass = <password>
# Logindauer in Sekunden
local_length = 900
# Dies ist die Domain, fuer die das Cookie, in dem der Sessionkey gespeichert wird,
# ausgestellt wird. Diese Variable muss die Domain oder der Host des Systems sein.
# Andernfalls wird es unmoeglich sein, sich einzuloggen.
# Bitte ueberpruefe, ob zu Beginn ein . steht. (erforderlich!)
# Dies ist jedoch nicht notwendig, solange du die libglue fuer mehr als eine Seite
# nutzt.
# sess_domain = .yourwebsite.com
# Name der Session/des Cookie, dass zum Browser geschickt wird.
sess_name = ampache
# Lebenszeit des Cookies. 0 == Immer (bzw. bis der Browser geschlossen wird),
# andernfalls wird hier die Lebenszeit in Sekunden erwartet
sess_cookielife = 0
# Ist das Cookie ein "sicheres" Cookie?
sess_cookiesecure = 0
prefix = "/<ampache_root>"
# This should not include http:// or any part of the host name
# ampache detects hostname and port automaticly
# Hier sollte kein http:// oder irgendein Teil des Hostnames
# stehen. Hostname und Port werden automatisch erkannt.
web_path = "/<path to ampache>"
site_title = "Ampache!!!"
# Sollte ausgeschaltet bleiben, ansonsten wird die Performance sehr drunter leiden.
do_mp3_md5 = "FALSE"
# Hier wird das Interval angegeben, in dem der aktuelle Fortschritt
# beim Katalogisieren ausgegeben wird. Bei grossen Katalogen sollte
# diese Zahl moeglichst gering gehalten werden.
catalog_echo_count = "25"
# Diese Option legt fest, welcher ID3 Tag bevorzugt wird.
# Diese Funktion wurde fuer diejenigen angelegt, die noch keine
# v2-Tags angelegt haben. Somit ist es bei manchen Nutzern hilfreich,
# v1 zu nutzen, bis die Kataloge auf v2 umgestellt sind.
id3tag_order = "id3v2"
id3tag_order = "id31v"
# Kommentiere dies aus, wenn du nicht moechtest, dass Ampache
# symlinks folgt.
#no_symlinks = "true"
# Benutze Login-/Authentifizierungssystem?
use_auth = "yes"
# Kuenstler- & Album Zwischenspeicherlimit
# Um die Katalog-Aktualisierungen zu beschleunigen, und um die Last
# auf MySQL zu reduzieren nutzen wir eine Art Zwischenspeicher, wo
# anhand einer ID MySQL-Abfragen gespeichert werden.
# Du kannst diese Option frei nach deinem belieben abaendern ...
album_cache_limit = "25"
artist_cache_limit = "50"
2.3.2 Configuring motd.php
Copy config/motd.php.dist to config/motd.php
Edit this file however you like, with either php code or straight html.
The output will be displayed below the login box on login.php.
3. Der erste Start von Ampache
Besuche mit deinem Browser die frisch installierte Ampache-Seite,
und es sollte das Anmeldeformular erscheinen.
Das Passwort und der Benutzername f�r den ersten Login lauten:
Benutzer: admin
Passwort: changeme
Jetzt kannst du dir ein Bier holen .. ;)
3.1 Einen Katalog einrichten
Zun�chst gilt es, einen Katalog einzurichten. Dies geschieht, indem
man auf "Katalog hinzuf�gen" klickt, und dort den Pfad zur
MP3-Sammlung angibt. Es ist nicht notwendig, alle Unterverzeichnise
einzeln anzugeben, da die angegebenen Verzeichnise rekursiv
durchsucht werden.
3.2 Aktualisieren der Kataloge
Falls alles einwandfrei gelaufen, hast du nun einen leeren Ampache
vor dir. Um diesen Zustand zu veraendern, gehe unter der
Administrationsseite auf den Katalog-Link.
Nun fehlt nur noch ein Klick auf "Alle Kataloge aktualisieren", und
die Datenbank wird gefuehlt. Dies kann eine Weile dauern, da der
Webserver nun jede einzelne Datei auf ihren ID3-Tag hin untersucht,
und diese Daten in die Datenbank einspeist.
Final Note on MP3 Tags:
Abschliessende Bemerkung zu den ID3-Tags:
Da Ampache seine Daten aus den ID3-Tags bezieht, ist es wirklich
empfehlenswert, diese sauber und geordnet zu halten.
Eines der besten Tools f�r diesen Zweck ist EasyTAG, ein Tageditor
f�r MP3- und OGG-Dateien:
http://easytag.sourceforge.net
Es l�uft direkt auf dem Linuxrechner, und ist somit ein wenig schneller,
als wenn man die ID3-Tags erst ueber Samba oder NFS aktualisiert. Das
heisst natuerlich nicht, dass dies geht .. Es geht lediglich darum, dass
dieses Programm schneller auf die ID3-Tags zugreifen kann.
Falls du darauf bestehen solltest, Windows zu nutzen, findet sich unter
http://massid3lib.sourceforge.net/ eine weitere gute Software, f�r den
selben Zweck.
3.3 Benutzer hinzuf�gen
Um Benutzer hinzuf�gen, gen�gt es unter Administration -> Benutzer
-> Benutzer hinzuf�gen zu gehen, und das dortige Formular mit den
entsprechenden Informationen zu versehen.
3.4 Sortieren und Aktualisieren der Dateien (Wird noch entwickelt)
In Verbindung mit dem Update der Katalogeinstellungen, sind in v3.1
folgende Felder hinzugekommen:
ID3-Kommando
Dateinamenmuster
Sortiermuster
Nachdem diese Felder mit Werten versehen wurden, steht einem regelm��igem
Update mithilfe von fileupdate.pl nichts mehr im Wege.
Dieses Programm fragt die Datenbank ab, und nimmt die neusten Aktualisierungen
vor. Bevor fileupdate.pl ausgef�hrt werden kann, muss die Ampache.pm editiert
werden, sodass sie die notwendigen Archivinformatioenen enth�lt.
Benutzung von fileupdate.pl:
fileupdate [--id3|--rename|--sort|--all] [--help] [--pretend] [--verbose]
--pretend Stelle das angegebene Kommando dar, ohne etwas zu machen.
--id3 Aktualisiere ID3-Tags von allen mit 'id3' markierten Dateien
--rename Benenne alle mit 'rename' markierten Dateien
--sort Sortiere alle mit 'sort' markierten Dateien
--all Nehme ID3-Update vor, bennene und sortiere alle Dateien um,
die mit 'id3' markiert wurden.
--verbose Zeige detailierte Informationen
--help Diese Nachricht
Beispiel:
Folgender Eintrag nimmt regelm��ige um Mitternacht alle erforderlichen Updates
vor:
* 24 * * * /apache/bin/fileupdate.pl -all
|
