User Tools

Site Tools


supported_hardware:ups

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
supported_hardware:ups [2023/02/13 14:52] – external edit 127.0.0.1supported_hardware:ups [2023/04/07 14:29] (current) – added deprecation message about disk space scanning and links to the new sysinfo plugin James Sentman
Line 1: Line 1:
 =====UPS: Uninterruptible Power Supply Plugin===== =====UPS: Uninterruptible Power Supply Plugin=====
 +
 +>**NOTE:** as of XTension version 9.5.2 the disk space monitoring in this plugin is deprecated. It will continue to work but for new setups and additional functionality please use the new [[supported_hardware:sysinfo|Sysinfo Plugin]] The other functionality of this plugin of monitoring a directly connected UPS is not deprecated. For monitoring UPS’s connected to other devices please have a look at the [[supported_hardware:apc|raspberry pi apcups plugin]].
 +
 +
 {{ :supported_hardware:upslistwindow.png|}} {{ :supported_hardware:upslistwindow.png|}}
 The UPS plugin provides a connection between XTension and a UPS that is compatible with the built in OSX support for such devices. If you see a battery level in the system for a UPS connected via USB then the same UPS will be compatible with the UPS plugin for XTension. Build 830 of XTension adds the reporting of disk drive space to this plugin too. The UPS plugin provides a connection between XTension and a UPS that is compatible with the built in OSX support for such devices. If you see a battery level in the system for a UPS connected via USB then the same UPS will be compatible with the UPS plugin for XTension. Build 830 of XTension adds the reporting of disk drive space to this plugin too.
Line 9: Line 13:
  
 For more information on dealing with UPS's and power failures with the Macintosh and XTension please see [[tutorials:dealing with power failures]] For more information on dealing with UPS's and power failures with the Macintosh and XTension please see [[tutorials:dealing with power failures]]
 +
 +-----
  
 =====Using UPS Monitor with XTension==== =====Using UPS Monitor with XTension====
 +>**NOTE:** the Unit Addresses in the screen shot above are incorrect for the current version of this plugin and the image needs to be updated. Please use the addresses described below for your Units and not the old x10 style addressing this plugin originally used in the very dark and very distant past.
 +
  
 Create a new interface in XTensions preferences and select "ups" as the device type. No port selections or other setup is required, just give it a more descriptive name. In order to make available all the information that the plugin can provide you'll need to create 6 units. Assign them to the ups interface you created earlier and give them the following address strings: Create a new interface in XTensions preferences and select "ups" as the device type. No port selections or other setup is required, just give it a more descriptive name. In order to make available all the information that the plugin can provide you'll need to create 6 units. Assign them to the ups interface you created earlier and give them the following address strings:
Line 21: Line 29:
   * Is Charging (address: “CHARGING”, not dimmable) is the battery currently charging or not.   * Is Charging (address: “CHARGING”, not dimmable) is the battery currently charging or not.
  
 +-----
    
 =====Monitoring Disk Space===== =====Monitoring Disk Space=====
 +
 +>**NOTE:** Please see the deprecation notice at the top of this page and use the newer [[supported_hardware:sysinfo|sysinfo]] plugin to get this information.
 +
 With version 830 of XTension this plugin also sends regular updates with the percent available and k available for each mounted disk. Create a unit on this interface with the name of the disk drive as the address to receive the bytes available in k, and create another but put a “%” at the end of the disk name to receive the percent available value. Both values are always sent though you do not have to create a unit for them if you do not wish to they will always show in the log.  The system may also include various other mounted file systems such as the time machine disk and volume that are dynamically created and unmounted by the system as well as other network file systems.  With version 830 of XTension this plugin also sends regular updates with the percent available and k available for each mounted disk. Create a unit on this interface with the name of the disk drive as the address to receive the bytes available in k, and create another but put a “%” at the end of the disk name to receive the percent available value. Both values are always sent though you do not have to create a unit for them if you do not wish to they will always show in the log.  The system may also include various other mounted file systems such as the time machine disk and volume that are dynamically created and unmounted by the system as well as other network file systems. 
  
 Running out of disk space on the server can be a major headache and cause data loss and database corruption even though XTension goes to a great deal of trouble not to corrupt itself in that case it’s not something you want to happen if you can avoid it. Sending yourself an email or other alert when this gets too low is a really good idea. Running out of disk space on the server can be a major headache and cause data loss and database corruption even though XTension goes to a great deal of trouble not to corrupt itself in that case it’s not something you want to happen if you can avoid it. Sending yourself an email or other alert when this gets too low is a really good idea.
 +
 +-----
 +=====History:=====
 +
 +  * 4/7/2023 Deprecated the disk space monitoring functions of this plugin in favor of the newer Sysinfo plugin.
 +  * This plugin has been part of XTension for so long nobody knows when it was first added, least of all the author. 
supported_hardware/ups.txt · Last modified: 2023/04/07 14:29 by James Sentman