# Wildfly Install role


## Requirements

TODO

<!--start argument_specs-->
Role Defaults
-------------

| Variable | Description | Default |
|:---------|:------------|:--------|
|`wildfly_version`| Wildfly version to install | `26.0.0.Final` |
|`wildfly_archive_filename`| Wildfly download archive name | `wildfly-{{ wildfly_version }}.zip` |
|`wildfly_download_baseurl`| Base URL for wildfly download | `https://github.com/wildfly/wildfly/releases/download` |
|`wildfly_install_workdir`| TODO document argument | `/opt/wildfly/` |
|`wildfly_home`| Wildfly installation directory | `{{ wildfly_install_workdir }}wildfly-{{ wildfly_version }}/` |
|`wildfly_install_download_url`| Wildfly download URL | `{{ wildfly_download_baseurl }}/{{ wildfly_version }}/{{ wildfly_archive_filename }}` |
|`wildfly_archive_dir`| Target download directory | `{{ wildfly_install_workdir }}` |
|`wildfly_config_base`| wildfly standalone.xml filename override | `standalone.xml` |
|`wildfly_user`| posix user account for wildfly | `wildfly` |
|`wildfly_group`| posix group for wildfly | `{{ wildfly_user }}` |
|`wildfly_jvm_memory_min`| wildfly jvm initial heap size | `64m` |
|`wildfly_jvm_memory_max`| wildfly jvm max heap size | `512m` |
|`wildfly_jvm_metaspace_size`| wildfly jvm metaspace setting | `96m` |
|`wildfly_java_package_name`| RHEL java rpm package | `java-1.8.0-openjdk` |
|`wildfly_jboss_eap_version`| Red Hap EAP version to install | `7.4.0` |
|`wildfly_jboss_eap_archive_filename`| Red Hat EAP archive name | `jboss-eap-7.4.0.zip` |
|`wildfly_jboss_eap_home`| Red Hat EAP installation path | `{{ wildfly_install_workdir }}jboss-eap-{{ wildfly_jboss_eap_version | regex_replace('^([0-9])\.([0-9]*).*', '\1.\2') }}/` |
|`wildfly_jboss_eap_enable`| Choice between wildfly (usptream) or Red Hat JBoss EAP (product) | `{{ True if rhn_username is defined and rhn_password is defined else False }}` |
|`wildfly_offline_install`| Whether to install from local archive | `False` |


Role Variables
--------------

* No required variables

<!--end argument_specs-->

## Dependencies

## Example Playbooks

### Default Install

Installs the default version of Wildfly to the default location with the default user.

```
---
- name: "Wildfly installation and configuration"
  hosts: "{{ hosts_group_name | default('localhost') }}"
  become: yes
  collections:
    - middleware_automation.wildfly
  roles:
    - wildfly_install
```

### Explicit Location and Version

Older Wildfly versions can be download from outside Github.

```
---
- name: "Wildfly installation and configuration"
  hosts: "{{ hosts_group_name | default('localhost') }}"
  become: yes
  vars:
    wildfly_version: '24.0.1.Final'
    wildfly_download_baseurl: "https://download.jboss.org/wildfly"
  collections:
    - middleware_automation.wildfly
  roles:
    - wildfly_install
```

## License

GPL2

## Author Information

* [Romain Pelisse](https://github.com/rpelisse)