Versionsinformationen KPM für Windows Server - Version 4.0 Release 1 Freigegeben Januar 2011 H&T Software GmbH. Technische Informationen Copyright-Informationen Copyright 2003 2011 H&T Software GmbH. Alle Rechte vorbehalten. Kein Teil dieses Dokuments darf ohne die ausdrückliche schriftliche Genehmigung der H&T Software GmbH in irgendeiner Form, sei es elektronisch oder mechanisch, zu einem beliebigen Zweck reproduziert oder übertragen werden. Beschränkungen Die mit dieser Dokumentation bereitgestellte Software wird Ihnen für Ihren eigenen Gebrauch entsprechend der mit der Software mitgelieferten Vereinbarung für Endbenutzer lizenziert. Die Informationen in diesem Dokument können ohne Vorankündigung geändert werden. Die H&T Software GmbH gewährleistet nicht, dass die Informationen Ihren Anforderungen entsprechen, oder dass die bereitgestellten Informationen fehlerfrei sind. Die Informationen können technische Ungenauigkeiten oder typografische Fehler enthalten. Neue Versionen dieses Dokuments können möglicherweise Änderungen enthalten, sofern die H&T Software GmbH neue Informationen erhält. 1
Inhaltsverzeichnis Wer dieses technische Handbuch lesen sollte... 3 Zu diesem technischen Handbuch... 3 Die Symbole in diesem Handbuch... 4 1. Die Voraussetzungen für den Einsatz von KPM... 5 Hardware... 5 Server... 5 Clients... 6 Software... 7 XAMPP-Programmumgebung... 7 Lotus Notes-Client (Version 6.X)... 7 Java Runtime Environment (JRE ab Version 1.4)... 8 Datensicherung... 8 Netzwerk... 8 2. Die Installation von KPM... 10 Schritt 1: XAMPP installieren... 10 Schritt 2: XAMPP konfigurieren... 16 Umschalten auf PHP 4... 16 PDF-Lib initialisieren... 17 MySQL-Zugang absichern... 18 phpmyadmin-zugriff korrekt konfigurieren... 22 Schritt 3: Datenbank einrichten... 22 Schritt 4: PHP-Dateien einrichten... 24 Schritt 5: Installation überprüfen... 26 3. Konfiguration des Single-SignOn... 28 Technische Realisierung... 28 Geschütztes Login-Verzeichnis... 28 Die SSPI-Technologie... 30 KPM als Intranet-Site... 30 Installation und Konfiguration... 31 Aktivierung von SSPI... 31 Definition von KPM als offizielle Intranet-Seite... 32 Konfiguration von KPM zur Unterstützung des Single-SignOn... 33 4. Einrichtung der Lotus Notes-Schnittstelle... 34 JRE installieren... 34 Benötigte Dateien von der Lotus Notes-Installation... 36 Lotus Notes-Schnittstelle konfigurieren... 37 2
Einleitung Wer dieses technische Handbuch lesen sollte Das KPM-Handbuch Technische Informationen richtet sich an alle Personen, die KPM installieren, konfigurieren, und in der täglichen Benutzung warten und betreuen. Falls Sie für einige hier erklärten Funktionen und Features ergänzende Informationen benötigen, schauen Sie bitte in den Anhang. Dort finden Sie Links auf Seiten im Internet, die Ihnen detailliertere Beschreibungen liefern. Zu diesem technischen Handbuch Kapitel 1, Die Voraussetzungen für den Einsatz von KPM beschäftigt sich vor allem mit den Leistungen, die Ihre eingesetzten Computer erbringen müssen, um die Software fehlerfrei nutzen zu können. Außerdem erfahren Sie, welche Softwareinstallationen durchgeführt werden müssen. Kapitel 2, Installation von KPM erklärt Ihnen Schritt für Schritt, welche Aktionen durchgeführt werden müssen, um KPM funktionsfähig in Ihrem Netzwerk betreiben zu können. Kapitel 3, Konfiguration des Single-SignOn unterrichtet Sie, welche Techniken für den KPM Single-SignOn eingesetzt werden, und wie Sie diese Technik für Ihre KPM-Installation nutzen können. Kapitel 4. Einrichtung der Lotus Notes-Schnittstelle zeigt Ihnen, wie Sie die Java-Schnittstelle zu Lotus Notes einrichten und konfigurieren. 3
Die Symbole in diesem Handbuch Hinweise, Vorsichtshinweise und Warnhinweise werden wie folgt eingesetzt: Hinweise sind zusätzliche, aber wichtige Informationen. Ein Hinweis lenkt Ihre Aufmerksamkeit auf wichtige Aspekte des Produkts. Das Lesen der Hinweise wird Ihnen die Verwendung des Produkts erleichtern. Vorsichtshinweise weisen auf die Möglichkeit von Datenverlust oder einen geringfügigen Sicherheitsbruch hin. Ein Vorsichtshinweis informiert über eine Situation, in der Probleme auftreten können, wenn die entsprechenden Vorkehrungen nicht getroffen werden. Beachten Sie die Vorsichtshinweise! Warnhinweise weisen auf die Möglichkeit von erheblichem Datenverlust oder eines schwerwiegenden Sicherheitsbruchs hin. Ein Warnhinweis macht auf ein schwerwiegendes Problem aufmerksam, das eintreten wird, wenn die entsprechenden Vorkehrungen nicht getroffen werden. Bitte nehmen Sie Warnhinweise sehr ernst! Uhrzeit-Hinweise finden Sie immer dann, wenn ein Kapitel Ihre Mitarbeit erfordert. Ein Uhrzeit-Hinweis gibt Ihnen eine Vorstellung davon, wie lange Sie für die Durchführung des nächsten Installationspunkts ca. einplanen müssen. Die Dauer für die Durchführung hängt stark von der Routine ab. Notizblock-Hinweise finden Sie immer dann, wenn eine von Ihnen eingegebene Information später benötigt wird. Damit alle während der Installation getroffenen wichtigen Entscheidungen für später genau dokumentiert sind, tragen Sie sich diese Informationen in Ihr Installations-Handbuch ein. 4
1. Die Voraussetzungen für den Einsatz von KPM Hardware KPM ist eine Intranet-Browseranwendung. Um KPM nutzen zu können, muss ein Webserver mit entsprechenden Features und Komponenten installiert werden, welche exakt auf den Gebrauch von KPM abgestimmt sind. Der Computer, auf dem KPM installiert wird, muss ein Windows-Betriebssystem besitzen, auf dem Webserver installiert und konfiguriert werden können. Außerdem muss er an ein Windows-Netzwerk angeschlossen sein, damit andere Benutzer mit KPM arbeiten können. Die komplette Installation von KPM wird lediglich auf einem Computer durchgeführt, ein Eingriff in die Clients ist normalerweise nicht notwendig. Im Folgenden werden die Hard- und Software- Voraussetzungen genau spezifiziert. In einem weiteren Unterkapitel wird kurz die Einbindung von KPM in Ihr Netzwerk vorgestellt und Verbindungsmöglichkeiten zu KPM aufgezeigt. Server Bitte bedenken Sie, dass die Hardware nicht nur dafür verantwortlich ist, dass die gewünschten Scripts ausgeführt werden, sondern auch den Convenience-Grad von KPM entscheidend mitbestimmt. So ist es für Sie als IT-Verantwortlicher vor allem die Aufgabe, einzuschätzen, ob es für Ihr Haus einen Mehrwert hat, 500 Euro am anzuschaffenden Server zu sparen oder die an KPM arbeitenden Firmenkundenberater mit einer schnellen Maschine dauerhaft glücklich zu machen. Die Menge der in KPM verwalteten Daten hängen von Ihrer jeweiligen Kunden- und Betreueranzahl ab. Sicherlich läuft KPM auch auf einem Desktop-PC oder einerm WindowsXP-Rechner problemlos, jedoch die mögliche Zahl der gleichzeitigen Zugriffe treibt die Prozessor- und Speicheranforderung bei komplexen Analysen und Dateizugriffen in die Höhe. Wir empfehlen daher, ab ca. 5 KPM-Usern einen Windows- Server anzuschaffen. Wir machen Ihnen hier eine Empfehlung für vier unterschiedliche Szenarien: 5
Szenario 1: 1-5 KPM-User Betriebssystem: WindowsXP / Windows 2003 Server Prozessor: Intel Core Duo Prozessor Speicher: 1 GB RAM Festplatte: 10 GB Festplattenspeicher Netzwerk: Netzwerkanbindung 100 MBit Szenario 3: 10-100 KPM-User Betriebssystem: Windows 2003 Server Prozessor: Intel DualCore Prozessor Speicher: 4 GB RAM Festplatte: 40 GB Festplattenspeicher Netzwerk: Netzwerkanbindung 100 MBit Szenario 2: 5-10 KPM-User Betriebssystem: Windows 2003 Server Prozessor: Intel DualCore Prozessor Speicher: 2 GB RAM Festplatte: 20 GB Festplattenspeicher Netzwerk: Netzwerkanbindung 100 MBit Szenario 4: > 100 KPM-User Betriebssystem: Windows 2003 Server Prozessor: Intel QuadCore Prozessor Speicher: 4 GB RAM Festplatte: 100 GB Festplattenspeicher Netzwerk: Netzwerkanbindung Gigabit Clients Einen Eingriff in die Clients ist normalerweise nicht erforderlich. Trotzdem möchten wir Ihnen hiermit eine kleine Checkliste mit auf den Weg geben, die erfüllt sein muss, um KPM benutzen zu können: Client-Checkliste: Betriebssystem: Windows XP / Windows NT Internet-Browser: Internet-Explorer, Javascript eingeschaltet Netzwerk: Netzwerkanbindung 100 MBit empfohlen 6
Software Nachdem Sie den KPM-Rechner angeschafft haben, ist es erforderlich, diesen zu installieren. Im Folgenden geben wir Ihnen eine Übersicht, welche Komponenten auf dem KPM-Server installiert werden müssen, und welche Aufgaben diese Komponenten übernehmen. Nähere Informationen zur Installation und Konfiguration dieser Komponenten finden Sie im Kapitel 2, Installation von KPM. XAMPP-Programmumgebung XAMPP bedeutet X (Windows oder Linux) 1 A (Apache) M MySQL P Php P Pdf-Support und steht für eine komplett fertig konfigurierte Programmumgebung eines Webserver-Environments, welches allen modernen Ansprüchen genügt. XAMPP bildet die Basis der KPM-Installation und muss zuerst installiert und konfiguriert werden. XAMPP übernimmt die Datenhaltung (MySQL), Script-Ausführung (PHP) und die Browser-Visualisierung (Apache-Webserver). Außerdem ist das fertig konfigurierte XAMPP für die PDF- Konvertierung und die automatische Windows-Anmeldung (Single- SignON verantwortlich. Die aktuelle XAMPP-Version wird Ihnen auf der KPM-Installations-CD mitgeliefert. Lotus Notes-Client (Version 6.X) Der Notes-Client hilft uns dabei, Daten aus KPM mit dem Lotus Domino-Server zu synchronisieren. Dazu werden gewisse.dll- Dateien des Lotus Notes-Clients benötigt. Auf diese Dateien greift die Lotus Notes-Schnittstelle zu, um Synchronisations-Optionen durchzuführen. 1 Frühere Versionen wurden lampp (Linux, Apache, ) oder wampp (Windows, Apache, ) genannt, daher wurde für die von beiden Systemen unterstützte Version ein X verwendet. 7
Diese Schnittstelle braucht eine voll funktionsfähige Lotus Notes-ID sowie eine im Adressbuch registrierte E-Mail-Adresse, die in der Lage sein sollte, Mails an hausinterne sowie externe E-Mail- Adressen (optional) zu senden. Bitte halten Sie am Tag der KPM-Installation die Lotus Notes- Installations-CD bereit. Java Runtime Environment (JRE ab Version 1.4) Um Java-Features auf dem KPM-Server zu nutzen, wird die Java- Runtime ab Version 1.4 benötigt. Diese ermöglicht, dass die.jar- Dateien der Lotus Notes-Schnittstelle korrekt ausgeführt werden können. Die aktuelle JRE ist bei www.sun.com verfügbar. Datensicherung Es ist erforderlich, KPM in Ihre eigene, hausinterne Backup- Strategie einzubinden. So können Sie den KPM-Server in die Backup-Routine Ihrer anderen Anwendungsserver hinzufügen oder ein eigenes Bandlaufwerk für die Datensicherung von KPM kaufen. KPM bietet über das Editor-Menü für jeden mit der Anwendung beauftragten Administrator die Möglichkeit, den aktuellen Stand der Datenbank zu sichern und rückzuspielen. Netzwerk KPM benötigt für die tägliche Arbeit eine zuverlässige Netzwerkanbindung, welche nicht langsamer als 100 MBit sein sollte. Es ist jedoch auch möglich, außerhalb des Unternehmens über VPN mit KPM zu arbeiten, wenn die Anbindung über ISDN / ADSL erfolgt. Die in KPM eingesetzte serverbasierte Web-Technologie entlastet Ihr Netzwerk, da die Haupt-Datenabfrage und -verarbeitung (SQL- Queries) auf dem KPM-Server stattfindet, und somit das Netzwerk nur für den Transfer der Anfrage (Request) und des Ergebnisses (Result) verwendet wird. 8
Personen, die sich außerhalb des Unternehmensnetzwerks befinden, und nicht über VPN an einer Domäne des Unternehmens angemeldet sind, können KPM nicht nutzen. Die Adresse, unter der KPM erreichbar ist, steht nur innerhalb des Unternehmens-WAN zur Verfügung. KPM kann demnach völlig Problemlos an eine freie Netzwerk-Dose angeschlossen werden. Dem Server wird eine feste IP-Adresse und evtl. ein DNS-Name (z.b. WebKPM) zugeteilt. Damit die User KPM leichter aufrufen können, empfehlen wir zusätzliche die Einstellung der KPM-Startseite in den Favoriten oder in der Unternehmenseigenen Intranet-Seite. 9
2. Die Installation von KPM Für eine komplette Installation und Konfiguration sollten Sie eine Dauer von ca. 3 Stunden einplanen. Für die Installation benötigen Sie: a) KPM-Server mit installiertem Windows XP oder Windows 2003 Server Betriebssystem, aktivierter Netzwerkverbindung und CD-Rom (alternativ USB-Port) b) KPM-Installations-CD c) Lotus Notes-Client Installations-CD Version 5.X oder 6.X In diesem Kapitel wird nur auf die technisch durchzuführenden Schritte eingegangen. Für eine detaillierte Funktionsbeschreibung der einzelnen Tools und deren Aufgaben lesen Sie bitte Kapitel 1, Die Voraussetzungen für den Einsatz von KPM, Abschnitt Software. Schritt 1: XAMPP installieren 15 Minuten a) Legen Sie die KPM-Installations-CD in das CD-Rom-Laufwerk des KPM-Servers. Öffnen Sie den Ordner KPM_Installationsdateien und dort den Ordner XAMPP. Doppelklicken Sie das Symbol der Datei xampp-win32-1.4.16- installer.exe 2 Falls Sie nicht über ein CD-Rom-Laufwerk am KPM-Server verfügen, oder dieses deaktiviert / defekt ist, so können Sie sich alternativ auch über USB oder Netzlaufwerk einen Zugriff auf die Daten der KPM-Installations-CD verschaffen. Das Handbuch geht im Folgenden jedoch immer von einem vorhandenen und intakten CD-Rom- 2 Je nach Versionswechsel der Installations-Dateien mag sich die genaue Bezeichnung ändern. 10
Laufwerk aus. Weiterhin setzen wir voraus, dass alle Aktionen direkt auf dem KPM-Server ausgeführt werden, Sie sich also lokal auf der Maschine befinden. b) Wählen Sie die Sprache Deutsch. Klicken Sie anschließend auf OK. c) Klicken Sie Weiter > d) Wählen Sie ein Installationsverzeichnis aus. Dieses Handbuch geht davon aus, dass Sie KPM in das Verzeichnis C:\Programme\KPM installieren. 11
Klicken Sie anschließend auf Installieren. e) XAMPP wird installiert. Die Installation dauert ca. 1-2 Minuten. f) Nachdem die Installation abgeschlossen ist, erscheint die folgende Meldung: g) Anschließend können Sie die für KPM relevanten Programme (Apache 2.0 und MySQL) als Dienst (Windows-Service) registrieren. Beantworten Sie dazu den folgenden Systemdialog mit Ja. 12
h) Nach einigen Port-Tests werden nun die einzelnen Dienst- Installationen einzeln abgefragt. Klicken Sie bei der Apache- Dienst-Installation auf Ja. i) Eventuell möchte die Windows-Firewall noch eine Zulassung für die vom Apache-Service benutzten Ports einstellen. Klicken Sie dann auf Nicht mehr blockieren. j) Anschließend erhalten Sie eine erfolgreiche Installations- Meldung des Apache 2.0 Services. k) Klicken Sie bei der Nachfrage für die MySQL-Dienst-Installation ebenfalls auf Ja. 13
l) Für einige Zeit erscheint ein MS-DOS-Fenster, dass Sie nicht schließen dürfen. m) Anschließend ist auch diese Service-Installation beendet. Klicken Sie OK. n) Klicken Sie bei der Frage nach dem FileZilla-FTP-Dienst bitte auf Nein. Dieser Dienst wird für den Betrieb von KPM nicht benötigt. o) Damit ist die XAMPP-Installtion beendet. Klicken Sie nun auf Ja, um den XAMPP-Control Panel zu starten. 14
p) Der XAMPP Control Panel sollte sich nun öffnen und in etwa wie folgt aussehen: q) Bitte überprüfen Sie, ob die beiden Dienste Apache und MySQL mit Running markiert sind und jeweils ein Haken bei Svc (Service) gesetzt ist. Sie können den Control Panel dann gerne schließen. Ein Klick auf wird das Panel in die Statusleiste minimieren, ein Klick auf wird das Panel schließen. r) Sie bekommen das XAMPP Control Panel jederzeit wieder über START Programme apachefriends xampp CONTROL XAMPP SERVER PANEL s) Testen Sie den manuellen Zugriff auf den Apache-Webserver, indem Sie auf dem KPM-Server http://localhost im Internet- Explorer eingeben und Return drücken. 15
t) Testen Sie bitte auch manuellen Zugriff auf die phpmyadmin- Oberfläche, indem Sie auf dem KPM-Server http://localhost/phpmyadmin im Internet-Explorer eingeben und Return drücken. Schritt 2: XAMPP konfigurieren Die voreingestellten XAMPP-Optionen passen fast genau für die Inbetriebnahme von KPM. Dennoch sind einige kleine Anpassungen durchzuführen. Umschalten auf PHP 4 5 Minuten a) Bitte beenden Sie dazu zunächst den Apache-Webserver über das XAMPP-Controlpanel. b) Öffnen Sie das KPM-Installationsverzeichnis C:\Programme\KPM und wechseln Sie dort in den Unterordner xampp\. Doppelklicken Sie die Datei php-switch.bat 16
c) Anschließend öffnet sich das Konsolen-Fenster: d) Geben Sie die Zahl 4 ein und drücken Sie die Return-Taste. Anschließend führt die Datei einige Kopier-Operationen durch. e) Drücken Sie eine beliebige Taste, um das Fenster zu schließen. f) Anschließend starten Sie bitte den Apache-Webserver über das XAMPP-Controlpanel. PDF-Lib initialisieren 5 Minuten a) Bitte beenden Sie dazu zunächst den Apache-Webserver über das XAMPP-Controlpanel. b) Öffnen Sie das KPM-Installationsverzeichnis C:\Programme\KPM und wechseln Sie dort in den Unterordner xampp\php\extensions\. Benennen Sie dort die Datei php_pdf.dll in php_pdf.old um. 17
c) Bitte kopieren Sie von der KPM-Intallations-CD aus dem Ordner XAMPP_Konfiguration die Datei php_pdf.dll in den Ordner C:\Programme\KPM\xampp\php\extensions\. d) Anschließend starten Sie bitte den Apache-Webserver über das XAMPP-Controlpanel. Bei Fehlermeldungen während des Apache-Neustarts machen Sie den eben durchgeführten Kopiervorgang rückgängig: a) Löschen Sie die neu hineinkopierte Datei php_pdf.dll. b) Nennen Sie die soeben geänderte Datei php_pdf.old in wieder in php_pdf.dll um. c) Starten Sie den Webserver erneut. Die Fehlermeldung sollte verschwinden. Setzen Sie sich am besten sofort mit uns in Verbindung. MySQL-Zugang absichern 10 Minuten Damit KPM (und nur KPM) auf die MySQL-Datenhaltung zugreifen kann, ist es erforderlich, den standardmäßig ungeschützten Zugang mit einem Passwort zu schützen. a) Öffnen Sie zunächst die phpmyadmin-oberfläche, indem Sie auf dem KPM-Server http://localhost/phpmyadmin im Internet- Explorer eingeben und Return drücken. Drücken Sie evtl. F5 (aktualisieren), wenn sich die Seite nicht direkt öffnet. Klicken Sie dort auf den Link Rechte. 18
b) Sie sehen nun die Benutzerübersicht aller MySQL-Benutzer. Klicken Sie dort in der Spalte für den (oberen) Benutzer root auf das Symbol auf der rechten Seite ( Rechte ändern). c) Es öffnet sich die Seite: Benutzer 'root'@'localhost' : Rechte ändern. Weiter unten auf der Seite finden Sie den Abschnitt Passwort ändern. Geben Sie ein Passwort ein (2x). Notieren Sie sich dieses Passwort in Ihren Installationsunterlagen unter MySQL-Kennwort Klicken Sie anschließend auf OK (unterhalb des Passwort- Feldes). 19
Bitte beachten Sie, dass in KPM wichtige Unternehmensdaten gespeichert werden. Daher empfehlen wir, ein Passwort mit den folgenden Eigenschaften zu verwenden: Länge: 9 oder mehr Zeichen, Groß- und Kleinbuchstaben sowie Zahlen, keine logischen Wörter, keine Tastaturzusammenhänge. Beispiel: Rgfs92seF oder gsde9ruij. d) Anschließend sehen Sie die Bestätigung, dass der Passwort- Wechsel vollzogen wurde. Klicken Sie anschließend auf Rechte und führen Sie die Punkte b), c) und d) für den anderen root -Benutzer durch. Bitte benutzen Sie dasselbe Passwort. Nach Änderung des unteren Benutzers wird Ihnen phpmyadmin den Zugriff verweigern. Dies ist korrekt. Bitte fahren Sie mit dem nächsten Installationspunkt fort. Achtung: Falls Sie versehentlich zunächst den unteren MySQÖ- Benutzer geändert haben, wird Ihnen phpmyadmin den Zugriff verweigern. Lesen Sie dann zunächst weiter und konfigurieren Sie anschließend den zweiten MySQL-Benutzer mit demselben Passwort. 20
e) Öffnen Sie das KPM-Installationsverzeichnis C:\Programme\KPM und wechseln dort in den Unterordner xampp\phpmyadmin\. Öffnen Sie die Datei config.inc.php (z.b. mit dem Texteditor). f) Suchen Sie dort die Zeile: $cfg['servers'][$i]['auth_type'] = 'config'; // Authentication method (config, http or cookie based)? g) Ändern Sie den Wert 'config'; auf 'http'; h) Speichern und schließen Sie die Datei. i) Öffnen Sie nun wieder die phpmyadmin-oberfläche, indem Sie auf dem KPM-Server http://localhost/phpmyadmin im Internet- Explorer eingeben und Return drücken. Alternativ können Sie das evtl. noch geöffnete Internet-Explorer-Fenster mit der Fehlermeldung aktualisieren, indem Sie dort F5 drücken. j) Sie sehen ein Anmelde-Dialogfenster. Bitte geben Sie dort als Benutzernamen root und als Passwort Ihr soeben vergebenes Passwort ein. 21
k) Wenn Sie nun wieder die phpmyadmin-oberfläche sehen können, dann war diese Operation erfolgreich. phpmyadmin-zugriff korrekt konfigurieren 5 Minuten a) Öffnen Sie nun noch einmal das KPM-Installationsverzeichnis C:\Programme\KPM und wechseln dort in den Unterordner xampp\phpmyadmin\. Öffnen Sie dort ein weiteres Mal die Datei config.inc.php (z.b. mit dem Texteditor). b) Suchen Sie die Zeile: $cfg['pmaabsoluteuri'] = ''; und geben Sie dort die Adresse ein, mit der das phpmyadmin- Tool innerhalb Ihres Netzwerks erreicht werden kann. Bitte benutzen Sie dazu den DNS-Namen des KPM-Servers: $cfg['pmaabsoluteuri'] = 'http://dewis301/phpmyadmin/'; oder die IP-Adresse des KPM-Servers: $cfg['pmaabsoluteuri'] = 'http://10.180.82.143/phpmyadmin/'; Speichern und schließen Sie die Datei. phpmyadmin benötigt diese Information, falls Sie das Tool an einem anderen PC bedienen möchten, sodass die interne Verlinkung beim Seitenwechsel nicht auf localhost zurückspringt (wie es in vorherigen Versionen der Fall war), wenn Sie Datenbanken auswählen oder Felder anpassen. Schritt 3: Datenbank einrichten 10 Minuten a) Öffnen Sie von der KPM-Installations-CD den Ordner KPM_Installationsdateien und dort den Ordner 22
KPM_Datenbank. Markieren Sie den gesamten Inhalt (Strg+A) und kopieren Sie alle Dateien (Strg+C). Wenn Sie KPM bereits genutzt haben, ist die Datenbank auf der Installations-Datei für Sie ohne Bedeutung. Nehmen Sie dazu die Inhalte des Datenbankorders Ihrer Datensicherung aus dem Ordner X(Backup-Device):\xampp\mysql\data\yyy(Ihr Datenbankordner) b) Anschließend öffnen Sie bitte das KPM-Installationsverzeichnis C:\Programme\KPM und öffnen dort den Ordner xampp\mysql\data. c) Erstellen Sie einen neuen Ordner mit einem Datenbanknamen (z.b. kpm_voba_stuttgart) Beachten Sie, dass Sie im Ordnernamen keine Großbuchstaben, Leerzeichen und Sonderzeichen verwenden. Notieren Sie sich diesen Namen in Ihren Installationsunterlagen unter Datenbank-Name d) Wechseln Sie in den eben erstellten Ordner und fügen Sie dort die Inhalte aus der Zwischenablage ein. e) Testen Sie den Zugriff auf die Datenbank, indem Sie die phpmyadmin-oberfläche öffnen. Klicken Sie dort links auf die Datenbank-Auswahlbox und überprüfen Sie, ob die Datenbank erkannt wird, und ob in den Klammern die Zahl 289 angezeigt wird. 3 3 Je nach Konfiguration darf diese Zahl etwas niedriger oder höher sein. In der Version 3.0 R8 sind es aktuell 284 Tabellen 23
f) Wählen Sie die Datenbank nun aus, indem Sie auf den Eintrag klicken (hier z.b. kpm_voba_stuttgart (151) anklicken. g) Es sollten nun alle Tabellen auf der linken Seite angezeigt werden und zudem rechts eine Detailansicht aller Tabellen zu sehen sein. h) Wenn Sie die Datenbank öffnen und alle Tabellen sehen können, war die Installation der Datenbank erfolgreich. Schritt 4: PHP-Dateien einrichten 24
10 Minuten a) Öffnen Sie von der KPM-Installations-CD den Ordner KPM_Installationsdateien und dort den Ordner KPM_Programmdateien. Markieren Sie den gesamten Inhalt (Strg+A) und kopieren Sie alle Dateien (Strg+C). b) Anschließend öffnen Sie bitte das KPM-Installationsverzeichnis C:\Programme\KPM und öffnen dort den Ordner xampp\htdocs\. c) Fügen Sie dort die Inhalte aus der Zwischenablage ein. d) Erstellen Sie einen Ordner dokumente im Ordner C:\Programme\KPM\xampp\htdocs\. e) Öffnen Sie die Datei dbconnect.php aus dem Ordner C:\Programme\KPM\xampp\htdocs\ mit einem Texteditor f) Sie sehen nun den Inhalt der Datei: g) Bitte ersetzen Sie in der Zeile $db_name= kpm 25
kpm durch den Datenbank-Namen aus Ihren Installationsdateien (z.b. kpm_voba_stuttgart ) $db_name= kpm_voba_stuttgart h) Bitte ersetzen Sie in der Zeile $db_pass= afweok2319d afweok2319d durch das MySQL-Kennwort aus Ihren Installationsdateien (z.b. Rgfs92seF ) $db_pass = Rgfs92seF i) Ihre Datei dbconnect.php sollte nun z.b. so aussehen: Bitte beachten Sie vor allem sehr Sorgfältig, dass Sie die Hochkomma-Zeichen korrekt setzen, keine Leerzeichen zwischen den Hochkommata verwenden und jede Befehlszeile genau wie in unserem Beispiel mit einem Semikolon endet. Schritt 5: Installation überprüfen 5 Minuten Öffnen Sie den Internet-Explorer und geben Sie http://localhost in die Adresszeile ein. Installieren Sie nicht direkt auf dem KPM- Server, müssen Sie http:// kpm_server_name in die Browserzeile eintragen. Dabei steht kpm_server_name für den DNS-Namen Ihres KPM-Servers. KPM sollte sich nun öffnen. 26
Damit ist die Installation erfolgreich abgeschlossen. 27
3. Konfiguration des Single-SignOn Neben der manuellen An- und Abmeldung, die in KPM immer verfügbar war und noch ist, bietet KPM seit der Version 2.7 auch die Möglichkeit einer automatischen Anmeldung (Single-SignOn) an. Durch die stärker in Microsoft Windows-eingebundene Version des Apache 2.0 Web-Servers ist es möglich, Windows-Systemdienste für Web-basierte Anwendungen zu nutzen. So können Sie den aktuell angemeldeten Windows-Benutzer dazu nutzen, um sich automatisch in KPM anzumelden. In den folgenden Abschnitten wird zunächst auf die dahinter liegende Technik eingegangen, um im Anschluss daran die Aktivierung dieser Technik mit Ihrer KPM-Installation zu erklären. Technische Realisierung Die technische Realisierung besteht im Wesentlichen aus der genauen Einrichtung und Konfiguration von drei Komponenten, welche im Folgenden ausführlich beschrieben sind. Geschütztes Login-Verzeichnis Ab Version 2.7 existiert ein Ordner /module/login/sso, der eine.htaccess -Datei beinhaltet. Diese Datei in einem Web-Verzeichnis bewirkt, dass der Zugriff auf alle Dateien unterhalb dieses Ordners nicht ohne zusätzliche Windows-Authentifizierung möglich ist. Es ist möglich, eine Liste besonderer Benutzer/Passwort-Kombinationen für diesen Ordner zu hinterlegen, oder aber den Zugriff auf nur die Mitglieder einer Domäne mit den im Windows-Repository hinterlegten Domain/User/Password- Kombinationen zu beschränken. Anders gesagt, bekommen nur Benutzer, die in Besitz der Windows-Anmeldedaten sind, Zugriff auf diesen Ordner. Genau dies wurde hier realisiert. So öffnet sich beim Aufruf dieses Ordners ein von Windows gesteuertes 28
Dialogfenster, in welchem die Windows-Anmeldedaten im Format: Domänenname\Benutzername und Passwort abgefragt werden. Beim Eingeben der falschen Daten wird das Fenster erneut auftauchen, um dem Benutzer die Möglichkeit zu geben, die eingegebenen Daten zu korrigieren. Dies passiert bis zu drei Mal. Anschließend wird eine Fehlermeldung ausgegeben: Werden die Daten allerdings korrekt eingetragen, so wird dem Benutzer der Zugriff gewährt. Er bekommt dazu keine Bestätigung angezeigt, jedoch den Inhalt des aufgerufenen Ordners. Somit ist gewährleistet, dass keine Person, die sich nicht auch in Ihrem Netzwerk anmelden kann, auf die Inhalte dieses geschützten Ordners zugreifen kann. Weitere Informationen zum Einsatz von.htaccess -Dateien finden Sie im Anhang C. Die.htaccess -Datei wurde so konfiguriert, dass diese Anmeldeinformationen manuell (durch manuelle Eingabe der Domäne/Benutzername/Passwort-Kombination) oder automatisch empfangen werden können. ------------------------- AuthType SSPI AuthName "KPM-Login" SSPIAuth On SSPIAuthoritative On Require valid-user ------------------------- Die für die automatische Übermittlung der Anmeldedaten zuständige Technologie SSPI muss dazu zunächst installiert werden. 29
Die SSPI-Technologie SSPI steht für NTLM steht für Das Apache 2.0-Modul SSPI-Auth hilft, die Informationen, welche in das Windows-Dialogfenster beim Zugriff auf einen mit einer.htaccess -Datei geschützten Ordner in PHP-Variablen auszudrücken. Die Globale $_SERVER Variable sieht nach erfolgreicher Authentifizierung so aus: [REMOTE_PORT] => 1664 [REMOTE_USER] => HINET\JHoring [AUTH_TYPE] => NTLM Bei nicht erfolgreicher Authentifizierung wird die AUsführung des Server-Scripts gestoppt. Die Variable [REMOTE_USER] wird gar nicht gesetzt. Da nur die erfolgreiche NTLM/SSPI-Authentifizierung dazu führt, dass eine Variable gesetzt wird und danach das Scripting weiter ausgeführt wird, kann somit ausgeschlossen werden, dass unauthorisierte [REMOTE_USER]- Variablen gesetzt werden und damit eine falsche automatische Anmeldung erfolgt. Bitte beachten Sie, dass die.htaccess -Datei nicht entfernt oder verändert wird. Dadurch kann es unter Umständen passieren, dass eine falsche automatische Anmeldung durchgeführt wird. KPM als Intranet-Site Damit nun die Windows-Login-Daten nicht manuell eingegeben werden müssen, sondern automatisch übermittelt werden, ist es erforderlich, dass die Intranet-Adresse von KPM für alle Internet- Explorer-Browser als offizielle Intranet-Site anerkannt wird. Für diese besonderen Sites gelten alternative Sicherheitseinstellungen und hier ist es auch möglich, dass nur für diese Intranet-Site die Windows-Anmeldedaten automatisch übermittelt werden. Wie Sie dies an einem Rechner einrichten, wird in dem nächsten Unterpunkt Installation und Konfiguration beschrieben. 30
Installation und Konfiguration Um die oben beschriebene Technik in KPM anwenden zu können, müssen mehrere Vorbereitungen getroffen werden. Aktivierung von SSPI SSPI wird die über ein Windows-Dialogfenster automatisch oder manuell übermittelten Login-Daten in PHP-Variablen umsetzen. Dazu muss das SSPI-AUTH-Modul jedoch zuerst in der Apache- Konfigurationsdatei httpd.conf freigeschaltet werden. Entfernen Sie dazu bitte das # -Zeichen vor der Zeile: LoadModule sspi_auth_module modules/mod_auth_sspi.so Starten Sie anschließend den Apache 2.0 Server neu, sodass die Änderungen auch greifen. Sie sollten nach dem Starten bei der Beschreibung des Dienstes auch einen Hinweis darauf erhalten, dass das SSPI_AUTH-Modul geladen wurde. 31
Definition von KPM als offizielle Intranet-Seite Um die Intranet-Adresse von KPM (z.b. http://10.82.115.20/kpm) als Intranet-Seite einzurichten, rufen Sie bitte die KPM-Startseite in Ihrem Internet-Explorer auf. Klicken Sie anschließend auf Extras Internetoptionen und wechseln Sie dort ins Register Sicherheit. Wählen Sie dort die Zone Lokales Intranet aus und klicken Sie anschließend auf Sites. Im nachfolgenden Dialogfenster Lokales Intranet klicken Sie bitte auf den Button Erweitert. Dort wird die KPM-Intranetadresse standardmäßig in das Feld Diese Website zur Zone hinzufügen eingetragen. Klicken Sie nun auf den Button Hinzufügen, um KPM zur Zone der Intranet-Sites hinzuzufügen. 32
Anschließend sollten Sie die Adresse im Feld Websites erkennen können. Bitte beachten Sie, dass Microsoft Windows immer nur den DNS-Namen oder die IP-Adresse als Website speichert, nicht den Unterordner oder gar einen Dateinamen. Schließen Sie nun bitte dieses Dialogfenster und auch alle weiteren Fenster, bis Sie das Menü Extras Internetoptionen verlassen haben. Konfiguration von KPM zur Unterstützung des Single- SignOn Bitte melden Sie sich in KPM mit Editor-Rechten an und öffnen Sie anschließend das Editor-Menü. Um den KPM-Autologin zu aktivieren, klicken Sie bitte in der Kategorie Allgemeine Funktionen / Einstellungen auf den Link Systemintelligenz/Extras. Aktivieren Sie dort bitte das Kästchen Autologin über SSPI und klicken anschließend auf Systemintelligenz speichern. Wählen Sie anschließend bitte Menü verlassen : In den Benutzeroptionen können Sie nun jedem Benutzer seinen Windows-Anmeldenamen zuordnen (wenn nicht schon bereits geschehen). Bitte beachten Sie, dass ab sofort alle KPM-Benutzer automatisch beim Aufrufen der Seite angemeldet werden. Wird ein Benutzername falsch in KPM eingetragen, bekommt dieser eine Fehlermeldung und muss sich weiterhin manuell anmelden. Damit sich die KPM-Benutzer immer manuell anmelden können, beachten Sie bitte auch in Zukunft, dass Sie ein Sicherheitspasswort in KPM anlegen und dies dem Benutzer mitteilen. Es wird bei aktiviertem Single-SignOn jedoch nur noch in Ausnahmefällen benötigt. 33
4. Einrichtung der Lotus Notes-Schnittstelle Die Lotus Notes-Schnittstelle ist ein optionales Feature in KPM. Sie synchronisiert KPM-Kalendereinträge mit Lotus Notes- Kalendereinträgen auf einem Lotus Domino-Server. Die Lotus Notes-Schnittstelle nutzt die offene Java-Schnittstelle von Lotus Notes, um Daten auszulesen und zu speichern. Die Voraussetzung ist ein Java-Runtime-Environment auf dem KPM- Server, damit die.jar-dateien der Lotus Notes-Schnittstelle geöffnet werden können. Eine Zusätzliche Voraussetzung ist ein installierter und mit einem Lotus Domino-Server verbundener Lotus Notes-Client der Version 6.X. Die Installation des Lotus Notes-Clients wird in diesem Handbuch nicht beschrieben, sondern für die Fertigstellung der KPM-Installation vorausgesetzt. JRE installieren 10 Minuten a) Legen Sie die KPM-Installations-CD in das CD-Rom-Laufwerk des KPM-Servers. Öffnen Sie den Ordner KPM_Installationsdateien und dort den Ordner Java Runtime Environment. Doppelklicken Sie das Symbol der Datei jre-1_5_0_11-windows-i586-p-s.exe. Im Internet finden Sie immer die neueste Java-Version unter http://www.java.com. Die Java-Version auf der KPM-Installations- CD ist die letzte mit KPM getestete Java-Version. Daher kann auch der Dateiname leicht abweichen. b) Die Installation wird nun gestartet. 34
c) Bitte akzeptieren Sie die Lizenzvereinbarung. d) Klicken Sie bei der Auswahl des Setuptyps bitte auf Standard. e) Die Installation wird nun durchgeführt. 35
f) Anschließend ist die Installation beendet. Klicken Sie bitte auf Fertigstellen, um die Installation abzuschließen. Im nächsten Schritt überprüfen wir, welche Daten und Dateien Sie von der Installation des Lotus Notes-Clients auf dem KPM-Server benötigen. Benötigte Dateien von der Lotus Notes-Installation 15 Minuten a) Lotus Notes muss in der Version 6.X auf dem KPM-Server installiert sein. Notieren Sie sich den Pfad der Lotus Notes-Installation in Ihren Installationsunterlagen unter Notes-Client-Installationspfad (z.b.: C:\Programme\Lotus\Notes ) b) KPM benötigt eine eigene Lotus Notes-ID-Datei. Daher muss KPM als normaler Lotus Notes-Benutzer in Ihrem System angelegt sein. c) Sie benötigen die ID-Datei auf dem KPM-Server, am besten im Lotus Notes-Unterverzeichnis Data (z.b. C:\Programme\Lotus\Notes\Data ) Notieren Sie sich den Pfad der ID-Datei in Ihren Installationsunterlagen unter Notes-ID-Pfad. 36
d) Sie benötigen das Passwort der ID-Datei sowie den Namen des Lotus Domino-Servers, mit dem der installierte Lotus Notes- Client kommuniziert. Notieren Sie sich dieses Passwort sowie den Server-Namen in Ihren Installationsunterlagen unter Notes-Kennwort und Notes-Mail- Server. e) Zuletzt benötigen Sie noch den Pfad der Notes-Datenbank des KPM-Notes-Kontos (.nsf-datei). Diese liegt standardmäßig im Verzeichnis \Data\mail\ und wird üblicherweise vnachname.nsf (also der erste Buchstabe des Vornamens und der Nachname, gefolgt von.nsf ) genannt. Notieren Sie sich diesen Pfad sowie den korrekten Namen der.nsf- Datei in Ihren Installationsunterlagen unter Notes-Mail-Datenbank. Bitte beachten Sie, dass nach der Notes-Installation der PC neu gestartet werden muss, da sich sonst die Windows- Umgebungsvariablen nicht aktualisieren können. Wenn Ihnen alle diese Informationen vorliegen, können Sie synckpm installieren, konfigurieren und starten. Lotus Notes-Schnittstelle konfigurieren 10 Minuten a) Bitte öffnen Sie nun in das KPM-Editor-Menü. 37
b) Klicken Sie dort auf den Menüpunkt Lotus Notes-Schnittstelle c) Stellen Sie dort bitte die intergrierte KPM / Lotus Notes- Schnittstelle auf Ja" d) Im Feld Lotus Notes Mail-DB des KPM-Users tragen Sie bitte den lokalen Pfad zur KPM-.nsf-Datei ein. In den Installationsunterlagen haben Sie den unter Notes-Mail- Datenbank notiert. e) Tragen Sie dann das Lotus Notes Mail-Passwort des KPM-Users bei ein. In den Installationsunterlagen haben Sie dieses unter Notes-Kennwort notiert. f) Tragen Sie den Lotus Notes Mailserver-Name, mit dem der Lotus Notes-Client kommuniziert, in das dafür vorgesehene Feld ein. In den Installationsunterlagen haben Sie den unter Notes- Mail-Server notiert. g) Setzen Sie das Tracelevel für Fehlermeldungen auf ALL. h) Passen Sie bitte den Lotus Notes Installations-Pfad auf dem KPM-Server an und tragen Sie dort den Pfad Ihrer Lotus Notes- Installation ein. In den Installationsunterlagen haben Sie den unter Notes-Client-Installationspfad notiert. 38