CrashPlan commands

This article applies to all products.png

Overview

CrashPlan Commands allow you to manually enter commands that can be used to generate log files, start and stop the CrashPlan 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 CrashPlan app.
  2. If necessary, sign in.
    See the table below for commands that require authentication.
  3. Open CrashPlan Commands using one of the following methods: 

    • Version 8.6 and later: Double-click the CrashPlan logo in the upper-left corner.
    • All versions: 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.

      CrashPlan Commands.png

Available commands

You must be signed in to the CrashPlan app 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
connection.info

This command is removed in version 6.9.0 and later.

 

The command is visible but deprecated in earlier 6.x versions because the 6.x CrashPlan app does not support computer-to-computer backups.

No
custom

Deletes any existing CrashPlan app language and skin customizations.

Yes
deauthorize Signs out the current user, disables the CrashPlan 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 CrashPlan app and turns off the background CrashPlan service. Yes
fullDiskAccess

For devices running macOS 10.14 and later, indicates if full disk access is granted to CrashPlan. Due to Apple privacy restrictions, full disk access is required for CrashPlan to perform security monitoring and backup activity for all files on a device.

 

Requires CrashPlan app version 8.2.0 or later.

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 CrashPlan service.

 

Beginning in CrashPlan app version 8.7.0, 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

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 CrashPlan 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 CrashPlan 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 CrashPlan app and restart the CrashPlan 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 CrashPlan service. You can abbreviate this command as resume. Yes
version

Lists the version and build number of the CrashPlan app.

 

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 CrashPlan

CrashPlan app versions before 8.0.0 also include a timestamp that is not related to the current version. You can ignore this timestamp.

Yes
Was this article helpful?
0 out of 0 found this helpful

Articles in this section

See more