Install and configure the DDT/MAP remote client for PC Windows

It is easy to install a client version of AllineaTools (DDT + MAP) on your Windows that allows you to launch a Graphical User Interface (GUI) on your local machine and connect to the remote cluster to debug or profile a code. You don’t need a licence to install an Allinea remote client, but the network license is verified when you connect to the cluster. Follow the steps below to install and configure the remote GUI client:

1. Download the PC Windows build executable file

It could be done in one of the following ways:

  • copy a client build from location to your local machine. For 32-bit Windows use:

    For 64-bit Windows use:



2. Run your executable and install the AllineaTools client

Double-click on allinea-tools-client-4.2.1-37994-Windows-6.1-xNN.exe:

DDT/MAP client for PC Windows


Choose “Run” in the next window:

Run Allinea Client setup on PC Windows


Enter the Allinea Tools Client Setup Wizard, close other applications as recommended, and click “Next”:

DDT/MAP remote client for PC Windows - Setup Wizard


Accept the user agreement:

AllineaTools client for PC Windows User Agreement


Choose the installation folder:

AllineaTools client for PC Windows - Installation folder


Create the program’s shortcut in the Start Menu Folder:

AllineaTools Client for PC Windows - Menu subfolder


Choose if you wish to create desktop icons:

AllineaTools PC Windows client  - create desktop icons


Now you are ready to install, click “Install”:



Wait for the installation to complete…

AllineaTools client for PC Windows - Installation in progress


Complete the installation by clicking “Finish”:

AllineaTools PC client - Installation Complete


Congratulations!! You are now ready to launch, test, and use Allinea DDT and MAP and connect to the cluster!


3. Launch the Allinea Tools applications

(double-click on either DDT or MAP icon):

AllineaTools client for PC Windows launch


Choose to configure the “Remote Launch”:

AllineaTools client for PC Windows Remote Launch


Configure the remote launch by specifying you login and host information in “Host Name” (replace <USER> by your login name), and setting the “Remote Installation Directory” as shown below, where the AllineaTools license would be verified.


AllineaTools Client for PC Windows: Remote Launch Settings


Choose “Test Remote Launch” for testing the login and validating your credentials.
Choose “OK” to start your debugging (DDT) or profiling (MAP) session!

Follow the links for further instructions to configure your debugging or profiling tasks:

DDT for a serial job: customize and run

DDT for a multiprocessor MPI job: customize and run

User’s Guide  (DDT + MAP) AllineaTools Version.4.2.1-37994
User’s Guide could also be found in the AllineaTools installation directory on Pegasus2 in the following location:


Remote DDT/MAP client for Mac OS/X: install and configure

Remote DDT/MAP remote client for PC Windows: install and conifgure

Remote DDT/MAP remote client for Linux/Unix: install and configure

DDT – Distributed Debugging Tool

MAP – MPI Profiling

Debugging and Profiling with Allinea Tools

AllineaTools (DDT + MAP) User’s Guide. Version 4.2.1-37994

HPC Documentation

HPC Home