How to Include the Client Automation (ITCM) agent in a cloned OS Image

Document ID : KB000009466
Last Modified Date : 14/02/2018
Show Technical Document Details
Introduction:

If the chosen method of deploying the CA IT Client Management (ITCM) agent to other computers is an imaging tool like ImageX, or an image file of a virtual machine using a tool like VMWare, some actions are required on the template machine if the Client Automation agent is part of the image.

Environment:
Client Automation -- all versions.
Instructions:

Important: This article contains information about modifying the registry. Before you modify the registry, make sure to create a back up of the registry and ensure that you understand how to restore the registry if a problem may occur. For more information about how to back up, restore and edit the registry, please view the relevant Microsoft Knowledge Base articles on support.microsoft.com.

DSM 11.2/ITCM 12.x, 14.x

Before generating the image, perform the following actions on the template machine:

  • Start the agent and register it with a manager to ensure proper verification of the management server information.
  • Run the following commands:

    caf stop
    ccnfcmda -cmd DeleteParameter -ps itrm/rc/host/managed -pn convertedhostuid
    ccnfcmda -cmd DeleteParameter -ps itrm/cfencrypt -pn LOCALID
    ccnfcmda -cmd DeleteParamSection -ps itrm/rc/security/providers/common/users
  • Delete the HostUUID key from the registry:

    On a 32-bit OS: HKEY_LOCAL_MACHINE\SOFTWARE\ComputerAssociates\HostUUID
    On a 64-bit OS: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ComputerAssociates\HostUUID
    On UNIX/Linux: Delete the file /etc/cadmuuid

 

  • Generate the image to be deployed BEFORE starting the DSM agent again.

 

DSM 11.1, 11.0

Before generating the image, perform the following actions on the template machine:

  • Start the agent and register it with a manager to ensure proper verification of the management server information.
  • Run the following commands:

    caf stop
    ccnfcmda -cmd DeleteParameter -ps itrm/rc/host/managed -pn convertedhostuid
    ccnfcmda -cmd DeleteParameter -ps itrm/cfencrypt -pn LOCALID
    ccnfcmda -cmd DeleteParamSection -ps itrm/rc/security/providers/winnt/users
  • Delete the HostUUID key from the registry:

    On a 32-bit OS: HKEY_LOCAL_MACHINE\SOFTWARE\ComputerAssociates\HostUUID

    On a 64-bit OS: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ComputerAssociates\HostUUID

 

  • Generate the image to be deployed BEFORE starting the DSM agent again.

 

All Versions

The deleted values 'convertedhostuid', 'LOCALID' and 'HostUUID' are machine-specific and will be properly regenerated on the template machine, as well as on the target machines at agent start.

The default users for the security providers will not be recreated automatically by the host. Therefore, if the security mode of the host is not set to centralized security, the following command to re-create the default users for the host must be executed on the template machine, as well as on each target machine:

rcUtilCmd.exe CreateDefaultUsers

Note: 'rcUtilCmd.exe' can be found in the ......\Program Files\CA\DSM\bin folder