Contact us www.mgeups.com

MGE and NUT How-To
OpenSource > MGE and NUT How-To

This document aims to describe a step by step installation of an MGE UPS with Network UPS Tools, in Point To Point mode (local protection and supervision).

Step 1: identify the NUT driver needed:

By looking at Supported UPSs page, identify which driver you need to communicate with your UPS (mge-utalk, mge-shut, snmp-ups or newhidups). Please beware to the fact that newhidups and snmp-ups are still in beta stage. Thus, these are not suitable for the moment if you need a high level of stability.

Step 2: Select your Operating System in the list below to have the right procedure:

Not listed (installation from source)

Step 3:

Now that everything has been installed and setup, we will validate the configuration using the upsc command.
This last allows to access UPS data, using the following command
    upsc ups_name@localhost

If everything is fine, you should see the UPS data tree displayed as follow:

If something went wrong, check this procedure again, from the step 1, or contact OpenSource support.

Step 4: Using Network UPS Tools

There are several interesting commands to use NUT to get data, set some values (ie for low battery level) or call instant commands (ie for battery test). Note that advanced graphical clients, like KNutClient, allows to do the same thing through graphical screens.

Step 4.1: Set values on UPS

Some information can be changed inside the UPS through NUT commands. This is the case, for example, of low battery level, transfer levels, ... Beware that some of these might not be restored upon a shutdown.

To view the list of available settable variables, use the following command:
    upsrw ups_name@localhost

To set the low battery level (which trigger shutdown), use the following command:
    upsrw -s battery.charge.low=20 -u admin -p mypass ups_name@localhost

Note:
    - admin and mypass depend on your configuration (see previous Step 2.2, upsd.users configuration),
    - for more information, please read upsrw manual page.

Step 4.2: Call instant commands

Some commands can be called through NUT. These can allow to stop/restart the UPS output, call a battery test, ...

To view the list of available settable variables, use the following command:
    upscmd -l ups_name@localhost

To execute a battery test, use the following command:
    upscmd -u admin -p mypass ups_name@localhost battery.test

Note:
    - admin and mypass depend on your configuration (see previous Step 2.2, upsd.users configuration),
    - for more information, please read upscmd manual page.

To contact MGE about this procedure, go here.

	MGE UPS SYSTEMS