2011-01-26 09:35:08 +00:00
|
|
|
ifdef::txt[]
|
|
|
|
Upgrading notes
|
|
|
|
===============
|
|
|
|
endif::txt[]
|
|
|
|
|
|
|
|
This file lists changes that affect users who installed older versions
|
2010-03-25 23:20:59 +00:00
|
|
|
of this software. When upgrading from an older version, be sure to
|
|
|
|
check this file to see if you need to make changes to your system.
|
|
|
|
|
2015-04-30 13:53:36 +00:00
|
|
|
Changes from 2.7.2 to 2.7.3
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- The linkman:nutdrv_qx[8] driver will eventually supersede linkman:bestups[8].
|
|
|
|
It has been tested on a U-series Patriot Pro II. Please test the new driver
|
|
|
|
on your hardware during your next maintenance window, and report any bugs.
|
|
|
|
|
|
|
|
- If you are upgrading from a new install of 2.7.1 or 2.7.2, double-check the
|
|
|
|
value of POWERDOWNFLAG in $prefix/etc/upsmon.conf - it has been restored to
|
|
|
|
/etc/killpower as in 2.6.5 and earlier.
|
|
|
|
|
|
|
|
- If you use upslog with a large sleep value, you may be interested in adding
|
|
|
|
`killall -SIGUSR1 upslog` to any OB/OL script actions. This will force
|
|
|
|
upslog to write a log entry to catch short power transients.
|
|
|
|
|
|
|
|
- Be sure that your SSL keys are readable by the NUT system user. The SSL
|
|
|
|
subsystem is now initialized after `upsd` forks, to work around issues in the
|
|
|
|
NSS library.
|
|
|
|
|
|
|
|
- The systemd nut-server.service does not Require nut-driver to be started
|
|
|
|
successfully. This was previously preventing upsd startup, even for just
|
|
|
|
one driver failure among many. This also matches the behavior of sysV
|
|
|
|
initscripts.
|
|
|
|
|
2014-04-22 18:39:47 +00:00
|
|
|
Changes from 2.7.1 to 2.7.2
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- upsdrvctl is now installed to $prefix/sbin rather than $driverexec.
|
|
|
|
This usually means moving from /bin to /sbin, apart from few exceptions.
|
|
|
|
In all cases, please adapt your scripts.
|
|
|
|
|
|
|
|
- FreeDesktop Hardware Abstraction Layer (HAL) support was removed.
|
|
|
|
Please adapt your packaging files, if you used to distribute the
|
|
|
|
nut-hal-drivers package.
|
|
|
|
|
|
|
|
- This is a good time to point out that for stricter packaging systems, it may
|
|
|
|
be beneficial to add "--enable-option-checking=fatal" to the ./configure
|
|
|
|
command line, in order to quickly pick up any other removed option flags.
|
|
|
|
|
2013-11-24 15:00:12 +00:00
|
|
|
Changes from 2.6.5 to 2.7.1
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- The linkman:apcsmart[8] driver has been replaced by a new implementation. There is a new
|
|
|
|
parameter, 'ttymode', which may help if you have a non-standard serial port,
|
|
|
|
or Windows. In case of issues with this new version, users can revert to
|
|
|
|
apcsmart-old.
|
|
|
|
|
|
|
|
- The linkman:nutdrv_qx[8] driver will eventually supersede blazer_ser and blazer_usb.
|
|
|
|
Options are not exactly the same, but are documented in the nutdrv_qx man
|
|
|
|
page.
|
|
|
|
|
|
|
|
- Mozilla NSS support has been added. The OpenSSL configuration options should
|
|
|
|
be unchanged, but please refer to the linkman:upsd.conf[5] and
|
|
|
|
linkman:upsmon.conf[5] documentation in case we missed something.
|
|
|
|
|
|
|
|
- linkman:upsrw[8] now prints out the maximum size of variables. Hopefully you
|
|
|
|
are not parsing the output of upsrw - it would be easier to use one of the
|
|
|
|
NUT libraries, or implement the network protocol yourself.
|
|
|
|
|
|
|
|
- The jNut source is now here: https://github.com/networkupstools/jNut
|
|
|
|
|
2012-08-12 21:39:31 +00:00
|
|
|
Changes from 2.6.4 to 2.6.5
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- users are encouraged to update to NUT 2.6.5, to fix a regression in
|
|
|
|
upssched.
|
|
|
|
- mge-shut driver has been replaced by a new implementation (newmge-shut).
|
|
|
|
In case of issue with this new version, users can revert to oldmge-shut.
|
|
|
|
|
2012-06-01 13:55:19 +00:00
|
|
|
Changes from 2.6.3 to 2.6.4
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- users are encouraged to update to NUT 2.6.4, to fix upsd vulnerability
|
2012-08-12 21:39:31 +00:00
|
|
|
(CVE-2012-2944: upsd can be remotely crashed).
|
2012-06-01 13:55:19 +00:00
|
|
|
- users of the bestups driver are encouraged to switch to blazer_ser,
|
|
|
|
since bestups will soon be deprecated.
|
|
|
|
|
2012-01-24 10:22:33 +00:00
|
|
|
Changes from 2.6.2 to 2.6.3
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- nothing that affects upgraded systems.
|
|
|
|
|
2011-09-29 18:14:46 +00:00
|
|
|
Changes from 2.6.1 to 2.6.2
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- apcsmart driver has been replaced by a new implementation. In case of issue
|
|
|
|
with this new version, users can revert to apcsmart-old.
|
|
|
|
|
2011-06-01 20:31:49 +00:00
|
|
|
Changes from 2.6.0 to 2.6.1
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- nothing that affects upgraded systems.
|
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
Changes from 2.4.3 to 2.6.0
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- users of the megatec and megatec_usb drivers must respectively switch to
|
|
|
|
blazer_ser and blazer_usb.
|
|
|
|
- users of the liebertgxt2 driver are advised that the driver name has changed
|
|
|
|
to liebert-esp2.
|
|
|
|
|
|
|
|
Changes from 2.4.2 to 2.4.3
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- nothing that affects upgraded systems.
|
|
|
|
|
|
|
|
Changes from 2.4.1 to 2.4.2
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- The default subdriver for the blazer_usb driver USB id 06da:0003 has changed.
|
|
|
|
If you use such a device and it is no longer working with this driver, override
|
|
|
|
the 'subdriver' default in 'ups.conf' (see man 8 blazer).
|
|
|
|
- NUT ACL and the allowfrom mechanism has been replaced in 2.4.0 by the LISTEN
|
|
|
|
directive and tcp-wrappers respectively. This information was missing below, so
|
|
|
|
a double note has been added.
|
|
|
|
|
|
|
|
Changes from 2.4.0 to 2.4.1
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- nothing that affects upgraded systems.
|
|
|
|
|
|
|
|
Changes from 2.2.2 to 2.4.0
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- The nut.conf file has been introduced to standardize startup configuration
|
|
|
|
across the various systems.
|
|
|
|
- The cpsups and nitram drivers have been replaced by the powerpanel driver,
|
|
|
|
and removed from the tree. The cyberpower driver may suffer the same in the
|
|
|
|
future.
|
|
|
|
- The al175 and energizerups drivers have been removed from the tree, since
|
|
|
|
these were tagged broken for a long time.
|
|
|
|
- Developers of external client application using libupsclient must rename
|
|
|
|
their "UPSCONN" client structure to "UPSCONN_t".
|
|
|
|
- The upsd server will now disconnect clients that remain silent for more than
|
|
|
|
60 seconds.
|
|
|
|
- The files under scripts/python/client are distributed under GPL 3+, whereas
|
|
|
|
the rest of the files are distributed under GPL 2+. Refer to COPYING for more
|
|
|
|
information.
|
|
|
|
- The generated udev rules file has been renamed with dash only, no underscore
|
|
|
|
anymore (ie 52-nut-usbups.rules instead of 52_nut-usbups.rules)
|
|
|
|
|
|
|
|
Changes from 2.2.1 to 2.2.2
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- The configure option "--with-lib" has been replaced by "--with-dev".
|
|
|
|
This enable the additional build and distribution of the static
|
|
|
|
version of libupsclient, along with the pkg-config helper and manual
|
|
|
|
pages. The default configure option is to distribute only the shared
|
|
|
|
version of libupsclient. This can be overriden by using the
|
|
|
|
"--disable-shared" configure option (distribute static only binaries).
|
|
|
|
- The UPS poweroff handling of the usbhid-ups driver has been reworked.
|
|
|
|
Though regression is not expected, users of this driver are
|
|
|
|
encouraged to test this feature by calling "upsmon -c fsd" and
|
|
|
|
report any issue on the NUT mailing lists.
|
|
|
|
|
|
|
|
Changes from 2.2.0 to 2.2.1
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- nothing that affects upgraded systems.
|
|
|
|
(The below message is repetead due to previous omission)
|
|
|
|
- Developers of external client application using libupsclient are
|
|
|
|
encouraged to rename their "UPSCONN" client structure to "UPSCONN_t"
|
|
|
|
since the former will disappear by the release of NUT 2.4.
|
|
|
|
|
|
|
|
Changes from 2.0.5 to 2.2.0
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- users of the newhidups driver are advised that the driver name has changed
|
|
|
|
to usbhid-ups.
|
|
|
|
- users of the hidups driver must switch to usbhid-ups.
|
|
|
|
- users of the following drivers (powermust, blazer, fentonups, mustek,
|
|
|
|
esupssmart, ippon, sms) must switch to megatec, which replaces
|
|
|
|
all these drivers. Please refer to doc/megatec.txt for details.
|
|
|
|
- users of the mge-shut driver are encouraged to test newmge-shut, which
|
|
|
|
is an alternate driver scheduled to replace mge-shut,
|
|
|
|
- users of the cpsups driver are encouraged to switch to powerpanel which
|
|
|
|
is scheduled to replace cpsups,
|
|
|
|
- packagers will have to rework the whole nut packaging due to the
|
|
|
|
major changes in the build system (completely modified, and now using
|
|
|
|
automake). Refer to packaging/debian/ for an example of migration.
|
|
|
|
- specifying '-a <id>' is now mandatory when starting a driver manually,
|
|
|
|
ie not using upsdrvctl.
|
|
|
|
- Developers of external client application using libupsclient are
|
|
|
|
encouraged to rename the "UPSCONN" client structure to "UPSCONN_t"
|
|
|
|
since the former will disapear by the release of NUT 2.4.
|
|
|
|
|
|
|
|
Changes from 2.0.4 to 2.0.5
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- users of the newhidups driver: the driver is now more strict about
|
|
|
|
refusing to connect to unknown devices. If your device was
|
|
|
|
previously supported, but fails to be recognized now, add
|
|
|
|
'productid=XXXX' to ups.conf. Please report the device to the NUT
|
|
|
|
developer's mailing list.
|
|
|
|
|
|
|
|
Changes from 2.0.3 to 2.0.4
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- nothing that affects upgraded systems.
|
|
|
|
- users of the following drivers (powermust, blazer, fentonups, mustek,
|
|
|
|
esupssmart, ippon, sms, masterguard) are encouraged to switch to megatec,
|
|
|
|
which should replace all these drivers by nut 2.2. For more information,
|
|
|
|
please refer to doc/megatec.txt
|
|
|
|
|
|
|
|
Changes from 2.0.2 to 2.0.3
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- nothing that affects upgraded systems.
|
|
|
|
- hidups users are encouraged to switch to newhidups, as hidups will be
|
|
|
|
removed by nut 2.2.
|
|
|
|
|
|
|
|
Changes from 2.0.1 to 2.0.2
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- The newhidups driver, which is the long run USB support approach,
|
|
|
|
needs hotplug files installed to setup the right permissions on
|
|
|
|
device file to operate. Check newhidups manual page for more information.
|
|
|
|
|
|
|
|
Changes from 2.0.0 to 2.0.1
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- The cyberpower1100 driver is now called cpsups since it supports
|
|
|
|
more than just one model. If you use this driver, be sure to remove
|
|
|
|
the old binary and update your ups.conf 'driver=' setting with the
|
|
|
|
new name.
|
|
|
|
|
|
|
|
- The upsstats.html template page has been changed slightly to reflect
|
|
|
|
better HTML compliance, so you may want to update your installed copy
|
|
|
|
accordingly. If you've customized your file, don't just copy the new
|
|
|
|
one over it, or your changes will be lost!
|
|
|
|
|
|
|
|
Changes from 1.4.0 to 2.0.0
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
- The sample config files are no longer installed by default. If you
|
|
|
|
want to install them, use 'make install-conf' for the main programs,
|
|
|
|
and 'make install-cgi-conf' for the CGI programs.
|
|
|
|
|
|
|
|
- ACCESS is no longer supported in upsd.conf. Use ACCEPT and REJECT.
|
|
|
|
Old way:
|
|
|
|
|
|
|
|
ACCESS grant all adminbox
|
|
|
|
ACCESS grant all webserver
|
|
|
|
ACCESS deny all all
|
|
|
|
|
|
|
|
New way:
|
|
|
|
|
|
|
|
ACCEPT adminbox
|
|
|
|
ACCEPT webserver
|
|
|
|
REJECT all
|
|
|
|
|
|
|
|
Note that ACCEPT and REJECT can take multiple arguments, so this
|
|
|
|
will also work:
|
|
|
|
|
|
|
|
ACCEPT adminbox webserver
|
|
|
|
REJECT all
|
|
|
|
|
|
|
|
- The drivers no longer support sddelay in ups.conf or -d on the
|
|
|
|
command line. If you need a delay after calling 'upsdrvctl
|
|
|
|
shutdown', add a call to sleep in your shutdown script.
|
|
|
|
|
|
|
|
- The templates used by upsstats have changed considerably to reflect
|
|
|
|
the new variable names. If you use upsstats, you will need to
|
|
|
|
install new copies or edit your existing files to use the new names.
|
|
|
|
|
|
|
|
- Nobody needed UDP mode, so it has been removed. The only users
|
|
|
|
seemed to be a few people like me with ancient asapm-ups binaries.
|
|
|
|
If you really want to run asapm-ups again, bug me for the new patch
|
|
|
|
which makes it work with upsclient.
|
|
|
|
|
|
|
|
- 'make install-misc' is now 'make install-lib'. The misc directory
|
|
|
|
has been gone for a long time, and the target was ambiguous.
|
2010-03-25 23:20:59 +00:00
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
- The newapc driver has been renamed to apcsmart. If you previously
|
|
|
|
used newapc, make sure you delete the old binary and fix your
|
|
|
|
ups.conf. Otherwise, you may run the old driver from 1.4.
|
2010-03-25 23:20:59 +00:00
|
|
|
|
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
*** File trimmed here on changes from 1.2.2 to 1.4.0 ***
|
2010-03-25 23:20:59 +00:00
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
For information before this point, start with version 2.4.1 and work back.
|