Note: Please go to to access the current RightScale documentation set. Also, feel free to Chat with us!
Home > Guides > RightScale Cloud Appliance for vSphere (RCA-V): Installation Guide > Prepare the vSphere environment for RightScale Connectivity

Prepare the vSphere environment for RightScale Connectivity

Table of Contents


To prepare an existing vSphere environment so that a RightScale Cloud Appliance for vSphere (RCA-V) can be successfully deployed.


  • Access to log in to the vSphere Client
  • Ability to create new user roles 


Note: If you do not have access to make the changes outlined below, contact your vSphere network administrator.

vSphere Requirements

  • vSphere Requirements: vSphere 5.1 or 5.5 Enterprise or Enterprise Plus Edition. vSphere Standard Edition is not supported at this time.  Note: The vSphere environment must be enabled for Distributed Resource Scheduling (DRS) and Datastores placed under Storage DRS.  
  • ESXi hosts must have NTP time sync enabled. Verify that the NTP client for the hypervisor is enabled, using the vSphere Web client,  Host->Manage->Settings->Time Configuration. 
  • vCenter Server Requirements: ​ vCenter 5.1 or 5.5 Standard or Foundation edition

vCenter Access Requirements

Although RightScale does not require admin access to vCenter server, please create a role that contains the minimum set of privileges required by the RightScale platform as described below.

Create a RightScale Role

  1. The first step is to create a new Role. Open the vSphere Client application and go to View > Administration > Roles.
  2. Click Add Role and name it accordingly. (e.g. RightScaleRole
  3. Make sure the role has the following privileges (at a minimum):
  • Datastore: All
  • Datastore Cluster
  • Folder: Create, Delete
  • Global: Cancel task
  • Host > Local operations: Create virtual machine, Delete virtual machine, Reconfigure virtual machine
  • (vSphere 5.5 only) Profile-driven storage: Profile-driven storage view
  • Network: Assign network
  • Resource: Apply recommendation, Assign virtual machine to resource pool, Create resource pool, Modify resource pool, Move resource pool, Remove resource pool
  • vApp: Import
  • Virtual machine: All

Create a Non-Admin User 

The next step is to create a new user profile that the RightScale platform will use to log in and access the vSphere environment.

  1. Open the system's Control Panel and go to User Accounts. Click Add or remove user accounts.
  2. Click Create a new account. Provide a descriptive name (e.g. RS-User), select the "Standard" user option, and click Create Account.
    Note: The user does not require 'Administrator' privileges. 
  3. Set a valid password for the user.
  4. icon_Save_v1.png  The RightScale platform will use this new user profile to access the vSphere environment. Save the username and password in a safe place and provide this login information to the person who is going to Download, Deploy, and Configure the RightScale Cloud Appliance for vSphere (RCA-V).

Assign Permissions for RightScale to the vSphere Infrastructure

Assign the new user (e.g. RS-User) the role that you created in the previous step (e.g. RightScaleRole). It's important to add the user at the vCenter level so that it can have the same permissions throughout the object hierarchy as well as have access to various services. From that point on, you can always restrict the "RightScale" user to a specific cluster, you can go down to that specific cluster and add permission for this user.​

  1. Go to Home. Right-click on the Datacenter icon and go to Add Permission.
  2. Click Add, select the new user (e.g.  RS-User), and click Add. Click OK.
  3. Assign the user the role that you created for the RightScale platform. (e.g. RightScaleRole)  Make sure the "Propagate to Child Objects" option is checked so that the user will have the same permissions to all underlying objects. Click OK.


Note: Make sure that RS-User has permission to access  vSwitches and dvSwitches objects.

  1. screen-Assign_Permissions-v1.png

Hardware Requirements

The requirements below are specific to deploy the RightScale Cloud Appliance (RCA-V) in the vSphere environment.

  • Requirements: Single-core 1GB VM with 10GB of disk space (plus overhead); in the future multiple VMs are recommended for fault tolerance.​
  • (Optional): An additional NAT / DHCP appliance, which requires a single-core 1GB VM with 10GB of disk space. However, if you already have existing NAT and DHCP mechanisms, you may not need to deploy this additional instance.

Connectivity Requirements

Update your firewall permissions accordingly to allow egress connectivity between the RCA-V and RightScale.

Important!  There are no inbound connectivity requirements. (RightScale to RCA-V)


RCA-V to RightScale



  • Egress (Outbound) access from RCA-V to RightScale:
    • Secure web socket tunnel between RCA-V and RightScale

    • RightScale Mirrors which contain required software installation packages (e.g. Ubuntu, rubygem, RCA-V appliance upgrades, etc.) Once the setup is complete, this firewall permission can be removed. 

    • (Optional) Access to DNS servers and

    • (Optional) Access to


VMs to RightScale

Each instance launched via the RightScale Dashboard/API must be allowed to make the following egress (outbound) connections to the RightScale platform in order for all instance-level services to be supported.

Note: NTP and DNS can also be provided locally. If true, you do not have to create firewall rules for NTP or DNS.

  • Each instance launched through RightScale must synchronize with the global time standard (e.g. through NTP or through other means). If the instance clock drifts by more than two minutes, certain operations will start to fail.

Please refer to the firewall rules page here.  Also note that only the Egress Rules section applies to vSphere environments. 




RCA-V to vCenter Server

RCA-V communicates with vCenter Server over SSL connection.  If there is a firewall between RCA-V and the vCenter Server, please setup the rules such that RCA-V is able to make a connection to vCenter Server's IP address on port 443.

Next Steps

You are now ready to install the RightScale Cloud Appliance (RCA-V) in your vSphere environment. The person who is installing the RCA-V can now follow the next section of the installation guide.

Important! Be sure to give the following information to the person who will be installing and configuring the RCA-V. 

The "RightScale User" login information (from the Create a Non-Admin User step).

  • username: __________________
  • password: __________________


Please proceed to the next step in the setup guide.

You must to post a comment.
Last modified
10:39, 18 Feb 2015


This page has no custom tags.


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.