This section provides solutions to frequently asked questions (FAQs) about the SBC Core systems.
To search for a specific word or term, use the keyboard shortcut CTRL+F.
Click on a frequently asked question to learn more:
How do I transfer files from one unit to the other?
You can transfer files from one unit of a HA pair to the other (this comes in handy for large files that you may have to send over a slow VPN), using SCP and port 2024.
Beginning with release 3.1, file transfers must be performed using SFTP on port 2024. Use the following steps as a guide (default login/password is sftpadmin/sftpadmin):
- From the source SBC, login to Linux shell using sftpadmin/sftpadmin and change directory to where the file is located.
Connect to target SBC. In this example, SBXa is the source and SBXb is the target SBC.
Use the put command to transfer a file to the specified directory as shown in the example below.
How do I block certain country codes?
Create a Class of service BLOCK_COUNTRY_CODES. This will contain the country codes to block, and also not hit the "Non Subscriber" call blocking.
Associated this class of service with the trunk group that is originating the calls (that you wish to block calls to certain country codes)
How do I display numbers in the routing table?
To display all numbers:
To display numbers to a certain route label:
To display a specific number:
You can also do a search from the EMA GUI. To view the Routing workspace, see Call Routing: System Provisioning - Routing.
How do I display the status of all the trunk groups in a Zone?
How do I display trunk group configuration data?
You can view the trunk group configuration data using the CLI.
What if my video calls are not working?
- Video bandwidth:
- Check CAC configuration
- Check reduction factor
- Passthrough calls are permitted:
- Check Packet Service Profile flags (no transcode option)
- No convert mode for Late Media video calls
- Codec List Profile – check if codecListProfile manipulation results in no coded in offer/answer
- Ingress/Offered SDP – check if video m -line is present
How do I import a ".cli" script file from the EMA GUI?
This mechanism can be used to speed up the process of configuring the SBC. A script file can be prepared (based on specific data from other existing systems) and then imported into the SBC. For example you could create a trunk group and routable numbers for one particular customer in one script file. You then import this script, and the customer is fully provisioned and ready to go.
The ".cli" file contains CLI commands, exactly of the same format as typing in the commands from the CLI. It should be in text format only. Note that the default behavior of the system is to interpret "spaces" as a request for auto-completion, so that extra spaces in your ".cli" file will cause errors. You can turn this function off by using the CLI command:
- Create text file with CLI commands. It is best to use Microsoft WordPad (should not use Word). This file must start with "configure" and end with "commit". Name of file must end in ".cli". Note that this is case sensitive ".CLI" will not work. Also note you may need to save the file as "text", then rename the file to end in ".cli".
- Include the "commit" command after each five CLI commands.
- On the SBC main screen, navigate to Administration > System Administration > Configuration Import/Export. The Configurations window is displayed.
For more information on upload configuration, refer to Configuration Import/Export - Upload Configuration.
See example CLI script to create a new trunk group and routing information "CLI Script Creates Trunk Group and Routes" on page Reference Configuration.
How do I delete a specific routed number via CLI?
You must put in the full routing data involving the number to delete it via the CLI.
How do I delete a Trunk Group?
The trunk group must be disabled and out of service before you can delete it.
How do I turn Globalization (+1) on and off per trunk group
You may need to send Globalized numbers out to a carrier trunk group, while stripping the +1 off calls that are sent to PBX trunk groups. This is accomplished via the trunk groups IP Signaling Profile. Within the IP signaling profile there is a Globalization profile. On the trunk group that needs Globalization, the IP signaling profile should contain a Globalization Profile that enables globalization. On the trunk group that globalization should not occur, a different IP Signaling profile is needed (one that has a Globalization profile that disables globalization).
You can also remove the numberGlobalizatoinProfile from the IP signaling profile that does not need Globalization (if you did not need any of the settings).
Trunk group example:
Associate an IP Signaling Profile which has Globallization Profile turned off to the trunk group.
Verify change, where NO_GLOBAL is a profile that does not globalize any numbers.
(the above results are shortened for brevity)
How do I display the status of the HA ports?
Check the states of these ports after initial system configuration to ensure the fibers are installed correctly and the two units are communicating.
How do I display registered users (Access configuration)?
The SBC can cache Registration information by turning on the Trunk Group field "Require Registration". It is often useful to display the users that have successfully Registered.
How do I ping from various interfaces?
Sometimes it is handy to test IP connectivity from the various interfaces on the SBC platform. Use the Ping utility from the EMA:
- Login to EMA and select Tools > Ping tab.
- Enter IP address to ping.
- Select IPV4 or IPV6 option.
- Select platform interface to ping from.
- Press Ping IP address. Results display in Ping Results window similar to below example.
In the above example, IP addresses are intentionally blurred.
How do I view user types and passwords?
On the SBC Application (accessed by the EMA and the CLI), various types of users are predefined. Each type of user has different capabilities. Please see Managing SBC Core Users and Accounts for details.
To add a new user or reset password from the EMA GUI, perform following:
- On the SBC main screen, navigate to Administration > Users and Application Management > User and Session Management.
- From User and Session Management window, select user or click appropriate Edit/Add/Delete icon.
To add a new user from CLI:
How do I change default passwords?
Some customers may require that all default passwords are changed. The default passwords and method to change them are described at Managing SBC Core Users and Accounts.
How do I view media range (base and max)?
To check the range of ports that used for media:
How do I set up billing to transfer to SFTP server?
You can set up to transfer CDR to an off board SFTP server on a regular basis, for example once per hour.
- Set up the cdrServer. Information needed are the IP address, user name, password, file name extension, and the path on the server where the billing files will be stored.
- The full path should be given "/export/home/billing"
- The file name extension can be the name of the System, for
- example "DALNBS01"
Set up the duration for the accounting logs to rollover to the next file (for example 60 minutes).
- Set a start time of the format "2011-08-24T18:00:00"
- Set rollover type to "repetitive"
- Set rollover action to "start"
Check the status of the transfer:
If I have multiple SIP Signaling Ports configured in a Zone, which is the source IP when sending a request to a peer?
As a best practice, Sonus recommends configuring one signaling port per zone. The SBC chooses a port (usually the first port) in the zone for outbound connections. However, the SBC cannot enforce the use of a specific signaling port within the zone to initiate a call on a trunk group. The trunk is assigned to a zone and not to a signaling port in the configuration model. To associate a unique source port for each trunk group, create separate zones defining a single signaling port per zone.
How many routes per call does the ERE support?
The ERE returns up to 10 routes. If more than 10 routing label routes are created, only the first 10 in-service routes are returned.
If I replace my CDR server but keep the same IP address, are any changes needed on SBC?
The SBC writes CDRs locally, and simply transfers them using SFTP to the CDR server (for example, DSI L0 server) based on the IP address listed in CDR server settings on the SBC. If you replace the CDR server with another server, but maintain the same IP address and user settings, no change is needed on the SBC.
Does SBC HA use a heartbeat scenario to talk to the other box?
The SBC uses Transparent Inter-process Communication (TIPC) to monitor several processes and applications running on the opposite server.
I am using Linux shell 'top' command and see CPU utilization over 100% for a process. What does this mean?
The top command returns the sum of CPU utilization by all threads within a process. The SBC is a multi-core system, and the process in question is utilizing more than one core. For more accurate results, use top –Hcommand to see process utilization per core/thread.
Is there a simple way to compare my CLI configuration settings against the default values?
Yes! You can view both configured values and defaults using the 'show' command. First, turn on default values setting using the following 'set' command:
Next, enter your 'show configuration' command:
See CLI System-Level Mode for details.
Can I install custom Linux scripts or make other OS level changes?
NO! SBC Core is a closed network device. Customer modifications at the Linux level are not allowed or supported. These modifications can cause stability, update and fail-over issues on SBC platform. Customers must ONLY configure the SBC using the supported interfaces(CLI, REST, EMA, EMS).
How may CLI 'set' commands can I commit at one time?
As a best practice, issue a
commit command after each group of approximately 10
set commands is entered.
How do I monitor IP addresses of users logged into the SBC?
Login to the EMA and navigate to Administration > Users and Application Management > User Management window and view User Sessions table.