Installing DPM

There are four installation scenarios. Whenever possible, we recommend the on-host installation method.

  • In on-host installation, the agent is installed and runs on the server it will monitor. The agent will automatically detect and configure any services that can be monitored. We recommend this option for MySQL, PostgreSQL, and MongoDB and it is the required installation option for Redis.

  • In off-host installation, the agent is installed on any compatible host, and connects to the monitored host over the network. Use this option if you are unable to install the agent on the database server, such as with Amazon RDS, Amazon Aurora, Google Cloud SQL for MySQL or Postgres, MongoDB Atlas, or for MySQL, PostgreSQL, and MongoDB when necessary (for example, when database traffic is encrypted with SSL).

  • In containerized installation, the agent is configured to run in a virtualization environment such as those provided by Heroku. The database will be monitored either “on-host” or “off-host” depending on the specific configuration.

  • Lastly, you can install DPM manually or using systems such as Ansible, Chef, or Puppet. Once again, the database will be monitored either “on-host” or “off-host” depending on the configuration.

Starting and Stopping DPM

Once installed, agents can be stopped, started, and restarted from the Agents Page. Simply click the ‘gear’ icon on the right side of the screen and select an option. Note that if you stop the supervisor from the Agents page, you will need to restart the service locally.

To start and stop the service locally, you can use service vividcortex stop, start, and restart, or you may also use /etc/init.d/vividcortex stop, start, and restart, if appropriate.

Uninstalling: Linux and FreeBSD

To uninstall the DPM agents from a server, run the following commands as root:

Note: If you installed the DPM agent to run as a non-root user, you must still run the following commands as root.

curl https://download.vividcortex.com/install > install
sh install --uninstall

This will stop sending metrics from that host. That host will disappear from the interface and release its license after two hours. If you need to uninstall DPM and free a license immediately, you can have the uninstall process delete the host automatically. To do so, run the following commands as root:

curl https://download.vividcortex.com/install > install
sh install --delete

Warning: using the delete option will immediately and permanently delete the host. This is useful if you automate the provisioning of servers and installation of DPM and need to release licenses quickly without having to delete the host manually in the interface.