In this section:
The SBC Core is enhanced to support SIP Registrar functionality for SIP end points. This feature allows the Ribbon SBC to act as an Access SBC with Registrar functionality in a single deployment.
The Ribbon SBC acting as a SIP REGISTRAR provides the following functions:
The following types of users can manage the SIP Registrar functionalities.
Use the SIP Registrar screen to import and export subscriber data in the form of an XML document to the TemplateConfigServlet
, which in turn invokes confd
commands for importing and exporting the data. As the import and export operations are time consuming, they are asynchronously executed in separate light weight processes.
Once the user uploads the subscriber data as an XML file, the EMA performs data validation and verification using the Inputs Sanitization technique to validate the uploaded data against the validation logic embedded in ValidationHandler.java
in order to ensure that the client sent valid inputs.
On the SBC main screen, go to Administration > System Administration > SIP Registrar.
You can perform the following operations on the "SIP Registrar" screen:
Operation | Parameters | Description |
---|---|---|
Check Status | N/A | Check the details/status of an import/export operation, if any. |
List | N/A | List exported subscribers files in the JSON Format. |
Import Subscribers | File Name, File Contents | Import the subscriber data. |
Export Subscribers | N/A | Export the subscriber data. |
Download | File Name | Download the subscriber data in the form of an attachment using the file name as an input parameter (identifier). |
Delete | File Name | Delete Subscriber data using the file name as an identifier. |
When updating (adding/modifying/deleting) Subscriber profiles from the EMA, Ribbon recommends doing so only during a maintenance window. Also, before performing a bulk import of profiles, set the debug level to Major or Critical using the CLI.
set oam eventLog typeAdmin debug filterLevel major
After you log into the EMA, the SBC makes an API call to verify if any Subscriber operation is in progress. If an operation is in progress, you are blocked from performing any other operations, and must log out of the EMA until the operation completes.
Once the Import operation starts, you are blocked from doing any other operations. Log out of the EMA until the operation completes.
Use the Export Subscribers option to export and list the files of the subscribers in a data table.
Click Logout and log back in later.
If the number of Exported files is 20, operators are prompted to delete the file from the table to proceed with the Export operation.
This section of the screen indicates if the Import/Export operation was successful.
Use this option to download the Subscriber XML file. In the SIP Registrar screen, select the Subscribers XML file from the list and then click Download to download the file to disk.
Use this option to delete the subscriber XML file. In the SIP Registrar screen, select the Subscribers XML file from the list and then click Delete to delete the file. A confirmation message "Are you sure you want to delete the file appears". Click Yes to confirm.
Add multiple subscriber entries using the following sample XML file data. You must add the multiple entries within the tags <sipLocalRegistrar>
</sipLocalRegistrar>
.
<config xmlns="http://tail-f.com/ns/config/1.0"> <global xmlns="http://sonusnet.com/ns/mibs/SONUS-GLOBAL-OBJECTS/1.0"> <signaling> <sipLocalRegistrar> <sipRegSubscriberProfile> <sipRegAor>53055@10.xx.xx.xx</sipRegAor> <sipRegAuthUserName>testUser1</sipRegAuthUserName> <sipRegAuthRealm>rbbn.com</sipRegAuthRealm> <sipRegAuthPassword>testPassword1</sipRegAuthPassword> <sipRegSendChallenge>challengeForNone</sipRegSendChallenge> </sipRegSubscriberProfile> <sipRegSubscriberProfile> <sipRegAor>53069@10.xx.xx.xx</sipRegAor> <sipRegAuthUserName>testUser2</sipRegAuthUserName> <sipRegAuthRealm>rbbn.com</sipRegAuthRealm> <sipRegAuthPassword>testPassword2</sipRegAuthPassword> <sipRegSendChallenge>challengeForNone</sipRegSendChallenge> </sipRegSubscriberProfile> </sipLocalRegistrar> </signaling> </global> </config>
When performing bulk provisioning, Ribbon recommends using the SBC EMA or RESTCONF API, instead of the CLI.