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. © 2019 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.
DUP event viewer The event viewer log captures the DUP execution status along with the details of that particular component which updated. 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.
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. You may also need to complete some or all of the following: • 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.
2 Type the Service Tag and click submit. 3 Select Drivers and Downloads. 4 Select the operating system, category, and the update importance. The list of applicable updates are displayed. 5 Click Download. 6 To complete downloading the file, follow the instructions on the screen. NOTE: You can also download a different file format from the File Title column by selecting a file format for the DUP and clicking it. In case you want to download more than one file type, you must do it one at a time.
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. NOTE: Not all driver DUPs support fresh installation. See the Dell Update Packages for Microsoft Windows Operating Systems readme file for the list of drivers that do not support fresh installation.
Other Documents You May Need To access other documents go to dell.com/support/manuals and select the product or use the direct link on the Dell Systems Management Tools and Documentation DVD. • Dell OpenManage Legacy Compatibility Guide NOTE: You do not need to install Dell OpenManage Server Administrator on the system to run DUPs.
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.
UEFI-based update utility or Lifecycle Controller Platform Update option, run the DUP after adding more memory or immediately after a reboot. 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.
Messages For descriptions and solutions to messages that you may receive when running DUPs, see the following table: Table 5. Update Packages Message Information Message Description/Solution This Update Package is not compatible with your system Your system: System(s) supported by this package: Select a compatible DUP, and try the update again. This Update Package cannot be executed under the current operating system.
Message Description/Solution 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 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 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.Package can be rebuilt only on a system that does not have Server Administrator device driver (HAPI) installed. Unable to Install Dell Instrumentation Driver (HAPI).
Message Description/Solution 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. be held liable for any direct, indirect, incidental, special, or consequential damages suffered during or after package customization and execution.
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. 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. 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.
• 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 support log files are intended for use by Dell support personnel.
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.
You can bypass the UAC restrictions by: • 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.
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.
