Skip to main content
Contact Support

Who is this article for?

Code42 for EnterpriseSee product plans and features
CrashPlan for Small Business 

CrashPlan for Small Business, yes.

Code42 for Enterprise, yes.

Link: Product plans and features.

This article applies to app versions 6, 7, and 8.

Other available versions:

Version 5 | Version 4Link: What version am I on?

Code42 Support

Adjust Code42 app settings for memory usage with large backups

  1. Last updated
  2. Save as PDF

Who is this article for?

Code42 for EnterpriseSee product plans and features
CrashPlan for Small Business 

CrashPlan for Small Business, yes.

Code42 for Enterprise, yes.

Link: Product plans and features.

This article applies to app versions 6, 7, and 8.

Other available versions:

Version 5 | Version 4Link: What version am I on?

Overview

The amount of available memory needed to use the Code42 app increases with the size of your archive or backup file selection. If your Code42 app crashes frequently, you may benefit from increasing the available memory (or adjusting backup settings to require less memory) if the following conditions apply:

  • Your Mac or Linux device's backup selection exceeds 1 TB of storage or 1 million files.
  • Your Windows device's backup selection exceeds 4 TB of storage or 4 million files.

Considerations

This article assumes you have the ability to edit your backup settings. Your administrator may prevent editing of these settings.

Additional memory considerations:

  • The Code42 app uses memory up to the maximum allotted. The maximum is used only if it is needed.
  • We recommend allocating 1 GB (1024 MB) of memory per 1 TB of storage (or per 1 million files). The Code42 app only needs about 600 MB of memory per 1 TB of storage (or per 1 million files), but our recommendation is intended to account for growth in your file selection.
  • In Code42 app version 7.0 and later, memory allocation is dynamically set to use 25% of the physical memory on the device. In Code42 app version 6.x, the default memory allocation is 1024 MB.

Sample recommendations

Backup Selection Size Recommended Memory Allocation (MB)
Up to 1 TB or up to 1 million files 1024
1.5 TB or 1.5 million files 1536
2 TB or 2 million files 2048
2.5 TB or 2.5 million files 2560
3 TB or 3 million files 3072
4 TB or 4 million files 4096

Memory limitations

Do not allocate more memory to the Code42 app than exists in your device. For example, if your device has 8 GB of RAM, make sure to allocate less than 8 GB (8192 MB) to the Code42 app to allow for other required processes on your device.

Windows 32-bit operating systems
Due to limited resources on devices running 32-bit Windows operating systems, we recommend a maximum memory allocation for the Code42 app of 1200-1500 MB.

Recommended solution

You can increase the amount of memory available to the Code42 app using command-line interface (CLI) commands. 

You shouldn't need to increase memory unless you are experiencing frequent crashes of the Code42 app and your backup files exceed 1 TB of storage or 1 million files on Mac or Linux or exceed 4 TB of storage or 4 million files on Windows. If you have questions about whether adjusting memory may help resolve crashes of the Code42 app, contact our Customer Champions.

If you are able to open and sign into the Code42 app, you can use the command-line interface (CLI) to allocate more memory.

Sending commands from the Code42 console
Administrators can execute this command from the Code42 console.

Steps

  1. Open the Code42 app.
  2. If necessary, sign in to your account.
  3. Use the keyboard shortcut for your operating system:
    • Windows: Ctrl+Shift+C
    • Mac: Option+Command+C
    • Linux: Ctrl+Shift+C
      The command-line area opens.
  4. Enter one of these commands (depending on the version of your Code42 app). Use a value appropriate for the size of your backup selection (for example, 1536 for a 1.5 TB selection):
    • For versions 6.7.2 and later: java mx 1536
    • For versions 6.7.1 and earlier: java mx 1536, restart 

The Code42 app closes.

  1. Open the Code42 app and sign in.
In Code42 app version 7.0 and later, memory allocation is dynamically set to use 25% of the physical memory on the device. To set the default value, use the command java mx clear.

Video

Watch the brief video below for instructions on increasing the amount of memory available to the Code42 app. 

Although this video demonstrates how to increase memory allocation using CrashPlan for Small Business, the same process applies to Code42 for Enterprise. 

Alternative solution

The Code42 app only uses the maximum memory allotted if it is needed. However, if the maximum memory supported by your device does not accommodate the size of your backup file selection, there are several alternative ways to reduce memory usage.

Remove system and application files from your backup selection

The Code42 app is designed to back up user files (photos, documents, etc.). It is not designed to back up your operating system or application files. When system and application files are included in your backup file selection, the Code42 app uses more resources, like memory, backing up these files. Review our guidelines for choosing what to back up for more information.

Reduce backup frequency

The Code42 app monitors changes to files in real time based on your backup frequency and versions settings. More frequent backups or large numbers of files require the Code42 app to use more system resources to process your backup. You can reduce the frequency of the New Versions scan to conserve memory.

Reduce CPU allocated to the Code42 app

You can control the amount of CPU processing time the Code42 app is allowed to use both when you are present (working on your device) and away. Most modern devices can support allowing the Code42 app to use a high percentage of CPU time without experiencing any performance issues, but you may want to adjust these settings for older devices. You can adjust these settings from the Code42 app.

CPU settings apply to the amount of CPU processing time dedicated to Code42 app work, not to total CPU processing capacity. Therefore, while % CPU may be set at 20, for example, a system monitor may show that 70% of CPU capacity is used for the Code42 app at a particular point in time. For more information, see Configure CPU usage for backup in the Code42 console.

  1. Sign in to the Code42 app.
  2. Navigate to Device Preferences:
  • Code42 app version 6.8.3 and later: Select settings button Settings.
  • Code42 app version 6.8.2 and earlier: 
    1. Click Details.
    2. Select the arrow next to your device name.
    3. Choose Device preferences.
      device preferences
  1. Click Usage.
  2. Reduce the percent of time CPU is allowed to use when the user is both away and present.

Schedule backup

Finally, if you are still experiencing performance issues related to memory, you can configure the Code42 app to back up only at specified times. However, be careful to set a schedule that allows the Code42 app to run while your device is on and not in standby mode. You can adjust your backup schedule from the Code42 app.

  1. Sign in to the Code42 app.
  2. Navigate to Backup Set Settings.
  • Code42 app version 6.8.3 and later:
    1. Select Settings gear icon.
    2. Select Backup Sets.
  • Code42 app version 6.8.2 and earlier:
    1. Select Details.
    2. Select the action menu.
  1. Next to Backup Schedule, click Change.
  2. Select Only run between specified times.
  3. Select the days and hours when the Code42 app is allowed to back up.
  4. Click Save.

Reduce your file selection

If you experience issues related to the Code42 app's memory usage after adjusting the settings described above, you may need to remove files from your selection to reduce the amount of memory needed to run the Code42 app.

Removing files
Deselecting files from your backup file selection permanently deletes them from your backup archive. You cannot download files that have been removed from your backup file selection.
  1. Back to top
  • Was this article helpful?

Recommended articles

  1. There are no recommended articles.
  1. Article type
    Topic
    Available in Code42 for Enterprise
    Yes
    Available in Code42 CrashPlan Premium
    Yes
    Available in Code42 CrashPlan Standard
    Yes
    Available in CrashPlan for Small Business
    Yes
    Stage
    Final
  2. Tags
    1. Java
    2. large file selection
    3. memory