Veritas Cluster Server discovery

The ServiceNow Discovery application uses the Unix Cluster – VERITAS Cluster pattern to find Veritas Cluster Server components. Discovering some of these resources may require updating to the latest version of the Discovery and Service Mapping Patterns application from the ServiceNow Store.

You can use this pattern on the ServiceNow AI Platform using Kingston Patch 8, London, or Madrid.

Request apps on the Store

Visit the ServiceNow Store 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.

Prerequisites

SSH credentials

On the ServiceNow AI Platform®, configure the SSH credentials for a user with elevated rights for running the cat command. For more information about commands, see Service Mapping commands requiring a privileged user under Service Mapping documentation.

Permissions to read the Veritas Cluster Server configuration file

Give the Unix OS user permissions to read the following configuration file: /etc/VRTSvcs/conf/config/main.cf.

Permissions to run Veritas Cluster commands

Give the Unix OS user permissions to run the following commands against the Veritas Cluster Server:

Command	Parameter	Mandatory/Optional	Description
“privilege user” + cat /etc/VRTSvcs/conf/config/main.cf	-	Mandatory	Read the Veritas Cluster Server configuration file.
“privilege user” + /opt/VRTSvcs/bin/haclus -value ClusterUUID 2>/dev/null	-	Mandatory	Get the Veritas Cluster Server cluster UUID.
“privilege user” + /opt/VRTSvcs/bin/haclus -value ClusterName 2>/dev/null	-	Mandatory	Get the Veritas Cluster Server cluster name.
“privilege user” + /opt/VRTSvcs/bin/haclus -value EngineVersion	-	Mandatory	Get the Veritas Cluster Server cluster version.
“privilege user” + /opt/VRTSvcs/bin/haclus -value ClusterAddress	-	Mandatory	Get the Veritas Cluster Server cluster address.
“privilege user” + /opt/VRTSvcs/bin/haclus -value ClusState	-	Mandatory	Get the Veritas Cluster Server cluster status.
“privilege user” + /opt/VRTSvcs/bin/hasys -state	-	Mandatory	Get the Veritas Cluster Server cluster nodes.
“privilege user” + /opt/VRTSvcs/bin/hares -state	-	Mandatory	Get the cluster resources of the Veritas Cluster Server.
“privilege user” + /opt/VRTSvcs/bin/hares -display |grep -w 'Type' |grep 'global' 2>/dev/null	-	Mandatory	Get the cluster resource type of the Veritas Cluster Server.
“privilege user” + /opt/VRTSvcs/bin/hares -display | grep Group 2>/dev/null	-	Mandatory	Get the cluster resource group of the Veritas Cluster Server.
“privilege user” + /opt/VRTSvcs/bin/hagrp -state 2>/dev/null	-	Mandatory	Get the resource group name and status of the Veritas Cluster Server.

Classification probe for triggering the UNIX Cluster – VERITAS Cluster pattern

Verify that the classification probe is set to trigger the UNIX Cluster – VERITAS Cluster pattern:

1. Navigate to Discovery Definition > CI Classification > CI Classification > UNIX.
2. In the UNIX Classification list, click Solaris or Linux.
3. On the Triggers probes tab, check that the HorizontalDiscoveryProbe-HorizontalPatt probe is assigned to the UNIX Cluster – VERITAS Cluster pattern.
   
   
   Remarque :

   The discovery log shows the error for OS discovery step even if the discovery finished successfully.

System property for the new host class

Add a system property [sys_property] sa.host_classes and set the value to cmdb_ci_unix_cluster. Creating a new host class for Veritas Cluster servers helps to identify this type of hosts correctly.

Limitations

You cannot customize the Unix Cluster – VERITAS Cluster pattern in the Debug mode in the Pattern Designer.

Data collected by Discovery during horizontal discovery

Table and field	Description
Unix Cluster [cmdb_ci_unix_cluster]	The attributes of the Unix Cluster.
IP address [ip_address]
Cluster type [cluster_type]
Name [name]
Cluster version [cluster_version]
Cluster status [cluster_status]
Unix Cluster Node [cmdb_ci_unix_cluster_node]	The attributes of the Unix Cluster Node.
Name [name]
Cluster [cluster]
Server [server]
Node state [node_status]
IP address [ip_address]
UNIX Cluster Resource Group [cmdb_ci_unix_cluster_resource_group]	The attributes of the UNIX Cluster Resource Group.
Name [name]
Node [node]
Server [server]
Cluster [cluster]
Resource group status [resource_group_status]
UNIX Cluster Resource [cmdb_ci_unix_cluster_resource]	The attributes of the UNIX Cluster Resource.
Resource type [resource_type]
Name [name]
Resource status [resource_status]
Cluster Virtual IPs [cmdb_ci_cluster_vip]	The attributes of the Cluster Virtual IP addresses.
IP address [ip_address]
name [name]
Cluster [cluster]
Cluster status [cluster_status]
Node [node]

The graphic illustrates CIs that are part of Veritas Cluster Server discovery.

CI relationships

The Unix Cluster – VERITAS Cluster pattern creates the following CI relationships:

CI	Relationship	CI
Unix Cluster [cmdb_ci_unix_cluster]	Hosts: Hosted on	Linux Server [cmdb_ci_linux_server]
Unix Cluster Node [cmdb_ci_unix_cluster_node]	Hosts: Hosted on	Linux Server [cmdb_ci_linux_server]
Cluster Virtual IPs [cmdb_ci_cluster_vip]	Virtualized by: Virtualized	Unix Cluster [cmdb_ci_unix_cluster]
Cluster Virtual IPs [cmdb_ci_cluster_vip]	Uses: Used by	Unix Cluster Node [cmdb_ci_unix_cluster_node]
Unix Cluster Node [cmdb_ci_unix_cluster_node]	Cluster of: Cluster	Unix Cluster [cmdb_ci_unix_cluster]
Unix Cluster resource [cmdb_ci_unix_cluster_resource]	Defines resources for: Gets resources from	Unix Cluster Node [cmdb_ci_unix_cluster_node]
Unix Cluster resource [cmdb_ci_unix_cluster_resource]	Defines resources for: Gets resources from	The Cluster field on [cmdb_ci_unix_cluster]
Unix Cluster resource group [cmdb_ci_unix_cluster_resource_group ]	Contains: Contained by	The Cluster field on UNIX Cluster [cmdb_ci_unix_cluster]
Unix Cluster resource group [cmdb_ci_unix_cluster_resource_group ]	Contains: Contained by	The Node field on Unix Cluster Node [cmdb_ci_unix_cluster_node]
Unix Cluster resource group [cmdb_ci_unix_cluster_resource_group ]	Contains: Contained by	Unix Cluster resource [cmdb_ci_unix_cluster_resource]