websphere liberty #4

Description

Liberty profile is a dynamic profile of IBM WebSphere Application Server (WAS)
that enables the WAS server to provision only the features required by the
application (or set of applications) deployed to the server.

Overview

WebSphere Application Server Liberty Profile

Liberty Profile is a dynamic profile of IBM WebSphere Application Server (WAS)
that enables the WAS server to provision only the required features of an
application (or set of applications) deployed to the server.

If an application only requires a servlet engine, then all that starts is the
WAS kernel, the HTTP transport and the web container. Which is fast to bring
up and has an small footprint.

The WAS Liberty profile provides a development-centric approach to configuring
the server. Configuration is through a simple XML file which is easy to author,
maintain in a version control system, share across and between development
team, and diff for changes.

Usage

If you are on IBM Power8 hardware (ppc64le), you can take advantage of the IBM
Java Software Development Kit (SDK). To do so, you must read and agree to the
terms and conditions found in the IBM Java license. The license can be found
in the IBM-Java-license.txt file in the charm directory or by going
here and click on Download to view the license for that version.
Please check for the license associated with the IBM JDK version that you use.

For POWER LE machines, IBM Java can be installed. Copy your licensed sdkibmppc64le.tar.gz
to the files/archives directory before deploying the charm. Installing this is optional as the default OpenJDK can be used instead.
You will need to set accept-ibm-java-license to True to install IBM Java.

The license for Websphere Liberty can be found in the license file in
the charm directory under files/archives after deploying the charm or by going
here and click on Download to view the license for version 8.5.5.5.
Please check for the license associated with the Websphere Liberty version that you use.

The charm downloads the 16.0.0.4 version of the Websphere Liberty runtime and its'
associated license from IBM.

Run the following to deploy this charm:

juju deploy websphere-liberty

At this point the charm will wait until the user accepts the license. If you
agree to the license, run the following command:

juju config websphere-liberty accept-ibm-websphere-license=True

By default the charm will deploy the 16.0.0.4 websphere liberty version from
the repository. To install a specific version of WebSphere Liberty, run the
following command:

juju config websphere-liberty ibm-liberty-version="8.5.5.8"

If using a version of WebSphere Liberty that is not the default (16.0.0.4),
please provide the checksum value of the file which you want to install:

juju config ibm-websphere-liberty sha_wlp="<checksum value>"

You can find the checksum value of the file using the following command:

sha512sum <file name>

Expose the application with juju expose websphere-liberty and browse to
http://ip-address:9080 to view WebSphere Liberty Profile.

Configuration

jdk
The Java Development Kit to install for this charm. Options are
'default', and 'ibm'. The OpenJDK will be installed and used by default.
To use the IBM JDK you must read and accept the IBM Java license file.

accept-ibm-websphere-license
Before you can use, extract, or install IBM WebSphere Liberty Server,
you must accept the terms of International License
Agreement for Non-Warranted Programs and additional license information.
Please read the license agreement carefully.

The WebSphere software cannot be installed until the terms and
contions are accepted. The charm will not function correctly until the
this configuration option is set to True.

accept-ibm-java-license
The IBM Java software comes with special terms and conditions from IBM.
The IBM Java software can only be used by accepting the terms and
conditions found in the IBM-Java-license.txt file.

Setting this option to True indicates that you have read and accept the
IBM Java terms and conditions found in the license file. The license
file can be found in the root directory of the charm source in the
IBM-Java-license.txt file or by going
here.

The IBM Java software is optional, the OpenJDK will be used by
default if the license terms are not accepted.

install-petstore
Petstore is a web application written in Java used to test that
WebSphere Liberty Profile is working. The default value is True, but
set this to False if you do not want the test application installed.

ibm-liberty-version
The version of WLP which has to be installed. If nothing is mentioned,
it would install v16.0.0.4 (the latest current version).

sha_wlp:
Checksum value to check integrity of IBM WLP package. The Charm
uses sha512sum to check the integrity. The default is set to the checksum
of the WLP 16.0.0.4 archive.

WebSphere Liberty Profile Links and Information

Configuration

jdk
(string) The Java Development Kit to install for this charm. Options are 'default', and 'ibm'. The OpenJDK will be installed and used by default. To use the IBM JDK you must read and accept the IBM Java license file.
default
install-petstore
(boolean) Petstore is a web application written in Java used to test that WebSphere Liberty Profile is working. Set this to False if you do not want the test application installed.
True
ibm-liberty-url
(string) The URL to the file that has the link to latest IBM Liberty package and license. Modification of this value would not be required.
http://public.dhe.ibm.com/ibmdl/export/pub/software/websphere/wasdev/downloads/wlp/index.yml
accept-ibm-websphere-license
(boolean) The IBM WebSphere Liberty Profile software comes with special terms and conditions from IBM. The WebSphere software can only be used by accepting the terms and conditions found in the IBM-WebSphere-license.txt file. Setting this option to True indicates that you have read and accept the IBM WebSphere terms and conditions found in the license file. The license file can be found in the root directory of the charm source in the IBM-WebSphere-license.txt file. **The WebSphere software cannot be installed until the terms and contions are accepted. The charm will not function correctly until the this configuration option is set to True.**
sha_wlp
(string) Checksum value to check integrity of IBM WLP package. The Charm uses sha512sum to check the integrity. The default is set to the checksum of the WLP 16.0.0.4 archive.
3a2f23c7405a814075025ff1918c8889a60d57eb32309730efd5d3b9392c4e6f9d0a0c9c75ef8105ae0254187ed3c79941c236c8b1d49823bdb8c9327f7f62ac
ibm-liberty-version
(string) The version of WLP which has to be installed. If nothing is mentioned, it would install v16.0.0.4 (the latest current version).
16.0.0.4
accept-ibm-java-license
(boolean) The IBM Java software comes with special terms and conditions from IBM. The IBM Java software can only be used by accepting the terms and conditions found in the IBM-Java-license.txt file. Setting this option to True indicates that you have read and accept the IBM Java terms and conditions found in the license file. The license file can be found in the root directory of the charm source in the IBM-Java-license.txt file. The latest version of the license will be downloaded to <charm-dir>/files/archives on deployment of the charm. ** The IBM Java software is optional, the OpenJDK will be used by default if the license terms are not accepted. **
ibm-java-file
(string) The name of the IBM Java SDK package for POWER LE platform. If not set, the charm code defaults to sdkibmppc64le.tar.gz for POWER LE platform. Useful if you want to use a different (newer) version of the SDK. IBM SDK is installed only if jdk option is set to 'ibm'.