The VIOS will be restarted during the upgrade.
| -r | The repository that contains the VIOS installation image. Valid values are disk for the Hardware Management Console (HMC) hard disk, nfs for an NFS file system, sftp for a secure FTP (SFTP) server, and usb for a USB data storage device. |
| -m | The name of the managed system which has the VIOS to upgrade. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss form must be used if there are multiple managed systems with the same user-defined name. |
| -p |
The name of the VIOS to upgrade.
You must either use this option to specify the name of the VIOS or use the --id option to specify the ID of the VIOS. The -p and --id options are mutually exclusive. |
| --id |
The ID of the VIOS to upgrade.
You must either use this option to specify the ID of the VIOS or use the -p option to specify the name of the VIOS. The --id and -p options are mutually exclusive. |
| --disk | The name of one or more free VIOS disks to be used for the upgrade. Multiple disk names must be comma separated. The total of the specified disk sizes must be a minimum of 30 GB. |
| -n |
The name of the VIOS installation image.
When the VIOS installation image is on the HMC hard disk, this option is required to specify the name of the installation image. When the VIOS installation image is on a remote server or a USB data storage device and the --save option is specified, this option is required to specify the name used to save the image to the HMC hard disk. |
| -f |
When the VIOS installation image is on a remote server, use this option to specify the installation image file names. 1 or 2 ISO file names must be specified. Multiple file names must be comma separated.
This option is required and only valid when the VIOS installation image is on 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 the VIOS installation image is on 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 the VIOS installation image is on 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 the VIOS installation image is on 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 that contains the VIOS installation image.
This option is required when the VIOS installation image is in 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 that contains the VIOS installation image. 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 the VIOS installation image is in an NFS file system. |
| -d | The name of the directory on the remote server that contains the VIOS installation image. If this option is not specified when the VIOS installation image is on a SFTP server, the image will be obtained from the user’s home directory. If this option is not specified when the VIOS installation image is in an NFS file system, the image will be obtained from the mount-location on the NFS server. |
| --device | When the VIOS installation image is on 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. |
| --save | Specify this option to save the VIOS installation image on the HMC hard disk. |
| --help | Display the help text for this command and exit. |
upgvios -m sys1 -p vios1 --disk hdisk6 -r disk -n VIOS_4.1.0.00
Upgrade VIOS vios1 using a VIOS installation image from a remote SFTP server, and use SSH keys for authentication:
upgvios -m sys1 -p vios1 --disk hdisk2,hdisk3 -r sftp -h sftpserver
-u sftpuser -k /home/hmcuser/keys/id_rsa -d vios/upgrade/VIOS_3.1.4.00
-f dvdimage.iso
Upgrade the VIOS with ID 1 using a VIOS installation image from a remote SFTP server (you will be prompted for the password). Save the image on the HMC hard disk:
upgvios -m 9080-HEX*1234567 --id 1 --disk hdisk1 -r sftp
-n VIOS_3.1.4.00 --save -h sftpserver -u sftpuser
-d vios/upgrade/VIOS_3.1.4.00 -f dvdimage.v1.iso,dvdimage.v2.iso
Upgrade the VIOS vios1 using a VIOS installation image from an NFS file system, and use NFS version 4:
updvios -m sys1 -p vios1 --disk hdisk9,hdisk10 -r nfs -h 9.3.145.52
-l /images --options "vers=4" -d vios/upgrade/VIOS_IMAGE
-f dvdimage.iso
Upgrade the VIOS with ID 1 using 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
upgvios -m sys1 --id 1 --disk hdisk1,hdisk2,hdisk3 -r usb
--device /dev/sdb1
| None | |
| None | |
| Linux | UPGVIOS (1) | November 2023 |