Running PMM Server Using AWS Marketplace¶
You can run an instance of PMM Server hosted at AWS Marketplace. This method replaces the outdated method where you would have to accessing an AMI (Amazon Machine Image) by using its ID, different for each region.
Assuming that you have an AWS (Amazon Web Services) account, locate Percona Monitoring and Management Server in AWS Marketplace.
The Pricing Information section allows to select your region and choose an instance type in the table that shows the pricing for the software and infrastructure hosted in the region you have selected (the recommended EC2 instance type is preselected for you). Note that actual choice will be done later, and this table serves the information purposes, to plan costs.
Disk space consumed by PMM Server depends on the number of hosts under monitoring. Each environment will be unique, however consider modeling your data consumption based on PMM Demo web site, which consumes ~230MB/host/day, or ~6.9GB/host at the default 30 day retention period. See this blog post for more details.
- Clicking the Continue to Subscribe button will proceed to the terms and conditions page.
- Clicking Continue to Configuration there will bring a new page to start setting up your instance. You will be able to re-check the PMM Server version and the region. When done, continue to the launch options by clicking Continue to Launch.
Select the previously chosen instance type from the EC2 Instance Type drop-down menu. Also chose the launch option. Available launch options in the Chose Action drop-down menu include Launch from Website and Launch through EC2. The first one is a quick way to make your instance ready. For more control, use the Manual Launch through EC2 option.
Choose Launch from Website option, your region, and the EC2 instance type on
the launch options page. On the previous screenshot, we use the
US East (N. Virginia) region and the EC2 Instance Type named
t2.medium. To reduce cost, you need to choose the region closest to
In this demonstration, we use the VPC (virtual private cloud) named
vpc-484bb12f. The exact name of VPC may be different from the example
Instead of a VPC (virtual private cloud) you may choose the
(no VPC) option and use a public cloud.
Selecting a subnet, you effectively choose an availability zone in the selected region. We recommend that you choose the availability zone where your RDS is located.
Note that the cost estimation is automatically updated based on your choice.
- AWS Documentation: Availability zones
In the Security Group section, which acts like a firewall, you may use the
Create new based on seller settings to create a
security group with recommended settings. In the Key Pair select an
already set up EC2 key pair to limit access to your instance.
It is important that the security group allow communication via the the following ports: 22, 80, and 443. PMM should also be able to access port 3306 on the RDS that uses the instance.
- Amazon Documentation: Security groups
- Amazon Documentation: Key pairs
- Amazon Documentation: Importing your own public key to Amazon EC2
Scroll up to the top of the page to view your settings. Then, click the Launch with 1 click button to continue and adjust your settings in the EC2 console.
The Launch with 1 click button may alternatively be titled as Accept Software Terms & Launch with 1-Click.
Your clicking the Launch with 1 click button, deploys your instance. To continue setting up your instance, run the EC2 console. It is available as a link at the top of the page that opens after you click the Launch with 1 click button.
Your instance appears in the EC2 console in a table that lists all instances available to you. When a new instance is only created, it has no name. Make sure that you give it a name to distinguish from other instances managed via the EC2 console.
After you add your new instance it will take some time to initialize it. When the AWS console reports that the instance is now in a running state, you many continue with configuration of PMM Server.
When started the next time after rebooting, your instance may acquire another IP address. You may choose to set up an elastic IP to avoid this problem.
- Amazon Documentation: Elastic IP Addresses
With your instance selected, open its IP address in a web browser. The IP address appears in the IPv4 Public IP column or as value of the Public IP field at the top of the Properties panel.
To run the instance, copy and paste its public IP address to the location bar of your browser. In the Percona Monitoring and Management welcome page that opens, enter the instance ID.
You can copy the instance ID from the Properties panel of your instance, select the Description tab back in the EC2 console. Click the Copy button next to the Instance ID field. This button appears as soon as you hover the cursor of your mouse over the ID.
Paste the instance in the Instance ID field of the Percona Monitoring and Management welcome page and click Submit.
PMM Server provides user access control, and therefore you will need user credentials to access it:
The default user name is
admin, and the default password is
You will be proposed to change the default password at login if you didn’t it.
The PMM Server is now ready and the home page opens.
You are creating a username and password that will be used for two purposes:
authentication as a user to PMM - this will be the credentials you need in order to log in to PMM.
authentication between PMM Server and PMM Clients - you will re-use these credentials when configuring pmm-client for the first time on a server, for example:
Run this command as root or by using the sudo command
pmm-admin config --server-insecure-tls --server-url=https://admin:admin@<IP Address>:443
Accessing the instance by using an SSH client.
For instructions about how to access your instances by using an SSH client, see Connecting to Your Linux Instance Using SSH
Make sure to replace the user name
ec2-user used in this document with
- How to verify that the PMM Server is running properly?
- Verifying PMM Server
- How to connect a PMM Client to the PMM Server?