Dell System E-Support Tool Version 3.2 User Manual

Dell System E-Support Tool

Version 3.2

User’s Guide

Notes and Cautions

NOTE: A NOTE indicates important information that helps you make better use of

your computer.

CAUTION: A CAUTION indicates potential damage to hardware or loss of data if

instructions are not followed.

_________________

Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden.

Trademarks used in this text: Dell™, the DELL logo, and OpenManage™ are trademarks of Dell Inc. Microsoft Corporation in the United States and/or other countries. VMware Server™ is a trademark of VMware Inc in the United States and/or other jurisdictions.

Server Administrator includes software developed by the Apache Software Foundation (apache.org). Server Administrator utilizes the OverLIB JavaScript library. This library can be obtained from bosrup.com.

Other trademarks and trade names may be used in this document to refer to either the entities claiming the marks and names or their products. Dell Inc. disclaims any proprietary interest in trademarks and trade names other than its own.

May 2012

and Windows Server® are either trademarks or registered trademarks of Microsoft

is a registered trademark and ESX

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . 7

What’s New In This Release. . . . . . . . . . . . . . . . 7

Supported Platforms and Operating Systems . . . . . . . 8

Installation Types

Other Documents You May Need

. . . . . . . . . . . . . . . . . . . . . 8

. . . . . . . . . . . . . 9

2 Installing, Upgrading, and

Running DSET On Windows

Operating System . . . . . . . . . . . . . . . . . . 11

Installation Prerequisite For Windows

Operating System . . . . . . . . . . . . . . . . . . . . 11

Creating One-time Report (Zero Footprint Report Collection) On Windows Operating System

Using GUI For Windows Operating System

Using CLI For Windows Operating System

Permanently Installing DSET and Generating Report On Windows Operating System

Using GUI For Windows Operating System

Using CLI For Windows Operating System

Clearing Hardware Logs On Windows Operating System

. . . . . . . . . . . . . . . . . . . . 12

. . . . . 14

. . . . . . . . . 15

. . . . . 17

. . . . . . . . . . . . . . . . . . . . 17

. . . . 12

. . . . 15

Contents 3

Using Installer For Windows

Operating System . . . . . . . . . . . . . . . . . . 17

Using GUI For Windows Operating System. . . . . 18

Extracting MSI Package For Large Site Automated Deployment

. . . . . . . . . . . . . . . . . 19

Upgrading DSET On Windows Operating System . . . . 19

Using The Installer

. . . . . . . . . . . . . . . . . 20

3 Installing, Upgrading, and

Running DSET On Linux

Operating System . . . . . . . . . . . . . . . . . . 23

Installation Prerequisite For Linux

Operating System. . . . . . . . . . . . . . . . . . . . . 23

4 Using DSET . . . . . . . . . . . . . . . . . . . . . . 35

4 Contents

Device Dependency On Linux Operating System

. . . . 24

Creating One-time Report (Zero Footprint Report Collection) On Linux Operating System

. . . . . 25

Permanently Installing DSET On Linux Operating System

. . . . . . . . . . . . . . . . . . . . . 27

Installing or Upgrading DSET Collector and DSET CIM Provider

Installing DSET Collector

. . . . . . . . . . . . . . . . . 27

. . . . . . . . . . . . . . 29

Installing DSET CIM Provider . . . . . . . . . . . . 29

Clearing Hardware Log On Linux Operating System

. . . . . . . . . . . . . . . . . . . . . 30

Upgrading DSET On Linux Operating System . . . . . . 31

Generating Basic and Advanced Report . . . . . . . . 35

CLI Options . . . . . . . . . . . . . . . . . . . . . . . . 36

For Windows Operating System

For Linux Operating System

. . . . . . . . . . 36

. . . . . . . . . . . . 36

List of CLI Options. . . . . . . . . . . . . . . . . . 36

Usage Examples

. . . . . . . . . . . . . . . . . . 41

Viewing DSET Report

. . . . . . . . . . . . . . . . . . 42

5 Maintaining DSET . . . . . . . . . . . . . . . . . . 43

Modifying Installed DSET Features . . . . . . . . . . . 43

For Windows Operating System

. . . . . . . . . . 43

For Linux Operating System . . . . . . . . . . . . 44

Repairing DSET . . . . . . . . . . . . . . . . . . . . . 44

6 Uninstalling DSET . . . . . . . . . . . . . . . . . . 45

Using GUI For Windows Operating System . . . . . . . 45

From the Start Menu

From the Windows Add or Remove

Programs Wizard . . . . . . . . . . . . . . . . . . 45

From the Application Maintenance Window

Using CLI For Windows and Linux Operating Systems

For Windows Operating System

For Linux Operating System

. . . . . . . . . . . . . . . . 45

. . . . 45

. . . . . . . . . . . . . . . . . . . . 46

. . . . . . . . . . 46

. . . . . . . . . . . . 46

A Error Codes . . . . . . . . . . . . . . . . . . . . . . . 27

DSET Error Codes . . . . . . . . . . . . . . . . . . . . 27

Installer Error Codes

. . . . . . . . . . . . . . . . . . . 28

Contents 5

For Windows Operating System . . . . . . . . . . 28

For Linux Operating System

. . . . . . . . . . . . . 28

6 Contents

Introduction

Dell System E-Support Tool (DSET) is a utility that collects configuration and log data for various chassis hardware, storage, software, and operating system components of a Dell PowerEdge server and consolidates the data into a .zip file.

What’s New In This Release

• Separate DSET Collector option for remote report collection from the following agents running on a remote server over the network:

– DSET Provider

– Dell OpenManage Server Administrator

– VMware ESX and ESXi

• Filtering sensitive data (Personally Identifiable Information (PII)) from the report.

• Support for the following Dell 12th generation PowerEdge servers:

–M620

– R620

– T620

– R720

– R720xd

• Support for Dell PERC storage controllers in 12th generation PowerEdge servers. For more information, see

• Enhanced report GUI

• Enhanced command line parameters.

• Option to automatically upload the generated report to Dell Technical Support.

• No support for 8th generation servers.

Readme

Introduction 7

Supported Platforms and Operating Systems

For information on the supported platforms and operating systems (Windows and Linux), see the Readme available with the installer or go to

support.dell.com/manuals. Click Software Serviceability Tools Dell System E-Support Tool.

Installation Types

You can install DSET in the following methods:

•

Create Local Diagnostic Report Local System DSET Report

the local system without permanently installing the application.

•

DSET Collector and DSET Common Information Model (CIM) Provider

system. The DSET Provider provides data using Windows Management Instrumentation (WMI) service (for Windows) and Open-pegasus or Small Footprint CIM Broker (SFCB) (for Linux). This data is collected locally or remotely using the DSET Collector. For Windows, any other WMI collection tool can be used and for Linux, other CIM clients can be used.

•

DSET Collector

collects the data (provided by various providers) available from local or remote systems.

— Installs DSET collector and DSET CIM provider in the local

NOTE: This option installs DSET permanently in the system.

— Installs DSET Collector in the local system that

(for Windows) and

(for Linux)— Generates a DSET report of

Create one-time

NOTE: This option installs DSET permanently in the system.

•

DSET CIM Provider

that provides data using WMI service (for Windows) and Open-pegasus or SFCB (for Linux).

NOTE: This option installs DSET permanently in the system.

8 Introduction

— Installs DSET CIM Provider in the local system

Installing, Upgrading, and Running DSET On Windows Operating System

This chapter provides information to install DSET on Windows operating system. You can install and run DSET using the GUI or the Command Line Interface (CLI).

Installation Prerequisite For Windows Operating System

Before installing DSET, make sure that:

• WMI service is installed and running.

– If WMI service is stopped, DSET starts the service automatically and

continues with installation.

– If WMI service is disabled, installation of DSET terminates with an

error message.

For installing DSET Provider, in addition to WMI, also make sure that:

• Operating system is between Windows 2003 and Windows 2008.

• Platform is Dell PowerEdge 9, 10, 11, or 12th generation server.

• OpenManage Server Administrator (if installed) version is between 5.5 to

7.0.

For installing DSET Collector, make sure that Windows operating system is Windows XP or later.

Installing, Upgrading, and Running DSET On Windows Operating System 11

Creating One-time Report (Zero Footprint Report Collection) On Windows Operating System

DSET enables you to generate configuration report without permanently installing DSET. This is also known as zero footprint report collection. After the report is generated and saved on the system, all files used to create the report are removed from the system.

Using GUI For Windows Operating System

To run DSET and create one-time report:

NOTE: You must be logged in as an Administrator or have administrator privileges

to run DSET. For Windows Server 2008 and later, you must be running DSET CIM with full administrator privileges.

Run the

The

Wizard

Click

The

Select the

The Readme Information is displayed.

Click

The

Dell_DSET_(Version Number).exe

Welcome to the Dell System E-Support Tool (3.2) Installation

window is displayed.

License Agreement

I accept the license agreement

Installation Type

is displayed.

window is displayed.

file.

and click

Next.

Select

Create Local Diagnostic Report

The

Report Settings

Enter the following:

•

Report Name or Full Path to Save the Report

filename or the complete path with the filename to save the generated report. If you mention only the filename, the report is saved to the default location.

NOTE: You can only save the report to an internal network path and not a

HTTP path.

12 Installing, Upgrading, and Running DSET On Windows Operating System

window is displayed.

and click

— Enter only the

NOTE: The default location for Windows (x86) systems is C:\Program Files\Dell and

for Windows (x86_64) systems is C:\Program Files (x86)\Dell.

•

Filter out sensitive data from the report

— Select this option to filter

the sensitive data (PII) from the report.

To include any of the sensitive data to the report, specify ’No’ in the

C:\Program Files(x86)\Dell\AdvDiags\DSET\config\ privacy_presetlist.cfg Files\Dell\AdvDiags\DSET\config\privacy_presetlist.cfg

file (in 64-bit systems) or

C:\Program

file (in 32-

bit systems).

The list of sensitive data (PII) are:

• Host Name

•IP Address

•Subnet Mask

•Default Gateway

• MAC Address

•DHCP Server

•DNS Server

• Processes

• Environment variables

•Registry

•Logs

• iSCSI Data

•

At request upload the report to Dell Technical Support

— Select this option to upload the report to the Dell Technical Support when requested.

Click

The

Report Settings to Skip Specific Information

window is displayed.

Installing, Upgrading, and Running DSET On Windows Operating System 13

Clear the options for which information is not required to be collected in the report. The options are:

• Hardware Information

• Storage Information

• Software Information

•Log Files

Select the

Gather Advanced Log Files Information

option to collect all

the log information in the report.

NOTE: Selecting the Advanced option may create large size reports. When

selected, the Log Files are also included.

Click

The

Ready to Collect Report

Click

Start

The

Updating System

window is displayed indicating the status of report

window is displayed.

collection.

Click

Finish

Dell System E-Support Tool (3.2) report has been

successfully created

window.

The report is saved on the desktop or at the specified location.

To view the report, unzip the .zip file using the password ’dell’. For more information, see "Viewing DSET Report".

Using CLI For Windows Operating System

To run DSET, run the following command:

•

Dell_DSET_(version number).exe REPORTNAME=<NAME> COLLECT=<hw,sw,st,lg,ad>

•

Dell_DSET_(version number).exe REPORTNAME=<NAME> COLLECT=<hw,sw,st,lg,ad> UPLOAD=auto /qn

silent Zero Footprint report collection.

where:

<NAME> is a valid Windows filepath, filename, or both filepath and filename

<hw,sw,st,lg,ad> are independent report options that can be specified

together with a comma separator without any space.

14 Installing, Upgrading, and Running DSET On Windows Operating System

— This invokes the GUI.

— This is for

hw = All hardware information

sw = All software (and operating system) information

st = All storage information

lg = All logs from the operating system and various applications

ad = Include advanced log items

For more information on the commands, see "Using DSET".

Permanently Installing DSET and Generating Report On Windows Operating System

Before installing DSET, make sure that the installation prerequisites are met. For more information, see "Installation Prerequisite For Windows Operating System".

Using GUI For Windows Operating System

To permanently install DSET on Windows operating system:

Run the

The Welcome to the Dell System E-Support Tool (3.2) Installation Wizard window is displayed.

Click

The

Dell_DSET_(Version Number).exe

License Agreement

is displayed.

file.

Select

I accept the license agreement

The Readme Information is displayed.

Click

The

Installation Type

Select

Install DSET Components

The

Select Installation Type

Installing, Upgrading, and Running DSET On Windows Operating System 15

window is displayed.

and click

window is displayed.

and click

Next.

+ 35 hidden pages