GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NETXML-UPS (8)

.ds Aq ’

NAME

netxml-ups - Driver for Eaton / MGE Network Management Card / Proxy (XML/HTTP Protocol) equipment

CONTENTS

NOTE

This man page only documents the hardware-specific features of the netxml-ups driver. For information about the core driver, see nutupsdrv(8).

SUPPORTED HARDWARE

netxml-ups support all recent Eaton / MGE models which use a Network Management Card or Proxy (MGE XML/HTTP protocol based). This applies to both Eaton (previously MGE Office Protection Systems) and to MGE UPS SYSTEMS. Supported card and proxy models are:

o

o NMC Minislot (Ref 66102, firmware EA or newer),

o

o SNMP/Web Minislot card (Ref 66244)

o

o NMC Transverse (Ref 66074),

o

o NMC & Modbus/JBus (Ref 66103),

o

o Network Management Proxy,

o

o ePDU Monitored (newer version).

Older models, such as SNMP card (Ref 66062 and Ref 66045), use the SNMP protocol and should use the snmp-ups(8) driver with the "mibs=mge" parameter.

EXTRA ARGUMENTS

This driver supports the following optional settings in the ups.conf(5):

timeout=value

The timeout for connecting to and reading from the UPS. Defaults to 5 seconds. Don\(cqt change this value unless you know exactly what you\(cqre doing.

This value must never be higher than half the MAXAGE value specified in upsd.conf(5), otherwise you run the risk that upsd(8) declares the driver stale while it is waiting for a connection to timeout.

subscribe

Connect to the NMC in subscribed mode. This allows to receive notifications and alarms more quickly, beside from the standard polling requests.

login=value

Set the login value for authenticated mode. This feature also needs the password argument, and allows value settings in the card. This feature is not used yet.

password=value

Set the password value, needed with the login for authenticated mode. This feature is not used yet.

shutdown_duration=value

Set the shutdown duration of the operating system, in seconds. This represents the amount of time needed by the system to operate a clean shutdown. Defaults to 120 seconds.

shutdown_timer=value

Set the shutdown timer, in seconds. After value seconds running on battery, the local system will receive a notification to shutdown. Defaults to "none" (disabled).

IMPLEMENTATION

The hostname of the UPS is specified with the "port" value in ups.conf, i.e.:

[mgexml]
        driver = netxml-ups
        port = http://netxml-ups.example.com:80

Specifying the method to connect to the UPS (http, https) is mandatory. If the port is equal to the default for the method specified (80 for http, 443 for https) it may be omitted.

In order not to overload older NMCs by polling them too frequently, it is recommended to increase the "pollinterval" (see nutupsdrv(8)) and ups.conf(5)) to at least 5 seconds.

KNOWN ISSUES

Don\(cqt connect to the UPS through a proxy. Although it would be trivial to add support for proxies, this is not recommended and don\(cqt ask for it. Not only because it will prevent the driver to make a persistent connection to the UPS, but also it adds an additional failure mode. If the proxy goes down (for whatever reason), the driver will no longer be able to reach the UPS.

AUTHORS

Arjen de Korte <adkorte-guest@alioth.debian.org>

SEE ALSO

    The core driver:

nutupsdrv(8)

    Internet resources:

The NUT (Network UPS Tools) home page: http://www.networkupstools.org/

Search for    or go to Top of page |  Section 8 |  Main Index


Network UPS Tools 2&.7&.3&. NETXML-UPS (8) 12/29/2015

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.