PMM2: Admin password change – any impact on already-registered agents?

Percona Monitoring and Management (PMM)
1

Dear PMM community,

I’m using PMM 2 and would like to understand the impact of changing the admin password on the web portal.

Our Current Setup:
To register a monitoring agent, we:

  1. Create a dedicated PMM user on the database
  2. Assign it a password
  3. Use those credentials to register the agent with PMM

Questions:

Q1. Does changing the PMM web portal admin password affect already-registered agents?
We want to update the admin password for security reasons, but we’re concerned it might disrupt agents that are currently running and connected.

Q2. If it does cause an impact, what is the recommended fix?
For example — do we need to re-register the agents, update a config file, or restart any services?

We’d appreciate any advice or experience from the community on this. Happy to share more details about our environment if needed.

Thank you!

2

Hi @Ly_Kimmeng,

Q1. Does changing the PMM web portal admin password affect already-registered agents?

Yes.

Q2. If it does cause an impact, what is the recommended fix?

You will indeed need to reconfigure all clients (run pmm-admin config, and any pmm-admin add commands for the databases you had before).

Unrelated, but note that PMM v2 is EOL already.

3

Hi @Agustin_G ,

Thank you for the clarification.

I would like to confirm one point regarding the impact of changing the PMM web portal admin password.

In our environment, the PMM agents were registered using a separate user account (pmm) during pmm-admin config, and we did not use the admin web portal credentials for agent registration.

Based on this setup, my understanding is that changing the PMM web portal admin password should not affect already-registered PMM agents, unless the agents themselves were configured using the admin credentials.

Could you please help confirm whether this understanding is correct?

Additionally, could you clarify why re-running pmm-admin config and re-adding all database services would still be required in this scenario?

Best regards,
Kimmeng

4

Hi @Ly_Kimmeng ,

Ok, I misunderstood your initial message then, sorry. In that case, the PMM clients won’t be affected by the changes, since you are not using the admin account for them. No extra steps are needed.

My reply applies to the typical usage scenario where the web UI admin account is also used for PMM clients.

5

Dear @Agustin_G ,

Thank you for your confirmation.

Best regards,

Kimmeng