About mPanel Memory Graph


mPanel (our cloud server management panel) records performance statistics about each server (including CPU and network activity) and plots them in graph form to provide customers with insight into the performance of their VPS over time.


In order for VPS memory usage/utilisation information to be recorded, each individual server being monitored must have the mPanel Memory Graph application installed.


The application is a light weight service on Windows VPSs, and a scheduled cron job on Linux VPSs.


All BinaryLane-provided operating systems come with the mPanel Memory Graph pre-installed.


---

Note for Debain 12 Users: 

Debian 12 no longer includes the `cron` package in the base image, impacting services like mPanel's memory graph, which relies on `cron` for data collection. To maintain mPanel functionality, install `cron` using:



sudo apt update && sudo apt install cron



Verify and enable `cron` if necessary:



systemctl status cron
sudo systemctl enable cron && sudo systemctl start cron

---


To ensure the memory graph data can be sent from your server, please add the following firewall rule for your VPS' operating system.


On Linux operating systems:


iptables -I OUTPUT -p udp --dport 21000 -j ACCEPT


On Windows Server:


netsh advfirewall firewall add rule name="mPanel Memory Graph" action=allow dir=out protocol=UDP remoteport=21000



Install mPanel Memory Graph


The mPanel Memory Graph application must be installed on your VPS (not on your personal computer) in order to periodically provide mPanel with your VPS's current memory usage information.


You may check to see whether the mPanel Memory Graph service is already installed by visiting the Performance Statistics page for your VPS and checking whether Memory Usage information has been made available.



Windows

  1. Login to your VPS using Remote Desktop or login using the mPanel

  2. The .Net framework (v2.0 and up) is a requirement for this, you can download and install the .Net 2.0 Framework from Microsoft's website.

  3. Download mPanelMemoryGraph.msi using Edge (or any other web browser).

  4. Open the mPanelMemoryGraph.msi installation file

  5. Click `Next` and `Finish` until the setup wizard completes.

A new Windows service named mPanel Memory Graph is now installed and running.

Troubleshooting Windows Installation


?️Windows 2003 VPS customers (or VPS's without .Net Framework 2.0 or later installed) may encounter an error during the installation:

dotnet-problem

You will need to first download and install the .Net 2.0 Framework from Microsoft's website, and then click on Retry or re-run the installation process.


Linux


  1. Login to your VPS using SSH or via mPanel

  2. Ensure the Python scripting language is installed (you can use yum or apt-get to automatically install Python, depending on your Linux distribution. If you're unsure which package update system you have installed, just try one before the other.)
    • Using apt-get:

      `sudo apt-get update`
      `sudo apt-get install python`

    • Using yum:

      `sudo yum update`
      `sudo yum install python`

  3. Follow any on screen instructions (such as answering Yes to downloading the required files) to install Python.

  4. Download the application archive:

    `wget http://mirror.binarylane.com.au/tools/mpanel-memory-graph.tar.gz`
    ?️
  5. Install the downloaded archive: 
sudo tar xfv mpanel-memory-graph.tar.gz -C /

The application has been installed into the necessary directories.

You may now remove the downloaded installation files: 

rm mpanel-memory-graph.tar.gz

A scheduled task has now been created that will periodically execute the mpanel-memory-graph application and update memory statistics.



View Memory Usage Information


Upon installing the mPanel Memory Graph application, you will then be able to view the Memory Usage of your VPS from the Performance Statistics section of mPanel.


A new Memory Usage plot will appear on the Overview performance graph.


You may need to wait up to 15 minutes for Memory Usage information to appear.



Security / Technical Information


The mPanel Memory Graph application is designed to serve one purpose only: to send the current system memory usage information to mPanel so that it may be display on customer VPS performance graphs.


The application sends a single UDP packet on port 21000 every few minutes to an mPanel server.


The application does not listen on, accept connections from, or bind to any ports.


Instead, the application is 'send only' and only ever transmits a UDP packet with a single value indicating the current system memory usage.


The application is optional, and may be removed if desired.


Uninstall mPanel Memory Graph

You may remove the mPanel Memory Graph application at any time, however you will no longer have memory utilisation information appearing in your performance graphs.

Windows

  1. Access the Start Menu and then click on Add/Remove Programs
  2. Find and remove the mPanel Memory Graph application

Linux

  1. Issue the following commands from the SSH console:
  2. sudo rm /etc/cron.d/mpanel-memory-graph
    sudo rm /usr/local/bin/mpanel-memory-graph