Topics include:
PTP uses the term resource manager to refer to any subsystem that controls the resources required for launching a parallel job. If the target parallel system employs a job scheduler for controlling access to compute resources, then the job scheduler would be considered the resource manager for the system. For a cluster with Open MPI installed, the Open MPI runtime system would be considered the resource manager.
In order for PTP to launch, monitor, and control applications on a target system, it must know what type of resource manager is being employed. PTP allows you to configure and manage resource managers that correspond to target systems. Each resource manager controls one target system, although a particular target system may have more than one type of resource manager.
Resource managers can be local or remote. A local resource manager controls resources on the local machine running Eclipse. A remote resource manager controls resources on a physically remote system. The process of configuring a local or remote resource manager is the same.
Open the PTP Runtime Perspective using Window > Open Perspective > Other... and then choose PTP Runtime from the list of perspectives.
Right-click in Resource Managers view and select Add Resource Manager...
Choose the resource manager that corresponds to the target system. In this example we will use the Open MPI resource manager, which is used to control the Open MPI Open Runtime Environment.
Select Next >
In this example, we will show how to configure PTP to use a local resource manager, for example, where Eclipse is installed on the head node of a cluster. This was the scenario that PTP 1.x handled.
The Open MPI connection configuration dialog is used to configure how Eclipse will communicate with the Open MPI environment.
To configure the simple case of a local resource manager, select Local as the Remote service provider.
For the local case, the Proxy server location will be automatically set to Local.
The Multiplexing Options allow communication to be tunneled over a single connection if necessary. For the local case, it is not required, and None should be selected.
The Local address for proxy connection should be set to the address of your local machine (its host name, IP address, or localhost
).
Select Next >
This example will demonstrate configuring a remote resource manager, where Eclipse and PTP are on your local laptop or workstation, and PTP controls a remote target system.
A remote resource manager allows PTP to control a remote target machine. To accomplish this, PTP uses the services of a remote service provider. Currently supported remote service providers include the Remote Tools package (a part of PTP) and the Eclipse Remote Systems Explorer (RSE) which is an optional package that can be installed at any time.
The only reason to use RSE rather than Remote Tools is if your remote system does not use thessh
protocol for remote connections,
or you wish to use the additional functionality that RSE provides. See the RSE documentation
for more information. We will only consider Remote Tools here, but the steps for configuring RSE are similar.
In the Open MPI connection configuration dialog, select Remote Tools as the Remote service provider.
At this point, you need to configure a Proxy server location. This will differ depending on the remote service provider that you selected in the previous step. The following steps describe configuring a Remote Tools location.
Select New...
In the Remote Host dialog, enter a name for the connection in the Target Name field (can be anything).
Select the Remote Host radio button.
Enter the address of the remote host in the Host field.
The Port field should be left at 22
unless your installation uses a different port for ssh
connections.
Enter your user name on the remote machine in the User field.
If you use password authentication, select the Password based authentication radio button and enter the password in the Password field.
If you use key based authentication, select the Public key based authentication radio button, select the file containing your public key, and enter the passphrase for your key (or leave blank if you don't use a passphrase).
Click Finish
The Multiplexing Options allow communication to be tunneled over a single connection if supported by the remote service provider. To enable tunneling, select the Use port forwarding radio button.
If you don't wish to use port forwarding, select the None radio button and enter the address of your local machine (its host name, or IP address) in the Local address for proxy connection field. Note that if your site does not allow outbound connections from the remote machine to your local machine, then you must use port forwarding.
Select Next >
The next page will show configuration information specific to a particular resource manager. In this case, the Open MPI tool configuration dialog is shown. You will not normally need to change this information. Just select the Open MPI version installed on the target machine, and default values will automatically loaded into the fields.
If you wish to specify the commands for the Open MPI environment, or add extra arguments, uncheck the Use default settings checkbox.
Launch command: A command line executed to launch the parallel application with Open MPI.
Debug command: A command line executed to use Open MPI to launch a debug session for the parallel application.
Discover command: A command line executed when the Resource Manager is started, to collect information about the Open MPI environment..
Path to installation: If not empty, then all commands are prefixed with this path.
Only a single command is allowed on each command field. Several place holders (macros) are allowed, the most relevant are:
Select Next >
The final dialog is Choose Resource Manager Name and Description which provides an opportunity to change how the resource manager is displayed.
If you wish to change the name or description, uncheck the Use default name and description checkbox.
Enter a new name in the Name field. Anything can be entered.
Enter a new description in the Description field. Anything can be entered.
Select Finish
The new Resource Manager should appear in the list of Resource Managers.
To start the resource manager, right mouse click on the resource manager in the Resource Managers view, then select Start Resource Manager from the context menu.
The resource manager icon should change color to green to indicate has been successfully started.
In the Machines view you should see an icon representing your target system and icons showing status of the node(s).
If the resource manager fails to start (the icon is red), right click on the resource manager and select Stop Resource Manager. Check the log files for the reason that the resource manager failed to start, correct the error and restart again.
It is sometimes necessary to change the configuration of an existing resource manager, for example, to change the remote machine that the resource manager controls. Note that the resource manager cannot be edited when it is running.
If the resource manager is running, stop it first. Right-click on the resource manager and select Stop Resource Manager
Right-click on the resource manager and select Edit Resource Manager
Modify the required configuration settings and click Finish.
Restart the resource manager.
If the resource manager is no longer required, it can be removed from the Resource Managers view
If the resource manager is running, stop it first. Right-click on the resource manager and select Stop Resource Manager
Right-click on the resource manager and select Remove Resource Manager
You will be prompted to confirm removal. Click OK
Proceed to Launching a parallel application.