Upgrade your multi-server Code42 environment

Overview

This tutorial describes how to upgrade your multi-server Code42 environment to a new Code42 server version.

For single-server environments, see Upgrade your multi-server Code42 environment.

Considerations

Before you begin

Step 1: Prepare your Code42 environment

Before you upgrade, dump the database as a fallback in case of an upgrade problem, and disable the Auto-upgrade devices setting as a precaution to prevent devices from upgrading unintentionally. Follow the steps for your database type:

• H2 database: This is the default database that's built into the authority server. 
• PostgreSQL database: Use this set of steps if your authority server has been configured to use an external PostgreSQL database.

Step 2: 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 on the authority server, storage servers are automatically upgraded after the authority server is upgraded.

Enable or disable automatic storage server upgrades:

1. Sign in to the Code42 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 a different operating system than your authority server, place the upgrade file(s) for each host server's 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

Step 3: Upgrade your authority server

1. Sign in to the Code42 console of your authority server.
2. Navigate to Settings > Server.
3. From the action menu, select Upgrade.
4. Locate and select the upgrade file.
5. Review the End User License Agreement and click I AGREE to proceed with the upgrade.
   The authority server restarts after successfully upgrading.
6. Clear your browser cache to ensure that you access the new version of the Code42 console the next time you connect.
7. After the authority server restarts, sign in to the Code42 console.
   The message Server Upgrade Complete appears.
8. When prompted, click No, I'll Upgrade Later to postpone upgrading all client devices.
9. Verify the following:
   • Under Settings > Server, the Current server version displays the new Code42 server version.
   • You are able to view the details of any organization, any user, and any device.
   • User devices are able to reconnect, back up, and restore.

Step 4: Upgrade your storage servers

Manual storage server upgrades only; skip this step if you enabled automatic storage server upgrades.

For each storage server in your Code42 environment:

1. Sign in to the Code42 console on your storage server.
2. Navigate to Settings > Server.
3. From the action menu, select Upgrade.
4. Locate and upload the upgrade file.
5. Review the End User License Agreement and click I AGREE to proceed with the upgrade.
   The storage server restarts after successfully upgrading.
6. Clear your browser cache to ensure that you access the new version of the Code42 console the next time you connect.
7. After the storage server restarts, sign in to the Code42 console.
8. Double-click the Code42 logo in the upper left to access the Code42 console command-line interface.
9. Enter this command to confirm the upgrade was successful:

   version

   The Code42 console returns the current version number, which should match the new Code42 server version.
10. Enter this command to sync your storage server with your authority server:

    node.sync
    

11. 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:
       • View logs in the Code42 console at Settings> Server > System Logs.
       • View logs on your Code42 server using a command line utility, such as tail:
         
         • Linux: /var/log/proserver
           Applies to Code42 servers installed as root on Ubuntu
         • Windows: C:\Program Files\CrashPlan PROe Server\logs
    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
       

12. After the node.sync command is complete, enter this command from the Code42 console command-line interface to restart your storage server:

    node.restart

    The storage server restarts.
13. Verify the following:
    • You are able to sign in to the storage server's Code42 console.
    • Under Settings > Server, the Current server version displays the new Code42 server version.
    • User devices are able to reconnect, back up, and restore.

Next steps

Troubleshooting the upgrade

Error processing upgrade: INVALID_FILE - Unable to read properties,
file=/Applications/PROServer.app/Contents/Resources/Java/upgrade/1386428616401/upgrade.properties

Related topics

• Set up a multi-server test environment
• Set up a multi-server test environment
• Upgrade your multi-server Code42 environment
• Best practices for upgrading devices (Code42 server version 5.2.x and earlier)
• Change ports for Code42 app device upgrades