Citrix Systems 4.2 Server User Manual


 
Chapter 15.
177
Amazon Web Service Interface
15.1. Amazon Web Services EC2 Compatible Interface
CloudPlatform can translate Amazon Web Services (AWS) API calls to native CloudPlatform API calls
so that users can continue using existing AWS-compatible tools. This translation service runs as a
separate web application in the same tomcat server as the management server of CloudPlatform,
listening on the same port. This Amazon EC2-compatible API is accessible through a SOAP web
service and the AWS Query API. The AWS Java SDK and AWS PHP SDK are both supported by the
Query API.
Limitations:
Supported only in zones that use basic networking.
Available in fresh installations of CloudPlatform 3.0.3 and newer. Not available through upgrade of
previous versions.
If you need to support features such as elastic IP, set up a Citrix NetScaler to provide this service.
The commands such as ec2-associate-address will not work without EIP setup. Users running VMs
in this zone will be using the NetScaler-enabled network offering (DefaultSharedNetscalerEIP and
ELBNetworkOffering).
15.2. System Requirements
This interface complies with Amazon's WDSL version dated August 15, 2012, available at http://
ec2.amazonaws.com/doc/2012-08-15/.
Compatible with the EC2 command-line tools EC2 tools v. 1.6.2.0, which can be downloaded at
http://s3.amazonaws.com/ec2-downloads/ec2-api-tools-1.6.2.0.zip.
15.3. Enabling the AWS API Compatible Interface
The software that provides AWS API compatibility is installed along with CloudPlatform. However, you
must enable the feature and perform some setup steps.
1. Set the global configuration parameter enable.ec2.api to true. See Section 5.5, “Setting
Configuration Parameters”.
2. Create a set of CloudPlatform service offerings with names that match the Amazon service
offerings. You can do this through the CloudPlatform UI as described in the Administration Guide.
Warning
Be sure you have included the Amazon default service offering, m1.small.
3. If you did not already do so when you set the configuration parameter in step 1, restart the
Management Server.
# service cloudstack-management restart