~ibmcharmers/charms/xenial/layer-ibm-was-base/devel

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
Charm for IBM WebSphere Application Server Base (WAS Base) 9.0.0

## 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] [was-product-page] and at the [Passport Advantage Site] [Passport]. More information available at the [IBM Knowledge Center] [WAS-Infocenter].

`IBM WebSphere Application Server Base`

This charm is using IBM Installation Manager to install IBM WebSphere Application Server Base Software. To install Installation Manager tool, ibm-im charm is used as a base layer for this charm.

`IBM SDK, Java Technology Edition`

WebSphere Application Server now uses a separately packaged, IBM Java SDK. It requires Java SDK version 8.

## 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 and IBM SDK, Java Technology Edition from the [Product Page][WAS-9.0.0-download].

### Packages for Ubuntu on Z (s390x):

IBM Installation Manager 1.8 (`agent.installer.linux.gtk.s390x_1.8.5000.20160506_1125.zip`)(CND0XML)

IBM WAS Base V9.0 (`was.repo.9000.base.zip`) (CND1AML)

IBM SDK, Java Technology Edition, V8 (`sdk.repo.8030.java8.linux.zip`) (CND18ML)


## Usage

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


## Memory and Disk Requirements

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

WebSphere Application Server Charm requires 15 GB of root disk to download packages and install the IBM WebSphere Application Server Base Software. 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_installer=</path/to/ibm_was_base_installer.zip> --resource ibm_java_sdk_installer=</path/to/ibm_java_sdk_installer.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/2 ibm-was-base/3 ibm-java-sdk/1
	juju deploy ibm-was-base


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 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 relation established between WAS Base and IHS, Please remove the relation before changing these config options.

If any of these values is not set, then the charm will use default values for profile creation. Once WAS Base charm is 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, user 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_fp=</path/to/ibm_was_base_fp.zip>
	juju attach ibm-was-base ibm_java_sdk_fp=</path/to/ibm_java_sdk_fp.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 WAS Base admin console use user name and password created in step 2 in `Deploy` section.


## 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][Im-info].

(2) Download Information
Information on procuring IM product is available at the [Product Page][im-product-page]
and at the [Passport Advantage Site][passport].	

## IBM WebSphere Application Server Base Information

(1) General Information 

Details about IBM WAS Base software available at [IBM Knowledge Center] [WAS-Infocenter].

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

(2) Download Information

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

Details about IBM Java SDK version 8 download available [here] [java-sdk-download]

More information about IBM IM Downloadable file and WAS Base Downloadable files available [here] [IBM-IM-more-info]

## Contact Information

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

<!-- Links -->

[IM-info]: http://www-01.ibm.com/support/knowledgecenter/SSDV2W/im_family_welcome.html

[im-product-page]: http://www-01.ibm.com/support/docview.wss?uid=swg27025142

[WAS-Infocenter]: http://www.ibm.com/support/knowledgecenter/SSEQTP_9.0.0/com.ibm.websphere.base.doc/ae/welcome_base.html

[was-product-page]: http://www-03.ibm.com/software/products/en/appserv-was

[WAS-9.0.0-download]: http://www-01.ibm.com/support/docview.wss?uid=swg27048319

[java-sdk--download]: http://www-01.ibm.com/support/docview.wss?uid=swg27048319#jdk

[Passport]: http://www-01.ibm.com/software/passportadvantage/

[IBM-IM-more-info]: http://www-01.ibm.com/support/docview.wss?uid=swg24038380

[was-license]: http://www-03.ibm.com/software/sla/sladb.nsf/lilookup/E0B1C3C1F5B537F285257FDF00359288?OpenDocument

[java-sdk-license]: http://www-03.ibm.com/software/sla/sladb.nsf/lilookup/292DB2B39A911D6485257FD10065CAAA?OpenDocument