Difference between revisions of "Uninterruptable Power Supply"

From SME Server
Jump to navigationJump to search
m (Fix case)
(Made serial UPS configuration generic)
Line 15: Line 15:
 
==Configuration Options==
 
==Configuration Options==
  
−
Not all UPS's are supported by USB or the newhidups driver, refer to:  http://www.networkupstools.org/compat/stable.html to find the configuration details for your model of UPS.
+
Not all UPS's are supported by USB or the newhidups driver. However NUT supports many UPS's and can be configured under SME Server easily.
  
−
For example Model bcmxcp_usb is for some Powerware units connected via USB or Model genericups for other Powerware units that only work on serial.
+
===Serial Connection===
  
−
===Serial Connection===
+
<ol></li><li>Find the configuration details for your model of UPS. Refer to:  http://www.networkupstools.org/compat/stable.html and make note of the driver name and upstype number (if any) in the third column.
 +
 
 +
{{Warning box|Always use the serial cable supplied with the UPS.  Standard serial cables won't work with a serial UPS and have been known to cause damage to the UPS. Pay particular attention to any references to cable in in the UPS Model column.}}
  
−
{{Warning box|Always use the serial cable supplied with the UPS.  Standard serial cables won't work with a serial UPS and have been known to cause damage to the UPS.}}
+
</li><li>From the consol issue the following commands:
  
−
The following are basic '''example''' settings.  Replace the properties with the appropriate settings for your UPS:
+
  config setprop nut Model <model>
−
  config setprop nut Model genericups
+
  config setprop nut Device <device>
−
  config setprop nut Device /dev/ttyS0
+
  config setprop nut Type <type>
−
  config setprop nut Type 7
 
 
  config setprop nut status enabled  
 
  config setprop nut status enabled  
  
−
Note: "Type" is only used if your model is Model genericups.
+
Where:<br>
 +
<model> and <type> are the driver name and type number found above.<br>
 +
<device> is the serial port that the UPS is connected to eg. /dev/ttyS0. It also possible to use a more readable symlink. See [[:Udev - symlinks | HowTo on udev - symlinks]]  for details.
 +
 
 +
Note: The case of Model, Device and Type.
  
−
Check:
+
</li><li>Check:
 
  config show nut
 
  config show nut
  
−
Apply changes and restart server:
+
</li><li>Apply changes and restart server:
 
  signal-event post-upgrade
 
  signal-event post-upgrade
 
  signal-event reboot  
 
  signal-event reboot  
  
−
Alternatively, with NUT not running or a server reboot:
+
Alternatively, '''without''' NUT running or requiring a server reboot:
 +
 
 
  expand-template /etc/sysconfig/ups
 
  expand-template /etc/sysconfig/ups
 
  expand-template /etc/ups/*
 
  expand-template /etc/ups/*
 
  /etc/rc7.d/S38nut start
 
  /etc/rc7.d/S38nut start
  
−
Confirm server is communicating with UPS:
+
</li><li>Confirm server is communicating with UPS:
 
  upsc UPS@localhost
 
  upsc UPS@localhost
−
 
−
For serial connected APC Smart UPS's there is a step by step [[:APC Serial UPS | HowTo on APC Serial UPS]]. This also shows how to configure the udev system instead of using a direct reference to the serial port.
 
  
 
Whenever a UPS event occurs Emails are sent to the admin account.
 
Whenever a UPS event occurs Emails are sent to the admin account.

Revision as of 00:11, 11 May 2008

Geographylogo.png Languages: 

English  • Deutsch  • français


The primary goal of the Network UPS Tools (NUT) project is to provide reliable monitoring of UPS hardware and ensure safe shutdowns of the systems which are connected.

The default configuration of NUT, will keep your connected systems operational until a critical battery state is reached (ie battery is nearing exhaustion) and then power down your server/equipment in a controlled fashion. See http://www.networkupstools.org/

Default Configuration (USB)

Most USB connected UPS's will work with the default settings. If using a USB connection just enable nut as follows: 

config setprop nut status enabled
signal-event post-upgrade
signal-event reboot

If your USB UPS does not work properly OR you have a serial device then follow the Configuration Options below.

Configuration Options

Not all UPS's are supported by USB or the newhidups driver. However NUT supports many UPS's and can be configured under SME Server easily.

Serial Connection

  1. Find the configuration details for your model of UPS. Refer to: http://www.networkupstools.org/compat/stable.html and make note of the driver name and upstype number (if any) in the third column.
    Warning.png Warning:
    Always use the serial cable supplied with the UPS. Standard serial cables won't work with a serial UPS and have been known to cause damage to the UPS. Pay particular attention to any references to cable in in the UPS Model column.

  2. From the consol issue the following commands: config setprop nut Model <model> config setprop nut Device <device> config setprop nut Type <type> config setprop nut status enabled Where:
    <model> and <type> are the driver name and type number found above.
    <device> is the serial port that the UPS is connected to eg. /dev/ttyS0. It also possible to use a more readable symlink. See HowTo on udev - symlinks for details. Note: The case of Model, Device and Type.
  3. Check: config show nut
  4. Apply changes and restart server: signal-event post-upgrade signal-event reboot Alternatively, without NUT running or requiring a server reboot: expand-template /etc/sysconfig/ups expand-template /etc/ups/* /etc/rc7.d/S38nut start
  5. Confirm server is communicating with UPS: upsc UPS@localhost Whenever a UPS event occurs Emails are sent to the admin account.

    Configuring as a slave

    Set configuration values: 

    config setprop nut SlaveUPS UPS@192.168.33.11
config setprop nut Master no

    Where 192.168.33.11 is your UPS master, that is the computer that is in direct communication with the UPS. The hostname of that computer may also work.

    Apply changes and restart server: 

    signal-event post-upgrade
signal-event reboot

    Confirm server is communicating with master: 

    upsc UPS@192.168.33.11

    Conecting multiple UPS's

    To be added http://bugs.contribs.org/show_bug.cgi?id=629

    Aditional Information

    There are template fragments in /etc/e-smith/templates/etc/ups that control the config files located in /etc/ups. The default settings should be OK for most situations.

    For information on configuration parameters: 

    man ups.conf
man upsd.conf
man upsd.users
man upsmon.conf
man upssched.conf

    For general information: 

    man upsd
man nutupsdrv
Retrieved from "https://wiki.koozali.org/index.php?title=Uninterruptable_Power_Supply&oldid=9699"