1. Code42 Support
  2. Incydr
  3. Using the backup agent
  4. Troubleshooting

Code42 commands

Updated

Overview

Code42 Commands allow you to manually enter commands that can be used to generate log files, start and stop the Code42 service, assign a new GUID, and more.

Considerations

An administrator can prevent pausing with the Pausing Controls setting. If pausing is disallowed, the pause and resume options described below can be run but have no effect.

Steps

  1. Open the Code42 agent.
  2. If necessary, sign in.
    See the table below for commands that require authentication.

  3. Open Code42 Commands using one of the following methods: 

    • Double-click the Code42 logo in the upper-left corner.
    • Enter the keyboard shortcut for your operating system:
      • Windows: Ctrl+Shift+C
      • Mac: Option+Command+C
      • Linux: Ctrl+Shift+C
  4. Enter commands in the text area.
    • Enter commands without quotes.
    • The commands are case-sensitive, so be sure to enter commands exactly as shown.
    • Use commas to separate multiple commands on the same line.

      Code42 commands

Available commands

You must be signed in to the Code42 agent to use commands that require authentication.

Command Description Requires authentication?
backup.replace <destination GUID>

Recreates the client-side cache with data from the destination.

 Yes
backup.scan Performs a file verification scan or checks your file selection for deleted files. You can abbreviate this command as scan. Yes
backup.set Creates or deletes backup sets. You can abbreviate this command as set. Yes
backup.validate Validates the client cache for all or a given destination. Yes
custom

Deletes any existing Code42 agent language and skin customizations.

 Yes
deauthorize Signs out the current user, disables the Code42 service and requires you to sign in to resume. Yes
disconnect Disconnects the device or another device on the account using the Globally Unique ID.
For example: disconnect <GUID> 		Yes
dump Prints the client's state and configuration to the logs for easy reading. If possible, always issue this command before sending the logs to support. No
exit Exits the Code42 agent and turns off the background Code42 service. Yes
fullDiskAccess

Indicates if full disk access is granted to Code42. Due to Apple privacy restrictions, full disk access is required for Code42 to perform security monitoring and backup activity for all files on a device.

 Yes
getlogs

Compiles the client logs into a compressed archive and displays the archives path.
For example: /Library/Logs/CrashPlan/cl_<GUID><hostname><date/timestamp>.zip

 No
guid Displays device's current identity (Globally Unique ID). Yes
guid new Assigns a new, randomly generated device identity. Yes
guid <guid number> Reassigns the provided GUID from another device in your account to this device. Yes
help Lists available commands. No
java

Displays or sets the Java JVM maximum heap size. You can use this command to increase the amount of memory allocated to the Code42 service.

 

There is a 30-minute delay for this setting to take effect. To apply the changes immediately, issue the restart command after setting the new java value.

 Yes
log

Controls logging levels. Available logging levels are:

  • info
  • debug
  • trace
  • default
 Yes
path.analyze Prints a path's selection and exclusion status.
For example: 
path.analyze C:\Users\Username\Documents 		Yes

pause.destination <destination GUID>

Pauses backup to a specific destination GUID for 1 hour. Add a number of minutes to pause for a different period, up to a maximum of 24 hours (1440 minutes). For example, pause.destination 43 30 pauses backup to the Code42 cloud destination for 30 minutes.

 Yes

pause.plan
<plan UID>

Pauses backup for a specific backup set for 1 hour. Add a number of minutes to pause for a different period, up to a maximum of 24 hours (1440 minutes). For example, pause.plan mybackup1 30 pauses the mybackup1 backup set for 30 minutes.

 

Obtain the plan UID for a backup set by searching for PlanUid in the service.log.0 file.  

 Yes

pause.system

 Pauses the Code42 service for 1 hour. Add number of minutes to pause for a different period, up to a maximum of 24 hours (1440 minutes). For example, pause.system 30 pauses for 30 minutes. You can abbreviate this command as pause. Yes
proxy Manages proxy settings and refresh PAC file. Available proxy commands are:
  • enable
  • disable
  • refresh
  • debug
  • test
 Yes
reauthorize Reauthorizes with the server. You can abbreviate this command as rz. Yes
reconnect Reconnects the device or another device on the account using the Globally Unique ID.
For example:reconnect <GUID> 		Yes
removable.media.info

Outputs a .txt file with metadata for all removable media connected to the device. This can help administrators investigate security events.

 

If no path is specified, the file is created on the Desktop. Optionally, add a filepath to save the file to a different location. For example: 
removable.media.info C:\Users\Username\Documents

 Yes
restart Exits the Code42 agent and restart the Code42 service. Yes

resume.destination <destination GUID>

 Resumes backups to a specific destination GUID. Yes

resume.plan
<plan UID>

 Resumes backups for a specific backup set. Obtain the plan UID for a backup set by searching for PlanUid in the service.log.0 file.   Yes
resume.system Resumes the Code42 service. You can abbreviate this command as resume. Yes
version

Lists the version and build number of the Code42 agent.

 

For example, in this response: 

8.0.0 - 1525200006800 - Build 281
  • 8.0.0 is the version number
  • 281 is the build number
  • 1525200006800 is the long version number used internally by Code42
 Yes