Note: Please go to to access the current RightScale documentation set. Also, feel free to Chat with us!
Home > Guides > Dashboard Users Guide > Design > ServerTemplates > Actions > Update the revision of a MultiCloud Image in a ServerTemplate

Update the revision of a MultiCloud Image in a ServerTemplate


  • 'designer' user role privileges


If you are modifying a ServerTemplate, you may want to update its list of MultiCloud Images. There are two main reasons why you would update a ServerTemplate's MCIs.

  • Add new cloud support
  • Update the list of MCIs to use newer revisions

To help you know when a newer revision of a MultiCloud Image is available, orange notification balls are displayed. If a newer committed revision of an MCI is available within the RightScale account or in the MultiCloud Marketplace (MCM), a yellow-orange sphere icon will appear next to the MCI under the HEAD ServerTemplate's Images tab. 

It's your responsibility to determine whether or not you should update the highlighted MCIs.

Orange ball notifications are only displayed if a newer committed revision of an MCI (with the same lineage) is available. If an MCI is cloned, it's a new object with a different lineage. The diagram below demonstrates the most common user scenarios.


Navigate to one of your ServerTemplates

  • Design -> ServerTemplates -> [ServerTemplateName] -> Images tab
  • Go to the editable HEAD version of the ServerTemplate. If no HEAD version exists, you can clone it to create an editable copy.

Check for newer versions

Under the Images tab of a HEAD version of a ServerTemplate, you may see yellow sphere icons, which denote that a newer revision of an MCI is available. RightScale will check within your RightScale account for a newer revision as well as in the MultiCloud Marketplace. The yellow sphere icons are only designed to serve as a notification. If an MCI has a yellow sphere icon, it does not mean that you must update its revision. The spheres will only be displayed for HEAD versions of a ServerTemplate and not committed revisions because only HEAD versions are editable.


If you click on the icon, you will perform a differential (diff) between the current revision and the most recently committed revision that's available. Use the diff to compare the differences between the two revisions to determine whether or not you want to update the MCI to a different revision. In the example below, the differences between the revisions are highlighted for your convenience.


 Next, you will need to determine whether or not you want to update the current RightScript revision.

Update a MultiCloud Image revision within a ServerTemplate

Once you have performed a differential between the two RightScripts and determined that you want to update the revision of a RightScript revision, you can follow one of the upgrade procedures below.

  • If a newer revision of the MCI is available in the MultiCloud Marketplace and it was not previously imported, you will need to import it first before you can select the new revision. Click the icon-orangeball-v1.png icon and click the Import button. (Requires 'library' user role privileges)  Or you can go to the MCM and manually import the newer revision. (Design -> MultiCloud Marketplace -> MultiCloud Images)
  • If a newer revision of the MCI already exists locally within your RightScale account, you do not need to import it.

Next, click the "Select Revision" icon icon-Edit-v1.png.  The available revisions will be displayed in a drop-down menu. If the newer revision is not listed in the dropdown menu, you will need to import it from the MultiCloud Marketplace. Select the newer revision that you want to use.

Repeat the steps above to manually update another individual MCI.

The orange ball icon will automatically disappear if you update the ServerTemplate to use the latest committed revision of a MultiCloud Image.

Test the ServerTemplate

If you make any changes to a ServerTemplate's list of MultiCloud Images, you should test the new images in their respective clouds. A user should be able to successfully launch a server with any of the MCI's images.

Publish the ServerTemplate

Once you have tested the ServerTemplate with the new MCIs, you may want to publish it to the MultiCloud Marketplace so that you can share it with other users.

See also



You must to post a comment.
Last modified
22:39, 16 May 2013


This page has no custom tags.


This page has no classifications.



© 2006-2014 RightScale, Inc. All rights reserved.
RightScale is a registered trademark of RightScale, Inc. All other products and services may be trademarks or servicemarks of their respective owners.