H3C S9500 Command Manual-Release2132[V2.03]-08 System Volume

HomeSupportSwitchesH3C S9500 Series SwitchesReference GuidesCommand ReferencesH3C S9500 Command Manual-Release2132[V2.03]-08 System Volume
04-Device Management Commands
Title Size Download
04-Device Management Commands 99.99 KB

Chapter 1  Device Management Commands

 

&  Note:

File names in this document comply with the following rules:

l      Path + file name (namely, a full file name): File on a specified path. A full file name consists of 1 to 135 characters.

l      “File name” (namely, only a file name without a path): File on the current working path. The file name without a path consists of 1 to 91 characters.

 

1.1  Device Management Commands

1.1.1  boot-loader

Syntax

boot-loader file file-url slot slot-number { main | backup }

View

User view

Default Level

2: System level

Parameters

file-url: Specifies a file name.

slot-number: Slot number of a card.

main: Specifies a file as a primary boot file.

backup: Specifies a file as a secondary boot file.

Description

Use the boot-loader command to specify a boot file on a card.

By default, the boot file is specified as a primary boot file.

A primary boot file is used to boot a device and a secondary boot file is used to boot a device only when a primary boot file is unavailable.

Related commands: display boot-loader.

Examples

# Specify the primary boot file of the card in slot 1 on a device as S9500.app.

<Sysname> boot-loader file cf0:/S9500.app slot 1 main

  This command will set boot file of the specified board, Continue? [Y/N]:y

  The specified file will be used as a main boot file at the next time!

1.1.2  bootrom update

Syntax

bootrom update file file-url slot slot-number-list

View

User view

Default Level

2: System level

Parameters

file-url: Boot ROM name and path.

slot-number-list: List of slot numbers of cards, in the format of slot-number-list = { slot-number [ to slot-number ] }&<1-7>. The slot-number argument represents the slot number of a card. &<1-7> indicates that you can specify up to seven slot numbers or slot number lists.

Description

Use the bootrom update command to upgrade the Boot ROM program on a card(s).

Examples

# Use the LSB1203.app file to upgrade the Boot ROM file on slot 1 and slot 4 of the device.

<Sysname> bootrom update file cf0:/LSB1203.app slot 1 4

1.1.3  debugging device

Syntax

debugging device

undo debugging device

View

User view

Default Level

1: Monitor level

Parameters

None

Description

Use the debugging device command to enable device debugging.

Use the undo debugging device command to disable device debugging.

By default, device debugging is disabled.

Examples

# Enable device debugging.

<Sysname> debugging device

1.1.4  display boot-loader

Syntax

display boot-loader [ slot slot-number ]

View

User view

Default Level

2: System level

Parameters

slot-number: Slot number of a card.

Description

Use the display boot-loader command to display information of the boot file.

Related commands: boot-loader.

Examples

# Display the information of the boot file.

<Sysname> display boot-loader

The primary app to boot of board 1 at the next time is: cf0:/S9500.APP

The backup  app to boot of board 1 at the next time is: cf0:/S9500.APP

The app to boot of board 1 at this time is: cf0:/S9500.APP

1.1.5  display cpu-usage

Syntax

display cpu-usage [ number [ offset ] [ verbose ] [ slave | slot slot-number ] [ from-device ] ] | slave | slot slot-number ]

View

Any view

Default Level

1: Monitor level

Parameters

number: Number of CPU usage statistics records to be displayed.

offset: Offset between the serial number of the first CPU usage statistics record to be displayed and that of the last CPU usage record to be displayed.

verbose: Specifies to display detailed information of CPU usage statistics.

slave: Specifies to display the statistics of the CPU usage of a standby card.

slot slot-number: Specifies to display the statistics of the CPU usage of a card. from-device: Displays external storage devices such as Flash and hard disk. The S9500 series switches currently do not support the from-device keyword.

Description

Use the display cpu-usage command to display the CPU usage statistics.

The system takes statistics of CPU usage at intervals (usually every 60 seconds) and saves the statistical results in the history record area. display cpu-usage number indicates the system displays number records from the newest (last) record. display cpu-usage number offset indicates the system displays number records from the last but offset+1 record.

Equivalent to the display cpu-usage 1 0 verbose command, the display cpu-usage command displays detailed information of the last CPU usage statistics record.

Examples

# Display detailed information of the CPU usage statistics record of a card on a device.

<Sysname> display cpu-usage slot 3

===== Current CPU usage info =====

CPU Usage Stat. Cycle: 15 (Second)

CPU Usage            : 11%

CPU Usage Stat. Time : 2006-12-29  16:46:31

CPU Usage Stat. Tick : 0x1b(CPU Tick High) 0x6870ce22(CPU Tick Low)

Actual Stat. Cycle   : 0x0(CPU Tick High) 0x17a7bf75(CPU Tick Low)

TaskName        CPU        Runtime(CPU Tick High/CPU Tick Low)

VIDL            89%               0/15330d96

TICK             1%               0/  43b345

STMR             0%               0/   9a7a2

RXTX             0%               0/   28145

IPCQ             0%               0/   c5c6e

RPCQ             0%               0/  3002e0

DEVD             0%               0/   1a9e7

DIAG             0%               0/   12e77

ADJ6             0%               0/   47c53

INFA             0%               0/    1513

BOTT             0%               0/    357e

PPSP             0%               0/   12623

L2ST             0%               0/  2889f6

L2Ma             0%               0/   2a285

L2Ch             0%               0/     77a

L2PS             0%               0/  27161f

DMPL             0%               0/  2924c8

RtCh             0%               0/  278923

L3MC             0%               0/  289a45

 DEV             0%               0/   5bde5

ADJ4             0%               0/   43a96

 mac             0%               0/   347b5

LAGG             0%               0/   25de6

MSTP             0%               0/    999b

GARP             0%               0/   67335

 ARP             0%               0/   6474f

  IP             0%               0/  365f37

FIB6             0%               0/    86a8

  ND             0%               0/   f236a

DT1X             0%               0/  2ab26c

 ACM             0%               0/  2c4795

RDSO             0%               0/   10019

 RDS             0%               0/  28d644

  SC             0%               0/  2770f6

 TAC             0%               0/   4f754

MFIB             0%               0/   358a1

IFNT             0%               0/    91f5

Table 1-1 display cpu-usage command output description

Field

Description

CPU usage info

Information of CPU usage records

CPU Usage Stat. Cycle

CPU usage measurement period in seconds

CPU Usage

CPU usage in percentage

CPU Usage Stat. Time

CPU usage statistics time in seconds

CPU Usage Stat. Tick

System runtime in ticks, represented by a 64-bit hexadecimal. CPU Tick High represents the most significant 32 bits and the CPU Tick Low the least significant 32 bits.

Actual Stat. Cycle

Actual CPU usage measurement period in ticks, represented by a 64-bit hexadecimal. CPU Tick High represents the most significant 32 bits and the CPU Tick Low the least significant 32 bits. Owing to the precision of less than one second, the actual measurement periods of different CPU usage records may differ slightly.

TaskName

Task name

CPU

CPU usage of the current task

Runtime(CPU Tick High/CPU Tick Low)

Running time of the current task

 

1.1.6  display device

Syntax

display device [ cf-card ] [ [ shelf shelf-number ] [ frame frame-number ] [ slot slot-number [ subslot subslot-number ] ] | verbose ]

View

Any view

Default Level

2: System level

Parameters

cf-card: Displays information of a compact Flash (CF).

shelf shelf-number: Displays detailed information of the specified shelf or unit. The shelf-number argument represents a shelf number or unit number.

frame frame-number: Displays detailed information of the specified frame. The frame-number argument represents a frame number.

slot slot-number: Displays detailed information of the specified card. The slot-number argument represents the slot number of a card.

subslot subslot-number: Displays detailed information of the specified subcard. The subslot-number represents the subslot of a subcard.

verbose: Displays detailed information.

Description

Use the display device command to display information about specified devices on a switch.

 

  Caution:

The S9500 series switches do not support the cf-card, shelf, frame and subslot keyword.

 

Examples

# Display brief information of cards on a device.

<Sysname> display device

Slot No.   Brd Type        Brd Status   Subslot Num    Sft Ver

 0         NONE            Absent       0              None

 1         LSB1SRP1N6      Master       0              S9500-CMW520-B2123

 2         NONE            Absent       0              None

 3         NONE            Absent       0              None

 4         LSB1GP12C       Normal       3              S9500-CMW520-B2123

 5         NONE            Absent       0              None

 6         NONE            Absent       0              None

Table 1-2 display device command output description

Field

Description

Slot No.

Slot number of a card

Brd Type

Hardware type of a card

Brd Status

Card status

Subslot Num

Number of subslots

Sft Ver

Software version

 

1.1.7  display device manuinfo

Syntax

display device manuinfo [ slot slot-number ]

View

Any view

Default Level

3: Manage level

Parameters

slot-number: Slot number of a card. The manufacturing information of the card specified by its slot number will be displayed.

Description

Use the display device manuinfo command to display manufacturing information about the device.

Examples

# Display manufacturing information of the SRPU on slot 0 of the device.

<Sysname> display device manuinfo slot 0

BOARD_SERIAL_NUMBER  : 03A058A054000014

MAC_ADDRESS          : 00E0-FC5A-6C37

Table 1-3 display device manuinfo command output description

Field

Description

DEVICE_SERIAL_NUMBER

Device serial number

MAC_ADDRESS

MAC address of the device

 

1.1.8  display environment

Syntax

display environment

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display environment command to display the temperature information, including the current temperature and temperature thresholds of cards.

Examples

# Display the temperature information of cards.

<Sysname> display environment

System Temperature information (degree centigrade):

----------------------------------------------------

SlotNo    Temperature       Lower limit       Upper limit

 0          53                10               70

 1          42                10               70

 2          38                10               70

 3          40                10               70

Table 1-4 display environment command output description

Field

Description

System Temperature information (degree centigrade)

Temperature information of system cards (degree centigrade)

SlotNo

Slot number of the board

Temperature

Current temperature

Lower limit

Lower limit of temperature

Upper limit

Upper limit of temperature

 

1.1.9  display fan

Syntax

display fan [ fan-id ]

View

Any view

Default Level

1: Monitor level

Parameters

fan-id: Built-in fan number.

Description

Use the display fan command to display the operating state of built-in fans.

Examples

# Display the operating state of all fans in a device.

<Sysname> display fan

 Fan  1 State: Normal

 Fan  2 State: Normal

The above information displays that fan 1 and fan 2 work normally.

1.1.10  display memory

Syntax

display memory [ slave | slot slot-number ]

View

Any view

Default Level

1: Monitor level

Parameters

slave: Displays the memory usage of the standby card.

slot-number: Slot number of a card.

Description

Use the display memory command to display the usage of the memory of all or specified cards of a device.

Examples

# Display the usage of the memory of a device.

<Sysname> display memory

System Total Memory(bytes): 431869088

Total Used Memory(bytes): 71963156

Used Rate: 16%

Table 1-5 display memory command output description

Field

Description

System Total Memory(bytes)

Total size of the system memory (in bytes)

Total Used Memory(bytes)

Size of the memory used (in bytes)

Used Rate

Percentage of the memory used to the total memory

 

1.1.11  display power

Syntax

display power [ power-id ]

View

Any view

Default Level

1: Monitor level

Parameters

power-id: Power supply number.

Description

Use the display power to display the status of the power supply of a device.

Examples

# Display the status of the power supply of a device.

<Sysname> display power

 Power   1 State: Absent

 Power   2 State: Normal

The above information indicates that power supply 2 works normally, and power supply 1 is absent.

1.1.12  display schedule reboot

Syntax

display schedule reboot

View

Any view

Default Level

3: Manage level

Parameters

None

Description

Use the display schedule reboot command to display the device reboot time set by the user.

Related commands: schedule reboot at, schedule reboot delay.

Examples

# Display the reboot time of a device.

<Sysname> display schedule reboot

System will reboot at 16:00:00 2006/03/10 (in 2 hours and 5 minutes).

The above information indicates the system will reboot at 16:00:00 on March 10, 2006 (in two hours and five minutes).

1.1.13  display xbar

Syntax

display xbar

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display xbar command to display the load mode of the active main board (AMB) and standby main board (SMB) of the system, including configured load mode and currently running load mode.

Related commands: xbar.

 

&  Note:

The configured load mode may be different from the currently running load mode. Only when both the AMB and SMB are in the slot can the load sharing mode become valid; otherwise, even if the load sharing mode is configured the AMB will automatically switch to the active-standby mode.

 

Examples

# Display the load mode of the AMB and SMB of a device.

<Sysname> display xbar

The configured system HA xbar load mode is BALANCE

The activated system HA xbar load mode is SINGLE

The above information indicates that the configured mode is load mode and the currently running load mode is standby.

1.1.14  reboot

Syntax

reboot [ slot slot-number ]

View

User view

Default Level

2: System level

Parameters

slot slot-number: Specifies the slot number of a card. If you do not specify the slot keyword, or reboot the active main board, the execution of this command results in the reboot of the whole device.

Description

Use the reboot command to reboot a card, a subcard, or the whole system.

 

  Caution:

l      Device reboot may result in the interruption of the ongoing services. Be careful to use the command.

l      If a primary boot file fails or does not exist, the device cannot be rebooted with this command. In this case, you can re-specify a primary boot file to reboot the device, or you can power off the device then power it on and the system automatically uses the secondary boot file to restart the device.

l      If you are performing file operations when the device is to be rebooted, the system removes the reboot operation for the sake of security.

 

Examples

# Reboot the device.

<Sysname> reboot

1.1.15  reset unused porttag

Syntax

reset unused porttag

View

User view

Default Level

1: Monitor level

Parameters

None

Description

Use the reset unused porttag command to clear the 16-bit index saved but not used in the current system.

A confirmation is required when you carry out this command. If you fail to make a confirmation within 30 seconds or enter “N” to cancel the operation, the command will not be carried out.

Examples

# Clear the 16-bit index saved but not used in the current system.

<Sysname> reset unused porttag

1.1.16  schedule reboot at

Syntax

schedule reboot at hh:mm [ date ]

undo schedule reboot

View

User view

Default Level

3: Manage level

Parameters

hh:mm: Reboot time of a device, in the format of hh:mm (hours:minutes). The value of the hh argument ranges of is 0 to 23, and the value of the mm argument ranges from 0 to 59.

date: Reboot date of a device, in the format mm/dd/yyyy (Month/day/year) or in the format yyyy/mm/dd (year/month/day) The yyyy value ranges from 2000 to 2035, the mm value ranges from 1 to 12, and the dd value depends on a specific month.

Description

Use the schedule reboot at command to enable the scheduled reboot function and specify a specific reboot time and date.

Use the undo schedule reboot command to disable the scheduled reboot function.

By default, the scheduled reboot function is disabled.

There are two cases if no specific reboot date is specified:

l           When the specified reboot time is later than the current time, the device will be rebooted at the reboot time of the current day.

l           When the specified reboot time is earlier than the current time, the device will be rebooted at the reboot time the next day.

l           If you are performing file operations when the device is to be rebooted, the system does not execute the command for the sake of security.

Note that:

l           The precision of the device timer is 1 minute. One minute before the reboot time, the device will prompt “REBOOT IN ONE MINUTE” and will be rebooted in one minute.

l           The difference between the reboot date and the current date cannot exceed 30 x 24 hours (namely, 30 days).

l           After you execute the above command, the device will prompt you to confirm the configuration. You must enter <Y> or <y> to make the configuration take effect. The original configuration will be overwritten at the same time.

l           If a date (month/day/year or year/month/day) later than the current date is specified for the schedule reboot at command, the device will be rebooted at the reboot time.

l           If you use the clock command after the schedule reboot at command to adjust the system time, the reboot time set by the schedule reboot at command will become invalid.

 

  Caution:

l      This command reboots the device in a future time, thus resulting in service interruption. Please use it with caution.

l      If you are performing file operations when the device is to be rebooted, the system removes the reboot operation for the sake of security.

 

Examples

# Configure the device to reboot at 22:00 PM (supposing that the current time is 16:36).

<Sysname> schedule reboot at 22:00

Reboot system at 22:00 2006/03/21(in 5 hour(s) and 23 minute(s))

confirm?[Y/N]:

# If you have used the terminal logging command to enable the log display function on the terminal before setting a reboot time, the system will automatically display related log information after you enter <y>. By default, the log display function is enabled.

<Sysname>

%Mar 21 16:36:51:601 2006 Sysname CMD/5/REBOOT:

con0: Set schedule reboot parameters at 16:36:51 2006/03/21, and system will reboot at 22:00 2006/03/21.

1.1.17  schedule reboot delay

Syntax

schedule reboot delay { hh:mm | mm }

undo schedule reboot

View

User view

Default Level

3: Manage level

Parameters

hh:mm: Device reboot wait time, in the format of hh:mm (hours:minutes). The value of the hh argument ranges from 0 to 720, and the value of the mm argument ranges from 0 to 59. The maximum reboot wait time of the device is 720 hours.

mm: Device reboot wait time in minutes, in the range of 0 to 43200. The maximum reboot wait time of the device is 43200 minutes, that is, 720 hours.

Description

Use the schedule reboot delay command to enable the scheduled reboot function and set a reboot wait time.

Use the undo schedule reboot command to disable the scheduled reboot function.

By default, the scheduled reboot function is disabled.

Note that:

l           The reboot wait time can be in the format of hh:mm (hours:minutes) or mm (absolute minutes). The maximum reboot wait time of the device is 720 hours, that is 43200 minutes.

l           The precision of the device timer is 1 minute. One minute before the reboot time, the device will prompt “REBOOT IN ONE MINUTE” and will be rebooted in one minute.

l           After you execute the above command, the device will prompt you to confirm the configuration. You must enter <Y> or <y> to make the configuration take effect. The original configuration will be overwritten at the same time.

l           If you use the clock command after the schedule reboot delay command to adjust the system time, the reboot wait time set by the schedule reboot delay command will become invalid.

l           If you are performing file operations when the device is to be rebooted, the system does not execute the command for the sake of security.

 

  Caution:

l      This command reboots the device after the specified delay time, thus resulting in service interruption. Please use it with caution.

l      If you are performing file operations when the device is to be rebooted, the system removes the reboot operation for the sake of security.

 

Examples

# Configure the device to reboot in 88 minutes (supposing the current time is 16:50).

<Sysname> schedule reboot delay 88

Reboot system at 18:18 2006/03/21(in 1 hour(s) and 28 minute(s)).

confirm?[Y/N]:

# If you have used the terminal logging command to enable the log display function on the terminal before setting a reboot time, the system will automatically display related log information after you enter <y>. By default, the log display function is enabled on the terminal.

<Sysname>

%Mar 21 16:50:13:369 2006 Sysname CMD/5/REBOOT:

con0: Set schedule reboot parameters at 16:50:13 2006/03/21, and system will reboot at 18:18 2006/03/21.

1.1.18  shutdown-interval

Syntax

shutdown-interval time

undo shutdown-interval

View

System view

Default Level

2: System level

Parameters

time: Detection interval in seconds.

Description

Use the shutdown-interval command to set a detection interval.

Use the undo shutdown-interval command to restore the default.

By default, the detection interval is 30 seconds.

Note that:

If the operation, administration and maintenance (OAM) module detects an exception on a port (for example, abrupt traffic increase resulting from an attack), the port will be closed automatically, without execution of the shutdown command. You can set the recovery time of the port by using the shutdown-interval command.

Examples

# Set the detection interval to 100 seconds.

<Sysname> system-view

[Sysname] shutdown-interval 100

1.1.19  temperature-limit

Syntax

temperature-limit slot-number lower-value upper-value

undo temperature-limit slot-number

View

System view

Default Level

2: System level

Parameters

slot-number: Slot number.

lower-value: Lower temperature limit in degrees centigrade.

upper-value: Upper temperature limit in degrees centigrade.

Description

Use the temperature-limit command to set the temperature alarm threshold on a card.

Use the undo temperature-limit command to restore the default.

By default, the lower value of the temperature alarm threshold is 10 and the upper value is 70.

 

&  Note:

The upper-value argument must be bigger than the lower-level argument; otherwise, the system prompts “Error! The temperature up limit must be greater than down limit.”, which indicates that the configuration of the command fails.

 

Examples

# Set the lower temperature limit on card 0 to 10 degrees centigrade and the upper temperature limit to 75 degrees centigrade.

<Sysname> system-view

[Sysname] temperature-limit 0 10 75

Setting temperature limit succeeded.

1.1.20  xbar

Syntax

xbar { load-balance | load-single }

View

System view

Default Level

2: System level

Parameters

load-balance: Specifies the AMB and SMB to work in the load sharing mode.

load-single: Specifies the AMB and SMB to work in the active-standby mode.

Description

Use the xbar command to set the load mode for the AMB and SMB of the device.

By default, the AMB and SMB work in the active-standby mode.

Related commands: display xbar.

 

&  Note:

Only when both the AMB and SMB are in the slot can the load sharing mode be valid; otherwise, even if the load sharing mode is configured the AMB will automatically switch to the active-standby mode.

 

Examples

# Configure a device to work in the load sharing mode.

<Sysname> system-view

[Sysname] xbar load-balance

 

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become A Partner
  • Partner Policy & Program
  • Global Learning
  • Partner Sales Resources
  • Partner Business Management
  • Service Business
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网