Monsub CLI Options
Monitor Subscriber CLI – New Options
The following options with their default value are added to existing monitor subscriber command.
UPF Monitor Subscriber CLI
Following are the options:
-
W - UP PCAP Trace (ON ): This parameter is used to create PCAP trace for slowpath and fastpath and is only applicable for CUPS.
-
U - Mon Display (ON): The non-protocol events (such as statistics and charging information from ECS and so on) are also captured in slowpath PCAP files and are displayed on U-PLANE monitor console.
-
V - PCAP Hexdump (ON): This flag must be set to ON to capture the protocol packets in a text file in hexdump format on U-PLANE.
Note | Currently, UP PCAP Trace flag must be set to ON to capture fastpath and slowpath PCAP files on CUPS. |
Monitor Subscriber CLI – New Options
The following options with their default value are added to existing monitor subscriber command.
-
F - Packet Capture (Full Pkt): Captures all packets from fastpath.
Using this option, operators can choose between full and partial packet captures. By entering F, the packet capture type can be changed to either full or partial. With partial packet capture, users can enter packet sizes from 1 to 16384 bytes. For example, if input is given as 20, only the first 20 bytes of fastpath packets will be captured and the remaining packets will be dropped.
NoteWhen opening the PCAP file, the summary view will display full length of the packet, but the detailed view will show only the truncated packet.
-
/ - Priority (0): The value is in the range from "0 – Best Effort" to "7 – Guaranteed"
-
0 - Best Effort
-
1 - Low
-
2 - Med-Low
-
3 - Medium
-
4 - Med-High
-
5 - High
-
6 - Critical
-
7 - Guaranteed
CautionIt is strongly recommended to not change the default value. It can adversely affect the system performance.
-
-
N - MEH Header (OFF) : The MEH header is stripped from the IP packet if this option is configured
Show Monitor Subscriber Sessions
Following is the new CLI to show the ongoing MonSub session.
You can trigger the CLI show monitor subscriber fastpath session all from UPF.
-
SessId: This is the local session id for MonSub session on UP Sessmgr.
-
CallID: Call id on Userplane.
-
PSN: This is panopticon sequence no. There is a maximum of four MonSub fastpath tracing sessions on one UP with PSN ranging from 0-3.
-
Start time: Time at which MonSub tracing session starts.
-
Interface Type: This is to identify the call type for which MonSub fastpath tracing session was started, whether it is Sxa, Sxb or Sxab.
Disconnect Monitor Subscriber Sessions
Following is the new CLI to disconnect the ongoing MonSub session. You can trigger the CLI from UPF.
monitor subscriber fastpath disconnect sessmgr-instance <UP SMGR Instance ID> session-id <Local Monitor subscriber Session ID at SMGR instance level>
If the MonSub session disconnect is successful, the following message dispalys on console.
Session Disconnected Successfully
If the MonSub session disconnect fails, the following message dispalys on console.
Monitor Subscriber session does not exist
Note | Only security administrator can execute the monitor disconnect CLI. |