Skip to main content
Code42 Support

Upgrading Your Multi-Server Environment From Version 3.6.3.1 To Version 3.6.4.1

Applies to:
  • CrashPlan PROe

Overview

This tutorial describes how to upgrade your multi-server environment from enterprise server version 3.6.3.1 to version 3.6.4.1.

For single-server environments, see Upgrading Your Single-Server Environment From Version 3.6.3.1 To Version 3.6.4.1.

Before you begin

  1. Review the general instructions at Upgrade Version 3.6.3.1 To 3.6.4.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 servers meet the enterprise server requirements.
  4. (OS X Yosemite v10.10) If a 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 authority 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. If your Code42 environment has enterprise servers running on different operating systems, download the upgrade file for each operating system:

MD5 checksums

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

Test the upgrade

The upgrade test requires two test servers or VMs, two test devices, and a fully closed, private network.

Test the Enterprise Servers

Set up the test Enterprise Servers

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

Prepare the test Enterprise Servers and devices

  1. Install enterprise server version 3.6.3.1 on two test servers.
  2. Import the database dump created in Step 1 into your test master server.
  3. On your test master server:
    1. Change the Primary and Secondary network addresses of your master server to work on the private network.
    2. On existing store points, disable Accept New Devices.
    3. Create a new store point on your test master server.
    4. In Settings > Server, disable Auto-upgrade devices.
      See Best Practices For Upgrading Your Devices for more details.
  4. On the second test server, import the database for your storage server.
  5. Verify that the test enterprise servers are able to communicate. From the master server's administration console, go to Destinations > Servers.
    The test storage server's status should be "online".
  6. Install CrashPlan app version 3.6.3 on a test device.
    Customized installers should not be used for the upgrade test.
  7. Once the CrashPlan app installation completes, register the device under a new user account.
  8. If your environment uses LDAP or SSO to authenticate users, register the user in an organization that uses built-in authentication.
  9. Verify that the test device is connected to the test master server.
  10. Back up a small amount of data to the test enterprise server.

Choose a Storage Server upgrade method

The storage servers in your Code42 environment can be upgraded automatically or manually. When Auto-upgrade storage servers is enabled in the authority server administration console, storage servers are automatically upgraded after the authority server is upgraded.

  • We recommend using the automatic storage server upgrade method to save time and reduce the possibility for human error.
  • If you want to tightly control when individual storage servers are upgraded to manage down time, do not use the automatic upgrade method.
Automatic upgrades for mixed operating system environments
The automatic storage server upgrade occurs only for storage servers on the same operating system as the authority server. In mixed operating system server environments, you must place the upgrade file(s) for any other storage server operating systems into the appropriate directory on your authority server.
  1. Sign in to the administration console on your authority server.
  2. Go to Settings > Server.
  3. Enable or disable Auto-upgrade storage servers, then click Save.
  4. If you enabled Auto-upgrade storage servers and one or more of your storage servers are running on an operating system that differs from your authority server, place the upgrade file(s) for each operating system in the appropriate directory on the authority server:
    • Linux: /opt/proserver/upgrade
      Applies to Code42 servers installed as root on Ubuntu
    • Windows: C:\Program Files\CrashPlan PROe Server\upgrade
    • OS X: /Applications/PROServer.app/Content/Resources/Java/upgrade

Upgrade the test Master Server

  1. Sign in to the administration console on your master server.
  2. Apply the enterprise server upgrade from Settings > Server > Action Menu > Upgrade.
  3. Review the End User License Agreement and click I AGREE to proceed with the upgrade.
    The enterprise server restarts after successfully upgrading.

Upgrade the test Storage Server

Automatic Storage Server upgrades
If you have enabled automatic storage server upgrades, your storage servers will update automatically. The process below is necessary only if you have disabled automatic server upgrades.
  1. Sign in to the administration console on your storage server.
  2. Apply the enterprise server upgrade from Settings > Server > Action Menu > Upgrade.
  3. Review the End User License Agreement and click I AGREE to proceed with the upgrade.
    The enterprise server restarts after successfully upgrading.
  4. After the server restart completes, clear your browser cache and sign in to the console.
  5. Double-click the Code42 logo in the upper left to access the administration console command-line interface.
  6. Enter this command to confirm the upgrade was successful:
    version
    The administration console returns the current version number, 3.6.4.1.
  7. Enter this command to sync your storage server with your master server:
    node.sync
  8. Wait for the node.sync command to complete (roughly 1 hour).
    1. Check the progress of node.sync by viewing logs (com.backup42.app.log) in one of two ways:
    2. Watch the log for text including SYNCHRONIZE:: Sync complete.
      Example:
      [06.13.14 10:54:22.018 INFO BWQ-NodeSyncService: com.code42.server.sync.NodeSyncEndCmd ] SYNCHRONIZE:: Sync complete at 2014-06-13T10:54:22:000
      
  9. Enter this command to restart your storage server after the node sync command has completed:
    node.restart
    The storage server restarts.

Verify the test Enterprise Server upgrade

After the upgrade completes:

  1. Clear your browser cache and sign in to the master 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 enterprise server's current version number is 3.6.4.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, a user, and a device provides good coverage.
    • The test storage server is online and connected to the test master server.
    • The test device is connected to the test master server.
    • You are able to back up files from the test device.

Testing a device

Prepare the device

  1. Confirm that CrashPlan app version 3.6.3 is installed on your 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 CrashPlan 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 CrashPlan app and verify the version number.
  • You are able to back up and restore files from the test CrashPlan app.

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

Perform the upgrade

Prepare your production environment

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

Choose a Storage Server upgrade method

The storage servers in your Code42 environment can be upgraded automatically or manually. When Auto-upgrade storage servers is enabled in the authority server administration console, storage servers are automatically upgraded after the authority server is upgraded.

  • We recommend using the automatic storage server upgrade method to save time and reduce the possibility for human error.
  • If you want to tightly control when individual storage servers are upgraded to manage down time, do not use the automatic upgrade method.
Automatic upgrades for mixed operating system environments
The automatic storage server upgrade occurs only for storage servers on the same operating system as the authority server. In mixed operating system server environments, you must place the upgrade file(s) for any other storage server operating systems into the appropriate directory on your authority server.
  1. Sign in to the administration console on your authority server.
  2. Go to Settings > Server.
  3. Enable or disable Auto-upgrade storage servers, then click Save.
  4. If you enabled Auto-upgrade storage servers and one or more of your storage servers are running on an operating system that differs from your authority server, place the upgrade file(s) for each operating system in the appropriate directory on the authority server:
    • Linux: /opt/proserver/upgrade
      Applies to Code42 servers installed as root on Ubuntu
    • Windows: C:\Program Files\CrashPlan PROe Server\upgrade
    • OS X: /Applications/PROServer.app/Content/Resources/Java/upgrade

Upgrade your Enterprise Servers

Master Server

  1. Sign in to the administration console on your master server.
  2. Apply the enterprise server upgrade from Settings > Server > Action Menu > Upgrade.
  3. Review the End User License Agreement and click I AGREE to proceed with the upgrade.
    The enterprise server restarts after successfully upgrading.
  4. After the enterprise server restarts, clear your browser cache and sign in to the console.
    The message Server Upgrade Complete appears.
  5. Click No, I'll Upgrade Later to postpone upgrading all client devices.
  6. Verify the following:
    • Under Settings > Server, the current version number is 3.6.4.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.
    • You are able to back up and restore files from your devices.

Storage Servers

Automatic Storage Server upgrades
If you have enabled automatic storage server upgrades, your storage servers will update automatically. The process below is necessary only if you have disabled automatic server upgrades.
  1. Sign in to the administration console on your storage server.
  2. Apply the enterprise server upgrade from Settings > Server > Action Menu > Upgrade.
  3. Review the End User License Agreement and click I AGREE to proceed with the upgrade.
    The enterprise server restarts after successfully upgrading.
  4. After the server restart completes, clear your browser cache and sign in to the administration console.
  5. Double-click the Code42 logo in the upper left to access the administration console command-line interface.
  6. Enter this command to confirm the upgrade was successful:
    version
    The administration console returns the current version number, 3.6.4.1.
  7. Enter this command to sync your storage server with your master server:
    node.sync
  8. Wait for the node.sync command to complete (roughly 1 hour).
    1. Check the progress of node.sync by viewing logs (com.backup42.app.log) in one of two ways:
    2. Watch the log for text including SYNCHRONIZE:: Sync complete
      Example:
      [06.13.14 10:54:22.018 INFO BWQ-NodeSyncService: com.code42.server.sync.NodeSyncEndCmd ] SYNCHRONIZE:: Sync complete at 2014-06-13T10:54:22:000
      
  9. Enter this command to restart your storage server after the node sync command has completed:
    node.restart
    The storage server restarts.
  10. Verify the following:
    • You are able to sign in to the storage server's administration console.
    • Under Settings > Server, the current server version is 3.6.4.1.
    • Your devices are able to reconnect.
    • You are able to back up and restore files from your devices.

Upgrade your devices

  1. Once you've verified the enterprise server upgrade, initiate the CrashPlan app upgrade for one existing device:
    1. In the master server's 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 CrashPlan app and verify the version number.
    • You are able to back up files from the test device.
  3. When you are ready to upgrade the rest of your Code42 environment's CrashPlan 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 3.6.3.1 To Version 3.6.4.1.