ansible-was

Roles for installing and managing IBM Websphere Application Server (WAS) on Unix-like systems (tested on Debian Linux). This includes setting up the IBM Installation Manager (IIM), IBM HTTP Server (IHS), and Plugin (PLG).

IIM

This role installs the IBM Installation Manager.

Requirements

You need to have the following installed on your operating system:

• Debian: setfacl & zip
• CentOS: setfacl & unzip

Make sure a user is present with the group specified as {{iim_user}}:{{iim_group}}.

This user needs permission to create the directories: {{iim_repo}}, {{iim_tmp}}, and {{iim_path}}.

Variables

• iim_user or ibm_user (set as iim_user: "{{ibm_user}}"): The user under which to install IIM. required

• iim_path or ibm_root (set as iim_path: "{{ibm_root}}/InstallationManager"): The directory where IIM will be installed. required

• ibm_repo: The location of the IBM repositories. default: "{{ibm_root}}/repo"

• ibm_mode: Default directory permissions. default: "0750"

• iim_version: Minimum required version of IIM. default: "1.8"

• iim_tmp: Temporary directory for installation zip files before extraction. default: "{{ibm_root}}/tmp"

• iim_group: Group for the iim_user. default: "{{iim_user}}"

• iim_mode: Permissions for created directories. default: "{{ibm_mode}}"

• iim_local_src: Use this if you have the installation zip file on the managed node's filesystem instead of copying it over.

Example of Use

Refer to playbook-iim.yml for installation instructions.

WAS

This role installs or uninstalls the IBM WebSphere Application Server.

Requirements

You need to have the following installed on your operating system:

• setfacl & unzip (Debian packages acl & zip).

Ensure a user exists with the group specified as {{was_user}}:{{was_group}}.

This user must have permissions to create the directories: {{was_repo}}, {{iim_tmp}}, and {{was_path}}.

Variables

• was_user or ibm_user (set as was_user: "{{ibm_user}}"): The user under which to install WAS (same user used for IIM). required

• was_path or ibm_root (set as was_path: "{{ibm_root}}/WebSphere"): The directory where WAS will be installed. required

• was_repo or ibm_repo (set as was_repo: "{{ibm_repo}}"): The repository location. required

• state: Choose between installed or absent. default: installed

• Other variables include was_nd, ibm_repo, was_version, and permissions for created directories.

• was_local_src: Use this if you have the WAS installation zip file already on the managed node.

Examples of Use

Refer to playbook-was.yml for installation and playbook-uninstall-was.yml for uninstallation.

IHS (+ PLG)

This role installs or uninstalls the IBM HTTP Server and its Plugin.

Requirements

You need to have the same prerequisites as for WAS:

• setfacl & unzip must be installed.

A user must exist with group {{ihs_user}}:{{ihs_group}}.

This user must have permission to create the directories: {{ihs_repo}}, {{plg_repo}}, {{iim_tmp}}, {{ihs_path}}, and {{plg_path}}.

Variables

Variables will be similar to those for WAS but prefixed with ihs_ and plg_.

Examples of Use

Refer to playbook-ihs.yml for installation and playbook-uninstall-ihs.yml for uninstallation.