README.pod

NAME

Cloudmin::Config - A collection of plugins to initialize services for use with Cloudmin, and a command line tool called config-system to run them.

It can be thought of as a very specialized configuration management system (e.g. puppet, chef, whatever) for doing just one thing (setting up a system for Cloudmin). It has basic dependency resolution (via topological sort), logging, and ties into the Webmin API to make some common tasks (like starting/stopping services, setting them to run on boot) simpler to code.

SYNOPSIS

my $bundle = Cloudmin::Config->new(bundle => 'KVM');
$bundle->run();

You can also call it with specific plugins, rather than a whole bundle of plugins.

my $plugin = Cloudmin::Config->new(include => 'CGroups');
$plugin->run();

Adding new features to the installer, or modifying installer features, should be done by creating new plugins or by adding to existing ones.

DESCRIPTION

This is a mini-framework for configuring elements of a Cloudmin system. It uses Webmin as a library to abstract common configuration tasks, provides a friendly status indicator, and makes it easy to pick and choose the kind of configuration you want (should you choose to go that route). The Cloudmin install script chooses either the KVM or Xen bundle, and performs the configuration for the whole stack.

It includes plugins for all of the common tasks in a Cloudmim installation, such as CGroups, Xen or KVM, NTP, BIND, etc.

INSTALLATION

The recommended installation method is to use native packages for your distribution. We provide packages for Debian, Ubuntu, CentOS/RHEL, and Fedora in our repositories.

You can use the standard Perl process to install from the source tarball or git clone:

perl Makefile.PL
make
make test
make install

Or, use your system native package manager. The following assumes you have all of the packages needed to build native packages installed.

To build a dpkg for Debian/Ubuntu:

dpkg-buildpackage -b -rfakeroot -us -uc

And, for CentOS/Fedora/RHEL/etc. RPM distributions:

dzil build # Creates a tarball
cp Cloudmin-Config-*.tar.gz ~/rpmbuild/SOURCES
rpmbuild -bb cloudmin-config.spec

ATTRIBUTES

bundle

Selects the plugin bundle to be installed. A bundle is a list of plugins configured in a Cloudmin::Config::* class.

include

One or more additional plugins to include in the run(). This can be used alongside bundle or by itself. Dependencies will also be run, and there is no way to disable dependencies (because they're depended on!).

exclude

One or more plugins to remove from the selected bundle. Plugins that are needed to resolve dependencies will be re-added automatically.

METHODS

run

This method figures out which plugins to run (based on the bundle, include, and exclude attributes.

LICENSE AND COPYRIGHT

Licensed under the GPLv3. Copyright 2017-2023 Cloudmin, LLC, Virtualmin, Inc., Jamie Cameron <[email protected]>, Joe Cooper <[email protected]>