Introduction
To install RightLink at boot an agent to interpret userdata or metadata and act on it as needed. Two things are passed to this agent as a executable Powershell block:
- Credentials (identity parameters) needed to initialize a RightScale Server via user-data.
- Code to download and install RightLink at boot time if its not already installed.
Each cloud has its own agent. EC2, AzureRM, and Google agents are currently supported. The following methods are used for each cloud:
- EC2 - Ec2ConfigService leveraged to act on userdata with <powershell> tags
- Google - Startup script set by using metadata key windows-startup-script-ps1
- AzureRM - CustomScriptExtension is added to run the script
Other clouds are currently not supported at this time for install at boot. Please create a custom image for other clouds.
Launching a Server with a Stock Image
Two tags are needed to install RightLink 10 at boot. The first identifies the instance as RightLink10 based to the RightScale platform. The second causes cloud agents to run a Powershell script to download and install RightLink. The MultiCloudImage (MCI) or Server must be tagged with:
rs_agent:type=right_link_lite
rs_agent:powershell_url=https://rightlink.rightscale.com/rll/10.6.0/rightlink.boot.ps1
The second tag above will install version 10.6.0 of RightLink. As a convenience, more generic versions such as 10
or 10.6
may be specified as a way to install the latest GA version for a lineage. For example, add tag rs_agent:powershell_url=https://rightlink.rightscale.com/rll/10/rightlink.boot.ps1
to install the latest 10.x.x agent. See the releases page for full list of supported versions to install and release notes.
Since the script/agent are being downloaded and installed at boot time, there must be outbound connectivity to the rightlink.rightscale.com IP addresses. If there is no outbound connectivity for the instance a proxy should be specified using the rs_agent:http_proxy
tag.
It it recommended to use the RightLink 10.x.x Windows Base
ServerTemplate available from the Marketplace as a starting point. See the releases page for links.
Advanced Usage
See Advanced Usage for Linux.