Error CMM000327 when changing the Scalability Server of an Agent.

Products

• CA Client Automation - IT Client Manager
• CA Client Automation

Issue/Introduction

Starting on Client Automation r12.8 the functionality to change remotely the Scalability Server of an Agent was added. When this function is used, sometimes the following error could appear:

Failed to set server address of computer [CMM000327]

If the target machine has an Agent older than 12.8 installed, then this feature won't work.

Environment

Client Automation - All Supported releases

Cause

If the Target machine has an Agent with the same release level than the Domain Manager, GUI logs needs to be reviewed and search for the following:

CCFCafApi::setServerAddress: returned: 16: CAFAPI_NOPRIV: You must be an administrator to perform this command.
CCODAI::CompSetServerAddress failed to set SS address of Agent <agent_name> to <scalability_server_name>, cafRc=16
CO_Events::RaiseEventEx: Event string: Eventid: 1034, EventString: User <user_logged_in> failed to set Scalability Server of computer <agent_name> to <scalability_server_name>, error code=CMM000327

This error means that only a Domain Administrator can change the Scalability Server of the Agents.

Resolution

The command 'caf setserveraddress' used to change the Scalability Server of an Agent locally, requires elevated privileges, which means if a user with standard permission level executes this command on a machine, the same will fail. This logic also applies when the change is made remotely on DSM Explorer.

In order to solve this, is recommended to have a domain Administrator user, which will have elevated rights on all Agents from the environment. Once this user is set, it has to be added to the group of Administrators in Domain Manager server (which by default assigns admin rights to any user added) and, in order to perform the change, DSM Explorer can be opened using this domain admin user and perform the requested change.