From openSIPS

Documentation: Binary Internal Interface - ver 1.10

Documentation -> Manuals -> Manual 1.10 -> Binary Internal Interface

Pages for other versions: devel 3.4 3.3 3.2 3.1 Older versions: 3.0 2.4 2.3 2.2 2.1 1.11 1.10


Binary Internal Interface v1.10
Prev

The Binary Internal Interface is an OpenSIPS core interface which offers an efficient way for communication between individual OpenSIPS instances. This is especially useful in scenarios where realtime data (such as dialogs) cannot be simply stored in a database anymore, because failover would require entire minutes to complete. This issue can be solved with the new internal binary interface by replicating all the events related to the runtime data (creation / updating / deletion) to a backup OpenSIPS instance.


Configuring the Binary Internal Interface listeners

In order to send or listen for Binary Packets, an interface must be specified using the bin_listen global script parameter. The number of listener processes can be tuned with the optional bin_children (default: 1)

   bin_listen = 10.0.0.150:5062
   bin_children = 2

Currently, the only module to make use of the interface is the dialog module, which can now replicate all dialog-related events to one or more OpenSIPS instances. Configuration can be done as follows:

   modparam("dialog", "accept_replicated_dialogs", 1)
   modparam("dialog", "replicate_dialogs_to", "78.46.64.50:5062")

More details can be found in the documentation page of the module.


C Interface Overview (for module developers)

The interface allows the module writer to build and send compact Binary Packets in an intuitive way.

In order to send packets, the interface provides the following primitives:


In order to receive packets, a module must first register a callback function to the interface:


Each time this callback is triggered, the information can be retrieved in the same order it was written using:

Retrieved from https://www.opensips.org/Documentation/Interface-Binary-1-10
Page last modified on September 23, 2013, at 05:58 PM