DELL EMC System Update Version 1.6 User’s Guide

PDF

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://<ip_address>/<directory>(for example, https://192.168.10.11/16.08.00), the config XML file is: 

<DSUConfig>
                                    <Repository Type="REPOSITORY"> 
                                    	<RepoLocation IP="192.168.10.11" Directory="16.08.00" UseLatestDSU="True"/> 
                                    </Repository>
                                    
                                    <AuthenticationSequence>																																	
                                    	<Authentication Type="PLAIN" ExecPort="22" Username="name" Password="password1" OrderID="4"
                                    ExecProto="SSH"/>  
                                    	<Authentication Type="PLAIN" ExecPort="22" Username="name" Password="password2" OrderID="1"
                                    ExecProto="SSH"/>
                                    	<Authentication Type="PLAIN" ExecPort="22" Username="name" Password="password3" 
                                    ExecProto="SSH"/>
                                    </AuthenticationSequence>
                                    
                                    <RemoteSystem>
                                    	<System Address="192.200.14.145">
                                    	<AuthenticationSequence>
                                    		<Authentication Type="PLAIN" Username="name" Password="password1" OrderID="1" ExecProto="SSH"/>
                                    	</AuthenticationSequence>
                                    	<ApplySequence>
                                    	<Sequence Type="ApplyFirst">
                                    		<Category OrderID="1" Value="BI"/>
                                    		<Category OrderID="2" Value="NI"/>
                                    		<Category OrderID="3" Value="DI"/>
                                    	</Sequence>
                                    	<Sequence Type="ApplyLast">
                                    		<Category OrderID="3" Value="SA"/>
                                    		<Category OrderID="0" Value="DD"/>
                                    	</Sequence>
                                    	</ApplySequence>
                                    </System>
                                    
                                    <System Address="192.150.12.132">
                                    	<AuthenticationSequence>
                                    		<Authentication Type="PLAIN" Username="name" Password="password2" OrderID="2" ExecProto="SSH"/>
                                    	</AuthenticationSequence>
                                    </System>
                                    </RemoteSystem>
                                    
                                    
                                    </DSUConfig>
Table 1. Config file options usage. The following table describes the type of repository and configuration method.
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.

Repository -> RepoLocation

IP="<ipaddress>" Directory="<directoryaddress>"

The attributes provides the location of repository for the update of IP and Directory as: [IP + '/' + Directory]. If the Type is OSNATIVE, location provided in the [IP + '/' + Directory] is expected to carry updates in rpm format. If the Type is REPOSITORY, location provided by the [IP + '/' + Directory] should contain catalog file in .gz format and same will be used to fetch updates.

UseLatestDSU="True|False"

The UseLatestDSU refers to the latest DSU version to be installed at the target system.

Usecase 1: Bootable ISO

a. TRUE: When Type is OSNATIVE, DSU'S version is compared from the location provided in the IP + '/' + Directory to the version carried by DSU bootable plug-in.

b. False: The DSU version carried inside dell boot plugin will be used.

UseCase2: While using remote option.

a. TRUE: Latest DSU will be made available at target system (Install/update)

b. False: DSU version available at target system will be used to apply updates.

This options is ignored in case Type is REPOSITORY.

  • NOTE: Dell recommends the value of the attribute as True, when using the remote option.
  • NOTE: Dell recommends the value of the attribute as True, in the config file to avoid failures at the remote system.
ApplySequence -> Sequence Type= "ApplyFirst |ApplyLast" This option allows user to provide the sequencing. ApplyFirst allows the user to apply the list of 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 --get-categories
  • OrderID - OrderID is positive integer value which will be used to apply the updates in an ascending order.

Default order for updating is:

  • iDRAC / LC
  • Applications like: Diagnostics – DI, iSM
  • Device Driver (Storage, COMMs, Chipset, Video)
  • Device Firmware (Storage, COMMs, PSU, CPLD)
  • BIOS
AuthenticationSequence -> Authentication Authentication

Type="PLAIN"

ExecPort="22"

Username="name" Password="password1"

OrderID="4"

ExecProto="SSH" |"WMI"

The Authentication has various attributes which can be used to config the remote systems.

The default value is Plain which requires the user to provide the user name and the password for the connection.

The ExecPort is used to provide the port number in accordance to the execution protocol provided.

Username and password are required for authentication.

The OrderID provides the order in which the authentications provided will be checked for the remote connections.

The ExecProto provides the protocol over which the connection will be established. SSH is the connection protocol used for Linux operating systems and WMI is the connection protocol used for Microsoft Windows operating systems. This attribute is optional.

RemoteSystem -> System System Address type

AddressType="IPV4"

To provide the IP address of system, DSU automatically detects the type of address if the input is not provided by the user.

Sample config file with only Apply Sequence option

<DSUConfig>
                                    <Repository Type="YUM"> 
                                    <RepoLocation IP="192.168.10.11" Directory="16.08.00" UseLatestDSU="False"/> 
                                    </Repository> 
                                    <ApplySequence>
                                    <Sequence Type="ApplyFirst">
                                    <Category Value="NI" OrderID = "1"/>
                                    <Category Value="BI" OrderID = "2"/> 
                                    </Sequence>
                                    <Sequence Type="ApplyLast">
                                    <Category Value="SV" OrderID = "0"/>
                                    </Sequence>
                                    </ApplySequence>
                                    </DSUConfig>

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.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.iso

Command to package the selected updates to a folder using existing bootable ISO

Linux Operating System:

dsu --destination-type=CBD --destination-location=/root/home/outdirectory --bootable-log-location=/var/log/bootmsg.log

Microsoft Windows Operating System:

dsu --destination-type=CBD --destination-location= C:\outdirectory --bootable-log-location=/var/log/bootmsg.log

Use with custom offline repository created with Dell Repository Manager

DSU can update a system based on a custom-built Server Update Utility (SUU) offline repository exported from Dell Repository Manager (DRM):

  • Build a bundle of desired DUPs using DRM in a custom repository or choose a Dell-defined system bundle from the Dell Online Catalog tab.
  • Select the checkbox of each desired bundle then click the Create Deployment Tools button.
  • Choose Create Server Update Utility (SUU) and then SUU to Directory .
  • Choose Generate 64-bit SUU.
  • Browse for a directory to begin the export then click Finish.

Once the export task for the SUU image has completed then issue the following:

Linux Operating System:

dsu --source-type=REPOSITORY --source-location= ="<path_to_suu>/repository\" --ic-location="<path_to_suu>/bin/Linux/invcol

Microsoft Windows Operating System:

dsu --source-type=REPOSITORY --source-location=="<path_to_suu>\Repository\" --ic-location="<path_to_suu>\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.xml"

Windows Operating System:

dsu --destination-type=ISO --destination-location="C:\demo.iso" -n -source-type=REPOSITORY --source-location="192.168.10.11/16.08.00" --config="C:\dsuconfig.xml"

Command to use reboot options

dsu --reboot

Restarts the system for updates to take effect.

dsu --config="<configFile Path>" --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="<filepath>" --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.

Command to use the installer option

dsu --dsu-lin64-installer-location="<location>"

dsu --remote --config=/home/dsu/config.xml --dsu-lin64-installer-location=/home/dsu/Systems-Management_Application_FT56W_LN64_1.6.0_A00.BIN

--dsu-win64-installer-location=C:\dsu\ Systems-Management_Application_FT56W_WN64_1.6.0_A00.EXE

--dsu-lin64-installer-location=/home/dsu/ Systems-Management_Application_FT56W_LN64_1.6.0_A00.BIN

To pick the location provided and install at remote system if DSU is not installed. Alternatively if uselatestdsu attribute is true then following DUP will be used to replace the DSU at remote system.

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.xml

Below is the DSU config file - Method 1 
<DSUConfig> 
                                    <RemoteSystem> 
                                    <System Address="100.100.10.11"> 
                                    <AuthenticationSequence> 
                                    <Authentication Type="PLAIN" Username="root" Password="password1" ExecProto="SSH"/> 
                                    </AuthenticationSequence>
                                    </System> 
                                    <System Address="100.100.10.22"> 
                                    <AuthenticationSequence> 
                                    <Authentication Type="PLAIN" Username="root" Password="password2" ExecProto="SSH"/> 
                                    </AuthenticationSequence>
                                    </System> 
                                    </RemoteSystem>
                                    </DSUConfig>
The DSU config file with Authentication Sequence - Method 2: 
<DSUConfig>
                                    <AuthenticationSequence> 
                                    <Authentication Type="PLAIN" ExecPort="22" Username="name" Password="password1" OrderID="1" 
                                    ExecProto="SSH"/>
                                    <Authentication Type="PLAIN" ExecPort="22" Username="name" Password="password2" OrderID="2" 
                                    ExecProto="SSH"/>
                                    </AuthenticationSequence>
                                    <RemoteSystem> 
                                    <System Address="100.100.10.11"> </System> 
                                    <System Address="100.100.10.22"> </System> 
                                    </RemoteSystem>
                                    </DSUConfig>
  • 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.

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\