Use the following procedure to install the Carbon Black Cloud Linux sensor on a Horizon golden image and create instant clones.
Prerequisites
See the following topics:
Procedure
- Create the golden image for the clone pool deployment. Perform required Linux updates, dependency installation for Horizon, and Horizon agent installation.
- Install the Linux sensor on the golden image by following the steps in Installing Linux Sensors on Endpoints.
- Confirm that configuration properties are set to enable the automatic identification and registration of a Horizon instant clone:
- The features are enabled by default. If
EnableAutoReregisterForVDIClones
does not exist in /var/opt/carbonblack/psc/cfg.ini, then you do not need to do anything and can proceed directly to Step 4. If the following property exists in the configuration file, confirm that it is set to one of the following values to enable automatic registration:EnableAutoReregisterForVDIClones=3
. Enables BIOS UUID and MAC Address hash change-based automatic registration. Recommended and default setting.EnableAutoReregisterForVDIClones=2
. Enables BIOS UUID change-based automatic registration.
- If the
EnableAutoReregisterForVDIClones
property is not set to the correct value, perform the following steps:- Run
service cbagentd stop
orsystemctl stop cbagentd
. - Edit the /var/opt/carbonblack/psc/cfg.ini file to set the correct value.
- Run
service cbagentd start
orsystemctl start cbagentd
.
Note:- To disable automatic registration, set the value of
EnableAutoReregisterForVDIClones
to1
. - When you install a Carbon Black Cloud Linux sensor 2.15+ on the Golden Image, Carbon Black automatically adds the
EnableAutoReregisterForVDIClones
property to the /var/opt/carbonblack/psc/cfg.ini file. The assigned value of theEnableAutoReregisterForVDIClones
property depends on your platform. For example,EnableAutoReregisterForVDIClones=1
for non-AWS, Azure, or GCP VMware platforms.
- Run
- The features are enabled by default. If
- Allow the background scan to complete on the golden image to optimize clone performance. Run the following command to determine whether the background scan has completed:
cat /var/opt/carbonblack/psc/blades/E51C4A7E-2D41-4F57-99BC-6AA907CA3B40/th.ini | grep LocalScanRunning
If
LocalScanRunning
is true, the background scan is ongoing. - Power off the golden image.
- Take a snapshot of the golden image.
Important: Do not run the
/opt/carbonblack/psc/bin/cbagentd -R
command on the golden image. This command turns the golden image into a clone, which might deregister pre-existing clones. - In the Horizon console, create an instant clone pool using the golden image and the snapshot created in Step 6.
- After the pool becomes available in the Horizon console, verify that the newly created instant clones are registered with a new Device ID in the Carbon Black Cloud console.
.