Kataloge sind das Herzstück von Ampache. Sie sind eine Art Kontainer für Ihre Lieder. Es gibt im Moment zwei Arten von Katalogen in Ampache, lokale und entfernte. Entfernte Kataloge werden nur in Verbindung mit XML-RPC benutzt, und zeigen auf andere Ampache Server. Lokale Kataloge hingegen zeigen auf ein lokales Verzeichniss auf dem Server. Erstellen Sie Ihren ersten Katalog indem Sie sich als Administrator einloggen und im Admin Menü auf Add a Catalog klicken.
Jeder Administrator kann seine Kataloge entweder über das Webinterface oder das Kommandozeilenscript /bin/catalog_update.inc verwalten. Das /bin/catalog_update.inc Script benötigt einen Katalognamen als ersten Parameter und führt ein „Update“ durch. Wenn kein Katalog angegeben wird, werden alle lokalen Kataloge upgedatet. Es folgt eine Liste mit Aktionen die auf Kataloge angewendet werden können, und was diese tun.
Ampache's Kataloge wurden so gebaut, dass Ihr Katalog völlig intakt bleibt wenn eine der obenstehenden Operationen stehenbleibt. Selbst wenn ein Fehler auftritt brauchen Sie keine Angst zu haben! Wenn Sie Probleme damit haben sollten wie Ampache Tags verarbeitet, oder während einer Operation einfach abbricht, schauen sie hier vorbei: Tag Reading / Meta Information
Aktivieren Sie immer das Logging wenn Sie nach Fehlern suchen
Ampache braucht Leserechte auf allen Dateien eines Kataloges, und Lese- und Ausführungsrechte auf allen Verzeichnissen. Wenn Probleme auftreten und Ampache Ihnen sagt dass er eine Datei oder ein Verzeichniss nicht auslesen kann, überprüfen Sie bitte die Dateiberechtigungen. Die untenstehenden Kommandos setzen die benötigten Berechtigungen. Es ist wichtig dass Sie in den Grundpfad des Kataloges wechseln bevor Sie diese Kommandos ausführen, da diese Kommandos die Berechtigungen rekursiv ändern.
cd /path/of/your/catalog
find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;
Stellen Sie sicher dass PHP's Open Basedir deaktiviert ist, oder aber wenn es aktiviert ist, es das Verzeichniss Ihrer Musik enthält. Stellen Sie außerdem sicher dass Ihre IIS/Apache Konfiguration keine Verbotslisten enthält welche die Zugriffe auf Ihre Musikverzeichnisse verbietet.
Auf Windows Netzlaufwerken müssen Sie sicherstellen dass der User unter dem Apache läuft exakt der gleiche ist, der das Laufwerk eingebunden hat, und genügend Rechte hat um das Laufwerk und die enthaltenen Dateien auszulesen.
Beachten Sie dass SELinux den Zugriff auf cifs oder NFS Mounts verbieten könnte. Siehe man pages für booleans(8), getsebool(8), und setseool(8). SELinux müsste diese Verletzungen im System Log loggen. (Im Normalfall /var/log/messages)
Zugriff auf gemeinsame Verzeichnisse und Laufwerke ist möglich, bedarf aber etwas Handarbeit. Hier sind ein paar Dinge auf die Sie achten müssen:
Obwohl Ampache set_time_limit(0) benutzt um das standardmäßige PHP Ausführungszeit- Limit zu ändern kann es vorkommen das einige PHP Einstellungen ebendies verhindern. Wenn PHP nicht genügen Speicher bekommen sollte (32MB), oder das Ausführungszeit- Limit erreicht sein sollte, ändern Sie bitte Ihre php.ini von Hand um diese Einstellungen hochzusetzen. Wenn PHP als Modul läuft müssen Sie danach Ihren Webserver neu starten. Machen Sie sich keine Sorgen wenn Ihnen mitten im Anlegen eines neuen Kataloges der Speicher ausgeht. Starten Sie einfach die Aktion nocheinmal, und Ampache wird dort weitermachen wo er aufgehört hat. Für weitere Informationen über Timeout Probleme und die möglichen Uhrsachen sehen Sie bitte hier nach:
Getid3() sollte niemals mehr als 32 MB an Arbeitsspeicher benötigen wenn es korrekt arbeitet. Ab und zu kann es allerdings passieren dass es über eine Datei stolpert die es nicht korrekt verarbeiten kann und dann sehr viel Arbeitsspeicher verbraucht und sich aufhängt. Die einzige Lösung ist die betreffende Datei neu zu taggen bzw. zu codieren, oder sie einfach von Ihrer Sammlung zu entfernen. Um herauszufinden welche Datei betroffen ist aktivieren Sie das logging und suchen Sie nach der letzten verarbeiteten Datei.
Seit Version 3.4-Beta2 können von Ampache nur solche Dateien verarbeitet werden welche Zeichen im Dateinamen besitzen, die unter site_charset in der Datei /config/ampache.cfg.php angegeben sind. Wenn einige Ihrer Dateien nicht korrekt katalogisiert werden und Zeichensatz- Fehler auftreten, können Sie die betreffenden Dateien entwerder von Hand umbenennen, oder Sie können das Script fix_filenames.inc im Verzeichniss /bin benutzen.