LOGOS Server Version 2.40 Installationsanleitung für Linux
Inhalt 1. Einleitung...2 2. Systemadministration...2 2.1 Systemvoraussetzungen... 2 2.1. LOGOS installieren... 2 2.2. Aktualisierung einer vorhandenen Installation... 7 2.3. Schritte nach der Installation... 8 3. LOGOS starten...10 3.1. Automatischer Start unter Debian Linux... 10 3.2. Automatischer Start unter Redhat Linux... 11 3.3. Automatischer Start unter SuSE Linux... 11 3.4. Automatischer Start unter Gentoo Linux... 11 4. Anlegen eines Administratorkontos...12 5. Im- und Export von Bäumen, Datenräumen und Skripten....12 6. Abschließende Hinweise...12 LOGOS Server 2.40 Installationsanleitung Linux knowledgetools International GmbH 2008 1
1. Einleitung Diese technische Referenz erläutert die Installation und Administration des LOGOS- Servers. 2. Systemadministration Dieses Kapitel beschreibt die Installation aller notwendigen Komponenten des LOGOS- Servers. 2.1 Systemvoraussetzungen Folgende Systemvoraussetzungen sind für die Installation des LOGOS-Servers zu erfüllen: - Linux ab Kernel 2.4, glibc 2.2 - MySQL ab Version 5 - Benötigter Festplattenspeicher: 300 MB (ohne Datenbanken) Bitte beachten Sie, dass der benötigte Speicherplatz auch durch die knowledgetools - Produkte bestimmt wird. Bilder, Videos und andere Dateien, die in den Zusatzinformationen enthalten sind, können u.u. ein Vielfaches des angegebenen Speicherplatzes benötigen. 2.1. LOGOS installieren Um LOGOS erfolgreich installieren zu können, überprüfen Sie zunächst die Systemvoraussetzungen (siehe oben). Stellen Sie sicher, dass MySQL 5 installiert ist und eine MySQL-Datenbankumgebung eingerichtet ist, in der während der Installation eine Datenbank für LOGOS angelegt werden kann. 1. Legen Sie die Installations-CD in das CD-Rom Laufwerk ein und mounten Sie die CD, falls erforderlich. Mounten Sie anschließend das Laufwerk, in das Sie die Installations-CD eingelegt haben (mount /mnt/cdrom). 2. Starten Sie das Installationsprogramm. (/mnt/cdrom/installation/setup.sh) 3. Folgen Sie nun den Anweisungen der Installationsroutine. a. Akzeptieren Sie die Lizenzbedingungen. (Abb. 1.0) LOGOS Server 2.40 Installationsanleitung Linux knowledgetools International GmbH 2008 2
Abb. 1.0 b. Geben Sie das Verzeichnis an, in dem LOGOS installiert werden soll. (Abb. 1.1) LOGOS Server 2.40 Installationsanleitung Linux knowledgetools International GmbH 2008 3
Abb. 1.1 c. Konfigurieren Sie den Zugriff auf MySQL und wählen Sie [weiter >>], um die neue Datenbank anzulegen. (Abb 1.2) LOGOS Server 2.40 Installationsanleitung Linux knowledgetools International GmbH 2008 4
Abb. 1.2 d. Installieren Sie die Lizenz (Abb. 1.3) LOGOS Server 2.40 Installationsanleitung Linux knowledgetools International GmbH 2008 5
Abb. 1.3 e. Bestätigen Sie den Abschluss der Installation. (Abb. 1.4) LOGOS Server 2.40 Installationsanleitung Linux knowledgetools International GmbH 2008 6
Abb. 1.4 2.2. Aktualisierung einer vorhandenen Installation Im Unterschied zu einer Neuinstallation werden die Verbindungsdaten zur MySQL-Datenbank nicht abgefragt. Diese Daten werden aus der vorhandenen Installation übernommen. Es erfolgt lediglich eine Aktualisierung der Programmdaten. LOGOS Server 2.40 Installationsanleitung Linux knowledgetools International GmbH 2008 7
2.3. Schritte nach der Installation Nachdem die Installation erfolgreich abgeschlossen wurde, sollte das integrierte Patchsystem aufgerufen werden, um LOGOS auf den aktuellen Stand zu bringen. Bitte stellen Sie sicher, das der Rechner auf dem LOGOS installiert ist eine HTTPS Verbindung ins Internet herstellen kann. Starten Sie den Patchvorgang mit: /opt/ktbs/bin/ktbs install-patches. Der Zugriff auf LOGOS unterliegt generell einem Passwortschutz. Bitte richten Sie ein Administratorkonto ein unter Verwendung des Kommandos /opt/kbts/bin/ktbs reset-administrator Passwort. Nach der Installation der LOGOS Software können knowledgetree-produkte in den nun installierten Server importiert sowie weitere Konfigurationsoptionen der Software gesetzt werden. Weitere typische Schritte nach der Installation: Richten Sie den automatischen Start von LOGOS ein. (siehe Kapitel 3) Prüfen Sie die Konfiguration des Webservers. Häufig veränderte Einstellungen sind der Port des Webservers (Standardeinstellung: Port 80) sowie die Einrichtung von SSL/TLS. Den Port des WebServer können Sie mit dem Kommando: #/opt/ktbs/bin/ktbs set-option port 82 ändern. Nach dem Bestätigen mit enter und Neustart des Servers, ist der Server auf Port 81 zu erreichen (http://localhost:82/knowledgetools). Eine komplette Liste der Einstellungsmöglichkeiten erhalten Sie mit: #/opt/ktbs/bin/ktbs show-options (Abb. 1.5) LOGOS Server 2.40 Installationsanleitung Linux knowledgetools International GmbH 2008 8
Abb. 1.5 Eine Liste der möglichen Kommandos erhalten Sie mit: #/opt/ktbs/bin/ktbs help (Abb. 1.6) Ein neues Feature sehen Sie ebenfalls in den Abbildungen 1.5 und 1.6. Die Management Konsole. Diese kann dazu benutzt werden via WebInterface Patches einzuspielen und den Server neu zu starten. Die Details entnehmen Sie bitte dem Nutzerhandbuch. LOGOS Server 2.40 Installationsanleitung Linux knowledgetools International GmbH 2008 9
Abb. 1.6 Vergessen Sie außerdem nicht, automatische Backups von LOGOS einzurichten, um Datenverluste zu vermeiden. knowledgetools haftet nicht für Schäden, die durch vorhandene Backups hätten vermieden werden können. 3. LOGOS starten Starten Sie LOGOS manuell wie folgt: #/opt/ktbs/bin/ktbs start Durch manuellen Aufruf von ktbs start starten Sie LOGOS einmalig bis zum Herunterfahren von Linux. Zum automatischen Start des Servers beim Booten des Computers dient das gleiche Programm, die genaue Vorgehensweise ist aber abhängig von der eingesetzten Linux-Distribution. 3.1. Automatischer Start unter Debian Linux Legen Sie zunächst einen symbolischen Link an, der aus dem Distributionsverzeichnis /etc/init.d auf das ktbs-programm verweist: #ln s /opt/ktbs/bin/ktbs /etc/init.d/ Richten Sie den automatischen Start in den Runlevels 2-5 ein: #update-rc.d ktbs defaults 99 LOGOS Server 2.40 Installationsanleitung Linux knowledgetools International GmbH 2008 10
3.2. Automatischer Start unter Redhat Linux Auf der Installations-CD für LOGOS enthalten ist ein spezielles Start-Skript zur Verwendung mit Redhat oder Fedora Linux. Kopieren Sie dieses Skript zunächst in das Distributionsverzeichnis /etc/init.d: #cp /cdrom/zubehoer/redhat/ktbs /etc/init.d/ Eine Konfigurationsvariable im Skript verweist auf das Verzeichnis von LOGOS. Bitte passen Sie das Skript entsprechend an, falls Sie LOGOS nicht im Standardverzeichnis /opt/ktbs installiert haben. Richten Sie dann den automatischen Start ein: #chkconfig --add ktbs 3.3. Automatischer Start unter SuSE Linux Auf der Installations-CD für LOGOS enthalten ist ein spezielles Start-Skript zur Verwendung mit SuSE Linux. Kopieren Sie dieses Skript zunächst in das Distributionsverzeichnis /etc/init.d: #cp /cdrom/zubehoer/suse/ktbs /etc/init.d/ Eine Konfigurationsvariable im Skript verweist auf das Verzeichnis von LOGOS. Bitte passen Sie das Skript entsprechend an, falls Sie LOGOS nicht im Standardverzeichnis /opt/ktbs installiert haben. Richten Sie dann den automatischen Start ein: #insserv d /etc/init.d/ktbs 3.4. Automatischer Start unter Gentoo Linux Auf der Installations-CD für LOGOS enthalten ist ein spezielles Start-Skript zur Verwendung mit Gentoo Linux. Kopieren Sie dieses Skript zunächst in das Distributionsverzeichnis /etc/init.d: #cp /cdrom/zubehoer/gentoo/ktbs /etc/init.d/ Eine Konfigurationsvariable im Skript verweist auf das Verzeichnis von LOGOS. Bitte passen Sie das Skript entsprechend an, falls Sie LOGOS nicht im Standardverzeichnis /opt/ktbs installiert haben. Richten Sie dann den automatischen Start im Default-Runlevel ein: #rc-update add ktbs default LOGOS Server 2.40 Installationsanleitung Linux knowledgetools International GmbH 2008 11
4. Anlegen eines Administratorkontos Der Zugriff auf LOGOS unterliegt Authorisierungsprüfungen. Die Einrichtung von Nutzerkonten und die Erteilung von Rechten zum Zugriff auf knowledgetrees erfolgt in der Nutzerverwaltung, die im knowledgetools Anwenderhandbuch beschrieben ist. Damit Sie sich zum ersten Mal auf dem Webserver einloggen und auf die Nutzerverwaltung zugreifen können, legen Sie zunächst ein Administratorkonto an. Geben Sie dazu ein: #/opt/ktbs/bin/ktbs reset-administrator NAME Der Nutzername kann beliebig gewählt werden, sollte aber eine Email-Adresse sein. Ein Passwort für das Nutzerkonto wird interaktiv abgefragt und sollte mindestens acht Zeichen lang sein. Sollte jemals das Administratorpasswort verloren gehen, ist das Kommando resetadministrator außerdem geeignet, um das Passwort zurückzusetzen und so wieder Zugriff zum Server zu erlangen. 5. Im- und Export von Bäumen, Datenräumen und Skripten. Seit der Version 2.36 finden diese Operationen im WebInterface statt. Bitte konsultieren Sie hierzu das Nutzerhandbuch. 6. Abschließende Hinweise Unsere Software unterliegt einer ständigen Weiterentwicklung. Bitte beachten Sie daher, dass sich einzelne Funktionalitäten im Rahmen von Updates bzw. Upgrades ändern können. Bei technischen Nachfragen wenden Sie sich per Email bitte an unseren technischen Support support@knowledgetools.de. LOGOS Server 2.40 Installationsanleitung Linux knowledgetools International GmbH 2008 12