~ibmcharmers/charms/trusty/ibm-was-base/trunk

## Overview

This charm is used ibm-im(IBM Installation Manager) charm as a base layer for installing Installation Manager(IM). This charm is installing IBM Installation Manager and IBM WebSphere Application Server Base software. 

For details on IBM WebSphere Application Server Base, as well as information on purchasing, please visit: [Product Page] [was-product-page] and at the [Passport Advantage Site] [Passport].

IBM Installation Manager(IBM IM) is a tool that you can use to install and maintain your IBM software packages.

 

## Prerequisites

 

This charm makes use of resources, a feature only available in Juju 2.0. During deploy or upgrade, you will need to specify the installable package(s)

required by this charm. Download your licensed IBM WebSphere Application Server Base packages from the [Product Page][WAS-8.5.5.0-download].

 

### Packages for Ubuntu on AMD64 (x86_64):

 

IBM Installation Manager 1.8 (`agent.installer.linux.gtk.x86_64_1.8.3000.20150606_0047.zip`)

### Packages for Ubuntu on Power (ppc64le):

 

IBM Installation Manager 1.8 (`agent.installer.linux.gtk.ppc64le_1.8.3000.20150606_0047.zip`)

## Usage

        

To use this charm, you must agree to the Terms of Use. You can view the full license for `IBM Installation Manager` and `IBM WebSphere Application Server Base` products by visiting the [im-license-info](http://www-03.ibm.com/software/sla/sladb.nsf/displaylis/39AFC1C1D485C4E085257E7300548B05?OpenDocument) and [was-license-info] [license-info] page.

 

Search for "IBM WebSphere Application Server" and choose the license that applies to the version you are using.

 

 

## Memory and Disk Requirements

 

### Deploy

 

 

 

                juju deploy ibm-was-base --resource ibm_im_installer=</path/to/ibm_im_installer.zip> --resource ibm_was_base_installer1=</path/to/ibm_was_base_installer1.zip> --resource ibm_was_base_installer2=</path/to/ibm_was_base_installer2.zip> --resource ibm_was_base_installer3=</path/to/ibm_was_base_installer3.zip> 

        

        

**Note**: This charm requires acceptance of Terms of Use. When deploying from the Charm Store, these terms will be presented to you for your consideration.

To accept the terms:

 

                juju agree ibm-im/1 ibm-was-base/2

 

                

2. To create application server profile, `manageprofiles` command needs values for profile name, profile path, user name and password. To provide these run the following command:

 

            juju set ibm-was-base profile_name=<profile_name>

            juju set ibm-was-base profile_path=<profile_path>

            juju set ibm-was-base was_admin_user=<user_name>

            juju set ibm-was-base was_admin_pw=<password>

                

        For eg:

 

            juju set ibm-was-base profile_name="profile01"

            juju set ibm-was-base profile_path="/opt/profiles"

            juju set ibm-was-base was_admin_user="admin1"

        juju set ibm-was-base was_admin_pw="admin123"

        If any of these values is not set, then the charm will use default values for profile creation. Once WAS Base charm deployed successfully, user can also delete existing profile and create new application server profile by setting any of these configuration options.

3. To Expose the IBM WAS Base Service to public, run the following command:

 

            juju expose ibm-was-base

 

                

### Upgrade

 

Once deployed, users can install fixpacks by upgrading the charm:

 

                juju attach ibm-was-base ibm_im_fixpack=</path/to/fixpack.zip>

                juju attach ibm-was-base ibm_was_base_fp1=</path/to/ibm_was_base_fp1.zip>

                juju attach ibm-was-base ibm_was_base_fp2=</path/to/ibm_was_base_fp2.zip>

                

                

### Verification

 

After installing IBM WebSphere Application Server Base, use your web browser to see the WebSphere Application Server admin console. The URLs for WAS Base admin console are:

Here was-base-host represents the public ip address of your machine, where WAS Base is installed. 

 

To login the WAS Base admin console use userid and password created in step 2 in `Deploy` section.

 

 

## Relating with IBM HTTP Server charm

 

Install a web server, such as IBM Http Server in the machine where IBM WebSphere Application Server Base installed. It provides the more configuration options and additional layer of security for applications deployed on WAS Base. Installing a web server plug-in enables the web server to communicate with the application server.

 

Here IBM WAS Base charm is related to IBM HTTP Server(IHS) subordinate charm. To add a relation, run the following command:

 

                juju add-relation ibm-was-base ibm-http

        

When IBM WAS Base charm is related to IBM HTTP Server charm, 'IBM Http Server', 'Web Server Plug-ins for WebSphere Application Server' and 'WebSphere Customization Toolbox' will be installed and configured. The web server definition is automatically created and configured during the configuration of the plug-in. Once IHS configured and admin server started, server status will be sent to the WAS Base charm to automatically propagate the plugin.xml file to IHS server. This plugin.xml file contains the WAS Base server details to redirect incoming requests to the WAS Base Server.

 

### Verification

 

After establishing relation between IBM WAS Base and IBM Http Server charm, you can verify by accessing the sample servlet available in WAS Base using IHS URL and IHS running port 80:

 

                http://ihs-host-name:80/snoop

        

Here ihs-host-name represents the public ip address of your machine, where WAS Base and IHS deployed(IHS is subordinate charm so WAS Base and IHS charms will be deployed on same machine). 'snoop' is the sample servlet on WAS Base server to test the connection between WAS Base and IHS.

 

To remove the relation, run the follwing command:

 

                juju remove-relation ibm-was-base ibm-http

        

 

## Configuration

## IBM Installation Manager(IM) Information

 

## IBM WebSphere Application Server Base Information

 

## Contact Information

 

[license-info]: http://www-03.ibm.com/software/sla/sladb.nsf/lilookup/9FF995C8B656580C85257E66003B3EFC?OpenDocument