middleware_automation.jws.jws
This role contains the ansible playbook to setup JWS.
Dependency
middleware_automation.redhat_csp_download
This collection is required to download resources from RedHat Customer Portal.
Documentation to collection can be found at https://github.com/ansible-middleware/redhat-csp-download
Versions
JWS VERSION |
Release Date |
Tomcat Version |
Native Version |
Notes |
---|---|---|---|---|
|
November 30, 2021 |
|
|
|
|
June 29, 2021 |
|
|
|
|
November 23, 2020 |
|
|
|
|
April 21, 2020 |
|
|
|
|
November 20, 2019 |
|
|
|
|
May 08, 2019 |
|
|
Patching
When variable jws_apply_patches
is True
(default: False
), the role will automatically apply the latest cumulative patch for the selected base version.
JWS VERSION |
Release Date |
JWS LATEST CP |
Notes |
---|---|---|---|
|
April 29, 2022 |
|
|
|
October 06, 2021 |
|
|
|
April 14, 2021 |
|
|
|
August 04, 2020 |
|
Refer to JBoss Web Server Component Details for additional details.
Role Defaults
Download and install parameters
Variable |
Description |
Default |
---|---|---|
|
Installation method, allowed values: |
|
|
Installation path for JWS/tomcat |
|
|
Installation RPM version |
|
|
Customer Portal Base URL for archive download |
|
|
Version of JWS to install |
|
|
Install JWS most recent cumulative patch for requested version |
|
|
Enable selinux policy enforcement for JWS |
|
|
Default installation path for JWS archives |
|
|
posix user account for service |
|
|
posix UID user account for service |
|
|
posix group for service |
|
|
posix GID user account for service |
|
|
Install native bits; provide a zipfile path below with tomcat, while on JWS it will be interpolated from version |
|
|
Tomcat native binaries archive filename |
|
|
Whether to stop any running tomcat process and continue installation |
|
|
Path local to controller for offline/download archive files |
`{{ lookup(‘env’, ‘PWD’) |
Service configuration
Variable |
Description |
Default |
---|---|---|
|
Comma separated list of apps to undeploy |
|
|
Tomcat catalina base env variable |
|
|
Path for tomcat configuration |
|
|
Path for tomcat policy configuration |
|
|
Path for logging configuration |
|
|
Relative path to context.xml |
|
|
Relative path to server.xml |
|
|
Relative path to web.xml |
|
|
Template to use for context.xml |
|
|
Template to use for server.xml |
|
|
Template to use for web.xml |
|
|
Template to use for catalina.properties |
|
|
Tomcat shutdown port |
|
|
Tomcat http listen port |
|
|
Service bind address |
|
|
Enable listening on http port |
|
|
Enable listening on https port |
|
|
Bind address for https |
|
|
Enable listening on https port |
|
|
Enable listening on ajp port |
|
|
Bind address for ajp |
|
|
Tomcat ajp listen port |
|
|
Enable loading secret from vault |
|
|
Passphrase for vault secret |
|
|
Enable tomcat systemd unit |
|
|
Interpreter for systemd unit |
|
|
Customize sysVinit script shebang |
|
|
Name for the systemd unit |
|
|
Absolute path to tomcat.conf |
|
|
Tomcat sysVinit script |
|
|
Tomcat systemd unit |
|
|
Absolute path to tomcat PIDfile |
|
|
Systemd unit type |
|
tomcat-vault configuration
Variable |
Description |
Default |
---|---|---|
|
vault keystore filename, made available in playbook files lookup paths |
|
|
Enable value |
|
|
Alias for loading from vault |
|
|
Tomcat keystore password |
|
|
Number of iteration for vault encryption |
|
|
Salt for encrypting tomcat vault |
|
|
vault.properties filename, made available in playbook files lookup paths |
|
|
vault.data filename, made available in playbook files lookup paths |
|
mod_cluster configuration
Variable |
Description |
Default |
---|---|---|
|
Enable mod_cluster module |
|
|
Bind address for mod_cluster |
|
|
mod_cluster port |
|
|
mod_cluster connector port |
|
|
Enable mod_cluster advertising |
|
|
Enable mod_cluster sticky sessions |
|
|
Force use of sticky sessions |
|
|
Remove sticky session from cookies |
|
HTTPS configuration
Variable |
Description |
Default |
---|---|---|
|
Enable HTTS connector |
|
|
Tomcat HTTPS listen port |
|
|
Service HTTPS bind address |
|
|
Servername associated to the HTTPS connector |
|
|
Max number of threads for the HTTPS connector |
|
|
HTTPS connector timeout |
|
|
HTTPS connector HTTPS header size |
|
|
Path to keystore file used by HTTPS connector |
|
|
Password to keystore file |
|
|
Request certificate from client |
|
Role Variables
Variable |
Description |
Required |
---|---|---|
|
Version of java openjdk RPM to install for Tomcat, by default nothing is installed |
|
|
JAVA_HOME to use for starting Tomcat, inferred from |
|
Example Playbook
---
- hosts: all
tasks:
- name: "Include JWS"
include_role:
name: "jws"