---

HMC Manual Reference Pages  - UPDHMC (1)

---

updhmc - update the Hardware Management Console

CONTENTS

Synopsis
Description
Options
Exit Status
Examples
Environment
Bugs
Author
See Also

updhmc -t {disk | dvd | ftp | sftp | nfs | usb}
[-h host-name] [-u user-ID] [--passwd password] [-k SSH-private-key]
[-l mount-location] [-o mount-command-options]
[-f file] [-r] [-c] [-n device-name] [--help]

updhmc updates the Hardware Management Console (HMC) by installing a corrective service package.

-t	The type of location which contains the corrective service ISO image. Valid values are disk for the HMC hard disk, dvd for a DVD drive, ftp for an FTP site, sftp for a secure FTP (SFTP) site, nfs for an NFS file system, or usb for a USB data storage device. To install a corrective service package located on a USB data storage device, the device must be connected to the HMC and must be mounted with the mount command before this command is issued. The lsmediadev command can be used to display the mount point for the USB device.
-h	The host name or IP address of the remote server where the corrective service ISO image is located. This option is required when the ISO image is located on a remote FTP, SFTP, or NFS server. Otherwise, this option is not valid.
-u	The user ID to use to log in to the remote FTP or SFTP server. This option is required when the ISO image is located on a remote FTP or SFTP server. Otherwise, this option is not valid.
--passwd	The password to use to log in to the remote FTP or SFTP server. If this option is omitted and the corrective service ISO image is located on a remote FTP server, you will be prompted to enter the password. If both this option and the -k option are omitted and the corrective service ISO image is located on a remote SFTP server, you will be prompted to enter the password. The --passwd and -k options are mutually exclusive. This option is only valid when the ISO image is located on a remote FTP or SFTP server.
-k	The name of the file that contains the SSH private key. If the file name is not fully qualified, the file must exist in the user’s home directory on the HMC. Use the ssh-keygen command to generate the public and private SSH key pair. The ssh-keygen command is not allowed to write to the .ssh directory in the user’s home directory on the HMC, so when you run the command on the HMC, you must specify both the directory and the file name for the private key. If you generate a key with a passphrase, you will be prompted to enter the passphrase when you run any HMC command that uses the key. If both this option and the --passwd option are omitted and the corrective service ISO image is located on a remote SFTP server, you will be prompted to enter the password. The -k and --passwd options are mutually exclusive. This option is only valid when the ISO image is located on a remote SFTP server.
-l	The mount location defined on the NFS server where the corrective service ISO image is located. This option is required when the ISO image is located on a remote NFS server. Otherwise, this option is not valid.
-o	The options to be passed to the mount command used to mount the NFS file system where the corrective service ISO image is located. This command uses NFS version 4 by default. This option is only valid when the ISO image is located on a remote NFS server.
-f	The name of the corrective service ISO image file. This option is required when the ISO image is located on the HMC hard disk, a remote FTP, SFTP, or NFS server, or on a USB data storage device. Otherwise, this option is not valid.
-r	Specify this option to restart the HMC after applying the corrective service package.
-c	Specify this option to remove the corrective service ISO image file from the HMC hard disk after applying the corrective service package. This option is only valid when the ISO image is located on the HMC hard disk.
-n	The name of the remote virtual media device where the corrective service ISO image is located. The lsmediadev command can be used to display the device name of a remote virtual media device. This option is only valid when -t dvd is specified. This option is not required when the ISO image is located on a DVD in the local DVD drive.
--help	Display the help text for this command and exit.

This command has the following return codes:

0	Success
1	Command failed
2	An HMC restart is required but the -r option was not specified
4	An additional ISO image or media is required

Install the corrective service package located on a DVD in the local DVD drive then reboot the HMC:

updhmc -t dvd -r

Install the corrective service package located on remote virtual media:

lsmediadev (to obtain the remote virtual media device name)

updhmc -t dvd -n /dev/sr1

Install a corrective service package located on an FTP server (you will be prompted to enter the user’s password):

updhmc -t ftp -h ftpServer -u user1 -f /tmp/Update1.iso

Install a corrective service package located on an SFTP server and use SSH keys for authentication:

updhmc -t sftp -h sftpServer -u user1 -k /home/hmcuser/keys/id_rsa
-f /tmp/Update1.iso

Install a corrective service package located in an NFS file system:

updhmc -t nfs -h 9.3.121.61 -l /hmc/images -f 830/update.iso

Install a corrective service package located on a USB data storage device (the USB device must already be connected to the HMC):

lsmediadev (to obtain mount points)

mount /media/sdb1

updhmc -t usb -f /media/sdb1/update2.iso

None

None

IBM Austin

lsmediadev