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 Overview........................................................................................................................................................ 6 What is new in this release................................................................................................................................................6 Other documents you might need...................................................................................................................................
Command to create ISO with the action for components....................................................................................28 Command to create ISO with the given custom-script........................................................................................ 28 Using kickstart files..........................................................................................................................................................28 7 Troubleshooting DSU................................
DSU exits with an error message "inv.xml not found" while connecting to the remote system on Microsoft Windows 2016.................................................................................................................................................................. 35 How can I generate a separate log file for each remote system on host system.................................................... 35 DSU exits with an error message on Ubuntu while loading libraries..................................
1 Overview DELL EMC System Update (DSU) is an application used to distribute Dell updates for Linux and Microsoft Windows Operating Systems. The DSU distributes: • OpenManage Server Administrator • BIOS, driver and firmware updates for different servers DSU for Linux: DSU extensively uses Yum and Zypper. • Yellowdog Updater, Modified Yellowdog Updater, Modified (YUM) is an open source command line package management utility used for Linux Operating Systems.
◦ --dsu-lin64-installer-location or --dsu-win64-installer-location – Automatic Reboot: ◦ --reboot – Ignoring optional dependencies for the update. Dependencies for the updates will be handled by DSU in order. ◦ • --ignore-optional-dependencies DSU options deprecated from this release: – --apply-upgrades-only – --apply-downgrades-only – --apply-equivalent-only NOTE: Ubuntu OS is pre-enabled on DSU, and the support is limited. For more information, see Support for Ubuntu operating systems.
2 Prerequisites for installing the DSU This section lists the specific prerequisites 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 Topics: • Supported hardware • Supported Operating Systems Supported hardware DSU is supported on 11th, 12th, 13th and 14th generation of Dell's PowerEdge servers.
NOTE: Support for Ubuntu is pre-enabled only on 12th,13th, and 14th generation of PowerEdge systems.
3 Installing DSU You can install DSU on Microsoft Windows and Linux operating systems through Dell Update Package (DUP). NOTE: For more information on the latest DSU DUP/RPM, see https://linux.dell.com/repo/hardware/dsu/os_independent/ x86_64/.
DSU installation wizard is displayed with the release title, release date, description, and supported devices information. 3 Click Install to begin the installation. NOTE: If any of the previous versions of DSU is not installed, a pop-up is displayed, asking the confirmation that you want to instal this particular version of DSU. Click Yes to continue. NOTE: The installation process may take several minutes. A message is displayed about the successful installation of DSU.
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 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 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 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 dsu /remote- or-remote= Command Syntax for Microsoft Windows To push updates to the remote system Description To push the required updates to the remote system.
Choose: c to Commit and apply updates Choose: to Select/Deselect updates Choose: a to Select All Choose: n to Select None Using DSU 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.
DSU Return Codes 8 Reboot Required Reboot is required for the update to be completed successfully. 13 Invalid Source Config (Configuration) Values provided for source location or source type is invalid. 14 Invalid Inventory Errors related to Inventory such as filename not present in the location or failed parsing inventory.
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 21Table 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 • 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 create bootable non-interactive DSU ISO Linux Operating System: dsu --non-interactive --destination-type=ISO --destination-location=/root/home/output.iso -config=/root/home/config.xml --source-type=REPOSITORY --source-location="ftp.dell.com/catalog" Microsoft Windows Operating System: dsu --non-interactive --destination-type=ISO --destination-location= C:\output.iso –—config=C: \config.
dsu --source-type=REPOSITORY --source-location=="\Repository\" --iclocation="\bin\Windows\invcol.exe Command to update the type of the repository dsu --source-type=REPOSITORY --source-location="ftp.dell.com/catalog" dsu --source-type=OSNATIVE Command to create bootable DSU ISO Linux Operating System: dsu --destination-type=ISO --destination-location="/home/demo.iso" -n -source-type=REPOSITORY -source-location="192.168.10.11/16.08.00" --config="/usr/libexec/dell_dup/dsuconfig.
Command to use remote option on Linux Operating System --remote="username:password@hostIP" : option used to provide for a single machine Config file is used when we need multiple connections. When using the remote option with two separate credentials and IP address. dsu --remote=root:password1@100.100.10.11 dsu --remote=root:password2@100.100.10.22 If using the config file for the two IP address dsu --remote --config=/root/dsuconfig.
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. NOTE: Starting DSU 1.4, the 10th generation of PowerEdge servers are not supported. This is applicable to the content in Linux repository and catalogs. 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.
DSU Inventory displays update for a component that is installed is newer than what is available. DSU Linux Repository is refreshed on a monthly basis, at the next refresh of the DSU Linux Repository the newer version will be carried. I am using DSU on 10th generation of PowerEdge Systems.
On Ubuntu operating system, I see a message “genisoimage: command not found. Please install genisoimage to create bootable iso”. What am I supposed to do? To troubleshoot the issue, execute the following command: sudo apt-get install genisoimage. By executing the command, you are installing the genisoimage to generate the ISO. On Linux operating system, I see a message “mkisofs: command not found. Please install mkisofs to create bootable iso”.
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.
DSU exits with an error message "inv.xml not found" while connecting to the remote system on Microsoft Windows 2016. From the host a corrupted invcol was pushed to the remote, then the issue appears on the remote system. Download the inventory collector and use option --ic-location to provide the details to DSU. How can I generate a separate log file for each remote system on host system. Separate log file for individual connection can be provided using LogFile attribute in the config file as shown below.
Redundant message displayed on Windows console while using remote option. To avoid redundant messages the command prompt needs to be restarted. For example: Number of systems complete: 5/5 100% Number of systems complete: 4/5 80% The system IP address on the DSU's Log file displayed is not correct. 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.