1

Introduction

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

This guide provides the steps to install, maintain, upgrade, and uninstall the DSET application on Windows and Linux operating systems.

Installation Types

You can install DSET in the following methods:

???Create a One-Time Local System DSET Report ??? Generates a DSET report of the local system without permanently installing the application.

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

NOTE: This option installs DSET and Remote Provider permanently in the system.

???DSET ??? Installs DSET in the local system that collects the data (provided by various providers) available from remote systems.

NOTE: This option installs DSET permanently in the system.

???Remote Provider ??? Installs Remote Provider in the system that provides data using WMI service (for Windows) and Tog-pegasus or SFCB (for Linux).

NOTE: This option installs Remote Provider permanently in the system.

Other Documents You May Need

In addition to this user???s guide, you can view the Release Notes:

???During installation:

???For Linux, run the ./dell-dset-lx(bit)-(Version Number).bin file and select option 1.

???After permanently installing the application:

???For Windows, in the Start menu, navigate to DSET 3.7.0 ??? View Release Notes. The Release Notes is displayed.

???On Linux, ReleaseNotes.txt is available at /opt/dell/advdiags/ dset/ folder.

???For information on using DSET, see the User's Guide available at www.dell.com/serviceabilitytools.

5

Accessing documents from Dell support site

You can access the required documents in one of the following ways:

???Using the following links:

???For all Systems Management documents ??? dell.com/softwaresecuritymanuals

???For Remote Enterprise Systems Management documents ??? dell.com/esmmanuals

???For Enterprise Systems Management documents ??? dell.com/openmanagemanuals

???For Client Systems Management documents ??? dell.com/clientsystemsmanagement

???For Serviceability Tools documents ??? dell.com/serviceabilitytools

???For OpenManage Connections Enterprise Systems Management documents ??? dell.com/ OMConnectionsEnterpriseSystemsManagement

???For OpenManage Connections Client Systems Management documents ??? dell.com/ connectionsclientsystemsmanagement

???From the Dell Support site:

a.Go to dell.com/support/manuals.

b.Under General support section, click Software & Security.

c.In the Software & Security group box, click the required link from the following:

???Serviceability Tools

???Enterprise Systems Management

???Client Systems Management

???Remote Enterprise Systems Management

???Connections Client Systems Management

d.To view a document, click the required product version.

???Using search engines:

??? Type the name and version of the document in the search box.

Language Support

Dell System E-Support Tool (DSET) is only supported and certified for systems running an English- language operating systems.

Network Ports Required by DSET

The table here lists the network ports required to run DSET.

Table 1. Network Ports Required On Systems Running Microsoft Windows

6

For Linux (Ports required for ESX are same as Linux)

Table 2. Network Ports Required On Systems Running Linux Or VMware ESX

Contacting Dell

NOTE: If you do not have an active Internet connection, you can find contact information on your purchase invoice, packing slip, bill, or Dell product catalog.

Dell provides several online and telephone-based support and service options. Availability varies by country and product, and some services may not be available in your area. To contact Dell for sales, technical support, or customer service issues:

1.Go to dell.com/support.

2.Select your support category.

3.Verify your country or region in the Choose a Country/Region drop-down list at the top of page.

4.Select the appropriate service or support link based on your need.

7

2

Installing, Upgrading, and Running DSET

Application On Windows Operating

System

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

If you install or upgrade the DSET application on a system having OpenManage Server Administrator version lower than 5.5 or an incompatible application, then an error message is displayed and the installation is not completed. Install a compatible version of the Server Administrator or remove the incompatible application and then install or upgrade DSET application.

If DSET application version 3.7.0 is already installed in the system and you try to install version earlier than 3.6.0 or greater than or equal to DSET 3.3, then an error message is displayed. Uninstall version 3.7.0 and then run the setup program.

Installation Prerequisite For Windows Operating System

Before installing DSET application, make sure that:

???WMI service is installed and running.

???If WMI service is stopped, the application starts the service automatically and continues with installation.

???If WMI service is disabled, installation of application terminates with an error message.

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

???Operating system is Windows 2003 or later.

???OpenManage Server Administrator (if installed) version is 6.3 or later.

To enable the successful functioning of remote report collection from OpenManage Server Administrator 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.

8

2.Add the application "omremote.exe" (located in InsallDirectory\bin\utils) to the Firewall exception list.

???Managed System:

1.If you have the Windows firewall configured, enable remote administration by running the following command in the command prompt:

netsh firewall set service RemoteAdmin

For more information on connecting through the Windows firewall, see Microsoft's MSDN website for Platform SDK:

???Windows Management Instrumentation (Connecting through Windows Firewall) at http:// msdn.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

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

NOTE: Only DSET can be installed on system having Windows XP.

Creating One-time Local System DSET Report On

Windows Operating System

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

Using GUI For Windows Operating System

To run DSET application and create one-time report:

NOTE: You must be logged in as an Administrator or have administrator privileges to run the application. For Windows Server 2008 and later, you must be running Remote Provider with full administrator privileges.

1.Run the Dell_DSET_(Version Number).exe file.

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

2.Click Next.

The License Agreement is displayed.

3.Select the I accept the license agreement and click Next. The Installation Type window is displayed.

4.Select Create a One-Time Local System DSET Report and click Next. The Report Settings window is displayed.

5.Enter the following:

???Report Name or Full Path to Save the Report ??? Enter only the filename or the complete path with the filename to save the generated report. If you mention only the filename, the report is saved to the default location.

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

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

???Enable Report Filtering ??? Select this option to filter the data from the report. For the list of data that is filtered, see the ???Report Filtering??? section in the Dell System E-Support Tool (DSET) User's Guide.

???Automatically Upload the Report to Dell ??? Select this option to upload the report to Dell Technical Support when requested.

6.Click Next.

The Report Settings to Skip Specific Information window is displayed.

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

8.Select the Gather Advanced Log Files Information option to collect all the log information in the report.

NOTE: If you select advanced log files option, by default, all the logs are collected and may create large size reports.

9.Click Next.

The Ready to Collect Report window is displayed.

10.Click Start.

The Updating System window is displayed indicating the status of report collection.

11.Click Finish in the Dell System E-Support Tool (3.7.0) report has been successfully created window.

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

To view the report, unzip the .zip file using the password ???dell???. For more information, see the Viewing DSET Report section in the user's guide..

Using CLI For Windows Operating System

To run the DSET application, run the following command:

???Dell_DSET_(version number).exe ??? This invokes the GUI.

???Dell_DSET_(version number).exe REPORTNAME=<name> COLLECT=<hw,sw,st,lg,ad> UPLOAD=auto PRIVACY='yes|no' /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

10

PRIVACY=yes Filters data from the report. For the list of data that is filtered, see the ???Report Filtering??? section in the Dell System E-Support Tool (DSET) User's Guide.

Usage Examples on silent Zero Footprint report collection:

???Example 1: To collect the hardware, software data and upload the report automatically:

Dell_DSET_(version number).exe REPORTNAME= ZFPReport1.zip COLLECT= hw,sw UPLOAD=auto

???Example 2: To collect the software, storage, logs and report filtering:

Dell_DSET_(version number).exe REPORTNAME= ZFPReport2.zip COLLECT= sw,st,lg PRIVACY=yes

Permanently Installing DSET Application And Generating Report On Windows Operating System

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

Using GUI For Windows Operating System

To permanently install DSET application on Windows operating system:

1.Run the Dell_DSET_(Version Number).exe file.

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

2.Click Next.

The License Agreement is displayed.

3.Select I accept the license agreement and click Next. The Installation Type window is displayed.

4.Select Install DSET and click Next.

The Select Installation Type window is displayed.

5.Select one of the following options and click Next:

???DSET and Remote Provider (Recommended)

???DSET

???Remote Provider

The Destination Folder window is displayed.

6.Click Browse and select the folder to install the DSET application or use the default location and click

Next.

The User Information window is displayed.

NOTE: The default location for Windows (x86) systems is <system drive>:\Program Files\Dell and for Windows (x86_64) systems is <system drive>:\Program Files (x86)\Dell

7.Enter the following:

???Full Name ??? Enter your full name.

???Organization ??? Enter your organization information.

8.Click Next.

The Ready to Install the Application window is displayed.

9.Click Next.

11

The Updating System window is displayed indicating the installation status.

10.To generate the report and/or upload (optional step) :

???Run and Collect DSET Report ??? Select this option to generate the report.

???Automatically Upload the Report to Dell ??? This option is enabled when Run and Collect DSET Report option is selected. Select this option to upload the report to the Dell Technical Support when requested.

11.Click Finish to close the installer.

DSET application is now installed in the local system and if you have performed step 11, the report is also generated and/or uploaded.

For more information, see Using DSET Application section in the user's guide.

Using CLI For Windows Operating System

To install DSET application, run the following command:

???Dell_DSET_(version number).exe ??? This invokes the GUI.

???Dell_DSET_(version number).exe INSTALL=<full/collector/provider> INSTALLDIR=<location> /qn ??? This performs silent installation that does not display any graphical progress bar.

Where:

full = Full installation of both DSET and Remote Provider on the local system collector = Installation of DSET only for remote collection

provider = Installation of Remote Provider only for remote collection from a remote system location = optional installation path

NOTE: To install the application permanently, the INSTALL parameter must be included in the command.

Clearing Dell Hardware Logs On Windows Operating

System

DSET application clears Dell hardware logs (Embedded System Manager logs) from the system without permanently installing the application. You can clear hardware logs using the installer or from the Start menu.

Using Installer For Windows Operating System

To clear hardware logs from the system:

NOTE: This does not install DSET application permanently.

1.Run the Dell_DSET_(Version Number).exe file.

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

2.Click Next.

The License Agreement is displayed.

12

3.Select the I accept the license agreement and click Next. The Installation Type window is displayed.

4.Select Clear Dell Hardware Logs and click Next. The User Information window is displayed.

5.Enter the following:

???Full Name ??? Enter your full name.

???Organization ??? Enter your organization information.

6.Click Next.

The Ready to Install the Application window is displayed.

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

8.Enter Y to clear the logs.

The following messages are displayed:

System event logs are cleared. Press Any Key To Continue

9.Press any key.

The command window closes and the Click the Finish button to exit this installation. window is displayed.

10.Click Finish to close the DSET application.

Using GUI For Windows Operating System

To clear hardware logs:

1.Navigate to DSET 3.7.0 ??? 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 MSI Package For Large Site Automated

Deployment

To extract the MSI file from DSET EXE:

1.Run the Dell_DSET_(Version Number).exe file.

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

2.The MSI is already extracted at the following location:

13

<system drive>:\Program Files\Common Files\Wise Installation Wizard

NOTE: The MSI location for Windows (x86) systems is <system drive>:\Program Files\Common Files\Wise Installation Wizard and for Windows (x86_64) systems is <system drive>:\Program Files (x86)\Common Files\Wise Installation Wizard.

The folder must contain only one MSI file that can be copied and renamed if required.

Upgrading DSET Application On Windows Operating

System

You can upgrade to DSET application version 3.7.0 from any of the following previous versions:

???DSET 1.8

???DSET 1.9

???DSET 2.0

???DSET 2.1

???DSET 2.2

???DSET 3.2

???DSET 3.3

???DSET 3.4

???DSET 3.5.0

???DSET 3.5.1

???DSET 3.6.0

NOTE: For the DSET application versions below 1.8 automatic upgrade to version 3.7.0 is not possible. When version 3.7.0 installer is running, the installer terminates with an error message. In such cases, uninstall previous versions of the application and then install version 3.7.0.

NOTE: DSET application does not require a system reboot.

Using The Installer

To automatically upgrade to DSET application version 3.7.0 using the installer:

1.Run the Dell_DSET_(Version Number).exe file.

The Welcome to the Dell System E-Support Tool (3.7.0) 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.7.0. The License Agreement window is displayed.

NOTE: For upgrading from versions 2.2 and lower, only DSET and Remote Provider permanent installation option is available.

4.Follow steps 3 to 11 provided in Using GUI For Windows Operating System.

Using CLI

To automatically upgrade to DSET application version 3.7.0 using CLI, at the prompt, run the command:

14

???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 application is upgraded.

Where:

full = Full installation of both DSET and Remote Provider on the local system. collector = Installation of DSET only for remote collection.

provider = Installation of Remote Provider only for remote collection from a remote system.

If DSET application version 3.2 or later is currently installed in the system, use the following options to upgrade to version 3.7.0:

Table 3. : Upgrading scenarios from DSET application version 3.2 or later to version 3.7.0

15

3

Installing, Upgrading, And Running DSET

Application On Linux Operating System

This section provides information to install, upgrade and run DSET application on Linux operating system.

If you install or upgrade the DSET application on a system having OpenManage Server Administrator version lower than 5.5 or an incompatible application, then an error message is displayed and the installation is not completed. Install a compatible version of the Server Administrator or remove the incompatible application and then install or upgrade DSET application.

If DSET application version 3.7.0 is already installed in the system and you try to install version 3.6, then an error message is displayed. Uninstall version 3.7.0 and then run the setup program.

During installation, the application checks if OpenPegasus CIMOM or SFCB service is installed or running. The following table provides more information.

Table 4. : Service and DSET Application Operation

NOTE: The default port 5988 (for http) or 5989 (for https) is used by the system to install Remote Provider. If custom ports are used, update the configuration file available at /opt/dell/advdiags/dset/ config/dset.cfg.

Installation Prerequisite For Linux Operating System

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

???For installing Remote Provider, make sure that:

???Operating system is RHEL 5, RHEL 6, RHEL 7, SLES 10, SLES 11, ESX 4.0 or ESX 4.1.

???OpenManage Server Administrator (if installed) version is 6.3 or later.

???The default port 5988 (for http) or 5989 (for https) is used by the system. If custom ports are used, update the configuration file available at /opt/dell/advdiags/dset/config/dset.cfg.

16

Device Dependency On Linux Operating System

The following table lists the devices and the dependencies that are required for Linux operating system to run DSET application. If these device dependencies are not met, DSET application exhibits the default behavior.

Table 5. : Device, Dependency, and Default Behavior

Credential-less CIMOM Authentication On Systems

Running Linux

When installing DSET or collecting the DSET report using DSET version 3.5.0 and earlier on systems running Linux, you must enter password at the command line interface. If the credentials are correct and the CIMOM (SFCB or TogPegasus) authentication is successful, the installation or report collection process is successfully completed.

From DSET version 3.5.1 and later, DSET supports single sign-on for the logged-in user. Single sign-on allows you to run DSET without entering the password. CIMOM accepts a client certificate while establishing the HTTPS connection. If the certificate is signed by a trusted authority, a network connection is started. During installation, DSET generates and deploys its own certificate and key which is used later. The access to certificate and key is limited only to the root user.

A brief description about the DSET installation or report collection process:

17

1.Collecting DSET report without providing any username or password: DSET tries for CIMOM connections through certificates.

a.If the connection is successful, the report collection continues without prompting for a password.

b.If the connection is unsuccessful, DSET asks whether or not you want to provide password and continue.

???If you choose to continue, DSET prompts you to enter root password and proceed.

???If you decide not to proceed, credential-based authentication is not performed.

2.Collecting DSET report by providing username and/or password, DSET will not try for a certificate- based connection and prompts for a password (if not entered).

NOTE: The tasks mentioned earlier in Credential-less CIMOM Authentication On Systems Running Linux section are also applicable for DSET installation only when CIMOMs are pre-installed and operational.

Possible Reasons For Unsuccessful Certificate Connection

The following are the possible reasons for unsuccessful certificate connection:

???DSET client certificate has expired. By default, the certificate is valid for one year from the time of generation.

???A particular version of operating system or CIMOM does not support certificate-based Authentication.

???DSET does not perform the certificate-based connections because there are known issues with a particular version of operating system or CIMOM for certificate-based authentication.

???DSET client certificate or CIMOM Trust Store is corrupted.

Limitations

The following are the limitations:

???The Credential-less authentication does not work on ESX. Therefore, DSET requires the credentials to run on ESX.

???For Credential-less authentication, the minimum supported version of Tog-pegasus is 2.11.0 and that of SFCB is 1.3.11. In case, the server has CIMOM versions earlier than the versions specified, you will be prompted for a password.

Operating System Check Override Option On Linux

Operating System

When the you try to install DSET by running ./dell-dset-lx(bit)-(Version Number).bin, the installer checks for the type of Operating System. If you have customized Operating System, the installation is in process is automatically stopped.

To resolve this issue, run the following command:

./dell-dset-lx(bit)-(Version Number).bin --ostype=<Operating_System_Name>

where Operating_System_Name can be any of the following five values:

???SLES

???RHEL5

???RHEL6

18

???RHEL7

???CENT

???ESX

NOTE: If any other value is entered apart from the OSs listed here, the installer throws an error message.

The strict type-checking is to make sure that only the correct packages required for DSET report collection are deployed on a server.

Creating One-time Local System DSET Report On Linux

Operating System

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

To run the DSET application and create one-time report:

NOTE: You must be logged in as root user to run DSET application.

1.At the Linux shell prompt, run the ./dell-dset-lx(bit)-(Version Number).bin file. The License Agreement is displayed along with the following message:

Do you agree to the above license terms? ('y' for yes | 'Enter' to exit):

2.Enter y.

The installation types are displayed.

3.Enter <option number> to select Create a One-time Local System DSET Report.

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. To select the default option (underlined) press Enter key.

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

Do you want to enable report filtering [y|n]: Enter y to filter the data from the report. For the list of data that is filtered, see Report Filtering section in the user's guide.

7.To automatically upload the report to Dell site, enter y when the following message is displayed. Else, enter n:

19

Do you want to upload the report on request to Dell Technical Support after the report is generated [y|n]:

8.If CIMOM already exists, DSET validates the CIMOM in the following order:

a.Credential-less CIMOM authentication

b.If Credential-less CIMOM authentication is not successful, enter the root credentials of the system when the following message is displayed: Please enter "root" password:

The data collection starts, the report is generated and saved as specified in step 5. If you chose to automatically upload the report, the report is uploaded and the Report uploaded successfully message is displayed.

To view the report, see Viewing DSET Report section in the user's guide.

Creating One-time Local System DSET Report Silently

For silent Zero Footprint report collection, run the command:

dell-dset-lx(bit)-(Version Number).bin ???qn -d <options> -r <reportname> -v <yes/no> -p <password> -a<auto>:

NOTE: The -p option must be included in the command to collect the report.

NOTE: The -v yes option filters data from the report. For the list of data that is filtered, see the ???Report Filtering??? section in the Dell System E-Support Tool (DSET) User's Guide.

Permanently Installing DSET Application On Linux

Operating System

You can install or upgrade the following components:

???DSET and Remote Provider

???DSET

???Remote Provider

NOTE: You must be logged in as root to install DSET application.

1.At the Linux shell prompt, run the ./dell-dset-lx(bit)-(Version Number).bin file. The License Agreement is displayed along with the following message:

Do you agree to the above license terms? ('y' for yes | 'Enter' to exit):

2.Enter y.

The installation types are displayed. The following table provides the installation types:

Table 6. :Installation Types

20

NOTE:

???For DSET application version 2.2 or lower, installation type 1 is displayed.

???If version 3.2 or later of 'DSET and Remote Provider', or 'DSET', or 'Remote Provider' is currently installed in the system, then installation types 1, 2, and 3 are displayed.

???For DSET application 3.5.1:

???If DSET is currently installed in the system, then installation type 3 is displayed.

???If Remote Provider is currently installed in the system, then installation type 2 is displayed.

3.Enter the <option number> to select the required installation type.

If the Install/Upgrade DSET and Remote Provider or Remote Provider option is selected, during installation the following messages are displayed:

a.If OpenPegaus is not 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]?.

Enter y.

If SFCB is installed, the following message is displayed: DSET collects the Hardware data

via Common Information Model Object Model(CIMOM): sblim-sfcb, which is already present on this system, please wait while DSET validates the existing sblim-sfcb...

b.If OpenPegasus is 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 wait while DSET validates the existing tog-pegasus...

4.If CIMOM already exists, DSET validates the CIMOM in the following order:

a.Credential-less CIMOM authentication

b.If Credential-less CIMOM authentication is not successful, enter the root credentials of the system when the following message is displayed: Please enter "root" password:

Wait for the installation to complete. The following messages are displayed based on the selected installation type:

???If you selected the Install/Upgrade DSET and Remote Provider option, the following message is displayed: DSET installation completed successfully. Enter '/usr/

21

sbin/dellsysteminfo' from a terminal shell prompt to create a report file

???If you selected the DSET option, then the following message is displayed: The DSET installation completed successfully. Enter '/usr/sbin/dellsysteminfo' from a terminal shell prompt to create a report file.

???If you selected the Remote Provider option, the following message is displayed: Remote Provider installation completed successfully.

DSET application is installed at the /opt/dell location by default.

Permanently Installing DSET Application Silently On Linux Operating System

For silent installation, run the command:

dell-dset-lx(bit)-(Version Number).bin -qi <full/collector/provider>

NOTE:

???Case 1: On Linux Operating System, if no CIMOMs (SFCB / Tog-Pegasus) are present and DSET installer is executed in silent mode. DSET Installer installs SFCB and register provider on the system as part of Provider Installation, but SFCB services are not started.

???Case 2: On Linux Operating System if any CIMOMs (SFCB / Tog-Pegasus) is present and services are disabled and DSET installer is executed in silent mode, then

???If Tog-Pegasus is only present and its services are not running. Then the DSET Installer installs SFCB and register provider on the system as part of installation, but its services are not started.

???If SFCB is present and its services are not running, then DSET Installer registers provider under SFCB as part of installation, but its services are not started.

In both the cases, to collect the DSET report user must start the SFCB services and SFCB to be added as part of default start-up services. Also CIMOM Validation check for pre-existing CIMOM cannot be done in silent installation mode.

Clearing Dell Hardware Logs On Linux Operating System

DSET application clears Dell hardware logs (Embedded System Manager 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 the DSET application.

1.At the linux shell prompt, run the ./dell-dset-lx(bit)-(Version Number).bin file. The License Agreement is displayed along with the following message:

Do you agree to the above license terms? ('y' for yes | 'Enter' to exit):

2.Enter y.

The installation types are displayed.

3.Enter <option number> to select Clear Dell Hardware Logs option. The following messages are displayed:

*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:

22

System Event Logs are cleared.

Press Enter continue

5.Press Enter.

DSET application exits and the Linux shell prompt appears.

Upgrading DSET Application On Linux Operating System

You can upgrade to DSET application version 3.7.0 from any of the following previous versions:

???DSET 1.8

???DSET 1.9

???DSET 2.0

???DSET 2.1

???DSET 2.2

???DSET 3.2

???DSET 3.3

???DSET 3.4

???DSET 3.5.0

???DSET 3.5.1

???DSET 3.6.0

NOTE: For versions lower than 1.8, automatic upgrade to DSET application version 3.7.0 is not possible. When version 3.7.0 installer is run, the installer terminates with an error message.

In such cases, uninstall previous versions of the application and then install DSET application version 3.7.0.

NOTE: DSET application does not require a system reboot.

To automatically upgrade to DSET application version 3.7.0 on Linux operating system:

1.At the Linux shell prompt, run the ./dell-dset-lx(bit)-(Version Number).bin file. The License Agreement is displayed along with the following message:

Do you agree to the above license terms? ('y' for yes | 'Enter' to exit):

2.Enter y.

Dell System E-Support Tool (DSET) application options are displayed.

3.Enter the <option number> to select Install/Upgrade DSET and Remote Provider (Recommended) option. The following messages are displayed:

DSET (Version number)is already installed. Do you want to upgrade to DSET 3.7.0 [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.

23

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): tog-pegasus, which is already present on this system, Please enter the Administrator/Root password to validate the existing tog-pegasus.

6.Enter the root credentials when the following message is displayed:

Please enter "root" password:

Wait for the installation to complete.

The DSET installation completed successfully message is displayed. DSET application is upgraded to version 3.7.0 and is installed at /opt/dell location by default.

Upgrading DSET Application Silently On Linux Operating System

To upgrade silently, run the command:

./dell/dset/lx(bit)/<version number>.bin ???qi <full/collector/provider>

NOTE:

???If DSET application version 2.2 or lower is currently installed in the system and CIMOM services are not installed or running, then the application cannot be silently upgraded to version 3.7.0.

???For DSET application version 3.2 or later:

???If <full/collector/provider> parameter is provided in the command, then the currently installed DSET application is uninstalled completely and the specified component of version 3.7.0 is installed.

???If <full/collector/provider> parameter is not provided in the command, then the currently installed DSET application component is upgraded to version 3.7.0.

24

4

Maintaining DSET Application

After installing the DSET application, you can modify the components that are installed. The application maintenance window is available only when DSET application is permanently installed on your system. You can also reinstall the corrupt files, registry keys, and shortcuts of the application.

Modifying Installed DSET Application Features

The installed features that can be modified are:

???DSET ??? Permanently installs DSET interface to generate reports for remote systems.

???Remote Provider ??? Permanently installs Remote Provider to allow reports to be generated from a remote system against this system.

For Windows Operating System

To modify the components:

1.Click on the Dell_DSET_(Version Number).exe file. The Application Maintenance window is displayed.

2.Select Modify and click Next.

The Select Features window is displayed.

3.Select one of the following options and click Next:

???DSET

???Remote Provider

The Ready to Modify the Application window is displayed.

4.Click Next.

The Updating System window is displayed.

5.Click Finish to exit the DSET application. The selected component is installed.

For Linux Operating System

To modify the installed components, run the ./dell-dset-lx(bit)-(Version Number).bin file at the shell prompt. and choose the required option. You can Install another component(s). If DSET is already installed in the system, then Remote Provider option is displayed to install. If Remote Provider is already installed in the system, then DSET option is displayed to install.

For more information see Installing, Upgrading, and Running DSET Application On Linux Operating System.

To modify the installed components silently, run the ./dell-dset-lx(bit)-(Version Number).bin ???qi <full/

provider/collector> file at the shell prompt. Depending on the components existing in the system and the parameter passed in the command, the following table provides the modify options:

25

Table 7. : Silent Modify Options

NOTE: If DSET and Remote Provider is already installed in the system, then the message ???DSET

3.7.0 is already installed.Uninstall DSET by running uninstall.sh from /opt/ dell/advdiags/dset location.??? is displayed.

Repairing DSET Application

To reinstall missing or corrupt files, registry keys, and shortcuts on Windows operating system:

1.Run the Dell_DSET_(Version Number).exe file.

The Application Maintenance window is displayed.

2.Select Repair and click Next.

The Ready to Repair the Application window is displayed.

3.Click Next.

The Updating System window is displayed.

4.Click Finish to exit DSET application.

NOTE: For Linux operating system, the repairing DSET application option is not available.

26

5

Uninstalling DSET Application

DSET application can be uninstalled using the GUI or the CLI option.

Using GUI For Windows Operating System

To uninstall DSET application, use one of the following options:

???From the Start menu

???From the windows Add or Remove Programs or Programs and Features wizard

???From the Application Maintenance window

From The Start Menu

To uninstall DSET application from the Start menu on Windows operating systems:

1.Click Start ??? Programs (or All Programs) ??? DSET 3.7.0 ??? Uninstall DSET. For Windows 2012, click Start ??? Apps ??? DSET 3.7.0 ??? Uninstall DSET.

The Are you sure you want to uninstall this product window is displayed.

2.Click Yes to uninstall the DSET application.

From The Windows Add Or Remove Programs (Or Programs And Features) Wizard

To uninstall DSET application from the Windows Add or Remove Programs or Programs and Features Wizard on Windows operating systems:

1.Click Start ??? Control Panel ??? Add or Remove Programs (or Programs and Features).

2.Select Dell System E-Support Tool (3.7.0) and click the Remove button.

3.Click Yes on the Are you sure you want to remove Dell System E-Support Tool (3.7.0) from your computer? window to uninstall DSET application.

From the Application Maintenance Window

To uninstall DSET application from the Application Maintenance Window on Windows operating systems:

1.Run the Dell_DSET_(Version Number).exe file.

The Application Maintenance window is displayed.

2.Select the Remove option and click Next.

The Dell System E-Support Tool (3.7.0) Uninstall window is displayed.

3.Click Next.

The Updating System window is displayed.

4.Click Finish on the Dell System E-Support Tool (3.7.0) has been successfully uninstalled window.

27

Using CLI For Windows And Linux Operating Systems

To uninstall DSET application using the CLI, run the following command from the command prompt:

For Windows Operating System

To uninstall DSET application using the CLI, run the following command from the command prompt:

Msiexec /x {E8D4AC76-9847-4669-93DB-617DB495092A}

The Windows Installer window displays Are you sure you want to uninstall this product? message. Click Yes to uninstall the DSET application.

For silent uninstallation, run the command:

Msiexec /x {E8D4AC76-9847-4669-93DB-617DB495092A} /qn

For Linux Operating Systems

To uninstall DSET application using the CLI, run the following command from the command prompt:

dsetuninstall

Or

/opt/dell/advdiags/dset/uninstall.sh

For silent uninstallation, run the command:

dell-dset-lx(bit)-(Version Number).bin -qu

28

6

Error Codes

This appendix provides the list of DSET installer error codes.

Installer Error Codes

For Windows Operating System

Custom error codes are not supported in this release. Default MSI error codes are returned.

For Linux Operating System

The list of error codes are:

Table 8. : Installer Error Codes and Description

Error Description

Code

0 Success

2Operating system architecture and installer architecture are not same.

3Unsupported Operating System. See the "Supported Operating Systems" section in the Release Notes for the complete list of supported operating systems.

4Earlier version of DSET application installed on the system is not supported for DSET application upgrade. See the or Upgrading DSET application On Linux Operating System section for more information.

5Earlier version of DSET application (version 2.2 or lower) installed on the system is supported for DSET application upgrade and user has passed -qi option, but CIMOM services are not installed or running

6Earlier version of DSET application installed on the system is supported for DSET application upgrade, but user has chosen not to upgrade to version 3.7.0.

7DSET application 3.7.0 and Remote Provider is already installed on the system.

8Earlier version of DSET application installed on the system is supported for DSET application upgrade, but user has passed -qn option.

9Failed to install dell-dset-common rpm.

10User has chosen not to install or run SFCB.

11CIMOM architecture and installer architecture are not the same.

12Either root password is incorrect or CIMOM is not functional.

13DSET application 3.7.0 full is already installed, but user has passed -qi or -qn option.

29

Error Description

Code

14User has not agreed to the license terms.

15Silent uninstallation is complete.

16Silent installation of full DSET is complete but not functional. See the Permanently Installing DSET Application Silently On Linux Operating System for more information.

17Silent ZFP report collection is complete.

18User has aborted the installation.

19Invalid installer option is passed.

20Failed to install dell-dset-collector rpm.

21Failed to install dell-dset-provider rpm.

22User has not selected any option, hence aborted ZFP report collection.

23Only collector is installed, but user has passed -qi or -qn option.

24Only Remote Provider is installed, but user has passed -qi or -qn option.

25Partial installation of DSET application is found on the machine, but user has passed -qi option.

26Silent installation of DSET is complete.

27Silent installation of Remote Provider is complete.

28User has tried to install earlier version of DSET application on a machine where a higher version already exists.

29Earlier version of DSET application (2.2 or lower) installed on the system is supported for DSET application upgrade, but user has passed -qn option.

30Earlier version of DSET application (2.2 or lower) installed on the system is supported for DSET application upgrade, but user has passed invalid parameter along with -qi option.

31DSET application requires srvadmin-hapi component for its functioning and the minimum version supported is 6.3.0. Installed version of srvadmin-hapi is lower than 6.3.0, which is incompatible with DSET application.

32The Installed architecture of srvadmin-hapi is not 64-bit and hence not compatible with 64-bit DSET application. 64-bit srvadmin-hapi component is required for 64-bit DSET application on a 64-bit operating system.

33SFCB is not found on the machine under test, aborting installation.

345989 port is occupied by a service that is not of DSET supported CIMOM.

35vmware-esx-cim package is not found on an ESX machine.

36User chooses to abort Remote Provider installation when asked for password.

37CIMOM is not functional due to missing certificates.

38Operating System check in installer has failed and the user is asked to override the OS check.

30