Overview

WebSphere Application Server is a proven, high-performance transaction engine that can help build, run, integrate, and manage dynamic web applications.

Usage

To download and install the code provided by this charm, you must agree to the IBM licenses. The license files can be found in the root directory of the charm source. See the accept_ibm_im_license and accept_ibm_websphere_license configuration descriptions for more details.

Run the following to deploy this charm:

juju deploy was-base

At this point, the charm will wait until you accept the licenses. To acknowledge acceptance, run the following commands:

juju set was-base accept_ibm_im_license=True
juju set was-base accept_ibm_websphere_license=True

Deployment will now proceed in one of two modes:

Trial Mode (default)

In this mode, the charm will install the included Installation Manager software. This software is pre-configured to download and install the latest WebSphere Application Server trial version. Before installation will proceed, you must provide IBM id credentials that will be used to authorize the download of this trial software. See IBM id registration if you need to register for an IBM id.

Issue the following commands to allow this charm to continue installation in Trial Mode:

juju set was-base ibm_id_name=<your ibm id>
juju set was-base ibm_id_pass=<your ibm id password>

Non-trial Mode

In this mode, the charm will retrieve installable packages from an HTTP repository that you have configured. See the repo_url configuration description for more details.

Creating a repository for Non-trial Mode

Install required packages on an available host:

sudo apt-get install dpkg-dev apache2

Upload the files listed in the repo_url configuration description to your web directory and configure Apache to serve content from that directory. Configure this charm to retrieve the necessary installation packages from your repository:

juju set was-base repo_url=http://<server-address>/<repo-directory>
juju set was-base websphere_trial=False

Post Deployment

Once deployment is complete, you can find the IP address for your new WAS instance by running the following:

juju status was-base

Navigate to http://<was-base-ip>:9060/ibm/console to view the WAS console. The default username and password are wasadmin.

Configuration

accept_ibm_im_license

The IBM Installation Manager software comes with special terms and conditions from IBM. The IBM Installation Manager software can only be used by accepting the terms and conditions found in the license file.

Setting this option to True indicates that you have read and accept the IBM Installation Manager 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-Installation-Manager-license.txt file.

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

accept_ibm_websphere_license

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

Setting this option to True indicates that you have read and accept the IBM WebSphere Application Server 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 Application Server software cannot be installed until the terms and conditions are accepted. The charm will not function correctly until the this configuration option is set to True.

ibm_id_name

Your IBM id name (usually an email address). This value is required when deploying in Trial Mode. See IBM id registration if you need to register for an IBM id.

ibm_id_pass

Your IBM id password. This value is required when deploying in Trial Mode. See IBM id registration if you need to register for an IBM id.

im_file_name

Installation Manager installable package name. The default value is the IM package included in this charm, pre-configured to install the latest WebSphere Application Server trial version.

repo_url

Location of the HTTP repository that serves WAS installable packages. At this time, WAS 8.5.5.0 + Fixpack 4 is supported. * WAS 8.5.5.0 download: http://www-01.ibm.com/support/docview.wss?uid=swg27038625 * WAS 8.5.5.4 fixpack download: http://www-01.ibm.com/support/docview.wss?uid=swg24038539

The following files are required to be present in your repository: * WAS_V8.5.5_1_OF_3.zip * WAS_V8.5.5_2_OF_3.zip * WAS_V8.5.5_3_OF_3.zip * 8.5.5-WS-WAS-FP0000004-part1.zip * 8.5.5-WS-WAS-FP0000004-part2.zip

websphere_trial

If True (the default), the Installation Manager will download and install the latest WebSphere Application Server trial version. This requires you to set ibm_id_name and ibm_id_pass configuration options. If False, you must make the required installation files accessible from an external repository and set the repo_url configuration option.

Contact Information

For issues with this charm, please contact jujusupp@us.ibm.com