PDF generated using the open source mwlib toolkit. See http://code.pediapress.com/ for more information.PDF generated at: Fri, 14 Mar 2014 19:03:35 PST
Discovery ImprovementsEureka Release
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
1CIM Discovery
CIM Discovery
OverviewCIM probes can explore any device based on the Common Information Model (CIM) by querying a CIM server, alsoreferred to as a CIMOM - Common Information Model Object Manager. By default, Discovery uses CIM probes toexplore storage systems as well as to get the serial numbers of ESX servers. This feature is available starting with theBerlin release.
ArchitectureThe following components are part of CIM: Common Information Model (CIM): CIM [1] allows multiple parties to exchange information about managed
elements. CIM represents these managed elements and the management information, while providing themechanism to actively control and manage the elements.
Storage Management Initiative Specification (SMI-S): SMI-S [2] is a standard of use that describes methods forstorage discovery on the vendor's side. ServiceNow uses SMI-S to determine how to discover CIM. SMI-S isbased on the Common Information Model (CIM) and the Web-Based Enterprise Management (WBEM)standards, which define management functionality via HTTP. The main objective of SMI-S is to enablemanagement of dissimilar storage products. ServiceNow supports SMI-S version 1.5 or higher.
Web-Based Enterprise Management (WBEM): WBEM [3] defines a particular implementation of CIM,including protocols for discovering and accessing each CIM implementation.
Service Location Protocol (SLP): SLP [4] is an ad hoc protocol for retrieving and associating configurationinformation about CIM servers, such as default paths, capabilities, and the exact interop namespace [5].ServiceNow Discovery retrieves the interop namespace of a CIM server via SLP and passes that information tothe CIM Classify probe. SLP, referred to here as the SLP server, uses service agents (SA) to gather anddisseminate information about a CIM server on a subnet. A subnet can have multiple service agents.
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
CIM Discovery 2
How CIM Discovery Works1. Shazzam launches the wbem port probe.2. The wbem port probe detects activity on target ports SLP 427, CIM 5989 and 5988, and then examines the
Service Registry Queries related list, at Discovery Definition > Port Probes, for the SLP query. The basesystem provides this query is provided to detect the service:wbem service type, which indicates the presence ofan SLP server.
3. Shazzam launches a scanner for this service type.The scanner retrieves the attributes of the service from the SLP server, including the interop namespaces [5] ofCIM servers in the network, and appends the values it finds to the port probe results.
4. The wbem port probe appends the SLP data it carries to the CIM Classify probe.5. The CIM Classify probe uses that information to explore the CIM servers.
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
CIM Discovery 3
wbem Port ProbeThe wbem probe stores the data it retrieves in the CIM Classification [discovery_classy_cim] table. The wbem portprobe is defined in Discovery Definition > Port Probes.
SLP QueryThe SLP query detects the wbem service (service:wbem) on an SLP server and gathers the attributes of the service.The SLP query is defined in the Service Registry Queries related list in the wbem port probe record (DiscoveryDefinition > Probes).
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
CIM Discovery 4
CIM Classify ProbeThe wbem port probe appends the SLP data it carries to the CIM Classify probe before launching it. The CIMClassify probe extracts VMware ESX serial numbers and connector relationships between the SAN and NAScomponents from CIM Servers in the network.
To access the CIM Classify probe, navigate to Discovery Definition > Probes.
References[1] http:/ / en. wikipedia. org/ wiki/ Common_Information_Model_(computing)[2] http:/ / www. snia. org/ tech_activities/ standards/ curr_standards/ smi[3] http:/ / en. wikipedia. org/ wiki/ Web-Based_Enterprise_Management[4] http:/ / en. wikipedia. org/ wiki/ Service_Location_Protocol[5] http:/ / sfdoccentral. symantec. com/ ccstor/ 5. 1. 1/ win_unix/ html/ cc_hscg/ apas01. htm
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
CIM Probe 5
CIM Probe
OverviewThe CIM probe uses WBEM protocols to query a particular CIM server, the CIM Object Manager, for a set of dataobjects and properties.
ParametersThe following parameters may be passed to the CIM probe:
Parameter Description Default Value
source The initial host to connect to. required
port The port to connect to. If empty, the value is determined by the "schema" parameter: http = 5988, https =5989.
none
schema The schema to use: '"http"' or '"https"'. required
namespace The CIM namespace. May be overridden by query. required
queries A semicolon-delimited list of CIM probe queries to process and return results for. required
retries The number of times to retry a query if it fails due to network connectivity issues. 2
connection_timeout The number of milliseconds to wait on each attempt to connect to a server. 5000
socket_timeout The number of milliseconds to wait to read data. 5000
Parameter is internal use only. Not supported.
Query LanguageThe CIM probe query language (CimIQL) uses keys, filters, and dot-walking to traverse the CIM schema.
Parameter ExpansionThe CIM query language supports standard SNC preprocessed probe parameter expansion. Place variables in queriesby encapsulating their names like this:
${foobar}.CIM_RunningOS[0].Name
CIM_ComputerSystem.${barfoo}
The text ${foobar} is replaced with the contents of the foobar probe parameter passed to the CIM probe;likewise for barfoo.
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
CIM Probe 6
Enhancements
Eureka Provides improved support of CIM probes with the CimIQL queries.
CimIQL
CimIQLCimIQL (short for CIM Intermediate Query Language, pronounced "simickle") is an intermediate languagedesigned to simplify the process of querying CIM providers. It currently supports the standard WBEM protocolstack, but others, such as WS-MAN, may be added in the future.The query language syntax borrows from elements of Microsoft's WMI query language and Unix's 'wbemcli'command.The CimIQL library is a pure-Java implementation.
SyntaxThe end-user provides CimIQL with a valid statement, which contains multiple queries, delimited by the period .character. A query represents a single high-level protocol-independent request.Each query is comprised of nested language components and sub-components known as tokens. A token describes aspecific lexical aspect of the CimIQL syntax.The first token of each query must be an operation token, which represents the overall logical operation to beperformed.Each query is paired with a result, which is then provided as input to the next query in the statement. A result iscomprised of a set of objects and their properties.
Operation TokensEach of the following core operations has a counter-part in the CIM Operations over HTTP [1] standard: Get Object (GetInstance) Enumerate Objects (EnumerateInstances) Enumerate Associated Objects (Associators) Method Call (extrensic MethodCall)The following are "psuedo-operation" tokens that act as no-op placeholders: Substitution (references the results of a named statement)
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
CimIQL 7
Get Object Token
{,,...}
Retrieves a single object of a specific class by specifying all of its unique keys (as key tokens) and any optionalparameter tokens, separated by commas.The classname is the case-sensitive CIM class name of the desired object. By default, objects of the specified classand of any extended classes are retrieved.The key and parameter tokens are enclosed by a single pair of curly brackets { ... }.This token must only be used as the first query in a statement.
Enumerate Objects Token
{{,,...}}
OR
Retrieves objects that match a set of condition tokens and parameter tokens.The condition tokens and parameter tokens are enclosed by two pairs of curly brackets {{ ... }}. The curly bracketsare optional if there are no conditions or parameters necessary, as shown in the second format.The classname is the case-sensitive CIM class name of the desired objects. By default, objects of the specified classand of any extended classes will be retrieved.The index token is optional.This token must only be used as the first query in a statement.
Enumerate Associated Objects Token
{{,,...}}
OR
Retrieves objects associated with each result from the preceding query.The condition tokens and parameter tokens are enclosed by two pairs of curly brackets {{ ... }}. The curly bracketsare optional if there are no properties filters or parameters necessary, as shown in the second format.The association classname is the name of the many-to-many or one-to-many class that associates two objectstogether. By default, objects of the specified class and of any extended classes will be retrieved.The parameter token, ResultClass, may be specified to filter results based on the resulting objects' classname.The index token is optional.This token must not be used as the first query in a statement.
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
CimIQL 8
Method Call Token
(,...)
Calls a method on each object of the preceding query's result set.The method name is the name of a valid method of each preceding result object.
Substitution Token
${}
A no-op token that feeds the results of a previous named statement as input into the next query of its own statement.
Internal Method Call Token
_(,...)
Calls an internal method on each object of the preceding query's result set. Internal methods are defined by CimIQLand do not necessarily involve communication with the server.The internal method name is prefixed with an underscore character.
Component TokensThe following tokens are sub-components of operation tokens.
Properties Token
*
OR
,,...
Specifies which properties are to be returned for each object of the final result set.The wildcard * returns all properties available. Otherwise, each property name desired is provided within acomma-separated list.This token is required at the end of each statement.
Query Delimiter Token
.
Separates queries.
Index Token
[index]
Reduces a preceding query's results to a single object at the specified integer index.This token is always optional.
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
CimIQL 9
Key Token
=''
Matches an object property designated as a key by exact value.The key name is the name of the property used as a key.
Condition Token
Matches a single property of an object, conditionally.The property name is the name of the property to match against.The conditional operator determines how the property's actual value is compared to its expected value. Theoperators available are equality (=) and inequality (!=).The enclosed value should be one of the following: Literal value enclosed in single-quotes ' ... '. E.g., foo='bar' Regular expression, enclosed by a pair of slashes / ... /. E.g., foo=/bar.*/
Parameter Token
:''
Passes a parameter by parameter name to the operation being called. The parameter may be consumed duringCimIQL pre-processing or by the CIMOM via request, depending on the parameter.
ExamplesA tutorial by example. Each example builds on the last ...
CIM_ComputerSystem[0].*
Retrieves the first result of all instances of CIM_ComputerSystem and its descendants. Retrieves all properties.
CIM_ComputerSystem.PrimaryOwnerContact
Retrieves all instances of CIM_ComputerSystem and its descendants. Retrieves only one property,PrimaryOwnerContact.
CIM_ComputerSystem{CreationClassName='Linux_ComputerSystem',Name='runtime'}.*
Retrieves a single unique instance of CIM_ComputerSystem and its descendants. All keys must be specified withinthe { } identity token. Key format is provided as PropertyName='VALUE", comma-separated between multiplekeys.
CIM_ComputerSystem{{Name!='runtime'}}.*
Retrieves one or more instances of CIM_ComputerSystem and its descendants - all that do not have Name propertyof 'runtime'. The filter token filters out instances that do not contain all of the properties/keys specified. Filter tokenswork similar to the identity token { }, with a few differences: The not-equals operator != can be used (as well as the equals = operator).
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
CimIQL 10
Both keys and properties can be specified. Slower and more resource-intensive than using the { } identity tokens. Regex can be used. See below.
CIM_ComputerSystem{{Name=/^run.*$/}}.*
Retrieves one or more instances of CIM_ComputerSystem and its descendants - all that have a value matching theregex contained within the / / characters. Note that the single quotations are not used for regex.
CIM_ComputerSystem{{Name='runtime'}}[2].*
Retrieves the second result of all instances of CIM_ComputerSystem and its descendants filtered. Matches allinstances that have a property Name of 'runtime'. Note the order of operations follows the query syntax ...1. Query server for all CIM_ComputerSystem and descendants.2. Filter results based on Name property.3. Retrieve the second instance that passed the filter.
CIM_ComputerSystem.CIM_RunningOS[0].Name
Retrieves the Name property for first CIM_OperatingSystem of each CIM_ComputerSystem. The middle-token,CIM_RunningOS, is the name of the Associator class, not the end-result.
CIM_ComputerSystem.CIM_RunningOS{{Name=/CentOS/}}[0].Name
The same as above, except that each CIM_OperatingSystem found is then filtered by its Name property (containing'CentOS').
ResultsResults can be transformed to XML, with extendibility to other formats in the future.
XMLA commented example:
CIM_ComputerSystem[0].PrimaryOwnerContact
Linux_ComputerSystem
CimIQL 11
Within here, each key is provided as VALUE with the VALUE
enclosed as CDATA. -->
References[1] http:/ / www. dmtf. org/ sites/ default/ files/ standards/ documents/ DSP0200_1. 3. 1. pdf
Data Collected by Discovery on Storage Devices
OverviewDiscovery uses CIM probes to explore storage systems based on the Common Information Model (CIM) anddetermine the relationships between Storage Area Network (SAN) and Network-Attached Storage (NAS)components. The CIM probe uses WBEM protocols to query a particular CIM server, the CIM Object Manager, for aset of data objects and properties. See CIM Discovery.
Tables and FieldsDiscovery uses the following tables and fields for storage devices.
Label Table Name Field Name Source
Sys ID Storage Disk [cmdb_ci_stoarge_disk] sys_id N/A
File Share ID Storage File Share [cmdb_ci_storage_fileshare] fileshare_id CIM probe
Path Storage File Share [cmdb_ci_storage_fileshare] path CIM probe
Disk space (GB) Storage Pool [cmdb_ci_storage_pool] disk_space CIM probe
Pool ID Storage Pool [cmdb_ci_storage_pool] pool_id CIM probe
Speed (GFC) Storage Port [cmdb_ci_storage_port] speed CIM probe
WWPN Storage Port [cmdb_ci_storage_port] wwpn CIM probe
Device ID Storage HBA [cmdb_ci_storage_hba] device_id CIM probe
Firmware version Storage Server [cmdb_ci_storage_server] firmware_version CIM probe
Disk Space (GB) Storage Volume [cmdb_ci_storage_volume] disk_space CIM probe
LUN Storage Volume [cmdb_ci_storage_volume] lun CIM probe
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
Data Collected by Discovery on Storage Devices 12
World Wide Port Name Host Bus Adapter
RelationshipsDiscovery can establish the correct relationships between an IP device and the storage device to which it attachesregardless of which device Discovery explores first. Discovery maps the local World Wide Name (WWN) [1] porton the IP device to the fiber channel port on the storage device to establish the relationship between the volume onthe IP device and the correct pool on the storage device. This diagram illustrates the process flow.
References[1] http:/ / www. tech-faq. com/ world-wide-name-wwn. html
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
13
Probe Results Cache
Probe Results Cache
OverviewDiscovery probes and sensors perform data collection and processing tasks. The probe collects the information andthe sensor processes it. Both get their instructions from the ECC queue. There is a worker job on the MID Server thatmonitors the queue for work. The monitor checks for any entries where the Queue is output and the State is ready.
The MID Server then processes all the outputs, runs the necessary probes, and returns the probes results to the ECCqueue. These results are put in the ECC Queue as input entries.
After an entry is inserted in the ECC Queue table, a Business Rule fires (on insert) that takes that information andruns it through a sensor processor. The sensor processor's job is to take the input data, find any sensors interested inthat data, and pass it along to be processed. Those sensors ultimately update the CMDB.For tips and instructions for creating your own custom probes and sensors, visit the ServiceNow community [1].
ProbesProbes are launched by the MID Server to collect all the information that you want returned from a device. Forexample, the base ServiceNow system has probes to get the names of Windows and Linux devices, and separateexploration probes that return disk information for devices with those operating systems. View each probe's resultsin the ECC queue, which displays specifics such as the time the probe ran and its payload. For each probe, you mustalso create a sensor to process the data that the probe returns. To view existing probes, navigate to Discovery >Discovery Definition > Probes.The Probe form provides the following unique fields.
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
Probe Results Cache 14
Field Description
Probe type Select the probe for the operating system of the device it will query.
CIM Probe: Select this probe type to query a CIM server using WBEM protocols. Multiprobe: Multiprobes can run one or more simple probes of any type or mix probes of different types. This type of probe can
make several queries simultaneously that return all the results at the same time. You cannot add multiprobes to other multiprobes. Probe: Select this generic probe type to define a probe class. Specify the name of the probe class in the ECC queue topic field. SNMP Probe: Select this probe type for network devices, such as routers. WMIRunner Probe: Use this probe type for Windows devices.
ECC queuetopic
Enter a descriptive term for the function of the probe. The probe uses this label as the Topic field for incoming ECC queue messages.The term does not have to be unique. For example, all the UNIX probes might have an ECC queue topic value of SSHCommand.
By default, ServiceNow probes use the following ECC queue topics:
CimProbe Multiprobe Powershell SCPRelay SSHCommand SNMP WMIRunner
ECC queuename
Enter either a descriptive name for human use, or the actual command the probe is to run. For example, if the value in the ECC queuetopic field is SSHCommand, then enter the actual shell command to run in this field.
CacheResults
Cache this probe's results in the probe results cache (starting with the Eureka release).
Setting Probe ParametersUse probe parameters to control the behavior of a particular probe every time it is triggered.1. Create or select the probe you want to set parameters for.2. From the Probe Parameters related list, click New.3. Create a probe parameter record (see table).The Probe parameter form has the following fields.
Field Description
Name Enter the parameter name. See the probe reference page for a list of available parameters.
Value Enter the parameter value or script.
Value script [Optional] Enter the script you want the parameter to run if you have not already specified a script in the Value field.
Probe Displays the probe this parameter relates to.
Global ParametersThe following parameters are available for all probe types.
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
Probe Results Cache 15
Parameter Description
payload_max_length Specifies the maximum string length of probe results that the MID Server will send to the instance for probes where the Usedby Discovery field is true. The MID Server verifies the size of the results before sending them to the instance. If the resultsexceed the limit, the MID server discards the results and returns a warning message. This parameter is available starting withthe Eureka release.
Type: integer (characters) Default value: 5000000
source [Required] The initial host to connect to.
Type: string (URL) Default value: None
Probe Results CacheThe probe results cache improves overall discovery performance by caching probe results on the instance and onlyprocessing results that have changed. The results of probes that have not changed do not need sensor processing andtherefore do not run. The cache can be enabled or disabled for individual probes. The probe results cache is availablestarting with the Eureka release.
Enabling and Disabling the Cache for Specific ProbesIf you have created probes, you can turn on the cache individually by enabling the Cache Results field for that probe.The probe results cache should be enabled only for those probes and sensors whose output is unlikely to change. Forexample, the Linux CPU sensor is cached because CPU information seldom changes. The cache is turned on bydefault for base system probes and sensors whose output is unlikely to change.
Warning: Do not turn on the cache for classification and identification probes. Furthermore, do not turn on the cache for probesthat trigger additional probes because this may prevent them from being triggered.
SensorsEvery probe in Discovery must have a corresponding sensor to process the data returned. For example, if incomingdata is the result of a WMI probe, then the WMI sensor is triggered to process the payload.
Note: If you create a multiprobe, you must create a multisensor to process the data returned from this probe. For details, seeMultiprobes and Multisensors.
To view the list of sensors in the system, navigate to Discovery > Discovery Definition > Sensors.The sensor form provides the following unique fields.
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
Probe Results Cache 16
Field Description
Reacts to probe Select the probe whose payload this sensor must process.
Condition script Create a predetermined requirement for this sensor to run.
Sensor Type[sys_class_name]
Select the type of sensor to create:
Import Export Map: This option is not currently used. MultiSensor: Multisensors process the data returned from multiprobes. Select this type to create a multisensor that
responds to the simple probes used in a multiprobe. Sensor: Select this type if this sensor is a simple sensor that responds to a simple probe.
Sensor type[sensor_type]
Specify how the answer from the probe is processed.
Classifier: This field is not currently used. Java: This field is not currently used. Javascript: Returned data from the probe is processed in the sensor itself, outside the application, and is visible to the
user. This is the most common sensor type. Multiline Text: This field is not currently used. XML: The XML data from the probe is broken into pieces. Some pieces can be used to launch other probes that the
original sensor needs to complete all the necessary information about a device.
Script Enter a script to run when processing the probe package. You can use the g_probe_parameters hashmap in a sensorscript to set probe parameters for any configured, triggered probes. For example, this code sets a 'node_port' parameter to16001 for all triggered probes.
g_probe_parameters['node_port'] = 16001;
Multiprobes and MultisensorsMultiprobes contain one or more simple probes configured to extract specific information from manageable devicesby executing multiple queries with a single authentication. You can schedule multiprobes to run any time in thediscovery process to make exploration more efficient. One common use for multiprobes is as identity probes.Identity probes ask a device for information such as its name and serial number, and then use the results of thosequeries to update existing CIs in the CMDB.To process the data returned from a multiprobe, you must create multisensors, which run scripts that process the datareturned by the multiprobes. Multisensors typically use the same name as their corresponding multiprobes.
Creating Multiprobes1. Navigate to Discovery > Discovery Definition > Probes.2. Click New.3. Complete the form using the following settings:
Probe type: Multiprobe. ECC queue topic: MultiProbe.
4. In the Includes probes related list, add the probes you want to include in the multiprobe.5. Click Save.
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
Probe Results Cache 17
Adding Simple ProbesAdd simple probes to your multiprobe in the Includes Probes related list. You can add simple probes of any type toa multiprobe and mix probe types if necessary.
Warning: Do not add a multiprobe to the Includes Probes related list.
MultiProbe record
To add simple probes, do one of the following: Click Edit to add existing simple probes to the multiprobe. Move
the appropriate simple probes into the Includes probes List. Click New to create a new simple probe for the multiprobe. This is
an advanced procedure and requires a strong knowledge ofJavaScript.
Editing the list of included probes
Multiprobes Included with ServiceNow
The following multiprobes are included with the base ServiceNowsystem. The corresponding multisensors have the same names.
Multiprobe Includes These Probes
AIX - ADM AIX - Active Processes: Gets active running processes Unix - Active Connections: Retrieves active connections information
AIX - Identify AIX - Network: Determines network interfaces, IPs, and MACs AIX - Serial Number: Retrieves the AIX serial number
CIM - SMI-S - Identity CIM - SMI-S - Computer System: Gets a CIM Computer System per SMI-S
HP-UX - ADM HP-UX - Active Processes: Gets active running processes Unix - Active Connections: Retrieves active connections information
HP-UX - Identify HP-UX - Hardware Serial Number: Retrieves HP-UX serial number HP-UX - Network: Retrieves HP-UX networking information
Linux - Identify Linux - Hardware Information: Gets DMI (BIOS) information Linux - Network: Gets network information
Mac OS X - Identify Mac OS X - Network: Gathers network information from Macintosh machines Mac OS X - CPU/Memory: Gathers CPU and memory information from Macintosh machines
SNMP - Identify SNMP - Identity Info: Identifies a printer CI
SNMP - Load Balancer -Identity
SNMP - F5 BIG-IP - Identity - Serial: Retrieves the BIG-IP chassis serial number, which is globally uniquefor this vendor
SNMP - Identity Info: Identifies an SNMP device
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
Probe Results Cache 18
Solaris - ADM Solaris - Active Processes: Gets active running processes Unix - Active Connections: Retrieves active connections information
Solaris - Identify Solaris - Network: Gets network information about Solaris devices Solaris - Serial Number: Gets the serial number for Solaris devices
Unix - ADM Unix - Active Processes: Gets active running processes Unix - Active Connections: Retrieves active connections information
UNIX - Classify ESX - OS: Identifies ESX machines UNIX - OS: Runs after the ESX - OS probe to determine the operating system for SSH devices not identified
as ESX
Windows - ADM Windows - Active Processes: Gets active running processes Windows - Active Connections: Retrieves active connections information
Windows - Identify Windows - Network: Probes a Windows machine for network information Windows - OS/Hardware Information: Probes a Windows machine for WMI information
Note: This probe requires the installation of a command line tool from Oracle called SNEEP. To download andinstall this tool, log in to the Oracle website [2]. After this tool is installed, the serial number probe runs automaticallywhen Discovery detects a Solaris device.
Creating MultisensorsTo create a new multisensor, navigate to Discovery > Discovery Definition > Sensors, and then click New. TheMultiSensor form provides the following unique fields:
Field Description
Reacts toprobe
Select the probe whose payload this sensor must process.
Conditionscript
Create a predetermined requirement for this sensor to run.
Sensor Type Select MultiSensor.
Sensor type Specify how the answer from the probe is processed.
Classifier: This field is not currently used. Java: This field is not currently used. Javascript: Returned data from the probe is processed in the sensor itself, outside the application, and is visible to the user. This
is the most common sensor type. Multiline Text: This field is not currently used. XML: The XML data from the probe is broken into pieces. Some pieces can be used to launch other probes that the original
sensor needs to complete all the necessary information about a device.
You must configure the sensor to process the data returned from the individual probes in the multiprobe. Scroll downto the Responds to Probes related list and click New. Define the scripts that process the multiprobe data using thefollowing unique fields.
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
Probe Results Cache 19
Field Description
Reacts toprobe
Select the probe within the multiprobe that this sensor reacts to. The sensor must be linked to the probe by function, such as networkidentification or serial number.
Script Enter a script to run before the script in the multisensor. This script defines how the data returned from each probe should beprocessed.
The Responds to Probes related list contains two separate links. The first link opens the record for the probe thissensor responds to. The link in the Script column opens the record that defines the sensor's response to the probe.
Enhancements
Eureka Provides improved probe performance by caching probe results on the instance and only processing results that
have changed. Provides a global probe parameter to set the maximum probe payload size.
References[1] http:/ / community. service-now. com[2] https:/ / login. oracle. com/ mysso/ signon. jsp
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
Article Sources and Contributors 20
Article Sources and ContributorsCIM Discovery Source: http://wiki.servicenow.com/index.php?oldid=209605 Contributors: Cheryl.dolan, Roy Laurie, Steve.wood, Vaughn.romero
CIM Probe Source: http://wiki.servicenow.com/index.php?oldid=210323 Contributors: Cheryl.dolan, George.rawlins, Vaughn.romero
CimIQL Source: http://wiki.servicenow.com/index.php?oldid=210108 Contributors: Roy Laurie, Vaughn.romero
Data Collected by Discovery on Storage Devices Source: http://wiki.servicenow.com/index.php?oldid=214980 Contributors: Vaughn.romero
Probe Results Cache Source: http://wiki.servicenow.com/index.php?oldid=214881 Contributors: Cheryl.dolan, Chris.nguyen, George.rawlins, Vaughn.romero
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
Image Sources, Licenses and Contributors 21
Image Sources, Licenses and ContributorsImage:CIM_SMI-S_Standard_Diagram.png Source: http://wiki.servicenow.com/index.php?title=File:CIM_SMI-S_Standard_Diagram.png License: unknown Contributors: Steve.woodImage:CIM_Agents_Diagram.png Source: http://wiki.servicenow.com/index.php?title=File:CIM_Agents_Diagram.png License: unknown Contributors: Joseph.messerschmidt, Steve.woodImage:CIM_Shazzam_Processing_Diagram.png Source: http://wiki.servicenow.com/index.php?title=File:CIM_Shazzam_Processing_Diagram.png License: unknown Contributors:Steve.woodImage:CIM_wbem_Port_Probe.png Source: http://wiki.servicenow.com/index.php?title=File:CIM_wbem_Port_Probe.png License: unknown Contributors: Steve.woodImage:CIM_SLP_Query.png Source: http://wiki.servicenow.com/index.php?title=File:CIM_SLP_Query.png License: unknown Contributors: Steve.woodImage:Shazzam_with_CIM_Diagram.png Source: http://wiki.servicenow.com/index.php?title=File:Shazzam_with_CIM_Diagram.png License: unknown Contributors: Steve.woodImage:CIM_CLassify_Probe.png Source: http://wiki.servicenow.com/index.php?title=File:CIM_CLassify_Probe.png License: unknown Contributors: Steve.woodImage:CIM_Data_Model1_Diagram.png Source: http://wiki.servicenow.com/index.php?title=File:CIM_Data_Model1_Diagram.png License: unknown Contributors: Steve.woodImage:ECC_Queue_Output.png Source: http://wiki.servicenow.com/index.php?title=File:ECC_Queue_Output.png License: unknown Contributors: Steve.woodImage:ECC_Queue_Input.png Source: http://wiki.servicenow.com/index.php?title=File:ECC_Queue_Input.png License: unknown Contributors: Steve.woodImage:Caution-diamond.png Source: http://wiki.servicenow.com/index.php?title=File:Caution-diamond.png License: unknown Contributors: John.robertsImage:Warning.gif Source: http://wiki.servicenow.com/index.php?title=File:Warning.gif License: unknown Contributors: CapaJCImage:Discovery Multiprobe.gif Source: http://wiki.servicenow.com/index.php?title=File:Discovery_Multiprobe.gif License: unknown Contributors: Steve.woodImage:Discovery Multiprobe Edit Probes.gif Source: http://wiki.servicenow.com/index.php?title=File:Discovery_Multiprobe_Edit_Probes.gif License: unknown Contributors: Steve.woodImage:Discovery Multisensor and Script.gif Source: http://wiki.servicenow.com/index.php?title=File:Discovery_Multisensor_and_Script.gif License: unknown Contributors: Steve.wood
CONCEPT RELEASE NOT FOR USE IN PRODUCTION Features in the release may or may not be productized
CIM DiscoveryCIM DiscoveryOverview Architecture How CIM Discovery Works wbem Port Probe SLP Query CIM Classify Probe
CIM ProbeOverview Parameters Query Language Parameter Expansion
Enhancements Eureka
CimIQLCimIQLSyntaxOperation TokensGet Object TokenEnumerate Objects TokenEnumerate Associated Objects TokenMethod Call TokenSubstitution TokenInternal Method Call Token
Component TokensProperties TokenQuery Delimiter TokenIndex TokenKey TokenCondition TokenParameter Token
Examples
ResultsXML
Data Collected by Discovery on Storage DevicesOverview Tables and Fields Relationships
Probe Results CacheProbe Results CacheOverview Probes Setting Probe Parameters Global Parameters Probe Results Cache Enabling and Disabling the Cache for Specific Probes
Sensors Multiprobes and Multisensors Creating Multiprobes Adding Simple Probes
Multiprobes Included with ServiceNow Creating Multisensors
Enhancements Eureka
Top Related