Configuring the collation.properties file entries
This topic lists the collation.properties file entries that the Linux® computer system sensor uses.
The sensor uses the control program vmcp command to discover a Linux virtual system running on a z/VM® operating system. For each Linux virtual system, specify the path for the vmcp command in the collation.properties file.
- com.collation.platform.os.unix.find.excludenfsmount=false
- The default value is false.
- com.collation.platform.os.command.ifconfig=
- This property specifies a path to a command that is used to configure network interfaces. The example of such command is ifconfig. However, you can provide any other command that has the same function, for example the ip command. Network interfaces are required for the discovery to be successful.
- com.collation.platform.os.command.CPUSpeed=cat /proc/cpuinfo | grep 'cpu MHz'|awk '{print $4}'| tail -1
- This property specifies the command that is used to retrieve the value of the CPUSpeed attribute that is expressed in MHz. The default value of this property is cat /proc/cpuinfo | grep 'cpu MHz'|awk '{print $4}'| tail -1.
- com.ibm.cdb.discover.zlinux.ignoreVMCPCommand.enabled=false
- This property specifies whether the
ignoreVMCPCommandattribute, or thecom.ibm.cdb.discover.zlinux.ignoreVMCPCommandproperty is used. If this property is set to false, theignoreVMCPCommandattribute is used. If this property is set to true, thecom.ibm.cdb.discover.zlinux.ignoreVMCPCommandproperty is used, which enables all sensors to discover the VMID and MMS attributes of Linux on System z targets.
- com.ibm.cdb.discover.zlinux.ignoreVMCPCommand=false
- This property is used only when the
com.ibm.cdb.discover.zlinux.ignoreVMCPCommand.enabledproperty is set to true.
- com.collation.discover.agent.command.vmcp.Linux.1.2.3.4={command path}
- This value specifies the path name of the vmcp command
for different Linux virtual
systems with different IP addresses. For example, to specify the path
of the vmcp command in the /sbin directory,
on a Linux host with IP address
192.168.1.2, add the following entry to the collation.properties file:
com.collation.discover.agent.command.vmcp.Linux.192.168.1.2=sudo /sbin/vmcp - com.collation.platform.os.command.crontabEntriesCommand.Linux=crontab -l -u
- This property is used to discover crontab entries.
You can specify this property as a scoped property by appending an
IP address or a scope set name to the property. The following example
uses an appended IP address:
com.collation.platform.os.command.crontabEntriesCommand.Linux.1.2.3.4=crontab -l -u - com.collation.platform.os.command.crontabEntriesUsers.Linux=root
- This property is used to discover crontab entries
for a specified user, use a comma-separated list to specify more than
one user. You can specify this property as a scoped property by appending
an IP address or a scope set name to the property. The following example
uses an appended IP address:
com.collation.platform.os.command.crontabEntriesUsers.Linux.1.2.3.4=root,build - com.collation.discover.agent.sys.ComputerSystem.serialNumberSanityChecks=
- "ˆ(?!null);ˆ(?!not );ˆ(?!n/a);ˆ(?!permission);ˆ(?!to be );ˆ(?!undef); ˆ[ -:\.\w]{4,80}$; ^(?!.{8}(\-.{4}){3}\-.{12}_.{2}(:.{2}){5});^(?!none);^(?!x{7});^(?!\.{9});^(?!0123456789);^(?!0+$)";
This property is used to validate the serialNumber property that is discovered by the operating system sensors, except Solaris, to avoid storing generic values, such as Not Defined, To be set by OEM, or Permission Denied.
The main default rule is that a serial number must contain from 4 to 80 characters and not begin with one of the following strings:- null : regular expression ^(?!null)
- not : regular expression ^(?!not)
- n/a : regular expression ^(?!n/a)
- permission : regular expression ^(?!permission)
- to be : regular expression ^(?!to be)
- undef : regular expression ^(?!undef)
- string in form : 098D8710-E623-3C3B-9F9B-FCBAFF1BF3B6_5C:F3:FC:E8:89:FC : regular expression ^(?!.{8}(\-.{4}){3}\-.{12}_.{2}(:.{2}){5})
- none : regular expression ^(?!none)
- xxxxxxx : regular expression ^(?!x{7})
- ......... : regular expression ^(?!\.{9})
- 0123456789 : regular expression ^(?!0123456789)
- 0000 : regular expression ^(?!0+$)
If a serial number does not follow this rule, it is not set. The regular expression syntax is defined in the Java™ SDK for class
java.util.regex.Pattern. Regular expressions must be separated by semicolons. Candidate serial numbers are always converted to all lowercase before they are matched against the regular expressions. Therefore, when you customize the property, use lowercase characters only.
- com.collation.discover.agent.ignoreVirtualMAC=true
- This property specifies whether the discovery of hardware addresses for virtual interfaces on Linux targets is enabled. If you set this property to true, hardware addresses are discovered.