Loading...

Managing Additional Settings

Table of Contents

Adding or Modifying Additional Settings from the CommCell Console

Additional Settings can be added to the following CommCell entities:

  • CommServe
  • MediaAgent
  • Clients
  • Client Groups
  • Users (CommServDB.Console settings only)
  • User Groups (CommServDB.Console settings only)
  • Domains (CommServDB.Console settings only)

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

Procedure

  1. From the CommCell Browser, right-click the entity and then click Properties.
  2. To work with a MediaAgent or a client, in the Properties dialog box, click Advanced.
  3. On the Additional Settings tab, click Add.
  4. 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 category for the additional setting, for example, Boolean.
    4. In the Value box, type the value of the additional setting.
  5. Optional: In the Comment box, enter any user comments about the additional setting. User comments can include notes how to use the additional setting.
  6. 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.

  7. Click OK.

Deleting an Additional Setting from the CommCell Console

Use the following steps to delete an additional setting:

  1. From the CommCell Browser, right-click the entity and then click Properties.
  2. If you are deleting the additional setting for a MediaAgent or a client, in the properties dialog box, click Advanced.
  3. On the Additional Settings tab, select the additional setting from the list and click Delete.
  4. Click Yes to remove the additional setting from the CommServe database.
  5. 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.

  1. Download the additional_settings.xml file and save it on the computer from where the command will be executed.
  2. 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.
  3. Run the qlogin command to log on to the CommServe computer.
  4. Execute the following command after updating the XML file:

    qoperation execute -af additional_settings.xml

  1. 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