ibm was base #1

Description

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


Software & terms:

ibm-was-base ›

WebSphere Application Server Base Edition

Overview

WebSphere Application Server is a proven, high-performance transaction engine that can help build, run, integrate, and manage dynamic web applications.
For details on IBM WebSphere Application Server Base, as well as information on purchasing, please visit: Product Page and at the Passport Advantage Site. More information available at the IBM Knowledge Center.

This charm is using IBM Installation Manager to install IBM WebSphere Application Server Base Software. This charm is using the ibm-im charm as as base layer to install the Installation Manager tool.

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.

Packages for Ubuntu on AMD64 (x86_64):

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

IBM WAS Base 8.5.5 part1 (WAS_V8.5.5_1_OF_3.zip)

IBM WAS Base 8.5.5 part2 (WAS_V8.5.5_2_OF_3.zip)

IBM WAS Base 8.5.5 part3 (WAS_V8.5.5_3_OF_3.zip)

Packages for Ubuntu on Power (ppc64le):

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

IBM WAS Base 8.5.5 part1 (WAS_V8.5.5_FOR_POWERLE_ML.zip)

IBM WAS Base 8.5.5 part1 (WAS_V8.5.5_2_OF_2_FOR_POWERLE_ML.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 and was-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

Minimum 2.0 GB of disk space for installed image and Minimum 1 GB of physical memory recommended.

The WebSphere Application Server charm requires 15 GB of root disk to download packages and install IBM WebSphere Application Server Base Edition. By default, available root disk space is 8GB.

To request a larger root disk, run the following command:

    juju set-constraints root-disk=15G

Deploy

  1. Run the following commands to deploy this charm:
    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 ibmcharmers/ibm-im/1 ibm-was-base/2
  1. 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 config ibm-was-base profile_name=<profile_name>
    juju config ibm-was-base profile_path=<profile_path>
    juju config ibm-was-base was_admin_user=<user_name>
    juju config ibm-was-base was_admin_pw=<password>
    

    For eg:

    juju config ibm-was-base profile_name="profile01"
    juju config ibm-was-base profile_path="/opt/profiles"
    juju config ibm-was-base was_admin_user="admin1"
    juju config ibm-was-base was_admin_pw="admin123"
    

Note: If a relation is established between WAS Base and IHS, please remove the relation before changing these config options.

If any of these values are not set, the charm will use default values for profile creation. Once WAS Base charm is deployed successfully, users can add or remove profiles by setting any of these configuration options.

  1. To expose the IBM WAS Base charm, run the following command:
    juju expose ibm-was-base
    

Upgrade

Once deployed, users can upgrade the existing installation by installing fixpacks:

If user wants to upgrade existing installation of Installtion Manger, run the following command:

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

To upgrade WAS Base installation:

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:

    http://was-base-host:9060/ibm/console
    https://was-base-host:9043/ibm/console

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

To login to the WAS Base admin console, use the user name and password created in step 2 of the Deploy section.

Relating with IBM HTTP Server charm

Install a web server, such as IBM Http Server (IHS) in the machine where IBM WebSphere Application Server Base is installed. IHS provides 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 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 following command:

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

Configuration

profile_name

The profile name is used to create application server profile.

profile_path

The location of the profile to be created.

was_admin_user

Admin user name to log in WAS admin console

was_admin_pw

The password used to log in WAS admin console.

IBM Installation Manager(IM) Information

(1) General Information
Details about IM available at IBM Knowledge Center.

(2) Download Information
Information on procuring IM product is available at the Product Page
and at the Passport Advantage Site.

IBM WebSphere Application Server Base Information

(1) General Information

Details about IBM WAS Base software available at IBM Knowledge Center.

Information on procuring WAS Base product is available at the Passport Advantage site

(2) Download Information

Details about WAS 8.5.5.0 download available [here] [[WAS-8.5.5.0-download]

Information about installation of WAS Base on 'ppc64le' based machine available here

More information about IBM IM Downloadable file and WAS Base Downloadable files available here

Contact Information

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

Configuration

was_admin_pw
(string) The password used to log in WAS admin console.
wsadmin
profile_name
(string) The profile name is used to create application server profile.
AppSrv01
was_admin_user
(string) Admin user name to log in WAS admin console.
wsadmin
profile_path
(string) The location of the profile to be created.
/root/IBM/WebSphere/AppServer/V85/BASE/profiles