Inventory Discovery by Scanner Job

Introduction

This job runs hardware and installed software inventory discovery by scanners.

Adapter Information

Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

CI	Attribute Value
IpAddress	NOT IP Probe Name Is null
Shell	NOT CI Type Equal telnet

This job uses the Inventory Discovery By Scanner Adapter.

Triggered CI Data

Name	Value
ProtocolList	${SHELL.root_class}
codepage	${SHELL.codepage:NA}
credentialsId	${SHELL.credentials_id:NA}
hostId	${SOURCE.root_id}
hostName	${SOURCE.name:NA}
ipTaggingList	${IP.ip_lease_time:NA}
ip_address	${SHELL.application_ip}
macList	${SHELL.arp_mac:NA}
nodeGUID	${SOURCE.ud_unique_id:NA}
nodeIpList	${IP.name:NA}
nodeMacList	${IP.arp_mac:NA}
primaryDNSName	${SOURCE.primary_dns_name:NA}
scanFileLastDownloadedTime	${SCANNER.scan_file_last_downloaded_time:NA}
scannerVersion	${SCANNER.version:NA}

Workflow Steps

Step Name	Module	Failure-policy
Remove Local Scan Log File	RemoveLocalScanLog.py	optional
Scanner Connect	ScannerConnect.py	mandatory
Lock Scanner Node	LockScannerNode.py	mandatory
UD Unique ID check	UDUniqueIDCheck.py	mandatory
Check Scan File Existence	CheckScanFileExistence.py	optional
Upgrade Scanner	UpgradeScanner.py	mandatory
Run Scanner	RunScanner.py	mandatory
Check Scanner Finished	CheckScannerFinished.py	optional
Download Scan File	DownloadScanFile.py	mandatory
Remove Scan Data	RemoveScanData.py	optional
Unlock Scanner Node	UnlockScannerNode.py	optional
Wait XML Enricher Process	WaitEnricherProcess.py	mandatory
Parse Enriched Scan File	ParseEnrichedScanFile.py	mandatory

Final Step Module
ReleaseResources.py

Adapter Parameters

Parameter	Default Value	Description
DownloadScanFileBeforeExecution	true	Specifies whether to download the scan file from the remote machine before execution.
IsPrePostScriptAllowed	false	Specifies whether to allow scanners to run pre-scan or post-scan scripts.
IsScannerDowngradeAllowed	true	Specifies whether the scanner downgrade is allowed.
IsScannerUpgradeAllowed	true	Specifies whether the scanner upgrade is allowed.
MappingConfiguration		Specifies scan file model mapping configurations.
P2PServerPorts	*	Only processes connected to these ports (as client or server) are discovered, together with this port. This parameter can include a number or a known name. You separate entries with commas. An asterisk (*) signifies all ports.
PrePostScriptExecTimeout	5	The Pre-scan or post-scan script maximum runtime (in minutes).
RemoveScanData	false	Specifies whether to remove the scan data on the remote host after it was downloaded on the Data Flow Probe machine.
ScannerConfigurationFile		Specifies the configuration file name that should be uploaded with the scanner and used for the scanner execution.
ScannerLogLevel	info	The scanner log level. This parameter can be info, debug, or trace.
collectIPv6Connectivity	false	Specifies whether to collect the IPv6 related connectivity.
discoverPorts	false	Specifies whether to discover TCP and UDP ports. If true, TCP ports with the listening or established status and all UDP ports are reported. Note If this parameter is enabled, UD Full (UDF) license is required instead of UD Inventory (UDI).
discoverProcesses	false	False: Processes are not reported except in the following two scenarios: If you set the discoverP2P parameter to true, the processes that are related to TCP connections are reported regardless of the discoverProcesses parameter value. If you set the discoverRunningSW parameter to true, the processes that are related to the running software are reported regardless of the discoverProcesses parameter value. (The running software is specified in the applicationsSignature.xml file). True. All processes are reported. Note If this parameter is enabled, UD Full (UDF) license is required instead of UD Inventory (UDI).
discoverRunningSW	Microsoft Hyper-V Hypervisor, VMware VirtualCenter, Virtualization Layer Software	Determines which running software should be reported.
discoverWPAR	false	Specifies whether to report IBM Workload partitions (WPARs). Note If this parameter is enabled and WPARs are discovered, UD Full (UDF) license is required instead of UD Inventory (UDI).
enableStamping	true	Determines whether ud_unique_id is stamped on the managed computer.
filterP2PProcessesByName	system, svchost.exe, lsass.exe, System Idle Process	The names of the processes that are not reported. Note This parameter only affects the P2P discovery. To prevent P2P running, enter an asterisk (*) as the value.
ignoreP2PLocalConnections	false	If false, P2P discovery does not ignore local connections. That is, when a client and server are installed on the same host and the client-server relationship connects between them, P2P discovery should report this relationship.
onlyStampingClient	true	Determines whether to only stamp the client machine. If false, both data-center and client machine are stamped.
udaConnectionOrder	first	The position of UD in the order of protocol connections. Possible values are: first, last, and none.
uploadScannerToAgentPath	true	Specifies whether to upload scanner to the installation path of UD agent. Note This parameter is only for Windows and eligible when Universal Discovery Protocol is used.