Connecting a Physical Server

This guide walks through setting up a physical, Linux server to connect to the ENF. The guide was created on an Ubuntu 18.04 (Bionic Beaver) machine, but should be compatible with most Debian-based distribution. NOTE: As of June 2020, this guide will not work on Ubuntu 20.04 (Focal Fossa)

Source code and detailed instructions are available in the Xaptum enftun repository on github.

Installation

  1. Install the Xaptum API Repository GPG signing key.
    > sudo apt install dirmngr
    > sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys c615bfaa7fe1b4ca
    
  2. Add the repository to your APT sources
    Since this how-to was run on Ubuntu 18.04 / Bionic Beaver, the distribution is bionic. Replace this with the appropriate distribution name.
    The following packages are available:
    • bionic (Bionic Beaver - Ubuntu 18.04)
    • buster (Debian 10)
    • stretch (Debian 9)
    • jessie (Debian 8)
      > echo "deb http://dl.bintray.com/xaptum/deb bionic main" | sudo tee /etc/apt/sources.list.d/xaptum.list
      > sudo apt update
      
  3. Install the enftun library.
    > sudo apt install enftun
    

Configure systemd Unit File

The enftun package includes sample systemd unit files. We will use the server sample as our example.

  1. Copy the the sample server.conf file into /etc
    > sudo cp /usr/share/doc/enftun/example/server.conf /etc/enftun/enf0.conf
    

We will start the enf services after generating the keys.

Generate ENF Access Keys

Each machine is one endpoint on the ENF and is identified by its IPv6 address. Each endpoint needs its own credentials.

The enftun-keygen utility helps in creating the credentials. The utility was installed with the enftun package.

  1. Create the directory that will hold the certificate files.
    > sudo mkdir -p /etc/enftun/enf0
    
  2. Create the Access Keys.
    Follow the prompts and enter the appopriate passwords.
    > sudo enftun-keygen -c /etc/enftun/enf0.conf       \
                      -u JohnQPublic@somecompany.com \
                      -a 2607:8f80:8080:b::deb:c002
    

Start ENF using systemd

  1. Enable enf0 to start on boot
    > sudo systemctl enable enftun@enf0
    
  2. Start enf0 manually. This avoids having to reboot.
    > sudo systemctl start enftun@enf0
    
  3. Verify that the new endpoint is connected to the ENF.
    At this point, the client machine should show up as ONLINE on the ENF dashboard.
    • Navigate to the control panel website and log in.
    • Click on the Network link. In this example, it is: 2607:8f80:8080:b::/64
    • The Endpoints list should show the new addresse as being ONLINE.

Additional Resources

Didn't find what you were looking for?

Contact us and we’ll get back to you as soon as possible.

Contact Us