SurvNet@RKI 3.0 1 SurvNet@RKI 3.0 Das Meldesystem zum IfSG Installationsanleitung Stand: 15. Mai. 2016 Installation der Anwendung Installationsvoraussetzungen Betriebssystem: Windows XP, Vista, 7 Prozessor: 1 GHz RAM: 512 MB Festplattenspeicher: 200 MB Empf. Bildschirmauflösung: 1280*800 oder höher Microsoft Windows Installer 4.5 Microsoft .Net-Framework 3.5 Sp1 oder höher (Festplattenspeicher: 300 MB) Microsoft SQL-Server 2005 Express oder höher Account für SQL-Server, welcher berechtigt ist Datenbanken zu erstellen Account mit Zugriff auf eine bestehende [email protected] Datenbank und mit Zugriff auf die vorhandene Datenbank von SurvNet@RKI Version 2.0 für die Migration RAM: 512 MB (2 GB oder mehr wird empfohlen) Festplattenspeicher: 2.2 GB Zu Beachten 1 Vor der Installation der Software in einem Gesundheitsamt sollte mit der zuständigen Landesstelle die Installation abgesprochen werden. Es ist zu beachten, dass SurvNet@RKI 3.0 erst im Gesundheitsamt genutzt werden kann, wenn auch in der zuständigen Landesstelle diese Version im Einsatz ist. Unter http://www.rki.de/DE/Content/Infekt/IfSG/Software/software_node.html bzw. http://survnet.rki.de/Content/Service/Documentations.aspx wird immer die aktuelle Version zu Verfügung gestellt. Nach Möglichkeit sollte eine neuere Version jeweils zügig installiert und genutzt werden. Zu Beachten 2 Vor jedem Update der Datenbank mit einer neueren Version sollte ein Backup erzeugt werden, so dass nach einem Fehler während des Update-Prozesses auf den Ausganszustand zurückgegangen werden kann. Neuinstallation der Software Beginnend mit der Version 0.8.16 wird neben den Setup-Programmen zur Installation der Datenbank auch ein Backup einer leeren Datenbank der jeweils aktuellen Version unter http://survnet.rki.de/Content/Service/Documentations.aspx zur Verfügung gestellt. Damit gestaltet sich die Installation wie folgt: Download der Datei „SurvNet3-Leere-Datenbank-X.X.XX.zip Restore des Datenbank-Backups „SurvNet3.X.X.XX_leer.bak“ in die Datenbank SurvNet3 Anlegen der von SurvNet@RKI verwendeten SQL-Logins mittels des Scriptes „ConfigSurvNet3User.sql“ SurvNet@RKI 3.0 3 Damit steht eine SurvNet@RKI-Datenbank zur Verfügung und kann vom Programm genutzt werden In der Zip-Datei „SurvNet3Migration.zip“ sind die für die Migration der Altdaten benötigten Scripte enthalten. Die Migration der Altdaten erfolgt wie weiter unten beschrieben. Information zur Installation der aktuellen Version 0.9.17 vom 31.03.2014 Zur Installation der Version 0.9.17 oder zum Update auf diese Version ist eine Version 0.8.16 Voraussetzung. Die Installation erfolgt analog den anderen Updates: Zuerst Update der Datenbank, danach Installation des Clientprogramms auf allen Arbeitsstationen. Besonderheiten sind nicht beachten. Information zur Installation der aktuellen Version 0.8.16 vom 01.07.2013 Zur Installation der Version 0.8.16 oder zum Update auf diese Version ist eine Version 0.8.15 Voraussetzung. Die Installation erfolgt analog den anderen Updates: Zuerst Update der Datenbank, danach Installation des Clientprogramms auf allen Arbeitsstationen. Information zur Installation der aktuellen Version 0.8.15 vom 24.01.2013 Zur Installation der Version 0.8.15 oder zum Update auf diese Version ist eine Version 0.8.14 Voraussetzung. Die Installation erfolgt analog den anderen Updates: Zuerst Update der Datenbank, danach Installation des Clientprogramms auf allen Arbeitsstationen. Information zur Installation der aktuellen Version 0.8.14 vom 21.08.2012 Zur Installation der Version 0.8.14 oder zum Update auf diese Version ist eine Version 0.8.13 Voraussetzung. Die Installation erfolgt analog den anderen Updates: Zuerst Update der Datenbank, danach Installation des Clientprogramms auf allen Arbeitsstationen. Information zur Installation der aktuellen Version 0.8.13 vom 12.07.2012 Zur Installation der Version 0.8.13 oder zum Update auf diese Version ist eine Version 0.8.12 Voraussetzung. Die Installation erfolgt analog den anderen Updates: Zuerst Update der Datenbank, danach Installation des Clientprogramms auf allen Arbeitsstationen. Information zur Installation der aktuellen Version 0.8.12 vom 26.04.2012 Zur Installation der Version 0.8.12 oder zum Update auf diese Version ist eine Version 0.8.11 Voraussetzung. Die Installation erfolgt analog den anderen Updates: Zuerst Update der Datenbank, danach Installation des Clientprogramms auf allen Arbeitsstationen. Information zur Installation der Version 0.8.11 vom 09.02.2012 Zur Installation der Version 0.8.11 oder zum Update auf diese Version sind folgende Schritte erforderlich: - Installation der Datenbank o Grundinstallation in der Version 0.7.5 o Update auf die Version 0.7.9 o Update auf die Version 0.7.10 o Update auf die Version 0.8.11 - Installation des Programms o Installation des Programms in der Version 0.8.11 Information zur Installation der Version 0.7.10 vom 18.11.2011 Zur Installation der Version 0.7.10 oder zum Update auf diese Version sind folgende Schritte erforderlich: - Installation der Datenbank o Grundinstallation in der Version 0.7.5 o Update auf die Version 0.7.9 o Update auf die Version 0.7.10 - Installation des Programms o Installation des Programms in der Version 0.7.10 Einrichten eines Datenbankservers [email protected] arbeitet mit einer Datenbank im Hintergrund, es ist erforderlich dass sich entweder eine Instanz von Microsoft SQL-Server 2005 Express (oder höher) im Netzwerk befindet oder auf ihrem Arbeitsplatzcomputer installiert ist. Die Installation bzw. Nutzung des Datenbankservers sollte mit dem System-Administrator abgesprochen werden. Der Microsoft SQL-Server muss im Authentifizierungsmodus „SQL-Server und Windows Authentifizierung“ konfiguriert sein. Bei der Installation des SQL-Servers sollte darauf geachtet werden, dass auch die Kommandozeilen-Tools sqlcmd.exe und bcp.exe mit installiert werden, da diese für die Übernahme der Altdaten verwendet werden. Bei der Verwendung einer MS SQL-Server-Express Version muss u.U. das TCP-IP-Protokoll aktiviert werden (Computerverwaltung/Dienste und Anwendungen/SQL-Server Configuration Manager/SQL Server Network Connection/TCP-IP). Grundlegende Installationsschritte Die Installation von SurvNet@RKI 3.0 erfolgt in den drei Schritten: Installation der Datenbank auf dem SQL-Server Installation des Client-Programms auf allen Arbeitsstationen Übernahme der Altdaten (sofern gewünscht) Für die Installation der Datenbank werden eine Grundinstallation und ein oder mehrere Servicepacks angeboten, die Installation und ein Update des Clients erfolgt durch das gleiche Setup-Programm. Installation der Datenbank Mit dem Start des Installationsprogramms werden die Installationsdateien entzippt. Dazu kann ein entsprechender Pfad angegeben werden. Anschließend wird das Setup gestartet. Nach Bestätigung der Lizenzbedingung können die zu installierenden Komponenten ausgewählt werden (Empfohlen wird die Verwendung der Standardeinstellung). Im nächsten Schritt kann der Installationspfad ausgewählt werden. In diesem Pfad werden auch die Skripte für die Altdatenübernahme angelegt. Anschließend muss die Verbindung zum SQL-Server konfiguriert werden. Dazu ist einzugeben: Der Name oder die IP-Adresse des SQL-Servers SurvNet@RKI 3.0 5 Die Art der Authentifizierung am SQL-Server für die Installation. Wählen sie „Windows Authentifizierung“, wenn sie mit ihren Windows-Anmeldeinformationen die Verbindung zum SQL-Server herstellen. Wählen sie „SQL Authentifizierung“ um den Benutzernamen und das Passwort separat anzugeben. Das hier verwendete Login für den SQL-Server muss auf dem SQL-Server die Berechtigungen zum Anlegen einer Datenbank und zum Anlegen von Logins besitzen. Der Name der Datenbank. Voreingestellt ist „SurvNet3“. Bei einem Update der Datenbank muss der Name der bereits vorhandenen Datenbank eingegeben werden. Über den Button „Test“ müssen die Einstellungen geprüft werden. Ein Fortsetzen der Installation ist nur bei erfolgreichem Test möglich. Schließlich werden noch die Voreinstellungen für die Übermittlungsstelle, den eigenen Landkreis und den Basispfad zur Verwaltung der Anwendungsdateien (Transportdateien) erfragt. Diese Einstellungen können auch später in der Anwendung unter „SurvNet-Optionen“ vorgenommen werden. Nach Start der Installation werden die Installationsskripte an die vorgenommenen Einstellungen angepasst und anschließend die Datenbank angelegt. Dieser Prozess kann je nach verwendetem System 15 bis 20 Minuten dauern. Im Ergebnis der Installation ist auf dem Datenbankserver eine leere Datenbank für die Anwendung SurvNet@RKI 3.0 angelegt. Die Datenbankdateien <Datenbankname>.mdf und <Datenbankname>_log.ldf werden im Standarddatenbankverzeichnis des SQL-Servers angelegt. Steht ein Servicepack für die Datenbank zur Verfügung sollte anschließend das Servicepack installiert werden. Installation des Servicepacks für die Datenbank Das Servicepack wird als *.msi-Datei oder als selbstextrahierende Zip-Datei zur Verfügung gestellt. Nach dem Starten der *.msi-Datei wird geprüft, ob das Servicepack installiert werden kann. Bei erfolgreicher Prüfung startet die Installation analog wie die Grundinstallation. Installation des Clients Mit dem Start des Installationsprogramms werden die Installationsdateien entzippt. Dazu kann ein entsprechender Pfad angegeben werden. Anschließend wird das Setup gestartet. Nach Bestätigung der Lizenzbedingung können die zu installierenden Komponenten ausgewählt werden (Empfohlen wird die Verwendung der Standardeinstellung). Im nächsten Schritt kann der Installationspfad ausgewählt werden. Anschließend muss die Verbindung zum SQL-Server konfiguriert werden. Dazu ist einzugeben: Der Name oder die IP-Adresse des SQL-Servers Der Name der Datenbank Hier sind die Angaben aus der Installation der Datenbank zu verwenden. Ein Login muss nicht explizit angegeben werden, da das Datenbankinstallationsprogramm ein SQL-Login auf dem Datenbankserver angelegt hat, was hier verwendet wird. Nach Start der Installation wird das Programm auf dem Arbeitsplatzrechner installiert und kann anschließend gestartet werden. Falls auf der Arbeitsstation schon ein Client älterer Version installiert war, so wird dieser auf die aktuelle Version angepasst. Basiskonfiguration Nach erfolgreicher Installation des Clients sollten die notwendigen Einstellungen vorgenommen werden. Dazu gehört, sofern es nicht schon bei der Datenbankinstallation erfolgt ist: Angabe der eigenen Übermittlungsstelle Angabe des eigenen Landkreises Pfad zu den SurvNet@RKI-Transportdateien Einrichtung der Benutzer Details dazu können dem Handbuch entnommen werden. Hinweis: Vom Installationsprogramm wird als Pfad für die Transportdateien das Verzeichnis Transport im Installationsverzeichnis vorgeschlagen. Das Standardinstallationsverzeichnis ist C:\Programme\Robert Koch-Institut\SurvNet3. Unter Windows Vista und Windows 7 sind Verzeichnisse im Verzeichnis C:\Programme für einen Nutzer ohne Administratorrechte nicht beschreibbar. Daher muss das Verzeichnis der Transportdateien in einen anderen Pfad gelegt werden. Das Programm prüft bei jedem Start, ob Updates für das Programm zur Verfügung stehen. Wenn Updates vorgeschlagen werden, sollten diese nach Möglichkeit zügig installiert werden. Übernahme der Altdaten Vorhandene Altdaten von SurvNet@RKI Version 2.0 können nur in eine leere Datenbank übernommen werden. Dies muss daher als erster Schritt nach der Installation erfolgen. Die Datenübernahme besteht aus einem Schritt zur Übernahme der Daten aus Access in den SQLServer (SurvNet@RKI 2.0 Struktur) und aus einem Schritt zur Übernahme der Daten vom SQLServer (SurvNet@RKI 2.0-Struktur) in die neue Datenbankstruktur für SurvNet@RKI 3.0. Wichtig: Vor der Übernahme der Altdaten in SurvNet@RKI 3.0 muss noch einmal ein abschließender Datenexport aus dem alten Programm SurvNet@RKI 2.0 erfolgen. Übernahme von Access-Daten in den SQL-Server Mit der Installation der Datenbank wurde auf dem Installationsrechner ein Verzeichnis „MigrationAccess“ im Installationspfad angelegt (üblicherweise „C:\Programme\Robert KochInstitut\SurvNet3“). Dort befinden sich die Komponenten zur Übernahme der Access-Altdaten. Vorausgesetzt wird, dass auf dem Rechner die MS SQL-Server-Kommandozeilen-Tools sqlcmd.exe und bcp.exe installiert ist. Diese Tools werden bei der Installation der MS SQL-Server Client-Komponenten mit installiert. Die Übernahme erfolgt durch Starten des Scriptes MigrationAccess.bat. Vor dem Starten sind im Script die Datenquelle und das Datenziel anzupassen. Dazu sind in den jeweiligen Zeilen („SET …“) am Anfang des Scriptes die entsprechenden Änderungen vorzunehmen: Set Server = <Der Name des Datenbankservers> Set IfSGMDB = <Der Pfad und Name zur Access-Datenbank Fraktal_Data.mdb> Set SYSTEMMDW = <Der Pfad und Name der Access-System-Datenbank System.mdw> Die Anmeldung am SQL-Server erfolgt mittels des bei der Datenbankinstallation angelegten Logins „SQL_SurvNet3_Admin“. Zur Nutzung der Windows-Authentifizierung ist in den Zeilen „Set SQLCMDPARAM1 = <…>“, „Set SQLCMDPARAM2 = <…>“ und „SET BCPCMDPARAM = <…>“ die Angabe „-U <SqlUser> -P <Passwort>“ durch „-E“ zu ersetzen. Der hier verwendete Account muss auf dem SQL-Server das Recht zum Erstellen einer Datenbank haben. Insbesondere muss bei Nutzung des Standard-Account SQL_SurvNet3_Admin diesem Account das Recht zum Erstellen einer Datenbank eingeräumt werden. SurvNet@RKI 3.0 7 Außerdem muss überprüft werden, ob der Pfad zu den MS SQL-Server-Kommandozeilen-Tools sqlcmd.exe und ncp.exe in den Zeilen „SET SQLCMD=<…>“ und „SET BCPCMD=<…>“ richtig eingestellt ist, da je nach Version des SQL-Servers unterschiedliche Pfade verwendet werden. Es wird empfohlen, dass die Dateien Fraktal_Data.mdb und System.mdw auf den zur Installation verwendeten Rechner kopiert werden. Es ist sicher zu stellen, dass der zur Migration der Daten verwendete Windows-Account Zugriff auf diese Dateien hat. Anschließend kann durch Starten des Skriptes die Datenübernahme begonnen werden. Die Datenübernahme wird in der Datei Errorlog.txt protokolliert. Dort können eventuelle Fehlermeldungen gefunden werden. Übernahme von SQL-Server-Daten in die SurvNet@RKI 3.0-Struktur Mit der Installation wurde ein Verzeichnis „Migration“ im Installationspfad angelegt (üblicherweise „C:\Programme\Robert Koch-Institut\SurvNet3“). Dort befinden sich alle Komponenten zur Übernahme der SurvNet@RKI 2.0-Daten in die SurvNet@RKI 3.0-Struktur. Vorausgesetzt wird, dass auf dem Installationsrechner das MS SQL-Server-Kommandozeilen-Tool sqlcmd.exe installiert ist. Dieses Tool wird bei der Installation der MS SQL-Server ClientKomponenten mit installiert. Die Übernahme erfolgt durch Starten des Scriptes Migration.bat. Vor dem Starten sind im Script folgende Anpassungen vorzunehmen: Set Server = <Name des SQL-Servers, auf dem sich der Altdatenbestand und die neue Datenbank befinden müssen> Set Database = <Name der SurvNet@RKI 3.0-Datenbank> Set IfSG = <Name der Survnet@RKI 2.0-Datenbank (üblicherweise IfSG2)> Die Anmeldung am SQL-Server erfolgt mittels des bei der Datenbankinstallation angelegten Logins „SQL_SurvNet3_Admin“. Zur Nutzung der Windows-Authentifizierung in den Zeilen „Set SQLCMDPARAM = <…>“, „Set SQLCMDPARAMDB = <…>“ und „Set SQLCMDPARAMTEST = <…>“ die Angabe „-U <SqlUser> -P <Passwort>“ durch „-E“ zu ersetzen. Der hier verwendete Account muss auf beide Datenbanken vollen Zugriff haben. Insbesondere muss bei Nutzung des StandardAccount SQL_SurvNet3_Admin diesem Account der volle Zugriff auf die SurvNet@RKI 2.0Datenbank (meist IfSG2) gewährt werden. Sowohl die Datenbank von SurvNet@RKI 2.0 als auch die Datenbank von SurvNet@RKi 3.0 müssen sich auf dem gleichen SQL-Server befinden. Dazu muss evtl. die [email protected] mit üblichen SQL-Mitteln auf den richtigen SQL-Server kopiert werden (Detach der Datenbank, Kopieren der Datenbank-Dateien *.mdf und *.ldf und Attach der Datenbank bzw. Backup/Restore). Anschließend kann durch Starten des Skriptes die Datenübernahme begonnen werden. Die Datenübernahme wird in der Datei Migration.log protokolliert. Dort können eventuelle Fehlermeldungen gefunden werden. Alle Fehlermeldungen werden in der Datei MigrationError.log protokolliert. Erstmalige Anmeldung an SurvNet@RKI 3.0 Für eine erste Anmeldung an SurvNet@RKI kann verwendet werden: a) Für Konfigurationsarbeiten Anmeldeart: SurvNet-Authentifikation Anmeldename: SurvNetAdmin Kennwort: survnet b) Für inhaltliche Arbeiten Anmeldeart: SurvNet-Authentifikation Anmeldename: SurvNetUser Kennwort: survnet Für die Routinearbeit sollten für alle Mitarbeiter geeignete Accounts in SurvNet@RKI unter SurvNet-Optionen angelegt werden. Installationsdateien Ab der Version 0.7.5 des Setup-Programms müssen die Datenbank und der Client (SurvNet@RKI) separat installiert werden. Für die Datenbankinstallation wird ein Setup für die Grundinstallation und Service-Packs zur Verfügung gestellt, für die Clientinstallation wird nur ein Setup für die aktuelle Version zur Verfügung gestellt, welches auch zum Update einer vorhandenen Version verwendet werden kann. Datenbank-Grundinstallation: Rki.SurvNet.SelfSetup.Database-0.7.5.5822.exe Datenbank -Service-Pack: Rki.SurvNet.Setup.Database-NNN.msi Client- Installation: Rki.SurvNet.SelfSetup.Client-NNN.exe NNN gibt jeweils die gültige Versionsnummer an. Die aktuellen Installations-Dateien befinden sich unter: http://www.rki.de/DE/Content/Infekt/IfSG/Software/software_node.html Für Installationen die mit einer Setup-Version vor 0.7.5 erstellt wurden, muss zunächst das SetupProgramm der Version 0.7.5 ausgeführt werden.