Installation

Anforderungen

HistView stellt nur wenige Anforderungen an den Server:

• einen Webserver mit Support für PHP (getestet nur mit Apache)
• PHP in Version 4.1 oder höher (empfohlen: als ladbares Modul für Apache, was wiederum die einzige getestete Variante ist), optional mit Unterstützung für MySQL (für die Download-Statistiken)
• Optional: MySQL Datenbank (lokal oder remote) für die Download-Statistiken

Die meisten Linux-Distributionen erfüllen diese Voraussetzungen über ihre Paketmanager, daher sollte die Installation hier kein Problem darstellen. Unter Windows mag das ein wenig anders aussehen. Um herauszufinden, ob PHP die nötigen Module eingebunden hat, kann man sich einfach eine kleine Textdatei mit der Zeile <?php phpinfo();?> erstellen, diese in den Webbaum legen, und mit dem Browser aufzurufen. Die entsprechenden Informationen sollten nun angezeigt werden. Sieht man hingegen exakt diese Zeile, oder wird einem die Datei zum Herunterladen angeboten, ist wahrscheinlich nicht einmal PHP selbst installiert - oder zumindest nicht richtig konfiguriert.

Installation

Empfohlene Installationsmethode

Die beste, einfachste und auch empfohlene Methode geht über den Paketmanager der jeweiligen Linux-Distribution. Das  IzzySoft APT Repository hält die dafür notwendigen RPM bzw. Debian Pakete bereit (wie man es in den eigenen Paketmanager einbindet, steht dort ebenfalls nachzulesen). Auf diese Weise werden alle Abhängigkeiten automatisch aufgelöst - und ein apt-get install histview bzw. yum install histview bringt HistView auf den Rechner.

Wer weder RPM noch Debian Pakete verwenden kann, muss sich entsprechend das TAR Archiv herunterladen. Dieses ist dann zu entpacken, woraufhin man in das entstandene Verzeichnis wechseln und make install aufrufen kann - natürlich nachdem alle anderen Abhängigkeiten aufgelöst wurden. Natürlich setzt auch dieses wiederum ein Linux-System voraus.

Vorteile dieser Installationsverfahren:

• alle Dateien landen automatisch am richtigen Platz
• alles kann auf einfache Weise wieder De-Installiert werden (apt-get remove histview, yum remove histview bzw. make uninstall)
• bei Installation über das Paketmanagement stehen künftige Updates automatisch bereit

Manuelle Installation

Wer die manuelle Installation vorzieht (oder keine andere Wahl hat), sollte zunächst sicherstellen, dass alle Anforderungen erfüllt sind. Dann geht es wie folgt weiter:

1. Das heruntergeladene TAR Archive entpacken - und zwar in ein beliebiges Verzeichnis nach Wahl. Dieses muss jedoch zumindest entweder innerhalb des Webbaums liegen, oder zumindest dorthin verlinkt bzw. mit einem Alias verfügbar gemacht sein, um vom Browser erreicht werden zu können. Besser noch ist das Entpacken in ein Verzeichnis, welches im PHP Include Pfad enthalten ist.
2. Anpassen der Konfiguration

Updates

Je nachdem, welche Art von Installation durchgeführt wurde, geht ein Update auf verschiedene Weise vonstatten:

• Mit dem Paketmanager (apt-get update, yum update histview)
• Archiv entpacken, und ein erneutes make install
• erneutes manuelles Kopieren aus dem neuen Archiv

In jedem Fall anschließend die Konfiguration auf etwaige neue Optionen prüfen.