Testing Mode

Testing mode is a simple way to test our whether or not Plumbr is a fit for your needs. Whenever you need to carry out a proof-of-concept project or a demo, this is the recommended way to start. When you are ready for production deployments, choose the production mode installation instead.

System requirements

When installing Plumbr Server using the Dockerfile, both Java EE server and database server are installed to the same machine. This machine would need to comply to following requirements:

  • CPU: Plumbr Server can run on any modern server class machine. Performance comparable to EC2 T2.Medium instance would be adequate.
  • Memory: It is recommended to at least 4G memory on the machine
  • Disk storage: depends on the number of JVMs monitored.  On average 1.1G of disk storage is required per monitored JVM per month
  • Operating system: As Docker images can be run only on Linux, all Linux distro capable of running Docker containers is suitable.

Installing

Installing Plumbr Server using Docker builds and launches a Docker image using the Dockerfile. For this you need to go through the following steps:

  1. Get root access to a Linux machine corresponding to system requirements above.
  2. Install Docker, using the installation guide on Docker site.
  3. Download Dockerfile from the Plumbr Download Center.
  4. Build the Docker image named plumbr-docker by launching “docker build -t plumbr-docker –build-arg username=<your-portal-plumbr-eu-email> –build-arg password=<your-portal-plumbr-eu-password> <folder-where-the-dockerfile-resides> .” command. 
    1. When the command results in “Cannot connect to the Docker daemon. Is the docker daemon running on this host?” error message, pease start docker daemon first with “sudo docker daemon &” command.
  5. Launch the created image via “docker run -d -p 8080:8080 plumbr-docker” command. On the first start of the image, initial data structures in database are created and populated, meaning that the startup process can take up to three minutes*.
  6. When the image has started, the Plumbr user interface is available at http://host-where-you-launched-docker-image:8080/. Open the URL and log in using the same credentials that you used to create the account at https://plumbr.io.
  7. Continue with downloading and attaching the Agent to the JVM you wish to monitor based on the steps described in Agent installation guide

* When the image does not start and/or you cannot proceed with the next step, check the Plumbr Server log files. Acquiring log files from the docker container is possible via “docker cp <CONTAINER_ID>:/root/jetty/logs/plumbr-server.log plumbr-server.log” command which copies the plumbr-server.log file to the current directory. Check the log file for potential errors and if needed, contact Plumbr Support for assistance.