HP OpenVMS Systems Documentation

Table 1-5 lists the minimum required system parameter values for the installation. Depending on the kinds of programs and applications running at your site, you might need higher values for some settings.

This section explains how to use the System Generation utility (SYSGEN) and the AUTOGEN utility to prepare your system for the DECwindows Motif installation. The AUTOGEN utility uses system configuration data to automatically set system parameters.

To check the values of your system parameters, invoke the SYSGEN utility by entering the following command at the DCL prompt:

$ RUN SYS$SYSTEM:SYSGEN
SYSGEN>

At the SYSGEN prompt, enter the SHOW command to display the value of a system parameter. The following command displays the value for the MAXBUF system parameter:

SYSGEN> SHOW MAXBUF

After checking the parameters with the SHOW command, enter the EXIT command at the SYSGEN prompt to return to DCL level.

If the current values are less than the values in Table 1-5, increase the system parameter settings. Section 1.7.4.4 describes the procedures for using the AUTOGEN utility to increase these values.

1.7.4.2 Calculating the Number of Free Global Pages and Global Sections

If your system parameter values are equal to or greater than the minimum values specified in Table 1-5, you can continue with the product installation. However, to install and run DECwindows Motif software, you must have sufficient free global pages and global sections for the DECwindows Motif software and the file SYS$LIBRARY:DCLTABLES.EXE.

First, determine how many free global pages and global sections exist on your system and how many are required to reinstall a new version of SYS$LIBRARY:DCLTABLES.EXE. Then, if necessary, use the AUTOGEN utility to increase the values of the GBLPAGES and GBLSECTIONS system parameters.

Enter the following DCL command to determine the number of global pages required for SYS$LIBRARY:DCLTABLES.EXE:

$ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE

This command returns the size (in blocks) of the file SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pages needed for the file.

Enter the WRITE command with the F$GETSYI lexical function to find the number of contiguous free global pages and the number of free global sections. The following example shows how to obtain this information at your terminal, which is the default for SYS$OUTPUT:

$ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") [Return]
15848
$ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") [Return]
24

See Table 1-6 to determine whether the number of contiguous free global pages and the number of free global sections is sufficient. If these values are not sufficient to continue with the installation, then see Section 1.7.4.4, which describes the procedures for increasing these values using the AUTOGEN utility.

In order for DECwindows Motif to run with acceptable performance, the page file must be large enough to handle the virtual memory requirements of your system. The optimal size of the page file depends on many factors, such as the amount of physical memory on the system and the application work load.

As a general rule, the page file size should be at least 75,000 blocks. However, this size may be too small on systems where a large number of applications are run. On a heavily loaded system it may be possible to achieve large performance improvements by increasing the size of the page file by a factor of two or more.

Normally, you should run AUTOGEN with feedback and let AUTOGEN calculate the size of the page file based on the usage pattern on your system. To run AUTOGEN with feedback, enter the following DCL command:

$ @SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT FEEDBACK

You can also increase the size of the page file by running the SYSGEN utility or by invoking the command procedure SYS$UPDATE:SWAPFILES.COM.

For more information about setting the size of the page file and running AUTOGEN, see the section about the AUTOGEN utility in the OpenVMS System Manager's Manual and the AUTOGEN section in OpenVMS System Management Utilities Reference Manual. For more information about performance tuning in general, see the OpenVMS Performance Management manual.

1.7.4.4 Changing System Parameter Values Using the AUTOGEN Utility

Use the AUTOGEN utility to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually. To change system parameters with AUTOGEN, edit the file SYS$SYSTEM:MODPARAMS.DAT.

To change a parameter value listed in this file, delete the current value associated with that parameter and enter the new value.

To add a new parameter, add a line to the file and include both the name of the parameter and its value. For example:

MIN_MAXBUF = 8192

To make incremental adjustments to parameters, such as global pages and global sections, prefix the parameter name with ADD_. The following example increases the global pages value by 30,000:

ADD_GBLPAGES = 30000

Table 1-7 lists the system parameters that you need to adjust incrementally.

After you enter all your changes, exit from the file and execute the AUTOGEN utility to recalculate your system parameters. Enter the following command to recalculate your system parameters and reboot the system:

$ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

When you specify REBOOT, the AUTOGEN utility performs an automatic system shutdown and then reboots the system. Any users logged in to the system are immediately disconnected during the shutdown. The automatic reboot puts the new parameter values into effect.

For details about using AUTOGEN, see the section about the AUTOGEN utility in the OpenVMS System Manager's Manual and the AUTOGEN section in OpenVMS System Management Utilities Reference Manual.

1.7.5 Backing Up Your System Disk

HP recommends that you back up your system disk before you install any software. At the beginning of the installation, the installation procedure asks whether your system disk is backed up. Use the backup procedures that are established at your site. For details about performing a system disk backup, see the section on the Backup utility in the OpenVMS System Management Utilities Reference Manual.

1.7.6 Notifying Other Users

Inform users on the system that you plan to install a product and that they must log out during the installation. To make sure that you are the only user logged in to the system, follow these steps:

1. Notify current users to log out. Enter the following command at the DCL prompt:

   $ REPLY/ALL/BELL/SHUTDOWN "Log out for the installation of - _$ Compaq DECwindows Motif for OpenVMS Alpha, Version 1.3 please..."

2. Enter the following command at the DCL prompt to prevent nonprivileged users from logging in to the system:

   $ SET LOGINS/INTERACTIVE=0

If possible, give users an estimated time when they can log in to the system again.

This chapter describes how to install and configure DECwindows Motif software using the POLYCENTER Software Installation (PCSI) utility. The DECwindows Motif product supports POLYCENTER Software installations using the Digital Command Language (DCL) interface.

This chapter presents information about the following topics:

• Section 2.1, Accessing Help Information
• Section 2.2, Extracting and Printing the Product Release Notes
• Section 2.3, Installing the DECwindows Motif Software
• Section 2.4, Recovering from Errors

For HP DECwindows Motif for HP OpenVMS Alpha Version 1.3, the DECwindows X11 Display Server installs a patch kit that provides the necessary, updated server images to the OpenVMS Alpha Version 7.3-1 software. This installation is an integral part of the PCSI installation of Version 1.3. The server and client software will be installed in the proper order.

Refer to the OpenVMS System Manager's Manual for complete details about installing and managing software products on your system. In addition to getting started information, the OpenVMS System Manager's Manual also provides information about several useful topics, such as:

• Removing installed products
• Reconfiguring installed products
• Copying software kits to new locations
• Retrieving product information

Refer to Section 1.4 for information about prerequisite software and licenses.

Online help is available with the installation utility for all PRODUCT commands and qualifiers. For help on a specific command, enter the DCL command HELP followed by the command and product name.

Refer to the following documents for information about tasks and PRODUCT commands and qualifiers:

• OpenVMS System Manager's Manual
• OpenVMS System Management Utilities Reference Manual
• OpenVMS DCL Dictionary

Refer to the OpenVMS System Manager's Manual for complete information about responding to questions that the POLYCENTER Software Installation utility asks during product installation. For example, when you respond to questions, you can do the following:

• Enter a value and press the Return key to select options.
• Press the Return key to accept default values.
• Confirm your responses.
  After you respond to questions by selecting options or accepting default values, the installation utility displays a summary of your answers.
  Then a question is displayed asking whether you are satisfied with your answers and whether you want to continue with the installation. If you decide to change your responses, type No and press the Return key. You can then either reenter your responses or answer No and exit from the installation utility.
• Stop the installation by pressing Ctrl/Y. (Note that this option is not recommended.)

Before you begin the installation procedure, you should read the product's release notes. To extract a copy of the HP DECwindows Motif for HP OpenVMS Alpha Release Notes, define PCSI$SOURCE to point to the location (device name and directory) of the PCSI kit. Then enter the PRODUCT EXTRACT RELEASE_NOTES command followed by the product name, DWMOTIF, at the DCL prompt.

For example:

$ DEFINE PCSI$SOURCE DKA400:[PCSI_ALPHA_DWMOTIF13]
$ PRODUCT EXTRACT RELEASE_NOTES DWMOTIF

Once you extract the release notes to a file, you can print the file. Note that you do not need to install the product before you extract the release notes.

The HP DECwindows Motif for HP OpenVMS Alpha Release Notes are also available in HTML and ASCII (.TXT) formats in the documentation directory on the DECwindows Motif CD-ROM. Refer to the Guide to the HP DECwindows Motif for HP OpenVMS Alpha CD--ROM for information about accessing the release notes and other DECwindows Motif documentation.

2.3 Installing the DECwindows Motif Software

The sections that follow take you through the stages of installing your DECwindows Motif software using the POLYCENTER Software Installation utility.

Refer to Chapter 1 for information about account quotas, disk space, and system parameters.

2.3.1 Starting the Installation

To start the POLYCENTER Software Installation utility, enter the following command at the DCL prompt:

$ DEFINE PCSI$SOURCE device:[PCSI_ALPHA_DWMOTIF13]

where device is the name of the device on which the distribution CD-ROM is mounted or on which the installation kit is located.

Next, invoke the POLYCENTER Software Installation utility:

$ PRODUCT INSTALL DWMOTIF

The installation dialog begins by displaying the name of the product which PCSI is installing. You are then asked to verify that you want to continue with the installation. The dialog continues with a display of product name, copyright, and Product Authorization Key (PAK) information.

The following product has been selected:
    DEC AXPVMS DWMOTIF V1.3-0              Layered Product

Do you want to continue? [YES]

Configuration phase starting ...

You will be asked to choose options, if any, for each selected product and for
any products that may be installed to satisfy software dependency requirements.

DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif


    Compaq DECwindows Motif for OpenVMS Alpha, Version 1.3 is based on Version 11
    Release 6.6 of the X Window System (X11R6.6) and OSF/Motif Version 1.2.3.

    DECwindows Motif V1.3-0 provides both runtime and development support for
    the X Window System. Runtime and development support is provided for X11
    Release 6.6 (X11R6.6) and OSF/Motif Version 1.2.3. For OSF/Motif Version 1.1.3,
    only runtime support is provided.


    Copyright 2003 Compaq Information Technologies Group, L.P.

    Compaq and the Compaq logo are trademarks of Compaq Information
    Technologies Group, L.P. in the U.S. and/or other countries.
    Motif is a registered trademark and The Open Group is a trademark
    of The Open Group in the United States and/or other countries.

    Confidential computer software. Valid license from Compaq or
    authorized sublicensor required for possession, use, or copying.
    Consistent with FAR 12.211 and 12.212, Commercial Computer Software,
    Computer Software Documentation, and Technical Data for Commercial
    Items are licensed to the U.S. Government under vendor's standard
    commercial license.


    Compaq Computer Corporation

    This software product is sold by Compaq Computer Corporation

    This product uses the PAK: DW-MOTIF

    This software is furnished under the licensing provisions of Compaq
    Computer Corporation's Standard Terms and Conditions. For more in-
    formation about Compaq's licensing terms and policies, contact your
    local Compaq office.