NCLI.ppt

Node B Command Line

Node B Command Line

Interface

Interface

Lazy Guide to Common Commands

Lazy Guide to Common Commands

Ebrahim Jakoet Ebrahim Jakoet  Lin Voigt  Lin Voigt

$hat%s co&ered'

$hat%s co&ered'



 (his )resentation )ro&ides a basic guideline for using the command line(his )resentation )ro&ides a basic guideline for using the command line

interface to the Node B

interface to the Node B a&ailable in *++ for ,a&ailable in *++ for ,-(+. -(+. (he follo/ing items (he follo/ing items areare co&ered0

co&ered0

 1

 1 Logging into the Node Logging into the Node B using N+ or telnetB using N+ or telnet

 1

 1 ,ni3 command line editing commands,ni3 command line editing commands

 1

 1 LE4 status on boardsLE4 status on boards

 1

 1 Node B and Board restartsNode B and Board restarts

 1

 1 $orking /ith configuration &ersions$orking /ith configuration &ersions

 1

 1 5emote +hell login and Linkhandler )aths5emote +hell login and Linkhandler )aths

 1

 1 6rinting V+$57 (- current7 8aults on sectors6rinting V+$57 (- current7 8aults on sectors

 1

 1 6rinting Board error logs6rinting Board error logs

 1

 1 6rinting acti&e alarms on site6rinting acti&e alarms on site

 1

Login to the Node B using N+

Login to the Node B using N+

Click here Click here to login to to login to site site

Click and drag here to Click and drag here to increase /indo/ size increase /indo/ size

(elnet to the site

 Click on Sun Tools -> Terminal  to o)en a terminal.

 *n customer lan you can also use the dos command )rom)t by

clicking Start -> Run and then ty)e cmd .

 telnet to the Node B by ty)ing telnet  and the i) address of the Node B.

 (he username and )ass/ords are all standardized to rbsxxxx  /here  xxxx  is the site id.

Editing commands

 cursor-down: ne3t command in history  CTRL-a: go to beginning of command line  CTRL-e: go to end of command line

 CTRL-h: backs)ace

 CTRL-d: delete <character to the right=  CTRL-k: delete to end of line

 CTRL-u: delete to beginning of line

vii  command

 $hen you login you are on the CB, board.

 ,se vii  to dis)lay the status of &isual <o)tical= indicators on the

board that the command is e3ecuted on. (he command returns the status of the &isual <o)tical= indicators7 also kno/n as the Light Emitting 4iodes <LE4=7 together /ith a list of registered clients.

LE4 Indications

Fault LED (red)

Priority State RedLEDbehaviour  

1 (highest) 8ault <+teadyLight=

2 No8ault <*ut=

Operation LED (green)

Priority State Green LED behaviour  

1 (highest) 6o/er not )resent <*ut=

2 Initial boot test <#> ?z=

3 Load@(est in )rogress <2 ?z=

4 4e)endent 5esource -issing <.; ?z=

5 6o/er )resent <+teady Light=

Information LED (yellow)

Priority State Yellow LED behaviour  

1 (highest) Board Locked <+teady Light=

2 +hutdo/n in )rogress <.; ?z=

3 BoardBusy <#>?z=

 *n the CB, board7 you can restart the Node B using the reload  command

as follo/s0

 *)tions

 1 none0 $arm restart. (he o)erating system is restarted and all load modules are restarted /ith conditional reload <reloaded if found faulty=.  1 cold 0 ?ard/are on this board is reset and all load modules are

unconditionally reloaded.

 1 coldwtest 0 ?ard/are on this board is reset and all load modules are unconditionally reloaded. ?ard/are tests are )erformed and the results re)orted.

 1 refresh: ll load modules on this board are unconditionally reloaded and only a minimal set of initial tests are e3ecuted.

Get the 6I, I4

 (o get the 6lug In ,nit identities7 use the command getAttrObj piu piu-id>!

 (ry #7 27 9  if you don%t kno/ the numbers and ho/ they

corres)ond to the 6I,s.

 Instead of using piu7 the follo/ing obDects can also be used in a

similar /ay0

 1 me" piu" pgm" rpu" slot 7 or subrac# .

5estart Node B or 6I,

 (o restart the Node B7

use the command restartObj me

 (o restart a s)ecific

6I, use the command restartObj piu piu-id> /here the )iu"id is found as sho/n in the )re&ious slide

 ,se llog  to see a log of

the restarts on a board7 llog $l  for a

Configuration Versions

 ,se the command cv cu to see the

currently loaded configuration &ersion.

 (o list the last ; a&ailable CV%s7

use cv ls.

 ,se cv set name> to make this CV

startable on the ne3t reload <restart=.

 ,se cv m# name> to sa&e the

5emote +hell Login "lhsh

  (his command enables remote access to the command shell in another )rocessor. (he command uses the link

handler for the communication. (he command can s)ecify an o)tional command that is e3ecuted on the remote side. If no such command is s)ecified7 a ne/ interacti&e command shell session starts.

 (he command o)ens a connection to another )rocessor through a link handler. lnhpath>  is used as a link

handler )ath to find the other side of the link. 4e)ending on the gi&en )arameters7 either0

 1   )rom)t is )resented and you can e3ecute commands as if you are logged in directly to lnhpath>!  1 If a command is s)ecified7 only that command is e3ecuted and then the shell session terminates.

 $hen a ne/ command shell is started7 the )rom)t is re)laced by a )rom)t that tells you on /hat )rocessor the shell

(y)ical Node B Linkhandler 6aths

Board BoardTpe Swallocation # CB,# -ainCB, ! 5F#9 5B+5FB A 5F 5B+5FB  5F#9 5B+5FB ## (F>?+": 5B+(FB #2 5,I8 5B+5,I8B #2@)ortde&A 5, #2@)ort:de& 5, #2@)ortAde&# 5,

List )rocesses on board

 (he lhsh command uses the

address of the board you /ant to connect to that

follo/s the format mmnn7 /here mm is the +ubrack I4 and nn is the +lot I4 @ 6N.

 (o see the )ort"de& numbers

on the 5,I8 board7 use the command lhsh %%&'%% ps  port(!

LE4 status on 5, and 8, boards



(o see the LE4 status on the 5, boards7 use the

follo/ing command0

 1 lhsh %%&'%%)port*x*dev*+ vii 



(o see the LE4 status on the 8, boards7 use the

follo/ing command0

V+$57 (- currents7 (em)

 ,se the command

lhsh

%%&'%%)port*x*dev* + fui get vswr  to see the V+$5 reading.

 Instead of vswr 7 use

devstat" faults" temp to get the (-

currents7 faults and tem)erature

Error log for 6I,



,se the command te log read  to see the error log for a

)articular board

$orking /ith Log files

log files stored on the Node B.

 (he logattributes command gi&es more details for each log file7 including the )ath name that can be used to )rintout the log contents.

 ,se the ,ni3 cat command /ith the filename to see the contents of a log file.

4um) command

 If a )rogram crashes

<board restarts=7

information about the error is sa&ed in the 6ost

-ortem 4um) <6-4=

area7 and then sa&ed on a file. (his information can be analyzed using the dump command.

 ,sing the )athname from

the list of . pmd files7 enter dump error $i filename> to see more details about the )rogram crashes

-ore Commands



help0 +ee a full list of commands

 1 ,se ' Hcmd to )rint synta3 and descri)tion

 1 man Hcmd detailed descri)tion



te log read 0 6rint the error logs



readcloc# 0 5ead system clock uni3 date formatK



 pboot show para0 )rint the board and flash )arameters

e.g. board ty)e7 re&ision7 serial number7 )roduct

number and re&ision of the container soft/are.

who0 )rints all users /ho are logged on

Node Command Line Interface

 (o enter a s)ecial Node Command Line Interface enter ncli and you

/ill notice that the )rom)t changes to !"ana#edEle$ent%&'(

Current larms



Enter alarms to )rint all acti&e alarms on the site.

+earch for -*

 ,se the search command to find one or more -*s in the -* tree.

 Command +ynta30

 1 search moAddress>  search.evel> / 0Ot+pe>  filter> / 

Jum) to -*

 ,se the jump command to change the /orking -*. It is

)ossible to tra&erse the -anaged *bDect -odel <-*-= in the same manner as in a directory structure7 using different o)erands.

 (he 5elati&e 4istinguished Name <54N= of the ne/ /orking -*

5eading )arameter &alues



,se the get  command to

retrie&e the attributes

<)arameters= and children of

an -*



Enter help get  for a more

detailed descri)tion

Changing )arameter &alues



,se the set  command to set attribute &alues for an

instance of an -*.

No of acti&e 5adio links

(o see the

number of acti&e

radio links7 jump

to the

Radio.in#s -*

on the sector

and use the get 

command to

)rintout the

&alue of the

noOfRadio.in#s

attribute.

,nderstanding

-*- (he -anaged *bDect -odel <-*-= defines

the information model /ith regard to node management. It )resents a &ie/ of all the manageable resources in the node7 and all the )arameters and actions associated /ith these resources.

 -*s form a tree"hierarchy7 starting from the

root -anaged Element

  n -* re)resents a resource in the node7

either a )hysical resource such as a )lug"in unit7 or a logical resource such as a soft/are )rogram or a )rotocol. Each -* has

)arameters associated /ith the resource7 called -* attributes.

  n -* can be configured by setting &alues

for the -* attributes.

 +ho/n belo/ is the attribute *)er+tate of the

(#6hys6ath(erm -*7 and the diagram on the right sho/s /here this -* fits in the -* tree.