Installing/Copying Software with the Graphical or Terminal User Interface

If you click on the Source Host Name button in the Specify Source Dialog, the system will display a box with all the hosts that are in your defaults.hosts file ($HOME/.sw/defaults.hosts or /var/adm/sw/defaults.hosts). You can highlight (choose) one of the hosts and press OK and it will appear in the appropriate box in the Specify Source Dialog. You can also manually enter a source host name in the text box next to the Source Host Name button if the source you want does not appear in the dialog.

Here is a sample $HOME/.sw/defaults.hosts file:

swinstall.hosts = {hostA hostB hostC}
swinstall.hosts_with_depots = {host-depotA host-depotB}
 
swcopy.hosts_with_depots = {SourceA SourceB}
 
swremove.hosts = {SourceX SourceY SourceZ}
swremove.hosts_with_depots = {Source1 Source2 Source3}

Multiple host names must be separated by a space. You must edit this file manually to add or delete hosts and depots. If your list of hosts will fit on one line, you do not need to delimit the list with brackets ({}).

If there are no hosts specified in the defaults.hosts file, only the local host and default depot path appear in the object lists.

Clicking on the Source Depot Path button will bring up a list of registered depots on the source host. You can highlight one of the depots and press OK and it will appear in the Specify Source Dialog. You can also manually enter a depot path in the text box next to the button.

Selecting depots for copying involves a source host and target depot path pair. For example, on the command line, depots are specified with the [host][:][/depot_path] syntax. The same is true in the GUI/TUI.

If a target depot specified does not exist, the system creates a new depot.

The Menubar for the Software Selection Window has five activities: File, View, Options, Actions, and Help.

Each of these choices provide additional pulldown menus for more activities. Placing your mouse cursor on the appropriate Menu choice and clicking the left mouse button causes additional menus to appear.

Each invocation of a command is considered a session. When you invoke a command, it automatically saves the current command options, source information, software selections and host designation before the task actually starts. The File Menu, which is common to all GUI windows, manages these session files.

A session file, which is used in the -C or -S session file option described in “Syntax”, can be recalled and re-executed if you often use the same functionality. All selections are always saved in $HOME/.sw/sessions/<swcommand>.last file just before starting the actual installation.

At the end of each session the system will overwrite the previous session file. If you want to save a session file for use later, you must rename that session file.

Here is an example of a session file:

# swinstall session file
#
# Filename      /users/fred/.sw/sessions/swinstall.last
# Date saved    05/26/93 15:59:41 MDT
 
swinstall.allow_downdate = true
swinstall.allow_incompatible = false
swinstall.allow_multiple_versions = false
swinstall.autoreboot = false
swinstall.autorecover_product = false
swinstall.compress_files = false
swinstall.create_target_path = true
.
.

The session file uses the same syntax as the defaults files (command.option=value). Session file values are, in turn, overridden by the corresponding command line options, if they are specified. See “Advanced Topics for swinstall and swcopy ” for more information on defaults.

For a description of each menu choice in the Menubar, click on a specific menu choice or use the arrow keys to highlight a particular menu choice and press the [f1] key on your keyboard. This brings up a Help Screen that provides additional information on that menu choice.

The Graphical and Terminal User Interfaces can be modified to fit your individual display requirements or view preferences. The View menu manages these view preferences by providing a Columns Editor to customize the window by changing the names and arrangement of the items in the Object List. The Columns Editor is accessed through the View->Columns... menu choice. Changes you make can also be saved (View->Save View as Default) and are treated as the default the next time you invoke the command.

You can change your Software View (in the Software Selection Window) with the Change Software View menu choice or the Change Software Filter button. You can specify Bundle, Product or Bundle Category views (that is, which level of the software object hierarchy you want to display at the topmost level). You can also sort your list of selections in a variety of different ways. Sorting is specified in a separate Sort Dialog.

The Options menu lets you change the default options file that controls command behaviors and policies. This is the same as editing the defaults options file /var/adm/sw/defaults or $HOME/.swdefaults. For a complete description of the Options Editor and how to change options with this dialog, see the section “Advanced Topics for swinstall and swcopy ”.

When you have specified the host, source and depot (or shared_root), you are ready to select software to install or copy. Software is selected from the Object List by highlighting items and then invoking the Mark For Install (or Copy) menu choice. In the TUI, you can also use the m and u keys to mark and unmark highlighted objects.

The Marked? flag in the Object List is automatically updated to Yes to reflect the selection. An additional flag - Partial - is provided to show that only some component of the software selection has been selected for the install.

Figure 2-2 Software Selection Window

	NOTE: Only one version of a product can be selected during a single installation session.

Once software is selected, the system then provides some additional capabilities (via the Actions menu choice):

Also in the Actions menu:

The Software Selection Window Object List is a hierarchical object list. That is, each object in the list may be opened to show its contents. For example, to see the subproducts in a particular product, you can open that product by double clicking on the object with your mouse. In the TUI, move the cursor to the item you want to open and press Return. The Object List then shows a listing of the subproducts for that product. If you want to open the subproduct, double click on it and its filesets are displayed. Objects that have an arrow (->) after the name can be opened to reveal other items.

To close an object and return to the previous list, double click on the first item in the list (. .(go up)). In the TUI, you must use Close Level in the Actions menu or press Return while highlighting the (. .(go up)) item.

When the product is opened, all of its subproducts (and filesets that are not part of a subproduct) are shown in the list. At the product level, only products are listed together. If the software_view is Bundle and the bundle is opened, all HP-UX OS products that are wholly or partially contained in the bundle will be shown. When one of the products is opened, only subproducts and filesets in the open product and open bundle are shown.

The first line of the Message Area is used to show which source has been chosen. The second line of the Message Area displays where the software will be installed or copied using the [host][:][/depot] syntax. These lines can be modified with the Change Source menu choice under the Actions menu. If an error occurs when the source is read, the Change Source Dialog is automatically displayed for input.

The Object List shows the software's attributes (Name, Revision, Information, Size (Kb), Architecture and Category). The Show Software Description menu choice also provides more information.

Choosing Install analysis... (or Copy - analysis) in the menu moves you to the next phase of the process by opening the Install (or Copy) Analysis Dialog. If software selections or host selections have not been made, an error box gives instructions on what items still need to be selected before the Analysis Dialog appears. The Software Selection Window remains open so you can examine your selections at any time. Canceling the Analysis will also return you this window to change selections.

The Status column in the Analysis Dialog shows the progress and the results of the Analysis Phase. The possible values for the Status are: Analyzing Targets, Analyzing Software, Finishing Analysis and Ready.

When the Analysis is done, the status for any host will either be Ready or Excluded from task. If any of the selected software can be installed onto the host, the status will be Ready. If none of the selected software can be installed onto the host, status will be Excluded from task.

Here is a summary of the status results:

The Products Ready column shows the number of products ready for installation or copy out of all products selected. These include:

See the section “Advanced Topics for swinstall and swcopy ” for more information regarding dependencies.

Only Ready products are shown. Bundles may also be ready. If they are, their products are reflected in the product contents and list.

A product may be automatically excluded from the task if an error occurs with the product. The host is automatically excluded from the task only if ALL products and bundles have been excluded.

The Product Summary button in the Analysis Dialog gives additional information regarding the product (or bundle) and provides a Product Description button that displays information about dependencies, copyright, vendor, etc.

The Logfile button presents a scrollable view of the information that is written in the logfile.

The Disk Space button shows the file system mount point, how much disk space was available before the installation, how much will be available after the operation, and what percent of the disk's capacity will be used. It also shows how much space must be freed to complete the operation.

Figure 2-4 Disk Space Analysis Dialog

When you press the Product Summary button in the Analysis Dialog another dialog appears that gives you additional information about the product and the operation. The Projected Actions column describes what type of installation or copy is being done. All actions are listed if more than one applies. For example, a product may be a New Install (Copy) and an Update (some filesets are new, some are an update). The possible types are:

If a global error occurs, e.g., a disk space error occurs or file systems can't be mounted, all products would be excluded. After the installation the Result will show:

After a copy has completed, the Copy Summary also displays the state of the product - AVAILABLE or CORRUPT. The AVAILABLE state is the most common.

The Summary column shows any warnings or errors that occurred.

The Logfile contains detailed information about the installation or copy process. If the current host is still in Analysis Phase, the logfile is updated periodically with the in-coming results. Pressing the Logfile button in the Analysis Dialog displays the Logfile.

Moving the scrollbar at the right side of the Logfile Dialog controls scrolling. By default, when the Logfile Dialog is first opened, Automatic scrolling is toggled on and the text of the logfile continually scrolls up as new information is added. The old information scrolls off the top of the list while the new information is added to the bottom of the list. You may turn automatic scrolling off by clicking on the Automatic scrolling button or by moving the scrollbar),

When automatic scrolling is turned off, the new information is still added to the bottom of the list but the list itself does not scroll. In this way, you can move to a particular place in the logfile and not be bothered by the automatic scrolling.

	NOTE: A source depot audit log also exists. See “Using the Source Depot Audit Log ” for more information.

The Disk Space button in the Analysis Dialog brings up a Disk Space Analysis Window that displays the status of the file systems on your disk. It shows the file system, the amount of space available on the disk BEFORE you attempted to load the software, how much room will be available AFTER the installation is completed, the capacity remaining, and how much free disk space is required (if any).

Opening the software (via the Open Item menu choice in the Actions menu) and double clicking on one of the filesets in the software will tell you the projected size of fileset on this file system and what the change will be in + or - Kbytes.

The Status row displays the progress and the results of the phase. The possible Status attributes and their meanings are:

The Object List displays other install status attributes:

If the Install (Copy) Phase is suspended on a host, a warning dialog is displayed to notify you that the install has been suspended.

When the Install (Copy) Phase completes on the host, a dialog is displayed to notify you that the task is completed. At this point, you may: