mcRNC User Interface

RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

 Nokia Solutions and Networks Academy

Legal notice

Intellectual Property Rights

All copyrights and intellectual property rights for Nokia Solutions and Networks
training documentation, product documentation and slide presentation material, all of
which are forthwith known as Nokia Solutions and Networks training material, are the
exclusive property of Nokia Solutions and Networks. Nokia Solutions and Networks
owns the rights to copying, modification, translation, adaptation or derivatives
including any improvements or developments. Nokia Solutions and Networks has the
sole right to copy, distribute, amend, modify, develop, license, sublicense, sell,
transfer and assign the Nokia Solutions and Networks training material. Individuals
can use the Nokia Solutions and Networks training material for their own personal
self-development only, those same individuals cannot subsequently pass on that
same Intellectual Property to others without the prior written agreement of Nokia
Solutions and Networks. The Nokia Solutions and Networks training material cannot
be used outside of an agreed Nokia Solutions and Networks training session for
development of groups without the prior written agreement of Nokia Solutions and
Networks.

2 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

mcRNC User Interface

SCLI short reference (fsclish)

Alarm handling via fsclish

Alarm handling via zscripts

Useful commands

Saving and restoring configuration

Adding user

3 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

SCLI short reference (1/6)

•mcRNC uses Structured Command Line Interface (SCLI)

• For configuration, administration, and monitoring
•Shell for SCLI in mcRNC is fsclish
• Browse available commands in a command, syntax tree view, use
command auto completion, and access context sensitive help
•Stored as a tree of commands
• Command to display command tree is cmdtree
• Follow command tree branches by pressing tab button
•The generic syntax of SCLI
• <operation> <domain> <rest of command>
• <operation> is a top level command that describes the type of
operation
• <domain> is the next level command defined by SCLI modules
• The <rest of the command> includes the parameters for top level
commands
4 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.
SCLI short reference (2/6)

•Pressing tab key shows the available parameters

•3 types of parameters
• Executable parameter denoted with symbol [X]
• Mandatory parameter denoted with symbol [MX]
• Optional parameter denoted with symbol [OX]
[X] - Out of the displayed parameters only one can be used with the top
level command at a time, leaving rest optional
[MX] - All mandatory parameters must be used in the command and can
have a default value
[OX] - Optional and default values are meaningless
exit - to return to upper level command
q - to quit long text output
set config-mode on – to acquire a configuration lock against parallel
configuration management

5 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

SCLI short reference (3/6)

•fsclish modes
• Interactive mode
• Non interactive mode
• Single command mode
• Batch mode
Interactive mode
• By typing fsclish in a node of mcRNC
• provides basic command line editing functionalities and
access to various commands implemented both as part of
the framework and by SCLI framework users
Single command mode
• Only one command in the command line
• Command: fsclish –c “single command”
6 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.
SCLI short reference (4/6)

• Batch mode
• The persistent session feature helps to execute multiple single
commands in the same SCLI session
• Useful where the state of preceding commands affect the following
commands
• Command:fsclish –p<session-id> –c ‘single command’
• An unused persistent session will expire after 1 hour of idle time
• Command:fsclish –r<session-id> to clear the persistent session
• Interrupting command execution
• Graceful interruption
• Ctrl-C
• Forced interruption
• Ctrl-C-Ctrl-Z

7 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

SCLI short reference (5/6)

•Top level <operation> commands

add reset
cmdtree restore
commit rollback
delete save
exit set
generate shell
help show
history start
initialise stop
list unset
load
quit
refresh

8 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

SCLI short reference (6/6)

•Some top level <domain> commands

alarm networking
app-parameter networking-service
backup radio-network
built-in restore
cluster routing
config security
config-mode signaling
directory snapshot
file stats
hardware sw-manage
has symptom-report
license troubleshooting
log user-management

9 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

Alarm handling via fsclish (1/3)

• Operation command -> show

• Top level domain commands -> alarm

• SSH to active CFPU unit

• Enter fsclish

• show alarm <rest of command>

10 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

Alarm handling via fsclish (2/3)

Alarm print out via fsclish

root@CFPU-0 [RNC-602] > show alarm active
CFPU-0@RNC-602 [2013-11-07 13:53:03 +0800]
Alarms: List of Alarms

Alarm ID : 30740
Specific problem : 70164 - ETHERNET LINK FAILURE
Managed object : fsipHostName=EIPU-1,fsFragmentId=Nodes,fsFragmentId=HA,
fsClusterId=ClusterRoot
Severity : 4 (minor)
Cleared : no
Clearing : automatic
Acknowledged : no
Ack. user ID : N/A
Ack. time : N/A
Alarm time : 2013-11-06 16:30:16:000 CST
Event type : x5 (equipment)
Application : fshaProcessInstanceName=NetworkManager,fshaRecoveryUnitName=
FSNetworkManagerServer,fsipHostName=EIPU-1,fsFragmentId=
Nodes,fsFragmentId=HA, fsClusterId=ClusterRoot
Identif appl. addl. info : ethsfp12_r1
Appl. addl. info : Link down

--------------------------------------------------------------------------------

11 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

Alarm handling via fsclish (3/3)

•Active alarms
show alarm active
• Filter active alarm based on severity
Severity levels
1 – indeterminate
2 – critical
3 – major
4 – minor
5 – warning
6 – cleared
show alarm active filter-by severity 2
Alarm history
show alarm history
show alarm history-count

12 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

Alarm handling via zscripts (1/2)

•Alarm handling zscript is zaho.

•The option of zaho script is shown below:
# zaho –h

Usage: zaho [ -h | --help | -a | --alarms | -p | --alarmhistory ][ -x <number> |

--alarmx <number> | -s | --summary ]

Obligatory parameters:
-h | --help : this help
-a | --alarms : active alarms
-x | --alarmx : shows alarms with certain alarm number
-s | --summary : summary of the alarms

Example: zaho -a : prints all active alarms

zaho -ax 12345 : prints all 12345 alarms from active alarms
zaho -ps : prints summary about alarm history

13 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

Alarm handling via zscripts (2/2)

•To print all alarms using zaho execute:

# zaho -a
•To print a specific alarms using zaho execute (example):
# zaho -ax 2518

RNC-5 Please wait, processing... Mon Feb 11 21:01:55 CET 2013

Alarm '2518' of Active Alarms [Mon Feb 11 21:01:55 CET 2013]:

Alarm ID,Time...... 1406 2013-01-23 12:46:53:095 CET

Specific Problem... 2518 NO VALID FALLBACK COPY FOR DEFAULT PACKAGE
Severity,Event..... ** Major(3) communicationsAlarm(x2)
ManagedObject.ID... /ClusterRoot/HA/Nodes/CFPU-0/QNOMUServer-0
Application ID..... /CFPU-0/QNOMUServer-0/IL_Sokeri
IAppl Addit. Info.. 4
Appl Addit. Info...

14 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

Useful commands (1/4)

•Display the working and standby units

• ilclifunit –u
• (fsclish equivalent)
show has functional-unit unit-info
•To see how the functional units as distributed over the octeons
on each node of a BCN box
• hwcli

15 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

Useful commands (2/4)
Checking or setting state of Managed Objects (Nodes and Recovery Groups) can be done inside
fsclish. Below are command examples:

Checking state of High Availability Services

• show has summary
• show has state managed-object /*PU*
• show has state managed-object /CFPU*/QND*
• show has filter node state managed-object /*
• show has filter rg state managed-object /*

Lock a functional unit for example CFPU-1

• set has lock managed-object /CFPU-1
Lock all recovery groups with QN
• set has lock managed-object /QN*

To unlock all recovery groups with QN

• set has unlock managed-object /QN*

To restart EIPU-0
• set has restart managed-object /EIPU-0

To switchover /SSH to a different CFPU

• set has switchover force managed-object /SSH
16 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.
Useful commands (3/4)
Equivalent command fshascli to check or set state of Managed Objects. Some of the options
are:
• -h, --help (prints information screen of the command)
• -s, --state
• -l, --lock
• -u, --unlock
• -r, --restart
• -X, --shutdown
• -w, --switchover
• -W, --forced-switchover
Lock a functional unit for example CFPU-1
• fshascli -l /CFPU-1
Lock all recovery groups with QN
• fshascli -l "/QN*"
To unlock all recovery groups with QN
• fshascli -u "/QN*"
•To see the status of all recovery groups with QND in CFPU-0 and CFPU-1
• fshascli -s "/CFPU*/QND*"
To reset the whole mcRNC
• fshascli -r /

17 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

Useful commands (4/4)
•State of the recovery groups, recovery units and hardware units can be
monitored using fshascli --tab command.
fshascli --tab "/*PU*" (prints node states)
fshascli --tab "/*" (prints node and recovery group
states)
fshascli --tab "/*/*" (prints recovery unit states)

•To see the status of all recovery group with QN*

• fshascli --tab "/QN*"

•To see the SW version

• fsswcli –c
• (fsclish equivalent)
show sw-manage current all

18 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

Saving and restoring configuration in fsclish
These operations have to performed on CFPU in fsclish daemon.
•To list existing configurations:
show snapshot list
•To query startup configuration:
show snapshot current-startup
•To save the configuration, use:
save snapshot
•To save the configuration under a different name, use:
save snapshot config-name <name>
•To save the configuration as active one after startup:
save snapshot startup config-name <name>
•To restore a specific configuration:
restore snapshot <name>
•To set a specific configuration as startup:
set snapshot startup <name>
Note: Software build (using sw-manage app-sw-management operations) is now
the preferred way to manage different configurations.
19 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.
Create an SSH client account using SCLI
commands
Enter fsclish daemon.
•Add a user group.
add user-management group <usergroup>
•Add a user to this group.
add user-management user <username> primary-group
<usergroup>
•Create a password for the newly created user.
set user-management passwd set-user-passwd user
<username>
•Assign permission to this group.
add user-management group-to-permission gid <usergroup>
permid fsclishAllowSFTP
add user-management group-to-permission gid <usergroup>
permid fsclishAllowSCP
•Assign secondary group to user (required for some permissions)
set user-management user <username> secondary-groups
_nokfsuiftp

20 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.

 Module Version control

Version Date Status Contact

V1.0 20.Feb.2012 Prepared for new version Marek Janicki

of RN3382
V1.1 29.March Added user account Marek Janicki
creation
V2.0 19 Nov 2013 Update to RU40 Kriang Lerdsuwanakij

/ 21 RN33823EN40GLA01 ©2014 Nokia Solutions and Networks. All rights reserved.