Skip to main content

Upgrade

Webmin-Upgrade Upgrade Planning Pre-Upgrade Preparation Backup Current Configuration: Complete backup of /etc/webmin

Document Current Settings: Export current configuration

Check System Compatibility: Verify OS and dependency requirements

Plan Maintenance Window: Schedule downtime for upgrade

Test Environment: Perform upgrade in test environment first

Version Compatibility Webmin 2.401 Requirements: Perl 5.10+, modern web browser

Module Compatibility: Verify third-party module compatibility

Operating System Support: Ensure OS version support

Database Requirements: Check database version compatibility

Upgrade Procedures Automatic Upgrade

bash
# Using Webmin's built-in upgrade feature
# Access through Webmin Configuration > Upgrade Webmin
# Command-line upgrade
sudo /usr/libexec/webmin/update-webmin.sh
# Check for updates
sudo /usr/libexec/webmin/update-webmin.sh --check

Manual Upgrade

bash
# Backup current installation
sudo cp -r /etc/webmin /etc/webmin.backup
sudo cp -r /usr/libexec/webmin /usr/libexec/webmin.backup
# Download Webmin 2.401
wget http://prdownloads.sourceforge.net/webadmin/webmin-2.401.tar.gz
tar -xzf webmin-2.401.tar.gz
cd webmin-2.401
# Run upgrade
sudo ./setup.sh /usr/libexec/webmin

Package-Based Upgrade

bash
# Ubuntu/Debian
wget http://prdownloads.sourceforge.net/webadmin/webmin_2.401_all.deb
sudo dpkg -i webmin_2.401_all.deb
# CentOS/RHEL
wget http://prdownloads.sourceforge.net/webadmin/webmin-2.401-1.noarch.rpm
sudo rpm -Uvh webmin-2.401-1.noarch.rpm

Post-Upgrade Tasks Verification Steps

bash
# Check Webmin version
cat /etc/webmin/version
# Verify service status
sudo systemctl status webmin
# Test web interface access
curl -k https://localhost:10000
# Check log files for errors
sudo tail -f /var/webmin/miniserv.log

Configuration Updates Webmin 2.401 includes new features like forgotten password recovery support for Virtualmin mailbox users and fixes for MySQL/MariaDB module database user creation.

New Features to Configure:

Password recovery functionality

Enhanced MySQL/MariaDB module features

Updated security settings

New module capabilities

Module Updates

bash
# Update individual modules
# Through Webmin Configuration > Webmin Modules
# Check for module updates
sudo /usr/libexec/webmin/update-modules.sh
# Install new modules if needed
sudo perl /usr/libexec/webmin/install-module.pl module.wbm.gz
Rollback Procedures
Emergency Rollback
bash
# Stop Webmin service
sudo systemctl stop webmin
# Restore from backup
sudo rm -rf /etc/webmin /usr/libexec/webmin
sudo cp -r /etc/webmin.backup /etc/webmin
sudo cp -r /usr/libexec/webmin.backup /usr/libexec/webmin
# Restart service
sudo systemctl start webmin

Selective Rollback

bash
# Restore only configuration
sudo cp -r /etc/webmin.backup/* /etc/webmin/
# Restore specific modules
sudo cp -r /usr/libexec/webmin.backup/module-name /usr/libexec/web