Published On: August 6ᵗʰ, 2019 02:06

Cisco Enterprise Network Function Virtualization Infrastructure Software Command Reference

System Time Commands

system time

To set the system time using the Network Time Protocol (NTP) server, use the system time command in global configuration mode. Use the no form of the command to delete the time configuration.


Note
When you enable and synchronize the system time clock using an NTP server, you must reboot the Cisco Enterprise NFVIS so that the BMC or CIMC date and time get updated with the new hardware clock.

system time [ timezone zone-subzone ] [ ntp [ preferred_server { ipv4-address | host-name } ] [ backup_server { ipv4-address | host-name } ] | ntp-ipv6 { ipv6-address | host-name } ]

no system time { ntp | ntp-ipv6 }

Syntax Description

timezone zone-subzone

Specifies the timezone using zone and subzone.

ntp

Specifies the time using the NTP IPv4 server.

preferred_server

Specifies the IPv4 preferred server details.

ipv4-address

Specifies the IPv4 address.

hostname

Specifies the hostname.

backup_server

Specifies the IPv4 backup server details.

ntp-ipv6

Specifies the time using the NTP IPv6 server.

ipv6-address

Specifies the IPv6 address.

Command Default

None

Command Modes

Global configuration (config)

Command History

Release Modification

3.7.1

The manual_time parameter is removed and the ntp-ipv6 parameter is added.

To set the system time manually, use the system set-manual-time command.

3.5.1

This command was introduced.

Usage Guidelines

When you set the system time manually using the system set-manual-time command, the NTP is disabled automatically. Similarly, when NTP is enabled, the manual time configuration is automatically disabled.

Examples

The following example shows how to set system time using NTP IPv4 server:

nfvis(config)# system time ntp preferred_server 198.51.100.1 backup_server 203.0.113.1
nfvis(config)# commit

Examples

The following example shows how to set system time using NTP IPv6 server:

nfvis(config)# system time ntp-ipv6 2001:420:30d:201:ffff:ffff:fff4:35
nfvis(config)# commit

system set-manual-time

To set the system time clock manually, use the system set-manual-time command in privileged EXEC mode.

system set-manual-time date-time

Syntax Description

date-time

Specifies the manual date and time in YYYY-MM-DDTHH:MM:SS format. The supported year range for specifying the manual time is from 2016 to 2036.

Command Default

None

Command Modes

Privileged EXEC (#)

Command History

Release Modification

3.7.1

This command was introduced.

Usage Guidelines

When you set the system time manually, the NTP is disabled automatically. Similarly, when NTP is enabled using the system-time command, the manual time configuration is automatically disabled.

Examples

nfvis# system set-manual-time 2017-01-01T17:35:39

show system time

To view the system time clock configuration details, use the show system time command in privileged EXEC mode.

show system time [ current-time | current-timezone | ntp [ status] ]

Syntax Description

current-time

Displays the current system time.
current-timezone

Displays the current system time zone.
ntp

Displays the synchronization status of the NTP server.
status

Displays the NTP status. You can filter the status using any of the following fields: delay, jitter, offset, poll, reach, refid, st, t, or when.

Command Default

All time configuration details are displayed.

Command Modes

Privileged EXEC (#)

Command History

Release Modification

3.7.1

The command was modified to include the current-time, current-timezone, ntp, status parameters and remove the backup-server, date, ntp-status, preferred-server, and timezone parameters.

3.5.1

This command was introduced.

Usage Guidelines

If the configured NTP server is not displayed in the command output, check that the NTP server is configured correctly.

When a remote host is queried, if the response is not received before the timeout time, the request times out and the information is not displayed in the command output.

Examples

The following is a sample output of the show system time ntp status command:

nfvis# show system time ntp status
REMOTE                  REFID  ST       T  WHEN         POLL    REACH DELAY  OFFSET  JITTER 
==========================================================================================
*2001:420:30d:20        .GPS.   2       u  35           64      377   0.927  6.551   1.319 

* sys.peer and synced, o pps.peer, # selected, + candidate,
- outlyer, . excess, x falseticker, space reject

show running-config system time

To display the running system time configuration, use the show running-config system time command in privileged EXEC mode.

show running-config system time

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Privileged EXEC (#)

Command History

Release Modification
3.5.1

This command was introduced.

Examples

nfvis# show running-config system time
system time ntp preferred_server 1.2.3.4
system time ntp backup_server 2.2.2.2
system time timezone America/New_York
system time ntp-ipv6 2001:420:30d:201:ffff:ffff:fff4:35