Serving PTV xServer with Docker

To install and start a PTV xServer with Docker on your local machine please check the system requirements and then proceed with the following steps.

Prerequisites & Preparation

PTV xServer can be started with Docker on every Linux distribution for which Docker is available. We recommend to use a recent version of Ubuntu, CentOS, Fediora, Debian, OpenSUSE or SUSE Linux Enterprise Server.

Server Delivery Package

PTV xServer software comes bundled in a compressed archive.

  1. Simply extract the content to a designated folder.

  2. Make sure that the current user is granted read, write and execute permission for the whole folder.

License

PTV xServer requires a valid license to start and use certain features.

Docker

Docker needs to be installed on the host machine. Find out how to get Docker here.

Configuration

Configure your PTV xServer as described in the other chapters of the Administrator's Guide.

Starting the PTV xServer in a Docker Container

Instead of starting the xServer with the xserver.sh script, execute docker/xserver-docker.sh with one of the following options:

start

Start the server in a new Docker container

stop

Stop a running xServer Docker container

restart

Stop and start the xServer Docker container

Typically, you will place the script in your /etc/init.d directory and start the server from there.

Smoke Testing

After installing Docker and the server and deploying the license file, make sure your installation is correct:

  1. Start the server from the console with the start option of the docker/xserver-docker.sh script. Check the wrapper.log for a message that reads "server started in ... ms".

  2. Start a browser and open http://localhost:port. The default port is 50000; the port used is also listed at the very beginning in thewrapper.log. You should now see the Dashboard.

  3. Open the Raw Request Runner in the section Administration. Select a sample request from the request selector and send the request. You should see the response message as well as the HTTP status code, which should be a 200.

  4. Go to the console you started the server from and shut down the server with the stop option of the docker/xserver-docker.sh script.

Next Steps

PTV xServer can be configured in many ways and lots of additional geographical content can be installed. Please refer to the other chapters in the Administrator's Guide to learn more about your options.