Overview

IBM Platform LSF Storage v9.1.3

IBM Platform LSF is a powerful workload management platform for demanding, distributed High Performance Computing (HPC) environments.
It provides a comprehensive set of intelligent, policy-driven scheduling features that enable you to utilize
all of your compute infrastructure resources and ensure optimal application performance.

IBM Platform LSF Storage will act as a shared repository (LSF will be installed only on Storage Server) for a LSF Cluster comprising of LSF Master/Master-Candidates and LSF Server. LSF will be installed and installation/configuration files will be shared with other hosts.

For details on IBM Platform LSF, as well as information on purchasing,
please visit:

Product Page and at the Passport Advantage Site.

More information available at the IBM Knowledge Center

Please note that the LSF charms (LSF Storage, LSF Master and LSF Server) will create LSF cluster having same host type (either x86 or ppcle). LSF supports different host types to be part of LSF Cluster. But the LSF charms as of now supports same host type model only(So all the hosts ie master, server should have same machine architecture either x86 or ppcle).

Prerequisites

This charm makes use of resources, a feature only available in Juju 2.0. During deploy, you will need to specify the installable package(s)
required by this charm. Download your licensed IBM Platform LSF Standard 9.1.3 version for Ubuntu. To acquire and download IBM Platform
LSF, follow instructions available at the Product Page.

This charm will deploy only the Standard edition for Platform LSF.

For x86_64 Ubuntu, the packages and their part numbers are:

IBM Platform LSF V9.1.3 Installer Package for Linux x86-64 (CN2PJEN) - lsf9.1.3_lsfinstall_linux_x86_64.tar.Z
IBM Platform LSF V9.1.3 Installation Package for LINUX on x86-64 Kernel 2.6 & 3.x English (CN11MEN) - lsf9.1.3_linux2.6-glibc2.3-x86_64.tar.Z

For Power Ubuntu, the packages and their part numbers are:

IBM Platform LSF V9.1.3 Installer Package for Linux on Power 8 LE English (CN5AGEN) - lsf9.1.3_lsfinstall_linux_ppc64le.tar.Z
IBM Platform LSF V9.1.3 Installation Package for Linux on Power 8 LE English (CN5AHEN) - lsf9.1.3_lnx310-lib217-ppc64le.tar.Z

As the charm will be deploying LSF Standard Edition, the platform_lsf_std_entitlement.dat file
will be same across the LSF Standard Edition packages. The part number for the entitlement file is:

IBM Platform LSF V9.1.3 Standard Edition Entitlement File Multiplatform English (CN11PEN ) - platform_lsf_std_entitlement.dat

Usage

To use this charm, you must agree to the Terms of Use. You can view the full license for IBM Platform LSF by visiting
the Software license agreements search website.

Search for "IBM Platform LSF, V9.1.3" and choose the license that applies to the version you are using.

Deploy

This charm uses NFS for file sharing (Note: No separate NFS charm required, it is handled by LSF code only). If you are deploying the LSF charm on a LXC/LXD container, such as the juju local provider, there are additional steps that need to be taken prior to deployment due to NFS limitation on LXC/LXD containers.

On the LXC/LXD host:

   apt-get install nfs-common
   modprobe nfsd
   mount -t nfsd nfsd /proc/fs/nfsd

For LXC only:
Edit /etc/apparmor.d/lxc/lxc-default and add the following three lines to it:

   mount fstype=nfs,
   mount fstype=nfs4,
   mount fstype=nfsd,
   mount fstype=rpc_pipefs,

after which:

   sudo /etc/init.d/apparmor restart

For LXD only

   lxc profile set default raw.apparmor "mount fstype=nfs,
   mount fstype=nfs4,
   mount fstype=nfsd,
   mount fstype=rpc_pipefs,"

   lxc profile set default security.privileged true

Once this is done, then you can deploy your IBM Platform LSF Storage charm.

This charm will deploy LSF storage Server. LSF Storage Server will act as a shared repository where LSF will be installed.
All the other hosts i.e. Master/Master Candidates and Servers will be accessing this Storage server. The shared LSF directory
/usr/share/lsf will be mounted to each host.

To configure a LSF Cluster, you need to deploy LSF Storage Server, Master/Master-Candidate and Server.
This charm will deploy only LSF Storage, You need to deploy IBM Platform LSF Master and IBM Platform LSF Server charm to have
a working LSF Cluster.

Run the following commands to deploy this charm:

juju deploy ibm-platform-lsf-storage \
  --resource ibm_lsf_installer=</path/to/installer.tar.Z> \
  --resource ibm_lsf_installation_x86=</path/to/distribution.tar.Z> \
  --resource ibm_lsf_entitlement_file=</path/to/entitlement.dat>

LSF Storage charm requires three resources for its installation, the LSF Installer package, Installation/Distribution package and the Entitlement file. If any one of these resources is not provided, the charm will not allow further installation until the missing resource is provided.

Note 1: The resource for getting the Installation/Distribution is different for x86 and Power, so if you are deploying on x86 machines, use resource name as
ibm_lsf_installation_x86 and for Power as ibm_lsf_installation_ppcle.

Note 2: This charm requires acceptance of Terms of Use. When deploying from the Charm Store, these terms will be presented to you for your consideration.
To accept the terms:

juju agree ibm-platform-lsf/1

Once you have agreed to the Terms, then only the LSF Storage charm will be deployed.

Relations with IBM Platform LSF Master and LSF Server charms

The IBM LSF Storage charm in itself is not useful until a relation is established between LSF Storage and LSF Master Charm.
Please refer to IBM Platform LSF Master and IBM Platform LSF Server charm README for more details.

Installation Verification

Once your IBM Platform LSF is installed successfully, you can login into the container and go the LSF Install path: cd /usr/share/lsf where all LSF configuration and bin files will be present.

Please Note that this is a Storage Server, this host will not be part of LSF Cluster, so LSF Daemons will not be running

IBM Platform LSF Information

(1) General Information

Information on IBM Platform LSF available at the IBM Knowledge Center

(2) Download Information

Information on procuring IBM Platform LSF product is available at the
Passport Advantage Site

(3) License

License information for IBM IM can be viewed
Software license agreements search website

(4) Contact Information

For issues with this charm, please contact IBM Juju Support Team jujusupp@us.ibm.com

(5) Known Limitations

This charm makes use of Juju features that are only available in version 2.0 or
greater.