Die nachfolgende Anleitung hilft dem Kunden mit den nötigen Informationen zur Installation und Konfiguration der MDWorkflow-Applikation.

Transkript

1 MDCMS Workflow-Installationsanleitung Die nachfolgende Anleitung hilft dem Kunden mit den nötigen Informationen zur Installation und Konfiguration der MDWorkflow-Applikation. 1 Generelle Informationen Die Workflow-Applikation ist eine Web-Applikation, die auf einem Application-Server läuft. Die Web- Applikation verbindet sich mit dem MDCMS-Datenbank-Repository auf dem iseries-system, wo die Daten und die Businesslogik der Applikation gespeichert sind. Sowohl die Web-Applikation als auch die Workflow-Applikation muss korrekt installiert sein, bevor die Workflow-Applikation verwendet werden kann. 2 Installation und Konfiguration der Web-Applikation 2.1 Vorbedingungen Java JDK 5 oder neuer (mit Java EE) Applikation-Server Die Web-Applikation wurde mit den folgenden Applikations-Servern getestet: Apache Tomcat Application Server (download: Glassfish Application Server v2 und v3 (download: v3 arbeitet nur mit with Java JDK 6 oder jünger Bevor der Applikations-Server installiert wird, muss JAVA JDK Version 5 (oder neuer; empfohlen) installiert werden. Download: Tel. +41 (41) , Fax +41 (41) , 1 / 5

2 2.2 Installations-Schritte Die MDCMS-Workflow-Applikation besteht aus einem gepackten WAR-File. Alternative I (empfohlen) Das WAR-File kann mit einer Extraktions-Software wie 7-Zip-Filemanager oder WinRAR geöffnet werden. Suche nach dem File WEB-INF/conf-faces-confg.xml. In diesem File können alle Client- Side-Einstellungen konfiguriert werden. Siehe dazu die Konfigurations-Punkte unten. Danach wird das File geschlossen und das WAR-File an den Applikations-Server weitergeleitet. Alternative II Laden des unveränderten WAR-Files auf die Administrator-Konsole des Web-Servers. In Apache Tomcat, öffnen des Apache Tomcat Installations-Verzeichnisses, welches üblicherweise ungefähr so benannt ist: C:/server/apache-tomcat / Von hier aus wird der Ordner webapps geöffnet, hier ist die MDCMS Workflow-Applikation gespeichert. Öffnen des WEB-INF Verzeichnisses. Beispiel: C:/server/apache-tomcat /webapps/mdWorkflowClient/WEB-INF/ Suchen und editieren des Files conf-faces-config.xml In diesem File können alle Client-Side-Einstellungen geändert werden. Siehe dazu die Konfigurations-Punkte unten. Im Glassfish Application Server, öffnen des Installationsverzeichnisses, welches üblicherweise ungefähr so benannt ist: C:/server/glassfishv2/ Von hier Öffnen der eigenen Domain und in den Ordner mit den j2ee-modulens, hier ist die MDCMS Workflow-Applikation gespeichert. Beispiel: C:/server/glassfishv2/glassfish/domains/domain1/applications/j2eemodules/mdWorkflowClient/WEB-INF/ Suchen und editieren des Files conf-faces-config.xml In diesem File können alle Client-Side-Einstellungen geändert werden. Siehe dazu die Konfigurations-Punkte unten. Nach dem Ändern der Einstellungen muss der Server neu gestartet werden. Die neuen Einstellungen sind dann aktiv. Tel. +41 (41) , Fax +41 (41) , 2 / 5

3 2.3 Web-Applikations-Konfigurationseinstellungen Öffnen File conf-faces-config.xml, Suche nach dem managed-bean mit Namen applicationconfiguration conf-faces-config.xml applicationconfiguration managed-properties Managed-property Beschreibung env Die Umgebung der MDCMS-Workflow-WebApp Installation (nur für Informationszwecke) Environment Die Beschreibung der Umgebung. Dieser Text wird auf der oberen linken Ecke im Bildschirm der MDCMS-Workflow-Applikation angezeigt. So weiss der Benutzer jederzeit, in welcher Umgebung er arbeitet. dateformat Wenn leer, dann wird das iseries-datumsformat verwendet YYYY -> Jahr MM -> Monat DD -> Tag Mögliche Trennzeichen für Datumsformate: ' ' leer '/' US '-' EU '.' CH ',' OS timeseparator iref ireflink logoff fullcontextpath networkuserprovid erclass Beispiel Datumsformat-Zeichenfolge: MM/DD/YYYY Wenn leer, wird das iseries-zeit-trennzeichen verwendet Man kann alle Trennzeichen wie ':' oder ' ' etc. verwenden Standard: 'Test reference' Dies ist der Text, der als Bezeichnung der externen Produktreferenz innerhalb von Tasks angezeigt wird. Es referenziert zur entsprechenden Einheit innerhalb des vorhandenen externen Management-Tools wie Test Manager, Problem Manager, etc. Dies ist der URL-Link zur Referenz-Einheit im externen Tool. Beispiel: ##iref## wird mit dem Wert des Referenzfeldes im Task-Bildschirm ersetzt. Standard: (NOCH NICHT IN BETRIEB) Dies ist der URL-Link des Bildschirmes, der dem Benutzer beim Abmelden angezeigt wird. Standard: Dies ist der Context-Pfad der Applikation. Wird verwendet, um den Task-Link im -body zu versenden. Standard: com.md.mdcms.base.mdnetworkuserprovider Wenn ein externes Login verwendet wird, kann ein kundenspezifisches NetworkUserProvider definiert werden (um NetworkUserId und NetworkUserName zu erhalten). Tel. +41 (41) , Fax +41 (41) , 3 / 5

4 Öffnen File conf-faces-config.xml, Suche nach dem managed-bean mit Namen iseriesproperties conf-faces-config.xml iseriesproperties managed-properties Managed-property Beschreibung Client Standard: 'WORKFLOW' Kunden-spezifische Einstellung hostenv MDCMS-Instanz auf dem iseries. Wenn leer, wird die Standard- Instanz von MDCMS verwendet. Beispiel: Eingabe von DEMO, damit die Instanz MDCMSDEMO verwendet wird. host Kein Standardwert. Obligatorisch Host-Adresse des iseries-repository, mit dem verbunden werden soll. Beispiel: 'my.iseries.com' usertype Standard: 'iseries' Definition der Anmeldung zum System: iseries extern iseries Login -> Login-Maske erscheint und der Benutzer muss das iseries-benutzerprofil und das Passwort eingeben systemuser systempw external -> direktes Login durch die Verbindung zum iseries mit systemuser and systempw (siehe unten). Die obligatorische NetworkUserId wird an das iseries übergeben und einem in MDSEC definierten iseries-benutzerprofil zugeordnet. Der Job mit der Business-Logik läuft dann unter dem zugeordneten Profil. Der technische Benutzer für externe usertypes zur Verbindung zum iseries. Das technische Benutzerpasswort für externe usertypes zur Verbindung zum iseries. Das pw ist verschlüsselt durch Base64. Ein Passwort kann hier verschlüsselt / entschlüsselt werden: (oder durch eine eigene kleine Verschlüsselungs-/Entschlüsselungs- Applikation) Tel. +41 (41) , Fax +41 (41) , 4 / 5

5 3 Installation und Konfiguration des iseries 3.1 Vorbedingung Ein iseries (AS/400 oder System i), System mit OS/400 Version V5R3M0 oder höher 3.2 Die Installations-Schritte Verwendung des MDINSSAVF-Commands (siehe MDCMS Installation Instructions für Details) und Einbezug des MD IDE Repository in die Installation. Das MD IDE Repository ist nur notwendig für die Partition, welche mit der Web-Applikation verbunden wird (ausser das Eclipse Plug-in wird auch verwendet). Allerdings muss die MDCMS-Version gleich sein wie in der Repository-Partition. 3.3 Konfiguration für den Gebrauch mit externen Benutzer-IDS Wenn die external network user IDs anstatt der internen iseries-benutzerprofile verwendet werden, muss ein System User (oder Technical User) in den Konfigurationseinstellungen der Web-Applikation definiert werden und der Benutzer muss in der Repository-Partition vorhanden sein. Dieser Benutzer muss keine speziellen Rechte haben und wird nur zur Verbindung mit dem iseries-system und dem Aufgeben von iseries-jobs verwendet (Jobs laufen unter dem zugeordneten internen iseries- Benutzerprofil). Um die externe ID einem internen Benutzerprofil zuzuordnen, muss in MDSEC der Wert der externen ID in des Feld external ID des Benutzers eingetragen werden. Das Feld beachtet Gross- /Kleinschrift. 3.4 Konfiguration u Ausführung des SMTP-Client MDCMS kann Mails via SMTP versenden. Der SMTP-Client existiert als kleine Java-Applikation im /MDCMS/MAIL ifs-ordner. Die Einstellungen für jede Partition, die Mails versenden kann, werden in den -Einstellungen in der Workflow-Applikation vorgenommen. Der Command MDSTRMAIL startet die java-applikation. Es wird empfohlen, diesen Command in einen geplanten Job oder in das IPL-Startprogramm einzubauen. Der Command selber setzt keinen Job ab, er startet einen zweiten Job, welcher den java thread, genannt MDMAIL, enthält Der Command MDENDMAIL beendet den java-job und den Kontrollprozess eine Minute nach dem Ausführen des Commands. Tel. +41 (41) , Fax +41 (41) , 5 / 5