QTools  5.9.3
Getting Started

Downloading and Installing QTools™

The QTools™ collection is available for download from SourceForge as well as from GitHub. The QTools™ download is provided as a Windows EXE (for Windows) or as a ZIP file for POSIX (Linux). The EXE installer is recommended, because it is digitally signed by Quantum Leaps and provides an uninstaller. Either way, uninstalling QTools is easy and requires only deleting the qtools directory from your disk.

qtools_install.png
QTools installer on Windows
Note
It is recommended to install QTools into the C:\qp directory, or at least a directory that has no spaces or special characters in the name (e.g., "Program Files" or "Program Files (x86)" are poor choices).

Setting PATH

To use the QTools™, it is highly recommended to add the <qtools>\bin directory to the global PATH on your system, where <qtools> denotes the directory where you have installed QTools (default are C:\qp\qtools on Windows and ~/qp/qtools on Linux).

Note
Adding <qtools>\bin to your PATH will enable you to invoke all QTools utilities (like QSpy or QClean) by simply typing qspy or qclean at the command prompt, regardless of your current directory. This will come handy, because typically you will not invoke qspy or qclean from the <qtools>\bin directory.

Setting QTOOLS Environment Variable

To use certain QTools utilities, such as QUTest or QSpyView, it is highly recommended to define the environment variable QTOOLS to point to the installation directory of QTools™.

Note
Defining the QTOOLS environment variable is required to run QUTest Unit Testing and QSpyView Visualization and Monitoring utilities.

Directories and Files

The following annotated directory tree in the standard QTools™ distribution lists the top-level directories and files:


Next: QP/Spy™ Software Tracing