Toolbelt provides a command line interface to the Aunsight platform that enables interaction with Aunsight without the need to launch a web browser. Because it can be integrated in shell scripts, Toolbelt also extends the productivity of engineers by allowing them to automate maintenance tasks and even deploy those tasks within Docker container processes.
This article details how to install the Aunsight toolbelt on Mac or Linux and Windows systems. After reading this article, users will have a working Toolbelt interface accessible from their system shell. From there, users may wish to learn more about the commands Toolbelt exposes to users.
Step 1: Download¶
Download the latest toolbelt version for Mac, Windows, or Linux at: https://artifacts.aunalytics.com/toolbelt/Toolbelt-latest/
From the directory, download the appropriate version for your operating system.
Step 2: Installing¶
MacOS and Linux¶
- Set the executable bit for the file:
chmod +x ./aunsight-toolbelt2-macos(MacOS) or
chmod +x ./aunsight-toolbelt2-linux(Linux)
- Move the downloaded file to a directory in your
$PATHenvironment variable. Assuming your download is located in
~/Downloads/, use the following command:
mv ~/Downloads/aunsight-toolbelt2-macos /usr/local/bin/au2
It is recommended that you rename your file
au2 rather than relying on shell aliases. This way you can invoke toolbelt by typing
au2 in all shells, rather than relying on shell configuration files.
- Rename the downloaded file from
au2.exeto a location you would like to install it. (e.g.
c:\Program Files\toolbelt\). Any directory will do so long as it can safely be included in your
Pathenvironment variable (e.g. Not a folder like
- Add the location of
Pathenvironment variable. To learn how to do this, see Microsoft's documentation.
Step 3: Verifying the Installation¶
To check if toolbelt is installed correctly, restart your shell session and type:
This should display the current version of the
au2 (Toolbelt) command line interface.
To verify that toolbelt can communicate with the Aunsight remote services, type:
You will be prompted for your Aunsight credentials. If you receive a token back after you've successfully logged in, then Toolbelt has successfully been installed.
You do not need to manually save the token you receive; Toolbelt automatically manages Aunsight tokens.