ÖSTERREICHISCHER BRIDGESPORTVERBAND BridgeTeamContest Installation
Installations Handbuch Version 1.7 im Februar 2009 gültig für BTC Version 1.5.xxx DI Werner Broser im Auftrag des Österreichischen Bridgesportverbandes
Inhalt Allgemeines... 1 Zugehörige Dokumente... 1 Voraussetzungen... 1 Programme als Teil der Software... 1 Betriebssysteme... 2 Laufzeitumgebungen... 2 Datenbanken... 2 Sonstige Programme... 2 Funktionsumfang... 3 Einschränkungen... 4 Berechtigungen... 5 Installation... 6 Installationsablauf SQL Server... 7 Installation VC++ Redistributed package... 24 Installationsablauf BridgeTeamContest... 25 Fehler und Behebung... 27 Bridge Programme lassen sich nicht starten... 27 Ursachen... 27 Installation der BridgeTeam Datenbank schlägt fehl... 27 Ursache... 27
Kapitel 1 Allgemeines BridgeTeamContest (BTC). BTC ist eine Anwendung zur Abrechnung von Teamturnieren. Das Programm verwendet eine MS SQL Server Datenbank. Diese muß nicht auf dem lokalen (gleichen) Rechner installiert sein, auf dem das Programm ausgeführt wird. Es ist auch möglich, das in einer Umgebung mit mehreren PC's nur ein Datenbankserver verwendet wird, auf den alle PC's zugreifen. Die Installation kann, wenn erwünscht, auch so eingerichtet werden, das Benutzer mit eingeschränkten Rechten (das ist ein spezieller Windows Benutzertyp), Daten ändern können, nicht jedoch die Datenstruktur. Zugehörige Dokumente ÖBV WKO ÖBV MPO Voraussetzungen Zur Verwendung der Programme des BTC Softwarepaketes sind die im folgenden angeführten Voraussetzungen notwendig. Es ist durchaus möglich, daß Programme dieses Softwarepaketes auch unter anderen Bedingungen (Betriebssysteme, Service Packs, usw...) laufen, das ist aber nicht unterstützt. Das bedeutet es gibt keine Hilfestellung oder Fehlerbehebungen. Programme als Teil der Software BridgeTeamContest, das Programm zur TeamTurnierabrechnung BridgeTeamContestUpdate, Updateprogramm bei neuen Versionen BridgeTeamInstallDB, Erst-Installation der Datenbank SetupBridgeTeamContest, Setup Programm zum Installieren der Software 1
Betriebssysteme Windows XP 1 SP2 oder höher Windows Vista 2 Windows 2000 3 SP4 Windows Server 2003 4 Laufzeitumgebungen.NET 5 Framework 2.0 oder höher Microsoft Visual C++ 2005 SP1 Redistributable Package (x86) Datenbanken Microsoft SQL SERVER 6 2005 (EXPRESS Ausgabe) Sonstige Programme MagicMPComposer, Programm zur Abrechnung der Meisterpunkte und Bereitstellung der Daten für den ÖBV 1 Windows XP ist Markenzeichen von Microsoft Corporation 2 Windows Vista ist Markenzeichen von Microsoft Corporation 3 Windows 2000 ist Markenzeichen von Microsoft Corporation 4 Windows Server 2003 ist Markenzeichen von Microsoft Corporation 5.NET ist Warenzeichen von Microsoft Corporation 6 SQL SERVER ist Warenzeichen von Microsoft Corporation 2
Funktionsumfang BTC unterstützt folgende Funktionen: Ausrechnung von Teamturnieren nach WKO 1.4.2007 Meisterpunktevergabe nach MPO 1.7.2007 Auswertung nach IMPS Auswertung nach BAM Turnier in Gruppen abwickelbar (Sitzordnung kann je Gruppe unterschiedlich sein) Auf und Abstieg zwischen Runden möglich Sitzordnungen definierbar: Erste Runde vorgesetzt (1:2, 3:4,...) Zweite Runde vorgesetzt ( 1:n/2+1, 1:n/2+2,...) Dänisch nach Stand Vorrunde Schweiz nach Stand Vorrunde Dänisch nach Stand vor zwei Runden Schweiz nach Stand vor zwei Runden Bei ungerader Teamzahl Pause oder Sandkasten möglich (je Gruppe definierbar) Händisch erstellt Round Robin Modus Sitzordnungen können je Gruppe unterschiedlich sein Hierarchische Rangordnung über Gruppen oder Rangordnung je Gruppe bestimmbar Format (Layout) der Ausgabeformulare innerhalb gewisser Parameter konfigurierbar Export von allen Ausgabeformularen nach pdf Export von allen Ausgabeformularen nach html Import ÖBV Spielerdatei Import Spielerdaten aus MagicContest Kompatibel zu MagicMPComposer 3
Einschränkungen Die SQL SERVER Express Ausgabe hat im Vergleich zur Vollversion eine Reihe von Einschränkungen, wie zb. die ausschließliche Verwendung von nur einer CPU auch auf Mehrprozessormaschinen oder eine Größenbeschränkung der Datenbank auf 4GB. Für die Verwendung in Zusammenhang mit BTC ist das aber irrelevant. Programmtechnisch gibt es keine Einschränkungen für irgendeinen Turnierparameter. Round Robin Modus ist definiert für maximal 16 Teams/Gruppe, kann leicht erweitert werden. Einige wenige Einschränkungen sind WKO oder MPO bedingt gegeben. 4
Berechtigungen Der Zugriff auf die Datenbank erfolgt bei BTC über sogenannte gespeicherte Prozeduren, dadurch kann auch ein Benutzer mit eingeschränkten Rechten auf die Datenbank zugreifen. Für Änderungen an der Datenbank sind entweder Administratorrechte notwendig oder die Anmeldung erfolgt über einen Datenbankbenutzer mit dbo Rechten (dbo=database owner). Berechtigungsmatrix Diese Tabelle geht davon aus, dass Windows Integrierte Anmeldung und Anmeldung über Datenbankbenutzer im SQL Server aktiviert sind. Programm Windows Integrierte Anmeldung Benutzer mit eing. Rechten Windows Integrierte Anmeldung Administrator Datanbank Benutzer mit eingeschränkten Rechten Datenbank Benutzer mit dbo Rechten MS Installationsprogramme (SQL Server,.NET Framework) NEIN JA NEIN NEIN SetupBridgeTeamContest NEIN JA NEIN NEIN BridgeTeamContest JA JA JA JA BridgeTeamContest Dialog Datenbankeinstellungen NEIN JA NEIN NEIN BridgeTeamContestUpgrade NEIN JA NEIN JA BridgeTeamContestInstallDB NEIN JA NEIN JA 5
Kapitel 2 Installation Die Installation umfaßt folgende Schritte (je nach aktueller Installation eines Rechners, sind möglicherweise nicht alle Schritte notwendig): Installation.NET Redistributable Framework 2.0 Installation MS SQL SERVER Installation Microsoft Visual C++ 2005 SP1 Redistributable Package (x86) Installation BTC Installation der BridgeTeam Datenbank Einrichtung BTC: Konfigurieren Datenbankverbindung, Lizenz einspielen Datenbank SQL Server (EXPRESS Ausgabe) SQL SERVER EXPRESS ist in verschiedenen Konfigurationen gratis von Microsoft erhältlich. Zur Verwendung von BTC reicht die Installation des kleinsten Paketes (ca, 45MB), dieses hat keine graphische Benutzeroberfläche zur Datenbank. Die Variante mit allen verfügbaren Werkzeugen ist deutlich größer (ca. 280MB) und nur dann sinnvoll, wenn Sie vorhaben Datenbank Sicherungen (backup s) durchzuführen, Datenbankbenutzer anzulegen oder gleichartige Vorgänge planen. Die Installation des SQL Servers wirkt vorerst aufwendig, meistens können jedoch die vorgeschlagenen Standardwerte übernommen werden. Der Ablauf ist für alle Varianten nahezu identisch, beim Dialog zur Auswahl der zu installierenden Komponenten sind dann je nach Variante unterschiedliche Möglichkeiten vorhanden und mitunter haben die Dialoge ein leicht unterschiedliches Aussehen. 6
Installationsablauf SQL Server Die Installation der Datenbank muß mit Administratorrechten ausgeführt werden. Je nach Installationsvariante führen Sie eines der setup Programm aus: SQLEXPR32_DEU.EXE Sie müssen den Microsoft Lizenzbedingungen zustimmen: Bild 1: Lizenzbedingungen 7
Das setup Programm überprüft und installiert fallweise fehlende Software: Bild 2: Installation fehlender Komponenten Wenn Sie planen das SQL Server Management Studio zu installieren, muß wie auch für BTC - das.net Framework 2.0 od. höher installiert sein. Diese Komponente wird allerdings vom SQL Server Installationsprogramm nicht automatisch installiert. Beide Programme weisen aber darauf hin, falls diese Komponente fehlt. 8
Es erfolgt eine Meldung über Erfolg oder Mißerfolg Bild 3: Status Installation erforderlicher Komponenten 9
Jetzt beginnt die eigentliche Installation. Mitunter sind einige Dialoge in Englisch, lassen Sie sich dadurch nicht abschrecken... Bild 4: Start der eigentlichen SQL Server Installation 10
Das Installationsprogramm prüft ihr System. Alle angezeigten Aktionen müssen anschließend den Status OK (Success) haben. Bild 5: Systemüberprüfung 11
Bei den Registrierungsinformationen müssen Sie das Feld Name ausfüllen, eine eigentliche Registrierung bei Microsoft ist nicht notwendig, der Name kann auch beliebigen Inhalts sein. Die Option Erweiterte Konfigurationsoptionen ausblenden ist standardmäßig aktiviert (das ist leider wieder eine der öfters auftretenden Microsoft Formulierungen mit doppelter Verneinung), also erweiterte Optionen würden nicht angezeigt. Setzen Sie diese Option auf nicht ausgewählt. Bild 6: Registrierungsinformationen 12
Anschließend können Sie die zu installierenden Komponenten auswählen, wobei die standardmäßig angezeigten Optionen ausreichen. Einige Komponenten (zb. SQL Server Management Studio Express 7 ) stehen nur zur Verfügung, wenn Sie eines der Advanced Pakete installieren, was auch zu einem späteren Zeitpunkt nachgeholt werden kann. Bild 7: Komponentenauswahl 7 Management Studio Express ist Markenzeichen von Microsoft Corporation 13
Jetzt können Sie einen Instanznamen angeben, das ist jener Name mit der die sogenannte Datenbankengine angesprochen wird. Wählen Sie Benannte Instanz, der vorgeschlagene Name SQLExpress kann übernommen werden. Bild 8: Instanznamen wählen 14
Im Dialog Dienstkonto, der allerdings nicht bei jeder Installation angezeigt wird (nur Microsoft weiß warum), wird eingestellt unter welchem Benutzer ein Programm (service) läuft. Wählen Sie bitte jene Einstellungen wie abgebildet. Bild 9: Dienstkonto Falls bei der Installation dieser Dialog nicht angezeigt wird, können diese Einstellung mittels graphischem Konfigurationstool nachträglich verändert werden. 15
Auch der folgende Dialog Authentifizierung wird leider nicht immer angezeigt. Die Option Windows-Authentifizierungsmodus (=Integrierte Anmeldung) und Gemischter Modus ist nur notwendig, wenn Sie vorhaben über definierte Datenbankbenutzer auf die Datenbank zuzugreifen. Bild 10: Authentifizierung 16
Im Dialog Sortierung wird eingestellt, nach welchen Kriterien der SQL Server Daten sortieren und behandeln soll. Der Standardwert hängt von den lokalen Einstellungen (Ort, Sprache, usw.) ab und sollte auf jeden Fall auf Latin1_General eingestellt sein, sowie die Checkbox Unterscheidung nach Akzent ausgewählt werden. Bild 11: Sortierungseinstellungen Auch dieser Dialog wird mitunter nicht bzw. etwas unterschiedlich angezeigt. Evnetuell sind auch alle Einstellungen der Checkboxen in einer einzigen Konfigurationskennung zusammengefasst, diese sollte dann entweder auf Latin1_General_CI_AS oder SQL_Latin1_General_CP1_CI_AS gesetzt sein (kann aus einer Liste von Werten gewählt werden). CI steht für Case Insensitiv (Groß und. Kleinschreibung wird nicht unterschieden). AS steht für Accent sensitiv (Akzent wird unterschieden). 17
Im Dialog Konfigurationsoptionen wählen Sie Benutzerinstanzen aktivieren Bild 12: Konfigurationsoptionen 18
Normalerweise werden bei einer Erstinstallation des Servers keine vorhandenen Komponenten gefunden, die gesondert zu behandeln sind. Dieser Dialog wird manchmal nicht angezeigt. Bild 13: Vorhandene Komponenten 19
Fehlerberichte und Komponentenverwendung brauchen Sie nicht an Microsoft senden, diese Optionen können Sie daher unausgewählt lassen. Bild 14: Fehlerberichte senden 20
Der Dialog informiert, dass SQL Server alle Informationen erhalten hat. Bild 15: Installationsbereit 21
Nach Installation der Komponenten, müssen alle den Status OK (grünes Häkchen) aufweisen. Bild 16: Setup Fortschritt 22
Die Installation ist jetzt nahezu abgeschlossen, es erscheint der letzte Dialog (fallweise Englisch und Deutsch gemischt!). Bild 17: Setup Ende 23
Installation VC++ Redistributed package Für Applikationen die Visual C++ verwenden, sind ist eine zusätzliche Laufzeitumgebung notwendig, die allerdings auf den meisten Computern installiert ist. Unter Software bzw. Programme in der Systemsteuerung könnte das überprüft werden. Eine nochmalige Installation schadet aber nicht. Die Installation erfolgt durch Aufruf der Datei: vc_redist_x86.exe Das Verhalten dieses Installationspaketes ist etwas eigenartig, es gibt keine Meldung über eine erfolgreiche Ausführung, sondern das Programm endet einfach. 24
Installationsablauf BridgeTeamContest Die Installation von BTC muß mit Administratorrechten erfolgen. Führen Sie dazu das Programm SetupBridgeTeamContest.exe aus. Die einzige Angabe, die Sie machen müssen ist das Zielverzeichnis der Installation. Sie können auch den vorgeschlagenen Wert C:\Programme\BridgeTeamContest übernehmen. Weitere Eingaben sind nicht notwendig. Im Zuge des Setups wird automatisch das Installationsprogramm BridgeTeamContestInstallDB aufgerufen. Das Installieren der Datenbank ist nur bei der Erstinstallation notwendig und möglich. Sie müssen einige Daten, zum Herstellen einer Verbindung zur SQLServer Instanz, eingeben. Bild 18: Datenbank Installation Datenbanksystem: Derzeit nur SQL Server 2005 wählbar. Datenbank Instanz: Der Name der SQL Server Instanz. Auf einem Rechner können mehrere Instanzen installiert sein, sowie können mehrere Rechner in einem Netzwerk verfügbar sein. 25
Mittels Laden werden diese Instanzen gesucht, dieser Vorgang kann einige Zeit in Anspruch nehmen. Bei isolierten Rechnern wird hier genau eine Instanz angezeigt, nämlich jene des lokalen Rechners. Falls nach dem Vorgang Laden ein Fehler der Form.. Index 0 unzulässig auftritt, ist der SQL Server Browserdienst nicht gestartet. Sie können entweder den Namen der Instanz in der Form <Rechnername>\Instanzname, also zb.: Arbeitsplatz2\SQLEXPRESS händisch eintragen, oder den Browserdienst über die SQL Server Konfiguration starten und den Vorgang Laden wiederholen. Windows Integrierte Anmeldung: Der SQL Server erlaubt Anmeldungen über den Windows Benutzer, wenn dies in der Datenbank so eingestellt ist (Standardeinstellung). Dessen Betriebssystem Rechte werden in etwa auf die Rechte eines Datenbankbenutzers in der Datenbank übertragen. Wenn Sie sich als Administrator anmelden, haben Sie auch in der Datenbank alle Rechte. Bei integrierter Anmeldung brauchen Sie sich nicht mehr gesondert an der Datenbank anmelden. Benutzer und Passwort sind notwendig, wenn Sie nicht die Windows Integrierte Anmeldung, sondern einen Datenbankbenutzer zur Anmeldung verwenden. Dieser Benutzer muß in der Datenbank angelegt sein und Datenbankadminstratorrechte (oder gleichwertige) besitzen. Wenn die Checkbox Einstellungen für Datenbank Zugriff auch für BridgeTeamContest verwenden ausgewählt ist, werden die Einstellungen gespeichert und für BTC verwendet. Das Programm erzeugt die BridgeTeam Datenbank mittels eines Wiederherstellungsvorganges (RESTORE) aus der Backup Datei <Installationsverzeichnis>\BridgeTeam.bck. Als letzen Schritt müssen Sie noch im Programm BTC die Verbindung zur Datenbank konfigurieren (sofern nicht im Installationsprogramm gespeichert) und eine Lizenz eingeben. Sehen Sie bitte dazu die Beschreibungen der Dialoge Turnier Verwaltung Einstellungen Admin: Datenbank und Hilfe Lizenz verwalten Beim Start von BridgeTeamContest wird solange die Datenbankverbindung nicht konfiguriert ist, folgender Fehler auftreten: Bild 19: Fehler beim Starten von BridgeTeamContest 26
Fehler und Behebung Die Anzahl der Fehler die während der Installation auftreten können, ist sehr groß. Eine komplette oder auch nur ansatzweise Auflistung würde den Rahmen dieses Dokumentes überschreiten. Auf zwei häufige Fehler und deren Behebung möchte ich jedoch eingehen. Bridge Programme lassen sich nicht starten Beim Start der Bridgeprogramme (BridgeTeamContestInstallDB, BridgeTeamContestUpgrade oder BridgeTeamContestUpgrade kommt eine Meldung der Form Komponente fehlt oder nicht gefunden Ursachen Entweder ist das VC++ Redistribute Package oder.net Framework nicht installiert. Für Fehler aufgrund Datenbankverbindung nicht eingerichtet, sehen sie bitte das vorige Kapitel. Installation der BridgeTeam Datenbank schlägt fehl Beim Ausführen der Datenbank Installation BridgeTeamContestInstallDB, nach bereits erfolgreicher Anmeldung an die Datenbank kommt eine Meldung der Form Access denied oder Das Betriebssystem hat bei Restore Container::ValidateTargetforCreation für C:\Programme\Bridge usw... Ursache Vermutlich läuft der SQLServer nicht unter dem Lokalen System Account, sondern unter dem Netzwerkdienst. Das kann behoben werden, in dem die SQL Server Konfiguration aufgerufen und der Dienst SQL Server geändert wird. Bild 20: Starten der SQL Server Konfiguration (sprachabhängig) 27
Aufruf des SQL Server 2005 Services SQL Server <Name> (meist SQLEXPRESS) Bild 21: SQL Server Konfigurations Manager 28
Einstellen der Eigenschaften (Properties) des Accounts auf Local System Bild 22: SQL Server Eigenschaften Der SQL Server muß daraufhin neu gestartet werden. Jetzt sollte das Installieren der Datenbank funktionieren. 29
Bilderindex BILD 1: LIZENZBEDINGUNGEN... 7 BILD 2: INSTALLATION FEHLENDER KOMPONENTEN... 8 BILD 3: STATUS INSTALLATION ERFORDERLICHER KOMPONENTEN... 9 BILD 4: START DER EIGENTLICHEN SQL SERVER INSTALLATION... 10 BILD 5: SYSTEMÜBERPRÜFUNG... 11 BILD 6: REGISTRIERUNGSINFORMATIONEN... 12 BILD 7: KOMPONENTENAUSWAHL... 13 BILD 8: INSTANZNAMEN WÄHLEN... 14 BILD 9: DIENSTKONTO... 15 BILD 10: AUTHENTIFIZIERUNG... 16 BILD 11: SORTIERUNGSEINSTELLUNGEN... 17 BILD 12: KONFIGURATIONSOPTIONEN... 18 BILD 13: VORHANDENE KOMPONENTEN... 19 BILD 14: FEHLERBERICHTE SENDEN... 20 BILD 15: INSTALLATIONSBEREIT... 21 BILD 16: SETUP FORTSCHRITT... 22 BILD 17: SETUP ENDE... 23 BILD 18: DATENBANK INSTALLATION... 25 BILD 19: FEHLER BEIM STARTEN VON BRIDGETEAMCONTEST... 26 BILD 20: STARTEN DER SQL SERVER KONFIGURATION (SPRACHABHÄNGIG)... 27 BILD 21: SQL SERVER KONFIGURATIONS MANAGER... 28 BILD 22: SQL SERVER EIGENSCHAFTEN... 29 30