VMware VCM 5.3 Troubleshooting Guide

VMware vCenter ConfigurationManagerTroubleshooting GuideVCM 5.3This document supports the version of each product listed and supports allsubsequent ve

For example, if collections are stalling at a specific step in the process, you may occasionally find that asingle CPU is running at 100% capacity. Th

It is important to remember that the debug logs produced by VCM were never designed for the averageuser. The messages contained in the logs have been

Error MessagesError messages indicate a more serious problem. VCM processes will not halt because of an error, butthey may not be able to continue nor

Types of Problems2Types of ProblemsMost VCM problems will fall into one of several categories that may make them easier to identify. Eachcategory is r

Security / AuthenticationOne of VCM's primary roles is multi-system administration. Therefore, VCM must be granted authority toact as an administ

VCM AgentThe VCM Agents are the mechanism by which VCM collects information from managed machines. If theAgent is not functioning properly, collection

You can easily determine if there is a problem with the Report Server specifically by navigating to theReport Server homepage to see if the native int

Network ConnectivityVCM relies heavily on network connectivity to all Agents. In systems where you have a split installation,failed network connectivi

VCM Troubleshooting Guide18 VMware, Inc.

How to Gather Diagnostic Files3How to Gather Diagnostic FilesYou may need to review or gather one or more of the following files to use for diagnostic

CopyrightYou can find the most up-to-date technical documentation on the VMware Web site at:http://www.vmware.com/support/The VMware Web site also pro

6. Select Administration | Settings | General Settings | Database. The Database data grid appears.7.8. Select the Type of information that should be l

1. Log on to the machine with the SQL Server used by VCM.2. Select Start | All Programs | Microsoft SQL Server | SQL Server Management Studio.3. Selec

5. Expand \HKEY_LOCAL_MACHINES\Software\Configuresoft\ECM\4.0\Collector. Verify the valueis 1. If that key does not exist, right-click on the 4.0 key

1. Log on to the Collector machine2. Select Start | Administrative Tools | Event Viewer. The Event Viewer appears.3. Expand Event Viewer in the left p

9. On the collector navigate to <drive>:\Program Files\VMware\VCM\SUM\Collector and lookfor the following files:nCSISUMWorker_SumDBDebug.txtnCSI

Software Provisioning Troubleshooting4Software Provisioning TroubleshootingWhen troubleshooting software provisioning, there are three main components

When requesting a package from a repository, the package (.crate file)cannot be foundPossible Cause RemediationThe package (.crate file) wasdeleted fr

Repository.index is no longer validPossible Cause RemediationThe Repository.index was manuallyedited and the xml code is corrupted.Review the xml code

Repository not found when reindexing or publishing packages to arepositoryPossible Cause RemediationIncorrect path to the repository. When reindexing

The Generate button is grayed outPossible Cause RemediationThe required fields are not yetpopulated with valid data.Add valid data to the required fie

ContentsAbout This Book 5General Troubleshooting Guidelines 7Verify the Behavior is Negative 7Isolate the Behavior 8Identify External Factors 9Check t

Error when adding a Provides: the dependency package name is invalidPossible Cause RemediationA Provides was defined with uppercase letters. A current

When a package is created, signed, saved as project, and then generated,the package is no longer signedPossible Cause RemediationBy design, only gener

I am uncertain if the package requires a reboot to install or I only want theinstallation to reboot sometimesConditional reboots are not supported. Yo

4. Click Next, and then click Finish.5. Modify as needed and run the following on the command line of the Agent machine:C:\WINDOWS\CMAgent\Installer\P

VCM Troubleshooting Guide34 VMware, Inc.

Windows Agent InstallationAWindows Agent InstallationPre-Install EnvironmentNetworkPre-VCM Install AnalysisRequired components and service for an Agen

InstallThe following describes in detail the install process from start to finish.Upon issuing an installation request, looking at the Jobs Running di

1. Detect Previous Install (Detects previous Agents and Agent components): Detect previous installdetermines if a previous Agent version is installed

4. Resolve Uninstall Dependencies: Based on what was found on the target and what is to be deployed,reconciliation occurs. The result of this is a lis

f. The directory structure is created and the following components are laid down on the target.nECMColInstallAgtRegistrationService.exe – This binary

VCM Troubleshooting GuideError when adding a Provides: the dependency package name is invalid 30When a package is created, signed, saved as project, a

e. If a component (other than the module installer) of the installation infrastructure needs to beupdated the following actions occur.nA connection is

14. Transfer Request Resultsa. Upon the completion of the machine environment inspection, the results are sent back to thecollector.b. Detailed inform

UninstallUninstall is the process of removing VCM Agent presence from a target box. This removes VCM productsand the install infrastructure. The resul

b. The next step is an attempt to attach to the target machine’s share. This attempt is made even if theprevious step succeeds. It may or may not work

1. Detect Previous Install is described in detail under the Install section, step 1.2. Uninstall Agent is described in detail under the Install sectio

1. Interactive: Interactive mode displays various dialog boxes for input regarding the following pieces ofinformation that the system needs to lay dow

accessed via a port or via DCOM, where a DCOM agent can only respond to DCOM requests.DCOMInstall happen via DCOM. Currently there are not other metho

UNIX Agent TroubleshootingBUNIX Agent TroubleshootingAgent Directory StructureAssuming that the defaults were taken during install, executing the comm

drwxr-x--- 4 root cfgsoft 96 May 6 16:47 3.0-rw-r----- 1 root cfgsoft 3203 May 6 16:47 manifest_Agent.3.0.Linux/opt/CMAgent/Agent/3.0:drwxr-x--- 2 roo

/opt/CMAgent/CFC/3.0/bin:-r-xr-x--- 1 root cfgsoft 107517 May 6 16:47 CSI_ManageCertificateStore-r-xr-x--- 1 root cfgsoft 87490 May 6 16:47 CsiAgentLi

About This BookAbout This BookThis manual, Troubleshooting Guide for VMware vCenter Configuration Manager, explains the types ofproblems that may occu

drwxrwx--- 3 root cfgsoft 72 May 6 16:47 DtmDBdrwxrwx--- 3 root cfgsoft 104 May 6 16:47 PDSdrwxrwx--- 3 root cfgsoft 72 May 6 16:47 SM/opt/CMAgent/dat

-rw-rwx--- 1 root cfgsoft 2361 May 6 16:47StatusManagerDB.dbdThe PDS directory contains the Certificate Store./opt/CMAgent/data/db/PDS:-rw-rw---- 1 ro

nRunHigh: Used to run privileged inspections. This is achieved because it is owned by root and has thesuid permission set (note the r-s in the permiss

-r-xr-x--- 1 root cfgsoft 204968 May 6 16:47libEcmScriptInspectionJob.so-r-xr-x--- 1 root cfgsoft 64392 May 6 16:47libPatchFactorySubsystem.so-r-xr-x-

/opt/CMAgent/install:-rw-r----- 1 root cfgsoft 35332 May 6 16:47 BootStrapInstall.log-r-xr-x--- 1 root cfgsoft 38940 May 6 16:47 BootStrapInstall.sh-r

-rw-r----- 1 root cfgsoft 6161 May 6 16:47 copy_reg.pyc<--- snip --->-r--r----- 1 root cfgsoft 2244 May 5 08:36 types.py-rw-r----- 1 root cfgsof

-r-xr-x--- 1 root cfgsoft 30736 May 6 16:47 lm-r-xr-x--- 1 root cfgsoft 9352 May 6 16:47 lmmgr-r-xr-x--- 1 root cfgsoft 104992 May 6 16:47 unzip-r-xr-

The certificate can be added to the Agent's certificate store using the CSI_ManageCertificateStore utility.Please note that the certificate infor

Unfortunately, the size of the initial request sent to Agents for which patch assessment data exists in theCollector causes problems. The size of this

/opt/CMAgent/data/DVSUP-INSTALL/Master:-rw-rw---- 1 nobody cfgsoft 8516 May 20 14:11UnixAccountGroup.mfl-rw-rw---- 1 nobody cfgsoft 13892 May 20 14:11

VMware ProfessionalServicesVMware Education Services courses offer extensive hands-on labs, case studyexamples, and course materials designed to be us

drwxrwx--- 6 root cfgsoft 4096 May 20 14:07UNIX Agent Error ScenariosIf the installation reports and errorCopy the DebugEvent_cis.dbe file from /opt/C

Initiating Connect() Scan against &lt;agent-machine&gt; (&lt;ip-address&gt;)Adding open port 26542/tcpThe Connect() Scan took 0 second

You may see other additional processes such as gawk or zip depending on when you issue the pscommand.Also follow the instructions in to ensure that th

The file messages in /var/log (Linux) or /var/adm (Solaris) will show any errors that the Agent processeshad before being able to write to the DebugEv

EtherealFirst, set up ethereal to capture the data:1. From the ethereal tool bar click on Capture | Capture Filters.2. In the Filter name text box, ty

nGreen – The PingnBlue – The ping result – the Content-Length in this message is usually 164 bytes.nRed – Session Negotiation – the Content-Length in

The Collector reports the job succeeded, but there is still no dataDetermine if there are problems with the suid programs in/opt/CMAgent/ECMu/1.0/binT

IndexAabout this book 5agent 15collector 35communication protocol 45manual installation 44network 35software provisioning logs 32UNIX/Linux 15AreResul

UUNIX agentcollector certificates 56directoriesinspections 58directory structure 47errors 60patch assessment 57results 59scripts 59user interface 13Ww

General Troubleshooting Guidelines1General Troubleshooting GuidelinesThis document attempts to describe some of the basic steps you can take before co

This construction may be confusing. A user might intuitively create a conditional statement that describesthe abnormal condition they want to eliminat

The goal for this trial-and-error elimination process is to understand when the undesired behavior occursso you can reproduce the behavior consistentl