You are on page 1of 49

HUAWEI TECHNOLOGIES CO., LTD.

All rights reserved


INTERNAL
www.huawei.com
Huawei OptiX OSN Equipment
Command Line Introduction
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 1
This course assumes that you know the
following:
Fundamentals of communication networks
SDH principle and networking
Hardware of Huawei OptiX OSN
equipment
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 2
Tips
This course explains Chapter 1 and Chapter 2 in
the OptiX OSN 1500/2500/3500/7500/9500
Command Line Introduction.
This course focuses on Chapter 2 Command
Line Configuration File in the OptiX OSN
1500/2500/3500/7500/9500 Command Line
Introduction.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 3
References
OptiX OSN 1500/2500/3500 Intelligent Optical
Transmission System Hardware Description
OptiX OSN 7500 Intelligent Optical Switching
System Hardware Description
OptiX OSN 9500 Intelligent Optical Switching
System Hardware Description
OptiX NG-SDH Command Line Introduction
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 4
After completing this presentation, you should be able
to:
> Maintain and commission the equipment by using
command lines.
> Develop and issue a command line batch file for
NE configuration.
> Run common commands.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 5
Chapter 1 Overview of Command Lines Chapter 1 Overview of Command Lines
Chapter 2 Developing a Batch File
Chapter 3 Common Commands
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 6
Overview of Command Lines
Here, a command line is a man-machine command issued to Huawei OptiX equipment.
Like the T2000, a command line helps greatly to deploy and maintain Huawei OptiX equipment.
Features:
- Easy
- Powerful
What is a command line? What is a command line?
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 7
Overview of Command Lines
Application of command line versions Application of command line versions
Version Application
V3.0 Equipment of earlier versions
V4.0
OptiX 155/622, OptiX OSN 2500
OptiX 155H, OptiX 155/622H (V200)
OptiX Metro 3000
V5.0
OptiX Metro 100/200/500/1050, OptiX 155/622H (V300), OptiX 10GV2, OptiX NG-
SDH, OptiX OSN 9500
Navigator
Cmdterm
Cmdclient
Types of command line software Types of command line software
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 8
Overview of Command Lines
Runs on Windows 98/2000/XP OS.
Inputs and outputs command lines and issues a batch file.
Loads NE software and board software.
Records inputs and outputs automatically.
Download the Navigator at http://support.huawei.com.
Location: Software > Version Software > Optical Network Product Line > Optical
Network Tools > Navigator
The Navigator of any version between V5.6 and V6.2 is recommended.
Navigator Navigator
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 9
Overview of Command Lines
Navigator functions Navigator functions
Inputs and outputs command
lines.
Issues a batch file.
Upgrades software of the SCC
and other boards.
Saves results automatically.
Navigator window
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 10
Overview of Command Lines
Runs on the UNIX OS.
Inputs and outputs command lines and issues a batch file.
Does not load NE software or board software.
The cmdterm is self-contained in the T2000. By default, the cmdterm is in
the path \T2000\server\Tool\.
Cmdterm Cmdterm
%cmdterm
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 11
Overview of Command Lines
Self-contained software of the T2000
Based on the T2000 server
Placed in the path \T2000\cmdclient\ by default
Applicable to remote maintenance
Cmdclient Cmdclient
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 12
Overview of Command Lines
Cmdclient window Cmdclient window
Input a command here.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 13
Overview of Command Lines
> Start the T2000.
> Choose System > Security Management.
The Remote Maintenance User Management window is displayed.
> Set the remote maintenance access license.
Enable the remote maintenance user, remote.
Set the password, operation rights, and validity period.
> Run the cmdclient.exe in the \T2000\cmdclient\ path and log in to the cmdclient.
> Compared with the Navigator and cmdterm, the cmdclient has the following features:
Is under the control of the T2000 server.
Can create and edit a remote maintenance report.
Cannot download software of the SCC and other boards.
Running the c Running the cmdclient mdclient
LU4
LU5
LU6
LU7
Slide 14
LU4
Lenovo User, 6/23/2008
LU5
Lenovo User, 6/23/2008
LU6
Lenovo User, 6/23/2008
LU7
Lenovo User, 6/23/2008
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 14
Overview of Command Lines
Format of a command line of version V Format of a command line of version V5.0 5.0
[#neid]:command[:[para_block:] ... [:para_block]]
neid: ID of the NE to run the command
command: command words
para_block: parameter block. Each parameter block has one or more assignments.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 15
Overview of Command Lines
Syntax rules of a command line Syntax rules of a command line
Start of command: ":" (colon)
End of command: ";" (semicolon)
Parameter block separator: ":" (colon)
Parameter separator: "," (comma)
AND: "&"
To: "&&"
Shielding: "//"
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 16
Overview of Command Lines
:module-operation-operation object:parameter block,;
Module
cfg: a configuration command
alm: an alarm command
per: a performance monitoring
command
sm: a security management
command
cm: a communication
management command
dbms: a database
management system
command
sys: a system command
Operation
get: to query an object
add: to add an object
set: to set an object
del: to delete an object
reset: to reset an object
Example: alm-get-curdata:0,0;
Command format Command format
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 17
Command Line Know-How
To query the format of a command, add /? next to the command words.
>For example, :alm-get-curdata/?
To query all command words available for the current NE, run the following
command:
>:help
To retrieve data by keywords, run a command in the following format:
>For example, :cfg or :cfg-get
Useful operations Useful operations
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 18
Chapter 1 Overview of Command Lines
Chapter 2 Developing a Batch File Chapter 2 Developing a Batch File
Chapter 3 Common Commands
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 19
Batch File Format
1. #1:login:"szhw","nesoft"; //The user name must be szhw.
2. :per-set-endtime:15m,1990@0@0@0@0@0;
:per-set-endtime:24h,1990@0@0@0@0@0;
3. :cfg-init-all;
4. :cfg-set-devicetype:OptiXOsn3500,standard; //case-sensitive
:cfg-set-nename:64,"OSN 3500 example";
5. :cfg-add-board:9&10,ssn1gxcsa:1&2,ssn1pq1:16&15,ssn1sep;
:cfg-add-board:17&18,ssn1nscc:8&11,ssn2sl64;
:cfg-add-board:19&20,ssn1d75s:33,ssn1eu04:35,ssn1tsb4;
//To add interface boards
6. //Clock configuration
:cfg-set-synclass:9,3,0x0801,0x0b01,0xf101;
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 20
Batch File Format
7. //Orderwire configuration
:cfg-set-telnum:37,1,101; //To set an addressing call number
:cfg-set-meetnum:37,999; //To set a conference call number
:cfg-set-reqtime:37,5; //To set call-waiting time
:cfg-set-lineused:37,8,1,used; //To set the optical interface for the order wire service
:cfg-set-meetlineused:37,8,1,used; //To set the optical interface for the conference call
8. //Service configuration
:cfg-add-xc:0,15,1,1,0,8,1,1,0,vc4;
:cfg-add-xc:0,8,1,1,0,15,1,1,0,vc4;
:cfg-add-xc:0,2,1&&32,0,0,8,1,2,1&&32,vc12;
:cfg-add-xc:0,8,1,2,1&&32,2,1&&32,0,0,vc12;
9. :cfg-verify;
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 21
Batch File
In V5.0, the command line software rejects the user and returns
NSERR_SM_LOGIN_ALREADY when szhw already logs in to the NE.
To forcedly log in, run the following command:
#1:lognew:"szhw","nesoft";
NOTE
1.
To log in to an NE
#1:login:"szhw","nesoft";
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 22
Batch File
2.
To end performance monitoring
:per-set-endtime:15m,1990@0@0@0@0@0;
:per-set-endtime:24h,1990@0@0@0@0@0;
Function:
These commands end performance monitoring and ensure that configuration rate and data
are properly sent to an NE.
Parameter description:
15m: Performance monitoring at the period of 15 minutes
24h: Performance monitoring at the period of 24 hours
1990@0@0@0@0@0: End time of performance monitoring. End performance
monitoring as required. To end performance monitoring immediately, set the end time
to 1990@0@0@0@0@0.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 23
Batch File
To initialize an NE
:cfg-init-all;
Function:
This command initializes an NE to clear all original data from the NE. In
this way, the original data does not affect the coming configurations.
Initialize the NE before you configure an NE.
3.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 24
Batch File
To set NE parameters
:cfg-set-devicetype:OptiXOsn3500,standard; //case-senstive
:cfg-set-nename:64,OSN 3500 example; //The assignment 64 indicates
the length of the NE name.
:cfg-set-nepositon:1109 room; //This command is optional.
4.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 25
Batch File
To add boards
:cfg-add-board:9&10,ssn1gxcsa:1&2&3,ssn1pq1;
:cfg-add-board:15&16,ssn1sep:8&11,ssn2sl64;
:cfg-add-board:19&&22,ssn1d75s:33,ssn1eu04:35,ssn1tsb4;
5.
Notes:
1. Enter proper slot numbers and board names.
2. Precede a board name with ssn1 or ssn2 to indicate whether the board is in
series N1 or N2. For example, ssn1gxcsa. For details, see the board number.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 26
Batch File
Precautions:
> The following boards need to be added:
- Line boards
- Tributary boards
- SCC
- Ethernet boards
- Interface boards
- Optical amplifier boards
> The active SCC is created by default and cannot be deleted. The standby SCC can be manually added or deleted.
> An interface board can be added only when its mapping processing board is added.
> A logically added board is in one of the following states:
- Adding
- Active
- Deleting
A board is successfully added or deleted only when the addition or deletion is successfully verified.
> By default, the PIU, FAN, and AUX/SAP boards are automatically added rather than manually installed.
> The CXL1/4/16 boards create logical functional units by logical slot.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 27
Batch File
To set clock parameters
:cfg-set-synclass:Bid,SyncNum,Sync1,Sync2,;
For example,
:cfg-set-synclass:9,4,0xf001,0x0801,0x0b01,0xf101;
Parameter Description
Bid
ID of the cross-connect clock board
Value range: 9 or 10
SyncNum Number of clock sources
Sync1/Sync2 Number of a clock source
6.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 28
Batch File
For example,
:cfg-set-synclass:9,4,0xf001,0x0801,0x0b01,0xf101;
There are four clock sources. Each clock source is numbered in double-byte hexadecimal.
- The more significant byte indicates the ID of a line board (0x010x11).
- The less significant byte indicates the number of an optical interface. The optical interfaces
are numbered from 1 on.
The clock sources are numbered as follows:
- External clock source 1 is numbered 0xf001.
- External clock source 2 is numbered 0xf002.
- The internal clock source is numbered 0xf101.
Notes:
Ensure that each line board indicated by the more significant byte is already installed.
End the clock source priority table with the internal clock source.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 29
Batch File
To set orderwire parameters
:cfg-set-telnum:37,1,101; //To set an addressing call number
:cfg-set-meetnum:37,999; //To set a conference call number
:cfg-set-tellen:37,3; //To set the length of a telephone number
:cfg-set-reqtime:37,5; //To set call-waiting time
:cfg-set-lineused:37,8,1,used; //To set the optical interface for the order wire
service
:cfg-set-meetlineused:37,8,1,used; //To set the optical interface for the
conference call
Notes:
1. Ensure that each board indicated by the commands is already installed.
2. Set the optical interface for the addressing call and that for the
conference call separately.
3. Keep the optical interface for the conference call from a loop.
7.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 30
Batch File
To add service connections
:cfg-add-xc:0,15,1,1,0,8,1,1,0,vc4;
:cfg-add-xc:0,8,1,1,0,15,1,1,0,vc4;
:cfg-add-xc:0,2,1&&32,0,0,8,1,2,1&&32,vc12;
:cfg-add-xc:0,8,1,2,1&&32,2,1&&32,0,0,vc12;
8.
NOTE
1. Add bidirectional service connections in pairs.
2. Precede each command with comments.
3. In the case of a service terminated at the local site //local site
peer site
4. In the case of a pass-through service //source site sink site
pass through
To add a VC4 service connection, which runs from VC4 1 on optical
interface 1 of slot 15 (source) to VC4 1 on optical interface 1 of slot 8 (sink)
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 31
Batch File
9. To verify and issue configurations
:cfg-verify;
Function:
This command enables the SCC to verify configurations and physical
situations. If the verification succeeds, the SCC saves the configurations
and notifies the other boards about starting by the configurations.
Without the command, the SCC does not issue the configurations to the
other boards.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 32
To query the state of an NE and to check whether it runs properly
:cfg-get-nestate;
Function:
This command checks whether configurations are successfully issued. If
the NE is in the running state, the configurations are successfully issued.
If the NE is in the installing state, the configurations fail to be delivered.
Batch File
10.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 33
To back up the NE database, that is, NE configurations manually
:dbms-copy-all:drdb,fdb0;
:dbms-copy-all:drdb,fdb1;
Function:
These commands prevent fdb0 and fdb1 from being lost due to restart.
Batch File
11.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 34
Question
Explain the following statements:
#1:lognew:"szhw","nesoft";
:per-set-endtime:15m,1990@0@0@0@0@0;
:per-set-endtime:24h,1990@0@0@0@0@0;
:cfg-init-all;
:cfg-set-devicetype:OptiXOsn3500,standard;
:cfg-set-nename:64,"NE1";
:cfg-add-board:9&10,ssn1gxcsa:1,ssn1sep1:7,ssn1sl16:17&18,ssn1nscc;
:cfg-set-synclass:9,1,0xf101;
:cfg-set-telnum:37,1,101;
:cfg-set-meetnum:37,999;
:cfg-set-reqtime:37,5;
:cfg-set-lineused:37,7,1,used;
:cfg-set-meetlineused:37,7,1,used;
:cfg-add-xc:0,7,1,1,0,1,1,1,0,vc4;
:cfg-add-xc:0,1,1,1,0,7,1,1,0,vc4;
:cfg-verify;
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 35
Chapter 1 Overview of Command Lines
Chapter 2 Developing a Batch File
Chapter 3 Common Commands Chapter 3 Common Commands
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 36
Common Commands
The add commands adds data.
The set command sets data.
The get command queries data.
The del command deletes data.
Example:
:cfg-get-nestate;
//To query the state of an NE
After verification, an NE must be in the running state rather than in the installing state.
:cfg-get-xc:0,0;
//To query all current cross-connections
:cfg-get-xc:0,5;
//To query all cross-connections terminated at slot 5
Configuration query Configuration query
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 37
Common Commands
:cfg-get-devicetype
//To query the type of an NE
:date(:set-date:2000-2-13)
//To query the date of an NE
:time(:set-time:13*00*11)
//To query the time of an NE
:cfg-get-phybd
//To query the physical board information
:cfg-get-bdversion:Bid
//To query the version of a board
:cfg-get-bdverinfo:Bid
//To query the version information of a board
Other queries Other queries
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 38
Common Commands
Alarm query Alarm query
To query a current alarm
alm-get-curdata:para1,para2;
Parameter description:
para1: ID of a board. To query all boards, set this parameter to 0.
para2: ID of an event. To query all events, set this parameter to 0.
Example:
:alm-get-curdata:0,0;
//To query all current alarms reported by all boards
:alm-get-curdata:11,0;
//To query all current alarms reported by board 11.
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 39
Common Commands
To query a history alarm
:alm-get-hisdata:para1,para2;
Parameter description:
para1: ID of a board. To query all boards, set this parameter to 0.
para2: ID of an event. To query all events, set this parameter to 0.
Example:
:alm-get-hisdata:0,0;
//To query all history alarms reported by all boards
Alarm query Alarm query
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 40
Common Commands
:set-date:2002-1-1;
//To set the date of an NE
:set-time:12*00*00;
//To set the time of an NE
:per-set-monevent:0,0,0,0,perall,15m,enable;
//To set a performance event to monitor
Performance monitoring Performance monitoring
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 41
Common Commands
:per-set-autorep:0,0,0,0,perall,15m(24h),disable;
//To disable reporting a performance event automatically
:per-set-starttime:15m,2005@1@2@3@4@5;
//To set the start time of the performance monitoring at the period of 15
minutes performance
:per-set-starttime:24h,2005@1@2@3@4@5;
//To set the start time of the performance monitoring at the period of 24
hours
Performance monitoring Performance monitoring
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 42
Common Commands
:login:"zhang","pass_word";
//To log in to an NE as zhang
:lognew:"zhang","pass_word";
//To forcedly log in to an NE as zhang
:sm-add-user:"user1","my_pass","every",enable;
//To add a user
User management User management
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 43
Common Commands
:sm-get-alluser;
//To query all users
:sm-get-curuser;
//To query the current user
:logout;
//To log out of an NE
User management User management
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 44
Common Commands
:cm-set-lanautoecc:open;
//To automatically extend an ECC
:cm-get-eccroute;
//To query an ECC route
:cm-get-chanerror;
//To query an ECC error
:cm-get-bdinfo;
//To query ECC status on an optical interface of an optical interface board
:cm-get-fiberport:bid,portnum;
//To query the state of an optical interface in an optical interface board, including DCC rate
ECC command ECC command
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 45
Common Commands
:cfg-reset-board:Bid, resetmode
Parameter description:
Bid: ID of a board
resetmode: Mode of reset
- Hard, a cold reset
- Soft, a warm reset
NOTE
A cold reset is thorough but interrupts services.
A warm reset protects services from interruption but is not thorough.
Board reset Board reset
:reset;
NE reset NE reset
Query about NE software version Query about NE software version
:sys-get-nesoftver;
//To query the software version of an NE
HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 46
Questions
What does a command line configuration file consist of?
In addition to the configuration commands, what commands are commonly used?
Thanks!
www.huawei.com