name : HOWTO.INSTALL.de Inhaltsverzeichnis Einführung I. Erstellung und Installation des Kernel-Moduls II. FAQ: F: Wie führe ich die .i686- oder .x86_64-Installationsdatei aus? F: Ist die .i686-Installationsdatei kompatibel mit meiner x86_64-Architektur? F: Kann ich das Produkt auf einem IA64-System installieren? F: Das Setup-Programm findet keine Kernel-Quelldateien im Verzeichnis /lib/modules/<MY_KERNEL>/build oder /lib/modules/<MY_KERNEL>/source. Was soll ich tun? Einführung In einigen Fällen kann das Setup-Programm die notwendigen Kernel-Module nicht kompilieren oder die erforderliche Ausführungsumgebung für das Produkt nicht vorbereiten. Normalerweise informiert Sie das Setup-Programm über dieses Problem und verweist Sie auf die entsprechende Datei. Abschnitt I dieser Datei beschreibt die Erstellung und Installation des Kernel-Moduls. Sie müssen diesen Abschnitt möglicherweise lesen, falls Sie einen benutzerdefinierten Kernel haben oder einen vom Standard abweichenden Speicherort der Kernel- Quelldateien. I. Erstellung und Installation des Kernel-Moduls Das Produkt kann unter folgenden Linux- Distributionen mit Kernel 2.4.20 bis 4.4 und glibc 2.3.2 (oder höher) installiert werden: (a) Red Hat Enterprise Linux 4.x, 5.x, 6.x, 7.0, 7.1, und 7.2 (b) Ubuntu 9.10, 10.04, 10.10, 11.04, 11.10, 12.04, 12.10, 13.04, 13.10, 14.04, 14.10, 15.04 und 15.10 (c) Fedora 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21 22 und 23 (d) SUSE Linux Enterprise Server 10 und 11 SUSE Linux Enterprise Server 12 – wird mit allen Dateisystemen außer Btrfs unterstützt (e) Debian 4, 5, 6, 7.0, 7.2, 7.4, 7.5, 7.6, 7.7, 8.0, 8.1, 8.2 und 8.3 (f) CentOS 5.x, 6.x, 7 und 7.1 (g) Oracle Linux 5.x, 6.x, 7.0, 7.1 und 7.2 -- sowohl Unbreakable Enterprise Kernel wie auch Red Hat Compatible Kernel Kernel (h) CloudLinux 6.x (i) ClearOS 5.x, 6.x, 7 und 7.1 Bei jeder dieser Distributionen kompiliert das Setup-Programm automatisch das Kernel-Modul, das erforderlich ist, damit das Produkt korrekt arbeitet. Falls das Setup-Programm das Kernel-Modul nicht kompilieren kann, müssen Sie dies manuell folgendermaßen selbst tun. Sie müssen die Kernel-Quelldateien installieren, die entsprechende Konfigurationsdatei und alle Pakete, die zur Erstellung des Kernels erforderlich sind. Diese Pakete beinhalten 'gcc', 'make', und 'kernel-devel'. Es erfolgt eine Nachfrage über die erforderlichen Pakete, wenn die Kernel-Quelldateien installiert werden. Normalerweise können Sie das 'SnapAPI'-Kernel-Modul erstellen und installieren, indem Sie die 'dkms'-Befehle folgendermaßen ausführen: # dkms build -m <Modulname> -v <Modulversion> \ --config <CONFIG-Datei> --arch <KERNEL-ARCH> \ --kernelsourcedir <Pfad_zu_den_KERNEL-Quellen> # dkms install -m <Modulname> -v <Modulversion> \ --config <CONFIG-Datei> --arch <KERNEL-ARCH> \ --kernelsourcedir <Pfad_zu_den_KERNEL-Quellen> In diesen Befehlen: muss <Modulname> eine der folgenden Varianten sein: (a) Für 2.4.x-Kernel: snapapi (b) Für 2.6.x- und 3.x-Kernel: snapapi26 <Modulversion> ist die Version des 'snapapi'-Moduls. Sie können diese ermitteln, indem Sie folgenden Befehl ausführen: # ls /usr/src | grep snapapi Falls beispielsweise der Name des Verzeichnisses 'snapapi26-0.7.64' lautet, dann ist der Wert von <Modulversion>: 0.7.64 <CONFIG-Datei> ist der Name Ihrer Kernel-Konfigurations- Datei. Diese Datei befindet sich üblicherweise im Verzeichnis /boot. Spezifizieren Sie den vollständigen Dateinamen, beispielsweise: /boot/config-2.6.31-14-generic <KERNEL_ARCH> ist der Typ der Kernel-Architektur, beispielsweise: i686. Sie können den Wert für <KERNEL_ARCH> ermitteln, indem Sie die folgenden Befehle ausführen: (a) Für RPM-basierte Distributionen, wie etwa Red Hat Enterprise Linux, CentOS oder Fedora: # rpm -q --queryformat "%{ARCH}\n" kernel (b) Für nicht auf RPM basierende Distributionen, wie etwa Ubuntu: # uname -m Weitere Details über die Verwendung von dkms finden Sie in den Manpage zu dkms. Nach erfolgreicher Erstellung und Installation des Kernel- Moduls können Sie das Produkt ausführen, um seine Funktionalität zu überprüfen. Die passenden Kernel-Module werden automatisch geladen. II. FAQ F: Wie führe ich die .i686- oder .x86_64-Installationsdatei aus? A: Es handelt sich um eine übliche Binärdatei. Zum Start der Installation müssen Sie folgende Befehle ausführen: # chmod +x <Dateiname> # ./<Dateiname> Wobei <Dateiname> der Name Ihrer .i686- oder .x86_64- Installationsdatei ist. Das Setup-Programm verwendet den RPM-Paketmanager (RPM). Bevor Sie das Produkt auf einem System installieren, das keinen RPM verwendet (wie etwa ein Ubuntu-System), müssen Sie den RPM installieren; beispielsweise, indem Sie folgenden Befehl als Benutzer Benutzer: #apt-get install -y rpm F: Ist die .i686-Installationsdatei kompatibel mit meiner x86_64- Architektur? A: Nein, Sie müssen die korrespondierende .x86_64-Installationsdatei herunterladen und installieren, statt der .i686-Installations- Datei. Die Installationsprozedur ist dieselbe. F: Kann ich das Produkt auf einem IA64-System installieren? A: Nein, diese Architektur wird von diesem Produkt nicht unterstützt. F: Das Setup-Programm findet keine Kernel-Quelldateien im Verzeichnis /lib/modules/<MY_KERNEL>/build oder im Verzeichnis /lib/modules/<MY_KERNEL>/source. Was soll ich tun? A: Dies bedeutet üblicherweise, dass Sie die Kernel- Quelldateien installieren müssen, die zu Ihrer Kernel-Version korrespondieren. Folgende Befehle installieren die Kernel-Quelldateien in Debian und Ubuntu: $ sudo apt-get update $ sudo apt-get install linux-headers-`uname -r` $ sudo apt-get install linux-image-`uname -r` Folgender Befehl installiert die Kernel-Quelldateien in Red Hat Enterprise Linux und Fedora: # yum install kernel-devel-`uname -r`