vCenter Configuration Manager Foundation Checker User's Guide vCenter Configuration Manager 5.3 vCenter Configuration Manager Foundation Checker 3.0 This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs. EN-000438-01 vCenter Configuration Manager Foundation Checker User's Guide You 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 provides the latest product updates. If you have comments about this documentation, submit your feedback to: firstname.lastname@example.org © 2006-2010 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. Contents About This Book 5 Introduction to Foundation Checker 7 Installing Foundation Checker 9 Installing the Standalone Version of Foundation Checker Downloading the Standalone Foundation Checker Running Foundation Checker Command Prompt Parameters Reviewing the Foundation Checker System Checks Components Displayed Information Evaluating the Results Other Troubleshooting Options Escalating Issues VMware, Inc. 9 10 11 12 13 13 13 14 15 15 3 vCenter Configuration Manager Foundation Checker User's Guide 4 VMware, Inc. About This Book This guide, VCM Foundation Checker User's Guide, describes the process of installing, running, and analyzing the prerequisite checks performed by VMware vCenter Configuration Manager (VCM) Foundation Checker. These checks are required before installing the VCM application. This document contains the following information: n Foundation Checker overview n Installing Foundation Checker n Running Foundation Checker n Reviewing the Foundation Checker system results VCM Foundation Checker User's Guide covers VCM 5.3 and Foundation Checker 3.0. Intended Audience This document contains information intended for system administrators who are experienced Windows, UNIX/Linux, Mac,or VMware virtualization system administrators and who are familiar with installing VCM. To use the information in this guide effectively, you must have a basic understanding of how to configure network resources, install software, and administer operating systems. You also need to fully understand your network’s topology and resource naming conventions. Document Feedback VMware welcomes your suggestions for improving our documentation. If you have comments, send your feedback to email@example.com. VMware, Inc. 5 vCenter Configuration Manager Foundation Checker User's Guide Technical Support and Education Resources The following technical support resources are available to you. To access the current version of this book and other books, go to http://www.vmware.com/support/pubs. Online and Telephone Support To use online support to submit technical support requests, view your product and contract information, and register your products, go to http://www.vmware.com/support. Customers with appropriate support contracts should use telephone support for priority 1 issues. Go to http://www.vmware.com/support/phone_support.html. 6 Support Offerings To find out how VMware support offerings can help meet your business needs, go to http://www.vmware.com/support/services. VMware Professional Services VMware Education Services courses offer extensive hands-on labs, case study examples, and course materials designed to be used as on-the-job reference tools. Courses are available onsite, in the classroom, and live online. For onsite pilot programs and implementation best practices, VMware Consulting Services provides offerings to help you assess, plan, build, and manage your virtual environment. To access information about education classes, certification programs, and consulting services, go to http://www.vmware.com/services. VMware, Inc. Introduction to Foundation Checker 1 The Foundation Checker is a tool used to verify that the machine designated as a VCM Collector meets all the prerequisites necessary for installing VCM. The prerequisites are described in the VCM Hardware and Software Requirements Guide. The Foundation Checker is comprised of a series of system checks run on the Collector machine. If the checks run without error, you can begin installing VCM. If the checks identify missing components or incorrect configurations, you are instructed where to verify the component or configuration, and how to remedy the errors. NOTEDo not proceed with the installation of VCM until the Foundation Checker is able to run all the checks with no errors. You will most commonly encounter the Foundation Checker as part of the Installation Manager. If you are using this manual in the context of installing VCM, see "Reviewing the Foundation Checker System Checks" on page 13 for information about evaluating the results. However, you can run the Foundation Checker as a standalone application. The most common scenarios for installing and running the standalone application are as follows: n If you are checking a designated Collector machine in advance of VCM installation. n If you are adding a Collector to your VCM configuration and want to check the new machine in advance of installation. Chapter 2 and Chapter 3 of this manual provides information about installing and running the standalone version of the Foundation Checker. IMPORTANT If you install and run the Foundation Checker before installation, it is important to uninstall the Foundation Checker before running the Installation Manager. If you do not uninstall, the Installation Manager will generate errors or consider the installation an upgrade and fail. VMware, Inc. 7 vCenter Configuration Manager Foundation Checker User's Guide 8 VMware, Inc. Installing Foundation Checker 2 The Foundation Checker is run as part of the VCM Installation Manager application. However, you can install a standalone version on your designated Collector machine to verify a VCM-ready configuration in advance of the full VCM installation. To use Foundation Checker as a standalone application, you can install the Foundation Checker tool using the Installation Manager or download the Foundation Checker application from the Download VMware vCenter Configuration Manager. Do not install a standalone version of Foundation Checker on a machine that is already running VCM. NOTEIf you received Foundation Checker from a source other than the Installation Manager, see "Running Foundation Checker" on page 11 for instructions. Take care to use the version of the Foundation Checker that supports the specific version of VCM you are installing. Installing the Standalone Version of Foundation Checker 1. Insert the installation CD into the machine on which you are installing Foundation Checker. The Installation screen appears. NOTE If the Installation screen does not appear automatically or if you are installing from a network location, navigate to the root directory on the CD or share and double-click setup.exe. 2. Click Run Installation Manager. The Introduction page appears. 3. Click Next. The License Agreement appears. 4. Select I accept the terms in the license agreement, and also indicate that you are an authorized agent or end user and that you have read the terms of the agreement. 5. Click Next. After identifying any components already installed on the machine, the Select Installation Type page appears. 6. Select the Advanced Installation check box to expand the installation options. 7. To install only the Foundation Checker, clear all the check boxes and then select Foundation Checker in the Tools list. 8. Click Next. The Gathering System Information page appears. The Installation Manager verifies that the machine has sufficient resources to support the Foundation Checker. 9. Click Next. The Configure Components page appears. VMware, Inc. 9 vCenter Configuration Manager Foundation Checker User's Guide 10. Use the default location or to change the location where the Foundation Checker tool is to be installed, type a new path in the text box or click Change to browse to the new location. 11. Click Next. The Install Components page appears. 12. Click Install. 13. When you are notified that the process is completed, click Finish. The application is installed. Downloading the Standalone Foundation Checker 1. Log on to the Download VMware vCenter Configuration Manager (http://downloads.vmware.com/d/info/datacenter_downloads/vmware_vcenter_configuration_ manager/5_0). 2. Download the Foundation Checker file. You must run the version of Foundation Checker associated with the version of VCM you are planning to install. 3. If the file does not self-extract and run, unzip the downloaded file. 4. Open a command prompt and browse to the location of the FoundationChecker.console.exe. See "Running Foundation Checker" on page 11 for more information. 10 VMware, Inc. Running Foundation Checker 3 After Foundation Checker has been installed, you can run it on the machine you are validating. The standalone Foundation Checker is run from a command prompt. 1. Open a command prompt window. 2. At the command prompt, go to the directory where VCM Foundation Checker is installed. For example, c:\Program Files\VMware\VCM\Tools\FoundationChecker. Or, if you are working with downloaded and unzipped files from the Download VMware vCenter Configuration Manager web site, go to the directory where the unzipped files reside. 3. Type FoundationChecker.console.exe -v -dispxform. The -v command directs the application to run in verbose mode, displaying status of the checks as they run. The -dispxform command launches the Foundation Checker Results page, providing information about any changes you may need to make to prepare your machine for an installation. See "Evaluating the Results" on page 14 for more information. VMware, Inc. 11 vCenter Configuration Manager Foundation Checker User's Guide Command Prompt Parameters Table 3-1. Foundation Checker Command Parameters Parameter Description -help Use this run-time parameter to display a complete list of available parameters. -v Use this parameter to run the application in verbose mode. You are presented with all application details while performing system checks. -dispxform Use this parameter to display the HTML page which presents the results of your checks after the Foundation Checker has run. -cat Use this parameter to check a particular category of checks. A list of check categories can be found in the Categories.xml file in the Datafiles\Input directory where you installed Foundation Checker. -outputfile Use this parameter with an output file name to output the results to a file. An example parameter is -outputfile c:\program files\VMware\VCM\Tools\FoundationChecker\results.txt. A .txt file is created in the folder where Foundation Checker is installed. This parameter is identical to the so parameter. -so Use this parameter with an output file name to output the results to a file. An example parameter is -so c:\program files\VMware\VCM\Tools\FoundationChecker\results.txt. A .txt file is created in the folder where Foundation Checker is installed. This parameter is identical to the outputfile parameter. -xformresult <filename> Changes the name of the results .xsl file. Defaults to ViewFCResults.xsl if not provided. The output file will be located in the Datafiles\Output directory where you installed the application. Changes the name of the results .xsl file. Defaults to ViewFCResults.xsl if not provided. -inputfile Use this parameter to use an custom input file used to check the machine. As part of the customer support process, VMware may provide a custom input file. -configfile <filename> Changes the name of the config XML file. Defaults to Config.xml if not provided. 12 -indir Use this parameter to specify the root directory for data input. -outdir Use this parameter to specify the output directory for data. -mach Use this parameter to specify the name of the machine on which you want to run the application. -debug Use this parameter to provide a larger list of debug options from running Foundation Checker. The output file is located in the Datafiles\Output directory where you installed the application. VMware, Inc. Reviewing the Foundation Checker System Checks 4 To ensure a successful VCM installation, Foundation Checker performs a series of system checks to verify the existence of various applications and system prerequisites. Components The system checks evaluate the machine for the following component prerequisites. n Operating System n SQL Server 2005 n .NET Framework (3.5.1) n Internet Information Services n SQL Server Reporting Services n Internet Explorer n Microsoft Data Access Components (MDAC) n SQL XML Displayed Information The displayed information includes: n Component: System check name. n Status: Severity level (OK, Warning, or Error). n OK: Indicates the check was successful. No further action is required. n Warning: Indicates that a non-mandatory check has failed. VCM may not install or, if installed, it may not run optimally. n Error: Indicates that a required check has failed and VCM will not install. n Problem: Provides a short description of the problem Foundation Checker identified during the assessment. n Fix: Provides a short description of the remediation steps needed to fix the problem. This field also contains a link to a Help file describing steps you can take to remedy the problem. n Message: Provides a description of what the expected values are for this System Check. VMware, Inc. 13 vCenter Configuration Manager Foundation Checker User's Guide Evaluating the Results The system check results are saved as an HTML file. The HTML file is automatically displayed at the end of the checking process when the Foundation Checker is run with the -dispxform parameter. You can also view the file using the following procedure. 1. Open the FCResult.htm file. The default location for the file is the Datafiles\Output directory where you installed Foundation Checker. 2. Click any of the OK, Error, or Warning links to expand the list of displayed checks for each component. Click on Click here for more information to view the steps for correcting any errors or warnings. See the following example: NOTEVMware recommends that you address all Errors and review all Warnings. Warnings provide valuable information regarding configuration settings that may impact VCM performance. IMPORTANT If you install and run the Foundation Checker before installation, it is important to uninstall the Foundation Checker before running the Installation Manager. If you do not uninstall, the Installation Manager will generate errors or consider the installation an upgrade and fail. 14 VMware, Inc. Reviewing the Foundation Checker System Checks Other Troubleshooting Options Additional troubleshooting options are as follows. Table 4-1. Other Troubleshooting Options Problem Resolution After running the Foundation Checker, the Carefully review and apply the configuration settings provided in the results file displays a large number of Hardware and Software Requirements, “Chapter 4: Software and Operating errors. System Requirements – Collector Machines”. Run the Foundation Checker again. I receive errors when I run the Foundation Reboot the machine and run Foundation Checker again. Checker on a machine that has previously run the Foundation Checker without errors. Escalating Issues If the steps provided to resolve the system check failures do not solve the warnings or errors, contact VMware Customer Support. Be prepared to provide the contents of the following folders. n FoundationChecker n _csi_installation The Support team will use these files to evaluate your system checking errors. The folders are located in the installing user’s Documents and Settings temporary folder, located under C:\Documents and Settings\john.doe\Local Settings\Temp, or use %Temp%. VMware, Inc. 15 vCenter Configuration Manager Foundation Checker User's Guide 16 VMware, Inc.