Skip to main content
Code42 Support

Increase server workload capacity

Applies to:
  • Code42 CrashPlan (previously CrashPlan PROe)

Overview

If you have a Code42 deployment with a large number of devices, Code42 server performance can lag when performing basic tasks such as backup, archive maintenance, and web restores. As a Code42 administrator, you can increase your Code42 server's workload handling capacity by setting "worker" property values. The workers manage different tasks on the Code42 server, and by changing the settings for the worker properties, you enable the Code42 server to handle more work in a shorter amount of time. 

Affects

On-premises Code42 servers with more than 500 devices per store point.

Considerations

To further tune Code42 server performance, we recommend that you increase Java heap space.

Verify system resources before proceeding
The Code42 server must have 8 or more cores and 16 GB or more of memory. If the system does not have these resources, then increasing worker property values can bring down the server. If you are unsure about the Code42 server's ability to handle the increased workload, change the values to half the desired count and monitor the system before deciding to change values to the full count.

Properties

Following are worker properties with suggested values.

Properties Default value Suggested value Description

b42.cpc.archiveMaintenanceManager.numWorkers 

1 10

Handles archive maintenance work. You should increase this value if there is a long maintenance queue. Each worker handles one user job and one system job per store point. So, if you have two store points and set this property to 10 workers, you can have up to 20 user jobs and 20 system jobs running at once. 

b42.cpc.inboundWorkers

10 25

Handles messaging, including messages related to sending backup work to the archives.

b42.cpc.numBackupWorkers 8 12

Handles backup jobs. 

b42.cpc.numReplaceWorkers

6 50 Handles cache syncs between the Code42 server and the CrashPlan app. If there are issues with slow file verification scans, setting this value higher allows more scans to run at once.
b42.cpc.numSecurityWorkers 2 25 Handles the security messaging exchange. Setting this value higher allows more logins to be handled at once.
b42.cpc.numWebRestoreWorkers 8 12 Handles processing for web restores. Setting the value higher allows more web restores to run at once.
b42.cpc.outbound.enqueue.timeout.seconds 180 60 Handles the timeout (in seconds) before shutting off a connection because an outbound message cannot complete. Setting the timeout value lower allows for more message attempts in a shorter amount of time.  
b42.ldap.ignore.partialResultException false true Troubleshoots retrieval of LDAP users.
c42.publishConfigWorker.throttle 5 2 Handles the rate at which client configuration changes are published. Lowering the rate lowers the throttle, allowing for more changes to be published in a shorter amount of time.

Before you begin

  1. Sign in to the administration console.
  2. Dump the database to preserve all settings on the server.
  3. Double-click the logo in the upper-left corner of the administration console.
    The command-line interface appears in the administration console.
  4. Run the prop.show command from the command-line interface for each worker property value you intend to change:

prop.show <property>

For example, to view the new value of the b42.cpc.archiveMaintenanceManager.numWorkers property, run the following command:

prop.show b42.cpc.archiveMaintenanceManager.numWorkers

  1. Record the value of each property in case you need to roll back any changes you make. (If nothing is returned, the property value is set to the default.)  

Steps

  1. Sign in to the administration console.
  2. Double-click the logo in the upper-left corner of the administration console.
    The command-line interface appears in the administration console.
  3. Run the prop.set command from the command-line interface for each worker property value you want to change:

prop.set <name> <value> save all

For example, to change the b42.cpc.archiveMaintenanceManager.numWorkers value to 10, run the following command:

prop.set b42.cpc.archiveMaintenanceManager.numWorkers 10 save all

  1. To verify the new setting, run the following prop.show command:

prop.show <property>

For example, to view the new value of the b42.cpc.archiveMaintenanceManager.numWorkers property, run the following command:

prop.show b42.cpc.archiveMaintenanceManager.numWorkers

  1. To ensure the new settings take effect on your Code42 server, run the node.restart command.
  • Was this article helpful?