Requirements

Edit online

Understand the requirements for using IBM Spectrum LSF Application Center web services.

User requirements

Log into IBM Spectrum LSF Application Center at least once before using the web service. This automatically configures user access permissions for your account.

Protocol and port

Web services share the same protocol and port with IBM Spectrum LSF Application Center.

The default protocol is HTTP, port: 8080. The default web service URL is http://host_name:8080.

If you enable HTTPS, the default port is 8443. The web service URL is https://host_name:8443.

To change protocol and port:
  1. Edit $GUI_CONFDIR/jvm.options, and change default.http.port, and default.https.port:
    
#define http/https port
-Ddefault.http.port=8080 
-Ddefault.https.port=8443
  2. Restart Platform Application Center:
    pmcadmin stop
pmcadmin start
  3. Run pacadmin to switch between HTTP and HTTPS.

Python client host requirements

The client host has the following requirements:
  • Python 2.6.x installed (http://www.python.org/download/releases/)
  • httplib2 versions 0.6, 0.8 (http://code.google.com/p/httplib2/downloads/list)
  • If you are using HTTPS:
    • Get the cacert.pem file from your Platform Application Center administrator and copy to the same directory from which you are going to invoke the client program.
    • When you are invoking the Python client and using HTTPS, note that for httplib2 version 0.8, you must specify the fully qualified host name or short host name in the URL. IP addresses cannot be used.
  • If you are using X.509:
    • Get the .key.pem and .cert.pem files from your Platform Application Center administrator and copy to the same directory from which you are going to invoke the client program.
    • You must use httplib2 version 0.6 with X.509

Get pac_api.py and pacclient.py

Get pac_api.py and pacclient.py from Github. Once you have the files:
  1. To log in, run pacclient.py logon. The connection information and security information is be saved in $HOME/.pacpass.
  2. To perform a task such as listing jobs or submitting a job, run the corresponding command, such as pacclient.py job or pacclient.py submit.
  3. To log out, run pacclient.py logout.