SIP Surrogate Agent Registration Re-initialization
Surrogate agents in the IMS network integrate IP Private Branch Exchange (PBX) that cannot register itself to the registrar. The Oracle Communications Session Border Controller supports registration retry attempts to the IMS core up to the configured maximum register attempts before failing. When the Oracle Communications Session Border Controller identifies an unregistered surrogate agent, the registration cache can cleared as a normal SIP user and the registration process re-started.
Surrogate Agents may not successfully register before the max-register-attempts, causing an unresponsive agent. Commands identify these unregistered agents and clear them from cache. New registration attempts are then available.
Command line option show registration sipd surrogate-agent <realm-id/unregistered> with no additional arguments displays all surrogate agents and their state.The system displays the last time of registration for each agent.
- realm id—displays all surrogate agents present in the selected realm.
- unregistered— displays all unregistered surrogate agents.
The preceding commands have the to-file option to redirect the output to a file
Possible values for the Last Registered at and State fields
- Last Registered at
- Displays the last time when the agent registered with the Registrar. This time will change with every renewal registry at expiration. If the surrogate user has not successfully registered, this field will say never registered
- State
- Displays the current state of the surrogate agent. This State field confirms the state of two timers used when a surrogate agent is being configured: 1. register-expires and 2. register-retry-time. When the register-retry-time expires, the state will be set to unregistered as it continues to try to register. When the register-expires time expires and max-register-attempts is exhausted, the state is set to failed.
| Last Registered At | State | Description |
|---|---|---|
| <time> | registered | Surrogate agent valid and registered |
| <time> | failed | Surrogate agent registered, but failed to register refresh and is in an invalid state |
| <time> | unregistered | Surrogate agent registered, now server is not responding but continues to send REGISTER |
| Never registered | failed | Surrogate agent failed to register. |
When there are no surrogate agents configured on the Oracle Communications Session Border Controller , the output for show registration sipd surrogate-agents, show registration sipd surrogate-agents by-realm <realm-id> and show registration sipd surrogate-agents unregistered shows "No matching entries found!".
When all the surrogate agents are registered and none in an unregistered state, the output for show registration sipd surrogate-agents unregistered shows "No matching entries found!".
Existing ACLI command clear-cache registration sipd restarts the registration process for the surrogate agent.