Upgrading or downgrading a service instance

You can upgrade or downgrade a particular active service instance. The upgrade or downgrade service version must be selected while creating or editing a service version. See Adding a service version or Editing a service version for more details.

Note: You can upgrade or downgrade a particular active service instance only by using the plan selected during initial service deployment. Upgrade and downgrade of an active service instance from Plan A to Plan B is not supported.

The following table shows how the different activities are managed during the Upgrade/downgrade action when any value of the activity changes between versions:

Activity Action on Upgrade/downgrade
Terraform template Modified (Depends on the template provider)
Rest Hook Executed again
Email notification Executed again
Helm Chart Destroyed and recreated
Decision Executed again
BAW/BPM template Executed again
Ansible credential Destroyed and recreated
Ansible inventory Destroyed and recreated
Ansible template Executed again

Note: If the activity ID of an activity changes, the activity is destroyed and recreated.

Procedure

  1. Navigate to the deployed instances page, by using one of these methods:

    • In the navigation bar, click Deployed instances > Services tab.

    • Alternatively, any operational user can access the instances page through the service library. From the IBM Cloud Pak for AIOps console, click Automate infrastructure > Service library. The Instances tab shows the deployed instances.

      In the deployed instances page, you can see a list of all deployed instances. Each instance record has name, status, service offering, user ordered, and the time of order.

  2. Search for your deployed instance by using any of the following search filters:

    • Enter your instance name in Search instances.

    • Click the show filter menu icon to filter records based on the status of a record. The different statuses of a service instance are Active, In progress, Error, and Terminated.

      Note: The Wait status is available whenever you use long running Business Process Manager template in your service.

    • You can click Name and Ordered On column headers to sort records. The Name also includes the namespace details. In addition, you have Service offering and Status column headers.

    • You can select a namespace from the All namespaces drop-down list. The list of deployed services in the page changes based on the selected namespace. You can select "All namespaces" to see all of the deployed services for which you have access.

    • You can use the pagination drop-down to select the number of records you want to display in a page at a time. Use the > or < to go through the next or previous set of records.

  3. Click Upgrade or Downgrade from the overflow menu of the service instance. The other way to upgrade or downgrade is to click the service instance and click Upgrade or Downgrade. These options are available only when Upgrade or Downgrade is specified while adding a new service version or editing a service version.

  4. Click Upgrade or Downgrade in the confirmation dialog box.

  5. A Upgrade service instance page is displayed where you can edit service input parameters before upgrading or downgrading an instance.

  6. A Planned changes page is displayed with the log output. Verify the output and click Upgrade or Downgrade if the log output looks ok.

  7. The service instance is upgraded or downgraded to the desired service version.