Upgrading Enterprise Agent for Windows

You may be informed by email when a new version of R1Soft software is released. New versions are improved by bug fixes and new/reworked functionality. All enhancements made to the product are documented in the *release notes*. Release notes usually contain a brief summary of recent changes, enhancements, and bug fixes in a particular software release.

{info:title=Note}{color:#fd4703}{*}New in version 4.2{*}{color}. Windows installers will support English, Japanese, and Spanish. End users cannot add install support for additional languages. Language chosen during the install will NOT become the CDP Server default user language.
{info}

{info:title=Note} You can view the release notes here: [Release Notes].
{info}
First, [obtain|Obtaining Windows CDP Enterprise Edition] the latest version of the CDP Enterprise Edition installer (4.2). You can use the "Enterprise Edition" or "Enterprise Agent" installer to upgrade the CDP Agent Enterprise Edition. Then access the computer on which the current version of CDP Agent is installed. (You must already have a PC running Windows CDP Agent 4.2.0 Enterprise Edition or an earlier version.)
{info:title=Note}R1Soft products follow this format for version numbers: MAJOR.MINOR.MAINTENANCE. Pre-release downloads ALWAYS have a version number that has an ODD MINOR number, e.g., 3.*{+}7{+}*.5. Stable downloads ALWAYS have a version number with an EVEN MINOR number, e.g., 3.*{+}8{+}*.3.{info}

While upgrading, the following information may be useful:

* To upgrade the CDP Server, you do not need to uninstall the previous version.
* It is recommended that you close all other applications before starting Setup. This will make it possible to update relevant system files without having to reboot your computer.
* Customers upgrading Windows Agents from 2.x to 3.14 or later versions no longer require a manual uninstall of the 2.x Windows Agent. Users running the 3.14 installer will be prompted during installation to remove the 2.x Agent (if detected). The installer will remove all 2.x binaries and require a reboot and re-run of the 3.14 installer to complete the installation process.
* The 3.18.0 release contained an updated driver to support new features and/or fixes. If you are upgrading from an earlier release or are performing a new installation of 4.2, a reboot is required for proper operation of the Windows Agent. This is not a forced reboot as the user has to approve the reboot by selecting "Yes" or "No" during the installation process.
* The upgrade will change the java heap size to 50% of physical memory if the {{server.conf}} file has been customized with a higher value. Reserving more than 50% of a system's memory for the Java Heap can result in situations where not enough memory is available to the CDP server for non-heap memory or for other applications running on the system. For more information, see [Configuring Enterprise Edition on Windows].
* Customers upgrading from version 3.10 with Archiving Limits set prior to the upgrade will need to reset archive limits post-upgrade. This can be easily accomplished using the bulk edit feature, which can be accessed via the Policy tab.
* Customers upgrading from version 3.10 or earlier versions may experience a delay when starting the WebUI. Please be patient as important updates are in progress. The log file will display "CDP Started" when all database updates are complete.

To upgrade the Windows CDP Agent Enterprise Edition to version 4.2, perform the following steps:

1. Log on to the Windows server as a member of the local Administrators group.

2. Navigate to the directory where you saved the CDP installation file. The installer will have the following attributes:

*For a 32-bit system:*
* File name - R1Soft-EnterpriseAgent-win32.zip
* File size - 30.1 MB

*For a 64-bit system:*
* File name - R1Soft-EnterpriseAgent-win64.zip
* File size - 52.0 MB
\\
{info:title=Note}The "Enterprise Edition" installer package is capable of installing/upgrading both Server and Agent software. The "Enterprise Agent" installer package contains only the Agent software and is a much smaller package.
{info}3. Extract the file from the archive. Execute the installer by clicking "Run."
\\

4. In the Welcome window, select a destination folder and click "Install."

!1install_ag_4-2.png!

5. Wait while the files are extracted.

!2install_ag_4-2.png!

6. Click "Install" in the opened window.

!3install_ag_4-2.png!

7. Click "Install CDP Agent."

!4install_ag_4-2.png!

8. The R1Soft CDP Agent Installer will open. Make sure all other applications are closed and click "Next."

!5install_ag_4-2.png!

9. You must agree to the following license agreement. Read it to the end and click "Next" to accept.

!6install_ag_4-2.png!

10. The installer will check your system for possible problems. It is strongly recommended that all tests have a "Pass" status. You can repeat the tests by clicking the "Test" button. Click "Next" to go to the next screen.

!7install_ag_4-2.png!

{info:title=Note}You can find the full list of requirements at [http://www.r1soft.com/windows-cdp/cdp-enterprise-edition/sys-req/].
{info}
{info:title=Note}
If one or several requirements are not met, then an explanation will be displayed in the "Message" column. If this happens, further installation is not recommended on this configuration.

There are three possible values for the "Status" column: "Pass," "Not Recommended," and "Fail."

If possible, correct the configuration and click "Test" again.
{info}

11. On the next screen, verify that there is free space on the drive where the CDP Agent is installed. Click "Next" to continue.
{info:title=Note} During the upgrade, you cannot change the installation directory for the Agent.
{info}

!upgrade1.png!

12. The configuration is complete. Click "Next" to start the upgrade process.

!upgrade2.png!

13. The upgrade process will start.

!upgrade3.png!

14. The upgrade process is complete. Click "Finish."

!11install_ag_4-2.png!

A Full Block Scan will be initiated after an Agent upgrade due to a restart of the Agent service/daemon. This ensures that replicas are consistent, even after a server crash or reboot. For more information or to better understand backup types, see [Benefits of CDP|http://www.r1soft.com/windows-cdp/cdp-enterprise-edition/features/high-performance-backup/].{excerpt:hidden=true}Instructions on how to upgrade CDP Agent Enterprise Edition to version 4.2 on Windows.{excerpt}











{newversion}
You may be informed by email when a new version of R1Soft software is released. New versions are improved by bug fixes and new/reworked functionality. All enhancements made to the product are documented in the *release notes*. Release notes usually contain a brief summary of recent changes, enhancements, and bug fixes in a particular software release.

{info:title=Note} Windows installers support English, Japanese, and Spanish. End users cannot add install support for additional languages. Language chosen during the install will NOT become the CDP Server default user language.
{info}

{info:title=Note} You can view the release notes here: [Release Notes].
{info}
First, [obtain|Obtaining Windows CDP Enterprise Edition] the latest version of the CDP Service Provider (Enterprise) Edition installer. You can use the "Service Provider (Enterprise) Edition" or "Enterprise Agent" installer to upgrade the CDP Agent Service Provider (Enterprise) Edition. Then access the computer on which the current version of CDP Agent is installed. (You must already have a PC running Windows CDP Agent 4.6.0 Service Provider (Enterprise) Edition or an earlier version.)
{info:title=Note}R1Soft products follow this format for version numbers: MAJOR.MINOR.MAINTENANCE. Pre-release downloads ALWAYS have a version number that has an ODD MINOR number, e.g., 3.*{+}7{+}*.5. Stable downloads ALWAYS have a version number with an EVEN MINOR number, e.g., 3.*{+}8{+}*.3.{info}

While upgrading, the following information may be useful:

* To upgrade the CDP Server, you do not need to uninstall the previous version.
* It is recommended that you close all other applications before starting Setup. This will make it possible to update relevant system files without having to reboot your computer.
* Customers upgrading Windows Agents from 2.x to 3.14 or later versions no longer require a manual uninstall of the 2.x Windows Agent. Users running the 3.14 installer will be prompted during installation to remove the 2.x Agent (if detected). The installer will remove all 2.x binaries and require a reboot and re-run of the 3.14 installer to complete the installation process.
* The 3.18.0 release contained an updated driver to support new features and/or fixes. If you are upgrading from an earlier release or are performing a new installation of 4.6, a reboot is required for proper operation of the Windows Agent. This is not a forced reboot as the user has to approve the reboot by selecting "Yes" or "No" during the installation process.
* The upgrade will change the java heap size to 50% of physical memory if the {{server.conf}} file has been customized with a higher value. Reserving more than 50% of a system's memory for the Java Heap can result in situations where not enough memory is available to the CDP server for non-heap memory or for other applications running on the system. For more information, see [Configuring Service Provider (Enterprise) Edition on Windows].
* Customers upgrading from version 3.10 with Archiving Limits set prior to the upgrade will need to reset archive limits post-upgrade. This can be easily accomplished using the bulk edit feature, which can be accessed via the Policy tab.
* Customers upgrading from version 3.10 or earlier versions may experience a delay when starting the WebUI. Please be patient as important updates are in progress. The log file will display "CDP Started" when all database updates are complete.

To upgrade the Windows CDP Agent Service Provider (Enterprise) Edition to version 4.6, perform the following steps:

1. Log on to the Windows server as a member of the local Administrators group.

2. Navigate to the directory where you saved the CDP installation file. The installer will have the following attributes:

*For a 32-bit system:*
* File name - ServerBackup-Enterprise-Agent-win32-4.6.0.exe
* File size - 30.1 MB

*For a 64-bit system:*
* File name - ServerBackup-Enterprise-Agent-win64-4.6.0.exe
* File size - 52.0 MB
\\
{info:title=Note}The "Service Provider (Enterprise) Edition" installer package is capable of installing/upgrading both Server and Agent software. The "Enterprise Agent" installer package contains only the Agent software and is a much smaller package.
{info}3. Extract the file from the archive. Execute the installer by clicking "Run."
\\

4. In the Welcome window, select a destination folder and click "Install."

!1install_ag_4-2.png!

5. Wait while the files are extracted.

!2install_ag_4-2.png!

6. Click "Install" in the opened window.

!3install_ag_4-2.png!

7. Click "Install CDP Agent."

!4install_ag_4-2.png!

8. The R1Soft CDP Agent Installer will open. Make sure all other applications are closed and click "Next."

!5install_ag_4-2.png!

9. You must agree to the following license agreement. Read it to the end and click "Next" to accept.

!6install_ag_4-2.png!

10. The installer will check your system for possible problems. It is strongly recommended that all tests have a "Pass" status. You can repeat the tests by clicking the "Test" button. Click "Next" to go to the next screen.

!7install_ag_4-2.png!

{info:title=Note}You can find the full list of requirements at [http://www.r1soft.com/windows-cdp/cdp-enterprise-edition/sys-req/].
{info}
{info:title=Note}
If one or several requirements are not met, then an explanation will be displayed in the "Message" column. If this happens, further installation is not recommended on this configuration.

There are three possible values for the "Status" column: "Pass," "Not Recommended," and "Fail."

If possible, correct the configuration and click "Test" again.
{info}

11. On the next screen, verify that there is free space on the drive where the CDP Agent is installed. Click "Next" to continue.
{info:title=Note} During the upgrade, you cannot change the installation directory for the Agent.
{info}

!upgrade1.png!

12. The configuration is complete. Click "Next" to start the upgrade process.

!upgrade2.png!

13. The upgrade process will start.

!upgrade3.png!

14. The upgrade process is complete. Click "Finish."