Introduction

Our Performance PCE server is provided as a containerised solution using Docker.

Docker is a Linux-based technology, and requires a virtualised Linux environment to be able to run on Windows.

You can create your own Linux environment and follow instructions on the 'Linux Setup' page, however, to make things simple AFD can provide a pre-configured Virtual Appliance for you to download and import into Hyper-V, Microsoft's Virtualisation technology for Windows Servers.

Please contact Support on 01624 811712 or email support@afd.co.uk confirming your account details, and we can build and supply this virtual machine for you.

Installation

Installing Hyper-V

If you do not already have Hyper-V enabled, the below instructions describe how to do this. This should be carried out by a systems administrator and will require a restart of the server.

The server must be 64-bit Windows Server 2008, 2012 or 2016

The server must support hardware assisted virtualisation (Intel VT or AMD-V). If supported, this can be enabled in the BIOS, you can check if this is available / enabled by opening a command prompt and typing "Systeminfo". The Hyper-V Requirements line will detect if Hyper-V is enabled, otherwise it will display missing features.

  1. Open Server Manager and click "Add Roles and Features" from the dashboard

  2. On the Installation Type screen, select "Role-based or feature-based installation" and click Next

  3. On the Select destination server screen, select the server to install Hyper-V on and click Next

  4. On the Select server roles screen, tick "Hyper-V" from the list of roles and click Next

  5. Click Next on the features screen and finally Install to complete the installation

The server will require a restart for the new Hyper-V role to be installed.

Importing the PCE Virtual Appliance into Hyper-V

AFD will have provided a Zip file containing the Virtual Machine, extract this to a location where the machine hard drive will be stored.

In the Windows / Start menu type "Hyper-V" and open up the Hyper-V manager.

From the "Action" menu, select "Import Virtual Machine" and browse to the folder where the PCE Server has been saved, it should be called AFDPCE.

Select the Virtual Machine to import and click next.

For the type of import, the first option will import the Virtual Machine and keep the files in the existing location rather than copying them to a new location.

The server has been configured to use "Default Switch" as the network, if you have a different network you can select this during the installation.

Starting the PCE Server

Select the AFDPCE server under Virtual Machines and click the "Start" button on the right panel.

Once the server has finished startup, the IP address should be displayed on the networking tab.

Test that this works by sending a PCE request to the IP address on port 8081, e.g.:

http://localhost:8081/afddata.pce?data=address&task=fastfind&fields=list&lookup=b111aa&serial={{serial}}&password={{password}}