ldfware command

Purpose

Loads the system's flash EPROM with the specified file, which must contain a valid binary flash EPROM image, and then reboots the system.

Syntax

ldfware [ -dev Device ] -file filename

ldfware -commit

ldfware -reject

Description

Periodically, you need to install fixes for your server firmware. If you do not use an HMC to manage your server, you must get your fixes through your operating system. If your server is not connected to the Internet, you must obtain optical media that contains the server firmware fix and install the server firmware fix from the optical media. The flash update image file is copied to the file system from diskette. The user needs to provide the image on a diskette if the user does not have access to remote file systems or any other files that are on the system. If enough space is not available, an error is reported stating additional system memory is needed. After the file is copied, a warning screen asks for confirmation to continue the update flash. Continuing the update flash reboots the system. The current flash image is not saved.

After you download and install a firmware fix, the fix is temporarily installed until you install it permanently. You might want to use the new level of firmware for a period of time to verify that it works correctly. When you are sure that the new level of firmware works correctly, you can permanently install the firmware fix. Be aware that if you install the firmware fix permanently (copy the temporary firmware level from the temporary side to the permanent side, so that the temporary and permanent sides contain the same level of firmware), you cannot return to the level that was previously on the permanent side. To install it permanently, use the -commit flag.

Attention: The ldfware command reboots the entire system. Do not use this command if more than one user is signed onto the system.

Flags

Flag name Description
-commit Commits the temporary image when booted from the temporary image. This effectively causes the permanent image to be copied over by the temporary image. This flag is not supported on all systems.
-dev Device Specifies that the flash update image file is on diskette. The device_name variable specifies the device. The default device_name is /dev/fd0.
-file FileName Specifies the file name of the image file source. The flash update image file source follows this flag. The file_name variable specifies the fully qualified path of the flash update image file.
-reject Rejects the temporary image when booted from the permanent image. This overwrites the temporary image with the permanent image. This flag is not supported on all systems.

Exit Status

The following exit codes are returned:

Value Description
0 Completed successfully.
1 Command terminated due to an error.
2 Command was aborted by the user.
3 Command was aborted by the user using the F10 key.

Examples

  1. To update the firmware from a local file, type the following command:
     ldfware -file /tmp/firmware/latest_flash
  2. To update the firmware that is on a diskette, type the following command:
       ldfware -device /dev/fd0 -file latest_flash 
  3. To update the firmware that is on a CD device, type the following command:
    mount -cd  /mnt ldfware -file /mnt/firmware/latest_flash



Last updated: Wed, November 18, 2020