rPath Appliance Platform Agent:Release Notes/2

From rPath Wiki

The following release notes apply to 2.x versions of the rPath Appliance Platform Agent.

rPath Appliance Platform Agent 2.2.7

• Fixed: A Backup issue with memory consumption problem has been fixed. (RAA-1286)
• Fixed: lib.mount.parseProcMounts now accepts comments and empty lines in files. (RAA-1438)
• Fixed: Backup fails instead of hangs when CIFS mount goes into "DISCONNECTED" state. (RAA-1514)
• New: Major Version API call has been added at the url /apiInfo. (RAA-1517)
• Fixed: saveConfig no longer tests mountpoints when location data is unchanged. (RAA-1522)
• New: API exposed via xmlrpc which retrieves backup metadata using getBackupMetadata. (RAA-1526)
• New: It is now possible to change the location/amount of log files. (RAA-1539)

rPath Appliance Platform Agent 2.2.6

• Fixed: Tracebacks when trying to apply a rollback. RAA-1447
• Fixed: A bug preventing download of compressed log files. RAA-1459
• Fixed: Bugs in distinguishing between tar and gzipped tar files during restore operations. RAA-1461
• New: Added a configuration option to disable plugins individually. RAA-1495
• New: Added a config.d loading mechanism. RAA-1495
• Fixed: PAM authentication breaking due to incorrect method signature. RAA-1425
• Fixed: The time zone plugin did not work in wizard mode. RAA-1430
• Fixed: The updatetroves plug-in would display the updates list even if no updates were available - "phantom updates". RAA-803
• Fixed: Update email notifications were being sent even when no updates were available. RAA-1486
• Fixed: Plugins were not always disabled correctly. RAA-1451

rPath Appliance Platform Agent 2.2.5

• New: The raa.web.reauthorize decorator has been added to allow plugin authors a standard way to mark web functions as requiring reauthorization to help prevent Cross-Site Request Forgery (CSRF) attacks.
• Updated: The root password plugin now requires the currently logged in user to reauthenticate themselves. RAA-929
• Updated: The usermanagement plugin has been refactored to use the raa.web.reauthorize decorator; this means that the original XML-RPC method signatures for addUser and saveUser have been restored to pre-2.1.5 behavior.
• Fixed: The usermanagement plug-in will no longer add a user before the password is validated, which leaves the user in an undefined state. RAA-1394

rPath Appliance Platform Agent 2.2.4

• Fixed: The network configuration plugin would hang if given a very long hostname. RAA-1295
• Fixed: The network configuration plugin would read files in /etc/sysconfig/network-scripts with extensions such as .bak or .save; it was fixed to match the behavior of the /etc/init.d/network script. RAA-1348
• Fixed: Minor typographical errors in Collection Tool. RAA-1349
• Fixed: Collection Tool failed when a file to be copied did not exist. RAA-1352
• Fixed: The rollback plugin was incompatible with Conary 2.0. RAA-1350

rPath Appliance Platform Agent 2.2.3

• Updated: The Migrate tab in the System Updates task is hidden by default and can be configured by appliance developers using the updatetroves.migrate.hide option. RAA-1029
• Updated: The System Updates task logs an error if an update is attempted before backups are configured in Backup and Restore. RAA-1116
• Updated: The Backup and Restore task verifies backup location settings before saving them by attempting to mount the requested location at the time it is configured. RAA-936
• Updated: The Backup and Restore task can be full disabled by a user rather than just disabling the backup schedule, including updating the XML-RPC exposed method setConfigValues. RAA-848
• Updated: A user can be edited without having to change that user's password. RAA-992
• Updated: The Backup and Restore task times out after a reasonable amount of whem when attempting to write or read from an NFS backup location. RAA-920
• Updated: The Backup and Restore task displays a running byte found as data is written to or read from a backup file.
• Fixed: The rAPA service daemon would go away during a restart. RAA-1079
• Fixed: Processes would hang when executed by the rAPA service daemon when large amounts of output was products on standard out or standard error.
• Fixed: Configured NTP server information was lost when using Save Timezone Only.
• Fixed: Scheduled updates were not correctly applied when users configured the updates to be applied automatically. RAA-960

rPath Appliance Platform Agent 2.2.2

• New: A password_rules method was added to allow custom identity providers to include a descriptive explanation of the password rules for the system. (RAA-886)
• Updated: When a one-time schedule is created with no start time, it is transparently converted to a ScheduleNow object. (RAA-1060)
• Fixed: An ItemNotFound error that could occur when manipulating services (RAA-1027)
• Fixed: The NTP server information, if available, was lost when clicking the Save Time Zone Only button (RAA-1035)

rPath Appliance Platform Agent 2.2.1

• New: When any NTP changes are made, the user receives a notice that any NTP changes will only take affect when the NTP subsystem is restarted or the system is rebooted. (RAA-1034)
• Updated: Backup directory scans no longer produce notification emails. (RAA-1033)
• Updated: Error-reporting in the timezone configuration plugin is now API consistent with other plugins. (RAA-974)
• Updated: The appliance information collection tool scripts have been simplified, and data collection specific to rPath's appliances has been removed. (RAA-737)
• Fixed: Crash on restart when upgrading from a version of rAPA that keeps the SCGI socket open (versions prior to 2.1.1). (RAA-1032)
• Fixed: Bugs that prevented proper function of the restartInterface() method from the network configuration plugin. (RAA-1030)
• Fixed: Incorrect gateway information returned by index() method in the network configuration plugin.

rPath Appliance Platform Agent 2.2.0

• New: The backup format has changed to support embedding metadata into the image, which may be used to validate the backup before it is used to restore the system (RAA-921, RAA-1023)
• New: XML-RPC-enabled schedScan method and Scan Now button in the web interface, each for performing a scan after saving configurations and restoring backups (RAA-924, RAA-958)
• New: Network part of the Configure plugin now supports running scripts before and after completing a hostname change (RAA-846)
• New: status message for scheduled service operations (previously removed from rAPA after 1.0.14) (RAA-991)
• New: XML-RPC-enabled method for getting a list of time zones known by the system
• New: Notify the current user if a restore failed (RAA-971)
• New: Ensure that external partitions are properly mounted before attempting to restore (RAA-972)
• New: Instead of performing an automatic SHA-1 validation by default upon restoring a backup, check the value of backup.validateSha1 to determine whether or not this more expensive operation is needed (RAA-973, RAA-1016)
• New: The favicon.ico graphic can be rebranded similarly to replacing other image files (RAA-951)
• New: Migration tool for the Updates plugin that includes obtaining software from a new Conary label (RAA-913)
• New: The current time zone is returned in "index" and getProperties() (RAA-981)
• New: Flip-flop Boot plugin supports validating signed images before applying them as an update (RAA-873)
• Updated: Flip-flop Boot and Factory Reset plugins
• Fixed: Invalid time zone information in certain conditions; valid time zones obtained from a scan of zoneinfo instead of zone.tab (RAA-978)
• Fixed: Backup type names not intuitive to the user (RAA-658)
• Fixed: Restarts in raa-service (such as after an update) shows that the service was dead and the subsystem locked when status was checked by the init script, even though the service was running properly (RAA-975)
• Fixed: A syntax error shown briefly in Internet Explorer browsers when uploading SSL certificates

rPath Appliance Platform Agent 2.1.5.1 Update

• The factory reset plugin's confirmation dialog displayed and acted incorrectly on certain browsers. The dialog has been updated to use the Appliance Agent's modal dialogs, and fixed to work on those browsers.

rPath Appliance Platform Agent 2.1.5.1

• Fixed: Subsequent checks for updates would fail after an update was canceled. (RAA-949)

rPath Appliance Platform Agent 2.1.5

• The Backup and Restore page verifies configuration when saving. (RAA-815)
• Configure Networking enforces that a hostname is a fully qualified domain name (FQDN).
• Output from the development version of raa-service and raa-web has been significantly reduced, and logging data is redirected to files in the working directory.
• The current user must be logged in using an account that has the "admin" role and must provide that account's password when editing or adding a user. In the Python code, this feature adds separate XML-RPC-enabled "saveUserViaXmlprc" and "addUserViaXmlrpc" methods for saving user information.
• Downloadable backups display the download path location.
• Backup and Restore validates the restore ID of a backup before scheduling the restore.
• The Backup plugin includes the configuration parameter backup.filter_expression which takes a regular expression and that, together with backup.file_format, provides the possibility to specify a filtering mechanism by which one can select files to keep.
• The Backup plugin gets a list of current backups using the XML-RPC-enabled getBackupList method.
• The Backup plugin supports pre- and post-backup and -restore scripts.
• The Backup plugin generates SHA1 message digest for backups and uses it to validate backups and restores. (RAA-894)
• The Configure Time Zone and Time plugin returns its properties to XML-RPC clients using the getProperties method.
• The custom.css override is no longer available, and the lookasides for raa.css provide the same functionality.
• Fixed: When the system was under high load on symmetric multiprocessing (SMP) machines, errors states that the database file is encrypted or malformed.

rPath Appliance Platform Agent 2.1.4

• It is now easier to determine whether hostname was set via DHCP or not.
• The updates plugin will save a single update job. This fixes bugs in displaying available updates in the web interface, and reduces the possibility of having stale update jobs. (RAA-875)
• Top level groups are now stored for possibility of system update failures which may leave multiple top level groups not updated. If more than one top level group is discovered on an update check, the stored value is used for the update check, instead of failing. (RAA-597)
• Stored checks are invalidated when running the rollbacks plugin. (RAA-519)
• Update jobs are now properly invalidated by removing left over freeze or download directories.
• When regenerating an SSL certificate, redirect to plugin index template. (RAA-878)
• Fixed corner case where if you moved the system time back and immediately scheduled a task, the scheduled task may never run. (RAA-600)
• The appliance logs plugin now handles the download of compressed files. (RAA-863)
• It is now possible to configure the number of lines that can be displayed in the appliance log viewer. (RAA-862)
• Return the schedule ID during a restore in the backup plugin (XML-RPC callers only).
• The updatetroves plugin can now perform common maintenance tasks as part of the update process. If configured, a backup will be taken before an update occurs, with a reboot following. In addition, when a rollback is performed, the plugin will restore the last backup taken at the top level group existing after the rollback completes. (RAA-768)
• If something goes wrong when uploading a new SSL certificate, revert back to previous known good certificate. (RAA-859)
• Exclude some network devices from being displayed by the network plugin, such as the loop interface; Match devices using regular expression.
• Fixed a migration error that prevented the rPath Appliance Platform Agent from starting if an update check had been performed after the Agent was updated to version 2.1.3 via the command line. (RAA-830)
• Only show links on the status page if the linked plugin is visible to that user.
• Added wrappers around individual calls to initPlugin so that initPlugin would be allowed to make subsequent calls into other plugins' methods. Still cannot make calls to the back end to perform immediate tasks.
• Allow links to plugin subdirectories in /usr/lib/raa (RAA-198)
• Fix the URL to the plugin on the status page (RAA-807)
• Notification address field not shown by default if e-mail addresses are present. (RAA-806)

rPath Appliance Platform Agent 2.1.3

• The enable backup schedule buttons now disable the scheduling widgets.
• Backups no longer uses a staging tarball on the local system to work around limitations in tar. (RAA-427)
• Remove most uses of util.command so that error messages printed on stdout/stderr may be printed in tracebacks. (RAA-500)
• The network configuration plugin will now change the DHCP_HOSTNAME setting in the interface configuration files if it is set (e.g. via Anaconda). Checking the Get hostname from DHCP button will clear DHCP_HOSTNAME from the configuration files.
• The disk usage plugin developed for rBuilder has been added. (RAA-661)
• The backup plugin now will record the output from the mount command in case of a failure. This assists debugging if something goes wrong.
• Calls into the Conary API have been updated. (RAA-141)
• A per-plugin status display area to the main index page has been added. Plugins may populate this region by implementing a method in the web class that returns specially formatted text data.
• Disabled the Backup Now button when a backup is in progress.
• The update plugin supports segmented updates; that is, updates where one can first update a system fully to version 2 of a group before starting the update to version 3. This feature is only exposed via XML-RPC or JSON calls.
• Fixed the raa-web-scgi script so that it properly creates a pid file. (RAA-771)

rPath Appliance Platform Agent 2.1.2

• The web frontend will no longer die if an exception occurs in a plugin's initPlugin method.

rPath Appliance Platform Agent 2.1.1

• The web server closes all file descriptors when it is asked to restart, preventing a hang that occasionally occurred after restarts caused by tasks. This fix requires a patch to lighttpd in order to work properly; otherwise lighttpd can segmentation fault when this code runs.
• The Configure Network interface includes a "Get hostname from DHCP" checkbox when modifying the hostname. (RAA-649)
• The status page includes hostname information. (RAA-645)
• The Logs Viewer interface uses the following allowable list of line numbers from the dropdown: 10, 25, 50, 100, 250. (RAA-637)
• The Logs Viewer interface automatically scrolls to the last (bottom) line in the text box when displaying a log.
• Checking the NTP checkbox in the Time Zone Plugin toggles the ntpd service on and off and makes it persist.
• The Time Zone plugin uses the callBackend method to simplify its code. (RAA-618)
• Users are not allowed to remove the "admin" role from the "admin" group. (RAA-570)
• Notification emails are not sent after an update check if "autoapply" is set to true. (RAA-504)
• Fixed: the Configure Network interface hid warnings about the IP address changing, appearing that the interface was hanging instead of warning the user of the need to visit a new URL.
• Fixed: the login template had width information in the HTML code, preventing CSS alterations to the width of the login table.
• Fixed: errors resulting from setting system time backward.

rPath Appliance Platform Agent 2.1.0

• Added a static filter that allows OEM redistributors of the rPath Appliance Platform Agent to replace images, CSS and JavaScript without replacing files owned by the raa-branding package. (RAA-583)
• Allow the display of global gateway information if defined in the installer during installation. (RAA-603)
• Changed the caption for the reboot/shutdown now prompts in the reboot plugin, to display Yes/No instead of OK/Cancel. (RAA-578)
• The data returned from the services index method is now localized. In addition, an item has been added to the tuple: an integer value corresponding to the services known status; for example, if status is running, stopped, or locked.
• For services where the status is known, invalid actions are not allowed. As an example, if the service is stopped, stop or restart is not allowed.
• Implemented new threading and Queue models to correct a known deficiency in the Python threading and Queue modules. (RAA-468)
• Added a tooltip and a "refresh" icon to the network configuration plugin page to describe use of the refresh button next to the network device sections.
• When browsing logs via the Logs plugin, non-existing files or directories do not populate the drop down of available list.
• Allow HTTP basic auth login via /httplogin. (RAA-568)
• Do not report services status based on their return code.
• Added a message to notify the user that the application is working on something when AJAX calls are made using the Post framework. (RAA-462)
• The services plugin now makes use of callBackend to retrieve the status for services listed in services.shown (RAA-540).
• The logs plugin can now use wildcards, as the filename in the config. For example, the config {'Apache Access Logs': '/var/log/httpd/*access.log'} might return [ 'Apache Access Logs: /var/log/httpd/access.log', 'Apache Access Logs: /var/log/httpd/ssl-access.log']. (RAA-528)
• Fixed traceback that occurred in the logs plugin when the requested filename did not exist.
• Fixed the method that retrieves the "Appliance Log" to not return a blank line at the end.
• Added mechanisms for interrupting (raa.web:preventExecution()) and resuming (raa.web:permitExecution()) scheduled tasks.
• Plugins may now subscribe to tasks via taskId or schedId and register a callback to be called when that task starts or stops. The system can be used to chain jobs together, to interrupt tasks so that something else can be run first, or to extend functionality of other plugins without modifying them directly.
• Detection of plugins will find indirect, in addition to direct, subclasses of rAAWebPlugin.