Pro Tip! How to use pip to install QQ CLI

Are you a developer? Do you use pip? Here's an easy way to install the QQ CLI utility on any python installations via pip. 

Requirements include the following:

• Cluster running Qumulo Core
• Ability to download and install "pip"
• SSL enabled 2.7 python release 

For example on MacOS:

[mbp:/] % python -V
Python 2.7.10
[mbp:/] % which python
/usr/bin/python

First you'll need to verify that pip is installed on the computer.

Open a terminal session.

Type pip and press enter 

If pip is installed, the following output will display and can skip ahead to Install Qumulo API Client using Native pip command.

[mpb:/] % pip Usage:
pip  [options]

Commands:
install Install packages.
download Download packages.
uninstall Uninstall packages.
freeze Output installed packages in requirements format.
list List installed packages.
show Show information about installed packages.
check Verify installed packages have compatible dependencies.
search Search PyPI for packages.
wheel Build wheels from your requirements.
hash Compute hashes of package archives.
completion A helper command used for command completion.
help Show help for commands

If pip is not installed you will see Command not found.

[mbp:/] % pip
pip: Command not found.

If needed, install pip by typing the following command when prompted.

sudo easy_install pip

Hit enter to start the install

Searching for pip
Best match: pip 9.0.1
Processing pip-9.0.1-py2.7.egg
pip 9.0.1 is already the active version in easy-install.pth
Installing pip script to /usr/local/bin
Installing pip2.7 script to /usr/local/bin
Installing pip2 script to /usr/local/bin

Using /Library/Python/2.7/site-packages/pip-9.0.1-py2.7.egg
Processing dependencies for pip
Finished processing dependencies for pip 

Once you have pip, you can install Qumulo API client using native pip command.

Run the following command to install QQ CLI.

[mbp:/] % sudo pip install qumulo-api
Collecting qumulo-api

Downloading qumulo_api-2.7.2-py2-none-any.whl (92kB)
100% |████████████████████████████████| 102kB 224kB/s
Installing collected packages: qumulo-api
Successfully installed qumulo-api-2.7.2  <----

Note that the qq utility will be installed where pip is installed.

% /usr/local/bin/qq -v
usage: qq [-h] [--chunked] [--chunk-size CHUNK_SIZE]
[--credentials-store CREDENTIALS_STORE] [--debug] [-v] [--version]
[--timeout TIMEOUT] [--host HOST] [--port PORT]
...

Lastly, test that the qq utility is working with your cluster

[mbp:~/Downloads/qumulo_api] % ./qq --host qumulo-1.local login -u admin
Password:
[mbp:~/Downloads/qumulo_api] % ./qq --host qumulo-1.local version
{
"build_date": "2017-10-21T21:24:13Z",
"build_id": "98427.1.31",
"flavor": "release",
"revision_id": "Qumulo Core 2.7.2"
}

You should now have qq command line tools installed!

Want to know more? For additional details, reference the following articles on using QQ CLI with your cluster.

Using the Qumulo CLI

QQ CLI: Comprehensive List of Commands