| *Release Date:* | 10/08/2013 |
| *Build Date:* | 10/03/2013 |
| *Linux Manager/Agent Build Version:* | 5.4.2 build 71 |
| *Windows Manager/Agent Build Version:* | 5.4.2 build 71 |
| *Recommended Module Version*: | 4.4.0 build 18929 |
{note:title=Important Upgrade Considerations}
h5. Component upgrade order
For Server Backup 5.2.0 and later, you must upgrade the components in the following order or your backups may fail:
* Data Center Console (if applicable)
* Backup Manager
* Backup Agent
h5. Upgrading the Data Center Console
When users who have environments with Debian (deb) packages upgrade the Data Center Console, the system displays a message similar to the following:
{code}Configuration file `/usr/sbin/r1soft-datacenter-console/conf/server.properties'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it?{code}
*All DCC data is overwritten and lost* if you respond by pressing "Y" or "I." The default action keeps your current version. This issue does not affect environments with RPM packages.
h5. Upgrade window
When upgrading Server Backup, Idera recommends that you select a window of time when no jobs are running.
h5. MSSQL or Exchange backups
If your Windows environment contains an MSSQL or Exchange database on two different partitions, you should enable multi-volume snapshot (MVS) in the policy settings.
{note}
{info:title=Initial merge speed}Initial merges after an upgrade may be slow. The issue is due to calculations and identification of what items need merging. Once the calculations complete, the actual merge process is relatively quick. We are aware of this issue and we are working toward a resolution.{info}
{info:title=Upgrading Backup Agent on Linux}
Server Backup Manager may require additional manual steps when upgrading the Backup Agent on Linux. For more information about this process, see:
* [ServerBackup:Upgrade Backup Agent on CentOS, RHE and Fedora]
* [ServerBackup:Upgrade Backup Agent on Debian and Ubuntu]
{composition-setup}
cloak.toggle.type=text
{composition-setup}
{toggle-cloak:id=MyCloakID}Read special instructions for upgrading from 5.0.0 or 5.0.1 !arrow-transparent.gif!
{cloak:id=MyCloakID}
When upgrading from Backup Agent version 5.0.0 or 5.0.1, we suggest you perform the following manual steps before the upgrade:
1. Verify that there are no running or defunct {{cdp-2-6}} processes by running:
{code}ps ax | egrep –i c[d]p{code}
2. Proceed with the upgrade:
*For Centos/RHEL/rpm-based:*
{code}yum update {code}
_Or:_
{code}yum install serverbackup-enterprise-agent{code}
*For Debian/Ubuntu/apt-based:*
{code}apt-get update {code}
followed by
{code}apt-get upgrade
{code}
_Or:_
{code}apt-get install serverbackup-enterprise-agent{code}
3. Start the new Server Backup Agent:
*For Centos/RHEL/rpm-based:*
{code}service cdp-agent start{code}
*For Debian/Ubuntu/apt-based:*
{code}/etc/init.d/cdp-agent start{code}
To verify the 5.0.2 Backup Agent is running, run the following command:
{code}egrep "Agent Version|Starting" /usr/sbin/r1soft/log/cdp.log | tail -n2{code}
{cloak}
{info}
----
h2. NEW FEATURE
Server Backup Manager 5.4.2 now automatically detects and retrieves an updated Backup Agent module for Linux systems only when needed.
h2. FIXED ISSUES
* This release fixes vulnerability issues as explained in [Security Advisory 9-25-2013|ServerBackup:Security Advisory 9-25-2013].
* Task History no longer automatically jumps from a viewed page back to page 1 for users who are running multiple tasks that appear across multiples pages.
* An issue causing Server Backup Manager to display an unavailable (grayed-out) Browse Database button for all past recovery points after the users upgrades to SBM 5.4.0.
* Users no longer experience an intermittent failure caused by a null pointer exception when creating new recovery points during a backup.
* Users who upgrade to Server Backup Manager 5.4.2 no longer experience a hibernate exception when browsing recovery points with MySQL.
* This release fixes an issue that prevented the user from starting the service after upgrading the Data Center Console.
h2. KNOWN ISSUES
h5. General issues
* Server Backup 5.2.x and later do not support remote deployment to a Windows 2003 server because installing drivers requires user interaction.
* Fedora users who upgrade from Server Backup 4.2.1 should note that the cdp-server and cdp-agent services do not automatically restart after the upgrade. You must manually restart these services.
* The temporary (.tmp) folder is not deleted after completing a silent install of Server Backup Manager or Backup Agent using the default values. The folder is empty, but still exists on the server.
* Server Backup displays an incorrect error message when there is not enough space available in {{/tmp}}. The current message, “Path not found /tmp,” is not correct. The message should read, “Not enough usable space in {{<tempdir>}} on host {{<hostname>}}.”
h5. Server issues
* Some users may experience an unknown exception error when adding a server and attempting to display disk information. This issue results when Server Backup runs as a local system account which does not have rights to read the disk. You can resolve this issue by changing the process to run as an administrator.
h5. Disk safe issues
* Disk safe verification verifies only those recovery points with an available status. DSV does not verify recovery points with a locked or incomplete status.
h5. Volume issues
* You cannot delete a volume located at the root of a mount point. It is not recommended to create volumes in this location. If you want to delete a volume that resides at the root of a mount point:
*# Unmount the drive.
*# Create a directory that includes folders on the mounted device. This is the location where you can store your volumes.
*# Delete the volume using Server Backup.
h5. Recovery point issues
* 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.
h5. Restore issues
* 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 /dev/dm-1, you should choose /dev/dm-3 as your target.
* 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.
* Some users may receive an exception error message when attempting to exclude a large group of files in a directory when performing a restore.
* Microsoft Exchange Server 2007 users cannot restore a mailbox database to an alternate location.
h5. Data Center Console issues
* The Data Center Console Bulk Edit functionality is experiencing issues, such as not allowing a user to edit merge schedule policies with two disk safes and *Data Retention* selected.
* The Data Center Console displays incorrect values in the *Compression Type* section of the Edit Disk Safe window after editing the values.
* Internet Explorer users who enable the Compatibility view may notice graphical display issues when attempting to view some Data Center Console pages, such as the Disk Usage, Volumes, and Policies pages. This issue does not occur in other Web browsers.
h5. Parallels Virtuozzo user issues
* Some Virtuozzo users receive incomplete compressed files when downloading data for either the first or last container listed in the recovery points list.
* 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.
* If you are running Parallels Cloud Server 6.0 but not running the beta kernel module, you may experience an issue where Server Backup does not back up Ploop devices that have major/minor version numbers larger than 255 characters. An error is logged in the backup policy if this situation occurs.
h2. ADDITIONAL NOTES
h5. Bare-metal restore boot CD
Server Backup Manager 5.4.2 does not include an updated bare-metal restore boot CD as this feature is not changed. An updated CD is planned for the next release.
h5. Server Backup Advanced, Server Backup Free, and R1Soft Standard Edition (non-Enterprise) users
There are no changes to Server Backup Advanced, Server Backup Free, and Server Backup Standard Edition, and therefore no Server Backup 5.4.x upgrades are available at this time. These non-Enterprise products are still fully supported as Server Backup 5.2.x and no upgrade is required. In order to receive \*future\* upgrades for non-Enterprise products, please replace the repository upgrade path(s) stored in your Idera/R1Soft repository source list with the following URLs:
* Apt Non-Enterprise: [http://repo.r1soft.com/apt-non-enterprise]
* Yum Non-Enterprise: [http://repo.r1soft.com/yum-non-enterprise/stable/]
h5. Server Backup Enterprise and SE users
To receive the Server Backup 5.4.x upgrade, please replace the repository upgrade path(s) stored in your Idera/R1Soft repository source list with the following URLs:
* Apt Enterprise: [http://repo.r1soft.com/apt/|http://repo.r1soft.com/apt/]
* Yum Enterprise: [http://repo.r1soft.com/yum/stable/|http://repo.r1soft.com/yum/stable/]
| *Build Date:* | 10/03/2013 |
| *Linux Manager/Agent Build Version:* | 5.4.2 build 71 |
| *Windows Manager/Agent Build Version:* | 5.4.2 build 71 |
| *Recommended Module Version*: | 4.4.0 build 18929 |
{note:title=Important Upgrade Considerations}
h5. Component upgrade order
For Server Backup 5.2.0 and later, you must upgrade the components in the following order or your backups may fail:
* Data Center Console (if applicable)
* Backup Manager
* Backup Agent
h5. Upgrading the Data Center Console
When users who have environments with Debian (deb) packages upgrade the Data Center Console, the system displays a message similar to the following:
{code}Configuration file `/usr/sbin/r1soft-datacenter-console/conf/server.properties'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it?{code}
*All DCC data is overwritten and lost* if you respond by pressing "Y" or "I." The default action keeps your current version. This issue does not affect environments with RPM packages.
h5. Upgrade window
When upgrading Server Backup, Idera recommends that you select a window of time when no jobs are running.
h5. MSSQL or Exchange backups
If your Windows environment contains an MSSQL or Exchange database on two different partitions, you should enable multi-volume snapshot (MVS) in the policy settings.
{note}
{info:title=Initial merge speed}Initial merges after an upgrade may be slow. The issue is due to calculations and identification of what items need merging. Once the calculations complete, the actual merge process is relatively quick. We are aware of this issue and we are working toward a resolution.{info}
{info:title=Upgrading Backup Agent on Linux}
Server Backup Manager may require additional manual steps when upgrading the Backup Agent on Linux. For more information about this process, see:
* [ServerBackup:Upgrade Backup Agent on CentOS, RHE and Fedora]
* [ServerBackup:Upgrade Backup Agent on Debian and Ubuntu]
{composition-setup}
cloak.toggle.type=text
{composition-setup}
{toggle-cloak:id=MyCloakID}Read special instructions for upgrading from 5.0.0 or 5.0.1 !arrow-transparent.gif!
{cloak:id=MyCloakID}
When upgrading from Backup Agent version 5.0.0 or 5.0.1, we suggest you perform the following manual steps before the upgrade:
1. Verify that there are no running or defunct {{cdp-2-6}} processes by running:
{code}ps ax | egrep –i c[d]p{code}
2. Proceed with the upgrade:
*For Centos/RHEL/rpm-based:*
{code}yum update {code}
_Or:_
{code}yum install serverbackup-enterprise-agent{code}
*For Debian/Ubuntu/apt-based:*
{code}apt-get update {code}
followed by
{code}apt-get upgrade
{code}
_Or:_
{code}apt-get install serverbackup-enterprise-agent{code}
3. Start the new Server Backup Agent:
*For Centos/RHEL/rpm-based:*
{code}service cdp-agent start{code}
*For Debian/Ubuntu/apt-based:*
{code}/etc/init.d/cdp-agent start{code}
To verify the 5.0.2 Backup Agent is running, run the following command:
{code}egrep "Agent Version|Starting" /usr/sbin/r1soft/log/cdp.log | tail -n2{code}
{cloak}
{info}
----
h2. NEW FEATURE
Server Backup Manager 5.4.2 now automatically detects and retrieves an updated Backup Agent module for Linux systems only when needed.
h2. FIXED ISSUES
* This release fixes vulnerability issues as explained in [Security Advisory 9-25-2013|ServerBackup:Security Advisory 9-25-2013].
* Task History no longer automatically jumps from a viewed page back to page 1 for users who are running multiple tasks that appear across multiples pages.
* An issue causing Server Backup Manager to display an unavailable (grayed-out) Browse Database button for all past recovery points after the users upgrades to SBM 5.4.0.
* Users no longer experience an intermittent failure caused by a null pointer exception when creating new recovery points during a backup.
* Users who upgrade to Server Backup Manager 5.4.2 no longer experience a hibernate exception when browsing recovery points with MySQL.
* This release fixes an issue that prevented the user from starting the service after upgrading the Data Center Console.
h2. KNOWN ISSUES
h5. General issues
* Server Backup 5.2.x and later do not support remote deployment to a Windows 2003 server because installing drivers requires user interaction.
* Fedora users who upgrade from Server Backup 4.2.1 should note that the cdp-server and cdp-agent services do not automatically restart after the upgrade. You must manually restart these services.
* The temporary (.tmp) folder is not deleted after completing a silent install of Server Backup Manager or Backup Agent using the default values. The folder is empty, but still exists on the server.
* Server Backup displays an incorrect error message when there is not enough space available in {{/tmp}}. The current message, “Path not found /tmp,” is not correct. The message should read, “Not enough usable space in {{<tempdir>}} on host {{<hostname>}}.”
h5. Server issues
* Some users may experience an unknown exception error when adding a server and attempting to display disk information. This issue results when Server Backup runs as a local system account which does not have rights to read the disk. You can resolve this issue by changing the process to run as an administrator.
h5. Disk safe issues
* Disk safe verification verifies only those recovery points with an available status. DSV does not verify recovery points with a locked or incomplete status.
h5. Volume issues
* You cannot delete a volume located at the root of a mount point. It is not recommended to create volumes in this location. If you want to delete a volume that resides at the root of a mount point:
*# Unmount the drive.
*# Create a directory that includes folders on the mounted device. This is the location where you can store your volumes.
*# Delete the volume using Server Backup.
h5. Recovery point issues
* 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.
h5. Restore issues
* 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 /dev/dm-1, you should choose /dev/dm-3 as your target.
* 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.
* Some users may receive an exception error message when attempting to exclude a large group of files in a directory when performing a restore.
* Microsoft Exchange Server 2007 users cannot restore a mailbox database to an alternate location.
h5. Data Center Console issues
* The Data Center Console Bulk Edit functionality is experiencing issues, such as not allowing a user to edit merge schedule policies with two disk safes and *Data Retention* selected.
* The Data Center Console displays incorrect values in the *Compression Type* section of the Edit Disk Safe window after editing the values.
* Internet Explorer users who enable the Compatibility view may notice graphical display issues when attempting to view some Data Center Console pages, such as the Disk Usage, Volumes, and Policies pages. This issue does not occur in other Web browsers.
h5. Parallels Virtuozzo user issues
* Some Virtuozzo users receive incomplete compressed files when downloading data for either the first or last container listed in the recovery points list.
* 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.
* If you are running Parallels Cloud Server 6.0 but not running the beta kernel module, you may experience an issue where Server Backup does not back up Ploop devices that have major/minor version numbers larger than 255 characters. An error is logged in the backup policy if this situation occurs.
h2. ADDITIONAL NOTES
h5. Bare-metal restore boot CD
Server Backup Manager 5.4.2 does not include an updated bare-metal restore boot CD as this feature is not changed. An updated CD is planned for the next release.
h5. Server Backup Advanced, Server Backup Free, and R1Soft Standard Edition (non-Enterprise) users
There are no changes to Server Backup Advanced, Server Backup Free, and Server Backup Standard Edition, and therefore no Server Backup 5.4.x upgrades are available at this time. These non-Enterprise products are still fully supported as Server Backup 5.2.x and no upgrade is required. In order to receive \*future\* upgrades for non-Enterprise products, please replace the repository upgrade path(s) stored in your Idera/R1Soft repository source list with the following URLs:
* Apt Non-Enterprise: [http://repo.r1soft.com/apt-non-enterprise]
* Yum Non-Enterprise: [http://repo.r1soft.com/yum-non-enterprise/stable/]
h5. Server Backup Enterprise and SE users
To receive the Server Backup 5.4.x upgrade, please replace the repository upgrade path(s) stored in your Idera/R1Soft repository source list with the following URLs:
* Apt Enterprise: [http://repo.r1soft.com/apt/|http://repo.r1soft.com/apt/]
* Yum Enterprise: [http://repo.r1soft.com/yum/stable/|http://repo.r1soft.com/yum/stable/]