You are on page 1of 84

cmedit Syntax

Yiannis Agrogiannis yiannis@teledrom.com


cmedit subcommands
Get: List data for MOIs

Set: Modify data (attributes) for MOIs

Action: Perform an action on MOI

Describe: Describe an MO Class, an MOI, or MOI attributes

Create: Create a MOI

Delete: Delete a MOI

Export: Bulk-export CM data to a file

Import: Bulk-import CM data from a file


ENM CLI Page 1
cmedit subcommands
Get: List data for MOIs

Set: Modify data (attributes) for MOIs

Action: Perform an action on MOI

Describe: Describe an MO Class, an MOI, or MOI attributes

Create: Create a MOI

Delete: Delete a MOI

Export: Bulk-export CM data to a file

Import: Bulk-import CM data from a file


ENM CLI Page 2
cmedit General Syntax

commandset subcommand <node(s)> <MOC>

Target Node(s) Target MOC

ENM CLI Page 3


cmedit General Syntax

commandset subcommand <node(s)> <MOC>

Case Sensitive Non case-sensitive

ENM CLI Page 4


get subcommand

ENM CLI Page 5


cmedit get - syntax

cmedit get <node(s)> <MOC>

cmedit get <node(s)> <MOC>.*

cmedit get <node(s)> <MOC>.attribute

cmedit get <node(s)> <MOC>.(attribute1, attribute2,..)

ENM CLI Page 6


cmedit get - syntax

cmedit get <node(s)> <MOC>

cmedit get <node(s)> <MOC>.*

cmedit get <node(s)> <MOC>.attribute

cmedit get <node(s)> <MOC>.(attribute1,attribute2,..)

ENM CLI Page 7


cmedit get – Example 1

› Print all instances for MO=eutrancellfdd for a specific node


cmedit get ERBS1 EUtranCellFDD

› Print all instances for MO=eutrancellfdd for multiple nodes


cmedit get ERBS1;ERBS2 EUtranCellFDD

› Print all instances for MO=eutrancellfdd in whole network


cmedit get * EUtranCellFDD

(* indicates all nodes)

ENM CLI Page 8


cmedit get – Example 2
Wildcards for node(s) name(s)
› Print all instances for MO=eutrancellfdd

cmedit get ERB* EUtranCellFDD

cmedit get *01 EUtranCellFDD

cmedit get *RB* EUtranCellFDD

ENM CLI Page 9


cmedit get – Example 2
Wildcards for MOC=No support
› cmedit get ERBS1 EUtranCell*

› Error 4004 : Command syntax error, unexpected input '*' while


processing get command (object specifications).

› Suggested Solution :
Refer to usage instructions for the cmedit get command

ENM CLI Page 10


cmedit get - syntax

cmedit get <node(s)> <MOC>


cmedit get <node(s)> <MOC> -t

cmedit get <node(s)> <MOC>.*

cmedit get <node(s)> <MOC>.attribute

cmedit get <node(s)> <MOC>.(attribute1, attribute2,..)

ENM CLI Page 11


cmedit get - syntax

cmedit get <node(s)> <MOC>

cmedit get <node(s)> <MOC>.*

cmedit get <node(s)> <MOC>.attribute

cmedit get <node(s)> <MOC>.(attribute1, attribute2,..)

ENM CLI Page 12


cmedit get – Example 3
› Print all cell attributes for a specific node
cmedit get ERBS1 EUtranCellFDD.*

› Print all cell attributes for a multiple nodes


cmedit get ERBS1;ERBS2 EUtranCellFDD.*

› Print all cell attributes in network


cmedit get * EUtranCellFDD.*

ENM CLI Page 13


cmedit get – Example 4

› Use wildcard to identify a node and print All attributes for


MO=eutrancellfdd

cmedit get ERB* EUtranCellFDD.*

cmedit get *005 EUtranCellFDD.*

cmedit get *BS00* EUtranCellFDD.*

ENM CLI Page 14


cmedit get - syntax

cmedit get <node(s)> <MOC>

cmedit get <node(s)> <MOC>.*


cmedit get <node(s)> <MOC>.* -t

cmedit get <node(s)> <MOC>.attribute

cmedit get <node(s)> <MOC>.(attribute1, attribute2,..)

ENM CLI Page 15


cmedit get - syntax

cmedit get <node(s)> <MOC>

cmedit get <node(s)> <MOC>.*

cmedit get <node(s)> <MOC>.attribute

cmedit get <node(s)> <MOC>.(attribute1, attribute2,…)

ENM CLI Page 16


cmedit get – Example 5
› Print for All cells in a Node the operationalState attributes
cmedit get ERBS1 EUtranCellFDD.operationalState

› Print for All cells in multiple Nodes the operationalState attribute


cmedit get ERBS1;ERBS2
EUtranCellFDD.operationalState

› Print for All cells in network both the operationalState attributes


cmedit get * EUtranCellFDD.operationalState
ENM CLI Page 17
cmedit get – Example 6

› Use wildcard to identify a node and print All attributes for


MO=eutrancellfdd

cmedit get ERB* EUtranCellFDD. operationalState

cmedit get *005 EUtranCellFDD. operationalState

cmedit get *BS00* EUtranCellFDD. operationalState

ENM CLI Page 18


cmedit get – Specific Cell

› Print for a specific cell in a node the operationalState attribute

cmedit getLTE01ERBS00001
EUtranCellFDD.(EUtranCellFDDId==LTE01ERBS00001-1 ,
operationalState)

ENM CLI Page 19


cmedit get - syntax

cmedit get <node(s)> <MOC>

cmedit get <node(s)> <MOC>.*

cmedit get <node(s)> <MOC>.attribute


cmedit get <node(s)> <MOC>.attribute -t

cmedit get <node(s)> <MOC>.(attribute1, attribute2,…)

ENM CLI Page 20


cmedit get - syntax

cmedit get <node(s)> <MOC>

cmedit get <node(s)> <MOC>.*

cmedit get <node(s)> <MOC>.attribute

cmedit get <node(s)> <MOC>.(attribute1, attribute2,..)

ENM CLI Page 21


cmedit get – Example 7
› Print for all cells in a Node both the operationalState and
administrativestate attributes
cmedit get ERBS1 EUtranCellFDD.(operationalState,
administrativestate)

› Print for all cells in network both the operationalState and


administrativestate attributes
cmedit get * EUtranCellFDD.(operationalState,
administrativestate)

ENM CLI Page 22


cmedit get – Example 8
› Use wildcard to identify a node and print both the
operationalState and administrativestate attributes
MO=eutrancellfdd
cmedit get ERB* EUtranCellFDD.(operationalState,
administrativestate)

cmedit get *005 EUtranCellFDD. (operationalState,


administrativestate)

cmedit get *BS00* EUtranCellFDD. (operationalState,


administrativestate)

ENM CLI Page 23


Question - cmedit get

› What is the command to list ALL attributes for a


specific cell in a node ??

ENM CLI Page 24


Question - cmedit get

Correct or Wrong ??

cmedit get ERBS1


EUtranCellFDD.(EUtranCellFDDId==cell-1, * )

ENM CLI Page 25


Answer - cmedit get

Wrong

cmedit get ERBS1


EUtranCellFDD.(EUtranCellFDDId==cell-1, * )

ENM CLI Page 26


Answer - cmedit get

Correct

cmedit get FDN

ENM CLI Page 27


cmedit get – Example 9

› Print all cell attributes for a specific cell (FDN)


cmedit get
ManagedElement=ERBS1,ENodeBFunction=1,EUtranCellFDD=ERBS-1

cmedit get
SubNetwork=RadioNode, ManagedElement=ERBS1, ENodeBFunction=1,
EUtranCellFDD=ERBS-1

(when a node belongs to a subnetwork)

ENM CLI Page 28


cmedit get – Syntax Summary
cmedit get <node(s)> <MOC>

cmedit get FDN

cmedit get <node(s)> <MOC>.*

cmedit get <node(s)> <MOC>.attribute

cmedit get <node(s)> <MOC>.(attribute1,


attribute2,…)

ENM CLI Page 29


cmedit get – Syntax Summary
cmedit get <node(s)> <MOC>

cmedit get <node(s)> <MOC>.*

cmedit get <node(s)> <MOC>.attribute

cmedit get <node(s)> <MOC>.(attribute1, attribute2,…)

Single nodes : Node1


Multiple Nodes : Node1;Node2
Collection : Collection name

ENM CLI
Saved Search : Search Page
name30
Hint 1
cmedit get

› Print all children MOs for a specific parent MO

cmedit get <node(s)> <MO>,*

Parent MO comma (not dot)

ENM CLI Page 32


set subcommand

ENM CLI Page 33


cmedit set - syntax

› Modify an attribute for all MOIs for a node(s)


cmedit set <node(s)> <MOC> attribute=new_value

› Modify an attribute for a specific MOI for a node


cmedit set <node> <MOC>.(MOid==id)
attribute=new_value

ENM CLI Page 34


cmedit set – Example 10

› Set an attribute value for All cells in a node

cmedit set ERBS1 EUtranCellFDD administrativeState=LOCKED

› Set an attribute value for a specific cell in a node

cmedit set ERBS1 eutrancellfdd. eutrancellfddid==1


administrativestate=UNLOCKED

ENM CLI Page 35


cmedit set - syntax

› Modify an attribute for all MOIs for a node(s)


cmedit set <node(s)> <MOC> attribute=new_value

› Modify an attribute for a specific MOI for a node


cmedit set <node> <MOC>.(MOid==id)
attribute=new_value
Single nodes : Node1
Multiple Nodes : Node1;Node2
Collection : Collection name
Saved Search : Search name
ENM CLI Page 36
describe subcommand

ENM CLI Page 37


cmedit describe - syntax

(The command doesn’t accept the Node name)

cmedit describe <MOC>

cmedit describe <MOC>.*

cmedit describe <MOC>.attribute1

cmedit describe <MOC>.(attribute1,attribute2)

ENM CLI Page 38


cmedit describe – Example 11

› cmedit describe EUtranCellFDD.*

› cmedit describe EUtranCellFDD.* -t

› cmedit describe EUtranCellFDD.operationalState

› cmedit describe EUtranCellFDD.(operationalState,


administrativeState, availabilityStatus, cellBarred)

ENM CLI Page 39


action subcommand

ENM CLI Page 40


cmedit action - syntax
› Initiate a modeled action by Query
cmedit action <Node> criteria action [options]

› Initiate a modeled action by FDN


cmedit action <FDN> action

› Initiate a modeled action by FDN


cmedit action <FDN> criteria action [options]

ENM CLI Page 41


cmedit action – Example 12
Initiate Node Manual Restart
› Modeled action by Query
cmedit action ERBS1 ManagedElement
manualRestart.(restartRank=RESTART_WARM;
restartReason=PLANNED_RECONFIGURATION; restartInfo=someinfo)

› Modeled action by FDN


cmedit action MeContext=ERBS1,ManagedElement=1
manualRestart.(restartrank=RESTART_WARM,
restartreason=PLANNED_RECONFIGURATION,restartinfo=someInfo)
ENM CLI Page 42
cmedit action – Example 13

Initiate AuxPlugInUnit Manual Restart


› Modeled action by Query (Node name)

cmedit action ERBS1


AuxPlugInUnit.(AuxPlugInUnitId==RRU-1) restartUnit

cmedit action ERBS1 ManagedElement startHealthCheck

cmedit action * ManagedElement startHealthCheck

ENM CLI Page 43


cmedit action – Example 14
› Create a Node CV (ERBS node type)
cmedit action ERBS1 configurationversion
create.(configurationVersionName=..., identity=…, operatorName=…,
comment=…)

ENM CLI Page 44


cmedit action – Example 15

› Create a Node BrmBackup (RadioNode node type)

cmedit action Node1 brmbackupmanager createBackup

ENM CLI Page 45


cmedit action – Example 16
› Delete a Node CV (ERBS node type)
cmedit action ERBS1 configurationversion
delete.configurationVersionName=...

ENM CLI Page 46


Hint

ENM CLI Page 47


cmedit action – Example 17

› Find what actions are supported for an MOC


(list all supported actions for an MOI by using any keyword as a
trigger)

cmedit action <Node> <MOC> keyword

ENM CLI Page 48


cmedit action – Example 18
› Find the supported action types for MOC=ManagedElement

cmedit action Node1 managedelement test

› Error 1016 : An incorrect action name (coffee) has been encountered for
the type ManagedElement possible value(s) are [manualRestart,
startHealthCheck]

› Suggested Solution : Provide a value from this list:


[manualRestart , startHealthCheck]

ENM CLI Page 49


cmedit action – Example 19
› Find the mandatory attributes for a specific action type

cmedit action Node1 managedelement manualrestart

› Error 1005 : manualRestart requires the following mandatory


attribute(s): (restartRank, restartReason, restartInfo)

› Suggested Solution : Provide the mandatory attribute(s):


(restartRank, restartReason, restartInfo)

ENM CLI Page 50


cmedit action – Example 20
cmedit action eNB4-304 eutrancellfdd hello

Error 1016 : An incorrect action name (hello) has been encountered for
the type EUtranCellFDD possible value(s) are [changeFrequency,
startAilg, stopAilg]

Suggested Solution :
Provide a value from this list: [changeFrequency, startAilg, stopAilg]

ENM CLI Page 51


cmedit action – Example 21
cmedit action eNB4-304 enodebfunction bye

Error 1016 : An incorrect action name (icecream) has been encountered


for the type ENodeBFunction possible value(s) are
[updateMMEConnection, collectDynamicCellStatus]

Suggested Solution : Provide a value from this list:


[updateMMEConnection , collectDynamicCellStatus]

ENM CLI Page 52


create subcommand

ENM CLI Page 53


cmedit create - syntax
› Create a Managed Object Instance by FDN
cmedit create <FDN> attributes [options]

ENM CLI Page 54


cmedit create – Example 22

› Create an ENodeBFunction
cmedit create
MeContext=ERBS001,ManagedElement=1,ENodeBFunction=1
ENodeBFunctionId=1; userLabel=”New"; eNodeBPlmnId=(mcc=272,
mnc=7,mncLength=2)

ENM CLI Page 55


cmedit create – Example 23

› Create an ENodeBFunction

cmedit create

MeContext=ERBS001,ManagedElement=1,ENodeBFunction=1

ENodeBFunctionId=1; userLabel=”New"; eNodeBPlmnId=(mcc=272,


mnc=7,mncLength=2)

ENM CLI Page 56


cmedit create – Example 24
› Create an EUtranCellFDD

› cmedit create
MeContext=ERBS1,ManagedElement=1,ENodeBFunction=1,
EUtranCellFDD=2 physicalLayerSubCellId=2, earfcnul=20900,
cellId=2, physicalLayerCellIdGroup=67, eUtranCellFDDId=2,
tac=100, earfcndl=2900

ENM CLI Page 57


delete subcommand

ENM CLI Page 58


cmedit delete - syntax
› Delete an MOI by specifying the FDN
cmedit delete <FDN> [-ALL]

› Delete an object by specifying the FDN


cmedit delete <FDN> criteria [-ALL] [options]

› Delete an object by query


cmedit delete <node> criteria [filter] [-ALL] [options]

ENM CLI Page 59


cmedit delete – Example 25
› Delete an MOI (by FDN)
cmedit delete
MeContext=ERBS001,ManagedElement=1,ENodeBFunction=1

-ALL

› Delete an MOI (by query)


cmedit delete * EUtranCellFDD.(EUtranCellFDDId==3, cellId==1)

ENM CLI Page 60


Additional
Alternative 1
Identify MOI directly by MOid
Alternative 1
› <MO Class>=<MO_Id> <attr name>

› <MO Class>=<MO_Id> <attr name1>, <attr name2>,….

ENM CLI Page 63


Example  find MOid
» cmedit get LTE05ERBS00010 eutrancellfdd
FDN :
SubNetwork=ONRM_ROOT_MO,SubNetwork=Dublin,MeContext=LTE05ERBS00010,ManagedElement=1
,ENodeBFunction=1,EUtranCellFDD=LTE05ERBS00010-1

FDN :
SubNetwork=ONRM_ROOT_MO,SubNetwork=Dublin,MeContext=LTE05ERBS00010,ManagedElement=1
,ENodeBFunction=1,EUtranCellFDD=LTE05ERBS00010-2

FDN :
SubNetwork=ONRM_ROOT_MO,SubNetwork=Dublin,MeContext=LTE05ERBS00010,ManagedElement=1
,ENodeBFunction=1,EUtranCellFDD=LTE05ERBS00010-3

FDN :
SubNetwork=ONRM_ROOT_MO,SubNetwork=Dublin,MeContext=LTE05ERBS00010,ManagedElement=1
,ENodeBFunction=1,EUtranCellFDD=LTE05ERBS00010-4

FDN :
SubNetwork=ONRM_ROOT_MO,SubNetwork=Dublin,MeContext=LTE05ERBS00010,ManagedElement=1
,ENodeBFunction=1,EUtranCellFDD=LTE05ERBS00010-5

FDN :
SubNetwork=ONRM_ROOT_MO,SubNetwork=Dublin,MeContext=LTE05ERBS00010,ManagedElement=1
,ENodeBFunction=1,EUtranCellFDD=LTE05ERBS00010-6
6 instance(s)
ENM CLI Page 64
Alternative 1 Example 1/3
› Print MO instance for MO=eutrancellfdd
cmedit get ERBS1 eutrancellfdd=cell-2
Instead of

› cmedit get ERBS1 eutrancellfdd.(EUtranCellFDDId== cell-2)

› Print attr values for MO=eutrancellfdd


cmedit get ERBS1 eutrancellfdd=cell-2 tac,cellbarred

Instead of
› cmedit get ERBS1 eutrancellfdd.(EUtranCellFDDId== cell-2,
tac,cellbarred)
ENM CLI Page 65
Wildcards for MOid

› <MO Class>=<Partial MO_Id>*

*<Partial MO_Id>

*<Partial MO_Id>*

ENM CLI Page 66


Alternative 1 Example 2/3
› cmedit get ERBS1 eutrancellfdd=LTE05* tac,cellbarred

› cmedit get ERBS1 eutrancellfdd=*-2 tac,cellbarred

› cmedit get ERBS1 eutrancellfdd=*ERBS* tac,cellbarred

ENM CLI Page 67


Alternative 1 Example 3/3

› Print MOI data based on specific attribute value

cmedit get * eutrancellfdd=LTE05*


administrativestate==UNLOCKED , operationalstate

ENM CLI Page 68


Alternative 2
Identify MOI by FDN
Example  find FDN
» cmedit get LTE05ERBS00010 eutrancellfdd
FDN :
SubNetwork=ONRM_ROOT_MO,SubNetwork=Dublin,MeContext=LTE05ERBS00010,ManagedElement=1
,ENodeBFunction=1,EUtranCellFDD=LTE05ERBS00010-1

FDN :
SubNetwork=ONRM_ROOT_MO,SubNetwork=Dublin,MeContext=LTE05ERBS00010,ManagedEleme
nt=1,ENodeBFunction=1,EUtranCellFDD=LTE05ERBS00010-2

FDN :
SubNetwork=ONRM_ROOT_MO,SubNetwork=Dublin,MeContext=LTE05ERBS00010,ManagedElement=1
,ENodeBFunction=1,EUtranCellFDD=LTE05ERBS00010-3

FDN :
SubNetwork=ONRM_ROOT_MO,SubNetwork=Dublin,MeContext=LTE05ERBS00010,ManagedElement=1
,ENodeBFunction=1,EUtranCellFDD=LTE05ERBS00010-4

FDN :
SubNetwork=ONRM_ROOT_MO,SubNetwork=Dublin,MeContext=LTE05ERBS00010,ManagedElement=1
,ENodeBFunction=1,EUtranCellFDD=LTE05ERBS00010-5

FDN :
SubNetwork=ONRM_ROOT_MO,SubNetwork=Dublin,MeContext=LTE05ERBS00010,ManagedElement=1
,ENodeBFunction=1,EUtranCellFDD=LTE05ERBS00010-6
6 instance(s)
ENM CLI Page 70
Alternative 2 Example 1/1
› cmedit get FDN -attr cellbarred
Instead of

› cmedit get ERBS1 eutrancellfdd.(eutrancellfdd=cell-2 ,cellbarred )

› cmedit get FDN -attr cellbarred,tac


Instead of

› cmedit get ERBS1 eutrancellfdd.(eutrancellfdd=cell-2 ,cellbarred,tac)

ENM CLI Page 71


Hint 2
Criteria for get subcommand
Criteria 1
› Print all CM attributes of the specified MO Class
<MO Class>.<cm>
› Print all PM attributes of the specified MO Class
› Note: Only supported on CPP platform types where node types support reading
of PM counters as MO attributes.
<MO Class>.<pm>
› Print all Persistent attributes of the specified MO Class
<MO Class>.<p>
› Print all Writable Persistent attributes of the specified MO Class
› <MO Class>.<w>
› Print all Mandatory Persistent attributes of the specified MOC
<MO Class>.<m>
ENM CLI Page 73
Criteria 2
› Use a semi-colon to separate multiple MO Classes when
searching for all instances of *either* MOC1 or MOC2
<MO Class1>;<MO Class2>

› Use a comma to separate multiple MO Classes when


searching for all instances of MOC1 which have a child MOC
instance of MOC2
<MO Class1>,<MO Class2>

ENM CLI Page 74


Hint 3
get cmd – Example 1
› Report netype and synch status of particular node
cmedit get <Node(s)> --detailnode

Example
cmedit get eNB4-304 --detailnode
FDN : MeContext=eNB4-304
neType : ERBS
syncStatus : SYNCHRONIZED

1 instance(s)

ENM CLI Page 76


get cmd – Example 2

› cmedit get eNB* --detailnode

› cmedit get *04 --detailnode

› cmedit get *B4* --detailnode

› cmedit get node1;node2;node3 --detailnode

ENM CLI Page 77


Hint 4
action subcommand
› Any action performed by activating a non-live configuration
cannot be undone
› Reason:
action subcommand affects the non-persistent attributes

› All other functions performed by set, create, delete


subcommands can be undone

ENM CLI Page 79


Hint 5
Print multiple MOCs
› Search for all instances of *either* MOC1 or MOC2 or
MOC3

cmedit get <node(s)> MOC1;MOC2;MOC3

Note : Use a semi-colon as separator

ENM CLI Page 81


Hint 6
Print multiple MOCs
› Search for all instances of MO Class1 which have a child
MO Class instance of MO Class2

cmedit get <node(s)> MOC1,MOC2

Note : Use a comma as separator

ENM CLI Page 83

You might also like