All of the Arm® Forge products can be launched by typing their name in front of an existing mpiexec
command:
$ map mpiexec -n 256 examples/wave_c 30
This startup method is called Express Launch and is the simplest way to get started.
The MPI implementations supported by Express Launch are:
If your MPI is not supported by Express Launch, an error message will display:
$ 'Generic' MPI programs cannot be started using Express Launch syntax (launching with an mpirun command).
Try this instead:
map --np=256 ./wave_c 20
Type map --help for more information.
This is referred to as Compatibility Mode, in which the mpiexec
command is not included and the arguments to mpiexec
are passed via a
–mpiargs="args here"
parameter.
One advantage of Express Launch mode is that it is easy to modify
existing queue submission scripts to run your program under one of the
Arm® Forge products. This works best for MAP, which gathers data without an interactive
user interface (map –profile
) or Reverse Connect (map –connect
, see Reverse Connect for more details) for interactive profiling.
If you cannot use Reverse Connect and want to use interactive profiling from a queue, you might need to configure Arm® MAP to generate job submission scripts for you. More details on this can be found in Start a job in a queue (MAP) and Integration with queuing systems.