1.2. Install the OpenStack Command-line Clients
Install the prerequisite software and the Python package for each OpenStack client.
1.2.1. Install the Prerequisite Software
The following table lists the software that you need to have to run the command-line clients, and provides installation instructions as needed.
Prerequisite | Description |
---|---|
Python 2.6 or later
|
Currently, the clients do not support Python 3.
|
python-setuptools package
|
python-setuptools is a collection of tools to allow for building, distribution, and installation of Python packages.
|
1.2.2. Install the Clients
When following the instructions in this section, replace PROJECT with the lowercase name of the client to install, such as nova. Repeat for each client. The valid values include:
ceilometer
- Telemetry APIcinder
- Block Storage API and extensionsglance
- Image Service APIheat
- Orchestration APIkeystone
- Identity service API and extensionsneutron
- Networking APInova
- Compute API and extensionsswift
- Object Storage API
The following example shows the command for installing the nova client with yum.
#
yum install python-novaclient
1.2.2.1. Installing from Packages
On Red Hat Enterprise Linux, use yum to install the clients:
#
yum install python-PROJECTclient
1.2.3. Upgrade or Remove Clients
To upgrade a client, add the
--upgrade
option to the yum install command:
#
yum install --upgrade python-PROJECTclient
To remove the a client, run the yum erase command:
#
yum erase python-PROJECTclient
1.2.4. What's Next
Before you can run client commands, you must create and source the
PROJECT-openrc.sh
file to set environment variables. See Section 1.4, “Set Environment Variables Using the OpenStack RC File”.