DOKLI Installationshandbuch. Manual

Transkript

1 DOKLI Installationshandbuch Manual

2

3 DOKLI Installationshandbuch Einheitliche Dokumentation der Klientinnen und Klienten der Drogeneinrichtungen (DOKLI) Version 01, Mai 2013 Für DOKLI-Version 2.1 René Philipp Heindl Alexander Grabenhofer-Eggerth Wien, im Mai 2013 Im Auftrag des Bundesministeriums für Gesundheit

4 Herausgeber und Verleger: Gesundheit Österreich GmbH, Stubenring 6, 1010 Wien, Tel , Fax , Homepage: Der Umwelt zuliebe: Dieser Bericht ist auf chlorfrei gebleichtem Papier ohne optische Aufheller hergestellt.

5 Inhalt Inhalt III 1 Einleitung Allgemeine Informationen Unterstützte Browserversionen DOKLI Support Neuinstallation Systemvoraussetzungen Installationsvorbereitungen Installation der DOKLI-Datenbank Installation des DOKLI-Webinterfaces Aufruf von DOKLI Datenübernahme bei einer Neuinstallation Update von früheren DOKLI Versionen auf Version Systemvoraussetzungen Update von 2.0.x auf Updatevorbereitungen Update der DOKLI Datenbank Update des DOKLI Webinterfaces Update von auf Updatevorbereitungen Update der DOKLI Datenbank Update des DOKLI Webinterfaces III

6

7 1 Einleitung 1.1 Allgemeine Informationen Um eine bessere Nachverfolgung der Installation / des Updates zu gewährleisten wurde anstatt des Setup-Tools in Version 2.0 nun wieder auf eine manuelle Installation / manuelles Update umgestellt. Wir hoffen, ihnen mit diesem Handbuch die beste Unterstützung zur Installation / zum Update zu liefern. DOKLI ist so ausgelegt, dass mehrere Einrichtungen einer Organisation über eine zentrale DOKLI-Installation dokumentieren können, wodurch auch die Wartung erheblich vereinfacht wird. Für spezielle Sicherheitseinstellungen wie https ist der Administrator der jeweiligen Organisation verantwortlich und die GÖG übernimmt keine Haftung für unsichere Installationen. 1.2 Unterstützte Browserversionen Internet Explorer 8 und höher Mozilla Firefox ab Version 16 Alle gängigen Opera und Google Chrome Versionen 1.3 DOKLI Support René Heindl, rene.heindl@goeg.at, Tel: (technische Fragen) Klaus Kellner, klaus.kellner@goeg.at, Tel: (inhaltliche Fragen) Kapitel 1 / Einleitung 1

8 2 Neuinstallation Eine Neuinstallation ist überall dort zu wählen, wo DOKLI bislang noch nicht im Einsatz war oder auf einem neuen Server/Computer installiert werden soll. Wenn sie eine Datenbank mit Altdaten einer vorherigen DOKLI-Version auf einen neuen Server installieren möchten, finden sie nähere Informationen unter: Datenübernahme bei einer Neuinstallation 2.1 Systemvoraussetzungen Windows XP oder höher IIS 6 oder höher installiert.net 4.5 installiert MS SQL Server 2012 Express inkl. MS SQL Server Management Studio Express oder höher HINWEIS: Bei der Installation bitte auch die SQL Server Anmeldung angeben o o Named Pipes und IP Protokolle am MS SQL Server freigeschalten (über das Konfigurationstool möglich) SQL Server Authentifizierung aktiviert 2.2 Installationsvorbereitungen 1. Herunterladen der Datei DokliV210.zip von 2. Entpacken der Datei DokliV210.zip a. Die entpackte Datei enthält 2 Ordner: Database und Web 2.3 Installation der DOKLI-Datenbank Hinweis: Der Webserver und der Datenbankserver müssen nicht unbedingt auf derselben Maschine liegen. ACHTUNG: Falls sie Daten aus einer anderen DOKLI-Installation / von einem anderen Server übernehmen wollen gehen sie zum Punkt Datenübernahme bei einer Neuinstallation 1. MS SQL Server Management Studio starten 2. Mit dem SQL Server verbinden 3. Über das Kontextmenü des Datenbankservers den Dialog Neue Datenbank öffnen (Hinweis: Ein Kontextmenü wird immer mit der rechten Maustaste über dem Element 2 GÖG/ÖBIG 2012, DOKLI Installationshandbuch

9 aufgerufen.) 4. Im Dialog einen Datenbanknamen wählen, z. B.: Dokli Kapitel 2 / Neuinstallation 3

10 5. Über das Kontextmenü der Datenbank und den Menüpunkten Tasks Wiederherstellen Datenbank den Wiederherstellungsdialog öffnen 6. Als Quelle Medium wählen und die Datei Dokli21.bak im Verzeichnis Database (s. Installationsvorbereitung) wählen und als Zieldatenbank die neu angelegte Datenbank wählen 4 GÖG/ÖBIG 2012, DOKLI Installationshandbuch

11 7. Unter Optionen im linken Menü die Auswahl Vorhandene Datenbank überschreiben (WITH REPLACE) auswählen Mit OK die Installation der Datenbank starten HINWEIS: Falls sie folgende Fehlermeldung erhalten öffnen Sie ein neues Abfragefenster (Strg+N) und führen folgende Befehle aus (F5 nach Eingabe) im Anschluß starten sie den Sql Server Manager neu und Fahren bei Schritt 5 fort: sp_configure 'contained database authentication', 1; GO RECONFIGURE; GO 8. Nach Fertigstellung der Installation einen neuen Datenbankbenutzer ( Anmeldung ) über den Ordner Sicherheit anlegen Kapitel 2 / Neuinstallation 5

12 9. Anmeldename und SQL Server Authentifizierung wählen 10. Passwort auswählen a. Falls das Passwort nicht den Sicherheitsrichtlinien des Datenbankservers entsprechen soll müssen sie das Häckchen bei Sicherheitsrichtlinien erzwingen entfernen 11. Als Standardsprache wählen Sie German aus 6 GÖG/ÖBIG 2012, DOKLI Installationshandbuch

13 12. Über den Menüpunkt Benutzerzuordnung dem neuen Benutzer für die DOKLI- Datenbank die Rolle db_owner geben 13. Mit Ok bestätigen 14. Fertig! Kapitel 2 / Neuinstallation 7

14 2.4 Installation des DOKLI-Webinterfaces 1. Im Ordner c:/intepub/wwwroot einen neuen Ordner Dokli anlegen. 2. Alle Dateien des Ordners Web (s. Installationsvorbereitung) in diesen neuen Dokli- Ordner kopieren 3. Die Datei web.config mit einem Text-Editor öffnen 4. In den Connection-Strings folgende Platzhalter - jeweils 2 mal -inklusive der geschwungenen Klammern ersetzen a. {DataSource}: Hier bitte die SQL-Server Instanz eintragen z. B.: {DataSource} wird zu.\sqlexpress b. {DatabaseName}: Hier bitte den Datenbanknamen eintragen c. {DatabaseUser}: den Benutzernamen der angelegten Anmeldung eintragen d. {DatabasePassword}: das Passwort der angelegten Anmeldung eintragen 5. Die Änderungen speichern HINWEIS: Falls sie keine Berechtigung zum Speichern haben müssen sie über die rechte Maustaste über web.config und dem Reiter Sicherheit ihrem Benutzer die Schreibberechtigung erteilten. 6. Schreibberechtigung für den Benutzer IIS_IUSR für folgende Ordner geben a. Aggregation b. Export c. Pdf 7. Den IIS Manager starten. ( inetmgr im Ausführen als bzw. in der Programmsuche eingeben) 8 GÖG/ÖBIG 2012, DOKLI Installationshandbuch

15 8. Unter dem Ordner Default Web Site das Kontextmenü des Ordners Dokli aufrufen und In Anwendung konvertieren wählen 9. Als Anwendungspool ASP.NET v4.0 wählen 10. Mit Ok bestätigen 11. Fertig Kapitel 2 / Neuinstallation 9

16 2.5 Aufruf von DOKLI Vorausgesetzt dass der IIS korrekt installiert ist, ist DOKLI nun lokal über erreichbar bzw. über ein Netzwerk mit Von Vorteil ist, wenn sie eine https-verbindung für DOKLI einrichten Informationen darüber finden sie unter Datenübernahme bei einer Neuinstallation ACHTUNG: Es können nur Daten von einer Datenbank automatisch übernommen werden. Falls sie die Daten aus mehreren Datenbanken in eine zusammenspielen möchten wenden sie sich bitte an den DOKLI-Helpdesk Wenn sie Daten aus einer vorherigen DOKLI -Version oder einem anderen Datenbankserver übernehmen wollen gehen sie bitte wie folgt vor: 1. (falls noch nicht vorhanden) SQL-Server Management Studio auf dem alten Datenbankserver installieren und starten 2. Über das Kontextmenü der Datenbank (rechte Maustaste) Tasks Sichern aufrufen 3. Unter dem Ziel den Punkt Festplatte auswählen und einen Speicherplatz für die Datenbanksicherung auswählen, z. B.: c:/temp/dokli.bak HINWEIS: Falls im Dateifeld schon eine Datei eingetragen ist, diesen Eintrag vor Auswahl eines neuen Dateispeicherorts über den Button Entfernen löschen, da sonst die Sicherung auf beide Dateien aufgeteilt wird. 4. Mit Ok die Sicherung starten. 5. Die gesicherte Datenbank auf den neuen Datenbankserver kopieren 6. Führen sie nun die Installation der Datenbank wie oben beschrieben durch. Anstatt der mitgelieferten Datei Dokli21.bak verwenden sie ihre eigene Datenbanksicherung. 7. Nach durchführen der Datenbankinstallation lassen sie bitte die Updateskripts wie im Punkt Update einer DOKLI Datenbank durchlaufen 8. Falls es sich nur um eine Übertragung der Daten auf einen neuen Server gehandelt hat und sie die DOKLI-Webanwendung schon installiert haben, vergessen sie nicht in der Datei web.config die alten Datenbankserver-Verbindungseinstellungen (Servername, Datenbankname, Benutzer, Passwort) anzupassen. 9. Fertig 10 GÖG/ÖBIG 2012, DOKLI Installationshandbuch

17 3 Update von früheren DOKLI Versionen auf Version Systemvoraussetzungen.NET 4.0 installiert Beim Update von auf 2.1.0: SQL Server 2008 R2 (Express Version möglich) h0lreoke1hgnzqhx4tm%2fgpqqtijeqmrcha8i382ivnwx7fxqwhfg%3d%3d SQL Server Management Studio auf dem Datenbankserver installiert 3.2 Update von 2.0.x auf Updatevorbereitungen 1. Herunterladen der Datei Update_V20_to_V210.zip von 2. Entpacken der Datei Update_V20_to_V210.zip a. Die entpackte Datei enthält 2 Ordner: Sql und Web Update der DOKLI Datenbank 1. Starten des SQL Server Management Studio 2. Öffnen des Skripts 01_Update210_Stored_Procedures.sql 3. {DatabaseName} durch den Datenbanknahmen ersetzen 4. Mit F5 ausführen HINWEIS: Eventuell je nach SQL Server Version auftretende Fehlermeldungen mit Verweis auf extendedproperty können ignoriert werden. 5. Öffnen des Skripts 02_Update210.sql Kapitel 3 / Update von früheren DOKLI-Versionen auf Version

18 6. {DatabaseName} durch den Datenbanknahmen ersetzen 7. Mit F5 ausführen 8. Fertig Update des DOKLI Webinterfaces 1. Sichern der Datei web.config aus dem Dokli-Verzeichnis unter c:/inetpub/wwwroot 2. Kopieren der Dateien aus dem Verzeichnis Web in das Dokli-Verzeichnis unter c:/inetpub/wwwroot 3. Die Datei web.config und die gesicherte Datei web.config mit einem Text-Editor öffnen 4. In den Connection-Strings folgende Platzhalter (jeweils 2x) mit den Einstellungen aus dem Connection-String der gesicherten Datei ersetzen. HINWEIS: der Connection-String befindet sich in der Zeile welche mit <add name= ConnectionString beginnt a. {DataSource}: Hier bitte die SQL-Server Instanz eintragen b. {DatabaseName}: Hier bitte den Datenbanknamen eintragen c. {DatabaseUser}: den Benutzernamen der angelegten Anmeldung eintragen d. {DatabasePassword}: das Passwort der angelegten Anmeldung eintragen 5. Die Änderungen speichern HINWEIS: Falls sie keine Berechtigung zum Speichern haben, müssen sie über die rechte Maustaste über web.config und dem Reiter Sicherheit ihrem Benutzer die Schreibberechtigung erteilten. 6. Schreibberechtigung für den Benutzer IIS_IUSR für folgende Ordner geben a. Aggregation b. Export c. Pdf 7. Fertig 12 GÖG/ÖBIG 2012, DOKLI Installationshandbuch

19 3.3 Update von auf Updatevorbereitungen 1. Herunterladen der Datei Update_V151_to_V210.zip von 2. Entpacken der Update_V151_to_V210.zip a. Die entpackte Datei enthält 2 Ordner: Sql und Web Update der DOKLI Datenbank 1. Falls Dokli auf einem Datenbankserver mit einer Versionsnummer kleiner als 2008 R2 gelaufen ist überspielen sie die alte Datenbank auf den neuen Datenbankserver wie in Punkt 2.6 beschrieben 2. Starten des SQL Server Management Studio 3. Folgende Skripte der Reihe nach öffnen, {DatabaseName} durch den Datenbanknahmen ersetzen und mit F5 starten a. db_01_update_structure_151_to_2.sql b. db_02a_update_constraints_delete_old.sql c. db_02b_update_constraints_add_new.sql d. db_03_storedprocedures.sql e. db_04_convert_existing_data_151_to_2.sql f. db_05_update_to_210.sql 4. Fertig Update des DOKLI Webinterfaces Ein direktes Update des Webinterfaces von 1.51 auf 2.1 ist nicht möglich es handelt sich hierbei um eine komplette Neuinstallation des Dokli Webinterfaces. Gehen sie dabei bitte wie folgt vor: 1. Sichern der Datei oebig.config aus dem Verzeichnis c:/inetpub/wwwroot/tdi 2. Installation des Webinterfaces starten wie unter dem Punkt Installation Webinterface beschrieben Kapitel 3 / Update von früheren DOKLI-Versionen auf Version

20 HINWEIS: Die Zugangsdaten zum Datenbankserver können sie der gesicherten Datei oebig.config entnehmen 3. Fertig 14 GÖG/ÖBIG 2012, DOKLI Installationshandbuch