SchILD-NRW mit Datenbank eines MySQL Servers (Version 5.1) Installationsanleitung überarbeitet von OStR Ralf Börger Inhalt 1 Einleitung... 2 1.1 Notwendige Dateien für Installation... 2 2 Server-Installation... 3 2.1 Den MySQL-Server installieren... 3 2.2 Den Server starten und eine Server Instanz konfigurieren... 5 2.3 MySQL GUI Tools Bundle als Administrations- und Migrationstool installieren... 7 2.4 Installation des Migrationsprogramm für SchILD NRW von ribeka... 10 3 Datenbank für SchILD-NRW einrichten... 12 3.1 Einrichtung der Datenbank auf dem Server... 12 4 User Client-Installationen... 14 4.1 MySQL-ODBC-Treiber installieren... 14 5 Zugriff von SchILD-NRW auf die MySQL-Datenbank einrichten... 16 5.1 ODBC-Datenquelle einrichten... 16 5.2 UDL-Datei anlegen... 19 5.3 Datenbank-Anmeldungsparameter in die SchILDBenutzerverwaltung... 21 5.4 Benutzer anlegen... 22 6 Daten-Migration aus einer ACCESS-Datenbank in die MySQLDatenbank... 25 7 Datensicherung... 27
1 Einleitung SchILD-NRW kann auch mit dem OpenSource-Datenbanksystem MySQL betrieben werden. Das bedeutet, dass die Datenhaltung nicht in einer Access Datenbank erfolgt, sondern auf einem Datenbank- Server. Die Dateneingabe und pflege erfolgt weiterhin über die bekannte Oberfläche der Schildsoftware, d.h. SchILD-NRW ist weiterhin eine reine Windows-Anwendung und muss unabhängig davon, unter welchem Betriebssystem der Datenbankserver läuft, auf einem Windows-Rechner als sogenannter Client gestartet werden. Der Aufwand zur Einrichtung von Schild mit einer MySQL Datenbank, ist dann sinnvoll, wenn mehrere Personen gleichzeitig mit Schild arbeiten müssen. Bei einem gleichzeitigem Zugriff auf eine Access Datenbank können in einem Netzwerk erhebliche Probleme auftreten, die systematisch nur durch den Serverbetrieb der Datenbank von Schild umgegangen werden kann. Der Einsatz eines Microsoft SQL Servers wird an anderer Stelle beschrieben. Gegenüber einer ACCESS-Datenbank bietet eine MySQL-Datenbank daher die folgenden Vorteile: Schnellerer Zugriff im Netzwerk Höhere Datensicherheit, da kein Zugriff auf Dateiebene notwendig ist. MySQL-Datenbanksysteme sind für Windows- und Linux-Betriebssysteme verfügbar, d.h. die Datenbank kann auf einem Windows- oder Linux-Server installiert werden. In diesem Dokument werden die einzelnen Schritte zur Installation der MySQL- Software und zur Anbindung SchILD-NRW Clients an einer MySQL-Datenbank erläutert. Dabei werden gewisse Kenntnisse in der Verwaltung eines Windows- bzw. Linux-Systems vorausgesetzt. Wichtiger Hinweis: Die nachfolgend angegebenen Dateinamen und Internetadressen geben den Zustand vom 03.02.2011 wieder. Da MySQL kontinuierlich weiterentwickelt wird, können die Angaben (insbesondere Versionsnummern) zu den Dateinamen bei zukünftigen Versionen abweichen. Bitte beachten Sie dies auch bei den Installationsanleitungen. 1.1 Notwendige Dateien für Installation Für die Installation auf Windows Systemen werden die folgenden Dateien benötigt, die Sie von den jeweils angegebenen Internetseiten herunterladen können. 1. Der MySQL Community Server kann von http://www.mysql.de/downloads/mysql/5.1.html#downloads herunter geladen werden. 2. Das MySQL GUI Tools Bundle mysql-gui-tools-5.0-r17-win32.msi ist unter http://dev.mysql.com/downloads/gui-tools/5.0.html zu finden.
Alternativ kann zukünftig eventuell die MySQL Workbench genutzt werden. Zur Zeit ist aber die Integration eines Migrationstools noch nicht erfolgt. Die MySQL Workbench laden unter Sie http://www.mysql.de/downloads/workbench/ herunter. 3. Das Setup für den MySQL-ODBC-Treiber Connector/ODBC steht unter http://www.mysql.de/downloads/connector/odbc/ zur Verfügung. 4. SQL-Skript zur Erstellung der Datenbank für SchILD-NRW schild_mysql.sql, Link: http://www.svws.nrw.de/uploads/media/schild_nrw_mysql.zip 5. Die Setupdatei zum Migrationsprogramm für Schild- NRW kann unter www.ribeka.com/dateidownload/schild/schild-mig/schildmigration.exe (Setup des Migrationsprogrammes) oder www.ribeka.com/dateidownload/schild/schild-mig/schildmigration.zip (als Zip Datei) herunter geladen werden. 6. Eine aktualisierte Version der Benutzerverwaltung finden Sie unter www.ribeka.com/dateidownload/schild/schild-nrw/useradmn.zip 2 Server-Installation Im Folgenden wird beschrieben, wie Sie den MySQL-Server unter Windows installieren und den MySQL Server starten. 2.1 Den MySQL-Server installieren Falls noch nicht geschehen, laden Sie von den in Abschnitt 1 Notwendige Dateien für Installation angegebenen Internetadressen das MySQL-Setup für Windows herunter. Starten Sie anschließend am dem Rechner, der als Server eingesetzt werden soll, das Programm mysql-essential-5.1.54-winx64.msi. Nach dem Begrüßungsfenster erscheint ein Fenster, in dem Sie den Setup-Typ festlegen müssen. Wählen Sie hier die Option Typical aus und aktivieren Sie den Schalter Next.
Hinweis: Falls Sie den Server nicht im Verzeichnis C:\Programme\MySQL\MySQL Server 5.1 installieren möchten, müssen Sie die Option Custom wählen. Im nächsten Fenster Ready to Install the Program aktivieren Sie den Schalter Install, um den Installationsprozess zu starten. Nach dem Kopiervorgang erscheinen verschiedene Fenster, in denen Sie die vorausgewählten Einstellungen beibehalten können.
Wenn die Insatllation beendet ist, können Sie direkt zum nächsten Schritt übergehen und die Server Instanz konfigurieren. 2.2 Den Server starten und eine Server Instanz konfigurieren Nach der Installation startet automatisch der Setup Wizard, mit dem Sie den MySQL- Server konfigurieren können. Aktivieren Sie nun den Schalter Finish im Setup Bildschirm und im nachfolgenden Begrüßungsfenster den Schalter Next. Im Fenster MySQL Server Instance Configuration wählen Sie die Option Standard Configuration und aktivieren Sie dann den Schalter Next. Übernehmen Sie die Einstellungen im nächsten Fenster und aktivieren Sie den Schalter Next.
Tragen Sie im nächsten Fenster ein Kennwort (New root password) für den Datenbankadministrator (root) ein und bestätigen Sie es (Confirm). Die Option Enable root access from remote machines muss aktiviert sein!. Klicken Sie dann auf den Schalter Next. Aktivieren Sie im nächsten Fenster den Schalter Execute, um den MySQL-Server zu konfigurieren.
Wenn dieser Vorgang abgeschlossen ist, aktivieren Sie den Schalter Finish, um das Konfigurationsprogramm zu beenden. 2.3 MySQL GUI Tools Bundle als Administrations- und Migrationstool installieren In die Installation des MySQL-Servers ist kein interaktives Administrations-Werkzeug eingebunden. Ein solches ist aber mit dem OpenSource-Programmpaket MySQL GUI Tools Bundle als MySQL-Administrator verfügbar. Die GUI Tools sind sowohl als Windows- und Linux-Version verfügbar. Es hat sich aber gezeigt, dass die Installation auf einem Windows-Rechner als administrativen Client im Netzwerk leicht durchgeführt werden kann. Nachfolgend wird daher auch nur dieser Weg beschrieben. Die Administration der MySQL-Datenbanken auf dem Windows-Server erfolgt somit von einem Windows- Client im Netzwerk. Falls noch nicht geschehen, laden Sie von den in Abschnitt 1.1 Notwendige Dateien für Installation angegebenen Internetadressen das Setup für GUI Tools Bundle herunter (mysql-gui-tools-5.0-r17-win32.msi). Das Programm sollte so installiert werden, dass nur der Datenbankadministrator Zugriff auf das Programm hat. Zur Installation bitte wie folgt vorgehen:
Die Datei mysql-gui-tools-5.0-r17-win32.msi starten und im Begrüßungsfenster den Schalter Next aktivieren. Die Lizenzbedingungen akzeptieren und den Schalter Next aktivieren. Ggf. das Zielverzeichnis anpassen
Als Setup-Typ die Option Complete wählen. Die Installation durch Aktivieren des Schalters Install starten. Die Installation durch Aktivieren des Schalters Finish beenden.
2.4 Installation des Migrationsprogramm für SchILD NRW von ribeka Die Installation des Migrationstools erfolgt automatisiert und verläuft wie in den folgenden Screenshots dargestellt. Beachten Sie den Hinweis und wählen die korrekten Verzeichnisse aus.
Der Zielordner ist dabei das Insatllationsverzeichnis für den Client auf dem SchILD gestartet werden soll: Bestätigen Sie und klicken auf Weiter.
Hierdurch wurde das Migrationstool installiert und kann aus dem Startmenü oder direkt aus dem Installationsordner von SchILD gestartet werden. 3 Datenbank für SchILD-NRW einrichten 3.1 Einrichtung der Datenbank auf dem Server Nachdem die Server- und die administrativen Client-Installationen durchgeführt wurden, kann eine MySQL- Datenbank für SchILD-NRW eingerichtet werden. Leider kann dies nicht durch einfaches Kopieren eines Prototypes (wie z.b. bei Firebird) erfolgen. Sie müssen die Datenbank mit den installierten MySQL Administrator und mit Hilfe eines SQL-Skriptes erstellen. Falls noch nicht geschehen, laden Sie sich aus dem Downloadbereich der Internetadresse www.svws.nrw.de das Programm SetupSchILDMySQL.exe herunter.
Es installiert das SQL-Skript für die Datenbank im Verzeichnis \Vorlagen\MySQL unterhalb des Verzeichnisses von SchILD-NRW. Dieses Verzeichnis wird nachfolgend mit <Vorlagen-Verzeichnis> bezeichnet. Starten Sie den MySQL Administrator Und wählen Sie den Eintrag Wiederherstellung:
Klicken Sie auf Datei öffnen und wählen das SQL Skript schild_nrw.sql aus dem Verzeichnis \Vorlagen\MySQL unterhalb des Programmverzeichnisses von SchILD- NRW. Klicken Sei dann auf Starten. Damit wird eine Datenbank mit dem Namen schild_nrw erzeugt. Zusätzlich werden die notwendigen Basisdaten angelegt. Im Bereich Kataloge des MySQL Administrators wird Ihnen jetzt auch die neu angelegt Datenbank schild_nrw angezeigt: 4 User Client-Installationen 4.1 MySQL-ODBC-Treiber installieren Um von den Windows-Rechnern (User Client), auf denen SchILD-NRW gestartet werden soll, auf eine MySQL-Datenbank zugreifen zu können, muss auf jedem User Client ein MySQL ODBC- Treiber installiert werden. Falls noch nicht geschehen, laden Sie von den in Abschnitt 1.1 Notwendige Dateien für Installation angegebenen Internetadressen das Setup für den MySQL-ODBC- Treiber herunter (z. B. mysql-connector-odbc-5.1.8-winx64.msi für ein 64 bit Windows). Zur Installation gehen Sie wie folgt vor:
Die Datei mysql-connector-odbc-5.1.8-winx64.msi starten und dann im Begrüßungsfenster den Schalter Next aktivieren. Für den Setup Type Typical verwenden Und im Fenster Ready to Install the Programm den Schalter Install aktivieren.
Die Installation durch Aktivieren des Schalters Finish beenden. 5 Zugriff von SchILD-NRW auf die MySQL-Datenbank einrichten 5.1 ODBC-Datenquelle einrichten Damit SchILD-NRW auf die MySQL-Datenbank zugreifen kann, wird neben dem oben beschriebener ODBC- Treiber eine ODBC- Verbindung benötigt. Um diese einzurichten, gehen Sie wie folgt vor. Drücken Sie die Windows Taste und die R Taste. Jetzt erscheint folgendes Fenster: Geben Sie dann den direkten Aufruf odbcad32.exe Oder aktivieren Sie Start/Systemsteuerung und wählen Sie in der Systemsteuerung zunächst System und Sicherheit
und das Symbol Verwaltung aus. Wählen Sie in der Verwaltung das Symbol Datenquellen (ODBC) aus. Aktivieren Sie den Schalter Hinzufügen:
Es erscheint das folgende Fenster. Wählen Sie den Treiber MySQL ODBC 5.1 Driver aus und aktivieren Sie den Schalter Fertig stellen. Es öffnet sich das nachfolgend dargestellte Fenster.
Geben Sie nun bei Data Source Name einen Namen für diese Verbindung ein. Wichtig: Dieser Name muss bei allen Rechner, die auf die MySQL-Datenbank von SchILD-NRW zugreifen sollen, identisch sein! Bei Description können Sie eine optionale Erläuterung zu der Verbindung eintragen. Im Feld Server geben Sie Servernamen oder die IP-Adresse des Servers, auf dem sich die Datenbank befindet, ein. Im Feld User tragen sie root ein, im Feld Password das Kennwort des Datenbankadministrators. Wichtig: Nach dem Verbindungstest (s.u.) sollten Sie das Kennwort unbedingt wieder löschen. Im Feld Database geben Sie den Namen der MySQL-Datenbank schild_nrw für SchILD-NRW ein. Aktivieren Sie nun den Schalter Test, um die Verbindung zu testen. Falls der Test erfolgreich verlief, sollten Sie wieder auf die Registerkarte Login wechseln und das Kennwort löschen. Anschließend schließen Sie das Fenster über den Schalter OK, ebenso den ODBC-Datenquellen-Administrator. 5.2 UDL-Datei anlegen Damit SchILD-NRW auf die MySQL-Datenbank zugreifen kann, muss zusätzlich zu der ODBC-Verbindung auch noch eine sogenannte UDL-Datei eingerichtet werden, die alle notwendigen Verbindungsparameter enthält. Um eine solche einzurichten, gehen Sie wie folgt vor: Starten Sie den Windows-Explorer Wechseln Sie in das Verzeichnis \UDL, das sich normalerweise unterhalb des Programmverzeichnisses von SchILD-NRW befindet. Falls das Verzeichnis nicht existiert, legen Sie es mit dem Windows-Explorer neu an. Aktivieren Sie die rechte Maustaste und wählen Sie Neu/Textdatei. Es wird eine neue Textdatei angelegt. Geben Sie der Datei einen aussagekräftigen Namen, z.b."mysql-datenbank" o. ä. Unter diesem Namen wird die Datenbank in SchILD-NRW angezeigt. Ändern Sie die Dateierweiterung in ".UDL". Anschließend aktivieren Sie die Eingabetaste, die Warnmeldung können Sie ignorieren. Damit ist das Grundgerüst einer UDL-Datei, in der Zugriff auf eine Datenbank definiert werden kann, gelegt. Um die konkreten Angaben zu setzen, führen Sie einen Doppelklick auf die soeben erzeugte Datei aus. Es sollte nun das Fenster "Datenverknüpfungseigenschaften" erscheinen (s.u.). Auf der Seite Provider wählen Sie den Eintrag Microsoft OLE DB Provider for ODBC Drivers aus.
Wechseln Sie nun auf den Karteireiter Verbindung. Aktivieren Sie die Option Datenquellenname verwenden und geben Sie den Namen der ODBC-Verbindung ein (siehe Abschnitt 5.1 ODBC-Datenquelle einrichten ). Um die Verbindung zu testen, geben Sie bei Benutzername root und bei Kennwort das Kennwort des Datenbankadministrators ein und aktivieren Sie den Schalter Verbindung testen. Der Eintrag Geben Sie den zu verwendenden Anfangskatalog ein muss unbedingt leer bleiben! Sofern die Verbindung erfolgreich hergestellt werden konnte, löschen Sie nun wieder den Benutzernamen und das Kennwort. Diese Einträge werden verschlüsselt in der in der Benutzerverwaltung von SchILD-NRW verwaltet (s.u.).
Schließen Sie das Fenster über den Schalter OK. 5.3 Datenbank-Anmeldungsparameter in die SchILDBenutzerverwaltung Damit die Benutzer von SchILD-NRW mit der MySQL-Datenbank arbeiten können, ohne das Kennwort für den MySQL-Server zu kennen, muss es verschlüsselt in der Benutzerverwaltung abgelegt werden. Starten Sie hierzu die Benutzerverwaltung von SchILD-NRW SchILD_PWCrypt.exe, die Sie im Installationsverzeichnis von Schild finden. Achten sie darauf, eine Schild Version neuer als Version 1.7.76.2 zu nutzen. Die Datei SchILD_PWCrypt.exe wird mit Schild Software installiert bzw. aktualisiert. Das Verschlüsselungsverfahren musste für die Datenbankparameter (Benutzername, Kennwort) geändert werden. Es können aus diesem Grund keine älteren Varianten des Verschlüsselungsprogramms verwendet werden. Es erscheint das folgende Fenster: Wählen Sie zunächst die UDL-Datei, die Sie in Abschnitt 5.2 UDL-Datei anlegen erstellt haben, aus, indem Sie auf das Symbol zum Öffnen eines Ordners klicken. Wählen Sie ggf. das korrekte Verzeichnis für die UDL Datei aus. Geben nun den Benutzernamen (root) und das Kennwort für den Datenbankadministrator ein und aktivieren Sie den Start-Schalter, um diese Daten in verschlüsselter Form abzuspeichern. In diesem Prozess wird eine DAT Datei erstellt, die den gleichen Namen besitzt wie die ausgewählte UDL Datei. Die eingetragenen Benutzer können nun SchILD-NRW starten und die MySQL- Datenbank auswählen (über den Namen der UDL-Datei), ohne das eigentliche Datenbank-Kennwort kennen zu müssen. Die Zugriffssteuerung erfolgt wie im Falle einer ACCESS-Datenbank weiterhin rein über die Privilegien, die in der Benutzerverwaltung festgelegt wurden.
5.4 Benutzer anlegen Zum Anlegen und Bearbeiten der Benutzer und deren Rechte kann zur Zeit leider nicht die Benutzerverwaltung unter Schild verwendet werden. Nutzen Sie hierzu die Anwendung UserAdmn.exe im Programmordner von Schild. Laden Sie ggfs. eine aktuelle Version der Benutzerverwaltung als gezippte Datei www.ribeka.com/dateidownload/schild/schild-nrw/useradmn.zip herunter und entpacken die Benutzerverwaltung im Installationsverzeichnis von SchILD. Beim Start der UserAdmn.exe müssen Sie dann zunächst die Datenbank auswählen, deren Nutzer Sie administrieren wollen. Daraufhin folgen mehrere Fehlermeldungen, die Sie ignorieren können und mit OK bestätigen:
Dann gelangen Sie zur folgenden Ansicht: Jetzt müssen Sie unter Benutzergruppen bearbeiten zunächst noch Benutzergruppen definieren, um die später anzulegenden Benutzer diesen Benutzergruppen zuordnen zu können. Klicken Sie auf + und legen eine Benutzergruppe Administratoren an. Schließen Sie das Benutzergruppen Fenster und legen dann in der Benutzer-Verwaltung mind.
den Administrator an, indem Sie Sie wiederum auf + gehen und einen Namen und das Passwort festlegen. Bestätigen Sie mit Ja und legen dann ein Kennwort für den Administrator fest. Schließen die Benutzerverwaltung wieder, um sich dann nochmals anzumelden: Legen Sie jetzt ggf. weitere Benutzer, deren Rechte und Passwörter fest: Betätigen dann den Haken zum Speichern.
6 Daten-Migration aus einer ACCESS-Datenbank in die MySQLDatenbank Um Daten aus einer bestehenden SchILD-ACCESS-Datenbank in die MySQL- Datenbank zu übertragen, dient das Programm SchildMigration.exe, das sich im Programmverzeichnis von SchILD-NRW befindet. Bevor Sie dieses Programm aufrufen, sollten Sie die Datenbank aber einmal mit SchILD-NRW öffnen. Starten Sie hierzu SchILD-NRW und wählen Sie die MySQL-UDL- Datei aus. Sobald der SchILD-Experte erscheint, können Sie das Programm aber wieder beenden. Und dann wieder schließen: Grund für diese Vorgehensweise ist, dass mögliche Zusatzfelder, die von SchILD- NRW bei Bedarf beim Start automatisch angelegt werden, auch tatsächlich in der Datenbank vorhanden sind. Öffnen Sie nun im Explorer per Doppelklick die MySQL-UDL-Datei und tragen Sie den Benutzer root und dessen Kennwort ein. Diese Einträge werden nur für die Migration benötigt und sollten nach Abschluss der Migration wieder entfernt werden!
Starten Sie nun das Migrationsprogramm SchildMigration.exe und wählen Sie im oberen Eingabefeld die SchILD-ACCESS-Datenbank, die konvertiert werden soll, aus. Die MySQL- Datenbank, in die die Daten überführt werden sollen, wählen Sie über die zugeordnete UDL- Datei aus:
Testen Sie die Verbindung Im Register Optionen könne Sie ggfs. weitere Einstellung zur Migration vornehmen: Durch den Schalter Migration starten werden anschließend die Daten aus der ACCESS-Datenbank in die MySQL-Datenbank überführt. Je nach Datenumfang kann dies eine längere Zeit in Anspruch nehmen. Wichtig: Nach Abschluss der Migration müssen Sie erneut im Explorer per Doppelklick die MySQL-UDL-Datei öffnen und den Benutzernamen und das Kennwort wieder löschen! Falls die Migration mit dem Ribeka Tool nicht funktioniert, verwenden Sie stattdessen das Migrationstool von MySQL, das mit den GUI Tools zusammen installiert wurde. 7 Datensicherung Da bei einer MySQL-Datenbank kein Zugriff auf Dateiebene besteht (bzw. nicht bestehen sollte), kann das interne Datensicherungsverfahren von SchILD-NRW nicht verwendet werden, um regelmäßige Backups der Datenbank zu erzeugen. Sie können stattdessen das Administrationsprogramm MySQL-Administrator verwenden. Um ein Backup durchzuführen, starten Sie MySQL-Administrator, wählen die Verbindung zur SchILD-NRW-Datenbank aus, tragen das Kennwort ein und betätigen den Schalter OK. Im Hauptfenster von MySQL-Admininistrator aktivieren Sie nun linken Teil des Fensters das Symbol Backup. Es erscheint das folgende Fenster:
Aktivieren Sie nun den Schalter Neues Projekt. Geben Sie einen Namen für das Backup- Projekt ein (nur alphanummerische Zeichen) und wählen Sie unter Schemata die Datenbank (bzw. das Unterverzeichnis, in dem die Datenbank gespeichert ist) aus. Benutzen Sie den Schalter >, um die Datenbank in das Backup- Projekt zu übernehmen. Aktivieren Sie nun den Schalter Projekt Speichern, um diese Angaben zu speichern. Um die Datensicherung zu starten, aktivieren Sie den Schalter Backup jetzt durchführen. Es erscheint dann ein Dateiauswahl-Dialog, in dem Sie einen Namen für die Backup-Datei eingeben können (Vorgabe ist der Name der Datenbank mit aktuellem Datum und Uhrzeit). Um ein Backup der Datenbank zurückzuspielen, verwenden Sie das Symbol Wiederherstellung im Hauptfenster von MySQL-Administrator und wählen Sie dann eine Datensicherungsdatei aus.