updateios command

Purpose

Updates the Virtual I/O Server to latest maintenance level.

Syntax

updateios -dev Media [-f] [ -install ] [ -accept ]

updateios -commit

updateios -cleanup

updateios -remove { -file RemoveListFile | RemoveList }

updateios -list -dev Media

updateios -fs FilesetName -dev Media

Description

The updateios command is used to install fixes, or to update the VIOS to the latest maintenance level. Before installing a fix or updating the maintenance level, the updateios command runs a preview installation and displays the results. You are then prompted to continue or exit. If the preview fails for any reason, do not install the update.

From VIOS version 2.2.2.0 or later, a separate preview is shown for the install file (bos.rte.install) when there is an update for the file. After you provide an input for the installation, a preview of the remaining installation is shown and it prompts for your input.

Note: A fix pack or service pack cannot be applied if the VIOS partition is part of a shared storage pool and the cluster node state is UP. To apply a fix pack or service pack, either remove the VIOS partition from the cluster or change the cluster node state to DOWN by running the clstartstop command.

Note: Do not do any cluster configuration activities until the updateios command has finished running.

Note: If you use the File Backed Optical Media repository, ensure to offload the media images before you apply a fix pack.

Flags

Flag name	Description
-accept	Specifies that you agree to required software license agreements for software to be installed.
-cleanup	Specifies the cleanup flag to remove all incomplete pieces of the previous installation. Perform cleanup processing whenever any software product or update is after an interrupted installation or update is in a state of either applying or committing. You can run this flag manually, as needed.
-commit	The -commit flag will commit all uncommitted updates to the VIOS.
-dev Media	Specifies the device or directory containing the images to install.
-f	Forces all uncommitted updates to be committed prior to applying the new updates. When combined with the -dev flag, this flag commits all updates prior to applying any new ones.
-file file	Specifies the file containing a list of entries to uninstall.
-fs FilesetName	Specifies the name of the fileset to be installed from the VIOS installation. media
-install	Installs new and supported filesets onto the VIOS. Attention: The log file, install.log in the user's home directory, will be overwritten with a list of all filesets that were installed.
-list	Lists the filesets on the VIOS installation media, that are available to be installed.
-remove	Removes the listed filesets from the system. The filesets to be removed must be listed on the command line or in the RemoveListFile file.

Exit Status

The following exit values are returned:

Return code	Description
19	All uncommitted updates must be committed
20	There are no uncommitted updates

Examples

To update the VIOS to the latest level, where the updates are located on the mounted file system /home/padmin/update, type the following command:
```
updateios -dev /home/padmin/update
```
To update the VIOS to the latest level, when previous levels are not committed, type the following command:
```
updateios -f -dev /home/padmin/update
```
To cleanup partially installed updates, type the following command:
```
updateios -cleanup
```
To commit the installed updates, type the following command:
```
updateios -commit
```
To list the available file sets on the VIOS installation media, type the following command:
```
updateios -list -dev /dev/cd0
```
To install a fileset from the VIOS installation media, type the following command:
```
updateios -fs ILMT-TAD4D-agent -dev /dev/cd1
```

Related Information

The ioslevel command, the lssw command, the oem_setup_env command, the oem_platform_level command, and the remote_management command.

Last updated: Wed, November 18, 2020