updateios command

Purpose

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

Syntax

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

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

updateios -query

updateios -commit

updateios -cleanup

updateios -remove { -file RemoveListFile | RemoveList}

updateios -list -dev Media

updateios -listlang

updateios -rmlang -preserve LANG_CODE1, LANG_CODE2,...

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 the 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 commits 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 before applying the new updates. When combined with the -dev flag, this flag commits all updates before applying any new ones.
-file file Specifies the file containing a list of entries to uninstall.
-fs FilesetName Specifies the name of the file set to be installed from the VIOS installation. media
-install Installs new and supported file sets onto the VIOS.
Attention: The log file, install.log in the user's home directory, is overwritten with a list of all file sets that were installed.
-list Lists the file sets on the VIOS installation media that are available to be installed.
-remove Removes the listed file sets from the system. The file sets to be removed must be listed on the command line or in the RemoveListFile file.
-listlang Lists all the currently installed languages along with their codes.
-rmlang Removes language filesets.
-preserve Preserves the given language code filesets and removes remaining language filesets.
Note: English filesets are preserved always.
-bg Runs the command in the background. It must be used with the -accept option.
-query Displays the status of the running command.

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

  1. 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
  2. To update the VIOS to the latest level, when previous levels are not committed, type the following command: 
    updateios -f -dev /home/padmin/update
  3. To cleanup partially installed updates, type the following command: 
    updateios -cleanup
  4. To commit the installed updates, type the following command: 
    updateios -commit
  5. To list the available file sets on the VIOS installation media, type the following command: 
    updateios -list -dev /dev/cd0
  6. To install a file set from the VIOS installation media, type the following command: 
    updateios -fs ILMT-TAD4D-agent -dev /dev/cd1
  7. To list the language filesets currently installed, along with their codes, type the following command:
    updateios -listlang
  8. To remove all languages and preserve one language, such as Japanese, type the following command:
    updateios -rmlang -preserve ja_JP
  9. To remove all languages and preserve more than one language, such as Japanese, Spanish or French, type the following command:
    updateios -rmlang -preserve ja_JP,es_ES,fr_FR
  10. To execute the command in background, type:
    updateios -dev /home/padmin/update -accept -bg

Related Information

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