Removing Installed Software with the GUI/TUI

The swremove Graphical User Interface (GUI) and Terminal User Interface (TUI) are based on the swinstall and swcopy user interfaces that are described in detail in Chapter 2 “Installing and Copying Software ”.

The swremove GUI and TUI also feature the same On-Line Help assistance as the swinstall interface. Choosing Help in the Menu bar or using the f1 key will present help topics that will further explain the various menu choices and options.

The swremove command behaves differently when removing from the primary root file systems versus alternate root file systems versus depots. The changes for alternate root file systems are noted in the section “Advanced Topics for swremove”. The changes to the interface for removing from depots are summarized in “Removing Software from Depots”.

The swremove session also consists of a Selection phase, an Analysis phase and a Remove phase. The Remove phase is the actual removal and monitoring of the process. The unconfigure scripts, preremove scripts and postremove scripts are executed in this phase.

swremove also automatically saves the current command options, source information, software selections and host/depots into a session file before the removal actually starts. This session file can then be recalled and re-executed. This session file is saved as $HOME/.sw/sessions/swremove.last.

To start the Graphical or Terminal User Interface for a remove session, simply type:

/usr/sbin/swremove

The Software Selection Window appears, displaying software on the local host.

Note that the -r and -d options must be specified for all root or depot removals, even when running the GUI/TUI.

You do not need to specify the -i option unless you want to pre-specify software to be marked in the GUI or TUI (see Chapter 2 “Installing and Copying Software ”).

Selecting Software to Remove

When you invoke swremove (without the -i or -r options), the Software Selection Window appears with all the software currently installed on the local host (at /) displayed in the Object List. Software is chosen by highlighting objects and "marking" them or by using the Actions->Mark For Remove menu choice. The Marked? flag is automatically updated to reflect the selection. The possible values for the Marked? flag are: "Yes", "Partial" and blank.

Opening and Closing an Object

As in swinstall, the objects in the swremove Object List can be bundles, products, subproducts or filesets. The column headers are identical to the attributes in the swinstall interface. These product attributes can also be modified with the Columns Editor.

The objects in the lists may be opened to show their contents. For example, if you wish to see the subproducts of a particular product, you may open that product by double clicking on the item (GUI only) or moving the focus to that item and pressing Return (TUI only). The contents of the Object List will be replaced with a listing of the subproducts for that product. If you want to open the subproduct, double click on it to display its filesets. Objects that have an arrow (->) after the name can be opened to reveal other items.

To close an object in the GUI and return to the previous list, double click on the first item in the list (. .(go up)). In the TUI, move the focus to . .(go up) and press Return.

To open and close objects in the TUI, use the Open Item and Close Level menu choices.

When the product is opened, the subproducts and the filesets are shown in the list together. However, at the product level, only products are listed together.

Analyzing a Removal

When the Actions->Remove analysis menu choice is made on the Software Selection Window, the Remove Analysis Dialog appears.

The Remove Analysis Dialog and its sub-menus are the same as those in the swinstall windows. See Chapter 2 “Installing and Copying Software ” for complete descriptions.

Analysis Progress and Results

The attributes available in the Analysis Object List are identical to the attributes available in the swinstall Analysis Dialog.

Once analysis has completed, the Status should be "Ready." If any of the selected software can be removed, the status will be "Ready" or "Ready with Warnings." If none of the selected software can be removed, status will be "Excluded from task."

The Errors and Warnings are the same as those for swinstall. Refer to Chapter 2 “Installing and Copying Software ” for complete details.

The Products Ready column shows the number of products ready for removal out of all products selected. The total products ready includes those products that are:

only marked because of dependencies
marked inside of bundles
partially and wholly marked.

See the section “Advanced Topics for swremove” for more information regarding dependencies.

A product may be automatically excluded from the removal if an error occurs with the product. The remove cannot proceed if the host target is excluded from the removal.

If the host fails the analysis, a Warning Dialog appears.

Getting More Details

The Analysis Dialog presents more in-depth information regarding the host and the products being removed. There are three areas of additional information: the Product Summary, an overview of the products being removed, their revision numbers, the results of the attempt, the type of removal being attempted and a summary of any errors or warnings — the Product Description, a more complete presentation of the product, its size, vendor name, dependencies and other important information — the Logfile, a scrollable view of the information that is written in the logfile.

These dialogs can be displayed from the either the Remove Analysis Dialog or from the Remove Dialog by choosing the appropriate button.

Details for removals using the -i and -r options can only be displayed for one host at a time.

Summarizing Details

The Product Summary describes the products to be removed and presents the effect of starting the removal on each product selected.

The Projected Action column describes what type of removal is being done. The possible types are:

Remove: The product exists and will be removed.
Filesets Not Found: The system did not find the filesets as specified.
Skipped: The product will not be removed.
Excluded: The product will not be removed because of some analysis phase errors. See the logfile for details about the error.

The Product Summary List is not an object-list; the products can not be opened and closed and actions can not be applied to the products. You cannot change the columns of the Product Summary List. To see more information about the products in the Product Summary, highlight an object in the list and select the Product Description button.

Seeing the swremove Logfile

The swremove Logfile Dialog behaves exactly as the Logfile Listing in swinstall.

The Remove Window

When the OK button choice is made in the Analysis Dialog, the Confirmation Dialog appears. The dialog explains that the remove phase will now be started on objects with a status of "Ready." To start the remove phase, press the Yes button on this dialog. (There are no "Final Remove Warnings").

The removal is then started on all objects with a status of "Ready" in the Remove Analysis Dialog. The Remove Analysis Dialog is replaced by the Remove Dialog.

The buttons are the same as those in the swinstall windows except there are no buttons for continuing, retrying unconfigure, aborting, or rebooting. See “Installing/Copying Software with the Graphical or Terminal User Interface ” for complete descriptions.

Monitoring the Removal Process

The columns available for the selected hosts in the Remove Dialog List are identical to those described in the swinstall Install Dialog. Unlike swinstall, however, you are not allowed to abort the removal UNLESS SD-UX suspends the task. Since removals can't suspend, the Abort and Resume buttons are not available.

When the remove phase is completed, a dialog is displayed to notify you of the completion. The only actions available at this point are:

displaying the logfile,
saving the session before exiting or starting with a new session,
starting a new session,
recalling a session, or
exiting.

The Product Summary Dialog reflects the results of the removal on each product selected.