Knottenwäldchen Software

Transkript

1 Knottenwäldchen Software Installationsanleitung für die netzbasierte Lösung Knottenwäldchen Software März.2011

2 Knottenwäldchen Software Seite 2 1 Inhalt 1 Inhalt Übersicht Installation Vorbereitung Serverinstallation PC-Installation Installation des Datenbank Treibers Installation von Updates der Hundeschul Software Erstinstallation der Hundeschul Software... 13

3 2 Übersicht Knottenwäldchen Software Seite 3 Mit der netzbasierten Lösung der Knottenwäldchen Hundeschulsoftware (kw Hundeschulsoftware) können mehrere Anwender gleichzeitig mit einer zentralen Datenbank arbeiten. Die Datenbank ist auf einem über das Internet bzw. über ein lokales Netz zugänglichen Server installiert. Jeder Anwender benötigt auf seinem PC oder Notebook eine Installation des Verwaltungsprogramms. Die Verteilung ist in Abbildung 1 dargestellt. Abbildung 1: Verteilung der Hundeschulsoftware Für den Betrieb muss die Datenbank bereitgestellt und auf jedem Benutzer- Arbeitsplatz die kw Hundeschulsoftware installiert werden. Die MySql Datenbank ist nicht Bestandteil der Hundeschul Software. Für die Bereitstellung der Datenbank im Netz müssen sie selbst sorgen. Sie benötigen hierzu einen über das Internet oder ein lokales Netz zugänglichen Server mit einer ebenfalls über das Netz zugänglichen MySql Datenbank. Dies wird von den meisten Internet Providern in Deutschland angeboten, ist aber in der Regel kostenpflichtig 1. Für die Installation der Hundeschul-Datenbank sind Grundkenntnisse in Linux und MySql notwendig. Die Installation ist in diesem Dokument beschrieben. 1 Die Google Suche nach Server Hosting Deutschland liefert über Treffer, es sollte also einer für sie dabei sein.

4 Knottenwäldchen Software Seite 4 3 Installation 3.1 Vorbereitung Entpacken Sie die zip-datei KwHundeschuleNet-<Version>.zip in ein temporäres Verzeichnis ihres Rechners, für die PC/Notebook Installation unter Windows zum Beispiel C:\temp\kw\ für die Datenbank Installation unter Linux zum Beispiel /home/meinname/kw/. Das gewählte temporäre Verzeichnis wird im folgenden mit [TEMP] bezeichnet. Folgende Struktur sollte sichtbar sein: [TEMP]\ MySql\ mysql-connector-odbc win32.msi kwhundeschulemysqlleer.sql KwHundeschule.msi setup.exe Für die Datenbank Installation wird lediglich die Datei kwhundeschulemysqlleer.sql benötigt. Sie generiert die Tabellen der Hundeschuldatenbank. Die Datenbank selbst muss gemäß Anleitung in Abschnitt Serverinstallation erstellt und ein Benutzer mit allen Zugriffsrechten auf diese Datenbank eingerichtet werden.

5 3.2 Serverinstallation Knottenwäldchen Software Seite 5 Anmerkung: Die im folgenden beschriebene Datenbank Installation muss nur ein einziges mal bei der Erstinstallation des Programmes durchgeführt werden. Sollten Updates das Hundeschulprogrammes eine Datenbankänderung erfordern, müssen sie die Datenbank nicht mehr anfassen. Die notwendigen Änderungen werden beim ersten Aufruf mit der Update-Version des Programms ausgeführt. Siehe hierzu auch Abschnitt Für die Serverinstallation wird MySql 5.0.* benötigt. Sie benötigen Zugriff zum Beispiel über den MySql Command Line Client mit root-rechten zum Erstellen und Laden der Hundeschul-Datenbank. Die Datenbank wird in der Regel auf einem UNIX/LINUX Rechner installiert. Es muss darauf geachtet werden, dass die Datenbank NICHT case sensitive Tabellennamen verwendet. Dafür ist der Parameter lower_case_table_names = 1 in der MySql Konfigurationsdatei my.cnf zuständig. Außerdem werden InnoDB Tabellen verwendet. Im folgenden sehen sie einen Auszug einer my.cnf Datei mit den Angaben, die für die Hundeschuldatenbank wichtig sind: [mysqld] # Namen der Datenbank werden in lower case interpretiert caselower_case_table_names=1 # Verwendung von InnoDB Tabellen innodb_data_home_dir = /var/lib/mysql/ innodb_data_file_path = ibdata1:10m:autoextend innodb_log_group_home_dir = /var/lib/mysql/ innodb_log_arch_dir = /var/lib/mysql/ innodb_buffer_pool_size = 16M innodb_additional_mem_pool_size = 2M innodb_log_file_size = 5M innodb_log_buffer_size = 8M innodb_flush_log_at_trx_commit = 1 innodb_lock_wait_timeout = 50 Folgende Schritte sind für die Installation durchzuführen: 1.) MySql CommandLine Client öffnen (Anmeldung mit root): zum Beispiel mit Wechseln in das MySql Installationsverzeichnis. Das kann von Installation zu Installation verschieden sein. Typische Verzeichnisse sind zum Beispiel cd /usr/bin oder cd /usr/share/mysql das Verzeichnis muss den Aufruf für den MySql Command Line Client

6 Knottenwäldchen Software Seite 6 enthalten. Aufruf z.b. mit mysql u root -p 2.) Passwort eingeben 3.) Datenbank erzeugen mit: create database kwhundeschule; 4.) Mit der frisch erzeugten Datenbank verbinden: connect kwhundeschule;

7 Knottenwäldchen Software Seite 7 5.) Erfolgsmeldung kontrollieren! 6.) Hundeschultabellen generieren mit: source [TEMP]/kwHundeschuleMySqlLeer.sql; Die sql-datei müssen sie vorher in ein temporäres Verzeichnis auf dem Server kopiert haben. Dieses Verzeichnis ist hier mit [TEMP] bezeichnet. 7.) Erfolgsmeldung kontrollieren! 8.) Benutzer anlegen mit: CREATE USER 'kwuser'@'[host]' IDENTIFIED BY 'verysecret'; Bitte beachten Sie, dass für [HOST] der Hostname der Datenbank eingetragen werden muss (wenn sie schon auf dem Server mit der MySql Installation arbeiten ist das localhost). Hosts sind in diesem Fall die Rechner, die auf die Datenbank zugreifen. Wenn sie über das Internet zugreifen möchten, verwenden sie % als wildcard für den Host. Das ist die einfachste Konfiguration. Wenn sie im Intranet arbeiten und alle zugreifenden Hosts kennen, legen sie am besten für jeden dieser Hosts einen eigenen Benutzer an (gleicher Benutzername, anderer Host, gleiches Passwort). Dann können sie sicher sein, dass nur von diesen Hosts auf die Datenbank zugegriffen werden kann. Der Nachteil ist, dass sie für jeden neuen oder ausgetauschten Host die Datenbank Konfiguration ändern müssen.

8 Knottenwäldchen Software Seite 8 Für den Benutzernamen ('kwuser') und das Passwort ('verysecret') können sie selbst ausgedachte Werte verwenden. 9.) Erfolgsmeldung kontrollieren! 10.) Benutzerrechte vergeben mit: grant all privileges on kwhundeschule.* to 'kwuser'@'[host]' identified by 'verysecret'; Bitte beachten Sie, dass für [HOST], 'kwuser' und das Passwort ('verysecret') die in Schritt 8 verwendeten Werte benutzen. Die Zugriffsrechte müssen für jeden Host erzeugt werden. 11.) Erfolgsmeldung kontrollieren, fertig! Wichtig: Die Werte, die Sie für [HOST], 'kwuser' und das Passwort ('verysecret') verwendet haben werden bei der ERSTEN (und nur bei der ersten) Anmeldung vom PC benötigt. Die Datenbank sollte unter Port 3306 ansprechbar sein. Das ist der Standard Port für MySql, der bei der ersten Anmeldung am PC vorbelegt ist. Sie können aber auch einen anderen Port verwenden, den sie dann zur Anmeldung benötigen.

9 3.3 PC-Installation Knottenwäldchen Software Seite 9 Auf jedem Anwender PC wird die Knottenwäldchen Hundeschulsoftware und eine Datenbank Zugriffssoftware installiert. Dabei sind folgende Schritte auszuführen: Anmerkung: Die im folgenden beschriebene Installation des Datenbanktreibers muss nur ein einziges mal pro PC Arbeitsplatz durchgeführt werden. Bei der Installation von Updates genügt es, die im Abschnitt bzw beschriebenen Aktivitäten auszuführen Installation des Datenbank Treibers Doppelklick auf die Datei mysql-connector-odbc win32.msi Sie werden durch die Installation geführt. Wählen Sie Next Wählen Sie Typical, dann Next.

10 Knottenwäldchen Software Seite 10 Wählen Sie Install. Wenn Sie Windows Vista verwenden, benötigen Sie Administrator Rechte und müssen die Installation noch einmal bestätigen. Schließlich erscheint Wählen Sie Finish und fertig ist die Installation.

11 Knottenwäldchen Software Seite Installation von Updates der Hundeschul Software Wichtig!!! Bitte vor Installation eines Update unbedingt eine Datenbanksicherung durchführen!! Bei der Installation von Updates genügt es, die im nächsten Abschnitt beschriebene Aktivitäten auszuführen, d.h. ein Doppelklick auf die Datei setup.exe. Dabei ist jedoch folgendes zu beachten. Bitte Beachten: Bei manchen Updates (in der Update Dokumentation vermerkt) wird auch die Datenbank geändert. Als Anwender merkt man davon nichts. Die Datenbank wird im Hintergrund den neuen Gegebenheiten angepasst (migriert), wenn der erste Benutzer eine neu installierte Softwareversion startet. Bei Datenbank-Updates wird die Version der Datenbank erhöht und ältere Programmversionen können nicht mehr mit der neuen Datenbank arbeiten. Abbildung 2 zeigt die Situation, nachdem Benutzer (A) zum ersten Mal mit der neuen Version gearbeitet hat. Abbildung 2: Erster User im Netz mit Update Die Versionen von Benutzer (A) und der Datenbank stimmen überein. Benutzer (B) und (C) haben aber noch immer die ältere Programm Version.

12 Knottenwäldchen Software Seite 12 Versuchen nun (B) oder (C) auf die Datenbank zuzugreifen so erhalten sie ein Bild und eine Meldung ähnlich der folgenden: Der gelbe Pfeil symbolisiert einen Benutzer mit einer älteren Version. Über den link Download letzte Version kann man sich die neueste Version herunter laden. Anwender (B) und (C) müssen also auf ihren PCs erst die neue Version installieren, bevor sie mit dem Programm wieder arbeiten können.

13 3.3.3 Erstinstallation der Hundeschul Software Knottenwäldchen Software Seite 13 Doppelklick auf die Datei setup.exe. Sie werden durch die Installation geführt. In der Regel genügt dreimaliger Klick auf den Weiter-Button. Damit ist die Hundeschulsoftware installiert, es fehlt aber noch die Software für den Zugriff auf die Datenbank über das Internet. Wählen Sie Weiter Wählen Sie Weiter

14 Knottenwäldchen Software Seite 14 Wählen Sie Weiter Warten Sie bis die Installation beendet ist

15 Knottenwäldchen Software Seite 15 Und klicken Sie Schließen. Sie finden jetzt auf Ihrem Desktop ein Icon der Hundeschulsoftware Durch Doppelklick starten Sie die Hundeschulsoftware. Beim ersten Start müssen Sie die Verbindung zur Datenbank einstellen. Dazu verwenden Sie für die Felder o Datenbank Server ([HOST] oder einen Namen, unter dem der Host gefunden wird), o Name der Datenbank (kwhundeschule), o Port, über den die Datenbank erreichbar ist (siehe Ende von Abschnitt 3.2), o Datenbank User (kwuser) und o Datenbank Passwort (verysecret) die Werte, die sie bei der Serverinstallation gewählt haben

16 Knottenwäldchen Software Seite 16 Die erste Anmeldung funktioniert wie bei der Einzelplatzversion mit der Kombination admin/admin. Datenbank, Server, aktueller Nutzer und die derzeit im Netz aktiven Nutzer werden in der Statuszeile angezeigt. Viel Spaß Wünscht das Knottenwäldchen Team