display virtual-system

Function

The display virtual-system command displays basic information about a virtual system (VS), including the VS name and slot resources assigned to the VS.

Format

display virtual-system [ name vs-name ] [ verbose ]

Parameters

Parameter	Description	Value
name vs-name	Specifies the name of a VS.	The value is a string of 1 to 31 case-insensitive characters. The string can contain letters, digits, underscores (_), and hyphens (-). The VS name must begin with letters except "all," "brief," or "verbose."
verbose	Displays detailed information about VSs.	-

Parameter

Description

Value

name vs-name

Specifies the name of a VS.

The value is a string of 1 to 31 case-insensitive characters. The string can contain letters, digits, underscores (_), and hyphens (-). The VS name must begin with letters except "all," "brief," or "verbose."

verbose

Displays detailed information about VSs.

Views

Resource template view of admin, Management view, VS view

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
lsvs	read

Usage Guidelines

Usage Scenario

If a PS administrator or a VS administrator needs to view information, such as the slot resources, and VS type, run the display virtual-system command. The command output helps analyze faults.

Prerequisites

A VS has been configured.

If the specified VS does not exist, run the virtual-system command in the admin view to create a VS.

Precautions

The physical system (PS) administrator can view information about all VSs only in the admin view. In other views of Admin-VS views, the administrator can view information only about Admin-VS. In VSn views, the administrator can view information only about VSn.

Example

The actual command output varies according to the device. The command output here is only an example.

# A PS administrator views information about all VSs.

<HUAWEI> system-view
[~HUAWEI] admin
[~HUAWEI-admin] display virtual-system
- --------------------------------------------------------------
Name                             Status         Description
- --------------------------------------------------------------
Admin-VS                         running         admin-vs
vs1                              running         vs1
vs2                              running         vs2
vs3                              running         vs3
- --------------------------------------------------------------

# A PS administrator views information about a VS named vs1.

<HUAWEI> system-view
[~HUAWEI] admin
[~HUAWEI-admin] display virtual-system name vs1 verbose
Name         : vs1
Status       : running
Description  :
Create time  : 2017-03-13 21:24:27+09:30 DST
Port mode    : port
System MAC   : 00-e0-fc-12-34-56
Assigned slot(s)
pvmb         : 1
pvmb         : 2
CPU(s)
slot 1      : 4%
cfcard:/VS_huawei: 0%, 16/41943040 (Used Kbytes/Max Kbytes)
Assigned interface(s)
  GE0/1/0, slot 1
Assigned resource(s)
u4route      : 10000(Max)
m4route      : 1000(Max)
u6route      : 1000(Max)
m6route      : 1000(Max)
vpn-instance : 256(Max)
cpu          : 5(weight)

**Table 1** Description of the **display virtual-system** command output
Item	Description
Name	Name of a VS: If no VS is created on a PS, Admin-VS is displayed. If a VS is created on a PS, the created VS is displayed.
Status	VS status: 0: indicates the initial status of a VS that is created. running: indicates that the VS is running. stop: indicates that the VS has been stopped. restoring: indicates that VS configurations are being restored. shutdowning: indicates that the VS is being stopped. 0xffffffff: indicates an invalid status.
Description	Description of the VS. If no description is configured, no information is displayed.
Create time	Date and time when the VS was created.
Port mode	Port mode for the VS. PORT: When you run the assign interface (VS view) command to assign interface resources, a specified interface is allocated to the VS.
System MAC	MAC address of the VS.
Assigned resource(s)	Logical resources assigned to the VS. Logical resources include u4route, m4route, u6route, m6route, vpn-instance.
Assigned slot(s)	Slot resources assigned to the VS: pvmb: primary main board of virtual system (PVMB). mb: main board (MB).