Dell System E-Support Tool (DSET) Version 3.
Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2012 Dell Inc.
Contents Notes, Cautions, and Warnings...................................................................................................2 1 Introduction..................................................................................................................................5 What's New In This Release....................................................................................................................................5 Supported Platforms And Operating Systems..........................
Generating Basic And Advanced Report................................................................................................................23 Report Filtering.................................................................................................................................................24 CLI Options..............................................................................................................................................................
Introduction 1 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.
DSET Collector — Installs DSET Collector in the local system that collects the data (provided by various providers) available from local or remote systems. • NOTE: This option installs DSET permanently in the system. • DSET CIM Provider — Installs DSET CIM Provider in the local system that provides data using WMI service (for Windows) and Open-pegasus or SFCB (for Linux). NOTE: This option installs DSET permanently in the system.
Installing, Upgrading, and Running DSET On Windows Operating System 2 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.
5. Select Create Local Diagnostic Report and click Next. The Report Settings window is displayed. 6. Enter the following: – Report Name or Full Path to Save the Report — Enter only the 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. Click Finish in the Dell System E-Support Tool (3.3) 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 — This invokes the GUI. • Dell_DSET_(version number).
– DSET Collector – DSET CIM Provider The Destination Folder window is displayed. 7. Click Browse and select the folder to install DSET or use the default location and click Next. The User Information window is displayed. NOTE: The default location for Windows (x86) systems is :\Program Files\Dell and for Windows (x86_64) systems is :\Program Files (x86)\Dell 8. Enter the following: – Full Name — Enter your full name. – Organization — Enter your organization information.
Clearing Hardware Logs On Windows Operating System DSET clears Dell hardware logs (Embedded System Manager logs) from the system without permanently installing the application. You can clear hardware logs using the installer or from the Start menu. Using Installer For Windows Operating System To clear hardware logs from the system: NOTE: This does not install DSET permanently. 1. Run the Dell_DSET_(Version Number).exe file. 2. Click Next. The Welcome to the Dell System E-Support Tool (3.
Navigate to DSET 3.3 → Clear ESM Logs in the Start menu. 1. The Clear ESM Logs command window displays the following message: *Going to clear the ESM Logs now Do you want to continue? Y/N: 2. Enter Y to clear the logs. The following messages are displayed: System event logs are cleared. Press Any Key To Continue 3. Press any key. The command window closes. Extracting MSI Package For Large Site Automated Deployment To extract the MSI file from DSET EXE: 1. Run the Dell_DSET_(Version Number).exe file.
NOTE: If you do not want to upgrade, click Cancel to exit the installer. 3. Click Upgrade to upgrade to DSET version 3.3. The License Agreement window is displayed. NOTE: For upgrading from versions 2.2 and lower, only DSET Collector and DSET CIM Provider permanent install option is available. 4. Follow steps 3 to 12 provided in Using GUI For Windows Operating System. Using CLI To automatically upgrade to DSET 3.3 using CLI, at the prompt, run the command: • Dell_DSET_(Version Number.
Installing, Upgrading, And Running DSET On Linux Operating System 3 This section provides information to install, upgrade and run DSET on Linux operating systems. During installation, DSET checks if OpenPegasus CIMOM or SFCB service is installed or running. The following table provides more information. Table 2.
Device Dependency • QLogic Fibre Channel Controller • • Default Behavior (if dependency is not met) a. Click Downloads → Dell. b. Click the adapter model number. c. Click Linux from the Current Drivers section and download the Applications Kit. Install libhbaapi rpm available in the operating system DVD. Fibre Channel Controllers are not SNIA API for Linux drivers. To displayed in DSET report download this, access the QLogic website at qlogic.com. a. Click Downloads → Fibre Channel Adapters. b.
5. Enter y if you want to use default file name for the report when the following message is displayed. Else, enter n to specify a file name: Do you want store this report in a default name and location [y|n]: If you enter n, provide the report name or full path where the generated report must be saved. If the path is not specified, the report is saved in the root directory. NOTE: You can only save the report to an internal network path and not a HTTP path. 6.
• DSET Collector and DSET CIM Provider • DSET Collector Only • DSET CIM Provider Only NOTE: You must be logged in as root to install DSET. 1. At the Linux shell prompt, run the ./dell-dset-lx(bit)-(Version Number).bin file. The License Agreement is displayed along with the following message: Do you agree to the above license terms? ('y' for yes | 'Enter' to exit): 2. Enter y. The installation types are displayed. The following table provides the installation types: Table 4.
– If you have selected DSET Collector and DSET CIM Provider option, then the following message is displayed: DSET installation completed successfully. Enter '/usr/sbin/ dellsysteminfo' from a terminal shell prompt to create a report file – If you have selected DSET Collector only option, then the following message is displayed: The DSET Collector installation completed successfully.
• DSET 3.2 NOTE: For versions lower than DSET 1.8 automatic upgrade to DSET 3.3 is not possible. When the DSET 3.3 installer is run, the installer terminates with an error message. In such cases, uninstall previous versions of DSET and then install DSET 3.3. NOTE: DSET does not require a system reboot. To automatically upgrade to DSET 3.3 on Linux operating system: 1. At the Linux shell prompt, run the ./dell-dset-lx(bit)-(Version Number).bin file.
NOTE: • If DSET version 2.2 or lower is currently installed in the system and CIMOM services are not installed or running, then DSET cannot be silently upgraded to version 3.3. • For DSET 3.2: – If parameter is provided in the command, then the currently installed DSET is uninstalled completely and the specified component of DSET 3.3 is installed.
Using DSET 4 You can generate reports on local and remote systems: • Local systems using GUI or CLI • Remote systems using CLI The data collection is allowed for the following operating systems on client and server: • Windows client to Windows server • Windows client to Linux server • Linux client to Linux server NOTE: The data collection is not allowed from Linux Client to Windows Server. Event viewer and application logs are generated that can be used for troubleshooting purpose.
Report Filtering During the DSET report collection, you can Enable Report Filtering option to filter the following data: • Host Name • IP Address • Subnet Mask • Default Gateway • MAC Address • DHCP Server • DNS Server • Processes • Environment variables • Registry • Logs • iSCSI Data To include any of the data to the report, specify ’no’ in the following file: • For Windows — :\Program Files (x86)\Dell\AdvDiags\DSET\config\ privacy_presetlist.
Change directory to /opt/dell/advdiags/dset/bin and run the command dellsysteminfo.sh [Options] List Of CLI Options The -h option displays the list of available CLI options. To view the options, run the following command: • For Windows: DellSystemInfo.exe -h • For Linux: dellsysteminfo -h Table 5. : Command and description Command Description -h, --help Display the help text and exit. -s, --server Specify the server to connect to. Use ’.’ to specify the local server.
Command Description NOTE: If Advance logs option is selected, larger report is created and by default log files (hw, st, sw, lg) are created. -n, --namespace Specify the namespace to connect. If left blank, the program selects the best available namespace or specify one of the following options: • • • • • root/dsetcim for DSET — This is the default namespace that is installed with DSET CIM Provider component.
Command Description Enter -a auto to upload the generated report automatically to the Dell Technical Support. Enter -a manual and include the (-r) filename to manually upload the report to the Dell Technical Support. -x, --proxyhost Upload the report to Dell Technical Support specifying proxy details. Enter -xproxy IP or Host name to use the proxy server to upload the report to Dell Technical Support. -y, --proxyusername Enter -y user name of the proxy server used to upload the report.
Data Source DSET Collector on Windows based System DSET Collector on Linux based System ESX with SMASH profile Yes Yes ESXi with OpenManage Server Administrator installed Yes Yes (Only remote) The following table provides information on the data collection supported by DSET for the data source: Table 7.
C:\Program Files\Dell\AdvDiags\DSET\bin> DellSystemInfo.exe -v yes -a auto -r C:\temp\dsetreport.zip • For Linux dellsysteminfo -v yes -a auto -r /opt/dell/myreports/dsetreport.zip NOTE: If -d option is not specified, then hw, st, sw, and lg data categories are collected by default. Example 4: To collect report information and upload to Dell Technical Support using authenticated proxy, run the command: • For Windows C:\Program Files\Dell\AdvDiags\DSET\bin> DellSystemInfo.
Viewing DSET Report You can view the hardware, storage, and software data in the generated report using the GUI. The logs and advanced log information are available in the log files located in the logs folder (part of the .zip file). To view the report: • For Windows, unzip the .zip file using the password ’dell’. • For Linux, copy the .zip file to Windows system and unzip the file using the password ’dell’. After you unzip, read the ReadmeFirst.txt file for instructions to view the report.
Maintaining DSET 5 After installing the DSET application, you can modify the components that are installed. The application maintainance window is available only when DSET permanently installed on your system. You can also reinstall the corrupt files, registry keys, and shortcuts of the application. Modifying Installed DSET Features The installed features that can be modified are: • Common — Installs all the files common to Provider and Collector. • Collector — Installs DSET Collector only.
To modify the installed components silently, run the ./dell-dset-lx(bit)-(Version Number).bin —qi file at the shell prompt. Depending on the DSET components existing in the system and the parameter passed in the command, the following table provides the modify options: Table 8. : Silent Modify Options Currently Installed Parameter Exit Status (Error Code and Description) Component DSET Collector and CIM Provider Yes. (13 — DSET 3.
Uninstalling DSET 6 DSET can be uninstalled using the GUI or the CLI option. Using GUI For Windows Operating System To uninstall DSET, use one of the following options: • From the Start menu • From the windows Add or Remove Programs wizard • From the Application Maintenance window From The Start Menu To uninstall DSET from the Start menu on Windows operating systems: 1. Click Start → Programs (or All Programs) → DSET 3.3 → Uninstall DSET 3.3.
Using CLI For Windows And Linux Operating Systems To uninstall DSET using the CLI, run the following command from the command prompt: For Windows Operating System To uninstall DSET using the CLI, run the following command from the command prompt: Msiexec /x{F34F52B2-DFE0-4103-96BF-771A4BB457F8} The Windows Installer window displays Are you sure you want to uninstall this product? message. Click Yes to uninstall DSET.
7 Error Codes This appendix provides the list of DSET error codes and Installer error codes. DSET Error Codes DSET Collector returns custom error codes on collection of reports. The list of error codes returned by dellsysteminfo are: Table 9. : DSET Error Codes and Description Error Code Name Description Solution 2 DSET_CIM_OPTION_ERROR Incorrect option provided in the command line Check the command line options and provide the valid option.
Error Code Name Description 16 DSET_CIM_SW_COLLECTION_WARN Data of a few software classes are not collected - 17 DSET_CIM_ST_COLLECTION_WARN Data of a few storage classes are not collected - 18 DSET_CIM_INVALID_FILE_NAME_ER ROR Invalid file name is provided or the path to save the report does not exist - 19 DSET_CIM_CLASS_NAME_ERROR Invalid class name is provided for the data collection Check for available class name.
Installer Error Codes For Windows Operating System Custom error codes are not supported in this release. Default MSI error codes are returned. For Linux Operating System The list of error codes are: Table 10. : Installer Error Codes and Description Error Code Description 0 Success 1 Unsupported hardware platform. See the "Supported Hardware Platforms" section in the Readme for the complete list of supported hardware. 2 Unsupported OpenManage Server Administator version is installed on the system.
Error Code Description 15 Silent uninstallation is complete. 16 Silent installation of full DSET is complete. 17 Silent ZFP report collection is complete. 18 User has aborted the installation. 19 Invalid installer option is passed. 20 Failed to install collector rpm. 21 Failed to install provider rpm. 22 User has not selected any option, hence aborted ZFP report collection. 23 Only collector is installed, but user has passed -qn option.
