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. © 2018 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents 1 Getting Started.............................................................................................................................................. 5 What’s new in this release................................................................................................................................................ 5 DUP event viewer........................................................................................................................................................
Command Line Interface Reference..............................................................................................................18 Linux CLI Options..............................................................................................................................................................18 Windows CLI Options......................................................................................................................................................
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.
– Citrix Xen Server 7.1 – Ubuntu v16.04 • Support for Selective update feature. • Support for Install Path for application DUP feature. • Support for Drivers and Driveronly feature in Microsoft Windows platform. • SHA256 signing support for Linux DUPs. NOTE: For detailed information on various Dell systems and operating systems on which DUP is supported, see the Dell Systems Software Support Matrix at dell.com/openmanagemanuals.
• You have administrator privileges. Prerequisites And Features For Systems Running Linux This section lists all the prerequisites and features for systems running the Linux operating system. Dell-Qualified and Dell-Enabled Packages 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.
NOTE: DUPs are also available in the repository folder in the Dell OpenManage Server Update Utility DVD, along with the Catalog.xml (that contains information about both Windows and Linux DUPs) and DellSoftwareBundleReport.html files. To download DUPs from www.dell.com/support: 1 Go to www.dell.com/support and select Support for Work. 2 Type the Service Tag and click submit. 3 Select Drivers and Downloads. 4 Select the operating system, category, and the update importance.
Interactive Mode In an interactive mode, if a fresh installation is applicable, DUP displays a message to install the driver along with the version of the package. Click Yes to install the package. Installation results are logged in the DUP Message Logs. Non-Interactive Mode When a fresh installation is applicable, executing DUPs with the /s switch installs the driver. For example, packagename.exe /s and packagename.exe /s /r performs fresh installation of driver DUPs.
• Do not run other applications while executing DUPs. • On a Microsoft Hyper-V virtual machine, while updating the host operating system components, ensure that the guest operating systems are not running. • Do not shut down the system while an update is in progress. • Make sure that the system reboots without power interruption after performing a BIOS update. • Do not close any terminal console windows used for performing the DUP CLI execution, while DUP executions are in progress.
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 .
Non-Interactive Mode Non‑interactive mode is essential when executing a script for applying DUPs to multiple systems. When applying DUPs to multiple systems, you cannot answer yes or no during script execution. • • • Type ‑q for non‑interactive mode. ‑f for force. ‑r for reboot if a reboot is required for the type of update being performed.
d e 4 CB10 A544 756B A70B 1019 CED6. If the fingerprint of the imported key is the same as the key owner's, you have a correct copy of the key. You can verify the key's owner in person, over the phone, or by any other means that guarantees that you are communicating with the key's true owner. c While still in the key editor, type sign. Answer the list of trust-validation questions that appear and create a passphrase to use as the secret key. You must import and validate the public key only once.
DUPs are designed with built-in error handling capabilities to ensure that the preceding requirements are validated. If the conditions are not met, no update occurs. DUPs also check for dependencies between BIOS and certain ESM packages. The application design allows you to create groups of DUPs and apply them to a wide range of systems. Additionally, if you only want to verify that a given package can be applied to the system, you can invoke the package by using the following CLI command: ./Packagename.
Network file shares also are an effective method of making DUP accessible in a distributed environment. When a DUP begins execution, it first copies the contents of the package to a temporary location on the local drive of the system. This process ensures that the update can be completed even if the connection to the network share is lost for any reason.
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.
Lifecycle Controller supports platform firmware rollback to the previous version. If the operating system has a non–functioning application because of a BIOS or firmware flash, reboot to Lifecycle Controller and roll back to the previous version. NOTE: The BIOS and firmware can be only rolled back. The Lifecycle Controller application, the Dell Diagnostics application, and drivers required for operating system installation cannot be rolled back to an earlier version.
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.
CLI Option CLI Task Description Command Syntax NOTE: This option exits after displaying the requested information; no DUP verification or updates occur. -q Run command in non-interactive mode -r Reboot option Execute the DUP silently without user intervention. ./packagename.bin -q Reboot the system, if required, after ./packagename.bin -r ‑q performing the update. The reboot does not occur: • • If the DUP fails or is not applicable to the target system.
CLI Option CLI Task Description Command Syntax NOTE: This command is supported with hard drive DUPs only. DUP allows the user to install application DUP to the desired defined location. --installpath= ./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.
CLI Option CLI Task Description Command Syntax /l= Appends logged messages to a specified ASCII file; creates a new file if one does not exist. packagename.exe /s /l=c:\pkg.log Log option packagename.exe /s /l="c:\Update Log \pkg.log" NOTE: If the file name contains spaces, use quotation marks around the value. The /s option is required with this option. /r Reboot option Reboots the system, if required, after performing the update. The reboot does not occur: • • packagename.
CLI Option CLI Task Description Command Syntax /installpath= DUP allows the user to install application DUP packagename.exe /s / to the desired defined location. installpath= /drivers= This feature extracts only driver contents from the DUP. /driveronly This features installs only driver contents from Packagename.exe /s /driveronly the DUP. Packagename.exe /s / drivers= Exit Codes for CLI Exit codes help you determine and analyze the execution results after you run DUPs.
Value Message Name Display Name Description compromised, the framework displays a 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. 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.
Insufficient Free Physical Memory to Load the BIOS Image BIOS updates require enough free physical memory to load the entire BIOS image into the physical memory. If there is insufficient free physical memory available on the system to load the BIOS image, the DUP for the BIOS may fail. To resolve, the BIOS can be updated using UEFI-based update utility or Lifecycle Controller Platform Update option, run the DUP after adding more memory or immediately after a reboot.
NOTE: Using the reboot=w option as documented in the Linux Kernel documentation might cause a Kernel Panic to occur on Red Hat Enterprise Linux 6 while the system shuts down. Messages For descriptions and solutions to messages that you may receive when running DUPs, see the following table: Table 5.
Message Description/Solution (Using the CLI) Specify the -f option. This package is not compatible with the version of Server Agent on your system. You must upgrade to Server Administrator before running this package. Use an alternative update method from dell.com/support/ manuals. This update package requires an OpenIPMI driver. The DUP you selected cannot be installed because you do not Currently no OpenIPMI driver is installed on have the OpenIPMI driver installed on the system. the system.
Message Description/Solution version "kernel.x". This process may take several minutes to complete... No specific kernel version specified! Building support for current kernel... Unable to determine current system kernel. The DUP application attempts to rebuild the package. Cannot create directory /extract directory. Please ensure that there is enough space. Extracting the package to this path requires more disk space than available.
Message Description/Solution This process may take several minutes to complete. Wait for the process to complete. Rebuilding Package Failed - Unable to extract package contents. Unable to extract the contents of the package. Rebuilding Package Failed - Server Administrator Packages cannot be rebuilt on a system that has the HAPI device device driver (HAPI) is already installed on driver installed. the system.
Message Description/Solution packagename.bin: Rebuilding Package failed Packages cannot be rebuilt on a system that has Server Server Administrator is installed on the system. Administrator installed. Uninstall Server Administrator from the system before using the ‑‑rebuild option. The installed operating system version is not supported by this Update Package. To customize this package, see "Rebuilding Packages" in the Update Package User’s Guide.In no event shall Dell Inc.
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 Description/Solution This Update Package is not compatible with your Select a compatible DUP, and try the update again. system. Your system: This Update Package is not compatible with your Select a compatible DUP, and try the update again. system. Your system: Systems(s) supported by this package: ...: This Update Package cannot be executed under the current operating system.
Message Description/Solution In the interactive mode , ClickYes when prompted to continue with the installation. This package is not compatible with the version Use an alternative update method from dell.com/support/manuals. of Server Agent on your system. You must 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.
• 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 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.
Trusted Platform Module and BitLocker Support 37
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.
