------------------------------------------------------
Dell System E-Support Tool Version 3.3

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
======================================================
* Support for the following Dell 12th generation
  PowerEdge servers:
   – R320
   – R420
   – R520
   – R820
   – M420
   – M520
   – M820
   – T320
   – T420
   
* Authenticated Proxy support for Windows operating 
  system to upload the DSET report to Dell Technical 
  Support.
  
* Support to collect report from 12th generation 
  servers having enterprise license for iDRAC (out of 
  band).
  
* Support for using non-root user to collect data from
  OpenManage Server Administrator namespace remotely 
  on Linux operating system from Windows client.

------------------------------------------------------
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, R320,
  R420, R520, R820, 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, M420, M520, M829, 
  M600, M605, M610, M610X, M710, M710HD, M805, M905,
  M910, and M915.

* Tower Systems: PowerEdge T620, T320, T420, 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.

======================================================
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.

For silent installation:
	On Linux Operating system for Silent installation of DSET,
	CIMOM (SFCB or Open Pegasus) should already be installed.
	To install SFCB:
		1. Locate the SFCB rpm from the Operating System Media. 
		2. Install SFCB rpm using "rpm -ivh  sblim-sfcb-*.rpm"
		3. Try to perform DSET silent installation.
	
	To install Tog-Pegasus:
		1. Locate the Tog-Pegasus rpm from the Operating System Media. 
		2. Install Tog-Pegasus using "rpm -ivh  tog-pegasus-*.rpm"
		3. Start the Pegasus services.
		4. Try to perform DSET silent installation.


======================================================
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.3.0.x.exe" file.
   The Welcome to the Dell System E-Support Tool (3.3)
   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.

- Select the option "Enable report Filtering" to 
  filter data from the report. For more information,
  refer to the User's Guide.

- Select the option "Automatically Upload the Report
  to Dell" 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 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. If the installed 
	Server Administrator version is not 5.5 through 7.1,
	then "Dell System E-Support Tool 3.3 cannot be 
	installed. The installed version of OpenManage 
	Server Administrator is incompatible. Update your
	system with Server Administrator version 5.5 through
	7.1 and run the setup program." message is displayed
	and the installation is not completed. Install a
	compatible version of the Server Administrator and
	run the "Dell_DSET_(Version Number).exe" file to 
	start installation.

9. Click "Finish" in "Dell System E-Support Tool (3.3)
   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.3.0.x.exe — This invokes the GUI.

- Dell_DSET_3.3.0.x.exe REPORTNAME=<NAME>
  COLLECT=<hw,sw,st,lg,ad> UPLOAD=auto /qn — This is 
  for 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.

  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.3.0.x.exe" file.
   The "Welcome to the Dell System E-Support Tool (3.3)
   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 status of report collection. If the installed 
	Server Administrator version is not 5.5 through 7.1,
	then "Dell System E-Support Tool 3.3 cannot be 
	installed. The installed version of OpenManage 
	Server Administrator is incompatible. Update your
	system with Server Administrator version 5.5 through
	7.1 and run the setup program." message is displayed
	and the installation is not completed. Install a
	compatible version of the Server Administrator and
	run the "Dell_DSET_(Version Number).exe" file to 
	start installation.
	
	After installation, the "Dell System E-Support Tool 
	(3.3) 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 : 
		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_(version number).exe — This invokes the GUI.

* Dell_DSET_3.3.0.x.exe INSTALL=
  <full/collector/provider> INSTALLDIR=<location> /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
  location = 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.3.0.x.exe" file.
   The "Welcome to the Dell System E-Support Tool (3.3)
   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 
   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. If the 
   installed OpenManage Server Administrator version 
   is not 5.5 through 7.1, then "Dell System E-Support
   Tool 3.3 cannot be installed. The installed version
   of OpenManage Server Administrator is incompatible.
   Update your system with Server Administrator version
   5.5 through 7.1 and run the setup program." message
   is displayed and the hardware logs are not cleared.
   Install a compatible version of the Server 
   Administrator and run the Dell_DSET_(Version 
   Number).exe file to clear the hardware logs. 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 "Click the Finish
	button to exit this installation." window is displayed.

9. Click "Finish" to close DSET.

----------
Using GUI:
----------
To clear hardware logs:

1. Navigate to DSET 3.3->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 from DSET EXE:

1. Run the "Dell_DSET_3.3.0.x.exe" file.
   The "Welcome to the Dell System E-Support Tool (3.3)
   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.
	  
The folder must contain only one MSI file that can be
copied 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.3.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 <option number> 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 to collect info for all hardware 
     categories [y|n]:
   - Do you want to collect info for all storage 
     categories [y|n]:
   - Do you want to collect info for all software
     categories [y|n]:
   - Do you want to collect linux log files [y|n]:
   - Do you want to 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 report filtering when the following 
   message is displayed. Else enter n. If enabled, it
   filters data from the report. For more information,
   refer to the User's Guide.

   Do you want to enable report filtering (For more 
   information, see the User's Guide) [y|n]:

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 on request to Dell
   Technical Support after the report is generated [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.3.0.x.bin 
   -qn -d <options> -r <reportname> -v <yes/no>
   -p <password> -a <auto/manual>

------------------------------------------------------
** 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.3.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. 
   Type 1 - Install/Upgrade DSET Collector and 
            DSET CIM Provider
   Type 2 - Install DSET Collector Only
   Type 3 - Install DSET CIM Provider Only
   For the description of installation types, refer
   to the User's Guide.
   
NOTE: 
	– For DSET version 2.2 or lower, installation type 1
	  is displayed.
	– If DSET 3.2 Collector and Provider or Collector or
	  CIM Provider is in the system, then installation 
	  types 1, 2, and 3 are displayed.
	– For DSET 3.3:
		* If Collector is in the system, then installation
		  type 3 is displayed.
		* If CIM Provider is in the system, then 
		  installation type 2 is displayed.

3. Enter <option number> to select the required 
   installation type.
   If Type 1 or Type 3 is selected, then during installation
   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): tog-pegasus,
   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 following 
   messages are displayed based on the selected installation
   type:
   – 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.
	 Enter '/usr/sbin/dellsysteminfo' from a terminal shell
	 prompt to create a report file
   – If you have selected DSET CIM Provider only option, then
     the following message is displayed:
	 The DSET CIM Providers installation completed successfully.
   DSET is installed at the /opt/dell location by 
   default.

For silent installation, run the command:
   
  dell-dset-lx(bit)-3.3.0.x.bin -qi

------------------------------------------------------
** 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.3.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 <option number> 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.3 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.0

NOTE: For versions earlier to 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.
---------------
## For Windows
---------------
---------
Using GUI
---------
To automatically upgrade to DSET 3.3 using the 
installer:
1. Run the Dell_DSET_3.3.0.x.exe file.
   The "Welcome to the Dell System E-Support Tool (3.3)
   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.3.
   The "License Agreement" window is displayed.

4. Click "Next" to proceed through license agreement 
   and readme information until the "Installation 
   Type" window appears.

NOTE: For upgrading from versions 2.2 and lower, 
      only :DSET Collector and DSET CIM Provider"
	  permanent install option is available.

5. Follow steps 3 to 8 in "Permanently Installing DSET
   and Generating Report" section of the Readme.

---------
Using CLI
---------
To automatically upgrade to DSET 3.3 using CLI, 
at the prompt, run the command:

* Dell_DSET_(Version Number.exe — This invokes the GUI.

* Dell_DSET_(version number).exe 
ADDLOCAL=<full/collector/provider> INSTALLDIR=<location>
/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).exe /qn is run, then both DSET Collector and
  CIM Provider are upgraded.
  
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
-------------
## For Linux
-------------
 --To automatically upgrade to DSET 3.3 on Linux 
  operating system:

1. At the Linux shell prompt, run the 
   ./dell-dset-lx(bit)-3.3.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 Tool (DSET) options are 
   displayed

3. Enter <option number> 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.3 [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.3 and is installed 
   at /opt/dell location by default.

--------------   
Silent Upgrade
--------------
To upgrade silently, run the command:
./dell/dset/lx(bit)/<version number>.bin —qi 
<full/collector/provider>

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 <full/collector/provider> parameter is provided
      in the command, then the existing DSET is 
	  uninstalled completely and the specified component
	  of DSET 3.3 is installed.
	– If <full/collector/provider> parameter is not 
	  provided in the command, then the existing DSET 
	  component is upgraded to DSET 3.3.

======================================================
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.3-> Uninstall DSET 
   3.3.

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.3) and click 
   the "Remove" button.

3. Click "Yes" on the Are you sure you want to 
   uninstall Dell System ESupport Tool (3.3)-> 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.3.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.3) Uninstall 
   window is displayed.

3. Click "Next".
   The Updating Screen is displayed.

4. Click "Finish" on the Dell System E-Support Tool 
   (3.3) 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{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.

For silent uninstallation, run the command:
  Msiexec /x{F34F52B2-DFE0-4103-96BF-771A4BB457F8} /qn

---------------------------
For Linux Operating System
---------------------------
dsetuninstall
Or
/opt/dell/advdiags/dset/uninstall.sh

For silent uninstallation, run the command:
  dell-dset-lx(bit)-3.3.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.3.0/DSET330.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
2   = DSET_CIM_OPTION_ERROR
3   = DSET_CIM_NAMESPACE_ERROR
6   = DSET_CIM_CONNECTION_ERROR
7   = DSET_SUDO_NOT_CONFIGURED_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
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
28  = UPLOAD_MODULE_INIT_FAILED
29  = UPLOAD_MODULE_PROXY_ERROR
30  = UPLOAD_MODULE_PROXY_UNSUPPORTED_AUTH_SCHEME
31  = UPLOAD_MODULE_PROXY_AUTHENTICATION_FAILED

------------------------------------------------------
** 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 <= 2.2 installed on the
       system is supported for DSET upgrade and user
	   has passed -qi option, but CIMOM services are
	   not installed or running
6    = Earlier version of DSET installed on the system
       is supported for DSET upgrade, but user has 
	   chosen not to upgrade to version 3.3.
7    = DSET 3.3 Provider and Collector is already 
       installed on the system.
8    = Earlier version of DSET CIM installed on the
       system is supported for DSET upgrade, but user
	   has passed -qn option.
9    = Failed to install common rpm.
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.3 full 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 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.
24   = Only provider is installed, but user has passed
       -qn option.
25   = Partial installation of DSET is found on the
       machine, but user has passed -qi option.
26   = Silent installation of collector is complete.
27   = Silent installation of provider is complete.
28   = User has tried to install earlier version of 
       DSET on a machine where a higher version already
	   exists.
29   = Earlier version of DSET <= 2.2 installed on the
       system is supported for DSET upgrade, but user
	   has passed -qn option.
30   = Earlier version of DSET <= 2.2 installed on the
       system is supported for DSET upgrade, but user
	   has passed invalid parameter along with -qi 
	   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)
  
* Remote Report collection of Windows to Linux requires 
  /tmp folder on the Linux system for the non root user
  to have write permission. (4129)
  
* When root group user collects the data from Windows to
  SLES 10 or SLES 11 using OpenManage Server 
  Administrator available in the target machine, the 
  report is not collected and the error message “Failed 
  to gather Chassis/Storage data. Check the IP Address,
  credentials and namespace.” occurs. (4127)

* 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. (2994)
  
* On Windows Operating system, if you uninstall DSET 
  during report collection, the installation is deleted 
  from the system and the report collection is terminated.

* On Linux operating system with LSI U320 scsi controller card
  and attached LT03 tape drive or PV tape drive, the information
  is not available in the DSET report. (4117)
  
* On Windows operating system, for the report collected
  using DSET namespace, the SCSI channels are not 
  enumerated under the storage section. (4085)
  
* In the DSET report, the hardware logs are not 
  enumerated for the data collected from iDRAC 
  namespace. (3759)
  
* In the report collected using DSET namespace for any
  system with Red Hat enterprise Linux 6.2, the 
  Broadcom BCM57800 1Gb NIC is enumerated as Broadcom
  BCM57800 1Gb Port  10 GB NIC. (3980)
  
* In the storage section of the DSET report, the FC 
  LUN information is not displayed in the FCHBA 
  Controller page. Only controller properties are 
  displayed. (4063)
  
* In the storage section of the DSET report, the 
  connector type for PERC S300 is displayed as "SAS 
  port Non RAID Mode" and not " SAS Port RAID Mode".
  (4086)
  
* In the DSET report for M915 Server with ESX4.1U2 
  operating system, clicking on memory class displays
  the error message "Command Unsuccessful". (4128)
  
* For 12G systems with ESXi operating system, OMSA 
  namespace report is not collecting bios setup data.
  (4394)
======================================================
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.3 
  report collection fails. Uninstall SFCB, re-install
  DSET 3.3, 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.

- Bios -> Bios Setup page will not be available when 
  a normal user under root group attempts to collect
  Windows to Linux remote DSET report from OMSA 
  namespace.

- When only DSET Collector is installed, the report 
  is not collected when using Start menu > Create 
  Advanced DSET Report or Create Basic DSET Report.

- The firmware data collected is less on 9G, 10G,
  and a few 11G servers since Maser card is not 
  available.
  
- On ESX 4.1 Operating System, less firmware data is 
  collected. To collect full firmware data, 
  usbarbitrator service should be stopped.
  
- On Linux Operating system (Red Hat Enterprise Linux 
  5.x(64 bit) and SuSE Linux Enterprise 10.x(64 bit), 
  if Dell Online Diagnostics (OLD) is installed before
  DSET, then DSET may get installed but is not operational 
  due to incompatible version of srvadmin-hapi*.rpm 
  installed by OLD.
  
  Work Around:
	Uninstall the incompatible version of srvadmin-hapi
	and try to install DSET again.

- On Linux Operating system (Red Hat Enterprise Linux 
  5.x(64 bit) or SuSE Linux Enterprise 10.x(64 bit), 
  if Dell Online Diagnostics (OLD) is installed before 
  DSET and SFCB is also installed, then DSET installation
  may fail with the following error: 
  "Either SFCB installed on this system is not functional
   or the 'root' password entered is incorrect. 
   Please Check the 'root' password or reinstall/upgrade
   the SFCB from Operating System Media and try 
   re-installing DSET"
  This error is due to incompatible version of 
  srvadmin-hapi*.rpm installed by OLD.

  Work Around:
	Uninstall the incompatible version of srvadmin-hapi
	and try to install DSET again.

- On Linux Operating system (Red Hat Enterprise Linux 
  5.x-64 bit or SuSE Linux Enterprise 10.x-64 bit), 
  if Dell Online Diagnostics (OLD) is installed before
  DSET, and tog-Pegasus is also installed, then DSET 
  installation may fail with the following error: 
  "Either tog-Pegasus installed on this system is not 
   functional or the 'root' password entered is incorrect. 
   Please check the 'root' password or reinstall/upgrade
   the Tog-Pegasus from Operating System Media and try
   re-installing DSET"
  This error is due to incompatible version of 
  srvadmin-hapi*.rpm installed by OLD.

  Work Around:
	Uninstall the incompatible version of srvadmin-hapi
	and try to install DSET again.
======================================================
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 - 09		Rev. A01