ntpdate Cookbook

Installs ntpdate and configures it to run as a scheduled job.(Although it later uses the ntpdate-debian binary, see man ntpdate). The reason for this one may found after struggling to sync the time via NTP daemon without exposing the external network interface to the world.

By default the cookbook will remove NTP package (if installed).

Requirements

Nothing really special. It depends on the opscode's cron cookbook in order to lay the cronjob.

Attributes

Key	Type	Description	Default
['ntpdate']['enable']	Boolean	enable or disable ALL actions	true
['ntpdate']['use_ntp_config']	String	whether to use the ntp.conf file config	'no'
['ntpdate']['config_folder']	String	Where lays the config file	'/etc/default'
['ntpdate']['config_file']	String	Config file name	'ntpdate'
['ntpdate']['ntp_servers']	StringArray	Which time servers to sync from	%w(pool.ntp.org)
['ntpdate']['ntp_options']	String	Additional options for ntpdate	nil
['ntpdate']['package_name']	StringArray	Which packages to install	%w(ntpdate)
['ntpdate']['crontab_file']	String	Crontab file name to create in /etc/cron.d directory	ntpdate
['ntpdate']['ntp_pkg_remove']	Boolean	Defines if the NTP packet should be removed	true
['ntpdate']['ntp_pkg_name']	String	NTP Package name	ntp

For the [:ntpdate][:crontab] directives check the cron cookbook from opscode.

Usage

ntpdate::default

{
  "name":"my_node",
  "ntpdate": {
  	"ntp_servers": %w{ntp1.somedomain.com ntp2.somedomain.com},
  	"crontab": {
  		"comment": "This Cron sets time on Sundays at 6:00 O'clock",
  		"minute": "0",
  		"hour":   "6",
  		"day":    "7"
  	}
  },
  "run_list": [
    "recipe[ntpdate]"
  ]
}

disabling ALL actions

but leaving the recipe in run_list() and the role configuration (sometimes is useful). This will remove all the configuration files the cookbook normally creates but will leave the packages as they are (actual stand).

{
  "name":"my_node",
  "ntpdate": {
   "enable": false
  	"ntp_servers": %w{ntp1.somedomain.com ntp2.somedomain.com},
  	"crontab": {
  		"comment": "This Cron sets time on Sundays at 6:00 O'clock",
  		"minute": "0",
  		"hour":   "6",
  		"weekday": "sun"
  	}
  },
  "run_list": [
    "recipe[ntpdate::default]"
  ]
}

Contributing

1. Fork the repository on Github
2. Create a named feature branch (like add_component_x)
3. Write your change
4. Write tests for your change (if applicable)
5. Run the tests, ensuring they all pass
6. Submit a Pull Request using Github

License and Authors

Authors: Ivan Golman (ivan.golman@gmail.com)