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
Follow

IN THIS ARTICLE

Outlines how to install QQ Command-Line Tools from the Web UI of Qumulo Core

REQUIREMENTS

  • Cluster running Qumulo Core
  • Python 2.7
  • Admin privileges on the Qumulo cluster

DETAILS

  1. Log in to the Qumulo Core Web UI.
  2. Select API & Tools.
  3. Click Download Command-Line Tools button.

    download_tools.png

  4. Unzip the downloaded file on your computer.
  5. Copy the qumulo_api directory to your home directory to ensure that only you are able to run the qq command on the computer where you are installing. If others need access, copy the qumulo_api directory to one of the following:
    • Apple and Linux computers - copy to /opt/
    • Windows - copy to C:\Program Files (x86)\ 

Lastly, you'll need copy the qumulo_api directory to your system's PATH to use the qq command from any location in the file system while in your CMD prompt or terminal.

Windows

  • Go to Control Panel, select System, click Advanced System Settings, and select Environmental Variables

    win_env_variables.png

  • Navigate to the System variables section and add the following paths to the Path System variable
    • C:\Python27\
    • C:\Python27\scripts
    • C:\Program Files (x86)\qumulo_api
  • Add the .PY Extension to the list of variable values in the PATHEXT System variable

    pathext_win.png

  • Click OK to close the Environment Variable dialogue box, then OK again to close the System Properties dialogue box
  • Browse to C:\Program Files (x86)\qumulo_api
  • Right click on the qq file and rename it to qq.py

You can now open up the Powershell or Command Prompt applications to interact with a Qumulo cluster from a windows workstation or server.

Mac

  • Open a Terminal window
  • Run the following command:
     
    sudo nano etc/paths
  • Enter your password when prompted

    mac_etc_paths.png

  • Enter the path of the qumulo_api folder at the bottom of the file:

    mac_paths_qumulo_api.png

  • Type control-X to exit 
  • Type Y and hit Enter to save the change

    mac_paths_yes.png

  • Launch a new Terminal window and run the following command to verify:
     
    echo $PATHS

You can now open up a Terminal window and interact with a Qumulo cluster from a Mac workstation.

For additional details command-line tools, reference the article QQ CLI: Get Started for more information.

RESOLUTION

You should now be able to successfully install QQ Command-Line Tools in Qumulo Core

ADDITIONAL RESOURCES

QQ CLI: Get Started

QQ CLI: Comprehensive List of Commands

 

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

Related articles

Comments

2 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

Please sign in to leave a comment.