ntpmaster #7

Description

This charm provides NTP master services for use with other
charms through the use of the ntp subordinate charm.


Overview

NTP provides network based time services to ensure synchronization of time
across computers.

Usage

The ntpmaster charm provides NTP based services to other charms - either directly
or through the use of the ntp subordinate charm.

Direct

This this mode services need to understand how to relate to the ntpmaster service
using the ntp protocol:

juju deploy ntpmaster
juju add-relation ntpmaster myservicethatwantsntp

This is less useful as every charm has to have master hooks.

Indirect

In this mode the ntp subordinate charm is used to configure NTP in other service
units to the ntpmaster service:

juju deploy ntp
juju deploy ntpmaster
juju deploy myservicethatdoesnotunderstandntp
juju add-relation ntp ntpmaster
juju add-relation ntp myservicethatdoesnotunderstandntp

You can of course have more that one ntpmaster:

juju add-unit -n 2 ntpmaster

All services that the ntp charm is subordinate to will be configured to sync with
all avaliable ntp masters.

Configuration

The ntpmaster charm by default will use the standard NTP pool servers that are
provided by the Ubuntu package. It can also be configured to use specific
servers:

juju set ntpmaster source="myserver1 myserver2 myserver3"

This would allow use with an internal time source, such as GPS or an atomic
clock, or with alternative external NTP sources.

If the ntpmaster is supposed to be its own reference, use "source=LOCAL" in
order to generate a local reference clock configuration file for this server.

Configuration

source
(string) Space separated list of NTP servers and options to use as source for time. Use LOCAL if the machine has no references but itself.
0.ubuntu.pool.ntp.org 1.ubuntu.pool.ntp.org 2.ubuntu.pool.ntp.org 3.ubuntu.pool.ntp.org
query-hosts
(string) Comma-separated list of restrict clauses which are allowed to query the server for time monitoring purposes. e.g. "10.1.1.0 mask 255.255.255.0"