Upload
umer-aftab
View
45
Download
6
Tags:
Embed Size (px)
DESCRIPTION
12122
Citation preview
NetNumen M31(RAN)Mobile Network Element Management System
MML Terminal Operation Guide
Version: 12.10.032
ZTE CORPORATIONNO. 55, Hi-tech Road South, ShenZhen, P.R.ChinaPostcode: 518057Tel: +86-755-26771900Fax: +86-755-26770801URL: http://ensupport.zte.com.cnE-mail: [email protected]
LEGAL INFORMATIONCopyright © 2011 ZTE CORPORATION.
The contents of this document are protected by copyright laws and international treaties. Any reproduction or
distribution of this document or any portion of this document, in any form by any means, without the prior written
consent of ZTE CORPORATION is prohibited. Additionally, the contents of this document are protected by
contractual confidentiality obligations.
All company, brand and product names are trade or service marks, or registered trade or service marks, of ZTE
CORPORATION or of their respective owners.
This document is provided “as is”, and all express, implied, or statutory warranties, representations or conditions
are disclaimed, including without limitation any implied warranty of merchantability, fitness for a particular purpose,
title or non-infringement. ZTE CORPORATION and its licensors shall not be liable for damages resulting from the
use of or reliance on the information contained herein.
ZTE CORPORATION or its licensors may have current or pending intellectual property rights or applications
covering the subject matter of this document. Except as expressly provided in any written license between ZTE
CORPORATION and its licensee, the user of this document shall not acquire any license to the subject matter
herein.
ZTE CORPORATION reserves the right to upgrade or make technical change to this product without further notice.
Users may visit ZTE technical support website http://ensupport.zte.com.cn to inquire related information.
The ultimate right to interpret this product resides in ZTE CORPORATION.
Revision History
Revision No. Revision Date Revision Reason
R1.0 2011-02-28 First Edition
R1.1 2011-04-25 This revision provides an introduction to man-machine language
in an additional appendix.
Serial Number: SJ-20101227165724-011
Publishing Date: 2011-04-25(R1.1)
ContentsAbout This Manual ......................................................................................... I
Chapter 1 Overview.................................................................................... 1-11.1 MML Terminal Overview ..................................................................................... 1-1
1.2 GUI of the MML Terminal .................................................................................... 1-2
1.3 Setting Preferences............................................................................................ 1-3
1.4 Implicit Prerequisites .......................................................................................... 1-5
Chapter 2 Using the MML Terminal........................................................... 2-12.1 Running a Command on the MML Tree ............................................................... 2-1
2.2 Running a Command by Manual Input ................................................................. 2-3
2.3 Searching for an MML Command ........................................................................ 2-4
2.4 Getting the Help of an MML Command ................................................................ 2-5
2.5 Querying History Commands .............................................................................. 2-6
2.6 Viewing Uploaded Messages .............................................................................. 2-7
2.7 Operations on Command Results........................................................................ 2-8
2.7.1 Clearing the Command Results................................................................. 2-8
2.7.2 Saving the Command Results ................................................................... 2-9
2.8 Operations on History Commands ..................................................................... 2-10
2.8.1 Saving History Commands...................................................................... 2-10
2.8.2 Deleting History Commands.................................................................... 2-10
Chapter 3 Batch File Operations............................................................... 3-13.1 Importing a Batch File......................................................................................... 3-1
3.2 Running the Commands of a Batch File ............................................................... 3-2
3.3 Saving a Batch File ............................................................................................ 3-3
3.4 Clearing the Running Result of a Batch File ......................................................... 3-3
3.5 Clearing the Imported Batch File Contents ........................................................... 3-4
Chapter 4 Using MML Commands via Telnet........................................... 4-14.1 Logging in to the Server via Telnet....................................................................... 4-1
4.2 Running MML Commands via Telnet ................................................................... 4-2
Appendix A Introduction to Man-Machine Language ............................ A-1
Figures............................................................................................................. I
Tables ............................................................................................................ III
Glossary .........................................................................................................V
I
II
About This ManualThe NetNumen M31 Mobile Network Element Management System (hereinafter calledNetNumen M31 or EMS for short) is a network management system for managing mobilenetwork elements. It is an intermediate system between the upper-layer operation supportsystem and lower-layer network element management systems. By using NetNumenM31,you may perform the integrated and centralised management operations on the networkelements, including:
l Configuration managementl Fault managementl Performance managementl Security managementl Log managementl Report management
NetNumen M31 uses object-oriented technologies. It is designed on the advanced J2EEplatform, providing unified standard interfaces to external devices.
Purpose
This operation guide provides the instructions on using the MML terminal provided byNetNumen M31.
Intended Audience
l Operation and Maintenance Engineersl Network Monitoring Engineers
What Is in This Manual
Chapter Summary
Chapter 1, Overview Introduces the function of the MML terminal and MML commands,
describes the graphic user interface of the MML terminal on the
NetNumen M31 client, and provides the instruction on how to set the
preferences for the MML terminal.
Chapter 2, Using the MML
Terminal
Provides the instructions on using single commands on the MML
terminal interface, and describes the operations on the command
results, history commands.
Chapter 3, Batch File
Operations
Provides the instructions on the batch file operations in the MML
terminal view, such as import, modify, save and delete a batch file.
I
Chapter Summary
Chapter 4, Using MML
Commands via Telnet
Describes how to log in to the NetNumen M31 server from a PC
terminal via Telnet and how to use MML commands via Telnet.
Appendix A Introduction to
Man-Machine Language
Gives an introduction to MML, including common MML terms and the
implementation of MML functions in the NetNumen M31 system.
Conventions
ZTE documents employ the following typographical conventions.
Typeface Meaning
Italics References to other manuals and documents.
“Quotes” Links on screens.
Bold Menus, menu options, function names, input fields, option button names, check
boxes, drop-down lists, dialogue box names, window names.
CAPS Keys on the keyboard and buttons on screens and company name.
Note: Provides additional information about a certain topic.
Checkpoint: Indicates that a particular step needs to be checked before
proceeding further.
Tip: Indicates a suggestion or hint to make things easier or more productive
for the reader.
II
Chapter 1OverviewTable of Contents
MML Terminal Overview .............................................................................................1-1GUI of the MML Terminal............................................................................................1-2Setting Preferences....................................................................................................1-3Implicit Prerequisites ..................................................................................................1-5
1.1 MML Terminal OverviewMML Terminal
NetNumen M31 provides the Man-Machine Language (MML) terminal as a commandline tool. The MML terminal supports various commands for fault management, securitymanagement, and configuration management operations. You can manage the objectsinvolved in the network Element Management System (EMS) by running single commandsor batch commands in the MML terminal.
The NetNumen M31 client provides a Graphic User Interface (GUI) for the MML terminal,on which you can use MML commands in an intuitive way. You can also telnet to the MMLterminal via a remote computer and use MML commands directly to perform operationson managed objects.
MML Command Introduction
An MML command always starts with a command code and ends with “;”. The commandcode determines the function of the command. When a command code is not enough toinvolve the complete operation information, the parameter part is generally added to thecommand code for explication.
The parameter part, using “:” as the start symbol, contains one parameter, or multipleparameters separated by “,”. The value of each parameter is bracketed by doublequotation marks.
The following gives an example of MML command:
ADDUSER: NAME= "study", FULLNAME= "student", DESCRIPTION= "1", PHONENUMBER= "5555555", EMAILADDRESS= "[email protected]", DEPARTMENT= "Maintenance",USERVALIDDAYS= 50, PASSWORDVALIDDAYS= 50, DISABLE= TRUE;
The previous command is used to add a new user with the user name “study” and fullname “student”. The telephone number of the user is “5555555” and the Email address is
1-1
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
“[email protected]”. This user belongs to the maintenance department. And the user 'svalidity period is 50 days. The password validity period is also 50 days.
Note:
MML commands vary with the actual equipment managed by the EMS. Therefore,this operation guide only gives the instruction of using the MML terminal. For moreexplanations of MML commands, please refer to MML command reference manual ofrelated equipment.
1.2 GUI of the MML TerminalTo open the MML terminal interface on the NetNumen M31 client, log in to the client first,and then do one of the following:
l Click Configuration > MML Terminal on the menu bar.l Click on the toolbar.
Figure 1-1 shows the MML terminal interface on the client.
Figure 1-1 MML Terminal Interface
1. NE tree2. Command processing pane
3. Command parameter pane4. Command input pane
5. MML tree
The following explains some components on the MML terminal interface.
l NE tree: lists all network elements managed by the EMS.
1-2
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Chapter 1 Overview
l MML-Tree: lists all available MML commands of the selected NE.l Command Processing: This pane consists of the following four tabs:
à Command Result tab: shows the running result of MML commands.
à History Command tab: lists all the history commands that you have run on theMML terminal interface, including the running time, result and command name.
à Upload Message tab: shows the running result of some commands that needlong time for completion, which may not be displayed on the Command Resulttab.
à Help tab: shows the help information of an MML command, such as commandformat, input parameters, output parameters, enumerable parameters, andcommand examples.
l Batch Processing: In this pane, you can import a batch file, run the batch commandsin the imported file, view the running result of the commands, save the running result,and delete the imported batch file.
l Code drop-down box: shows the current command selected on the MML-Tree andlists all previous commands that you have run.
l : click to show the previous command listed in the Code drop-down box.l : Click to show the next command listed in the Code drop-down box.l : click to run the current command.l : This button is available only when you run a batch command on the
command processing pane. Generally, a batch command needs a long time forcompletion because it concerns a mass of data. It may occupy the Command Resulttab for a long time to show the command result and you can not do other operationson the interface during the running of the batch command. In this case, you can clickthis button to suspend the batch command after getting the information you wantbefore the completion of this command.
1.3 Setting PreferencesPrerequisites
l You have successfully logged in to the NetNumen M31 client.l The MML Terminal interface is open.
Context
The purpose of preferences setting is to determine the processing mode of historycommands, command results, messages and batch command results when their countsexceed a certain limit, for example, deleting them directly, or saving and then deletingthem. After the setting of preferences, the related records will be automatically deleted,or saved and deleted, when the records are more than the preset number.
To set the preferences, perform the following steps:
1-3
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
Steps
1. On the menu bar of the client window, click Configuration > Preferences to open thePreferences dialogue box, as shown in Figure 1-2.
Figure 1-2 Preferences dialogue box
2. Set the preferences according to Table 1-1.
Table 1-1 Value Range for Preference Setting
Record Type Value Range Default Saving Path
History Command 1 to 100/ums-client/works/full/runtime/ppus/
uca.ppu/uca-mml.pmu/log/History
Command Result 1 to 100
/ums-client/works/full/runtime/ppus
/uca.ppu/uca-mml.pmu/log/ExecuteRe
sult
Message Report 1 to 100
/ums-client/works/full/runtime/ppus
/uca.ppu/uca-mml.pmu/log/MessageRe
port
Batch Command Result 1 to 100/ums-client/works/full/runtime/ppus/
uca.ppu/uca-mml.pmu/log/BatchResult
• All the default folders, where the records are saved, are under the installation directory of theclient software, which corresponds to the setting during the installation process.
a. Type the upper limit of record number in the box after “beyond”.
1-4
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Chapter 1 Overview
b. If you want to save the records of command results before deleting them, selectthe Automatic Save check box.
c. If you want to save the records of command results under another path instead ofthe default one, click Browse to select a new path in the pop-up Save dialoguebox.
d. If you want to save the records of command results by NE, selectAutomatic SaveBy NE. Or else, select Automatic Save Not By NE.
3. Click OK to complete the setting of preferences and close the Preferences dialoguebox.
– End of Steps –
1.4 Implicit PrerequisitesFor all the operations described subsequent to this section, the following prerequisites arepresumed to have been met.
l You have successfully logged in to the NetNumen M31 client.l The MML Terminal view is open.l The connection between the managed NE and the NetNumen M31 server is normal.
1-5
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
This page intentionally left blank.
1-6
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Chapter 2Using the MML TerminalTable of Contents
Running a Command on the MML Tree ......................................................................2-1Running a Command by Manual Input........................................................................2-3Searching for an MML Command ...............................................................................2-4Getting the Help of an MML Command.......................................................................2-5Querying History Commands......................................................................................2-6Viewing Uploaded Messages .....................................................................................2-7Operations on Command Results...............................................................................2-8Operations on History Commands............................................................................2-10
2.1 Running a Command on the MML TreeContext
TheMML-Tree pane on theMML Terminal view provides all available MML commands foreach managed object in the system. You can select a command on MML-Tree and issuethe command to the corresponding NE. The NE will then carry out the operation requiredby the command and return the result.
To select and run a command on the MML tree, perform the following steps:
Steps
1. Click an NE node on the NE tree. The MML-Tree refreshes itself automatically andshows all available MML commands corresponding to the type of the selected NE, asshown in Figure 2-1.
2-1
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
Figure 2-1 Selecting an NE
Tip:
If you want to issue a command to multiple NEs of the same type, press and holdCTRL, and then click these NEs one by one on the NE tree.
2. Expand MML-Tree and then click the MML command you want to run.
The selected MML command appears in the Code drop-down box, and the parameterdisplay area shows the input parameters of the command that you need to set, asshown in Figure 2-2.
Figure 2-2 Selecting an MML Command
3. Set the input parameter(s).
2-2
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Chapter 2 Using the MML Terminal
4. Click the Execute button.
– End of Steps –
Result
The Command Result tab on the Command Process pane shows the command result,as shown in Figure 2-3.
Figure 2-3 Showing the Command Result
2.2 Running a Command by Manual InputPrerequisites
l You have selected the managed NE to which the command will be issued.
To select a managed NE, you can click the corresponding NE node on the NE treedirectly, or use the SET AMO command.
Context
NetNumen M31 also supports the manual input of MML commands. You can enter anMML command on the command input pane in the MML Terminal view to issue the inputcommand to the corresponding NE.
2-3
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
Note:
MML commands vary with the NE types managed by the EMS. The previous section“MML Terminal Overview” gives a brief explanation of MML commands. For moreexplanation of MML commands, please refer to the MML command reference manual ofrelated equipment.
To run an MML command by manual input, perform the following steps:
Steps
1. Type an MML command in the command input pane, as shown in Figure 2-4.
Figure 2-4 Typing an MML Command
2. Click Execute to run the command.
– End of Steps –
Result
The Command Result tab on the Command Processing pane shows the commandresult.
2.3 Searching for an MML CommandContext
To search for an MML command of an NE, “CLEAR ALARM”, for example, perform thefollowing steps:
2-4
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Chapter 2 Using the MML Terminal
Steps
1. Click an NE node on the NE tree. TheMML-Tree refreshes itself automatically to showall available MML commands corresponding to the type of the selected NE.
2. Type a keyword (“ALARM”, for example) of the command to be found in the Inputsearch text box, and then click .
– End of Steps –
Result
TheMML-Tree changes accordingly and shows all the commands containing the keyword“ALARM”. The command “CLEAR ALARM” is the first command in the search result, asshown in Figure 2-5.
Figure 2-5 Search Result
2.4 Getting the Help of an MML CommandContext
The Help tab on the command processing pane of the MML Terminal view provides thehelp information of some MML commands, such as command function, input parameters,output parameters, and command examples.
To view the help information of an MML command, perform the following steps:
Steps
1. Click an NE node on the NE tree. TheMML-Tree refreshes itself automatically to showall available MML commands corresponding to the type of the selected NE.
2. Expand MML-Tree and then click the MML command you want to view.
3. Click the Help tab on the Command Processing pane.
– End of Steps –
2-5
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
Result
The help information of the selected command appears in theHelp tab, as shown in Figure2-6.
Figure 2-6 Getting the Command Help
2.5 Querying History CommandsContext
To query the history commands that you have run in the MML Terminal view, do thefollowing:
Steps
l Click the History Command tab on the Command Processing pane.
– End of Steps –
Result
The History Command tab on the Command Processing pane lists the records of allhistory commands that you have run in the MML Terminal view, as shown in Figure 2-7.
2-6
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Chapter 2 Using the MML Terminal
Figure 2-7 History Command
2.6 Viewing Uploaded MessagesContext
If an MML command takes a long time for completion and its result can not be displayed inreal-time on the Command Result tab, you can view the command result on the UploadMessage tab because the command result can be uploaded in the format of message viabroadcast interface at request.
Take the SHOW DB RATIO command for example. The following describes how to viewthe command result on the Upload Message tab.
Steps
1. Click the EMS server node on the NE tree.
2. Type the SHOW DB RATIO command in the command input area and then click, as shown in Figure 2-8.
The Command Result tab prompts you to view the command result on the UploadMessage tab.
2-7
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
Figure 2-8 Command Result
3. Click the Upload Message tab and you can view the command result, as shown inFigure 2-9.
Figure 2-9 Upload Message Tab
– End of Steps –
2.7 Operations on Command Results
2.7.1 Clearing the Command Results
Context
To clear the command results displayed on the Command Result tab on the commandprocessing pane, do the following:
2-8
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Chapter 2 Using the MML Terminal
Steps
l Right-click any place on theCommandResult tab, and then clickClear on the shortcutmenu.
– End of Steps –
Result
The command results displayed on the Command Result tab are cleared.
2.7.2 Saving the Command Results
Context
The command results displayed on theCommand Result tab on the command processingpane can be saved as local text file(s).
NetNumen M31 supports the following two saving modes:
l Save all the command results in one text filel Save the results of commands running in the same NE in a text file, that is, the
command results of different NEs are saved separately in multiple text files.
To save the command results in a text file, perform the following steps:
Steps
1. Right-click any place on theCommandResult tab, and then click Save on the shortcutmenu to open the Save dialogue box.
Tip:
To save the command results by NE, click Save by NE Type instead on the shortcutmenu.
2. In the pop-up Save dialogue box, select the saving path, type the file name, and thenclick Save.
3. Click OK in the pop-up Confirm dialogue box that prompts successful saving.
– End of Steps –
2-9
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
2.8 Operations on History Commands
2.8.1 Saving History Commands
Context
You can save the record of one history command or all history commands displayed onthe History Command tab on the command processing pane.
To save one history command record, perform the following steps:
Steps
1. Click the History Command tab on the Command Processing pane.
2. Right—click the history command record to be saved on the History Command tab,and then click Save on the shortcut menu.
Tip:
To save all the records of the history commands, click Save All instead on the shortcutmenu.
3. In the Save dialogue box, select the saving path, type the file name, and then clickSave.
4. Click OK in the pop-up Confirm dialogue box that prompts successful saving.
– End of Steps –
2.8.2 Deleting History Commands
Context
You can delete one history command record or all history commands displayed on theHistory Command tab on the Command Processing pane.
To delete a history command record, perform the following steps:
Steps
1. Click the History Command tab on the Command Processing pane to show all therecords of history commands.
2. Right-click the history command record to be deleted on the History Command tab,and then click Delete on the shortcut menu.
2-10
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Chapter 2 Using the MML Terminal
Tip:
To delete all history command records, click Clear instead on the shortcut menu.
– End of Steps –
Result
The selected history command record disappears from the History Command tab.
2-11
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
This page intentionally left blank.
2-12
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Chapter 3Batch File OperationsTable of Contents
Importing a Batch File ................................................................................................3-1Running the Commands of a Batch File .....................................................................3-2Saving a Batch File ....................................................................................................3-3Clearing the Running Result of a Batch File ...............................................................3-3Clearing the Imported Batch File Contents .................................................................3-4
3.1 Importing a Batch FilePrerequisites
l You have prepared the batch file to be imported.
ContextA batch file is a text file containing a series of commands. The system can run the batchfile to execute all commands in the file.
To import a batch file into the system, perform the following steps:
Steps1. Click the Batch Processing tab on the MML Terminal interface, as shown in Figure
3-1.
Figure 3-1 Batch Processing Tab
3-1
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
2. Click on the toolbar to open the Select File dialogue box.
3. In the Select File dialogue box, select the batch file, and then click Open.
– End of Steps –
Result
The content in the selected batch file is displayed on the Batch Processing tab, as shownin Figure 3-2.
Figure 3-2 Imported Batch File
Tip:
You can modify the contents of the imported file directly on the Batch Processing tab.
3.2 Running the Commands of a Batch FilePrerequisites
l The batch file has been imported into the MML terminal.
3-2
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Chapter 3 Batch File Operations
Context
A single command only defines one operation. To make an NE complete multiplemaintenance operations continuously, you can edit a batch file and import it to the MMLterminal. When the batch file is run, the MML terminal reads the batch file and executesthe imported commands line by line.
Steps
l Click on the batch toolbar to run the imported batch file.
– End of Steps –
Result
The running result appears in the Result area. The error messages are also listed if thereare any.
3.3 Saving a Batch FilePrerequisites
l The batch file has been imported into the MML terminal.
Context
After importing a batch file, you can modify the content of the file as needed on the BatchProcessing pane and then save the modification.
To edit and save an imported batch file, perform the following steps:
Steps
1. Modify the contents in the batch file as needed in the Batch Processing pane.
2. Click on the toolbar.
3. Click OK in the pop-up Confirm dialogue box that prompts successful saving.
– End of Steps –
3.4 Clearing the Running Result of a Batch FilePrerequisites
l You have run a batch file.
Context
To clear the running result of a batch file displayed in the Result area, do the following:
3-3
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
Steps
1. Click on the toolbar.
2. In the pop-up Confirm dialogue box, click OK.
– End of Steps –
Result
The running result disappears from the Result area on the MML terminal interface.
Tip:
Before clearing the running result of a batch file, you can save them first by using thecorresponding buttons. is used to save all running result, while is used to save theresult by NE type.
3.5 Clearing the Imported Batch File ContentsPrerequisites
l The batch file has been imported into the MML terminal.
Context
To clear the imported contents of a batch file displayed on the Batch Processing paneand remove the batch file from the MML terminal, do the following:
Steps
1. Click on the toolbar.
2. In the pop-up Confirm dialogue box, click OK.
– End of Steps –
Result
The Batch Processing pane is cleared and the corresponding batch file is deleted fromthe MML terminal.
3-4
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Chapter 4Using MML Commands viaTelnetTable of Contents
Logging in to the Server via Telnet..............................................................................4-1Running MML Commands via Telnet ..........................................................................4-2
4.1 Logging in to the Server via TelnetPrerequisites
l The NetNumen M31 server has been started.l The local PC terminal runs properly, on which aWindows operating system is installed.
Context
To log in to the NetNumen M31 server via Telnet on the local PC terminal, perform thefollowing steps:
Steps
1. On the local PC, click Start > Run to open the Run dialogue box.
2. Type cmd in the Run dialogue box, and click OK.
3. In the pop-up DOS command window, type telnet IP address of the server 21123, andpress ENTER.
“21123” is the Telnet port number of the NetNumen M31 server. Suppose theIP address of the server is 10.63.138.35. To telnet to the server, type telnet
10.63.138.35 21123.
4. Type the user name, press ENTER, and then type the password, press ENTER againto log in to the NetNumen M31 server.
– End of Steps –
Result
The prompt $> appears in the DOS command window after successful login.
4-1
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
*****************************************************
NetNumen(TM) Unified Management System Terminal
ums [NetNumen M31 V12.10.032e]
*****************************************************
LOGIN
username:admin
password:
$>
4.2 Running MML Commands via TelnetPrerequisites
l The NetNumen M31 server runs properly.l The connection between the local PC terminal and the server is normal.l You have logged in to the server via Telnet.
Context
After successful login to the NetNumen M31 server via Telnet, you can issue MMLcommands to an NE managed by NetNumen M31 to carry out necessary operations.
Note:
MML commands vary with the type of NEs managed by NetNumen M31. The previoussection “MML Terminal Overview” gives a brief explanation of MML commands. For moreexplanations of MML commands, please refer to the MML command reference manual ofrelated equipment.
The following gives an example of how to connect to an NE and issue commands to theNE via Telnet.
Steps
1. After the prompt $> in the command window, type the SET AMO: NE NAME= ;command and press ENTER to connect to the corresponding NE.
Note:
“NE NAME” is the name of an NE displayed on the NetNumen M31 client, which isdefined during the creation of the corresponding NE agent.
4-2
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Chapter 4 Using MML Commands via Telnet
For example, suppose the “NE NAME” is “10.61.90.159”, enter the command asfollows:
*****************************************************
NetNumen(TM) Unified Management System Terminal
ums [1.10.30]
*****************************************************
LOGIN
username:admin
password:
$>SET AMO:10.61.90.159
$10.61.90.159>
Where, $10.61.90.159> indicates that the local PC is successfully connected to theNE (10.61.90.159) via Telnet.
2. Type an MML command and press ENTER to issue this command to the NE, whichexecutes the received command and returns the command result to the local terminal.
For example, to show all users of the NE, type the SHOWALLUSER command in thecommand window. The NE returns the command result as follows.
$10.61.90.159>SHOW ALLUSER
No. |Name |Description |Disable
---------------------------------------------------------------------
1 admin Administrator has all rights of this system. FALSE
---------------------------------------------------------------------
Rows: 1
$10.61.90.159>
Note:
You are recommended to use the NetNumen M31 client for the commissioning andmaintenance of the NetNumen M31 system. If you want to use the MML terminalfor the commissioning, configuration, and maintenance of NEs via Telnet, refer torelated MML command manuals of the corresponding equipment types for detailedinstructions on MML commands.
– End of Steps –
4-3
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
This page intentionally left blank.
4-4
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Appendix AIntroduction to Man-MachineLanguageThe NetNumen M31 system supports the use of a Man-Machine Language (MML) thatis defined to standardize the interfaces for managing telecommunications devices from aconsole. You can get access to a device in the managed network via a super terminal orTELNET utility, and then use MML commands to manage the device. The use of MMLfacilitates the commissioning and maintenance of telecommunications devices due to itsconvenience, flexibility and easy-use features.
MML Terminology
The following table explains common terms related to MML.
Term Explanation
MML command MML command is a data format specified by ITU-T for data transfer between
a terminal and a network management system. It is the complete specification
of a function that the system is required to perform.
The common attributes of an MML command include: command code,
mnemonic symbol, command name, and one or more parameters.
Mnemonic symbol A mnemonic symbol is a character string used for the memory of an MML
command, for example, “ADD_SHELF”. It usually indicates the meaning of
the MML command.
Character set The character set is a definite set of different characters specified in CCITT
Z.314, that is, a sub-set of the CCITT International Alphabet No. 5. The
character set contains three types of characters: letter, digit, and special
character.
Downlink MML
command
Downlink MML commands are command data issued by a user from a
terminal to the network management system.
Uplink MML
command
Uplink MML commands are data responded or reported by the network
management system.
A-1
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
Term Explanation
Command code A command must provide a complete specification of a function that the
system is required to perform. It comprises a command code followed
generally by one or more parameter blocks. A command code in the EMS is
an identifier containing four letters.
l The first letter defines the functional area (or sub-area) which this
command belongs to. It is regarded as level-1 code.
l The second and third letters define the object class that the command
will effect or influence. They are regarded as level-2 codes.
l The fourth letter defines the action that the system shall perform. It is
regarded as level-3 code.
Parameter A parameter is data that identifies and contains pieces of information
necessary to execute a command. It consists of one or multiple parameter
blocks separated with a delimiter (:). A parameter contains two parts:
parameter name and parameter value.
l Parameter Name: An identifier which indicates unambiguously the
meaning and structure of the subsequent parameter value.
l Parameter Value: The part of a parameter that contains the information
required to specify any appropriate object(s) or value(s).
Parameter block A parameter block is a set of parameters containing information necessary
for the system to perform the function specified in the command. Multiple
parameters in a parameter block are separated by a comma (,).
Simple parameter A simple parameter refers to a parameter whose value contains only one
information unit.
Compound
parameter
A compound parameter refers to a parameter whose value contains more than
one information unit. It is used to specify a multidimensional object or value.
Different information units are separated by a hyphen (-) in a logical order.
The positions of these information units cannot be changed. The information
units of digit type are generally placed at the end.
An example of compound parameter is: add user: userinfo = testuser-xxx;
Multiple instances A parameter may contain more than one parameter value, that is, a set of
parameter values separated with &. There is no logical relation among these
parameter values. The parameter values must be of the same type, that is,
simple, or compound. In other words, a parameter value may have multiple
instances.
For example, add user: userinfo= testuser1-xxx&testuser2-xxx;
Parameter type Parameter type determines the conversion method and storage mode of
parameter values. Common parameter types include: Boolean, integer, float,
enumeration, date&time, duration, address, and character string.
A-2
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
Appendix A Introduction to Man-Machine Language
Term Explanation
Reserved identifier Some identifiers are reserved because they are used by system commands,
system parameters, or common parameters in the system. These reserved
identifiers cannot be used in the definition of command codes and parameter
names. For example, commit, Rollback, begin, end, and ack are all reserved
identifiers.
Implementation of MML Functions in the EMSThe client and server of the NetNumen M31 system cooperate with each other toimplement the MML functions, as illustrated in Figure A-1.
Figure A-1 Implementation of MML Functions
l WSF: WorkStation Functionl MML: Man-Machine Languagel GUI: Graphic User Interfacel EMS: Element Management Systeml CLIS: Command Line Interface Serverl NE: Network Element
The following describes how theMML functions are implements on the client and the serverof the NetNumen M31 system.
l MML functions supported by the client
The client supports the access to the server via a command line terminal, which isan embedded operation interface similar to DOS. The operation requests are input ascommand lines in the terminal and then sent to the server in the format of commandmessages.
l MML functions supported by the server
A-3
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Terminal Operation Guide
The server allows the access of different clients, implements the logic processingof received requests, manages the database, and interacts with managed networkelements.
As shown in Figure A-1, the F interface module and the CLIS module work togetherto support the access of clients.
à The F interface module forwards received operation requests to correspondingmodules according to the command codes of these requests. The command codeof an operation request varies with the actual module that shall do this operation.
à The CLIS module receives the commands sent by the MML terminal or the GUI,verifies the validity of these commands, and then processes these commandsaccording to their types. The received commands can be classified into thefollowing three types:
t Data configuration commands: The CLIS module encapsulates suchcommands in a unified format and then sends them to the internal logicprocessing module for further processing.
t Alarm and performance commands: The CLIS module encapsulates suchcommands into F interface messages and then sends them to the F interfacemodule for further processing.
t System commands: The CLIS module forwards such commands to the NEsystem directly.
à The internal logic processing module implements the following processes:
t Security processing: This module authenticates the received operationrequests, and records these operations in logs.
t Data processing: This module can modify the topology information of thesystem according to the received commands, and store the requested datain the database of the system.
t Communicating with NEs: This module directly forwards the real-timecommands (for example, a command for querying alarms, or an onlineconfiguration command) to the NE system, and sends non-real-timecommands (for example, an offline configuration command) to the NEsystem after processing them.
t Responding on requests: This module can respond to some requests directly(for example, a single offline configuration command without synchronizationrequirement), or forward the response of the NE system to the EMS.
A-4
SJ-20101227165724-011|2011-04-25(R1.1) ZTE Proprietary and Confidential
FiguresFigure 1-1 MML Terminal Interface ........................................................................... 1-2
Figure 1-2 Preferences dialogue box ........................................................................ 1-4
Figure 2-1 Selecting an NE....................................................................................... 2-2
Figure 2-2 Selecting an MML Command................................................................... 2-2
Figure 2-3 Showing the Command Result................................................................. 2-3
Figure 2-4 Typing an MML Command ....................................................................... 2-4
Figure 2-5 Search Result .......................................................................................... 2-5
Figure 2-6 Getting the Command Help...................................................................... 2-6
Figure 2-7 History Command .................................................................................... 2-7
Figure 2-8 Command Result ..................................................................................... 2-8
Figure 2-9 Upload Message Tab ............................................................................... 2-8
Figure 3-1 Batch Processing Tab .............................................................................. 3-1
Figure 3-2 Imported Batch File.................................................................................. 3-2
Figure A-1 Implementation of MML Functions ...........................................................A-3
I
Figures
This page intentionally left blank.
TablesTable 1-1 Value Range for Preference Setting........................................................... 1-4
III
Tables
This page intentionally left blank.
GlossaryCLIS- Command Line Interface Server
DOS- Disk Operating System
EMS- Network Element Management System
GUI- Graphical User Interface
J2EE- JAVA 2 platform Enterprise Edition
MML- Man Machine Language
NE- Network Element
V