Linux Requirements

Platform Owner	Deanna Burns (Unlicensed)
Document status	WORK IN PROGRESS
Tech lead	Allena Kendrick (Unlicensed)
Technical writers	Vandana Bansal
CI Owner	Nancy Braen
CMDB Manager	Christopher Abbott (Unlicensed)
Project Manager	David Swanson (Unlicensed)

Files

Report metrics (Must Configure CMDB View for Linux)

Technical Requirements

#

Requirement

User Story

Importance

Challenge

Notes

1

Mid Server

When Discovery runs dmidecode | cat, it returns garbage.
{"related_data":{"tDataObj":{}}}

This article:
https://community.servicenow.com/community?id=community_question&sys_id=21e8e0b4db903f04fece0b55ca961926
states that a user running London had a very similar issue and resolved it by adding the mid server property “mid.property.ssh.use_snc”When Discovery runs dmidecode | cat, it returns garbage.
{"related_data":{"tDataObj":{}}}

This article:
https://community.servicenow.com/community?id=community_question&sys_id=21e8e0b4db903f04fece0b55ca961926
states that a user running London had a very similar issue and resolved it by adding the mid server property “mid.property.ssh.use_snc”

2

Linux Change

On the linux side, we made the following changes which are applicable to our entire environment, not just for the ServiceNow sandbox:

Allowed the linux ServiceNow credential – s_svcnow_mid – to run the following commands as sudo without a password:

'/usr/sbin/dmidecode',

'/sbin/dmidecode',

'/usr/sbin/lsof',

'/sbin/lsof',

'/usr/bin/fdisk -l',

'/usr/bin/multipath -ll',

'/usr/sbin/dmsetup table *',

'/usr/sbin/dmsetup table',

'/usr/sbin/dmsetup ls',

'/usr/bin/ls',

'/usr/bin/cat',

'/bin/stat',

'/usr/bin/netstat'

Changed /etc/hostname to reflect the fqdn instead of just the short name.

3

To resolved the host name/dns domain/name for new Linux CI. Nancy will be implementing automatic fully qualified domain automatically updated without rebooting the linux server

*

PROBES

PROBES
Horizontal discovery probe: launches patterns Linux - Installed Software^ Unix - ADM^ Linux - Identity* Linux - CPU* Linux - Distribution* Linux - Find FQDN* Linux - Memory* Linux - Memory Modules* Linux - Network ARP Tables* Linux - Storage* Linux - Amazon EC2* Unix - OS Uptime* UNIX - OS Filesystems* UNIX - Find FQDN* Unix - ADM Enhanced*

PATTERNS

Pattern
Linux Server

Linux Discovery Data Attributes Collections

https://docs.servicenow.com/bundle/london-it-operations-management/page/product/discovery/reference/r_DataCollDiscoLinuxComputers.html

Label	Table Name	Field Name	Source
Operating System	cmdb_ci_linux_server	os	uname
OS Version	cmdb_ci_computer	os_version	uname -a or cat /etc/*release
Short description	cmdb_ci_linux_server	short_description	uname
Name	cmdb_ci_linux_server	name	DNS, NBT
Hostname	cmdb_ci_linux_server	host_name	DNS, NBT
DNS domain	cmdb_ci_linux_server	dns_domain	DNS
Start date	cmdb_ci_linux_server	start_date	uptime
Manufacturer	cmdb_ci_computer	manufacturer	dmidecode
Serial number	cmdb_ci_computer	serial_number	dmidecode
CPU type	cmdb_ci_linux_server	cpu_type	/proc/cpuinfo
CPU speed (MHz)	cmdb_ci_linux_server	cpu_speed	/proc/cpuinfo
CPU count	cmdb_ci_linux_server	cpu_count	/proc/cpuinfo
CPU core count	cmdb_ci_computer	cpu_core_count	/proc/cpuinfo
CPU core thread	cmdb_ci_computer	cpu_core_thread	/proc/cpuinfo
CPU manufacturer	cmdb_ci_linux_server	cpu_manufacturer	/proc/cpuinfo
Model number	cmdb_ci_computer	model_number	dmidecode
Model ID	cmdb_ci_computer	model_id	dmidecode
RAM (MB)	cmdb_ci_linux_server	ram	meminfo
Disk space (GB)*	cmdb_ci_linux_server	disk_space	/proc/ide, /proc/scsi, /var/log/dmesg
Type	cmdb_ci_disk	type	/proc/ide, /proc/scsi, /var/log/dmesg
Model ID	cmdb_ci_disk	model_id	/proc/ide, /proc/scsi, /var/log/dmesg
Disk space (GB)	cmdb_ci_disk	disk_space	/proc/ide, /proc/scsi, /var/log/dmesg
Name	cmdb_ci_disk	name	/proc/ide, /proc/scsi, /var/log/dmesg
Name	cmdb_ci_file_system	name	df
Capacity (MB)	cmdb_ci_file_system	capacity	df
Available Space (MB)	cmdb_ci_file_system	available_space	df
Mount point	cmdb_ci_file_system	mount_point	df
Name	cmdb_running_process	name	ps
Command	cmdb_running_process	command	ps
Type	cmdb_running_process	type	ps
PID	cmdb_running_process	pid	ps
Parameters	cmdb_running_process	parameters	ps
Name	cmdb_ci_network_adapter	name	ifconfig
IP address	cmdb_ci_network_adapter	ip_address	ifconfig
MAC address	cmdb_ci_network_adapter	mac_address	ifconfig
Netmask	cmdb_ci_network_adapter	netmask	ifconfig
Default gateway	cmdb_ci_hardware	default_gateway	route

TABLE COLUMNS

Note: u_ = added Data attributes

Data attributes in pink = Required fields

Data attributes in blue = Ownership fields

Data attributes in green = Data collected by Discovery

ColumnsControlsApplication Access

Table Columns table. Currently in read mode

Column labelSort in ascending order	Column nameSort in ascending order	MandatorySort in ascending order	TypeSort in ascending order	ReferenceSort in ascending order	Max lengthSort in ascending order	Default valueSort in ascending order	DisplaySort in ascending order
Sys ID	sys_id	true	Sys ID (GUID)	(empty)	32		false
Name	name	true	String	(empty)	255		true
Kernel Release	kernel_release	false	String	(empty)	40		false
PagerDuty webhook	x_pd_integration_pagerduty_webhook	false	String	(empty)	40		false
PagerDuty service	x_pd_integration_pagerduty_service	false	String	(empty)	40		false
COA	u_coa	false	String	(empty)	100		false
CPU name	cpu_name	false	String	(empty)	100		false
Most recent discovery	last_discovered	false	Date/Time	(empty)	40		false
Domain	sys_domain	false	Domain ID	(empty)	32	global	false
OS Version	os_version	false	String	(empty)	40		false
Correlation ID	correlation_id	false	String	(empty)	512		false
Classification	classification	false	String	(empty)	40	Production	false
Assignment group	assignment_group	false	Reference	Group	32		false
Lease expiration date	u_lease_expiration_date	false	Date	(empty)	40		false
Discovery source	discovery_source	false	String	(empty)	40		false
Monitor	monitor	false	True/False	(empty)	40	false	false
OS Address Width (bits)	os_address_width	false	Integer	(empty)	40		false
Asset tag	asset_tag	false	String	(empty)	40		false
CPU speed (MHz)	cpu_speed	false	Decimal	(empty)	15		false
Maintenance schedule	maintenance_schedule	false	Reference	Schedule	32		false
DR Plan Next Testing Date	u_dr_plan_next_test	false	Date	(empty)	40		false
Justification	justification	false	String	(empty)	80		false
First discovered	first_discovered	false	Date/Time	(empty)	40		false
Order received	delivery_date	false	Date/Time	(empty)	40		false
Checked in	checked_in	false	Date/Time	(empty)	40		false
Description	short_description	false	String	(empty)	1,000		false
Is a Disaster Recovery Plan Required?	u_dr_plan_required	false	String	(empty)	40	No	false
Assigned	assigned	false	Date/Time	(empty)	40		false
Category	category	false	String	(empty)	40	javascript:gs.include("CMDBItem");var it...	false
Assigned to	assigned_to	false	Reference	User	32		false
DNS Domain	dns_domain	false	String	(empty)	255		false
CD Speed	cd_speed	false	Integer	(empty)	40		false
Support group	support_group	false	Reference	Group	32		false
Supported by	supported_by	false	Reference	User	32		false
Status	install_status	false	Integer	(empty)	40		false
Comments	comments	false	String	(empty)	4,000		false
Department	department	false	Reference	Department	32		false
CPU type	cpu_type	false	String	(empty)	40		false
Purchased	purchase_date	false	Date	(empty)	40		false
Manufacturer	manufacturer	false	Reference	Company	32		false
Start date	start_date	false	Date/Time	(empty)	40		false
Floppy	floppy	false	String	(empty)	40		false
Model ID	model_id	false	Reference	Product Model	32		false
Form factor	form_factor	false	String	(empty)	40		false
Chassis type	chassis_type	false	String	(empty)	40		false
Substatus	hardware_substatus	false	String	(empty)	40		false
Disk space (GB)	disk_space	false	Decimal	(empty)	15		false
Is Virtual	virtual	false	True/False	(empty)	40	false	false
Display name	u_display_name	false	String	(empty)	255		false
Ordered	order_date	false	Date/Time	(empty)	40		false
Data Center	u_reference_1	false	Reference	Data Center	32	bac72b5137130200f212cc028e41f1b8	false
sys_class_path	sys_class_path	false	System Class path	(empty)	255	javascript:GlideDBObjectManager.get().ge...	false
Disaster backup	dr_backup	false	Reference	Server	32		false
Alias	u_alias	false	String	(empty)	100		false
Object ID	object_id	false	String	(empty)	512		false
License metric	metric_type	false	List	Software License Calculation	1,024		false
Owned by	owned_by	false	Reference	User	32		false
Updated by	sys_updated_by	false	String	(empty)	40		false
CD	cd_rom	false	True/False	(empty)	40		false
GL account	gl_account	false	String	(empty)	40		false
Virus Protection	u_virus_protection	false	True/False	(empty)	40		false
DR Plan Last Approved	u_dr_plan_last_approval	false	Date	(empty)	40		false
Operational status	operational_status	false	Integer	(empty)	100	1	false
Cost currency	cost_cc	false	String	(empty)	3	USD	false
Updated	sys_updated_on	false	Date/Time	(empty)	40		false
Created	sys_created_on	false	Date/Time	(empty)	40		false
Lease contract	lease_id	false	String	(empty)	40		false
Backup	u_backup	false	String	(empty)	40		false
Warranty expiration	warranty_expiration	false	Date	(empty)	40		false
OS Domain	os_domain	false	String	(empty)	40		false
Used for	used_for	false	String	(empty)	40	Production	false
CPU manufacturer	cpu_manufacturer	false	Reference	Company	32		false
Installed	install_date	false	Date/Time	(empty)	40		false
Approval group	change_control	false	Reference	Group	32		false
Schedule	schedule	false	Reference	Schedule	32		false
Cost	cost	false	Floating Point Number	(empty)	40		false
Class	sys_class_name	false	System Class Name	(empty)	80	javascript:current.getTableName();	false
Hardware Status	hardware_status	false	String	(empty)	40	installed	false
Processor	processor	false	Reference	Processor Definition	32		false
Management IP Address	ip_address	false	String	(empty)	255		false
Skip sync	skip_sync	false	True/False	(empty)	40	false	false
Fault count	fault_count	false	Integer	(empty)	40	0	false
Attributes	attributes	false	String	(empty)	65,000		false
Created by	sys_created_by	false	String	(empty)	40		false
Company	company	false	Reference	Company	32		false
DR Plan Last Tested Date	u_dr_plan_last_test	false	Date	(empty)	40		false
Asset	asset	false	Reference	Asset	32		false
Default Gateway	default_gateway	false	String	(empty)	40		false
Can Print	can_print	false	True/False	(empty)	40	false	false
Maintenance URL	u_maintenance_url	false	URL	(empty)	1,024		false
Operating System	os	false	String	(empty)	50		false
DR Plan Next Approval Date	u_dr_plan_next_approval	false	Date	(empty)	40		false
Vendor	vendor	false	Reference	Company	32		false
Location	location	false	Reference	Location	32		false
Serial number	serial_number	false	String	(empty)	255		false
CPU count	cpu_count	false	Integer	(empty)	40	1	false
Domain Path	sys_domain_path	false	(empty)	(empty)	255		false
Model number	model_number	false	String	(empty)	255		false
Bomgar Jumpoint	u_bomgar_jumpoint	false	Reference	Bomgar Jumpoint	32		false
Invoice number	invoice_number	false	String	(empty)	40		false

MandatorySort in ascending order	TypeSort in ascending order	ReferenceSort in ascending order	Max lengthSort in ascending order	Default valueSort in ascending order	DisplaySort in ascending order
CPU core thread	cpu_core_thread	false	Integer	(empty)	40		false
Updates	sys_mod_count	false	Integer	(empty)	40		false
Host name	host_name	false	String	(empty)	255		false
MAC Address	mac_address	false	String	(empty)	40		false
Subcategory	subcategory	false	String	(empty)	40		false
OS Service Pack	os_service_pack	false	String	(empty)	40		false
Monitoring	u_monitoring	false	True/False	(empty)	40		false
Due	due	false	Date/Time	(empty)	40		false
Checked out	checked_out	false	Date/Time	(empty)	40		false
Cost center	cost_center	false	Reference	Cost Center	32		false
CPU core count	cpu_core_count	false	Integer	(empty)	40	1	false
Requires verification	unverified	false	True/False	(empty)	40		false
Due in	due_in	false	String	(empty)	40		false
Functional Contact	managed_by	false	Reference	User	32		false
DR Plan ID #	u_dr_plan_id	false	String	(empty)	40		false
RAM (MB)	ram	false	Integer	(empty)	40		false
Firewall status	firewall_status	false	String	(empty)	40	Intranet	false
Fully qualified domain name	fqdn	false	String	(empty)	255		false
PO number	po_number	false	String	(empty)	40		false
Warranty Expiration Date	u_warranty_expiration_date	false	Date	(empty)	40		false

User Interface

Main Form

Related Items

Network Adapters

Storage Devices

File Systems

Software Installations

Network Adapters

Serial Numbers

CI IPs

DNS Names for CI

Memory Modules

Disk Partitions

Disks

User Interface Requirements

Main Form:
1. Owned By should be a required field. Tells who to contact if something is not working.
2. Requirement was to discover Backup field automatically. However, this cannot be done automatically and will need to be entered manually.
3. COA should be a required field, in order to know the charging information for the CI.
4. Hide - Virus Protection, Monitoring and Warranty Expiration Date. Not used by the team.
5. Cost Center should be required. Although it is part of COA it does not really spell it out. Having Cost Center populated makes it easier.

Relationships

Validation Steps

Step	Description	Verdict
Execute Linux Validation ATF	https://yalesandbox.service-now.com/nav_to.do?uri=sys_atf_test_result.do?sys_id=1d3841e3dbab3700715013296896193e

Open Questions

Question	Answer	Date Answered

Report metrics (Must Configure CMDB View for Linux)

Technical Requirements

PROBES

PATTERNS

Linux Discovery Data Attributes Collections

TABLE COLUMNS

User Interface

Main Form

Related Items

Network Adapters

Storage Devices

File Systems

Software Installations

Network Adapters

Serial Numbers

CI IPs

DNS Names for CI

Memory Modules

Disk Partitions

Disks

User Interface Requirements

Relationships

Validation Steps

Open Questions

Out of Scope