Einrichtung einer Projektzeitenmanager Datenbank auf einem mysql Datenbankserver Mit Hilfe des Programmes pzmadmin v1.6.x
Inhaltsverzeichnis Inhaltsverzeichnis...2 Voraussetzungen...3 Schritt 1: Verbindungsdaten eingeben...4 Schritt 2: Verbindung testen...5 Schritt 3: Mit Datenbank verbinden...6 Schritt 4: Datenbankstruktur einrichten...7 Schritt 5: Berechtigungen setzen...8 Schritt 6: Lizenz eingeben und überprüfen...10 Services...12 Lizenz ändern...13 Wechsel auf Version 1.5.x...14 Zweitinstallation...15 Anhang: Zugriffsrechte auf den mysql Datenbankserver...16 Administrator ermitteln unter Windows...16 mysql-datenbankserver Zugriffsrechte ändern...17 Abbildungsverzeichnis...18 pzmadmin Handbuch 2
Voraussetzungen Für die Datenbank des Projektzeitenmanagers wird ein mysql Server benötigt. Getestet wurde die Software mit den mysql Version 3.23.x unter den Betriebssystemen Windows 98, Windows 2000, Windows 2000 Advanced Server und Linux (Suse 8.0). Seit Version 1.5.4 wird auch mysql 4.0 unterstützt (getestet bis 4.0.20). Der mysql Server muss installiert sein, bevor darauf die Datenbank installiert werden kann. Der Name der Datenbank ist pzm_v1. Wird dieser Name schon von einem anderen Programm als dem Projektzeitenmanager benutzt, setzen Sie sich bitte mit uns in Verbindung. Für die Installation muss ein gültiger Administrator Account zum mysql Server vorhanden sein, d.h es müssen Loginname und Passwort des Administrators bekannt sein. Hinweis: Wird das Programm pzmadmin auf einem anderen Rechner gestartet als auf dem Rechner, auf dem der Datenbankserver läuft, muss der Administrator Account auch von dem anderen Rechner erreichbar sein (dies ist default-mässig nicht so!). Ist dieser Account mit diesen Zugriffsrechten noch nicht vorhanden, muss dieser entsprechend eingerichtet bzw. konfiguriert werden (Anleitung siehe Anhang). pzmadmin Handbuch 3
Schritt 1: Verbindungsdaten eingeben Nach dem Start des Programms pzmadmin erscheint das Hauptfenster. Abbildung 1: Hauptfenster Um eine neue Verbindung anzulegen, drücken Sie bitte zuerst den Button Neu. Abbildung 2: Button Neu" Daraufhin erscheint ein Verbindungsdatendialog. In diesen werden die Verbindungsdaten eingegeben. I Abbildung 3: Verbindungsdatendialog pzmadmin Handbuch 4
Im Feld 'Verbindungsname' wird ein Name eingetragen, der zur Kennzeichnung der Verbindung dient. Dieser Verbindungsname ist frei wählbar und hat nichts mit dem Rechnernamen zu tun, auf dem der Datenbankserver läuft. Da er in der Registry gespeichert wird, steht er bei jedem Aufruf des Programmes pzmadmin wieder zur Verfügung. Das Feld mit der Überschrift DB Servername / IP-Nummer dient zur Eingabe des symbolischen Namens des Datenbankservers bzw. seiner IP-Nummer. Läuft das Programm auf dem gleichen Rechner, auf dem auch der Datenbankserver läuft, kann hier auch localhost eingetragen werden. Dieses Feld darf ebenso wie das Feld Verbindungsname nicht leer bleiben! Hinweis: Wird ein symbolischer Name eingetragen, muss darauf geachtet werden, dass dieser Name auch auf eine IP-Nummer aufgelöst werden kann. Ob dies möglich ist, kann z.b. mit dem Befehl 'ping' überprüft werden. Sicher ist immer die Eingabe der IP-Nummer oder localhost beim gleichen Rechner. Schritt 2: Verbindung testen Sind Verbindungs- und Datenbankservername eingetragen, kann die Verbindung getestet werden. Dies geschieht durch Drücken des Buttons Verbindung testen.... Es erscheint der Login-Dialog. Abbildung 4: Login-Dialog In das Feld User Name wird der Name des mysql-administrators, in das Feld Password wird sein Passwort eingetragen. Hat der Administrator kein Passwort, bleibt dieses Feld leer. Schlägt der Anmeldeversuch fehl, erscheint folgendes Fenster: Abbildung 5: Fehlermeldung bei mißglücktem Login Hinweis: Die häufigsten Gründe für fehlgeschlagene Anmeldeversuche sind: - Der Benutzername und / oder das Passwort sind falsch eingetippt oder gänzlich unbekannt. (Groß- und Kleinschreibung beachten!) pzmadmin Handbuch 5
- Das Programm pzmadmin läuft auf einem anderen Rechner als der mysql- Server und der root-zugriff hat nicht die Berechtigung, sich von einem anderen Rechner aus anzumelden (vgl. Anhang). Erst nachdem der Verbindungstest erfolgreich war, wird der OK-Button aktiv und die Verbindungsdaten werden übernommen. Das Programm pzmadmin ist aber noch nicht (!) mit der Datenbank verbunden. Schritt 3: Mit Datenbank verbinden Zum Verbinden mit der Datenbank wird der Login-Dialog benutzt. Dieser öffnet sich automatisch, nachdem eine neue Verbindung angelegt wurde und das Verbindungsdatenfenster über den OK-Button verlassen wird. Vom Hauptfenster aus können Sie den Login-Dialog nach Auswahl einer Verbindung in der Verbindungsdaten-Combobox über den Button Connect erreichen. Abbildung 6: Hauptfensterausschnitt mit Verbindungsdaten-Combobox, Connct-Button Wenn eine neue Verbindung angelegt wurde, sind im Login-Dialog bereits Username und Password der neuen Verbindung eingegeben. Der Username wird bei jedem Aufruf des Login-Dialogs automatisch gesetzt. Wird das Häkchen bei Passwort speichern gesetzt, erscheint auch das Passwort automatisch. Abbildung 7: Login-Dialog mit der Möglichkeit zum Passwort speichern Drücken des OK-Buttons stellt die Verbindung zur Datenbank her. Dies wird auch in der Statusleiste des Hauptfensters angezeigt. Abbildung 8: Statuszeile des Hauptfensters pzmadmin Handbuch 6
Schritt 4: Datenbankstruktur einrichten Nachdem sich das Programm pzmadmin mit dem mysql-datenbankserver verbunden hat, ist es möglich, die Struktur der Datenbank pzm_v1 anzulegen. Abbildung 9: Hauptfenster mit Reiter Datenbank einrichten Durch das Drücken des Buttons Datenbankstruktur einrichten werden alle Tabellen, die für die Arbeit mit dem Projektzeitenmanager benötigt werden, eingerichtet. Hinweis: Wird beim Verbinden mit dem Datenbankserver festgestellt, dass die Datenbank pzm_v1 schon vorhanden ist, fehlt komplett der Reiter Datenbank einrichten! Damit soll verhindert werden, dass versehentlich eine bestehende Datenbank, in der möglicherweise schon wichtige Daten vorhanden sind, gelöscht wird. Soll die Datenbank trotzdem gelöscht werden, muss der Datenbankadministrator dies auf Datenbankebene tun oder ein externes Datenbankverwaltungstool verwenden. Das untere Protokollfenster gibt darüber Auskunft, ob die Aktion erfolgreich war oder nicht. Bei Erfolg werden auch Administratorname und passwort der pzm_v1 -Datenbank angezeigt. Der Name ist admin und das Passwort pzmadmin. Mit diesen kann sich der pzm_v1 -Administrator beim Login des Projektzeitenmanagers anmelden. Dort können Name und Passwort selbstverständlich geändert werden. pzmadmin Handbuch 7
Abbildung 10: Hauptfenster mit Einrichtungsprotokoll Schritt 5: Berechtigungen setzen Nachdem die Datenbankstruktur erfolgreich eingerichtet wurde, ist es jetzt an der Zeit, die Berechtigung für den Zugriff der Clients des Programmes Projektzeitenmanager auf die eingerichtete Datenbank zu setzen. Damit außer dem mysql-administrator und den Projektzeitenmanager Clients niemand auf die Datenbank pzm_v1 des Projektzeitenmanagers zugreifen kann, wird sie durch ein Masterpasswort geschützt. Dieses wird verschlüsselt in der Datenbank abgelegt. Die Clients sind in der Lage dieses zu entschlüsseln. Hinweis: Sollte das bei Auslieferung voreingestellte Passwort bekannt werden, kann jeder der es kennt, die Datenbank mit anderer Software manipulieren. Auf der Berechtigungen setzen Seite sollte deshalb im Masterpasswort- Eingabefeld ein eigenes Masterpasswort eingegeben werden. Damit die Eingabe in die Datenbank übernommen wird, muss anschließend der Button DB-Berechtigungen einrichten... gedrückt werden. Abbildung 11: Button DB-Berechtigungen einrichten... und Eingabefeld für das Masterpasswort Das Masterpasswort müssen Sie sich nur merken, falls Sie ohne mysql- Administratorrechte mit einem Drittprogramm auf die Datenbank zugreifen möchten. Dieses Passwort kann aber auch jederzeit nachträglich verändert werden. pzmadmin Handbuch 8
Abbildung 12: Warnmeldung Warnmeldung: Bekommen Sie diese Warnmeldung, liegt dies daran, dass Sie pzmadmin auf dem Computer ausführen, auf dem auch die Datenbank installiert ist, aber die besstehenden Berechtigungenseinstellungen jedem Nutzer auf diesem Computer den Zufrif auf alle mysql-datenbänke nur ohne Passwort erlauben. Da der Verbindungsaufbau des Projektzeitenmanagers aber mit Passwort erfolgt, würde dies fehlschlagen. Wenn Sie nicht von dem Datenbankserver aus mit dem Projektzeitenmanager arbeiten wollen, können Sie den Eintrag auch bestehen lassen. Es kann dann allerdings auch keine Testverbindung aufgebaut werden. Wird der Dialog bejaht, können Sie administrative Aufgaben beim mysql- Server nur noch mit dem Namen und Passwort eines mysql-benutzers vornehmen, der Supervisorrechte hat. Nach erfolgreicher Einrichtung der Berechtigungen erhalten Sie folgendes Meldungsfenster mit entsprechendem Protokoll. Abbildung 13: Berechtigung setzen, Protokoll pzmadmin Handbuch 9
Schritt 6: Lizenz eingeben und überprüfen Im letzten Schritt wird die Datenbank mit einer gültigen Lizenz versorgt. Für die erste Eingabe einer Lizenz wird der Button Ändern benutzt - obwohl noch keine Lizenz eingegeben ist, die geändert werden könnte. Abbildung 14: Hauptfenster, Reiter Lizenz Durch Drücken des Buttons Ändern öffnet sich das Lizenzfenster. Wenn der Button Lizenzdatei laden gedrückt wird, erscheint ein Datei öffnen -Dialog. Öffnen Sie mit diesem die Datei pzm_key.txt. Die in dieser Datei enthaltenen Lizenzschlüssel werden sofort in die entsprechenden Felder des Lizenzfensters übernommen. Abbildung 15: Lizenzfenster mit eingegeben Schlüsseln Alternativ können die verschlüsselten Lizenzdaten in die jeweiligen Felder per Hand eingegeben werden. Die verschlüsselten Lizenzdaten finden Sie auf dem Blatt Projektzeitenmanager Registrierungsinformationen, welches Sie zusammen mit der Projektzeitenmanager-CD erhalten haben. pzmadmin Handbuch 10
Wenn alle Felder versorgt sind, drücken Sie bitte den Button Keys testen. Ein eingebauter Algorithmus überprüft, ob die Eingaben richtig sind. Wenn dies der Fall ist, werden die Lizenzschlüssel im Klartext angezeigt und der OK- Button wird aktiviert. Abbildung 16: Lizenzfenster, Anzeige im Klartext Mit Drücken des OK-Buttons werden die Eingaben in die Datenbank übertragen. Ein Klick auf den Logout Button löst die Verbindung zur Datenbank und gibt den Ende Button frei, mit dem Sie das Programm pzmadmin beenden. Abbildung 17: Logout Button Die Datenbank ist jetzt komplett eingerichtet. Für die Anmeldung mit dem Projektzeitenmanager wurde ein Nutzer admin mit dem Passwort pzmadmin angelegt. Weitere Nutzer können Sie direkt im Programm Projektzeitenmanager anlegen. pzmadmin Handbuch 11
Services Datenbank konsolidieren Im Zuge der Weiterentwicklung des Projektzeitenmanagers können für Projekte jetzt Sollzeiten vorgegeben werden. Werden mit einem Projektzeitenmanager der Version 1.3.1 (oder älter) Einträge in der Datenbank vorgenommen, werden diese bei der Soll/Ist-Anzeige nicht berücksichtigt. Durch Drücken des Starten Buttons unter Datenbank konsolidieren werden die Einträge auf ihre Korrektheit geprüft und gegebenenfalls entsprechend erweitert. Abbildung 18: Hauptfenster, Reiter Services Das Meldungsfenster zeigt an, dass die Soll/Istzeiten wieder alle korrekt angezeigt werden können. Abbildung 19: Meldung nach erfolgter Konsolidierung pzmadmin Handbuch 12
Lizenz ändern Um sich die aktuell verwendeten Lizenzdaten im Klartext anzeigen zu lassen, drücken Sie einfach den Button Abfragen. Abbildung 20: Anzeige der aktuellen Lizenzdaten Wenn Sie neue Lizenzdaten haben (z.b. wegen Ablauf der Testlizenz oder einer Erhöhung der Nutzeranzahl), können Sie die Lizenzdaten wie in Schritt 6 beschrieben eingeben. Die alten Daten werden einfach überschrieben. pzmadmin Handbuch 13
Wechsel auf Version 1.5.x Wird von einer älteren Version des Projektzeitenmanagers auf die Version 1.5 (oder höher) gewechselt, so ist eine Anpassung der Datenbank notwendig. Diese kann vom Programm pzmadmin nur in Version 1.5 (oder höher) durchgeführt werden. Es ist daher notwendig, die entsprechende Version des Programms pzmadmin zu installieren. Es kann einfach über die alte Version installiert werden. Wenn im Programm pzmadmin die Verbindung zur Datenbank hergestellt wird, prüft es automatisch, ob eine Anpassung notwendig ist. Ist dies der Fall, erscheint das folgende Fenster. Abbildung 21: Meldung, dass die Datenbank angepasst wird Kurze Zeit nach Bestätigung der Meldung mit OK zeigt ein Fenster die vollzogene Anpassung an. Abbildung 22: Meldung nach erfolgreichenr Datenbankanpassen Eine Zeiterfassung mit einer älteren Projektzeitenmanagerversion führt zu Fehlern bei der Soll/Ist Anzeige. Sollte dies versehentlich passiert sein, kann mit dem Programm pzmadmin unter Services, Datenbank konsolidieren, der Fehler bereinigt werden. pzmadmin Handbuch 14
Zweitinstallation Der Datenbankname des Projektzeitenmanagers ist auf pzm_v1 festgelegt. Durch die Festlegung wird der sichere Zugriff auf die Daten durch die Clients gewährleistet. Sollen auf einem Server zwei Projektzeitenmanager Datenbanken angelegt werden, so müssen sie unterschiedliche Namen haben. Es ist deshalb nicht möglich, für verschiedene Abteilungen auf einem Server einfach jeweils eigene Datenbänke anzulegen. Zu diesem Zweck sind besondere Varianten des Projektzeitenmanagers und des Programmes pzmadmin erforderlich. Sie sind mit der normalen Version identisch, die Daten werden aber in einer Datenbank pzm_v1a gespeichert. Die Installation und Benutzung dieser Variante erfolgt völlig analog zu der des normalen Projektzeitenmanagers, so dass dafür keine zusätzliche Dokumentation erforderlich ist. pzmadmin Handbuch 15
Anhang: Zugriffsrechte auf den mysql Datenbankserver Administrator ermitteln unter Windows Wenn Sie mysql auf einem Computer mit Windows-Betriebssystem installiert haben, gibt es einen einfachen Weg Namen und Passwort des bei der Installation angelegten mysql-administrators zu ermitteln. - Aktivieren Sie WinMySQLadmin durch einen Klick auf die Ampel im System-Tray der Taskleiste. - Klicken Sie auf Show me. - Wechseln Sie durch Klick auf den Reiter my.ini Setup auf die entsprechende Registerkarte. - Die Einträge unter user und password enthalten den gesuchten Namen und das dazugehörige Passwort. pzmadmin Handbuch 16
mysql-datenbankserver Zugriffsrechte ändern Falls der Rechner, auf dem das Programm pzmadmin läuft, ungleich dem Rechner ist, auf dem der mysql Datenbank-Server läuft, muss der Root-Zugriff auf den mysql Datenbankserver soweit abgeändert werden, dass auch von anderen Rechnern (einer anderen IP-Adresse) zugegriffen werden kann. Nachfolgend wird beschrieben 1, wie dies vorgenommen werden kann. Nachdem die Arbeit mit dem pzmadmin beendet wurde und die Datenbank für den Projektzeitenmanager eingerichtet wurde, kann dieser Eintrag wieder rückgängig gemacht werden. Damit das Programm pzmadmin ein Setup der Datenbanken von einem anderen Rechner aus vornehmen kann, müssen die Zugriffsberechtigungen für den Administrator in der Systemdatenbank von mysql erweitert werden. Führen Sie folgende Schritte aus: 1. Wechseln Sie auf die Kommandozeile unter Windows 9x, ME, 2000, XP oder führen Sie eine Shell unter UNIX (LINUX) aus. 2. Wechseln Sie in das Verzeichnis, in dem sich der mysql-client befindet ( mysql.exe unter Windows-Betriebssystemen bzw. mysql unter UNIX (LINUX). 3. Verbinden Sie den Client mit der mysql-systemdatenbank ( mysql ): In der Regel geht dies durch den Aufruf mysql mysql, wenn auf dem Computer alle lokalen Nutzer volle Zugriffsrechte haben. Ansonsten muß der Aufruf mit Nutzernamen und Passwort erfolgen: mysql -u"root" -p"adminpassword" mysql wobei root der Administrator und adminpasswort das ihm zugehörige Passwort ist. 4. Nun haben Sie zwei Möglichkeiten: Entweder Sie legen einen zusätzlichen Adminstraroraccount an: insert into user values('%', 'admin', Password('adminpassword'), 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y'); oder Sie erweitern den Zugriff für den vorhandenen Adminstrator auf den Zugriff von allen Clients aus: update user set host="%" WHERE user="root" and host="localhost"; 5. Nun verlassen Sie den client mit exit und laden die Systemdatenbanken neu: mysqladmin reload oder mysqladmin -u"root" -p"adminpassword" reload, wenn der Administrator ein Passwort hat (s.o.) Danach sollte die weitere Einrichtung mit dem Programm pzmadmin von einem externen Rechner möglich sein. 1 Diese Beschreibung kann und soll nicht ein mysql Administratorhandbuch ersetzen. Sie zeigt einen pragmatischen Weg auf, der einfach nachvollziehbar ist und beschritten werden kann. Tiefergehende Informationen können dem mit mysql gelieferten Handbuch entnommen werden oder unter folgender URL nachgeschlagen werden http://www.mysql.com/documentation/index.html. pzmadmin Handbuch 17
Abbildungsverzeichnis Abbildung 1: Hauptfenster...4 Abbildung 2: Button Neu"...4 Abbildung 3: Verbindungsdatendialog...4 Abbildung 4: Login-Dialog...5 Abbildung 5: Fehlermeldung bei mißglücktem Login...5 Abbildung 6: Hauptfensterausschnitt mit Verbindungsdaten-Combobox, Connct-Button...6 Abbildung 7: Login-Dialog mit der Möglichkeit zum Passwort speichern...6 Abbildung 8: Statuszeile des Hauptfensters...6 Abbildung 9: Hauptfenster mit Reiter Datenbank einrichten...7 Abbildung 10: Hauptfenster mit Einrichtungsprotokoll...8 Abbildung 11: Button DB-Berechtigungen einrichten... und Eingabefeld für das Masterpasswort...8 Abbildung 12: Warnmeldung...9 Abbildung 13: Berechtigung setzen, Protokoll...9 Abbildung 14: Hauptfenster, Reiter Lizenz... 10 Abbildung 15: Lizenzfenster mit eingegeben Schlüsseln... 10 Abbildung 16: Lizenzfenster, Anzeige im Klartext... 11 Abbildung 17: Logout Button... 11 Abbildung 18: Hauptfenster, Reiter Services... 12 Abbildung 19: Meldung nach erfolgter Konsolidierung... 12 Abbildung 20: Anzeige der aktuellen Lizenzdaten... 13 Abbildung 21: Meldung, dass die Datenbank angepasst wird... 14 Abbildung 22: Meldung nach erfolgreichenr Datenbankanpassen... 14 pzmadmin Handbuch 18