Installation on existing OpenStack deployment

Installation on existing OpenStack deployment

This section describes how to install and configure the ec2-api service for Ubuntu (LTS).

Install and configure components

Install the packages:

# apt-get update
# git clone https://github.com/openstack/ec2-api.git
# cd ec2-api

Run install.sh

The EC2 API service gets installed on port 8788 by default. It can be changed before the installation in install.sh script.

The services afterwards can be started as binaries:

/usr/local/bin/ec2-api
/usr/local/bin/ec2-api-metadata

or set up as Linux services.

Create the ec2api service API endpoints:

$ openstack endpoint create --region RegionOne ec2api \
  public http://controller:XXXX/
$ openstack endpoint create --region RegionOne ec2api \
  admin http://controller:XXXX/
$ openstack endpoint create --region RegionOne ec2api \
  internal http://controller:XXXX/
  • where ‘controller’ is address of controller,
  • and ‘XXXX’ is port your ec2api is installed on (8788 by default)

Configuring OpenStack for EC2 API metadata service

To configure OpenStack for EC2 API metadata service:

for Nova-network add:

# [DEFAULT]
# metadata_port = 8789
# [neutron]
# service_metadata_proxy = True

to /etc/nova.conf

then restart nova-metadata (can be run as part of nova-api service) and nova-network services.

for Neutron add:

# [DEFAULT]
# nova_metadata_port = 8789

to /etc/neutron/metadata_agent.ini

then restart neutron-metadata service.

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.