Changes

From SME Server
Jump to navigationJump to search
Moved NMC to configuration section
Line 17: Line 17:     
===Configure apcupsd===
 
===Configure apcupsd===
 +
====General====
 
Link the startup file and enable the service
 
Link the startup file and enable the service
 
  ln -s /etc/init.d/e-smith-service /etc/rc.d/rc7.d/S38apcupsd
 
  ln -s /etc/init.d/e-smith-service /etc/rc.d/rc7.d/S38apcupsd
Line 47: Line 48:  
  Error contacting apcupsd @ localhost:3551: Connection refused
 
  Error contacting apcupsd @ localhost:3551: Connection refused
 
then this may be due to Nut. Make sure Nut is stopped and disabled as above. You may also need to disconnect and reconnect the USB cable after Nut has been stopped}}
 
then this may be due to Nut. Make sure Nut is stopped and disabled as above. You may also need to disconnect and reconnect the USB cable after Nut has been stopped}}
  −
===Usage of apcupsd===
  −
The file ''/etc/apcupsd/apcupsd.conf'' controls the configuration of the apcupsd daemon and is well documented. In addition to this ''/etc/apcupsd/apccontrol'' is called by the daemon whenever a UPS event occurs, and determines the standard action taken. User configurable actions can be taken by creating/editing files in /etc/apcupsd with names corresponding to relevant events, and these are called first by ''apccontrol''. For example, a file called ''onbattery'' will be called by ''apccontrol'' whenever an ON BATTERY event occurs, and if ''onbattery'' returns an exit code of 99, then ''apccontrol'' will not take its own default action.
  −
  −
To view the UPS status of settings and monitored values you can use
  −
/sbin/apcaccess
  −
  −
To configure the UPS EEPROM values you can use
  −
/etc/init.d/apcupsd stop
  −
/sbin/apctest
  −
  −
Follow the command line menu to make selections and set UPS configuration vales. The menu varies depending upon if you are using usb or serial communications, but generally allows for querying the UPS status, running a battery calibration, programming the EEPROM values and communicating directly with the UPS in TTY mode.
  −
  −
Don't forget to restart the daemon when you are finished with apctest
  −
/etc/init.d/apcupsd start
  −
  −
See the [http://www.apcupsd.com/manual/manual.html documentation] for further details
  −
{{Note box|The UPS EEPROM value for RETPCT (Return Percentage - battery charge required before UPS powers up/on after failure) should be greater than the value of BATTERYLEVEL (battery charge level that initiates a shutdown) in ''/etc/apcupsd/apcupsd.conf''}}
   
====Network Management Cards====
 
====Network Management Cards====
 
If you have a Network Management Card installed in the UPS such as the AP9617 card, you can use ''snmp'' or ''pcnet'' for UPSTYPE with the following configurations
 
If you have a Network Management Card installed in the UPS such as the AP9617 card, you can use ''snmp'' or ''pcnet'' for UPSTYPE with the following configurations
Line 99: Line 82:  
{{Note box|msg=''ipaddress'' is the IP address assigned to the UPS. The default user is ''apc'' (and apparently can't be changed), and the ''AuthPhrase'' is the Authentication Phrase as set above}}
 
{{Note box|msg=''ipaddress'' is the IP address assigned to the UPS. The default user is ''apc'' (and apparently can't be changed), and the ''AuthPhrase'' is the Authentication Phrase as set above}}
 
Continue as above in the ''Configure apcupsd'' section
 
Continue as above in the ''Configure apcupsd'' section
 +
 +
===Usage of apcupsd===
 +
The file ''/etc/apcupsd/apcupsd.conf'' controls the configuration of the apcupsd daemon and is well documented. In addition to this ''/etc/apcupsd/apccontrol'' is called by the daemon whenever a UPS event occurs, and determines the standard action taken. User configurable actions can be taken by creating/editing files in /etc/apcupsd with names corresponding to relevant events, and these are called first by ''apccontrol''. For example, a file called ''onbattery'' will be called by ''apccontrol'' whenever an ON BATTERY event occurs, and if ''onbattery'' returns an exit code of 99, then ''apccontrol'' will not take its own default action.
 +
 +
To view the UPS status of settings and monitored values you can use
 +
/sbin/apcaccess
 +
 +
To configure the UPS EEPROM values you can use
 +
/etc/init.d/apcupsd stop
 +
/sbin/apctest
 +
 +
Follow the command line menu to make selections and set UPS configuration vales. The menu varies depending upon if you are using usb or serial communications, but generally allows for querying the UPS status, running a battery calibration, programming the EEPROM values and communicating directly with the UPS in TTY mode.
 +
 +
Don't forget to restart the daemon when you are finished with apctest
 +
/etc/init.d/apcupsd start
 +
 +
See the [http://www.apcupsd.com/manual/manual.html documentation] for further details
 +
{{Note box|The UPS EEPROM value for RETPCT (Return Percentage - battery charge required before UPS powers up/on after failure) should be greater than the value of BATTERYLEVEL (battery charge level that initiates a shutdown) in ''/etc/apcupsd/apcupsd.conf''}}
    
===Configure Multimon etc Scripts===
 
===Configure Multimon etc Scripts===

Navigation menu