mirror of https://github.com/ShaYmez/xlxd.git
140 lines
4.0 KiB
Markdown
140 lines
4.0 KiB
Markdown
# 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 don’t need to register your XLX at ysfreflector.de !
|
||
Nevertheless it is possible.
|
||
|
||
© 2016 Jean-Luc Deltombe (LX3JL) and Luc Engelmann (LX1IQ)
|