Project-docker

Docker image for pinpointing experiments. It runs a simple HTTP server using which the experiments can be started.

Prerequisites:

docker for running the experiments container
java v.8+ and maven v.3+ for compiling the docker image

How to run

Clone the repository

git clone https://github.com/JoergSchwabe/Project-docker.git

In Windows:

git clone https://github.com/JoergSchwabe/Project-docker.git --config core.autocrlf=input Project-docker

Invoke the following command in the root directory of the repository:
```
mvn clean install docker:build docker:start
```
This command will create and run a docker image with name 'JoergSchwabe/Project-docker', from which docker containers can be created and started.
Invoke the following command to stop the run and remove the docker image:
```
mvn docker:stop docker:remove
```

More commands

Invoke the following command:
```
mvn docker:start
```
This creates and runs the container with the experiments called pinpointing-container, which is accessible on the port 3030.

Alternatively, one can create and start the container using the docker command shown in Quick Start. There one can also change the port value 3030 or the name pinpointing-container to different values.

If access to the files generated by the experiments is needed, the following option can be added to the command shown in Quick Start before the last argument:
```
--mount type=bind,source=/absolute/path/on/host/machine,target=/home/pinpointing/workspace
```
The directory under /absolute/path/on/host/machine must exist. The experiments will save all the generated files into it and then they can be accessed from the host machine. According to the Docker documentation this is a better solution than leaving the files in the container. Potential problem is that this is a huge amount of small files, so if they are not removed after the experiments, there may be space problems on the host machine. If this option is not used, generated files are removed when the container is removed.
Point your browser to the address of the host machine with the configured port, e.g., http://localhost:3030/.

If the server is not available, or there are other problems, one can inspect the container output log using
```
docker logs pinpointing-container
```
Use the web interface to configure and run the experiments.

While the container is running, one can connect to it from the shell, which is useful for inspecting the files in case of problems:
```
docker exec -it pinpointing-container bash
```
To stop the web server run:
```
mvn docker:stop
```
If the contaner was started using the docker command, use:
```
docker stop pinpointing-container
```
Replace the name accordingly. To see all running use:
```
docker ps
```
To remove the container in case it is no longer needed run:
```
mvn docker:remove
```
or using the docker command:
```
docker rm -v pinpointing-container
```
Removing the container may take asome time. Please be patient. To see all available containers use:
```
docker ps -a
```

ykazakov/docker-satpinpointing-experiments

Project-docker

Prerequisites:

How to run

More commands

See also