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
- Setup ircDDBgateway
- ircDDBGateway Configuration using ircddbgatewayconfig
- The ircddbgatewayconfig tool has a series of tabs
- Setup Port Forwarding
- Startup ircDDBGateway as a daemon
- Reflector Host Files
Not recommended, unless you are familiar with the ircddbgateway configuration file and manual editing.
sudo apt-get update sudo apt-get upgrade sudo apt-get install ircddbgatewayd
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
Install ircddbgateway (GUI) and ircddbgatewayd (daemon)
Recommended for new users.
sudo apt-get update sudo apt-get upgrade 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.
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.
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 LANIf 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
- 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)
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 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
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 your configuration, which is stored in a file at /etc/opendv/ircddbgateway in Compass Linux. Exit the program.
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 ~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.
curl -L -s -o upnp.sh https://goo.gl/6ujLeH
chmod +x upnp.sh
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 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
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.
# Edit current File - Deprecated
sudo cp DPlus_Hosts.txt DPlus_Hosts.txt.old
sudo sed 's/^REF\([0-9]\+\)[[:space:]][^a-zA-Z]*$/REF\1\tref\1.dstargateway.org/' <DPlus_Hosts.txt >DPlus_Hosts.txt.new
diff DPlus_Hosts.txt DPlus_Hosts.txt.new # Shows the changes
sudo mv DPlus_Hosts.txt.new DPlus_Hosts.txt
# Alternate way to get updated REFLECTOR and GATEWAY List
# You could create a cron job to update this file periodically as it is constantly updated
sudo cp DPlus_Hosts.txt DPlus_Hosts.txt.old
sudo curl http://ar-dns.net/dplus-gw -o DPlus_Hosts.txt
# Or Just Reflectors
sudo curl http://ar-dns.net/dplus -o DPlus_Hosts.txt
# Restart ircddbgateway/ircddbgatewayd, e.g. for the daemon
sudo systemctl restart ircddbgatewayd
# Similar files exist for DCS, XLX, and DExtra on http://ar-dns.net
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 email@example.com and then send an email to firstname.lastname@example.org Please use the group for questions and to share your experiences, so that all UDRC™ users can benefit from the replies.