IBM Tivoli Monitoring, Version 6.3

tacmd editSdaOptions

Description

Use the tacmd editSdaOptions command to edit Self-Describing Agent (SDA) option configuration entries.

The tacmd editSdaOptions command removes the configuration that controls how product definitions for the specified agent types are applied at the hub monitoring server. When the application support for a product is applied to the hub monitoring server, commonly called seeding, the definitions are added to the hub and these are automatically propagated to any active remote monitoring server. Configuration for the SDA seeding for a product type specifies how the distribution targets for definitions are applied. The option to control the seeding is provided to prevent prior customization from being lost. Editing seeding configuration will not modify how the existing SDA was seeded.
Note: You must log in using the tacmd login command before running the editSdaOptions command.

CLI syntax

tacmd editSdaOptions {-o|--options} KEY=VALUE...KEY=VALUE |
KEY_GROUP=VALUE {-t|--type} TYPE... [{-f|--force}]
  

where:
-o|--options
Specifies the KEY=VALUE...KEY=VALUE pairs to set, separated by a space.
KEY INSTALL_SEED
Valid values include NEW, NONE, and ALL. Specify NEW, NONE, or ALL to choose how distribution definitions are applied during the pristine install of the product identified.
  • NEW: A configuration choice of NEW allows all product distribution definitions to be added to the TEMS during a Pristine Install.
  • NONE: A configuration choice of NONE prevents any product distribution definitions from being added to the TEMS during a Pristine Install.
  • ALL: A configuration choice of ALL allows all product distribution definitions to be added to the TEMS during a Pristine Install.
key UPGRADE_SEED (for the Pristine Install)
Valid values include NEW, NONE, and ALL. Specify NEW, NONE, or ALL to choose how distribution definitions are applied during the upgrade install of the product identified.
  • NEW: A configuration choice of NEW prevents any product distribution definitions to be added to the TEMS during a Upgrade Install.
  • NONE: A configuration choice of NONE prevents any product distribution definitions from being added to the TEMS during a Upgrade Install.
  • ALL: A configuration choice of ALL allows all product distribution definitions to be added to the TEMS during a Upgrade Install.
KEY_GROUP SEEDING
Valid values include NEW, NONE, ALL, DISABLE, and ENABLE. Specify NEW, NONE, or ALL to choose how distribution definitions are applied during the upgrade install and pristine install of the product identified.
  • NEW: A configuration choice of NEW is equivalent to specifying UPGRADE_SEED=NEW and INSTALL_SEED=NEW.
  • NONE: A configuration choice of NONE is equivalent to specifying UPGRADE_SEED=NONE and INSTALL_SEED=NONE.
  • ALL: A configuration choice of ALL is equivalent to specifying UPGRADE_SEED=ALL and INSTALL_SEED=ALL.
  • DISABLE: A configuration choice of DISABLE prevents all product monitoring definitions from being added to the TEMS during an Upgrade or Pristine Install.
    Note: After you have disabled SEEDING for a TYPE using the -o SEEDING=DISABLE option, you cannot modify the INSTALL_SEED and UPGRADE_SEED keys until SEEDING is re-enabled for the TYPE using the -o SEEDING=ENABLE option.
  • ENABLE: A configuration choice of ENABLE clears the DISABLED values and sets UPGRADE_SEED and INSTALL_SEED to INSTALL_SEED=ALL and UPGRADE_SEED=NEW.
-t|--type
Specifies one or more product types. If a product type does not have a seeding option configuration, the DEFAULT configuration is used.
-f|--force
Edit the SDA configuration options without prompting for confirmation.

If no configuration is provided, the SDA seeding uses default installation values. The default installation value for a pristine install is ALL. The default installation value for an upgrade installation is NEW. If only a single installation value is provided to an editSitOptions command, the value for the unspecified options is set to the described default installation value (i.e., ALL for pristine install, NEW for upgrade install).

CLI example

The command in the example edits configuration options for product type LZ.

tacmd editSdaOptions -t LZ -o INSTALL_SEED=NEW UPGRADE_SEED=NONE

The command in the example specifies a configuration for all product types that only the UPGRADE_SEED option is updated.

tacmd editSdaOptions -t DEFAULT -o UPGRADE_SEED=ALL

The command in the example disables seeding for product type NT.

tacmd editSdaOptions -t NT -o SEEDING=DISABLE

The command in the example restores seeding to the factory default for product type NT.

tacmd editSdaOptions -t NT -o SEEDING=ENABLE

The command in the example specifies that if R1 R2 R3 R4 R5 do not have entries, then new configuration options are created with factory default values.

tacmd editSdaOptions -t R1 R2 R3 R4 R5 -o SEEDING=ENABLE

Return values

See Return codes

Related commands

tacmd listSdaOptions

tacmd deleteSdaOptions

tacmd listappinstallrecs

tacmd deleteappinstallrecs

Return to Table 1.



Feedback