Ansible Role: Mule

This role helps install Mule Community Edition on Linux servers.

Requirements

• You need to have Java installed on your server.
• You can install Java easily using the Geerlingguy role called geerlingguy.java, but other installation methods are fine too.
• Make sure the Java version you install is compatible with Mule's requirements.

Installation

To install this Ansible role from Ansible Galaxy, run:

$ ansible-galaxy install bmeme.mule

Update

To update the role, use the --force option when running the install command:

$ ansible-galaxy install --force bmeme.mule

Role Variables

Here are some basic variables you can set:

Variable Name	Description	Default
mule_version	Mule version to install. Check here for options.	4.5.0
mule_group	System group for Mule	mule
mule_user	System user for Mule	mule
mule_home	Directory where Mule is installed	/opt/mule
mule_remove_package	Remove the "tar.gz" package after installation	true
mule_restart_handler_enabled	Restart/start Mule after installation	true

Mule Configuration Properties

This role allows you to configure some basic Java settings and logging properties in the wrapper.conf file.

Variable Name	Description	Default
mule_wrapper_java_command	Absolute path of Java	java
mule_wrapper_java_initmemory	Initial Java Heap Size in MB	1024
mule_wrapper_java_maxmemory	Maximum Java Heap Size in MB	2048
mule_wrapper_startup_timeout	Default startup timeout in seconds	600
mule_wrapper_console_format	Console output format	M
mule_wrapper_console_loglevel	Log level for console output	INFO
mule_wrapper_logfile	Log file name for wrapper output	%MULE_BASE%/logs/%MULE_APP%.log
mule_wrapper_logfile_format	Log file output format	M
mule_wrapper_logfile_loglevel	Log level for log file output	INFO
mule_wrapper_logfile_maxsize	Maximum log file size before log rotation	1m
mule_wrapper_logfile_maxfiles	Maximum number of rolled log files	10
mule_wrapper_syslog_loglevel	Log level for sys/event log	NONE

You can find more guidance on configuring Mule in the official documentation here.

Dependencies

N/A

Example Playbook

Here’s an example of how to use this role:

- hosts: muleserver
  vars_files:
    - vars/main.yml
  roles:
    - geerlingguy.java # for Java installation
    - bmeme.mule

License

This role is licensed under the MIT License.

Author Information

Created by Bmeme. Currently maintained by Daniele Piaggesi and Roberto Mariani.

Credits

This role was inspired by other existing roles. Special thanks to:

• geerlingguy
• lean-delivery