Installationsanleitung für die netzbasierte Variante Bis

1
Installationsanleitung
für die netzbasierte Variante
Bis Version 3.5
Copyright © KnoWau Software 2013
KnoWau, Allgemeine Bedienhinweise
Seite 1
2
Seite absichtlich leer
KnoWau, Allgemeine Bedienhinweise
Seite 2
3
Inhaltsverzeichnis
1
Übersicht ........................................................................................................................................ 5
2
Installation...................................................................................................................................... 6
2.1
Vorbereitung .......................................................................................................................... 6
2.2
Serverinstallation.................................................................................................................... 7
2.3
PC-Installation ...................................................................................................................... 11
2.3.1
Installation des Datenbank Treibers ............................................................................. 11
2.3.2
Installation von Updates der Hundeschul Software...................................................... 13
2.3.3
Erstinstallation der Hundeschul Software..................................................................... 15
KnoWau, Allgemeine Bedienhinweise
Seite 3
4
Seite absichtlich leer
KnoWau, Allgemeine Bedienhinweise
Seite 4
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 300.000 Treffer, es sollte also
einer für sie dabei sein.
KnoWau, Allgemeine Bedienhinweise
Seite 5
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-3.51.22-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-3.51.22-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 2.3.1.
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
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 2.3.2.
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
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
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.
Für den Benutzernamen ('kwuser') und das Passwort ('verySecret') können sie selbst
ausgedachte Werte verwenden.
KnoWau, Allgemeine Bedienhinweise
Seite 9
10
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.
KnoWau, Allgemeine Bedienhinweise
Seite 10
11
2.3 PC-Installation
Auf jedem Anwender PC wird die KnoWau Software und eine Datenbank Zugriffssoftware installiert.
Dabei sind folgende Schritte auszuführen:
2.3.1 Installation des Datenbank Treibers
Doppelklick auf die Datei mysql-connector-odbc-3.51.22-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
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
2.3.2 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 2.3.3 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
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
2.3.3 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
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
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
o
o
o
o
Datenbank Server ([HOST] oder einen Namen, unter dem der Host gefunden wird),
Name der Datenbank (kwhundeschule),
Port, über den die Datenbank erreichbar ist (siehe Ende von Abschnitt 2.2),
Datenbank User (kwuser) und
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
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