Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
Software Distributor Administration Guide: HP-UX 11i v1, 11i v2, and 11i v3 > Chapter 7 Remote Operations Overview

Remote Operations Tutorial


Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

This tutorial introduces you to the remote operations user interface and to the general flow for distributing software to other systems. Also, you will learn how to preview, schedule, and monitor your distribution jobs. Although this tutorial uses swinstall for the example GUI, the swcopy and swremove GUI programs are almost identical. You can apply the knowledge you gain from this tutorial to those tasks.

You may wish to go through this tutorial more than once to experiment with variations in the basic operations.

Tutorial Set-Up

  1. Set up remote operations on your controller system and a remote test system. (See “Setting Up Remote Operations”.)

  2. As root on the controller system, enable the remote operations GUI:

    touch /var/adm/sw/.sdkey

  3. Make sure your PATH variable contains /usr/sbin. To check, enter:

    echo $PATH

  4. Make sure your DISPLAY variable is properly set by typing:

    echo $DISPLAY

  5. Ensure that the examples are installed. Enter:


  6. Create the depot containing example package (i.e., SD-DATABASE):

    cd /usr/lib/sw/examples/swpackage/depot_src

    swpackage -s psf @ /var/adm/sw/examples/depot

    swreg -l depot @ /var/adm/sw/examples/depot

  7. To verify that the software is in the depot and is available for distribution to targets, enter:

    swlist -s /var/adm/sw/examples/depot

    You should see SD-DATABASE in the resulting list.

How to Perform a Single-Target Installation


The tutorial consists of these steps:

Table 7-2 Installation Steps

Overview of Installation Steps

I. Start-up

Start the Job Browser.

II. Select Targets

Specify the targets where you want the software installed. You can use the default local target or specify another target.

III. Select Source

Provide the location of the software depot from which the software will be installed with the Specify Source dialog.

IV. Select Software

Use the Software Selection Window to select the software to install.

V. Specify Install Preferences

Use the Install Preferences dialog box to set preview or scheduling options.

VI. Analysis and Installation

Perform the actual software installation or preview.

VII. Monitor ResultsMonitor job progress and results using the Job Browser GUI.

VIII. Remove Jobs

Delete the completed jobs using the Job Browser.


Step I: Start-up

To initiate an install session:

  1. Start the Job Browser by typing:


  2. From the Job Browser window, choose

    ActionsCreate JobInstall Software...

    The message “Invoking a swinstall process” displays at the bottom of the window, then the Target Selection Window appears.

Step II: Select Targets

The Target Selection Window displays the local, default target. A target is where you want the installation to go (in the example below, the target is the system swbash3). By default, the current system is listed (Figure 7-3: “Target Selection Window”,).

Figure 7-3 Target Selection Window

Target Selection Window

Specify the desired target for the installation:

  1. For local default:

    1. Highlight the local target system with a left mouse click. Then select Actions→Mark for Install (or right-click to display the pop-up menu and select Mark for Install).

    2. Select Actions→Show Software for Selection...

    This displays the Specify Source dialog. If this is your first time through this tutorial, skip directly to “Step III: Select Source”. After you have gone through this tutorial once, retry Step I using remote targets.

    — or

    For remote targets: choose Actions→Add Targets to install to a different target. This takes you to the Add Targets dialog (Figure 7-4: “Add Target Dialog (for multiple or non default targets)”,).

  2. Enter the target name in the Hostname: area (e.g., system_two) and select Add. This takes you to the Select Target Path dialog.

    Figure 7-4 Add Target Dialog (for multiple or non default targets)

    Add Target Dialog (for multiple or non default targets)
  3. Use the current root path (/) by selecting OK. This returns you to the Add Targets dialog.

  4. Select OK in the Add Targets dialog. This updates the Target Selection Window with your target selection. Yes appears in the Marked column, indicating that the target is marked for installation.

  5. Choose ActionsShow Software for Selection. The Specify Source dialog appears.

Step III: Select Source

In this step, the Specify Source dialog lets you select the Source Host Name (the source system where the depot resides) and Source Depot Path (path of the depot containing the software).

Figure 7-5 Specify Source Dialog

Specify Source Dialog
  1. The Specify Source dialog should list your controller name or your remote test system name in the Source Host Name... field and the example depot that you created (/var/adm/sw/examples/depot) in the Source Depot Path... field.

    From this dialog, you can also:

    • Click on the Source Host Name... button to display a list of hosts that you can select from.

    • Click on the Source Depot Path... to display a list of registered depots that you can select from.

    Click OK. The Software Selection Window appears (Figure 7-6: “Software Selection Window”,). This window displays all available software in the depot that you selected.

Step IV: Select Software

Use the Software Selection Window to select the software you want to install.

Figure 7-6 Software Selection Window

Software Selection Window
  1. Highlight SD-DATABASE (i.e., the example software) by clicking on it with the left mouse button.

  2. Choose ActionsMark for Install (or right-click to display the pop-up menu and select Mark for Install).

    The Marked? column is set to Yes for SD-DATABASE.

    Table 7-3 Software Selection List

    Software Selection Window Object List

    The Software Selection Window object list is hierarchical: you can open each object in the list and show objects contained inside. Objects in the list that contain other objects that can be opened, have an arrow () after the name.

    For example:

    • To see the subproducts in the product SD-DATABASE, double click on it. The object list displays the subproducts. To open a subproduct, double click on the name. (Or highlight the name and then select ActionsOpen Item.)

    • To close an object and return to the previous list, double click on the first item in the list (..(go up)) or highlight the item and selecting ActionsClose Level.

      Note that products are listed together, but subproducts and filesets may appear in the same list when you open a product.


  3. Choose ActionsInstall. This displays the Install Preferences dialog (Figure 7-7: “Install Preferences Dialog”,).

Step V: Specify Install Preferences

The Install Preferences dialog box gives you the following optional selections: Preview, Schedule, and OK.You can also enter a Job Title.

Figure 7-7 Install Preferences Dialog

Install Preferences Dialog
  1. Select the text area after Job Title and type:


    This is the name of your install job.

  2. Select OK to install the software now.

    For single-target installations such as this tutorial, the Install Analysis dialog appears (Figure 7-8).

  3. If this is your first pass through the tutorial, proceed to Step V.

  4. (Optional) Previewing a Job

    1. Select the Preview button. This tells SD to analyze the software without installing it.

    2. Click OK. The Install Analysis dialog appears. This dialog lets you monitor the analysis of a single-target job. You can also browse log files and product summary information.

    3. When the target Status indicates Ready (analysis is successful), select OK. This returns you to the Software Selection Window.

    4. Select ActionsInstall. The Install Preferences dialog appears.

    5. Proceed with the installation by selecting OK in the Install Preferences dialog.

      (If you repeat this tutorial and choose to preview a job that uses multiple targets, you will find that the Install Analysis dialog does not appear. You can only preview job progress from the Job Browser. See “Step VII: Monitor Results ” for more information.)

  5. (Optional) Scheduling a Job

    1. Select the Schedule button. This activates the fields that let you specify the time and date you at which you want your job to run. (For example, you may want to schedule a job at midnight when few users are logged in.)

    2. After you specify the schedule information, click OK. The system displays a note indicating that the job has been scheduled.

    3. Click OK in the dialog. The Target Selection Window reappears. Select File→Exit to return to the Job Browser, from which you can monitor your scheduled job.

Step VI: Analysis and Installation

SD-UX analyzes the target before performing the actual install, copy, or remove operation. (If you set up a preview job in Step IV, the install stops after the analysis.)

Figure 7-8 Install Analysis Dialog

Install Analysis Dialog
  1. When the Analysis is complete, the status for the target you selected should show Ready, indicating no errors or warnings occurred during analysis. Select OK to proceed with the installation.

    The Install Window dialog (Figure 7-9: “Install Window dialog”,) appears, and the installation starts automatically. When the status in the dialog changes to Completed, the installation has successfully completed.

    Figure 7-9 Install Window dialog

    Install Window dialog
  2. Select Done to exit the Install Window dialog. This returns you to the Target Selection Window.

  3. Select File→ Exit to return to the Job Browser.

  4. (Optional) Select another target for installation (i.e., Actions→Mark for Install).

Step VII: Monitor Results

When you exit the Target Selection Window, you return to the Job Browser. The icons in the job list change to show the status of jobs. Different icons indicate different job status. (See “Job Browser Icons” for sample icons.)

Your job, labeled SDTESTJOB, should show with either a check mark or a ruler icon. To verify status information for SDTESTJOB from the job list:

  • Double click SDTESTJOB to invoke the Job Results dialog.

  • Double click the target to show the detailed target log.

  • Click OK to close each dialog after you have viewed it.


  1. Select the SDTESTJOB icon.

  2. Choose ActionsShow Job Description.... The Job Description dialog appears. This displays all of the job attributes, the software and the target(s) involved.

  3. (Optional) Select Show Options... to see what the job option settings.

  4. (Optional) Select Show Results... to see the latest job status.

Step VIII: Remove Jobs

After you have run the tutorial, use the Job Browser to remove the example jobs:

  1. Click on the SDTESTJOB icon.

  2. Select ActionsRemove Job.... The Remove a Job dialog box appears.

  3. Select OK.

— or

  1. Select the job icon and right click.

  2. Select ActionsRemove Job... from the pop-up menu. The Remove a Job dialog appears, displaying SDTESTJOB.

  3. Select OK. The SDTESTJOB icon disappears from the Job Browser and the job is removed from the SD-UX database.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1997, 2000-2003, 2006, 2007, 2008 Hewlett-Packard Development Company, L.P.