Deploying Hypersocket VM in Docker

Pre-requisites: A system that already has docker installed. For the below examples, docker was installed on a Linux Mint operating system.

 

Persisting data

As changes will be made to the Hypersocket configuration, these will need to be saved separately as Docker does not do this by default. There are two locations where changes will be written, so we first need to create a new volume for each of these locations with these commands:

docker volume create --name hypersocket-one-data

docker volume create --name hypersocket-one-mysql

 

Deploying a Virtual Machine

It is incredibly easy to run a hypersocket image in docker. A VM can be downloaded and run with just a single command, but we also want to add the above 2 volumes that were created for configuration changes:

sudo docker run -d  -v hypersocket-one-mysql:/var/lib/mysql -v hypersocket-one-data:/opt/hypersocket-one -p 443:443 hypersocket/hypersocket-one

 

The -d flag tells docker to start up the VM in a detached state

The -p flag defines which port to forward from the host server through to the image. In this case, the Linux Mint host has no web server installed, so we can just forward the standard HTTPS port through to the image.

 

Finding Hypersocket image names

You can find out the name of the image you want to use by issuing the following command: sudo docker search hypersocket.

The below image shows the FTS, VPN, SSO and Nervepoint Access Manager products. Note that when running the images you must refer to them by their full name - i.e hypersocket/hypersocket-one

 

 

 

Checking VM status

You can see if the image is running with the docker ps command. Note here that you can see the Container ID which is required for stopping the container. You can also see the port that was mapped.

 

For more information on how to use Docker, you can take a look at the docker user guide here:

https://docs.docker.com/engine/userguide/intro/

 

Accessing the Hypersocket server

Simply open up a browser and point it at the Docker machine's host IP address on the port number that you used in the port forward command (in this case, we used the standard HTTPS port 443).

You should be presented with the Setup Wizard. Follow this wizard, after which you should be able to log on to the server and begin to set up your users and resources.

 

 

Stopping the docker container

First get the container ID using docker ps. You can stop a container by issuing the docker stop command (note that you only need to type in the first few characters of the Container ID).

For example, in the below image we were able to stop the container by just typing: docker stop 9e

 

Note: As Docker is a containerised VM host, the VMCentre that runs on other Hypersocket VM images is not available, neither are other methods of access such as SSH.

 

Have more questions? Submit a request

Comments