Kairos02 Cli Oam

Kapsch CarrierCom
KAIROS CLI Command Line Interface

V 2015.1
|1
Kapsch CarrierCom
Change History
Version Date Title Responsible
2015.1 2015-07-07 Some smaller changes for 2015.1 Thomas SZEPANNEK
Document identifier: PE/TRD/APP/029549 V01/EN
Document status: Preliminary
Document version: 2015.1
Feb.2015 | KAIROS GSM-R Training

09 July 2015 | 2
Kapsch CarrierCom
KAIROS01 CLI Command Line Interface
Part 1 ￭ KAIROS01 R4 and Hardware Overview
Part 2 ￭ Login Procedures ……………………………………… 4

￭ Command Line Interface (CLI) & Command structure 9
￭ CLI Common Tasks ….……………………………… 14
￭ Service Units ….……………………………………… 24
￭ IP and Ethernet Interfaces …………………………... 38
￭ Fault Management & Platform Maintenance …….. 49
￭ Software ..…………………………………………… 73
￭ SS7 Datafill & Signaling Service Groups ……….. 84
Part 3 ￭ SOS Agent Basics
Feb.2015 | KAIROS GSM-R Training | 3

Kapsch CarrierCom
Course Objectives
In this part, you will learn how to:
￭ Login to the KAIROS platform
￭ Identify and use the Command Line Interface of the KAIROS platform.
￭ Perform basic maintenance tasks
￭ Understand basic configuration parameters
￭ Login to SOS CallAgents

Kapsch CarrierCom
Login Procedures
02.12.2009 | Titel der Präsentation Untertitel der Präsentation | 5

Kapsch CarrierCom
Types of Access
KAIROS SOS Appl Linux

CBM 0
CLI CBM 1
CBM
PC
Active IP Address: 10.x.x.129 (in OAM VLAN)
KXA [SSG]
KXA [SSG]
KSX (10G)
KSX (10G)
KPA [CA]
KPA [CA]
Filler
Filler
Filler
Filler
Filler
Filler
-
KSC
KSC
CS LAN KSC Data Manager 0 1 2 3 4 5 6 7 8 9 1011121314
Fan Fan Fan Fan Fan
10.x.x.130
KSC Data Manager 1
10.x.x.131

Kapsch CarrierCom
KAIROS OAM Possibilities
SOLARIS:>
CBMMTC
CBM
BILLMTC
Telnet CORE CBM Appl.
CBM 0
CLI: SSPFS
CBM 1 For MSC
Unix (Solaris)
SOLARIS:> Dataserver For HLR
ORACLE
Data Server
SosAgent HLR-PM
CI:
KXA [SSG]
KXA [SSG]
KSX (10G)
KSX (10G)
MAPCI; MTC Oracle 10G
KPA [CA]
KPA [CA]
Filler
Filler
Filler
Filler
Filler
Filler
-
KSC
KSC
Tables MSC
Logutil
Unix (Solaris)
1 2 3 4 5 6 7 8 9 1011121314
Fan Fan Fan Fan Fan
ATCA KAIROS
KPA [HLR_SG]
KPA [HLR_SG]
KAIROS CLI:>
KXA [SSG]
KXA [SSG]
KSX (10G)
KSX (10G)
SOS
KPA [CA]
KPA [CA]
Filler
Filler
Filler
Filler
-
KSC
KSC
HLR
CLI
1 2 3 4 5 6 7 8 9 1011121314
Fan Fa Fa Fan Fan
Linux NCGL n n
Linux - SSH:

Kapsch CarrierCom
CLI login possibilities
ssh session onto active KSC Datamanager
SOS application level

SosAgent mscca login MSC Login to SosAgents on MSC-S mtc_xx
SosAgent mrf login MRF

SosAgent hlr login HLR_SG1 Login to SosAgents on HLR mtc_xx
CLI:> Other CLI Commands / KAIROS level

Linux level
shell
Login to Linux

Kapsch CarrierCom
Login from C-NMS
Selected Node
Open ssh window for Login (Java Based)

Kapsch CarrierCom
CLI Interface

Kapsch CarrierCom
CLI Session Welcome Screen
*******************************************************
Welcome to KAIROS
*******************************************************
Frame: 0
Shelf: 0
Slot: 7
Subslot: 0
PEC: KCRY80Bx_ksc
ARCH: x86_64
*******************************************************
Buildversion: 1.0.0.142699.0
Baseline: kcgl100_aa_14.26.5.0_2014wk26
*******************************************************
Last login: Thu Sep 25 11:51:46 CEST 2014 from 47.164.64.183 on pts/0

Kapsch CarrierCom
Login to CLI Session
￭ Login onto active KSC Datamanager to CLI Session

￭ CLI >
￭ Onproduct help ?
￭ Repeat of previous command ← ↑ →
￭ Abbreviated command entry TAB detailed = det = d
￭ Example for Abbreviated command:

cli>hardware app-blade show all detailed = ha ap sh a d

Kapsch CarrierCom
CLI Commands KAIROS 1.0 (NSS 22)
cli>?
modes description
admin system administration
aim application inventory management
cli-session customize CLI session
exit exit CLI session EXITs the CLI Session
firmware firmware upgrade entity
fm fault management commands
hardware hardware inventory and mtce
interfaces interfaces commands
netsec NGW firewall policy configuration
networking networking services Login to
pm performance management commands MSC-S: MSC
routing NGW routing configuration HLR: MRF, HLR_SGx
security security commands
shell switch to Linux shell
software software management commands
SosAgent Entities and commands relating to SOS agents
ssg ssg commands
storage storage system administration
system system identity
time administer time of day

Kapsch CarrierCom
Command structure examples
cli>hardware app-blade show 0 0 10 0
Title
Prerequisite User or system
Steps
defined
cli>hardware frame show all
User or system
Title defined
Steps
Prerequisite

Kapsch CarrierCom
CLI Common Tasks

Kapsch CarrierCom
Show/Modify cli-session parameters | exit the session
cli-session
cli>cli-session show all
command-prompting verbose-level screen-width timeout
------------------ --------------- ------------- -----------
service-impacting brief 79 20
cli>cli-session modify timeout
timeout integer (1-1410), set the timeout of the cli in min
exit
Exits the CLI Session

Kapsch CarrierCom
Show system name | time
system
system show all
system-key system-id user-label description
---------- --------- ------------------ -------------------------
1 1 KAIROS4600 default-description
time
cli>time local-time show all
current-time
------------------------------
Mon Aug 9 13:41:53 2010

Kapsch CarrierCom
Admin commands for remote-hosts (e.g. Backup server)
cli>admin commands
bulk-input bulk-input commands
remote-hosts remote-hosts commands
cli>admin remote-hosts
add, delete, modify, show, password-change,
cli>admin remote-hosts show all
rh-name remote-hostname remote-userid
-------------------- -------------------- -------------
backupserver 10.236.133.11 hlrbkp

Kapsch CarrierCom
Security user commands
￭user account cli>security user-account show all

￭ Users & Roles user-id role account-state
￭ admin -------------------- -------------------- -------------
gsm_e SecAdmin unlocked
￭ secadmin mtc SecAdmin unlocked
root SecAdmin unlocked
￭ basic train0 SecAdmin locked
train1 Admin locked
￭user password train2 Admin locked
train3 Admin locked
train_ext Basic locked
￭user privclass
￭ Command classes 0-31, all
￭ Command classes are transfered to SOSAgent users
Only users with the role „SecAdmin“ are allowed to add/mod users

Kapsch CarrierCom
Enter the Linux shell
cli>shell
mtc@ksc-base-unit0:~$ pwd
/home/mtc
mtc@ksc-base-unit0:~$ who Show logged in users

mtc
train0
train1
mtc@ksc-base-unit0:~$ exit Exit to CLI Level

logout
cli>
telnet sessions to separate Linux shells

Kapsch CarrierCom
Show hardware objects (Blade, Disk, Fan, Power, SAM)
cli>hardware ?
hardware inventory and mtce
app-blade application blade
disk disk on a storage blade
frame frame
ftm fan tray module
pem power entry module
port port commands
prpmc Processor PCI mezzanine card
rtm rear transition module
sam shelf and alarm manager
shelf shelf
Actions:
add, modify, delete, show
Additional actions for app-blades:
abort, activate, deactivate, indicate,
offline, online, unlock, lock, reset, swact, test

Kapsch CarrierCom
Show hardware app-blade
cli>hardware app-blade show all [cli>ha ap sho al]
frame shelf slot inv-pec asgn-pec adm-state opr-state avail-status

----- ----- ---- --------- --------- --------- --------- ------------
0 0 1 KCRY80BA KCRY80BA unlocked enabled
0 0 2 KCRY85AA KCRY85AA unlocked enabled
cli>hardware ftm show al

frame shelf slot inv-pec asgn-pec opr-state avail-status
----- ----- ---- --------- --------- --------- ------------
0 0 1 KCRY78AB KCRY78AB enabled
0 0 2 KCRY78AA KCRY78AA enabled

Kapsch CarrierCom
Show Hardware details
cli>hardware app-blade show 0 0 3 0 det [= detailed]
frame = 0
shelf = 0
slot = 3
sub-slot = 0
user-label = default-user-label
description = default-description
assigned-pec = KCRY80BA
inventory-pec = KCRY80BA
admin-state = unlocked
operational-state = enabled
availability-status =
activity-state = inactive
offline = no… …

Kapsch CarrierCom
Filter capabilities
where filter = != < >

for non-numerical chars starts-with | ends with | contains | does-not-contain
Example: … where user-account-id contains train
cli>hardware app-blade sho all where assigned-pec = KCRY82AA

----- ----- ---- --------- --------- --------- ---------
0 0 9 KCRY82AA KCRY82AA locked disabled offduty
cli>ha app sho all where assigned-pec = KCRY82AA and admin-state = unlocked
----- ----- ---- --------- --------- --------- --------- ---------------

Kapsch CarrierCom
Service Units

Kapsch CarrierCom
CLI AIM Commands
aim
service-group service-instance service-unit si-assignment
cli>aim ?
application inventory management
service-group service-group commands
service-instance service-instance commands
service-unit service-unit commands
si-assignment si-assignment commands

Kapsch CarrierCom
aim application inventory management
cli>aim application inventory management
service-group service-group commands

Service Group
service-instance service-instance commands
S-Instance 0 SI x
service-unit service-unit commands
si-assignment si-assignment commands

S-Unit SU SU SU
1 2 x y
service-unit commands
show, add, modify, delete,
jam, unjam, load, unload,
lock, unlock, swact, shutdown APP- APP-

BLADE BLADE
All Service Units should have TWO entities on different blades, except the SSGs (max. 8)

Kapsch CarrierCom
Service Units on Application Blades, MSC example
1 2 3 4 5 6 7 8 9 10 11 12 13 14
KXA KPA KSC KXA KPA KSX KSC KSX
SSG CA SSG CA
DHCP DHCP
DsIpMgr DsIpMgr
GAPS GAPS
SOS Agent MSC UNIT0
SOS Agent MSC UNIT1

IPADDR IPADDR
Ngw Ngw
Management Management
shelfmtc_shelf0 _0
shelfmtc_shelf0 _1
PM PM
Central Central
Solid Solid
Wd Wd
USMMGR USMMGR
oamFM oamFM
SSG2
SSG1
Server Server
Storage Storage
Service Service
sysmtc sysmtc

Kapsch CarrierCom
Service Units on Application Blades, Active & Standby
1 2 3 4 5 6 7 8 9 10 11 12 13 14
KXA KPA KSC KXA KPA KSX KSC KSX
SSG CA SSG CA
DHCP DHCP
DsIpMgr DsIpMgr
GAPS GAPS
SOS Agent MSC UNIT0
SOS Agent MSC UNIT1

IPADDR IPADDR
Ngw Ngw
shelfmtc_shelf0 _0
shelfmtc_shelf0 _1
PM PM
Central Central
Solid Solid
Wd Wd
USMMGR USMMGR
oamFM oamFM
SSG2
SSG1
Server Server
Service Units
Storage Storage
ACTIVE
Service Service
sysmtc sysmtc Standby

Kapsch CarrierCom
Service Units on Application Blades, HLR example
1 2 3 4 5 6 7 8 9 10 11 12 13 14
KXA KPA KSC KXA KPA KSX KSC KPA KSX KPA
SSG MRF SSG MRF HLR HLR
DHCP DHCP
DS_Proxy DS_Proxy
DsIpMgr DsIpMgr
MRF OAM MRF_OAM HLR_OAM HLR_OAM
Agent Agent Agent Agent
GAPS GAPS
SOS Agent MRF UNIT0
SOS Agent MRF UNIT1

IPADDR IPADDR
SOS Agent HLR_SG1 UNIT0
SOS Agent HLR_SG1 UNIT1

Ngw Ngw
shelfmtc_shelf0 _0
shelfmtc_shelf0 _1
PM PM
Central Central
Solid Solid
Wd Wd
USMMGR USMMGR
oamFM oamFM
SSG2
SSG1
Server Server
Storage Storage
Service Service
sysmtc sysmtc

Kapsch CarrierCom
Example: Steps for installing and provisioning Call Agent hardware
1.Insert blades into correct slots (e.g. 2 & 5)

OOS
2 5
￭ Self testing Mode, LED solid blue IS
H/S
KPA KPA
￭ Flashing LED, communication with Shelf Manager CA CA
OOS
When blue LED turns off, blade is active IS
SOS Agent MSC UNIT0
SOS Agent MSC UNIT1

￭ H/S
2.Unlock the blade in hardware level MSC Call Agent

Service Group
3.Verify installation (hardware level)
4.Provisioning the datacallp subnet (networking level)
5.Provisioning an MSC Call Agent service group

and service units (aim level)
6.Unlock Service Units (AIM Level)

OOS OOS
IS IS
H/S H/S

Kapsch CarrierCom
Show the SosAgent Service Units
cli>aim service-unit show MSC detail
sg-name = MSC
2 5
su-number = 0
KPA KPA
admin-state = unlocked
presence-state = instantiated CA CA
readiness-state = in-service ACTIVE
SOS Agent MSC UNIT0
SOS Agent MSC UNIT1

jam-state = unjammed
frame = 0
shelf = 0
slot = 2
sub-slot = 0
sg-name = MSC
su-number = 1
admin-state = unlocked SYNC
presence-state = instantiated
readiness-state = in-service
jam-state = unjammed
frame = 0
Standby
shelf = 0
slot = 5 OOS
IS
OOS
IS
sub-slot = 0 H/S H/S

Kapsch CarrierCom
Sosagent = Combined Commands for SOS Application Blades
cli>sosAgent ?
Entities and commands relating to SOS agents
hlr hlr commands
mrf mrf commands
mscca mscca commands
mschlr mschlr commands
prsm prsm commands
tabsync Tabsync database entities and commands

Kapsch CarrierCom
MSC-S SosAgent mscca
cli>sosAgent mscca ?
mscca commands
add Used to provision a node.
delete Used to remove a node.
dpsync drop synchronization between the two units
imgtest run an image test on the inactive SOS instance
jam mscca jam command
load mscca load command
lock mscca lock command
login Login to SOS instance for a node.
niikey Enable or Disable the SOS image to boot as inactive
rex perform Routine EXercise on H/W and SOS image
show Display configuration and operational data {ALL | 'SG-Name'}
swact mscca swact command
sync synchronize the active and inactive units
unjam mscca unjam command
unload mscca unload command
unlock mscca unlock command
cli>SosAgent mscca login MSC

Kapsch CarrierCom
SosAgent mscca show all detailed
SG Name Active IRM Sync State App Admin State App Oper State
---------- ---------------- ------------ -------------------- --------
MSC 172.29.7.36 in-sync activated enabled
cli>sosAgent mscca show all det

Service Group Name = MSC
Service Group ID = 12
Niikey Flag = disabled
Active IRM = 172.29.7.36
Duplex for MSCCA,
MRF, HLR_SG
Redundancy Model = duplex
Application ID = 2005
mount-point1 = /opt/kapsch/ca/data/786432/sd00
mount-point2 = /opt/kapsch/ca/data/786432/sd01 Mount Points
mount-point3 = /opt/kapsch/ca/data/NODATA/
mount-point4 = /opt/kapsch/ca/data/upgrade/
Inactive IRM = 172.29.7.37
Sync State = in-sync
unit0-img-tested = NO
unit0-rex-tested = NO
unit1-img-tested = NO
unit1-rex-tested = YES

Kapsch CarrierCom
Login to Sosagents
MAPCI User is created automatically from CLI User with randomized number
￭ MSC-S
cli>sosAgent mscca login MSC
￭ HLR
cli>sosAgent mrf login MRF
cli>sosAgent hlr login HLR_SG1
Logging into: HLR_SG1 0
Connected to 13 0.
Attempting to log in as userid: mtc__23

Kapsch CarrierCom
SosAgent MAPCI Application
￭ Top Level CI commands
￭ Subsystems
￭ Table Editor
￭ Maintenance Levels
￭ File System Tools
￭ Logutil
￭ For more details see the „SOS Agents Basics“ Document

Kapsch CarrierCom
MAPCI Levels inside a SosAgent
IOD PM CCS Trks Ext APPL

. . . ... . .
MTC
0 Quit MTC:
2
3
4 SRSTATUS Output Area
5 BERP
6 CAPACITY Menu
7 Alarm Header
8 User-Name
9
10 Input Line
11 IOD
12
13 PM
14 CCS
15
16 Trks
17 Ext
18 APPL
MTC__43
Time 11:25 >

Kapsch CarrierCom
IP and Ethernet Interfaces

Kapsch CarrierCom
networking
cli>networking ?
￭ IP Addresses networking services
alias alias commands
dhcp dhcp commands
￭ DHCP Server ip ip commands
ipmgr-port-entry ipmgr-port-entry commands
pool pool commands
￭ IP Pools:
￭ Dataoam (External VLAN) dataOAM 172.29.7.0
defaultBase 172.24.x.x (fix)

￭ Basedefault (Internal Transport)
defaultData 172.25.x.x (fix)

￭ Datadefault (Internal Transport)
￭ Datacallp1 call processing processed by SSG1 dataCallP 172.29.7.32 DatacallP1 = SIG1
￭ DatacallP2 Backup Signaling network by SSG2 dataCallP2 172.29.64 DatacallP2 = SIG2
SSG External
￭ ssgext external WAN

Kapsch CarrierCom
KAIROS Internal connections
SIG1 SIG2 SIG2 SIG2

SIG1 SIG1
OAM
To IP routing switches OAM
dataOAM R R
Crossconnect Links
KSC-RTM KSC-RTM
STR STR KSX RTM
KSX
DATA FABRIC
KSX KSX
(L2 switch)
CHASSIS MIDPLANE (L2 switch)
BASE FABRIC
KSC KSC
DM SSG1 SSG2 CA DM
NGW 1+1 NGW
dataOAM Sig1 = DataCallp1 dataOAM

Sig2 = DataCallP2
Kapsch CarrierCom
Example: Datacallp addresses
cli>networking ip show datacallp
pool-name block ip-address client-id service

-------------- -------------- --------------- -------------- --------------
datacallp datacallp-g... 172.17.10.33 datacallp-g...

datacallp m3ua-ssgsg-... 172.17.10.40 m3ua-ssgsg-... None
datacallp m3ua-ssgsg-... 172.17.10.41 m3ua-ssgsg-... None
datacallp sca-msc-0-d... 172.17.10.36 sca-msc-0-d... None

Kapsch CarrierCom
IP interfaces
ETH Interfaces (physical interfaces, external WAN & shelf internal)

2xx NGW Interfaces on KSC (WAN and backplane)
3xx KSC Base interfaces to all slots
4xx KSC Data interface to all slots
AE Interfaces (aggregated ethernet interfaces, virtual)

6xx NGW internal Interfaces on KSC (routed via VRRP)
cli>interface eth show all

frame shelf slot sub-slot if-number adm-state opr-state avail-status
----- ----- ---- -------- --------- --------- --------- -------------
0 0 3 0 204 unlocked enabled
0 0 3 0 205 locked disabled dependency
0 0 6 0 302 unlocked disabled dependency

Kapsch CarrierCom
NGW Interfaces on KSC
ETH on RTM to backplane
AE 601 NGW Routing

Mechanism
AE on KSC
AE 602 AE 603 AE 604 AE
605 (in NGW functionality)
ETH to WAN on RTM
204 205 206 207

reserved
dataOAM SIG1 SIG2

Kapsch CarrierCom
IP routing on KSC (Slot 3 & 7): NGW functionality
cli>routing ?
NGW routing configuration
ngw-ipv4-interface ngw-ipv4-interface commands
ngw-ipv4-route-table ngw-ipv4-route-table commands
ngw-ipv4-static-route ngw-ipv4-static-route commands
ngw-router ngw-router commands
ngw-router-attributes ngw-router-attributes commands
ngw-vrrp-instance ngw-vrrp-instance commands
ngw-vrrp-tracking ngw-vrrp-tracking commands
ngw-wan-monitoring ngw-wan-monitoring commands

Kapsch CarrierCom
Routing mechanism on NGWs
cli>routing ngw-vrrp-tracking show all det
router-identifier = 1
vrrp-interface-number = 602
vrrp-identifier = 4
group-identifier = 2
interface-number = 601
interface-state = up
router-identifier = 1
vrrp-interface-number = 603
vrrp-identifier = 5
group-identifier = 2
interface-number = 601
interface-state = up

Kapsch CarrierCom
VRRP Router on both NGW
Data Fabric
Base Fabric
VRRP VRRP
Router 1 Router 2
MASTER BACKUP
204 205 206 207 204 205 206 207

OAM VLAN OAM SIG1 SIG2 OAM SIG1 SIG2
SIG1 VLAN

Kapsch CarrierCom
KAIROS Internal communication
SIG1 SIG1
SIG2 To IP routing switches SIG1
SIG2
OAM OAM
dataOAM R R
Crossconnect Links
KSC-RTM KSC-RTM
STR STR KSX RTM
KSX
DATA FABRIC
KSX KSX
(L2 switch)
CHASSIS MIDPLANE (L2 switch)
BASE FABRIC
KSC KSC
DM SSG SSG CA DM
NGW 1+1 NGW
Inter Switching Links (currently not in use)

Kapsch CarrierCom
Routing: check internal connections
cli>routing ngw-ipv4-interface show all

id ifnum interface-address mask ifstate
-- ----- ----------------- ---- -------
1 501 172.24.132.0 16 up
1 501 172.24.132.2 16 up
1 601 172.25.132.0 16 up
1 601 172.29.7.2 28 up
1 601 172.29.7.4 28 up
1 601 172.29.7.5 28 up
1 601 172.29.7.34 27 up
1 601 172.29.7.66 27 up
1 602 172.29.7.154 29 up
1 603 172.29.7.146 29 up
1 605 172.29.7.130 29 up
2 501 172.24.132.1 16 up
2 501 172.24.132.3 16 up
2 601 172.29.7.6 28 up
2 601 172.29.7.35 27 up

Kapsch CarrierCom
Fault Management & Platform Maintenance

Kapsch CarrierCom
Fault management
On Site Fault management:

￭ Visual alarm (chassis/blade) via LEDs; (see LED guide in Part 1)
￭ Audible alarm (chassis), Stop button
CLI Fault management:

￭ Active Alarm List (AAL): fm alarm
￭ Log Browser: fm log
￭ Size of Event Historical Log is configurable with minimum storage of 48 hours
￭ Capability of Interfacing and communicating with multiple destinations
(CLI, CarrierNMS)
￭ Fault localization
￭ Manual diagnostics to verify health of standby blades

Kapsch CarrierCom
CLI Fault Management Commands
fm
alarm log
cli>fm ?
fault management commands
alarm alarm commands
alarm-suppress alarm-suppress commands
log log commands
log-repository log-repository commands
log-suppress log-suppress commands
modeled-data modelled-data commands
seclog seclog commands
seclog-repository seclog-repository commands
syslog syslog commands
cli>fm

Kapsch CarrierCom
Displaying active customer alarms
￭ To display the list of all active alarms:

￭ Open a CLI session.
￭ Enter the following command line:
fm alarm show all [output-form]
￭ A list of active alarms is displayed.
￭ The system returns a cli> prompt.
￭ Note: Reports are available in three formats; brief, compact, or detailed.
cli>fm alarm show ?
all keyword, show all
location keyword, specify alarm location
name keyword, specify alarm name
severity keyword, specify alarm severity
cli>fm alarm show
Note: In order to abort the output use Ctrl-C

Kapsch CarrierCom
fm alarms
cli>alarm commands
clear force an alarm to clear
resync alarm resync command
show alarm show command
start start a real-time alarm feed
stop stop a real-time alarm feed
cli>fm alarm show all
1007 MtcAe 1302 alarm major

Aggregate Ethernet interface degraded
ae 0:0:3:0
/=/v=1/frame=0/shelf=0/slot=3/sub-slot=0/if-number=603
serverEid,0:0:3:0:10:1,entityType,20,instance,603
Aggregate ethernet interface is degraded.
Last Modified: 2014-10-06T20:20:23+02:00 930951

Kapsch CarrierCom
Anatomy of a KAIROS alarm
cli>fm alarm show all
Application-type-id alarm name alarm number event-class severity
description 2001 SSG 1300 alarm major

Path alarm
ref-entity-type path 0:0:1:0 location
/=/v=1/path-id=1/pathset-id=2
ref-entity-tag Last Modified: 2014-12-05T12:10:15-06:00 timestamp
This example illustrates a major alarm affecting path 1

of pathset 2 for the SSG blade located in slot 1.

Kapsch CarrierCom
Show alarm details
cli>fm alarm show application-type-id 15 det Details

Alarm-info:
name = AMF
number = 1300
alarm-id = 15-0-1-/=/v=1/sg-name=ssgSG--1-13
App-info:
application-name = AMF
application-type-id = 15
application-instance-id = 1
Ref-entity-info:
ref-entity-type = service-group
ref-entity-tag = /=/v=1/sg-name=ssgSG
Event-info:
alarm-type-id = 1
alarm-instance-id = 13
event-class = alarm-notification
event-type = quality-of-service-alarm-type
severity = minor
description = Service group redundancy.
additional-text = Alarm set when a service unit fails from a service group.
probable-cause = application-subsystem-failure
proposed-repair-action = Investigate the cause of the service unit failure.
service-affecting = true
suppression = suppression-allowed

Kapsch CarrierCom
CLEARING alarms via CLI
cli>fm alarm sho application-type-id 1007 name MtcAppBld 1305 det

1. Show Details
Alarm-info:
name = MtcAppBld
number = 1305
alarm-id = 1007-0-1-/=/v=1/frame=0/shelf=0/slot=3/sub-s
lot=0-serverEid,0:0:0:0:4:1,entityType,11,instance,1-105-1
App-info:
application-name = System Maintenance
application-type-id = 1007
application-instance-id = 1 2. Copy Alarm-id into
Ref-entity-info: fm alarm clear command
ref-entity-type = app-blade
ref-entity-tag = /=/v=1/frame=0/shelf=0/slot=3/sub-slot=0
CLI> fm alarm clear 1007-0-1-/=/v=1/frame=0/shelf=0/slot=3/sub-s

lot=0-serverEid,0:0:0:0:4:1,entityType,11,instance,1-105-1
%Warning: Clearing this alarm will permanently remove it from the Active Alarm List.
Do you want to continue?
confirm (y/n)>y
cli>

Kapsch CarrierCom
Showing the alarms via C-NMS
Alarms for all nodes

Search for text
Select alarms

Kapsch CarrierCom
Get more details for the alarm
C-NMS view
CLI view
cli>fm alarm show severity major

2003 HLR 1303 alarm major
HLR RExFlt
hlr 0:0:8:0
/=/v=1/sg-name=HLR_SG2
Memory synchronization failed
Last Modified: 2014-08-07T01:41:19+02:00 985359

Kapsch CarrierCom
Acknowledge or clear alarms via C-NMS
Select action for checked alarms

Kapsch CarrierCom
Displaying logs
￭To display a listing of all logs currently stored in log files.

￭ Open a CLI session.
￭ At the cli> prompt, enter
￭ fm log show all [output-form]
￭ A list of requested data appears.

cli>fm log show ?
all keyword, show all
application-type-id keyword, specify application type id
end keyword, specify log timestamp upper limit
last keyword, show last X logs
location keyword, specify log location
sequence-number keyword, specify sequence number
severity keyword, specify log severity
start keyword, specify log timestamp range
cli>fm log show
Note:
Depending on the amount of logs stored in files the output from this command could be
extremely lengthy. In order to abort the output use Ctrl-C
Kapsch CarrierCom
fm log ACTIONS
cli>log commands
resync log resync command
show log show command
start start a real-time log feed
stop stop a real-time log feed
Log Example
cli>fm log show
cli>
1007 MtcEth 1600 2014-11-07T09:29:24+01:00 info nil
Ethernet interface progress mark
eth 0:0:1:0 3672981
/=/v=1/frame=0/shelf=0/slot=1/sub-slot=0/if-number=409
se
Waiting for interface up notification has timed out.

Kapsch CarrierCom
Displaying logs with filters
By application-type-id
cli>fm log show application-type-id 1007
1007 MtcAppBld 1600 2014-10-28T15:02:46-05:00 info nil

Last two logs Application Blade progress mark
app-blade 0:0:7:0 16658277
cli>fm log show last 2
/=/v=1/frame=0/shelf=0/slot=1/sub-slot=0
se
By location
cli>fm log show location 0 0 7 0
By severity
cli>fm log show severity major
Logs starting from a specific sequence number

cli>fm log show sequence-number 16658277

Kapsch CarrierCom
Displaying logs with start and end time
cli>fm log show start 2014-08-13T10:05:00+02:00 end 2014-08-13T11:05:00+02:00

1003 PmCentral 1603 2014-08-13T11:05:00+02:00 info nil
Purging of PM reports started
system 0:0:3:0 2191586
/=/v=1/system-key=1
2001 SSG 1502 2014-08-13T10:59:48+02:00 state-chg nil

Route state change
routeset 0:0:1:0 2191567
/=/v=1/routeset-id=3
RSBSS1G idx-3 IPSP-route: prev_state = unavailable, new_state = available
1007 MtcAppBld 1302 2014-08-13T10:13:09+02:00 alarm-set minor

Application Blade temperature high
app-blade 0:0:4:0 2191512
/=/v=1/frame=0/shelf=0/slot=1/sub-slot=0
serverEid,0:0:0:0:4:1,entityType,11,instance,1
Board minor temperature threshold exceeded

Kapsch CarrierCom
Real-time feeds for alarms/logs
Starting and Stopping a real-time alarm feed

cli>fm alarm start
cli>fm alarm stop
Starting and Stopping a real-time log feed

cli>fm log start
cli>fm log stop
Recommendation: Use one session for maintenance operations and

open a second session for real-time alarm/log feeds

Kapsch CarrierCom
Show & filtering logs via C-NMS
Select logs
Set filter for time, logtype, text

Kapsch CarrierCom
System Recovery
￭ CA-Restarts: Restarts processes of the SOS –SW, without reloading

￭ Effect of Restarts on call processing
￭ Booting the MSC Call Agent = reloading the SOS-SW
￭ KAIROS Shelf Disaster recovery

Kapsch CarrierCom
Restarts on SosAgents
Restart Type Which command
WARM >restart warm active
COLD >restart cold active
RELOAD >restart reload active
Automatically restart as a result of:

• an error
• death of an initial process or permanent process
• system clock failure
• TRAP or SWER at interrupt level

Kapsch CarrierCom
Effect of Restarts on call processing
Active Call Call Setup
WARM Remain up
No call
setup
COLD Remain up during a
restart
RELOAD Cleared

Kapsch CarrierCom
Booting the MSC Call Agent = Reloading SW
Login to MSC and verify itocci boot image is set (MAPCI command)
>itocci
>lbf cm
Note: Boot file is flagged with an '*' in ALR column
Issue the following commands from CLI on Data Manager:

1. Display MSC service-unit status:
>aim service-unit show MSC
2. Jam standby MSC unit: (MSC 1 in this example)
>aim service-unit jam MSC 1
3. Force Lock active MSC unit: (MSC 0 in this example)
>aim service-unit lock MSC 0 force
4. Unlock the active MSC unit:
>aim service-unit unlock MSC 0
5. Unjam the standby MSC unit
>aim service-unit unjam MSC 1
6. Login to MSC and check status of MSUs.

Kapsch CarrierCom
Platform maintenance
Routine maintenance:
￭ Clean air filters every 90 days depending on environmental factors

￭ Replace air filters every six months depending on environmental factors
Replacement procedures: (See “KAIROS maintenance” document)
￭ PEM
￭ FTM
￭ SAM
￭ Application Blades

Kapsch CarrierCom
Replacement Procedure Example
Replacement Task Flows are available for every blade/FRU
￭ Ensure blade is locked and the Mated Blade is active
￭ Know the blade frame, shelf, slot, sub-slot. (“Indicate” command)
￭ Wear ESD bands attached to a ground.
￭ Remove any cables connected to the faceplate (if applicable).
￭ Loosen the captive screws at both ends of the blade faceplate.
￭ Compress bottom ejector lever and open latch until you feel resistance. Do not remove the blade
immediately: The blue H/S LED flashes and then turns solid.
￭ Wait for the blade to shut down. The blue H/S LED stops flashing and illuminates solid.
￭ Carefully pull the levers to extract the blade from the shelf.

Kapsch CarrierCom
Example: Replacement Task Flow for MSC Blade

Kapsch CarrierCom
Software

Kapsch CarrierCom
Software related tasks
cli>software ?
software management commands
automate set schedules for automated tasks such as Backup
backup backup and restore commands
baseline software baseline commands
flash Modify and query flash based software
job-status show parcel apply, rollback, remove status
key manage software key entries
parcel apply, query and remove software
product product install/uninstall
transfer download or upload software
upgrade software upgrade
Firmware Commands used during Installation of new hardware / Commissioning

cli>firmware ?

Kapsch CarrierCom
Show Software product & baseline
cli>software product show all

product-code product-version product-title product-state
------------ --------------- -------------------------- -------------
KAIROS00010 1.0.0 KAIROS Release 1.0.0 active
Lab Version, Currently not in use: Parcels are not bundled to Baselines at the current state
cli> software baseline show all
%Error(rc=0x14): Baseline NOT found, or empty parcel list.
.
Applied Baseline
cli>software baseline sho al
baseline-name state
------------------------------------------------------- ----------
kairos1.0_MSC_baseline_1.0 Applied
kairos1.0_MSC_baseline_1.1 Partial Apply
Next SW releaseFuture

Kapsch CarrierCom
Show software parcels
Baseline contains parcels for Linux AND SosAgents

cli>software parcel sho al
id state
------------------------------------------------------------ ----------------
3pcIpPeel_atca8310-10.0.0.142699.0-1.i386 Applied
AISAIM_atca7370_typhoon_CNP-1.0.0.142699.0-1.i386 Applied
AMFCentral_atca7370_typhoon_NCGLHA-1.0.0.142699.0-1.i386 Applied
AMFLocalTyphoon_atca7370_typhoon_NCGLHA-1.0.0.142699.0-1.... Applied
AMFLocal_atca7370_NCGLHA-1.0.0.142699.0-1.i386 Applied
AMFLocal_atca7370_typhoon_NCGLHA-1.0.0.142699.0-1.i386 Applied
AMFLocal_atca7370_typhoon_NCGLHA-1.0.0.142699.1-1.i386 Applied
AMFLocal_atca8310_NCGLHA-1.0.0.142699.0-1.i386 Applied
ace_atcaf125_NCGLWRS-1.0.0.142699.0-1_WR.atcaf125.i386 Applied
acl_atcaf125_NCGLWRS-1.0.0.142699.0-1.1_WR.atcaf125.i386 Applied
aim_lib_atca7370_NCGLHA-1.0.0.142699.0-1.i386 Applied
applman_atca8310-10.0.0.142699.1-1.i386 Applied
appVolMgrDaemon_atca7370_KCRY80BA_CNP-1.0.0.142699.0-1.i386 Applied
atca7370-config_atca7370_NCGLWRS-1.0.0.142699.0-1_WR.atca... Applied

Kapsch CarrierCom
Software automated backups
KAIROS Backup includes KAIROS-SW+ (All SOSAgent Images) + (Filesystem)
cli>software automate show all

backup automate-id
---------- ------------
backup 1
backup 2
backup 3
backup 4
backup 5
backup 6
backup 7
cli>software automate show all d

backup = backup
automate-id = 1
day-of-the-week = mon
hour = 23
minute = 15
remote-host-id = backupserver
remote-path = /HLR_BACKUP_SPACE

Kapsch CarrierCom
Backup
Which SOS APP Blade Images are included into the KAIROS Backup?
￭ MSC
cli>software backup sos-register show all
backup-id sg-instance-name
---------------------------------------- -------------------------------
GU_MSC_Call_Agent MSC
￭ HLR
cli>software backup sos-register show all
backup-id sg-instance-name
---------------------------------------- --------------------------------
GU_Home_Location_Registry HLR_SG1
GU_Message_Routing_Function MRF

Kapsch CarrierCom
Create a KAIROS Backup
cli> software backup archive create

%Progress: Command is in progress
This will take 30-45 minutes.
cli> software backup archive show all detailed

archive-id = all_all_2014-07-28-13-01-34
state = Available
path = /opt/swd/backups
parcel-name = kairos_backup_all_all_2014-07-28-13-01-34.tar
version = 1
created-date = 2014-07-28 13:01:34
Locate the image on the disk:

mtc@ksc-base-unit0:~$:/root> ls -t /opt/swd/backups
Observation:
kairos_backup_all_all_2014-07-28-13-01-34.tar

Kapsch CarrierCom
Software backup archives
cli>software backup archive sho al
archive-id state
------------------------------ ------------------------------
all_all_2014-07-29-07-49-41 Available
MSC: stores 3 Backups
HLR: stores only 1 Backup

Kapsch CarrierCom
Storage Disks on KSC RTM
￭Seperate Directories on DISKs for each SosAgent (MSCCA / MRF + HLR_SG)

￭/opt/kapsch/ca/data/851968/ sd00 /image0
/temp
/patch
/ghot
/gcdr
RTM Slot 3 KAIROS

RTM Slot 7
à300GB
sd00 sd00 Backup
sd01 sd01 Server
Linux Linux Ext. Backup
Filesystem Filesystem
replicated
etc etc
var var

Kapsch CarrierCom
storage
cli>storage file-system show all

mount-point size-mb %use adm-stat opr-stat avail
---------------------------------- ------- ---- -------- -------- --------
/ 2048 43 unlocked enabled avail...
/boot 1922 49 unlocked enabled avail...
/dev/shm 32 1 unlocked enabled avail...
/export_monitor/tftpboot 8002 37 unlocked enabled avail...
/home 103 7 unlocked enabled avail...
/nfsctrl 19 11 unlocked enabled avail...
/opt/kapsch/ca 503 9 unlocked enabled avail...
MRF
/opt/kapsch/ca 503 4 unlocked enabled avail...
/opt/kapsch/ca/data/720896/sd00 10002 19 unlocked enabled avail...
/opt/kapsch/ca/data/786433/sd01 3007 1 unlocked enabled avail... HLR_SG1
/opt/kapsch/ca/data/NODATA 2007 1 unlocked enabled avail...
. . . . . .
Separate mount points for every SOSAgent app-blade

Kapsch CarrierCom
Which File Systems are backuped?
cli>software backup file-register show all det
backup-id = CNP
type = load
path = /home
mount-point = /home
backup-id = GU_MSC_Call_Agent
type = load
path = /opt/kapsch/ca
mount-point = /opt/kapsch/ca
backup-id = GU_MSC_Call_Agent
type = load
path = /opt/kapsch/ca/data/786432/sd00/back0/
mount-point = /opt/kapsch/ca/data/786432/sd00
path = /opt/kapsch/ca/data/786432/sd00/gcdr/
path = /opt/kapsch/ca/data/786432/sd00/ghot/
path = /opt/kapsch/ca/data/786432/sd00/images/
path = /opt/kapsch/ca/data/786432/sd00/jf/
. . . .
path = /opt/kapsch/ca/data/786432/sd01/jf/
path = /opt/kapsch/ca/data/786432/sd01/patch/

Kapsch CarrierCom
SS7 Datafill & Signaling Service Groups

Kapsch CarrierCom
SSG commands for KAIROS 1.0

cli>ssg ?
ssg commands
adjacent-node-group adjacent-node-group commands
application-server application-server commands
application-server-process application-server-process commands
as-sls-behavior as-sls-behavior commands
asp-association asp-association commands
ext-net-app ext-net-app commands
external-connections external-connections commands
ip-int-addr-assignment ip-int-addr-assignment commands
ip-m3ua-addr-assignment ip-m3ua-addr-assignment commands
ip-mme-addr-assignment ip-mme-addr-assignment commands
ip-sip-addr-assignment ip-sip-addr-assignment commands
mme-association mme-association commands
na-set na-set commands
network-appearance network-appearance commands
pairing pairing commands
path path commands
pathset pathset commands

Kapsch CarrierCom
SIGTRAN Data on MSC
CLI Datafill SOS Datafill
KAIROS MSC IN-SYNC
SSGs MSCCA
Table Master
Database
SIGTRAN Data Distribution SS7
Layers Layers
C7 Tables
C7GTT, C7LOCSSN, APPLICATION
APPLICATION
SCCP
C7RPC, C7NETSSN ART
SCCP
C7 Data C7 Tables MTP3

M3UA Network Appearance NA: C7NETWRK
Routesets RS: C7RTESET
MTP2
SCTP SIGTRAN Data Empty Tables: MTP1
AS, ASP, ADJ-Nodes C7Lkset, C7Link E1
IP PATH Data
Ethernet PATH, PATHSET

Kapsch CarrierCom
Sigtran Associations
STP Datafill MSC

SSG0
SIGTRAN Links AS30 AS31
AS1 ASP310 ASP320
ASP310
ASP321
AS2
ASP320
ASP311 SSG1
ASP321
ASP311 HLR1
SSG0
AS2 AS4
ASP21
ASP22
SSG1

Kapsch CarrierCom
MSC-S communication via paths and SIGTRAN associations
MGW-R KAIROS
BSC
Pointcode
ASP SSG1
ASP MSCCA
0
IP-LAN
STP/SGW 1
SSG2
Pathset
PSTN ASP
SGP
PLMN

Kapsch CarrierCom
HLR Paths inside KAIROS
KAIROS MRF
Pathset
SSG0
Ext
8 HLR_SG2
10
4 11
SSG1
6 HLR_SG1
Ext

Kapsch CarrierCom
Thank you for your attention
Kapsch CarrierCom AG | Training

Lehrbachgasse 11 | 1120 Vienna | Austria
Phone +43 664 628 3962
E-mail training@kapsch.net | www.kapsch.net
www.kapschcarrier.com/training
Please Note:
The content of this presentation is the intellectual property of Kapsch AG and all rights are reserved with respect to the copying, reproduction, alteration, utilization, disclosure or
transfer of such content to third parties. The foregoing is strictly prohibited without the prior written authorization of Kapsch TrafficCom AG. Product and company names may be
registered brand names or protected trademarks of third parties and are only used herein for the sake of clarification and to the advantage of the respective legal owner without
the intention of infringing proprietary rights.
21.09.2010 | GSM-R Training Strategy | 91

Kairos02 Cli Oam

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Kairos02 Cli Oam

Uploaded by

Copyright:

Available Formats

Kapsch CarrierCom

KAIROS CLI Command Line Interface

Version Date Title Responsible

2015.1 2015-07-07 Some smaller changes for 2015.1 Thomas SZEPANNEK

Document identifier: PE/TRD/APP/029549 V01/EN

Document status: Preliminary

Document version: 2015.1

Feb.2015 | KAIROS GSM-R Training

KAIROS01 CLI Command Line Interface

Part 1 ￭ KAIROS01 R4 and Hardware Overview

Part 2 ￭ Login Procedures ……………………………………… 4

Part 3 ￭ SOS Agent Basics

Feb.2015 | KAIROS GSM-R Training | 3

In this part, you will learn how to:

￭ Login to the KAIROS platform

￭ Perform basic maintenance tasks

￭ Understand basic configuration parameters

￭ Login to SOS CallAgents

Feb.2015 | KAIROS GSM-R Training | 4

02.12.2009 | Titel der Präsentation Untertitel der Präsentation | 5

KAIROS SOS Appl Linux

Active IP Address: 10.x.x.129 (in OAM VLAN)

Feb.2015 | KAIROS GSM-R Training | 6

KAIROS OAM Possibilities

Feb.2015 | KAIROS GSM-R Training | 7

CLI login possibilities

ssh session onto active KSC Datamanager

SOS application level

SosAgent mrf login MRF

CLI:> Other CLI Commands / KAIROS level

Feb.2015 | KAIROS GSM-R Training | 8

Login from C-NMS

Open ssh window for Login (Java Based)

Feb.2015 | KAIROS GSM-R Training | 9

02.12.2009 | Titel der Präsentation Untertitel der Präsentation | 10

CLI Session Welcome Screen

Feb.2015 | KAIROS GSM-R Training | 11

Login to CLI Session

￭ Login onto active KSC Datamanager to CLI Session

￭ Example for Abbreviated command:

Feb.2015 | KAIROS GSM-R Training | 12

CLI Commands KAIROS 1.0 (NSS 22)

Feb.2015 | KAIROS GSM-R Training | 13

Command structure examples

cli>hardware app-blade show 0 0 10 0

cli>hardware frame show all

Feb.2015 | KAIROS GSM-R Training | 14

CLI Common Tasks

02.12.2009 | Titel der Präsentation Untertitel der Präsentation | 15

Show/Modify cli-session parameters | exit the session

cli>cli-session show all

command-prompting verbose-level screen-width timeout

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

cli>cli-session modify timeout

timeout integer (1-1410), set the timeout of the cli in min

Exits the CLI Session

Feb.2015 | KAIROS GSM-R Training | 16

Show system name | time

system-key system-id user-label description

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

Mon Aug 9 13:41:53 2010

Feb.2015 | KAIROS GSM-R Training | 17

Admin commands for remote-hosts (e.g. Backup server)