Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

If you wish to avoid using the dashboard and perform actions from the command line (particularly if you wish to script certain actions), you can instead use the OpenStack client.


Information on using the OpenStack client can be found here: https://docs.openstack.org/developer/python-openstackclient/


Installation

Depending on your operating system, the OpenStack client should be available through the default repositories (these are run as root, or using sudo privileges):

  • Ubuntu: apt-get install openstack
  • CentOS 7: yum  pip install openstackmacOS*: sudo python-openstackclient
  • MacOS: pip install python-openstackclient

      ...

        • Note for MacOS: If you need to install missing packages, Homebrew (https://brew.sh/) a missing package manager for

      ...

        • MacOS can assist with this.

      More information on installing the client can be found here: https://docs.openstack.org/developer/python-openstackclient/user-guide/common/cli-install-openstack-command-line-clients.html


      Windows 10 Users - Ubuntu Bash Shell (WSL):

      ...

      While potentially you can input your user credentials on the command line every time you run openstack, the simpler (and more secure) option is to put your credentials into a file which you read from before using the CLI. First create a file in your home directory (usually called openrc) with the following settings:

      Code Block
      export OS_NO_CACHE='true'
      export OS_TENANT_NAME=<project_name>
      export OS_PROJECT_NAME=<project_name>
      export OS_USERNAME=<user_name>
      export OS_PASSWORD=<password>
      export OS_AUTH_URL='https://nimbus.pawsey.org.au:5000/'
      export OS_IDENTITY_API_VERSION=3
      export OS_DEFAULT_DOMAIN='default'
      export OS_USER_DOMAIN_NAME='Default'
      export OS_PROJECT_DOMAIN_NAME='Default'
      export OS_AUTH_STRATEGY='keystone'
      export OS_REGION_NAME='RegionOne'
      export CINDER_ENDPOINT_TYPE='internalURL'
      export GLANCE_ENDPOINT_TYPE='internalURL'
      export KEYSTONE_ENDPOINT_TYPE='internalURL'
      export NOVA_ENDPOINT_TYPE='internalURL'
      export NEUTRON_ENDPOINT_TYPE='internalURL'
      export OS_ENDPOINT_TYPE='internalURL'
      export MURANO_REPO_URL='http://storage.apps.openstack.org/'
      export MURANO_PACKAGES_SERVICE='glance'

      Where:

      ...

      log in to the Nimbus dashboard, where you can download your Nimbus credentials file by clicking on your username in the top right corner and selecting "OpenStack RC File v3" (save it as something like nimbus-rc).


      Once created, you can load your credentials by running:

      Code Block
      . ~/openrcnimbus-rc

      Running your Nimbus credentials file will prompt you to input your Pawsey account password (NOTE: be aware that your password will then be available in plaintext in the environment variable OS_PASSWORD, until you either log out or unset that variable).