Skip to main content
Code42 Support

Upgrading Your Single-Server Environment From Version 4.1.5 To Version 4.1.5.1

Applies to:
  • CrashPlan PROe

Overview

This tutorial describes how to upgrade your single-server environment from enterprise server version 4.1.5 to version 4.1.5.1.

Before you begin

  1. Review the general instructions at Upgrade Version 4.1.5 To 4.1.5.1.
  2. Verify that your support is up to date from the administration console Licensing screen.
    Only environments under current support and maintenance are able to upgrade.
  3. Make sure that your host server meets the enterprise server requirements.
  4. (OS X) If your host server is running Java 6, upgrade to Oracle Java Development Kit (JDK) 7.
  5. Test the software upgrade before upgrading your production environment.
  6. Always dump your enterprise server database(s) before attempting to upgrade.
  7. Verify that your devices can connect to your master server on TCP port 4280 to download the device upgrade files.
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.

Download upgrade & installation files

Download the upgrade file for your server platform:

MD5 checksums

In order to prepare a test environment, you will need installation files for the previous version of the enterprise server.

Testing the upgrade

Testing the upgrade requires one test device or VM.

Testing the Enterprise Server

Prepare the Enterprise Server

Create your test environment from your production environment with the following steps:

Test the Enterprise Server upgrade

  1. Install version 4.1.5 of the enterprise server software on the test enterprise server.
  2. Import the database dump created in Step 1 into your test enterprise server.
  3. On your test enterprise server's existing store points, disable Accept New Devices.
  4. Create a new store point on your test enterprise server.
  5. Install SharePlan app version 4.1.4 on a Windows test device.
    Customized installers should not be used for the upgrade test.
  6. Once the SharePlan app installation completes, register the device under a new user account.
    If your environment uses LDAP or SSO to authenticate users, register the user in an org that uses built-in authentication.
  7. Verify that the test device is connected to the test master server.
  8. Sync a small amount of data to the test enterprise server.
  9. From the test enterprise server's administration console, go to Settings > Server > Action Menu > Upgrade to apply the enterprise server upgrade.
  10. Review the End User License Agreement and click I AGREE to proceed with the upgrade.

Verify the test Enterprise Server upgrade

After the upgrade completes:

  1. Clear your browser cache and sign in to the enterprise server's administration console.
    The message Server Upgrade Complete appears.
  2. Click No, I'll Upgrade Later to postpone upgrading all client devices.
  3. Verify the following:
    • Under Settings > Server, the current version number is 4.1.5.1.
    • You are able to view the details of an org, a user, and a device. You can also do spot checks of various configuration screens if you'd like, but verifying one org, user, and device provides good coverage.
    • Your test device is connected to the test enterprise server.
    • You are able to sync data for the test device.

Testing a device

Prepare the device

  1. Confirm that SharePlan app version 4.1.4 is installed on your Windows test device.
  2. Ensure that your test device has network access to the test enterprise server, which you have already isolated for testing purposes.

Test the device upgrade

Once you've verified the enterprise server upgrade, initiate the SharePlan app upgrade for your test device:

  1. In the administration console, go to Devices > Overview, then click the name of the test device.
  2. From the action menu, select Upgrade.
  3. Click Upgrade to upgrade your test device.

The upgrade command is sent to the device immediately and the device begins the upgrade process.

Verify the test device upgrade

After the upgrade completes, verify the following:

  • The administration console displays a “success” message in the lower-left corner.
  • Launch the SharePlan app and verify the version number.
  • You are able to sync files from the test device.

Next steps

If the test in your upgrade environment passes all verification steps, then proceed with upgrading your production environment.

If any verification steps fail during the upgrade test, stop all upgrade operations. Gather the following information and send it to our Customer Champions:

  • Archive of enterprise server log files, including the upgrade log
  • Archive of device log files
  • Copy of the database dump created during the test process

Performing the upgrade

Prepare your production environment

  1. Review the Licensing screen to verify that your support license is current.
  2. Dump your enterprise server's database from Settings > Server > Action Menu > Dump Database.
  3. Test the upgrade as described above.
  4. In Settings > Server, disable Auto-upgrade devices.
    See Best Practices For Upgrading Your Devices for more details.

Upgrade your Enterprise Server

  1. Apply the enterprise server upgrade from Settings > Server > Action Menu > Upgrade.
  2. Review the End User License Agreement and click I AGREE to proceed with the upgrade.
    The enterprise server restarts after successfully upgrading.
  3. After the enterprise server restarts, clear your browser cache and sign in to the console.
    The message Server Upgrade Complete appears.
  4. Click No, I'll Upgrade Later to postpone upgrading all client devices.
  5. Verify the following:
    • Under Settings > Server, the current version number is 4.1.5.1.
    • You are able to view the details of an org, a user and a device. You can also do spot checks of various configuration screens if you'd like, but verifying an org, user and device's details provides good coverage.
    • Your devices are able to reconnect to the enterprise server.
    • You are able to sync and share files from your devices.

Upgrade your devices

  1. Once you've verified the enterprise server upgrade, initiate the SharePlan app upgrade for one existing Windows device:
    1. In the administration console, go to Devices > Overview, then click the name of the device.
    2. From the action menu, select Upgrade.
    3. Click Upgrade to upgrade the device.
      The upgrade command is sent to the device immediately and the device begins the upgrade process.
  2. Verify the test device upgrade:
    • The administration console displays a “success” message in the lower left corner.
    • Launch the SharePlan app and verify the version number.
    • You are able to sync files from the test device.
  3. When you are ready to upgrade the rest of your Code42 environment's Windows SharePlan app devices:
    1. Sign in to the master server's administration console
    2. From Settings > Server, enable Auto-upgrade devices
      This setting takes effect when you restart the enterprise server.
    3. Click Upgrade All Devices in the banner at the top of the administration console to upgrade devices that are currently connected.

Troubleshooting the upgrade

For information on resolving upgrade issues, read the full article at Troubleshooting The Upgrade From Version 4.1.5 To Version 4.1.5.1.