Wildfly systemd role

Role setting up a systemd service to manage a Wildfly app server instance, using basic information on server installation.

Note: default values are based on the one of the wildfly_install role.

Requirements

A working systemd environment is required on target’s system.

Role Defaults

Variable	Description	Default
`wildfly_user`	posix user account for wildfly service	`wildfly`
`wildfly_group`	posix group for wildfly service	`{{ wildfly_user }}`
`wildfly_home`	Wildfly installation directory	`/opt/wildfly/wildfly-27.0.0.Final/`
`wildfly_config_base`	Base standalone.xml config for instance	`standalone.xml`
`wildfly_port_range_offset`	Increment for `jboss.socket.binding.port-offset`	`100`
`wildfly_systemd_unit_enabled`	Enable systemd unit to autostart after reboot	`True`
`wildfly_systemd_service_config_location`	Path for systemd unit file	`/usr/lib/systemd/system`
`wildfly_systemd_service_config_file_suffix`	Systemd unit file extension	`.service`
`wildfly_systemd_conf_file_suffix`	Suffix for systemd conf file	`.conf`
`wildfly_systemd_service_config_file_template`	Template for systemd unit	`templates/wfly.service.j2`
`wildfly_service_config_file_template`	Template for systemd config	`templates/wfly.conf.j2`
`wildfly_service_config_file_location`	Path for wildfly systemd unit file	`/etc/`
`wildfly_enable_yml_config`	Enable yaml file configuration feature (WFCORE5343)	`False`
`wildfly_yml_configs`	List of filenames for wildfly configuration bootstrap	`[]`
`wildfly_java_package_name`	RHEL java rpm package	`java-11-openjdk-headless`
`wildfly_java_opts`	Additional settings for the JVM running wildfly	`-Xmx1024M -Xms512M`
`wildfly_bind_addr`	Bind address for listening to public network	`0.0.0.0`
`wildfly_bind_addr_private`	Bind address for listening to private network	`127.0.0.1`
`wildfly_bind_addr_management`	Bind address for management console port	`127.0.0.1`
`wildfly_multicast_addr`	Multicast address for jgroup cluster discovery	`230.0.0.4`
`wildfly_statistics_enabled`	Whether to enable statistics	`False`

Role Variables

Variable	Description	Required
`wildfly_java_home`	JAVA_HOME of installed JRE, leave empty for using specified wildfly_java_package_name RPM path	`No`
`wildfly_instance_id`	When collocating services on the same host, EAP instance ID (integer value)	`No`
`wildfly_instance_name`	When collocating services on the same host, EAP instance name	`No`

Dependencies

Example Playbook

  tasks:

    - name: "Set up for WildFly instance {{ item }}"
      include_role:
        name: wildfly_systemd
      vars:
        wildfly_config_base: 'standalone-ha.xml'
        wildfly_basedir_prefix: "/opt/{{ inventory_hostname }}"
        wildfly_config_name: "{{ install_name }}"
        wildfly_port_range_offset: 100
        wildfly_instance_name: "{{ install_name }}"
        wildfly_instance_id: "{{ item }}"
        service_systemd_env_file: "/etc/eap-{{ item }}.conf"
        service_systemd_conf_file: "/usr/lib/systemd/system/jboss-eap-{{ item }}.service"
      loop: "{{ range(0,3) | list }}"

License

GPL2

Author Information

Romain Pelisse