Delen via

De wizard Integratiepakket

  • Artikel

Belangrijk

Deze versie van Orchestrator heeft het einde van de ondersteuning bereikt. U wordt aangeraden een upgrade uit te voeren naar Orchestrator 2019.

Met de wizard Integratiepakket (WIZARD IP) kunt u een nieuw integratiepakket maken op basis van een bestaande integratie-assembly. Integratieassembly's kunnen worden gemaakt met behulp van de wizard Command-Line activiteit (CLIActivityWizard) of met behulp van de Orchestrator SDK. De WIZARD IP (IPWizard) verpakt de assembly's, afhankelijke bestanden en vereiste metagegevens in een .OIP bestand dat kan worden geïmplementeerd via Orchestrator Deployment Manager. U kunt professioneel uitziende integratiepakketten maken met volledige huisstijl en aangepaste pictogrammen, of gewoon opdrachtregelactiviteiten verpakken zodat ze eenvoudiger kunnen worden geïmplementeerd met behulp van de wizard IP.

Bepalen wanneer een integratiepakket moet worden gemaakt

Het is belangrijk om te bepalen of het geschikt is om activiteiten afzonderlijk te gebruiken met de .NET Integration Pack-activiteiten van de toolkit, of dat het beter is om alle activiteiten in een integratiepakket te maken en te implementeren.

Wanneer u slechts weinig activiteiten hebt of wanneer u zich in de ontwikkelingsfase bevindt en veel wijzigingen in een activiteit aanbrengt, moet u alleen de assembly's met de toolkit .NET Integration Pack-activiteiten gebruiken om deze activiteiten uit te voeren in runbooks. Het verpakken, registreren, implementeren, verwijderen en upgraden van integratiepakketten zorgt voor grote overhead tijdens het ontwikkelingsproces.

Als u een groep activiteiten wilt testen of als u verder bent in de ontwikkelingscyclus en het volledige end-to-end installatie- of upgradeproces wilt testen, is het maken van een integratiepakket de beste aanpak. Het integratiepakket biedt een gebruiksvriendelijkere ervaring en een volledige installatie-ervaring. Integratiepakketten maken het ook mogelijk om de activiteiten te implementeren op meerdere runbookservers of runbookontwerpers in de hele organisatie of op externe klanten.

Een nieuw integratiepakket maken

Met de wizard Integratiepakket kunt u integratiepakketten maken op basis van de bestaande Orchestrator-compatibele assembly's en afhankelijke bestanden. Als u nog geen Orchestrator-compatibele assembly hebt gemaakt, raadpleegt u de wizard Opdrachtregelactiviteit.

Notitie

De Integration Toolkit bevat niet langer de binaire bestanden voor de WiX-hulpprogramma's (Windows Installer XML), die door de WIZARD IP wordt gebruikt voor het maken van aangepaste integratiepakketten. Installeer de nieuwste versie (v3.11) van de WiX Toolset voordat u de WIZARD IP gebruikt.

Een nieuw integratiepakket maken

  1. Start de wizard Integratiepakket. Selecteer Wizard > Orchestrator-integratiepakket starten. De welkomstpagina wordt weergegeven.

  2. Als u een bestaand integratiepakket hebt dat u wilt bijwerken, selecteert u Integratiepakket importeren. Zie Een bestaand integratiepakket bijwerken voor meer informatie. Als u een nieuw integratiepakket wilt maken, selecteert u Volgende.

    Belangrijk

    Als u een bestaand IP-adres wilt upgraden, moet u Integratiepakket importeren selecteren. Als u Volgende selecteert, heeft het IP-adres dat u maakt een nieuwe unieke product-id en nieuwe unieke id's voor alle activiteiten, zelfs als u een vorige assembly opnieuw gebruikt en hetzelfde product en dezelfde bestandsnamen gebruikt.

  3. Voer op de pagina Productdetails de informatie in of wijzig deze indien nodig om de informatie over uw integratiepakket aan te passen. In de onderstaande tabel worden de velden en de bijbehorende beschrijvingen beschreven:

    Veldnaam Beschrijving
    Productnaam De naam van het IP-adres dat wordt weergegeven in Deployment Manager
    Category name De tekst die wordt weergegeven als de categorietitel voor het IP-adres in het deelvenster Activiteiten van Runbook Designer
    Bedrijf De naam van uw bedrijf. Deze informatie wordt weergegeven in Programma's toevoegen/verwijderen onder 'Publisher'
    EULA-bestand Een tekstbestand met RTF-indeling met een .EULA extensie. De gebruiksrechtovereenkomst wordt weergegeven aan de gebruiker tijdens de registratie met behulp van Deployment Manager en vereist acceptatie voordat de registratie wordt uitgevoerd.
    Resourcebestand Een assembly met pictogrammen en andere resources die worden gebruikt om de categorie- en activiteitspictogrammen op te geven. Standaard wordt het standaard-toolkit-resourcebestand gebruikt (Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll)
    Versie Het versienummer van het integratiepakket, dat wordt weergegeven in Deployment Manager en wordt gebruikt om te bepalen of het IP-adres een upgrade is.
    Upgrade inschakelen Als u een bestaand integratiepakket hebt geïmporteerd, is dit selectievakje standaard ingeschakeld, zodat dit integratiepakket een upgrade kan uitvoeren van een bestaande geïnstalleerde versie. Als u dit selectievakje uitschakelt, worden nieuwe product- en activiteit-id's gemaakt voor het IP-adres (er wordt geen upgrade uitgevoerd van een bestaande versie). Als u de installatie van meerdere versies van uw IP-adres naast elkaar wilt inschakelen, schakelt u dit selectievakje uit.
    Beschrijving Een gedetailleerde beschrijving van uw integratiepakket
    Categoriepictogram Het standaardcategoriepictogram wordt weergegeven. Als u een ander pictogram wilt kiezen, selecteert u de knop Wijzigen en selecteert u een nieuw pictogram en selecteert u vervolgens OK.

  4. Wanneer u klaar bent met het invoeren van productgegevens, selecteert u Volgende. De pagina Activiteiten wordt weergegeven. Op de pagina Activiteiten verwijst u naar de assembly of assembly's die de activiteiten bevatten die u hebt gedefinieerd met behulp van de wizard Command-Line activiteit of die u hebt gemaakt met de Orchestrator SDK.

  5. Als u een nieuwe activiteit wilt toevoegen aan het IP-adres, selecteert u Toevoegen.

  6. Als u het assemblybestand wilt openen en toevoegen, selecteert u het beletselteken (...) rechts van Bibliotheek. Blader naar het gewenste assemblybestand, selecteer het en selecteer Openen. De bestandsnaam en het pad worden weergegeven in het veld Bibliotheek.

  7. Als u een activiteit in de assembly wilt selecteren, selecteert u de vervolgkeuzepijl Klasse en selecteert u de juiste activiteitsnaam in de lijst. De naam en beschrijving die in de activiteit zijn gedefinieerd, worden weergegeven in de velden Weergavenaam en Beschrijving .

  8. Wijzig desgewenst de weergavenaam en beschrijving van de activiteit.

  9. Het pictogram voor de standaardactiviteit wordt weergegeven voor de activiteit. Als u een ander pictogram wilt, selecteert u Wijzigen, selecteert u een ander pictogram in de browser en selecteert u OK.

  10. Selecteer OK om de definitie van de activiteit op te slaan. De naam en beschrijving van de activiteit worden nu weergegeven in de lijst Activiteiten.

  11. Ga zo nodig door met het toevoegen van activiteiten aan de lijst. Wanneer u klaar bent met het toevoegen van activiteiten, selecteert u Volgende. De pagina Afhankelijkheden en Opgenomen bestanden wordt weergegeven.

  12. Op deze pagina kunt u een lijst definiëren met extra bestanden die u wilt verpakken met uw integratiepakket. Deze bestanden kunnen extra assembly's zijn die nodig zijn voor uw activiteiten, scripts, documentatie of andere bestanden die u wilt implementeren op RunbookServers en Runbook Designers, samen met uw activiteiten. Selecteer Toevoegen, selecteer de bestanden die u nodig hebt en selecteer vervolgens OK om bestanden aan de lijst toe te voegen.

  13. Wanneer u klaar bent met het toevoegen van bestanden aan de lijst, selecteert u Volgende. De pagina Orchestrator Integration Pack File wordt weergegeven.

  14. Voer in het tekstvak het pad en de bestandsnaam in van het integratiepakket dat moet worden gemaakt. Als u een bestandsnaam invoert die al bestaat, wordt deze overschreven. Zorg ervoor dat u voldoende toegang hebt om naar het opgegeven pad te schrijven, anders mislukt het proces. Als er geen pad is opgegeven, wordt het OIP-bestand gemaakt in de map Documenten (C:\users\<your username>\Documents). Selecteer Volgende om te beginnen met het bouwen van het IP-adres.

    Belangrijk

    De tekens in de bestandsnaam moeten geldig zijn voor de taal die op uw besturingssysteem is geïnstalleerd.

    Belangrijk

    Geef een naam op voor het integratiepakket die niet gebruikelijk is om ervoor te zorgen dat het niet overeenkomt met de naam van een ander integratiepakket. Orchestrator kan geen twee integratiepakketten met dezelfde naam installeren.

  15. Wanneer het IP-adres is gemaakt, worden op de laatste pagina van de wizard het pad en de bestandsnaam van het nieuwe OIP-bestand weergegeven. Selecteer Voltooien om de wizard af te sluiten. Als er een fout optreedt, kunt u Terug selecteren en het buildproces opnieuw proberen.

    Zie het artikel Een integratiepakket toevoegen voor informatie over het implementeren van uw integratiepakket.

Een bestaand integratiepakket bijwerken

Met de wizard Orchestrator-integratiepakket kunt u een bestaand integratiepakket importeren, zodat u wijzigingen kunt aanbrengen en opnieuw kunt verpakken als een nieuwe versie. Zorg ervoor dat u het selectievakje Upgrade inschakelen inschakelt, anders wordt er een nieuw IP-adres gemaakt in plaats van de vorige geïnstalleerde versie te vervangen of bij te werken.

Nuttige tips voor IP-upgrade

Onderliggende assembly's bijwerken

Wanneer u een integratiepakket maakt, worden metagegevens over het IP-adres opgeslagen in het pakket, zodat deze tijdens volgende upgrades door de wizard kunnen worden gelezen. Wanneer u bepaalde items bijwerkt, zoals activiteiten of de onderliggende assembly's voor die activiteiten, moet u het IP-adres opnieuw opbouwen. Als u echter de activiteitsinstellingen wijzigt en een nieuw assemblybestand selecteert, worden de velden op de pagina Activiteitsgegevens opnieuw ingesteld, waardoor u de gegevens opnieuw moet invoeren.

U kunt de IP-configuratie-instellingen behouden terwijl u alleen de assembly wijzigt. Sla de nieuwe assembly op in hetzelfde pad en dezelfde bestandsnaam als de vorige assembly (die wordt weergegeven in het veld Bibliotheek van het dialoogvenster Activiteitsgegevens).

Migratie van QIK-integratiepakketten

Als u een integratiepakket hebt gemaakt met behulp van de wizard Opalis QIK, moet u het converteren om compatibel te zijn met Orchestrator voordat het kan worden geïmporteerd en gebruikt door Orchestrator.

Voordat u een IP-adres converteert, moet u de volgende stappen uitvoeren:

  • Als de activiteiten in uw IP-adres zijn gemaakt met behulp van de QIK CLI-wizard, moet u de stappen volgen die worden beschreven in Migratie van QIK CLI-activiteit om ze compatibel te maken met Orchestrator. Als u geen afzonderlijke kopie van de assembly met de activiteiten hebt, moet u eerst het IP-adres installeren op een Opalis 6.3-server en vervolgens de assembly zoeken in de volgende map: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Quick Integration Kit 3.

  • Als de activiteiten in uw IP-adres op maat zijn ontwikkeld in C# met behulp van de Opalis-API, moet u de stappen volgen die worden beschreven in Aangepaste QIK-API-activiteiten migreren om ze compatibel te maken met Orchestrator.

    Notitie

    Activiteiten op basis van Java die gebruikmaken van de Opalis-API voor Java worden niet meer ondersteund door de Integration Toolkit of orchestrator.

  • Als uw IP-adres afhankelijke of andere ingesloten bestanden bevat, moet dat bestand beschikbaar zijn om opnieuw in het nieuwe IP-adres te worden verpakt. Als u geen afzonderlijke kopie van deze bestanden hebt, moet u eerst het IP-adres installeren op een Opalis 6.3-server en vervolgens de bestanden zoeken in de volgende map: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Bin.

  • Als uw IP-adres een aangepast bronbestand bevat dat wordt gebruikt voor activiteits- en categoriepictogrammen, moet dat bestand beschikbaar zijn voor het nieuwe IP-adres. Als u geen afzonderlijke kopie van dit bestand hebt, moet u eerst het IP-adres installeren op een Opalis 6.3-server en vervolgens het bestand zoeken in de volgende map: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.

  • Als uw IP-adres de standaardpictogrammen van QIK gebruikt voor de categorie- of activiteitspictogrammen en u deze pictogrammen wilt blijven gebruiken in plaats van de nieuwe pictogrammen in Orchestrator te gebruiken, moet u het Opalis.QIK.Wizard.Images.dll bestand verkrijgen en gebruiken zoals u een aangepast resourcebestand zou doen. Als u geen afzonderlijke kopie van dit bestand hebt, moet u eerst het IP-adres installeren op een Opalis 6.3-server en vervolgens het bestand zoeken in de volgende map: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.

Notitie

Voor het eenvoudigste conversieproces moet u al deze bestanden plaatsen op de locaties waarin ze zich bevonden toen het IP-adres oorspronkelijk werd verpakt voordat de wizard IP werd gestart. De wizard IP verwijst naar deze bestanden op basis van de oorspronkelijke paden. Het selecteren van een nieuw pad is mogelijk voor alle bestanden, maar als u een nieuw pad selecteert voor assembly's die de activiteiten bevatten, worden sommige details van de activiteit opnieuw ingesteld, waardoor u de gegevens opnieuw moet invoeren. Door de oorspronkelijke paden voor de bestanden te gebruiken, wordt de bestaande informatie eenvoudig opnieuw gebruikt zonder deze opnieuw in te voeren.

Een integratiepakket dat compatibel is met Opalis converteren

  1. De wizard Integratiepakket starten

  2. Selecteer het Integratiepakket importeren.

  3. Selecteer het bestaande OIP-bestand en selecteer Openen.

  4. U ziet een waarschuwingsbericht dat aangeeft dat het IP-adres niet compatibel is met Orchestrator. Selecteer OK.

  5. Wijzig de productgegevens indien nodig om eventuele wijzigingen weer te geven. Het versienummer van het IP-adres wordt automatisch verhoogd en het selectievakje Upgraden is ingeschakeld. Selecteer Next.

  6. Op de pagina Activiteiten doorloopt u elke activiteit en controleert u of de informatie correct is voltooid. Als de assembly voor de activiteit niet is gemigreerd of zich niet op dezelfde locatie bevindt als toen het IP-adres werd gemaakt, is het veld Klasse leeg. Als u wilt voorkomen dat gegevens opnieuw moeten worden getypt, moet u de assembly vervangen voordat u de wizard start.

  7. Wanneer u klaar bent met het bewerken van activiteiten, selecteert u Volgende.

  8. Zorg ervoor dat de afhankelijke bestanden zich nog steeds op dezelfde locatie bevinden als weergegeven, of verwijder ze en voeg nieuwe afhankelijke bestanden toe. Selecteer Next.

  9. Voer een pad en bestandsnaam in voor het nieuwe IP-bestand. Gebruik niet dezelfde naam als het vorige IP-adres, zodat u ervoor kunt zorgen dat u een kopie van het vorige IP-adres behoudt. Selecteer Volgende om het IP-adres te bouwen.

    U hebt nu een IP-adres dat compatibel is met Orchestrator en dat kan worden geregistreerd en geïmplementeerd met Orchestrator Deployment Manager.

Integratiepakketten : bekende problemen

Beperking van bestandsnaamlengte

Wanneer u assembly's in uw integratiepakket opgeeft, worden deze automatisch door het installatieprogramma toegevoegd aan het register. Vanwege de beperking in de lengte van de registersleutelnaam, mag het gecombineerde pad en de bestandsnaam van een assembly niet langer zijn dan 234 tekens. Gezien het standaardpad waar assembly's binnen een IP-adres worden geplaatst, mag de maximale bestandsnaamlengte van een opgenomen assemblybestand niet langer zijn dan 80 tekens. Als een assembly met een bestandsnaam van meer dan 80 tekens in de installatie is opgenomen, mislukt de installatie.

Orchestrator-resources

Naast deze online referentie voor System Center Orchestrator zijn er veel bronnen die aanvullende informatie kunnen bieden over het bouwen van runbooks, het gebruik van de Integration Toolkit en best practices.

Zie ook