Dell Update Packages User's Guide
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. © 2016 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
Contents 1 Getting Started............................................................................................................... 5 What’s new in this release..................................................................................................................................................5 DUP event viewer.............................................................................................................................................................. 5 Zip pack elimination.
Command Line Interface Reference...............................................................................17 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 and 13th generation of PowerEdge servers, iDRAC and Lifecycle Controller has common DUP update.
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. The details of the slot information are also captured in the DUP log files. Dependency DUP supports the following dependencies: • Soft Dependency — Dependency(s) that needs to be applied in order to use certain new features coming with the update. For example, when the features of BIOS 1.7 are enabled only when iDRAC is at 2.
To run the check from the CLI, type: packagename.exe /c /s. To run the check from the GUI: 1. Double-click the .exe file for the DUP you downloaded. 2. Read the information about the update in the GUI’s scrolling text window. You can view the log results after running the check option from either the CLI or the GUI. The default path for the older version prior to DUP 7.2 framework is %SystemDrive%\dell\updatepackage\log. The paths of the log files from 7.
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. Select and open from the repository list displayed. 7. Click on the Components tab to view the list of DUPs available. 8. Choose any or all of the DUPs displayed. 9. Click on Download File. Provide the path and click OK. 10. The selected DUPs appear in the Job Queue. 11.
NOTE: On 13G systems, the iDRAC and Lifecycle Controller has common DUP update. Best practices for using DUPs • Prepare repair disks before you perform any updates. • Download the currently installed version of drivers, BIOS, and firmware, so that you have a backup plan in case of any issues. • Make sure that you have a backup of operating system files or system configuration files stored on a system other than the one you are updating.
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 . Updating Packages Component and System Compatibility You can run the DUP and read the summary information. This information is provided to help you determine whether the update is appropriate for the system and specific environment.
For more information on the command line interface (CLI), see Command Line Interface Reference. Verifying the Digital Signature A digital signature is used to authenticate the identity of the signer of an Update Package and to certify that the original content is unchanged. Digital signature of DUPs provide a reliable and trustful method of authentication.
Verifying the Digital Signature On Systems Running Windows To verify the Update Package’s digital signature: 1. Start Windows Explorer and locate the Update Package whose digital signature you want to verify. 2. Right-click the filename. 3. Click Properties in the pop-up menu. 4. In the Properties window, click the Digital Signatures tab. If this tab is not displayed, the Update Package is not signed. 5. Select the signature from the signature list, and click Details.
Saving Console Output for Linux As the DUPs are executed, messages are printed to the console. To redirect console output, use the following syntax with interactive commands: ./packagename.bin|tee -a logname.lo The |tee specifies the output from the DUP to be sent to both the console and to a log file. The ‑a switch ensures that the output is appended to a file, protecting any previous log file output from being overwritten.
NOTE: DUPs for Linux can also be found in the repository on the Dell OpenManage Server Update Utility DVD 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. In addition, you must use the CLI /f option, which forces the downgrade.
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. 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.
CLI Option CLI Task Description Command Syntax -r Reboot the system, if required, after performing the update. The reboot does not occur: ./packagename.bin -r ‑q Reboot option • • 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. -v,--version Display version option Display the version, fixes, enhancements, and release date; lists systems to which the DUP can be applied. .
CLI Option CLI Task Description Command Syntax When you click Install in the graphical user interface (GUI) mode, the same checking process is performed. /e= Extract option Extracts all files contained in the DUP to the path you specify. If the directory specified in the path does not exist, it is created. packagename.exe /s /e=c:\update packagename.exe /s /e="c:\update files" If the path contains spaces, use quotation marks around the value. The /s option is required with this option.
CLI Option CLI Task Description Command Syntax NOTE: Using the /s option causes all output to be written to log files. /u= Unicode Log option Appends logged messages to a specified packagename.exe /s /u=c:\pkg.log Unicode file; creates a new file if one does not exist. If the file name contains spaces, packagename.exe /s /u="c:\Update Log use quotation marks around the \pkg.log" value. The /s option is required with this option.
Value Message Name Display Name Description message and an RPM Verify Legend, and then exits with exit code 9. RPM produces output only if there is a verification failure. The format of the output is: .SM5DLUGT 'utility name' For example, if the fmt command is compromised, the framework displays the message: rpm verify failed: .M...... /usr/bin/fmt RPM Verify Output Legend: .
5 Linux Troubleshooting This section describes possible troubleshooting steps related to Linux Operating System. 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.
To resolve this, stop the Dell OpenManage Server Administrator and Dell OpenManage Server Administrator Storage Management Service before running the storage controller firmware DUPs. Loss of Functionality While Renaming Linux DUPs Linux DUPs can be executed even if they are renamed, but some functionality is lost. Renamed Linux DUPs with extensions that are in the Linux MIME (Multimedia Internet Message Extensions) database could fail to execute from various X‑Windows desktops, for example GNOME.
Message Description/Solution Current version: Required version: You must use the -f option to continue with the update in the non‑interactive mode. The version of this DUP is either older than or the same as the version installed. To apply the DUP, you must force execution. The software to be updated was not found. Install the following software, and then retry the update. Software name: Required version: The system does not contain the software that matches the DUP.
Message Description/Solution Kernel source for the running kernel is not installed, and the currently installed OpenIPMI driver RPM was installed without the kernel source for the running kernel. In order to install OpenIPMI driver modules for the running kernel that meet the minimum version requirement, you must install kernel source for the running kernel, and then use DKMS (see man page for dkms) to install and build OpenIPMI driver modules for the running kernel.
Message Description/Solution Please provide a directory name to extract to. Provide a directory name for the extracted files. ROOT directory cannot be used for extraction. Create a directory for the extracted files. Successfully extracted to "/extractdir" The package contents were extracted to the directory you designated. Cannot find utilities on the system to extract package.
Message Description/Solution Rebuilding Package Failed - RPM Installation failed with error code= Provides the RPM error code that prevented the package from being rebuilt. packagename.bin: Rebuilding Package failed Unable to extract package contents. Make sure that there is enough space in the /tmp directory. packagename.bin: Rebuilding Package - Kernel is already supported by this package.
Message Description/Solution 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. Re-application of BIOS or firmware DUP serves no purpose. Inventory operation exceeded specified timeout. Inventory operations have time-out limits as defined in the package’s PIEConfig.xml file. Time‑out durations are in seconds.
Message Location The default location of the message log files is /var/log/dell/updatepackage/log.
6 Troubleshooting for Systems Running Windows This section describes possible troubleshooting steps related to systems running Microsoft Windows. 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.com/support/manuals, provides the latest information regarding known issues.
Message Description/Solution Systems(s) supported by this package: ...: This Update Package cannot be executed under the current operating system. The operating system is not supported by DUP. For a list of supported operating system check the Dell Systems Software Support Matrix. This document is available at dell.com/ support/manuals. Your system does not have the minimum operating system version or service pack required for this Update Package.
Message Description/Solution upgrade to Server Administrator before running this package. Administrator privileges are required to perform this update. Log in with Administrator privileges, and try the update again. You must reboot the system for the update to take effect. If you shut down or power off the system after performing an update, you will lose the update. An Update Package is already running. Wait until it is complete before proceeding with another update.
NOTE: The support log files are intended for use by Dell support personnel. Dell encourages you to redirect the DUP output to a file of your choice.
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.
NOTE: In addition to BIOS DUP, execution of firmware DUP for U320, Serial Attached SCSI (SAS) 5, SAS 6, Expandable RAID Controller (PERC) 5, PERC 6, and Cost Effective RAID Controller (CERC) 6 controllers is blocked on a system having a TPM version 1.2 chip, TPM Security set at ON with pre‑boot measurement, and TPM Activation set at Enabled if you enable BitLocker (TPM or TPM with USB or TPM with PIN).
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.
UAC Restrictions When Running DUPs Remotely By default, after UAC starts, all Administrator Account users login as Standard Users. Thus, rights to access critical system resources are not available until the user confirms the privilege elevation request. This restriction disables the option to remotely deploy DUPs. UAC returns an Access Denied error if the management node agent runs on these login credentials.
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: Use the /s and /l options to direct the output to the log files. Question: How can I gain access to the DUP dependency information and other information? Answer: This information is displayed on the initial graphical user interface (GUI) screen when you run the DUP. Some information is also available by using the CLI,/c/s options. (You must use the /c /s options together.
Answer: Only certain CLI options can be used simultaneously. When invalid combinations of CLI options are entered in a single command string, only the option with the highest priority is executed. For details on which commands can be used together for different operating system, see Command Line Interface Reference . Question: How do I verify that the DUPs that I have downloaded has a digital signature? Answer: In Windows Explorer, locate the DUP that you want to verify and right-click the filename.