Installationsanleitung für die netzbasierte Variante Bis Version 3.5. KnoWau, Allgemeine Bedienhinweise Seite 1

Transkript

1 1 Installationsanleitung für die netzbasierte Variante Bis Version 3.5 Copyright KnoWau Software 2013 KnoWau, Allgemeine Bedienhinweise Seite 1

2 2 Seite absichtlich leer KnoWau, Allgemeine Bedienhinweise Seite 2

3 3 Inhaltsverzeichnis 1 Übersicht Installation Vorbereitung Serverinstallation PC-Installation Installation des Datenbank Treibers Installation von Updates der Hundeschul Software Erstinstallation der Hundeschul Software KnoWau, Allgemeine Bedienhinweise Seite 3

4 4 Seite absichtlich leer KnoWau, Allgemeine Bedienhinweise Seite 4

5 5 1 Übersicht Die netzbasierte Lösung der KnoWau Software ermöglicht das gleichzeitige Arbeiten mehrerer Anwender auf einer zentralen MySql Datenbank. 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 der KnoWau Software. Die Verteilung ist in Abbildung 1 dargestellt. Abbildung 1: Verteilung der Hundeschulsoftware Die MySql Datenbank ist nicht Bestandteil der KnoWau 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 angeboten, ist aber in der Regel kostenpflichtig 1. Für die Installation der Hundeschul-Datenbank sind Grundkenntnisse in Linux und MySql von Vorteil. 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. KnoWau, Allgemeine Bedienhinweise Seite 5

6 6 2 Installation 2.1 Vorbereitung Starten sie die von unserer Homepage heruntergeladene Datei KnoWauSetup<Version>.exe zur Installation Software auf jedem Client. Nach der Installation finden sie im Verzeichnis C:\Program Files (x86)\knowau\mysql Die Dateien: mysql-connector-odbc win32.msi und kwhundeschulemysqlleer.sql Kopieren sie diese beiden Dateien am besten in ein temporäres Verzeichnis, das wir im Folgenden mit [Temp] bezeichnen. Doppelklicken sie auf die erste Datei [Temp]\mysql-connector-odbc win32.msi, um den MySql Datenbank Connector auf dem Client zu installieren. Der sorgt dafür, dass die Software die MySql Datenbank findet. Siehe Kapitel Die Datei [Temp]\kwHundeschuleMySqlLeer.sql wird für die Datenbank Installation auf dem Server benötigt, siehe Kapitel 2.2. Sie sollten sie also zum Beispiel per FTP auf den Server übertragen, damit sie von dort aus auf sie zugreifen können. Wir werden sie im Folgenden weiterhin unter [Temp]\kwHundeschuleMySqlLeer.sql referenzieren. Mit ihr werden die Tabellen der Hundeschul-/Pensions-datenbank erzeugt. Die Datenbank selbst muss gemäß Anleitung in Abschnitt Serverinstallation erstellt und ein Benutzer mit allen Zugriffsrechten auf diese Datenbank eingerichtet werden. KnoWau, Allgemeine Bedienhinweise Seite 6

7 7 2.2 Serverinstallation 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.* 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 wird das InnoDB Speichermodul von MySql für die Tabellen verwendet. Im Folgenden sehen sie einen Auszug einer my.cnf Datei mit den Angaben, die für die Datenbank wichtig sind: [mysqld] # Namen der Datenbank werden in lower case interpretiert (optional) 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 durch: KnoWau, Allgemeine Bedienhinweise Seite 7

8 8 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 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; KnoWau, Allgemeine Bedienhinweise Seite 8

9 9 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 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. Für den Benutzernamen ('kwuser') und das Passwort ('verysecret') können sie selbst ausgedachte Werte verwenden. KnoWau, Allgemeine Bedienhinweise Seite 9

10 10 9.) Erfolgsmeldung kontrollieren! 10.) Benutzerrechte vergeben mit: grant all privileges on kwhundeschule.* to 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. KnoWau, Allgemeine Bedienhinweise Seite 10

11 PC-Installation Auf jedem Anwender PC wird die KnoWau Software und eine Datenbank Zugriffssoftware installiert. Dabei sind folgende Schritte 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. KnoWau, Allgemeine Bedienhinweise Seite 11

12 12 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. KnoWau, Allgemeine Bedienhinweise Seite 12

13 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 KnoWauSetup<Version>.exe. Dabei ist jedoch folgendes zu beachten. Bei manchen Updates (in der Update Dokumentation vermerkt) ändert sich auch die Datenbank. Als Anwender merkt man davon nichts. Die Datenbank wird im Hintergrund auf die neue Version 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. KnoWau, Allgemeine Bedienhinweise Seite 13

14 14 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. KnoWau, Allgemeine Bedienhinweise Seite 14

15 Erstinstallation der Hundeschul Software Doppelklick auf die Datei KnoWauSetup<Version>.exe. Sie werden durch die Installation geführt. Warten sie, bis die Vorbereitung abgeschlossen ist: Wählen Sie Weiter Wählen Sie Weiter KnoWau, Allgemeine Bedienhinweise Seite 15

16 16 Wählen Sie Installieren Warten Sie bis die Installation beendet ist Und klicken Sie Fertig stellen. Sie finden jetzt auf Ihrem Desktop ein Icon der KnoWau Software. Durch Doppelklick starten Sie die Software. Beim ersten Start müssen Sie die Verbindung zur Datenbank einstellen. KnoWau, Allgemeine Bedienhinweise Seite 16

17 17 Wählen sie MySql Datenbank benutzen Tragen sie die Daten ihrer Datenbank ein und klicken sie Verbindung testen. 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 2.2), o Datenbank User (kwuser) und o Datenbank Passwort (verysecret) die Werte, die sie bei der Serverinstallation gewählt haben Wenn die Verbindung aufgebaut werden kann, wird die Ampel grün. KnoWau, Allgemeine Bedienhinweise Seite 17

18 18 Klicken sie Speichern. Klicken sie OK. Die Verbindung zur Datenbank wird erst beim nächsten Start aufgebaut. Die Anwendung wird beendet, sie müssen sie erneut starten 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 KnoWau Team KnoWau, Allgemeine Bedienhinweise Seite 18