Basic system setting
Setting basic system information is done in
system context. This context allows to set hostname, clock, DNS, NTP, users, etc.
The basic system info is available using
show system command. The command outputs info about NetX platform,
NetXOS version, uptime and current power consumption (power consumption info is not available for cloud platform). The command
prints an out-of-band management IP address as well -- see Out of band management for
details how to set the address. Example of the command output.
netx# show system Platform: NetX-X1120 NetX OS version: NetXOS release 7.4.1708 (Core) Netc version: 1.12 Kernel version: 3.10.0-693.17.1.el7.netx.x86_64 Uptime: up 9 weeks, 5 days, 21 hours, 20 minutes Power Consumption: 46 W Service Module IP: 192.168.1.1/24
X.XX versioning scheme for a stable build. If you enable devel repository, new package is built with every commit to
netc git. In this case,
the versioning scheme is changed to
1.9.53.gb653e32 , where
C is number of commits since stable and
abrv is an abbreviated
object name for the commit itself.
To change the hostname, run
system hostname command with the desired hostname or use
hostname command in the system context.
netx# system hostname test-rt test-rt# system hostname netx netx#
Setting search domain and addresses of DNS serveres in the
system context is done using
netx# system domain-lookup domain.com netx# system name-server 22.214.171.124 netx# system name-server 126.96.36.199 ! You can use show command to verify the settings netx# show system domain-lookup domain.com netx# show system name-server 188.8.131.52 184.108.40.206
Setting timezone and clock information is possible using the
clock command in the
show system clock command can be used
to verify the settings.
netx# show system clock Local time: Wed 2017-05-03 15:22:31 UTC Universal time: Wed 2017-05-03 15:22:31 UTC RTC time: Wed 2017-05-03 15:22:53 Time zone: UTC (UTC, +0000) NTP synchronized: no RTC in local TZ: no DST active: n/a netx# system clock set 2017-01-10 16:22:13 ! It is possible to use <TAB> completion to find the correct timezone. netx# clock timezone Europe/Prague
NTP settings is done via
system ntp command. It is possible to set IP address or domain name of NTP server. The
default configuration use NTP servers
show system clock command can be used
to verify the settings.
netx# system ntp ntp1.netx.as Local time: Wed 2017-05-03 18:22:55 CEST Universal time: Wed 2017-05-03 16:22:55 UTC RTC time: Wed 2017-05-03 16:23:17 Time zone: Europe/Prague (CEST, +0200) NTP synchronized: yes RTC in local TZ: no DST active: yes Last DST change: DST began at Sun 2017-03-26 01:59:59 CET Sun 2017-03-26 03:00:00 CEST Next DST change: DST ends (the clock jumps one hour backwards) at Sun 2017-10-29 02:59:59 CEST Sun 2017-10-29 02:00:00 CET
More detailed information can be obtained by issuing a
show system ntp command.
The command displays detailed information about connected servers, their operational status, etc.
netx# show system ntp remote refid st t when poll reach delay offset jitter ============================================================================== *220.127.116.11 18.104.22.168 2 u 42 128 377 0.267 0.213 0.024
The columns meaning is the following:
remote : the remote server that is used for clock synchronization. The single character next to the remote server indicates whether the remote server is used for time synchronization. Possible values are:
- * : current time source used for clock synchronization
- # : source selected, an alternative backup. This is only shown if more than 10 remote servers are configured
- + : source selected, if the current time source (
*) is discarded, this is a candidate as a new best source
- o : source selected, Pulse Per Second (PPS) is used
- x : source discarded by the intersection algorithm
- . : source discarded by the intersection algorithm
- - : source discarded by cluster algorithm
- blank : source discarded as not valid, the reason can be uncreachability, high stratum, etc.
refid - the upstream stratum to the remote server. For stratum 1 servers, this will be the stratum 0 source
st - the stratum level, 0 through 16.
t - the type of connection. The most common values are:
- u : unicast
- b : broadcast or multicast
- l : local reference clock
when : the last time (seconds) when the server was queried for the time.
poll : how often the server is queried for the time
reach : success and failutre rate of communicating with the remote server. 8-bit left shift octal value. Success means the bit is set, failure means the bit is not set. 377 is the highest value (all attempts successful).
delay : round trip time (RTT) to the remote server (millisecods)
offset : how far off are the clock from the reported time on the remote server (milliseconds). It can be possitive or negative.
jitter : the root mean squared deviation of offsets (milliseconds).
The initial clock synchronization can take some time. If necessary, it is possible to sync clock manualy using
system ntp sync command.
netx# system ntp sync 12 Apr 19:31:42 ntpdate: adjust time server 22.214.171.124 offset -0.000804 sec
After manual sync, it will take some time before NTP marks clock as synchronized in
show system ntp
show system clock commands.
The default username in NETX routers is
netc set as the default shell. Additional users can be added in the
Adding a user via
user <username> command
! Add user 'test' netx# system user test netx(user-test)#
Password can be changed via
password command. A new password can be specified directly as a string parameter of the
password command or
ENTER is pressed after
! Set the password for the user netx(user-test)# password Changing password for user test-user. New password: Retype new password: passwd: all authentication tokens updated successfully.
It is possible to set encrypted password directly using
crypt keyword in
user context. The
crypt command expect input format
compatible with crypt glibc function.
User's login shell can be changed according the needs. The default login shell is
netc shell, but if e.g., bash shell is required
it is possible to change it via
! Set user's login shell to bash netx(user-test)# login-shell bash
The user can be removed via
no user <username> command.
! Remove user 'test' netx(system)# no user test
If password for the
admin account is forgotten, it is possible to start password recovery procedure by issuing the following steps:
ge2interfaces with straight through Ethernet cable
- Reboot NETX router
- After the reboot, the
admincredentials are set to default -
admin/N3tX0559in running config
- Log in and change the password using
system user admin passwordcommand
- Save the password using
copy running-config startup-configcommand
- Disconnect the cable between
- Reboot NETX router
The rest of the
startup-configuration is not changed. If you need to put NETX router to default configuration,
shell command following with
rm /etc/netc/startup-config after step
3 and then continue with step
Parts of NETX configuration, e.g., bird or firewall (iptables) configs, can be edited by an editor. The default editor is
however, different editor can be set as well using the
system editor command.
! list available editors netx# system editor ? <str> - editor name joe mcedit nano vi vim ! change the default editor to nano netx# system editor nano ! revert back to vim netx# no system editor nano
The out-of-band management is implemented using Intelligent Platform Management Interface (IPMI) and provides management and
monitoring capabilities independently of the NETX system. The configuration is available in
system context using
netx# show system service-module ? <cr> factory-default - Load default configuration to service module gw - Service interface IPv4 Gateway ip - Service IPv4 interface user - Service user list
Setting up management IP address and gateway:
netx# system service-module ip 192.168.1.1/24 netx# system service-module gw 192.168.1.254
Setting up user
new_admin with a top secret password:
netx# system service-module user new_admin password secretpassword
Management web interface is available at
https://<service-module ip>. The settings can be
show system service-module command.
netx# show system service-module Power Consumption: 44 W PS1: OK PS2: OK Fan1: 5400 RPM Fan2: 5600 RPM Fan3: 5700 RPM CPU: 60 C System: 35 C Peripheral: 38 C DIMMA1: 29 C DIMMB1: 31 C Service Module IP: 192.168.1.1/24 Service Module GW: 192.168.1.254 Service Module MAC: ac:1f:6b:2e:e7:28
There are separate commands to show just info about power supplies, fans and CPU temperatures. E.g.
netx# show system power Power Consumption: 45 W PS1: OK PS2: OK netx# show system fan Fan1: 5400 RPM Fan2: 5700 RPM Fan3: 5600 RPM netx# show system temperature CPU: 59 C System: 35 C Peripheral: 38 C DIMMA1: 28 C DIMMB1: 31 C
The list of usernames can be shown via
show system service-module user. E.g.:
netx(config)# show service-module user netx new_admin
Remote logging is available using syslog protocol via UDP. Server can be configured using
system logging server
command with server's
ip address. Port can be also specified using
:portnumber after server's address. Port number configuration is optional, if port is not configured, the default port
514 will be used. E.g.:
netx(config)# system logging server 192.168.1.1:514
Syslog messages are classified by facility and severity. More than one logging
facility can be configured to filter messages sent to server. If no
facility is configured, NETX does not filter logging messages and sends them to server. E.g.:
netx(config)# system logging facility auth netx(config)# system logging facility syslog