Troubleshooting the sensor
This topic describes common problems that occur with the Linux® computer system sensor and presents solutions for those problems.
Host Signature error occurs on Red Hat Enterprise Linux 7 and CentOS Linux 7 targets
- Problem
- When you discover target systems that run Red Hat Enterprise Linux 7, or CentOS Linux 7, the following error
occurs:
2016-03-31 15:46:31,759 DiscoverManager [DiscoverWorker-7] SessionSensor-9.1.146.78-[22] DEBUG session.SshSessionClient - Command [LC_ALL=en_US.UTF-8;LANG=en_US.UTF-8;export LANG LC_ALL;ifconfig -a] failed in session ssh2:/HostAuthcom.collation.platform.security.auth.HostAuth[asmcfm][XX XXX]/null@9.1.146.78: exit status 127 (no stdout)
- Solution
- To solve the problem, you must install the ifconfig command on the targets,
or choose any other command that can manage network interfaces. You must specify its name and path
in the
com.collation.platform.os.command.ifconfig
property in the collation.properties file. For details, see Configuring the collation.properties file entries.
The sensor fails with a command failed to run error
- Problem
- The following message is displayed:
The command vmcp q userid has failed to run or returns a blank value on the target Linux virtual system running on a z/VM® operating system.Error Message: CTJTD0431E: The following command failed to run or returns a blank value: sudo /sbin/vmcp q userid | awk 'print{3}'.
- Solution
- This problem is caused by one of the following conditions:
- An incorrect path for the vmcp command on the target Linux virtual system.
- The vmcp tool is not installed on the target Linux virtual system.
- The sudo command is not configured to run the vmcp command.
- The system name is not configured on the z/VM system.
To solve this problem, complete the following steps:- Verify that the correct path for the vmcp command is entered in the collation.properties file. For details, see Configuring the collation.properties file entries.
- Verify that the system name is configured on the z/VM system, the system name cannot be blank.
- If the vmcp tool is not installed on the Linux virtual system, you must
load it. To load the vmcp device driver, issue
the
modprobe vmcp
command on the Linux guest. - Verify that the sudo command is available.
To verify run the following command on the Linux guest where the monitoring agent is installed:
If sudo is active and loaded, this command sends the q userid command to the hosting virtual machine, which queries the user ID for the guest.sudo vmcp q userid
If there is not a requirement to reconcile the Linux virtual system to the host system on the z/VM operating system, it is not necessary to run the vmcp command. You can use the externalized command property (com.collation.discover.agent.command.vmcp.Linux=) in the collation.properties file to set the host system value to adummy
value. You must be able to parse the externalized command with the following command appended to it:
For example, you might use:q userid | awk '{ print $3 }'
This produces thecom.collation.discover.agent.command.vmcp.Linux.192.168.1.2=echo A B zVMHost
echo A B zVMHost q userid | awk '{print $3 }'
which returns the zVMHost name. The host attribute for your virtual systems is set tozVMHost
instead of the actual host system name. - You can disable the vmcp command by setting the ignoreVMCPCommand command to true. For instructions, see Configuring the collation.properties file entries.
z/VM guests can be duplicated after multiple discoveries of the same Linux virtual system
- Problem
- Duplicates can occur if the command vmcp q userid returns a blank value on the target Linux virtual system running on a z/VM operating system.
- Solution
- You must manually merge these duplicates.
Linux Computer System Sensor captured memory size is inaccurate.
- Problem
- When discovering Linux computer systems, the memory size captured by the sensor does not match with the installed memory size.
- Solution
- The solution is to enable dmidecode, as it gives the most accurate value of installed memory.