extended_drbd

This cookbook is designed to setup and configure a pair of server with drbd. Please Note: this cookbook does not mount the drbd drive.

This cookbook assumes that you want it to control your firewall using iptables, as such it will attempt to open/close the correct ports. If you want to disable this functionality you can modify the attribute node['iptables']['enabled'] and set it to false.

This cookbook can be used in the following situations:

Fresh server pair installation (please see below for how to use).
Adding a server to another server running drbd.
Change drbd.conf file and have drbd update with out restarting.

Usage

How to use when creating a fresh server pair:

Prerequisites:

Chef client must be installed on both servers.
The disk location node['drbd']['disk']['location'] must exist.

Note: In order for this work properly both servers need to be running chef at the same time,

You will need to have the following attribute values specified:

node['drbd']['primary']['fqdn'] and node['drbd']['partner']['hostname']

Note: If you do not specify both attributes then the chef run will error out.

Once one server has been specified as drbd master you can add the recipe "drbd::drbd_fresh_install" to the run_list of both servers.

How to use when adding a new server to another server running drbd:

This is the same as above except the new server is not specified as the drbd master, and you dont have to be running chef-client on the other server.

How to use when changing the drbd.conf file:

On which ever server you are updated (or both) add the recipe "drbd::drbd_inplace_upgrade" to the server's run_list. And the next time Chef-client runs it will preform the changes in a safe way.

The way I have used this have been to call this drbd cookbook from within another cookbook, and have the second cookbook do the logic of decided whether or not this is a fresh install or inplace upgrade.

Here is how I use it:

if ::File.exists?("/etc/drbd.conf")
  include_recipe "extended_drbd::drbd_inplace_upgrade"
else
  include_recipe "extended_drbd::drbd_fresh_install"
end

Attributes:

default['drbd']['packages'] = ["kmod-drbd83", "drbd83"]
default['drbd']['disk']['location'] = "/dev/local/data"
default['drbd']['mount'] = "/data"
default_unless['drbd']['fs_type'] = "ext3"
default['drbd']['dev'] = "/dev/drbd0"
default['drbd']['master'] = false
default['drbd']['port'] = 7789
default['drbd']['configured'] = false
default['drbd']['syncrate'] = "36M"
default['drbd']['resource'] = "data"
default['drbd']['stop_file'] = "/etc/drbd_stop_file"
default['drbd']['synced']['stop_file'] = "/etc/drbd_synced_stop_file"
default['drbd']['initialized']['stop_file'] = "/etc/drbd_initialized_stop_file"
default['drbd']['primary']['fqdn'] = nil - Fqdn of the primary drbd server
default['drbd']['server']['hostname'] = nil - Fqdn of the server Note: This will use the node['fqdn'] if not specified.
default['drbd']['server']['ipaddress'] = nil - Ipaddress of the server Note: This will use node['ipaddress'] if nil.
default['drbd']['partner']['hostname'] = nil - Fqdn of the partner server
default['drbd']['partner']['ipaddress'] = nil - Ipaddress of the parter server Note: If not specified chef will try to search the chef-server using node['drbd']['partner']['hostname'] to find the node object.
default['drbd']['command_timeout'] = 36000 - A timeout value used when trying to create a filesystem of a huge data store.
default['drbd']['protocol'] = 'C' - The protocal used by the drbd app.
default['drbd']['disk']['on_io_error_action'] = 'detach'
default['drbd']['disk']['disk-flushes'] = false
default['drbd']['disk']['md-flushes'] = false
default['drbd']['disk']['no-disk-barrier'] = false
default['drbd']['net']['enabled'] = false
default['drbd']['net']['sndbuf-size'] = '1M'
default['drbd']['net']['max-buffers'] = 8000
default['drbd']['net']['max-epoch-size'] = 8000
default['iptables']['enabled'] = true

Testing

This recipe includes a number of chefspec unit tests for this cookbook.

To execute the tests run rake

This also makes use of vagrant, and creates VM's to make use of the cookbook. Because this cookbook REQUIRES both serves to be running chef at the same time, there are a few manual steps involved with using Vagrant.

Create both VM's (one at a time).
Once both VM's are up and running, edit the Vagrant File:

Existing file:
def get_recipes()
  recipes = %w{
    chef-solo-search
    minitest-handler
    extended_drbd_helper
    yum::epel
    yum::elrepo
  }
#    extended_drbd::drbd_fresh_install
#  }

Please change the file to look like:

Ater changes:
def get_recipes()
  recipes = %w{
    chef-solo-search
    minitest-handler
    extended_drbd_helper
    yum::epel
    yum::elrepo
    extended_drbd::drbd_fresh_install
  }

Now run vagrant provision <server_name> for both servers at the same time.

License and Author

Author:: Justin Witrick (github@thewitricks.com)
Copyright:: Justin Witrick.

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.

misnow1 / extended_drbd