Configure NTP Servers Using the CLI¶
You can use the CLI to add or update a list of NTP servers and services.
NTP Servers
You can specify up to three NTP servers using the CLI or the Horizon Web interface. For more information, see Configure NTP Servers Using Horizon.
To view the existing NTP server configuration, use the following command.
~(keystone_admin)]$ system ntp-show
+--------------+----------------------------------------------+
| Property | Value |
+--------------+----------------------------------------------+
| uuid | c65d5dcd-de6c-4ff9-89a1-c385dd4c7310 |
| ntpservers | 0.pool.ntp.org,1.pool.ntp.org,3.pool.ntp.org |
| isystem_uuid | a16d7b07-1d42-41cf-b001-04bc25216a2b |
| created_at | 2019-12-07T18:31:14.242942+00:00 |
| updated_at | 2019-12-07T18:42:09.244572+00:00 |
+--------------+----------------------------------------------+
Note
When you change the NTP system configuration you must lock/unlock all hosts. This process requires a swact on the controllers. During a host swact the system may raise NTP alarms.
To change the NTP server IP addresses, use the following command syntax. The ntpservers option takes a comma-delimited list of NTP server names.
~(keystone_admin)]$ system ntp-modify \
ntpservers=<server_1[,server_2][,server_3]>
For example:
~(keystone_admin)]$ system ntp-modify ntpservers=0.pool.ntp.org,1.pool.ntp.org,3.pool.ntp.org
NTP Service
Clock synchronization, synchronizes time across multiple systems in a network. The default value for clock_synchronization is ntp.
Note
NTP and PTP is configured per host. Lock/unlock the host when updating clock_synchronization for the host.
Use the following command to change the clock synchronization on the host:
~(keystone_admin)]$ system host-update controller-0 clock_synchronization=ntp
+-----------------------+--------------------------------------------+
| Property | Value |
+-----------------------+--------------------------------------------+
| action | none |
| administrative | unlocked |
| availability | available |
| bm_ip | None |
| bm_type | None |
| bm_username | None |
| boot_device | /dev/disk/by-path/pci-0000:00:1f.2-ata-1.0 |
| capabilities | {u'stor_function': u'monitor'} |
| clock_synchronization | ntp |
| config_applied | 16dfa935-e21e-4737-90f4-1afa83a3091b |
| config_status | None |
| config_target | 16dfa935-e21e-4737-90f4-1afa83a3091b |
| console | ttyS0,115200n8 |
| created_at | 2020-02-27T15:00:07.108865+00:00 |
| hostname | controller-0 |
| id | 1 |
| install_output | text |
| install_state | None |
| install_state_info | None |
| inv_state | inventoried |
| invprovision | provisioned |
| location | {} |
| mgmt_ip | 192.168.204.3 |
| mgmt_mac | 00:00:00:00:00:00 |
| operational | enabled |
| personality | controller |
| reserved | False |
| rootfs_device | /dev/disk/by-path/pci-0000:00:1f.2-ata-1.0 |
| serialid | None |
| software_load | nn.nn |
| subfunction_avail | available |
| subfunction_oper | enabled |
| subfunctions | controller,worker |
| task | |
| tboot | false |
| ttys_dcd | None |
| updated_at | 2020-02-28T17:21:42.374847+00:00 |
| uptime | 7403 |
| uuid | cc870915-b8dd-4989-914c-7095eabe36e8 |
| vim_progress_status | services-enabled |
+-----------------------+--------------------------------------------+
To view the NTP service configuration, use the following command:
~(keystone_admin)]$ system host-show controller-0
+-----------------------+------------------------------------------------+
| Property | Value |
+-----------------------+------------------------------------------------+
| action | none |
| administrative | unlocked |
| availability | available |
| bm_ip | None |
| bm_type | None |
| bm_username | None |
| boot_device | /dev/disk/by-path/pci-0000:04:00.0-sas |
| |-0x5001e6754aa38000-lun-0 |
| capabilities | {u'stor_function': u'monitor', u'Personality': |
| | u'Controller-Active'} |
| clock_synchronization | ntp |
| config_applied | 590f29ad-19e2-43ee-855e-f765814e3ecd |
| config_status | Config out-of-date |
| config_target | cd18ec25-c030-4b0c-862b-c39726275743 |
| console | ttyS0,115200n8 |
| created_at | 2020-02-27T18:32:58.752361+00:00 |
| hostname | controller-0 |
| id | 1 |
| install_output | text |
| install_state | None |
| install_state_info | None |
| inv_state | inventoried |
| invprovision | provisioned |
| location | {} |
| mgmt_ip | 192.168.204.3 |
| mgmt_mac | 00:1e:67:54:aa:39 |
| operational | enabled |
| personality | controller |
| reserved | False |
| rootfs_device | /dev/disk/by-path/pci-0000:04:00.0-sas |
| | -0x5001e6754aa38000-lun-0 |
| serialid | None |
| software_load | nn.nn |
| task | |
| tboot | false |
| ttys_dcd | None |
| updated_at | 2020-02-28T15:17:06.658008+00:00 |
| uptime | 159970 |
| uuid | 92c86da2-adb7-4fb2-92fc-82759e25108d |
| vim_progress_status | services-enabled |
+-----------------------+------------------------------------------------+
Note
When NTP server is unreachable, alarm 100.114 is raised, and it will be cleared once the server becomes reachable.
It is possible to take some time to raise or clear alarm 100.114. NTP
related alarm depends on the ntpq command output and follows NTP
specification. The 8-bit register in the poll is used to determine the
server’s reachability. If the register contains any nonzero bits, the
server is considered reachable; otherwise, it is considered unreachable.
The current maximum poll interval is 128 seconds. As a result, it might take about 30 minutes to raise or clear alarm 100.114 in some cases. However, this is expected behavior.
