Effiziente Administration Ihrer Netzwerkumgebung

Admin
Anwender
Au f
träg
e, F
reig
abe
n
,
tzer
enu r und
et B
e
walt , Ordn ungen
r
e
V
en chtig
box
e
Mail ibt Ber
verg
Erzeugt und pflegt
Mailboxen und
Datenbanken
Anbindung von
Fremdsystemen
n
ne
atio
r m onen
o
f
i
rin nt
tze onve
nu
Be n d K
u
Ve r
Mail waltet
Ben
box
Ber en und utzer,
ech
tigu vergib
nge
t
n
*Alle Firmensymbole sind eingetragene Warenzeichen der Inhaberfirmen
Effiziente Administration Ihrer
Netzwerkumgebung
MailQueue Schnittstelle
Inhaltsverzeichnis
1 Allgemeines _____________________________________________ 3
2 Voraussetzungen ________________________________________ 3
3 Mail-Struktur ____________________________________________ 4
4 Beispiel _________________________________________________ 5
5 Sicherheit _______________________________________________ 7
Operations Manager
1
Mail Queue Schnitstelle
Allgemeines
Mit der MailQueue-Schnittstelle können Anträge in die Warteschlagen des
Operations Managers gestellt werden. Der Start eines Antrags erfolgt dabei
durch das Versenden einer E-Mail mit den erforderlichen Antragsdaten an ein
definiertes Postfach.
In den folgenden Kapiteln ist erklärt, wie die MailQueue-Schnittstelle
verwendet werden kann, um eine automatisierte Anbindung von Operations
Manager Prozessen an beliebige Systeme über die MailQueue-Schnittstelle
zu realisieren.
2
Voraussetzungen
Für das erfolgreiche Einstellen von Anträgen per E-Mail sind einige
Voraussetzung zu realisieren:
• Der als Empfänger definierte Benutzer muss ein aktives Mailkonto
haben und sich wenigstens einmal mit seinem Konto interaktiv am
ausführenden Dispatcher Server angemeldet haben. (Erfolgt über die
Anmelung am Server.)
• Der ausführende Dispatcher muss Zugriff auf die definierte
Eingangsmailbox haben.
• Das Logon vom Dispatcher Service muss auf den als Empfänger
definierten Benutzer eingestellt sein.
• Bei der Verwendung von Exchange 2007 muss der Webservice aktiviert
sein.
• Der Absender des Antrags muss auf den Antrag berechtigt sein.
• Eintragungen in der Regestry
o HKLM\Software\UnicatGmbH\Dispatcher\Control\disableMailReq
uests = 0
o HKLM\Software\UnicatGmbH\Dispatcher\MailRequests
Exchange 2003
https://servername/exchange/username/inbox oder
https://servername/exchange/unsername/Posteingang
Exchange 2007
https://Mailserver/ews/exchange.asmx
Sollten Änderungen an der Regestry vorgenommen werden, muss der
Dispatcher Service neu gestartet werden, da andernfalls die
Änderungen nicht aktiviert sind.
Stand: 23.09.2009
Seite 3 von 7
Operations Manager
3
Mail Queue Schnitstelle
Mail-Struktur
Ein E-Mail, mit der ein Antrag im Operations Manager gestartet werden kann,
hat die folgende Form:
• Empfänger: Der für MailQueue-Anträge definierte Empfänger.
• Betreff: OMJOB – um dem Dispatcher zu signalisieren, dass es sich
hierbei um einen Antrag handelt.
• Mailtext:
Alle Zeilen des Mailtextes müssen mit einem Umbruch geschlossen
werden.
• OMInqueue
• Server: Dies ist der NetBios-Name des Datenbankservers in dessen
Datenbank der neue Antrag eingestellt wird.
• Datenbank: Dies ist die Datenbank in welche der neue Antrag
eingestellt wird z.B. ntadm2.
• Schema: Dies ist der Name des Antragsart.
• Template: Vorlage (Registersatz) der Antragsart, welche verwendet
werden soll.
Stand: 23.09.2009
Seite 4 von 7
Operations Manager
•
4
Mail Queue Schnitstelle
Parameter: Hier erfolgt eine Auflistung aller Parameter, die der
Antrag benötigt. Diese müssen als Liste von Parameternamen und
Parameterwerten angegeben werden. Gibt es z.B. ein
Oberflächenregister ‚GUIValueOne‘ und wird darin ein Eintrag
gemacht, muss hier jetzt die Angabe mit ‚GUIValueOne‘ und Wert
des Eintrags erfolgen. Es können beliebig viele Parameter, je nach
Design der Antragsart übergeben werden.
Beispiel
Im folgenden wird der Standardantrag ‚OM WS Inqueue‘ (ein einfacher Antrag,
der ein paar Sekunden wartet) über die MailQueue-Schnittstelle aktiviert.
Zunächst aber erst einmal die überliche Vorgehensweise:
Die Werte ‚ValueOne’ und ‚ValueTwo’ ergeben die Gesamtwartezeit. Wie
würde hierfür bei der beschriebenen Antragsart die E-Mail aussehen?
Stand: 23.09.2009
Seite 5 von 7
Operations Manager
Mail Queue Schnitstelle
Zunächst das Antragsschema:
Die zu übergebenden Parameter sind also ‚GUIValueOne, und
‚GUIValueTwo’. Damit kann die E-Mail für den Start folgendermaßen
aussehen:
Stand: 23.09.2009
Seite 6 von 7
Operations Manager
Mail Queue Schnitstelle
Sonderzeichen sind so weit dies möglich ist zu vermeiden, da die
Antragsdaten an den Webservice übergeben werden.
Die E-Mail wird kurz nach dem Erhalt aus dem Posteingang entfernt und im
Operations Manager verarbeitet. Der Ablauf des Antrags kann in der
Warteschlagen des Operations Manager verfolgt werden.
Der Absender des Antrags erhält nur dann eine Benachrichtigung über die
erfolgte Abarbeitung des Antrags, wenn dies im auszuführenden Antrag
eingearbeitet ist.
5
Sicherheit
Aufgrund der Prozess-Logik muss der Operations-Manager den Urheber bzw.
Antragsteller eines Antrags identifizieren.
In der MailRequest-Schnittstelle wird dafür der Absender der E-Mail
herzangezogen. Der Absender muss also über die Zugriffsberechtigungen für
die Antragsart verfügen (RM – Read, Middleware).
Stand: 23.09.2009
Seite 7 von 7