Operations

Operations

This page collects operational commands and checks used when running GABPBX.

Service Control

Systemd deployments commonly use:

systemctl stop gabpbx
systemctl start gabpbx
systemctl status gabpbx
journalctl -u gabpbx

For crash debugging, run GABPBX under gdb instead of the service manager.

CLI

Start foreground console:

gabpbx -vvvc

Connect to a running instance:

gabpbx -r

Run one command:

gabpbx -rx "core show version"

Useful commands:

core show version
core show channels
core show channel <name>
module show
module show like <name>
logger reload
dialplan reload
manager show connected
rtp set debug on
rtp set debug off

For chan_sofia:

sip show settings
sip show peers
sip show peer <peer>
sip show channels
sip show inuse
sip set debug on
sip set debug peer <peer>
sip set debug ip <addr>
sip show blacklist

Logging

Main config:

configs/logger.conf.sample

Reload:

*CLI> logger reload

When debugging SIP, collect:

• GABPBX console logs.
• sip set debug output.
• Packet capture with tcpdump or sngrep.
• AMI events if monitoring behavior is involved.

Packet Capture

Examples:

tcpdump -i any -n -s 0 -w /tmp/gabpbx-sip.pcap udp port 5060
tcpdump -i any -n -s 0 -w /tmp/gabpbx-rtp.pcap portrange 10000-20000

Use sngrep for SIP ladder inspection when available.

Build Hygiene

Normal build:

./configure
make
make install

Avoid make clean or make dist-clean unless intentionally resetting build state, because it forces much more recompilation.

Git Hygiene

For the public GitHub repository:

• Keep main protected.
• Work through branches and pull requests for public changes.
• Do not commit local memory/private documentation.
• Keep generated build artifacts out of the repository.
• Keep source files needed to build from a fresh clone tracked.

default.exports is a required source/build support file and must be tracked.

SIP Production Checklist

• Disable guest calls unless required.
• Use strong peer secrets.
• Configure NAT: externaddr, localnet, nat=force_rport,comedia.
• Keep directmedia=no until RTP is proven.
• Configure call limits on trunks.
• Disable REFER transfers on untrusted trunks.
• Monitor authentication failures and blacklist entries.
• Verify RTP both directions before and after transfers.
• Verify codecs on both call legs.
• Restart GABPBX when switching SIP channel drivers.