This manual describes the necessary steps to install a new DAPNET Core node on a linux running machine. Please inform us about any mistakes or misunderstandable descriptions. Overview

The Node program consists of two parts:

• The DAPNET-Core as the main control programm for all DAPNET actions
• The DAPNET-Web as the Web frontend

We assume a fresh debian based linux system where you have root access. The user the DAPNET Core will run on is „dapnet“ in this manual. Choose whatever fits to you system setup. Create this user. Google how to do this on your linux system. The dapnet Core does not need root rights to run.

The following software packages are needed

• git
• maven
• Java 1.8

You need to install java 1.8 following this link. After having installed java, install the rest with

sudo apt-get install git maven

Make a directory /opt/dapnet

sudo mkdir /opt/dapnet

Make dapnet the owner of this directory

sudo chown dapnet /opt/dapnet

Change to user dapnet. If you don't have a user dapnet on your system, make one. If you don't know how, ask google.

su dapnet

Change to

cd /opt/dapnet

and download the newest version from github.

git clone https://github.com/DecentralizedAmateurPagingNetwork/Core.git
git clone https://github.com/DecentralizedAmateurPagingNetwork/Web.git

Compile the Core:

cd Core
mvn clean package

The compiled files are now in the directory target. In order not to loose your config make a directory named „local“

mkdir /opt/dapnet/Core/local

Generate three more dircetories

mkdir /opt/dapnet/Core/local/config
mkdir /opt/dapnet/Core/local/data
mkdir /opt/dapnet/Core/local/logs

Copy the example config files to /opt/dapnet/Core/local/config:

cp /opt/dapnet/Core/example_config/* /opt/dapnet/Core/local/config

Edit /opt/dapnet/Core/local/config/ClusterConfig.xml

<TCPPING initial_hosts="44.225.164.27[7800],44.225.164.162[7800]"

If the Core is behind NAT, activate the following section by removing the <!– and –> and enter your outbound HAMNET-IP.

<!-- FOR CORE BEHIND NAT USE
   <TCP bind_port="7800"
         external_addr="44.225.x.x"
         loopback="true"/>
-->

Contact us or one of the existing Core sysops and get the password. We assume hier it is „geheim“. So put the real one in the line:

auth_value="geheim"/>

At the bottom, put the callsign of the core in lowercase. The example here ist db0abc

<pbcast.GMS name="db0abc@DAPNET"

That's all for now.

Change to

cd /opt/dapnet/Core/local

and start at screen, so the program keeps running even if your SSH connection is closed

sudo apt-get install screen

(if not already installed)

screen

You can leave the screen with CTRL+A D. New attachment to the screen with screen -r .

Start the core:

cd /opt/dapnet/Core/local
java -Dlog4j.configurationFile=../local/config/LogSettings_REST.xml -jar ../target/dapnet-core.jar

Replace the jar filename with the right one you just compiled. It may change in the development process.

If you don't like the screen and better want a systemd service to start at boot time, have a look at

https://github.com/DecentralizedAmateurPagingNetwork/Core/tree/master/util/systemd

All cores have to be able to reach each other directly by HAMNET IPs (44.0.0.0/8). If you do not have native HAMNET access, consider the PPTP manual and ask us for a static IP and user/password combination.

The source code is already downloaded to

/opt/dapnet/Web

. Now install the apache2 webserver and the php module if not already present.

apt-get install apache2 libapache2-mod-php5

Edit

/etc/apache2/sites-availabe/000-default.conf

and change

DocumentRoot /opt/dapnet/Web/dist

Insert below this line:

<Directory /opt/dapnet/Web/dist>
                Options Indexes FollowSymLinks
                AllowOverride None
                Require all granted
</Directory>

Restart the apache.

sudo service apache2 restart

Change to

cd /opt/dapnet/Web

and follow the instructions on Github.

Now the web interface is accessable on http://YOURURL .

Ask us for your personal login data and happy paging.