10.1.3 Release

10.1.3 it is a point release for the last major GA release (10.1.2). This release includes:

1. Added /rll/proc/shutdown_kind to distinguish between stop and terminate during running of decommission scripts. For further reference see Local and Proxied HTTP Requests.
2. Bug fix: Set Host field correctly for API requests proxied through RightLink

Quick Reference

Item	Description
Change Log	https://rightlink.rightscale.com/rll/10.1.3/CHANGES.md
Linux Base ServerTemplate	https://www.rightscale.com/library/server_templates/RightLink-10/lineage/53250
Github repo for Base ServerTemplate	https://github.com/rightscale/rightlink_scripts/tree/10.1.3
Install-at-boot	Tag: rs_agent:mime_include_url=https://rightlink.rightscale.com/rll/10.1.3/rightlink.boot.sh To run: Import Linux Base ServerTemplate, create server from ST, pick desired MCI, launch
Enable-running	Script: https://rightlink.rightscale.com/rll/10.1.3/rightlink.enable.sh To run: Import Linux Base ServerTemplate, launch raw instance, copy key from 'settings>API credentials', SSH into raw instance Run command: curl -s https://rightlink.rightscale.com/rll/10.1.3/rightlink.enable.sh | bash -s -- -l -k <your-key> -d <deployment-name> -n my server -t RightLink 10.1.3 Linux Base -a us-3.rightscale.com -c <cloud_type>

RightScale tested images

The following images were tested by RightScale and known to work with this version of RightLink 10. This list is not intended as a recommendation of these images, it is simply intended as a reference so you can locate known-to-work images and compare with your own images if you are having difficulties.

Known to work means that the following features work: enable a running bare instance using the rightlink.enable.sh script, reboot the instance, stop and start the enabled instance, create the rightscale user and support managed login, install the Rightlink init scripts, and install monitoring (collectd).

Note: except for VMware the tests for this release use official images prepared by the OS vendor or the cloud vendor. In some cases this leads to failures due to problems with the specific images that can easily be overcome using a custom image.

How-To

Quick Test

• From the marketplace import the RightLink 10.1.3 Linux Base ServerTemplate published by RightScale Engineering.
• Create a Server from the ServerTemplate
• Select an appropriate MCI and launch, the ST should go operational, you should see an audit entry with the boot scripts, you should be able to SSH into the instance using your managed SSH key and you should be logged in as user 'rightscale' from which you can sudo

Adapting the Base ServerTemplate

• You can clone the base ST and insert a different MCI of your choice, the MCI needs to have the required RS_agent tags (see below)
• Alternatively, you can create you own ST using your own MCI

• Standard MCI tags (see RightLink 10: Cloud-init for additional tags):

  rs_agent:type=right_link_lite rs_agent:mime_include_url=https://rightlink.rightscale.com/rll/10.1.3/rightlink.boot.sh

• AWS, Softlayer, Openstack Juno, and RCA-V (vSphere) have been tested; Other images on other clouds with a functioning cloud-init should work, but YMMV (see above).

• For GCE, only Ubuntu images contain cloud-init. These images install and run RightLink, however managed login will not work due to the google manage_accounts.py daemon script running and resetting permissions on the ssh authorized_keys file. Other OSes on GCE may be bootstrapped with alternate GCE userdata and tags, contact RightScale for info.

• For CoreOS the tags and script also differ slightly due to limitations in CoreOS' cloud-init implementation, contact RightScale for info.

• The collectd monitoring script only works for Ubuntu and RHEL/CentOS/Compatible OSes and will strand for most other distros as there isn't code to install collectd for those alternate OSes. The monitoring script was verified with RHEL/CentOS 6 and 7 and Ubuntu 12.04 and 14.04 but should work on other versions as well.

RightLink 10 is Not Fully Compatible with RightLink6

• The environment variables available to RightScripts are different, and there are no RS_REBOOT or RS_OS_TYPE variables. Write idempotent scripts using the capabilities of the shell, such as testing for the presence of files. Dispatch based on the presence of tools or file system locations you need instead of a OS type variable.
• No rs_tag command, instead RightLink 10 can proxy API 1.5 requests and add authentication along the way
• No built-in Chef support
• RightScript log output is not sanitized to remove credential values! (Some of them are by the platform but this will change soon.) The sanitization has lots of problems, the only proper solution is for the script writer to ensure sensitive credentials are not output to stdout/stderr!
• For a full list of changes see Incompatibilities with RightLink 6