=======================================================================
IBM Spectrum LSF Application Center Desktop Client For Linux and MacOS
=======================================================================

===================================================
Abstract
===================================================
Readme file for IBM® Spectrum LSF Application Center Desktop Client for Linux and MacOS
Product/Component Release: 10.2.0.12


===================================================
Description
===================================================
The IBM Spectrum LSF Application Center Desktop Client is a light weight desktop service for LSF Application Center.
It is installed on an LSF Application Center user's (Windows , Linux, or MacOS) desktop and allows the user access to
the LSF command line interface (CLI) without having to install traditional LSF Services (lim, res, and sbd) on their desktop.
The desktop CLIs are fully compatible with LSF CLIs; they have the same name and option syntax.
This installer is for the Linux and MacOS Desktop Client.
 

===================================================
Dependencies
===================================================
- IBM Spectrum LSF Application Center 10.2.0.12 must already be installed and must be accessible from the Desktop Client host via http(s).
- cURL 7.XX installed on the Desktop Client host. (https://curl.haxx.se/)


===================================================
Installing the Desktop Client for Linux and MacOS
===================================================

1. Download the applicable package:
     pacdesktop_client10.2.0.12_x64.tar
     pacdesktop_client10.2.0.12_macosx.tar
     pacdesktop_client10.2.0.12_macosx-x86_64.tar
     pacdesktop_client10.2.0.12_ppc64le.tar


2. Untar the package. For example:
     $tar -xvf pacdesktop_client10.2.0.12_x64.tar


3. Add the LSF_DESKTOP_CLIENT environment variable to the host and enable it:
    For csh, tcsh env:   $setenv LSF_DESKTOP_CLIENT yes
    For sh, ksh, bash env:  $export LSF_DESKTOP_CLIENT=yes


4. Add the Desktop Client directory to the system PATH environment, to allow for the execution of LSF Desktop Client commands in other directories.
   For example, for LSF Application Center Desktop Client files under /opt/LSF_Desktop_Client, enter:
     For csh, tcsh env: $setenv PATH /opt/LSF_Desktop_Client:$PATH
     For sh, ksh, bash env: $export PATH=$PATH:/opt/LSF_Desktop_Client


5. Execute the paclogon command to log on to IBM Spectrum LSF Application Center. For example:
   URL:  http://AC_SERVER:8080/platform
   Username: A user that has permission to execute LSF commands
   Password: The user's password in Linux or MacOS
   Enter:

   $ paclogon
    Log on to IBM Spectrum LSF Application Center
    User account: tester
    Enter password: xxxx
    Specify the URL to connect to IBM Spectrum LSF Application Center. Format:
    http://host_name:port_number/platform or https://host_name:port_number/platform
    URL: http://AC_SERVER:8080/platform
    You have successfully logged on to IBM Spectrum LSF Application Center.

6. Execute other commands of LSF Desktop Client. For example:
   $ bsub sleep 100
   Job <17888> is submitted to default queue <normal>.

Copyright and trademark information
©Copyright IBM Corporation 2021
U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. 
IBM®, the IBM logo and ibm.com® are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml
