Note: Please go to to access the current RightScale documentation set. Also, feel free to Chat with us!
Home > Guides > RightLink 6 > RightLink Legacy Versions > RightLink 5.8 and Lower > Create RightScale-Enabled Images with RightLink 5.8 and lower > RightLink 5.8 Installer for Oracle Enterprise Linux (OEL) (alpha)

RightLink 5.8 Installer for Oracle Enterprise Linux (OEL) (alpha)


Boot a non-RightScale enabled OEL instance, perform some manual configuration, install the RightLink package, and re-bundle the instance into a new, RightScale-enabled AMI. Optionally, test compatibility before bundling, and create an MCI (MultiCloud Image) for your new image.


  1. Do not forget to tag the MultiCloud Image! Any MCI that points to custom images that have RightLink installed must be tagged appropriately to successfully operate with the RightScale management platform; see the last step in this article for more information.
  2. These instructions apply only to RightLink v5.6 and above. RightLink packages prior to v5.6 do not install clean under OEL and required extensive changes.


NOTE: Although the steps provided below for bundling an instance may still be valid in some scenarios, we encourage you to explore using the the Instance Provisioner for bundling and RightLink-enabling an existing instance. See Create New Instance with the Instance Provisioner for additional information.


Currently, RightScale does not officially support OEL.  However, you can install RightLink on an OEL instance by hand-editing some configuration files, then installing the CentOS package.


Launch an OEL Instance

OEL images are available publicly in the Amazon EC2 cloud. You may also have an OEL image in another public or private cloud that needs to be RightScale-enabled.

In the RightScale Dashboard, navigate to the appropriate cloud in the menu (e.g., Clouds > cloud name > Instances > New) and launch a new instance with the image you would like to RightLink-enable.

SSH into the Instance

Once the instance or server becomes operational, click on the SSH Console button in the RightScale Dashboard.

Note: All commands issued in an SSH console from this point forward assume you are using the 'root' user.

Set the Cloud Type

The following is only required for non-interactive installs. If /etc/rightscale.d/cloud is not set, the user is prompted to select the cloud interactively upon install of the rightscale package.
Run the following command to set the cloud type (example uses Amazon EC2):

# supported clouds: ec2,rackspace,vmops
mkdir -p /etc/rightscale.d && echo -n "$cloud" > /etc/rightscale.d/cloud

This file is used by the RightLink agent to recognize which cloud type the instance is running in.
For CloudStack use vmops.

Install EPEL Package

The Extra Packages for Enterprise Linux (EPEL) project provides thousands of prebuilt RPMs for supplemental packages that are built and maintained by the Fedora open-source community. The RightLink RPM depends on some of these packages as prerequisites and cannot be installed unless EPEL is available to satisfy the dependencies.

You can EPEL-enable your system by installing the EPEL repository package. The repository package configures your system's YUM or up2date system to use EPEL's repositories. You can then install packages with your usual method, and the EPEL repository will be included and used to satisfy any dependencies.

rpm -Uvh
Install Dependencies

Install the RPM package dependencies manually as needed:

yum -y install git curl bash

We also need to install the 'rightimage-extras' package, which is a meta package that lists other packages essential to ServerTemplate functionality. To install, configure a repository:

sudo cat >/etc/yum.repos.d/RightScale-epel.repo<<-EOF
name=RightScale Software

Then, install the package:

yum install rightimage-extras -y
Install RightLink

Browse RightScale's mirror ( for available RightLink packages. Although we recommend using the latest available RightLink package, it may not be available for your particular release.  The most recently published packages can be found in the "latest" RightLink packages directory.  If you do not find a suitable package in one of the "latest" directories, you can also browse for a different version from one of the archived directories. You must choose the distribution package that's most appropriate for your purposes, based upon your instance's operating system and CPU architecture (32-bit or 64-bit).

Install the appropriate RPM package. You can copy and paste the link from your browser if desired.

Latest Package

The following script downloads and installs the latest x86_64 CentOS RPM package from the mirror:

rpms=$(curl -s | perl -0ne 'print "$1\n" while (/<a\s*href\s*=\s*\"(.*?)\">.*?<\/a>/igs)' | grep .rpm | grep "$arch") && rpm=$(grep "$arch" <<<"$rpms") && \
echo Installing "$rpm". && rpm -iv"$rpm" || echo 'RightLink installation failed!'
Specific Package

Alternatively, install a specific version from the mirror (only recommended if a specific reason to not use the latest exists).
The following installs RightLink 5.8.8.

64-bit instance:

rpm -iv

Bundle the Instance

Your instance must have a working install of EC2 AMI Tools in the path of the root user for this procedure to succeed.  The installation of the EC2 AMI tools requires ruby.  To install ruby, run this command:

yum install ruby

After ruby has been installed, you can download the EC2 AMI tools from here:

Download the rpm to the instance.  Once the rpm is on the instance, run this command in the directory in which the rpm resides:

rpm -Uvh ec2-ami-tools.noarch.rpm

Note: The RightScale BundleWorker requires the SFTP subsystem to be enabled on your instance. This is disabled in many of the OEL images.

You can usually re-enable with:

sed -i s/#Subsystem/Subsystem/g /etc/ssh/sshd_config && service sshd restart

Also, ensure that the your instance has Rsync installed which is a requirement of the bundler worker:

yum -y install rsync

You may also need to mount an ephemeral disk to the instance if this is not included in the fstab of the OEL image being used (commonly the case).
To ensure the first ephemeral device is mounted to /mnt, use the following:

ephemeral0=/dev/"$(curl -s"
mkdir -pv /mnt; mount | grep "$ephemeral0" || mount "$ephemeral0" /mnt

Please note, t1.micro instances do not include ephemeral storage. You can still bundle on this instance type by using an attached EBS volume instead.

Before bundling, check that /mnt has enough free space for the bundle (at least 10GB):

df -h | grep /mnt

Now that these prerequisite steps have been performed, you are ready to create the AMI.  To create a new AMI from the running instance, click the Bundle button in the Dashboard.
Once the bundle worker has completed the task, view the audit entry and take note of the AWS ID that was used to register the new AMI.

Test the Bundled Image (optional)

To perform a compatibility test on the new private RightLink-enabled image that you just created, see Testing your Private RightLink-enabled Image.

Create a MultiCloud Image

In order to properly use the new RightScale-enabled image with ServerTemplates, you should create a MultiCloud Image (MCI) that references the new image.  See Create a New MultiCloud Image. The MCI can then be added to any local (HEAD) ServerTemplates in your account.   If you need to make that image available in a different AWS region, follow the Replicate an Image to different AWS regions

Tag the MultiCloud Image (mandatory)

Once you've created the MCI, you will need to add the following tag to the MCI so that RightScale will be able to identify the created image as a RightLink-enabled image:


Congratulations!  You now have an MCI that points to a RightLink-enabled image for launching OEL instances.  Just like any other instance that's launched using one of our v5 RightImages (which are RightLink-enabled), you will be able to see monitoring graphs and execute scripts inside the Dashboard.

You must to post a comment.
Last modified
10:11, 19 Feb 2015



This page has no classifications.



© 2006-2014 RightScale, Inc. All rights reserved.
RightScale is a registered trademark of RightScale, Inc. All other products and services may be trademarks or servicemarks of their respective owners.