Quick Reference

Item Description
Change Log https://rightlink.rightscale.com/rll/10.0.3/CHANGES.md
Linux Base ServerTemplate https://www.rightscale.com/library/server_templates/RightLink-10-0-3-Linux-Base/lineage/53250
Github repo for Base ServerTemplate https://github.com/rightscale/rightlink_scripts/tree/10.0.3
Enable-running Script: https://rightlink.rightscale.com/rll/10.0.3/rightlink.enable.sh
Set-up: import ST, launch raw instance, copy key from 'settings>API credentials', SSH into raw instance
Run command:
curl -s https://rightlink.rightscale.com/rll/10.0.3/rightlink.enable.sh | bash -s -- -l -k <your-key> -d <deployment-name> -n my server -t RightLink 10.0.3 Linux Base -a us-3.rightscale.com -c <cloud_type>
Known Limitations Decommission scripts are terminated after a second or two instead of waiting up to 180 seconds due to errors in init system scripts. Upstart, systemd, and sysvinit are affected. A RightScript to hotfix these issues is available at https://us-4.rightscale.com/library/right_scripts/RightLink-10-0-3-fix-decommiss/lineage/53363. This issue will be fixed in 10.0.5.

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/start the enabled instance, create the 'rightscale' user and support managed login, install the RightLink init scripts, and install monitoring (collectd v4).

OS Clouds Images Image provenance
Ubuntu 14.04 AWS US-Oregon ami-3b14370b

Official Ubuntu image locator
Softlayer 25GB - Ubuntu / Ubuntu / 14.04-64 Minimal for VSI (226478) Softlayer public image
VMware (using RCA-V)   custom image
Ubuntu 12.04 AWS US-Oregon ami-fd7959cd

Official Ubuntu image locator
Softlayer 25GB - Ubuntu / Ubuntu / 12.04-64 Minimal for VSI (202346) Softlayer public image
VMware (using RCA-V)   custom image
CentOS 7 AWS US-Oregon ami-c7d092f7 http://wiki.centos.org/Cloud/AWS
Softlayer 25GB - CentOS / CentOS / 7.0-64 Minimal for VSI (387060) Softlayer public image
VMware (using RCA-V)   custom image
CentOS 6 AWS US-Oregon ami-81d092b1 http://wiki.centos.org/Cloud/AWS
Softlayer 25G CentOS 6 64-bit (10609) Softlayer public image
VMware (using RCA-V)   custom image

How-To

Quick Test

  • From the marketplace import the [RightLink 10.0.3 Linux Base ServerTemplate[(https://www.rightscale.com/library/server_templates/RightLink-10-0-3-Linux-Base/lineage/53250) 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.0.3/rightlink.boot.sh

  • AWS, Softlayer, and RCA-V (vSphere) have been tested; YMMV on other clouds

  • For GCE the tags and script differ slightly due to some problems with multi-part MIME user-data, which we expect to resolve soon, 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 works for Ubuntu 14.04, Ubuntu 12.04, CentOS 7, CentOS 6.6, RHEL 6.5 and will strand for most other distros due to the lack of a functioning collectd.4.10 rpm

  • 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!