Skip to main content
Code42 Support

Upgrading Version 3.6.5.1 To 4.2.3.1

Applies to:
  • CrashPlan PROe

Overview

This article describes how to upgrade the enterprise servers in your Code42 environment from version 3.6.5.1 to version 4.2.3.1, and to perform associated CrashPlan app upgrades.

Managed Appliance Upgrades
If your master server is a Code42 managed appliance, our Customer Champions work with you to upgrade your Code42 environment. Do not attempt to upgrade your environment on your own.

Affected Code42 Platform Components

The upgrade from version 3.6.5.1 to 4.2.3.1 includes changes to the following components. View Code42 Platform Version 4.2.3.1 Release Notes (From 3.6.5.1) for details.

Upgraded Not Upgraded
  • Enterprise server
  • CrashPlan app
  • CrashPlan mobile app
None—all components are upgraded.

Version Compatibility

Code42 platform version 4.2.3.1 is compatible with the following components.

Component Compatible Versions
Code42 server 4.2.3.1*
CrashPlan app

All operating systems:

  • 4.2.0*
  • 3.7
  • 3.6.4
CrashPlan mobile app
  • Android:
    • 4.2.1
    • 4.2.0
    • 3.5.4
  • iOS:
    • 4.2.0
    • 3.5.5
SharePlan app
  • Windows:
    • 4.2.0*
    • 4.1.6
  • OS X:
    • 4.2.0*
    • 4.1.6
SharePlan mobile app
  • Android:
    • 4.2.1
    • 4.2.0*
    • 4.1.6
  • iOS:
    • 4.2.0*
    • 4.1.6

* Indicates this version is bundled with Code42 platform version 4.2.3.1

Considerations For Upgrading To Version 4.2.3.1

Cannot Revert Upgrade To Version 4.2.x

Version 4.2.0 introduced changes to the Code42 platform that have implications for the upgrade process.

Reverting Or Recovering From This Upgrade
After upgrading to version 4.2.3.1, you cannot revert or "roll back" your Code42 environment to a previous version.

Make Sure All Store Points Are Online

Version 4.2.0 introduced changes to data storage in your Code42 environment. To ensure that these changes are made during the upgrade, all store points must be connected before you upgrade to version 4.2.3.1. If all store points are not connected before you upgrade, the enterprise server will not start after the upgrade, and you must contact our Customer Champions​ to proceed.

Connect All Store Points
Before upgrading, all store points in your Code42 environment must be online and visible to the Code42 server on which they reside. If any store points are not connected, the Code42 server will not start after the upgrade, and you must contact our Customer Champions​ for Code42 for Enterprise support or CrashPlan PRO support to proceed.

Disable LDAP Sync

Known Issue In Version 4.2.3
Version 4.2.3 of the Code42 platform is affected by a known issue related to LDAP sync. In certain circumstances, this issue can cause data loss.

We recommend that you:

  1. Disable LDAP sync before upgrading to version 4.2.3.
  2. Enable LDAP sync only after upgrading to version 4.3.4 or later.

Minimum Oracle Java Version

Enterprise server version 4.2.3.1 requires Oracle Java 7 or later to run. Depending on your host server operating system, you may need to update Oracle Java on your enterprise servers (as described in the upgrade instructions below) before upgrading to version 4.2.3.1.

Change For Custom Roles

After version 4.1.6, the ability to restore data from the CrashPlan app has been moved to a user permission, cpd.restore. As part of the upgrade process, your custom roles will be updated to reflect this change. Specifically, all custom roles that contain the permission cpd.login will also have the new permission cpd.restore.

For more information on custom roles, see Best Practices For Custom Roles & Permissions.

No Upgrade For OS X CrashPlan Apps

Due to a known issue, upgrade resources for OS X CrashPlan apps are not included. To upgrade your OS X devices, continue upgrading your Code42 environment to version 5.1.2.

Back Up The Syslog Configuration

Enterprise servers configured to use syslog only

If your enterprise server is configured to send logs to a syslog server, make a backup copy of the conf_base.groovy file, which contains the syslog settings. You will use this file to reconfigure syslog after the upgrade is complete. 

The location of conf_base.groovy varies based on the operating system:

  • Linux: /var/opt/proserver/conf
    ​Applies to Code42 servers installed as root on Ubuntu
  • Windows: C:\ProgramData\PROServer\conf
  • OS X: /Library/Application Support/CrashPlan/PROServer/conf

After the upgrade is complete, place the conf_base.groovy file back in its original location.

Upgrading Linux Enterprise Servers

If you upgrade a Linux enterprise server that does not have the unzip utility, the upgrade process will log several failed attempts to run unzip. However, the upgrade process will complete successfully using a Java unzip utility instead, so the log entries are not a cause for concern.

Upgrade Instructions

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

Step 1: Confirm The Java Version Of Your Enterprise Servers

For each enterprise server in your environment:

  1. Confirm that the installed Java version is Java 7.
    If your enterprise servers use an earlier version of Java, the upgrade fails. We recommend using the latest release within Java 7.
  2. If the installed version of Java is earlier than Java 7, upgrade your enterprise server to Java 7.

Step 2: Download The Upgrade File

Download the upgrade file for your server operating system. If your Code42 environment has enterprise servers running on different operating systems, download the upgrade file for each operating system:

MD5 checksums

Step 2: Upgrade Your Enterprise Servers

Follow our instructions to upgrade the enterprise servers in your Code42 environment:

Step 3: Upgrade Your CrashPlan Devices

Follow our instructions to upgrade CrashPlan devices in your Code42 environment.

Step 4: Continue Upgrading To A Later Version

Version 4.2.3.1 is affected by several issues that are resolved in later versions. Code42 strongly recommends that you continue upgrading to version 5.1.2.