Using Different Mount Points on PMM Docker Deployments

Mount Points on PMM DockerIn this blog post, we’ll see how to use different mount points on PMM Docker deployments (Percona Monitoring and Management). This is useful if you want to use other mount points for the different directories, or even if you want to use a custom path that is not bound to Docker’s volumes directory (which is /var/lib/docker/volumes/ by default) within the same mount point.

There are two ways in which you can achieve this:

  • using symlinks after the pmm-data container is created
  • modifying the docker create command to use different directories

In the following examples, /pmm/ is used as the new base directory. One can, of course, choose different directories for each if needed. Also, remember to be aware of any SELinux or AppArmor policies you may have in place.

Using symlinks

For this, we need to follow these steps:

  1. Create the needed directories
  2. Create the pmm-data container
  3. Move contents from default Docker paths to the desired paths
  4. Create symlinks that point to the moved directories

Let’s see this with some commands and outputs. In this example, we will use /pmm/ as if it were the new mount point:

After this, we can start the pmm-server container (see below).

Modifying the docker create command

For this, we need to follow these other steps:

  1. Create the needed directories
  2. Create a temporary pmm-data container
  3. Copy its contents to the new locations, and delete it (the temporary container)
  4. Create the permanent pmm-data container with the modified paths (-v arguments)
  5. Fix ownership of files in the copied directories (to avoid errors when starting the pmm-server container later on)

Let’s see this in practical terms again, assuming we want to use the /pmm/ mount point.

After this, we can start the pmm-server container (see below).

Running pmm-server container

After following either of the steps mentioned above, we can run the pmm-server container with the exact same commands as shown in the online documentation:

And that’s it! Now you should have custom mount points on PMM docker deployment.

Share this post

Comments (8)

  • Janis Puris

    Step #3 is not correct with recent docker versions

    The docker paths need to have “/.” at the end as per
    If this is not done, the cp command will nest the directories in destination path and mysql will fail to start (among to start with).

    Change following

    shell> docker cp pmm-data-temporary:/opt/prometheus/data /pmm/opt/prometheus/data
    shell> docker cp pmm-data-temporary:/opt/consul-data /pmm/opt/consul-data
    shell> docker cp pmm-data-temporary:/var/lib/mysql /pmm/var/lib/mysql
    shell> docker cp pmm-data-temporary:/var/lib/grafana /pmm/var/lib/grafana
    shell> docker rm -v pmm-data-temporary


    shell> docker cp pmm-data-temporary:/opt/prometheus/data/. /pmm/opt/prometheus/data
    shell> docker cp pmm-data-temporary:/opt/consul-data/. /pmm/opt/consul-data
    shell> docker cp pmm-data-temporary:/var/lib/mysql/. /pmm/var/lib/mysql
    shell> docker cp pmm-data-temporary:/var/lib/grafana/. /pmm/var/lib/grafana
    shell> docker rm -v pmm-data-temporary

    March 27, 2019 at 11:04 am
    • Agustin G

      Hi Janis,
      Thanks for your comment. I have double-checked this, and it should work as mentioned in the original steps. The thing is that we never created the innermost directories with mkdir command, so we would be in the following situation (from the same documentation link you sent):

      -> SRC_PATH specifies a directory
      —-> DEST_PATH does not exist
      ——–> DEST_PATH is created as a directory and the contents of the source directory are copied into this directory

      I have tried this again, just in case, and it is working as expected. Maybe you modified the mkdir commands? Please send the exact commands you sent, so I’m able to reproduce, if not.

      October 21, 2019 at 6:29 pm
  • Tanuj

    We get permission denied error when we run step 5
    chown: cannot read directory ‘/opt/prometheus/data’: Permission denied
    chown: cannot read directory ‘/opt/consul-data’: Permission denied
    chown: cannot read directory ‘/var/lib/grafana’: Permission denied
    chown: cannot read directory ‘/var/lib/mysql’: Permission denied

    May 25, 2019 at 9:01 pm
  • Fernando Mattera

    Excelent post!

    I did this a year ago, and still working

    November 11, 2019 at 9:53 am
  • Jose Manuel Vera

    This procedure leads to Prometheus template error on CentOs 7

    November 22, 2019 at 3:56 am
    • Agustín

      Hi José. Thanks for your comment.

      Can you be more specific as to what is failing, so we can see if there are any issues with the steps? So far, we haven’t seen any errors due to these steps, specifically, although there were errors when some commands were not run as expected. Feel free to use the forums to post full steps used, and their outputs, so we can review them.

      November 22, 2019 at 6:27 am
  • molguram vinay

    Also a workaround. To change the docker default configuration and make it use the Disk/Partition that we want to.

    For the above example, If we want to use the /pmm/ .

    1. Stop docker service:
    systemctl stop docker.service

    2. Override defaults(which is /var/lib/docker/volumes/) to use /pmm.

    Add in /etc/systemd/system/docker.service.d/override.conf

    ExecStart=-/usr/bin/dockerd -H fd:// -g /pmm/docker –containerd=/run/containerd/containerd.sock

    3. Start docker service:
    systemctl status docker.service

    systemctl status docker.service

    Now follow the same steps to Install and configure:

    And then, you will have docker using the /pmm mount.

    February 3, 2020 at 11:43 am

Comments are closed.

Use Percona's Technical Forum to ask any follow-up questions on this blog topic.