Compaq logo

Revision and Configuration Management Data Collector for Windows NT

User Guide

December 2000

This document provides information for installing and using the Revision and Configuration Management Data Collector software for Windows NT.

Revision/Update Information: This manual replaces the manual for the Revision and Configuration Data Collector Version 3.0
for Windows NT

Operating System and Version: Microsoft Windows NT 4.0

Software Versions: RCM Server Version 3.4
RCM Data Collector Version 3.1 [BL50] for
Windows NT

December 2000

© 2000 Compaq Computer Corporation.

COMPAQ and the Compaq logo Registered in U.S. Patent and Trademark Office.

AlphaServer, DECevent, and FX!32 are trademarks of Compaq Information Technologies Group, L.P. Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation. Intel is a registered trademark of Intel Corporation. All other product names mentioned herein may be trademarks of their respective companies.

Confidential computer software. Valid license from Compaq required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license.

Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF THIS INFORMATION REMAINS WITH RECIPIENT. IN NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE OR OTHER DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION OR LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

The limited warranties for Compaq products are exclusively set forth in the documentation accompanying such products. Nothing herein should be construed as constituting a further or additional warranty.

Compaq service tool software, including associated documentation, is the property of and contains confidential technology of Compaq Computer Corporation. Service customer is hereby licensed to use the software only for activities directly relating to the delivery of, and only during the term of, the applicable services delivered by Compaq or its authorized service provider. Customer may not modify or reverse engineer, remove or transfer the software or make the software or any resultant diagnosis or system management data available to other parties without Compaq’s or its authorized service provider’s consent. Upon termination of the services, customer will, at Compaq’s or its service provider’s option, destroy or return the software and associated documentation in its possession.

Table of Contents

Preface *

Purpose of this Document *

Intended Audience *

Structure of this Guide *

Document Conventions *

More Information *

Overview *

How Does RCM Work *

Windows NT Systems Supported by RCM *

Installing the RCM Data Collector for Windows NT *

RCM Data Collection Prerequisites *

Skills Required to Use RCM *

Installing the RCM Data Collection Utilities *

Deinstalling the RCM Data Collector for Windows NT *

Performing an RCM Data Collection *

Scheduling and Executing the RCM Data Collection *

Performing a Scheduled Data Collection *

Executing the Data Collection Manually *

Transferring RCM Data Indirectly *

Why Transfer Data Indirectly *

Manually Transferring Data *

Sending Data to Compaq Services *

RCM Technical Support *

RCM Technical Support *

Contact the RCM Team *

 

 

Preface

Purpose of this Document

This document describes the procedures for installing and running the Revision and Configuration Management Data Collector software on a Microsoft Windows NT system.

Intended Audience

This guide is intended for CompaqÔ Services personnel who will install and use RCM to collect revision and configuration data from customer systems.

Structure of this Guide

This guide is divided into the following sections:

Document Conventions

This guide uses the following document conventions:

Convention

Description

Courier

File names, commands, and user input are shown in courier typeface.

Italics

Italics emphasize important information and indicate menu buttons, menu items, field names, section titles, and document titles.

More Information

For more information on the RCM tool, see the following URL:

http://www.support.compaq.com/svctools/rcm/



1 Overview

This chapter provides an overview of the Revision and Configuration Management Data Collector software for Windows NT. It contains the following sections:

How Does RCM Work

Revision and Configuration Management (RCM) provides revision and configuration reporting for Intel and Compaq AlphaServer systems running Windows NT. RCM uses the following components to perform the data collection on a Windows NT system:

The system configuration snapshot (collected data) is automatically transported to Compaq Services using e-mail or ftp. The data is then loaded onto the RCM Server, which is maintained in Compaq by the RCM team.

The RCM Server incorporates a web-based user interface which enables authorized personnel in Compaq Customers Services to view detailed configuration and change reports. Customers with premium service contracts are able to view these configuration and change reports through the Electronic Site Management Guide (eSMG). Further information on using the RCM Server is available to Compaq Services personnel in the RCM Server User Guide.

Windows NT Systems Supported by RCM

RCM supports the following systems, running Windows NT 4.0 (up to and including Service Pack 6):



2 Installing the RCM Data Collector for Windows NT

This chapter describes how you can install and deinstall the RCM Data Collector for a Windows NT system. It contains the following sections:

RCM Data Collection Prerequisites

The following table lists the requirements for installing and running the RCM Data Collector on a Windows NT system. Requirements may vary according to the system.

Area

Requirements

Disk Space

10 MB of free disk space on the system on which you install the RCM Data Collector.

Account Settings

  • Valid user name and password
  • Administration privileges
  • Access Privilege to Log on as a service

Software

RCM Data Collector for Windows NT kit Version 3.1

For AlphaServer systems only:

FX!32™ - If you want to install the Compaq Survey Utility with the RCM kit, you need to have FX!32 installed on the system. FX!32 can be obtained from the following URL:

http://www.support.compaq.com/amt/fx32/

The latest version of the RCM Data Collector software is available on the Service Tools CD-ROM.

Note: For Windows NT installations on AlphaServer systems only, FX!32 must be already installed on the target system. You will see the following two error messages during installation and system reboot:

You can safely ignore these error messages as they relate to 'Intel Industry Standard' calls which are not available in FX!32.

Skills Required to Use RCM

To collect RCM data and generate RCM reports, you should have practical experience in the following areas:

Installing the RCM Data Collection Utilities

This section describes how to install the RCM Data Collector for Windows NT kit. The installation procedure installs the RCM Data Collector, the RCM Service, and the Compaq Survey Utility components on a Windows NT system. Please see the How Does RCM Work section for information on each component.

Note: Please refer to the RCM Data Collection Prerequisites section for information on the prerequisites for installing this kit, including user account requirements.

To install the RCM Data Collector for Windows NT kit, do the following:

  1. Deinstall any existing version of the RCM Data Collector for Windows NT before installing a new version. See the Deinstalling the RCM Data Collector for Windows NT section for more information.
  2. Create a new directory where you want to install the RCM Data Collector for Windows NT kit. This directory must be accessible from all the systems on which you want to install the kit.
  3. Copy the RCM Data Collector for Windows NT kit into the new directory.
  4. Extract the kit files by entering either of the following commands:
    rcm_nt_vn_na.exe or
    rcm_nt_vn_ni.exe
    where:

This command creates an installation directory with the same name as the kit, for example,
rcm_nt_v3_1a

  1. Execute the installation procedure by entering the following command in the installation directory:
    setup.exe
    A graphical user interface is displayed and you can follow the instructions on screen to continue the RCM kit installation process.
  2. You are prompted for the following configuration information:

Prompt

Description

Company Name

The name of your company owning the system.

Contact Name

The name of your contact in the company owning the system.

Contact Telephone

The telephone number of your contact in the company owning the system.

Contact E-mail

The e-mail address of your contact in the company owning the system.

Technical Account Manager

The name of the technical account manager.

Technical Account Manager
E-mail

The e-mail address of the technical account manager (must be @compaq.com).

Customer Access ID

The RCM access identifier for this system. For information on using access identifiers, refer to the RCM Server User Guide.

Transport Option

Method for returning the collected data to Compaq Services. It can be one of the following:

Email - automatically email the data, using SMTP or MAPI (Messaging API).

  • SMTP Server - The hostname of the SMTP server in the format of hostname[:port], for example, smtp.company.com:25. Contact your local administrator for this information.
  • SMTP Email Address – An e-mail address required for SMTP authentication. Usually your normal email address suffices. Contact your local administrator for this information.

FTP - automatically ftp the data.

None - do not automatically transport the data. If you wish to transfer collected data to Compaq Services manually, see the Transferring RCM Data Indirectly section.

Maximum Archives

The maximum number of old data collections that are kept in the installationdirectory\rcm_archive\ directory.

Local Transport Option

Method for sending a copy of the collected data to a local location. It can be one of the following:

Email - email the data.

  • SMTP Server – The hostname of the SMTP server in the format of hostname[:port], for example, smtp.company.com:25. Contact your local administrator for this information.
  • SMTP Email Address – An e-mail address required for SMTP authentication. Usually your normal email address suffices. Contact your local administrator for this information.
  • Destination Address – The email address to which a local copy of the data will be sent.

FTP - Ftp the data. You must specify a login name, a password, and upload directory.

None - Do not transport the data a local location.

Collection Frequency

The frequency at which you want to schedule data collections. It can be one of the following:

Weekly - run the collection weekly, specify which day of the week.

Monthly - run the collection monthly, specify which day of the month.

Quarterly - run the collection quarterly.

System Serial Number

The serial number of the target system. If the Data Collector software does not detect this number, then you will be prompted to enter it.

  1. You are prompted Do you want to install the Survey Utility now? Click the Yes button.
  2. If Compaq Survey Utility is already installed, a warning message is displayed. Click the No button as you do not need to reinstall this utility.
  3. At the end of the installation, you are given the option to install the RCM Service. You only need to install this service if you want to run automatic RCM data collections.
    If you want to install the service, check the
    Yes, I want to install the RCM (NT) service now checkbox.
  4. You are prompted Logon to the RCM Service using a User or System account. Enter U for user. Please ensure that your account has the privileges listed in the RCM Data Collection Prerequisites section.

This concludes the RCM Data Collector kit installation process.

Deinstalling the RCM Data Collector for Windows NT

To deinstall the RCM Data Collector for Windows NT kit, do the following:

  1. To remove the RCM Service, enter the following command, in the directory where you installed the kit:
    rcm remove
  2. To remove the rest of the kit, from the Start Menu, first select the Programs, Compaq Service Tools, and Revision & Configuration Management menu options, and then select the Uninstall RCM Data Collector for Windows NT menu item.
  3. Delete all files in the directory in which you installed RCM.
  4. Delete the directory in which you installed RCM.



3 Performing an RCM Data Collection

This chapter describes how you schedule and execute an RCM data collection for a Windows NT system. It contains the following sections:

Scheduling and Executing the RCM Data Collection

When you install the RCM Data Collector, you select a schedule for the RCM data collection. If you install the RCM Service, the Data Collector will execute automatically according to that schedule.

To check or change the scheduling or transport options at any time, you need to reinstall the Data Collector.

The following sections describe how scheduled collections run, and how you can execute a data collection manually. If you selected to transfer data indirectly, see the Transferring RCM Data Indirectly section for further information on how to return the data to Compaq Services for analysis.

Performing a Scheduled Data Collection

When the Data Collector is installed, by default it schedules the data collection to run on the first day of each month, at 3:40 a.m. local time. You may have changed these options when you installed the Data Collector.

If you install the RCM Service, the Data Collector will execute automatically at each scheduled interval and each time the system is rebooted.

Each time a data collection is complete, any transfer options you selected during the Data Collector installation are automatically executed.

Note: If you do not install the RCM Service utility, the data collection will not run automatically.

Executing the Data Collection Manually

If you want to execute the data collection manually, you do not need to install the RCM Service utility.

To execute the data collection manually, enter the following command in the directory where you installed the Data Collector:

rcm all

This command will start the data collection immediately. When the data collection is complete, any transfer options you selected during the data collector installation are executed.

Transferring RCM Data Indirectly

This section describes how to indirectly transfer data collected by RCM to Compaq Services for analysis. It describes the following topics:

Why Transfer Data Indirectly

Some systems running RCM do not have a direct connection to the Internet. For example, the target system (or systems) may be one of the following:

In these situations, you can manually transfer the collected data to a system that has a direct Internet connection. After the data is transferred, you need to send the data to Compaq Services for analysis.

Manually Transferring Data

When the data collection is completed, the collected data is saved into a .zip file in the following directory:
installationdirectory\manual\

The .zip file has the following name:
rcmn-machinename-yyyymmdd-hhmmss.ZIP

You can copy this file to a system with a direct Internet connection.

Note: Do not change the name of the .zip file or its extension.

Sending Data to Compaq Services

When you have copied the .zip file containing the collected RCM data to a system with an Internet connection, you can send the data to Compaq Services using either of the following options:

Note: Do not change the name of the file, or its extension while sending it to Compaq Services. If you do, the automatic process for receiving the file will not work.

E-mail

To mail the data using an e-mail application, send the file as an attachment to the following address:

rcm.data@compaq.com

FTP

To ftp the data, ftp the file in binary mode, using anonymous ftp, to the following location:

rcm.support.compaq.com/to_rcm/



4 RCM Technical Support

This chapter provides information on accessing RCM technical support resources. It contains the following sections:

RCM Technical Support

If you have a problem using any aspect of RCM, either with the Data Collectors, data transport, or the user interface, please contact us at the following URL:

rcm.support@compaq.com

To help us resolve any problems quickly, please send us the following information:

  1. Your name, RCM user name (registration name), and contact details.
  2. The access ID (entered during data collector installation), hostname, and serial number of the system on which you collected data.
  3. The platform, system serial number, operating system version, data collection utility versions, and build numbers.
  4. The platform, operating system name and version, and browser name and version on the system from which you accessed the RCM Server.
  5. Details of the problem, including any log files, error files, or messages generated by the system.

Contact the RCM Team

The RCM team welcome any queries or comments that you may have about RCM. If you have questions or comments, or you would like to participate in future field tests or early release programs, contact the Product Manager, Vincent Jordan.

rcm.feedback@compaq.com