Managing Additional Settings

Table of Contents

Adding or Modifying Additional Settings from the CommCell Console

You can add additional settings to the following CommCell entities:

Note: In a cluster environment, you must specify the additional settings on the physical nodes (the client computers), not on the cluster server.

Procedure

From the CommCell Browser, right-click the entity and then click Properties.
To work with a MediaAgent or a client, in the Properties dialog box, click Advanced.
On the Additional Settings tab, click Add.
In the Add Additional Settings dialog box, do the following:
1. In the Name box, type the name of the additional setting.
  Alternatively, you can click Lookup and search for the additional setting using the Find box.
2. In Category box, select the category for the additional setting, for example, CommServe.
3. In the Type box, select the type for the additional setting, for example, Boolean.
4. In the Value box, type the value of the additional setting.
In the Comment box, enter comments for the additional setting.
Click OK to save the additional setting configuration.
To change the value of an existing additional setting, select the additional setting from the list and then click Edit.
Click OK.

Deleting an Additional Setting from the CommCell Console

Use the following steps to delete an additional setting:

From the CommCell Browser, right-click the entity and then click Properties.
If you are deleting the additional setting for a MediaAgent or a client, in the properties dialog box, click Advanced.
On the Additional Settings tab, select the additional setting from the list and click Delete.
Click Yes to remove the additional setting from the CommServe database.
Click OK.

Managing Additional Settings from the Command Line Interface

Use the following steps to modify (add, edit, or delete) the additional setting details for one or more clients.

Download the additional_settings.xml file and save it on the computer from where the command will be executed.
Open the .xml file and provide the respective values for the XML parameters listed in the table below.
Notes:
- The additional setting is added if it does not exist and the registryKeys/deleted parameter is set to 0.
- The additional setting is updated if it does exist and the registryKeys/deleted parameter is set to 0.
Run the qlogin command to log on to the CommServe computer.
Execute the following command after updating the XML file:
qoperation execute -af additional_settings.xml
You can verify the changes that you performed on the clients using the steps below:
1. From the CommCell Browser, right-click the client and then click Properties.
2. Click Advanced.
3. Click the Additional Settings tab. The changes should be displayed.

The following table displays the XML parameters that need to be provided before running the qoperation command:

Parameter	Description of Parameter Values
clientName	Name of the client computers for which you want to add, modify or delete an additional setting.
keyName	Name of the additional setting.
type	Type of the additional setting. Valid values are: BOOLEAN ENCRYPTED INTEGER MULTISTRING STRING
value	Value of the additional setting. Depending on type, the value could be numerical, a numeric range, or character string.
relativepath	The relative location of the additional setting in the instance. For example, if the additional setting is created on the CommServe, then the relative path will be CommServe.
registryKeys/deleted	Option to remove the additional setting. Valid values are: 1, to remove the additional setting 0, to retain the additional setting
registryKeys/enabled	Option to enable the additional setting. Valid values are: 1, to enable the additional setting 0, to disable the additional setting

Last modified: 8/31/2018 6:09:11 PM