Archive/XCP NUT

* #XCP 1.6 + EPEL 5 repo NUT setup (less file editing)
* #Old HOWTO
----
== XCP 1.6 + EPEL 5 repo NUT setup (less file editing) ==
In this HOWTO I am using 2 Units rack-mounted UPS APC Smart-UPS SC1500 with COM-to-COM connection cable included with UPS. COM-to-USB seems to be more problematic in setup. 
Check you COM port is available to OS
dmesg | grep ttyS
[ 21.873093] serial8250: ttyS0 at I/O 0x3f8 (irq = 4) is a 16550A
[ 21.873290] serial8250: ttyS1 at I/O 0x2f8 (irq = 3) is a 16550A
[ 21.874976] 00:09: ttyS0 at I/O 0x3f8 (irq = 4) is a 16550A
[ 21.875207] 00:0a: ttyS1 at I/O 0x2f8 (irq = 3) is a 16550A
If you can see this - seems like everything OK. If empty - check for disabled COM port at Integrated Peripherals in BIOS
Setup Epel repo
cat > /etc/yum.repos.d/epel.repo << EOF
[epel]
name=Extra Packages for Enterprise Linux 5 - $basearch
baseurl=http://dl.fedoraproject.org/pub/epel/5/i386/
failovermethod=priority
enabled=0
gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL
EOF
Install needed software from Epel repo
yum search nut --enablerepo=epel
yum install nut --enablerepo=epel,base
Check access to /dev/ttyS0 device file
ls -l /dev/ttyS0
crw-rw---- 1 root uucp 4, 64 Jan 22 14:21 /dev/ttyS0
In our case wee need to add nut user into group uucp
usermod -G uucp nut
Setup NUT
cat >> /etc/ups/ups.conf << EOF
[apc1500]
 driver = apcsmart
 port = /dev/ttyS0
 desc = "main UPS"
 sdtype = 1
EOF
Add into corresponding part of file:
cat >> /etc/ups/upsd.users << EOF
[admin] 
 password = vVE69V_4vx 
 actions = SET 
 instcmds = ALL 
vi /etc/ups/upsmon.conf
MONITOR apc1500@localhost 1 admin vVE69V_4vx master
Change SHUTDOWNCMD in /etc/ups/upsmon.conf to
SHUTDOWNCMD "xe vm-shutdown --multiple power-state=running && /sbin/shutdown -h +0"
Start ups
/etc/init.d/ups start
Check UPS response
#upsc apc1500
battery.alarm.threshold: 0
battery.charge: 100.0
...
----
== Old HOWTO ==
Network UPS Tools are a handy set of tools for working with and managing and attached UPS (Uninterruptible Power Supply).
The particular point of this howto is a simple example of how to configure NUT on a pair of Xen XCP dom0 hosts with the following assumptions:
host1 assumed to be attached via USB to the UPS device
host2 on the same subnet as master, and is notified over TCP of changes in the power situation
host1/host2 are assumed to be powered by the same UPS (e.g. as it was in our office when I wrote this example we had two servers plugged into the UPS)
In the below example, host1's IP address is 192.168.41.21
The shutdown example below uses the "xe" command-line tool to shutdown any running XCP guests.
I used a Powerware UPS, with the bcmxcp_usb USB driver included with NUT. You will certainly have to make adjustments as needed.
This HowTo could definitely be improved by properly utilizing the 'nut' user account to run the management tools (my UPS had issues, so I gave up and ran everything as root), and also the init script could certainly be improved, it was written fairly quickly.
Install NUT on XCP host 1/2
wget http://download.alyseo.com:81/contrib/XenServer/v4.0.96/Nut/nut-2.2-1.i386.rpm
rpm -i nut-2.2-1.i386.rpm
Create a basic init script as there doesn't seem to be one in the NUT package I used.
vi /etc/init.d/nut
# Only on HOST2
# Comment out the start/stop lines for upsd and upsdrv, just leave upsmon
# Edit the driver 'bcmxcp_usb' below to match the driver from /usr/local/ups/bin/ that you'll be using.
#
#!/bin/bash
#
# chkconfig: - 80 20
# description: Nut
#
# processname: nut
# config: /usr/local/ups/etc/ups.conf
# pidfile: /var/run/nut
source /etc/rc.d/init.d/functions
RETVAL=0
prog="nut"
upsdrv="/usr/local/ups/bin/upsdrvctl"
drv="bcmxcp_usb"
upsd="/usr/local/ups/sbin/upsd"
ups="upsd"
upsmon="/usr/local/ups/sbin/upsmon"
mon="upsmon"
desc="NUT daemon"
start() {
 echo -n $"Starting $desc : "
 daemon $upsdrv -u root start
 $upsd -u root
 $upsmon -u root
 RETVAL=$?
 echo
 [ $RETVAL -eq 0 ] && touch /var/lock/subsys/$prog
 return $RETVAL
}
stop() {
 echo -n $"Shutting down $desc: "
 killproc $drv
 killproc $ups
 killproc $mon
 RETVAL=$?
 echo
 [ $RETVAL -eq 0 ] && rm -f /var/lock/subsys/$prog
 return $RETVAL
}
restart() {
 stop
 start
}
reload() {
 echo -n $"Reloading $desc: "
 killproc $drv -HUP
 killproc $ups -HUP
 killproc $mon -HUP
 RETVAL=$?
 echo
 return $RETVAL
}
case "$1" in
 start)
 start
 ;;
 stop)
 stop
 ;;
 restart)
 restart
 ;;
 reload)
 reload
 ;;
 condrestart)
 [ -e /var/lock/subsys/$prog ] && restart
 RETVAL=$?
 ;;
 status)
 status $prog
 RETVAL=$?
 ;;
 *)
 echo $"Usage: $0 {start|stop|restart|reload|condrestart|status}"
 RETVAL=1
esac
exit $RETVAL
#
chmod +x /etc/init.d/nut
chkconfig --add nut
Configure NUT on XCP host 1/2
vi /usr/local/ups/etc/ups.conf
# comment out everything, add this:
user=root
[Powerware5110]
driver = bcmxcp_usb
port = auto
vi /usr/local/ups/etc/upsd.conf
# comment out everything, add this:
#use the below on HOST1
LISTEN localhost 3493
LISTEN 192.168.41.21 3493
ACL all 0.0.0.0/0
ACL localhost 127.0.0.1/32
ACL office 192.168.41.0/24
ACCEPT localhost
ACCEPT office
REJECT all
#use the below on HOST2
ACL all 0.0.0.0/0
ACL localhost 127.0.0.1/32
ACCEPT localhost
REJECT all
#
vi /usr/local/ups/etc/upsd.users
# comment out everything, add this:
[local_mon]
password = MYPASSWORD 
allowfrom = localhost
upsmon master
[office_mon]
password = MYPASSWORD 
allowfrom = office
upsmon master
#
vi /usr/local/ups/etc/upsmon.conf
#
# HOST1 (master with UPS attached)
MONITOR Powerware5110@localhost 1 local_mon MYPASSWORD master
SHUTDOWNCMD "xe vm-shutdown --multiple power-state=running && /sbin/shutdown -h +0"
# HOST2 (slave just networked to master)
MONITOR Powerware5110@192.168.41.21 1 office_mon MYPASSWORD master
SHUTDOWNCMD "xe vm-shutdown --multiple power-state=running && /sbin/shutdown -h +0"
#
Start everything up, run on both host1/host2
#start the service
service nut start
#run this to get some stats from the UPS to check connectivity
/usr/local/ups/bin/upsc Powerware5110
Category:XCP
Category:HowTo
Category:Users