Dell Update Packages version 21.04 User's Guide April 2021 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 - 2021 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...............................................................................................................................................................18 Windows CLI Options....................................................................................................................................................... 20 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.
For Windows operating systems DUP generates the event log in the event viewer folder and the corresponding instances get generated. For the Linux operating systems DUP generates the event log in the folder. The log instance provides details of different performance parameters like Exit Code, DUP log location and name details.
● Add executable privileges to the package filename. Type the following command: chmod +x packagename.bin. ● Verify that the package meets the prerequisites for performing an update. To perform the check, type: ./ packagename.bin -c. ● Utilize one of the following methodologies for performing the updates. The first method is called the Single update method. In this method, Run the DUP from the command line in interactive mode to perform the update. The other method is called the Script method.
NOTE: You can also download a DUP or group of DUPs using Dell Repository Manager. See the Dell Repository Manager User's Guide for more information. Downloading DUPs through Repository Manager You can download DUPs from Dell Repository Manager. 1. In the Dell Repository Manager window, click My Repositories tab. 2. Click New → Create New Repository. The Create Repository window is displayed. 3. Type the Name and Description. 4. Click Next. The Base Repository window is displayed.
Table 1.
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.
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 .
● ‑r for reboot if a reboot is required for the type of update being performed. 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.
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. Execute the DUP by double-clicking the filename from within Windows Explorer. 2. Read the update information displayed in the DUP window. 3. Check the DUP inventory report for Package version and installed versions of component. 4. Click Install to install the DUP. 5. 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.
For Systems Running Linux: To install the previous version from a script, use -q (unattended) mode. In addition, you must use the CLI -f option, which forces the downgrade. 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.
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.
If you have updated the BIOS or firmware of the system only once, the rollback feature offers the option of reverting to the factory-installed BIOS or firmware images. If you have updated the BIOS or firmware to multiple versions, the factory-installed images are overwritten and you cannot revert to them. 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 CLI Option CLI Task Description Command Syntax -q Execute the DUP silently without user intervention. ./packagename.bin -q Run command in non-interactive mode -r Reboot option ./packagename.bin -r ‑q Reboot the system, if required, after performing the update. The reboot does not occur: ● 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.
Table 2. Linux CLI Options: Usage CLI Option CLI Task Description Command Syntax --installpath= DUP allows the user to install application DUP to the desired defined location. ./packagename.bin -installpath= Windows CLI Options For a list of the CLI options for systems running Windows, a description of each option, and the command syntax see the following table.
Table 3. Windows CLI Options: Usage (continued) CLI Option CLI Task Description Command Syntax NOTE: If the file name contains spaces, use quotation marks around the value. The /s option is required with this option. /r Reboot option packagename.exe /s /r /l=c: \pkg.log Reboots the system, if required, after performing the update. The reboot does not occur: ● If the DUP fails or is not applicable to the target system. ● If the DUP does not require a reboot.
Table 3. Windows CLI Options: Usage CLI Option CLI Task Description Command Syntax /drivers= This feature extracts only driver contents from the DUP. Packagename.exe /s / drivers= /driveronly This features installs only driver contents from the DUP. Packagename.exe /s /driveronly Exit Codes for CLI Exit codes help you determine and analyze the execution results after you run DUPs. After running DUPs, see the exit codes that are described in the following table. Table 4.
Table 4. Exit Codes Value Message Name Display Name Description For example, if the fmt command is compromised, the framework displays the message: rpm verify failed: .M...... /usr/bin/fmt RPM Verify Output Legend: .‑ Verification test passed S‑ File Size differs. M‑ Mode differs (includes permissions and file type). 5‑ MD5 sum differs. D‑ Device major/minor number mismatch L‑ ReadLink(2) path mismatch U‑ User ownership differs. G‑ Group ownership differs. T‑ mTime differs.
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 Message 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. Install the following software, and then retry the update.
Table 5. Update Packages Message Information Message 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 . This Update Package requires a newer version of the OpenIPMI driver than is currently installed on the system, which is version .
Table 5. Update Packages Message Information Message 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. Archive cannot be extracted.
Table 5. Update Packages Message Information 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’. This process may take several minutes to complete.
Table 5. Update Packages Message Information (continued) Message packagename.bin: Rebuilding Package failed - Unable to extract package contents. 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.
Table 5. Update Packages Message Information Message Description/Solution incidental, special, or consequential damages suffered during or after package customization and execution. 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.
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 Message This Update Package is not compatible with your system. Your system: This Update Package is not compatible with your system. Your system: Systems(s) supported by this package: ...: Description/Solution Select a compatible DUP, and try the update again. Select a compatible DUP, and try the update again. This Update Package cannot be executed under the current operating system.
Table 6. Messages Message The version of this Update same as the currently installed Software application name: Package version: version: Description/Solution Package is the The DUP you selected cannot be installed because the same version of the software already exists on the system. version. Installed In the interactive mode , ClickYes when prompted to continue with the installation. This package is not compatible with the version of Server Agent on your system.
NOTE: User needs to have administrative privilege to see the log files.
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.
● Enabling remote agent use of the Local System Account to perform a DUP update. The Local System Account is not protected by UAC (recommended option). ● 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.
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.
Question: Why does the DUP for the system BIOS require a reboot? 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.
10 Appendix This chapter contains the copyrights information for all the licenses that are used in DUP framework. libxml2 Except where otherwise noted in the source code (e.g. the files hash.c, list.c, and the trio files, which are covered by a similar license but with different Copyright notices) all the files are: Copyright (C) 1998-2012 Daniel Veillard. All Rights Reserved.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
