janus-gateway

Janus Gateway RPM https://github.com/meetecho/janus-gateway

Configuration

Example configuration files are in /opt/janus/etc/janus

Install and start the service

The RPM installs a systemd unit. To enable it and start the service run

# systemctl enable --now janus-gateway

The service is not restarted automatically after RPM upgrades. Remember to run

# systemctl restart janus-gateway

Detailed trace

It is possible to build the RPM with additional libraries that send to standard output a detailed trace and detect memory leaks and faults. This is useful for upstream developers to debug a server crash.

Run rpmbuild defining additional compilation flags. For instance:

$ rpmbuild -D 'dist .ns7' -D 'dbgflags -O0 -fno-omit-frame-pointer -g3 -ggdb3 -fsanitize=address,undefined' janus-gateway.spec

The build requires a modern GCC version with libasan and libubsan dependencies. On CentOS 7 it is possible to install it from SCLo.

See also the .travis.yml in this repository for more information.

Once the RPM with additional libraries is installed:

Add a local systemd unit override fragment, by running systemctl edit janus-gateway.service.
```
[Service]
Environment="SOFIA_DEBUG=9"
ExecStart=
ExecStart=/bin/bash -c 'exec /opt/janus/bin/janus -o -d 7 -L /dev/null &>/var/log/janus-trc.log.$$$$'
```
As alternative copy the above fragment to /etc/systemd/system/janus-gateway.service.d/override.conf and run systemctl daemon-reload.
Check the changes are in place:
```
systemctl cat janus-gateway
```
Restart the service (when possible):
```
systemctl restart janus-gateway
```
Check the status. The current log file is /var/log/janus-trc.log.PIDNUM, where PIDNUM is the server main process PID:
```
systemctl status janus-gateway
```

To clean up the above setup:

rm -f /etc/systemd/system/janus-gateway.service.d/override.conf
systemctl daemon-reload

Then restart the service.

Building a release RPM

Ensure the release commit hash is set in the .spec file
Fix the .spec file Version and Release tag
Write the %changelog entry in the .spec file
Commit the above changes
Create a git tag that starts with a digit. Do not use any "-" (minus) sign! E.g.: 0.12.1r2
Push the tag and the commit to start the automated build on Travis CI

Builds started from a tagged commit are published to "updates"!

More information: https://docs.nethserver.org/projects/nethserver-devel/en/v7/building_rpms.html