This page describes how RightLink 10 checks for and performs in-place upgrades of itself.
RightLink 10 comes with a variety of tools to assist in upgrading the agent on a running machine. The recommended approach is to use an
upgrades file which contains approved upgrade paths and, using the provided scripts, configure RL 10 to periodically consult that file and automatically upgrade. You can maintain your own
upgrades file so that you can ensure your applications will continue to work with new versions, or you can use the default RightScale
upgrades file which contains RightScaled-tested upgrade paths. You can also run a command on a machine to upgrade RL 10 to a specific binary already on the machine.
RightLink 10 upgrades can be performed using the provided scripts or manually.
Using the upgrades file and scripts
The recommended approach for upgrading RightLink 10 is to use the RightScale-provided upgrade script (Linux, Windows). Additionally, RightScale provides a
setup-automatic-upgrade script (Linux, Windows) that will create the needed cron entry/scheduled job to periodically run the upgrade script mentioned previously.
upgrade script takes an input
UPGRADE_VERSION which is a version to upgrade (or downgrade) to, such as
setup-automatic-upgrade script takes an input
UPGRADES_FILE_LOCATION which is the URL of an
upgrades file. This file can be the default file provided by RightScale, or a custom file.
RightScale-tested upgrades file
As of today, we have not yet built the automation to test upgrade paths of the RL10 agent, so the RightScale-provided
upgrades file (located here) will not provide any upgrade paths. In the future, we plan on building such automation and maintaining that file for backwards-compatible upgrades. Details on the
upgrades file are below.
Custom upgrades file
It is recommended that you maintain your own
upgrades file so that you can ensure that an upgrade doesn't affect your machines and your application. The file should be placed somewhere that all of your instances can access (we recommend an S3 bucket). When a new version of RL10 is released, this gives your team the opportunity to test it, test the upgrade with whatever version you're currently using, and then update the file if the upgrade is successful. Details on the
upgrades file are below.
Upgrades file syntax
upgrades file lists each allowed upgrade path, in the form
<running_version>:<desired_version>. For example:
running_version can only be listed once in the file, or upgrades from that version will fail to start.
When the upgrade script is run, either manually or automatically, RightLink 10 will look through the file, locating the single match for its current version. If it finds the current version, it will use the
desired_version string to construct the URL to the target binary using the official RightScale RightLink 10 download path (
# RightScale Rightlink10 Self-Upgrade Manifest # Each line has the form <current_version>:<desired_version> 10.3.1:10.6.0 10.4.0:10.6.0 10.5.0:10.6.0
Reverting an Upgrade
If you want to revert an upgrade, it is recommended you re-run the
upgrade script with
UPGRADE_VERSION set to the old version of RightLink. Note that the
UPGRADE_VERSION input was added recently, so please make sure the latest version of the upgrade script for Linux and Windows is imported from the MultiCloud Marketplace and run as an
Certain RightLink versions may have key breaking changes. The following is summary of major ones:
- 10.6.0 - The script revision will now be printed in the summary.
- 10.5.0 - Managed login changed to Enhanced Managed Login. Instead of logging in as the
rightscaleuser, users now login under their individual usernames. In addition, managed login was changed from an automatic feature to an optional feature. The
RL10 Linux Enable Managed LoginRightScript was added to the 10.5.0 Linux Base ServerTemplate to enable this optional feature. To always enable this feature, this RightScript will have to run and be added to the boot scripts of an upgraded server. Note you can change the revision for all servers attached to a ServerTemplate or for individual servers.
- 10.2.1 -
rightlinkservice changed from root to
rightlinkuser. Upgrade of previous versions to this version or later not supported.
Please refer to the release changelogs for for relevant bug fixes.
- 10.2.1 - When upgrading from 10.2.1 monitoring graphs will disappear if the upgrade script is run. Re-run the 'Enable Monitoring' script to re-enable monitoring.