Install CLI clients

If you want to run the examples by using cURL instead of using the CLI, skip this step and proceed to the next section, “Sending API requests to the Offer”.

You can use the OpenStack® designate command-line interface (CLI) client with Managed DNS. The designate client is the CLI for the OpenStack DNS service API and its extensions, and is a plug-in to the OpenStack CLI.

📘

You can specify the --debug parameter on any designate command to show the underlying API request for the command. This is a good way to become familiar with the API requests.

1. Run the following commands on a Mac OS X® or Linux® distribution to install the OpenStack and designate clients:

   $ sudo pip install -U python-openstackclient
   $ sudo pip install -U python-designateclient
   

2. Create a CLI configuration file with the content as shown in the following example, name the file clouds.yaml, and place it under your current directory.

   clouds:
      prod:
        auth:
          auth_url: https://identity.api.rackspacecloud.com/v2.0/
          project_id: <RACKSPACE_CLOUD_TENANT_ID>
          username: <RACKSPACE_CLOUD_USERNAME>
          password: <RACKSPACE_CLOUD_PASSWORD>
   

   For more CLI configuration options, see the Configuration topic in the OpenStack client documentation.

3. Export the following environment variables manually, or update your .bash_profile or .bashrc files with these variables:

   $ export OS_CLOUD=prod
   

4. Run the following command to see if OpenStack designate CLI works:

   $ openstack --help
   

5. If you get an error such as Exception: Versioning for this project requires either an sdist tarball, or access to an upstream git repository. Are you sure that git is installed?, run the following command:

   $ sudo pip install -U distribute
   

Now that your command line tool is ready, skip to “Creating a zone with the CLI.”