Installing the P8DNS Agent on Linux as a Systemd service


1. Download the  zip package from https://atom.tph.io/

2. Create the directories /opt/p8dns agent

3. Extract it into /opt/p8dns agent

4. On the command line:


cd /opt/p8dns agent
sudo chmod +x bin/*.sh
sudo cp script/p8dns.service /lib/systemd/system/p8dns.service
sudo systemctl enable p8dns.service
sudo systemctl start p8dns.service



To stop the command - sudo systemctl stop p8dns.service


*Requires the latest version of Java to run.




How to configure P8DNS Agent


To set up the P8DNS Agent, you will need to configure the cfg.properties file.


Linux = /opt/P8DNS Agent/conf/cfg.properties.



The file contains the following:

server = 41.79.180.180

token = BSYEB28O

local_dns = 8.8.8.8;8.8.4.4

local_domain =


Variable meanings:


Variable
Description
server
This is the P8DNS IPs of 41.79.180.180 / 41.79.181.181
token
This is your User token configured in P8DNS (This links your P8DNS to the P8DNS Agent)
local_dns
This is the local DNS servers
local_domian
This is the local domain if the Agent is running a windows server



Which P8DNS policy to apply


When you run the P8DNS Agent as the DNS server for your network, it starts filtering with the policy associated with the login token you set up in the config file.


You can add a User's token which can be created under P8DNS console>Users

For a single site, use the default user's token which needs to be created.

For multiple sites, add each user (sites), token to each relevant site.