DELL EMC System Update Version 1.
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 Introduction to Dell System Update................................................................................................................5 How does Dell System Update work............................................................................................................................... 5 What is Remote DSU feature..................................................................................................................................... 6 What is new in this release..
Command to create bootable non-interactive DSU ISO............................................................................................. 28 Command to create bootable interactive DSU ISO..................................................................................................... 28 Command to package the selected updates to a folder using existing bootable ISO............................................. 28 6 Sample scripts using DSU............................................................
1 Introduction to Dell System Update DELL EMC System Update (DSU) is an application used to distribute Dell updates for Linux, Microsoft Windows Operating Systems and updates through iDRAC and operating systems to iDRAC passthrough. DSU is a software designed to facilitate the application of updates on various Dell systems. Using DSU you can: • Identify the available updates, select the relevant updates, and deploy the updates on multiple systems.
What is Remote DSU feature Option to enable updates to another system from the host system. The following options are the methods to use connect with remote system for updates either using single command or updated on multiple systems Remote option for single systems • Command to use remote option on Microsoft Windows Operating System The following option is to enable the remote option on Microsoft Windows systems: dsu /remote=domain \credentials@hostname • Command to use remote option on Linux Operatin
NOTE: The command line options provided will take precedence over the config file options. NOTE: The above sample config files provides scripts to handle many IP addresses with different password and not adjusting the scripts for each IP address every time. NOTE: For the usage of remote option actual root account only can be used. Sudo users cannot be used. The remote system must have default PermitRootLogin pre-enabled in /etc/ssh/sshd_config.
2 Installing and upgrading the DSU You can install DSU on Microsoft Windows and Linux operating systems through Dell Update Package (DUP). This section lists the specifics for installing DSU. NOTE: You must have administrator privileges if DSU is installed on the supported Microsoft Windows operating system. NOTE: you must have root/super user permission if DSU is installed on the supported Linux operating system NOTE: For more information on the latest DSU RPM, see https://linux.dell.
Installing DSU DUP on Microsoft Windows operating systems from command line interface To install DSU on the supported Microsoft Windows operating system, you must install Dell Update Package (DUP) using the following steps in the command line interface : 1 Download the latest DUP from support.dell.com. 2 Launch the command prompt with administrative privileges. From the folder where DUP executable file is available, run dupfile /i command to install DUP on Microsoft Windows.
NOTE: Server Administrator does not support installation on unsupported systems. This is applicable to SC-class systems, as OMSA is not supported on these systems. NOTE: To use a 64-bit package on a 32-bit Dell package installed (srvadmin-dell) on the system, uninstall the 32-bit packages and install the 64-bit package.
3 Supported platforms for DSU This section lists the hardware and operating systems for installing DSU. Topics: • Supported hardware • Supported Operating Systems Supported hardware DSU is supported on 12th, 13th and 14th generation of Dell's PowerEdge servers. For more information on supported hardware for Linux Operating Systems, see linux.dell.com/repo/hardware/ omsa.html#Supported_Hardware.
Support for Ubuntu operating systems Support for Ubuntu operating systems is pre-enabled and the support is limited. All the DSU commands may function as usual without any issues. • Ubuntu 18.04.2 For more information on the catalog that has the updates for Ubuntu operating system, see https://linux.dell.com/repo/hardware/ubuntu/ catalog/ . NOTE: Support for Ubuntu is pre-enabled only on 12th,13th, and 14th generation of PowerEdge systems.
4 Updating the system using DSU For a list of CLI options for systems running DSU, a description of each option, and the command syntax see the following table: Table 1. DSU Commands for Linux and Microsoft Windows Operating Systems DSU Commands for Linux and Microsoft Windows Operating Systems Using DSU Help Description To access the DSU Help.
DSU Commands for Linux and Microsoft Windows Operating Systems Getting supported category values using DSU Description To get all the supported category values and display the corresponding acronym for the category name from the catalog. Command Syntax for Linux dsu --get-categories or dsu —g Command Syntax for Microsoft Windows dsu --get-categories or dsu /g Getting all components of the specified categories using DSU Description To get all the upgradable components of the specified categories.
DSU Commands for Linux and Microsoft Windows Operating Systems Description To provide the path of the inventory file. Command Syntax for Linux dsu --input-inventory-file= Command Syntax for Microsoft Windows dsu --input-inventory-file= or dsu /inputinventory-file= Destination path to save the inventory file Description To provide the destination file path to save the inventory file in XML format.
DSU Commands for Linux and Microsoft Windows Operating Systems Description To provide the path, of the inventory collector binary or executable file in the target machine. Command Syntax for Linux dsu --ic-location= Command Syntax for Microsoft Windows dsu --ic-location= Source Location Description Enables the user to specify the local or network directory location of the source or repository.
DSU Commands for Linux and Microsoft Windows Operating Systems Command Syntax for Microsoft Windows dsu /output-log-file=C:\dsu.log or dsu --outputlog-file=C:\dsu.log List Critical updates Description To report components with critical is displayed. Command Syntax for Linux dsu --list-critical-updates Command Syntax for Microsoft Windows dsu /list-critical-updates or --list-criticalupdates Configures the logger Description To configure the dsu logger.
DSU Commands for Linux and Microsoft Windows Operating Systems Command Syntax for Microsoft Windows dsu /remote- or-remote= NOTE: When domain is used, only single-label DNS names are supported that do not contain a suffix such as .com, .corp, .net, .org or company name. For example, "host" is a single-label DNS name. To push updates to the remote system Description To push the required updates to the remote system.
DSU Commands for Linux and Microsoft Windows Operating Systems To push the updates via operating system IDRAC Passthrough using the USB-NIC interface. Description • • OAuth: Supports operating system to iDRAC passthrough connection without iDRAC credentials. BasicAuth: Supports operating system to iDRAC passthrough connection with iDRAC credentials.
This is one of the Bootable ISO generation methods. It can be created through either of the two following methods: • Interactive- DUPs are downloaded and packaged in the iso. dsu –destination-type=ISO –destination-location=”/root/bootabledsu.iso” • Non-interactive- Requires a repository location to fetch DUPs. dsu –n –destination-type=ISO –destination-location=”/root/bootabledsu.iso” –config=”/root/ dsuconfig.xml” The config.
DSU Return Codes 22 Invalid Destination Type Destination type is not ISO or CBD. 24 Update Failure Failure in applying updates. 25 Update Partial Failure Out-of-date updates are selected. 26 Update Partial Failure And Reboot Required Out-of-date updates are selected. For successful updates, reboot is required. 34 No Applicable Updates Found There are no updates found which can be applied. 35 Remote Partial Failure Some remote systems has failure some maybe successful.
5 Sample options usage The following are some of the sample options with DSU: Sample Config file with Authentication Sequence and Remote System options To point to a repository hosted at https:///(for example, https://192.168.10.11/16.08.00), the config XML file is: PAGE 23
Table 3. Config file options usage Element Options Usage Description Repository Type="OSNATIVE|REPOSITORY" When type is OSNATIVE, the command specific to the OS will be used to install updates. Updates are fetched from IP + '/' + Directory. When type is REPOSITORY, the updates will be downloaded from location provided in the IP + '/' + Directory.
Element Options Usage Description categories mentioned to be updated first and ApplyLast allows the user to apply the updates last. ApplySequence -> Sequence -> Category Value OrderID There are two attributes which has to be mentioned for this feature: • Value - Category value is to be provided. To get the category value use the option --getcategories • OrderID - OrderID is positive integer value which will be used to apply the updates in an ascending order.
Sample config file with only Apply Sequence option PAGE 26Remote System: dsu --use-idrac-passthrough --source-type=REPOSITORY -u --remote="OS Username:OSPassowrd@OSIP Sample Config File to perform firmware update via operating system to iDRAC Passthrough using OAuth Authentication PAGE 27Remote system: dsu -u --remote=username:password@SystemOSIP --ignore-signature Command to use the installer option dsu --dsu-lin64-installer-location="" dsu --remote --config=/home/dsu/config.xml --dsu-lin64-installer-location=/home/dsu/SystemsManagement_Application_FT56W_LN64_1.7.0_A00.BIN --dsu-win64-installer-location=C:\dsu\ Systems-Management_Application_FT56W_WN64_1.7.0_A00.EXE --dsu-lin64-installer-location=/home/dsu/ SystemsManagement_Application_FT56W_LN64_1.7.0_A00.
dsu --source-type=REPOSITORY --source-location= =" repository" --iclocation="/bin/Linux/invcol Microsoft Windows Operating System: dsu --source-type=REPOSITORY --source-location==" Repository" --iclocation="\bin\Windows\invcol.exe Command to update from the provided repository dsu --source-type=REPOSITORY --source-location="downloads.dell.
dsu --destination-type=CBD --destination-location=/root/home/outdirectory --bootable-loglocation=/var/log/bootmsg.log Microsoft Windows Operating System: dsu --destination-type=CBD --destination-location= C:\outdirectory --bootable-loglocation=/var/log/bootmsg.
6 Sample scripts using DSU Creating Bootable ISO using helper script You can create a bootable ISO (Linux-based). The script is available in the location: https://linux.dell.com/repo/hardware/scripts/. The following sample script creates a bootable ISO. dsucreateiso [options] Table 4. Options used in creating bootable ISO Options Creating Bootable ISO Workspace directory command Description To provide the working space be used by the script.
Options Creating Bootable ISO Description Provides location of where to create log file. Creates a Logfile at the given location with the file name as dsucreateiso_%Y%m%d_%H%M%S.log. By default the log is located at /var/log/dsucreateiso.log and will be appended with each execution. Command for Log file dsucreateiso -l LOGLOCATION or dsucreateiso --loglocation= LOGLOCATION Apply Action for the component Description Specifies the option with which dsu will be executed in mounted environment.
Command to customize the working directory dsucreateiso --output=/root/bootabledsu.iso --workspace=/root/myworkspace Command to create ISO with offline network and local repository dsucreateiso --dellbootplugin=/root/dellbootplugin.tar.gz --source=/root -output=bootabledsu.
7 Troubleshooting DSU The repository setup is fine, however OMSA (srvadmin) is failing to install. Even though DSU does not block OMSA installation or upgrade on any server, OMSA is supported on certain Linux distributions and PowerEdge server models. For more details on supported OS and server, check the latest OMSA documentation. DSU supports upgrade of OMSA (srvadmin), where an OMSA version is already installed.
The DSU commands are not working even after the successful installation of the software.
8 Frequently asked questions This section lists some frequently asked questions about DSU. How can I select an update in the given list? Type the number displayed against the update, to select the update. An asterisk (*) is displayed corresponding to the update after it is selected. How can I cancel an update already selected in the given list? It works like a toggle button.
Table 5. Possible Outcomes for PowerEdge systems Scenarios Outcomes DSU on 10th generation of PowerEdge system pointing to the Platform not supported message is displayed. newest Linux Repository (on linux.dell.com) and the Repository no longer has 10G content. DSU 1.5 RPM (sourced from linux.dell.com) on a 10th generation of PowerEdge system pointing to the newest Linux Repository that no longer has 10G content. Platform not supported message is displayed. DSU 1.
I see a message saying “Failed to parse config file” with exit code 17. What should I do to troubleshoot and resolve the issue? The config file may not be filled correctly. Refer the configuration schema information in the dsuconfig.xml section in Using DSU bootable ISO topic. I see a message “unable to get the inventory collector path from catalog”. What should I do to troubleshoot and resolve the issue? For more information on the inventory collector path, check the catalog file.
On some cases the Virtual IP address is captured by DSU in place of OS IP, in such scenarios the IP address displayed will not be correct. On the remote systems running SUSE Linux 15 servers, the remote system is unable get connected after a restart. This is due to the firewall which could be enabled after a restart. Host System displays an error message as "unknown option provided in DSU" when the option UseLatestDSU=FALSE mentioned in config file. Set the value of attribute value as TRUE.
DSU fails to connect to the remote host system using ActiveDirectory credentials. If the ActiveDirectory crendentials contains suffixes with dot, the DSU fails to connect. Only single-label DNS names are supported that do not contain a suffix such as .com, .corp, .net, .org or companyname. If using a multi-domain user. For example: If the user has provided "subdomain.domain.com\username", Dell recommends to provide the username as subdomain\username.