Buy Percona ServicesBuy Now!

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.

../../_images/aws-marketplace.pmm.home-page.1.png

The home page of PMM in AWS Marketplace. Click the Continue button to start setting up your instance. You can also preselect your region on this screen.

Assuming that you have an AWS (Amazon Web Services) account, locate Percona Monitoring and Management Server 1.4.1 in AWS Marketplace.

Note

Available versions

Currently, you can use this method to run an instance of PMM version 1.4.1.

Click the Continue button to start setting up your instance. There are two options available to you. The 1-Click Launch option is a quick way to make your instance ready. For more control, use the Manual Launch option.

../../_images/aws-marketplace.pmm.launch-on-ec2.png

Percona Monitoring and Management is now available from AWS Marketplace

Setting up a PMM instance using the 1-Click Launch option

With the 1-Click Launch tab selected, make sure that all sections match your preferences. In this demonstration, we use the US East (N. Virginia) region and the VPC (virtual private cloud) named vpc-aba20dce. To reduce cost, you need to choose the region closest to your location.

On the 1-Click Launch tab, you select your region in the Region section. Note that your choice of the region is preserved from the previous screen where it is available next to the Continue button.

Setting up a VPC and an EC2 instance type

Depending on your choice of a VPC some configurations of CPU and RAM may be disabled in the EC2 Instance Type section.

In this demonstration, we select the vpc-aba20dce in the VPC Settings section. Then, we choose m4.large as the EC2 instance type.

../../_images/aws-marketplace.pmm.launch-on-ec2.1-click-launch.1.png

Select VPC in the VPC Settings section and then choose an EC2 instance type that suits your planned configuration.

Instead of a VPC (virtual private cloud) you may choose the EC2 Classic (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.

Limiting Access to the instance: security group and a key pair

In the Security group, which acts like a firewall, select a preconfigured security group in the Security group section. 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 following ports: 22, 80, and 443. PMM should also be able to access port 3306 on the RDS that uses the instance.

../../_images/aws-marketplace.pmm.launch-on-ec2.1-click-launch.2.png

Select a security group which manages firewall settings.

Applying settings

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.

../../_images/aws-marketplace.pmm.launch-on-ec2.1-click-launch.3.png

Your instance settings are summarized in a special area. Click the Launch with 1 click button to continue.

Note

The Launch with 1 click button may alternatively be titled as Accept Software Terms & Launch with 1-Click.

Adjusting instance settings in the EC2 Console

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.

../../_images/aws-marketplace.launch-on-ec2.1-click-launch.4.png

Adjust your settings in the EC2 console. To run it, click the EC2 Console link in the message at the top of the page.

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.

../../_images/aws-marketplace.ec2-console.pmm.1.png

The newly created instance selected.

Running the instance

After you add your new instance it will take some time to initialize it. When the Instance State contains running for your instance, you can run it.

Note

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.

For more information, see Elastic IP Addresses in AWS documentation.

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.

../../_images/aws-marketplace.pmm.ec2.properties.png

To run the instance, copy and paste its public IP address to the location bar of your brower.

In the Percona Monitoring and Management welcome page that opens, enter the instance ID in the Instance ID field.

../../_images/aws-marketplace.pmm.ec2.dialog.instance-id.1.png

Enter the instance ID on the welcome page.

You can copy the instance ID in 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.

../../_images/aws-marketplace.pmm.ec2.properties.instance-id.png

Hover the cursor over the instance ID for Copy button to appear.

Paste the instance in the Instance ID field of the Percona Monitoring and Management welcome page and click Submit.

The next screen offers to create a user and a password that you will later use to run your instance. Create a user name, assign a password, and click Submit.

../../_images/aws-marketplace.pmm.ec2.dialog.user-name.png

Create credentials for your instance.

The system authentication window then appears for you to use your newly created credentials. Enter the user name and password that you have just created. Your instance is now ready.

../../_images/pmm.home-page.1-4-1b.png

Percona Monitoring and Management is now ready

Note

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 admin.

Next Steps

Verify that PMM Server is running by connecting to the PMM web interface using the IP address from the console output, then install PMM Client on all database hosts that you want to monitor.

Running PMM Server Using Amazon Machine Images

Percona provides public Amazon Machine Images (AMI) with PMM Server in all regions where Amazon Web Services (AWS) is available. You can launch an instance using the web console for the corresponding image:

Region String AMI ID
US East (N. Virginia) us-east-1 ami-fef59384
US East (Ohio) us-east-2 ami-0ae8c16f
US West (N. California) us-west-1 ami-e099a380
US West (Oregon) us-west-2 ami-ad31ebd5
Canada (Central) ca-central-1 ami-1010ab74
EU (Ireland) eu-west-1 ami-6618a61f
EU (Frankfurt) eu-central-1 ami-e71d9388
EU (London) eu-west-2 ami-dfd4cabb
Asia Pacific (Singapore) ap-southeast-1 ami-4efa9f32
Asia Pacific (Sydney) ap-southeast-2 ami-787e8a1a
Asia Pacific (Seoul) ap-northeast-2 ami-2bad0b45
Asia Pacific (Tokyo) ap-northeast-1 ami-19f3747f
Asia Pacific (Mumbai) ap-south-1 ami-fea3ea91
South America (São Paulo) sa-east-1 ami-0263246e

Running from Command Line

  1. Launch the PMM Server instance using the run-instances command for the corresponding region and image. For example:

    aws ec2 run-instances \
      --image-id ami-fef59384 \
      --security-group-ids sg-3b6e5e46 \
      --instance-type t2.micro \
      --subnet-id subnet-4765a930 \
      --region us-east-1 \
      --key-name SSH-KEYNAME
    

    Note

    Providing the public SSH key is optional. Specify it if you want SSH access to PMM Server.

  2. Set a name for the instance using the create-tags command. For example:

    aws ec2 create-tags  \
      --resources i-XXXX-INSTANCE-ID-XXXX \
      --region us-east-1 \
      --tags Key=Name,Value=OWNER_NAME-pmm
    
  3. Get the IP address for accessing PMM Server from console output using the get-console-output command. For example:

    aws ec2 get-console-output \
      --instance-id i-XXXX-INSTANCE-ID-XXXX \
      --region us-east-1 \
      --output text \
      | grep cloud-init
    
Visit Percona Store


General Inquiries

For general inquiries, please send us your question and someone will contact you.