Create a Discovery CI classification

A CI classification allows Discovery to identify and explore servers running most common operating systems, network devices when a CI Discovery is run. Create or modify CI classifications if you want classify something new that Discovery does not already find, or to trigger different identification or exploration probes.

Before you begin

Role required: admin

Procedure

  1. Navigate to Discovery Definition > CI Classification.
  2. Select the type of classification to create.
    Classifier type Description
    CIM These classifiers trigger CIM probes that identify and explore storage servers and devices.
    Process These classifiers trigger probes that identify and explore a large variety software, such as web servers and databases. See Create a Discovery process classification for instructions on creating this type of classifier.
    Process Handlers Filters that prevent the creation of duplicate CIs. See Create a Discovery process handler for instructions on creating this type of classifier.
    Scan Results CI These classifiers trigger probes that identify and explore various network devices and computers that other classifiers do not handle. These include Solaris machines, printers, IP phones, and AIX servers.
    Scan Results Application These classifiers trigger probes that identify and explore a few generic applications that other classifiers do not handle. These include mail server software discovered through IMAP and Nagios monitoring software.
    SNMP These classifiers trigger probes that identify and explore network devices, such as routers and switches.
    SNMP System OIDs The OIDs that Discovery uses to identify devices.
    UNIX These classifiers trigger probes that identify and explore computers running different flavors of UNIX-based operating systems.
    Windows These classifiers trigger probes that identify and explore computers running different versions of Windows.
  3. Click New in the list of classifications for the type you selected.
  4. Fill out the form fields (see table):
    Field Input Value
    Name Name of the configuration item (CI).
    OID SNMP system OID for matching this device. When the OID value matches that of an SNMP device, Discovery uses the information to populate the CMDB with the specified Manufacturer, Model, and Classifier.
    Operator Operator for determining how to match and SNMP OID. The choices are Is and Starts with. This field is available only for SNMP System OIDs classifiers.
    Active Enables or disables this classifier. When a classifier is disabled, the system stops classification at this level and does not launch classifiers of a lower order. For example, when the classifier for Windows 2008 Server is disabled, the system stops Discovery at this point and does not launch the Windows 2012 Server classifier.
    Order Order (sequence) in which the platform run this classifier.
    Table Table for this classification. For example, if this record classifies a Linux server, select the Linux Server [cmdb_ci_linux_server] table.
    Classifier Classification of an SNMP device, such as A10 Load Balancer. This field is available only for SNMP System OIDs classifiers.
    Relationship type Type of relationship for this classifier, such as Runs on::Runs. This field is available only for application and process classifiers.
    Match criteria Criteria that must match to classify this device. The choices are Any of the parameters or All of the parameters.
    Manufacturer Name of the manufacturer of a network device. This field is available only for SNMP and SNMP System OIDs classifiers.
    Model Model number of a network device. This field is available only for SNMP and SNMP System OIDs classifiers.
    On classification script Script that runs if classification criteria are met. Use this script to perform any special tasks after a device is classified. It is possible to use the g_probe_parameters hashmap from within a classification script to set probe parameters for any configured, triggered probes. For example, this code sets a 'node_port' parameter to 16001 for all triggered probes:
    (JS), g_probe_parameters['node_port'] = 16001; //
    Related lists
    Classification Criteria Criteria formed from specific parameters and the values that they must contain to match devices that Discovery finds in the network with CIs in the CMDB. See Discovery classification parameters for a list of the parameters you can use for the criteria.
    SNMP OID Classifications Unique fingerprints of all the SNMP devices that ship with the base Discovery product. Users can add OIDs for SNMP devices not in this list. This related list is available only for SNMP devices.
    Triggers probes Probes that Discovery launches to identify and explore detailed information about a CI that it has classified in the network. If you want to use patterns for horizontal discovery, add the Horizontal Pattern probe in the Probe column, and then specify your pattern in the Pattern column.
    Warning: Do not specify your pattern in Probe column. You must chose the Horizontal Pattern probe, which launches the specified pattern.
    Versions Lists versions of this classifier. A new version is created whenever you modify the classifier record. To revert to a previous version, open that record and select Revert to this version under Related Links.
  5. Right-click the header and select Save.
  6. (Optional) Use the Classification Criteria related list to create criteria that determines when the probes in the Triggers Probes related list are launched.
    1. Click New.
    2. Type in the appropriate parameter, select an operator, and enter a value to use for this classification. Operators include:
      Table 1. On Classification script objects
      Parameter Description
      isNode Indicates if this instance is a node.
      type Returns the classification windows.
      isVIP Indicates if this CI is a virtual machine, with a virtual IP address.
      ip_address Returns the IP address of the device being discovered.
      name Name of the Windows version, such as Windows 2003 Standard.
      regex matches Use this operator to create a regular expression to conduct a complicated search on a string.
      in IPs Find a single IP address in an IP address range, network or list. Possible formats are: 10.10.10.0 - 10.10.10.255; 10.10.10.0/24; or 10.10.10.0, 10.10.10.1, 10.10.10.2.
    3. Click Save to return to the Classification form.

Example

This example shows a completed CI classification form with exploration probes defined. For instruction on creating probes, see Discovery probes and sensors. The probes defined here are launched when the device is properly classified, unless Discovery is configured to stop after classification.
Figure 1. Discovery classification form
Discovery classification form

What to do next

Run a CI type discovery through the Discovery Schedule.