Running OverSIP in Debian and Ubuntu

The Gem provides an executable oversip whose location depends on the operating system:

• In Debian it is located in the /var/lib/gems/1.9.1/bin/ directoy (so not in the default PATH).
• In Ubuntu it is located in the /usr/local/bin/ directory.

Anyhow, in Debian and Ubuntu OverSIP must be managed via the init script which works as follows:

The init script

The provided /etc/init.d/oversip init script follows the LSB specifications. The script is called with one of the following arguments:

start

It starts OverSIP (unless it’s already running). It also checks whether the RUN variable has been set to yes in the default file (/etc/default/oversip).

stop

It stops OverSIP.

restart / force-reload

It performs both stop and start actions.

reload

It sends a HUP signal to the OverSIP master process causing it to reload the configuration files under /etc/oversip/ (all but oversip.conf which is not reloaded).

user-reload

It sends a USR1 signal to the OverSIP master process causing it to invoke the OverSIP::SystemEvents.on_user_reload callback.

status

It returns the process status according to the LSB specifications.

The default file

The DEB package also installs a default file /etc/default/oversip with the following variables:

RUN

Set it to yes after configuring OverSIP. Otherwise the init script will fail to start.

USER and GROUP

The system user and group OverSIP will run as. By default oversip (a system user created by the DEB package).

CONFIG_DIR

Directory with the configuration files. By default /etc/oversip/.

CONFIG_FILE

Main configuration file name (within the configuration directory CONFIG_DIR). By default oversip.conf.