System Settings

Introduction

The system settings under the configuration context can be used to set general information about the device, such as hostname, timezone, and other system-wide settings.

To enter the system settings context:

example:/#> configure
example:/config/#> system
example:/config/system/#>

Configuration

Hostname

The system hostname is used to identify the device in a network. It can be configured in the CLI as shown in the example below.

example:/#> configure
example:/config/#> system
example:/config/system/#> hostname bob
example:/config/system/#> leave
bob:/#>

The set of allowed characters follows the specification defined in RFC 1123. This includes letters (a-z, A-Z), digits (0-9) and hyphens (-). Additionally, underscores (_) are also allowed. The hostname cannot start or end with a hyphen or underscore, and cannot exceed 63 characters.

[no] hostname [HOSTNAME]

System hostname.

no

Reset to the default hostname.

HOSTNAME

Hostname string (1..63 characters).

RFC 1123 compliant.

Allowed characters are:

Letters (A-Z, a-z), numbers (0-9), dash (-), and underscore (_).
Hostname may not start or end with dash (-) or underscore (_).

Description

The system description provides a brief text describing the device or its role in the network.

example:/config/system/#> description "Main office router"

[no] description [DESCRIPTION]

System description.

no: Reset to the default description.
DESCRIPTION: Description text.

Location

The system location describes where the device is physically located.

example:/config/system/#> location "Rack 5, Room 101, Building A"

[no] location [LOCATION]

Location of the system.

no: Remove the configured location.
LOCATION: Location text.

Contact

The contact information for the system. It is typically used to specified an email address or the name of the person responsible for maintaining the device.

example:/config/system/#> contact "admin@example.com"

[no] contact [EMAIL]

Contact information for the system.

no: Remove the configured contact information.
EMAIL: Contact text (e.g., email address).

Message of the Day (MOTD)

The message of the day (MOTD) is a banner displayed when a user logs in. This can be used to display policy information, warnings, or any other message for users accessing the device.

example:/config/system/#> motd "Welcome to the network gateway.\nContact admin@example.com for support."

For flexible formatting, certain control characters are allowed:

Control Character	Description
`\a`	BELL
`\b`	Backspace
`\t`	Horizontal TAB
`\n`	New line
`\v`	Vertical TAB
`\f`	Form Feed
`\r`	Carriage Return
`\e`	ANSI escape
`\\`	Backslash

[no] motd [MESSAGE]

System postlogin message.

no: Reset to the default message.
MESSAGE: Message text, enclosed in quotes.

Timezone

The timezone setting controls the local time displayed by the device. Daylight saving time (DST) adjustments are applied automatically based on the selected timezone.

The timezone can be configured as below:

example:/config/system/#> show timezone Europe
Europe/Amsterdam
Europe/Berlin
Europe/London
Europe/Stockholm
...
example:/config/system/#> timezone Europe/Stockholm

[no] timezone <timezone> [no-dst]

System timezone.

no: Reset to the default timezone (UTC).
timezone: A valid timezone identifier (e.g., Europe/Stockholm)
no-dst: Disable daylight saving time adjustments

list-timezones

List all available timezones