unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



updadmin(8)							  updadmin(8)



NAME

  updadmin - Invokes the Update	Installation Cleanup utility to	remove or
  archive backup files created by an Update Installation

SYNOPSIS

  /usr/sbin/updadmin

DESCRIPTION

  The updadmin command invokes the Update Administration Cleanup utility,
  which	removes	or archives the	 backup	files that were	created	 by an Update
  Installation process.	There are no flags or options associated with this
  command. Running this	utility	is an optional step after performing an
  Update Installation, but it is recommended if	you want to recover disk
  space	being consumed by these	backup files.

  The backup files that	are created by an Update Installation have these
  extensions:

    +  *.PreMRG	- A file saved to a .PreMRG extension is a backup copy of a
       customized protected system file.  System files in this category	are
       system files that are expected to be customized by users, for example,
       /etc/passwd and /etc/hosts. If the automatic merge process fails	to
       merge the new version of	the file with your customizations to the
       file, your customizations must be merged	manually into the new version
       of the file when	the Update Installation	is complete.  The *.PreMRG
       version is a copy of the	file as	it existed before the Update Instal-
       lation and only will be present if the automatic	merge fails.

    +  *.PreUPD	- A file saved to a .PreUPD extension is a backup copy of a
       customized unprotected system file as it	existed	before the Update
       Installation. System files in this category are system files that are
       not expected to be customized by	users, for example,
       /usr/bin/X11/netscape. If an unprotected	system file is altered in any
       way, customizations must	be merged manually into	the new	version	of
       the system file when the	Update Installation is complete.

  When you are finished	merging	your customizations into the new version of
  the file, these backup files no longer are needed, and they can be removed
  or archived.

  The Update Installation Cleanup utility gives	you the	option to archive or
  remove all backup files, or to select	only the files you want. You are
  prompted to enter an archive destination if you decide to archive the
  files.

  The Update Installation Cleanup utility uses the tar(1) command to create
  the archive, and the archive destination can be any archive destination
  supported by the tar command,	including tape devices.	The default archive
  location is the backup.tar file in the /var/adm/update/ directory. You can
  use any file name you	want, but if you want the file to have a .tar
  extension, you must enter it as part of the file name. If the	file name
  exists, it is	overwritten. You have the option to compress the archive file
  with the gzip	utility; if you	do, a .gz extension is appended	automati-
  cally.


  Unless you compress the archive file,	the space savings realized by archiv-
  ing to a tar file on disk will be only in moving the files from the /
  (root), /usr,	or /var	file systems to	the file system	containing the
  archive. To save disk	space, archive the files to tape.

  To archive to	a tape device in tar format, enter archive destinations	simi-
  lar to the following:

    +  /dev/tape/tape0c	- archives to a	default	density	rewind	tape (with
       compression)

    +  /dev/ntape/tape0_d0 - archives to a nonrewind tape device 0.  The _d0
       suffix specifies	the density. If	you are	archiving to a nonrewind tape
       device, it is recommended to use	a brand	new or erasable	tape.

  On systems capable of	graphical display, the updadmin	command	invokes	a
  graphical user interface to the Update Installation Cleanup utility. On
  systems that are not capable of graphical displays, a	text-based, menu-
  driven user interface	is invoked. The	Update Installation Cleanup utility
  is also available as a task from the SysMan Menu.

  To view the online help for the Update Installation Cleanup utility without
  running the utility, use the following command:

       # /usr/dt/bin/dthelpview	-h /usr/dt/appconfig/help/C/updadmin.sdl

RESTRICTIONS

  You must have	root privileges	to use the Update Installation Cleanup util-
  ity.

  If your system has not been updated to the next version of the operating
  system by the	Update Installation process, the Update	Installation Cleanup
  utility cannot be invoked.

FILES

  /usr/sbin/updadmin
      Update Administration Cleanup utility

  /usr/dt/appconfig/help/C/updadmin.sdl
      Contains the online help for the Update Administration Cleanup utility.

  /var/adm/update/backup.tar
      Default location of the archive file

SEE ALSO

  Commands: tar(1), gzip(1), sysman(8),	installupdate(8)

  Installation Guide