SUNUPGRADE(8) — MAINTENANCE COMMANDS

NAME

sunupgrade − upgrade the Sun Operating System

SYNOPSIS

/usr/etc/sunupgrade [ −l ] [ −d ] [ −n ]

AVAILABILITY

This command is available on Sun2, Sun3 and Sun4 application architectures running SunOS version 4.0 or later only. Refer to Installing the SunOS 4.0.3 for more information.

DESCRIPTION

sunupgrade is an interactive utility used to upgrade the Sun Operating System (SunOS) to a higher revision level on Sun2, Sun3, and Sun4 application architectures. The current SunOS level must be at least SunOS 4.0.

Note: sunupgrade should only be invoked from the miniroot (see Installing the SunOS 4.0.3).

sunupgrade lets you upgrade any system configuration. The following are the valid configuration types:

• Standalone

• Homogeneous server

• Heterogeneous server

• Dataless clients

• Diskless clients

Both local and remote installation modes are supported.

sunupgrade overlays new executable administrative files on top of existing ones; the user must resolve the differences between the conflicting files after sunupgrade is completed. If new and old versions of these ASCII files are not identical, the newer file is installed with a trailing suffix reflecting the release name. The older versions of vmunix are saved with a trailing suffix indicating the pre-release version. Except for /usr/share/sys/sun/conf.c, these conflicts will only arise in the /etc and /var directories.

All of these conflicting files are logged in /usr/etc/upgrade/save/special_files for servers and standalone systems, /usr/etc/upgrade/save/clientname.special_files for diskless clients, and
/home/upgrade/special_files for dataless clients.

Errors returned by sunupgrade during the upgrade procedure are saved in /usr/etc/upgrade/save/errlog.

After sunupgrade completes execution: single-user mode must be invoked; all special files inspected; the older administrative files replaced with the newer ones and renamed without the suffixes; and errlog checked for errors.

OPTIONS

−l Create log of all files extracted and overlaid. Performance will deteriorate slightly. Log files are saved in the directory /usr/etc/upgrade/save. A log called upgrade_files is created in that directory containing the filenames of all the new files installed. Client log files are installed as clientname.upgrade_files.

−d Work in debugging mode. Not recommended for normal operation.

−n Switch off “no-rewind” operation. The no-rewind operation available only on systems running SunOS 4.0.2-CG8 or 4.0.3.

FILES

/usr/etc/upgrade/EXCLUDELIST

/usr/etc/upgrade/README

/usr/etc/upgrade/checksums

/usr/etc/upgrade/chk_ok

/usr/etc/upgrade/chk_release

/usr/etc/upgrade/chkextract

/usr/etc/upgrade/config_host

/usr/etc/upgrade/extract

/usr/etc/upgrade/extract_client

/usr/etc/upgrade/extract_clntroot

/usr/etc/upgrade/extract_stand

/usr/etc/upgrade/include

/usr/etc/upgrade/includefile

/usr/etc/upgrade/get_arch

/usr/etc/upgrade/get_clientinfo

/usr/etc/upgrade/get_machtype

/usr/etc/upgrade/get_tapeinfo

/usr/etc/upgrade/get_toc

/usr/etc/upgrade/get_upgradeinfo

/usr/etc/upgrade/mop_up

/usr/etc/upgrade/mount_ufs

/usr/etc/upgrade/mount_usr

/usr/etc/upgrade/start_log

/usr/etc/upgrade/save/errlog

/usr/etc/upgrade/save/special_files

/usr/etc/upgrade/save/upgrade_files

/usr/etc/upgrade/setup_kvm

/usr/etc/upgrade/small_kernel_files

/usr/etc/upgrade/sun2_cp_share

/usr/etc/upgrade/sun2_ln_exec

/usr/etc/upgrade/sunupgrade

/usr/etc/upgrade/tar_clntroot

/usr/etc/upgrade/verify_clntpart

/usr/etc/upgrade/xdrtoc

Museum

Related Articles