Note: Please go to docs.rightscale.com to access the current RightScale documentation set. Also, feel free to Chat with us!
Home > Guides > Dashboard Users Guide > Design > Account Library > Concepts > About Your Imports

About Your Imports

Table of Contents

Background

Prior to the November 2010 release of the Dashboard, tracking the lineage of RightScale components was limited.  The addition of the public MultiCloud Marketplace presented several challenges to tracking component lineages.  Starting in the November 2010 release the lineage tracking was improved, enabling easier updates for components.  In fact, checking for updates now includes matching against revisions in the public MultiCloud Marketplace, not just your local view.

Overview

RightScale components that have been imported from the MultiCloud Marketplace are shown here (Design > Account Library > Your Imports).  For each component (ServerTemplate, RightScript, MultiCloud Images and Macros) the Total imports and whether or not there are Updates available is displayed on the Overview tab.  Select the component tab or associated hyperlink to see detailed information about previously imported components.  The following information is displayed:

  • Name*
  • Publisher*
  • Imported At*
  • Revision
  • Revision Notes
  • Update Available
  • Update Revision Notes (not displayed by default)
  • Xref - Shows the number of Servers and/or Server Arrays.  If there are any, the entry is a hyperlink to the Design > ServerTemplates > Xref tab (which shows Server and Server Array information)
  • Actions - If updates are available, you can click the Import or Diff action links to either import the newer version or get a full description of the differences between your current version and the upgraded version.

*  Macros do not support versions, hence only these fields can be displayed.

You can filter the results either by the Name or Publisher.  Checking the 'show imports with updates' will display only the RightScale components that have updates available.  Available updates are indicated with a yellow sphere.   Hover over the yellow sphere for a summary of update information, including the Revision Notes.

The Your Imports Overview tab typically looks similar to the following:

screen-YourImports.png

ServerTemplates, RightScripts and MultiCloud Images

These three RightScale components are treated precisely the same.  The same look, feel and functionality from the UI exists for each component.  A typical page looks like the following.  (Note:  The Xref tab for ServerTemplates reveals Servers and Arrays.  The Xref tab for RightScripts and MCIs lists ServerTemplates.)

 screen-YourImportsSTexample.png

Notice the following salient points:

  • A ServerTemplate is shown (but RightScripts and MCIs look and behave the same)
  • There is ONE line item per local or imported component.  Only the latest revision is displayed.
  • Only components that have updates available are shown (because the "Show imports with updates" checkbox that is selected)
  • Click the Diff action link to see the differences between your current version and the latest version you can upgrade to
  • Click the Import action link to import the newer revision
  • Hover over the yellow sphere to get additional upgrade notes.  (Revision, Revision Notes and when it was published.)

Other Scenarios

By far the most prevalent scenario is shown above.  You have imported a component, and at some point that component was updated by the original publisher, and hence Your Imports reports on what components can be upgraded.  There are a few scenarios or edge cases you should be familiar with however.

Once published (not) always published -   It could be the case that an available upgrade, as indicated by a yellow sphere, disappears.  What likely transpired were steps similar to the following:

  • You import a component from the public MultiCloud Marketplace
  • You use it for a day, a week, a  month or some period of time
  • A newer revision is published.  You notice the yellow sphere.
  • Prior to you importing the upgraded revision, the yellow sphere disappears.
  • The publisher realizes they meant to publish privately (to an Account Group) instead of publicly.  They effectively retracted the publication before you imported the newer revision.  (This is likely a fairly rare scenario, but would explain the mystery of the disappearing yellow ball. ;-)  Note: Once you have imported something from the MultiCloud Marketplace, it cannot be taken back from you.  In other words, even in this scenario, you could still use the originally published revision of the component.

Other Dashboard Locations for Upgrades

The upgrade functionality as indicated by the yellow sphere works elsewhere in the Dashboard as well.  For example, consider the following:

  • Navigate to a HEAD revision of a ServerTemplate (Design > ServerTemplates)
  • Select the ServerTemplate
  • Select either the Images or Scripts tab
    • If there is a newer revision of either the MCIs or RightScripts, you will see the yellow sphere indicating that upgrades are available.  For example, a RightScript with upgrades will look like:

screen-YourImportsScriptsTabExample.png

  • If you hover over the yellow sphere, you will see a message similar to the following:

Revision 3 is now available in the MultiCloud Marketplace; click to display diff.

 

One last subtle point: Published revisions in the MultiCloud Marketplace take precedence in the upgrade messaging.  For example, consider the following scenario:

  1. You import 'revision 1' of a RightScale component.
  2. You clone, modify and publish a newer 'revision 2'.  You share this privately with others in an Account Group.
  3. Others use 'revision 2' for some time. In the mean time, you publish a newer 'revision 3' and share it privately as well.
  4. Others will see the yellow sphere indicating upgrades are available.  Hovering over the sphere will indicate the updates are local, not in the MultiCloud Marketplace.
  5. Lastly, the original publisher of the component publishes a newer revision.
    1. You will still have a yellow sphere indicator
    2. Hovering over the sphere will comment that the public marketplace has upgrades available (not the local share).  Both are tracked, and can even be edited, but the messaging gives precedence to upgrades in the public marketplace.

Macros

Because Macros do not support versioning, you can only see the total of how many have been imported. There are no potential upgrades, hence the yellow sphere indicating "upgrades are available" does not apply.

 

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

Tags

Classifications

This page has no classifications.

Announcements

None


© 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.