Dell Update Packages User's Guide June 2020 Rev.
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2020 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents Chapter 1: Getting Started.............................................................................................................. 5 What’s new in this release....................................................................................................................................................5 DUP event viewer.................................................................................................................................................................
Linux CLI Options................................................................................................................................................................. 17 Windows CLI Options.......................................................................................................................................................... 18 Exit Codes for CLI.......................................................................................................................................
1 Getting Started A Dell Update Package (DUP) is a self-contained executable in a standard package format that updates a single software element on the system. Using DUPs, you can update a wide range of system components and apply scripts to similar sets of Dell systems to bring the system components to the same version levels. NOTE: On Dell’s 12th generation of PowerEdge servers onwards, iDRAC and Lifecycle Controller has common DUP update.
The log instance provides details of different performance parameters like Exit Code, DUP log location and name details. Zip pack elimination DUP facilitates you to extract the contents of the DUP payload and other contents in an existing folder or a defined location. Slot information for hard drive DUP provides specific information about the hard drive location detail with the slot number, storage controller, enclosures and other particulars.
Prerequisites and Features for Systems Running Windows Before installing DUPs, read the information provided online and in the downloaded package. Ensure that the updates you selected are both necessary and appropriate for the system. You may also need to complete some or all of the following steps: NOTE: Run the DUP Check option on the target system and ensure that the system meets the prerequisites for performing an update. To run the check from the CLI, type: packagename.exe /c /s.
The Create Repository window is displayed. 3. Type the Name and Description. 4. Click Next. The Base Repository window is displayed. NOTE: Click Cancel at any time to exit without creating a new repository. 5. Select a source for the repository. NOTE: You can also click on Help menu and choose the option: Import Repository from Catalog file… 6. 7. 8. 9. 10. 11. 12. Select and open from the repository list displayed. Click on the Components tab to view the list of DUPs available.
NOTE: If you have updated the BIOS, power supply firmware, PERC firmware, PCIeSSD firmware, Mellanox, Emulex firmware and driver, chipset and video drivers, Intel, QLogic and Broadcom firmware the changes to the components take effect only after you reboot the system. On 13G systems onwards, the SAS expander firmware does not require a reboot. NOTE: For a single reboot, install the ESM firmware update before the BIOS update.
2 Using Dell Update Packages Dell provides a number of aids to help you determine whether or not the system requires an update. You can download DUP from dell.com/support/manuals. For more information, see Downloading DUPs .
In the following command example, the command applies a BIOS DUP without any user confirmation, forces the execution in the case of a downgrade from a more recent BIOS version, and reboots the system after the DUP is applied. This command is executed provided the DUP satisfies all the system and version requirements. BIOS_XR23Y_LN_1.2.8.BIN ‑q ‑f ‑r For more information on the command line interface (CLI), see Command Line Interface Reference.
Executing DUPs On Systems Running Windows To run DUPs from the interactive graphical user interface (GUI), perform the following steps. This procedure applies to all Update Packages. 1. 2. 3. 4. 5. Execute the DUP by double-clicking the filename from within Windows Explorer. Read the update information displayed in the DUP window. Check the DUP inventory report for Package version and installed versions of component. Click Install to install the DUP. Reboot the system, if necessary.
System Reboot Required Certain packages, such as those that update the system BIOS, require a reboot for the new software to take effect. After you apply an update that requires a reboot, you must restart the system to complete the update. You have the option of choosing to defer the reboot until another time as long as you do not turn off the system. This feature is primarily intended to allow you to apply any number of updates together and perform the system reboot after the last update has been applied.
NOTE: If the system loses power during the update process, you must perform the updates again. NOTE: DUPs for Linux can also be found in the repository on the Dell OpenManage Server Update Utility ISO that contains the updated BIOS, and firmware components for Dell systems. For more information, see the Dell OpenManage Server Update Utility User's Guide available at dell.com/support/manuals. For Systems Running Windows: To install the earlier version from a script, use the /s (unattended) mode.
3 Update and Rollback in Lifecycle Controller Enabled Server Dell Lifecycle Controller Enabled Server is an embedded configuration utility that enables systems and storage management tasks from an embedded environment throughout the life cycle of a system. Residing on an embedded flash memory card, Lifecycle Controller is similar to a BIOS utility in that it can be started during the boot sequence and can function independently of an installed operating system.
NOTE: Rollback is not supported in the operating system environment. To enable rollback, ensure that you boot into Lifecycle Controller.
4 Command Line Interface Reference You can display information about the CLI options by typing the DUP name and either -h or --help at a command line prompt. The console displays all of the command line options and provides help for each choice. Topics: • • • Linux CLI Options Windows CLI Options Exit Codes for CLI Linux CLI Options For a list of CLI options for systems running Linux, a description of each option, and the command syntax see the following table: Table 2.
Table 2. Linux CLI Options: Usage (continued) CLI Option CLI Task Description -r ./packagename.bin -r ‑q Reboot the system, if required, after performing the update. The reboot does not occur: Reboot option • • Command Syntax If the DUP fails or is not applicable to the target system. If the DUP does not require the target system to be rebooted. NOTE: The -q option is required with this option.
NOTE: DUPs for Microsoft Windows operating systems cannot display output at the command line because they are Windows GUI applications. All output information is written to a log file. For information on log files, see DUP Message Logs. Table 3. Windows CLI Options: Usage CLI Option CLI Task Description Command Syntax /? or /h or /help Displays command line options and help information. packagename.exe /? Determines if the update can be applied to the target system. packagename.exe /s /c / l=c:\pkg.
Table 3. Windows CLI Options: Usage (continued) CLI Option CLI Task Description Command Syntax Options /e and /c are not valid with this option. /s or /silent Silent option Executes the update silently without user intervention. When /s is not specified, the DUP is launched in GUI (interactive) mode. packagename.exe /s / l=c:\pkg.log The /s option is required when using the /e, /f, /c, /l, and /u options. NOTE: Using the /s option causes all output to be written to log files.
Table 4. Exit Codes Value Message Name Display Name Description 0 SUCCESSFUL Success The update was successful. 1 UNSUCCESSFUL (FAILURE) Unsuccessful An error occurred during the update process; the update was not successful. 2 REBOOT_REQUIRED Reboot required You must restart the system to apply the updates. 3 DEP_SOFT_ERROR Soft dependency error Some possible explanations are: • • You attempted to update to the installed version of the software.
Table 4. Exit Codes (continued) Value Message Name Display Name Description U‑ User ownership differs G‑ Group ownership differs T‑ mTime differs 13 UPDATE_SUCCESSFUL_SO Update is successful. Soft FT_DEPEDENCY_NOT_ME Dependencies are not met. T The applied update is successful. The soft dependencies, which enable all the features of the updated software are not met. Apply the dependent updates for getting the full features. 14 REBOOT_REQUIRED_SOFT _DEPENDENCY_NOT_MET Update is successful.
5 Linux Troubleshooting This section describes possible troubleshooting steps related to Linux Operating System. Topics: • • • Known Issues Messages DUP Message Logs Known Issues The issues listed below are known issues and corrective actions for Dell Update Packages (DUPs) for Linux operating systems. Also see the corresponding Readme for Linux at dell.com/support/manuals. NOTE: The Readme file, which is available at dell.com/support/manuals, provides the latest information regarding known issues.
Kernel Panic While Running Storage Controller Firmware Update Packages Linux systems running one or more applications that interact with SCSI devices in certain ways are known to cause a kernel panic situation. To resolve this, stop the Dell OpenManage Server Administrator and Dell OpenManage Server Administrator Storage Management Service before running the storage controller firmware DUPs.
Table 5. Update Packages Message Information (continued) Message This Update Package cannot be executed under the current operating system. This Update Package is not compatible with any of the devices detected in your system. The prerequisite software version for this update was not found. Software application name: Current version: Required version: You must use the -f option to continue with the update in the non‑interactive mode. The software to be updated was not found.
Table 5. Update Packages Message Information (continued) Message This update package requires an OpenIPMI driver. Currently no OpenIPMI driver is installed on the system. In order to assist in the , you can download and install a version of the OpenIPMI driver that meets the minimum version requirement from dell.com/ support/manuals. The minimum version required is .
Table 5. Update Packages Message Information (continued) Message File already exists. Rebuilding package to support kernel version "kernel.x". This process may take several minutes to complete... No specific kernel version specified! Building support for current kernel... Cannot create directory /extract directory. Please ensure that there is enough space. Cannot create temporary file "filename" Unable to create Temp Files. Please ensure that there is enough space in the tmp folder.
Table 5. Update Packages Message Information (continued) Message Rebuilding Package Failed - Uninstallation of driver was unsuccessful. Package has been rebuilt successfully. Rebuilding Package Failed - Error creating output package. Rebuilding Package Failed - Error creating wrapper files. Output package: Package execution requires 'root' user privileges. Successfully extracted to . Rebuilding package packagename.bin to support ’uname -r’.
Table 5. Update Packages Message Information (continued) Message packagename.bin: Rebuilding Package - Kernel is already supported by this package. packagename.bin: Rebuilding Package Failed RPM Installation failed with error code= packagename.bin: Rebuilding Package Failed Error creating driver support directory. packagename.bin: Rebuilding Package Failed Error copying kernel modules. packagename.
Table 5. Update Packages Message Information (continued) Message In no event shall Dell Inc. be held liable for any direct, indirect, incidental, special, or consequential damages suffered during or after package customization and execution. Attempt to update BIOS or firmware to the same version. Update was unnecessary and not applied. Description/Solution Fully consider this statement before executing a customized package that was enabled by the ‑‑rebuild option.
DUP Message Logs Logging occurs when you run a command for a DUP. The logs maintain information about all update activities. DUPs write to the Messages log. If you install the same package more than once on the same system, the log is appended. The messages files directory contain messages about a wide range of events on the system. Therefore, you must scan through the log file to find the messages that are relevant to DUPs.
6 Troubleshooting for Systems Running Windows This section describes possible troubleshooting steps related to systems running Microsoft Windows. Topics: • • • Known Issues Messages DUP Message Logs Known Issues The issues listed below are known issues and corrective actions for Dell Update Packages (DUPs) on systems running Windows operating systems. Also see the corresponding Readme for Windows at dell.com/support/manuals. NOTE: The Readme file, which is available at dell.
Table 6. Messages (continued) Message This Update Package is not compatible with your system. Your system: Systems(s) supported by this package: ...: This Update Package cannot be executed under the current operating system. Your system does not have the minimum operating system version or service pack required for this Update Package. Your system exceeds the maximum operating system version supported by this Update Package.
Table 6. Messages (continued) Message Software application name: Package version: Installed version: This package is not compatible with the version of Server Agent on your system. You must upgrade to Server Administrator before running this package. Administrator privileges are required to perform this update. You must reboot the system for the update to take effect. An Update Package is already running. Wait until it is complete before proceeding with another update.
Messages Log Files The messages log file includes the following information • • • • • • • • • • • Date and time the DUP was launched Package release ID number The full path and filename of the support log generated by the command DUP type DUP version Framework version of the DUP Software application name of the DUP Version of the currently installed DUP Version that the command is trying to apply to the system Exit code that results from execution of the command Whether a reboot was performed NOTE: The sup
7 Trusted Platform Module and BitLocker Support A Trusted Platform Module (TPM) is a secure microcontroller with cryptographic capabilities designed to provide basic security‑related functions involving encryption keys. It is installed on the motherboard of the system, and communicates with the rest of the system using a hardware bus. You can establish ownership of the system and its TPM using the BIOS setup commands.
8 Microsoft Windows Server 2008 User Account Control In Microsoft Windows Server 2008 and earlier, user accounts were often members of the local Administrators group and had access to administrator privileges. Members of the local Administrators group install, update, and run software since an Administrator account has system-wide access. When a user is added to the local Administrators group, that user is automatically granted Windows privileges.
• • • Using the Local Administrator Account on each remote machine where the DUP is running. Disabling UAC for all users on remote machines (not a recommended option). Not upgrading to Administrator account on remote machines. NOTE: Only two accounts (the Local Administrator Account and the Local System Account) are not protected by UAC. All other users including accounts with local administrator rights or domain administrator rights have UAC enabled by default.
9 Frequently Asked Questions Question: Must I reboot my system after applying every Dell Update Package (DUP)? Answer: DUPs that are running in the interactive mode determine if it is necessary to reboot the system. If so, you are prompted to reboot. In the silent unattended mode, the exit code is set to 2, which indicates that a system restart is required. Question: Which operating systems are supported by DUPs? Answer: The Dell Systems Software Support Matrix available at dell.
Answer: The BIOS update is applied only after you restart the system. Question: I'd like to apply several updates to my system at once. Can I do this with DUPs? Do I need to be concerned about the order in which I apply the updates? Answer: Yes, you can apply multiple updates to the system at the same time. For information about the update order , see Installation Order of DUPs. Question: If I rename Windows DUPs, will they still function correctly? Answer: Yes. Question: Can I modify DUPs? Answer: No.
