------------------------------------------------------ Dell System E-Support Tool Version 3.2 Readme This readme contains information about Dell System E-Support Tool. Dell System E-Support Tool (DSET) is a utility that collects configuration and log data from the target server for various chassis hardware, storage, and operating system components of a Dell PowerEdge server. DSET generates a System Configuration Report, which consolidates the gathered data into a .zip file that can be automatically or manually uploaded to Dell Technical Support. ------------------------------------------------------ ====================================================== 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 report. For the complete list of PII, refer to the "Personally Identifiable Information (PII)" section. * Support for the following Dell 12th generation PowerEdge servers: – M620 – R620 – T620 – R720 – R720xd * Support for the following Dell PERC storage controllers in Dell 12G PowerEdge servers: - S110 Software Based RAID - PERC H310 Integrated RAID Controller - PERC H510 Integrated RAID Controller - PERC H710 Integrated RAID Controller - PERC H810 RAID Controller * Enhanced report GUI. * Enhanced command line parameters. * Option to automatically upload the generated report to Dell Technical Support. * No support for 8th generation servers. ------------------------------------------------------ Hardware and Software Requirements ------------------------------------------------------ ====================================================== Supported Hardware Platforms ====================================================== DSET supports the following systems: * Storage Systems: PowerVault DL2000, DL2100, DL2200, and PowerVault NX. * Rack Systems: PowerEdge R720, R720xd, R620, R200, R210, R210II, R300, R310, R410, R415, R510, R515, R610, R710, R715, R805, R810, R900, R905, R910, 1950, 1955, 2950, 6950, and 2970. * Blade Systems: PowerEdge M620, M600, M605, M610, M610X, M710, M710HD, M805, M905, M910, and M915. * Tower Systems: PowerEdge T620, T100, T105, T110, T110II, T300, T310, T410, T605, T610, T710, 1900, and 2900. * CloudEdge Systems: PowerEdge C410X, C1100, C2100, C6100, C6105, and C6145. ====================================================== Supported Operating Systems ====================================================== DSET Provider and Collector ---------------------------- Installation and report collection (local and remote) can be done from the following operating systems: * Microsoft Windows Server 2003 (32-bit and 64-bit) * Microsoft Windows Server 2003 R2 (32-bit and 64-bit) * Microsoft Windows Server 2008 (32-bit and 64-bit) * Microsoft Windows Server 2008 R2 (64-bit) * Microsoft Windows 2008 Server Core (32-bit and 64-bit) * Microsoft Windows Small Business Server 2011 (64-bit) * Microsoft Hyper-V Server 2008 R2 * VMware ESX 4.0 * VMware ESX 4.1 * Red Hat Enterprise Linux 5 (32-bit and 64-bit) * Red Hat Enterprise Linux 6 (64-bit) * SUSE Linux Enterprise Server 10 (64-bit) * SUSE Linux Enterprise Server 11 (64-bit) DSET Collector -------------- Installation and remote report collection can be done from the following client operating systems: * Microsoft Windows XP * Microsoft Windows Vista * Microsoft Windows 7 Remote report collection from the following operating systems can be done when DSET Collector is installed on Windows/Linux: * VMware ESXi 4.0 * VMware ESXi 4.1 * VMware ESXi 5.0 NOTE: Install Dell OpenManage Server Administrator version 5.5 or later on the target machine, to collect the hardware data from ESXi remotely. ====================================================== Supported Web Browsers ====================================================== Internet Explorer 7.0 and later versions for viewing the reports in Windows platform. ====================================================== Personally Identifiable Information (PII) ====================================================== The list of Personally Identifiable Information are: - Host Name - IP Address - Subnet Mask - Default Gateway - MAC Address - DHCP Server - DNS Server - Processes - Environment variables - Registry - Logs - iSCSI Data ====================================================== Installation Prerequisites ====================================================== ------------ For Windows: ------------ * You need to be logged in as a local or domain Administrator. * To Install DSET on Microsoft Windows 2008, Microsoft Windows Vista or Microsoft Windows 7 as a standard user, run the DSET installer with elevated privileges using "Run As" option. * To install DSET Provider, Windows Management Instrumentation (WMI) service must be running. - If WMI is stopped, DSET starts WMI automatically and continues with installation. - If WMI is disabled, installation of DSET terminates with an error message. ---------- For Linux: ---------- * You need to be logged in as the root user. * Enable SSH services for remote report collection from Linux systems. * Make sure that the user credentials supplied for remote report collection can initiate SSH connection and have root privileges. NOTE: For Linux CIMOM, the default port 5988 (for http) or 5989 (for https) is used by the system to install DSET Provider. If custom ports are used, update the configuration file available at /opt/dell/advdiags/dset/config/dset.cfg. ====================================================== Installation Details ====================================================== --------------- ## For Windows: --------------- ------------------------------------------------------ ** Creating One-time Report (Zero Footprint) ------------------------------------------------------ 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: ----------- * To run DSET and create one-time report: 1. Run the "Dell_DSET_3.2.0.x.exe" file. The Welcome to the Dell System E-Support Tool (3.2) Installation Wizard window is displayed. Note: You must start the DSET application as a local or domain administrator. 2. Click "Next" to proceed through license and readme information until the "Installation Type" window appears. 3. Select "Create Local Diagnostic Report" and click "Next". 4. The Report Settings window is displayed with the following options: - 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 user’s Desktop in Windows. - Filter out sensitive data (PII) from the report: Select this option to filter certain sensitive data from the report. To include any of the sensitive data in the report, specify ’No’ in the C:\Program Files (x86)\Dell\ AdvDiags\DSET\config\privacy_presetlist.cfg file (in 64-bit systems) or C:\Program Files\Dell\ AdvDiags\DSET\config\privacy_presetlist.cfg file (in 32-bit systems). For the complete list of sensitive data, please refer to "Personally Identifiable Information (PII)" section of Readme. - At request upload the report to Dell Technical Support: Select this option to upload the report to the Dell Technical Support when requested. 5. Click "Next" to display the "Report Settings to Skip Specific Information" window. 6. 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 Note: The checkboxes are enabled by default unless instructed by Dell Technical Support. 6. Select the "Gather Advanced Log Files Information" option to collect additional log information in the report. NOTE: Selecting the Advanced option may create very large size report files. 7. Click "Next". The Ready to Collect Report window is displayed. 8. Click "Start". The Updating System window is displayed indicating the status of report collection. 9. Click "Finish" in Dell System E-Support Tool (3.2) report has been successfully created window. The report is saved on the user’s Desktop or at the user-specified location. To view the report, unzip the .zip file using the password 'dell'. For more information, see "Viewing DSET Report" section in User's Guide. --------------- Using the CLI: --------------- To run DSET, run the following command: - Dell_DSET_3.2.0.x.exe REPORTNAME= COLLECT= — This invokes the GUI. - Dell_DSET_3.2.0.x.exe REPORTNAME= COLLECT= UPLOAD=auto /qn — This is for silent Zero Footprint report collection. Where: is a valid Windows filepath, filename, or both filepath and filename are independent report options that can be specified together with a comma separator without any space. 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 ------------------------------------------------------ ** Permanently Installing DSET and Generating Report ------------------------------------------------------ Before installing DSET, make sure that the installation prerequisites are met. ---------- Using GUI: ---------- To permanently install DSET on Windows operating system: 1. Run the "Dell_DSET_3.2.0.x.exe" file. The Welcome to the Dell System E-Support Tool (3.2) Installation Wizard window is displayed. 2. Click "Next" to proceed through license agreement and readme information until the "Installation Type" window appears. 3. Select one of the following options and click "Next": - DSET Collector and DSET CIM Provider (default) - DSET Collector - DSET CIM Provider The Destination Folder window is displayed to specify an alternative install path. 4. You may enter your Full Name and Organization information. This is optional. 5. Click "Next". The "Ready to Install the Application" window is displayed. 6. Click "Next". The "Updating System" window is displayed indicating the installation status. After installation, the Dell System E-Support Tool (3.2) has been successfully installed window is displayed. 7. To generate the report and/or upload (optional step): - Run and Collect DSET Report : Select this option to generate the report. - At request upload the report to Dell Technical Support : Select this option to upload the report to the Dell Technical Support when requested. 8. Click "Finish" to close the installer. DSET is now installed in the local system and if you have performed step 7, the report is also generated and/or uploaded. -------------- Using the CLI: -------------- To install DSET, run the following command: * Dell_DSET_3.2.0.x.exe INSTALL= INSTALLDIR= /qn Where: Full = Full installation of both DSET Collector and DSET Provider on the local system Collector = Installation of DSET Collector only for remote collection Provider = Installation of DSET Provider only for remote collection from a remote system INSTALLDIR = optional installation path /qn = Silent installation that does not display any graphical progress bar ------------------------------------------------------ ** Clearing Hardware Logs ------------------------------------------------------ DSET clears Dell hardware logs (Embedded System Management logs) from the system without permanently installing the application. You can clear hardware logs using the installer or from the Start menu. ---------------- Using Installer: ---------------- To clear hardware logs from the system: NOTE: This does not install DSET permanently. 1. Run the "Dell_DSET_3.2.0.x.exe" file. The Welcome to the Dell System E-Support Tool (3.2) Installation Wizard window is displayed. 2. Click "Next" to proceed through license agreement and readme information until the "Installation Type" window appears. 3. Select "Clear Hardware Log Only" and click "Next". The User Information window is displayed. 4. You may enter your Full Name and Organization. This is optional. 5. Click "Next". The Ready to Install the Application window is displayed. 6. Click "Next". The Updating System window is displayed. After some time the command window is displayed with the following message: *Going to clear the ESM Logs now Do you want to continue? Y/N: 7. Enter Y to clear the logs. The following messages are displayed: System event logs are cleared. Press any key to continue 8. Press any key. The command window closes and the Dell System E-Support Tool (3.2) has successfully cleared the ESM logs window is displayed. 9. Click "Finish" to close DSET. ---------- Using GUI: ---------- To clear hardware logs: 1. Navigate to DSET 3.2->Clear ESM Logs in the Start menu. 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 the MSI package for large site automated deployment ------------------------------------------------------ To extract the MSI file out of DSET EXE: 1. Run the "Dell_DSET_3.2.0.x.exe" file. The Welcome to the Dell System E-Support Tool (3.2) Installation Wizard window is displayed. 2. The MSI is already extracted at the following location: C:\Program Files\Common Files\Wise Installation Wizard NOTE: The MSI location for Windows (x86) systems is C:\Program Files\Common Files\Wise Installation Wizard and for Windows (x86_64) systems is C:\Program Files (x86)\Common Files \Wise Installation Wizard. There should be only one MSI file that can be copied from this folder and renamed if required. 3. Cancel the DSET installer to remove the embedded MSI package. ------------- ## For Linux: ------------- ------------------------------------------------------ ** Creating One-time Report (Zero Footprint) ------------------------------------------------------ DSET enables you to generate a 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. --To run DSET and create one-time report: NOTE: You must be logged in as root user to run DSET. 1. At the Linux shell prompt, run the ./dell-dset-lx(bit)-3.2.0.x.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. 3. Enter 2 to select "Create One-time Local System DSET Report" option. 4. Enter y or n for the following messages that are displayed one at a time to choose the category for which the data must be collected: - Do you want collect info for all hardware categories [y|n]: - Do you want collect info for all storage categories [y|n]: - Do you want collect info for all software categories [y|n]: - Do you want collect linux log files [y|n]: - Do you want collect advanced log files [y|n]: NOTE: If you select advanced log files option, by default, all the logs are collected and may create large size reports. 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. Enter y to enable privacy when the following message is displayed. Else enter n. If enabled, it filters the sensitive data from the report. To include any of the sensitive data to the report, specify ’No’ in the /opt/dell/advdiags/dset/config/ privacy_presetlist.cfg file. Do you want to enable privacy [y|n]: For the complete list of sensitive data, please refer to "Personally Identifiable Information (PII)" section of Readme. 7. To automatically upload the report to Dell site, enter y when the following message is displayed. Else, enter n: Do you want to upload the report at the request of Dell Technical Support[y|n]: 8. Enter the root credentials of the target system when the following message is displayed: To proceed further with DSET report collection, it requires the root credentials of the system as it collects the Hardware data via Common Information Model Object Model. Please enter "root" password: NOTE: Root credentials are necessary for the DSET Provider to collect inventory or configuration information about the system. DSET does not store this password. The root password must be specified each time a report is collected. The data collection starts, the report is generated and saved as specified in step 5. If you chose to automatically upload the report, the report is uploaded and the Report uploaded successfully message is displayed. For silent Zero FootPrint report collection, run the command: dell-dset-lx(bit)-3.2.0.x.bin -qn -d -r -v -p -a ------------------------------------------------------ ** Permanently Installing DSET ------------------------------------------------------ You can permanently install the following DSET components: - DSET Collector and DSET CIM Provider - DSET Collector Only - DSET CIM Provider Only ------------------------------------------------------ Installing or Upgrading DSET Collector and DSET CIM Provider ------------------------------------------------------ To permanently install or upgrade DSET on the local system: NOTE: You must be logged in as root to install or upgrade DSET. 1. At the Linux shell prompt, run the ./dell-dset-lx(bit)-3.2.0.x.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. 3. Enter 3 to select Install/Upgrade DSET Collector and DSET CIM Provider option. If SFCB or OpenPegasus is not installed or running, the following message is displayed: The Small Footprint CIM Broker (SFCB) is a network service that enables remote collection of system configuration information. 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]? 4. Enter y. If OpenPegasus is installed and running, the following message is displayed: DSET collects the Hardware data via Common Information Model Object Model(CIMOM): togpegasus, which is already present on this system, Please enter the Administrator/Root password to validate the existing tog-pegasus 5. Enter the root credentials of the system when the following message is displayed: Please enter "root" password: 6. Wait for the installation to complete. The DSET installation completed successfully message is displayed. DSET is installed at the /opt/dell location by default. For silent installation, run the command: dell-dset-lx(bit)-3.2.0.x.bin -qi -------------------------- Installing DSET Collector -------------------------- To permanently install DSET Collector: NOTE: You must be logged in as root to install DSET Collector. 1. At the Linux shell prompt, run the ./dell-dset-lx(bit)-3.2.0.x.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. 3. Enter 4 to select Install DSET Collector option. 4. Wait for the installation to complete. The DSET Collector installation completed successfully message is displayed. DSET collector is installed at opt/dell/ location by default. ----------------------------- Installing DSET CIM Provider ----------------------------- To permanently install DSET CIM Provider: NOTE: You must be logged in as root to install DSET CIM Provider. 1. At the Linux shell prompt, run the ./dell-dset-lx(bit)-3.2.0.x.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. 3. Enter 5 to select Install DSET CIM Provider option. If SFCB or OpenPegasus is not installed or running, the following message is displayed: The Small Footprint CIM Broker (SFCB) is a network service that enables remote collection of system configuration information. 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]? 4. Enter y. If OpenPegasus is installed and running, the following message is displayed: DSET collects the Hardware data via Common Information Model Object Model(CIMOM): togpegasus, which is already present on this system, Please enter the Administrator/Root password to validate the existing tog-pegasus 5. Enter the root credentials when the following message is displayed: Please enter "root" password: Wait for the installation to complete. The DSET CIM Providers installation completed successfully message is displayed. DSET CIM Provider is installed at /opt/dell location by default. ------------------------------------------------------ ** Clearing Hardware Log On Linux ------------------------------------------------------ DSET clears Dell hardware logs (Embedded System Management logs) from the system without permanently installing the application. To clear hardware logs from the system: NOTE: You must be logged in as a root to run DSET. 1. At the linux shell prompt, run the ./dell-dset-lx(bit)-3.2.0.x.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. 3. Enter 6 to select Clear ESM Hardware Log option. *Going to clear the ESM Logs now Do you want to continue? Y/N: 4. Enter y to clear the logs. The following messages are displayed: System event logs are cleared. Press any key to continue 5. Press any key. DSET exits and the Linux shell prompt appears. ====================================================== Upgrading DSET ====================================================== You can upgrade to DSET 3.2 from any of the following previous versions: * DSET 1.8 * DSET 1.9 * DSET 2.0 * DSET 2.1 * DSET 2.2 NOTE: For versions earlier to DSET 1.8, automatic upgrade to DSET 3.2 is not possible. When the DSET 3.2 installer is run, the installer terminates with an error message. In such cases, uninstall previous versions of DSET and then install DSET 3.2. NOTE: DSET does not require a system reboot. --------------- ## For Windows --------------- To automatically upgrade to DSET 3.2 using the installer: 1. Run the Dell_DSET_3.2.0.x.exe file. The Welcome to the Dell System E-Support Tool (3.2) Installation Wizard window is displayed. 2. Click "Next". The DSET (Version Number) is already installed window is displayed. NOTE: If you do not want to upgrade, click Cancel to exit the installer. 3. Click "Upgrade" to upgrade to DSET version 3.2. The License Agreement window is displayed. 4. Select the "I accept the license agreement" and click "Next". The Readme Information is displayed. 5. Click "Next". The Installation Type window is displayed. 6. Click "Next". The Select Installation Type window is displayed. 7. Click "Next". The Destination Folder window is displayed. 8. 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 C:\Program Files\Dell and for Windows (x86_64) systems is C:\Program Files (x86)\Dell. 9. You may enter your Full Name and Organization information. This is optional. 10. Click "Next". The Ready to Install the Application window is displayed. 11. Click "Next". The Updating System window is displayed indicating the installation status. After installation, the Dell System E-Support Tool (3.2) has been successfully installed window is displayed. ------------- ## For Linux ------------- --To automatically upgrade to DSET 3.2 on Linux operating system: 1. At the Linux shell prompt, run the ./dell-dset-lx(bit)-3.2.0.x.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. Dell System E-Support Tools (DSET) options are displayed 3. Enter 2 to select Install/Upgrade DSET Collector and DSET CIM Provider option. The following messages are displayed: DSET (Version Number) is already installed. Do you want to upgrade to DSET 3.2 [y|n]? 4. Enter y. If SFCB or OpenPegasus is not installed or running, the following message is displayed: The Small Footprint CIM Broker (SFCB) is a network service that enables remote collection of system configuration information. 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. If OpenPegasus is installed and running, the following message is displayed: DSET collects the Hardware data via Common Information Model Object Model(CIMOM): togpegasus, which is already present on this system, Please enter the Administrator/Root password to validate the existing tog-pegasus Enter the root credentials when the following message is displayed: Please enter "root" password: 6. Wait for the installation to complete. The DSET installation completed successfully message is displayed. DSET is upgraded to version 3.2 and is installed at /opt/dell location by default. ====================================================== Uninstallating DSET ====================================================== DSET can be uninstalled using the GUI or the CLI option. -------------------------- ** Using GUI For Windows -------------------------- To uninstall DSET, use one of the following options: ------------------------------------------------------ From the Start Menu ------------------------------------------------------ To uninstall DSET from the Start Menu on Windows operating systems: 1. Click Start-> Programs-> DSET 3.2-> Uninstall DSET 3.2. 2. Click "Yes" at the prompt to uninstall DSET. ------------------------------------------------------ From the Windows Add or Remove Programs Wizard ------------------------------------------------------ To uninstall DSET from the Windows Add or Remove Programs Wizard on Windows operating systems: 1. Click Start-> Control Panel-> Add or Remove Programs. 2. Select Dell System E-Support Tool (3.2) and click the "Remove" button. 3. Click "Yes" on the Are you sure you want to uninstall Dell System ESupport Tool (3.2)-> window to uninstall DSET. ------------------------------------------------------ From the Application Maintenance Window ------------------------------------------------------ To uninstall DSET from the Application Maintenance Window on Windows operating systems: 1. Run the Dell_DSET_3.2.0.x.exe file. The Application Maintenance screen is displayed. 2. Select the "Remove" option and click "Next". The Dell System E-Support Tool (3.2) Uninstall window is displayed. 3. Click "Next". The Updating Screen is displayed. 4. Click "Finish" on the Dell System E-Support Tool (3.2) has been successfully uninstalled window. ------------------------------------------------------ ** 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 ----------------------------- Msiexec /x{F3DBD63F-287B-4BF5-9B6C-BD3B70E107F4} The Windows Installer window displays "Are you sure you want to uninstall this product?" message. Click "Yes" to uninstall DSET. For silent uninstallation, run the command: Msiexec /x{F3DBD63F-287B-4BF5-9B6C-BD3B70E107F4} /qn --------------------------- For Linux Operating System --------------------------- dsetuninstall Or /opt/dell/advdiags/dset/uninstall.sh For silent uninstallation, run the command: dell-dset-lx(bit)-3.2.0.x.bin -qu ====================================================== Open Source Library ====================================================== The list of open source libraries used are: * Python 3.1 * OpenSSL 0.9 * PyWBEM 0.7 * 7-Zip 4.65 * Plink 0.55 * Pscp 0.58 * Libxml2 2.7.8 * Libxslt 1.1.26 * XSLTPROC 1.1.26 * sblim-sfcb 1.3.11 * python cmpi-bindings 0.4.0-7.1 * sblim-indication_helper 0.4.2 * sblim-cmpi-base 1.5.5 * cim-schema 2.19 The modified open source libraries are available at the following location: http://opensource.dell.com/releases/dset/3.2.0/ DSET320.iso ====================================================== Error Codes ====================================================== ------------------------------------------------------ ** DSET Error Codes ------------------------------------------------------ DSET Collector will return custom error codes on collection of report. List of Error codes Returned by dellsysteminfo are: -------------------------------------------------- 0 = DSET_CIM_NO_ERROR -1 = DSET_CIM_GENERAL_ERROR 2 = DSET_CIM_NAMESPACE_ERROR -3 = DSET_CIM_CREDENTIAL_ERROR -4 = DSET_CIM_PROVIDER_ERROR -6 = DSET_CIM_CONNECTION_ERROR -7 = DSET_CIM_OPTION_ERROR -8 = DSET_CIM_HW_COLLECTION_ERROR -9 = DSET_CIM_ST_COLLECTION_ERROR -10 = DSET_CIM_SW_COLLECTION_ERROR -11 = DSET_CIM_LG_COLLECTION_ERROR -12 = DSET_CIM_INDEX_ERROR -13 = DSET_CIM_ZIP_ERROR -14 = DSET_CIM_TRANSFORM_ERROR -15 = DSET_CIM_HW_COLLECTION_WARN -16 = DSET_CIM_SW_COLLECTION_WARN -17 = DSET_CIM_ST_COLLECTION_WARN -18 = DSET_CIM_INVALID_FILE_NAME_ERROR -19 = DSET_CIM_CLASS_NAME_ERROR -20 = UPLOAD_UNKNOWN_ERROR -21 = UPLOAD_OPTION_ERROR -22 = UPLOAD_FILE_SIZE_ERROR -23 = UPLOAD_CERTIFICATE_ERROR -24 = UPLOAD_CHUNK_ERROR -25 = UPLOAD_SERVER_ERROR -26 = UPLOAD_INVALID_FILE_ERROR -27 = UPLOAD_TIMEOUT_ERROR ------------------------------------------------------ ** Installer Error Codes ------------------------------------------------------ -------------- ## For Windows -------------- Custom error codes are not supported in this release. Default MSI error codes are returned. ------------ ## For Linux ------------ 0 = Success 1 = Unsupported hardware platform. See the "Supported Hardware Platforms" section for the complete list of supported hardware. 2 = Unsupported OMSA version is installed on the system. NOTE: - On a 32-bit Linux system, supported OMSA version for 32-bit DSET installation is 5.5 to 7.0. - On a 64-bit Linux system, supported OMSA version for 64-bit DSET installation is 6.3 to 7.0. In case, the installed OMSA version is between 5.5 to 6.2, 64-bit DSET cannot be installed and it is recommended to install 32-bit DSET. 3 = Unsupported Operating System. See the "Supported Operating Systems" section for the complete list of supported operating systems. 4 = Earlier version of DSET installed on the system is not supported for DSET upgrade. See the "Upgrading DSET" section for more information. 5 = Earlier version of DSET installed on the system is supported for DSET upgrade, but user has passed -qi or -qn option. 6 = Earlier version of DSET installed on the system is supported for DSET upgrade, but user has chosen not to upgrade to version 3.2. 7 = DSET 3.2 Provider and Collector is already installed on the system. 8 = DSET 3.2 Collector is already installed on the system. 9 = DSET 3.2 Provider is already installed on the system. 10 = User has chosen not to install or run sfcb. 11 = CIMOM architecture and installer architecture are not the same. 12 = Either root password is incorrect or CIMOM is not functional. 13 = DSET 3.2 is already installed, but user has passed -qi or -qn option. 14 = User has not agreed to the license terms. 15 = Silent uninstallation is complete. 16 = Silent installation 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 -qi or -qn option. 24 = Only provider is installed, but user has passed -qi or -qn option. ====================================================== Known Issues ====================================================== * On Windows operating systems if OpenManage Server Administrator (OMSA) 6.x is installed after DSET is installed, OMSA Data Manager fails to start and all hardware and storage information is not available in the report. (2388) * Global Hot Spare information is not available for storage devices in the DSET report. (2408) * On T110 II systems with Windows 2008 SP2 x64 bit operating system, the slot information for external controller (PERC 6E) is displayed as Embedded under Storage->Dell PERC 6E Controller. (2412) * Hardware and storage information may be missing in DSET report collected through OMSA namespace if the target machine has Windows Server SBS 2011. (2416) * Network information under Software -> Linux OS section may be missing for PowerEdge M910 systems running RHEL 6.1. Most networking information can be found under the Chassis -> Network section instead. (2425) * On Windows system the "Device Name" attribute of Virtual Disks is blank in the Storage information for H200 controller. (2381) * DSET Collector always presents Start Menu -> Create Report for collection on the local system even if there is no DSET or OMSA provider installed locally. (2387) * When collecting hardware, storage, or software information remotely from R710 system with Windows 2008 R2 SP1 operating system to T110II system with SLES 10 SP4 x64 operating system, raw XML is displayed in the report. (2095) * When the size of the virtual disk is less than the maximum capacity of the raid size, "Available Disk Space" and "Used Disk Space" information is not displayed under Virtual disk. (2118) * The message "A System Configuration Report has not been created yet" may appear on the report's main Storage page if the report was collected through the OMSA namespace. (2174) * On Linux operating systems, DSET leaves few kernel modules like ipmi,mpt2sas,raid_class,nls_utf8,cifs still loaded after execution. (1193) * "View Report" is not available in the Start -> DSET menu on Windows systems. (2350) * On Windows operating system, Remote report from any Microsoft Windows system, in different domain fails when the report is collected through Dell OpenManage Server Administrator(OMSA) namespace. (2722) Work Around: To enable the successful functioning of remote report collection from OMSA ensure the following: The managed system and the management station are on the same domain or there is a trust relationship between the two domains. If you have a Windows Firewall configured on the management station or the managed system, make the following configuration changes to enable remote Server Administrator CLI and software updates to work successfully. Management Station: 1. Open TCP port 135. 2. Add the application "omremote.exe" (located in InsallDirectory\bin\utils) to the Firewall exception list. Managed System: 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.microsoft.com/en-us/library/aa389286 (VS.85).aspx" "http://support.microsoft.com/kb/875605" For Windows Server 2008 onwards, see the following link: "http://msdn.microsoft.com/en-us/library/aa822854 (VS.85).aspx" * Software -> Linux OS -> Display information is not available from a RHEL 6.1 64-bit system due to changes in xorg.conf. (2426) * USB CD-ROM or DVD-ROM drive information is not displayed in the Storage section. (2773) * "Read Policy" and "Write Policy" information is not displayed under Virtual Disks on some Windows 2008 R2 systems. (2774) * Chassis -> Hardware logs are missing in Linux to Linux remote reports when any version of Dell Open Manage Server Administrator(OMSA) is installed on the target Linux system. (2771) * On Linux systems, Storage -> Fibre Channel HBA devices are not displayed in the Storage section of DSET reports due to missing Emulex or QLogic drivers. (2754) Resolution: - For Emulex Fibre Channel Controller: Download HBAnywhere utility from Emulex. To download this utility, access the Emulex website at emulex.com. 1. Click Downloads->Dell. 2. Click the adapter model number. 3. Click Linux from the Current Drivers section and download the Applications Kit. 4. Install libhbaapi rpm available in the operating system DVD. - For QLogic Fibre Channel Controller: Download SNIA API for Linux drivers. To download this, access the QLogic website at qlogic.com. 1. Click Downloads->Fibre Channel Adapters. 2. Select a model and an operating system and click Go. 3. Install libhbaapi rpm available in the operating system DVD. * "Raw SEL Data" column is blank on the Chassis -> Hardware Logs page of DSET report of a Linux system, if any version of supported OMSA is installed. (2695) * Storage -> Enclosure -> Temperature is missing for external PowerVault enclosures in DSET report collected through OMSA namespace. (2824) * For Linux operating systems, during local report collection, if the password has any special characters such as:, #, !, $, &, (, ), |, ;, “, ‘, <, and >, prefix the special characters in the password with '\'. * For Windows 2008 operating systems, the Hotfix Install date is not displayed correctly in the DSET report > Software section > Installed Applications page. * On Windows Operating system, if you uninstall DSET during report collection, the installation is deleted from the system and the report collection is terminated. ====================================================== Limitations ====================================================== - On RedHat Enterprise Linux (RHEL) 5.0 and 6.0, if SFCB package rpm was installed using "Dell Systems Management Tools and Documentation DVD" DSET 3.2 report collection fails. Uninstall SFCB, re-install DSET 3.2, and generate the report. - On Linux machines if the root user is not configured to use remote network (HTTP or HTTPS service) for OpenPegasus, hardware and storage information is not collected in the report. - DSET Collector on Linux cannot collect a remote report through the OMSA namespace. - On Linux systems, if SFCB is installed using Open Manage Server Administrator DVD and then DSET is installed, DSET report collection fails. Restart SFCB service on the system and then generate the report. ====================================================== Global Support ====================================================== For information on technical support, visit www.dell.com/contactus. Information in this document is subject to change without notice. © 2012 Dell Inc. All rights reserved. Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden. Trademarks used in this text: Dell(TM), the DELL logo, PowerEdge(TM),PowerVault(TM), and OpenManage(TM) are trademarks of Dell Inc. Microsoft(R), Windows(R), Windows Server(R), Internet Explorer(R), and Windows Vista(R) are trademarks or registered trademarks of Microsoft Corporation in the United States and/or other countries. Red Hat Enterprise Linux(R) and Enterprise Linux(R) are registered trademarks of Red Hat, Inc. in the United States and/or other countries. The term Linux(R) is a registered trademark of Linus Torvalds, the original author of the Linux kernel. SUSE(TM) is a trademark of Novell Inc. in the United States and other countries. VMware(R) and ESX(TM) are registered trademarks or trademarks of VMware, Inc. in the United States and/or other jurisdictions.Java(TM) is a registered trademark of Oracle and/or its affiliates. Hewlett-Packard(R) is a registered trademark of Hewlett-Packard Company. "Python" is a registered trademark of the PSFin the United States of America. OPENSSL trademark of The OpenSSL Software Foundation, Inc. Other trademarks and trade names may be used in this publication 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. 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. 2012 - 05 Rev. A01