CLEANUP(8,C) AIX Commands Reference CLEANUP(8,C)
-------------------------------------------------------------------------------
cleanup
PURPOSE
Moves backout cluster information from file system.
SYNTAX
+-- -c --+
/etc/lpp/cleanup ---| |--- dev --- frame_number ---|
+-- -r --+
DESCRIPTION
This command is a tool used to move backout stack frames from the file system
to storage media (for example, tape). The main purpose of such action is to
open up room in the file system so it does not get clogged up with backout
information.
Note: When the LPP's information is cleaned from the backup stack,
uncommitting (backing out) updates to an LPP is no longer possible.
Therefore, you must return the commit information for that LPP to the
backout stack before attempting to uncommit (back out) that LPP. When
you attempt an uncommit (back out), the stack is automatically checked
for cleaned up information. If any information exists, you are notified
and asked to restore them using cleanup -r.
If you need to free the space used by the last update, you should use the
cleanup program.
For each LPP installed and for each invocation of updatep -c to commit an LPP
(or group of LPPs applied together), a backout stack frame is created as a
subdirectory under /usr/lpp.save. A stack frame contains information which
permits an update to be uncommitted. Stack frames are sequentially numbered
and allocated in a LIFO (Last In First Out) stacked manner.
The /etc/lpp/cleanup utility enables stack frames to be archived to tape or
diskette so that valuable root file space can be released for subsequent
updates. Prior to applying a PTF update, the following commands will archive
all stack frames to blank tape mounted on /dev/rmt0. Be sure the tape in the
drive is write-enabled in ready status, and is attached to the AIX/370 guest at
address 380.
/etc/lpp/cleanup -c /dev/rmt0 [0-9]
Note: The above /dev/rmt0 [0-9] is correct shell syntax.
Processed November 8, 1990 CLEANUP(8,C) 1
CLEANUP(8,C) AIX Commands Reference CLEANUP(8,C)
After cleanup is run, further updates may be applied and committed. Note that
new stack frame numbers will be allocated to continue the previously
established sequence; numbering does not revert to 1.
If updates committed before running cleanup subsequently need to be uncommitted
or rejected, the archived stack frames must first be restored from the tape.
FLAGS
-c Backout information from one or more frames is moved from the backout
stack to the media referred to by a device, specified by dev.
-r Backout information on the media referred to by the dev parameter is
restored to the backout stack.
Processed November 8, 1990 CLEANUP(8,C) 2