ibm platform symphony #2

Supports: trusty

Description

IBM Platform Symphony (Symphony) is enterprise-class software that distributes and virtualizes compute-intensive application services and processes across existing heterogeneous IT resources


Charm for IBM Platform Symphony

Overview

IBM Platform Symphony (Symphony) is enterprise-class software that distributes and virtualizes compute-intensive application services and processes across existing heterogeneous IT resources

Usage

To install Platform Symphony, you need to download the packages for Ubuntu and create an apt repository. To acquire and download Platform Symphony, login to fixcentral: IBM Fix Central.

From fix central, select Platform Computing for the product group, then select Platform Symphony from the "Select from Platform Computing" dropdown, then select 7.1 from Installed Version dropdown, then select "All" for Platform and press Continue. Again, press continue on the next page to browse for fixes. Then it shows list of fixes Download 7.1 build: sym-7.1-build335711

If your platform is x86_64, then download: Master Image: symsetup7.1_lnx26-lib23-x64.bin Node Image: symcompsetup7.1_lnx26-lib23-x64.bin

If your platform is ppc64, then download: Master Image: symsetup7.1_lnx26-lib25-ppc64.bin Node Image: symcompsetup7.1_lnx26-lib25-ppc64.bin

Download the key file from Passport Advantage: Passport Advantage Site.

Key file name is: platform_sym_adv_entitlement.dat

Creating the repositories

Run steps below with admin access

Install needed packages apt-get install dpkg-dev apache2

Create the repository on apache server Under your apache repository directory cd mkdir Platform-symphony Place the downloaded Platform Symphony Host, Compute Host and entitlement files in the above directory

Configure apache server to allow access to the repository Configure config.yaml with the repository url

symphony_url: "http://<server-name>/<REPOSITORY_DIR/Platform-symphony"

Deploy

For creating Platform Symphony cluster , deploy Master host and compute host, as shown below:

juju deploy ibm-platform-symphony platform-symphony-master
juju deploy ibm-platform-symphony platform-symphony-node

At this point Platform Symphony install will wait for you to accept the License. To install the downloaded binaries you must agree to the IBM license. The license file(s) can be found in the product binaries you downloaded.

If you agree to the license, run the following command:(without accepting License Platform Symphony cannot be installed)

juju set platform-symphony-master accept-ibm-symphony-license=True
juju set platform-symphony-node accept-ibm-symphony-license=True

Add relation between the platform-symphony-node and platform-symphony-master charm

juju add-relation platform-symphony-node:node platform-symphony-master

Growing Cluster

You can add more client nodes to the master, by redeploying the charm, as shown below

juju deploy ibm-platform-symphony platform-symphony-node1
juju deploy ibm-platform-symphony platform-symphony-node2 ....and so on

If you have added more nodes, then accept license for those machines as well:

juju set platform-symphony-node1 accept-ibm-symphony-license=True
juju set platform-symphony-node2 accept-ibm-symphony-license=True

For each of the added nodes, add relation between the platform-symphony-master and new node, like

juju add-relation platform-symphony-node1:node platform-symphony-master
juju add-relation platform-symphony-node2:node platform-symphony-master

Note:

1 If any changes are made to Master node ,like upgrade ,setting license to False ,please ensure to remove the existing relations between the master and slave nodes.

2 Master and slave nodes cannot be deployed on same container.Also multiple slave nodes cannot be installed on the same container

Verification

To verify the cluster setup through symping , run the below command: juju set platform-symphony-master verify_cluster=True After verification, set back the platform-symphony-master verify_cluster to False, to avoid it being called after each config changed juju set platform-symphony-master verify_cluster=False

Configuration

accept-ibm-symphony-license Before you can use or install IBM Platform Symphony, you must accept the terms of International License Agreement for Non-Warranted Programs and additional license information. Please read the license agreement carefully.

Set the value of accept-ibm-symphony-license to True if you agree to IBM Platform Symphony license. License information for IBM Platform Symphony is available here.

symphony_url URL where lies the repository packages for Platform Symphony.

package Name of Symphony master/node image in .bin format.

key_file Name of entitlement file in .dat format.

verify_cluster True to run verification code.

sha Checksum value to check integrity of IBM Platform Symphony package. The Charm uses sha1sum to check the integrity. If empty, it does not carry out the integrity check. Use sha1sum <Package Location/Package Name> | cut -d" " -f1 to find out Checksum value for downloaded package. Cryptographic value should be altered by the user only when the package name is change. Else it should not be altered.

sha_key Checksum value to check integrity of IBM Platform Symphony Key file. The Charm uses sha1sum to check the integrity. If empty, it does not carry out the integrity check. Use sha1sum <Package Location/Package Name> | cut -d" " -f1 to find out Checksum value for downloaded package. Cryptographic value should be altered by the user only when the package name is change. Else it should not be altered.

See config.yaml file for more information.

The IBM Platform Symphony software cannot be installed until the terms and conditions are accepted. The charm will not function correctly until the configuration option is set to True.

Contact Information

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


Configuration

accept-ibm-symphony-license
(boolean) IBM Platform Symphony (Symphony) is enterprise-class software that distributes and virtualizes compute-intensive application services and processes across existing heterogeneous IT resources. Do not set this value to False if a relation is exists
key_file
(string) Entitlement key file name of platform symphony
package
(string) Name of the Platform Symphony package. If not set, the Charm uses a predefined package name for download from the url location. If the predefined package is not available at url location or if set incorrectly, the charm cannot install the Platform Symphony software.
sha
(string) Checksum value to check integrity of IBM Platform Symphony package. The Charm uses sha1sum to check the integrity. If empty, it does not carry out the integrity check. Refer README file to find out Checksum value for downloaded package. Cryptographic value should be altered by the user only when the package name is change. Else it should not be altered.
sha_key
(string) Checksum value to check integrity of IBM Platform Symphony Key file. The Charm uses sha1sum to check the integrity. If empty, it does not carry out the integrity check. Refer README file to find out Checksum value for downloaded package. Cryptographic value should be altered by the user only when the package name is change. Else it should not be altered.
symphony_url
(string) Download url for Platform Symphony packages. If not set or set incorrectly, the charm cannot install the Platform Symphony software.
verify_cluster
(boolean) Parameter to execute cluster verification which actually used to send workload to a cluster to test and verify that Symphony components are working and responsive.