~ibmcharmers/charms/trusty/ibm-platform-rtm/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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
Charm for IBM Platform RTM v9.1.4

Overview
--------

IBM Platform RTM v9.1.4

IBM Platform RTM is an operational dashboard for IBM Platform LSF environments that provides comprehensive workload monitoring, reporting and management. It makes cluster administrators more efficient in their day-to-day activities and provides the information and tools needed to improve cluster efficiency, enable better user productivity, and contain or reduce costs. Unlike other monitoring tools that focus on just one facet of cluster monitoring, Platform RTM provides a complete, integrated monitoring facility that is designed specifically for Platform LSF environments. It enables you to monitor multiple clusters easily and effectively through a single intuitive interface.

Platform RTM provides comprehensive workload monitoring, reporting and management tools to increase productivity, reduce costs and position your employees to work more effectively. Organizations using Platform RTM can benefit from:

	- Cluster monitoring and control.
	- Flexible charting options.
	- Job-level profiling.
	- Ability to monitor resource consumption and allocation.
	- Automated alerts and exception handling.
	- License monitoring: support for FlexNet, Reprise License Manager (RLM) license managers
	- IBM Platform LSF performance monitoring

For details on Platform RTM usage and its benefits please visit [RTM Product Page.] [product-page]  For information on purchasing, please visit [Passport Advantage Site][passport-rtm].

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


Usage
-----

Download your licensed `IBM Platform RTM 9.1.4`. This charm will deploy Platform RTM v9.1.4. To download and install the code contained in this charm you must agree to the IBM license. You can view the full license for IBM Platform RTM by visiting the [Software license agreements search website][license-info].

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

	IBM Platform RTM V9.1.4 datapoller package for Ubuntu 14.04 for Power 8 LE (CN6XGEN)
	IBM Platform Plugins and Cacti-Update packages for Ubuntu 14.04 for Power 8 LE English (CN6X7EN)


Deploy
------

IBM Platform RTM Ubuntu 14.04 ppc64le works only with version of MariaDB Server 5.5. Both Mariadb and Platform RTM have to be deployed in the same machine. The user has to deploy Mariadb server from charm store as shown below:

	juju deploy mariadb

If you see any issues while deploying Mariadb, please set `dataset-size` in order to allocate memory for all caches as shown below:

	juju set mariadb dataset-size="256M"

For more information on Mariadb deployment and configuration, please visit charm store [link.][mariadb-charm]

Then, run the following command to deploy IBM Platform RTM charm.

	juju deploy ibm-platform-rtm --to <machine-id>

`<machine-id>` is the container where Mariadb is deployed.

Platform RTM Charm downloads the install packages from an SFTP server that can be setup in your network. An action called 'download' is provided for the same:

    juju action do <unit name> download username=<sftp user> password=<sftp password> packagedir=<full path to repository directory> host=<sftp host name>

The packagedir path should end with a directory name that is same as this charm name (ibm-platform-rtm) and should contain the packages that are to be downloaded.

At this point Platform RTM install will wait for you to accept the License. To install the downloaded binaries you must agree to the IBM license. If you agree to the license, run the following command in the example: (without accepting License Platform RTM cannot be installed)

EULA value, URL and package names in the config.yaml can be set by running:

	juju set <service> <option>=<value>

e.g.    
    
	juju set ibm-platform-rtm accept-ibm-prtm-license=True

For adding the relation, run the below command

	juju add-relation ibm-platform-rtm mariadb

To remove relation between Mariadb and Platform-rtm, run the below command (Please remove-relation between Platform-rtm and Mariadb before uninstalling platform RTM)

	juju remove-relation ibm-platform-rtm mariadb

After installing IBM Platform RTM, Use your web browser to start the Platform RTM Console. The URL for the Platform RTM Console is http://rtm_host where rtm_host is either the Platform RTM host name or IP address.

e.g.

	http://rtm_host

Here rtm_host is an ip address where Platform RTM is installed. And specify the Platform RTM administrator name and password. The default administrator name is admin, and the default password for this account is admin

Configuration
-------------

See config.yaml file for more information.

`accept-ibm-prtm-license`
	The IBM Platform RTM software can only be used by accepting the terms and conditions for IBM Platform RTM License. Setting this option to True indicates that you have read and accepted the IBM Platform RTM terms and conditions found in the license file. The details about accessing the license(s) can be found in the README.

`prtm_datapoller_pkg_sha`
	Checksum value to check integrity of IBM Platform RTM datapoller package. The Charm uses sha1sum to check the integrity. If empty, it does not carry out the integrity check. The command to find the checksum is sha1sum <Package Name> | cut -d" " -f1

`prtm_server_pkg_sha`
	Checksum value to check integrity of IBM Platform RTM server package. The Charm uses sha1sum to check the integrity. If empty, it does not carry out the integrity check. The command to find the checksum is sha1sum <Package Name> | cut -d" " -f1


IBM Platform RTM Information
----------------------------

(1) General Information

Information on IBM Platform RTM available at the [IBM Knowledge Center] [platform-rtm-info]

(2) Download Information

Information on procuring IBM Platform RTM product is available at the [Passport Advantage Site][passport-rtm]

(3) Contact Information

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

<!-- Links -->

[product-page]: http://www-03.ibm.com/systems/platformcomputing/products/lsf/rtm.html

[passport-rtm]: http://www-01.ibm.com/software/passportadvantage/

[license-info]: http://www-03.ibm.com/software/sla/sladb.nsf/searchlis/?searchview&searchorder=4&searchmax=0&query=%28IBM+Platform+RTM%29

[platform-rtm-info]: http://www-01.ibm.com/support/knowledgecenter/SSVMSD_9.1.4/install/install_rtm_ubuntu.dita

[mariadb-charm]: https://jujucharms.com/u/ibm-demo/mariadb/trusty/2