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

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.

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

rpm -Uvh http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm

yum -y install git curl bash

sudo cat >/etc/yum.repos.d/RightScale-epel.repo<<-EOF
[rightscale-epel]
name=RightScale Software
baseurl=http://cf-mirror.rightscale.com/rightscale_software/epel/6/x86_64/archive/latest/
gpgcheck=1
enabled=1
gpgkey=http://s3.amazonaws.com/rightscale_key_pub/rightscale_key.pub
EOF

yum install rightimage-extras -y

#!/bin/bash
arch=x86_64
rpms=$(curl -s http://mirror.rightscale.com/rightscale_rightlink/latest/centos/ | 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 http://mirror.rightscale.com/rightscale_rightlink/latest/centos/"$rpm" || echo 'RightLink installation failed!'

rpm -iv http://mirror.rightscale.com/rightscale_rightlink/latest/centos/rightscale_5.8.8-centos_5.8-x86_64.rpm

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:

http://aws.amazon.com/developertools/368

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:

#!/bin/bash
ephemeral0=/dev/"$(curl -s http://169.254.169.254/2009-04-04/meta-data/block-device-mapping/ephemeral0)"
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:

provides:rs_agent_type=right_link

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.