Preparing The CrashPlan App For Deployment

Customize the CrashPlan app text

1. From within the custom folder, open the custom.properties file using a plain text editor.
   
   Plain Text Editors 
   Use a plain text editor, such as Vi, VIM, emacs, Text Wrangler, Notepad++, TextMate, etc., to make these changes.
   Word processors, such as Wordpad, Word, Pages, or OpenOffice Writer, can add formatting characters to plain text files and should be avoided.
2. Within the section listed below, add any attributes that you would like to modify. You can modify any attribute listed in the lang/txt.properties file, installed alongside the CrashPlan app.
   
   • Windows: C:\Program Files\CrashPlan\lang\txt.properties
     If you installed per user, see the file and folder hierarchy for file locations.
   • OS X: /Applications/CrashPlan.app/Contents/Resources/Java/lang/txt.properties
     If you installed per user, see the file and folder hierarchy for file locations.
   • Linux: /usr/local/crashplan/lang/txt.properties
   • Solaris (when installed as root): /opt/sfw/crashplan/lang/txt.properties

Text changes will only affect CrashPlan apps using an English-language locale.

Add your customizations to this section of the custom.properties file:

## Language properties???    
## Specify any properties found in lang/txt.properties???    
## Any properties listed here will override but are English only.

For example, the following properties change the labels of the text fields of the user login screen:

LoginPanel.firstName=First name\:???    
LoginPanel.lastName=Last name\:???    
LoginPanel.password=Password\:

For example, you can change the displayed login page labels by adding 'C42' to the firstName, lastName, and password fields as follows:

LoginPanel.firstName=C42 First name\:???    
LoginPanel.lastName=C42 Last name\:???    
LoginPanel.password=C42 Password\:

Customize the CrashPlan app images

The custom/skin directory contains the images that you can customize or replace with your own images. These are the only images or graphics that can be customized.

Modified images must be saved with filenames, image dimensions, and formats identical to the original. Only images matching the original file's properties are applied during the install process.

An example of a CrashPlan app co-branded with an example logo:

Customize configuration settings

You can customize CrashPlan app settings, such as setting the primary network address of the enterprise server, pre-populating a registration key, or configuring Single Sign-On (SSO), by creating a custom.properties file specific to your Code42 environment. For Mac OS X only, Code42 provides a shell script to assist you in creating a custom.properties file; for Windows and Linux environments, you will need to edit the custom.properties file manually.

Before running customizing configuration settings in your Code42 environment, familiarize yourself with the available custom properties:

Option 1: Custom configuration script

Code42 provides a customization script for use on OS X. You can view the full options of the customization script by running custom.sh -h.

mycomputer:custom jdoe$ ./custom.sh

=====================================================
  Please review your customization settings below:

address=proe-master.example.com:4282
secondaryAddress=192.0.2.50
hideAddress=false
lockedAddress=true
registrationKey=AAAA-BBBB-CCCC-DDDD
username=${username}
password=
proxy.enable=false
proxy.pacUrl=test
ssoAuth.enabled=true
ssoAuth.required=false
ssoAuth.provider=Shibboleth
LoginPanel.firstName=Surname\:???

Change settings  (yes, no, or revert) [no]?

Option 2: Manually create custom installers

After customizing the contents of the custom template folder, you can add the custom folder to an installer to create a custom installation package. Manually adding the custom folder is required on Windows and Linux devices, because the provided custom.sh script is designed only for OS X.

Place custom installers on your Master server

Copy your custom installers from their current location to a download folder on your master server. The location of this folder varies based on the operating system of your master server.

If the download folder does not exist on your master server, create it.

Download custom installers on devices

You can download and install the custom installers from your master server to your devices by signing into the administration console and selecting the appropriate platform from the welcome screen.

Mac

If you are installing the CrashPlan app with a software management tool, or installing as a user other than the device owner or end user, you may need to specify the correct username and home path during the installation process. By default, CrashPlan PROe sets the backup user owner and home path as the user that initiated the install. Additional scripting is required to modify this behavior. For assistance with advanced scripting (a billable service), please contact sales.

Specify User & Home Directory

Using a text editor, edit the file 'userInfo.sh' located within the directory 'custom' you created during the customization process above. Set the following variables:

Windows

If you are installing the CrashPlan app with a software management tool, or installing as a user other than the device owner or end user, you may need to specify the correct username and home path during the installation process. By default, CrashPlan PROe sets the backup user owner and home path as the user that initiated the install. Additional scripting is required to modify this behavior. For assistance with advanced scripting (a billable service), please contact sales.

Specify User & Home Directory

For automated or silent installation using third party management tools, an advanced script may be required.

Windows Batch Script Example

This script is an example and is not guaranteed or supported.

@ECHO OFF

REM The LDAP login user name and the CrashPlan user name.
SET CP_USER_NAME=%USERNAME%
Echo UserName: %CP_USER_NAME%

REM The users home directory, used in backup selection path variables.
SET CP_USER_HOME=%USERPROFILE%
Echo UserHome: %CP_USER_HOME%

REM Set the registration key
SET CP_REG_KEY=AAAA-BBBB-CCCC-DDDD
Echo RegKey: %CP_REG_KEY%

REM Tells the installer not to run CrashPlan client interface following the installation.
SET CP_SILENT=true
Echo Silent: %CP_SILENT%

SET CP_ARGS="CP_USER_NAME=%CP_USER_NAME%&CP_USER_HOME=%CP_USER_HOME%&CP_REG_KEY=%CP_REG_KEY%"
Echo Arguments: %CP_ARGS%

REM You can use any of the msiexec command-line options.
ECHO Installing CrashPlan...
CrashPlanPROe-x64_Win.exe /qn /l* install.log CP_ARGS=%CP_ARGS% CP_SILENT=%CP_SILENT%

Linux

When installing on a Linux device without a GUI, a username and password must be specified within the 'custom.properties' file prior to installation.