39.1. SNTP resource

39.1. SNTP resource
	Chapter 39. SNTP - Simple Network Time Protocol

The Abilis CPX SNTP resource can work as:

SNTP client: It loads time data from a remote SNTP server and sets the Abilis internal clock accordingly.
SNTP server: It provides the time data to other SNTP clients.

Figure 39.1. SNTP resource as both SNTP client and server

If the Client process isn't active, the server process operates as a primary reference source of synchronisation; if the client process is active, the server process operates as a secondary reference source of synchronisation.

39.1.1. Activating the SNTP resource

Add the resource to the Abilis system with the following command:

[09:58:31] ABILIS_CPX:a res:sntp

RES:SNTP ALREADY EXISTS

The SNTP resource may already exist in the system, but may not yet be active: set it active with the command:

[09:58:35] ABILIS_CPX:s act res:sntp

COMMAND EXECUTED

	Caution
	After adding or setting the SNTP active, you must restart the Abilis to make the resource running (use the command warm start to reboot the Abilis).

39.1.2. SNTP resource parameters

The following command displays the parameters of the resource; the d p sntp ? command shows the meaning of parameters.

[09:58:41] ABILIS_CPX:d p sntp

RES:Sntp ----------------------------------------------------------------------
Run    DESCR:Simple_Network_Time_Protocol
       LOG:NO
       - Client ---------------------------------------------------------------
       CLI-ACT:YES                    udp-remport:123
       HOST-1:#                       HOST-2:#
       HOST-3:#                       HOST-4:#
       SRCADD:R-ID (192.168.000.201)
       POLLP:60        NRTY:3         TBW:30        TBD:30
       - Server ---------------------------------------------------------------
       SRV-ACT:NO                     udp-locport:123
       IPSRC:*                        IPSRCLIST:#

Meaning of the most important parameters:

LOG: Logging functionalities activation/deactivation.
CLI-ACT: Client activation [NO, YES].
udpport: Remote UDP port for the client [123]. Read Only.
HOST-x: Sets the IP address of the SNTP Server host number x to which the Client process of the Abilis will send its synchronisation requests [#, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].
SRCADD: Source IP address for client requests [R-ID, OUT-IP, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].
POLLP: Client synchronisation polling period [1..65535 min.]. Sets the time interval (in minutes) after which to start the synchronisation procedure of the SNTP Client of Abilis.
NRTY: Client synchronisation retries number [0..255]. Sets the maximum number of repetitions for each synchronisation attempt.
TBW: Client time to wait before retry [1..65535 sec.]. Sets the time interval (in seconds) after which the request sent by the SNTP Client of the Abilis will be considered failed, if no answer from the SNTP Server is received.
TBD: Client retry delay [1..65535 sec.]. Sets the time interval (in seconds) between a failed synchronisation request and its successive one.
SRV-ACT: Server activation [NO, YES].
udpport: Local UDP port for the server [1..65535].
IPSRC: Incoming requests: accepted source IP address [*, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].
IPSRCLIST: Incoming requests: list of further accepted source IP addresses [#, IP/IR/RU/MR listname].

The command which allows the configuration of the resource to be modified has the following syntax:

s p sntp par:val...

	Caution
	To activate the changes made on the upper case parameters, execute the initialization command init res:sntp; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. With warm start command).


Chapter 39. SNTP - Simple Network Time Protocol		39.2. Examples of SNTP configuration