Add an integration pack

Important

This version of Orchestrator has reached the end of support. We recommend you to upgrade to Orchestrator 2022.

System Center - Orchestrator includes a set of standard activities that are automatically installed. You can expand functionality and ability of Orchestrator to integrate platforms and products by Microsoft and other companies by installing integration packs. Each integration pack contains activities that provide functions that are unique to that product. Microsoft provides integration packs for all the System Center components, several other Microsoft products, and products from other companies.

Integration packs are available from the Microsoft Download Center. Each integration pack has a guide that provides installation instructions, known issues, and reference information for the activities in that integration pack.

Note

Orchestrator doesn't support a downgrade of integration packs. If you have an integration pack that's currently registered or previously registered in Orchestrator, installation fails if you attempt to install an earlier version of the same integration pack. You should test integration packs and upgraded integration packs in a test environment before you implement them in a production environment. If you require a downgrade of an integration pack in a production environment, contact Microsoft Customer Support for assistance.

Register and deploy an integration pack

After you download the integration pack, you register the integration pack file with the Orchestrator management server, and then deploy it to Runbook Servers and computers that have the Runbook Designer installed. For more information about how to install a specific integration pack, see the guide for that integration pack.

When you install an upgrade of an integration pack, you must first uninstall any earlier version of the integration pack from all the Runbook Servers and Runbook Designers. You then register and deploy the upgrade of the integration pack. If you don't uninstall the previous version of the integration pack prior to registering and deploying the upgrade version, the upgrade version will fail.

Select the required tab for the steps to register, deploy, and upgrade an integration pack:

Register an integration pack

Follow these steps to register an integration pack:

1. On the management server, copy the .OIP file for the integration pack to a local hard drive or network share.
2. Start the Deployment Manager.
3. In the navigation pane of the Deployment Manager, expand Orchestrator Management Server, right-click Integration Packs to select Register IP with the Management Server. The Integration Pack Registration Wizard opens.
4. Select Next.
5. In the Select Integration Packs or Hotfixes dialog, select Add.
6. Locate the .OIP file that you copied locally from step 1, select Open, and then select Next.
7. In the Completing the Integration Pack Wizard dialog, select Finish.
8. On the End User Agreement dialog, read the Microsoft Software License Terms, and select Accept.

Deploy an integration pack

Follow these steps to deploy an integration pack:

1. In the navigation pane of Deployment Manager, right-click Integration Packs, select Deploy IP to Action Server or Client.
2. Select the integration pack that you want to deploy, and then select Next.
3. Enter the name of the Runbook Server or computers with the Runbook Designer installed on which you want to deploy the integration pack, select Add, and select Next.
4. Continue to add additional Runbook Servers and computers running the Runbook Designer on which you want to deploy the integration pack. Select Next.
5. In the Installation Options dialog, configure the following settings.
6. To choose a time to deploy the integration pack, select the Schedule installation checkbox, and then select the time and date from the Perform installation list.
7. Select one of the following:
   • Stop all running runbooks before installing the integration pack to stop all running runbooks before deploying the integration pack.
   • Install the Integration Packs without stopping the running Runbooks to install the integration pack without stopping any running runbooks.
8. Select Next.
9. In the Completing Integration Pack Deployment Wizard dialog, select Finish.
10. When the integration pack is deployed, the Log Entries dialog displays a confirmation message.

Upgrade an integration pack

Follow these steps to upgrade an integration pack:

1. On all the computers that have a Runbook Server or Runbook Designer installed, uninstall any earlier version of the integration pack. You can achieve this by doing any one of the following:
   • Remove it by following the instructions in How to Uninstall and Unregister an Integration Pack.
   • Sign in to each computer and uninstall the integration pack from Programs and Features in Control Panel.
   • On the management server, start the Deployment Manager, and then right-click on the deployed integration pack for each Runbook Server or Runbook Designer computer and select Uninstall Integration Pack or Hotfix.
2. Register and deploy the upgraded integration pack.

Next steps

Learn more about creating runbooks.