Clean up *most* ec2 / euca2ools references
The ec2 / euca2ools command references definitely don't work any more, this deletes most of them. The exception is the policy reference doc which is over a year out of date, and needs more then surgical removal of ec2 from it. Change-Id: I963170f99037d5ed085e8c676ab55750c7f6372e
This commit is contained in:
parent
54529f03c9
commit
7e693e9c5c
@ -186,52 +186,6 @@ in the OpenStack Configuration Reference.
|
|||||||
systems can be built within an OpenStack cluster, or provisioned outside of
|
systems can be built within an OpenStack cluster, or provisioned outside of
|
||||||
it, but OpenStack software does not provide these features.
|
it, but OpenStack software does not provide these features.
|
||||||
|
|
||||||
EC2 compatibility API
|
|
||||||
~~~~~~~~~~~~~~~~~~~~~
|
|
||||||
|
|
||||||
.. todo:: Does this need to be removed now?
|
|
||||||
|
|
||||||
In addition to the native compute API, OpenStack provides an EC2-compatible
|
|
||||||
API. This API allows EC2 legacy workflows built for EC2 to work with OpenStack.
|
|
||||||
|
|
||||||
.. warning::
|
|
||||||
|
|
||||||
Nova in tree EC2-compatible API is deprecated. The `ec2-api project
|
|
||||||
<https://git.openstack.org/cgit/openstack/ec2-api/>`_ is working to
|
|
||||||
implement the EC2 API.
|
|
||||||
|
|
||||||
You can use numerous third-party tools and language-specific SDKs to interact
|
|
||||||
with OpenStack clouds. You can use both native and compatibility APIs. Some of
|
|
||||||
the more popular third-party tools are:
|
|
||||||
|
|
||||||
Euca2ools
|
|
||||||
A popular open source command-line tool for interacting with the EC2 API.
|
|
||||||
This is convenient for multi-cloud environments where EC2 is the common API,
|
|
||||||
or for transitioning from EC2-based clouds to OpenStack. For more
|
|
||||||
information, see the `Eucalyptus Documentation
|
|
||||||
<http://docs.hpcloud.com/eucalyptus>`__.
|
|
||||||
|
|
||||||
Hybridfox
|
|
||||||
A Firefox browser add-on that provides a graphical interface to many popular
|
|
||||||
public and private cloud technologies, including OpenStack. For more
|
|
||||||
information, see the `hybridfox site
|
|
||||||
<http://code.google.com/p/hybridfox/>`__.
|
|
||||||
|
|
||||||
boto
|
|
||||||
Python library for interacting with Amazon Web Services. You can use this
|
|
||||||
library to access OpenStack through the EC2 compatibility API. For more
|
|
||||||
information, see the `boto project page on GitHub
|
|
||||||
<https://github.com/boto/boto>`__.
|
|
||||||
|
|
||||||
fog
|
|
||||||
A Ruby cloud services library. It provides methods to interact with a large
|
|
||||||
number of cloud and virtualization platforms, including OpenStack. For more
|
|
||||||
information, see the `fog site <https://rubygems.org/gems/fog>`__.
|
|
||||||
|
|
||||||
php-opencloud
|
|
||||||
A PHP SDK designed to work with most OpenStack-based cloud deployments, as
|
|
||||||
well as Rackspace public cloud. For more information, see the `php-opencloud
|
|
||||||
site <http://www.php-opencloud.com>`__.
|
|
||||||
|
|
||||||
Building blocks
|
Building blocks
|
||||||
~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~
|
||||||
|
@ -1,7 +0,0 @@
|
|||||||
=================================
|
|
||||||
Managing the cloud with euca2ools
|
|
||||||
=================================
|
|
||||||
|
|
||||||
The ``euca2ools`` command-line tool provides a command line interface to EC2
|
|
||||||
API calls. For more information, see the `Official Eucalyptus Documentation
|
|
||||||
<http://docs.hpcloud.com/eucalyptus/>`_.
|
|
@ -21,7 +21,6 @@ operating system, and exposes functionality over a web-based API.
|
|||||||
configuring-migrations.rst
|
configuring-migrations.rst
|
||||||
cpu-topologies.rst
|
cpu-topologies.rst
|
||||||
default-ports.rst
|
default-ports.rst
|
||||||
euca2ools.rst
|
|
||||||
evacuate.rst
|
evacuate.rst
|
||||||
flavors2.rst
|
flavors2.rst
|
||||||
flavors.rst
|
flavors.rst
|
||||||
|
@ -6,14 +6,12 @@ Manage the cloud
|
|||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
|
|
||||||
euca2ools.rst
|
|
||||||
common/nova-show-usage-statistics-for-hosts-instances.rst
|
common/nova-show-usage-statistics-for-hosts-instances.rst
|
||||||
|
|
||||||
System administrators can use the :command:`openstack` and :command:`euca2ools`
|
System administrators can use the :command:`openstack` to manage their clouds.
|
||||||
commands to manage their clouds.
|
|
||||||
|
|
||||||
The ``openstack`` client and ``euca2ools`` can be used by all users, though
|
The ``openstack`` client can be used by all users, though specific commands
|
||||||
specific commands might be restricted by the Identity service.
|
might be restricted by the Identity service.
|
||||||
|
|
||||||
**Managing the cloud with the openstack client**
|
**Managing the cloud with the openstack client**
|
||||||
|
|
||||||
|
@ -525,14 +525,12 @@ Enable ping and SSH on VMs
|
|||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
You need to enable ``ping`` and ``ssh`` on your VMs for network access. This
|
You need to enable ``ping`` and ``ssh`` on your VMs for network access. This
|
||||||
can be done with either the :command:`nova` or :command:`euca2ools` commands.
|
can be done with the :command:`openstack` command.
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
Run these commands as root only if the credentials used to interact with
|
Run these commands as root only if the credentials used to interact with
|
||||||
``nova-api`` are in ``/root/.bashrc``. If the EC2 credentials in the
|
``nova-api`` are in ``/root/.bashrc``.
|
||||||
``.bashrc`` file are for an unprivileged user, you must run these commands
|
|
||||||
as that user instead.
|
|
||||||
|
|
||||||
Enable ping and SSH with :command:`openstack security group rule create`
|
Enable ping and SSH with :command:`openstack security group rule create`
|
||||||
commands:
|
commands:
|
||||||
@ -542,13 +540,6 @@ commands:
|
|||||||
$ openstack security group rule create --protocol icmp default
|
$ openstack security group rule create --protocol icmp default
|
||||||
$ openstack security group rule create --protocol tcp --dst-port 22:22 default
|
$ openstack security group rule create --protocol tcp --dst-port 22:22 default
|
||||||
|
|
||||||
Enable ping and SSH with ``euca2ools``:
|
|
||||||
|
|
||||||
.. code-block:: console
|
|
||||||
|
|
||||||
$ euca-authorize -P icmp -t -1:-1 -s 0.0.0.0/0 default
|
|
||||||
$ euca-authorize -P tcp -p 22 -s 0.0.0.0/0 default
|
|
||||||
|
|
||||||
If you have run these commands and still cannot ping or SSH your instances,
|
If you have run these commands and still cannot ping or SSH your instances,
|
||||||
check the number of running ``dnsmasq`` processes, there should be two. If not,
|
check the number of running ``dnsmasq`` processes, there should be two. If not,
|
||||||
kill the processes and restart the service with these commands:
|
kill the processes and restart the service with these commands:
|
||||||
|
@ -22,15 +22,7 @@ To manually recover a failed compute node:
|
|||||||
|
|
||||||
#. Identify the VMs on the affected hosts by using a combination of the
|
#. Identify the VMs on the affected hosts by using a combination of the
|
||||||
:command:`openstack server list` and :command:`openstack server show`
|
:command:`openstack server list` and :command:`openstack server show`
|
||||||
commands or the :command:`euca-describe-instances` command.
|
commands.
|
||||||
|
|
||||||
For example, this command displays information about the i-000015b9 instance
|
|
||||||
that runs on the np-rcc54 node:
|
|
||||||
|
|
||||||
.. code-block:: console
|
|
||||||
|
|
||||||
$ euca-describe-instances
|
|
||||||
i-000015b9 at3-ui02 running nectarkey (376, np-rcc54) 0 m1.xxlarge 2012-06-19T00:48:11.000Z 115.146.93.60
|
|
||||||
|
|
||||||
#. Query the Compute database for the status of the host. This example converts
|
#. Query the Compute database for the status of the host. This example converts
|
||||||
an EC2 API instance ID to an OpenStack ID. If you use the :command:`nova`
|
an EC2 API instance ID to an OpenStack ID. If you use the :command:`nova`
|
||||||
@ -298,24 +290,6 @@ After power resumes and all hardware components restart:
|
|||||||
This action enables you to connect to the instance without the volume
|
This action enables you to connect to the instance without the volume
|
||||||
attached, if you allow only connections through public keys.
|
attached, if you allow only connections through public keys.
|
||||||
|
|
||||||
To script the disaster recovery plan (DRP), use the `https://github.com/Razique
|
|
||||||
<https://github.com/Razique/BashStuff/blob/master/SYSTEMS/OpenStack/SCR_5006_V00_NUAC-OPENSTACK-DRP-OpenStack.sh>`_
|
|
||||||
bash script.
|
|
||||||
|
|
||||||
This script completes these steps:
|
|
||||||
|
|
||||||
#. Creates an array for instances and their attached volumes.
|
|
||||||
|
|
||||||
#. Updates the MySQL database.
|
|
||||||
|
|
||||||
#. Restarts all instances with euca2ools.
|
|
||||||
|
|
||||||
#. Reattaches the volumes.
|
|
||||||
|
|
||||||
#. Uses Compute credentials to make an SSH connection into every instance.
|
|
||||||
|
|
||||||
The script includes a ``test mode``, which enables you to perform the sequence
|
|
||||||
for only one instance.
|
|
||||||
|
|
||||||
To reproduce the power loss, connect to the compute node that runs that
|
To reproduce the power loss, connect to the compute node that runs that
|
||||||
instance and close the iSCSI session. Do not detach the volume by using the
|
instance and close the iSCSI session. Do not detach the volume by using the
|
||||||
|
@ -38,7 +38,7 @@ responsibilities of services and drivers are:
|
|||||||
|
|
||||||
``nova-api``
|
``nova-api``
|
||||||
Receives XML requests and sends them to the rest of the system. A WSGI app
|
Receives XML requests and sends them to the rest of the system. A WSGI app
|
||||||
routes and authenticates requests. Supports the EC2 and OpenStack APIs. A
|
routes and authenticates requests. Supports the OpenStack Compute APIs. A
|
||||||
``nova.conf`` configuration file is created when Compute is installed.
|
``nova.conf`` configuration file is created when Compute is installed.
|
||||||
|
|
||||||
``nova-cert``
|
``nova-cert``
|
||||||
|
@ -2,9 +2,9 @@
|
|||||||
nova-api
|
nova-api
|
||||||
========
|
========
|
||||||
|
|
||||||
-------------------------------------------
|
-------------------------------------
|
||||||
Server for the Nova EC2 and OpenStack APIs
|
Server for the OpenStack Compute APIs
|
||||||
-------------------------------------------
|
-------------------------------------
|
||||||
|
|
||||||
:Author: openstack@lists.openstack.org
|
:Author: openstack@lists.openstack.org
|
||||||
:Date: 2012-09-27
|
:Date: 2012-09-27
|
||||||
|
@ -18,10 +18,10 @@ download images to launch instances.
|
|||||||
OpenStack Compute consists of the following areas and their components:
|
OpenStack Compute consists of the following areas and their components:
|
||||||
|
|
||||||
``nova-api`` service
|
``nova-api`` service
|
||||||
|
|
||||||
Accepts and responds to end user compute API calls. The service supports the
|
Accepts and responds to end user compute API calls. The service supports the
|
||||||
OpenStack Compute API, the Amazon EC2 API, and a special Admin API for
|
OpenStack Compute API. It enforces some policies and initiates most
|
||||||
privileged users to perform administrative actions. It enforces some policies
|
orchestration activities, such as running an instance.
|
||||||
and initiates most orchestration activities, such as running an instance.
|
|
||||||
|
|
||||||
``nova-api-metadata`` service
|
``nova-api-metadata`` service
|
||||||
Accepts metadata requests from instances. The ``nova-api-metadata`` service
|
Accepts metadata requests from instances. The ``nova-api-metadata`` service
|
||||||
|
@ -49,9 +49,9 @@ initialization time, one which accepts messages with routing keys
|
|||||||
``NODE-TYPE.NODE-ID`` (for example ``compute.hostname``) and another, which
|
``NODE-TYPE.NODE-ID`` (for example ``compute.hostname``) and another, which
|
||||||
accepts messages with routing keys as generic ``NODE-TYPE`` (for example
|
accepts messages with routing keys as generic ``NODE-TYPE`` (for example
|
||||||
``compute``). The former is used specifically when Nova-API needs to redirect
|
``compute``). The former is used specifically when Nova-API needs to redirect
|
||||||
commands to a specific node like ``euca-terminate instance``. In this case,
|
commands to a specific node like ``openstack server delete $instance``. In this
|
||||||
only the compute node whose host's hypervisor is running the virtual machine
|
case, only the compute node whose host's hypervisor is running the virtual
|
||||||
can kill the instance. The API acts as a consumer when RPC calls are
|
machine can kill the instance. The API acts as a consumer when RPC calls are
|
||||||
request/response, otherwise it acts as a publisher only.
|
request/response, otherwise it acts as a publisher only.
|
||||||
|
|
||||||
Nova RPC Mappings
|
Nova RPC Mappings
|
||||||
|
Loading…
x
Reference in New Issue
Block a user