                                             H                     Spiralog____________________________________________&                     Installation Guide    -                     Order Number: AA-QSU5C-TE     !                     February 1997                   F                     Software Version:             Spiralog File SystemC                                                   for OpenVMS Alpha =                                                   Version 1.2   G                     Operating System:             OpenVMS Alpha Version 5                                                   7.1                  J           ________________________________________________________________           February 1997   B           Possession, use, or copying of the software described inC           this documentation is authorized only pursuant to a valid D           written license from Digital or an authorized sublicensor.  A           While Digital believes the information included in this E           publication is correct as of the date of publication, it is +           subject to change without notice.   @           Digital Equipment Corporation makes no representationsA           that the use of its products in the manner described in B           this publication will not infringe on existing or futureB           patent rights, nor do the descriptions contained in thisB           publication imply the granting of licenses to make, use,>           or sell equipment or software in accordance with the           description.  /            Digital Equipment Corporation 1997.              All Rights Reserved.  ;           The following are trademarks of Digital Equipment C           Corporation: DEC, Digital, OpenVMS, VAX DOCUMENT, and the            DIGITAL logo.   @           All other trademarks and registered trademarks are the/           property of their respective holders.   E           This document was prepared using VAX DOCUMENT, Version 2.1.                                  C   _________________________________________________________________   C                                                            Contents       C   Welcome...................................................      v      1  Before Installing Spiralog   ;         1.1   Tasks for Customers Upgrading from a Previous C               Version of Spiralog...........................    1-1 C         1.2   Check Prerequisite Hardware and Software......    1-2 C         1.3   Back Up Your System Disk......................    1-2 C         1.4   Set Up the Installation Account...............    1-2      2  Installing Spiralog  C         2.1   Run the Spiralog Installation Procedure.......    2-1 C         2.2   Edit the System Startup and Shutdown Files....    2-3 C         2.3   Set System Parameters.........................    2-3 C         2.4   Reboot........................................    2-4      3  Deinstalling Spiralog       A  Sample Installation  #   B  Files Installed on Your System                       C                                                                 iii                              I         _________________________________________________________________   I                                                                   Welcome       C               This book describes how to install Version 1.2 of the 5               Spiralog File System for OpenVMS Alpha.   I               ___________________________________________________________                For information I               on..._________________See_the...___________________________   :               Spiralog              Spiralog Release Notes               restrictions  9               Using Spiralog        Spiralog User's Guide   G               Managing Spiralog     Spiralog System Manager's Guide and A                                     Spiralog Commands at a Glance   ?               Ensuring that         Spiralog Programmer's Guide                 your program works               with Spiralog and                its programming I               interfaces_________________________________________________            Send Us Your Comments   :               Digital welcomes your comments on this book.  @               Print or edit the online form SYS$HELP:OPENVMSDOC_8               COMMENTS.TXT and send us your comments by:  4               Internet    openvmsdoc@zko.mts.dec.com  =               Fax         +1-603-881-0120, Attention: OpenVMS 3                           Documentation, ZK03-4/U08   A               Mail        OpenVMS Documentation Group, ZKO3-4/U08 ,                           110 Spit Brook Rd,/                           Nashua, NH 03062-2698                            USA   I                                                                         v                          I                                                                         1 I         _________________________________________________________________   I                                                Before Installing Spiralog     F               This chapter describes the tasks you must perform before/               you install Spiralog Version 1.2:   I               1. Tasks for Customers Upgrading from a Previous Version of                   Spiralog   9               2. Check Prerequisite Hardware and Software   )               3. Back Up Your System Disk   0               4. Set Up the Installation Account  D         1.1 Tasks for Customers Upgrading from a Previous Version of             Spiralog  H               Read this section if you are upgrading to Spiralog Version6               1.2 from a previous version of Spiralog.  H               Because of various incompatibilities between OpenVMS AlphaE               Version 7.1 and previous versions of Spiralog, you must C               deinstall your current version of Spiralog before you 3               upgrade to OpenVMS Alpha Version 7.1.   I               Follow these steps before you install Spiralog Version 1.2:   <               1. Deinstall your current version of Spiralog:  *                  $ PRODUCT REMOVE SPIRALOG  I               2. Upgrade your operating system from OpenVMS Alpha Version 2                  7.0 to OpenVMS Alpha Version 7.1.  F                 ________________________ Note ________________________  E                 If you have already upgraded to OpenVMS Alpha Version F                 7.1 and did not deinstall Spiralog first, follow these>                 steps before you install Spiralog Version 1.2:  >                 1. Deinstall your current version of Spiralog:  I                                            Before Installing Spiralog 1-1                 Before Installing SpiralogI     1.1 Tasks for Customers Upgrading from a Previous Version of Spiralog     )                 $ PRODUCT REMOVE SPIRALOG   =              2. Reinstall OpenVMS Alpha Version 7.1 using the                   PRESERVE option.  #              3. Reboot your system.   B              If you do not follow these steps, you will experienceB              problems with the BACKUP command, the print and batch1              queuing system, and DECdtm services.   C              ______________________________________________________   0     1.2 Check Prerequisite Hardware and Software  B           Before you install Spiralog Version 1.2, make sure that:  7           o  You are running OpenVMS Alpha Version 7.1.   C           o  You do not have a version of Spiralog prior to Version ;              1.2 installed on the system (see Section 1.1).   3           o  You have at least 64 Mbytes of memory.   <           o  Your system disk has at least 9200 free blocks.  >           You do not need a Product Authorization Key (PAK) to'           install Spiralog Version 1.2.         1.3 Back Up Your System Disk  D           A failure during installation could leave your system diskD           in an inconsistent state. Digital recommends that you back?           up your system disk before starting the installation.   @           Use the backup procedures that are established at your           site.   '     1.4 Set Up the Installation Account   D           Log in to an account that has full privileges enabled, for&           example, the SYSTEM account.  8           You need the following minimum process quotas:                ASTLM          98              BIOLM         100              BYTLM       32640              DIOLM         100  "     1-2 Before Installing Spiralog           I                                                Before Installing Spiralog I                                       1.4 Set Up the Installation Account       "                  ENQLM         200"                  FILLM         300  G               Follow these steps to find out the installation account's ;               process quotas, and change them if necessary:   I               ___________________________________________________________ I               Step__Action_______________________________________________   .               1     Run the Authorize utility:  ,                     $ SET DEFAULT SYS$SYSTEM#                     $ RUN AUTHORIZE   -               2     Check the process quotas:   *                     UAF> SHOW account-name  F               3     If any process quota is incorrect, change it using4                     the MODIFY command, for example:  9                     UAF> MODIFY account-name /BYTLM=32640   /               4     Exit the Authorize utility:                        UAF> EXIT   I               5     Activate any changes by logging out, and then logging I               ______in_again.____________________________________________                               I                                            Before Installing Spiralog 1-3                          I                                                                         2 I         _________________________________________________________________   I                                                       Installing Spiralog     I               This chapter describes how to install Spiralog Version 1.2:   8               1. Run the Spiralog Installation Procedure  ;               2. Edit the System Startup and Shutdown Files   &               3. Set System Parameters                 4. Reboot   3         2.1 Run the Spiralog Installation Procedure   E               To run the Spiralog Version 1.2 installation procedure, !               follow these steps:   H               1. Mount the Spiralog Version 1.2 distribution CD-ROM. ForG                  example, if the CD-ROM is in DKA500, use this command:   -                  $ MOUNT DKA500: /OVERRIDE=ID   C               2. Run the Spiralog installation procedure, using the 6                  PRODUCT INSTALL command. For example:  E                  $ PRODUCT INSTALL SPIRALOG /SOURCE=DKA500:[SOFTWARE]   D                  See the DCL help for the PRODUCT INSTALL command toE                  find out about the features it provides, such as how F                  to control where it installs the product (by default,C                  SYS$COMMON), and how to get context-sensitive help )                  during the installation.   C                  The time required to run the Spiralog installation F                  procedure depends on your system. On a DEC 3000 Model1                  300 it takes about five minutes.   I                  When you enter the PRODUCT INSTALL command, you will see %                  a message like this:   I                                                   Installing Spiralog 2-1                 Installing Spiralog /     2.1 Run the Spiralog Installation Procedure     5              The following product has been selected: %              DEC AXPVMS SPIRALOG V1.2   +              Do you want to continue? [YES]   :           3. Press Return to answer Yes (the default). The!              installation starts:   )              *** DEC AXPVMS SPIRALOG V1.2 E                  Spiralog File System for OpenVMS Alpha, Version V1.2   E                  Copyright  Digital Equipment Corporation 1997.  All                    rights reserved  .                  Digital Equipment Corporation  ?                  This product is licensed for use with OpenVMS.   G              Do you want all the default values for this product? [YES]   :           4. Press Return to answer Yes (the default). The$              installation continues:  9              Do you want to view the default values? [NO]   9           5. Press Return to answer No (the default). The $              installation continues:  8              %PCSIUI-I-DONEASK, execution phase starting5              The following product will be installed: %              DEC AXPVMS SPIRALOG V1.2 D              %PCSI-I-VOLINFO, estimated space information for volume                   DISK$SYSTEM F              -PCSI-I-VOLSPC, 9200 required; 20000 available; 10800 netD              Portion Done: 0%...10%...20%...30%...40%...50%...60%..."                   70%...90%...100%  6              The following product has been installed:%              DEC AXPVMS SPIRALOG V1.2 9              %PCSI-I-EXETSTSTART, start of test procedure G              %PCSI-I_EXETSTOK, end of test procedure; completed with no                   errors *              *** DEC AXPVMS SPIRALOG V1.2:=                  Spiralog File System for OpenVMS Alpha, V1.2   A                  Now reboot to activate this version of Spiralog.        2-2 Installing Spiralog            I                                                       Installing Spiralog I                            2.2 Edit the System Startup and Shutdown Files     6         2.2 Edit the System Startup and Shutdown Files  G               If you are installing Spiralog for the first time, follow                these steps:  F               1. To allow your users to get help on SPIRALOG commands,E                  edit the system startup file, SYS$STARTUP:SYSTARTUP_ >                  VMS.COM, to define MSGHLP$LIBRARY to point to/                  SYS$HELP:SPIRALOG.MSGHLP$DATA.   9                  For example, if your system startup file =                  currently defines MSGHLP$LIBRARY to point to G                  SYS$HELP:MSGHLP$LIBRARY.MSGHLP$DATA, modify the DEFINE $                  command as follows:  O                  $ DEFINE MSGHLP$LIBRARY SYS$HELP:MSGHLP$LIBRARY.MSGHLP$DATA, - F                  SYS$HELP:SPIRALOG.MSGHLP$DATA /SYSTEM /EXECUTIVE_MODE  )               2. Edit the system shutdown F                  file, SYS$MANAGER:SYSHUTDWN.COM, to add the following                  command:   1                  $ @SYS$STARTUP:SPIRALOG$SHUTDOWN   B                  This command automatically dismounts all Spiralog:                  volumes that are mounted on the computer.  !         2.3 Set System Parameters   I               If you are installing Spiralog for the first time, increase F               the values of the PAGEVIR and NPAGEDYN system parametersG               for each computer on which you intend to mount a Spiralog                volume.   F               We recommend that you increase NPAGEVIR by 2,000,000 andE               NPAGEDYN by 1,000,000 for each Spiralog volume that you ,               want to mount on the computer.  @               For example, if you want to mount two volumes on aD               computer, add the following lines to its MODPARAMS.DAT               file:   "               ADD_NPAGEVIR=4000000"               ADD_NPAGEDYN=2000000  I                                                   Installing Spiralog 2-3                 Installing Spiralog      2.4 Reboot         2.4 Reboot  A           To activate Spiralog Version 1.2, reboot using Autogen:   9           $ @SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT FEEDBACK   C           If you have an OpenVMS Cluster with a single system disk, A           reboot all the OpenVMS Alpha computers in your cluster.   D           If you have an OpenVMS Cluster with multiple system disks:  9           1. Install Spiralog on your other system disks.   E           2. Reboot all the OpenVMS Alpha computers that boot off the :              system disks on which you installed Spiralog.                                                                 2-4 Installing Spiralog                          I                                                                         3aI         _________________________________________________________________   I                                                     Deinstalling Spiralogr    G               To deinstall Spiralog Version 1.2, use the PRODUCT REMOVE                command:  '               $ PRODUCT REMOVE SPIRALOG   F               This command undoes all the changes made by the SpiralogE               Version 1.2 installation procedure, except that it does E               not modify the online help library (HELPLIB.HLB). After_H               you have deinstalled Spiralog Version 1.2, the online helpD               library will still include information on the SPIRALOG               command.                                                  I                                                 Deinstalling Spiralog 3-1i a  e                    I                                                                         AbI         _________________________________________________________________   I                                                       Sample Installatione    @               This appendix contains a log generated by a sample%               installation procedure.u  B               Depending on which layered products you have on yourE               system, you might see additional messages and questions 1               when you perform your installation.   <         $ PRODUCT INSTALL SPIRALOG /SOURCE=DKA500:[SOFTWARE]  0         The following product has been selected:         DEC AXPVMS SPIRALOG 1.2   &         Do you want to continue? [YES]  L         *** DEC AXPVMS SPIRALOG 1.2: Spiralog File System for OpenVMS Alpha,         Version 1.2l  O             Copyright  Digital Equipment Corporation 1997. All rights reservede  )             Digital Equipment Corporation   :             This product is licensed for use with OpenVMS.  F             Do you want all the default values for this product? [YES]  0             Do you want to view the values? [NO]  3         %PCSIUI-I-DONEASK, execution phase starting.0         The following product will be installed:         DEC AXPVMS SPIRALOG 1.2SK         %PCSI-I-VOLINFO, estimated space information for volume DISK$SYSTEM A         -PCSI-I-VOLSPC, 9200 required; 20132 available; 10932 net O         Portion Done: 0%...10%...20%...30%...40%...50%...60%...70%...90%...100% 1         The following product has been installed:-         DEC AXPVMS SPIRALOG 1.2a4         %PCSI-I-EXETSTSTART, start of test procedureI         %PCSI-I-EXETSTOK, end of test procedure; completed with no errors.  L         *** DEC AXPVMS SPIRALOG 1.2: Spiralog File System for OpenVMS Alpha,         Version 1.2t  I                                                   Sample Installation A-1. .  .           Sample Installation       8         Now reboot to activate this version of Spiralog.     $s                                                                                           A-2 Sample Installationi                         I                                                                         B_I         _________________________________________________________________   I                                            Files Installed on Your Systemo    F               The Spiralog installation procedure installs a number of(               files on your system disk.  G               The Spiralog installation procedure creates the following_               files:  !               [SYS$LDR]F64DEF.STB &               [SYS$LDR]FSDRIVERDEF.STB'               [SYS$LDR]SYS$FILES_64.STBo'               [SYS$LDR]SYS$FSDRIVER.EXE '               [SYS$LDR]SYS$FSDRIVER.STBa/               [SYS$STARTUP]SPIRALOG$STARTUP.COMd0               [SYS$STARTUP]SPIRALOG$SHUTDOWN.COM$               [SYSEXE]F64$SERVER.EXE"               [SYSEXE]SPIRALOG.EXE&               [SYSHLP]F64$SDA_HELP.HLB*               [SYSHLP]SPIRALOG.MSGHLP$DATA'               [SYSHLP]SPIRALOG$HELP.HLB /               [SYSHLP]SPIRALOG012.RELEASE_NOTES_'               [SYSHLP.EXAMPLES]BACKUP.Hr1               [SYSHLP.EXAMPLES]SPIRALOG_BARRIER.Co3               [SYSHLP.EXAMPLES]SPIRALOG_CACHING_1.Ch3               [SYSHLP.EXAMPLES]SPIRALOG_CACHING_2.CM7               [SYSHLP.EXAMPLES]SPIRALOG_CLUDISMOUNT.COMn4               [SYSHLP.EXAMPLES]SPIRALOG_CLUMOUNT.COM3               [SYSHLP.EXAMPLES]SPIRALOG_CLUSAVE.COM 7               [SYSHLP.EXAMPLES]SPIRALOG_MOVE_SERVER.COM /               [SYSHLP.EXAMPLES]SPIRALOG_FLUSH.CZ1               [SYSHLP.EXAMPLES]SPIRALOG_READDIR.Ck!               [SYSLIB]F64$SDA.EXEh#               [SYSLIB]F64$SHARE.EXE &               [SYSMSG]SPIRALOG$MSG.EXE'               [SYSTEST]SPIRALOG$IVP.COM .               [SYSUPD]PROVIDE_SYS$FILES_64.COM-               [SYSUPD]REMOVE_SYS$FILES_64.COM   I                                        Files Installed on Your System B-1_ _  _      "     Files Installed on Your System      &           [SYSUPD]SPIRALOG_COMMAND.CLD  D           The Spiralog installation procedure modifies the following           files:  #           [SYS$LDR]SYS$FILES_64.EXE            [SYSHLP]HELPLIB.HLBs           [SYSLIB]DCLTABLES.EXEn                                                                          &     B-2 Files Installed on Your System