Setup ircDDBgateway
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
sudo ircddbgatewayconfig
It may take a long time to startup, perhaps 2 minutes.
The ircddbgatewayconfig tool has a series of tabs
Gateway Tab
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.
Additional Repeaters
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.
- Tell the Gateway that the RP2C is at 192.168.0.3 (or your equivalent IP) and listening on port 20000 see address and port here.
- Tell the Gateway to listen for the RP2C by changing "Local Icom Address" to 192.168.0.2 (or 0.0.0.0) and "Local Icom Port" to 20000, in other words, listen for the controller on 192.168.0.2:20000
- 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)
ircddb Network
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.
OpenQuad Network
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.
Enable DExtra
This is for XRF reflectors and gateway to gateway linking as well as AMBE device (ThumbDV/PiDV/...) connections.
Enable DPlus
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.
Enable DCS/CCS
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.
Miscellaneous Functions
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
cd ~
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.
cd ~
~/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 reboot
sudo systemctl status ircddbgatewayd
Dashboard
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
cd /tmp 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 do if grep -Fq "# Prepared at ar-dns.net" "$hosts" then echo "Copying $hosts" sudo cp "$hosts" /usr/share/opendv else echo "$hosts Bad, not copied" fi rm "$hosts" done 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!
NW Digital Radio is in the process of setting up various community groups at Groups.io Please create a personal account at Groups.io Join the main NW Digital group by sending an email from your registered email account to main+subscribe@nw-digital-radio.groups.io and then send an email to udrc+subscribe@nw-digital-radio.groups.io Please use the group for questions and to share your experiences, so that all UDRC™ users can benefit from the replies.