Upgrade to version 5.4.5

Overview

This article describes how to upgrade the Code42 servers in your Code42 environment to version 5.4.5, and to perform associated Code42 app upgrades. The steps below apply to upgrades from 5.1.x, 5.2.x, 5.3.x, and 5.4.x.

Affected Code42 platform components

The upgrade from version 5.1.x, 5.2.x, 5.3.x, and 5.4.x to 5.4.5 includes changes to the following components. View Code42 platform version 5.4.5 release notes for details.

Upgraded

• Code42 server
• Code42 app

Version compatibility

Considerations

• If the File Selection setting is locked in the Code42 console (Settings > Device Backup > Backup), you must take action to ensure all Code42 apps are version 4.5.2 or later before upgrading to Code42 server version 5.4.5.
  • Use the Device Status Report to view devices' Code42 app version.
  • If upgrades are required, see Upgrade Devices In Your Code42 environment.
• Beginning with version 5.3.0 of the Code42 platform, the Code42 app is no longer bundled with the Code42 server. Compatible Code42 app versions are available for download from the new App Downloads screen in the Code42 console. See Adding Clients To Your Code42 environment for more details.

• Do not make any configuration changes to Code42 for Enterprise settings in the Code42 console while upgrading your Code42 server. As a best practice, wait 24 hours after pushing any configuration changes to Code42 for Enterprise apps before you upgrade the Code42 server, and wait 24 hours after the server upgrade completes before changing any settings. Contact our Customer Champions for support if you have any questions.

• If you are upgrading from Code42 server version 5.1.x or 5.2.x, you may need to refresh the Code42 console to see the new App Downloads screen after the upgrade completes.
• If you are upgrading from Code42 server version 5.1.x or 5.2.x, you may be prompted to upgrade clients after the upgrade completes. Ignore this prompt; client upgrades are managed from the App Downloads screen beginning in version 5.3.0.
• Frequency and Version retention settings in the Code42 console now use only one set of push and lock buttons for all settings, instead of individual push and lock buttons for each setting. If either the Frequency or Version retention settings are locked, both are locked after upgrading to Code42 server 5.4.5.
• To enable TLS messaging, configure your network to:
  • Allow all Code42 servers to communicate over ports 4287 and 4288
  • Allow all user devices to communicate over port 4287
• Customizations to Code42 console label text and button colors must be re-applied after upgrading to Code42 server version 5.4.5:
  • Label text customizations created in Code42 server version 5.3.x and earlier must be copied from /web/base/console/custom/*.txt to /content-custom/Default-custom/shared/custom/properties.json
  • Button color customizations created in Code42 server version 5.3.x and earlier must be copied from /content-custom/Default-custom/shared/custom/config.css to /content-custom/Default-custom/shared/custom/properties.json

Upgrade instructions

If you have any questions about upgrading your Code42 environment, or if you need assistance troubleshooting the upgrade, contact our Customer Champions for Code42 for Enterprise support.