Configure Telecommunications Discovery (TSOM) Patterns

  • Release version: Yokohama
  • Updated January 30, 2025
  • 2 minutes to read

    • This document outlines the dependencies, requirements, and installation steps necessary for setting up Telecommunications Discovery Patterns (also known as TSOM Patterns) in TSOM Visibility in ServiceNow®.

    Before you begin

    To use Telecommunications Discovery Patterns, you need a subscription to TSOM.

    Role required: admin

    Request apps on the Store

    Visit the ServiceNow Store website to view all the available apps and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.

    Dependencies and Requirements

    • Telecom Service Operation Core (sn_tsom_core)
    • Discovery Core plugin (com.snc.discovery.core), which is automatically installed by Discovery.
    • ITOM Discovery License plugin (com.snc.itom.discovery.license). You must activate this plugin.
    • ITOM Licensing plugin (com.snc.itom.license). For more information, see Request Discovery.

    TSOM Visibility Installation Disclaimer

    See TSOM Visibility Installation Disclaimer for important information and requirements related to the installation process.

    Install Horizontal Discovery and Telecommunication Discovery Patterns

    The process of obtaining and installing the Telecommunications Discovery Patterns in TSOM.

    Before you begin

    Role required: admin

    Procedure

    1. Install the Horizontal Discovery application.
      See Discovery setup, as it is foundational for running Telecommunications Discovery Patterns.
    2. Obtain and install Telecommunications Discovery Patterns:
      1. Install the Telecommunications Discovery Patterns (sn_tsom_patterns) from the ServiceNow® Store.
    3. Set up a MID Server and synchronization Patterns:
      1. Synchronization the installed patterns with the appropriate MID Servers to confirm they’re ready for use:
        1. Navigate to Discovery > MID Servers.
        2. Select Pattern Sync to Mid.
        Note:
        This action synchronizes both TSOM and ITOM patterns.

        For more information on how to configure a MID Server, see Configuring MID Server.

    4. Configure TSOM System Properties:
      1. Set the system property sn_tsom_patterns.itom_pattern_enabled to define the logic for whether to use only the TSOM Pattern or a combination of ITOM and TSOM patterns.
        1. Navigate to All > System Properties > All Properties.
        2. Select sn_tsom_patterns.itom_pattern_enabled.
        3. Check that the Value is set to true (default).

        If you want TSOM to run only TSOM patterns and exclude ITOM patterns, set the Value to false.

        Note:
        The default setting is configured to use both TSOM and ITOM patterns.
    5. Enable the replacement of various ITOM patterns with TSOM patters on a specific MID Server:

      For example: The Telecom Router pattern replaces the Network Router pattern for a specific MID Server when mid.telecom.discovery.patterns.enabled is set to true for that MID Server.

      1. Go to the Filter Navigator and type ecc_agent_config.list.
      2. Select mid.telecom.discovery.patterns.enabled (each MID Server has this parameter).
      3. Check that the Value is set to true.

      Repeat this configuration for each MID Server that you want to use for running TSOM patterns.

    TSOM Visibility Installation Disclaimer

    In order to support the TSOM Visibility solution, we have modified the CMBD CI Class Models store application, introducing updates to the IRE Identification Rules for the following telecom CIs.

    For more information about CMBD CI Class Models store application, see CMDB CI Class Models.

    • Interface Cards
    • Slots
    • Subslots
    • Network Interfaces

    TSOM Visibility requires CMDB CI Class Models Version 1.69.0 (sn_cmdb_ci_class).

    If you install any of the TSOM Visibility applications (sn_sgc_altiplano_connector, sn_tsom_patterns, or the sn_tsom_core plugin), the CMDB CI Class Models store application is automatically updated (or installed) to Version 1.69.0.

    Note:
    An administrator can still upgrade the CMDB CI Class Models store application to Version 1.69.0 at their discretion, regardless of whether their Yokohama instance has TSOM Visibility or even if their instance is on a pre-Yokohama release (for example, Washington DC or Xanadu).

    IMPORTANT! If an administrator deploys CMDB CI Class Models Version 1.69.0—whether or not TSOM Visibility is installed—any customized IRE identification rules applied to one or more of the above-mentioned telecom CIs may be affected. These rules will require careful validation to ensure proper functionality.