38.1. SNTP resource

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 38.1. SNTP resource as both SNTP client and server

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.

38.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]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).

38.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]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).