hyscore Installation Kurzanleitung für Windows-Server

Transkript

1 hyscore Installation Kurzanleitung für Windows-Server PDF-Dokument: installation_45_v13.pdf Version 4.5 Ausgabe Seite 1

2 Inhalt Ablaufplan... 3 Bevor Sie beginnen... 4 Inhalt der hyscore-datenträger...4 Schritt 1: hyscore Installation... 5 Schritt 2: Cold Fusion Installation... 5 Schritt 3: Cold Fusion Konfiguration... 5 Schritt 4: Die hyscore Datenbanken einrichten... 5 Installation der Reorganisations-Datenbank unter Windows 32bit... 6 Installation der Reorganisations-Datenbank unter Windows 64bit... 8 Mit MS SQL-Datenbank... 8 Installation der hyscore-datenbank hyscore mit MS SQL-Datenbank hyscore mit MySQL-Datenbank CF-Client Database einrichten Schritt 5: hyscore Systemdaten installieren Aufruf des Installationsprogramms Parameter für den Datenbank-Zugriff festlegen Datenbank und Verbindung testen hyscore Tabellen anlegen Indizes anlegen Systemdaten überspielen Schritt 6: Testen der Installation Fortsetzung der Einrichtungsarbeiten Online-Ressourcen Anleitung zum Update der ColdFusion Seriennnummer Änderungshistorie Version 4.5 Ausgabe Seite 2

3 Ablaufplan VORBEREITUNG Systemvoraussetzungen sicherstellen siehe Datenblatt hyscore_systemvoraussetzungen.pdf Webserver einrichten SQL-Datenbank(en) anlegen siehe Datenblatt hyscore_db_anbindung.pdf hyscore Applikation installieren ColdFusion Server installieren siehe separate Anleitung install_cf9_windows.pdf ColdFusion Server konfigurieren siehe separate Anleitung config_cf9.pdf Basisinstallation testen hyscore Datenbank(en) installieren Testlogin ins hyscore-system Ende Version 4.5 Ausgabe Seite 3

4 Bevor Sie beginnen 1.) Vergewissern Sie sich anhand des Datenblattes hyscore_systemvoraussetzungen.pdf, dass die Systemvoraussetzungen erfüllt sind. Das Datenblatt können Sie ebenso wie alle anderen hier erwähnten Anleitungen und Dokumente unter herunterladen. 2.) Dokumentieren Sie alle nötigen Angaben wie -Konten, Serveradressen, Datenbankserver, DB-User und Passworte. Sie können hierfür das Dokument hyscore_install_doku.doc verwenden. 3.) Prüfen Sie die Voraussetzungen für die Installation von hyscore anhand der Checkliste chklist_install_termin.pdf. Inhalt der hyscore-datenträger hyscore wird entweder auf CD oder DVD ausgeliefert. Je nach Version erhalten Sie einen oder mehrere Datenträger. Verzeichnis Disk1/coldfusion Disk2/docs Disk2/downloads Disk2/hyscore Disk2/database Disk2/mySQL Disk2/patches Disk2/tools Inhalt Installationsprogramm der aktuellen ColdFusion Version Anleitungen und Dokumente Anleitung zum Download der aktuellen Patches und Update- Versionen aktuelle hyscore-version, als ZIP-Archiv oder EXE-Datei hyscore-installationsdatenbank für mysql, im Format.sql aktuelle mysql-version für Windows Server in der Regel ist dieses Verzeichnis leer, weil man das aktuelle Patch herunterladen kann Hilfsprogramme zum Lesen von PDF-Dateien und Extrahieren von ZIP-Archiven Version 4.5 Ausgabe Seite 4

5 Schritt 1: hyscore Installation Entpacken Sie die aktuelle hyscore-anwendung (zu finden im "hyscore"-verzeichnis auf der CD) in das Verzeichnis "hyscore" unterhalb des Basisverzeichnisses des Webservers. Der Standardpfad zum Entpacken ist das Verzeichnis "C:\Inetpub\wwwroot\hyscore". Bitte passen Sie dies falls nötig an die Gegebenheiten Ihres Webservers an. Entpacken Sie dann falls vorhanden - das aktuelle Patch (zu finden im Verzeichnis patches auf der CD ) in ein temporäres Verzeichnis. Kopieren Sie dann die entpackten Verzeichnisse und Dateien des Patches über die entsprechenden Verzeichnisse und Dateien der hyscore Anwendung. Schritt 2: Cold Fusion Installation Hierzu gibt es eine ausführliche Anleitung als separates Dokument: Für ColdFusion 8: install_cf8_windows.pdf Für ColdFusion 9: install_cf9_windows.pdf Schritt 3: Cold Fusion Konfiguration Hierzu gibt es eine ausführliche Anleitung als separates Dokument: Für ColdFusion 8: config_cf8_windows.pdf Für ColdFusion 9: config_cf9_windows.pdf Schritt 4: Die hyscore Datenbanken einrichten hyscore benötigt eine Datenbank zum Speichern der Anwendungsdaten (z.b. "hyscore") und eine Datenbank speziell für Installation, Updates und Reorganisation. Die Verwaltung der Datenquellen erfolgt im ColdFusion Administrator im Menü "Data & Services Data Sources". Version 4.5 Ausgabe Seite 5

6 Installation der Reorganisations-Datenbank unter Windows 32bit Geben Sie im Formular "Add New Data Source" in das Feld "Data Source Name" den Namen "hyscore_reorg" ein und wählen Sie im Feld "Driver" die Option "Microsoft Access with Unicode". Klicken Sie dann auf [Add] Im nächsten Bildschirm können Sie die Einstellungen für diese Datenquelle festlegen. Klicken Sie auf [Show Advanced Settings], um zusätzliche Einstellmöglichkeiten einzublenden: Version 4.5 Ausgabe Seite 6

7 Nehmen Sie hier die folgenden Einstellungen vor: Database File: Dateiname der Access-Datenbankdatei, diese heißt hyscore_reorg.mdb und befindet sich im Verzeichnis /reorg unterhalb des hyscore-anwendungsverzeichnisses, z.b. C:\Inetpub\wwwroot\hyscore\reorg\hyscore_reorg.mdb (Hinweis: Der in der Abbildung gezeigte Pfad dient nur zur Illustration und weicht möglicherweise vom tatsächlichen Speicherort ab! ) ColdFusion User Name und ColdFusion Passwort: Diese Felder sollten leer sein. Maintain Connections across clients requests: Diese Option muss AUSGESCHALTET sein Enable long text retrieval (CLOB): Diese Option muss EINGESCHALTET sein Long Text Buffer: Den Wert eintragen Dann [Submit] klicken, um die Einstellungen zu speichern. Die neue Datenbank wird dadurch in der Liste der installierten Datenquellen angezeigt. Version 4.5 Ausgabe Seite 7

8 Wichtig! Durch das Speichern der Änderungen führt ColdFusion automatisch einen Verbindungstest zur Datenbank durch. Das Ergebnis dieses Tests wird in der Spalte Status angezeigt. In der Spalte "Status" muß unbedingt ein "OK" stehen, sonst stimmt etwas am Pfad, an der Datei oder den Berechtigungen nicht! Installation der Reorganisations-Datenbank unter Windows 64bit Mit MS SQL-Datenbank Wichtig: Der SQL Server muß TCP/IP Verbindungen akzeptieren! Legen Sie zunächst unter MS SQL eine neue Datenbank hyscore_reorg an. Wählen Sie als Wiederherstellungsmodell unbedingt Einfach. Die Log-Files werden sonst zu groß. Wählen Sie unbedingt eine CASE INSENSITIVE Sortierung, z.b. Latin1_General_CI_AS Version 4.5 Ausgabe Seite 8

9 Benutzen Sie dann die mit hyscore ausgelieferte Access-Datenbank, um die Reorganisationsdatenbank in MS SQL mit Daten zu füllen. Wählen Sie dazu in der SQL-Managementconsole für die Reorganisationsdatenbank die Option Daten importieren und dann den Assistenten für 32bit. Im anschließenden Dialog wählen Sie Access Datenbank als Datenquelle aus, die Datenbankdatei heißt hyscore_reorg.mdb und befindet sich im Verzeichnis /reorg unterhalb des hyscore-anwendungsverzeichnisses, z.b. C:\Inetpub\wwwroot\hyscore\reorg\hyscore_reorg.mdb Übertragen Sie alle Tabellen und Daten aus der Access-Datenbank in die MS SQL Datenbank. Legen Sie dann einen Benutzer für den Zugriff durch den ColdFusion Applikationsserver an. Dieser Benutzer benötigt folgende Berechtigungen (Mitgliedschaft in Datenbankrollen): db_datareader, db_datawriter, db_owner. Die zugehörige Anmeldung darf keine Windows-Authentifizierung benutzen, sondern muss die SQL Server Authentifizierung verwenden. Schalten Sie die Kennwortrichtlinie für die Anmeldung aus bzw. deaktivieren Sie zumindest den automatischen Ablauf des Kennwortes. Anschließend können Sie die Datenquelle unter ColdFusion einrichten: Geben Sie im Formular "Add New Data Source" in das Feld "Data Source Name" den Namen "hyscore_reorg" ein und wählen Sie im Feld "Driver" die Option "Microsoft SQL Server". Klicken Sie dann auf [Add] Dadurch wird der Bildschirm "Datasources > Microsoft SQL Server" angezeigt. Klicken Sie auf [Show Advanced Settings], um zusätzliche Einstellmöglichkeiten einzublenden und nehmen Sie folgende Einstellungen vor: CF Data Source name Database Server Port Username Password Alias-Name der Datenquelle in Cold Fusion, default: "hyscore_reorg" Datenbankname im SQL Server Name des SQL Servers oder IP Portnummer für TCP/IP Verbindungen Benutzername im SQL Server Passwort des Benutzers Maintain Connections across clients requests: Diese Option muss EINGESCHALTET sein Enable long text retrieval (CLOB): Diese Option muss EINGESCHALTET sein Long Text Buffer: Den Wert eintragen Speichern Sie Ihre Angaben mit [Submit]. Anschließend muss der Name der neuen Datenquelle in der Liste angezeigt werden, der Status sollte "OK" sein. Version 4.5 Ausgabe Seite 9

10 Installation der hyscore-datenbank hyscore mit MS SQL-Datenbank Wichtig: Der SQL Server muß TCP/IP Verbindungen akzeptieren! Legen Sie zunächst unter MS SQL eine neue Datenbank an. Wählen Sie als Wiederherstellungsmodell unbedingt Einfach. Die Log-Files werden sonst zu groß. Wählen Sie unbedingt eine CASE INSENSITIVE Sortierung, z.b. Latin1_General_CI_AS Legen Sie dann einen Benutzer für den Zugriff durch den ColdFusion Applikationsserver an. Dieser Benutzer benötigt folgende Berechtigungen (Mitgliedschaft in Datenbankrollen): db_datareader, db_datawriter, db_owner. Die zugehörige Anmeldung darf keine Windows-Authentifizierung benutzen, sondern muss die SQL Server Authentifizierung verwenden. Schalten Sie die Kennwortrichtlinie für die Anmeldung aus bzw. deaktivieren Sie zumindest den automatischen Ablauf des Kennwortes. Anschließend können Sie die Datenquelle unter ColdFusion einrichten: Geben Sie im Formular "Add New Data Source" in das Feld "Data Source Name" den Namen "hyscore" ein und wählen Sie im Feld "Driver" die Option "Microsoft SQL Server". Klicken Sie dann auf [Add] Dadurch wird der Bildschirm "Datasources > Microsoft SQL Server" angezeigt. Klicken Sie auf [Show Advanced Settings], um zusätzliche Einstellmöglichkeiten einzublenden und nehmen Sie folgende Einstellungen vor: CF Data Source name Database Server Port Username Password Alias-Name der Datenquelle in Cold Fusion, default: "hyscore" Datenbankname im SQL Server Name des SQL Servers oder IP Portnummer für TCP/IP Verbindungen Benutzername im SQL Server Passwort des Benutzers Maintain Connections across clients requests: Diese Option muss EINGESCHALTET sein Enable long text retrieval (CLOB): Diese Option muss EINGESCHALTET sein Long Text Buffer: Den Wert eintragen Speichern Sie Ihre Angaben mit [Submit]. Anschließend muss der Name der neuen Datenquelle in der Liste angezeigt werden, der Status sollte "OK" sein. Version 4.5 Ausgabe Seite 10

11 hyscore mit MySQL-Datenbank Wichtig: Der SQL-Server muß TCP/IP Verbindungen akzeptieren! Legen Sie zunächst unter MySQL ein neues Schema an. Legen Sie dann einen Benutzer für den Zugriff durch den ColdFusion Applikationsserver an. Dieser Benutzer benötigt für das Schema alle Berechtigungen. Anschließend können Sie die Datenquelle unter ColdFusion einrichten: Geben Sie im Formular "Add New Data Source" in das Feld "Data Source Name" den Namen "hyscore" ein und wählen Sie im Feld "Driver" die Option "MySQL (4/5)". Klicken Sie dann auf [Add] Dadurch wird der Bildschirm "Datasources > MySQL (4/5)" angezeigt. Klicken Sie auf [Show Advanced Settings], um zusätzliche Einstellmöglichkeiten einzublenden und nehmen Sie folgende Einstellungen vor: CF Data Source name Database Server Port Username Password Alias-Name der Datenquelle in Cold Fusion, default: "hyscore" Name des Schemas im MySQL Server Name des Servers oder IP (default: localhost) Portnummer für TCP/IP Verbindungen Benutzername im MySQL Server Passwort des Benutzers Maintain Connections across clients requests: Diese Option sollte EINGESCHALTET sein Enable long text retrieval (CLOB): Diese Option muss EINGESCHALTET sein Long Text Buffer: Den Wert eintragen Speichern Sie Ihre Angaben mit [Submit]. Anschließend muss der Name der neuen Datenquelle in der Liste angezeigt werden, der Status sollte "OK" sein. Version 4.5 Ausgabe Seite 11

12 CF-Client Database einrichten ColdFusion verfügt über ein Client Management, mit dem u.a. die Ids der Client-Verbindungen und das Datum des letzten Besuchs eines Clients für eine Zeitlang gespeichert werden. Unter Windows speichert ColdFusion diese Informationen standardmäßig in der Registry. Bei weniger als 100 lizenzierten Usern ist das auch völlig ausreichend. Bei mehr als 100 Usern sollten Sie aus Performance-Gründen die Informationen des Client-Managements jedoch in einer eigenen SQL-Datenbank speichern lassen. Legen Sie hierzu auf die gleiche Weise wie oben beschrieben eine weitere SQL-Datenbank mit dem zugehörigen Benutzer an, der Benutzer benötigt alle Rechte. Richten Sie diese Datenbank unter dem Namen cfclientmgt als ColdFusion Datenquelle ein. Version 4.5 Ausgabe Seite 12

13 Danach im Menü zum Punkt "Server Settings / Client Variables" wechseln: Dort im Abschnitt Select Data Source to Add as Client Store die Datenquelle cfclientmgt auswählen und auf [Add] klicken: Version 4.5 Ausgabe Seite 13

14 Im anschließenden Bildschirm die Optionen wie gezeigt setzen: Create Client database tables: ankreuzen Purge data for clients that remain unvisited for [ 90 ] days: ankreuzen Disable global client variable updates: NICHT ankreuzen Dann [Submit changes] klicken. Daraufhin erscheint die Datenbank als neuer Eintrag in der Liste Select Default Storage Mechanism for Client Sessions : Aktivieren Sie das Optionsfeld links neben dem Namen der Datenbank und klicken Sie [Apply]. Schritt 5: hyscore Systemdaten installieren Achtung! Zuvor müssen Sie unbedingt die Reorganisations-Datenbank und die hyscore- Datenbank als ColdFusion-Datenquellen angemeldet haben! Aufruf des Installationsprogramms Das Installationsprogramm "index.cfm" befindet sich im Ordner "install" unterhalb des hyscore Basisverzeichnisses. Das Installationsprogramm muss manuell durch Eingabe der entsprechenden Adresse in die Adresszeile des Webbrowsers aufgerufen werden: Version 4.5 Ausgabe Seite 14

15 Durch Aufruf der URL wird das Hauptmenü des Installationsprogramms angezeigt: Bitte folgen Sie den Anweisungen des Programms: Parameter für den Datenbank-Zugriff festlegen Geben Sie den Alias-Namen der Ziel-Datenbank (=Produktionsdatenbank für die hyscore-daten) ein, so wie er in ColdFusion eingerichtet ist. Standardwert: hyscore Wählen Sie die Art der Datenbank aus der Liste aus. Aktivieren Sie die Option "Vorhandene Daten... löschen (empfohlen)." Klicken Sie auf [Übernehmen], um die Einstellungen zu speichern. Version 4.5 Ausgabe Seite 15

16 Danach wird das erfolgreiche Speichern der Sitzungsvariablen angezeigt. Anschließend können Sie das Fenster schließen. Datenbank und Verbindung testen Klicken Sie auf "Testtabelle anlegen" und danach auf "Testtabelle löschen" um die Datenbankverbindung zu testen. hyscore Tabellen anlegen Klicken Sie auf den Menüpunkt, um die hyscore-tabellen in der Datenbank anzulegen. Indizes anlegen Klicken Sie auf den Menüpunkt, um die Indizes in der Datenbank anzulegen. Version 4.5 Ausgabe Seite 16

17 Systemdaten überspielen Klicken Sie jeden Tabellennamen einmal an, um die zugehörigen Daten zu übertragen. Die Übertragung wird jeweils in einem neuen Fenster geöffnet, das Sie nach dem Ende jeweils schließen können, sobald die entsprechende Meldung in diesem Fenster erscheint. Schritt 6: Testen der Installation Geben Sie im Browser die Adresse der Datei "index.cfm" im hyscore Anwendungsverzeichniss ein, also z.b.: Danach muss der Login-Bildschirm von hyscore erscheinen. Fortsetzung der Einrichtungsarbeiten hyscore Implementierung: Checkliste zur Ersteinrichtung (hyscore ab Version 4.3.x) (Dateiname: chklist_ersteinrichtung_v43x.pdf) Version 4.5 Ausgabe Seite 17

18 Online-Ressourcen Die hier erwähnten Anleitungen und Datenblätter stellen wir im Online-Hilfekatalog zum Download zur Verfügung: Anleitung zum Update der ColdFusion Seriennnummer Falls ColdFusion im Demo-Modus installiert wurde, muß man VOR DEM Ablauf der 30-Tage- Testphase die Seriennummer aktualisieren, bevor der Server von mehreren Benutzern gleichzeitig genutzt werden kann. Um die Seriennummer zu ändern, muß man in der Kopfzeile des rechten großen Bildschirmfensters auf das i im blauen Kreis klicken: Dort unter "New Licence" die Seriennummer eintragen und auf "Submit Changes" klicken. Das Feld "Update File" kann normalerweise leer bleiben. Die neue Lizenz wird anschließend in der Tabelle System Information angezeigt. Version 4.5 Ausgabe Seite 18

19 Änderungshistorie Aktion Neues Dokument mit Versionierung Anpassung an Version 4.5 und CF 9 Ergänzung: Reorg-DB unter Win64bit Hinweis auf Case Insensitive Sortierung ergänzt Datum Bearbeiter Freigabedatum Freigegeben durch Ralf Guttmann Ralf Guttmann Ralf Guttmann Ralf Guttmann Ralf Guttmann Ralf Guttmann Ralf Guttmann Ralf Guttmann Version 4.5 Ausgabe Seite 19