03 04 RN33823EN16GLA0 McRNC User Interface

Nokia AcademymcRNC User Interface RN33823EN16GLA0 © Nokia Solutions and Networks 2015 Copyright and confidentiality The contents of this document are Feedback may be used in Nokia Solutions merchantability and fitness for a proprietary and confidential property of and Networks products and related particular purpose, are made in relation Nokia Solutions and Networks. This specifications or other documentation. to the accuracy, reliability or contents of document is provided subject to Accordingly, if the user of this document this document. NOKIA SOLUTIONS AND confidentiality obligations of the gives Nokia Solutions and Networks NETWORKS SHALL NOT BE RESPONSIBLE applicable agreement(s). feedback on the contents of this IN ANY EVENT FOR ERRORS IN THIS document, Nokia Solutions and Networks DOCUMENT or for any loss of data or This document is intended for use of may freely use, disclose, reproduce, income or any special, incidental, Nokia Solutions and Networks customers license, distribute and otherwise consequential, indirect or direct damages and collaborators only for the purpose commercialize the feedback in any Nokia howsoever caused, that might arise from for which this document is submitted by Solutions and Networks product, the use of this document or any Nokia Solutions and Networks. No part of technology, service, specification or contents of this document. this document may be reproduced or other documentation. made available to the public or to any This document and the product(s) it third party in any form or means without Nokia Solutions and Networks operates a describes are protected by copyright the prior written permission of Nokia policy of ongoing development. Nokia according to the applicable laws. Solutions and Networks. This document Solutions and Networks reserves the is to be used by properly trained right to make changes and improvements Nokia is a registered trademark of Nokia professional personnel. Any use of the to any of the products and/or services Corporation. Other product and company contents in this document is limited described in this document or withdraw names mentioned herein may be strictly to the use(s) specifically created this document at any time without prior trademarks or trade names of their in the applicable agreement(s) under notice. respective owners. which the document is submitted. The user of this document may voluntarily The contents of this document are © Nokia Solutions and Networks 2015 provide suggestions, comments or other provided "as is". Except as required by feedback to Nokia Solutions and applicable law, no warranties of any kind, Networks in respect of the contents of either express or implied, including, but this document ("Feedback"). Such not limited to, the implied warranties of 2 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 mcRNC User Interface SCLI short reference (fsclish) Alarm handling via fsclish Useful commands Saving and restoring configuration Adding user 3 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 . and monitoring • Shell for SCLI in mcRNC is fsclish • Browse available commands in a command.SCLI short reference (1/6) • mcRNC uses Structured Command Line Interface (SCLI) • For configuration. use command auto completion. syntax tree view. administration. 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 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 . [MX] .[OX] .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] .to return to upper level command .Optional and default values are meaningless .to quit long text output .exit . leaving rest optional .Out of the displayed parameters only one can be used with the top level command at a time.set config-mode on – to acquire a configuration lock against parallel configuration management 5 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 .[X] .q .All mandatory parameters must be used in the command and can have a default value . 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 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 . 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 • Command:fsclish –f <file> run SCLI batch file • Interrupting command execution • Graceful interruption Ctrl-C • Forced interruption Ctrl-C-Ctrl-Z 7 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 . SCLI short reference (5/6) • Top level <operation> commands • add • reset • cmdtree • restore • commit • rollback • delete • save • exit • set • help • shell • history • show • initialise • start • quit • stop • refresh 8 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 . SCLI short reference (6/6) • Some top level <domain> commands • alarm • networking • app-parameter • networking-service • backup • radio-network • cmf • restore • config • routing • config-mode • security • file • signaling • hardware • snapshot • has • stats • license • sw-manage • log • symptom-report • troubleshooting • networking • user-management • networking-service 9 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 . 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 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 . fsFragmentId= Nodes. fsClusterId=ClusterRoot Identif appl.fsFragmentId=Nodes.fsFragmentId=HA. 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 . addl.fshaRecoveryUnitName= FSNetworkManagerServer. addl.ETHERNET LINK FAILURE Managed object : fsipHostName=EIPU-1. fsClusterId=ClusterRoot Severity : 4 (minor) Cleared : no Clearing : automatic Acknowledged : no Ack. info : ethsfp12_r1 Appl. info : Link down -------------------------------------------------------------------------------- 11 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 .fsFragmentId=HA. time : N/A Alarm time : 2013-11-06 16:30:16:000 CST Event type : x5 (equipment) Application : fshaProcessInstanceName=NetworkManager. user ID : N/A Ack.fsipHostName=EIPU-1. 4 – minor .5 – warning .1 – indeterminate . Alarm handling via fsclish (3/3) • Active alarms show alarm active • Filter active alarm based on severity • Severity levels .3 – major .6 – cleared show alarm active filter-by severity 2 • Alarm history show alarm history show alarm history-count • Clearing alarm set alarm clear alarm-id <alarm-id> 12 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 .2 – critical . Unit status • Display the working and standby units • ilclifunit –u (Linux command line) • show has functional-unit unit-info (fsclish version) • To see how the functional units as distributed over the octeons on each node of a BCN box • hwcli (Linux command line) • show hardware state list (fsclish version) • Display the system status • show tools system-status brief list • show tools system-status detailed list 13 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 . 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 14 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 .SCLI Checking or setting state of Managed Objects (Nodes and Recovery Groups) can be done inside fsclish.Managed Objects commands . Managed Objects commands . --help (prints information screen of the command) • -s.Linux command (1/2) • Equivalent command fshascli to check or set state of Managed Objects. --lock • -u. --unlock • -r. --shutdown • -w. --restart • -X. --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 / 15 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 . --state • -l. Some of the options are: • -h. --switchover • -W. Linux command (2/2) • State of the recovery groups. 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*" 16 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 . recovery units and hardware units can be monitored in table format using fshascli --tab command.Managed Objects commands . Software version To see the SW version • fsswcli –c (Linux command line) • show sw-manage current all (fsclish version) 17 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 . Saving the configuration in fsclish This operation has to performed on CFPU in fsclish daemon. But software build (using sw-manage app-sw-mgmt operations) is now the preferred way to manage different configurations. Note: Other commands for snapshot exists. use save snapshot Unsave configurations may be lost after RNC restarts. 18 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 . To save the configuration. _nokfsuifullbash. set user-management passwd set-user-passwd user <username> • Groups commonly used: _nokfsuimanage. Create an account using SCLI commands • Enter fsclish daemon. _nokfsuivendoradmin. _nokfsuiseclog. • Add user and assign to groups. _nokfsuiusbmanage 19 RN33823EN16GLA0 © Nokia Solutions and Networks 2015 . _nokfsuifsclishroot. _nokfsuilog. add user-management user <username> primary-group <user-group> secondary-groups <user-group2> • Set the password for the newly created user. _nokfsuilimitedbash • One or more groups to be used if more access is required: _nokfsuiwheel. _nokfsuifiletransfer. _nokfsuimonitor.