Note: Please go to to access the current RightScale documentation set. Also, feel free to Chat with us!
Home > Guides > Dashboard Users Guide > Clouds > AWS Regions > VPCs > Actions > VPN Connection Description

VPN Connection Description


Due to RightScale Legacy Platform deprecation, this section covering Amazon Web Services Virtual Private Clouds (VPC) is no longer valid. Please see the Network Manager section for current information on creating and managing AWS VPCs.


Use the AWS VPC query API to describe your VPN connections.  This is the one step you need to complete using the API or command line tools to obtain key information and complete the entire VPC setup.  Everything else can be done entirely from within the RightScale Dashboard.


  • All other VPC configuration steps should be completed.  (VPC and subnet creation, DHCP options, etc.)  This is the last step in the entire process.


After configuring the VPC through the RightScale Dashboard you will need to issue the API command shown in Step #1 below using the latest version of the Amazon EC2 API Tools in order to get the networking information to connect your company network to the VPC.

Depending on your specific router, you will need to change the "-format" option to the API query shown below.  The following routers and their associated operating systems are currently supported:

  • Cisco
  • Juniper
  • Generic Device


Step 1:  Run the ec2-describe-vpn-connection command

Run the following API command from any Server already running in the cloud.  For example, a LAMP Server that was launched from the same account you configured your VPC from. From such a Server all of your AWS credentials are already known to AWS.   Note the Server can be from a standard Deployment, it does not need to be an Instance running in a subnet of your VPC.  The output will be saved in a temporary text file (output.txt).

Cisco example:
ec2-describe-vpn-connections --format cisco-ios-isr > output.txt

Example Cisco device

Juniper example:
ec2-describe-vpn-connections --format juniper-junos-j > output.txt

Example Juniper device


Generic example:
ec2-describe-vpn-connections --format generic > output.txt

Example generic device

Step 2:  Configure your Customer Gateway device

Use the information captured in the output.txt file to configure your Customer Gateway device. Of course, the individual procedure varies depending on the manufacturer of your device (such as Cisco or Juniper).

You must to post a comment.
Last modified
12:12, 3 Nov 2014



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.