Installationsanleitung BalticScore 3.0

Installationsanleitung BalticScore 3.0
Dieses ist die Installationsanleitung für BalticScore 3.0, die Plattform für Sportwettkämpfe.
Inhaltsverzeichnis
1 Allgemeine Voraussetzungen............................................................................................................2
2 Installation unter Windows...............................................................................................................2
3 Installation unter Mac OS X.............................................................................................................2
4 Konfiguration der Datenbank........................................................................................................... 3
4.1 MySQL..................................................................................................................................... 3
4.1.1 Setzen der Einstellungen................................................................................................... 3
4.2 PostgreSQL............................................................................................................................... 3
4.2.1 Setzen der Einstellungen................................................................................................... 4
5 Lizenz aktualisieren..........................................................................................................................4
6 MySQL installieren.......................................................................................................................... 4
6.1 Windows................................................................................................................................... 4
6.2 Mac OS X................................................................................................................................. 5
6.2.1 MySQL-Server..................................................................................................................5
6.2.2 MySQL-Workbench.......................................................................................................... 5
6.3 Datenbank-Schema anlegen......................................................................................................5
6.4 Benutzer anlegen.......................................................................................................................6
7 PostgreSQL installieren.................................................................................................................... 6
7.1 Windows................................................................................................................................... 6
7.2 Mac OS X................................................................................................................................. 6
7.3 Datenbank konfigurieren.......................................................................................................... 6
7.4 Remote-Zugriff freigeben......................................................................................................... 7
1. April 2015
Seite 1 von 7
BalticScore 3.0
Installationsanleitung BalticScore 3.0
1 Allgemeine Voraussetzungen
Um BalticScore betreiben zu können müssen folgende Voraussetzungen erfüllt sein.
●
Ein Java Runtime Environment 1.7.0 oder höher muss installiert und im Suchpfad sein.
Außerdem benötigen Sie folgende Dateien:
●
Lizenzdatei, z.B. aiszeit.licenses
●
Installationsdatei oder Archivdatei für die gewünschte Plattform
BalticScore gibt es für folgende Zielsysteme:
●
Microsoft Windows 7 oder Windows 8.1
●
Mac OS X 10.9
Die mitgelieferte Datenbank vom Typ HSQLDB ist nicht für den Mehrbenutzerbetrieb geeignet. Für
diesen werden MySQL und PostgreSQL unterstützt.
Für einen Betrieb mit MySQL müssen Sie zusätzlich einen MySQL-Server installieren und die
Datenbank mit der mitgelieferten Datenbankstruktur einrichten.
Für einen Betrieb mit PostgeSQL müssen Sie zusätzlich einen PostgeSQL-Server installieren und
die Datenbank mit der mitgelieferten Datenbankstruktur einrichten.
Zur Einrichtung der Datenbanken siehe Kapitel Konfiguration am Ende dieses Dokuments.
2 Installation unter Windows
Zur Installation unter Windows 7 und Windows 8.1 steht eine Archivdatei zur Verfügung.
●
Sie benötigen die Archivdatei: BalticScore-win32-<Version>.zip
●
Entpacken Sie die Dateien inkl. Verzeichnisse in ein beliebiges Zielverzeichnis. Das
Verzeichnis „C:\Programme“ oder „C:\Program Files“ wird ausdrücklich und
insbesondere unter Windows 7 NICHT empfohlen.
●
Das Programm „BalticScore.exe“ steht nach dem Entpacken im Verzeichnis
„BalticScore3“ und kann direkt aufgerufen oder verknüpft werden.
●
Die Hypersonic Datenbank (HSQLDB) ist voreingestellt und eine leere Datenbank ist Teil
der Auslieferung. Eine Anpassung an eine andere Datenbank (MySQL, PostgreSQL) ist über
den Dialog Benutzervorgaben möglich. Siehe Kapitel Konfiguration am Ende des
Dokuments.
3 Installation unter Mac OS X
Zur Installation unter unter Mac OS X 10.9 steht eine Installationsdatei zur Verfügung.
●
Sie benötigen die Installationsdatei: „ BalticScore-macosx-<Version>.zip“
1. April 2015
Seite 2 von 7
BalticScore 3.0
Installationsanleitung BalticScore 3.0
●
Öffnen Sie die Datei (z.B. durch Doppel-Klick im Finder).
●
Ziehen Sie das Verzeichnis „ BalticScore3“ auf das Icon „Applications“ (Dazu
werden Administrator-Rechte benötigt).
●
Passen Sie das Datenbank-Verzeichnis in der Datei „ aiszeit.properties“ an.
●
Das Programm lässt sich starten, in dem man den Ordner „ BalticScore3“ unter
Programme-öffnet und dann das BalticScore-Icon doppelt klickt.
4 Konfiguration der Datenbank
4.1
MySQL
Um BalticScore mit MySQL betreiben zu können müssen folgende Voraussetzungen erfüllt sein.
●
MySQL 5.5 oder 5.6 ist installiert (siehe 6 MySQL installieren).
●
Wichtig ist, dass für BalticScore der Tabellentyp InnoDB und als Zeichensatz nicht UTF8
sondern z.B. Latin1 verwendet wird.
4.1.1
Setzen der Einstellungen
●
Starten Sie BalticScore.
●
Wählen Sie „Fenster→Benutzervorgaben...“, unter Mac OS X auch
„BalticScore→Einstellungen...“
●
Wählen Sie unter „Allgemein→Datenbank“ den Dialekt „MySQL5InnoDBDialect“.
●
Setzen Sie die Parameter wie folgt:
○
Datenbank:
//<Rechnername/<Schema> oder //<IP-Adresse>/<Schema>
z.B. //localhost/balticscore
○
Benutzer:
<Benutzer>
z.B. balticscore
○
Kennwort:
<Kennwort>
z.B. balticscore
○
Kennwort (Wdh):
<Kennwort Wiederholung> wie Kennwort
●
Betätigen Sie „Anwenden“.
●
Beenden Sie BalticScore und starten es erneut.
4.2
PostgreSQL
Um BalticScore mit PostgreSQL betreiben zu können müssen folgende Voraussetzungen erfüllt
sein.
●
PostgreSQL 9.3 oder höher ist installiert (siehe 7 PostgreSQL installieren).
1. April 2015
Seite 3 von 7
BalticScore 3.0
Installationsanleitung BalticScore 3.0
4.2.1
Setzen der Einstellungen
●
Starten Sie BalticScore.
●
Wählen Sie „Fenster→Benutzervorgaben...“, unter Mac OS X auch
„BalticScore→Einstellungen...“
●
Wählen Sie unter „Allgemein→Datenbank“ den Dialekt „PostGreSQLDialect“.
●
Setzen Sie die Parameter wie folgt:
○
Datenbank:
//<Rechnername/<Schema> oder //<IP-Adresse>/<Schema>,
z.B. //localhost/balticscore3
○
Benutzer:
<Benutzer>
z.B. balticscore
○
Kennwort:
<Kennwort>
z.B. balticscore
○
Kennwort (Wdh):
<Kennwort Wiederholung>
wie Kennwort
●
Betätigen Sie „Anwenden“.
●
Beenden Sie BalticScore und starten es erneut.
5 Lizenz aktualisieren
Die Lizenz kann über das Hilfe-Menü („Hilfe→Lizenzdatei importieren...“) aktualisiert werden.
Die Lizenzdatei kann auch einen anderen Namen (z.B. „ TT_Bieber_Vereinslizenz.licenses“)
haben. Es wird automatisch die richtige Datei ersetzt.
6 MySQL installieren
Die Installationsdateien für den MySQL-Server können auf der Web-Site
http://dev.mysql.com/downloads/mysql runter geladen werden.
6.1
Windows
1. Installationsdatei (z.B. „ mysql-installer-community-5.6.23.0.msi“) als
Administrator ausführen
2. Lizenzbestimmungen akzeptieren
3. Installationstyp „Custom“ auswählen
4. Den passenden 32-Bit oder 64-Bit „MySQL Server 5.6“ und „MySQL Workbench 6.2“ zu
den zu installierenden Produkten hinzufügen
5. Gegebenenfalls „Microsoft Visual C++ 2013 Redistributable“ installieren
6. Installation starten
7. Konfigurationstyp „Server Machine“ auswählen und die restlichen Einstellungen belassen
8. Root-Kennwort festlegen
1. April 2015
Seite 4 von 7
BalticScore 3.0
Installationsanleitung BalticScore 3.0
9. Weiter bis zum Start der Serverkonfiguration
10. Weiter bis zum Ende der Installation
6.2
6.2.1
Mac OS X
MySQL-Server
1. Datei „mysql-5.6.23-osx10.9-x86_64.dmg“ von
https://dev.mysql.com/downloads/mysql/ herunterladen.
2. Datei „mysql-5.6.23-osx10.9-x86_64.dmg“ durch Doppel-Klick öffnen.
3. Installation des enthaltenen Pakets durch Doppel-Klick starten.
4. Lizenzbestimmungen akzeptieren.
5. Installation bestätigen.
6.2.2
MySQL-Workbench
1. Datei „mysql-workbench-community-6.2.5-osx-i686.dmg“ von
https://dev.mysql.com/downloads/workbench/ herunterladen.
2. Datei „mysql-workbench-community-6.2.5-osx-i686.dmg“ durch Doppel-Klick
öffnen.
3. Icon der Workbench auf das Application-Icon ziehen. Die Datei werden dann kopiert.
4. Zum Starten der Workbench muss das Kontext-Menü gewählt werden und die Frage, ob
dieses Programm, das von einem nicht zertifizierten Entwickler stammt, gestartet werden
soll, mit „Ja“ bzw. „Öffnen“ bestätigen.
6.3
Datenbank-Schema anlegen
Die für die Installation benötigte Datei „BalticScoreMySQLInstall_3.sql“ mit dem
Datenbank-Schema 3.0 kann unter http://www.balticscore.de „Downloads“ runter geladen werden.
1. MySQL-Workbench starten.
2. Mit der Datenbankinstanz verbinden.
3. Über „File→Open SQL Script...“ die Datei „BalticScoreMySQLInstall_3.sql“
öffnen.
4. Das komplette Script ausführen.
6.4
Benutzer anlegen
1. MySQL-Workbench starten.
1. April 2015
Seite 5 von 7
BalticScore 3.0
Installationsanleitung BalticScore 3.0
2. Mit der Datenbankinstanz verbinden.
3. Unter „MANAGEMENT“ „Users and Privileges“ wählen.
4. Einen neuen Benutzer (z.B. „balticscore“) mit der Schaltfläche „Add Account“ anlegen
Unter „Limit Connectivity...“ „localhost“ eintragen und das gewünschte Kennwort zweimal
eintragen. „Apply“ drücken.
5. Zur Rechtevergabe „Schema Privileges“ wählen.
6. Den angelegten Benutzer (z.B. „balticscore“) auswählen und dann die Schaltfläche „Add
Entry...“ betätigen.
7. Als „Selected Schema“ „balticscore3“ auswählen und bestätigen.
8. Mit „Select ALL“ alle Privilegien auswählen.
9. Mit „Apply“ den Eintrag speichern.
7 PostgreSQL installieren
Die Installationsdateien für den PostgreSQL-Server können von der Web-Site
http://www.postgresql.org/download/ herrunter geladen werden.
7.1
Windows
1. Die Installationsdatei, z.B. „ postgresql-9.3.6-1-windows.exe“ als Administrator
ausführen.
2. Alle Einstellungen unverändert lassen und das Kennwort für den Benutzer „postgres“
merken.
7.2
Mac OS X
1. Die Archivdatei, z.B. „postgresql-9.3.6-1-osx.zip“ entpacken.
2. postgresql-9.3.6-1-osx als Administrator ausführen.
3. Alle Einstellungen unverändert lassen und das Kennwort für den Benutzer „postgres“
merken.
7.3
Datenbank konfigurieren
1. Das Administrationsprogramm „pgAdmin III“ starten und das Kennwort für den Benutzer
„postgres“ eingeben.
2. Im Objektbrower zu „Login-Rollen“ navigieren und dort eine Login-Rolle anlegen.
3. Als Rollenname „balticscore“ eingeben, ein Kennwort vergeben und merken.
4. Speichern und Beenden per „OK“.
1. April 2015
Seite 6 von 7
BalticScore 3.0
Installationsanleitung BalticScore 3.0
5. Im Objektbrower zu „Datenbanken“ navigieren und dort eine Datenbank anlegen.
6. Als Name „balticscore3“ eingeben und als Eigentümer „balticscore“ auswählen.
7. Speichern und Beenden per „OK“.
8. Die Datenbank markieren und im Menü unter „Werkzeuge“ das „Abfragewerkzeug“ wählen.
9. In dem „Abfragewerkzeug“ eine neue Verbindung mit dem Benutzer „balticscore3“ anlegen
10. Über „Datei→öffnen...“ die Datei „BalticScorePostgreSQLInstall_3.sql“ öffnen.
11. Im Menü unter „Abfrage→pgScript Ausführen“ wählen. Alle Objekte werden angelegt.
12. Das Abfragewerkzeug beenden.
13. Im Objektbrowser die angelegte Datenbank „balticscore3“ auswählen und über das Menü
„Anzeigen→Auffrischen“ aktualisieren.
14. Die angelegten Tabellen können im Schema „public“ angesehen werden.
15. PgAdmin III beenden.
7.4
Remote-Zugriff freigeben
1. Administrationsprogramm „pgAdmin III“ starten und das Kennwort für den Benutzer
„postgres“ eingeben.
2. Über „Datei→pg_hba.conf öffnen...“ aufrufen. Die Datei im Datenverzeichnis auswählen
und öffnen.
3. Für jeden anderen PC die IP-Adresse angeben. Es können auch Bereiche angegeben werden.
Bitte in der PostgreSQL-Dokumentation nachlesen.
4. Speichern, beenden und PostgreSQL neu starten.
1. April 2015
Seite 7 von 7
BalticScore 3.0