hyscore Installation Kurzanleitung für Windows-Server PDF-Dokument: installation_49_v14.pdf Version 4.9 Ausgabe 14 10.11.2011 Seite 1
Inhalt Ablaufplan... 3 Bevor Sie beginnen... 4 Auslieferung auf Datenträger... 4 Auslieferung als Download... 5 Wichtige Hinweise... 5 Schritt 2: Installation der hyscore Datenbank... 6 Schritt 3: Cold Fusion Installation... 6 Schritt 4: Cold Fusion Konfiguration... 6 Schritt 5: hyscore Datenquellen in ColdFusion einrichten... 6 Einrichten der Reorganisations-Datenbank unter Windows 32bit... 7 Einrichten der Reorganisations-Datenbank unter Windows 64bit... 9 Einrichten der hyscore-datenbank unter ColdFusion... 11 a) mit MS SQL-Datenbank... 11 b) mit MySQL-Datenbank... 11 Optional: CF-Client Database einrichten... 13 Schritt 6: hyscore System einrichten... 16 Fortsetzung der Einrichtungsarbeiten... 16 Online-Ressourcen... 16 Anleitung zum Update der ColdFusion Seriennnummer... 17 Änderungshistorie... 18 Version 4.9 Ausgabe 14 10.11.2011 Seite 2
Ablaufplan VORBEREITUNG Systemvoraussetzungen sicherstellen siehe Datenblatt hyscore_systemvoraussetzungen.pdf Webserver einrichten mysql installieren *) *) falls erforderlich hyscore Applikation installieren SQL-Datenbank installieren siehe separate Anleitung: hyscore_db_installation.pdf ColdFusion Server installieren ColdFusion Server konfigurieren siehe separate Anleitung install_cf9_windows.pdf Login als hypervisor siehe separate Anleitung config_cf9.pdf Ersteinrichtung, Step 1 Ende Version 4.9 Ausgabe 14 10.11.2011 Seite 3
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 www.hyscore.de/help herunterladen. 2.) Dokumentieren Sie alle nötigen Angaben wie Email-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. Auslieferung auf Datenträger hyscore wird in der Regel 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, als Backup für mysql, im Format.sql bzw. Format.bak für MS 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.9 Ausgabe 14 10.11.2011 Seite 4
Auslieferung als Download Alternativ bieten wir hyscore auch zum Download an. In diesem Fall müssen Sie jedoch ColdFusion sowie den mysql Datenbankserver separat von den jeweiligen Websites herunterladen. Download von hyscore Die Downloadadresse und die Zugangsdaten erhalten Sie zusammen mit Ihrer Lizenzurkunde per Email. Download von ColdFusion 9 Standard http://www.adobe.com/go/trycoldfusion_de/ Hinweis: Sie benötigen eine Adobe-ID, um Zugriff auf den Download zu erhalten. Falls Sie noch keine Adobe-ID besitzen, müssen Sie sich zuerst registrieren. Download von mysql Community Edition http://www.mysql.com/downloads/mysql/ Wichtige Hinweise Diese Anleitung beschreibt eine Installation vom Datenträger. Wenn Sie die Softwarekomponenten selbst herunterladen, stimmen daher Ihre tatsächlichen Verzeichnispfade nicht mit den hier angegebenen Pfaden überein. Version 4.9 Ausgabe 14 10.11.2011 Seite 5
Schritt 1: hyscore Installation Entpacken Sie die aktuelle hyscore-anwendung 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 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: Installation der hyscore Datenbank Hinweis zur Download-Version: Nach dem Herunterladen und Entpacken der hyscore Version finden Sie im Verzeichnis /datenbank die entsprechenden Installationsdateien der hyscore-datenbank, z.b. hyscore_49xx.sql für mysql oder hyscore_49xx.mdb für MS SQL Server. Benutzen Sie diese Backupdatei, um eine neue hyscore-datenbank zu erstellen. Hierzu gibt es eine ausführliche Anleitung als separates Dokument: hyscore_db_installation.pdf Schritt 3: 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 4: 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 5: hyscore Datenquellen in ColdFusion einrichten hyscore benötigt eine Datenbank zum Speichern der Anwendungsdaten (z.b. "hyscore") und eine Reorg-Datenbank speziell für Installation, Updates und Reorganisation. Die Verwaltung der Datenquellen erfolgt im ColdFusion Administrator im Menü "Data & Services Data Sources". Version 4.9 Ausgabe 14 10.11.2011 Seite 6
Einrichten der Reorganisations-Datenbank unter Windows 32bit Die Reorg-Datenbank ist eine MS-Access-Datenbankdatei mit dem Namen hyscore_reorg.mdb, sie befindet sich im Verzeichnis /reorg. 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.9 Ausgabe 14 10.11.2011 Seite 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 128000 eintragen Dann [Submit] klicken, um die Einstellungen zu speichern. Die neue Datenbank wird dadurch in der Liste der installierten Datenquellen angezeigt. Version 4.9 Ausgabe 14 10.11.2011 Seite 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! Einrichten der Reorganisations-Datenbank unter Windows 64bit Unter Windows 64bit werden unter ColdFusion Standard leider nur Datenquellen des MS SQL Server unterstützt. Die Reorg-Datenbank muss daher in diesem Fall ebenfalls als MS SQL Datenbank eingerichtet werden: 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.9 Ausgabe 14 10.11.2011 Seite 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 Reorg-Datenbank als 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 128000 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.9 Ausgabe 14 10.11.2011 Seite 10
Einrichten der hyscore-datenbank unter ColdFusion a) mit MS SQL-Datenbank Wichtig: Der SQL Server muß TCP/IP Verbindungen akzeptieren! Legen Sie zunächst unter MS SQL die hyscore.datenbank an. Das Verfahren ist ausführlich in der separaten Anleitung hyscore_db_installation.pdf beschrieben. 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 128000 eintragen Enable binary large object retrieval (BLOB): Diese Option muss EINGESCHALTET sein Speichern Sie Ihre Angaben mit [Submit]. Anschließend muss der Name der neuen Datenquelle in der Liste angezeigt werden, der Status sollte "OK" sein. b) mit MySQL-Datenbank Wichtig: Der SQL-Server muß TCP/IP Verbindungen akzeptieren! Legen Sie zunächst unter MySQL die hyscore-datenbank an. Das Verfahren ist ausführlich in der separaten Anleitung hyscore_db_installation.pdf beschrieben. Anschließend können Sie die Datenquelle unter ColdFusion einrichten: Version 4.9 Ausgabe 14 10.11.2011 Seite 11
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 muss EINGESCHALTET sein Enable long text retrieval (CLOB): Diese Option muss EINGESCHALTET sein Long Text Buffer: Den Wert 128000 eintragen Enable binary large object retrieval (BLOB): Diese Option muss EINGESCHALTET sein 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.9 Ausgabe 14 10.11.2011 Seite 12
Optional: 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.9 Ausgabe 14 10.11.2011 Seite 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.9 Ausgabe 14 10.11.2011 Seite 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]. Version 4.9 Ausgabe 14 10.11.2011 Seite 15
Schritt 6: hyscore System einrichten Geben Sie für die Ersteinrichtung die Webadresse des hyscore Systems in Ihren Webbrowser ein, z.b. http://127.0.0.1/hyscore Danach muss der Login-Bildschirm von hyscore erscheinen. Melden Sie sich dort mit dem Benutzer hypervisor an, das Standardpasswort lautet hyper2. Nach dem Login sind Sie automatisch im System-Mandanten angemeldet. Geben Sie die Lizenzschlüssel ein, die Sie beim Erwerb der Software erhalten haben. Wählen Sie dazu im Admin-Menü Systemverwaltung / Wartung / Lizenzverwaltung Ändern Sie das Passwort für den Benutzer hypervisor. Wechseln Sie dazu auf die persönliche Startseite und wählen Sie dort Mein Arbeitsbereich / Meine Benutzereinstellungen ändern Fortsetzung der Einrichtungsarbeiten hyscore Implementierung: Checkliste zur Ersteinrichtung (hyscore ab Version 4.9.x) (Dateiname: chklist_ersteinrichtung_v49x.pdf) Online-Ressourcen Die hier erwähnten Anleitungen und Datenblätter stellen wir im Online-Hilfekatalog zum Download zur Verfügung: http://www.hyscore.de/help/ Version 4.9 Ausgabe 14 10.11.2011 Seite 16
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.9 Ausgabe 14 10.11.2011 Seite 17
Ä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 Neues DB- Auslieferungsverfahren Datum Bearbeiter Freigabedatum Freigegeben durch 20.10.2009 Ralf Guttmann 26.10.2009 Ralf Guttmann 11.11.2010 Ralf Guttmann 12.11.2010 Ralf Guttmann 16.11.2010 Ralf Guttmann 16.11.2010 Ralf Guttmann 15.03.2011 Ralf Guttmann 15.03.2011 Ralf Guttmann 07.11.2011 Ralf Guttmann 10.11.2011 Ralf Guttmann --- Ende der Anleitung --- Version 4.9 Ausgabe 14 10.11.2011 Seite 18