Overview

In order to use RightLink 10 on clouds that are not supported by cloud-init, you will need to use the RightScale-provided cloud-init package. See the supported clouds list below to determine if you need the RightScale-provided cloud-init package to support your desired cloud. RightScale cloud-init differs from the stock cloud-init by adding a plugin for the SoftLayer cloud. RightScale cloud-init will always have RightScale as the package Vendor/Maintainer and rightscale in the release name.

Cloud Cloud-init Type
EC2, Azure, Google[2], OpenStack, RackSpace, RCA-V[1], CloudStack Vanilla
Softlayer[3] RightScale

[1] Requires RCA-V version 2.0_20160415_21 or above
[2] CentOS 6.x on GCE has a specific note below
[3] Ubuntu 14.04 and Ubuntu 16.04 work with vanilla Cloud-init and cloud images comes with them pre-installed. CentOS/RHEL and older Ubuntu versions do not.

Installing Vanilla Cloud-Init

The installation steps for 'vanilla' cloud-init will vary depending on your operating system. The following sections provide instructions specific to each of the supported operating systems.

Red Hat Based Systems, Such as CentOS

Depending on the specific version of your system, cloud-init may be part of the Extras repo. If not, the packages may be found in the Fedora Extra Packages for Enterprise Linux repository. Use the following command-line to install cloud-init on Red Hat-based systems.

  yum -y install cloud-init
  rpm -Uvh cloud-init-0.7.5-2.el6.src.rpm
  sed -i.orig -e 's/2%{?dist}/20%{?dist}/g' ~/rpmbuild/SPECS/cloud-init.spec
  rpmbuild -ba ~/rpmbuild/SPECS/cloud-init.spec
  rpm -Uvh ~/rpmbuild/RPMS/x86_64/cloud-init-0.7.5-20.el6.x86_64.rpm
  rm -fr ~/rpmbuild

Debian Based systems, Such as Ubuntu

Use the following command-line to install cloud-init on Debian-based systems.

  apt-get -y update
  apt-get -y install cloud-init

CloudStack

Cloud-init versions shipping with major OS versions (Ubuntu 12.04+, CentOS/RHEL 6+) support CloudStack, but need a little bit of additional configuration. For Ubuntu 12.04, the CloudStack datasource exists but is not configured to run by default and is not selectable by dpkg-reconfigure. For Ubuntu 14.04+, CentOS/RHEL 6+, the CloudStack plugin is there but runs after the EC2 plugin by default, which has a 2 minute timeout. To avoid a 2 minute delay at bootup, only the CloudStack datasource should be used. dpkg-reconfigure populates /etc/cloud/cloud.cfg.d/90_dpkg.cfg on Ubuntu systems. Create a bit of cloud-configuration to override the datasource list after that:

echo "datasource_list: [ CloudStack ]"  | sudo tee /etc/cloud/cloud.cfg.d/91_cloudstack.cfg

Installing RightScale Cloud-Init (Softlayer)

The installation steps for RightScale cloud-init will vary depending on your operating system. The following sections provide instructions specific to each of the supported operating systems.

CentOS 6.x/7.x

  cat <<EOF > /etc/yum.repos.d/RightScale-epel.repo
  [rightscale-epel]
  name=RightScale Software
  baseurl=http://mirror.rightscale.com/rightscale_software/centos/\$releasever/x86_64/archive/latest/
  enabled=1
  gpgcheck=1
  gpgkey=http://mirror.rightscale.com/rightlink/rightscale.pub
  priority=1
  EOF
  yum -y install cloud-init

Ubuntu 12.04

Ubuntu 12.04 Cloud-Init Install - Part 1

  cat <<EOF > /etc/apt/preferences.d/rightscale-cloud-init-pin-1001
  Package: cloud-init
  Pin: version 0.7.2*
  Pin-Priority: 1001
  EOF

Ubuntu 12.04 Cloud-Init Install - Part 2

  curl http://mirror.rightscale.com/rightlink/rightscale.pub | apt-key add -
  echo "deb [arch=amd64] http://mirror.rightscale.com/rightscale_software_ubuntu/latest precise main" > /etc/apt/sources.list.d/rightscale_extra.sources.list
  apt-get -y update
  apt-get -y --force-yes install cloud-init

For Ubuntu 14.04 and 16.04, please use vanilla cloud-init. Use the stock Ubuntu images provided by Canonical, which come with cloud-init pre-installed, as a reference.