ibm platform symphony #2

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