Skip to main content
Code42 Support

Upgrading Your Multi-Server Environment To Version 4.1.3

Applies to:

    Overview

    This tutorial describes how to upgrade your multi-server environment from enterprise server version 4.1.2 to version 4.1.3.

    Before you begin

    1. Review the general instructions at Upgrade Version 4.1.2 To 4.1.3.
    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. Test the software upgrade before upgrading your production environment.
    4. Always dump your enterprise server database(s) before attempting to upgrade.
    5. Verify that your devices can connect to your master server on TCP 4280 to download the SharePlan app upgrade files.
    Managed Private Cloud customers: PRO Services works with you to upgrade your environment. If you have any managed appliances, do not attempt to upgrade your Code42 environment on your own.

    Upgrade & installation files

    Test the upgrade

    The upgrade test requires two test servers or VMs, two test SharePlan app 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:

    1. Write down the current primary and secondary network addresses from the production enterprise server's administration console.
    2. On your production enterprise server, dump the database.
    3. Disconnect your test enterprise server from your production network.
      This is to prevent your test enterprise server from interacting with devices or sending alert emails to users or administrators.
    4. If the primary network address of the production enterprise server is an IP address, then you must set the IP address of the test machine to the same value. It is therefore critical that you completely disconnect the test machine from your production network, as suggested above, to prevent the test machine from interacting with any SharePlan apps or storage servers.
    5. If the primary network address is a hostname rather than an IP address, you must edit the hosts file on your test machine so that the hostname entered as the primary network address in the administration console points to the IP address of the test machine:
      • An example entry might read :
        • myserver.example.com 192.0.2.101
      • As an alternative, you may change the IP address of the test machine to be identical to the IP address of the production enterprise server. As already stated, it is important to isolate the test machine from your production network, to prevent the test machine from interacting with SharePlan apps and storage servers.

    Prepare the test Enterprise Servers and SharePlan App devices

    1. Install enterprise server version version 4.1.2 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. Change the primary and secondary network addresses of your test storage server to work on the private network.
    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 SharePlan app version 4.1.2 on one of the test clients.
      Customized SharePlan app installers should not be used for the upgrade test.
    7. 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 organization that uses built-in authentication.
    8. Verify that the test device is connected to the test master server.
    9. Add a file to SharePlan and verify that it is synced to the test enterprise server.
    10. Download the appropriate upgrade file for your master server.

    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

    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's 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, 4.1.3.
    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, clear your browser cache and sign in to the master server's administration console to verify the upgrade test. Verify the following:

    • You are able to sign in to the test master server's administration console.
    • Under Settings > Server, the enterprise server's current version number is 4.1.3.
    • 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.

    Testing a SharePlan App device

    Prepare the device

    1. Confirm that SharePlan app version 4.1.2 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 SharePlan app upgrade for your test device:

    1. Navigate to the test device's Device Details pane.
    2. From the action menu, select Upgrade.
    3. Confirm that you are ready 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 confirm that your version number is 4.1.3.
    • You are able to sync and share files from the test SharePlan 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. Please send the following information to our Customer Champions for assistance:

    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. Download the upgrade file(s) for your enterprise server operating system(s).
    4. Test the upgrade as described above.
    Automatic Storage Server upgrades
    The automatic storage server upgrade occurs only for storage servers on the same operating system as the master 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 master server.

    Operating System Location
    Windows C:\Program Files\CrashPlan\upgrade
    OS X /Applications/PROServer.app/Content/Resources/Java/upgrade
    Linux (installed as root) /opt/proserver/upgrade
    Linux (installed as user) /home/userName/proserver/server/upgrade

    Upgrade your 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. Verify the following:
      • You are able to sign in to the master server's administration console.
      • Under Settings > Server, the current version number is 4.1.3.
      • 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 SharePlan app devices are able to reconnect.
      • You are able to sync and share files from a SharePlan app device.

    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's 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, 4.1.3.
    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 4.1.3.
      • Your SharePlan app devices are able to reconnect.
      • You are able to sync and share files from a SharePlan app device.

    Upgrade your devices

    1. Once you've verified the enterprise server upgrade, initiate the SharePlan app upgrade for one existing device:
      1. Navigate to the test device's details.
      2. From the action menu, select Upgrade.
      3. Confirm that you are ready to upgrade your test device.
        The upgrade command is sent to the device immediately and the device begins the upgrade process.
    2. Verify the SharePlan app test device upgrade:
      • The administration console displays a “success” message in the lower left corner.
      • Launch the SharePlan app and go to Settings > Account to verify that the version number is 4.1.2.
      • You are able to sync and share files from the test device.
    3. When you are ready to upgrade the rest of your Code42 environment's SharePlan app devices:
      1. Sign in to the master server's administration console
      2. From Settings > Server, enable Auto-upgrade devices, which was disabled before beginning the enterprise server upgrade.
        All devices will begin upgrading. See Best Practices For Upgrading Your Devices for more details.

    Troubleshooting the upgrade

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