Joseph Robinson 2ce5b11b1a [User Guides] Rename Admin-Guide-Cloud to Admin-Guide

This patch changes the name of the Admin-Guide from the Cloud
Admin Guide to the Administrator guide. This affects the
filename in the repository, and references to cloud administrators
within the document texts.

1.) Changing instances of 'cloud administrator'
    to 'administrator'.

2.) Change links from '/admin-guide-cloud/' to
    '/admin-guide/' within the Admin Guide.

3.) Adjust .htaccess file.

Change-Id: I7f21a710e922981aa295afc0616de36fd819b523
Implements: blueprint user-guides-reorganised

2016-04-01 19:50:13 +09:00

3.2 KiB

Raw Blame History

Manage the cloud

compute-euca2ools.rst common/nova_show_usage_statistics_for_hosts_instances.rst

System administrators can use nova client and euca2ools commands to manage their clouds.

nova client and euca2ools can be used by all users, though specific commands might be restricted by Role Based Access Control in the Identity service.

Managing the cloud with nova client

The python-novaclient package provides a nova shell that enables Compute API interactions from the command line. Install the client, and provide your user name and password (which can be set as environment variables for convenience), for the ability to administer the cloud from the command line.

To install python-novaclient, download the tarball from http://pypi.python.org/pypi/python-novaclient/#downloads and then install it in your favorite Python environment:
```
$ curl -O http://pypi.python.org/packages/source/p/python-novaclient/python-novaclient-2.6.3.tar.gz
$ tar -zxvf python-novaclient-2.6.3.tar.gz
$ cd python-novaclient-2.6.3
```
As root, run:
```
# python setup.py install
```

Confirm the installation was successful:

$ nova help
usage: nova [--version] [--debug] [--os-cache] [--timings]
            [--timeout SECONDS] [--os-username AUTH_USER_NAME]
            [--os-password AUTH_PASSWORD]
            [--os-tenant-name AUTH_TENANT_NAME]
            [--os-tenant-id AUTH_TENANT_ID] [--os-auth-url AUTH_URL]
            [--os-region-name REGION_NAME] [--os-auth-system AUTH_SYSTEM]
            [--service-type SERVICE_TYPE] [--service-name SERVICE_NAME]
            [--volume-service-name VOLUME_SERVICE_NAME]
            [--endpoint-type ENDPOINT_TYPE]
            [--os-compute-api-version COMPUTE_API_VERSION]
            [--os-cacert CA_CERTIFICATE] [--insecure]
            [--bypass-url BYPASS_URL]
            SUBCOMMAND ...

Running nova help returns a list of nova commands and parameters. To get help for a subcommand, run:

$ nova help SUBCOMMAND

For a complete list of nova commands and parameters, see the OpenStack Command-Line Reference.

Set the required parameters as environment variables to make running commands easier. For example, you can add --os-username as a nova option, or set it as an environment variable. To set the user name, password, and tenant as environment variables, use:
```
$ export OS_USERNAME=joecool
$ export OS_PASSWORD=coolword
$ export OS_TENANT_NAME=coolu
```
The Identity service will give you an authentication endpoint, which Compute recognizes as OS_AUTH_URL:
```
$ export OS_AUTH_URL=http://hostname:5000/v2.0
$ export NOVA_VERSION=1.1
```

3.2 KiB Raw Blame History

Manage the cloud

3.2 KiB

Raw Blame History