Ruijie RG-CS83-PD Series User manual

Ruijie RG-CS83-PD Series Switches
CS83-PD_RGOS 12.5(4)B0707
Configuration Guide
Document Version: V1.0
Date: 2023.04.27
Copyright © 2023 Ruijie Networks

Copyright
Copyright © 2023 Ruijie Networks
All rights are reserved in this document and this statement.
Any reproduction, excerption, backup, modification, transmission, translation or commercial use of this document
or any portion of this document, in any form or by any means, without the prior written consent of Ruijie Networks
is prohibited.
Trademark and are owned by Ruijie Networks.
All other trademarks or registered trademarks mentioned in this document are owned by their respective owners.
Disclaimer
The products, services, or features you purchase are subject to commercial contracts and terms. Some or all of
the products, services or features described in this document may not be within the scope of your purchase or
use. Unless otherwise agreed in the contract, Ruijie Networks does not make any express or implied statement
or guarantee for the content of this document.
Due to product version upgrades or other reasons, the content of this document will be updated from time to
time. Ruijie Networks reserves the right to modify the content of the document without any notice or prompt.
This manual is for reference only. Ruijie Networks endeavors to ensure content accuracy and will not shoulder
any responsibility for losses and damages caused due to content omissions, inaccuracies or errors.

Preface
Intended Audience
This document is intended for:
Network engineers
Technical support and servicing engineers
Network administrators
Technical Support
Ruijie Networks Website: https://www.ruijienetworks.com/
Technical Support Website: https://ruijienetworks.com/support
Case Portal: https://caseportal.ruijienetworks.com
Community: https://community.ruijienetworks.com
Technical Support Email: servi[email protected]
Live Chat: https://www.ruijienetworks.com/rita
Conventions
1. Conversions
Convention
Description
Bold font
Commands, command options, and keywords are in bold font.
Italic font
Arguments for which you supply values are in italic font.
[ ]
Elements in square brackets are optional.
{ x | y | z }
Alternative keywords are grouped in braces and separated by
vertical bars.
[ x | y | z ]
Optional alternative keywords are grouped in brackets and
separated by vertical bars.
&<1-n>
The argument before the sign (&) can be input for consecutive 1- n
times.
//
Double slashes at the beginning of a line of code indicate a
comment line.
2. Signs
The signs used in this document are described as follows:

Warning
An alert that calls attention to important rules and information that if not understood or followed can result in
data loss or equipment damage.
Caution
An alert that calls attention to essential information that if not understood or followed can result in function
failure or performance degradation.
Note
An alert that contains additional or supplementary information that if not understood or followed will not lead to
serious consequences.
Specification
An alert that contains a description of product or version support.
3. Note
The manual offers configuration information (including model, port type and command line interface) for
indicative purpose only. In case of any discrepancy or inconsistency between the manual and the actual version,
the actual version prevails.

Basic Configuration
CLI Configuration
ZAM Configuration
Basic Management Configuration
RBAC Configuration
Line Configuration
File System Configuration
USB Configuration
HTTP Configuration
Syslog Configuration
Software Upgrade Configuration
Uboot Configuration
Rboot Configuration
Time Range Configuration
UFT Mode Management Configuration
Supervisor Module Redundancy Configuration
Hot Swapping Configuration
Process Restarting Configuration
Python Configuration
License Management Configuration

Configuration Guide Contents
i
Contents
1 Configuring the CLI............................................................................................................................1
1.1 Introduction................................................................................................................................1
1.1.1 Accessing the CLI..........................................................................................................1
1.1.2 Command Modes...........................................................................................................1
1.1.3 System Help...................................................................................................................3
1.1.4 Abbreviated Commands ................................................................................................4
1.1.5 No and Default Options of Commands..........................................................................4
1.1.6 Prompts for Incorrect Commands..................................................................................5
1.1.7 History Commands ........................................................................................................5
1.1.8 Featured Editing.............................................................................................................6
1.1.9 Searching and Filtering of the Show Command Output................................................7
1.1.10 Command Alias............................................................................................................8
1.1.11 Character Set Encoding...............................................................................................9
1.2 Restrictions and Guidelines.......................................................................................................9
1.3 Configuration Task Summary..................................................................................................10
1.4 Operating the Python Script.....................................................................................................10
1.5 Configuring a Command Alias.................................................................................................10
1.6 Configuring the Privilege Level of a Command.......................................................................11
1.7 Configuring the Character Set Encoding Format....................................................................11
1.8 Monitoring................................................................................................................................12

Configuration Guide Configuring the CLI
1
1 Configuring the CLI
1.1 Introduction
The command line interface (CLI) is a window for text instruction interaction between users and network
devices. Users can enter commands in the CLI to configure and manage network devices.
1.1.1 Accessing the CLI
Before using the CLI, you need to connect a terminal or PC to a network device. After you start the network
device and initialize the hardware and software of the network device, you can use the CLI. If you use the
network device for the first time, you can connect it only through the console port. This is called out-of-band
management. After performing relevant configuration, you can connect and manage the network device by
telnetting to the virtual terminal.
1.1.2 Command Modes
Since the device has many commands, you can classify them by function to facilitate their use. The CLI
provides several commands modes, and all commands are registered in one or several command modes. You
must enter the mode of a command before using this command. Command modes are related with each other
but differ from each other.
As soon as a new session is set up between a user and the management interface of a network device, you
enter user EXEC mode. In this mode, you can use a few commands and the command functions are limited,
such as the show command. Execution results of commands in user EXEC mode are not saved.
To use more commands, enter privileged EXEC mode. Generally, you must enter a password to enter privileged
EXEC mode. In privileged EXEC mode, you can use all commands registered in this command mode, and
further enter global configuration mode.
Using commands in configuration modes (such as global configuration mode and interface configuration mode)
affects configurations in use. If you save the configurations, these commands are saved and run when the
system restarts. To enter another configuration mode, enter global configuration mode. If you perform
configuration in global configuration mode, you can enter various configuration sub-modes, such as interface
configuration mode.

Configuration Guide Configuring the CLI
2
Table 1-1 Description of the Command Modes (suppose that the name of the network device is
"Device")
Command
Mode
Access Method
Prompt
Exit or Entering Next
Mode
Function
Description of the
Mode
User EXEC
mode
A user enters
user EXEC
mode by default
when accessing
a network
device.
Device>
Run the exit
command to exit this
mode.
Run the enable
command to enter
privileged EXEC
mode.
Use this command
mode to conduct
basic tests or
display system
information.
Privileged
EXEC mode
In User EXEC
mode, run the
enable
command to
enter privileged
EXEC mode.
Device#
Run the disable
command to return
to user EXEC mode.
Run the configure
command to enter
global configuration
mode.
Use this command
mode to check
whether the
configurations take
effect. This mode is
password-protected.
Global
configuration
mode
In Privileged
EXEC mode, run
the configure
command to
enter global
configuration
mode.
Device(config)#
Run the exit or end
command, or press
Ctrl+C to return to
privileged EXEC
mode.
Run the interface
command to enter
interface
configuration mode.
In the interface
command, you must
specify the interface
configuration
sub-mode you want
to enter.
Run the vlan vlan-id
command to enter
VLAN configuration
mode.
Use commands in
this mode to
configure global
parameters that
affect the entire
network device.
Interface
configuration
mode
In global
configuration
mode, run the
interface
gigabitethernet
0/1 command to
enter interface
configuration
mode.
Device(config-if-
gigabitethernet
0/1)#
Run the end
command or press
Ctrl+C to return to
privileged EXEC
mode.
Run the exit
command to return
to global
configuration mode.
In the interface
command, you must
specify the interface
configuration
sub-mode you want
to enter.
Use this command
mode to configure
various interfaces of
the network device.

Configuration Guide Configuring the CLI
3
Command
Mode
Access Method
Prompt
Exit or Entering Next
Mode
Function
Description of the
Mode
Config-vlan
(VLAN
configuration
mode)
In global
configuration
mode, run the
vlan vlan-id
command to
enter VLAN
configuration
mode.
Device(config-vlan)#
Run the end
command or press
Ctrl+C to return to
privileged EXEC
mode.
Run the exit
command to return
to global
configuration mode.
Use this command
mode to configure
VLAN parameters.
1.1.3 System Help
When entering commands in the CLI, you can obtain help information by using the following methods:
At the command prompt in any mode, enter a question mark (?) to list the commands supported in current
command mode and command description.
Device> ?
Exec commands:
<1-99> Session number to resume
disable Turn off privileged commands
disconnect Disconnect an existing network connection
enable Turn on privileged commands
exit Exit from the EXEC
help Description of the interactive help system
lock Lock the terminal
ping Send echo messages
show Show running system information
telnet Open a telnet connection
traceroute Trace route to destination
Enter a space and a question mark (?) after a keyword of a command to list the next keyword or variable
associated with the keyword.
Device(config)# interface ?
Aggregateport Aggregate port interface
Dialer Dialer interface
GigabitEthernet Gigabit Ethernet interface
Loopback Loopback interface
Multilink Multilink-group interface
Null Null interface
Tunnel Tunnel interface
Virtual-ppp Virtual PPP interface
Virtual-template Virtual Template interface
Vlan Vlan interface

Configuration Guide Configuring the CLI
4
range Interface range command
Note
If a keyword is followed by a parameter value, the value range and description of this parameter are
displayed as follows:
Device(config)# interface vlan ?
<1-4094> Vlan port number
Enter a question mark (?) after an incomplete string of a command keyword to list all command keywords
starting with the string.
Device# d?
debug delete diagnostic dir disable disconnect
After an incomplete command keyword is entered, if the suffix of this keyword is unique, press the Tab key
to display the complete keyword.
Device# show conf<Tab>
Device# show configuration
In any command mode, you can run the help command to obtain brief description of the help system.
Device(config)# help
Help may be requested at any point in a command by entering
a question mark '?'. If nothing matches, the help list will
be empty and you must backup until entering a '?' shows the
available options.
Two styles of help are provided:
1. Full help is available when you are ready to enter a
command argument (e.g. 'show ?') and describes each possible
argument.
2. Partial help is provided when an abbreviated argument is entered
and you want to know what arguments match the input
(e.g. 'show pr?'.)
1.1.4 Abbreviated Commands
If a command is long, you can enter a part of the command keyword characters that are used to identify the
command keyword.
For example, the interface gigabitethernet 0/1 command for entering the configuration mode of interface
GigabitEthernet 0/1 is abbreviated as follows:
Device(config)# int g0/1
Device(config-if-GigabitEthernet 0/1)#
1.1.5 No and Default Options of Commands
Most commands have the no option. Generally, the no option is used to disable a feature or function, or perform
an operation opposite to a command. For example, run the no shutdown command on an interface to perform
the operation opposite to the shutdown command, that is, enable the interface. The keyword without the no
option is used to enable a disabled feature or a feature that is disabled by default.

Configuration Guide Configuring the CLI
5
Most configuration commands have the default option. The default option is used to restore settings of a
command to default values. Default values of most commands are used to disable this function. Therefore, in
most cases, the function of the default option is the same as that of the no option. For some commands,
however, the default values are used to enable this function. In this case, the function of the default option is
opposite to that of the no option. At this time, the default option is used to enable the function of this command
and set the variables to default values.
Note
For specific function of the no or default option of each command, see the command reference.
1.1.6 Prompts for Incorrect Commands
If an incorrect command is entered, an error prompt is displayed.
Table 1-2 Common CLI Errors
Error
Description
How to Obtain Help
% Ambiguous
command: "show c"
The characters entered are too
few to identify a unique
command.
Enter the command again, and enter a question
mark (?) after the ambiguous word. All the
possible keywords are displayed.
% Incomplete
command.
The mandatory keyword or
variable is not entered in the
command.
Enter the command again, and enter a space
and a question mark (?). All the possible
keywords or variables are displayed.
% Invalid input
detected at ‘^’
marker.
An incorrect command is
entered. The symbol (^)
indicates the position of the
wrong word.
At the current command mode prompt, enter a
question mark (?). All the command keywords
allowed in this command mode are displayed.
1.1.7 History Commands
The system automatically saves commands that are entered recently. You can use shortcut keys to query or call
history commands.
Table 1-3 Operation Methods
Operation
Result
Ctrl+P or the
Up key
The previous command in the history command list is displayed. Starting from the latest
record, you can repeatedly perform this operation to query earlier records.
Ctrl+N or the
Down key
After pressing Ctrl+P or the Up key, you can perform this operation to return to a command
that is more recently executed in the history command list. You can repeatedly perform this
operation to query more recently executed commands.

Configuration Guide Configuring the CLI
6
Specification
The standard terminals, such as the VT100 series, support the direction keys.
1.1.8 Featured Editing
When editing commands, you can use the keys or shortcut keys listed in the following table:
Table 1-4 Description of Shortcut Keys
Function
Key or
Shortcut Key
Description
Move the cursor in a
line.
Left key or
Ctrl+B
Move the cursor to the left by one character.
Right key or
Ctrl+F
Move the cursor to the right by one character.
Ctrl+A
Move the cursor to the head of the command line.
Ctrl+E
Move the cursor to the end of the command line.
Delete an entered
character.
Backspace key
Delete one character to the left of the cursor.
Delete key
Delete one character to the right of the cursor.
Move the output by
one line or one page.
Enter key
When the output is displayed, press the Enter key to move the
output one line upward and display the next line. Use this key
only when the output does not end yet.
Space key
When the output is displayed, press the Space key to page down
and display the next page. Only when the output does not end,
use this key.
When the cursor is close to the right boundary, the entire command line moves to the left by 20 characters, and
the hidden front part is replaced with a dollar ($) sign. You can use related keys or shortcut keys to move the
cursor to the characters in the front or return to the head of the command line.
For example, the entire access-list command may be wider than the screen. When the cursor is first close to
the end of the command line, the entire command line moves to the left by 20 characters, and the hidden front
part is replaced with a dollar sign ($). Each time the cursor is close to the right boundary, the entire command
line moves to the left by 20 characters.
access-list 199 permit ip host 192.168.180.220 host
$ost 192.168.180.220 host 202.101.99.12
$0.220 host 202.101.99.12 time-range tr
Press Ctrl+A to return to the head of the command line. At this time, the hidden tail part of the command line is
replaced with a dollar sign ($).
access-list 199 permit ip host 192.168.180.220 host 202.101.99.$

Configuration Guide Configuring the CLI
7
Note
The default line width of terminals is 80 characters.
1.1.9 Searching and Filtering of the Show Command Output
To search specified content in the output of the show command, run the following command:
Table 1-5 Searching for Specified Content in the Output of the show Command
Command
Purpose
show any-command | [ regexp ] begin
regular-expression
Searches for specified content in the output of the
show command, and outputs the first line containing
the content and all information that follows this line.
To filter specified content in the output of the show command, run the following commands:
Table 1-6 Filtering Specified Content in the Output of the show Command
Command
Purpose
show any-command | [ regexp ] exclude
regular-expression
Filters the output of the show command to filter out
lines containing the specified content, and outputs
other information.
show any-command | [ regexp ] include
regular-expression
Filters the output of the show command to output
only the lines containing the specified content, and
filters out other information.
Note
The show command can be executed in any mode.
Searched content is case-sensitive.
When the regexp keyword is specified, a regular expression can be used for filtering content. The following
table describes the usages of special characters in a regular expression.

Configuration Guide Configuring the CLI
8
Table 1-7 Description of Usages of Special Characters in a Regular Expression
Character
Symbol
Special Meaning
Period
.
Matches any single character.
Plus sign
+
Matches one or any sequence in a string.
Caret
^
Matches the start of a string.
Underline
_
Matches commas, brackets, start and end of a string, and spaces.
Square brackets
[ ]
Matches a single character within a range.
To search or filter the output of the show command, you must enter a vertical line (|). After the vertical line,
specify the search or filter rules and content to be searched or filtered (characters or strings). Content to be
searched and filtered is case-sensitive.
Device# show running-config | include interface
interface GigabitEthernet 0/0
interface GigabitEthernet 0/1
interface GigabitEthernet 0/2
interface GigabitEthernet 0/3
interface GigabitEthernet 0/4
interface GigabitEthernet 0/5
interface GigabitEthernet 0/6
interface GigabitEthernet 0/7
interface Mgmt 0
Device# show running-config | regexp include GigabitEthernet [0-9]/1
interface GigabitEthernet 0/1
1.1.10 Command Alias
You can specify any word as the alias of a command to simplify the input of the command string.
1. Default aliases in the system
In configuration mode or privileged EXEC mode, default aliases are available for some commands. You can run
the show aliases command to display these default aliases.
Device(config)# show aliases
Exec mode alias:
h help
p ping
s show
u undebug
un undebug
Note
Default aliases in the system cannot be deleted.

Configuration Guide Configuring the CLI
9
2. System help regarding command aliases
The system provides help information for command aliases. An asterisk (*) is displayed in front of an alias in
the following format:
*command-alias=original-command
For example, in privileged EXEC mode, the default command alias "s" represents the keyword show. If you
enter "s?", help information of the keywords and aliases starting with "s" is displayed.
Device# s?
*s=show show start-chat start-terminal-service
If the command represented by an alias contains more than one word, the command is displayed in a pair of
quotation marks.
For example, in privileged EXEC mode, configure the alias "sv" to replace the show version command. If
you enter "s?", help information of the keywords and aliases starting with "s" is displayed.
Device# s?
*s=show *sv=”show version” show start-chat
start-terminal-service
You can use an alias to obtain help information of the command represented by the alias.
For example, if you configure the alias "ia" in interface configuration mode to represent the ip address
command, you can enter "ia?" in interface configuration mode to obtain help information of "ip address?",
and replace the alias with the actual command.
Device(config-if)# ia ?
A.B.C.D IP address
dhcp IP Address via DHCP
Device(config-if)#ip address
Caution
If you enter a space in front of a command alias, the command represented by this alias is displayed.
1.1.11 Character Set Encoding
The function of character set encoding enables the device to use a unified character set encoding format by
configuring character set encoding. After a command is entered in the CLI of a terminal, the command is
automatically converted into a command in the unified character set encoding format before delivery.
Note
When hybrid formats exist in current running configurations, you must manually delete running configurations
containing the encoding format different from the target format before modifying the character set encoding
format.
1.2 Restrictions and Guidelines
You can adopt UTF-8/GBK to perform configuration in Chinese. When you use the cursor to process words or
delete Backspace in the CLI, the interface may display errors or garbled characters. You are advised to delete

Configuration Guide Configuring the CLI
10
all current characters and then configure a unified character set encoding format. Upon word processing or
Backspace deletion, you can run the show running-config command to check whether the configurations are
correct. (To delete a Chinese character, you must press the Backspace key twice in the case of GBK, but must
press the Backspace key three times in the case of UTF-8.)
1.3 Configuration Task Summary
CLI configuration includes the following tasks: All the configuration tasks below are optional. Select the
configuration tasks as required.
Operating the Python Script
Configuring a Command Alias
Configuring the Privilege Level of a Command
Configuring the Character Set Encoding Format
1.4 Operating the Python Script
1. Overview
This section describes how to load and unload the Python script of CLI.
2. Procedure
(1) Enter the privileged EXEC mode.
enable
(2) Operate the Python script. The configuration steps below are mutually exclusive. Select one of them for
configuration.
○Load the Python script.
cli-python insmod python-filename
○Unload the Python script.
cli-python rmmod python-filename
1.5 Configuring a Command Alias
1. Overview
You can specify any word as the alias of a command to simplify the input of the command string.
2. Restrictions and Guidelines
The command replaced with an alias must start from the first character of the command line.
The command replaced with an alias must be complete.
An alias must be entered in full; otherwise, it cannot be identified.
3. Procedure
(1) Enter the privileged EXEC mode.
enable

Configuration Guide Configuring the CLI
11
(2) Enter the global configuration mode.
configure terminal
(3) Configure an alias to replace the front part of a command.
alias mode command-alias original-command
Default aliases are available for some commands in global configuration mode or privileged EXEC mode
by default.
1.6 Configuring the Privilege Level of a Command
1. Overview
This section describes how to configure the privilege level of a command.
2. Procedure
(1) Enter the privileged EXEC mode.
enable
(2) Enter the global configuration mode.
configure terminal
(3) Configure the privilege level of a command.
privilege mode [ all ] { level level |reset } command-string
1.7 Configuring the Character Set Encoding Format
1. Overview
This section describes how to configure a unified character set encoding format for the device.
2. Restrictions and Guidelines
When hybrid formats exist in current running configurations of the device, you must manually delete running
configurations containing the encoding format different from the target format before modifying the character
set encoding format.
3. Procedure
(1) Enter the privileged EXEC mode.
enable
(2) Enter the global configuration mode.
configure terminal
(3) Configure the character set encoding format.
language character-set { default | GBK | UTF-8 }
By default, hybrid formats are supported.

Configuration Guide Configuring the CLI
12
1.8 Monitoring
Run the show command to check the running status of a configured function to verify the configuration effect.
Table 1-8 Monitoring of the CLI
Command
Purpose
show aliases [ mode ]
Displays all command aliases or the command aliases in specific
command mode.

Configuration Guide Contents
i
Contents
1 Configuring ZAM................................................................................................................................1
1.1 Introduction................................................................................................................................1
1.1.1 Overview........................................................................................................................1
1.1.2 Principles........................................................................................................................1
1.2 Restrictions and Guidelines.......................................................................................................2
1.3 Configuring ZAM........................................................................................................................2
1.3.1 Overview........................................................................................................................2
1.3.2 Restrictions and Guidelines...........................................................................................2
1.3.3 Prerequisites..................................................................................................................2
1.3.4 Procedure.......................................................................................................................3
1.4 Monitoring..................................................................................................................................4
1.5 Configuration Examples.............................................................................................................4
1.5.1 Configuring ZAM............................................................................................................4

Configuration Guide Configuring ZAM
1
1 Configuring ZAM
1.1 Introduction
1.1.1 Overview
The zero automatic manager (ZAM) function enables the device to automatically download the software version,
upgrade the device version, and apply configuration files when the device has no configuration and the network
administrator is not in contact with the field devices. ZAM simplifies the operation, maintenance, and
deployment of massive devices, lowers the labor cost, reduces human errors, and improves the efficiency of
network deployment.
1.1.2 Principles
Figure 1-1 ZAM Automatic Go-Online Solution
ZAM go-online and deployment include four stages as follows:
Initialization
At this stage, a device that goes online without configurations connects to a network and completes
initialization. The device automatically pre-deploys the ZAM environment. During the pre-deployment, the
MGMT port or service port must be used as the ZAM interface. The device automatically performs
configuration, without any need of extra configuration by the administrator.
(2) DHCP
Upon the pre-deployment above, the ZAM interface requests an IP address from the Dynamic Host
Configuration Protocol (DHCP) server via the DHCP protocol. In a reply packet, the reply packet carries
Option 66 (containing the IP address of the file server) and Option 67 (containing the name of the Python
script to be downloaded). The requirements are as follows:
○The ZAM interface supports DHCP.
○Configure the ZAM interface with a DHCP-allocated IP address. DHCP requests support Option 66 and
Option 67, and Option 66 and Option 67 have been configured in the address pool of the DHCP server.
Device DNS Server
File Server
DHCP Server