Installed with Service Mapping

Several types of components are installed with Service Mapping.

Tables installed with Service Mapping

Service Mapping adds the following tables.
Table Description
Applicative Credentials

[sa_applicative_credentials]

Contains credentials used when running application-specific commands on servers.
BaseLines

[sa_baselines]

Contains storing points in the time defined as baselines for business services.
Business Service User preferences

[sa_business_service_user_prefs]

Contains user preferences associated with a specific business service.
Service Mapping CI attributes

[sa_ci_attr]

Contains CI attributes relevant only for discovery process.
Related CI Types

[sa_ci_to_pattern]

Assigns CI types to patterns (relevant only for the horizontal discovery performed by Discovery).
Menu Action

[sa_context_menu]

Contains data on configurable menu options for CIs in the business service map.
Pattern Debugger Session

[sa_debug_session]

This internal table is used for the Pattern Designer components.
Pattern Debugger Session Status for UI

[sa_debug_session_status]

This internal table is used for the Pattern Designer components.
Sa Deferred Service Discovery

[sa_deferred_service_discovery]

This internal table is used for Service Mapping components.
Service Discovery Log

[sa_discovery_log]

Contains discovery logs collected by Service Mapping.
Service Discovery Messages

[sa_discovery_message]

Contains messages created by Service Mapping during service discovery.
Planned Business Service

[sa_dw_business_service]

Contains data on planned services created in Service Map Planner.
Components

[sa_dw_components]

Contains data on planned components created in Service Map Planner.
Check Connectivity Result

[sa_dw_connectivity_result]

Contains data on results of connectivity test performed in Service Map Planner.
Connectivity Test

[sa_dw_connectivity_test]

Contains data on connectivity tests performed in Service Map Planner.
Planned Custom Entry Point

[sa_dw_custom_entry_point]

Contains data on planned custom entry points in Service Map Planner.
Planned Entry Point

[sa_dw_entry_point]

Contains planned entry points used in Service Map Planner.
Planned Endpoint Attributes

[sa_dw_ep_attrs]

Contains attributes of planned entry point used in Service Map Planner.
Import Errors

[sa_dw_import_errors]

Contains import errors appearing in Service Map Planner.
Phase

[sa_dw_phase]

Contains planned phases in Service Map Planner.
Validation errors

[sw_dw_validation_errors]

Contains validation errors appearing in Service Map Planner.
Sa Endpoint Status

[sa_endpoint_status]

Contains discovery status for endpoints in Service Mapping.
Find Host Scripts

[sa_find_host_scripts]

Contains the names of script includes that find hosts based on the endpoint glide records.
nfdump file

[sa_flcon_file_nfdump]

This internal table contains information used for Netflow-based discovery.
nfdump install

[sa_flcon_local_nfdump]

This internal table contains information used for Netflow-based discovery.
AWS VPC flow logs

[sa_flcon_vpc_flow_log]

This internal table contains information used for Netflow-based discovery.
SA Flow Connection

[sa_flow_connection]

This internal table contains information used for Netflow-based discovery.
Flow Connector

[sa_flow_connector]

This internal table contains information used for Netflow-based discovery.
Flow Server Communication

[sa_flow_server_comm]

This internal table contains information used for Netflow-based discovery.
Flow Services IP/Port and Statistics

[sa_flow_service]

This internal table contains information used for Netflow-based discovery.
Hash

[sa_hash]

This internal Service Mapping internal table contains temporary statuses.
Host Class to Capability

[sa_host_class_to_capability]

Maps server type to capabilities required by Service Mapping.
Infra Path To Elements

[sa_infra_path_assoc]

Contains data on components which are part of a network path.
Entry Point

[sa_m2m_service_entry_point]

Maps entry points to business service.
Mapping External Discovery Commands

[sa_mapping_ext_commands]

Contains data on customized commands created by user.
Network Paths

[sa_network_paths]

Contains data on network paths discovered by Service Mapping.
Discovered Service Notification

[sa_notification]

This internal table contains data on notifications between different parts of the software.
Horizontal Discovered Paged Payloads

[sa_paged_payload]

Service Mapping uses data in this table for splitting payload sent from the MID Server.
Discovery Patterns

[sa_pattern]

Contains preconfigured and customized patterns that Service Mapping uses for discovery.
Service Mapping Draft Pattern

[sa_pattern_draft]

Contains non-activated discovery patterns.
Service Mapping Relation attributes

[sa_rel_attr]

Contains relation attributes used during service discovery process.
Rel to Infra Path

[sa_rel_to_infra_path]

Maps relations to network or storage paths.
Service Mapping Server Usage

[sa_server_usage]

Contains count of servers used by Service Mapping.
Service Group Members

[sa_service_group_member]

Maps service group to its business service members.
File System To Storage Path

[sa_storage_paths]

Contains data on storage paths discovered by Service Mapping.
Storage Path Connectivity Map

[sa_storage_path_connectivity_map]

Maps file system to storage volume.
Business Service Group Responsibilities

[sa_svc_group_responsibilities]

Contains data on users having access to business service groups.
Traffic Based Discovery Rules

[sa_traffic_based_rules]

Contains data on configuration of traffic-based discovery.
Uploaded File

[sa_uploaded_file]

Contains data on files uploaded to the MID Server and used by Service Mapping.

Properties installed with Service Mapping

Service Mapping adds the following properties.
Note: To open the System Property [sys_properties] table, enter sys_properties.list in the navigation filter.
Property Description
sa.storage_path_calculation.active Enable storage path calculation.
  • Type: true/false
  • Default value: true
  • Other possible values: false
  • Location: Service Mapping > Administration > Properties.
sa.update_paths_in_service_model.active Update network and storage paths in Service Model.
  • Type: true/false
  • Default value: true
  • Other possible values: false
  • Location: Service Mapping > Administration > Properties.
sa.network_path_calculation.active Enable network path calculation.
  • Type: true/false
  • Default value: true
  • Other possible values: false
  • Location: Service Mapping > Administration > Properties.
sa.discovery_task_timeout_min Maximum time for a Service Mapping task in minutes (including waiting for execution in internal queues and ECC queue).
  • Type: string
  • Default value: 120
  • Other possible values: any number higher than 30
  • Location: System Property [sys_properties] table
sa.debugger.max_timeout Maximum timeout (in seconds) since the last server activity during a Pattern Debugger run.
  • Type: integer
  • Default value: 120
  • Other possible values: any number higher than 60
  • Location: Service Mapping > Administration > Properties.
sa.rediscovery.batch_size Number of discovery tasks executed in a single batch.
  • Type: integer
  • Default value: 100
  • Other possible values: any number higher than 10
  • Location: Service Mapping > Administration > Properties.
sa.traffic_based_discovery.active Traffic-based discovery
  • Type: true/false
  • Default value: true
  • Other possible values: false
  • Location: Service Mapping > Administration > Properties.
sa.traffic_based_discovery.conn_aging_time Time period in hours for a Traffic Based Connection to remain active since last discovered.
  • Type: integer
  • Default value: 72
  • Other possible values: any number higher than 24
  • Location: Service Mapping > Administration > Properties.
sa.traffic_based_discovery.ignored_ports Ports to ignore when found by traffic-based discovery.

This property is available in the System Property [sys_properties] table.

Change this property to define ports that Service Mapping ignores while performing traffic-based discovery. It makes discovery more efficient since resources are not wasted on discovering irrelevant connections.

  • Type: string
  • Default value: 445, 139, 111, 2049, 860, 3260, 135, 53
  • Other possible values: any relevant port numbers
  • Location: System Property [sys_properties] table
sa.traffic_based_discovery.max_connections Maximum number of traffic-based connections from a single CI.

This property is available in the System Property [sys_properties] table.

This property helps to keep the map size reasonable by limiting the number of possible CI connections.

  • Type: integer
  • Default value: 30
  • Other possible values: any number higher than 1
  • Location: System Property [sys_properties] table
best_practice.import_csv.max_file_size_in_kb Maximal size of CSV files in KB.

This property is used for importing business service candidates in bulk.

  • Type: integer
  • Default value: 5000
  • Other possible values: any number higher than 1
  • Location: Service Mapping > Service Planner > Properties > .
glide.ui.sa_dw_business_service_activity.fields Defines which fields are displayed for the activity feed in the Planner feature.
  • Type: string
  • Default value: *Attachments*, name, work_notes, *Email*, status, Business_service_owner
  • Other possible values: comma separated list of fields
  • Location: System Property [sys_properties] table
sa.enable_gray_out_on_resume_discovery Enable sub-tree to be grayed out after Service Mapping resumes discovery on an edge, or rerun discovery on the entire topology.
  • Type: boolean
  • Default value: true
  • Other possible values: false
  • Location: System Property [sys_properties] table
glide.service_mapping.computation_depth

This property controls the maximal depth of the business service map.

  • Type: integer
  • Default value: 25
  • Other possible values: any number higher than 1
  • Location: System Property [sys_properties] table
sa.mapping.user.manual.citype.blacklist A list of comma delimited CI types that are excluded when adding a manual CI.
  • Type: string
  • Default value: cmdb_ci_service, cmdb_ci_endpoint, cmdb_ci_hardware
  • Other possible values: CI type names
  • Location: Service Mapping > Administration > Properties > .
best_practice.import_csv.max_lines Maximal number of lines in the CSV file used to import entry points.
  • Type: integer
  • Default value: 10000
  • Other possible values: any number higher than 1
  • Location: Service Mapping > Service Planner > Properties > .
best_practice.check_connectivity.expand_listening_port This property controls which PIDs Service Mapping checks during the hop operation in the connectivity check. This property is true, then Service Mapping only checks connectivity on PIDs whose ports are in the listening state, not connected.
  • Type: boolean
  • Default value: true
  • Other possible values: false
  • Location: System Property [sys_properties] table
sa.map.enable_loops_on_service_split Enable you to connect a business service to another, already existing, business service even if the CI connection (endpoint) that you are connecting is part of this other business service. This property helps to avoid loops or cycles in service maps.
  • Type: boolean
  • Default value: false
  • Other possible values: true
  • Location: Service Mapping > Administration > Properties > .
best_practice.check_connectivity.blacklist_ips Blacklist of IP addresses to expand to in the Connectivity Checks feature.
  • Type: string
  • Default value: 127.0.0.1, 127.0.0.2
  • Other possible values: comma-separated list of IP addresses
  • Location: Service Mapping > Service Planner > Properties > .
best_practice.check_connectivity.blacklist_ports Blacklist of ports to expand to in the connectivity checks feature.
  • Type: string
  • Default value: [empty]
  • Other possible values: comma-separated list of ports
  • Location: Service Mapping > Service Planner > Properties > .
best_practice.check_connectivity.max_ips The maximum number of IP addresses to process during the connectivity check.
  • Type: integer
  • Default value: 100
  • Other possible values: any number higher than 1
  • Location: Service Mapping > Service Planner > Properties > .
service_watch.implied_match.endpoint.black_list A list of endpoint types for which Service Mapping does not apply process matching logic utilized during the top-down pattern execution.
  • Type: string
  • Default value: cmdb_ci_endpoint_ssis_mssql, cmdb_ci_endpoint_ssas_mssql
  • Other possible values: comma-separated list of endpoints
  • Location: System Property [sys_properties] table

Roles installed with Service Mapping

Service Mapping adds the following roles.
Role title [name] Description Contains roles
Service Mapping administrator

[sm_admin]

Sets up the Service Mapping application. Maps, fixes, and maintains business services. Also performs advanced configuration and customization of the product. Assign this role to application administrators.

  • [sam_core_admin.sm_admin]
  • [discovery_admin.sm_admin]
  • [itil_admin.sm_admin]
  • [personalize_dictionary.sm_admin]
Service Mapping user

[sm_user]

Views business service maps to plan change or migration, as well as analyze the continuity and availability of services. Assign this role to application users.

  • [sam_core_user.sm_user]
  • [itil.sm_user]
Service Mapping application owner

[sm_app_owner]

Provides information necessary for successful mapping of a business service. Once a service is mapped, this user reviews the results and either approves it or suggests changes. Assign the sm_app_owner role to users who own business services and are familiar with the infrastructure and applications that make up the services.

[sm_user]
Service Mapping Pattern Designer administrator

[pd_admin]

Creates new and modifies existing patterns, which Service Mapping and Discovery use for performing horizontal and top-down discovery.

[pd_user]
MID Server for Service Mapping administrator

[sm_mid]

This role allows accessing Service Mapping tables with minimal, but sufficient permissions. [rest_service]

[pd_mid]

Script includes installed with Service Mapping

Service Mapping adds the following script includes.
Script include Description
SaUploadedFiles Gets user uploaded files from the MID Server.
LoadRoutingTable Returns the routing table for the given host.
GetOutgoingPort Returns the outgoing port ID for the given host based on the target IP and next hop IP.
PatternLibrary Contains all patterns used by Service Mapping.
ParseURL Decodes encoded sys_ID attribute on DB Views.
CancelBSDiscovery Stops the discovery process of a business service.
Layer2ConnectionStrategy Creates representation of physical connections between the input host and other hosts and return the set of relation IDs.
LoadPorts Returns the list of ports for the given host.
GetPortByIP Returns the port ID of the given host associated with the given IP address.
DiscoveryHostUtils Shows a collection of functions for retrieving information about hosts. For example, it translates the CI type into the OS type.
ServiceMappingUtils Shows a collection of functions to synchronize Service Modeling with Service Mapping.

Client Scripts installed with Service Mapping

Service Mapping adds the following client scripts.
Client script Table Description
IP source change NAT

[cmdb_ci_translation_rule]

Verifies that the source IP entered during a rule change is correct.
IP Validation NAT

[cmdb_ci_translation_rule]

Validates the entered IP.
IP Target change NAT

[cmdb_ci_translation_rule]

Verifies that the new target IP entered during a rule change is correct.
Validate host TCP

[cmdb_ci_endpoint_tcp]

Validates the host attribute for the TCP entry point type.
Enable view map Business Service

[cmdb_ci_service_discovered]

If there are no entry points, this script disables the View map button on the business service form.
QBS_ISQueryDefined Technical Service

[cmdb_ci_query_based_service]

N/A
rewrite endpoint link Business Service

[cmdb_ci_service_discovered]

Displays the Edit entry point dialog box when you click an entry point link on the Entry Points tab on the Business Service form.
ShowEditPatternButton Discovery patterns

[sa_pattern]

Controls display of the Edit button in the Pattern Designer module.
Validation functions Endpoint

[cmdb_ci_endpoint]

A set of functions for validation of several attributes for different entry point types.
Remove "--None--" from OS Types Uploaded file

[sa_uploaded_file]

Prevents the value — None — from being added to the OS Types list.
Validate URL HTTP(S)

[cmdb_ci_endpoint_http]

Validates the URL attribute for the HTTP(S) entry point type.
QBS - remove options from table drop down Technical Service

[cmdb_ci_query_based_service]

Removes redundant options from the table selection list in the Technical Business Service form.
add url params Endpoint

[cmdb_ci_endpoint]

Saves data entered in the Edit entry point dialog box to the related business service.
Enable Run Discovery button Business Service

[cmdb_ci_service_discovered]

Disables the Run Discovery button on the service map page while the discovery process is running.
Validate port TCP

[cmdb_ci_endpoint_tcp]

Validates the port attribute for the TCP entry point type.
Remove "--None--" from OS Architecture Uploaded file

[sa_uploaded_file]

Prevents the value — None — from being added to the OS Architecture list.

Business Rules installed with Service Mapping

Service Mapping adds the following business rules.
Business rule Table Description
Advanced translation rule NAT

[cmdb_ci_translation_rule]

Exposes relevant fields to the advanced translation rule mode.
Basic translation rule NAT

[cmdb_ci_translation_rule]

Exposes relevant fields to the basic translation rule mode.
Translation port compatibility NAT

[cmdb_ci_translation_rule]

Verifies existence of the port field on both the source and the target.
Port validation NAT

[cmdb_ci_translation_rule]

Validates the port value.
Set Name TCP

[cmdb_ci_endpoint_tcp]

Automatically creates the name of the endpoint of the TCP type. This name has the following format: <host:port>.
Service Discovery - Device Complete Device

[discovery_device_history]

Trigger Service Mapping activities once horizontal discovery finishes to discover an IP address.
Query Based Service Table Validation Technical Service

[cmdb_ci_query_based_service]

Periodically recalculates all technical service members.
Delete business service preferences User

[sys_user]

Deletes all user preferences associated with a business service when it is deleted.
Clear CI when "CI Type" is the scope Traffic Based Discovery

[sa_traffic_based_rules]

Clears CI-related fields when CI Type is selected on the Traffic Based Discovery rules form.
Ext commands sync Mapping External Discovery Commands

[sa_mapping_ext_commands]

Synchronizes the external commands tables with the MID Server.
Change to operational status Business service

[cmdb_ci_service_discovered]

If there are no entry points, disallows changing this business service status to operational.
saListCis Global

[global]

Adds the List CIs link on the Business Service form.
MID Synchronize CI Types Dictionary Entry

[sys_dictionary]

Whenever the CI Type change, a notification is sent to the MID Server that causes it to reload the CI list to get the updates.
Validate Uploaded File Fields Uploaded File

[sa_uploaded_file]

Validates the correctness of the inserted/modified Uploaded File fields.
Prevent Duplicate and Special Chars Discovery patterns

[sa_pattern]

Prevents the insertion or modification of pattern names that have certain forbidden special characters or when the name is already used by another pattern.
Update NAT rule NAT

[cmdb_ci_translation_rule]

Updates the inbound and outbound relations of a NAT rule CI type when the related NAT rule is updated or deleted.
Remove entry point Entry Point

[sa_m2m_service_entry_point]

When an entry point, which serves as a connected business service node in one business service, is removed from another business service, this script validates the change and turns this node into a boundary node.

If there are no entry points left in a business service, its status is changed to non-operational.

Set applicative credentials type Applicative Credentials

[sa_applicative_credentials]

Populates fields in the credentials table when applicative credentials record is inserted or updated.
Check group name uniqueness Service Group

[cmdb_ci_service_group]

Checks that the business service group is unique and disallows renaming the All group.
Modify service group Service Group

[cmdb_ci_service_group]

Checks that the business service group has a valid parent and is not its own parent.
Notify MID on Discovery revert Update Versions

[sys_update_version]

Notifies MID Server when a discovery pattern runs the revert operation.
Clear CI type when "CI" is the scope Traffic Based Discovery

[sa_traffic_based_rules]

Clears CI type-related fields when CI is selected on the Traffic Based Discovery rules form.
Add query business service to group ALL Technical Service

[cmdb_ci_query_based_service]

When a traffic-based service is created, it is automatically added to the All business service group.
Validate NDL - draft Service Mapping Draft Pattern

[sa_pattern_draft]

If a pattern was changed, it creates the pattern draft and updates the pattern that is on the MID Server.
Query Based Service Filter Updated Technical Service

[cmdb_ci_query_based_service]

Recalculation of Technical Service members when a Technical Service filter is updated.
Remove business service from group Service Group Members

[sa_service_group_member]

When a business service is deleted from all customer defined groups, it is automatically removed from the All business service group.
Check service name uniqueness Business Service

[cmdb_ci_service]

Checks that the business service name is unique.
Notify MID Server on NDL change Discovery patterns

[sa_pattern]

If a pattern was changed, it updates the pattern copy that is on the MID Server.