This example is on Compass Linux for the UDRC as dstarrepeater 1
You can pull and edit a seed file or use the GUI tool to edit the configuration file.
ircDDBGateway Configuration non-GUI
Install non-gui ircddbgatewayd
Not recommended, unless you are familiar with the ircddbgateway configuration file and manual editing.
sudo apt-get update
sudo apt-get install ircddbgatewayd
Get the seed file for ircddbgateway
sudo curl -L -s -o /etc/opendv/ircddbgateway https://raw.githubusercontent.com/nwdigitalradio/udrc-tools/master/udrc-setup/ircddbgateway
Edit and save /etc/opendv/ircddbgateway
ircDDBGateway Configuration using ircddbgatewayconfig
Install ircddbgateway (GUI) and ircddbgatewayd (daemon)
Recommended for new users.
sudo apt-get update
sudo apt-get install ircddbgateway ircddbgatewayd
This install will also install ircddbgatewayconfig
Start the ircddbgatewayconfig tool in a terminal
It may take a long time to startup, perhaps 2 minutes.
The ircddbgatewayconfig tool has a series of tabs
Set the Callsign to the callsign you have registered at ircDDB.net or to your callsign if you do not have a registration.
Setting the Local HB Address to 0.0.0.0 will cause ircddbgateway to listen on all IPv4 addresses on the computer. This is useful if you have other repeaters at different IP addresses. If all repeaters are attached to the same computer, then use 127.0.0.1. Leave the Local HB Port at the default 20010. The Icom settings should be left as set, in case you have an Icom ID-RP2C attached, now or in the future.
Repeater 1 - 1st Tab
Leave the Address at 127.0.0.1 for a dstarrepeater (UDRC) that is on the same computer. The Port is the UDP port the dstarrepeater is configured to listen on, the default for the first repeater is 20011. Leave the port at the default unless you have more than one device attached. The IP address and port may need to be changed if you have additional repeaters attached to the gateway.
You may also set a default Reflector and whether to connect at Startup and whether to Reconnect after a period of inactivity or to stay continuously linked to a fixed reflector.
Repeater 1 - 2nd Tab
This tab is self explanatory.
Follow the same steps for additional repeaters. Note how a different IP address can be used if the dstarrepeater (UDRC or Other) is on the LAN or even over the Internet.
If this repeater was on the same computer, the Address would be 127.0.0.1 and at a different UDP port, like 20012.
A Repeater on an Icom ID-RP2C
Note: If you have migrated from a G2 system, the 10.x.x.x network is not needed on ircddbgateway. You can set the LAN address on your router to 172.16.0.x (like 172.16.0.254) and set your Pi's network configuration to point to that address as its Internet gateway.
If your LAN uses a different net, eg. 192.168.0.x/24, you can set the ID-RP2 to use an address on that network and adjust settings accordingly or put a second IP address on the eth0 of the Raspberry Pi -- see https://wiki.debian.org/NetworkConfiguration#Multiple_IP_addresses_on_one_Interface
ID-RP2C+ircDDBgateway+router on a single LAN
If you only want to use a single network port and LAN it is a simple networking problem, just keep your addresses and ports straight.
Using the illustration (replace IP addresses as appropriate on your network)
- Set Gateway to address 192.168.0.2 and port to 20000
- Set Communications Settings to IP Address 192.168.0.3 and port to 20000 with appropriate netwmask (usually 255.255.255.0)
That's it. A simple network configuration.
For ircDDB.net registered gateways, enable ircDDB, select the server Hostname (Group2-irc in the Americas, Group1-irc for the rest of the world). Along with the Username and Password from your registration.
If your gateway is not registered on ircddb.net, then disable this tab.
For unregistered gateways or as a second network, enable ircDDB, select the server Hostname (rr.openquad.net) and your callsign as the Username. Leave the Password empty. We use the ircDDB 2nd Network tab for this entry. Most gateways will enable this feature for maximum connectivity.
You can be connected to both networks.
Enable DPRS Reporting
Enable and put in an APRS-IS Hostname and Port.
This is for XRF reflectors and gateway to gateway linking as well as AMBE device (ThumbDV/PiDV/...) connections.
This will connect to REF reflectors as a hotspot style connection, as well as gateway and AMBE device connections. The Login is a US Trust registered callsign, use your personal callsign if you don't have a club callsign registered as a user. DO NOT USE 'CALLSIGN' AS IN THE EXAMPLE, USE A US TRUST REGISTERED CALLSIGN.
This allows connection to DCS reflectors and initiating CCS links. Select a CCS Server
Enable Remote Control
Select a Password and UDP Port. This allows remote control of the gateway through programs including applications for the iPhone and Android.
Select your preferred Language and various functions.
Save and Exit
Save your configuration, which is stored in a file at /etc/opendv/ircddbgateway in Compass Linux. Exit the program.
Setup Port Forwarding
Jim Moen, K6JM has put together a good list of ports needing forwarded from your router to the Gateway.
Based on Jim's list, it is possible to use a script on Linux to automatically update port forwarding based on UPNP.
Get the tool to update UPNP entries
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install miniupnpc
Download the script
curl -L -s -o upnp.sh https://goo.gl/6ujLeH
chmod +x upnp.sh
This script was tested against a MikroTik router, but should work with other UPNP capable routers. You may have to enable the UPNP feature on the router.
Note: You may edit the script to open your Remote Control port, if you have configured one.
Using the script is very easy. It takes two arguments. The first is the interface used for the Internet, typically eth0 or wlan0. The second is either start to load the rules or stop to unload them.
~/upnp.sh eth0 start
~/upnp.sh eth0 stop
You may have to rerun the script if your router changes its public IP or is rebooted, depending on your router's capabilities. This script should be run on reboot of the gateway computer, or if the gateway computer gets a new IP based on DHCP leases.
Startup ircDDBGateway as a daemon
Startup the daemon and observe the log.
sudo systemctl start ircddbgatewayd
sudo tail -f /var/log/opendv/ircddbgatewayd.log
Once you are satisfied all is working, setup ircddbgatewayd to automatically start on boot up.
sudo systemctl enable ircddbgatewayd
Reboot and verify that ircddbgatewayd is running
sudo systemctl status ircddbgatewayd
If you would like a web based real time dashboard for ircDDBGateway, check out the real time dashboard at ircNodeDashboard
Reflector Host Files
The reflector host files can be found in /usr/share/opendv
cd /usr/share/opendv ; ls -l *.txt
Here is a little procedure to change all IP based REFxxx references to use their DNS name instead. Available as pull-hosts.sh
curl -o DCS_Hosts.txt http://ar-dns.net/dcs
curl -o DExtra_Hosts.txt http://ar-dns.net/dextra-gw
curl -o DPlus_Hosts.txt http://ar-dns.net/dplus-gw
for hosts in DCS_Hosts.txt DExtra_Hosts.txt DPlus_Hosts.txt
if grep -Fq "# Prepared at ar-dns.net" "$hosts"
echo "Copying $hosts"
sudo cp "$hosts" /usr/share/opendv
echo "$hosts Bad, not copied"
echo "Restart ircddbgateway to use new files ..."
This Wiki page is offered as a courtesy of NW Digital Radio, technical support for ircddbgateway is on Yahoo!