Projekt IGH DataExpert Installation DataExpert Paynet-Adapter (SIX) Datum: 25.06.2012 Version: 2.0.0.0 Inhaltsverzeichnis 1 Einleitung...... 2 1.1.NET Framework... 2 2 Installation von "DE_PaynetAdapter.msi"... 2 2.1 Konfiguration des Windows Services... 3 2.2 Konfiguration des PaynetAdapter... 4 2.2.1 Konfiguration der Grundparameter:... 4 2.2.2 Konfiguration des Zertifikats:...... 5 2.2.3 Konfiguration von Benutzern ohne DataExpert:...... 5 2.2.4 Konfiguration von Benutzern mit DataExpert... 6 3 Verschieben der DataExpert-PaynetAdapter (neues Verzeichnis)... 7 3.1 Einleitung...... 7 3.2 Verschieben der Adapter Installation... 7 4 Installation mehrerer DataExpert-PaynetAdapter... 9 4.1 Einleitung...... 9 4.2 Klonen der Original Installation... 9 4.3 Benutzung des DE_PaynetAdapterCloningTool... 9 5 Deinstallation mehrerer DataExpert-PaynetAdapter... 12 5.1 Einleitung...... 12 5.2 Löschen einer geklonten Adapter Installation... 12 03.07.2012 / 1-13
1 Einleitung Eine PaynetAdapter-Installation erfolgt durch die Installation von "DE_PaynetAdapter.msi". Diese Installation setzt auf.net Framework Version 2.0 auf. Dies bedeutet, dass.net Framework 2.0 vor dem PaynetAdapter installiert werden muss. 1.1.NET Framework Die Installation von PaynetAdapter setzt.net Framework Version 2.0 voraus. Falls bereits DataExpert Server installiert ist, entfällt dieser Schritt. Das Installationssetup kann direkt ab http://msdn.microsoft.com/de-de/netframework/aa731542 heruntergeladen und installiert werden. Die Installation benötigt ca. 10 Minuten. Installation: Starten von "dotnetfx.exe" aus dem Verzeichnis ".Net Framework 2.0 (German)". 2 Installation von "DE_PaynetAdapter.msi" Melden sie sich als lokaler Administrator auf ihrem System an Datei "DE_PaynetAdapter.msi" anwählen und starten. Wichtig: Die Installation kann nur lokal und nicht über Netzwerk (Share) gestartet werden. Während der Installation kann gewählt werden, ob die Applikation für alle Benutzer oder nur für den aktuellen Benutzer installiert werden soll. Vorgewählt ist "für alle Benutzer". Als Installationsverzeichnis sollte das vorgeschlagene Default Verzeichnis beibehalten werden. Das Datenverzeichnis kann wie unter Punkt 3 beschrieben an den gewünschten Ort verschoben werden. Befolgen sie die Anweisungen und warten sie bis die Installation erfolgreich beendet wurde. Anmerkung: Es ist wichtig, dass sie die Installation als lokaler Administrator durchführen. PaynetAdapter wird sonst nicht funktionieren. 03.07.2012 / 2-13
2.1 Konfiguration des Windows Services Bevor der PaynetAdapter Windows Service gestartet werden kann, muss er konfiguriert werden. Wählen sie über das "Startmenü" die "Systemsteuerung" (Control Panel) und danach die Kategorie "Verwaltung" (Administrative Tools). Nun sehen sie folgendes: Wählen sie die Kategorie "Services" und suchen sie in der Liste den Eintrag "PaynetAdapter": Öffnen sie durch einen Doppelklick auf den Eintrag dessen Eigenschaften und wählen sie die Lasche "Login" (Log On): Wählen sie die 2. Option und geben sie als Benutzernamen "Administrator" und unten das Passwort ein. Bestätigen sie mit "OK". Die Konfiguration ist nun abgeschlossen und alle Fenster können geschlossen werden. 03.07.2012 / 3-13
2.2 Konfiguration des PaynetAdapter Der PaynetAdapter muss über die mitgelieferte Verwaltungsapplikation konfiguriert werden. Unter anderem beinhaltet dies das Zertifikat und die PID zur Identifizierung bei Paynet. Wählen sie dazu im "Startmenü" unter "Programme" den Eintrag "IGH". Es erscheint eine Verknüpfung mit dem Namen "Paynet Adapter Verwaltung". Nach dem Start erscheint folgendes: 2.2.1 Konfiguration der Grundparameter: Es können folgende Parameter konfiguriert werden. Die Parameter können verändert werden, indem die Zeile gewählt wird (erscheint grau) und danach in die 2. Spalte geklickt wird. ExecPeriod: Dieser Wert bestimmt, in welchem Intervall der Adapter versucht Kontakt zu Paynet aufzunehmen. Bsp: 00:30:00 (Format: hh:mm:ss) Hier wären 30 Minuten konfiguriert MailServerSettings: Der Adapter hat die Fähigkeit Informationen per Email zu verschicken. Die Einstellungen des Mail Servers werden hier konfiguriert. Bsp: false;smtp.yourserver.ch;sender@yourdomain.ch;receiver@yourdomain.ch 1. "true": Email ist aktiviert "false": Email ist deaktiviert 2. "smtp.yourserver.ch": Die Adresse des Mailservers 3. "sender@yourdomain.ch": Die Adresse des Absenders 4. "receiver@yourdomain.ch": Die Adresse des Empfängers WebServiceURL: Dieser Wert ist die Webservice Adresse von Paynet ServerPID Dieser Wert ist die PID, welche dem Server Betreiber von Paynet zugestellt worden ist. 03.07.2012 / 4-13
2.2.2 Konfiguration des Zertifikats: Der PaynetAdapter benötigt zur Verbindung mit Paynet ein gültiges Zertifikat (erhält der Betreiber von Paynet). Dieses kann im Menü "Bearbeiten" unter "Zertifikat..." ausgewählt werden. Ist die Liste leer, so haben sie das Zertifikat auf ihrem System (Profil) nicht installiert. Installieren sie das Zertifikat und wiederholen sie diesen Schritt (es ist wichtig, dass das Zertifikat unter dem gleichen Profil installiert wird unter welchem der PaynetAdapter Service später ausgeführt wird.) 2.2.3 Konfiguration von Benutzern ohne DataExpert: Falls sie den Paynet Adapter ohne DataExpert Server betreiben wollen, so können sie unter dem Menü "Modus" die Option "Benutzerverwaltung" wählen: Es erscheint folgende Maske: Durch anwählen der Zeile kann in der 1. Spalte der Benutzername und in der 2. Spalte die jeweilige Empfänger PID eingetragen werden. Um einen neuen Benutzer einzufügen klicken sie im Menü "Bearbeiten" -> "Benutzer" -> "Erstellen" und es erscheint eine neue Zeile. Um einen Benutzer zu entfernen, selektieren sie die gewünschte Zeile und wählen sie im Menü "Bearbeiten" -> "Benutzer" -> "Entfernen". 03.07.2012 / 5-13
Zum Schluss können sie die gesamte Konfiguration speichern und den Adapter starten: 2.2.4 Konfiguration von Benutzern mit DataExpert Falls sie den Paynet Adapter mit DataExpert Server betreiben wollen, so können sie unter dem Menü "Bearbeiten" die Option "DataExpert Integration..." wählen: Nun kann die Option Benutzerverwaltung von DataExpert verwenden gewählt werden, sowie die ServerUser.xml Datei von DataExpert gesucht und gewählt werden: Die Benutzerverwaltung kann danach nur noch in DataExpert durchgeführt werden. 03.07.2012 / 6-13
3 Verschieben der DataExpert-PaynetAdapter (neues Verzeichnis) 3.1 Einleitung Alle Paynet Adapter werden in einem gemeinsamen Datenverzeichnis verwaltet. Dieses lautet nach der Installation C:\IGH. Der Adapter besitzt in diesem Verzeichnis ein eigenes Unterverzeichnis. Auf Wunsch kann dieses übergeordnete Datenverzeichnis verschoben werden. Wichtig: Nachdem das Datenverzeichnis verschoben wurde, müssen alle Shortcuts zu den Applikationen PaynetAdapterConfig und PaynetAdapterCloningTool manuell angepasst werden 3.2 Verschieben der Adapter Installation Melden sie sich als lokaler Administrator an und wählen sie dazu im "Startmenü" unter "Programme" den Eintrag "IGH". Es erscheint eine Verknüpfung mit dem Namen "Paynet Cloning Tool". Nach dem Start erscheint folgendes: Wählen sie das neue übergeordnete Datenverzeichnis und drücken sie den Knopf Move Installation. Nun werden alle Adapter und deren Datenverzeichnisse in das neue Datenverzeichnis kopiert und der Windows Service entsprechend umkonfiguriert. 03.07.2012 / 7-13
Nach Abschluss der Prozedur wird die Applikation automatisch geschlossen. Alle Verknüpfungen der Adapter Verwaltungen sowie des Adapter Cloning Tools müssen mit dem neu gewählten Pfad konfiguriert werden: 03.07.2012 / 8-13
4 Installation mehrerer DataExpert-PaynetAdapter 4.1 Einleitung Um mehrere Paynet Adapter parallel zu betreiben, muss vorgängig bereits die normale Installation erfolgreich durchgeführt worden sein. Ist dies nicht der Fall so führen sie zuerst eine Installation nach der oben angegebenen Anleitung durch. 4.2 Klonen der Original Installation Falls mehrere Paynet Adapter parallel mittels verschiedener PID betrieben werden müssen, so ist dies durch das Klonen der Original Installation möglich. 4.3 Benutzung des DE_PaynetAdapterCloningTool Ein neuer zusätzlicher PaynetAdapter muss über die mitgelieferte Replizierungsapplikation installiert werden. Melden sie sich als lokaler Administrator an und wählen sie dazu im "Startmenü" unter "Programme" den Eintrag "DataExpert". Es erscheint eine Verknüpfung mit dem Namen "Paynet Cloning Tool". Nach dem Start erscheint folgendes: Um eine weitere Instanz des Paynet Adapters zu erzeugen, wählen sie unter Cloned Installation Name einen neuen Namen wie z.b PaynetAdapter2 und drücken Clone + Install 03.07.2012 / 9-13
Nach drücken des Knopfes erscheint folgender Dialog, welcher sie nach dem Benutzerkonto fragt, unter welchem der Windows Service zukünftig laufen soll: Geben sie als Benutzernamen.\Administrator und das zugehörige Passwort ein. Nach drücken des OK Knopfes, erscheint die Meldung das der Adapter erfolgreich installiert wurde. Nun sollten sie im Service Manager eine neue Instanz des Paynet Adapters mit dem von ihnen definierten (z.b PaynetAdapter2) Namen vorfinden. Konfigurieren sie das Recovery Verhalten wie im Kapitel Konfiguration des Windows Service beschrieben. Erstellen sie nun eine Verknüpfung auf dem Desktop zur Verwaltung des neuen PaynetAdapters. Die Verwaltungsapplikation mit dem Namen DE_PaynetAdapterConfig.exe finden sie unter dem neuen erstellten Verzeichnis, welches unter Cloned Installation Directory angegeben ist. Falls sie keine Verknüpfung erstellen wollen, können sie die Adapter Verwaltung auch direkt im jeweiligen Verzeichnis des gewählten Paynet Adapters starten. 03.07.2012 / 10-13
Abschliessend müssen sie in der Verwaltungsapplikation die neue PID des neuen Adapters und den dazugehörigen Benutzernamen sowie das Passwort setzen (siehe Konfiguration Benutzernamen) Die Installation ist nun abgeschlossen und sie können den Adapter starten. 03.07.2012 / 11-13
5 Deinstallation mehrerer DataExpert-PaynetAdapter 5.1 Einleitung Alle Paynet Adapter, welche nach der Originalinstallation geklont wurden, müssen manuell wieder deinstalliert werden. Sie können nicht direkt über das Deinstallationsprogramm entfernt werden. Nur die Originalinstallation wird durch das Deinstallationsprogramm vollständig entfernt. Wichtig: alle geklonten Instanzen können nach einer Deinstallation der Originalinstallation nicht mehr entfernt werden. Entfernen sie immer zuerst alle geklonten Instanzen und zum Schluss die Originalinstallation mittels des Deinstallationsprogrammes von Windows. 5.2 Löschen einer geklonten Adapter Installation Melden sie sich als lokaler Administrator an und wählen sie dazu im "Startmenü" unter "Programme" den Eintrag "DataExpert". Es erscheint eine Verknüpfung mit dem Namen "Paynet Cloning Tool". Nach dem Start erscheint folgendes: 03.07.2012 / 12-13
Wählen sie die Installation in der unteren Liste, welche sie entfernen möchten und drücken sie den Knopf Delete + Uninstall. Nun wird der Windows Service entfernt und alle Daten, welche sich im Verzeichnis Cloned Paynet Adapters werden vollständig gelöscht! 03.07.2012 / 13-13