Overview
This article provides instructions for deploying the insider risk agent and backup agent to new endpoint devices. This applies only to environments with endpoint devices licensed for backup.
Considerations
- Devices on which you install the Code42 agents must meet the system requirements in Code42 platform hardware and software requirements.
Install agents for Windows devices
Follow these steps to build a command to install the insider risk agent and backup agent on Windows devices. Use the commands in your deployment tool (for example, Windows SCCM).
Download Windows installers
- Sign in to the Code42 console.
- Navigate to Administration > Agent Management > Downloads.
- From the Insider risk agent tab, select the latest Windows installer and click download .
- From the Backup agent tab, select the latest Windows installer and click download .
Set up deployment policy for Windows
Set up a deployment policy with a username detection script for Windows:
- From the Code42 console, navigate to Administration > Agent Management > Deployment.
- Create a new deployment policy, or edit an existing policy.
- In the User detection scripts box for Windows, enter your own username detection script, or use a sample script from Deployment script and command reference for the backup agent.
- Copy the deployment arguments from an Incydr deployment policy for the insider risk agent.
- Navigate to Administration > Agent Management > Deployment.
- Select the deployment policy you set up in step 3.
- Copy the Windows argument. It starts with
DEPLOYMENT_URL
and ends with/norestart
.
These are the deployment properties for the insider risk agent.
- Copy the deployment arguments from an Incydr deployment policy for the backup agent.
- Navigate to Administration > Agent Management > Deployment.
- Select the deployment policy you set up in step 3.
- Under Installation Properties, click the Backup agent tab.
- Copy the Windows argument. It starts with
CP_ARGS=
and ends with/qn
.
These are the deployment properties for the backup agent.
Set up Windows installation policies
- In your deployment tool, upload the installer packages from the previous section to your deployment tool.
- Set up the installation policy for the insider risk agent.
- Create the command by placing the name of the installation file before the deployment arguments. The following command is an example:
code42-aat_n.n.n.nn_win64.exe DEPLOYMENT_URL=https://console.us.code42.com DEPLOYMENT_POLICY_TOKEN=c42c42c42-4242-4242-4242-c42c42c42c42 DEPLOYMENT_SECRET=c42c42c42c42c42c42c42c42c42c42c42c42c42c42c= /install /quiet /norestart
- Scope this policy to install to all new devices.
- Create the command by placing the name of the installation file before the deployment arguments. The following command is an example:
- Set up the installation policy for the backup agent.
- Create the command by using msiexec.exe. The following command is an example:
msiexec /i Code42_n.n.n_Win64.msi CP_ARGS="DEPLOYMENT_URL=https://.host&DEPLOYMENT_POLICY_TOKEN=c42c42c42-4242-4242-4242-c42c42c42c42” CP_SILENT=true DEVICE_CLOAKED=false /norestart /qn
- Scope this policy to install to all new devices that require backup functionality.
- Create the command by using msiexec.exe. The following command is an example:
Install agents for Mac devices
Follow these steps to install the insider risk agent and backup agent on Mac devices using your deployment tool (for example, Jamf Pro).
Download Mac installers
- Sign in to the Code42 console.
- Navigate to Administration > Agent Management > Downloads.
- From Insider risk agent tab, select the latest Mac installer and click download .
- Mount the downloaded DMG and extract the installer PKG from within.
- From Backup agent tab, select the latest Mac installer and click download .
- Mount the DMG and extract the installer PKG from within.
Set up deployment policy for Mac
Set up a deployment policy with a username detection script for Mac:
- From the Code42 console, navigate to Administration > Agent Management > Deployment.
- Create a new deployment policy, or edit an existing policy.
- In the User detection scripts box for Mac, enter your own username detection script, or use a sample script from Deployment script and command reference for the backup agent.
- Copy the deployment arguments from an Incydr deployment policy for the insider risk agent.
- Navigate to Administration > Agent Management > Deployment.
- Select the deployment policy you set up in step 4.
- Copy the deployment properties file contents. These are the deployment properties for the insider risk agent. They must be populated to the device at
/tmp/code42.deployment.properties
or/Library/Application Support/Code42-AAT-Config/code42.deployment.properties
.
- Copy the deployment arguments from an Incydr deployment policy for the backup agent.
- Navigate to Administration > Agent Management > Deployment.
- Select the deployment policy you set up in step 4.
- Under Installation Properties, click the Backup agent tab.
- Copy the deployment properties file contents. These are the deployment properties for the backup agent. They must be populated to the device at
/Library/Application Support/CrashPlan/deploy.properties
.
Set up Mac installation policies
- In your deployment tool, upload the installer packages from the previous section to your deployment tool.
- Set up the configuration profiles for the Code42 agents:
- Configuration profile for the insider risk agent
-
Configuration profile for the backup agent
If you have already deployed legacy agents, you may already have this profile in place. If so, you can leave it as-is. It does not need to be replaced.
- Scope these profiles to all devices on which you intend to install Code42 agents.
- Set up the installation policy for the insider risk agent.
- Create a package or script to populate the deploy.properties file. The following command is an example:
#!/bin/bash mkdir -p "/Library/Application Support/Code42-AAT-Config" echo "DEPLOYMENT_URL=https://console.us.code42.com DEPLOYMENT_POLICY_TOKEN=c42c42c42-4242-4242-4242-c42c42c42c42 DEPLOYMENT_SECRET=c42c42c42c42c42c42c42c42c42c42c42c42c42c42c=" > "/Library/Application Support/Code42-AAT-Config/code42.deployment.properties"
- Once the deployment properties file is populated, install the insider risk agent PKG in the system context.
- Scope this policy to install to all new devices.
- Create a package or script to populate the deploy.properties file. The following command is an example:
- Set up the installation policy for the backup agent.
- Create a package or script to populate the deploy.properties file. The following command is an example:
#!/bin/bash
mkdir -p /Library/Application\ Support/CrashPlan echo "DEPLOYMENT_URL=https://console.us.code42.com DEPLOYMENT_POLICY_TOKEN=c42c42c42-4242-4242-4242-c42c42c42c42 CP_SILENT=true DEVICE_CLOAKED=false" > "/Library/Application Support/CrashPlan/deploy.properties" - Once the deployment properties file is populated, install the backup agent PKG in the system context.
- Scope this policy to install to any new devices that require backup functionality.
- Create a package or script to populate the deploy.properties file. The following command is an example: