English (US)
Deutsch Español Français עברית
OPEN A CASE
KNOWLEDGE BASE
COMMUNITY
QUMULO TRENDS

KNOWLEDGE BASE

Articles in this section
See more

QQ CLI: Install Command-Line Tools

Avatar
Lindsie
  • Updated
Print Friendly and PDF

IN THIS ARTICLE

This page explains how you can install QQ Command-Line Tools.

REQUIREMENTS

  • A cluster running Qumulo Core
  • Python 3.6 (or higher)
    NOTE: From Qumulo Core 4.0.1, the QQ CLI doesn't support Python 2.7.

DETAILS

Qumulo Core offers Command-Line Tools in different forms based on your cluster's software version. The following sections give instructions for Qumulo Core 2.14.5 (and higher) and 2.14.4 (and lower).

QUMULO CORE 2.14.5 (OR HIGHER)

  1. Log in to the Qumulo Core Web UI.
  2. Click APIs & Tools > Download qq Command-Line Tool for Python 3.6+.
    Screen_Shot_2021-06-09_at_1.19.57_PM.png
    Your browser downloads the qq file.

Windows

On Windows, you can run a qq command using the python.exe interpreter. For example:

python.exe /Users/qumulo_user/qq

MacOS or Linux

On MacOS or Linux, you can run a qq command using the python interpreter.

python ~/qq

To run the file directly, configure its executable bit.

chmod +x ~/qq
~/qq

QUMULO CORE 2.14.4 (OR LOWER)

  1. Log in to the Qumulo Core Web UI.
  2. Click API & Tools > Download Command-Line Tools.
    Your browser downloads the qumulo_api.zip file.
  3. Extract the contents of the file.

To be able to execute the Command-Line Tools from anywhere, you must configure your system variables.

Windows

  1. Add thequmulo_api, Python36, and Python36\scripts directories to your system's PATH variable.
  2. Add the .PY extension to your system's PATHEXT variable.
  3. Rename qq to qq.py.

MacOS or Linux

  1. Run the sudo nano etc/paths command and enter your password.
  2. Add the path to the qumulo_api directory to the bottom of the file.
  3. To verify your configuration, run the echo $PATH command.

For more information about using Command-Line Tools, see QQ CLI: Get Started.

INSTALLING THE COMMAND-LINE TOOLS USING THE PYTHON SDK

You can also install the Qumulo API Tools using the Python SDK by running the following command.

pip install qumulo_api

The qq file (qq.exe for Qumulo Core 3.1.4 and higher) is installed in the Scripts directory, next to your Python installation (for example, C:\Python36\Scripts).

To allow qq.exe to be executed from anywhere, add this directory to your system's PATH.

RESOLUTION

You can now install and use the Qumulo Command-Line Tools.

ADDITIONAL RESOURCES

QQ CLI: Get Started

QQ CLI: Comprehensive List of Commands

Explore the API with qq raw

 

Like what you see? Share this article with your network!

Related articles

Comments

4 comments

Sort by Date Votes
  • Avatar
    Lee Duckett

    This utility seems to have a requirement not listed in the "REQUIREMENTS" section.  I think that it also requires you to have Python installed.

    0
    Comment actions Permalink
  • Avatar
    Lindsie

    Hi Lee!

    Thanks for calling that missing requirement to our attention. Python 2.7 has been added to the section to ensure users know what they need to successfully install the qq command-line tools. Reach out if you need anything else!

    0
    Comment actions Permalink
  • Avatar
    Stefan Radtke
    • Edited

    Lindsie, the command to verify the PATH variable has changes on MacOS is 

    echo $PATH
    and not 
    echo $PATHS

    Appreciate if you can remove the S.

    Thanks, Stefan

    0
    Comment actions Permalink
  • Avatar
    Lindsie

    Thanks for the feedback Stefan! This change has been made in the documentation. Reach out with any additional suggestions you may have.

    0
    Comment actions Permalink

Please sign in to leave a comment.