General
The YateHSS/HLR CLI is accessible through the Yate’s Telnet interface. It accepts connections by default on TCP port 5038 to connect to the Yate Remote Manager (rmanager).
By default the Command Line Interface is accessible from localhost only. It is possible to configure rmanager to be accessible from network but that poses security risks. Consider using firewall rules, telnet-ssl and configuring password authentication.
From the Linux console:
telnet 127.0.0.1 5038
General Yate commands are also accessible through the same interface.
help hss
hss list {sims [IMSI-PREFIX]|subscribers [MSISDN-PREFIX]}
hss list {regs|purged} {cs|ps|ims} [IMSI-PREFIX]
hss show {subscriber|sim|sqns} {MSISDN|IMSI|ICCID}
hss {push|drop|kick|kill} {cs|ps|ims|all} IMSI-PREFIX
hss repair {MSISDN|IMSI|ICCID}
hss reattach {IMSI}
hss reset {IMSI}
hss repair-dangling-regs
Control the HSS operation
You can use the TAB key to complete the current command line. All YateHSS/HLR related commands start with hss
hss TAB
list show push drop kick kill repair
hss show TAB
subscriber sim sqns
Statistics
A single command with no parameters that displays some information about the HSS/HLR as a whole:
hss
Subscribers CS Regs PS Regs IMS Regs Connected
total total active total active total active cluster nodes
———– —— —— —— —— —— —— ——————-
23 21 1 22 8 4 0 (standalone)
Listing items
All commands related to lising YateHSS/HLR items start with hss list
You can use the Page Up, Page Down, Home and End keys to scroll through long lists.
SIMs
This command lists all provisioned SIMs or just those that start with a specific IMSI prefix.
hss list sims
Primary IMSI Alternate IMSI SIM Type Algorithm CS PS LTE IMS WLAN
————— ————— ———— ——— — — — — —-
001990123456789 ISIM milenage yes yes yes yes yes
001990123456788 ISIM milenage yes yes yes yes yes
001020000000001 SIM comp128-1 yes yes yes no yes
460990010001001 310410992261045 ISIM milenage yes yes yes yes yes
…
hss list sims 00190
Primary IMSI Alternate IMSI SIM Type Algorithm CS PS LTE IMS WLAN
————— ————— ———— ——— — — — — —-
001900123456788 ISIM milenage yes yes yes yes yes
001900000000001 SIM comp128-1 yes yes no no no
Subscribers
This command lists all provisioned subscribers or just those that start with a specific MSISDN prefix.
hss list subscribers
MSISDN Primary IMSI Alternate IMSI ODB CS PS IMS SIP
————— ————— ————— — — — — —
40700012345 001990123456789 yes yes yes yes yes
40700012346 001900123456788 yes yes yes yes yes
40316201405 001020000000001 no yes yes no no
…
hss list subscribers 882
MSISDN Primary IMSI Alternate IMSI ODB CS PS IMS SIP
————— ————— ————— — — — — —
88270021 001150010001001 no yes yes no no
88270005 001020000000003 no yes yes no no
88270013 310410010001005 no yes yes no no
…
Registrations
This command lists active registrations for each subtype: CS, PS or IMS. An optional IMSI prefix added to the command allows displaying only registrations of interest.
hss list regs cs
IMSI IMEI(SV) Protocol VLR Number Reg. time
————— —————- ——– —————— —————-
310410010001005 0134070049232090 MAP 8820016 2016-12-05 17.25
hss list regs ps
IMSI IMEI(SV) Protocol Access SGSN / Host Reg. time
————— —————- ——– ——- ———————— —————-
001990123456789 1234567898654321 MAP e-utran 8820016 2016-11-28 13.06
001020000000001 8607830344603800 MAP ??? 8820016 2016-10-24 23.45
001020000000003 3546540526090101 MAP geran 8820016 2016-12-12 17.48
001010000000007 3594670766703801 DIAMETER e-utran ucn.yatebts.com 2016-12-10 23.54
001010000000006 3585820515563804 DIAMETER geran ucn.yatebts.com 2016-12-09 04.21
hss list regs ps 00101
IMSI IMEI(SV) Protocol Access SGSN / Host Reg. time
————— —————- ——– ——- ———————— —————-
001010000000007 3594670766703801 DIAMETER e-utran ucn.yatebts.com 2016-12-10 23.54
001010000000006 3585820515563804 DIAMETER geran ucn.yatebts.com 2016-12-09 04.21
The hss reattach command forces a resynchronization for the specified IMSI.
hss reattach {IMSI}
Example:
hss reattach 001019901000082
Reattaching 1 PS registrations
Re-sync IMSI:001019901000082 by mme:ucn.epc.mnc001.mcc001.3gppnetwork.org SQN 000000001700 -> 0000000016E0
The hss reset command applies when an HSS server recovers, for example, from a failure, and it needs to confirm that some of the subscribers are still connected to a specific VLR/SGSN or MME. The HSS sends a reset command to the VLR/SGSN/MME, adding a mark for ‘Location information not confirmed in HSS’ for that IMSI.
This way is possible to do reset this manually if needed.
The command synopsis:
hss reset
cs ps vlr sgsn mme
Followed by IMSI to send the reset.
Showing information
All commands showing details of YateHSS/HLR items start with hss show
SIMs
This command takes either an IMSI or ICCID parameter and displays information about selected SIM. The amount of information depends on SIM type and provisioned information.
hss show sim 001990123456789
Primary IMSI Alternate IMSI SIM Type Algorithm CS PS LTE IMS WLAN
————— ————— ———— ——— — — — — —-
001990123456789 ISIM milenage yes yes yes yes yes
ICCID Vendor PIN PIN 2 PUK PUK 2
——————– ——————– —— —— ———- ———-
8996399000000002493 SmartJac 0000 0000 11111111 22222222
AMF CS PS IMS WLAN USIM ISIM WLAN
AMF LTE SQN SQN SQN SQN Opc Opc Opc
—- —- —– —– —– —– —- —- —-
0000 9001 0-15 16-31 0-31 (=PS) no yes no
Subscribers
This command takes either a MSISDN, IMSI or ICCID parameter and displays information about selected subscriber. The amount of information depends on provisioned information.
hss show subscriber 001990123456789
ODB BOIC BIC PS PS AP AP
MSISDN Roam BAOC BOIC ExHC BAIC Roam All Roam HPMN VPMN
————— —- —- —- —- —- —- —- —- —- —-
40700012345 no no no no no no no yes no yes
SS BOIC BIC Mult
Pass CLIP CLIR BAOC BOIC ExHC BAIC Roam CW HOLD PTY
—- —- —- —- —- —- —- —- —- —- —-
no yes no no no no no no yes yes no
CFU Number CFB Number CFNRC Number CFNRY Number Time
————— ————— ————— ————— —-
(not provision) 40700099999 40700099999 (not provision) 30
CS Profile PS Profile EPS Profile IMS Profile
—————— —————— —————— ——————
Prepaid voice Prepaid data Prepaid data VoLTE with CAMEL
SIP Username Authname Realm Active
———————- ———————- ———————- ——
40700012345 SIP service yes
Private identity Public identity Alternate public ID Active
———————- ———————- ———————- ——
001990123456789@ims.ex sip:+40700012345@examp tel:+40700012345 yes
Primary IMSI Alternate IMSI SIM Type Algorithm CS PS LTE WLAN
————— ————— ———— ——— — — — —-
001990123456789 ISIM milenage yes yes yes yes
Sequence numbers
This command takes either an IMSI or ICCID parameter and displays sequence numbers usage for selected USIM or ISIM.
hss show sqns 8996399000000002493
IDX Sequence SQN Network node Last use time
— ———– ———— —————————– ——————-
0 72 000000000900 mme:8820016 2016-11-08 15:31:23
1 3 000000000061 wlan-aaa-server:8820016 2016-08-03 13:05:11
2 9 000000000122 mme:8820020 2016-08-09 15:15:23
3 31 0000000003e3 vlr:8820016 2016-09-30 23:08:04
4 39 0000000004e4 sgsn:8820016 2016-09-30 23:08:08
5 1 000000000025 2016-07-22 14:03:41
6 1 000000000026 2016-07-22 14:03:41
…
Registration operations
These operations work on currently registered subscribers since address of the visited network node must be known. Subscribers that are not registered are silently ignored.
Push data
This operation pushes subscribers data to the visited network node where it is registered.
The domain to send information for must be provided as parameter, must be either cs, ps, ims or all (which sends data for all domains).
Last parameter is an IMSI prefix (of at least 5 digits) that selects for which subscribers to push data. A full length IMSI may be provided.
hss push cs 310410010001005
Pushed CS data for 1 subscribers
hss push ps 00102000
Pushed PS data for 2 subscribers
hss push all 00101
Pushed CS data for 0 subscribers
Pushed PS data for 2 subscribers
Pushed IMS data for 0 subscribers
Deregister
This family of operations cause the subscriber to be deregistered from HSS/HLR.
The operation name does as follows:
The domain to deregister must be provided as parameter, must be either cs, ps, ims or all (which deregisters all domains).
Last parameter is an IMSI prefix (of at least 5 digits) that selects which subscribers to deregister. The dangerous kill operation requires at least 14 digits (matches at most 10 IMSIs).
hss drop all 001020000000001
Kicked out 0 CS registrations
Kicked out 1 PS registrations
Kicked out 0 IMS registrations
hss kick ps 00199
Kicked out 1 PS registrations.
hss kill ps 001010000000006
Kicked out 1 PS registrations.
Check and repair
This command takes a MSISDN, IMSI or ICCID and tries to fix any database inconsistencies related to matching subscriber, registrations, SIM and sequence numbers.
At the end the command reports the problems detected and actions taken – if any.
hss repair 001010000000006
Errors detected:
Has PS or EPS profile but no PS registration… fixed
hss repair 40316201405
Nothing needed fixing.
The hss repair-dangling-regs command was introduced for HSS clustering situations to help synchronize registrations (where some of the records may be desynchronized) between the cluster nodes.
hss repair-dangling-regs
Example:
hss repair-dangling-regs
Started dangling regs repair.
Starting dangling registration fixing process.
Terminated dangling registration fixing process.
