Server Backup 6.18.2 Release Notes

----
{note:title=Important Upgrade Notice}
Customers upgrading from Server Backup Manager 6.2.2\+ can upgrade as normal, otherwise please upgrade to 6.2.2 first.  {note}
{note:title=MySQL and Virtuozzo}
If you have MySQL in Virtuozzo containers you will need to upgrade both the agent and the Backup Manager to address issues with recovery. {note}


h1. {color:#172b4d}Fixed Issues{color}

* Server Backup Agent changes to offer support for,
** Linux kernels Debian 12 / Kernel 6.1
** Alma/Rocky/RHEL/Cloud Linux 9.3 / Kernel 5.14
** •Ubuntu 22.04 / Kernel  5.19
* Microsoft SQL Server 2022 Support
* Bugfix: Incorrect timestamp shown when browsing recovery points of Alma Linux v9.2 or higher systems.

h1. {color:#172b4d}Upgrading{color}


h5.

{color:#172b4d}You must have an active maintenance account to upgrade. If you have a perpetual (non-heartbeat) license, it will be converted to a heartbeat license automatically upon upgrade. Make sure your SBM has {color}{color:#172b4d}{_}https{_}{color}{color:#172b4d} connectivity to complete this conversion. During the upgrade, you will be notified of the change and will be given the option to revert back to the previous version you were running. {color}


{note}{color:#172b4d}{*}Component upgrade order{*}{color}
{color:#172b4d}Server Backup Manager software must be upgraded in the following order:{color}

* {color:#172b4d}Server Backup Manager{color}
* {color:#172b4d}Server Backup Agent{color}
{note}


h5. {color:#172b4d}Data Center Console{color}

Data Center Console (DCC) is *not* compatible with Server Backup Manager v6.18.


h5. {color:#172b4d}Backup Agent{color}

{color:#172b4d}Backup Agent software requires a glibc version of 2.5 or greater.{color}
{info:title=GNU C Library Compatibility}
{color:#172b4d}Backup Agents on Linux distributions with older glibc libraries should remain on version 5.10 or earlier versions of the Backup Agent software. Refer to the following Knowledge Base article for more information: {color}{color:#172b4d}[Error - Linux cdp agent fails with "Floating Point Exception"|kb3:Error - Linux cdp agent fails with "Floating Point Exception"]{color}{color:#172b4d}.{color}{info}

h1. Kernel Modules Update 

Please watch this space for updates & timelines related to upcoming Stable and Beta kernel module releases. We thank you for your patience.

{color:windowtext}{*}{+}UPDATE 11/10/2023:+{*}{color}

Server Backup Manager 6.18.1 was released this week
With the 6.18.1 backup agent, BETA support is now available for the following operating systems:
\- Kernel 6.1  - Debian 12
\- Kernel 5.14 - Alma Linux 9.2 / RHEL 9.2 / Rocky Linux 9.2 / Cloud Linux 9.2 / Oracle Linux 9.2 / CentOS Stream 9

*{+}UPDATE 11/30/2023:+*
\- We are working on promoting 5.13 kernel modules, and 5.14 kernel modules for RHEL 9.0/9.1and similar distros, from BETA to Stable. Coming Soon\!
\- We are planning to add BETA module support for 5.17 kernels the week of December 4th 2023
{color:windowtext}\- {color}{color:windowtext}Work continues towards adding BETA support for 5.14 kernels, on RHEL 9.3 and similar distros. This work is expected to complete in Q1 2024.{color}{color:windowtext} {color}

{color:windowtext}{*}{+}UPDATE 12/15/2023{+}{*}{color}{color:windowtext}*:*{color}
{color:windowtext}\- {color}{color:windowtext}Modules for {color}{color:windowtext}AlmaLinux{color}{color:windowtext} 9.0/9.1 and Rocky Linux 9.0/9.1 operating systems have been promoted to production stable. These versions will now auto build from the agent using the "{color}{color:windowtext}getmodule{color}{color:windowtext}" command.{color}
{color:windowtext}\- {color}{color:windowtext}Modules for RHEL 9.0/9.1 operating systems will be promoted to production stable as early as next week{color}
{color:windowtext}\- {color}{color:windowtext}Work continues on BETA Support for {color}{color:windowtext}AlmaLinux{color}{color:windowtext} 9.3 operating systems{color}{color:windowtext} {color}

*{+}UPDATE 01/04/2024:+*
\- {color:windowtext}Modules for RHEL 9.0/9.1 operating systems {color}{color:windowtext}have been promoted to production stable. These versions will now auto build from the agent using the "{color}{color:windowtext}getmodule{color}{color:windowtext}" command{color}
{color:windowtext}\- Work continues on BETA Support for AlmaLinux 9.3 operating systems, now with a target availability of January 2024{color}

*{+}UPDATE 01/18/2024{+}*: 
\- Final testing on AlmaLinux 9.3 modules is underway. BETA modules will be available by the end of January 2024.
\- RHEL 9.3 BETA modules will be available soon after. 

*{+}UPDATE 02/01/2024 : +* 
\- AlmaLinux 9.2 / RockyLinux 9.2 modules for 5.14.x kernels have been promoted to production. Modules for this version will now auto build from the 6.18.1\+ agent using the "getmodule" command
\- We are now serving requests for AlmaLinux 9.3 BETA modules
\- We will begin serving requests for RHEL 9.3 BETA modules the week of February 5th
\- RockyLinux 9.3 BETA support is currently in testing

*{+}UPDATE 02/22/2024 :+*
\- RHEL 9.2 modules for 5.14.x kernels have been promoted to production. Modules for this version will now auto build from the 6.18.1\+ agent using the "getmodule" command 
\- We are now serving requests for RHEL 9.3, Rocky Linux 9.3, and CloudLinux 9.3 BETA modules 

*{+}UPDATE 03/07/2024 :+*
\- {color:windowtext}We are currently focused on the upcoming 6.18.2 release of R1Soft Server Backup Manager.{color}{color:windowtext} {color}
{color:windowtext}\- {color}{color:windowtext}The upcoming 6.18.2. release will open up BETA support for Debian 12, with 6.2 kernels.{color}{color:windowtext} {color}
{color:windowtext}\- {color}{color:windowtext}AlmaLinux{color}{color:windowtext} 9.3 modules will soon be promoted to production following the upcoming 6.18.2 release.{color}{color:windowtext} {color}












h1. {color:#172b4d}Known Issues{color}

{color:#000000}{*}Common Problems and Issues{*}{color}
* {color:#172b4d}When Disk Safes grow larger than 32TB, backups fail with : "reset(): database or disk is full", even when sufficient storage space is available.{color}
* {color:#172b4d}File search  will run forever for protected machines with EFI partitions, the search will get stuck in /boot/efi.   As a workaround, specify the starting path for the search.{color}
* {color:#172b4d}Multipath I/O storage configurations with duplicate device UUIDs are not supported and have been found to not function in some configurations.{color}
* {color:#172b4d}The merge task may fail when you attempt to merge a recovery point that was interrupted due to CLOB/BLOB issues. If the merge fails due to this issue, merge the points one by one. After the merge fails, merge each recovery point one by one until the task is successful.{color}
* {color:#172b4d}Users who have Debian installations should note that a Debian-based machine that has both RPM and DEB packages installed is recognized as RPM-based only by Server Backup Manager.{color}
* {color:#172b4d}Users cannot set heap memory for more than 1024 MB using {color}{color:#172b4d}{*}serverbackup-setup \-m{*}{color}{color:#172b4d}. Even if there is more than enough space, Server Backup Manager displays a message indicating that memory specified must be smaller than 1024 MB. Edit server.conf to update memory settings.{color}
* {color:#172b4d}Users who have more than 1,500 mount points per device may experience performance issues during a file restore or when attempting to browse recovery and archive points.{color}
* {color:#172b4d}(Cosmetic) zk-web messages in SBM log after install or upgrade. Steps to resolve can be found{color} {color:#172b4d}[here|kb3:zk-web messages in SBM log after install or upgrade]{color}

h5. {color:#172b4d}Installation issues{color}

* {color:#172b4d}Server Backup Agent installation on Windows Server 2022 fails as .NET 3.5 isn't enabled on Windows servers 2019 or 2022. If Microsoft .NET 3.5 is manually installed, remote agent installation completes successfully.{color}
* {color:#172b4d}Remote agent deployment on Windows 11 machine fails because of User Account Control Settings. Disable "Run all administrators in Admin Approval Mode" under User Account Control before running remote agent install.{color} {color:#172b4d}{*}Note{*}{color}{color:#172b4d}: A reboot of the Windows computer will be required.{color}
* {color:#172b4d}Server Backup 5.2.x and later do not support remote deployment to a Windows 2003 server because installing drivers requires user interaction..{color}

h5. {color:#172b4d}Restore issues{color}

* {color:#172b4d}After performing backup, unable to browse software RAID + LVM partition formatted with XFS filesystem.{color}
* {color:#172b4d}Users who use Centos LiveCD on any bare-metal restores that have LVM may receive error messages that they failed to restore deltas to a certain device number. This issue results from the fact that because the Centos LiveCD uses its own LVM to manage its file systems, dm-0 and dm-1 are always in use. To avoid this issue, choose a target that is two LVM devices higher than the original. For example, if /tmp is originally on {color}{color:#172b4d}_/dev/dm-1{_}{color}{color:#172b4d}, you should choose {color}{color:#172b4d}_/dev/dm-3{_}{color}{color:#172b4d} as your target.{color}
* {color:#172b4d}RecoveryCD versions 4.2.0 and 5.0.0 do not work when performing a bare-metal restore to a target that includes mdadm and LVM devices.{color}
* {color:#172b4d}Some users may receive an exception error message when attempting to exclude a large group of files in a directory when performing a restore.{color}
* {color:#172b4d}Microsoft Exchange Server 2007 users cannot restore a mailbox database to an alternate location.{color}

h5. Parallels Virtuozzo user issues

* {color:#172b4d}Not all files are downloaded for a container on Virtuozzo and system displays the error message, {color}{color:#172b4d}{{{}ERROR - Failed to download file{}}}{color}{color:#172b4d}, in the log file.{color}
* {color:#172b4d}Parallels Cloud Server 6.0 users may notice that Virtuozzo virtual machines are not detected as devices in the Disk Safe wizard. The VMs are backed up. If you need granular file restore for a VM, you can back up the PCS VM by installing a Server Backup Agent in the VM guest operating system.{color}
* {color:#172b4d}Virtuozzo users may notice that when some containers are downloaded, the compressed file does not contain the first and last container listed in the recovery points.{color}