Puppet Ejabberd Module

This is an ejabberd module for installing and configuring ejabberd. It has been tested on CentOS 6 with ejabberd 2.1.13.

Usage

Use the defaults:

include ejabberd

Or to configure:

class { 'ejabberd':
    config_source   => 'puppet:///files/my/ejabberd.cfg',
    package_ensure  => 'installed',
    package_name    => 'ejabberd',
    service_reload  => true,
}

By default, when the config file changes the ACLs will be reloaded by running ejabberdctl load_config. For this to work, the mod_admin_extra module must be installed. To add new hosts, ejabberd must be restarted manually. Alternatively, you can tell the module to restart ejabberd instead of doing a reload by setting service_reload => false.

Defines

ejabberd::contrib::module

Installs a module from the contrib repository. Note that you will also need to add the module to your ejabberd.cfg config file to enable it.

ejabberd::contrib::module { 'mod_rest': }

Providers

ejabberd_user

This provider can be used to create users:

ejabberd_user { 'myusername':
    host        => 'localhost',
    password    => 'mypassword'
}

License

Copyright 2014 Lee Boynton

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Support

Please log tickets and issues on GitHub

Changelog

0.0.5 2014-09-18

• Added param $include_epel to disable epel being included. Use this on CentOS if you get the ejabberd package from elsewhere. (thanks to @michael-leroy)

0.0.4 2014-03-23

• Fixed path error when installing MySQL driver and contrib modules on 32-bit architectures
• Fixed user already exists error on subsequent puppet runs when more than one ejabberd user has been added (thanks to @michael-leroy)

0.0.3 2014-01-26

• ejabberd is now installed from epel on RedHat
• Added missing vcsrepo dep to modulefile
• Added service_reload parameter to configure module to either reload or restart ejabberd when config changes

0.0.2 2014-01-20

• Calls ejabberdctl load_config to reload ACLs when config changes. This means that ejabberd is no longer restarted when config changes.
• Allow ejabberd config file to be specified
• Allow package name and package ensure to be specified
• Some specs added
• Native erlang MySQL driver added

0.0.1 2014-01-10

• Initial release