mirror of
https://github.com/LX3JL/xlxd.git
synced 2026-01-26 02:14:15 +01:00
837d13d9b4
-Added compiling optimization -Fix warning message compiling with -Wall -Added file startup systemd -Updated file README.md
135 lines
3.6 KiB
Markdown
135 lines
3.6 KiB
Markdown
# 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!
|
|
Path file running xlxd are:
|
|
```
|
|
Exec /xlxd
|
|
Config file /xlxd
|
|
```
|
|
# 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 and up 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 Debian 7 and 8
|
|
```
|
|
# apt-get install apache2 php5
|
|
```
|
|
###### Install webserver with PHP7 support Debian 9 (Stretch)
|
|
```
|
|
# apt-get install apache2 php
|
|
```
|
|
###### Install g++ compiler
|
|
```
|
|
For Debian 8 and 9
|
|
# apt-get install build-essential
|
|
|
|
For Debian 7
|
|
# apt-get install g++-4.7
|
|
```
|
|
###### 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/Systemd/xlxd /etc/init.d/xlxd
|
|
```
|
|
###### Adapt the default startup parameters to your needs
|
|
```
|
|
# pico /etc/init.d/xlxd
|
|
```
|
|
###### Crontab the dmrid.dat from the XLXAPI server to your xlxd folder
|
|
```
|
|
Open file:
|
|
# nano /etc/crontab
|
|
|
|
Add at the bottom of the file
|
|
0 0 * * * root wget -O /xlxd/dmrid.dat http://xlxapi.rlx.lu/api/exportdmr.php
|
|
```
|
|
###### Last step is to declare the service for automatic startup and shutdown
|
|
```
|
|
For Debian 7
|
|
# update-rc.d xlxd defaults
|
|
|
|
For Debian 8 and up
|
|
# cp ~/xlxd/Systemd/xlxd.* /lib/systemd/system/
|
|
# systemctl daemon-reload
|
|
# systemctl enable xlxd.timer
|
|
```
|
|
###### Start or stop the service with
|
|
```
|
|
# service xlxd start
|
|
# service xlxd stop
|
|
# service xlxd restart
|
|
# service xlxd status
|
|
```
|
|
###### Copy dashboard to /var/www
|
|
```
|
|
Debian 7
|
|
# cp -r ~/xlxd/dashboard /var/www/db
|
|
|
|
Debian 8 and up
|
|
# cp -r ~/xlxd/dashboard /var/www/html/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 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)
|
|
|
|
© 2016 Luc Engelmann LX1IQ
|