percona · catalinaadam · Nov 21, 2024 · Jul 5, 2024 · Jul 5, 2024 · Jul 5, 2024
@@ -1,6 +1,6 @@
 # SSH Key
 
-This section lets you upload your public SSH key to access the PMM Server via SSH (for example, when accessing PMM Server as a [virtual appliance](../install-pmm/install-pmm-server/baremetal/virtual/index.md).
+This section enables you to upload your public SSH key for SSH access to the PMM Server, such as when accessing it as a [virtual appliance](../install-pmm/install-pmm-server/baremetal/virtual/index.md).
 
 ![!](../_images/PMM_Settings_SSH_Key.jpg)
 

@@ -18,41 +18,32 @@ When you need to share a dashboard with your team members, you can either send t
 Rendering images requires the Image Renderer plug-in. If your PMM Admin has not installed this for your PMM instance, you will see the following error message under **Share Panel > Link**.
 ![!image](../_images/No_Image_Render_Plugin.png)
 
-To install the dependencies:
+To enable image rendering:
 
-1. Connect to your PMM Server Docker container.
+1. Deploy the Grafana Image Renderer container alongside PMM Server:
 
-    ```sh
-    docker exec -it pmm-server bash
-    ```
+   ```sh
+   docker run -d --name renderer --network=pmm-network grafana/grafana-image-renderer:latest
+   ```
 
-2. Install Grafana plug-ins.
+2. Stop your existing PMM Server container:
 
-    ```sh
-    grafana-cli plugins install grafana-image-renderer
-    ```
+   ```sh 
+   docker stop pmm-server
+   docker rm pmm-server
+   ```
 
-3. Restart Grafana.
+3. Start a new PMM Server container with the required environment variables:
 
-    ```sh
-    supervisorctl restart grafana
-    ```
-
-4. Install libraries.
-
-    ```sh
-    yum install -y libXcomposite libXdamage libXtst cups libXScrnSaver pango \
-    atk adwaita-cursor-theme adwaita-icon-theme at at-spi2-atk at-spi2-core \
-    cairo-gobject colord-libs dconf desktop-file-utils ed emacs-filesystem \
-    gdk-pixbuf2 glib-networking gnutls gsettings-desktop-schemas \
-    gtk-update-icon-cache gtk3 hicolor-icon-theme jasper-libs json-glib \
-    libappindicator-gtk3 libdbusmenu libdbusmenu-gtk3 libepoxy \
-    liberation-fonts liberation-narrow-fonts liberation-sans-fonts \
-    liberation-serif-fonts libgusb libindicator-gtk3 libmodman libproxy \
-    libsoup libwayland-cursor libwayland-egl libxkbcommon m4 mailx nettle \
-    patch psmisc redhat-lsb-core redhat-lsb-submod-security rest spax time \
-    trousers xdg-utils xkeyboard-config alsa-lib
-    ```
+   ```sh
+   docker run -d \
+   --name pmm-server \
+   --network=pmm-network \
+   -p 8443:443 \
+   -e GF_RENDERING_SERVER_URL=http://renderer:8081/render \
+   -e GF_RENDERING_CALLBACK_URL=https://pmm-server:8443/graph/ \
+   percona/pmm-server:latest
+   ```
 
 ## Render Dashboard image
 

@@ -1,7 +1,6 @@
 # About PMM
 
-
-<i info>:material-information: Info:</i> This is the documentation for the latest release, **PMM {{release}}** ([Release Notes](release-notes/3.0.0_Alpha.md)).
+<i info>:material-information: Info:</i> This is the documentation for the latest release, **PMM {{release}}** ([Release Notes](release-notes/3.0.0_Alpha.md).
 
 Percona Monitoring and Management (PMM) is an open source database observability, monitoring, and management tool for use with MySQL, PostgreSQL, MongoDB, and the servers on which they run. It enables you to view node- to single-query performance metrics for all of your databases in a single place. 
 

@@ -64,7 +64,7 @@ For more details see <https://prometheus.io/docs/instrumenting/writing_exporters
     ```sh
     root@mysql1:~# pmm-admin add external --group=processes  --listen-port=9256
     External Service added.
-    Service ID  : /service_id/6485f4fd-745b-4dfb-8b72-328e300f8b50
+    Service ID  : 6485f4fd-745b-4dfb-8b72-328e300f8b50
     Service name: mysql1-processes
     Group       : processes
     ```

@@ -27,7 +27,7 @@ The output of this command should look as follows:
 
 ```txt
 HAProxy Service added.
-Service ID  : /service_id/c481183f-70a2-443f-91e5-cae5cecd06a2
+Service ID  : c481183f-70a2-443f-91e5-cae5cecd06a2
 Service name: Ubuntu-haproxy
 ```
 

@@ -21,7 +21,7 @@ pmm-admin add proxysql --username=pmm --password=pmm
 
 ```text
 ProxySQL Service added.
-Service ID  : /service_id/f69df379-6584-4db5-a896-f35ae8c97573
+Service ID  : f69df379-6584-4db5-a896-f35ae8c97573
 Service name: ubuntu-proxysql
 ```
 

@@ -1,4 +1,4 @@
-# Connect Remote instance
+# Connect remote instance
 
 ## Recommended settings
 

@@ -7,7 +7,7 @@ On Debian or Red Hat Linux, install `percona-release` and use a Linux package ma
 
     ```sh
     percona-release disable all
-    percona-release enable original release
+    percona-release percona-release enable pmm3-client
     ```
 
 === "Debian-based"
@@ -26,7 +26,7 @@ On Debian or Red Hat Linux, install `percona-release` and use a Linux package ma
         !!! hint "Root permissions"
             ```sh
             apt update
-            apt install -y pmm2-client
+            apt install -y pmm-client
             ```
 
     3. Check.
@@ -48,7 +48,7 @@ On Debian or Red Hat Linux, install `percona-release` and use a Linux package ma
     2. Install the PMM Client package.
 
         ```sh
-        yum install -y pmm2-client
+        yum install -y pmm-client
         ```
 
     3. Check.
@@ -64,7 +64,7 @@ On Debian or Red Hat Linux, install `percona-release` and use a Linux package ma
 To manually download package manager:
 {.power-number}
 
-1. Visit the [Percona Monitoring and Management 2 download](https://www.percona.com/downloads/pmm2/) page.
+1. Visit the [Percona Monitoring and Management 3 download](https://www.percona.com/downloads//) page.
 2. Under *Version:*, select the one you want (usually the latest).
 3. Under *Software:*, select the item matching your software platform.
 4. Click to download the package file:
@@ -89,12 +89,12 @@ To manually download package manager:
 
     Here are the download page links for each supported platform.
 
-    - [Debian 9 (Stretch)](https://www.percona.com/downloads/pmm2/{{release}}/binary/debian/stretch/)
-    - [Debian 10 (Buster)](https://www.percona.com/downloads/pmm2/{{release}}/binary/debian/buster/)
-    - [Debian 11 (Bullseye)](https://www.percona.com/downloads/pmm2/{{release}}/binary/debian/bullseye/)
-    - [Red Hat/CentOS/Oracle 7](https://www.percona.com/downloads/pmm2/{{release}}/binary/redhat/7/)
-    - [Red Hat/CentOS/Oracle 8](https://www.percona.com/downloads/pmm2/{{release}}/binary/redhat/8/)
-    - [Ubuntu 18.04 (Bionic Beaver)](https://www.percona.com/downloads/pmm2/{{release}}/binary/debian/bionic/)
-    - [Ubuntu 20.04 (Focal Fossa)](https://www.percona.com/downloads/pmm2/{{release}}/binary/debian/focal/)
-    - [Ubuntu 22.04 (Jammy Jellyfish)](https://www.percona.com/downloads/pmm2/{{release}}/binary/debian/jammy/)
+    - [Debian 9 (Stretch)](https://www.percona.com/downloads/pmm3/{{release}}/binary/debian/stretch/)
+    - [Debian 10 (Buster)](https://www.percona.com/downloads/pmm3/{{release}}/binary/debian/buster/)
+    - [Debian 11 (Bullseye)](https://www.percona.com/downloads/pmm3/{{release}}/binary/debian/bullseye/)
+    - [Red Hat/CentOS/Oracle 7](https://www.percona.com/downloads/pmm3/{{release}}/binary/redhat/7/)
+    - [Red Hat/CentOS/Oracle 8](https://www.percona.com/downloads/pmm3/{{release}}/binary/redhat/8/)
+    - [Ubuntu 18.04 (Bionic Beaver)](https://www.percona.com/downloads/pmm3/{{release}}/binary/debian/bionic/)
+    - [Ubuntu 20.04 (Focal Fossa)](https://www.percona.com/downloads/pmm3/{{release}}/binary/debian/focal/)
+    - [Ubuntu 22.04 (Jammy Jellyfish)](https://www.percona.com/downloads//{{release}}/binary/debian/jammy/)
 
@@ -47,7 +47,7 @@ To log in to the PMM user interface:
 
     2. Log into the PMM user interface.
 
-    3. Select **PMM → PMM Settings → SSH Key**.
+    3. Select **PMM Configuration > Settings > SSH Key**.
 
     4. Copy and paste the contents of the `admin.pub` file into the **SSH Key** field.
 

@@ -15,7 +15,7 @@ PMM supports standard as well as custom labels. PMM automatically assigns standa
 
 | **Label Type**| **Object**| **Label name **| **Example** |                                                                                                
 |----------|--------|-------|------------------------------|
-| **Standard**  | Node   | node_id |/node_id/123|                                          
+| **Standard**  | Node   | node_id |123|                                          
 |          | Service|service_type   |   - mysql, mongodb, postgresql etc.                                     
 | **Custom**| Node, Service, Agent| Any string matching regular expression: <br /> [a-zA-Z_][a-zA-Z0-9_]*. <br /> Also, it cannot start with two underscores.| owner="joe"<br/> _rack="12345"|
 
@@ -38,4 +38,4 @@ To set the labels using the user interface:
 
 ### Using pmm-admin
 
- You can also assign labels using [pmm-admin](../../../use/commands/pmm-admin.md).
+ You can also assign labels using [pmm-admin](../../../use/commands/pmm-admin.md).
@@ -84,7 +84,7 @@ Once PMM is set up, choose the database or the application that you want it to m
 
                 ```sh
                 apt update
-                apt install -y pmm2-client
+                apt install -y pmm-client
                 ```
 
         === ":material-redhat: Red Hat-based"

@@ -80,7 +80,12 @@ Once PMM is set up, choose the database or the application that you want it to m
                 dpkg -i percona-release_latest.generic_all.deb
                 ```
 
-            2. Install the PMM Client package:
+            2. Enable the PMM client repository:
+
+                ```sh
+                percona-release enable pmm3-client release
+                ```
+            3. Install the PMM Client package:
 
                 ```sh
                 apt update
@@ -92,16 +97,21 @@ Once PMM is set up, choose the database or the application that you want it to m
             Install the following with `root` permission:
             { .power-number} 
 
-            1. Install [percona-release](https://docs.percona.com/percona-software-repositories/installing.html) tool.  If this is already installed, [update percona-release](https://docs.percona.com/percona-software-repositories/updating.html) to the latest version.
+            4. Install [percona-release](https://docs.percona.com/percona-software-repositories/installing.html) tool. If this is already installed, [update percona-release](https://docs.percona.com/percona-software-repositories/updating.html) to the latest version.
 
                 ```sh
                 yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
                 ```
 
-            2. Install the PMM Client package:
+            5. Enable the PMM client repository:
 
                 ```sh
-                yum install -y pmm2-client
+                percona-release enable pmm3-client release
+                ```
+            6. Install the PMM Client package:
+
+                ```sh
+                yum install -y pmm-client
                 ```
 
     3. Register PMM Client:
@@ -176,27 +186,37 @@ Once PMM is set up, choose the database or the application that you want it to m
                 dpkg -i percona-release_latest.generic_all.deb
                 ```
 
-            2. Install the PMM Client package:
+            2. Enable the PMM client repository:
+
+                ```sh
+                percona-release enable pmm3-client release
+                ```
+            3. Install the PMM Client package:
 
                 ```sh
                 apt update
-                apt install -y pmm2-client
+                apt install -y pmm-client
                 ```
 
         === ":material-redhat: Red Hat-based"
 
             Install the following with `root` permission: 
             { .power-number}   
 
-            3. Install [percona-release](https://docs.percona.com/percona-software-repositories/installing.html) tool.  If this is already installed, [update percona-release](https://docs.percona.com/percona-software-repositories/updating.html) to the latest version:
+            1. Install [percona-release](https://docs.percona.com/percona-software-repositories/installing.html) tool.  If this is already installed, [update percona-release](https://docs.percona.com/percona-software-repositories/updating.html) to the latest version:
 
                 ```sh
                 yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
                 ```
-            4. Install the PMM Client package:
+            2. Enable the PMM client repository:
+
+                ```sh
+                percona-release enable pmm3-client release
+                ```
+            3. Install the PMM Client package:
 
                 ```sh
-                yum install -y pmm2-client
+                yum install -y pmm-client
                 ```
 
     8. Register PMM Client:
@@ -280,11 +300,16 @@ Once PMM is set up, choose the database or the application that you want it to m
                 dpkg -i percona-release_latest.generic_all.deb
                 ```
 
-            2. Install the PMM Client package:
+            2. Enable the PMM client repository:
+
+                ```sh
+                percona-release enable pmm3-client release
+                ```
+            3. Install the PMM Client package:
 
                 ```sh
                 apt update
-                apt install -y pmm2-client
+                apt install -y pmm-client
                 ```
 
         === ":material-redhat: Red Hat-based"
@@ -297,10 +322,15 @@ Once PMM is set up, choose the database or the application that you want it to m
                 yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
                 ```
 
-            2. Install the PMM Client package:
+            2. Enable the PMM client repository:
 
                 ```sh
-                yum install -y pmm2-client
+                percona-release enable pmm3-client release
+                ```
+            3. Install the PMM Client package:
+
+                ```sh
+                yum install -y pmm-client
                 ```
 
     4. Register PMM Client:
@@ -337,11 +367,16 @@ Once PMM is set up, choose the database or the application that you want it to m
                 dpkg -i percona-release_latest.generic_all.deb
                 ```
 
-            2. Install the PMM Client package:
+            2. Enable the PMM client repository:
+
+                ```sh
+                percona-release enable pmm3-client release
+                ```
+            3. Install the PMM Client package:
 
                 ```sh
                 apt update
-                apt install -y pmm2-client
+                apt install -y pmm-client
                 ```
 
         === ":material-redhat: Red Hat-based"
@@ -354,10 +389,15 @@ Once PMM is set up, choose the database or the application that you want it to m
                 yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
                 ```
 
-            2. Install the PMM Client package:
+            2. Enable the PMM client repository:
 
                 ```sh
-                yum install -y pmm2-client
+                percona-release enable pmm3-client release
+                ```
+            3. Install the PMM Client package:
+
+                ```sh
+                yum install -y pmm-client
                 ```
 
     3. Register PMM Client:
@@ -393,11 +433,16 @@ Once PMM is set up, choose the database or the application that you want it to m
                 dpkg -i percona-release_latest.generic_all.deb
                 ```
 
-            2. Install the PMM Client package:
+            2. Enable the PMM client repository:
+
+                ```sh
+                percona-release enable pmm3-client release
+                ```
+            3. Install the PMM Client package:
 
                 ```sh
                 apt update
-                apt install -y pmm2-client
+                apt install -y pmm-client
                 ```
 
         === ":material-redhat: Red Hat-based"
@@ -410,10 +455,15 @@ Once PMM is set up, choose the database or the application that you want it to m
                 yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
                 ```
 
-            2. Install the PMM Client package:
+            2. Enable the PMM client repository:
+
+                ```sh
+                percona-release enable pmm3-client release
+                ```
+            3. Install the PMM Client package:
 
                 ```sh
-                yum install -y pmm2-client
+                yum install -y pmm-client
                 ```
 
     4. Register PMM Client: