Description
|
Allows you to update the firmware of devices on the server. The supported firmware image file types are:
- .exe — Windows-based Dell Update Package (DUP)
- .d9
- .pm
- .sc
The supported catalog files are:
NOTE:
- Updating the platforms from the repository is not supported for IPv6.
- The firmware update through FTP has a limitation of file name up to 64 characters.
- Depending on the network traffic, the HTTP packet transfer may fail if you perform update operation from a remote RACADM through a local share. In such cases, retry the operation. If the issue persists, use remote RACADM with the CIFS or NFS share.
- The supported share types for single file or DUP updates are CIFS, NFS, HTTP, and HTTPS. For Repository updates, the supported share types are CIFS, NFS, FTP, TFTP, and HTTP.
- When a port number is appended to an IP address for firmware update, the job fails with an internal error.
|
Synopsis
|
For single file or DUP update:
racadm update -f <updatefile>
racadm update -f <updatefile> -l <location> -u <username for CIFS share> -p <password for CIFS share>
racadm update -f <updatefile> -l <location>
For Repository updates
racadm update -f <catalog file> -t <Repository type> -l <location> \ -u <username for CIFS share> -p <password for CIFS share> \ [-a <restart>] [--verifycatalog]
racadm update -f <catalog file> -t <Repository type> \ -e <FTP server with the path to the catalog file> [-a <restart>] \[--verifycatalog]
racadm update -f <catalog file> -t <Repository type> \ -e <FTP server with the path to the catalog file> [-a <restart>] \ -ph <proxy ip> -pu <proxy user> -pp <proxy pass> -po <proxy port> \
-pt <proxy type>
racadm update viewreport
|
Input
|
For single file or DUP update:
- -f: <updatefile>—Update filename (Windows DUP,
.d9,.pm,
.sc) only.
- -u: < username for CIFS share>—Specifies username of the remote share that stores the update file. Specify username in a domain as domain/username.
- -p: <password for CIFS share—Specifies password of the remote share that stores the update file.
- -l: <location>—Specifies network share location that stores the update file. For more information on NFS or CIFS share, see section on Usage examples
- —reboot—Performs a graceful system reboot after the firmware update.
For Repository update:
- -f: <updatefile>—Update filename .
For update from repository
.xml files are allowed. If a file name is not specified for repository update, Catalog.xml is taken as default.
If a file name is not specified for repository update, then the
Catalog.xml is taken as default.
- -u: < username for CIFS share>—Username of the remote share that stores the update file. Specify username in a domain as domain/username.
- -p: <password for CIFS share — Specifies password of the remote share that stores the update file.
- -l: <location>—Specifies network share location (CIFS/NFS/HTTP/HTTPS/FTP), that stores the update file. For more information on network share, see section on Usage examples
- -a: <restart> — This option indicates if the server should be restarted after the update from repository operation completes. Must be one of the below:
- TRUE : restart after update completes
- FALSE : do not restart after update completes
NOTE:These options are case insensitive.
- -t:Repository type>—Specifies the type of repository being used for the update.
Must be one of the below:
- FTP: Repository is FTP
- TFTP: Repository is TFTP
- HTTP: Repository is HTTP
- HTTPS: Repository is HTTPS
- CIFS: Repository is CIFS
- NFS: Repository is NFS
NOTE:These options are case insensitive. If the repository update functionality is to be invoked, this option is necessary.
- -e:<FTP server with the path to the catalog file>—Specifies the Server path for the FTP, TFTP, HTTP, and HTTPS.
- -ph : <proxy ip>—Specifies the IP address of the proxy server.
-
-pu : <proxy user>—Specifies the user name for proxy credentials.
-
-pp : <proxy pass>—Specifies the password for proxy credentials.
- -po : <proxy port>—Specifies the port for proxy server.
- -pt : <proxy type>—Specifies the proxy type.
Must be one of the below:
- HTTP: Proxy is HTTP
- SOCKS4: Proxy is SOCKS4
NOTE:
- If the repository has to be through a proxy, the proxy server address, proxy username and the proxy password are necessary. The Lifecycle Controller must be enabled for repository update.
- This command supports both IPV4 and IPV6 formats. IPV6 is applicable only for CIFS and NFS remote share.
|
Output
|
Firmware update job for
<filename> is initiated.
This firmware update job may take several minutes to complete depending on the component or firmware being updated. To view the progress of the job, run the
racadm jobqueue view command.
For repository update command, the output is:
Update from repository operation has been initiated. Check the progress of the operation using "racadm jobqueue view -i JID_809364633532" command.
For devices that perform update process without rebooting the host, the update status changes from
Downloading to
Completed. For devices that require host reboot to perform update process, the update status changes from
Downloading to
Scheduled. When the status is displayed as
Scheduled, reboot the host to start the update process.
The following devices require host reboot to perform the update process:
- Backplanes
- BIOS
- Complex programmable logic device (CPLD)
- Hard disk drives
- Network interface cards (NIC) or Fibre Channel (FC) cards
- PCIe SSD devices
- Power supply unit (PSU)
- Storage controllers
|
Example
|
For single file or DUP updates:
- Upload the update file from a remote FTP share
racadm update -f <updatefile> -u admin -p mypass -l ftp://1.2.3.4/share
- Upload the update file from a remote FTP share and to perform a graceful system reboot after update:
racadm update -f <updatefile> -u admin -p mypass -l ftp://1.2.3.4/share --reboot
- Upload the update file from a remote CIFS share:
racadm update -f <updatefile> -u admin -p mypass -l //1.2.3.4/share
- Upload the update file from a remote CIFS share and under a user domain "dom":
racadm update -f <updatefile> -u dom/admin -p mypass -l //1.2.3.4/share
- Upload the update file from a remote NFS share:
racadm update -f <updatefile> -l 1.2.3.4:/share
- Upload the update file from a remote HTTP share:
racadm update -f <updatefile> -u admin -p mypass -l http://1.2.3.4/share
- Upload the update file from a remote HTTPS share:
racadm update -f <updatefile> -u admin -p mypass -l https://1.2.3.4/share
- Upload the update file from the local file system using Local RACADM.
racadm update -f <updatefile>
- Upload the Update file from a remote CIFS share and to perform a graceful system reboot after update:
racadm update -f <updatefile> -u admin -p mypass -l //1.2.3.4/share --reboot
- Upload the Update file from a remote NFS share and to perform a graceful system reboot after update:
racadm update -f <updatefile> -l 1.2.3.4:/share --reboot
- Upload the update file from a remote HTTP share and to perform a graceful system reboot after update:
racadm update -f <updatefile> -u admin -p mypass -l http://1.2.3.4/share --reboot
- Upload the Update file from the local file system using local racadm and to perform a graceful system reboot after update:
racadm update -f <updatefile> --reboot
For Repository updates:
- Perform update from an FTP repository and to apply the updates, reboot the server:
racadm update -f Catalog.xml -l //192.168.11.10/Repo -u test -p passwd -a TRUE -t CIFS
- Generate a comparison report using about the available updates in the repository:
racadm update -f Catalog.xml -l 192.168.11.10:/Repo -t NFS -a FALSE --verifycatalog
- Perform update from an FTP repository and reboot the server to apply the updates:
racadm update -f Catalog.xml -e 192.168.11.10/Repo/MyCatalog -a TRUE -t FTP
- Perform update from an FTP repository with authentication and reboot the server to apply the updates
racadm update -f Catalog.xml -e 192.168.11.10/Repo/MyCatalog -u user -p mypass -a TRUE -t FTP
- Perform update from a HTTP repository and restart the server to apply the updates.
racadm update -f Catalog.xml -e 192.168.11.10/Repo/MyCatalog -a TRUE -t HTTP
-
Perform update from a TFTP repository and restart the server to apply the updates.
racadm update -f Catalog.xml -e 192.168.11.10/Repo/MyCatalog -a TRUE -t TFTP
- Perform update from an FTP repository through a proxy server.
racadm update -f Catalog.xml -e 192.168.11.10/Repo/MyCatalog -a TRUE -ph 145.140.12.56 -pu prxyuser -pp prxypass -po 80 -pt http -t FTP
- Perform update from an
downloads.dell.com
racadm update -f Catalog.xml.gz -e ftp.dell.com/Catalog -a TRUE -t FTP
- View the comparison report generated when --verifycatalog is used.
racadm update viewreport
|