xlxd/README.md

4.0 KiB
Raw Permalink Blame History

Copyright

© 2016 Jean-Luc Deltombe LX3JL and Luc Engelmann LX1IQ

The XLX Multiprotocol Gateway Reflector Server is part of the software system for the D-Star Network. The sources are published under GPL Licenses.

Usage

The packages which are described in this document are designed to install server software which is used for the D-Star network infrastructure. It requires a 24/7 internet connection which can support 20 voice streams or more to connect repeaters and hotspot dongles!!

  • The server requires a fix IP-address !
  • The public IP address should have a DNS record which must be published in the common host files.

If you want to run this software please make sure that you can provide this service free of charge, like the developer team provides the software and the network infrastructure free of charge!

Requirements

The software packages for Linux are tested on Debian7 (Wheezy) 32 and 64bit or newer. Raspbian will work but is not recommended. Please use the stable version listed above, we cannot support others.

Installation

Debian 7 (Wheezy) 32 and 64bit

After a clean installation of debian make sure to run update and upgrade
# apt-get update
# apt-get upgrade
Install Git
# apt-get install git git-core
Install webserver with PHP5 support
# apt-get install apache2 php5
Install g++ compiler
 # apt-get install build-essential
 # apt-get install g++-4.7 (skip this step on Debian 8.x) 
After downloading and before compiling, please have a look at the main.h file
 # nano /xlxd/src/main.h

 For YSF you need to define a default HotSpot frequency !!!

Download and compile the XLX sources
# git clone https://github.com/LX3JL/xlxd.git
# cd xlxd/src/
# make clean
# make
# make install
Copy startup script "xlxd" to /etc/init.d
# cp ~/xlxd/scripts/xlxd /etc/init.d/xlxd
Adapt the default startup parameters to your needs
# pico /etc/init.d/xlxd
Download the dmrid.dat from the XLXAPI server to your xlxd folder
# wget -O /xlxd/dmrid.dat http://xlxapi.rlx.lu/api/exportdmr.php
Check your FTDI driver and install the AMBE service according to the readme in AMBEd
 
Last step is to declare the service for automatic startup and shutdown
# update-rc.d xlxd defaults
Start or stop the service with
# service xlxd start
# service xlxd stop
Copy dashboard to /var/www
# cp -r ~/xlxd/dashboard /var/www/db
Give the dashboard read access to the server log file
# chmod +r /var/log/messages 
Reboot server to see if the auto-start is working
# reboot

Firewall settings

XLX Server requires the following ports to be open and forwarded properly for in- and outgoing network traffic:

  • TCP port 80 (http) optional TCP port 443 (https)
  • TCP port 8080 (RepNet) optional
  • UDP port 10001 (json interface XLX Core)
  • UDP port 10002 (XLX interlink)
  • TCP port 22 (ssh) optional TCP port 10022
  • UDP port 42000 (YSF protocol)
  • UDP port 30001 (DExtra protocol)
  • UPD port 20001 (DPlus protocol)
  • UDP port 30051 (DCS protocol)
  • UDP port 8880 (DMR+ DMO mode)
  • UDP port 62030 (MMDVM protocol)
  • UDP port 10100 (AMBE controller port)
  • UDP port 10101 - 10199 (AMBE transcoding port)
  • UDP port 12345 - 12346 (Icom Terminal presence and request port)
  • UDP port 40000 (Icom Terminal dv port)

YSF Master Server

Pay attention, the XLX Server acts as an YSF Master, which provides 26 wires-x rooms. It has nothing to do with the regular YSFReflector network, hence you dont need to register your XLX at ysfreflector.de ! Nevertheless it is possible.

© 2016 Jean-Luc Deltombe (LX3JL) and Luc Engelmann (LX1IQ)