Deployment script and command reference

What the default script is and how it works

The default detection script for Windows:

• Uses the device's operating system to determine the most recent logged-on username.
• Calculates the typical home directory for that username.

The default detection script then reports these two values to a standard output.

Following is the default detection script:

@echo off
rem Use sysnative when running 32-bit on a 64-bit processor
if "%PROCESSOR_ARCHITEW6432%"=="" goto native
   %SystemRoot%\Sysnative\cmd.exe /c %0 %*
   exit
:native
rem Change code page to UTF-8
CHCP 65001
for /f "TOKENS=2*" %%a in ('reg query "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Authentication\LogonUI" /v LastLoggedOnUser') do set current_domain_user=%%b
echo current_domain_user = %current_domain_user%
for /f "TOKENS=1,2 DELIMS=\" %%a in ("%current_domain_user%") do set current_domain=%%a& set current_user=%%b
echo current_domain = %current_domain%
echo current_user = %current_user%
if "%current_user%" == "" (
   set current_user=%current_domain%
   echo current_user = %current_user%
)
if NOT "%current_user%" == "" (
   echo C42_USERNAME=%current_user%
   echo C42_USER_HOME=C:\Users\%current_user%
)

How to customize the default script

Create a custom script by copying and altering the default script. Then paste your custom script into your deployment policy.

When creating your custom script, be aware of the following:

• Every script must end as the default script does, by echoing values for two variables.

  echo C42_USERNAME=<value>
  echo C42_USER_HOME=<value>

• In the Code42 cloud, usernames must be email addresses.

  echo C42_USERNAME=%current_user%@example.com

• You must provide values. Null values and empty strings will not work.
• If you cannot write a script to provide a workable value, write a message for the username field of the Code42 app sign in dialog, for example:

  echo C42_USERNAME=Enter name and click Sign in

• The values cannot include quote marks, 'single' or "double".

What the default script is and how it works

The default detection script for Mac:

• Uses the device's operating system to determine the most recent logged-on username.
• Calculates the typical home directory for that username.

The default detection script then reports these two values to a standard output.

Following is the default detection script:

function main() {
local user=$(/usr/bin/python -c 'from SystemConfiguration import SCDynamicStoreCopyConsoleUser; import sys; username = (SCDynamicStoreCopyConsoleUser(None, None, None) or [None])[0]; username = [username,""][username in [u"loginwindow", None, u""]]; sys.stdout.write(username + "\n");')
echo "C42_USERNAME=${user}"
echo "C42_USER_HOME=/Users/${user}"
}
main "$@"

How to customize the default script

Create a custom script by copying and altering the default script. Then paste your custom script into your deployment policy.

When creating your custom script, be aware of the following:

• Every script must end as the default script does, by echoing values for two variables:

  echo "C42_USERNAME=<value>"
  echo "C42_USER_HOME=<value>"
  

• In the Code42 cloud, usernames must be email addresses.

  echo "C42_USERNAME=${user}@example.com"
  

• You must provide values. Null values and empty strings will not work.
• If you cannot write a script to provide a workable value, write a message for the username field of the Code42 app sign in dialog, for example:

  echo "C42_USERNAME=Enter name and click Sign in"
  

• The values cannot include quote marks, 'single' or "double".

DEPLOYMENT_URL=https://.host:port
DEPLOYMENT_POLICY_TOKEN=0fb12341-246b-448d-b07f-c6573ad5ad02
CP_SILENT=true
DEVICE_CLOAKED=false
PROXY_URL=http://.host:port/fname.pac

Mac deploy.properties file location

When the Code42 app installer runs on Mac, it looks for the deploy.properties file in three locations, in the following order:

1. In the disk image, typically in /Volumes/Code42CrashPlan
2. In a Jamf Pro temp directory: /tmp/mountpt/Code42CrashPlan
3. (Recommended location) In the directory /Library/Application Support/CrashPlan
   Installations for a single user use ~/Library rather than /Library.

hdiutil convert -format UDRW Code42CrashPlan_n.n.n_Mac.dmg -o C42_n.n.n_w.dmg
hdiutil attach C42_n.n.n_w.dmg
cp deploy.properties /Volumes/Code42CrashPlan/deploy.properties
hdiutil detach /Volumes/Code42CrashPlan
hdiutil convert -format UDRO C42_n.n.n_w.dmg -o C42_n.n.n_ro.dmg

#!/bin/bash
mkdir -p /Library/Application\ Support/CrashPlan
echo "<deploy.properties>" > /Library/Application\ Support/CrashPlan/deploy.properties

Mac commands

Deployment policy command arguments need to be imported into your software management tool.

Commands and arguments are detailed here in case you need to modify them for some reason, or to help you deploy without a device management tool.

• To install a Code42 app for all users of a device, sign in to an account with administrative rights and issue a command like the following:

hdiutil attach Code42CrashPlan_n.n.n_Mac.dmg
installer -package "/Volumes/Code42CrashPlan/Install Code42 CrashPlan.pkg"  
-target LocalSystem
hdiutil detach /Volumes/Code42CrashPlan

• To install for one user only, sign in as that user and use target CurrentUserHomeDirectory. 

Individual parts of the commands are as follows:

Create a custom script

Create a custom script and paste your script into your deployment policy. If you need help, contact your Customer Success Manager (CSM) for enterprise support at csmsupport@code42.com.

When creating your custom script, be aware of the following:

• Every script must end as the default script does, by echoing values for two variables:

  echo C42_USERNAME=<value>;
  echo C42_USER_HOME=<value>;
  

• In the Code42 cloud, usernames must be email addresses.
• You must provide values. Null values and empty strings will not work.
• If you cannot write a script to provide a workable value, write a message for the username field of the Code42 app sign in dialog, for example:

  echo C42_USERNAME=Enter name and click Sign in;
  

• The values cannot include quote marks, 'single' or "double".