Installationsanleitung

aus NetVision Source, der freien Wissensdatenbank

Dieser Artikel befasst sich mit der Neuinstallation eines auf NetVision Source basierenden Trackers. Alle Schritte sind so einfach und allgemein wie möglich gehalten, und Pfadangaben nur als Beispiele zu verstehen. Falls Du etwas an dieser Anleitung auszusetzen hast, oder meinst, es fehlt ein wichtiger Schritt, benutze bitte die Diskussionsseite, um Dich mitzuteilen.

Inhaltsverzeichnis

Voraussetzungen

Damit der NetVision Source funktioniert, müssen einige Voraussetzungen erfüllt sein. Wir empfehlen folgende Systemkonfiguration:

  • Windows-, Linux- oder *BSD-Betriebssystem
  • Apache 2 HTTP-Server
  • PHP > 4.3.0 mit den Erweiterungen gd, exif und mysql
  • MySQL 4.0.x, MySQL 4.1 oder höher wird noch NICHT unterstützt!
  • Ein funktionierender SMTP-Server zum Versenden von eMails
  • Optional, aber empfohlen: phpMyAdmin

Weiterhin setzen wir voraus, dass Du Dich mit folgenden Dingen auskennst:

  • Fortgeschrittene PHP-Kenntnisse, um Skripte editieren zu können
  • Wissen, wie man einen Webserver (z.B. Apache 2) sowie PHP und MySQL korrekt konfiguriert
  • Bei einem Linux-Server grundlegende Kenntnisse der Shell und der gängigen Kommandos

Die Installation und Administration eines BitTorrent-Trackers erfordert in diesen Bereichen einiges Detailwissen, und ohne dieses wird es wahrscheinlich schwierig für Dich, bei Fehlern schnell eine Lösung zu finden.

Herunterladen und entpacken

Lade Dir zuerst die aktuellste Version des NetVision Source auf der Downloadseite herunter. Wir empfehlen aufgrund der geringeren Dateigröße das Format .tar.bz2. Du kannst nun das Archiv direkt auf Deinem PC entpacken, oder dieses auf den Server hochladen und Dich via SSH einloggen und das Archiv lokal entpacken. Letzeres hat den Vorteil, dass die Rechte für einige Ordner direkt richtig gesetzt sind.

Lokal entpacken

  • Entpacke den Source mit Deinem Lieblings-Archiver, z.B. WinZIP oder WinRAR.
  • Lade die Dateien mit einem FTP-Client auf Deinen Server hoch.
  • Setze die Dateirechte für die Ordner "torrents" und "bitbucket" auf 777 (beschreibbar für Alle).

Via SSH entpacken

  • Logge Dich via SSH auf Deinem Server ein.
  • Wechsle in den Ordner, in dem der Tracker liegen soll
  • Lade mit wget die aktuelle Version des Source herunter.
  • Entpacke den Source mit folgendem Befehl:
tar xjvf nvtracker-YYYYMMDD.tar.bz2 (für .tar.bz2-Dateien)
tar xzvf nvtracker-YYYYMMDD.tar.gz (für .tar.gz-Dateien)
  • Verschiebe die Dateien aus dem Ordner nvtracker-YYYYMMDD in den aktuellen Ordner, oder benne diesen um, und setze ihn als Document Root.

Datenbank erstellen und einspielen

Wir empfehlen, für den Tracker eine eigene Datenbank zu verwenden, da den Tabellennamen kein Präfix vorangestellt werden kann. Zuerst musst Du einen Datenbank-Benutzer anlegen, der nur auf die Tracker-Datenbank Zugriff hat. Den Tracker mit dem MySQL-Root-Benutzer laufen zu lassen, ist nicht empfehlenswert! Benutze den MySQL-Kommandozeilenclient, oder phpMyAdmin, um folgende SQL-Befehle als MySQL-Benutzer "root" auszuführen. Ersetze dabei den Benutzernamen (nvdbuser) und das Passwort (nvdbpasswort) nach Belieben: 

CREATE DATABASE nvtracker;
GRANT USAGE ON *.* TO nvdbuser@localhost IDENTIFIED BY 'nvdbpasswort';
GRANT ALL PRIVILEGES ON *.nvtracker TO nvdbuser@localhost;

Nun benutze phpMyAdmin oder den Kommandozeilenclient, und spiele den Datenbank-Dump "nvdatabase.sql" in die Datenbank ein. Die Datei befindet sich im Hauptverzeichnis des Trackers. Du kannst folgenden Shell-Befehl nutzen, um die Datenbank zu importieren: 

mysql -uroot -p nvtracker < nvdatabase.sql

Nun sollte die Datenbank alle Tabellen und vorgefertigten Einträge enthalten, die für den Trackerbetrieb nötig sind.

Tracker konfigurieren

Nun muss der Tracker konfiguriert werden. Zuerst musst Du die Datenbank-Zugangsdaten in die Datei "includes/secrets.php" eintragen. Analog zum oben eingerichteten MySQL-Benutzer sollte diese Datei etwa so aussehen: 

<?

$mysql_host = "localhost";
$mysql_user = "nvdbuser";
$mysql_pass = "nvdbpasswort";
$mysql_db   = "nvtracker";

?>

Als nächstes musst Du die Konfigurationsdatei anpassen. Eine vollständige Beschreibung aller Konfigurationsoptionen findest Du auf der Seite NetVision Source konfigurieren, daher gehen wir an dieser Stelle nicht näher darauf ein.

Cronjob für Ratiohistogramme eintragen

Damit die Ratiohistogramme erstellt werden können, muss das entsprechende Skript als Cronjob eingetragen werden. Um die Cronjobs zu bearbeiten, rufe als Benutzer root via Shell den Befehl crontab -e auf. Daraufhin öffnet sich ein Texteditor, in dem Du die Cron-Tabelle bearbeiten kannst. Füge am Ende der Datei (es existieren evtl. bereits Einträge) folgende Zeile ein: 

0 * * * * /usr/bin/php /kompletter/pfad/zur/logratiostats.php

Bitte beachte, dass Du dafür einen Kommandozeilen-PHP-Parser benötigst. Einige Linux-Distributionen installieren das Apache-Modul und die CLI-Version getrennt! Achte auch darauf, dass am Ende des Crontabs eine Leerzeile existiert, ansonsten erhältst Du beim Beenden des Editors einen Fehler wie "premature end of file".

Falls Der Pfad zur PHP-Binary nicht korrekt ist (/usr/bin/php), gib als root bitte einfach folgenden Befehl ein: 

which php

Es sollte nun ein einzelner Pfad inklusive Befehlsname (php) am Ende angezeigt werden. Zeigt der Befehl aber etwas wie "which: no sdg in ..." an, dann hast Du womöglich keinen PHP-Kommandozeilenparser installiert.

SysOp-Benutzeraccount anlegen

Damit Du den Tracker selber benutzen kannst, musst Du zuerst einen SysOp-Benutzer anlegen. Aus Sicherheitsgründen haben wir keinen Standard-Benutzer im Datenbank-Dump integriert. Um einen Benutzer anzulegen, verwende die normale Registrierungsfunktion des Trackers. Du musst nicht zwingend auf die Bestätigungsmail warten, sondern kannst auch einfach das Feld "status" auf "confirmed" setzen. Um Deinem Benutzer SysOp-Rechte zu geben, ändere einfach das Feld "class" auf 100: 

UPDATE `users` SET `class`=100,`status`='confirmed';

Achtung: führe diese Anfrage nur aus, solange kein anderer Benutzer registriert ist - ansonsten hat JEDER registrierte Benutzer SysOp-Rechte! Sind bereits andere Benutzer angemeldet, musst Du eine WHERE-Bedingung mit Deiner Benutzer-ID nachstellen, oder einfach mit phpMyAdmin Deinen Datensatz bearbeiten.

Wenn Du Dich auf dem Tracker nun neu einloggst, solltest Du SysOp-Rechte besitzen.

Herzlichen Glückwunsch!

Du hast Deinen NVTracker nun erfolgreich installiert!

Von "http://netvision.dyn.pl/wiki/Installationsanleitung"
'Persönliche Werkzeuge