| -r | The remote location or media where the VIOS update image will be imported from. Valid values are nfs to import the image from an NFS file system, sftp to import the image from a secure FTP (SFTP) server, and usb to import the image from a USB data storage device. |
| -n | The name to give the VIOS update image on the HMC. |
| -f |
When importing a VIOS update image from a remote server, use this option to specify the names of the files to import if all of the files in the import directory are not part of the same update image. Multiple file names must be comma separated. If this option is omitted, all files in the import directory will be imported.
If the import directory contains more than one ISO file, this option must be specified with the name of one ISO file to import. This option is only valid when importing a VIOS update image from a remote server. |
| -h | The host name or IP address of the remote server. |
| -u |
The user ID to use to log in to the remote SFTP server.
This option is required when importing a VIOS update image from a remote SFTP server. Otherwise, this option is not valid. |
| --passwd |
The password to use to log in to the remote SFTP server.
If both this option and the -k option are omitted when importing a VIOS update image from a remote SFTP server, you will be prompted to enter the password. The --passwd and -k options are mutually exclusive. |
| -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 when importing a VIOS update image from a remote SFTP server, you will be prompted to enter the password. The -k and --passwd options are mutually exclusive. |
| -l |
The mount location defined on the NFS server where the VIOS update image will be imported from.
This option is required when importing a VIOS update image from an NFS file system. Otherwise, this option is not valid. |
| --options |
Options to be passed to the mount command used to mount the NFS file system where the VIOS update image will be imported from. The options must be enclosed in double quotes.
The HMC supports NFS versions 3 and 4, and this command uses version 3 by default. To use version 4, include the option vers=4. This option is only valid when importing a VIOS update image from an NFS file system. |
| -d | The name of the directory on the remote server where the VIOS update image will be imported from. If this option is not specified when importing the VIOS update image from a SFTP server, the image will be imported from the user’s home directory. If this option is not specified when importing the VIOS update image from an NFS file system, the image will be imported from the mount-location on the NFS server. |
| --device | When importing a VIOS update image from a USB data storage device, use this option to specify the name of the USB device on the HMC. The USB device must be connected to the HMC and must be mounted with the mount command before this command is run. The lsmediadev command can be used to display the device name of the USB device once it has been connected to the HMC. |
| --help | Display the help text for this command and exit. |
cpviosupd -r sftp -n VIOS_FP_3.1.3.14 -h sftpserver -u sftpuser
-k /home/hmcuser/keys/id_rsa -d vios/update/VIOS_FP_3.1.3.14
-f H24094002.iso
Import a VIOS update image from a remote SFTP server (you will be prompted for the password):
cpviosupd -r sftp -n VIOS_FP_3.1.2.10 -h sftpserver -u sftpuser
-d vios/update/VIOS_FP_3.1.2.10
Import a VIOS update image from an NFS file system using NFS version 4:
cpviosupd -r nfs -n VIOS_FP_3.1.3.14 -h 9.3.145.52 -l /images
--options "vers=4" -d vios/update/VIOS_FP_3.1.3.14
-f U872970.bff,U877527.bff,U877574.bff,U879820.bff,U883888.bff
Import a VIOS update image from a USB data storage device (the USB data storage device must already be connected to the HMC):
lsmediadev (to obtain mount point/device name)
mount /dev/sdb1
cpviosupd -r usb -n VIOS_FP_3.1.2.10 --device /dev/sdb1
| None | |
| None | |
| Linux | CPVIOSUPD (1) | December 2022 |