2016-07-05 12:29:40 -04:00
|
|
|
|
# Copyright
|
|
|
|
|
|
|
|
|
|
|
|
<EFBFBD> 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)
|
|
|
|
|
|
|
|
|
|
|
|
<EFBFBD> 2016 Luc Engelmann LX1IQ
|
