1
0
mirror of https://github.com/ShaYmez/xlxd.git synced 2024-11-17 13:41:49 -05:00
xlxd/README.md
Luiz Fernando Ribeiro Amaral a9911d3042 New XLX dashboard layout
- A dashboard with the new layout is contained in the dashboard2 folder.
- Enhanced the styling of the README file.
2016-07-05 11:08:29 -06:00

2.7 KiB

Copyright

© 2016 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) 
Download and compile the XLX sources
# git clone https://github.com/LX3JL/xlxd.git
# cd xlxd/src/
# make
# make clean
# 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
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)
  • UDP port 10001 (json interface XLX Core)
  • UDP port 10002 (XLX interlink)
  • TCP port 22 (ssh) optional TCP port 10022
  • UDP port 30001 (DExtra protocol)
  • UPD port 20001 (DPlus protocol)
  • UDP port 30051 (DCS protocol)

© 2016 Luc Engelmann LX1IQ