Using the IBM Spectrum LSF and IBM Spectrum LSF Process Manager port check applications


Note: The lsportcheck and pmportcheck tools supplied by IBM are designed to display the ports configured for use by Platform Suite for SAS® versions 8, 9 and 10 (which include IBM Spectrum LSF and IBM Spectrum LSF Process Manager). When executed on a node, these tools also identify the process ID and program name currently occupying that port. Therefore, they can be used to confirm that the appropriate processes have successfully started and reserved their necessary ports on a particular host. Combining these tools with Nmap, you can confirm that these ports are accessible from one node to another. 

If the profile.lsf file or the profile.js file is not sourced or if the file is run on a system that does not have IBM Spectrum LSF or IBM Spectrum LSF Process Manager installed, these programs will read against the default port configurations.

Note: These programs require that libstdc++ is installed on UNIX platforms.

Using lsportcheck

Note: The profile.lsf file must be sourced for this program to check configured ports instead of the defaults.

After extracting the appropriate lsportcheck binary for your particular host, running ./lsportcheck or ./lsportcheck -h produces the usage instructions for the application.

To examine the ports on a master host, run ./lsportcheck -l -m. For a slave host, run ./lsportcheck -l -s.

The output of the program should look similar to the following:

IBM spectrum LSF default port list

Using pmportcheck

Note: The profile.js file must be sourced for this program to check configured ports instead of the defaults.

Using pmportcheck is similar to using lsportcheck, though IBM Spectrum LSF Process Manager does not have master hosts. So, you would run this tool only on the host that is running IBM Spectrum LSF Process Manager.

To examine the ports for IBM Spectrum LSF Process Manager, run ./pmportcheck -l.

The output of the program should look similar to the following:

IBM spectrum LSF process manager default port list

Using Nmap to Test Connectivity between Hosts

These programs confirm that the process on the local host has successfully reserved the port, but do not confirm that these ports are accessible from the other hosts. You can test port accessibility using a program called Nmap, which can be installed using yum on Linux with the command yum install nmap.

The example above shows the ports being used by IBM Spectrum LSF and IBM Spectrum LSF Process Manager on a particular host being identified. Using Nmap from another host, you can confirm that these ports are accessible remotely by submitting the following syntax:

nmap -p<port1,port2,portn> <hostname>

The output of the program looks similar to the following if the ports are accessible:

program output if the ports are accessible

If the ports are not accessible, the output looks similar to the following:

output if the ports are not accessible