Performing an incremental discovery
After a full discovery with full topology split, you should use incremental discovery with incremental topology split for topology
updates. Topology updates are due to the adding of new devices to the managed IP network, the decommissioning of devices, or the changing of configurations.
Incremental discovery is invoked by adding new devices as
seed devices to the or placing the new devices on the ’s Pending Devices list. Seed devices are specified
in a seed file or in
Add Agent
commands.Incremental topology split assigns the new devices to an existing topology split, which might result in the moving of some devices from one
IP Availability Manager
to another in an attempt to improve the split.To perform an incremental discovery with incremental topology split:
- Configure the as follows:
- Enable topology splitSet the NumberOfDomains configuration parameter to the number of domains that are specified in the TSM_BASEDIR/smarts/local/conf/discovery/topo-split/ topo-split.conf file. That number must be greater than 1.
- Select normal modeEnsure that the IsTrialLearningEnabled configuration parameter is FALSE.
- Select incremental topology splitEnsure that the IsSplitFromScratch configuration parameter is FALSE.
- Optional but recommended: Enable automatic topology synchronizationSet the IsTopoSyncEnabled configuration parameter to TRUE.
- Optional but recommended: Enable edge managementSet the EnableAutoEdgeManagement configuration parameter to TRUE. Note that automatic topology synchronization must be enabled before edge management can be enabled.
- Enable the TSM hook scriptSet the IsTSMHookEnabled configuration parameter to TRUE.
- Create a seed file and add the new devices to the seed file.The uses the hostnames or IP addresses of the seed devices that are specified in the seed file to discover the devices in the managed IP network. The seed file resides in the TSM_BASEDIR/smarts/local/conf directory. The includes the procedure for creating seed files.
- Import the seed file and initiate an incremental discovery with incremental topology split.“Initiating a discovery” on page 81 describes various methods to import a seed file and initiate a discovery. One method is to open a Domain Manager Administration Console that is attached to the and do the following:SelectTopology > Import from seed fileto launch theImport From Seed Filedialog box. In the dialog box, specify the complete path and name of the seed file. (By default, the path to the seed file is TSM_BASEDIR/smarts/local/conf.) ClickOKto import the seed devices and to start the incremental discovery with incremental topology split.If IsTopoSyncEnabled is TRUE, the splits the new topology and places a seed file for each domain in the ’s local/logs directory, and in eachIP Availability Manager’s local/logs directory. The adds the new devices in a domain’s seed file to the Pending Devices list of the appropriateIP Availability Manager. It also deletes outdated devices from the appropriateIP Availability Manager’s repository. Outdated devices are devices that are already in theIP Availability Manager’s topologyandare either not assigned by the topology-split algorithm or are assigned and areunmanaged.If IsTopoSyncEnabled is FALSE, the splits the new topology and places a seed file for each domain in the ’s local/logs directory, butnotin eachIP Availability Manager’s local/logs directory. Because the seed files are retained by the , administrators can use them later to initiateIP Availability Managerdiscovery manually.If you use these seed files to initiateIP Availability Managerdiscovery manually, ensure that you use the set of seed files with the most recent timestamp.Each new seed file in the ’s local/logs directory contains previously discovered devices and newly discovered devices, whereas each new seed file in a domain’s local/logs directory contains the new devices only. Outdated devices are commented out in the domain’s seed file.
- If IsTopoSyncEnabled is TRUE: For eachIP Availability Manager, go to the BASEDIR/smarts/bin directory in the appropriateIP Managerinstallation area and enter the following command to invoke a pending discovery:dmctl -s<AM name>invoke ICF_TopologyManager::ICF-TopologyManager discoverPendingdmctl -s AM001 invokeICF_TopologyManager::ICF-TopologyManager discoverPending
- If IsTopoSyncEnabled is FALSE: For eachIP Availability Manager, use the associated seed file in the ’s local/logs directory to manually initiate a discovery at theIP Availability Manager. If theIP Availability Manageris on a different host, copy the associated seed file to that host and place it in the BASEDIR/smarts/local/conf directory.
- After theIP Availability Managers have completed their discoveries, check all critical numbers to determine if they meet your predefined criteria.