- Print
- PDF
Unit management commands are used to manage access permissions, mode access and terminal configurations.
Unit management CLI commands are categorized as follows:
Configuration Commands
This section includes unit management configuration commands.
admin username
Command Objective:
This command enables the admin users to access NETCONF.
The no form of the command disables access for the admin users.
Syntax:
admin username <string(20)> password
no admin username <string(20)>
Parameter Description:
- username < string(1-20) > - Configures the User ID to be used for login. This value is a string of maximum size 20.
- password < string(8-20) > - Configures the Password to be entered by the user. This value is a string of maximum size 20.
Mode:
Global Configuration Mode
Example:
Your Product (config)# admin user netconf1 password Test#123
alias – Interface | exec | configure
Command Objective:
This command replaces the given token / command with the given string.
This command is a standardized implementation of the existing command. It operates similarly to that of the command alias replacement, except that it allows the user to type a command with multiple tokens without quotes.
Syntax:
alias {interface | exec | configure} < alias-name > { command <max 10 tokens> | token }
Parameter Description:
- interface - Specifies the commands executed in interface configuration mode.
Note: This feature has been included to adhere to the Industry Standard CLI syntax. This feature is currently not supported. - exec - Specifies the commands executed in privileged EXEC / user EXEC mode.
Note: This feature has been included to adhere to the Industry Standard CLI syntax. This feature is currently not supported. - configure - Specifies the commands executed in configuration mode (That is, global, line, profile, vlan, switch and protocol specific configuration modes).
Note: This feature has been included to adhere to the Industry Standard CLI syntax. This feature is currently not supported. - < alias-name > - Specifies the alternate name to be used for the command or token.
- command <max 10 tokens> - Specifies the command and token values for which alias name should be configured.
- token - Specifies the token for which alias name should be configured.
Mode:
Global Configuration Mode
Prerequisites:
Alias name can be set only for the commands having equal to or less than 10 tokens.
Example:
Your Product (config)# alias exec cltcp command clear tcp
alias – replacement string
Command Objective:
This command replaces the given token by the given string.
The no form of the command removes the alias created for the given string.
Syntax:
alias < replacement string > < token to be replaced >
no alias < alias >
Parameter Description:
- < replacement string >/ < alias > - Specifies the string for which a replacement is needed.
- < token to be replaced > - Specifies an abbreviated / short form of the replacement string
Mode:
Global Configuration Mode
Example:
Your Product (config)# alias products pdt
archive download-sw
Command Objective:
This command performs an image download operation on a switch stack or on a standalone switch to download a new image from an SFTP from a remote location to the switch, and to overwrite or keep the existing image.
Syntax:
archive download-sw /overwrite [ /reload ] { tftp://server/filename | sftp://< user-name >:< pass-word >@server/filename | flash:filename}
Parameter Description:
/overwrite - Overwrites the software image in flash with the downloaded one. This option should be specified only if the flash device has sufficient space to hold two images.
tftp://server/filename - Configures the source URL and filename used to overwrite / update the existing image. The file is transferred using TFTP.
sftp://< user-name >:< pass-word >@server/filename < alias > - Configures the source URL, user name, password and filename used to overwrite / update the existing image. The file is transferred using SFTP.
flash:filename - Configures the name of the flash file used to overwrite / update the existing image.
Mode:
Privileged EXEC Mode
Example:
Your product# archive download-sw /overwrite tftp://20.0.0.1/ISS.exe
Download is in Progress...
configure terminal
Command Objective:
This command enters to Global Configuration Mode which allows the user to execute all the commands that support global configuration mode.
Syntax:
configure terminal
Mode:
Privileged EXEC Mode
Example:
Your Product# configure terminal
copy
Command Objective:
This command copies the configuration from a remote site to flash.
Syntax:
copy { sftp://< user-name >:< pass-word >@server/filename startup-config }
Parameter Description:
- sftp://< user-name >:< pass-word >@server/filename - Configures the name of the file in remote location to be copied (downloaded) into configuration file (flex.conf). This option configures the SFTP server details.
Mode:
Privileged EXEC Mode
Example:
your product# copy sftp://< user >:< password >@< serverip >/flex.conf startup-config
default mode
Command Objective:
This command configures the mode by which the default interface gets its IP address.
This configuration takes effect only on switch restart.
Syntax:
default mode { manual | dynamic }
Parameter Description:
- manual - Assigns static IP address to the default interface. The IP address and IP mask configured by the user are assigned to the default interface.
- dynamic - Assigns dynamic IP address to the default interface. That is, IP address provided by the server in the network is assigned to the default interface on switch reboot. The IP address is fetched through the dynamic IP address configuration protocols such as DHCP client, RARP client, and BOOTP client.
Mode:
Global Configuration Mode
Default:
manual
Example:
Your Product(config)# default mode dynamic
enableuser
Command Objective:
This command releases the blocked user specified by the username string.
Note: Only the root user can enable blocked users.
Syntax:
enableuser < username >
Mode:
Global Configuration Mode
Example:
Your Product (config)# enableuser user1
end
Command Objective:
This command exits from the current mode to the Privileged EXEC mode.
Syntax:
end
Mode:
All Modes
Example:
Your Product# end
erase
Command Objective:
This command clears the contents of the startup configuration or sets parameters in NVRAM to default values.
Syntax:
erase {startup-config | nvram: | flash:filename}
Parameter Description:
- startup-config - Clears the startup configuration file.
Note: erase startup-config followed by reload will erase the configuration listed in the startup-config file but not the management interface configuration after the unit reload. - nvram - Clears the content from NVRAM.
- flash:filename - Clears the content from the local system flash file.
Mode:
Privileged EXEC Mode
Note: The Delete functionality is only supported for VxWorks and Linux.
Example:
erase startup-config
exit
Command Objective:
This command exits the current mode and reverts to the mode used prior to the current mode.
Syntax:
exit
Mode:
All Modes
Example:
Your Product# exit
factory reset
Command Objective
This command resets the device to factory setting.
This command followed by reload will erase the configuration listed in the startup-config and the management interface configuration.
IMPORTANT NOTE: Prior to release 22.01.4, the factory reset command does not erase the management interface configuration, hostname, or user details.
For release 22.01.3, manually reset the management interface configuration to restore the IP configuration to default.
Syntax
factory reset
Mode
Global Configuration mode
Example:
Your Product(config)# factory reset
end
reload
feature telnet
Command Objective
This command enables the Telnet service in the system.
The no form of this command disables the Telnet service. While connected via Telnet, the no form of this command is not functional.
Syntax
feature telnet
no feature telnet
Mode
Global Configuration mode
Default
Disabled
Example:
Your Product(config)# feature telnet
firmware activate
Command Objective
This command upgrades and activates the firmware
Syntax
firmware activate {[no-reload] | [init] | [rollback]}
Parameter Description:
no-reload - Upgrades/activates the firmware without Reloading the System
init - Initiates firmware activation
rollback - Performs rollback
< replacement string >/ < alias > - Specifies the string for which a replacement is needed.
< token to be replaced > - Specifies an abbreviated / short form of the replacement string
Mode
Global Configuration mode
Example:
Your Product (config)# firmware activate
help
Command Objective:
This command displays a brief description for the given command.
To display help descriptions for commands with more than one word, do not provide any space between the words.
Syntax:
help [ command ]
Mode:
All Modes
Example:
Your Product# help enable
Configure Terminal command must be executed as:
Your Product# help configureterminal
hostname
Command Objective:
This command configures the name of the switch. This is a string with a maximum size of 15.
Syntax:
hostname
Mode:
Global Configuration Mode
Example:
Your Product(config)# hostname switch1
listuser
Command Objective:
This command lists all the default and newly created users, along with their permissible mode.
Syntax:
listuser
Mode:
Privileged EXEC Mode
Example:
Your Product# listuser
USER MODE
root /
guest /
login authentication
Command Objective:
This command configures the authentication method for user logins for accessing the GUI to manage the switch. Few network routers and other network equipment allows access to a server or a managing computer to determine if the user attempting to log in has the proper rights or is in the user database.
The no form of the command resets the authentication method for user logins to its default values. Changing login authentication from default to another value may disconnect the telnet session.
Syntax:
login authentication [{radius | tacacs }] [local]
no login authentication
Parameter Description:
radius - Sets the RADIUS server to be used as an authentication server. Enables remote access servers to communicate with a central server to authenticate dial-in users and authorize their access to the requested system or service.
Note: Radius user will be given privilege based on service type attribute value received in access accept packet from radius server.tacacs - Sets the TACACS server to be used as an authentication server. Communicates with the authentication server commonly used in networks.
Note: Tacacs user will be given root privilege by default or local user privilege if the user exists in the local database.local - Sets locals authentication. The user identification, authentication, and authorization methods are chosen by the local system administration and does not necessarily comply with any other profiles.
Mode:
Global Configuration Mode
Default:
Local
Example:
Your Product(config)# login authentication radius
login authentication-default
Command Objective:
This command configures the authentication method for user logins for accessing the CLI to manage the switch. Few network routers and other network equipment allows access to a server or a managing computer to determine if the user attempting to log in has the proper rights or is in the user database.
Changing login authentication from default to another value may disconnect the telnet session.
The no form of the command resets the authentication method for user logins to its default values.
Note: This command is a standardized implementation of the existing command. It operates similarly to that of the command login authentication.
Syntax:
login authentication { default |
no login authentication { default |
Parameter Description:
- default - Sets the default authentication method for User Logins.
- < list-name > - Uses the list of user names created with the user name command, for authentication.
Note: This feature has been included to adhere to the Industry Standard CLI syntax. This feature is currently not supported.
Mode:
Global Configuration Mode
Example:
Your Product(config)# login authentication default
logout
Command Objective:
During console session, this command exits from Privileged EXEC/ User EXEC mode to Login Prompt. During Telnet session, this command terminates the session.
Syntax:
logout
Mode:
Privileged EXEC Mode
Example:
Your Product# logout
Your Product login:
no pagination
Command Objective:
This command disables pagination.
Syntax:
no pagination
Mode:
Global Configuration Mode
Example:
Your Product (config)# no pagination
reload
Command Objective:
This command restarts the switch.
Syntax:
reload
Mode:
Privileged EXEC Mode
Example:
Your Product# reload
set cli pagination
Command Objective:
This command enables or disables pagination.
Syntax:
set cli pagination {on | off}
Parameter Description:
- on - Enables pagination
- off - Disables pagination
Mode:
Global Configuration Mode
Example:
Your Product (config)# set cli pagination off
system contact
Command Objective:
This command sets the system contact information.
Syntax:
system contact
Mode:
Global Configuration Mode
Default:
Accedian, Canada
Example:
Your Product(config)# system contact support@x.com
system location
Command Objective:
This command sets the system location.
Syntax:
system location
Mode:
Global Configuration Mode
Default:
Accedian, Canada
Example:
Your Product(config)# system location Controls
tech-support
Command Objective:
The Tech Support Generator collects various system information such as kernel, network, and other OS related data. The collected data will be stored and compressed into a single file that is then exportable.
Syntax:
tech-support { list | generate | { export url } }
Parameter Description:
- list – Displays the name of the report.
Note: The report file name will have the following format:accedianIncidentReport_< timestamp >.bz2
Example: accedianIncidentReport_19700101-003549.bz2
- generate - Generates the report.
- export - Exports the reports to a specific URL. The report file can be exported via SFTP and TFTP protocols.
Mode:
Privileged EXEC Mode
Example:
Your product# tech-support list
Report Available
--------------------------------------------
accedianIncidentReport_20221103-155918.bz2
write
Command Objective:
This command writes the running-config to a flash file, startup-configuration file or to a remote site.
Syntax:
write { flash:filename | startup-config | tftp://server/filename | sftp://< user-name >:< pass-word >@server/filename}
Parameter Description:
- flash:filename - Configures the name of the file to which the configuration is to be saved. This file is present in the flash.
- startup-config - Starts the switch with the saved configuration on reboot.
- tftp - Configures the TFTP related details for writing the configuration to a file in TFTP server.
- server - The IP address or host name of the server in which configuration should be maintained.
- filename - The name of the file in which the configuration should be written.
- sftp
- Configures the SFTP related details for writing the configuration to a file in SFTP server. - user-name - The user name of remote host or server.
- pass-word - The password for the corresponding user name of remote host or server.
- server - The IP address or host name of the server in which configuration should be maintained.
- filename - The name of the file in which the configuration should be written.
Mode:
Privileged EXEC Mode
Note: Filenames and directory names are case sensitive.
Example:
Your Product(config)# write startup-config
Display Commands
This section includes unit management display commands.
show admin users
Command Objective:
This command displays the information about the NETCONF admin users.
Syntax:
show admin users
Mode:
Privileged EXEC Mode
Example:
Your Product# show admin users
User
Netconf1
show aliases
Command Objective:
This command displays all the aliases.
Syntax:
show aliases
Mode:
Privileged EXEC Mode
Example:
Your Product# show aliases
line -> li 1
products -> root
alternatename -> newname
show running-config
Command Objective:
This command displays all system running configs.
Note: This configuration is lost if the system is restarted.
Syntax:
show running-config
Note: If executed without optional parameters, this command displays the current active configurations, except for the default configurations of all the modules in all the interfaces.
For example, MEF 10_3 default envelope ranking, shown below, will not appear in the output.
configure terminal
set mef dot1p-priority 0 envelope-rank 7
set mef dot1p-priority 1 envelope-rank 6
set mef dot1p-priority 2 envelope-rank 5
set mef dot1p-priority 3 envelope-rank 4
set mef dot1p-priority 4 envelope-rank 3
set mef dot1p-priority 5 envelope-rank 2
set mef dot1p-priority 6 envelope-rank 1
set mef dot1p-priority 7 envelope-rank 0
Mode:
Privileged EXEC Mode
Example:
The output given below is only a fragment of the whole output. This output differs based on the modules that are configured.
Your Product# show running-config bgp
Building configuration...
router bgp 100
bgp router-id 100.20.6.100
redistribute static
neighbor 100.20.6.20 remote-as 200
neighbor 100.20.6.20 maximum-prefix 10
!
router bgp 100
!
End
show running-config qos
Command Objective:
This command displays the configuration done in QoS module.
Note: This option is available only when Diffserv is enabled.
Syntax:
show running-config qos
Mode:
Privileged EXEC Mode
Example:
Your Product# show running-config qos
#Building configuration...
!
!
policy-map 10
set meter 10 conform-action cos-transmit-set 7 exceed-action cos-transmit-set 6 violate-action drop
set policy class 10 default-priority-type none
!
set meter-stats enable meter-id 10
!
!
end
show running-config telemetry
Command Objective:
This command displays the telemetry configuration information currently running on the router.
Syntax:
show running-config telemetry
Mode:
Privileged EXEC Mode
Example:
Your Product# show running-config telemetry
#Building configuration...
!
set telemetry enable
telemetry
slm enable
set reporter-type openmetrics status enable ip 10.10.10.10 port 1234
!
end
show env
Command Objective:
This command displays the status of the all the resources like CPU, Flash and RAM usage, and also displays the current, power and temperature of the switch.
This command is a complete standardized implementation of the existing command.
Syntax:
show env {all | temperature | fan | RAM | CPU | flash | power}
Parameter Description:
- all - Displays threshold information of all resources such as CPU, Flash, RAM, power and temperature.
- temperature - Displays temperature threshold values of the switch in celcius.
- fan - Displays the threshold information of the fan.
- RAM - Displays the maximum RAM usage of the switch in percentage.
- CPU - Displays the maximum CPU usage of the switch in percentage.
- flash - Displays the maximum flash usage of the switch in percentage.
- power - Displays the threshold power suply for the switch
Mode:
Privileged Exec Mode
Example:
Your product# show env fan
show env all
Command Objective:
This command displays threshold information of all resources such as CPU, Flash, RAM, power and temperature.
Syntax:
show env all
Parameter Description:
- RAM Threshold - User can configure Maximum RAM threshold values for unit to trigger the alarms if RAM usage crosses the configured threshold values.
- Current RAM Usage - Displays unit's current RAM usage.
- CPU Threshold - User can configure Maximum CPU threshold values for unit to trigger the alarms if CPU utilization crosses the configured threshold values.
- Current CPU Usage - Displays unit's current CPU usage.
- Fan Status 1 - Displays unit's Fan 1 operational status.
- Fan Status 2 - Displays unit's Fan 2 operational status.
- Fan Status 3 - Displays unit's Fan 3 operational status.
- Fan Status 4 - Displays unit's Fan 4 operational status.
- Min power supply - User can configure Minimum power supply threshold value for unit to trigger the alarms if power level of the unit crosses the Minimum configured values.
- Max power supply - User can configure Maximum power supply threshold value for unit to trigger the alarms if power level of the unit crosses the Maximum configured values.
- Current power supply - Displays current value of active power supply .
- Max Temperature - User configurable Maximum threshold temperature value in Celsius.
When ASIC switch temperature value crosses this Maximum temperature value, alarm will be raised.
- Min Temperature - User configurable Minimum threshold temperature value in Celsius.
When ASIC switch temperature value crosses this Minimum temperature value, alarm will be raised.
- Current Temperature - Displays the ASIC switch temperature values in Celsius.
- Flash Threshold - User configurable threshold in percentage of flash usage in the unit, beyond which alarm will be generated.
- Current Flash Usage - Displays the utilization of flash memory in the unit platform.
Note: Flash memory is part of /etc/accedian and /etc/accedian/history.
- Mgmt. Port Routing - Displays the status for management routing whether enables or disabled.
Mode:
Privileged Exec Mode
Example:
Your product# show env all
RAM Threshold : 98%
Current RAM Usage : 81%
CPU Threshold : 100%
Current CPU Usage : 2%
Fan Status 1 : Operational
Fan Status 2 : Operational
Fan Status 3 : Operational
Fan Status 4 : Operational
Fan Status 5 : Operational
Min power supply : 110v
Max power supply : 220v
Current power supply : 230v
Max Temperature : 37C
Min Temperature : -10C
Current Temperature : 40C
Flash Threshold : 100%
Current Flash Usage : 66%
Mgmt Port Routing : Disabled
show nvram
Command Objective:
This command displays the current information stored in the NVRAM.
Syntax:
show nvram
Mode:
Privileged EXEC Mode
Example:
Your product# show nvram
Default IP Address : 20.0.0.1
Default Subnet Mask : 255.0.0.0
Default IP Address Config Mode : Dynamic
Default IP Address Allocation Protocol : BOOTP
Switch Base MAC Address : 00:89:fe:34:55:33
Default Interface Name : Gi0/1
Default RM Interface Name : int1
Config Restore Option : No restore
Config Save Option : No save
Auto Save : Enable
Incremental Save : Enable
Roll Back : Enable
Config Save IP Address : 0.0.0.0
Config Save Filename : iss.conf
Config Restore Filename : /home/automation/code/future/LR/switch1/restore.conf
PIM Mode : Sparse Mode
IGS Forwarding Mode : MAC based
Cli Serial Console : Yes
SNMP EngineID : 80.00.08.1c.04.46.53
SNMP Engine Boots : 42
Default VLAN Identifier : 1
Stack PortCount : 0
ColdStandby : Disable
Hitless Restart Flag : Disable
Hardware Version : 5.9.1
Firmware Version : 6.7.2
Hardware Part Number : 1-0-0
Software Serial Number : 1-0-0
Software Version : 7.2.0
Switch Name : default
RM Heart Beat Mode : Internal
RM Redundancy Type : Cold
RM Data Plane Type : Shared
RM Type : OOB
NPAPI mode : Synchronous
TimeStamp Method : Software
Restore Flag : Enabled
Dynamic Port Count : 24
FIPS operation mode : Disabled
Restore Option : Disabled
Bridge Mode : Customer Bridge
Debugging Log File Location : /home/twg
Management Port : Disabled
Automatic Port Create Flag : Disabled
Restore Type : CSR
IMG_DUMP_PATH : /home/twg/
show oss
Command Objective:
This command displays the name, version, copyright notice and license terms of each open source software (OSS) component that is used.
Syntax:
show oss
Mode:
Privileged EXEC Mode
Example:
Your product# show oss
Copyright notices and licenses for Open Source Software used in the product are listed below:
Component Name Version Copyright License
--------------- --------------- -------------------------------------------------- ------------------------------
bash 5 Copyright © 1995-2014 Brian fox, Chet Ramey, https://www.gnu.org/licenses/gpl-3.0.en.html
Roland McGrath
bridge-utils 1.6 Copyright © 2004-2011, Stephen Hemminger https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html
and Lennert Buytenhek
busybox 1.31.1 Copyright © 1999-2004 by Erik Andersen. https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html
Copyright © 2005-2006 Rob Landley.
All rights reserved.
bzip2 1.0.8 Copyright © 1996-2019 Julian Seward https://spdx.org/licenses/BSD-4-Clause.html
cJSON 1.5.6 Copyright (c) 2009 Dave Gamble https://opensource.org/licenses/MIT
show privilege
Command Objective:
This command shows the current user privilege level.
Syntax:
show privilege
Mode:
Privileged EXEC Mode
Example:
Your Product# show privilege
Current privilege level is 15
show system information
Command Objective:
This command displays system information.
Syntax:
show system information
Mode:
Privileged EXEC Mode
Example:
Your Product# show system information
Hardware Version : 500-173-01
Software Version : 10.04.006.00.02
Firmware Version : AMO-100G-NG_22.01.2_1332
Hardware Serial Number : C414-0305
Software Serial Number : 1-0-0
Switch Name : C414-0305
System Contact : Accedian, Canada
System Name : C414-0305
Switch Description : AMO-100G-NG
System Location : Accedian, Canada
Logging Option : Console Logging
Device Uptime : 0 Days, 0 Hrs, 0 Mins, 54 Secs
Login Authentication Mode : Local
Config Save Status : Not Initiated
Remote Save Status : Not Initiated
Config Restore Status : Not Initiated
Traffic Separation Control : none
show telnet server
Command Objective
This command displays the Telnet server status.
Syntax
show telnet server
Mode
Privileged EXEC Mode
Example:
Your Product# show telnet server
telnet service enabled
Clear Commands
This section includes the unit management clear commands.
clear screen
Command Objective:
This command clears all the contents from the screen.
Syntax:
clear screen
Mode:
All Modes
Example:
Your Product# clear screen
clear iss counters
Command Objective:
This command clears the unit counters for all protocols or for the specified protocols like OSPFv2, RIP, RIPv6, OSPFv3, NETIP(v4/v6).
Note: If the command is executed without optional parameters all unit counters are cleared.
Syntax:
clear iss counters [bgp] [ospf] [rip] [rip6] [ospf3] [ipv4] [ipv6]
Parameter Description:
- ospf - Clears the counters for OSPF
- rip - Clears the counters for RIP
- rip6 - Clears the counters for RIPv6
- ospf3 - Clears the counters for OSPFV3
- ipv4 - Clears the counters for IPv4
- ipv6 - Clears the counters for IPv6
Mode :
Privileged EXEC Mode
Example:
Your product# clear iss counters
© 2024 Cisco and/or its affiliates. All rights reserved.
For more information about trademarks, please visit: Cisco trademarks
For more information about legal terms, please visit: Cisco legal terms
For legal information about Accedian Skylight products, please visit: Accedian legal terms and tradmarks