Integrationspaket-Assistent

Wichtig

Diese Version von Orchestrator hat das Ende des Support erreicht. Es wird empfohlen, ein Upgrade auf Orchestrator 2019 zu durchführen.

Mit dem Integration Pack-Assistenten (IP-Assistent) können Sie ein neues Integrationspaket aus einer vorhandenen Assembly erstellen, die vom Command-Line-Aktivitäts-Assistenten oder über das Orchestrator SDK erstellt wurde. Der IP-Assistent paketiert die Assemblys, abhängige Dateien und erforderliche Metadaten in einer OIP-Datei, die über den Orchestrator Deployment Manager bereitgestellt werden kann. Mit dem IP-Assistenten können Sie professionell aussehende Integrationspakete mit vollständigem Branding und benutzerdefinierten Symbolen erstellen oder einfach Befehlszeilen paketieren, damit sie leichter bereitgestellt werden können.

Entscheidung, wann ein Integrationspaket erstellt werden soll

Beim Erstellen benutzerdefinierter Aktivitäten für die Verwendung in Orchestrator ist es wichtig zu entscheiden, wann es sinnvoll ist, Aktivitäten einzeln mit ’’ den .NET Integration Pack-Aktivitäten des Toolkits zu verwenden und wann es sinnvoll ist, ein Integrationspaket zu erstellen und ’’ bereitzustellen.

Wenn Sie nur über eine oder mehrere Aktivitäten verfügen oder sich in der Entwicklungsphase befinden und viele Änderungen an einer Aktivität erstellen, sollten Sie einfach die Assemblys mit den Toolkit-IP-Aktivitäten verwenden, um den Betrieb dieser Aktivitäten zu ’ testen. Das Paketieren, Registrieren, Bereitstellen, Deinstallieren und Aktualisieren von Integrationspaketen verursacht beim Entwicklungsprozess einen beträchtlichen Overhead, der möglicherweise nicht erforderlich oder gewünscht ist. Da die Bereitstellung einer IP-Adresse das Installieren einer Windows Installer-Datei und das Vornehmen von Änderungen an der Datenbank umfasst, kann dies häufig zu unerwarteten Ergebnissen führen. Daher wird empfohlen, einen virtuellen Computer zu verwenden und ihn häufig wiederherzustellen, um eine saubere Testumgebung ’ sicherzustellen.

Wenn Sie über eine Gruppe von Zu testende Aktivitäten verfügen oder im Entwicklungszyklus weiterkommen und den gesamten End-to-End-Prozess der Installation, des Upgrades, der Deinstallation und der Verwendung fertiger Aktivitäten testen möchten, ist das Erstellen eines Integrationspakets der richtige ’ Weg. Das Integrationspaket bietet eine benutzerfreundlichere Oberfläche, einschließlich der Anzeige von Aktivitäten im Bereich „Aktivitäten“ von Runbook Designer, sowie eine vollständige Installationsfunktion. Integrationspakete ermöglichen außerdem die Bereitstellung der Aktivitäten für mehrere Runbookserver oder Runbook Designer in der gesamten Organisation oder für externe Kunden.

Erstellen eines neuen Integrationspakets

Mit dem Integration Pack-Assistenten können Sie Integrationspakete aus vorhandenen Orchestrator-kompatiblen Assemblys und abhängigen Dateien erstellen. Wenn Sie noch keine Orchestrator-kompatible Assembly erstellt haben, lesen Sie den Befehlszeilenaktivitäts-Assistenten.

Hinweis: Das Integration Toolkit enthält nicht mehr die Binärdateien für das WiX-Toolset (Windows Installer XML), das vom IP-Assistenten zum Erstellen der Windows Installer-Dateien in Integration Packs verwendet wird. Diese Sammlung von Tools muss jetzt vor der Installation des Toolkits installiert werden. Wenn WiX anschließend deinstalliert wird, zeigt der Integrationspaket-Assistent jedoch eine Fehlermeldung an, die Sie zum Download und zur Installation von WiX führt. Das Integration Toolkit unterstützt Version 3.5 des WiX-Toolsets.

So erstellen Sie ein neues Integrationspaket

  1. Starten Sie den Integration Pack-Assistenten. Klicken Sie auf Alle Programme starten Microsoft System Center > 2012 >> Orchestrator Integration Toolkit > Orchestrator Integration Pack Wizard. Die Willkommensseite wird angezeigt.

  2. Wenn Sie über ein vorhandenes Integrationspaket verfügen, das Sie aktualisieren möchten, klicken Sie auf Integrationspaket importieren. Weitere Informationen zu diesem Prozess finden Sie unter Aktualisieren eines vorhandenen Integrationspakets. Klicken Sie auf Weiter, um ein neues Integrationspaket zu erstellen.

    Wichtig

    Wenn Sie ein Upgrade für eine vorhandene IP-Adresse durchführen möchten, müssen Sie auf Integrationspaket importieren klicken. Wenn Sie auf Weiterklicken, hat die von Ihnen erstellten IP-Adressen eine neue eindeutige Produkt-ID und neue eindeutige IDs für alle Aktivitäten, auch wenn Sie eine vorherige Assembly erneut verwenden und die gleichen Produkt- und Dateinamen verwenden.

  3. Geben Sie auf der Seite Produktdetails die Informationen nach Bedarf ein, oder ändern Sie sie, um die Informationen zu Ihrem Integrationspaket anzupassen. In der folgenden Tabelle werden die Felder und deren Beschreibungen beschrieben:

    Feldname BESCHREIBUNG
    Produktname Der Name der IP-Adresse, die in der Deployment Manager
    Kategoriename Der Text, der als Kategorietitel für die IP-Adresse im Bereich Aktivitäten des Runbook Designer
    Company Name Ihres Unternehmens. Diese Informationen werden unter "Software" unter "Software" “ Publisher”
    EULA-Datei Eine RTF-formatierte Textdatei mit der Dateinamenerweiterung . EULA. Wird dem Benutzer während der Registrierung mithilfe Deployment Manager angezeigt und erfordert die Zustimmung vor der Registrierung.
    Ressourcendatei Eine Assembly, die Symbole und andere Ressourcen enthält, die zum Bereitstellen der Kategorie- und Aktivitätssymbole verwendet werden. Standardmäßig wird die Standardressourcendatei des Toolkits verwendet (Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll)
    Version Die Versionsnummer des Integrationspakets, die in der Deployment Manager angezeigt und verwendet wird, um zu bestimmen, ob die IP-Adresse ein Upgrade ist.
    Aktivieren des Upgrades Wenn Sie ein vorhandenes Integrationspaket importiert haben, ist dieses Kontrollkästchen standardmäßig aktiviert, sodass dieses Integrationspaket ein Upgrade einer vorhandenen installierten Version durchführen kann. Wenn Sie dieses Kontrollkästchen aktivieren, werden neue Produkt- und Aktivitäts-IDs für die IP-Adresse erstellt, und eine vorhandene Version wird nicht aktualisiert. Wenn Sie die gleichzeitige Installation mehrerer Versionen Ihrer IP-Adresse aktivieren möchten, aktivieren Sie dieses Kontrollkästchen.
    BESCHREIBUNG Eine ausführliche Beschreibung Ihres Integrationspakets
    Kategoriesymbol Das Standardkategoriesymbol wird angezeigt. Wenn Sie ein anderes Symbol auswählen möchten, klicken Sie auf die Schaltfläche Ändern, wählen Sie ein neues Symbol aus, und klicken Sie dann auf OK.
  4. Wenn Sie mit der Eingabe der Produktinformationen fertig sind, klicken Sie auf Weiter. Die Seite Aktivitäten wird angezeigt. Auf der Seite Aktivitäten verweisen Sie auf die Assemblys, die die Aktivitäten enthalten, die Sie mit dem Command-Line-Aktivitäts-Assistenten definiert oder mit dem ’ Orchestrator SDK erstellt haben.

  5. Klicken Sie auf Hinzufügen, um der IP-Adresse eine neue Aktivität hinzuzufügen.

  6. Um die Assemblydatei zu öffnen und hinzuzufügen, klicken Sie rechts von Bibliothek auf die Schaltfläche mit den Auslassungs- und Auslassungstasten( ). Navigieren Sie zur gewünschten Assemblydatei, wählen Sie sie aus, und klicken Sie auf Öffnen. Der Dateiname und der Pfad werden im Feld Bibliothek angezeigt.

  7. Um eine Aktivität aus der Assembly auszuwählen, klicken Sie auf den Dropdownpfeil Klasse, und wählen Sie den entsprechenden Aktivitätsnamen aus der Liste aus. Der in der Aktivität definierte Name und die Beschreibung werden in den Feldern Anzeigename und Beschreibung angezeigt.

  8. Ändern Sie bei Wunsch den Anzeigenamen und die Beschreibung der Aktivität.

  9. Das Standardaktivitätssymbol wird für die Aktivität angezeigt. Wenn ein anderes Symbol gewünscht ist, klicken Sie auf Ändern, wählen Sie im Browser ein anderes Symbol aus, und klicken Sie dann auf OK.

  10. Klicken Sie auf OK, um die Aktivitätsdefinition zu speichern. Der Aktivitätsname und die Beschreibung werden jetzt in der Liste Aktivitäten angezeigt.

  11. Fügen Sie der Liste nach Bedarf weitere Aktivitäten hinzu. Wenn Sie mit dem Hinzufügen von Aktivitäten fertig sind, klicken Sie auf Weiter. Die Seite Abhängigkeiten und eingeschlossene Dateien wird angezeigt.

  12. Auf dieser Seite können Sie eine Liste zusätzlicher Dateien definieren, die in Ihr Integrationspaket gepackt werden soll. Diese Dateien können zusätzliche Assemblys sein, die von Ihren Aktivitäten, Skripts, Dokumentationen oder anderen Dateien benötigt werden, die zusammen mit Ihren Aktivitäten auf RunbookServern und Runbook Designern bereitgestellt werden sollen. Klicken Sie auf Hinzufügen, wählen Sie die benötigten Dateien aus, und klicken Sie dann auf OK, um der Liste Dateien hinzuzufügen.

  13. Wenn Sie mit dem Hinzufügen von Dateien zur Liste fertig sind, klicken Sie auf Weiter. Die Seite Orchestrator Integration Pack File (Orchestrator Integration Pack-Datei) wird angezeigt.

  14. Geben Sie im bereitgestellten Textfeld den Pfad und den Dateinamen des zu erstellenden Integrationspakets ein. Wenn Sie einen dateinamen eingeben, der bereits vorhanden ist, wird er überschrieben. Stellen Sie sicher, dass Sie über ausreichendEntzugriff zum Schreiben in den angegebenen Pfad verfügen, da der Prozess fehlschlägt. Wenn kein Pfad angegeben ist, wird die OIP-Datei im Ordner Dokumente (C:\users\ < Ihr Benutzername > \Documents) erstellt. Klicken Sie auf Weiter, um mit dem Erstellen der IP-Adresse zu beginnen.

    Wichtig

    Die Zeichen im Dateinamen müssen für die Sprache gültig sein, die auf Ihrem Betriebssystem installiert ist.

    Wichtig

    Geben Sie einen Namen für das Integrationspaket an, der nicht üblich ist, um sicherzustellen, dass es nicht mit dem Namen eines anderen Integrationspakets übereinstimmen kann. Orchestrator kann nicht zwei Integrationspakete mit demselben Namen installieren.

  15. Wenn die IP-Adresse erfolgreich erstellt wurde, werden auf der letzten Seite des Assistenten der Pfad und der Dateiname der neuen OIP-Datei angezeigt. Klicken Sie auf Fertig stellen, um den Assistenten zu beenden. Wenn ein Fehler aufgetreten ist, können Sie auf Zurück klicken und nach Bedarf alle Informationen korrigieren und dann den Buildprozess wiederholen.

    Informationen zum Bereitstellen Ihres Integrationspakets finden Sie im Artikel Hinzufügen eines Integrationspakets.

Aktualisieren eines vorhandenen Integrationspakets

Mit dem Orchestrator Integration Pack-Assistenten können Sie ein vorhandenes Integrationspaket importieren, damit Sie Änderungen vornehmen und es als neue Version neu packen können. Wenn Sie sicherstellen möchten, dass Änderungen an einer vorhandenen IP-Adresse ein Upgrade der IP-Adresse sind und kein neues Integrationspaket erstellt werden, müssen Sie sicherstellen, dass Sie die vorhandene IP-Adresse in den Integration Pack-Assistenten importieren und auch sicherstellen, dass das Kontrollkästchen Upgrade aktivieren aktiviert “” ist. Wenn Sie diese Schritte nicht durchführen, wird die IP-Adresse mit einer neuen Produkt-ID und neuen Aktivitäts-IDs erstellt, wodurch eine side-by-side-Installation der neuen Version erstellt wird, anstatt die vorherige installierte Version zu ersetzen oder zu aktualisieren.

Dieser Prozess zum Erstellen und Aktualisieren einer IP-Adresse wird während der ersten Produktentwicklung nicht empfohlen, wenn Sie noch Aktivitäten entwickeln und Änderungen konstant sind. Stattdessen ist es besser, die Aktivitäten im .NET Integration Pack des Integration Toolkits zum Testen der Aktivitäten ’ außerhalb einer IP-Adresse zu nutzen. Weitere Informationen finden Sie unter Entscheidung, wann ein Integrationspaket erstellt werden soll.

Hilfreiche IP-Tipps

Aktualisieren zugrunde liegender Assemblys

Wenn Sie ein Integrationspaket erstellen, werden Metadaten über die IP-Adresse im Paket gespeichert, damit sie während nachfolgender Upgrades vom Assistenten gelesen werden kann. Wenn Sie bestimmte Elemente wie Aktivitäten oder die zugrunde liegenden Assemblys für diese Aktivitäten aktualisieren, müssen Sie die IP-Adresse neu erstellen. Wenn Sie jedoch die Aktivitätseinstellungen ändern und eine neue Assemblydatei auswählen, werden die Felder auf der Seite Aktivitätsinformationen zurückgesetzt, und Sie müssen die Informationen erneut eingeben.

Wenn Sie die zugrunde liegende Assembly einer oder mehrere Aktivitäten in einer IP ändern, um möglicherweise Parameter hinzuzufügen oder veröffentlichte Daten zu ändern, aber keine der anderen Einstellungen relativ zur IP-Adresse ändern möchten, speichern Sie einfach die neue Assembly unter demselben Pfad und Dateinamen wie die vorherige Assembly (die im Feld Bibliothek des Dialogfelds ’ Aktivitätsinformationen angezeigt wird). Importieren Sie dann einfach die vorhandene IP-Adresse in den Assistenten, und führen Sie den Prozess zum Erstellen der IP durch, ohne die Aktivitätsinformationen zu ändern.

Migration des QIK-Integrationspakets

Wenn Sie ein Integrationspaket mit dem Opalis QIK-Assistenten erstellt haben, müssen Sie es so konvertieren, dass es mit Orchestrator kompatibel ist, bevor es importiert und von Orchestrator verwendet werden kann.

Vor dem Konvertieren einer IP-Adresse müssen die folgenden Schritte durchgeführt werden:

  • Wenn die Aktivitäten in Ihrer IP-Adresse mithilfe des QIK-CLI-Assistenten erstellt wurden und Sie sie noch nicht so konvertiert haben, dass sie mit Orchestrator kompatibel sind, müssen Sie die Schritte unter QIK CLI-Aktivitätsmigration ausführen, bevor Sie fortfahren. Wenn Sie keine separate Kopie der Assembly mit den Aktivitäten haben, müssen Sie die IP-Adresse zuerst auf einem Opalis 6.3-Server installieren und dann die Assembly im folgenden Verzeichnis suchen: “ C:\Programme (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Quick Integration Kit 3 ” .

  • Wenn die Aktivitäten in Ihrer IP-Adresse mithilfe der Opalis-API mithilfe von C# benutzerdefiniert entwickelt wurden und Sie sie noch nicht so konvertiert haben, dass sie mit Orchestrator kompatibel sind, müssen Sie die Schritte unter Migrieren von benutzerdefinierten Aktivitäten der QIK-API ausführen, bevor Sie fortfahren.

    Hinweis

    Java-basierte Aktivitäten, die die Opalis-API für Java verwenden, werden nicht mehr vom Integration Toolkit oder von Orchestrator unterstützt.

  • Wenn Ihre IP-Adresse abhängige oder andere eingeschlossene Dateien enthält, muss diese Datei verfügbar sein, um sie erneut in die neue IP-Adresse zu packen. Wenn Sie keine separate Kopie dieser Dateien haben, müssen Sie die IP-Adresse zuerst auf einem Opalis 6.3-Server installieren und dann die Dateien im folgenden Verzeichnis suchen: “ C:\Programme (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Bin ” .

  • Wenn Ihre IP-Adresse eine benutzerdefinierte Ressourcendatei enthält, die für Aktivitäts- und Kategoriesymbole verwendet wird, muss diese Datei für die neue IP-Adresse verfügbar sein. Wenn Sie keine separate Kopie dieser Datei haben, müssen Sie die IP-Adresse zuerst auf einem Opalis 6.3-Server installieren und dann die Datei im folgenden Verzeichnis suchen: “ C:\Programme (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions ” .

  • Wenn Ihre IP-Adresse die von QIK bereitgestellten Standardsymbole für die Kategorie- oder Aktivitätssymbole verwendet hat und Sie diese Symbole weiterhin verwenden möchten, anstatt die neuen Symbole in Orchestrator zu verwenden, müssen Sie die Opalis.QIK.Wizard.Images.dll-Datei abrufen und wie eine benutzerdefinierte Ressourcendatei verwenden. Wenn Sie keine separate Kopie dieser Datei haben, müssen Sie die IP-Adresse zuerst auf einem Opalis 6.3-Server installieren und dann die Datei im folgenden Verzeichnis suchen: “ C:\Programme (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions ” .

Hinweis

Für den einfachsten Konvertierungsprozess sollten Sie alle diese Dateien an den Speicherorten platzieren, an denen sie sich beim ursprünglichen Packen der IP-Adresse vor dem Starten des IP-Assistenten befinden. Der IP-Assistent verweist auf diese Dateien nach ihren ursprünglichen Pfaden. Die Auswahl eines neuen Pfads ist für alle Dateien möglich, aber die Auswahl eines neuen Pfads für Assemblys, die die Aktivitäten enthalten, führt dazu, dass einige Details der Aktivität zurückgesetzt werden, und Sie müssen die Informationen erneut eingeben. Wenn Sie die ursprünglichen Pfade für die Dateien verwenden, werden die vorhandenen Informationen einfach erneut verwendet, ohne sie erneut eingeben zu müssen.

So konvertieren Sie ein Opalis-kompatibles Integrationspaket

  1. Starten des Integration Pack-Assistenten

  2. Klicken Sie auf Integrationspaket importieren.

  3. Wählen Sie die vorhandene OIP-Datei aus, und klicken Sie auf Öffnen.

  4. Es wird eine Warnmeldung mit dem Hinweis angezeigt, dass die IP-Adresse nicht mit Orchestrator kompatibel ist. Klicken Sie auf OK.

  5. Ändern Sie die Produktdetails nach Bedarf, um änderungen widerzu spiegeln. Beachten Sie, dass die Versionsnummer der IP-Adresse automatisch erhöht wird und das “ Kontrollkästchen Upgrade ” deaktiviert ist. Klicken Sie auf Weiter.

  6. Gehen Sie auf der Seite Aktivitäten die einzelnen Aktivitäten durch, und stellen Sie sicher, dass die Informationen ordnungsgemäß abgeschlossen sind. Wenn die Assembly für die Aktivität nicht migriert wurde oder sich nicht am gleichen Speicherort wie beim Erstellen der IP-Adresse befindet, ist das Feld Klasse leer. Um zu verhindern, dass Informationen erneut eingeben müssen, sollten Sie die Assembly ersetzen, bevor Sie den Assistenten starten.

  7. Wenn Sie mit dem Bearbeiten von Aktivitäten fertig sind, klicken Sie auf Weiter.

  8. Stellen Sie sicher, dass sich abhängige Dateien weiterhin am gleichen Speicherort wie gezeigt befinden, oder entfernen Sie sie, und fügen Sie neue abhängige Dateien hinzu. Klicken Sie auf Weiter.

  9. Geben Sie einen Pfad und einen Dateinamen für die neue IP-Datei ein. Verwenden Sie nicht den gleichen Namen wie die vorherige IP-Adresse, damit Sie sicherstellen können, dass Sie eine Kopie der vorherigen IP-Adresse beibehalten. Klicken Sie auf Weiter, um die IP-Adresse zu erstellen.

    Sie verfügen jetzt über eine IP-Adresse, die mit Orchestrator kompatibel ist und über Orchestrator-Geräte registriert und bereitgestellt Deployment Manager.

Bekannte Probleme bei – Integrationspaketen

Längenbeschränkung für Dateinamen

Wenn Sie Assemblys in Ihr Integrationspaket integrieren, werden sie automatisch vom Installationsprogramm zur Registrierung hinzugefügt. Aufgrund der Einschränkung der Länge des Registrierungsschlüsselnamens dürfen der kombinierte Pfad und Dateiname einer Assembly 234 Zeichen nicht überschreiten. Angesichts des Standardpfads, in dem Assemblys innerhalb einer IP-Adresse platziert werden, darf die maximale Dateinamenlänge einer eingeschlossenen Assemblydatei 80 Zeichen nicht überschreiten. Wenn eine Assembly mit einem Dateinamen, der mehr als 80 Zeichen umfasst, in der Installation enthalten ist, kann die Installation nicht abgeschlossen werden.

Orchestrator-Ressourcen

Zusätzlich zu dieser Onlinereferenz für System Center 2012 Orchestrator gibt es eine Reihe von Ressourcen, die zusätzliche Informationen zum Erstellen von Runbooks, mithilfe des Integration Toolkits und bewährte Methoden bereitstellen können.

Resource Standort
System Center-Startseite https://www.microsoft.com/en-us/cloud-platform/system-center
System Center dokumentation https://docs.microsoft.com/system-center/
Orchestrator-Teamblog auf TechNet https://blogs.technet.microsoft.com/orchestrator/
Orchestrator-Community-Foren auf TechNet https://social.technet.microsoft.com/Forums/en-US/home?category=systemcenterorchestrator

Weitere Informationen

Orchestrator Integration Packs
Dokumentation zum Integration Toolkit
Orchestrator-SDK