Index Index for
Section 8
Index Alphabetical
listing for I
Bottom of page Bottom of
page

installupdate(8)

NAME

installupdate - Invokes the Update Installation procedure

SYNOPSIS

/sbin/installupdate [-nogui] [-u] {ris_server:} /sbin/installupdate [-nogui] [-u] {[cdrom_device] [cdrom_mount_point]}

OPTIONS

-nogui On systems with graphics capability, this option invokes the text- based, menu driven user interface rather than the graphical user interface. -u Invokes an unattended Update Installation. Unattended means that barring any problems during the Update Installation (such as file type conflicts, insufficient disk space, and blocking layered products), there is no user interaction required. This option builds a kernel with all kernel components and does not provide the opportunity to archive obsolete files before the Update Installation process deletes them. If the analysis phase of the update discovers file type conflicts, insufficient disk space, or blocking layered products, the update process stops and prompts you to correct the problem or problems before the update resumes.

DESCRIPTION

An Update Installation updates the base operating system software and the worldwide language support (WLS) software to the next released version of the operating system on a single system. The Update Installation preserves user files, data files, print and network configurations, user accounts, and any other system setup and customization you may have done. Cluster software is updated by a process called a rolling upgrade. An Update Installation is one of several stages in a cluster rolling upgrade. The cluster rolling upgrade process is documented in the TruCluster Server Cluster Installation manual and in clu_upgrade(8). An Update Installation does not update layered products, but you can still perform an Update Installation if your system is installed with layered products. Some layered products operate properly with the new version of the operating system and others must be reinstalled with a version that is compatible with the new version of the operating system. You are notified accordingly. You can delete these products during the Update Installation process and then reinstall them on the updated system. There are two distribution methods for an Update Installation: · From the operating system CD-ROM (from a mount point or CD-ROM device) · Over a network connection to a Remote Installation Services (RIS) server that is serving the most recent version of the operating system The Update Installation is performed from single-user mode. You must be superuser or the user root to bring a system down to single-user mode. Do not boot to single-user mode to perform an Update Installation. Whether you are using CD-ROM or RIS, the Update Installation process is started by entering the /sbin/installupdate command from the command line. The functions performed during the Update Installation process include: · Detecting and deleting obsolete system files, files that were previously shipped with the older version of the operating system but are not in the new release. You have the option to archive these files to a file name of your choice before they are removed from the system. · Checking for file types that you have changed since the last version of the operating system. Certain file type conflicts prevent the Update Installation from continuing, and you must resolve these conflicts before you can restart the Update. This feature preserves the integrity of the new operating system about to be installed. · Checking for adequate free disk space to ensure the Update Installation has enough room for temporary processing and there is enough disk space for the new software subsets that were introduced in the new version of the operating system. · Checking for installed layered products that may not be compatible with the new version of the operating system. The product or products may need to be reinstalled later. · Saving unprotected customized files to files with .PreUPD extensions to preserve customizations that were made to unprotected system files. These files are not expected to be modified and are not merge protected from the Update Installation, therefore they are saved with the .PreUPD extension. · Performing merges of protected system files. These are files that are shipped as part of the operating system that are expected to be customized (for example, the /etc/hosts file). These files are merge protected, which means that user customizations are preserved and newly introduced functionality is merged into the already customized file. · Using the setld command to load new software subsets. Subsets previously installed are updated as well as any new mandatory subsets that were introduced in the new version of the operating system. Base operating system subsets and Worldwide Language Support (WLS) subsets are updated. · Building a custom kernel and rebooting the system with that kernel. · Executing user-supplied update_preinstall and update_postload files, if they exist, to perform customizations on the updated system. An Update Installation completes in 45 to 120 minutes. Actual time varies depending on your processor type, the number of software subsets that have to be updated, network traffic, and the speed of the CD-ROM device. You need to respond to prompts only during the initial analysis phase of the Update Installation. Postinstallation tasks may include manually merging file customizations into those files that were not done automatically and rebuilding the kernel with layered product kernel components. It is recommended that you review the Update Installation log files located in the /var/adm/smlogs directory when the Update Installation is complete.

EXAMPLES

The following examples assume you have performed all required preinstallation tasks, have shut down the system to single user mode, and have mounted the local file systems with the <filename> /sbin/bcheckrc</filename> command. See the Installation Guide for more information about these steps. To start an unattended Update Installation from a CD-ROM device: # /sbin/installupdate -u /dev/disk/cdrom0c To start the Update Installation using the text-based interface from a CD- ROM device that is mounted on the /mnt mount point: # /sbin/installupdate -nogui /mnt To start the Update Installation from a RIS server named server1: # /sbin/installupdate server1:

FILES

/usr/adm/smlogs/update.log Contains a log of the output that was displayed to the screen during the Update Installation. /usr/adm/smlogs/upd_custom_files Contains a list of the files that were saved to a .PreUPD extension. /usr/adm/smlogs/upd_PreMRG_files Contains a list of the files that were saved to a .PreMRG extension. /usr/adm/smlogs/upd_mergfail_files Contains a list of the protected system files that failed to automatically merge during the Update Installation.

SEE ALSO

Commands: clu_upgrade(8), doconfig(8), fitset(8), ris(8), setld(8), updadmin(8) Installation Guide Installation Guide -- Advanced Topics Update Installation Quick Reference Card Sharing Software on a Local Area Network TruCluster Server Cluster Installation

Index Index for
Section 8
Index Alphabetical
listing for I
Top of page Top of
page