geninstall Command

Purpose

A generic installer that installs software products of various packaging formats. For example, installp, RPM, SI, and ISMP.

Syntax

geninstall -d Media [ -I installpFlags ] [ -E | -T ] [ -t ResponseFileLocation ] [-e LogFile] [ -p ] [ -F ] [ -Y ] [ -Z ] [ -D ] { -f File | Install_List ] | all}

geninstall -u [-e LogFile] [ -E | -T ] [ -t ResponseFileLocation ] [ -D ] {-f File | Uninstall_List...}

geninstall -L -d Media [-e LogFile] [ -D ]

Description

Accepts all current installp flags and passes them on to installp. Some flags (for example, -L) are overloaded to mean list all products on the media. Flags that don't make sense for ISMP packaged products are ignored. This allows programs (like NIM) to continue to always send in installp flags to geninstall, but only the flags that make sense are used.

The geninstall command provides an easy way to see what modifications have been made to the configuration files listed in /etc/check_config.files. When these files have been changed during a geninstall installation or update operation, the differences between the old and new files will be recorded in the /var/adm/ras/config.diff. If /etc/check_config.files requests that the old file be saved, the old file can be found in the /var/adm/config directory.

The /etc/check_config.files file can be edited and can be used to specify whether old configuration files that have been changed should be saved (indicated by s) or deleted (indicated by d), and has the following format:

d /etc/inittab

A summary of the geninstall command's install activity is kept at /var/adm/sw/geninstall.summary. This file contains colon-separated lists of filesets installed by installp and components installed by ISMP. This is used mainly to provide summary information for silent installs.

Note: Refer to the README.ISMP file in the /usr/lpp/bos directory to learn more about ISMP-packaged installations and using response files. Also, the geninstall command is capable of installing interim fix files containing concurrent updates. Any interim fixes containing concurrent updates must be placed inside a subdirectory called cupdates in the directory containing installation images, and the geninstall command will install them appropriately.

Flags

Item	Description
-d Device or Directory	Specifies the device or directory containing the images to install.
-D	Specifies debug mode. This flag is for debugging this script. It produces a large quantity of output and should not be used for normal operations.
-e LogFile	Enables event logging. The -e flag enables the user to append certain parts of the geninstall command output to the file specified by the LogFile variable. The LogFile variable must specify an existing, writable file, and the file system in which the file resides must have enough space to store the log. The log file does not wrap.
-E	Creates an ISMP response file recording in the default location, which is the directory containing the product installation files. This option requires running the ISMP installation or uninstallation interactively and completely. The resulting response file will be used to provide the same options on future installations or uninstallations of the same product. Creation of the response file recording will also result in installation or uninstallation of the product.
-f File	Specifies a file that contains a list of images to copy to the target location. The installp, RPM, and ISMP images should be prefixed with I:, R:, and J:, respectively. Prefix the interim fix packages with an E:.
-F	Allows the user to reinstall a package that is already installed, or to install a package that is older than the currently installed version.
-I installpFlags	Specifies the installp flags to use when calling the installp command. The flags that are used during an install operation for installp are the a, b, c, D, e, E, F, g, I, J, M, N, O, p, Q, q, S, t, v, V, w, and X flags. The installp flags that are not used during install are the C, i, r , z, A, and l flags. The installp command should be called directly to perform these functions. The -u, -d, -L, and -f flags should be given outside the -I flag.
-L	Lists the contents of the media. The output format is the same as the installp -Lc format, with additional fields at the end for ISMP and RPM formatted products.
-p	Performs a preview of an action by running all preinstallation checks for the specified action.
-t ResponseFileLocation	Allows specifying an alternate location for response files or response file templates. The default location is the directory containing the product installation files. This flag can be used to create a response file recording or template in a different location. The ResponseFileLocation can either be a file or directory name. If the ResponseFileLocation is a directory, it must already exist. If the ResponseFileLocation is not an existing directory, it will be assumed that a file name is specified.
-T	Creates an ISMP response file template in the default location, which is the directory containing the product installation files. The resulting template can be used to create a reponse file for future installations or uninstallations of the same product with the desired options. Creation of the response file template will not result in installation or uninstallation of the product.
-u	Performs an uninstall of the specified software. For ISMP products, the uninstaller listed in the vendor database is called, prefixed by a "J:".
-Y	Agrees to required software license agreements for software to be installed. This flag is also accepted as an installp flag with the -I option.
-Z	Tells geninstall to invoke the installation in silent mode.

Example

To install all the products on a CD media that is in drive cd0, type:

geninstall -d /dev/cd0 all

If ISMP images are present on the media, a graphical interface is presented. Any installp, SI, or RPM images are installed without prompting, unless the installp images are spread out over multiple CDs.

Files

Item	Description
/usr/sbin/gencopy
/usr/sys/inst.data/sys_bundles
/usr/sys/inst.data/user_bundles