Note: This documentation is still in progress, not reviewed properly, and might contain some errors or outdated images. It's intended for the upcoming 4.0.0 release, so configuration settings might be different from previous versions.

Upgrading to v3.8.1

Overview

Version 3.8.1 is a maintenance release that addresses several bugs and issues discovered in the v3.8.0 release. This patch update focuses on enhancing stability, security, and resolving specific issues with the new features introduced in v3.8.0.

Upgrade Instructions

  1. Download latest tarball from GitHub
  2. Backup your files and database before proceeding
  3. Replace all files with content from the downloaded archive
  4. Restore your configuration file (inc/config.inc.php) from backup

Bug Fixes and Improvements

Separate PowerDNS Database Fixes

  • Fixed parameter name inconsistencies in database configuration
  • Improved error handling for connections to separate PowerDNS databases
  • Optimized SQL queries when accessing tables across different databases
  • Enhanced performance for operations involving joins between Poweradmin and PowerDNS tables
  • Fixed edge cases where database prefixing was incorrectly applied

Language System Improvements

  • Resolved session persistence issues with language preferences
  • Enhanced validation of the enabled_languages configuration option
  • Fixed browser language detection compatibility issues
  • Improved fallback behavior when configured languages are unavailable
  • Corrected character encoding issues in certain language files

Search Functionality Enhancements

  • Fixed incorrect record counts when using the search grouping feature
  • Optimized SQL queries for grouped search results
  • Resolved pagination issues when using record grouping
  • Improved memory usage for large search result sets
  • Enhanced handling of special characters in search queries

Security Improvements

  • Fixed potential XSS vulnerabilities in record display and edit forms
  • Enhanced CSRF token validation throughout the application
  • Improved input sanitization for user-supplied data
  • Updated third-party dependencies to address security vulnerabilities
  • Strengthened validation for DNS record content

Browser Compatibility

  • Fixed CSS rendering issues in latest browser versions
  • Resolved JavaScript errors in the record management interfaces
  • Improved mobile responsiveness throughout the application
  • Enhanced keyboard navigation and accessibility
  • Fixed UI rendering inconsistencies in various browsers

Performance Optimizations

  • Improved caching behavior for frequently accessed data
  • Optimized database queries for better performance
  • Reduced memory usage for zone listing and editing operations
  • Enhanced page loading times throughout the application

Notes

  • No database schema changes are required for this update
  • This release maintains full backward compatibility with v3.8.0
  • The update is recommended for all users, especially those using the new features introduced in v3.8.0
  • This patch version focuses solely on bug fixes and enhancements without introducing new features