5.8
Table Of Contents
- VMware vRealize Configuration Manager Troubleshooting Guide
- Contents
- About This Book
- Troubleshooting Overview
- Types of Problems
- Gathering Diagnostic Information
- What to Send to VMware Technical Support
- Capture a Desktop Image
- Capture a Window Image
- Set the Debug Log to Store all Message Types
- Extract the Debug Log
- Extract SQL Server Logs
- Collect IIS Logs
- Collect ARS Files
- Collect the UNIX Syslog Messages
- Collect Import/Export Tool Logs
- Extract Windows Event Logs
- Extract Windows System Information
- Collect UNIX ETL Logs
- Collect VCM Installation Logs
- Enable VCM Patching Logging
- Collect VCM Patching Logs
- Collect Agent Logging
- Troubleshooting Problems with VCM
- Patch Content Does Not Download for Red Hat and SUSE Machines
- Signed Patch Content Cannot Be Validated
- Mismatched Security Setting for AIX Patch Staging with NFS
- UNIX Patch Deployment Fails
- UNIX Patch Assessment Returns No Results
- Patch Deployment Jobs Might Time Out
- UNIX Bulletins Missing from the Required Location
- Report and Node Summary Errors
- Report Parameter Errors
- Protected Storage Errors
- SSL Becomes Disabled
- Troubleshooting the vSphere Client VCM Plug-In
- vSphere Client VCM Plug-In Is Not Enabled
- Cannot Register the vSphere Client VCM Plug-In
- Invalid Certificate on a vSphere Client
- Collector Not Running
- HTTPS/SSL Is Not Configured on the Collector
- Collection Unsuccessful
- Machines Not Listed in the Collect Available List
- Machines Not Listed in the Available List for Any Action
- ESX Servers Are Not Displayed
- VCM Windows Agent
- Windows Agent Installation Environment
- Windows Agent Installation Process
- Detect Previous Install
- Validate Installation Environment
- Interrogate Target Environment
- Resolve Uninstall Dependencies
- Uninstall Module
- Uninstall Module Installer
- Install Simple Installer
- Install Module Installer
- Resolve All Versions of Modules Based on Highest Version Number
- Install Module
- Fully Release the Synchronization Lock on the Target Machine
- Submit Request to Agent
- Check If Request Is Complete
- Transfer Request Results
- Acknowledge Successful Data Transfer
- Prepare Request Results for Insert
- Insert Data Into Database
- Transform Inserted Data
- Cleanup Machine Data
- Partially Release the Synchronization Lock on the Target Machine
- Cleanup Request Data
- Windows Agent Uninstallation Process
- Detect Previous Install
- Validate Installation Environment
- Interrogate Target Environment
- Resolve Uninstall Dependencies
- Uninstall Module
- Uninstall Module Installer
- Fully Release the Synchronization Lock on the Target Machine
- Partially Release the Synchronization Lock on the Target Machine
- Cleanup Request Data
- Windows Agent Upgrade Process
- Windows Agent Manual Installation Process
- Windows Agent Communication Protocols
- Communication Protocol Change Process
- Detect Previous Install
- Uninstall Agent
- Uninstall Package Installer
- Uninstall Basic Installer
- Validate Installation Environment
- Install Simple Installer
- Store Installation Data in the Database
- Install Module Installer
- Fully Release the Synchronization Lock On the Target Machine
- Submit Request to Agent
- Check If Request Is Complete
- Transfer Request Results
- Acknowledge Successful Data Transfer
- Prepare Request Results For Insert
- Insert Data Into Database
- Transform Inserted Data
- Cleanup Machine Data
- Partially Release the Synchronization Lock on the Target Machine
- Cleanup Request Data
- Debug Window Agent Installations
- VCM UNIX Agent
- UNIX Agent Directory Structure After Installation
- /opt/CMAgent
- /opt/CMAgent/Agent
- /opt/CMAgent/CFC
- /opt/CMAgent/data
- /opt/CMAgent/data/db
- /opt/CMAgent/data/db/DtmDB/RDM
- /opt/CMAgent/data/db/PDS
- /opt/CMAgent/data/db/SM/RDM
- /opt/CMAgent/ECMu
- /opt/CMAgent/ECMu/x.x/bin
- /opt/CMAgent/ECMu/x.x/scripts
- /opt/CMAgent/install
- /opt/CMAgent/Installer
- /opt/CMAgent/ThirdParty
- /opt/CMAgent/ThirdParty/x.x/PatchAssessment
- /opt/CMAgent/uninstall
- Directories Created During an Inspection
- Directory of Executed Scripts and Results
- Collector Certificates
- Patch Assessment
- Exploratory UNIX Agent Troubleshooting
- UNIX Agent Directory Structure After Installation
- Index
/opt/CMAgent/uninstall
The uninstall directory contains the script to remove the Agent.
/opt/CMAgent/uninstall:
-rwxr-xr-- 1 root root 54135 Oct 31 15:01 UninstallCMAgent
Directories Created During an Inspection
When a Collector first contacts the Agent, it copies its data model to the Agent. The Agent stores the data
model as a Birdstep database in a Collector-named directory immediately under DtmDB/RDM. If you delete
the directory, the next collection fails, but the subsequent collection recopies the data model.
opt/CMAgent/data/db/DtmDB/RDM/collector-name:
-rw-rw---- 1 nobody cfgsoft 35508 May 20 10:05 327B23C6-0AE4-428E-0001-
7F00F14D0500_data.dat
-rw-rw---- 1 nobody cfgsoft 19220 May 20 10:05 327B23C6-0AE4-428E-0001-
7F00F14D0500_keys.dat
-rw-rw---- 1 nobody cfgsoft 36358 May 20 10:02 643C9869-064D-428E-0001-
7F0063CE0800_data.dat
-rw-rw---- 1 nobody cfgsoft 18765 May 20 10:02 643C9869-064D-428E-0001-
7F0063CE0800_keys.dat
-rw-rw---- 1 nobody cfgsoft 27124 May 20 10:05 6B8B4567-0AE2-428E-0001-
7F00A5190200_data.dat
-rw-rw---- 1 nobody cfgsoft 15808 May 20 10:05 6B8B4567-0AE2-428E-0001-
7F00A5190200_keys.dat
-rw-rw---- 1 nobody cfgsoft 1865 May 20 10:02 DtmDB.dbd
-rw-rw---- 1 nobody cfgsoft 498 May 20 14:11 DtmDB.taf
-rw-rw---- 1 nobody cfgsoft 1325056 May 20 10:05 DtmKeys.dbd
-rw-rw---- 1 nobody cfgsoft 3078144 May 20 10:05 DtmRecord.dbd
When an inspection occurs, a Collector-named directory appears under /opt/CMAgent/data.
/opt/CMAgent/data/collector-name:
drwxrwx--- 2 nobody cfgsoft 4096 May 20 14:11 Master
drwxrwx--- 2 nobody cfgsoft 4096 May 20 14:12 Package
The Master directory contains the inspected data and is used when performing deltas. One MFL file is
collected per data class. If you delete the files, the next collection is a full collection instead of a delta.
/opt/CMAgent/data/collector-name/Master:
-rw-rw---- 1 nobody cfgsoft 8516 May 20 14:11 UnixAccountGroup.mfl
-rw-rw---- 1 nobody cfgsoft 13892 May 20 14:11 UnixAccountUser.mfl
-rw-rw---- 1 nobody cfgsoft 2869360 May 20 14:11 UnixFileSystem.mfl
The Package directory temporarily contains the results that are sent back to the Collector. You can
expand the ZRP file with the /opt/CMAgent/ThirdParty/1.0/bin/unzip *zrpcommand.
/opt/CMAgent/data/collector-name/Package:
-rw-rw---- 1 root root 10210 May 20 14:11 215D4C5A-AF55-40EB-BADD-
B634B18EF734.zrp
The Agent deletes the ZRP file after receiving acknowledgement that the Collector received it. You can
capture the file before it is deleted though. See "Capture the ZRP on the Agent" on page 75.
VCM UNIX Agent
VMware, Inc.
69