gfs2
Table of Contents
- Module Description - What the module does and why it is useful
- Setup - The basics of getting started with gfs2
- Usage - Configuration options and additional functionality
- Reference
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
- Acceptance Tests
Module Description
This module supports the Global File System and ensures that proper firewall rules are used to support GFS2.
Setup
What gfs2 affects
gfs2 installs required packages and ensures that GFS2 services are running. Additionally, it will make use of simp/iptables to ensure that the proper ports are open, if it is installed.
Setup Requirements
Your yum repository must have the following packages:
- ricci
- sg3_utils
- modcluster
- rgmanager
- gfs2-utils
- lvm2-cluster
- cmano
If you are using xenu or xen0, your yum repo additionally must have:
- kmod-gnbd-xen
- libvirt.${::hardwaremodel}
Finally, a server must have:
- luci
Beginning with gfs2
To install GFS2 and manage proper services, simply include the module.
include 'gfs2'
or
classes:
- gfs2
Usage
I want to manage a GFS2 server
include 'gfs2'
include 'gfs2::server'
classes:
- gfs2
- gfs2::server
simp/iptables
I'm using Using SIMP iptables, you can also manage your firewall and restrict the nodes that are allowed to connect to the cluster.
classes:
- gfs2
- gfs2::server
- gfs2::cluster_allow
gfs2::server::cluster_nets: 10.10.50.0/24
gfs2::cluster_allow::cluster_nets: 10.10.50.0/24
Reference
Classes
Public Classes
Limitations
SIMP Puppet modules are generally intended to be used on a Red Hat Enterprise Linux-compatible distribution.
Development
Please read our Contribution Guide and visit our Developer Wiki
If you find any issues, they can be submitted to our JIRA.
Acceptance tests
To run the system tests, you need Vagrant
installed.
You can then run the following to execute the acceptance tests:
bundle exec rake beaker:suites
Some environment variables may be useful:
BEAKER_debug=true
BEAKER_provision=no
BEAKER_destroy=no
BEAKER_use_fixtures_dir_for_modules=yes
BEAKER_debug
: show the commands being run on the STU and their output.BEAKER_destroy=no
: prevent the machine destruction after the tests finish so you can inspect the state.BEAKER_provision=no
: prevent the machine from being recreated. This can save a lot of time while you're writing the tests.BEAKER_use_fixtures_dir_for_modules=yes
: cause all module dependencies to be loaded from thespec/fixtures/modules
directory, based on the contents of.fixtures.yml
. The contents of this directory are usually populated bybundle exec rake spec_prep
. This can be used to run acceptance tests to run on isolated networks.