To set the required environment variables for the OpenStack
command-line clients, you must create an environment file
called an OpenStack rc file, or openrc.sh
file. This project-specific environment
file contains the credentials that all OpenStack services
use.
When you source the file, environment variables are set for your current shell. The variables enable the OpenStack client commands to communicate with the OpenStack services that run in the cloud.
![]() | Note |
---|---|
Defining environment variables using an environment file is not a common practice on Microsoft Windows. Environment variables are usually defined in the Advanced tab of the System Properties dialog box. |
In a text editor, create a file named
file and add the following authentication information:PROJECT
-openrc.shThe following example shows the information for a project called
admin
, where the OS username is alsoadmin
, and the identity host is located atcontroller
.export OS_USERNAME=admin export OS_PASSWORD=
ADMIN_PASS
export OS_TENANT_NAME=admin export OS_AUTH_URL=http://controller:35357/v2.0On any shell from which you want to run OpenStack commands, source the
file for the respective project. In this example, you source thePROJECT
-openrc.shadmin-openrc.sh
file for theadmin
project:$ source admin-openrc.sh
When you run OpenStack client commands, you can override
some environment variable settings by using the options
that are listed at the end of the help output
of the various client commands. For example, you can override
the OS_PASSWORD
setting in the
file by specifying a password on a keystone command, as
follows:PROJECT
-openrc.sh
$ keystone --os-password PASSWORD
service-list
Where PASSWORD
is your password.