nim_update_all Command

Purpose

Updates NIM resources and customizes NIM clients.

Syntax

nim_update_all [ -d device ] [ -l lpp_source resource ] [ -s spot resource ] [ -B ] [ -u ] [ -v ] client object(s)

Description

The nim_update_all command updates the install resources and clients in the NIM environment. Flags may be used for specifying which NIM resources need updating and also to disable the updating of NIM clients. The nim_update_all command updates the NIM environment by performing the following tasks:
  • Exports the environment variable NIM_LICENSE_ACCEPT=yes.
    • Used for accepting software license agreement during update install.
  • Adds variable entry NSORDER=local,bind in /etc/environment.
    • Necessary for name resolution when hosts only exist in /etc/host.
  • Obtains the update level information from the media.
    • The default media location is /dev/cd0.
    • The media location may be modified by using the -d flag.
  • Updates the lpp_source, spot, and mksysb resources.
    • The lpp_source resource name may be specified by using the -l flag.
    • The spot resource name may be specified by using the -s flag.
    • The mksysb resource name is obtained from the mksysb resource contained in the basic_res_grp resource group. Specify the -B flag to disable updating the mksysb resource.
  • Performs an update_all operation on NIM clients.
    • If client objects are given, specified clients are updated.
    • If client objects are omitted, all existing NIM clients are updated.
    • If -u flag is used, no clients are updated.

Flags

Item Description
-d device Specifies the absolute path location for update images used during command execution. By default, device is /dev/cd0.
-l lpp_source resource Specifies the object name for the lpp_source resource to update. By default, the resource name is obtained from basic_res_grp.
-s spot resource Specifies the object name for the spot resource to update. By default, the resource name is obtained from basic_res_grp.
-B Disables the updating of the backup image contained in basic_res_grp.
-u Disables the updating of client objects.
-v Enables verbose debug output during command execution. Security

Location

/usr/sbin/nim_update_all

Exit Status

Returns zero (0) upon success.

Security

Access Control: You must have root authority to run the nim_update_all command.

Examples

  1. To update install resources 520lpp_res (lpp_source), 520spot_res (spot), and master_sysb (mksysb) contained in the basic_res_grp resource group, using update images located in device /dev/cd2, and update all clients in the NIM environment, type:
    nim_update_all -d /dev/cd2
  2. To update install resources lpp1 (lpp_source), spot1 (spot), and disable updating the mksysb image, using update images located in device /dev/cd0, and update the client object machine1 in the NIM environment, type:
    nim_update_all -l lpp1 -s spot1 \
               -B machine1
  3. To update install resources 520lpp_res (lpp_source), 520spot_res (spot), and disable updating the mksysb image contained in the basic_res_grp resource group, using update images located in device /dev/cd0, and disable updating clients in the NIM environment, type:
    nim_update_all -B -u

Files

Item Description
/etc/niminfo Contains variables used by NIM.
/var/adm/ras/nim.update Contains log information from command execution.