 






          DIGITAL


          Cover Letter/Installation Instructions for DECram for VMS
          Version 1.0

          AV-PFM3A-TE

          Digital is pleased to provide the DECram for VMS Version 1.0
          product to our customers. DECram for VMS is a disk device that
          allows a VMS system manager to create pseudo disks (RAMdisks)
          that reside in VAX main memory for the purpose of improving I/O
          performance.

          The DECram for VMS Version 1.0 product is distributed on TK50,
          magtape, and CDROM. The media also contains the DECram for 
          VMS User's Manual Version 1.0 and Release Notes in PostScript
          and text formats. [1]

          Kit Contents

          The kit contains the following items:

          o  Cover Letter/Installation Instructions

          o  Software Product Description

          o  System Support Addendum

          o  DECram for VMS Version 1.0 on TK50, magtape, or CDROM

             -  DECram for VMS Version 1.0 Device Driver (MDDRIVER)

             -  DECram for VMS Release Notes

             -  DECram for VMS User's Manual

          ___________________
        [1] The following are trademarks of Digital Equipment Corporation:

            Digital, the Digital logo, VAX, VMS, DECram.

 






          Documentation

          During the DECram for VMS installation, the documentation will
          be copied to your system and placed in the SYS$HELP directory.
          The DECram for VMS User's Manual and the DECram for VMS
          Installation Instructions will be copied in both PostScript and
          text formats. The file names are:

             DECRAM_DRIVER_MANUAL.PS
             DECRAM_DRIVER_MANUAL.TXT
             DECRAM_INSTAL_GUIDE.PS
             DECRAM_INSTAL_GUIDE.TXT

          Release Note

          When attempting to initialize a DECram device using the INITIALIZE
          command, the system returns the following incorrect error
          message:

         %INIT-F-INTDIV, arithmetic trap, integer divide by zero at PC=xxxxxxxx

          The correct message that the system should return is:

                   %SYSTEM-F-NOPRIV, no privilege for attempted operation

          This problem will be corrected in a later release of VMS.













                                          2

 






          Copyright Information

          The following copyright information applies only to Version 1.0
          of the DECram product:

          Customers are hereby authorized to make one or more printed
          copies of the DECram for VMS User's Manual in PostScript and/or
          text form. Any such copy shall serve as Customer's user manual
          for this product. This copying is hereby authorized only within
          Customer's Corporate Group, and this authorization applies to
          electronic-to-electronic, electronic-to-hardcopy, and hardcopy-
          to-hardcopy forms of copying. Any copy hereby authorized is for
          Customer's internal use and distribution only, and Customer may
          not sell, or otherwise use and/or distribute any such copy. This
          authorization for copying applies only to Version 1.0 of the
          DECram product.















              ©Digital Equipment Corporation. 1991. All rights reserved.

















                                          3

 






          Preparing to Install DECram for VMS

          This document describes how to install DECram for VMS. You can
          install DECram for VMS on VMS Version 5.2 and on subsequent
          versions.

          Your bill of materials (BOM) and indented bills report (BIL)
          specify the contents of your kit. Be sure to verify the contents
          of your kit with this information. If your kit is damaged or if
          parts of it are missing, contact your Digital representative.

          DECram for VMS provides online release notes. Digital recommends
          that you read the release notes before proceeding with the
          installation. For information on accessing the online release
          notes, see Section 3.

          1  License Registration

          You must register and load your license for DECram for VMS
          before you start the installation. This will allow you to to
          run the Installation Verification Procedure (IVP) and use the
          software after the installation completes.

          Log in to the system manager's account, SYSTEM, to register
          a license. 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
             License Product Authorization Key (PAK).

          o  At the DCL prompt, enter the LICENSE REGISTER command with
             the appropriate qualifiers that correspond to License PAK
             information.

          If you plan to use DECram for VMS on more than one node in a
          VAXcluster, you will need to load a license, register it, and
          install DECram for VMS on the other nodes as well.

          For complete information on using LMF, see the VMS License
          Management Utility Manual.

                                          4

 






          2  Installation Procedure Requirements

          This section and those that follow discuss various requirements
          for installing DECram for VMS. The installation takes approx-
          imately 15 minutes, depending on your type of media and your
          system configuration.

          2.1  Privileges and Disk Space

          To install DECram for VMS, you must be logged in to an account
          that has SETPRV or at least the following privileges enabled:

          o  CMKRNL

          o  WORLD

          o  SYSPRV

          Note that VMSINSTAL disables BYPASS privilege at the start of
          the installation.

          The requirements of DECram for VMS for free disk storage space
          are different during installation and after installation.
          Table 1 summarizes the storage requirements.

          ________________________________________________________________

          Table 1:  Disk Space Requirements
          ________________________________________________________________

                                                               Blocks
                                  Blocks During Installa-      After In-
          Kit                     tion                         stallation
          ________________________________________________________________

          DECram for VMS          1,600                        655
          Version 1.0
          ________________________________________________________________

          To determine the number of free disk blocks on the system disk,
          enter the following command at the DCL prompt:

               $ SHOW DEVICE SYS$SYSDEVICE

                                          5

 






          2.2  System Parameters

          Installing DECram for VMS requires no changes to default system
          parameter settings. However, using DECram for VMS requires that
          you increase the number of System Page Table Entries (SPTEs) and
          also increase the SYSGEN parameter SPTREQ.

          The number of SPTEs is determined by the size of the DECram disk
          to be created. All SPTEs must be available contiguously or the
          configuration procedure will fail.

          Additional SPTEs for a DECram disk can be created by increasing
          the size of SYSGEN parameter SPTREQ. Use the following algorithm
          to determine the SPTREQ increase:

          (Size of DECram disk in blocks + 127)/128 + 128 = SPTREQ increase

          For example, the algorithm determines an SPTREQ increase of 207
          is required for a DECram disk of 10,000 blocks:

          ((10,000+127)/128)+128 = 207

          If the current value of SPTREQ is inadequate for a given disk,
          the system must be rebooted to allow for a larger value. There-
          fore, Digital recommends that you increase the SPTREQ value to
          a multiple of 128. Consequently, the increase for this example
          should be 2556; the amount of memory wasted would be negligible.

          To increase SPTREQ by 256, edit the file
          SYS$SYSROOT:[SYSEXE]MODPARAMS.DAT
          and add the following line:

          ADD_SPTREQ 256

          You must then run AUTOGEN.COM using the following command:

               $ @SYS$UPDATE:AUTOGEN MODPARAMS REBOOT

          The SPTREQ value now includes the increase required for the
          DECram disk.

                                          6

 






          If more than one DECram disk is created, use the algorithm
          to determine the initial SPTREQ increase for each disk. Then
          increase each initial value to a multiple of 128. The sum of
          the individual SPTREQ increases is the total amount required to
          accommodate all the disks.


          2.3  VMSINSTAL Requirements

          When you invoke the VMSINSTAL command procedure, it checks the
          following, all of which are transparent to the user:

          o  The default device and directory are set to SYS$UPDATE.

          o  The installer is logged in to a privileged account.

          o  Adequate quotas for installation have been set. VMSINSTAL
             requires that the installation account have a minimum of the
             following quotas:

                ASTLM = 24
                BIOLM = 18
                BYTLM = 18,000
                DIOLM = 18
                ENQLM = 30
                FILLM = 20

             Use the VMS Authorize Utility to check the values of these
             quotas for the installation account.

          o  No other users are logged in on the system.

          If VMSINSTAL detects any problems during the installation, it
          notifies you and asks if you want to continue the installation.
          In some instances, you can enter YES and press RETURN to
          continue. To stop the installation process and correct the 
          situation, enter NO or press RETURN. Then correct the problem and
          restart the installation.

                                          7

 






          2.4  Backing Up Your System Disk

          At the beginning of the installation, VMSINSTAL asks if you have
          backed up your system disk. Digital recommends that you perform
          a system disk backup before installing any software.

          Use the backup procedures that are established at your site. For
          details on performing a system disk backup, see the processor-
          specific upgrade and installation supplement for your system.






























                                          8

 






          Installing DECram for VMS

          This section explains how to install DECram for VMS and includes
          information on error recovery, the Installation Verification
          Procedure (IVP), and how to report problems.

          3  The Installation Procedure

          The DECram for VMS installation procedure consists of a series
          of questions and informational messages. See the Sample
          Installation section for a sample installation.

          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 exits. You can start
          the installation again at a later time.

          1. Invoke VMSINSTAL.

             To start the installation, invoke the VMSINSTAL command
             procedure from a privileged account, such as the SYSTEM
             account. VMSINSTAL is in the SYS$UPDATE directory.

                 $ @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N

             The following list defines the elements of the VMSINSTAL
             command procedure:

             saveset-name

             The installation name for the component. For DECram for VMS,
             use the following installation name:

                  DECRAM010





                                         9

 






             device-name

             The name of the device on which you plan to mount the
             installation media. For example, MTA0: is the device name for
             some tape drives. It is not necessary to use the console drive
             for this installation. However, if you do use the console
             drive, once the installation is complete you should return
             the console media to the console drive.

             OPTIONS N

             An optional parameter that indicates you want to see the
             question on release notes. If you do not include the OPTIONS
             N parameter, VMSINSTAL does not ask you about the release
             notes. You should review the release notes before proceeding
             with the installation. If you are restarting the installation
             and have already reviewed the release notes, you do not need
             to specify OPTIONS N.

             There are several other options you can select when you
             invoke VMSINSTAL.

             o  Auto_answer option (A): Initially creates a file that
                contains your answers to VMSINSTAL questions and prompts.
                You can then use the option (and the answer file) to save
                time during a re-installation.

             o  Get save set option (G): Lets you store product save sets
                temporarily on a magnetic tape or in a disk directory.

             o  File log option (L): Logs all activity to the terminal
                during installation.

             o  Alternate root option (R): Lets you install the product to
                a system root other than that of the running system.

             If you specify more than one option, separate the options
             with commas and no spaces.

                                         10

 






             The following example invokes VMSINSTAL to install DECram
             for VMS from tape drive MTA0: and shows the system response.
             This example uses the OPTIONS A auto-answer and the OPTIONS N
             release note parameters.

                  $ @SYS$UPDATE:VMSINSTAL DECRAM010 MTA0: OPTIONS A,N

                        VAX/VMS Software Product Installation Procedure V5.3


                  It is 15-MAY-1991 at 09:10.
                  Enter a question mark (?) at any time for help.

             If you do not supply either the product name or the device
             name, VMSINSTAL prompts you for this information later in the
             installation procedure.

          2. Confirm system disk backup.

             VMSINSTAL asks if you are satisfied with your system disk
             backup. You should back up your system disk before performing
             an installation. If you are satisfied with the backup of your
             system disk, press RETURN. Otherwise, enter NO to discontinue
             the installation. After you back up your system disk, you can
             restart the installation.

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

          3. Mount the media.

             You should now mount the distribution volume on the device
             you specified when you invoked VMSINSTAL. The device name
             appears in the line preceding the question. VMSINSTAL then
             asks you if you are ready to continue with the installation.

             If you respond YES to indicate that you are ready, VMSINSTAL
             displays a message that the media containing DECram for
             VMS has been mounted on the specified device and that the
             installation has begun.

                                         11

 






             If you entered the wrong device name when you invoked
             VMSINSTAL and need to restart the installation, enter NO
             in response to the "Are you ready?" question. To abort the
             installation for other reasons, press CTRL/Y.

                  Please mount the first volume of the set on MTA0:.
                  * Are you ready? YES
                  %MOUNT-I-MOUNTED, DECRAM MOUNTED ON _$$MTA0:  (NODE 1)
                  The following products will be processed:
                    DECRAM  V1.0

                      Beginning installation of DECRAM V1.0 at 09:12

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

          4. Select a release notes option.

             If you specified OPTIONS N, VMSINSTAL asks a question on
             release notes. You have four options for handling the release
             notes:

                  Release notes included with this kit are always copied to
                  SYS$HELP.

                  Additional Release Notes Options:

                   1.  Display release notes
                   2.  Print release notes
                   3.  Both 1 and 2
                   4.  None of the above

                  * Select option [2]:

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



                                         12

 






             If you select option 2, VMSINSTAL prompts you for the name of
             the print queue:

                  * Queue name [SYS$PRINT]:

             You can press RETURN to send the file to the default output
             print device or you can enter another queue name.

             If you select option 3, VMSINSTAL displays the release notes
             immediately on the console terminal and then prompts you for
             a queue name for the printed version.

             Select option 4 if you have already reviewed the release
             notes and are restarting the
             installation.

             Next, VMSINSTAL displays the following question:

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

             To continue the installation, enter YES. Otherwise, press
             RETURN. In either case, the release notes are copied to a
             file in the SYS$HELP directory:

                  SYS$HELP:DECRAM010.RELEASE_NOTES

             After the installation, you can enter the following command
             to review the release notes through the Help facility:

                  $ HELP DECRAM010 RELEASE_NOTES

          5. Purge files.

             You have the option to purge files from previous versions
             of DECram for VMS that are superseded by this installation.
             Since no previous version of DECram for VMS exists, enter NO
             in response to the question:

              * Do you want to purge files replaced by this installation [YES]?
  
                                        13

 






          6. Choose the Installation Verification Procedure (IVP) option.

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

             The installation procedure now asks if you want to run the
             IVP. The IVP for DECram for VMS checks to be sure that the
             installation is successful. Digital recommends that you run
             the IVP.

                                           NOTE

                The IVP creates a DECram disk MDA0 that remains after
                the IVP completes. If you do not want this disk, do not
                run the IVP.

             After DECram for VMS is installed, you can run the IVP 
             independently to verify that the software is available on
             your system. You may also need to run the IVP after a system
             failure to make sure that users can access DECram for VMS.

          7. Observe the Installation Verification Procedure (IVP).

             If you chose to run the IVP, VMSINSTAL runs it now. When the
             IVP runs successfully, you see the following display:

                     Successful Termination of DECram V1.0 IVP.

          8. The installation procedure ends.

                 Installation of DECRAM V1.0 completed at 09:27

                  Enter the products to be processed from the next distribution
                   volume set.
                * Products: exit

                  VMSINSTAL procedure done at 09:27

             The previous messages indicate that the installation procedure
             is complete.

                                         14

 






             You can now log out of the privileged account:

                  $ LOGOUT
                  SYSTEM     logged out at 15-MAY-1991 43:21.13

             Note that VMSINSTAL deletes or changes entries in the process
             symbol tables during the installation. Log out and then log
             in to restore these symbols if you wish to continue using the
             account from which you performed the installation.

          4  Error Recovery

          If errors occur during the installation or when the Installation
          Verification Procedure (IVP) is running, VMSINSTAL displays
          failure messages. If the installation fails, you see the 
          following message:

               %VMSINSTAL-E-INSFAIL, The installation of DECRAM V1.0 has failed.

          If the IVP fails, you will see two messages: either of the first
          two messages that follow, and the third message:

               Problem encountered attempting to create a DECram disk.

               Problem encountered initializing a DECram disk.

               Unsuccessful termination of DECram V1.0 IVP.

          Errors can occur during the installation if any of the following
          conditions exist:

          o  The operating system is a version prior to VMS Version 5.2.

          o  Installation account quotas necessary for successful 
             installation are insufficient.

          o  System parameter values for successful installation are
             insufficient.

          o  The VMS help library is currently in use.

          o  The product license has not been registered and loaded.

                                         15

 






          For descriptions of the error messages generated by these con-
          ditions, see the VMS documentation on system messages, recovery
          procedures, and VMS software installation. If you are notified
          that any of these conditions exist, you should take the appro-
          priate action as described in the message. For information on
          installation requirements, see the Preparing to Install DECram
          for VMS section.
































                                         16

 






          5  DECram Installation Messages

          The following messages may be generated by the DECram for VMS
          installation procedure.

          Missing License Message

          The installation procedure checks for the presence of the
          license to use DECram for VMS. If the license is not found,
          the following message is sent:

                       A license for DECRAM has not been registered
                       and loaded. DECRAM will not be installed.

          No DECram for VMS Driver Installed Message

          The installation procedure determines if the DECram for VMS
          driver is already installed in the system. If there is no driver
          installed in the system, the following message is sent:

                       %SYSTEM-W-NOSUCHDEV, no such device available

          This message can be ignored; the installation will proceed
          normally.

          DECram for VMS Driver Already Installed Message

          If the installation procedure determines that the DECram for VMS
          driver is already installed on the system, the following message
          is sent:

                       A DECRAM Driver is already installed on the system.

          Digital recommends that you reboot your system, rather than
          perform a SYSGEN RELOAD, to invoke DECram for VMS.




                                         17

 






          6  Running the Installation Verification Procedure Separately

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

               $ @SYS$UPDATE:DECRAM$IVP

                                        NOTE

             The IVP creates a DECram disk MDA0 that remains after the
             IVP completes. If you do not want this disk, do not run
             the IVP.

          7  Determining and Reporting Problems

          If you encounter a problem while using DECram for VMS, report it
          to Digital. Depending on the nature of the problem and the type
          of support you have, you can take one of the following actions:

          o  Call Digital Services if your software contract or warranty
             agreement entitles you to telephone support.

          o  Submit a Software Performance Report (SPR).

          Review the Software Product Description (SPD) and Warranty
          Addendum for an explanation of your warranty. If you encounter
          a problem during the warranty period, report the problem as
          indicated above or follow alternate instructions provided by
          Digital for reporting SPD nonconformance problems.

          8  DECram Documentation

          Print the DECram for VMS User's Manual, which is contained in
          the following files:

             SYS$HELP:DECRAM_DRIVER_MANUAL.PS
             SYS$HELP:DECRAM_DRIVER_MANUAL.TXT

                                         18

 






          Print the release notes, if you have not already done so. The
          release notes are contained in the following file:

             SYS$HELP:DECRAM010.RELEASE_NOTES

          Installed Files

          The DECram for VMS installation procedure installs a number of
          files on your system. Section 9 lists the installed files.

          9  File Names

          The following list contains the names of all files changed or
          created on your system when DECram for VMS is installed.

          o  SYS$LIBRARY:DCLTABLES.EXE

             This file is changed when you install DECram Version 1.0 on
             VMS Versions 5.2 and 5.3.

          o  SYS$LOADABLE_IMAGES:MDDRIVER.EXE

             This file is the DECram for VMS device driver (MDDRIVER).

          o  SYS$SYSTEM:DECRAM$SIZE.EXE

             This file is applicable to VMS Versions 5.2 and 5.3 only.

          o  SYS$HELP:DECRAM010.RELEASE_NOTES

             This file contains the release notes for Version 1.0 of
             DECram for VMS.

          o  SYS$HELP:DECRAM_DRIVER_MANUAL.PS
             SYS$HELP:DECRAM_DRIVER_MANUAL.TXT

             These files contain the DECram for VMS User's Manual. This
             manual describes the features of the DECram for VMS driver
             and includes information on how to configure the device and
             use the device driver.

          o  SYS$HELP:DECRAM_INSTAL_GUIDE.PS
             SYS$HELP:DECRAM_INSTAL_GUIDE.TXT

                                         19

 






             These files contain the instructions for installing DECram
             for VMS. (This is the document you are now reading.)

          o  SYS$TEST:DECRAM$IVP.COM

             This file is the Installation Verification Procedure (IVP).

          o  SYS$EXAMPLES:DECRAM$CONFIG.COM

             A command procedure that is used to automatically create and
             initialize a DECram disk. The DECram for VMS User's Manual
             shows an example of using this procedure.

          o  SYS$EXAMPLES:RAMDISK$STARTUP.COM

             A procedure used to build a read-only DECram disk.

          o  SYS$EXAMPLES:RAMDISK$NODE.DAT

             The data file used by RAMDISK$STARTUP.COM.

          o  SYS$EXAMPLES:SCRATCHRAM$STARTUP.COM

             A procedure used to build a read/write DECram disk.

          o  SYS$EXAMPLES:SCRATCHRAM$NODE.DAT

             The data file used by SCRATCHRAM$STARTUP.COM.

          Sample Installation

          This section contains a sample installation of DECram for VMS.
          The sample installation assumes that no users are logged on
          to your system, and that OPTIONS N is specified to print the
          release notes. The Installation Verification Procedure (IVP)
          runs at the end of the installation.

               $ @SYS$UPDATE:VMSINSTAL

                       VAX/VMS Software Product Installation Procedure V5.3

               It is 15-MAY-1991 at 08:01.

                                         20

 






               Enter a question mark (?) at any time for help.
               * Are you satisfied with the backup of your system disk [YES]? y
               * Where will the distribution volumes be mounted: MUA0:

          Enter the products to be processed from the first distribution volume
                    set.
               * Products: decram010
               * Enter installation options you wish to use (none): N
               The following products will be processed:
                 DECRAM V1.0

                Beginning installation of DECRAM V1.0 at 08:02

               %VMSINSTAL-I-RESTORE, Restoring product save set A ...

             Release notes included with this kit are always copied to SYS$HELP.

                  Additional Release Notes Options:

                1.  Display release notes
                2.  Print release notes
                3.  Both 1 and 2
                4.  None of the above

               * Select option [2]: 4
               * Do you want to continue the installation [NO]? Y

               $!  Copyright (c) 1990 Digital Equipment Corporation.  All rights
                    reserved.

               %DECRAM-I-VMSOK, Installing DECRam V1.0 on VMS Version V5.3
               * Do you want to purge files replaced by this installation [YES]?
               * Do you want to run the IVP after the installation [YES]?

                       The installation will check for the DECram driver already
                       installed in the system. If there is no driver installed 
                       in the system you will receive the following message:

                       "%SYSTEM-W-NOSUCHDEV, no such device available"

                       This message can be ignored, the installation will
                       proceed normally.

                                         21

 






               %SYSTEM-W-NOSUCHDEV, no such device available
               %VMSINSTAL-I-RESTORE, Restoring product save set C ...
               %VMSINSTAL-I-RESTORE, Restoring product save set E ...
               %VMSINSTAL-I-RESTORE, Restoring product save set F ...
               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target
                                       directories...
               %SYSTEM-W-NOSUCHDEV, no such device available

               Device       Device      Error    Volume         Free  Trans Mnt
                Name        Status      Count     Label        Blocks Count Cnt
               MDA0:        Online          0

               Device       Device      Error    Volume         Free  Trans Mnt
                Name        Status      Count     Label        Blocks Count Cnt
               MDA0:        Online          0
               %MOUNT-I-MOUNTED, MDTST        mounted on _JONAS$MDA0:
               Successful Termination of DECram V1.0 IVP.
                Installation of DECRAM V1.0 completed at 08:04

            Enter the products to be processed from the next distribution volume
                     set.
               * Products: exit
                VMSINSTAL procedure done at 08:04

               $














                                         22
