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.

Sample recommendations

Backup Selection SizeRecommended Memory Allocation (MB)
Up to 1 TB or up to 1 million files1024 (default)
1.5 TB or 1.5 million files1536
2 TB or 2 million files2048
2.5 TB or 2.5 million files2560
3 TB or 3 million files3072
4 TB or 4 million files4096

Memory limitations

You should not allocate more memory to the Code42 app than the maximum supported by your device. For example, if your device has 8 GB of RAM, you shouldn’t allocate more than 8 GB (8192 MB) to the Code42 app.

Windows 32-bit operating systems
On devices running a 32-bit Windows operating system, programs are limited to a maximum of 2 GB of RAM. After accounting for other resources required by your system, this limits the Code42 app's maximum memory allocation to approximately 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 Administration console
Administrators can execute this command from the administration 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 the following command, using a value appropriate for the size of your backup selection (for example, 1536 for a 1.5 TB selection):
    java mx 1536, restart
    The Code42 app closes.
  5. Open the Code42 app and sign in.

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 administration 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.