Dell System E-Support Tool (DSET) Version 3.7.
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. Copyright © 2014 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
Contents 1 Introduction........................................................................................................... 5 Installation Types................................................................................................................................... 5 Other Documents You May Need........................................................................................................ 5 Accessing documents from Dell support site..................................................
Clearing Dell Hardware Logs On Linux Operating System............................................................... 22 Upgrading DSET Application On Linux Operating System................................................................ 23 Upgrading DSET Application Silently On Linux Operating System............................................. 24 4 Maintaining DSET Application..........................................................................25 Modifying Installed DSET Application Features.........
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. This guide provides the steps to install, maintain, upgrade, and uninstall the DSET application on Windows and Linux operating systems.
Accessing documents from Dell support site You can access the required documents in one of the following ways: • Using the following links: – For all Systems Management documents — dell.com/softwaresecuritymanuals – For Remote Enterprise Systems Management documents — dell.com/esmmanuals – For Enterprise Systems Management documents — dell.com/openmanagemanuals – For Client Systems Management documents — dell.com/clientsystemsmanagement – For Serviceability Tools documents — dell.
Port Number Protocol Usage 443 WS-Man Accessing iDRAC For Linux (Ports required for ESX are same as Linux) Table 2.
2 Installing, Upgrading, and Running DSET Application On Windows Operating System This chapter provides information to install DSET application on Windows operating system. You can install and run the application using the GUI or the Command Line Interface (CLI). If you install or upgrade the DSET application on a system having OpenManage Server Administrator version lower than 5.5 or an incompatible application, then an error message is displayed and the installation is not completed.
2. Add the application "omremote.exe" (located in InsallDirectory\bin\utils) to the Firewall exception list. – Managed System: 1. If you have the Windows firewall configured, enable remote administration by running the following command in the command prompt: netsh firewall set service RemoteAdmin For more information on connecting through the Windows firewall, see Microsoft's MSDN website for Platform SDK: • Windows Management Instrumentation (Connecting through Windows Firewall) at http:// msdn.
• Enable Report Filtering — Select this option to filter the data from the report. For the list of data that is filtered, see the “Report Filtering” section in the Dell System E-Support Tool (DSET) User's Guide. • 6. Automatically Upload the Report to Dell — Select this option to upload the report to Dell Technical Support when requested. Click Next. The Report Settings to Skip Specific Information window is displayed. 7. 8.
PRIVACY=yes Filters data from the report. For the list of data that is filtered, see the “Report Filtering” section in the Dell System E-Support Tool (DSET) User's Guide. Usage Examples on silent Zero Footprint report collection: • Example 1: To collect the hardware, software data and upload the report automatically: Dell_DSET_(version number).exe REPORTNAME= ZFPReport1.zip COLLECT= hw,sw UPLOAD=auto • Example 2: To collect the software, storage, logs and report filtering: Dell_DSET_(version number).
The Updating System window is displayed indicating the installation status. 10. To generate the report and/or upload (optional step) : • Run and Collect DSET Report — Select this option to generate the report. • Automatically Upload the Report to Dell — This option is enabled when Run and Collect DSET Report option is selected. Select this option to upload the report to the Dell Technical Support when requested. 11. Click Finish to close the installer.
3. Select the I accept the license agreement and click Next. The Installation Type window is displayed. 4. Select Clear Dell Hardware Logs and click Next. The User Information window is displayed. 5. Enter the following: • 6. Full Name — Enter your full name. • Organization — Enter your organization information. Click Next. The Ready to Install the Application window is displayed. 7. Click Next. The Updating System window is displayed.
:\Program Files\Common Files\Wise Installation Wizard NOTE: The MSI location for Windows (x86) systems is :\Program Files\Common Files\Wise Installation Wizard and for Windows (x86_64) systems is :\Program Files (x86)\Common Files\Wise Installation Wizard. The folder must contain only one MSI file that can be copied and renamed if required. Upgrading DSET Application On Windows Operating System You can upgrade to DSET application version 3.7.
• Dell_DSET_(Version Number.exe — This invokes the GUI. • Dell_DSET_(version number).exe ADDLOCAL= INSTALLDIR= /qn — This performs silent installation that does not display any graphical progress bar. NOTE: • ADDLOCAL parameter in the command is optional. • For version 3.2 and later, while upgrading, if ADDLOCAL parameter is not included in the command, then only the installed component is upgraded. • For version 2.2 or lower, if Dell_DSET_(version number).
3 Installing, Upgrading, And Running DSET Application On Linux Operating System This section provides information to install, upgrade and run DSET application on Linux operating system. If you install or upgrade the DSET application on a system having OpenManage Server Administrator version lower than 5.5 or an incompatible application, then an error message is displayed and the installation is not completed.
Device Dependency On Linux Operating System The following table lists the devices and the dependencies that are required for Linux operating system to run DSET application. If these device dependencies are not met, DSET application exhibits the default behavior. Table 5. : Device, Dependency, and Default Behavior Device Dependency Default Behavior (if dependency is not met) Emulex Fibre Channel Controller • Fibre Channel Controllers are not displayed in DSET report HBAnywhere utility from Emulex.
1. 2. Collecting DSET report without providing any username or password: DSET tries for CIMOM connections through certificates. a. If the connection is successful, the report collection continues without prompting for a password. b. If the connection is unsuccessful, DSET asks whether or not you want to provide password and continue. • If you choose to continue, DSET prompts you to enter root password and proceed. • If you decide not to proceed, credential-based authentication is not performed.
• RHEL7 • CENT • ESX NOTE: If any other value is entered apart from the OSs listed here, the installer throws an error message. The strict type-checking is to make sure that only the correct packages required for DSET report collection are deployed on a server. Creating One-time Local System DSET Report On Linux Operating System DSET application enables you to generate configuration report without permanently installing the application. This is also known as zero footprint report collection.
Do you want to upload the report on request to Dell Technical Support after the report is generated [y|n]: 8. If CIMOM already exists, DSET validates the CIMOM in the following order: a. Credential-less CIMOM authentication b. If Credential-less CIMOM authentication is not successful, enter the root credentials of the system when the following message is displayed: Please enter "root" password: The data collection starts, the report is generated and saved as specified in step 5.
Type Installation Option Description and also remote report collection from this system. 2 DSET Select this option to permanently install the required components to generate report from remote systems. 3 Remote Provider Select this option to permanently install the required components to allow reports to be generated from a remote system against this system. NOTE: • For DSET application version 2.2 or lower, installation type 1 is displayed. • If version 3.
sbin/dellsysteminfo' from a terminal shell prompt to create a report file • If you selected the DSET option, then the following message is displayed: The DSET installation completed successfully. Enter '/usr/sbin/dellsysteminfo' from a terminal shell prompt to create a report file. • If you selected the Remote Provider option, the following message is displayed: Remote Provider installation completed successfully. DSET application is installed at the /opt/dell location by default.
System Event Logs are cleared. Press Enter continue 5. Press Enter. DSET application exits and the Linux shell prompt appears. Upgrading DSET Application On Linux Operating System You can upgrade to DSET application version 3.7.0 from any of the following previous versions: • DSET 1.8 • DSET 1.9 • DSET 2.0 • DSET 2.1 • DSET 2.2 • DSET 3.2 • DSET 3.3 • DSET 3.4 • DSET 3.5.0 • DSET 3.5.1 • DSET 3.6.0 NOTE: For versions lower than 1.8, automatic upgrade to DSET application version 3.7.
To perform the option that you selected, it is necessary to install and start this service and leave it running in background for future configuration collection. Continue installing/activating the SFCB on this system to listen for incoming collection requests from clients. Do you want proceed[y|n]? 5. Enter y.
Maintaining DSET Application 4 After installing the DSET application, you can modify the components that are installed. The application maintenance window is available only when DSET application is permanently installed on your system. You can also reinstall the corrupt files, registry keys, and shortcuts of the application. Modifying Installed DSET Application Features The installed features that can be modified are: • • DSET — Permanently installs DSET interface to generate reports for remote systems.
Table 7. : Silent Modify Options Currently Installed Parameter Exit Status (Error Code and Description) Component DSET and Remote Provider Yes. (13 — DSET 3.7.0 full is already installed, but user has passed -qi or -qn option.) No DSET Yes. (23 — Only DSET is installed, but user has passed -qi or -qn option.) No DSET No Yes. Remote Provider is installed. Remote Provider Yes.
Uninstalling DSET Application 5 DSET application can be uninstalled using the GUI or the CLI option. Using GUI For Windows Operating System To uninstall DSET application, use one of the following options: • From the Start menu • From the windows Add or Remove Programs or Programs and Features wizard • From the Application Maintenance window From The Start Menu To uninstall DSET application from the Start menu on Windows operating systems: 1. Click Start → Programs (or All Programs) → DSET 3.7.
Using CLI For Windows And Linux Operating Systems To uninstall DSET application using the CLI, run the following command from the command prompt: For Windows Operating System To uninstall DSET application using the CLI, run the following command from the command prompt: Msiexec /x {E8D4AC76-9847-4669-93DB-617DB495092A} The Windows Installer window displays Are you sure you want to uninstall this product? message. Click Yes to uninstall the DSET application.
Error Codes 6 This appendix provides the list of DSET installer error codes. 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 8. : Installer Error Codes and Description Error Code Description 0 Success 2 Operating system architecture and installer architecture are not same. 3 Unsupported Operating System.
Error Code Description 14 User has not agreed to the license terms. 15 Silent uninstallation is complete. 16 Silent installation of full DSET is complete but not functional. See the Permanently Installing DSET Application Silently On Linux Operating System for more information. 17 Silent ZFP report collection is complete. 18 User has aborted the installation. 19 Invalid installer option is passed. 20 Failed to install dell-dset-collector rpm. 21 Failed to install dell-dset-provider rpm.