Forge Home

ctdb

Configure CTDB

4,029 downloads

1,488 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 1.0.0 (latest)
  • 0.0.1
released Oct 6th 2020
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2016.4.x
  • Puppet >= 4.10.0 < 7.0.0
  • ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'bahner-ctdb', '1.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add bahner-ctdb
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install bahner-ctdb --version 1.0.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

bahner/ctdb — version 1.0.0 Oct 6th 2020

ctdb

Table of Contents

  1. Description
  2. Setup - The basics of getting started with ctdb
  3. Usage - Configuration options and additional functionality
  4. Development - Guide for contributing to the module

Description

Configuring ctdb can be a little daunting at first. When I got it to work I created this module and forgot about it. I see that many have downloaded and figured it could use a brush up.

Setup

It mainly just installs the package and configure the bare necessities. ctdb is a cluster tdb, which is the backend for a local Samba installation without AD integration. So it stores user accounts and what have you. When running you can add users to just one of the servers and have all the Samba servers in the cluster pick up on the change.

Setup Requirements

A shared file system is required. You must have such a filesystem, whether SMB of NFS where the cluster lock can be stored. This is so important the no default is given for the recovery_lock file, which must reside on this shared filesystem, that all cluster members must have access to.

Usage

You need at least to configure where the lock file is stored.

You must provide a list of ip adresses, the nodes_list which the cluster members can use to see each other.

You must provide the public addresses the cluster you create. If one server goes down the others will start answering on these adresses. It's DNS Round Robin all the way. Secundum non datur. ctdb wotks by keeping all of these IPs up and running across the cluster. You then you DNS round robin to spread load between them or something like that.

So either you populate the nodes_list and public_addresses files yourself, or you provide the correct ip/interface pairs and ip list to the module. Using the module is probably the best. Look at the REFERENCE.md for examples.

The following Hiera example demonstrates usage.

---
ctdb::recovery_lock: /Shared/files/system/ctdb.lock
ctdb::nodes:list:
  - 10.0.0.2
  - 10.0.0.4
  - 10.0.0.6
  - 10.0.0.8
  - 10.0.0.10
ctdb::public_addresses_list:
  - '10.0.0.1 eth0'
  - '10.0.0.3 eth0'
  - '10.0.0.5 eth0'
  - '10.0.0.7 eth0'
  - '10.0.0.9 eth0'
  - '1.2.3.4  eth1'
  - '1.2.3.5  eth1'
ctdb::manages_samba: true
ctdb::manages_winbind: true
ctdb::manages_nfs: true
ctdb::max_open_files: 10
ctdb::logging: file:/var/log/log.ctdb
ctdb::debuglevel: ERR
ctdb::set_tdb_mutex_enabled: 1
ctdb::samba_skip_share_check: true

Development

Pull requests are welcome, so are issues.

Release Notes

See CHANGELOG.md

2020-10-07: bahner