Dell™ OpenManage™ Server Update Utility User's Guide
Other Documents You Might Need
Dell OpenManage Server Update Utility (SUU) is an application that identifies and applies updates to your system. You can use SUU to update your Dell system or to view the updates available for any system supported by SUU.
SUU compares the versions of components currently installed on your system with the update components packaged on the Dell Server Updates DVD. SUU then displays a comparison report of the versions and provides the option of updating the components.
|
NOTE: Only users with administrator (Microsoft® Windows®) or root (Linux) privileges can perform updates with SUU. |
The following features are introduced in SUU 1.8:
SUU 1.8 allows you to upgrade components using the -e or -upgradeonly command in the CLI. Earlier releases of SUU allowed you to update components (upgrade and downgrade in the same session) through the CLI. You could not perform only an upgrade. For a list of all the CLI commands, see Using the CLI.
SUU 1.8 allows you to downgrade components using the -n or -downgradeonly command in the CLI. Earlier releases of SUU allowed you to update components (upgrade and downgrade in the same session) through the CLI. You could not perform only a downgrade. For a list of all the CLI commands, see Using the CLI.
For detailed information about the supported Dell systems see the SUU Readme file located at the <%systemdrive%>\suu directory.
Table 1-1 lists the icons that indicate the update status for a component in the Comparison Report.
Table 1-1. Icons and Update Status
SUU is supported on Dell PowerEdge systems running versions of Windows or Linux operating systems listed below.
For detailed information about the various Dell systems and operating systems that SUU is supported on, see the Dell Systems Software Support Matrix. This guide is available on the Dell Support website at support.dell.com or on the Dell Systems Management Tools and Documentation DVD.
SUU is both a Graphical User Interface (GUI) and a Command Line Interface (CLI) based application.
You can use the GUI to:
You can use the CLI to:
To launch the SUU GUI, insert the Dell Server Updates DVD into the DVD drive.
If SUU does not launch automatically, navigate to the Dell Server Updates DVD root directory and launch suulauncher.exe (for Windows systems) or type suu -g (for both Windows and Linux systems) in a command window.
In the GUI, you can start with a comparison of the components in your Dell system and the components in the repository. You can then proceed to upgrade, downgrade, update components, or you can browse the repository for components.
Whenever SUU inventories your system for the list components installed, a progress bar that shows the progress of the inventory collection is displayed. After the progress bar completes 100%, SUU displays the Comparison Report.
|
NOTE: On the Red Hat Enterprise Linux Server version 5 operating system, DVDs are auto-mounted with the -noexec mount option. This option does not allow you to use the autorun feature or run any executable from the DVD. You need to manually mount the DVD and then run the executables. |
|
NOTE: Ensure that the path from which you run SUU does not exceed 260 characters on the Windows operating system. On Linux systems, ensure that the path from which you run SUU does not exceed 4096 characters. |
When you start SUU, SUU performs a prerequisites check. In the prerequisites check, SUU performs an update and scans your system to determine if a hardware or software update is required. When the scan is complete, SUU displays the list of components whose prerequisite conditions are not met. The list of components may comprise hardware components, the Dell OpenManage component (software component), or hardware and software components.
If the components in your system meet the prerequisite conditions, SUU does not display the prerequisite failure messages. SUU displays the Comparison Report instead.
If the list of components that failed the prerequisite check comprises the Dell OpenManage component (software component), SUU displays a software prerequisite failure message as shown in Figure 1-1.
Figure 1-1. Software Prerequisite Failure Message
If the Dell OpenManage component is of a version earlier than 4.3, the prerequisites check fails. Install the Dell OpenManage component version 4.3 or later before proceeding with the software upgrade.
To install the Dell OpenManage component, see the Dell OpenManage Server Administrator User's Guide on the Dell Support website at support.dell.com or on the Dell Systems Management Tools and Documentation DVD.
You can also click Continue to proceed with the update of hardware components, if applicable. If you click Continue, the row for the Dell OpenManage component is disabled in the Comparison Report as shown in Figure 1-2.
Figure 1-2. Dell OpenManage Component Disabled
If the list of components that failed the prerequisite check comprises hardware components, SUU displays a message as shown in Figure 1-3.
Figure 1-3. Hardware Prerequisite Failure Message
Install these prerequisites before proceeding with the upgrade, downgrade, or update. You can also click Continue to proceed with the upgrade of the Dell OpenManage component, if applicable. To install the hardware prerequisites:
This creates the Prerequisites CD.
|
NOTE: Set the boot order in your system BIOS such that the CD drive is placed ahead of the system hard drive. |
|
NOTE: An additional reboot may be required to complete the prerequisite update. Do not remove the CD until the information on the screen prompts you to do so. |
If you click Continue, all the rows for the hardware components are disabled in the Comparison Report. If the Dell OpenManage component requires an upgrade, the corresponding row is enabled in the Comparison Report as shown in Figure 1-4. You can proceed to upgrade the Dell OpenManage component.
Figure 1-4. Hardware Components Disabled
If the list of components for which the prerequisites failed, comprises the Dell OpenManage component (software component) and the hardware components, SUU displays a prerequisite failure message as shown in Figure 1-5.
Figure 1-5. Software and Hardware Prerequisite Failure Message
You cannot proceed with any hardware or software upgrades without installing the Dell OpenManage component or the hardware prerequisites. To install the Dell OpenManage component, see the Dell OpenManage Server Administrator User's Guide on the Dell Support website at support.dell.com or on the Dell Systems Management Tools and Documentation DVD. To install the hardware prerequisites, perform the steps in Hardware Prerequisites Failure.
You can click Continue to view the Comparison Report as shown in Figure 1-6. All the rows in the Comparison Report are disabled as both, the hardware and software components, failed to meet the prerequisite conditions.
Figure 1-6. Hardware and Software Components Disabled
When you perform an upgrade, downgrade, or update, SUU copies all the update packages into a local directory on the system. The directory is <%systemdrive%>:\dell\suu in Microsoft Windows and /var/log/dell/suu in Linux. You can select the packages you want to upgrade. You can also downgrade newer versions of components on your system to the corresponding component version contained in the Dell Server Updates DVD. For more information about downgrading components, see Downgrading Components.
|
NOTICE: Do not remove the Dell Server Updates DVD from the DVD drive when you are running SUU. |
SUU compares the components installed on your system with the component versions available in the repository and displays the results in a Comparison Report. To view the Comparison Report, click your system's host name displayed in the left window directory tree.
|
NOTE: If your system's host name does not appear in the tree, either you do not have the correct user privileges, or your system does not support SUU. However, you can still browse the repository. |
The Criticality column in the Comparison Report denotes the importance of applying the update. There are four levels of criticality: Urgent, Recommended, Optional, and Inapplicable. These levels are described in Table 1-2.
For every component on your system that is current with the version in the SUU repository, SUU displays a green checkmark icon
.
For system components that are newer than the repository version components, SUU enables the Enable Downgrade check box. Select the Enable Downgrade check box and click the Downgrade button to downgrade these system components to the repository versions. For information on downgrading components, see Downgrading Components.
|
NOTE: The Enable Downgrade check box is enabled only if there is a component on the system that is newer than the repository version component. |
SUU displays the Inapplicable icon if the component version on your system equals the repository version. In that case, the update is not applicable on your system.
If the upgrade components are available, SUU enables the Upgrade button on the upper right corner of the Comparison Report (see Figure 1-7). For information on upgrading components, see Upgrading Components.
|
NOTE: You cannot use SUU to update any firmware or device driver installed on your system that does not match a comparable repository component. You must manually update components installed on your system that do not compare with the repository. |
If the Upgrade, Downgrade, or Update button is disabled, one of the following may apply:
|
NOTE: If the Comparison Report displays the same package name for more than one component in your system, and these components require an Upgrade, it means that a single execution of the package is sufficient to update all the components. Therefore, in the GUI, when you select/deselect one component, all other components that have the same package name are selected/deselected by default. |
Figure 1-7. SUU Comparison Report
In this figure, the firmware, driver, and the Dell OpenManage components have been selected for an upgrade as the repository versions are newer than the current versions installed on the system.
One of the firmware components (Dell Remote Access Controller 5 Firmware) is recommended for a downgrade as the currently installed version is newer than the version in the repository.
To upgrade components from the repository:
Figure 1-8. Upgrade Confirmation
While upgrading the components, SUU displays an update report as shown in Figure 1-9.
The status of the upgrade is reflected in the Comparison Report.
To downgrade components from the repository:
SUU disables the Enable System Set Update check box and selects only those components that are newer than the repository version components and can be downgraded as shown in Figure 1-10. This is an automatic process and you cannot select/deselect individual packages.
While downgrading the components, SUU displays a progress report.
The status of the downgrade is reflected in the Comparison Report.
When the upgrade/downgrade/update operation completes, you may get a message prompting you to restart the system to complete the upgrade/downgrade/update process. If so, leave the Dell Server Updates DVD in the DVD drive during the restart.
|
NOTE: When you upgrade/downgrade/update the BIOS, you must restart immediately. SUU does not allow you to continue until you restart the system. |
|
NOTE: When you restart the system, log in using the same user account or user privileges that you used during the previous boot. |
After you log into the operating system, open a command window and type suu -g (for both Windows and Linux systems), or suulauncher.exe (for Windows systems) to restart the SUU GUI.
You can run SUU from a network location and update components on multiple systems. This feature is called the network share support feature.
|
NOTE: You must be connected to the network to use the network share support feature. |
To run SUU from a network location:
If you click Yes, SUU displays the Update dialog box that shows the progress of the update/upgrade/downgrade.
The updates are reflected in the Comparison Report.
Ensure that the name of your report or the path in which you save the report does not exceed 260 characters if you are running SUU on Windows. On Linux systems, ensure that the name of your report does not exceed 255 characters or the path in which you save the report does not exceed 4096 characters.
You can upgrade and downgrade components at the same time using the System Set Update feature. This saves you the time and effort of upgrading or downgrading components one at a time.
To upgrade and downgrade components at the same time:
Figure 1-11. Enable Downgrade Check Box Disabled
All the components that can be updated are selected in the Comparison Report.
|
NOTE: You cannot deselect individual components when you select the Enable System Set Update check box. |
If you click Yes, SUU displays the Update dialog box that shows the progress of the update.
The updates are reflected in the Comparison Report.
|
NOTE: Do not click Update in SUU when the Comparison Report is displayed and an application other than the SUU is updating your system components. In such a scenario, restart SUU and then perform an update through SUU. |
|
NOTE: The update status of some components will be effective only after you restart your system. |
From SUU version 1.5 onwards, you can upgrade Dell OpenManage service packs. The procedure to upgrade Dell OpenManage service packs is the same as that to upgrade the hardware components.
To upgrade Dell OpenManage service packs:
If you click Yes, SUU displays the Update dialog box that shows the progress of the upgrade as shown in Figure 1-12.
Figure 1-12. Dell OpenManage Upgrade Progress
Dell OpenManage service packs have been upgraded.
You can choose whether to continue or stop the update if the package that you have selected for an update encounters an update failure.
To continue or stop updates:
Figure 1-13. Stop on Update Failures Option Selected
|
NOTE: The Stop on Update Failures check box is enabled only if you have selected more than one component for an update. |
SUU starts the upgrade of the components selected for upgrade. If SUU encounters a failure while updating the first component, SUU does not continue updating the other components. It displays the failure icon (
) in the Update dialog box indicating that the update has failed. SUU also displays the
icon in the Update dialog box denoting that the other components selected for update have not been updated.
After the update process, SUU displays an Update Error dialog box stating an update error as shown in Figure 1-14.
Figure 1-14. Failure of Update
If you do not select the Stop on Update Failures check box, and SUU encounters an update failure, then SUU continues updating the other components as shown in Figure 1-15.
Figure 1-15. Continue on Update Progress
In Figure 1-15, the first component was not updated because of an update failure. However, SUU has updated the second component because the Stop on Update Failures check box was not selected.
SUU then displays an Update dialog box that shows that the first component has not been updated but the second component has been updated. SUU also displays an Update Error dialog box that states an update failure as shown in Figure 1-16.
Figure 1-16. Continue on Update Error
SUU has updated/stopped the updates of components depending on whether or not you selected the Stop on Update Failures check box.
You can export the Comparison Report and save it on your system as a CSV, HTML, or XML file.
To export the Comparison Report, click Export Report.
You can save the report in a .csv, .html, or .xml format on your system.
|
NOTE: Ensure that the name of your report or the path in which you save the report does not exceed 260 characters if you are running SUU on Windows. On Linux systems, ensure that the name of your report does not exceed 255 characters or the path in which you save the report does not exceed 4096 characters. |
In SUU, you can view the details of the packages or bundles displayed in the repository.
To view the details of a package, select a package in the repository table. The details are displayed in the Package Summary section as shown in Figure 1-18. You can also use the up-arrow and down-arrow keys to view the details of a package.
Figure 1-18. Package Details of a Selected Package
You can also view the details of a bundle.
To view the bundle-level details, select any bundle under the repository tree on the left-hand side pane of the SUU GUI. SUU displays the information for the selected bundle in the System Summary section and the packages specific to this bundle in the repository table as shown in Figure 1-19.
Hardware packages are denoted by the
icon and software packages are denoted by the
icon.
|
NOTE: You can use the <Tab> key to navigate through the Comparison Report table or the package/bundle-level details table and the <Ctrl><Tab> keys to navigate from the Comparison Report table or the package/bundle-level details table to the tree on the left-hand side of the SUU GUI. |
Figure 1-19. Bundle-Level Details
You can sort the columns in the Comparison Report and the repository table by clicking the column names. SUU sorts the columns in the ascending or descending order. The
icon indicates that the column has been sorted in the ascending order and the
icon indicates that the column has been sorted in the descending order.
Figure 1-20 shows the Package Name column sorted in the ascending order.
Figure 1-20. Package Names Sorted
To browse through the repository:
Figure 1-21 shows all available components in the repository.
You can view the repository for all the systems that support Windows and Linux. See the DellSoftwareBundleReport.html in the repository directory for details on the contents of the repository.
SUU creates two event logs: update.log and support.log. The update log shows the status of each component updated. The support log contains trace and debug data and is only used by Dell Support.
The default location for the SUU logs in Microsoft Windows is <%systemdrive%>:\dell\suu. The default location for the Linux logs is /var/log/dell/suu.
|
NOTE: You can use the suu -d command in the CLI to change the default location of the SUU logs. |
|
NOTE: The directory that you specify for the event logs must exist. SUU does not create the directory. |
To run SUU from the CLI, you must be in the Dell Server Updates DVD root directory. If you are running SUU on a network share, copy the Dell Server Updates DVD contents to a shared directory and run the CLI from the shared directory.
All CLI commands begin with the suu string followed by a space and then the short or long form of the command. If you type suu -? or suu -help or suu -h, the command line interface displays the syntax for SUU CLI commands:
Usage: suu [<command>] [-d | -directory <directory_name>]
Table 1-3 lists the SUU commands. To run a CLI command, open a command window and type the appropriate CLI command syntax at the command prompt.
Table 1-3. Server Update Utility CLI Commands
The default location for SUU event logs in Windows is <%systemdrive%>:\dell\suu. The default location for the logs in Linux is /var/log/dell/suu.
When you type suu with a command and a directory path, you can change the default location for logs for that session of SUU. To change the directory location for logs for a session of SUU, type:
suu <command> -directory <path>
For example, if you type suu -u -directory c:\tmp, SUU runs an update on the system and redirects logs to c:\tmp instead of c:\dell\suu.
To run the SUU comparison application, type suu -c. A welcome screen is displayed. While the comparison is in progress, the following message accompanied by a spinning bar is displayed:
| finding applicable system update set
When complete, the Comparison Report displays as in the following example:
========Comparison Results========
Component: BIOS
Component type: BIOS
current version: A11 < repository version A12
package name: PE1600SC-BIOS-WIN-Al2.exe
The Comparison Report provides a listing of the installed system components and the comparable SUU repository components. The comparison of the version levels is indicated with the arithmetic symbols > (greater than), < (less than), and = (equal to). The report also lists the available Dell Update Package to update the component.
|
NOTE: The update command from the CLI can be used for both an upgrade and a downgrade. |
To update your system with the selected components, type suu -u. All components that are not up-to-date with the components in the repository are upgraded. System components with versions newer than the repository version are downgraded to the repository level versions.
The -installIPMI command installs/updates the OpenIPMI driver on your Linux system. If SUU detects that updates need the OpenIPMI driver to be installed and you run commands such as suu -g, suu -c, suu -u, or suu -p, an error message displays asking you to install the required OpenIPMI driver and SUU exits. Run the suu -g -installIPMI command to launch the GUI and install/upgrade the OpenIPMI driver automatically.
|
NOTE: The Dell Server Updates DVD contains the OpenIPMI driver for Linux. |
If a lower version of the OpenIPMI driver is currently installed on your system, running the -installIPMI command updates the lower version to that of the OpenIPMI driver contained on the Dell Server Updates DVD.
If there is the same or higher version of OpenIPMI driver currently installed on your system, running the -installIPMI command does not affect the currently installed driver.
To view the progress for your update, open another command shell and type suu -p.
A progress report similar to the following appears:
======update progress======
Package name : RAC_FRMW_WIN_R104824.EXE
Status : Update Successful
---------------------------------------
Package name: PE1750-BIOS-WIN-A11.exe
Status : Update is in progress
To view the inventory progress when SUU is collecting information about the components on your system, open another command shell and type suu -iprog.
A progress report similar to the following appears:
====== system inventory progress ======
no progress available
====== system inventory progress ======
54% Complete
You can choose to continue or stop further updates if the selected update packages encounter an update failure. To stop updates, type suu -u -s. If an update failure is encountered, SUU stops further package updates.
If you do not specify any parameter during the update, that is, if you type suu -u, SUU continues to update other packages even if it encounters an update failure.
Besides this guide, you can find the following guides either on the Dell Support website at support.dell.com or on the Dell Systems Management Tools and Documentation DVD:
Dell OpenManage Server Administrator is a comprehensive, one-to-one systems management solution, designed for system administrators, to manage systems locally and remotely on a network.
The readme files for SUU and Dell Update Packages ship on the Dell Server Updates DVD. These readme files contain the latest information about SUU and Dell Update Packages in addition to information about known issues.
The DellSoftwareBundleReport.html file in the repository directory (<%systemdrive%>:\suu\repository) contains details about the contents of the repository in a readable format. This is an HTML file that you can use as a quick reference for information about supported systems, packages, bundles, and other details.