Quick Installation

Install the DMCloudArchitect Health Monitor

The DMCloudArchitect Health Monitor is designed to be lightweight and safe. Setup takes under 5 minutes. No ongoing maintenance required.

What the Install Script Does

One script handles the complete setup.

1

Creates a system user

A dedicated dmca_health OS user is created with no login shell and no sudo rights. Home directory: /home/dmca_health.

2

Installs monitor files

The monitoring scripts are installed to /home/dmca_health/ owned by the new user.

3

Configures MySQL credentials

MySQL credentials are stored encrypted using mysql_config_editor. Plain-text credentials are never written to disk.

4

Sets up cron jobs

Two cron jobs are scheduled: metric sampling every 5 minutes, and hourly aggregation + snapshot upload.

5

Registers with your account

The monitor registers this server using your API key. A stable SERVER_ID is generated from hostname and primary IP.

Requirements

Server

  • Linux (any modern distribution)
  • bash shell
  • wget or curl
  • Standard tools: awk, df, access to /proc
  • Root / sudo access for initial setup only

MySQL (optional)

  • MySQL 5.7+ or MariaDB 10.3+
  • Read-only monitoring account: PROCESS privilege
  • mysql_config_editor available
  • Multiple instances supported

Installation Steps

Step 1

Get your API key

Sign up for a free account to receive your API key. You will need it during installation to register your server.

Get API Key →
Step 2

Download the install script

Run the following on your Linux server:

bash
$ mkdir ~/tmp && cd ~/tmp
$ rm -f install_dmca_health.sh
$ wget https://health.dmcloudarchitect.com/download/install_dmca_health.sh
$ chmod 755 install_dmca_health.sh
Step 3

Run the installer

The installer requires root to create the system user and configure cron jobs. After setup, the monitor runs entirely as the unprivileged dmca_health user.

bash
$ sudo ./install_dmca_health.sh
→ Creating dmca_health system user… → Installing monitor to /home/dmca_health/dmca-monitor/ → Configuring MySQL credentials (encrypted)… → Scheduling cron jobs… ✓ Installation complete. Enter your API key when prompted.
Step 4

Verify the monitor is running

After installation, confirm the monitor is active and cron jobs are scheduled:

bash
$ sudo -u dmca_health crontab -l
*/5 * * * * $HOME/bin/dmca_health.sh sample 1 * * * * $HOME/bin/dmca_health.sh aggregate ✓ Monitor scheduled. First snapshot uploads within the next hour.

MySQL Setup Note

Create a read-only MySQL account for the monitor. Only the PROCESS privilege is required:

mysql
CREATE USER 'dmcamonitor'@'localhost' IDENTIFIED BY 'strong_password_here'; GRANT PROCESS ON *.* TO 'dmcamonitor'@'localhost'; FLUSH PRIVILEGES;

Credentials are then stored encrypted using mysql_config_editor during the install process. No plain-text passwords are stored anywhere.

Ready to get started?

Create a free account and get your API key in under a minute.

Get Free API Key