ibm http #13

Supports: trusty

Add to new model

Description

IBM HTTP Server is a full-featured web server that is included with other products such as IBM WebSphere Application Server at no charge.


Software & terms:

Readme

IBM HTTP-SERVER 8.5

IBM Http Server is a full-featured web server that is included with other products such as IBM WebSphere Application Server at no charge. You can use this web server for projects that do not warrant the expense of a priced and supported http server. The IBM Http Server is based on the Apache Http Server and provides a rich set of Apache features in addition to IBM enhancements.

User guides and security guides to support this release are available for
online viewing User Guide

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 Http-Server packages from the
Product Page.

Package for Ubuntu on AMD64 (x86_64):

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

IBM Http-Server 8.5
(WAS_V8.5.5_SUPPL_1_OF_3.zip , WAS_V8.5.5_SUPPL_2_OF_3.zip , WAS_V8.5.5_SUPPL_3_OF_3.zip)

Package for Ubuntu on Power (ppc64le):

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

IBM Http-Server 8.5
(WAS_V8.5.5_SUPL_1_4_FOR_POWERLEML.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-HTTP-SERVER by visiting the im-license-info and http-license-info page.
Search for "IBM-Http-Server" and choose the license that applies to the version you are using.

IBM-Http-Server is built on top of the ibm-im layer More Info. So user has to provide the IBM-IM resource when deploying the ibm-http-server.

As IBM-Http charm is a subordinate charm, any principle charm (ibm-was-base/ibm-was-nd) should exist on a container before deploying http-server.

Deploy

Run the following commands to deploy this charm:

juju deploy ibm-http --resource ibm_im_installer=</path/to/installer.zip> --resource ibm_http_installer1=</path/to/installer1.zip> --resource ibm_http_installer2=</path/to/installer2.zip> --resource ibm_http_installer3=</path/to/installer3.zip>

IBM-Http charm has three components IHS,PLG,WCT. 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-http-server/2 ibm-http-plg/1 ibm-http-wct/1

Add a relation between ibm-http and any principle charm(ibm-was-base/ibm-was-nd):

juju add-relation ibm-http <principle charm>

Upgrade

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

juju attach ibm-http ibm_http_server_fixpack1=</path/to/fixpack.zip>
juju attach ibm-http ibm_http_server_fixpack2=</path/to/fixpack.zip>
juju attach ibm-http ibm_http_server_WCT_fixpack1=</path/to/fixpack.zip>
juju attach ibm-http ibm_http_server_WCT_fixpack2=</path/to/fixpack.zip>

Note: IBM-Http-Server has multiple fixpack packages. WCT component of ibm-http charm has a different package. User must make sure to provide all the packages required.

If user wants to upgrade the layer charm IBM-IM, provide the IM fixpack.

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

Installation Verification

Once deployed, you can use IBM Http-Server. To verify Http-Server is installed, list the contents of the installation directory:

juju run --application ibm-http 'ls /opt/IBM/HTTPServer'

Additional Information

General

Details about IBM Http-Server available here.

Download

Information on procuring IBM Http-Server product is available at the Product Page.

License

License information for IBM Http-Server can be viewed Here.

Known Limitations

This charm makes use of Juju features that are only available in version 2.0 or greater.

Contact Information

For issues with this charm, please contact IBM Juju Support Team.


Configuration

curl_opts
(string) The options passed to the 'curl' command when fetching files from curl_url. For example: '-u <user:password>'
curl_url
(string) Location of the IBM product installation file(s). This should be a URL that curl can use to download files. Multiple URLs should be separated by a space. NOTE: cryptographic verification is required and must be specified as part of the URL query string with the key a valid hash algorithms md5, sha256, or sha512, and the the checksum value itself (http://<url>?[md5|sha256|sha512]=<checksum>). For example: 'http://example.com/file.tgz?sha256=<sum>' 'sftp://example.com/file1.tgz?md5=<sum> ftp://example.com/file2.tgz?md5=<sum>'
extra_packages
(string) Space separated list of extra deb packages to install.
install_keys
(string) List of signing keys for install_sources package sources, per charmhelpers standard format (a yaml list of strings encoded as a string). The keys should be the full ASCII armoured GPG public keys. While GPG key ids are also supported and looked up on a keyserver, operators should be aware that this mechanism is insecure. null can be used if a standard package signing key is used that will already be installed on the machine, and for PPA sources where the package signing key is securely retrieved from Launchpad.
install_sources
(string) List of extra apt sources, per charm-helpers standard format (a yaml list of strings encoded as a string). Each source may be either a line that can be added directly to sources.list(5), or in the form ppa:<user>/<ppa-name> for adding Personal Package Archives, or a distribution component to enable.
license_accepted
(boolean) Some IBM charms require acceptance of a license before installation can proceed. If required, setting this option to True indicates that you have read and accepted the IBM terms and conditions found in the license file referenced by the charm.
package_status
(string) The status of service-affecting packages will be set to this value in the dpkg database. Valid values are "install" and "hold".
install