| -r | The remote location or media where the VIOS installation 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 installation image on the HMC. |
| -f |
When importing a VIOS installation image from a remote server, use this option to specify the name of one or two VIOS installation image ISO files to import. Multiple file names must be comma separated. When importing DVD ISO images, you must specify the first DVD ISO file name first, followed by the second DVD ISO file name.
This option is required when importing a VIOS installation image from a remote server. This option is not valid when importing a VIOS installation image from a USB data storage device. |
| -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 installation 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 installation 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 installation 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 installation image will be imported from.
This option is required when importing a VIOS installation 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 installation 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 installation image from an NFS file system. |
| -d | The name of the directory on the remote server where the VIOS installation image will be imported from. If this option is not specified when importing the VIOS installation 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 installation image from an NFS file system, the image will be imported from the mount-location on the NFS server. |
| --device | When importing a VIOS installation 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. |
cpviosimg -r sftp -n vios3.1 -h sftpserver -u sftpuser
-k /home/hmcuser/keys/id_rsa
-f Virtual_IO_Server_Base_Install_3.1.0.0_DVD_1_of_2_112018.iso,
Virtual_IO_Server_Base_Install_3.1.0.0_DVD_2_of_2_112018.iso
Import a flash VIOS installation image from an NFS file system using NFS version 4:
cpviosimg -r nfs -n vios3.1flash -h 9.3.145.52 -l /images
-d /vios -f Virtual_IO_Server_Base_Install_3.1.0.10_Flash_112018.iso
--options "vers=4"
Import a VIOS installation 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
cpviosimg -r usb -n vios3.1 --device /dev/sdb1
| None | |
| None | |
| Linux | CPVIOSIMG (1) | May 2022 |