Installation Docker (including DVDStore Application)

Owned by Simon Becker
Last updated: Jul 24, 2015 by Andreas Reinhardt
3 min read

This page provides information on how inspectIT can be used with the open source container virtualization software Docker. The provided Docker image is based on the official JBoss image and already includes the inspectIT agent as well as a sample Application (DVDStore) allowing you to start right away. To utilize the given image you will need a Docker installation.

Quickstart

There are two ways to get inspectIT running inside docker containers:

  1. If you have Docker Compose installed on your linux system, just use our docker-compose.yml to start the whole stack.

  2. Otherwise you will need to start two containers manually and link them to each other(one for the CMR and one for JBoss/inspectIT/DVDStore):

    1. First start the CMR container by entering the following command:

      $ docker run -d --name inspectIT-CMR -p 8182:8182 -p 9070:9070 inspectit/cmr

      This command pulls the inspectit/cmr image from Docker Hub if you don't already have it available locally. Explanation of used options:

      1. -d: runs the container in the background

      2. --name inspectIT-CMR: assigns the given string as container-name
      3. -p 8182:8182: maps the port 8182 from the container to port 8182 of your docker host (needed for communication with the inspectIT GUI)
      4. -p 9070:9070: maps the port 9070 from the container to port 9070 of your docker host (needed for communication with the inspectIT Agent)

    2. When the CMR is running you can launch the inspectit/dvdstore image:

      $ docker run -d --name inspectIT-dvdstore -h dvdstore -p 8080:8080 --link inspectIT-CMR:cmr inspectit/dvdstore

      Again the image will be pulled from Docker Hub if you launch it for the first time. Explanation of used options:

      1. -h dvdstore: sets the Container hostname to "dvdstore"

      2. --link inspectIT-CMR:cmr: Establishs a link to the inspectIT-CMR container we launched in a). 

    Now you have set up your containers and should be able to access the DVDStore Application via your webbrowser by entering http://127.0.0.1:8080/dvdstore.

    Note: if you use a boot2docker setup (Windows or Mac) and your docker-host is running inside a VirtualBox, use the corresponding IP of your VBox instead. You get this by entering "boot2docker ip" in your boot2docker Start Shell (typically it is 192.168.59.103).

Connect with inspectIT UI (Client)

The UI-client can be downloaded from www.inspectit.eu. By default the client will start with a pre defined "Local CMR" - IP: 127.0.0.1:8182. Now you should see a registered Loacl CMR and a connected agent. The name of the agent equals the container id or if you specified a name (as we did: "dvdstore") it is called like this.

Note: In a boot2docker setup the containers are running inside your VirtualBox. For this reason you will need to add another CMR which is listening on the IP of your VirtualBox instead of localhost. To add the CMR just click the green plus-symbol ('+'). You will be asked for the CMR name, IP, port and an optional description. As IP just enter the IP of your VBox, the port stays the same as mentioned above (8182). After you are done with this step you should see a new CMR (in the screenshot below it is called "Docker CMR DVDStore-example") and a connected agent named "dvdstore".