Universal Tomcat

This system helps you install and manage Tomcat configurations.

Requirements

None needed.

Role Dependencies

• ChristopherDavenport.universal-java: Depends on the tomcat_use_java variable. If this is set to false, you need to provide the java_home variable.

• ChristopherDavenport.apache-portable-runtime: Depends on the tomcat_use_apr variable.

Role Variables

# Default settings for universal-tomcat

# Available Tomcat versions
# 6.0.47
# 6.0.51
# 7.0.72
# 7.0.76
# 8.0.38
# 8.0.42
# 8.5.6
# 8.5.12
# 9.0.0.M18

tomcat_version: "8.5.12"

tomcat_mirrors:
  - http://archive.apache.org/dist/tomcat

# Temporary Storage Directory
tomcat_tmp_storage: /tmp/tomcat-ansible

# Decide if Java should be installed
# If not present, provide java_home variable
tomcat_use_java: true

# Decide if to install the APR Role Dependency
tomcat_use_apr: true

tomcat_user_name: tomcat
tomcat_user_group: tomcat
tomcat_user_home: /home/{{ tomcat_user_name }}
tomcat_user_system: false

# Port settings
tomcat_port_shutdown: 8005
tomcat_port_connector: 8080
tomcat_port_redirect: 8443
tomcat_port_ajp: 8009

# Java options
tomcat_java_opts: ""
tomcat_catalina_opts: ""

# Base directory for Tomcat
tomcat_base_dir: /opt
tomcat_catalina_home: "{{ tomcat_base_dir }}/tomcat"
tomcat_instance_path: "{{ tomcat_base_dir }}/tomcat"

# Optional settings
tomcat_prefer_ipv4: true
tomcat_override_uri_encoding: ""
tomcat_prefer_urandom: true

tomcat_instance: tomcat

# User roles
tomcat_roles:
  - manager
  - manager-gui
  - manager-script
  - manager-jmx
  - admin
  - admin-gui
  - admin-script

tomcat_users: []
  # - name: tomcat
  #   password: tomcat
  #   roles: "manager-gui,admin-gui"

tomcat_debug: false

# Configuration settings for Ansible
tomcat_configure: true
tomcat_configure_configs: "{{ tomcat_configure }}"
tomcat_configure_libs: "{{ tomcat_configure }}"
tomcat_configure_webapps: "{{ tomcat_configure }}"

# Paths to copy files
tomcat_extra_libs_path: []
tomcat_webapps_path: []

# Customization strings
tomcat_extra_global_naming_resources: ""
tomcat_context_xml_header_extra: ""
tomcat_context_xml_extra: ""

# Session persistence settings
tomcat_disable_persistence_across_restarts: false

# Custom configuration files
tomcat_use_custom_server_xml: false
# tomcat_custom_server_xml: Path
tomcat_use_custom_web_xml: false
# tomcat_custom_web_xml: Path
tomcat_use_custom_context_xml: false
# tomcat_custom_context_xml: Path
tomcat_use_custom_tomcat_users_xml: false
# tomcat_custom_tomcat_users_xml: Path
tomcat_use_custom_manager_context_xml: false
# tomcat_custom_manager_context_xml: Path

# Major version of Tomcat
tomcat_version_major: "{{ tomcat_version.0 }}"
tomcat_tar_archive: "apache-tomcat-{{ tomcat_version }}.tar.gz"

# Tomcat instance directories
tomcat_instance_directories:
  - conf
  - logs
  - webapps
  - temp
  - bin
  - lib
  - work

# Specific settings for each Tomcat version
tomcat_version_specific:
  "6.0.47":
    checksum: md5:7b848f76b605c0fd7fd5c7291a050ca4
    web_xml_schema_version: 3.0
    tomcat_native_version: "1.2.10"
  "6.0.51":
    checksum: md5:c18a8f0cb5966d3f599d49cafeaf7c54
    web_xml_schema_version: 3.0
    tomcat_native_version: "1.2.12"
  "7.0.72":
    checksum: md5:c24bfae15bb9c510451a05582aae634d
    web_xml_schema_version: 3.0
    tomcat_native_version: "1.2.10"
  "7.0.76":
    checksum: md5:ae2e481f918eb2a99a0e47a07e5f1671
    web_xml_schema_version: 3.0
    tomcat_native_version: "1.2.12"
  "8.0.24":
    checksum: md5:9f71353dfba0184c23ecd4743e4132ff
    web_xml_schema_version: 3.1
    tomcat_native_version: "1.2.10"
  "8.0.38":
    checksum: md5:cb1f5e098024df2bb19c581eca180a2a
    web_xml_schema_version: 3.1
    tomcat_native_version: "1.2.12"
  "8.0.42":
    checksum: md5:3cabfc2d3c320b7eb62f8a94da0447ea
    web_xml_schema_version: 3.1
    tomcat_native_version: "1.2.12"
  "8.5.6":
    checksum: md5:e273e27deb1828ae5f19374616b9fba8
    web_xml_schema_version: 3.1
    tomcat_native_version: "1.2.10"
  "8.5.12":
    checksum: md5:c2e6eca5a0642d1e30fbe3573b96ab75
    web_xml_schema_version: 3.1
    tomcat_native_version: "1.2.12"
  "9.0.0.M18":
    checksum: md5:626e16b93de65b2a58714ed50f00d9f9
    web_xml_schema_version: 3.1
    tomcat_native_version: "1.2.12"

Dependencies

Example Playbook

- hosts: servers
  roles:
     - role: ChristopherDavenport.universal-tomcat
       become: yes

License

MIT

Author Information

This role was created by ChristopherDavenport in 2016.