HP OpenVMS Systems Documentation
HP DECwindows Motif
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.
If you do not ensure that your system has the necessary number of global pages and global sections for the installation, the DCL tables can become corrupted.
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.
The DECwindows Motif installation and startup procedures automatically check for required system parameter values and pass the appropriate values to AUTOGEN. Therefore, in most cases you do not have to check and modify these values manually.
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 18.104.22.168 describes the
procedures for using the AUTOGEN utility to increase these values.
22.214.171.124 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 126.96.36.199, which describes the procedures for increasing these values using the AUTOGEN utility.
|Currently Running DECwindows Motif|
|Not Currently Running DECwindows Motif|
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.
188.8.131.52 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 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:
$ REPLY/ALL/BELL/SHUTDOWN "Log out for the installation of - _$ Compaq DECwindows Motif for OpenVMS Alpha, Version 1.3 please..."
$ 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:
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:
Refer to Section 1.4 for information about prerequisite software and licenses.
If you do not have a satisfactory backup copy of your system disk, do not attempt to install DECwindows Motif software. Back up the system disk (as described in the OpenVMS upgrade and installation supplement for your system) before you install DECwindows Motif software.
Before beginning the installation procedure, review Chapter 1 for information about installation preparations and requirements.
Refer to the following documents for information about tasks and PRODUCT commands and qualifiers:
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:
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.
$ DEFINE PCSI$SOURCE DKA400:[PCSI_ALPHA_DWMOTIF13] $ PRODUCT EXTRACT RELEASE_NOTES DWMOTIF
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.
The DECwindows Motif software installation includes patches to the server software that is included in the OpenVMS Alpha operating system. Once these patches are installed, you cannot uninstall them. Removing the DECwindows Motif software using the PRODUCT REMOVE command does not remove the patches. The only method to restore your system to its former state is to reinstall the OpenVMS Alpha operating system. See Section 184.108.40.206 for more information.
The sections that follow take you through the stages of installing your DECwindows Motif software using the POLYCENTER Software Installation utility.
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
If you want to see the help text shown in this chapter, use the /HELP qualifier with the PRODUCT INSTALL command.
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.