Copyright © 2015 www.opensips-solutions.com
Table of Contents
List of Examples
The event_virtual module provides the possibility to have multiple external applications, using different transport protocols, subscribed to the OpenSIPS Event Interface as a single virtual subscriber, for a specific event. When an event is triggered, the event_virtual module notifies the specified transport modules using one of the following policies:
PARALLEL - all subscribers (applications) are notified at once
FAILOVER - for every event raised, try to notify the subscribers, in the order in which they are given, until the first successful notification
ROUND-ROBIN - for every event raised, notify the subscribers alternatively, in the order in which they are given (for each raised event notify a different subscriber)
Only one expire value can be used (for the whole virtual subscription), and not one for each individual subscriber.
virtual:policy subscriber_1 [[subscriber_2] ...]
virtual: - informs the Event Interface that the events sent to this subscriber should be handled by the event_virtual module
policy - subscriber notification policy, can have one of the following values: 'PARALLEL', 'FAILOVER', 'ROUND-ROBIN' (with the behaviour described above)
!! Important: Policies must always be specified as uppercase strings!
subscriber_1 - use the socket syntax for this specific subscriber (eg. "rabbitmq:guest:firstname.lastname@example.org:5672/pike")
The following libraries or applications must be installed before running OpenSIPS with this module loaded: