Get Software Tools

You need the following tools to try tutorial steps yourself using the nqueens_fortran sample application:

• Intel Inspector installation package and license

• .tgz file extraction utility

• Supported compiler (see Release Notes for more information)

• Editor

Acquire the Intel Inspector

If you do not already have access to the Intel Inspector, you can download it for free as follows:

• standalone version
• part of the Intel® oneAPI HPC Toolkit

Install and Set Up the Intel Inspector Sample Applications

1. Copy the nqueens_fortran.tgz file from the <install-dir>/samples/<locale>/Fortran/ directory to a writable directory or share on your system. The default <install-dir> is below /opt/intel/.

2. Extract the sample from the .tgz file to create the nqueens_fortran directory.

3. Ensure you have set the EDITOR or VISUAL environment variable to your text editor.

Understand Optimal Compiler/Linker Settings

You can use the Intel® Inspector to analyze memory and threading errors in both debug and release modes of C++ and Fortran binaries; however, applications compiled/linked in debug mode using the following settings produce the most accurate and complete analysis results.

Build the Application

1. In a terminal session, change directory to the nqueens_fortran directory.

2. Type make nqueens_threading_debug.

Verify the Application Runs Outside the Intel Inspector

1. In the same terminal session, type ./nqueens_threading_debug to execute the sample application.

2. Check for non-deterministic application output similar to the following:

   Usage: nqueens_threading[_debug] boardSize
   Using default size of 10
   Starting nqueens solver for size 10 with 8 thread(s)
   Number of solutions: 1404
   Incorrect result!
   Calculations took 113 ms.

Set up the Intel Inspector Environment

Do one of the following to set up the Intel Inspector environment:

• Run one of the following source commands:

  • For csh/tcsh users: source <inspector-install-dir>/inspxe-vars.csh

  • For bash users: source <inspector-install-dir>/inspxe-vars.sh

  NOTE:

  The name of this script for the application as part of an Intel® HPC Toolkit or Intel® IoT Toolkit installation is env\vars instead of inspxe-vars.

  The default installation path, <inspector-install-dir>, is below:

  • /opt/intel/ for root users

  • $HOME/intel/ for non-root users

• Add <inspector-install-dir>/bin32 or <inspector-install-dir>/bin64 to your path.

In some cases, you can also run the <studio-install-dir>/psxevars.csh or <studio-install-dir>/psxevars.sh command. The default installation path, <studio-install-dir>, is below:

• /opt/intel/ for root users

• $HOME/intel/ for non-root users

Open the Intel Inspector Standalone GUI

In the same terminal session, type inspxe-gui & to run the Intel Inspector standalone GUI in the background.

Create a New Project

1. Choose File > New > Project... to display a dialog box similar to the following:

   

2. In the Project name field, type threading_issues. Then click the Create project button to create a config.inspxeproj file in the ~/intel/inspxe/projects/threading_issues/ directory (default location) and display a dialog box similar to the following:

   

3. Click the Browse button next to the Application field and select the nqueens_fortran/nqueens_threading_debug application. Notice the Intel Inspector autofills the project Working directory field for you. Then click the OK button to return to the Welcome page, where the name of the opened project displays in the title bar and in the Project Navigator pane. (If necessary, choose View > Project Navigator to display the Project Navigator.)