Configuring the SMP Agent to ignore specific resource keys on Unix, Linux & Macintosh clients

book

Article ID: 180754

calendar_today

Updated On:

Products

Management Platform (Formerly known as Notification Server) Notification Server Agent for Macintosh (Altiris) Notification Server Agent for Unix/Linux (Altiris)

Issue/Introduction

 How to configure the SMP Agent to ignore specific resource keys on Unix, Linux & Macintosh clients

Resolution

For the Symantec Management Agent for Unix, Linux, and Mac (ULM) version 7.1 - 8.x, it is possible to configure the resource keys to ignore during the generation of NSE events. This allows to exclude the values that could cause a conflict in a given environment.

(An NSE event is anything sent to the Notification Server, including Basic Inventory, event transactions, inventory solution, etc.)  

This can apply to any situation where computer resources are merged because they have the same resource key values.

To make this configuration change: 

  1. On the ULM client computer, edit the file: /opt/altiris/notification/nsagent/etc/client.conf. 
  2. Find the  '[MachineID]' section.
  3. Change the values for the 'ignore_resource_keys' . (Add the name and value entry if it doesn't currently exist.)

 

Note 1: Values listed here will NOT be used as resource keys in events sent to the NS/SMP from the client.

Note 2: This field is a comma-separated list on a single line.

Note 3: Supported values are: namedomain, fqdn, macaddress, uniqueid, adnameaddomain.  

Field Value Related Resource Key Comment
namedomain name.domain The first name.domain key (hostname/computer name on Mac/DNS name)
adnameaddomain name.domain The second name.domain key (containing information from Active Directory)
fqdn fqdn The FQDN resource key and the third name.domain key with short FQDN
macaddress macaddress MAC address
uniqueid uniqueid Unique ID value based on UUID of computer, motherboard serial number, and MAC address.

Note 4: The value of name.domain resource key is based on the targeted settings 'Computer Information' settings in the Symantec Management Console. Options are the local computer name or the DNS name, etc. There may be multiple name.domain resource keys. 

Note 5: Depending on the NS version, the 'ignore_resource_keys' field may or may not exist in the client.conf file. If it does not exist, it is possible to add the line in the 'MachineID' section. See samples, below. 

Note 6: Even if all resource keys are set to be ignored, the agent will always attempt to create a name.domain resource key based on the 'hostname' of the client computer.

Note 7: IMPORTANT: DO NOT ignore all resource keys without first ensuring that the Hostname is set on Linux and HP-UX, Solaris, AIX computers: "hostname". Also, check that Computer Name is set on OS X computer: "scutil --get ComputerName". If this Hostname or Computer Name is not set and all resource keys are ignored, the agent will not be able to create any resource keys, resulting in a complete loss of registration and communication with the Notification Server. 

Note 8: If you would like to configure the Agent to ignore specific resource keys at install time, use the .aex-agent-install-config.cml file. The aex-agent-install-config.xml file is obtained on the Notification Server console in the Altiris Agent Installation, install Altiris Macintosh Agent screen, under "Installation settings". By default, the file begins with a dot (.) and is hidden on UNIX/Linux/Macintosh systems. Put this file in the same directory as the install file before installing the agent.

 

Sample: 

[MachineID]

...

ignore_resource_keys=fqdn, macaddress, uniqueid

...

 

Sample Command Line for Run Script Task, Shell Script, Etc.

The following command can be used from a command line, in a run script task, a shell script or another appropriate script to automate the configuration of client machines with these settings. If the entry exists, it will be updated. If the entry does not exist, it will be created at the end of the machineid section.  

      sudo aex-helper agent -s MachineID ignore_resource_keys "fqdn, macaddress, uniqueid"