~ibmcharmers/charms/trusty/layer-ibm-platform-lsf-server/trunk

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
Charm for IBM Platform LSF Server V9.1.3


Overview
--------

IBM Platform LSF Server

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.

A `LSF Server` host is a server host that are capable of submitting and executing jobs. They cannot be selected as LSF Master incase the designated LSF Master goes down.

More information available at the [IBM Knowledge Center] [platform-lsf-info]



Usage
-----

This charm will not download the LSF Binaries as its being handled by `IBM Platform LSF Storage` Charm.
The LSF installation files will be shared when a relation is added between LSF Storage and LSF Server (using NFS).


Deploy
------

This charm will deploy `LSF Server`. `LSF Server` is a server host that are capable of submitting and executing jobs in a
LSF Cluster.

To configure a LSF Cluster, you need to deploy `LSF Storage`, `LSF Master` charm.
This charm will deploy only LSF Server. Functionally this charm will do nothing, to have a working LSF Cluster you need to add relation between Storage Charm(LSF Storage charm will share the LSF Installation files(/usr/share/lsf)) and LSF Master charm to add this Server host as part of LSF Cluster.

To deploy IBM Platform LSF Server Charm, follow the below steps:
     
     juju deploy ibm-platform-lsf-server
     juju deploy ibm-platform-lsf-storage
     juju add-relation ibm-platform-lsf-storage ibm-platform-lsf-server
     juju add-relation ibm-platform-lsf-master ibm-platform-lsf-server

To add more units of LSF Server

     juju add-unit ibm-platform-lsf-server
This will add one more LSF Server host to your existing LSF Cluster.

### Verification of LSF Cluster
Once the IBM Platform LSF Server is deployed successfully and relation is established between LSF Storage and LSF Server and LSF Master and LSF Server, you can verify your LSF cluster by running some lsf commands as mentioned below:
- Login into the machine where LSF Server is installed as lsf administrator user `lsfadmin`
- Export the lsf profile path: `. /usr/share/lsf/conf/profile.lsf`
- Go to the path  `/usr/share/lsf/9.1/linux2.6-glibc2.3-x86_64/bin(the distribution folder will change based upon Operating System, for Power the path would be /usr/share/lsf/9.1/linux3.10-glibc2.17-ppc64le/bin` and you can issue commands like `lsid`, `lshosts`, `bhosts` to verify your cluster is up and fine.
- For submitting jobs you can issue command `bsub` `<job>`, for example: `bsub pwd`


### To remove the units of LSF Server
    
     juju remove-unit <unit name of the LSF Server you want to remove>
This will remove the unit from the existing LSF Cluster. (LSF conf files will be updated and LSF files will be unmounted)

#### Removing Relations
A LSF Server is related to IBM Platform LSF Storage charm as well as IBM Platform LSF Master charm. Incase you want to remove the relation between these, refer to the below steps:
      
     juju remove-relation ibm-platform-lsf-master ibm-platform-lsf-server
This will remove the server host information from the lsf configuration files and the server host will no longer be part of the existing LSF Cluster. The LSF Server Daemons will be stopped.
      
     juju remove-relation ibm-platform-lsf-storage ibm-platform-lsf-server
This will unmount the LSF shared installation files.


IBM Platform LSF Information
----------------------------
(1) General Information

Information on IBM Platform LSF available at the [IBM Knowledge Center] [platform-lsf-info]

(2) Contact Information

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

(3) Known Limitations

This charm makes use of Juju Status commands, and requires juju `1.24` or greater


<!-- Links -->

[license-info]: http://www-03.ibm.com/software/sla/sladb.nsf/search

[platform-lsf-info]: https://www-01.ibm.com/support/knowledgecenter/SSETD4_9.1.3/lsf_kc_unix_install.dita