21.1. Installation Process #
To use PPEM in containerized environments:
Create a container image with the manager.
Create new DBMS container images or modify the existing ones to integrate the agent into the images, so that the DBMS can be monitored and managed by PPEM.
A service manager must be used as the default executable for the image, as the agent and the DBMS server will be simultaneously running inside the container.
Configure container networking for the agents to be reachable by the manager, and vice versa:
If containers with agent and manager services are planned to be placed in the different networks or on the different hosts, then ensure that the containers are not behind NAT and reachable via their IP addresses.
For example, with Docker, the
overlayormacvlannetwork drivers can be used.Adjust network traffic policies, if any, to allow PPEM traffic.
For more information about the PPEM networking requirements, refer to the Security section.
Get an API key to configure agents:
Start a container with the manager service.
In the navigation panel, go to Summary.
If the agent installation instruction is displayed on the page, then copy the key from the instruction.
If no instruction is displayed, then complete the following steps:
In the navigation panel, go to Infrastructure → Agents.
In the Authentication key column for any agent, click either
to copy the key or 
to view the key.
Create the
ppem-agent.ymlagent configuration file:Specify the parameters for connecting the agent to the containerized DBMS.
Specify the previously obtained API key and the URL for connecting the agent to the manager.
Run DBMS containers, passing the previously created agent configuration file into the containers.