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. © 2020 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 new in this release................................................................................................................................................... 5 Related Documents..........
Output inventory information............................................................................................................................................ 38 Preview updates.................................................................................................................................................................. 38 Configuration file ............................................................................................................................................
1 Introduction to Dell System Update DELL EMC System Update (DSU) is a script optimized update deployment tool that is used to apply Dell EMC updates such as applications, firmware and drivers for Linux, and Microsoft Windows operating systems. Using DSU identify the available updates, select the relevant updates, and deploy the updates on a single system or multiple systems through operating systems or Integrated Dell Remote Access Controller (iDRAC) or iDRAC pass through.
2 Support Matrix This section lists the hardware, Operating Systems and PowerEdge Servers required for installing DSU. Topics: • • Supported hardware Supported Operating Systems Supported hardware DSU supports iDRAC7, iDRAC8 and iDRAC9 based Dell EMC PowerEdge servers. NOTE: To install through iDRAC on iDRAC9 based PowerEdge Servers, minimum version of iDRAC 3.30.30.30 and later is required NOTE: DSU 1.
NOTE: To install through iDRAC on iDRAC9 based PowerEdge Servers, minimum version of iDRAC 3.30.30.30 and later is required. NOTE: It is recommended to have physical server to install or uninstall DSU on remote or host system.
3 Installing DSU Installing DSU DUP on Linux operating systems Prerequisites • • • • • • Ensure that you have superuser or root user permissions. Ensure that the remote system has a default PermitRootLogin pre-enabled in /etc/ssh/sshd_config. Ensure that you use the root account to access a Linux server remotely. Ensure that you have the Libssh2 package. Ensure that you enable the SSH protocol. For more information about the latest DSU RPM, see https://linux.dell.
Online method to install DSU on SLES operating system Prerequisites Ensure that the online repository is configured to linux.dell.com. About this task To install DSU on the supported SUSE Linux Enterprise Server (SLES) operating system through command prompt, perform the following steps: Steps 1. Download the latest Dell Update Package (DUP) from the support site. 2. Provide the superuser or root privileges for the folder where you have saved the DUP files. 3.
Steps 1. Download the latest DUP from support.dell.com. 2. Double-click the .exe file. The User Account Control page is displayed. 3. Click Yes. The Dell EMC System Update page is displayed. 4. To install DSU, click Install. 5. (For first-time users only) Click Yes on the confirmation screen. 6. After a successful installation, the success page is displayed. Click OK. Next steps To verify if the installation is successful, run dsu /h on the command prompt.
4 DSU features Provides updates for BIOS, applications, firmware and driver for various devices to the end customer. The updates are provided to the customer by gathering and adding all the device and dependency details together by providing a consistent and easy to execute user interface. Also publishes inventory collector application for inventorying the updatable components and also the metadata about the updates in the form of catalogs and hosts repositories.
Actions Mandatory Attributes Optional Attributes Syntax/Example Example: dsu --inventory dsu --inventory -component-type=BIOS Export inventory in JSON format --inventory --authentication --output --component-type --output-format Format: dsu --inventory -output= -output-format=JSON Example: dsu --inventory -output=C:\Program files\Dell\Dell EMC System Update \dell_dup\inv.json --output-format=JSON dsu --inventory -output=C:\Program files\Dell\Dell EMC System Update \dell_dup\inv.
Actions View inventory when system is not connected to downloads.dell.com (offline) Mandatory Attributes --inventory --source-type --source-location Optional Attributes --component-type --authentication --catalog-location --ic-location Syntax/Example Format: dsu --inventory -sourcetype=repository -sourcelocation= Example: dsu --inventory -sourcetype=repository -sourcelocation=C:\Program files\Dell\Dell EMC SystemUpdate\ABC dsu --inventory -catalog-location=\ \192.168.10.25\DSU \catalog.
Actions Mandatory Attributes Optional Attributes Syntax/Example Example: dsu --inventory -remote=abc:abc_123@1 00.89.45.27 -output= C:\Dell \DELL EMC System Update\dell_dup \inv.json --outputformat=JSON dsu --inventory -remote=abc:abc_123@1 00.89.45.27 -output= C:\Dell \DELL EMC System Update\dell_dup \inv.
Actions Mandatory Attributes Optional Attributes Syntax/Example \dell_dup\inv.json --output-format=JSON dsu --inventory -remote -config=C:\Dell\Dell EMC System Update \dell_dup \config.xml -output=C:\Dell\Dell EMC System Update \dell_dup\inv.
Actions Mandatory Attributes Optional Attributes Syntax/Example rsystemtype=iDRAC -output= C:\Program files\Dell\Dell EMC System Update \dell_dup\inv.
Actions Mandatory Attributes Optional Attributes Syntax/Example \invCol.exe -cataloglocation=C:\Dell \DELL EMC System Update\dell_dup \Catalog.xml -sourcetype=REPOSITORY dsu --inventory -use-idracpassthrough -remote=abc:abc_123@1 00.88.66.100 -source-location= C:\Dell\DELL EMC System Update \dell_dup --iclocation= C:\Dell \DELL EMC System Update\dell_dup \invCol.exe -cataloglocation=C:\Dell \DELL EMC System Update\dell_dup \Catalog.
Actions Export inventory in JSON format for remote system Mandatory Attributes --inventory Optional Attributes --component-type Syntax/Example Format: dsu --inventory -use-idracpassthrough -remote= username:password@IP address -output=location -output-format=JSON --use-idracpassthrough --remote --output Example: --output-format dsu --inventory -use-idracpassthrough -remote=abc:abc_123@1 00.99.88.77 -output=C:\Program files\Dell\Dell EMC System Update \dell_dup\inv.
Actions Mandatory Attributes Optional Attributes Syntax/Example \dell_dup \inv_idrac.xml -component-type=BIOS Preview Preview command is used for listing all the applicable updates. For more details on optional attributes and its usage, click the hyperlink that is provided in the below table. Table 2.
Action Mandatory Attributes Optional Attributes Syntax/Example rsystemtype=iDRAC -category=AS,BI,ES Viewing preview using remote Operating System to iDRAC pass through(OAUTH) --preview --component-type --remote --category --use-idracpassthrough Format: dsu --preview -remote= --use-idracpassthrough Example: dsu --preview -remote=abc:abc_@128. 99.100 --use-idracpassthrough dsu --preview -remote=abc:abc_123@1 28.99.
Action Mandatory Attributes Optional Attributes Syntax/Example inventory-file=\ \192.168.10.24\Share \inventory.xml dsu --preview -catalog-loction=\ \192.168.10.24\Share \Catalog.gz --inputinventory-file=\ \192.168.10.24\Share \inventory.
Table 3. Update on host server and single remote host server Actions Updating server using noninteractive method Mandatory Attributes Optional Attributes NA --non-interactive Syntax/Example Format: dsu --noninteractive Example: dsu --noninteractive Update single remote server from host server through operating systems. --remote --config Format: dsu -remote= Example: dsu -remote=abc:abc_123@1 24.99.88.77 dsu --remote -config=C:\Dell\Dell EMC System Update \dell_dup\conf
Actions Mandatory Attributes Optional Attributes Syntax/Example Example: dsu --remote -config=C:\Dell\Dell EMC System Update \dell_dup\config.xml dsu --remote -config=C:\Dell\Dell EMC System Update \dell_dup \config.xml -component-type=BIOS Updating multiple servers through iDRAC --config --component-type --source-type --category --remote --list-criticalupdates Format: dsu --config= --sourcetype= --remote Example: dsu -config=C:\Dell \Dell EMC System Update \dell_dup \config.
Actions Updating host server through iDRAC passthrough Mandatory Attributes --use-idracpassthrough Optional Attributes Syntax/Example NA Format: dsu --use-idracpassthrough -source-type= --source-type Example: dsu --use-idracpassthrough -sourcetype=REPOSITORY Updating a server with types of updates Applying updates using upgrade only --apply-upgrades --remote Format: dsu --apply-upgrades --config Example: dsu --apply-upgrades dsu --applyupgrades -remote=abc:abc_123@1 23.66.55.
Actions Applying updates for critical updates only Mandatory Attributes --list-criticalupdates Optional Attributes --remote --config Syntax/Example Format: dsu --list-criticalupdates Example: dsu --list-criticalupdates dsu --list-criticalupdates -config=C:\Dell\Dell EMC System Update \dell_dup\config.
Actions Mandatory Attributes Optional Attributes Syntax/Example type=REPOSITORY -component-type=BIOS Updating a server with different component types --component-type --remote --config Format: dsu --componenttype= Example: dsu --componenttype=BIOS,FRMW,APP,D RVR dsu --componenttype=BIOS,DRVR,FRMW, APP -remote=abc:abc_123@1 00.188.22.
Bootable ISO With Bootable ISO feature, user can perform the following use cases: 1. Interactive-mode 2. Non-interactive See the below table for all the Bootable ISO-related use cases and its respective mandatory and optional attributes along with format and an example. For more details on optional attributes and its usage, click the hyperlink that is provided in the below table. Table 4.
Action Mandatory attributes Optional attributes Syntax/Example authentication=abc:b ca123 --destinationlocation=\ \192.168.10.1\Share \ISO9660.iso --noninteractive Using DSU Bootable ISO NOTE: The bootable ISO can be created with an alternative sample script which is a simple method and has multiple options for customization such as creating ISO for some specific set of platforms. For more information, see Sample scripts using DSU. This is one of the Bootable ISO generation methods.
5 Network Share A shared resource, or network share, is a computer resource made available from one host to other host on a computer network . DSU supports SMB1 and SMB2 protocol. Choices: --authentication Network share allows user to specify the authentication parameters that are required for accessing the repository. If the authentication parameters are incorrect, then AUTHENTICATION_FAILURE is returned. To export inventory file using authentication option: --inventory --output=C:\Programfiles\Dell\Dell E
11.
Syntax: dsu /i --output= --output-format=json --authentication=username:password Naming Convention The following section describes the format on how user can provide share location. For example: For windows: --catalog-location=\\100.96.12.21\folder\catalog.xml --authentication=abc:bca123 example: For Linux: --catalog-location=//100.96.12.21/folder/catalog.
6 Sample scripts using DSU Creating Bootable ISO using helper script To create linux-based bootable ISO, see the script at the location: https://linux.dell.com/repo/hardware/scripts/. Syntax to create bootable ISO: dsucreateiso[options] Creating bootable ISO Following options can be used while creating a bootable ISO: • • • • • • • • • • Destination path custom script. Location of the custom script. Location of the DELL boot plug-in. Apply action for the component. Location to create log file.
Provides either local or network location of repository or catalog. By default network would be enabled to download catalog and DUPs file. Syntax for displaying the location of catalog file: dsucreateiso -s SOURCELOCATION or dsucreateiso --source-location=SOURCELOCATION Location to create log file Creates a log file 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 appends with each execution.
Command to create Bootable ISO by the available repository dsucreateiso --source=/root --output=bootabledsu.iso Command to customize the working directory dsucreateiso --output=/root/bootabledsu.iso --workspace=/root/myworkspace Command to create Bootable ISO with offline network and local repository dsucreateiso --dellbootplugin=/root/dellbootplugin.tar.gz --source=/root -output=bootabledsu.
• To use custom working directory ./dsucreateiso --dellbootplugin=/root/dell-boot-plugin-8.3.0-16.08.00.noarch.rpm --catalog=/root/Catalog.xml --baseurl=ftp://downloads.dell.com/ --dsu=/root/dell-systemupdate-1.3.1-16.09.00.x86_64.rpm --output=/root/bootabledsu.iso --workspace=/root/myworkspace/ NOTE: Log files are located in /var/log/. The log file is dsucreateiso.log.
7 Dell System Update Options DSU Help Displays the command-line options and help information. Command for Linux: dsu --help or dsu —h Command for Windows: dsu --help or dsu /h Utility version To get the DSU utility version. Command for Linux: dsu --version Command for Windows: dsu --version Non-interactive update Runs the update silently without user intervention. The -q option writes all the output to log files. The default behavior ignores new IC unless --download-ic option is specified.
Catalog location Path of catalog file used. File format supported: .xml, .gz and .tar.gz Command for Linux: dsu --catalog-location= Command for Windows: dsu --catalog-location= Category values To get all the supported category values and display the corresponding acronym for the category name from the catalog. Command for Linux: dsu --get-categories Command for Windows: dsu --get-categories Category list To get all the upgradable components of the specified categories.
Command for Windows: dsu --apply-downgrades Updates list To apply the updates specified in the file list, if applicable and available in catalog. Command for Linux: dsu --update-list= Command for Windows: dsu --update-list= Equivalent version updates To get the list of applicable components of the same versions for updating.
Command for Linux: dsu --preview or -p Command for Windows: dsu --preview or /p Configuration file Configuration of the file path for DSU. All the configuration and options are specified using this option. Once this option is specified, the remaining options are ignored. NOTE: For the given config file, it performs schema check only if the schema file (config.xsd) is available at %programdata%\Dell\DellEMCSystemUpdate\dell_dup. To Download schema file, see http://downloads.dell.
NOTE: While performing inventory for remote systems, the IC-log is seen only on the remote host systems. Source Location Allows user to specify the local or network directory location of the source or repository. Command for Linux: dsu --source-location= Command for Windows: dsu --source-location= Destination location To provide the path of the package created using the --destination-type and to be saved.
Path to save the log file To provide the file path to save the dsu log file. Command for Linux: dsu --output-log-file=/root/dsu.log Command for Windows: dsu --output-log-file=C:\dsu.log List only critical updates To list critical component updates. The DSU selection views shall display Criticality of the updates along with update name. [ Urgent/ Recommended/Optional] Dependent updates (only Hard) shall also be listed along with the updates.
DSU installer file location To install or update the DSU on remote systems which is required for remote updating. NOTE: If this option is not provided, then the DSU installer file present in the catalog are used. NOTE: The DSU version should be same version as the local system. Command for Linux: --dsu-lin64-installer-location= Command for Windows: --dsu-win64-installer-location= Restarting system To restart the system, automatically post updates.
Command for Windows: dsu --ignore-signature Component Type Component type filter lists the updates that are required for the specified component type. The following are the five component type filters provided: 1. 2. 3. 4. 5. Firmware BIOS APAC APP Drivers NOTE: The category filter option works when the IC version is greater or equal to 20.04.200, it lists specified components in the servers. Else, the filter list all the components in the server. NOTE: The IC is available at catalog version 20.05.00.
Providing the credentials of the remote system To enable the remote system with the credentials provided along with the hostname. Multiple remote destinations can be configured using the input config file. Command for Linux: dsu --remote= Command for Windows: dsu --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.
Input inventory Allows users to specify the inventory information in a file. DSU takes the information instead of inventorying for determining the applicable updates. Inventory Collector output and multi system inventory are provided with this option. If the input of inventory file is invalid, then INVALID_INVENTORY is returned.
Command Syntax for Windows: dsu --uninstall Progress Progress command is used to get the update status of DSU on host and remote. NOTE: Run progress command in one minute interval. NOTE: When no instance of DSU is running on the system and --progress option is used, displays an output as No progress is available. NOTE: The generated progress files are successful but unable to see the file in the network share.
DSU Return Codes 4 Invalid Log Level Invalid log level set by user. 6 Invalid Command Line Option Invalid combination of DSU options used. For example, – destination type and –non-interactive cannot be used simultaneously. 7 Unknown Option Incorrect option provided. 8 Reboot Required Reboot is required for the update to be completed successfully.
8 Uninstalling DSU Topics: • • • Uninstalling DSU DUP on Red Hat Enterprise Linux operating system Uninstalling DSU DUP on SLES operating system Uninstalling DSU on Windows through UI Uninstalling DSU DUP on Red Hat Enterprise Linux operating system About this task To uninstall DSU on the supported Red Hat Enterprise Linux (RHEL) operating system through command prompt, perform the following steps: Steps 1. In command prompt, run the following command: yum remove dell-system-update 2. Press q to continue.
Steps 1. Launch the start menu and open Control Panel. 2. In Programs section, click Uninstall a program. 3. In the search bar search for Dell EMC System Update. 4. Select the program and click Uninstall. 5. In Programs and Features window, click Yes. 6. In User Account Control window, click Yes.
9 Troubleshooting DSU Repository conflicts for updates having different version. DSU hovers over incorrect updates, if multiple repositories are configured which contains different versions of similar packages. It is recommended to disable other repositories in such cases.
Work around: 1. Close all the open share connections. 2. Sign out and sign in to the machine to close the connection to the share network. A message is displayed when running any DSU command Description: When run only a single instance of DSU on Linux operating system, the following message is displayed DSU already in use Work around: Delete the temporary files in the following location (/temp/DSUINACTION.txt) and run the commands again.
10 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. Can I run DSU using PowerShell ISE? Use DSU with PowerShell but not with PowerShell ISE. How can I cancel an update already selected in the given list? It works like a toggle button.
Scenarios Outcomes • • I am running DSU 1.4 DUP and pointing at a legacy catalog.xml that has 10G content. If the DUP doesn’t support 10G platform, then DSU is not installed. If DUP supports 10G platform, DSU is installed. When dsu command is invoked Platform not supported message is displayed. There may be two possible outcome: • • If the DUP doesn’t support 10G platform, then DSU is not installed. If DUP supports 10G platform, DSU is installed. dsu command works as usual.
Yes, using the script the repository is being created with the Linux bundles. As in mounted environment, DSU is being executed which applies filters to remove the LC OS Driver Packs and the other files. Which is the default directory to output the ISO? Executing directory with ISO name as dsu_bootableimage_%Y%m%d_%H%M%S is the default directory to output the ISO.
Single remote iDRAC with non-default port fails to get the inventory, preview or update command information. Recommendation: It supports only by providing the non-default port details in a Config file. Sample config file: PAGE 56Displays incorrect firmware name for iDRAC and iDRAC-pass-through. Recommendation :Use latest iDRAC version.
11 Sample When using an IC that has component type filter, it lists component types which are specified. When using an IC that does not have component type filter option, all the available server components are listed. Topics: • Sample options usage 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.
ExecProto="SSH"/> # Sample Config file for Configuring repository and sequencing the order of updates using Config file
# Remote Windows OS to iDRAC Passthrough with basic Authentication PAGE 60
Table 7. 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.
Element Options Usage Description • • 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.
Command to perform firmware updates via iDRAC (Remote System) Inventory: dsu --source-type=REPOSITORY -i --remote="idracuser:idracpassword@iDRAC IP" --rsystemtype=iDRAC Preview: dsu --source-type=REPOSITORY --preview --remote="idracuser:idracpassword@iDRAC IP" -rsystemtype=iDRAC Update: dsu --source-type=REPOSITORY -u --remote="idracuser:idracpassword@iDRAC IP" --rsystemtype=iDRAC --reboot Sample config file for performing firmware updates via iDRAC (Multiple Remote system) <
Sample Config file to perform firmware update via operating system to iDRAC passthrough using Basic Authentication PAGE 64dsu --config="" --remote --category=BI -e --reboot The command restarts the remote systems specified in the config file if the update requires a restart of the system and will relaunch DSU to check the status of the same. Command to use push remote updates dsu --push-remote-updates --remote --config="" --category=BI To push all the required updates to the remote system from the system where DSU is running, runs the update and provides the status back.
Microsoft Windows Operating System: dsu --non-interactive --destination-type=ISO --destination-location= C:\output.iso –— config=C:\config.xml Command to create bootable interactive DSU ISO Linux Operating System: dsu --destination-type=ISO --destination-location=/root/home/output.iso Microsoft Windows Operating System: dsu --destination-type=ISO --destination-location= C:\output.
