 














             VAX DEC/Module Management System Installation Guide

             Order Number: AA-P121E-TE



             July 1990

             This document contains instructions for installing the VAX
             DEC/Module Management System (MMS) on the VMS operating
             system. It also explains how to read the online release notes
             before or after installing the product. This document applies
             to the VAX DEC/Module Management System Version 2.6.





             Revision/Update Information:  This revised manual supersedes
                                           the VAX DEC/Module Management
                                           System Installation Guide
                                           (Order Number AA-P121D-TE).

             Operating System and Version: VMS Version 5.2 or higher.
                                           Future maintenance releases may
                                           require higher versions.

             Software Version:             VAX DEC/Module Management
                                           System Version 2.6

             digital equipment corporation
             maynard, massachusetts

 

             ___________________________________________________
             First Printing, March 1983
             Revised, June 1984
             Revised, April 1987
             Revised, May 1989
             Revised, July 1990

             The information in this document is subject to change without
             notice and should not be construed as a commitment by Digital
             Equipment Corporation. Digital Equipment Corporation assumes
             no responsibility for any errors that may appear in this
             document.

             The software described in this document is furnished under a
             license and may be used or copied only in accordance with the
             terms of such license.

             No responsibility is assumed for the use or reliability
             of software on equipment that is not supplied by Digital
             Equipment Corporation or its affiliated companies.

             Restricted Rights: Use, duplication, or disclosure by the
             U.S. Government is subject to restrictions as set forth in
             subparagraph (c)(1)(ii)  of the Rights in Technical Data and
             Computer Software clause at DFARS 252.227-7013.

              Digital Equipment Corporation 1983, 1984, 1987, 1989, 1990.

             All Rights Reserved.
             Printed in U.S.A.

             The postpaid Reader's Comments forms at the end of this docu-
             ment request your critical evaluation to assist in preparing
             future documentation.

             The following are trademarks of Digital Equipment Corporation:

             CDA              MASSBUS          VAX RMS
             DDIF             PrintServer 40   VAXstation
             DEC              Q-bus            VMS
             DECnet           ReGIS            VT
             DECUS            ULTRIX           XUI
             DECwindows       UNIBUS
             DIGITAL          VAX
             LN03             VAXcluster       DIGITAL

                                                                    ZK5450

 















                                                                  Contents
          ________________________________________________________________

          Preface .........................................................  v
          Preparing to Install MMS...................................... 1
            Prerequisite Software....................................... 1
            Accessing the Online Release Notes........................   1
            Installation Procedure Requirements.......................   2
            User Account Quotas and Privileges........................   4
            VMS License Management Facility ...........................  5
            Using MMS with Other Tools ................................. 6
            Using VMSINSTAL.............................................. 6
          Installing MMS ................................................. 8
            Installing MMS on a VAXcluster............................. 14
          After the Installation........................................ 15
          Running the Installation Verification Procedure
            Separately....................................................  15
          Error Conditions............................................... 16
          Installing MMS as a Shared Image ............................ 17
          Maintenance Updates ........................................... 18
          Reporting Problems............................................. 18
          Sample Installation ........................................... 19









                                                                       iii

 














                                                                   Preface
          ________________________________________________________________



             This document describes how to install the VAX DEC/Module
             Management System MMS on the VMS operating system. It is
             intended for system managers. This document applies to MMS
             Version 2.6 and higher. The major version number is repre-
             sented by the digits to the left of the decimal point; the
             maintenance update version number is indicated by the digits
             to the right of the decimal point.

             Keep this document with your distribution kit. You will need
             it to install maintenance updates or to reinstall MMS for any
             other reason.

             At the back of this document are two Reader's Comments forms.
             If you have any comments about this document, please fill out
             one form and mail it; your comments will be considered for
             the next revision of the installation guide.

             For more information about installing MMS on VMS systems, see
             your processor-specific installation/operations guide.

             The installation procedure is described step-by-step and is,
             for the most part, self-explanatory. The system prompts you
             to answer questions and to change volumes, and waits for you
             to tell it to continue.

             Defaults appear in brackets ([])  throughout the installation
             procedure. Text you type is indicated in red.

                                                                         v

 





          ____________________________________________________________

          Preparing to Install MMS

             Your bill of materials (BOM) and indented bills report (BIL)
             specify the number and contents of your media. Be sure to
             check the contents of your kit against this information.
             If your kit is damaged or if you find that parts of it are
             missing, call your Digital representative.

             Distribution media must be mounted in numerical order. The
             installation procedure prompts you to mount the volumes. For
             more information on how to mount distribution media, see your
             processor-specific installation/operations guide, which also
             details several options to the installation procedure.

          ____________________________________________________________

          Prerequisite Software

             MMS requires VMS Version 5.2 or higher.

             For VMS Version 5.2 (or higher) systems, the following VMS
             classes are required for full functionality of MMS:

              o VMS Required Saveset

              o Utilities

              o Programming Support

             For more information on VMS classes and tailoring, see the
             VMS Operating System Software Product Description.

          ____________________________________________________________

          Accessing the Online Release Notes

             MMS provides online release notes. The prompt to display
             or print the release notes during the installation appears
             in step 5 of the installation procedure when you invoke
             VMSINSTAL with the OPTIONS N parameter.

                     VAX DEC/Module Management System Installation Guide 1

 






             To obtain the MMS Version 2.6 release notes after the in-
             stallation, type or print the file SYS$HELP:MMS$026.RELEASE_
             NOTES. (If you have installed prior versions of MMS, you can
             find the associated release notes up to and including Version
             2.5 in SYS$HELP:MMSvvu.RELEASE_NOTES, where vv is the major
             version number, and u is the update number. Note the omis-
             sion of the dollar sign ($).) Online help also directs you
             to the release notes file. After the installation, type the
             following command:

               $ HELP MMS RELEASE_NOTES <RETURN>

          ____________________________________________________________

          Installation Procedure Requirements

             The installation takes approximately 5 to 45 minutes, de-
             pending on the type of media and your system configuration.
             Before installing MMS, you must have the following privileges
             and resources:

              o SETPRV privileges, or CMKRNL and SYSPRV privileges

              o A minimum of 2300 blocks of free disk space during instal-
                lation; 800 blocks are used after installation

              o A minimum of 2 megabytes of physical memory

              o A minimum of 160 free global pages plus the size (in num-
                ber of disk blocks) of the file SYS$LIBRARY:DCLTABLES.EXE
                at installation.

              o A minimum of 3 free global sections at installation; 3
                global sections are used after installation

                                          NOTE

                 You must ensure that your system has the necessary
                 global page and global section SYSGEN quotas for the
                 installation. Failure to do so could cause the DCL
                 tables to be corrupted in some situations.

          2  VAX DEC/Module Management System Installation Guide

 






             To determine the number of available global pages on your
             system, invoke the VMS Install Utility by typing the follow-
             ing command:

               $ INSTALL LIST/GLOBAL/SUMMARY <RETURN>

                       Summary of Local Memory Global Sections

               nnn Global Sections Used,  nnnnn/nnnnn Global Pages Used/Unused

             When you issue this command, the system displays a summary
             of the number of global sections used, the number of global
             pages used, and the number of global pages unused. To exit
             from the VMS Install Utility, type the EXIT command.

             MMS requires approximately 160 global pages. If there are
             fewer than 160 pages available, you can delete an ex-
             isting known image with the VMS Install Utility. You can
             also increase the GBLPAGES system parameter with the VMS
             System Generation Utility (SYSGEN) by editing the file
             SYS$SYSTEM:MODPARAMS.DAT and then invoking the AUTOGEN com-
             mand procedure, SYS$UPDATE:AUTOGEN.COM. For more information
             on the AUTOGEN command procedure, see your processor-specific
             installation or operations guide.

             You can determine the number of available global sections by
             invoking SYSGEN as follows:

          $ RUN SYS$SYSTEM:SYSGEN <RETURN>
          SYSGEN> USE CURRENT <RETURN>
          SYSGEN> SHOW GBLSECTIONS <RETURN>
          Parameter Name             Current   Default   Minimum   Maximum Unit  Dynamic
          --------------             -------   -------   -------   ------- ----  -------
          GBLSECTIONS                    nnn       nnn        nn      nnnn Sections
          SYSGEN> EXIT <RETURN>

             The first number displayed is the current number of global
             sections. Compare this to the number of global sections in
             use as displayed by the VMS Install Utility. MMS requires 3
             global sections. Therefore, if the number of global sections
             used (displayed by INSTALL) plus 3 exceeds the current number

                     VAX DEC/Module Management System Installation Guide 3

 






             of global sections, you must increase the number of available
             global sections before you can install MMS. To increase the
             number, you must increase the GBLSECTIONS system parameter
             with SYSGEN by editing the file SYS$SYSTEM:MODPARAMS.DAT and
             then invoking the SYS$UPDATE:AUTOGEN.COM procedure. For more
             information on the AUTOGEN.COM procedure, see your processor-
             specific installation/operations guide.

             If the number of global sections used plus 3 is less than the
             current number of global sections, you can exit from SYSGEN
             and continue.

          ____________________________________________________________

          User Account Quotas and Privileges

             To use MMS, each account must have a minimum of TMPMBX privi-
             lege and have the following minimum requirements:

              o AST limit (ASTLM) 14 (minimum)

              o Buffered I/O byte count quota (BYTLM) 13000 (minimum)

              o Open file limit (FILLM) 6 (minimum)

              o Subprocess creation quota (PRCLM) 2 (minimum)

             Use the VMS Authorize Utility (AUTHORIZE) to compare the
             current values of these quotas with the requirements for MMS.
             For example, the account used in the following example is the
             SYSTEM account:

               $ SET DEFAULT SYS$SYSTEM <RETURN>
               $ RUN AUTHORIZE <RETURN>
               UAF> SHOW SYSTEM <RETURN>

             To change the values of these quotas, use the VMS Authorize
             Utility's MODIFY command. For more information, see the VMS
             Authorize Utility Manual.

          4  VAX DEC/Module Management System Installation Guide

 





          ____________________________________________________________

          VMS License Management Facility

             The VMS License Management Facility (LMF) is available with
             Version 5.0 (and higher) of the VMS operating system. Before
             you install MMS, you must register your MMS software li-
             cense, or an equivalent license, such as the VAXset software
             license.

             The license registration information you need is contained
             in the Product Authorization Key (PAK) that is shipped with
             MMS. The PAK is a paper certificate that contains information
             about the license.

             During the installation, you are asked if you have registered
             the MMS license and loaded the appropriate authorization
             key. You must register and load your license for MMS before
             you start the installation in order to run the Installation
             Verification Procedure (IVP) and use the software.

             To register a license under VMS V5.0 (or higher), first log
             in to the system manager's account, SYSTEM. You then have a
             choice of two ways to perform the registration:

              o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it
                prompts you for information, respond with data from your
                Product Authorization Key (PAK).

              o Issue the LICENSE REGISTER DCL command with the appro-
                priate qualifiers that correspond to information on the
                PAK.

             For complete information on using LMF, see the manual on the
             License Management Utility in the VMS documentation set.





                     VAX DEC/Module Management System Installation Guide 5

 





          ____________________________________________________________

          Using MMS with Other Tools

             MMS includes support for forms in VAX FMS libraries. If FMS
             is not installed on your system, the procedure will print the
             following message:

               %MMS-I-NOFMSSUPP, DEC/MMS will not contain support for VAX FMS.

             To use MMS to access forms stored in FMS libraries, you must
             have already installed FMS on your system. If you install or
             reinstall FMS after you have installed MMS, FMS support will
             not be available. You must reinstall MMS for FMS support.

          ____________________________________________________________

          Using VMSINSTAL

             After you log in to a privileged account to install MMS, set
             the default device to SYS$UPDATE: and then invoke VMSINSTAL,
             the command procedure that installs this product.

             VMSINSTAL has the following format:

               $ @SYS$UPDATE:VMSINSTAL MMS02n ddcu: [OPTIONS N]

             You can also type an asterisk (*) in place of MMS02n. If you
             are installing from magnetic tape, you can use the asterisk
             to save installation time; the asterisk causes MMS to be
             installed with a minimum of tape passes. Note that if there
             are multiple products on the same magnetic tape and you
             specify the asterisk, VMSINSTAL will install all the products
             on the tape.

             n
             Represents the maintenance update of MMS. Refer to the label
             on the MMS distribution kit, BIL, or BOM for the maintenance
             update number of your kit.

          6  VAX DEC/Module Management System Installation Guide

 






             ddcu:
             Represents a device name where the distribution volumes will
             be mounted, where dd is the device code, c is the controller
             code, and u is the unit number. It is not necessary to use
             the console drive to install MMS. If you do use the console
             drive, you should replace any media you removed from the
             drive. CSA1: is the device name used in examples in this
             document.

             OPTIONS N
             Is an optional parameter you should provide if you want to be
             prompted to display or print the release notes. If you do not
             include the OPTIONS N parameter, VMSINSTAL does not prompt
             you to display or print the release notes. VMSINSTAL permits
             the use of several other options. For more information on
             the other options, see your processor-specific installation
             /operations guide.

             If you do not supply the first two parameters, VMSINSTAL
             prompts you for the product and device names. If you wish to
             be prompted for the product and device names and to display
             or print the release notes, type the following:

               $ @SYS$UPDATE:VMSINSTAL OPTIONS N <RETURN>

             When you invoke VMSINSTAL, it checks the following:

              o Whether you are logged in to a privileged account. Digital
                recommends that you install software from the system
                manager's account with your default device and directory
                set to SYS$UPDATE.

              o Whether you have adequate quotas for installation.
                VMSINSTAL checks for the following quota values:

                 _ ASTLM = 24

                 _ BIOLM = 18

                 _ BYTLM = 18000

                 _ DIOLM = 18

                     VAX DEC/Module Management System Installation Guide 7

 






                 _ ENQLM = 30

                 _ FILLM = 20

                VMSINSTAL then checks whether the following conditions
                exist. If so, discontinue the conditions before resuming
                the installation procedure.

                 o Whether DECnet is up and running

                 o Whether any users are logged in to the system

                If VMSINSTAL detects either of these conditions, you will
                be asked whether you want to continue the installation. If
                you want to continue, type YES. If you want to stop the
                installation, press RETURN.

                You must register the information contained in the Product
                Authorization Key (PAK) that is shipped with MMS or
                VAXset by using either the VMS License command proce-
                dure (SYS$UPDATE:VMSLICENSE) or the LICENSE REGISTER and
                LICENSE LOAD commands, as described in the VMS License
                Management Utility Manual.

          ____________________________________________________________

          Installing MMS

             This section contains excerpts from the installation pro-
             cedure and explains each step. Defaults appear in brackets
             throughout the installation procedure.

             To abort the installation procedure at any time, press
             CTRL/Y. When you press CTRL/Y, the installation procedure
             deletes all files it has created up to that point and then
             returns you to DCL level. If you want to retry the installa-
             tion procedure after pressing CTRL/Y, you must proceed from
             step 2.

          8  VAX DEC/Module Management System Installation Guide

 






             Step 1: Log in to a privileged account and set your default
             device and directory to SYS$UPDATE.

          <RETURN>

               Username: SYSTEM  <RETURN>
               Password:         <RETURN>
               $ SET DEFAULT SYS$UPDATE <RETURN>

             Step 2: Invoke VMSINSTAL.

               $ @VMSINSTAL MMS026 CSA1: OPTIONS N <RETURN>

                     VAX/VMS Software Product Installation Procedure Vn.n

               It is dd-mmm-yyyy at hh:mm.
               Enter a question mark (?) at any time for help.

               * Are you satisfied with the backup of your system disk [YES]? <RETURN>

             If you are satisfied with the backup of your system disk,
             press RETURN. Otherwise, type NO and press RETURN to discon-
             tinue the installation.

             Step 3: Insert the first installation kit volume.

               Please mount the first volume of the set on CSA1:.
               * Are you ready? YES <RETURN>
               The following products will be processed:

                 VAX DEC/MMS V2.6

                   Beginning installation of VAX DEC/MMS V2.6 at hh:mm

               %VMSINSTAL-I-RESTORE, Restoring product saveset A...

             To indicate that you want to continue the installation, mount
             volume 1, type YES, and press RETURN.

                     VAX DEC/Module Management System Installation Guide 9

 






             Step 4: Insert the subsequent installation kit volumes.

               %BACKUP-I-READYREAD, mount volume 2 on _CSA1: for reading

               Enter "YES" when ready: YES<RETURN>

             VMSINSTAL prompts you to insert the next volume and waits for
             you to type YES after inserting it. If you type NO, VMSINSTAL
             displays the prompt again. This prompt is displayed only if
             your installation kit contains more than one volume.

             Step 5: Select a release notes option.

             This step applies only if you specified OPTIONS N in step 2.

               Release Notes Options:

                   1. Display release notes
                   2. Print release notes
                   3. Both 1 and 2
                   4. Copy release notes to SYS$HELP
                   5. Do not display, print or copy release notes

               * Select option [2]: <RETURN>

             If you select option 1, VMSINSTAL displays the release notes
             on line immediately. You can terminate the display at any
             time by pressing CTRL/C.

             If you select option 2, VMSINSTAL prompts you for a queue
             name. Either type a queue name or press RETURN to send the
             file to the default output printer.

               * Queue name [SYS$PRINT]: <RETURN>

             If you select option 3, VMSINSTAL displays the release notes
             on line immediately, and then prompts you for a queue name.
             Either type a queue name or press RETURN to send the file to
             the default output printer. The MMS release notes are then
             copied to SYS$HELP:MMS$026.RELEASE_NOTES.

          10  VAX DEC/Module Management System Installation Guide

 






             If you select option 4, VMSINSTAL copies the release notes to
             SYS$HELP immediately.

             If you select option 5, VMSINSTAL does not display or print
             the release notes, but copies them to SYS$HELP. Typically,
             you select this option to terminate the installation.

                                          NOTE

                 The release notes file installed by VMSINSTAL is la-
                 beled with the current product name, dollar sign, and
                 version number (for example, MMS$026). Take care not
                 to delete release notes for previous versions of MMS.

             Next, VMSINSTAL displays the following:

               * Do you want to continue the installation ? YES <RETURN>
               %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully
               moved to SYS$HELP.

             If you want to continue the installation, type YES and press
             RETURN. If you type NO or press RETURN, VMSINSTAL discon-
             tinues the installation. In either case, VMSINSTAL moves the
             release notes to SYS$HELP.

             Step 6: Respond to License Registration Queries.

             MMS supports the VMS License Management Facility (LMF). The
             installation procedure displays license information about
             your product and then asks if you have registered and loaded
             your authorization key for MMS. The following is an example
             of such information:

               Product:       MMS
               Producer:      DEC
               Version:       2.6
               Release Date:  DD-MMM-YYYY

               * Does this product have an authorization key registered and loaded?

                    VAX DEC/Module Management System Installation Guide 11

 






             You must register and load your product authorization key
             (PAK) to successfully complete the installation. If you have
             not done so, you must answer NO to this question. Register
             and load your PAK, and then restart the installation.

             Step 7: Select installation options.

               * Do you want to run the IVP after the installation [YES]? <RETURN>

             The Installation Verification Procedure (IVP) runs tests
             to check whether the installation procedure was successful.
             Press RETURN to run the IVP after the installation. If you do
             not want to run the IVP, type NO in response to the prompt.

               * Do you want to purge files replaced by this installation [YES]? <RETURN>

             The directories SYS$EXAMPLES, SYS$HELP, and SYS$SYSTEM may
             contain previous versions of MMS files. These files are
             replaced during the installation with new files, but the old
             files are not automatically purged. Purging is recommended.
             In response to the purging prompt, press RETURN to purge the
             files or type NO to keep them.

             Step 8: Read informational messages.

             The MMS installation procedure produces a number of informa-
             tional messages that report on the progress of the installa-
             tion.

               No further questions will be asked.  The DEC/MMS installation
               will now continue for approximately 5 to 45 minutes, depending
               on your type of media and your system configuration.

               %VMSINSTAL-I-RESTORE, Restoring product saveset B ...
               %MMS-I-NOFMSSUPP, DEC/MMS will not contain support for VAX FMS.
               %MMS-I-LINKIMAGE, Linking V2.6.

                                          NOTE

                 You see the previous message only if FMS is not in-
                 stalled on your system.

          12  VAX DEC/Module Management System Installation Guide

 






             The success of the installation is indicated by the following
             message:

          %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

             If the installation procedure is successful, the new or mod-
             ified files are moved to their target directories. In addi-
             tion, the SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE
             files are updated to include the new versions of MMS help
             text and the MMS command line definition.

             The following files are created or modified by the installa-
             tion procedure:

                SYS$HELP:HELPLIB.HLB
                SYS$HELP:MMS$026.RELEASE_NOTES
                SYS$LIBRARY:DCLTABLES.EXE
                SYS$SYSTEM:MMS.EXE
                SYS$TEST:MMS$IVP.COM
                [SYSHLP.EXAMPLES.MMS]MMS$DEFAULT_RULES.MMS
                [SYSHLP.EXAMPLES.MMS]MMS$DEFAULT_SHELL_RULES.MMS

             If you typed YES in response to the prompt that requests a
             file purge at step 7, previous versions of the MMS files are
             now purged.

             Step 9: Run the Installation Verification Procedure.

             If you chose to run the IVP in step 7, VMSINSTAL now calls
             the IVP to verify that MMS was installed successfully, and
             displays the following:

               %MMS-I-BEGINIVP, Beginning V2.6 IVP.
               %MMS-I-ENDIVP, V2.6 IVP SUCCESSFUL.





                    VAX DEC/Module Management System Installation Guide 13

 






             Step 10: End the installation procedure.

                  Installation of MMS V2.6 completed at hh:mm

                  VMSINSTAL procedure done at hh:mm

               $ LOGOUT <RETURN>
               SYSTEM     logged out at dd-mmm-yyyy hh:mm:ss.ss

             When the product installation procedure is complete, you
             can choose to install more products or to log out (as shown
             here.) If you removed any media from the console drive before
             beginning the installation, you should replace it now.

             VMSINSTAL deletes or changes entries in the process symbol
             tables during the installation. Therefore, if you are going
             to continue using the system manager's account and you want
             to restore these symbols, you should log out and log in
             again.

          ____________________________________________________________

          Installing MMS on a VAXcluster

             To run MMS on multiple nodes of a VAXcluster, first check
             to see that you have the appropriate software license. Then,
             follow these steps after installing MMS:

              1. Issue the LICENSE LOAD command to activate the license on
                each node in the VAXcluster on which MMS is to be executed
                as described in the VMS License Management Utility Manual.

              2. Issue the following command on each node in the VAXcluster
                on which MMS is to be executed:

                  $ CREATE/DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.MMS] <RETURN>



          14  VAX DEC/Module Management System Installation Guide

 






              3. To use the product on other nodes in the VAXcluster,
                you must replace the version of the DCL tables that is
                installed on the other VAXcluster nodes. To do this,
                perform the following steps:

                 a. Log in to a node on the cluster.

                 b. Enter the following command at the DCL prompt:

                     $ INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE <RETURN>

                 c. Repeat steps a and b for each node of the cluster.

          ____________________________________________________________

          After the Installation

             MMS is now installed and can be invoked with the MMS command.

             The installation procedure modifies the DCL command table so
             that the MMS command is recognized and processed. However,
             the previous command table is still in effect for those users
             who are currently logged in. All logged-in users who want
             to use the MMS command must log out of the system and log in
             again.

             If MMS will be used extensively on your system, you can
             reduce system overhead and memory requirements by installing
             it as a shared image using the VMS Install Utility. For
             more information, see the Installing MMS as a Shared Image
             section.

          ____________________________________________________________

          Running the Installation Verification Procedure Separately

             The Installation Verification Procedure (IVP) is usually run
             at installation. If you want to run the IVP separately to
             ensure the integrity of installed files if system problems
             occur, execute the following command procedure:

               $ @SYS$TEST:MMS$IVP <RETURN>

                    VAX DEC/Module Management System Installation Guide 15

 






             If you are installing MMS on a VAXcluster, you should run the
             IVP for each node on the cluster that is licensed to run MMS.

             If the IVP fails for any reason, the following messages are
             displayed:

               The VAX DEC/MMS V2.6 Installation Verification Procedure failed.

               %VMSINSTAL-E-IVPFAIL, The IVP for VAX DEC/MMS V2.6 has failed.

          ____________________________________________________________

          Error Conditions

             If the installation procedure fails for any reason, a message
             like the one following is displayed:

               %VMSINSTAL-E-INSFAIL, The installation of MMS V2.6 has failed.

             An error during the installation can occur if one or more of
             the following conditions exist:

              o Operating system version is incorrect.

              o Quotas necessary for successful installation are in-
                sufficient (see the Installation Procedure Requirements
                section).

              o Process quotas required by VMSINSTAL are incorrect (see
                the Using VMSINSTAL section).

              o The VMS HELP library is currently in use.

              o The product was registered incorrectly or not registered.

             For descriptions of the error messages generated by these
             conditions, see the VMS System Messages and Recovery
             Procedures Reference Volume, your processor-specific in-
             stallation/operations guide, or the VMS License Management
             Utility Manual.

          16  VAX DEC/Module Management System Installation Guide

 






             If you are notified that any of these conditions exist, you
             should take the appropriate action as described in the mes-
             sage. You may need to change a system parameter or increase
             an authorized quota value.

             If the installation fails, you must restart the installation
             procedure from step 2. If the installation fails due to an
             IVP failure, contact a Digital field service representative.

          ____________________________________________________________

          Installing MMS as a Shared Image

             If MMS will be used extensively on your system, you can
             reduce the system overhead and memory requirements by in-
             stalling it as a shared image. To perform the installation
             on a system that is currently running, use the VMS Install
             Utility while you are logged in to a privileged account.
             If errors occur, see the VMS System Messages and Recovery
             Procedures Reference Volume.

             First, determine the number of available global pages
             and global sections on your system. See the Installation
             Procedure Requirements section for information on how to do
             this.

             Then, invoke the VMS Install Utility and install MMS as a
             shared image by typing the following commands:

               $ INSTALL <RETURN>
               INSTALL> ADD SYS$SYSTEM:MMS.EXE/OPEN/SHARED <RETURN>
               INSTALL> EXIT <RETURN>

             Then, update the system startup file to install MMS.

             To ensure that MMS is installed as a shared image each time
             the system is bootstrapped, include the following lines
             in SYS$MANAGER:SYSTARTUP_V5.COM (the site-specific startup
             file):

                    VAX DEC/Module Management System Installation Guide 17

 






               $ INSTALL
               ADD SYS$SYSTEM:MMS.EXE/OPEN/SHARED
               EXIT

          ____________________________________________________________

          Maintenance Updates

             Digital may periodically issue maintenance updates of MMS.
             Each update consists of an installation kit. You should
             install this kit as described in this document or in any
             documentation that may accompany the maintenance update.

             Each time a maintenance update is released, the version
             number changes. For example, if the current version is 1.0,
             the version number of the first maintenance update will
             be 1.1. In addition, each maintenance update includes new
             release notes. The release notes describe the changes that
             have been made to MMS since the previous release.

             The update release notes are provided on line. You should
             read the release notes when you first install MMS; they are
             also accessible at any time after the product is installed.
             For information on reading the release notes at the time that
             you install MMS, follow the installation procedure through
             step 5. To locate the release notes after MMS is installed,
             display or print the file SYS$HELP:MMS$026.RELEASE_NOTES, or
             type the following command :

               $ HELP MMS RELEASE_NOTES <RETURN>

          ____________________________________________________________

          Reporting Problems

             If an error occurs while you are using MMS and you believe
             that the error is caused by a problem with MMS, take one of
             the following actions:

          18  VAX DEC/Module Management System Installation Guide

 






              o If you purchased MMS within the past 90 days and you think
                the problem is caused by a software error, you can submit
                a Software Performance Report (SPR).

              o If you have a Basic or DECsupport Software Agreement,
                you should call your Customer Support Center. With these
                services, you receive telephone support that provides
                high-level advisory and remedial assistance. For more
                information, contact your local Digital representative.

              o If you have a Self-Maintenance Software Agreement, you can
                submit a Software Performance Report (SPR).

             If you find an error in the MMS documentation, please fill
             out and submit a Reader's Comments form from the back of the
             document in which the error was found. Include the section
             and page number where the error was found.

          ____________________________________________________________

          Sample Installation

             This section contains a sample installation of MMS. Note that
             this is only a sample. Sometimes the installation procedure
             is modified in maintenance updates of this product. Because
             this installation guide is not usually revised for mainte-
             nance updates, be sure to read the Read Before Installing or
             Using VAX DEC/Module Management System cover letter before
             you install this product. This letter notes any significant
             changes in the installation that vary from this sample.

          Username: SYSTEM <RETURN>
          Password: <RETURN>
          $ SET DEFAULT SYS$UPDATE <RETURN>
          $ @VMSINSTAL MMS026 CSA1: OPTIONS N <RETURN>

           VAX/VMS Software Product Installation Procedure Vn.n
          It is 15-OCT-1990 at 09:53.
          Enter a question mark (?) at any time for help.

          * Are you satisfied with the backup of your system disk [YES]? YES <RETURN>

                    VAX DEC/Module Management System Installation Guide 19

 






          Please mount the first volume of the set on DUA0:.
          * Are you ready? YES <RETURN>
          %MOUNT-I-MOUNTED, MMS mounted on _DUA0:

          The following products will be processed:
            MMS V2.6
                  Beginning installation of MMS V2.6 at 09:54

          %VMSINSTAL-I-RESTORE, Restoring product saveset A ...

              Release Notes Options:

           1.  Display release notes
           2.  Print release notes
           3.  Both 1 and 2
           4.  Copy release notes to SYS$HELP
           5.  Do not display, print or copy release notes

          * Select option [2]: 4 <RETURN>
          * Do you want to continue the installation? YES <RETURN>
           %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved
           to SYS$HELP

            +------------------------------+
            | Installation of DEC/MMS V2.6 |
            +------------------------------+

           The installation can be aborted at any time by pressing CTRL/Y.

          Product:      MMS
          Producer:     DEC
          Version:      2.6
          Release Date: DD-MMM-YYYY
          * Does this product have an authorization key registered and loaded? YES <RETURN>

           This kit contains an Installation Verification Procedure (IVP)
           to verify the correct installation of DEC/MMS.  It can be run
           prior to the conclusion of this procedure by answering "YES" to
           the IVP prompt or invoked after the installation as follows:

            @SYS$TEST:MMS$IVP

          20  VAX DEC/Module Management System Installation Guide

 






          * Do you want to run the IVP after the installation [YES]? YES <RETURN>
          * Do you want to purge files replaced by this installation [YES]? YES <RETURN>

           No further questions will be asked.  The DEC/MMS installation
           will now continue for approximately 5 to 45 minutes, depending
           on your type of media and your system configuration.

          %VMSINSTAL-I-RESTORE, Restoring product saveset B ...
          %MMS-I-LINKIMAGE, Linking V2.6.
          %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.MMS].

              If you intend to execute this layered product on other nodes in your
              VAXcluster, and you have the appropriate software license, you must
              prepare the system-specific roots on the other nodes by issuing the
              following command on each node (using a suitably privileged account):

           $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.MMS]
          %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
          %MMS-I-BEGINIVP, Beginning V2.6 IVP.
          %MMS-I-ENDIVP, V2.6 IVP SUCCESSFUL.
           Installation of MMS V2.6 completed at 10:00

          Enter the products to be processed from the next distribution volume set.
          * Products: EXIT <RETURN>
           VMSINSTAL procedure done at 10:01
          $ LOGOUT <RETURN>
            SYSTEM       logged out at  15-OCT-1990 10:01:13.83












                    VAX DEC/Module Management System Installation Guide 21
