Skip to content
PERCONA MONITORING AND MANAGEMENT DOCUMENTATION

For help, click the link below to get free database assistance or contact our experts for personalized support.

Get help from Percona

Access the PMM Server Virtual Appliance web interface

After deploying your PMM Server as a virtual appliance (OVA), access its web interface to set up administrator credentials, verify connectivity, and prepare your monitoring environment.

To log in to the PMM user interface:

  1. Open a web browser and visit the guest IP address. Your browser may display a security warning about an untrusted certificate. This is expected with the default self-signed certificate. You can safely proceed to the website.

  2. The PMM login screen appears.

  3. On the login screen, enter the default credentials:admin/ admin.

  4. (Recommended) Follow the prompts to change the default password. You also can change the default password through SSH by using the change-admin-password command.

  5. The PMM Home Dashboard appears.

(Optional) Change root password from UI

You can change the root password directly from the user interface:

  1. Start the virtual machine in GUI mode.

  2. Log in with the default superuser credentials: root/percona

  3. Follow on-screen prompts to change the password.

(Optional) Set up SSH from UI/CLI

To set up SSH from UI/CLI:

  1. Create a key pair for the admin user:

    ssh-keygen -f admin

  2. Log into the PMM user interface.

  3. Select PMM Configuration > Settings > SSH Key.

  4. Copy and paste the contents of the admin.pub file into the SSH Key field.

  5. Click Apply SSH Key. This copies the public key to /home/admin/.ssh/authorized_keys in the guest.

  6. Log in via SSH (N.N.N.N is the guest IP address).

    ssh -i admin admin@N.N.N.N
(Optional) Set up static IP via CLI

When the guest OS starts, it will get an IP address from the hypervisor’s DHCP server. This IP can change each time the guest OS is restarted. Setting a static IP for the guest OS avoids having to check the IP address whenever the guest is restarted.

  1. Start the virtual machine in non-headless (GUI) mode.

  2. Log in as root.

  3. Edit /etc/sysconfig/network-scripts/ifcfg-eth0

  4. Change the value of BOOTPROTO:

    BOOTPROTO=none

  5. Add these values:

    IPADDR=192.168.1.123 # replace with the desired static IP address
NETMASK=255.255.255.0 # replace with the netmask for your IP address
GATEWAY=192.168.1.1 # replace with the network gateway for your IP address
PEERDNS=no
DNS1=192.168.1.53 # replace with your DNS server IP

  6. Restart the interface:

    ifdown eth0 && ifup eth0

  7. Check the IP:

    ip addr show eth0

  8. Preserve the network configuration across reboots:

    echo "network: {config: disabled}" > /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg

Next steps

After the initial login: