Integrationspaketguiden

  • Artikel
  • 11 minuter för att läsa

Viktigt

Den här versionen av Orchestrator har nått slutet av supporten. Vi rekommenderar att du uppgraderar till Orchestrator 2019.

Med guiden För integrationspaket (IP-guiden) kan du skapa ett nytt integrationspaket från en befintlig sammansättning som skapats av aktivitetsguiden för Command-Line eller skapats via Orchestrator SDK. IP-guiden paketerar sammansättningar, beroende filer och metadata som krävs till en .OIP-fil som kan distribueras via Orchestrator Deployment Manager. Du kan skapa professionella integrationspaket med fullständig organisationsanpassning och anpassade ikoner eller helt enkelt paketera kommandoradsaktiviteter så att de kan distribueras enklare med IP-guiden.

Avgöra när du ska skapa ett integrationspaket

När du skapar anpassade aktiviteter för användning i Orchestrator är det viktigt att bestämma när det är lämpligt att använda aktiviteter individuellt med Toolkits .NET-integrationspaketaktiviteter, och när det är lämpligt att skapa och distribuera ett integrationspaket.

När du endast har en eller några få aktiviteter, eller när du är i utvecklingsfasen och gör många ändringar i en aktivitet, bör du använda sammansättningarna med Toolkit IP-aktiviteter för att testa driften av dessa aktiviteter. Paketering, registrering, distribuering, avinstallation och uppgradering av integrationspaket skapar mycket arbete i utvecklingsprocessen som varken behövs eller är önskvärt. Eftersom distributionen av en IP-adress omfattar installation av en Windows Installer-fil och att göra ändringar i databasen, kan detta ofta orsaka oväntade resultat. Därför rekommenderar vi att du använder en virtuell dator och återställer den ofta för att säkerställa en ren testmiljö.

Om du har en grupp aktiviteter att testa eller om du har kommit längre i utvecklingscykeln och vill testa processen för installation, uppgradering, avinstallation från slutpunkt till slutpunkt eller att använda färdiga aktiviteter, då är det dags att skapa ett integrationspaket. Integrationspaketet ger en mer användarvänlig upplevelse, inklusive aktiviteter som visas i aktivitetsfönstret i Runbook Designer och en fullständig installationsupplevelse. Integrationspaketen kan även distribuera aktiviteter till flera Runbook-servrar eller Runbook Designers i organisationen, eller till externa kunder.

Skapa ett nytt integrationspaket

Med integrationspaketguiden kan du skapa integreringspaket från befintliga Orchestrator-kompatibla sammansättningar och beroende filer. Om du inte har skapat en Orchestrator-kompatibel sammansättning än kan du gå till guiden Kommandoradsaktivitet.

Obs! Integration Toolkit innehåller inte längre binärfilerna för wiX-verktygsuppsättningen (Windows Installer XML), som används av IP-guiden för att skapa Windows Installer-filer i integrationspaket. Den här samlingen verktygen är nu nödvändiga, de måste installeras innan du installerar Toolkit. Om WiX därefter avinstalleras kommer IP-guiden visa ett felmeddelande och dirigera dig till att ladda ned och installera WiX. Integration Toolkit stöder version 3.5 av WiX Toolset.

Så här skapar du ett nytt integrationspaket

  1. Starta guiden För integrationspaket. Klicka på > Starta alla program > Microsoft System Center 2012 > Orchestrator > Integration Toolkit > Orchestrator Integration Pack Wizard. Välkomstsidan visas.

  2. Om du har ett befintligt integrationspaket som du vill uppdatera klickar du på Importera integrationspaket. Mer information om processen finns i Uppdatera ett befintligt integrationspaket. Om du vill skapa ett nytt integrationspaket klickar du på Nästa.

    Viktigt

    Om du vill uppgradera en befintlig IP-adress måste du klicka på Importera integrationspaket. Om du klickar på Nästa får den IP-adress som du skapar ett nytt unikt produkt-ID och nya unika ID:n för alla aktiviteter, även om du använder en tidigare sammansättning och använder samma produkt och filnamn.

  3. På sidan Produktinformation anger eller ändrar du informationen efter behov för att anpassa informationen om ditt integrationspaket. I tabellen nedan beskrivs fälten och deras beskrivningar:

    Fältnamn Description
    Produktnamn Namnet på IP-adressen som visas i Distributionshanteraren
    Kategorinamn Den text som visas som kategorirubrik för IP-adressen i fönstret Aktiviteter i Runbook-designer
    Företag Namnet på ditt företag. Den här informationen visas i Lägg till/ta bort program under "Publisher"
    EULA-fil En RTF-formaterad textfil med filnamnstillägget . EULA. Visas för användaren under registreringen med distributionshanteraren och kräver godkännande före registreringen.
    Resursfil En sammansättning som innehåller ikoner och andra resurser som används för att ange kategori- och aktivitetsikoner. Som standard används standardresursfilen för Toolkit (Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll)
    Version Versionsnumret för integrationspaketet som visas i Distributionshanteraren och används för att avgöra om IP-adressen är en uppgradering.
    Aktivera uppgradering Om du har importerat ett befintligt integrationspaket är den här kryssrutan markerad som standard, vilket gör att integrationspaketet kan uppgradera en befintlig installerad version. Om du avmarkerar den här kryssrutan skapas nya produkt- och aktivitets-IP-nummer för IP-adressen och den uppgraderar inte en befintlig version. Om du vill aktivera sida-vid-sida-installation av flera versioner av din IP-adress avmarkerar du den här kryssrutan.
    Description En detaljerad beskrivning av ditt integrationspaket
    Kategoriikon Standardkategoriikonen visas. Om du vill välja en annan ikon klickar du på knappen Ändra och väljer en ny ikon. Klicka sedan på OK.

  4. När du är klar med att ange produktinformation klickar du på Nästa. Sidan Aktiviteter visas. På sidan Aktiviteter refererar du till den sammansättning eller de sammansättningar som innehåller de aktiviteter som du har definierat med hjälp Command-Line aktivitetsguiden eller som skapats med Orchestrator SDK.

  5. Om du vill lägga till en ny aktivitet i IP-adressen klickar du på Lägg till.

  6. Klicka på ellipsknappen (...) till höger om Bibliotek för att öppna och lägga till sammansättningsfilen. Bläddra till önskad sammansättningsfil, markera den och klicka på Öppna. Filnamnet och sökvägen visas i fältet Bibliotek.

  7. Om du vill välja en aktivitet från sammansättningen klickar du på listrpilen Klass och väljer lämpligt aktivitetsnamn i listan. Namnet och beskrivningen som definierats i aktiviteten visas i fälten Visningsnamnoch Beskrivning.

  8. Om du vill ändrar du visningsnamnet och beskrivningen för aktiviteten.

  9. Standardaktivitetsikonen visas för aktiviteten. Om en annan ikon önskas klickar du på Ändra och väljer en annan ikon i webbläsaren. Klicka sedan på OK.

  10. Klicka på OK för att spara aktivitetsdefinitionen. Aktivitetsnamnet och beskrivningen visas nu i listan Aktiviteter.

  11. Fortsätt att lägga till aktiviteter i listan efter behov. När du är klar med att lägga till aktiviteter klickar du på Nästa. Sidan Beroenden och Inkluderade filer visas.

  12. På den här sidan kan du definiera en lista över ytterligare filer som du vill ha paketerade med ditt integrationspaket. Dessa filer kan vara ytterligare sammansättningar som krävs av dina aktiviteter, skript, dokumentation eller andra filer som du vill distribuera till Runbook-servrar och Runbook Designers tillsammans med dina aktiviteter. Klicka på Lägg till och välj sedan de filer som du behöver och klicka sedan på OK för att lägga till filer i listan.

  13. När du är klar med att lägga till filer i listan klickar du på Nästa. Sidan Orchestrator Integration Pack-fil visas.

  14. I textrutan anger du sökvägen och filnamnet för integrationspaketet som ska skapas. Om du anger ett filnamn som redan finns skrivs det över. Kontrollera att du har tillräcklig åtkomst för att skriva till den angivna sökvägen, annars misslyckas processen. Om ingen sökväg anges skapas OIP-filen i mappen Dokument (C:\users\<ditt användarnamn>\Dokument). Klicka på Nästa för att börja skapa IP-adressen.

    Viktigt

    Tecknen i filnamnet måste vara giltiga för det språk som är installerat på operativsystemet.

    Viktigt

    Ange ett namn för integrationspaketet som inte är vanligt för att säkerställa att det inte matchar namnet på ett annat integrationspaket. Orchestrator kan inte installera två integreringspaket med samma namn.

  15. När IP-adressen har skapats visas sökvägen och filnamnet för den nya OIP-filen på den sista sidan i guiden. Klicka på Slutför för att avsluta guiden. Om det uppstod ett fel kan du klicka på Tillbaka och korrigera informationen efter behov och sedan försöka skapa processen igen.

    Information om hur du distribuerar ditt integrationspaket finns i artikeln Så här lägger du till ett integrationspaket.

Uppdatera ett befintligt integrationspaket

Med guiden Orchestrator Integration Pack kan du importera ett befintligt integrationspaket så att du kan göra ändringar och paketera om det som en ny version. Om du vill se till att ändringar av en befintlig IP-adress är en uppgradering till IP-adressen och inte skapar ett nytt integrationspaket måste du importera den befintliga IP-adressen till guiden för integrationspaket och kontrollera att kryssrutan "Aktivera uppgradering" är markerad. Om du inte gör något av följande skapas IP-adressen med ett nytt produkt-ID och nya aktivitets-ID:n, vilket skapar en sida-vid-sida-installation av den nya versionen i stället för att ersätta eller uppgradera den tidigare installerade versionen.

Den här processen med att skapa och uppgradera en IP-adress rekommenderas inte under den inledande produktutvecklingen när du fortfarande utvecklar aktiviteter och ändringar är konstanta. I stället är det bättre att använda aktiviteterna i Integration Toolkits .NET-integrationspaket för att testa aktiviteter utanför en IP-adress. Mer information finns i Bestämma när du ska skapa ett integrationspaket.

Användbar IP-uppgradering Tips

Uppdatera underliggande sammansättningar

När du skapar ett integrationspaket lagras metadata om IP-adressen i paketet så att det kan läsas av guiden under efterföljande uppgraderingar. När du uppdaterar vissa objekt, till exempel aktiviteter eller underliggande sammansättningar för dessa aktiviteter, måste du återskapa IP-adressen. Men om du ändrar aktivitetsinställningarna och väljer en ny sammansättningsfil återställs fälten på sidan Aktivitetsinformation, vilket kräver att du anger informationen på nytt.

Om du ändrar den underliggande sammansättningen av en eller flera aktiviteter i en IP-adress, kanske för att lägga till parametrar eller ändra publicerade data, men inte vill ändra någon av de andra inställningarna i förhållande till IP-adressen, sparar du bara den nya sammansättningen på samma sökväg och filnamn som den föregående sammansättningen (som visas i fältet Bibliotek i dialogrutan Aktivitetsinformation). Sedan importerar du bara den befintliga IP-adressen till guiden och går igenom processen för att skapa IP-adressen utan att ändra någon av aktivitetsinformationen.

Migrering av QIK-integrationspaket

Om du har skapat ett integrationspaket med hjälp av Opalis QIK-guiden måste du konvertera det för att vara kompatibelt med Orchestrator innan det kan importeras och användas av Orchestrator.

Innan du konverterar en IP-adress måste du slutföra följande steg:

  • Om aktiviteterna i din IP-adress har skapats med hjälp av QIK CLI-guiden och du inte redan har konverterat dem till att vara kompatibla med Orchestrator, måste du följa stegen som beskrivs i QIK CLI-aktivitetsmigrering innan du fortsätter. Om du inte har en separat kopia av sammansättningen som innehåller aktiviteterna måste du först installera IP-adressen till en Opalis 6.3-server och sedan hitta sammansättningen i följande katalog: "C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Quick Integration Kit 3".

  • Om aktiviteterna i din IP-adress har anpassats med C# med hjälp av Opalis-API:et och du inte redan har konverterat dem till att vara kompatibla med Orchestrator, måste du följa stegen som beskrivs i Migrera anpassade aktiviteter för QIK API innan du fortsätter.

    Anteckning

    Java-baserade aktiviteter som använder Opalis API för Java stöds inte längre av Integration Toolkit eller Orchestrator.

  • Om din IP-adress innehåller beroende eller andra inkluderade filer måste filen vara tillgänglig för ompaketering till den nya IP-adressen. Om du inte har en separat kopia av dessa filer måste du först installera IP-adressen till en Opalis 6.3-server och sedan hitta filerna i följande katalog: "C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Bin".

  • Om din IP-adress innehåller en anpassad resursfil som används för aktivitets- och kategoriikoner måste filen vara tillgänglig för den nya IP-adressen. Om du inte har en separat kopia av den här filen måste du först installera IP-adressen till en Opalis 6.3-server och sedan hitta filen i följande katalog: "C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions".

  • Om din IP-adress använde standardikonerna som tillhandahålls av QIK för kategori- eller aktivitetsikonerna och du vill fortsätta att använda dessa ikoner i stället för att använda de nya ikonerna som anges i Orchestrator, måste du hämta Opalis.QIK.Wizard.Images.dll-filen och använda den på samma sätt som en anpassad resursfil. Om du inte har en separat kopia av den här filen måste du först installera IP-adressen till en Opalis 6.3-server och sedan hitta filen i följande katalog: "C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions".

Anteckning

För den enklaste konverteringsprocessen bör du placera alla dessa filer på de platser där de fanns när IP-adressen ursprungligen paketerades innan du startade IP-guiden. IP-guiden refererar till dessa filer med sina ursprungliga sökvägar. Det är möjligt att välja en ny sökväg för alla filer, men om du väljer en ny sökväg för sammansättningar som innehåller aktiviteterna kommer en del av informationen om aktiviteten att återställas, vilket kräver att du anger informationen på nytt. Genom att använda de ursprungliga sökvägarna för filerna används den befintliga informationen helt enkelt på samma sätt utan att du behöver ange den på samma gång.

Konvertera ett Opalis-kompatibelt integrationspaket

  1. Starta guiden För integrationspaket

  2. Klicka på Importera integrationspaket.

  3. Välj den befintliga OIP-filen och klicka på Öppna.

  4. Ett varningsmeddelande visas som anger att IP-adressen inte är kompatibel med Orchestrator. Klicka på OK.

  5. Ändra produktinformationen efter behov för att återspegla eventuella ändringar. Observera att versionsnumret för IP-adressen ökar automatiskt och att kryssrutan "Uppgradera" är markerad. Klicka på Nästa.

  6. På sidan Aktiviteter går du igenom varje aktivitet och ser till att informationen slutförs korrekt. Om sammansättningen för aktiviteten inte har migrerats eller inte är på samma plats som den var när IP-adressen skapades, kommer fältet Klass att vara tomt. Om du vill förhindra att någon information behöver skrivas in igen bör du ersätta sammansättningen innan du startar guiden.

  7. När du är klar med redigeringsaktiviteterna klickar du på Nästa.

  8. Se till att beroende filer fortfarande finns på samma plats som visas, eller ta bort dem och lägg till nya beroende filer. Klicka på Nästa.

  9. Ange en sökväg och ett filnamn för den nya IP-filen. Använd inte samma namn som den tidigare IP-adressen så att du kan se till att du behåller en kopia av den tidigare IP-adressen. Klicka på Nästa för att skapa IP-adressen.

    Nu har du en IP-adress som är kompatibel med Orchestrator och som kan registreras och distribueras med Orchestrator Deployment Manager.

Integreringspaket – kända problem

Längdbegränsning för filnamn

När du inkluderar sammansättningar i integrationspaketet läggs de automatiskt till i registret av installationsprogrammet. På grund av begränsningen i längden på registernyckelns namn får den kombinerade sökvägen och filnamnet för en sammansättning inte överskrida 234 tecken. Med tanke på standardsökvägen där sammansättningar inom en IP-adress placeras får den maximala filnamnslängden för en inkluderad sammansättningsfil inte överskrida 80 tecken. Om en sammansättning med ett filnamn som överstiger 80 tecken ingår i installationen misslyckas installationen.

Informationskällor för Orchestrator

Förutom den här onlinereferensen för System Center 2012 Orchestrator finns det ett antal resurser som kan ge ytterligare information om hur du skapar runbooks, använder Integration Toolkit och bästa praxis.

Resurs Location
System Center Start https://www.microsoft.com/en-us/cloud-platform/system-center
System Center dokumentation https://docs.microsoft.com/system-center/
Orchestrator-teamets blogg på TechNet https://blogs.technet.microsoft.com/orchestrator/
Orchestrator Community-forum på TechNet https://social.technet.microsoft.com/Forums/en-US/home?category=systemcenterorchestrator

Se även

Orchestrator-integreringspaket
Dokumentation om Integration Toolkit
Orchestrator SDK