Who is this article for?
CrashPlan for Enterprise, yes.
Code42 for Enterprise, yes.
CrashPlan for Small Business, no.
This article applies to on-premises authority servers.
This tutorial describes how to upgrade the Code42 apps in your Code42 environment.
- We recommend you test the upgrade thoroughly before you enable automatic upgrades for all user devices.
- Code42 apps upgrade automatically after you enable the upgrade and restart your authority server.
- Devices reconnect to the authority server at a randomized interval of 1 to 15 minutes. If a download attempt is unsuccessful, the device retries after one hour.
- In very large Code42 environments, upgrading thousands of devices simultaneously may temporarily affect Code42 app and Code42 console performance. See Change ports for Code42 app device upgrades for steps to prevent potential problems.
Before you begin
- Code42 app branding updates replace "CrashPlan" with "Code42" in the name of the application, service, and some related file paths. This may require you to take administrative action to ensure compatibility with Code42 app version 8.2.1 and later. See Code42 app version 8.2.0 changes to application and service names for complete details.
- Beginning with version 5.3 of the Code42 platform, the Code42 app is no longer bundled with the Code42 server. You must add the compatible Code42 app versions from the App Downloads screen in the Code42 console.
- Code42 app versions 6.5 and later do not support deployment preferences and customizations defined in pre-6.5 Code42 app custom installers. These settings must be re-created with deployment policies and customization templates in the Code42 console.
- (Optional) If you have limited network bandwidth and a large number of devices to upgrade, you can improve network performance during device upgrades by pre-staging the Code42 app upgrade files on devices before starting the upgrade process.
Code42 apps on Linux typically require that you install the configuration package libgconf-2-4. If that package is missing, Code42's initial install alerts you, but an upgrade simply fails silently. To install the package, type the following in the terminal:
sudo apt-get install libgconf-2-4
After you install libgconf-2-4, your Code42 app should run normally.
Step 1: Upgrade the Code42 apps
- (Code42 server version 5.3 and later) If you haven't already, add the newest Code42 apps to your authority server.
- Test the upgrade for one existing device:
- Sign in to the Code42 console on your authority server.
- In version 6.5 and later, navigate to Administration > Devices > Active. In versions earlier than 6.5, navigate to Devices > Overview.
- Click the name of the device.
- From the action menu in the upper right, select Upgrade.
(The Upgrade option is enabled only if Auto-upgrade devices is deselected in Settings > Server and the device meets the system requirements for the new Code42 app version.)
- Click Upgrade to upgrade the device.
The upgrade command is sent to the device immediately and the device begins the upgrade process. When the upgrade is complete, the Code42 console displays a “success” message in the lower left corner.
- Verify the test Code42 app upgrade:
- Launch the Code42 app on the device and verify the version number.
- Confirm that you are able to back up files from the test device.
- When you are ready to upgrade the rest of your Code42 environment's devices, choose one of the following options for upgrade:
- Auto-upgrade all devices
- Upgrade devices per organization (Version 7.0 and later)
- Sign in to the authority server's Code42 console.
- Choose Organizations > Active.
- Select an organization.
- From the action menu in the upper-right, choose Upgrade Clients.
Clients in that organization are upgraded to the highest version available. Clients in child organizations are not upgraded.
Step 2: Verify the Code42 app upgrade
Export a list of devices in your Code42 environment and sort by version to view Code42 apps that have not upgraded:
- Sign in to the Code42 console.
- In version 6.5 and later, navigate to Administration > Devices > Active. In versions earlier than 6.5, navigate to Devices.
- From the action menu, select Export All.
- Save the CSV file to your computer.
- Open the CSV file in the spreadsheet application of your choice.
- Sort by the displayVersion column and look for any Code42 apps with an old version number.
Resolve a failed Code42 app upgrade
Device cannot download update from the authority server
The most common reason for a failed upgrade is a network issue that prevents the device from downloading an update from the authority server.
Diagnose network connection
Test ports to verify that user devices are able to connect to your authority server. Devices attempt to connect through port 443 or 4287. See Change ports for Code42 app device upgrades for more information on ports.
If the device cannot connect to your master server.
- Verify that your master server's Website protocol, host and port is correctly configured at Settings > Server.
Devices download upgrades from this address.
- Check connectivity and networking settings.
Diagnose with logs
When a device attempts to download .jar files from your authority server as part of the upgrade process, it logs that activity in service.log.0. If necessary, you can review the device's service.log.0 to check the device's communications with the authority server.
- Navigate to the log directory on the device:
- Windows: C:\ProgramData\CrashPlan\log
To view this hidden folder, open a file browser and paste the path in the address bar. If you installed per user, see the file and folder hierarchy.
- Mac: /Library/Logs/CrashPlan
To view this hidden folder, open the Finder, press Command+Shift+G, and paste the path. If you installed per user, see the file and folder hierarchy.
- Linux: /usr/local/crashplan/log
- Windows: C:\ProgramData\CrashPlan\log
- Open service.log.0 in a plain text editor (Notepad, TextEdit, etc.).
- Search for .jar to find the download event. For example:
[11.13.15 08:40:35.560 INFO 7856_DwldMgr .service.upgrade.DownloadManager] DOWNLOAD:: Downloading patch from http://192.168.100.10:4280/installs/mac/upgrade5/1440997200510_261.jar?guid=650355915434815233; DownloadManager[patchDir = upgrade, patchFiles = [1440997200510 (2015-08-31T05:00:00:510+0000)], patchProblem = false]
- Review the log entry:
- If the device successfully downloaded the .jar file, send the device's log files to our Customer Champions for Code42 for Enterprise or CrashPlan for Small Business for review. If the device is not properly applying an upgrade, a serious error may be interfering with the upgrade process.
- If the device failed to download the .jar file:
- Confirm that the location of the authority server listed alongside the log entries for .jar is the correct location of your actual authority server. If it is incorrect, update the authority server's Website protocol, host and port at Settings > Server in the Code42 console.
- Check connectivity and networking settings.
If you cannot wait to diagnose the problem and a small number of devices are affected, the fastest fix is to simply uninstall the Code42 app and install the latest version.
Windows device upgrade fails
A Windows device upgrade can sometimes fail with a 1603 error:
Error 1603: A fatal error occurred during installation
Info 1603: The file <file name> is being held in use by the following process: Name: <process name>
This problem can be caused by the following:
- Short file name creation is disabled on the target machine.
- The Windows temporary folders are full.
- A file is locked and cannot be overwritten.
- The SYSTEM account does not have full control permissions on the folder to which you are trying to install the Windows Installer package.
- The Microsoft Windows Installer Service is not installed correctly.
With this temporary solution, the user can start working with the latest version of the software. However, because this solution does not address the underlying reasons for the failure, upgrade may fail at the next software update and you may need to uninstall the Code42 app and reinstall the latest version again. Therefore, we recommend you implement the following permanent solution.
To fix the most common issues that cause Code42 app upgrade failures on Windows, perform the following steps on the device:
Step 1: Make sure short file name creation is enabled
- Access the command prompt on the target machine and type
- Navigate to the following registry entry:
- Look at the value of NtfsDisable8dot3NameCreation. If the value is 1 or 3, short file name creation is disabled. (The value of 2 sets the 8.3 naming convention creation on a per volume basis.)
- Change the value to 0 to enable short file name creation.
- Reboot the machine before attempting to launch the installation again.
- (Optional) If the target machine should normally have short file name creation disabled, disable it after the install completes by resetting NtfsDisable8dot3NameCreation to 1 and rebooting.
Step 2: Empty all temporary folders
- Access the command prompt and type
- Note the values listed for TEMP and TMP.
- Delete all files in these locations.
Step 3: Make sure no other applications run in the background
Applications running in the background, including utilities such as virus scanners, may interfere with installation.
- Close all running applications and utilities.
- Launch the installation again.
- (Optional) If this error occurs during uninstallation, use the Microsoft Windows Installer CleanUp utility.
Troubleshoot Code42 console performance
As Code42 apps are upgrading, if your authority server's Code42 console is slow or times out when trying to log in:
- Check the authority server system's process monitor to make sure that the Code42 server service is still running.
- Check to see if the Code42 server service is resource constrained. If so:
- Use the operating system's firewall to block inbound connections on the upgrade port. Depending on the version of your Code42 server and Code42 app, that port is 4280 or 4285. See Change ports for Code42 app device upgrades for more information on ports.
- Gradually add IP range exceptions to allow batches of Code42 app devices to connect and upgrade.