In addition to upgrading a single application instance, the provider can upgrade all instances at a time thus applying patches and any other urgent updates. This is possible through scheduling updates for a specific set of instances.
Before you start bulk upgrade, take the following into consideration:
- To avoid or easier localize any possible problems, start with upgrading a single instance prior to upgrading multiple (see the Operations Provider's guide >> Managing Accounts > Operating Resellers and Customers > Managing Subscriptions > Upgrading Subscription section).
- To estimate the total time of bulk upgrade, use the service template with the least number of resources.
To perform a bulk upgrade of multiple application instances, perform the following steps.
- Go to Services > Applications.
- In the APS Connectors tab, click the application you wish to upgrade. Make sure a newer version of the application is imported and enabled.
- Click Upgrade Instances button below. The next page will prompt you to select the upgrade type:
- All instances: this option allows to upgrade all instances of the application.
- Upgrade by Service Template: this option allows you to upgrade instances from subscriptions of particular service templates only. Select the type of upgrade and click Next button to proceed. If you chose to upgrade all instances, you will skip to step 5. If you wish to upgrade the application in selected service templates only, you will see the list of those templates on the next page.
If Upgrade by Service Template was selected above, the next page will list all instances available for upgrade. Otherwise, this page will be skipped.
- Check service templates where you wish the application to be upgraded and click Next to proceed to the summary page.
- Review the upgrade settings and click Finish to confirm.
The Upgrade Instances button will change to Cancel Pending Upgrades. This button is displayed until the application is upgraded on all instances.
Monitoring Upgrades Status
Once the upgrade has been started, the upgrade status may be monitored on the Instances tab of the application. Each instance may display with either of the following statuses in Updates field.
- When the instance is upgraded successfully, Updates value will become empty.
- Scheduled: upgrade for this instance is scheduled but has not been started yet.
- Pending: the instance upgrade is in progress.
- Failed: errors occurred during upgrade, the instance has not been upgraded.
- If the upgrade ends with Failed status, there are two possible solutions:
- Click the instance where the upgrade has been failed and check the Updates value for the reason of the failure.
- If there is a task failed during the upgrade, the task has to be canceled. When a new fixed version is imported, the upgrade has to be restarted.
Bulk Add-on Upgrades
Once an application is upgraded, all add-ons compatible with the newer application version are updated automatically, assuming they had been previously imported.
Cancellation of Bulk Upgrades
While the bulk upgrade is in process, you can cancel it for those instances which have not yet been upgraded. To see a list of instances being upgraded, go to the Instances tab of the application. Those pending are displayed with Pending or Scheduled scheduled status in the Updates column (see Monitoring Upgrades Status above). When the upgrade is complete, the Cancel pending upgrades button is not displayed on the General tab. The only way to revert upgraded instances in this case is disabling the version or deactivating the service template. Note also that you may not cancel upgrade of the instances where upgrade has been failed.
To cancel an upgrade with Pending status, perform the following steps.
- Go to Services > Applications.
- In the APS Connectors tab, click the application which is being upgraded. If the upgrade has not yet been finished, you will see Cancel pending upgrades button below. Click it to proceed.
- The upgrade process will stop. CloudBlue Commerce stops creating upgrade tasks for all application instances.
It's impossible to cancel upgrades for instances in Scheduled status at once. To do it, you need to cancel upgrade for each application instance individually. To locate such tasks, go to the Tasks menu and filter instances by "upgrade" or application ID.