RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.mcRNC User Interface2 RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.Nokia Solutions and Networks AcademyLegal noticeIntellectual Property RightsAll 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.3 RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.mcRNC User InterfaceSCLI short reference (fsclish)Alarm handling via fsclish Alarm handling via zscripts Useful commandsSaving and restoring configurationAdding user4 RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.SCLI short reference (1/6)mcRNC uses Structured Command Line Interface (SCLI) For configuration, administration, and monitoringShell for SCLI in mcRNC is fsclish Browse available commands in a command, syntax tree view, use command auto completion, and access context sensitive helpStored as a tree of commands Command to display command tree is cmdtree Follow command tree branches by pressing tab buttonThe generic syntax of SCLI is a top level command that describes the type of operation is the next level command defined by SCLI modules The includes the parameters for top level commands5 RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.SCLI short reference (2/6)Pressing tab key shows the available parameters3 types of parameters Executable parameterdenoted 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 meaninglessexit - to return to upper level commandq - to quit long text outputset config-mode on to acquire a configuration lock against parallel configuration management6 RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.SCLI short reference (3/6)fsclish modes Interactive mode Non interactive mode Single command mode Batch modeInteractive 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 usersSingle command mode Only one command in the command line Command: fsclish c single command7 RN33823EN40GLA012014 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 c single command An unused persistent session will expire after 1 hour of idle time Command:fsclish r to clear the persistent session Interrupting command execution Graceful interruption Ctrl-C Forced interruption Ctrl-C-Ctrl-Z8 RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.SCLI short reference (5/6)Top level commands add cmdtree commit delete exit generate help history initialise list load quit refresh reset restore rollback save set shell show start stop unset9 RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.SCLI short reference (6/6)Some top level commands alarm app-parameter backup built-in cluster config config-mode directory file hardware has license log networking networking-service radio-network restore routing security signaling snapshot stats sw-manage symptom-report troubleshooting user-management10 RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.Alarm handling via fsclish (1/3) Operation command -> show Top leveldomain commands -> alarm SSH to active CFPU unit Enter fsclish show alarm 11 RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.Alarm handling via fsclish (2/3)Alarm print out via fsclishroot@CFPU-0 [RNC-602] > show alarm active CFPU-0@RNC-602[2013-11-07 13:53:03 +0800]Alarms: List of AlarmsAlarm ID : 30740Specific problem : 70164 - ETHERNET LINK FAILUREManaged object : fsipHostName=EIPU-1,fsFragmentId=Nodes,fsFragmentId=HA,fsClusterId=ClusterRootSeverity : 4 (minor)Cleared: noClearing : automaticAcknowledged : noAck. user ID : N/AAck. time: N/AAlarm time : 2013-11-06 16:30:16:000 CSTEvent type : x5 (equipment)Application: fshaProcessInstanceName=NetworkManager,fshaRecoveryUnitName=FSNetworkManagerServer,fsipHostName=EIPU-1,fsFragmentId=Nodes,fsFragmentId=HA, fsClusterId=ClusterRootIdentif appl. addl. info : ethsfp12_r1Appl. addl. info : Link down--------------------------------------------------------------------------------12 RN33823EN40GLA012014 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 severity2Alarm history show alarm history show alarm history-count13 RN33823EN40GLA012014 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 hUsage: zaho [ -h | --help | -a | --alarms | -p | --alarmhistory ][ -x | --alarmx | -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 alarmsExample: zaho -a: prints all active alarmszaho -ax 12345 : prints all 12345 alarms from active alarmszaho -ps : prints summary about alarm history14 RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.Alarm handling via zscripts (2/2)To print all alarms using zaho execute:# zaho -aTo print a specific alarms using zaho execute (example):# zaho -ax 2518RNC-5 Please wait, processing...Mon Feb 11 21:01:55 CET 2013Alarm '2518' of Active Alarms [Mon Feb 11 21:01:55 CET 2013]:Alarm ID,Time...... 1406 2013-01-23 12:46:53:095 CETSpecific Problem... 2518 NO VALID FALLBACK COPY FOR DEFAULT PACKAGESeverity,Event..... **Major(3) communicationsAlarm(x2)ManagedObject.ID... /ClusterRoot/HA/Nodes/CFPU-0/QNOMUServer-0Application ID..... /CFPU-0/QNOMUServer-0/IL_SokeriIAppl Addit. Info.. 4Appl Addit. Info...15 RN33823EN40GLA012014 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-infoTo see how the functional units as distributed over the octeons on each node of a BCN box hwcli16 RN33823EN40GLA012014 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-1Lock 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-0To switchover /SSH to a different CFPU set has switchover force managed-object /SSH17 RN33823EN40GLA012014 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-switchoverLock a functional unit for example CFPU-1 fshascli -l /CFPU-1Lock 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 /18 RN33823EN40GLA012014 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 groupstates)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 all19 RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.Saving and restoring configuration in fsclishThese operations have to performed on CFPU in fsclish daemon.To list existing configurations:show snapshot listTo query startup configuration:show snapshot current-startup To save the configuration, use:save snapshotTo save the configuration under a different name, use:save snapshot config-name To save the configuration as active one after startup:save snapshot startup config-name To restore a specific configuration:restore snapshot To set a specific configuration as startup:set snapshot startup Note: Software build (using sw-manage app-sw-management operations) is now the preferred way to manage different configurations.20 RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.Create an SSH client account using SCLI commandsEnter fsclish daemon.Add a user group.add user-management group Add a user to this group.add user-management user primary-group

Create a password for the newly created user.set user-management passwd set-user-passwd user

Assign permission to this group.add user-management group-to-permission gid permid fsclishAllowSFTPadd user-management group-to-permission gid permid fsclishAllowSCPAssign secondary group to user (required for some permissions)set user-management user secondary-groups _nokfsuiftp 21 RN33823EN40GLA012014 Nokia Solutions and Networks. All rights reserved.Module Version control/Version Date Status ContactV1.020.Feb.2012 Prepared for new version of RN3382Marek JanickiV1.1 29.March Added user account creationMarek JanickiV2.0 19 Nov 2013 Update to RU40 Kriang Lerdsuwanakij