How to import a new configuration parameter in to Default Computer Policy

Document ID : KB000117788
Last Modified Date : 18/10/2018
Show Technical Document Details
Introduction:
How to import a new configuration parameter into the Default Computer Policy?
Background:
The purpose of this document is to provide instruction on how to import a new configuration parameter into Default Computer Policy.  This may be used to manage new parameters, or parameters that are simply not exposed in the Default Computer Policy in ITCM.
Environment:
Client Automation (ITCM) -- any version
Instructions:
Example #1: T5IZ385 (Configure system updates invento)

This policy introduces the following configuration parameter at the agent:
ccnfcmda -cmd  SetParameterValue -ps /itrm/agent/am -pn WBEMTimeout -v 1

In this example, the parameter being managed is an integer value:
<configuration>
  <allusers>
    <paramsection name="itrm">
      <paramsection name="agent">
        <paramsection name="am">
          <parameter name="WBEMTimeout" value="1">
            <attribute name="dis_en">WMI Timeout</attribute>
            <attribute name="write">agent</attribute>
            <parameterinfo name="pi_WBEMTimeout">
              <attribute name="type">int</attribute>
              <attribute name="desc">Timeout value used by AM agent for collection of WMI inventory queries. Default value is 1 minute.</attribute>
            </parameterinfo>
          </parameter>
        </paramsection>
      </paramsection>
    </paramsection>
  </allusers>
</configuration>

Save this XML and run the following command to import the new policy:
ccnfregdb -f"X:\<full path to xml file>\Conf_WMI_Timeout.xml" -e
Note: There is no space between the -f option and the opening quotation mark.

This parameter will be seen in:
DSM Explorer --> Control Panel --> Configuration --> Configuration Policy --> Default Configuration Policy (or any custom policy) --> DSM --> Agent --> Asset Management --> WMI Timeout

<parameter name="WBEMTimeout" value="1">
This line establishes the parameter name, and sets a default value of 1.

<attribute name="dis_en">WMI Timeout</attribute>
This line sets the English display name, to display in DSM Explorer.  Instead of listing the parameter as "WBEMTimeout", it will be observed as "WMI Timeout".  Other supported languages are dis_ja, dis_de, dis_es, dis_fr, dis_it.  Add an individual attribute for each supported localization.

<attribute name="write">agent</attribute>
This line means the parameter will be LOCALLY MANAGED by default.  Meaning it is visible in computer policy, but not being CENTRALLY MANAGED.  To centrally manager it, a value of "manager" would be used.

<parameterinfo name="pi_WBEMTimeout">
This line designates parameter info or pi_parameter name.  It is used to define extended attributes, such as parameter variable type and description.

<attribute name="type">int</attribute>
This line informs configuration policy the value being stored is an integer type.  Other types are bool, string or encrypted.

<attribute name="desc">
This line sets the description observed in DSM Explorer.  These can also be localized for various languages, e.g. desc_en, desc_ja, desc_de. desc_es, desc_fr, desc_it.  Add an individual attribute for each supported language.

To reverse the changes and erase this configuration parameter, you can create the following XML:
<configuration>
<allusers>
<parameter path="itrm/agent/am" name="WBEMTimeout" />
</allusers>                                         
</configuration>

Save the XML and run this command:
ccnfregdb -r"X:\<full path to xml file>\Delete_WMI_Timeout.xml" -e
Note: There is no space between the -r option and the opening quotation mark. 

Example #2: T533290 (Archived Software exclude in RAC superseded by T437279)

This policy introduces the following configuration parameter at the agent:
ccnfcmda -cmd SetParameterValue -ps /itrm/usd/manager -pn RACBatchLinkage -v 0 (No Linkage)
ccnfcmda -cmd SetParameterValue -ps /itrm/usd/manager -pn RACBatchLinkage -v 1 (Batch Linkage)


In this example, the parameter being managed is an boolean value:
<configuration>
  <allusers>
    <paramsection name="itrm">
      <paramsection name="usd">
        <paramsection name="manager">
          <parameter name="RACBatchLinkage" value="1">
            <attribute name="dis_en">RAC: Job Container Linkage</attribute>
            <attribute name="write">agent</attribute>
            <parameterinfo name="pi_RACBatchLinkage">
              <attribute name="type">bool</attribute>
              <attribute name="desc">By design, RAC containers are built using the "batch job execution" option, whereas software jobs in the container are executed sequentially. If any job in the sequence fails, the remaining jobs will not be executed. Change this policy to false, to set RAC containers to be build using the "no linkage" setting. With the "no linkage" setting, jobs will execute sequentially, but independent from each other.</attribute>
            </parameterinfo>
          </parameter>
        </paramsection>
      </paramsection>
    </paramsection>
  </allusers>
</configuration>

Save this XML and run the following command to import the new policy:
ccnfregdb -f"X:\<full path to xml file>\ConfRAC.xml" -e
Note: There is no space between the -f option and the opening quotation mark.

This parameter will be seen in:
DSM Explorer --> Control Panel --> Configuration --> Configuration Policy --> Default Configuration Policy (or any custom policy) --> DSM --> Software Delivery --> Manager --> RAC: Job Container Linkage

As a boolean parameter, the value will either be 0 or 1:
FALSE = 0
TRUE = 1


Everything else is the same as described in example #1.  This creates a new parameter in Default Computer Policy (ITRM) --> Software Delivery (usd) --> Manager.  Internally configuration policy uses short names, e.g. "am" for Asset Management and "usd" for Software Delivery.

To reverse the changes and erase this configuration parameter, you can create the following XML:
<configuration>
<allusers>
<parameter path="itrm/usd/manager" name="RACBatchLinkage" />
</allusers>											
</configuration>

Save the XML and run this command:
ccnfregdb -r"X:\<full path to xml file>\DeleteRAC.xml" -e
Note: There is no space between the -r option and the opening quotation mark.