Huawei

INTERNAL

Huawei OptiX OSN Equipment Command Line Introductionwww.huawei.com

HUAWEI TECHNOLOGIES CO., LTD.

All rights reserved

This course assumes that you know the following: Fundamentals of communication networks SDH principle and networking Hardware of Huawei OptiX OSN equipment


All rights reserved

Page 1

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.


All rights reserved

Page 2

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


All rights reserved

Page 3

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.


All rights reserved

Page 4

Chapter 1 Overview of Command Lines Chapter 2 Developing a Batch File Chapter 3 Common Commands


All rights reserved

Page 5

Overview of Command Lines

What is a command line?

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 - PowerfulHUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 6

Overview of Command LinesApplication of command line versionsVersion V3.0 Equipment of earlier versions OptiX 155/622, OptiX OSN 2500 V4.0 OptiX 155H, OptiX 155/622H (V200) OptiX Metro 3000 V5.0 OptiX Metro 100/200/500/1050, OptiX 155/622H (V300), OptiX 10GV2, OptiX NGSDH, OptiX OSN 9500 Application

Types of command line software Navigator Cmdterm CmdclientHUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 7

Overview of Command LinesNavigator 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.


All rights reserved

Page 8

Overview of Command LinesNavigator functions Inputs and outputs command

lines. Issues a batch file. Upgrades software of the SCC

and other boards. Saves results automatically.

Navigator window


All rights reserved

Page 9

Overview of Command LinesCmdterm 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


All rights reserved

Page 10

Overview of Command LinesCmdclient Self-contained software of the T2000 Based on the T2000 server Placed in the path \T2000\cmdclient\ by default Applicable to remote maintenance


All rights reserved

Page 11

Overview of Command LinesCmdclient window

Input a command here.


All rights reserved

Page 12

Overview of Command LinesRunning the cmdclient cmdclient> 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.HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 13 LU7 LU4 LU5 LU6

Slide 14 LU4Lenovo User, 6/23/2008

LU5Lenovo User, 6/23/2008



Overview of Command LinesFormat of a command line of version V5.0 V5.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.


All rights reserved

Page 14

Overview of Command LinesSyntax rules of a command line

Start of command: ":" (colon) End of command: ";" (semicolon) Parameter block separator: ":" (colon) Parameter separator: "," (comma) AND: "&" To: "&&" Shielding: "//"


All rights reserved

Page 15

Overview of Command LinesCommand format

:module-operation-operation object:parameter block,;

Module

Operationget: to query an object add: to add an object set: to set an object del: to delete an object reset: to reset an object

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

Example: alm-get-curdata:0,0;All rights reserved Page 16


Command Line Know-HowUseful operations 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


All rights reserved

Page 17



All rights reserved

Page 18

Batch File Format1. 2. 3. 4.

#1:login:"szhw","nesoft"; //The user name must be szhw. :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; //case-sensitive :cfg-set-nename:64,"OSN 3500 example"; :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 //Clock configuration :cfg-set-synclass:9,3,0x0801,0x0b01,0xf101;

5.

6.


All rights reserved

Page 19

Batch File Format7.

//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 //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; :cfg-verify;All rights reserved Page 20

8.

9.


Batch File1. To log in to an NE #1:login:"szhw","nesoft";

NOTEIn 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";


All rights reserved

Page 21

Batch File2. 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@[email protected] TECHNOLOGIES CO., LTD. All rights reserved Page 22

Batch File3. 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.


All rights reserved

Page 23

Batch File4. 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.


All rights reserved

Page 24

Batch File5. 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; 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.


All rights reserved

Page 25

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.


All rights reserved

Page 26

Batch File6. To set clock parameters :cfg-set-synclass:Bid,SyncNum,Sync1,Sync2,;

For example, :cfg-set-synclass:9,4,0xf001,0x0801,0x0b01,0xf101;Parameter Bid Value range: 9 or 10 SyncNum Sync1/Sync2 Number of clock sources Number of a clock source Description ID of the cross-connect clock board


All rights reserved

Page 27

Batch FileFor 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.


All rights reserved

Page 28

Batch File7.

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 wireservice

:cfg-set-meetlineused:37,8,1,used; //To set the optical interface for the conference callNotes: 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.HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 29

Batch FileTo 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)

8. 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;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 throughHUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 30

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.


All rights reserved

Page 31

Batch File10.

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.


All rights reserved

Page 32

Batch File11.

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.


All rights reserved

Page 33

QuestionExplain 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 34



All rights reserved

Page 35

Common CommandsConfiguration query 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 5HUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 36

Common CommandsOther queries: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 boardHUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 37

Common CommandsAlarm 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 38

Common CommandsAlarm query 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


All rights reserved

Page 39

Common CommandsPerformance monitoring :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


All rights reserved

Page 40

Common CommandsPerformance monitoring :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


All rights reserved

Page 41

Common CommandsUser management :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


All rights reserved

Page 42

Common CommandsUser management :sm-get-alluser; //To query all users :sm-get-curuser; //To query the current user :logout; //To log out of an NE


All rights reserved

Page 43

Common CommandsECC command: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


All rights reserved

Page 44

Common CommandsBoard reset: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.

NE reset:reset;

Query about NE software version:sys-get-nesoftver; //To query the software version of an NEHUAWEI TECHNOLOGIES CO., LTD. All rights reserved Page 45

Questions What does a command line configuration file consist of?

In addition to the configuration commands, what commands are commonly used?


All rights reserved

Page 46

Thanks!www.huawei.com

Huawei

Documents

common commandsuser

current alarms

common commandsperformance

addressing

conference

common commandsalarm

internal clock

end performance