                                                           PATHWORKSC                      for_OpenVMS_(Macintosh)_______________________ .                      Server Installation Guide                         AA-PBFDE-TE  !                      January 1995                 ?                      Revision/Update Information: This document @                                                   supersedes theG                                                   PATHWORKS for OpenVMS D                                                   (Macintosh) ServerE                                                   Installation Guide, C                                                   Version 1.2, part E                                                   number AA-PBFDD-TE.   G                      Software Version:            PATHWORKS for OpenVMS F                                                   (Macintosh), Version5                                                   1.3         2                      Digital Equipment Corporation+                      Maynard, Massachusetts                  E            __________________________________________________________ *            First Published, September 1990>            Revised, January 1991, January 1992, February 1993,            January 1995   A            Digital Equipment Corporation makes no representations B            that the use of its products in the manner described inC            this publication will not infringe on existing or future C            patent rights, nor do the descriptions contained in this C            publication imply the granting of licenses to make, use, ?            or sell equipment or software in accordance with the             description.   @            Possession, use, or copying of the software described?            in this publication is authorized only pursuant to a >            valid written license from Digital or an authorized            sublicensor.   B             Digital Equipment Corporation 1990, 1991, 1992, 1993,            1995.              All Rights Reserved.             Printed in U.S.A.  <            The following are trademarks of Digital Equipment            Corporation:   @            Alpha, DEC, DECconnect, DEClaser, DECnet, DECnet-DOS,B            DECnet-VAX, DECprint, DECshare, DECwindows, EtherWORKS,B            LN03, LN03 Plus, LN03 ScriptPrinter, MicroVAX, OpenVMS,C            PATHWORKS, PrintServer, Rdb/VMS, ReGIS, VAX, VAXcluster, D            VAXmail, VAXserver, VAX SQL, VMS, VMScluster, VT, and the            DIGITAL logo.  4            The following are third-party trademarks:  A            PostScript is a registered trademark of Adobe Systems, C            Inc. Apple, AppleShare, AppleTalk, LocalTalk, Macintosh, =            and MacTerminal are registered trademarks of Apple @            Computer, Inc. MacX is a trademark of Apple Computer,<            Inc. MacWrite is a registered trademark of ClarisA            Corporation. PATH Manager is a registered trademark of D            Verisoft Corporation. All other trademarks and registeredC            trademarks are the property of their respective holders.   /            This document is available on CDROM.   E            This document was prepared using VAX DOCUMENT Version 2.1.                                C    ________________________________________________________________   C                                                            Contents     C    Preface..................................................    vii         1  Introduction  C          Installation and Configuration Overview............    1-1 C          Planning the Physical Layout of a Network..........    1-2   <    2  Preparing to Install PATHWORKS for OpenVMS (Macintosh)  C          Planning Which Components to Install...............    2-2 C          What You Need......................................    2-3 C          Prerequisite Hardware..............................    2-3 C          Prerequisite Software..............................    2-4 C          Component-Required Software........................    2-4 C          AppleTalk Software.................................    2-4 C          Preinstallation Tasks..............................    2-5 C          Logging In to a Privileged Account.................    2-5 C          Backing Up Your System Disk........................    2-5 C          Determining Disk Space Requirements................    2-5 C          Process Account Quotas.............................    2-6 C          Setting System Parameters..........................    2-7 C          Checking Current Values............................    2-7 C          Determining the CHANNELCNT Value...................    2-8 C          Modifying Values...................................    2-9 C          Next Steps.........................................   2-10                 C                                                                 iii                  4      3  Installing PATHWORKS for OpenVMS (Macintosh)  E            Starting VMSINSTAL.................................    3-2 E            Interrupting the Installation Procedure............    3-3 E            Responding to VMSINSTAL Questions..................    3-3 E            General VMSINSTAL Questions........................    3-4 E            Questions About Components.........................    3-6 E            AppleTalk for OpenVMS Questions....................    3-8 E            AppleTalk/DECnet Transport Gateway Questions.......   3-10 E            DECshare File Server Questions.....................   3-10 E            DECshare Print Server Question.....................   3-12 E            Online Documentation Questions.....................   3-12 E            Completing the Installation........................   3-12 E            Error Messages and Conditions......................   3-14 E            Next Steps.........................................   3-15         4  Postinstallation Tasks  5            Modifying Your System Startup and Shutdown E            Procedures.........................................    4-2 E            Rebooting to Load AppleTalk for OpenVMS............    4-3 E            Starting the Software and Running the IVP..........    4-3 E            Next Steps.........................................    4-4   '      5  Configuring a VMScluster System   E            Replacing DCL Tables...............................    5-2 E            Running the ATK$CONFIG Configuration Procedure.....    5-2 E            Starting ATK$CONFIG................................    5-3 E            Setting Up the Primary Port........................    5-3 E            Assigning Network Ranges...........................    5-4 E            Enabling/Disabling Event Logging...................    5-4 E            Defining the AppleTalk/DECnet Transport Gateway....    5-5 E            Completing the Configuration Procedure.............    5-5 E            Starting PATHWORKS for OpenVMS (Macintosh).........    5-6 E            Creating a DECshare File Server on Other Servers...    5-7 E            Next Steps.........................................    5-9                       iv                  %         A  Sample Installation Script     )         B  Files Installed on Your System   :         C  DECnet Objects Created by PATHWORKS for OpenVMS            (Macintosh)             D  Installing the XQP+  H               Installation Steps.................................    D-1H               Responding to VMSINSTAL Questions..................    D-2H               XQP+ Sample Installation...........................    D-5  "         E  Configuringing the XQP+  H               New Features.......................................    E-1H               Controlling the New Features on Version 5.5-2......    E-2H               Controlling the New Features on Version 6.x........    E-3H               Controlling XQP+ in a VMScluster...................    E-49               Mixed OpenVMS Version 5.5-2 and Version 6.x H               Clusters...........................................    E-4;               VMSclusters Running OpenVMS Version 5.5-2 and H               Version 6.x........................................    E-4H               Controlling DECshare XQP+ Usage....................    E-4H               Deinstalling the XQP+..............................    E-5H               Known Problems.....................................    E-6  
         Index              Tables  H               2-1       Checklist for Preparing to Install.......    2-1  ;               2-2       Components of PATHWORKS for OpenVMS H                         (Macintosh)..............................    2-2  H               2-3       Disk Space Requirements..................    2-6  H               2-4       System Parameter Values..................    2-7  >               3-1       Checklist for Installing PATHWORKS forH                         OpenVMS (Macintosh)......................    3-1  H               4-1       Checklist for Postinstallation Tasks.....    4-1  H                                                                        v                 9            5-1       Checklist for Configuring VMScluster E                      Systems..................................    5-1   E            B-1       Directory: SYS$COMMON:[MSA]..............    B-2   E            B-2       Directory: SYS$COMMON:[MSA.MSAF$ICONS]...    B-2               B-3       Directory: E                      SYS$COMMON:[MSA.MSAP$UTILITY]............    B-3   E            B-4       Directory: SYS$COMMON:[SYS$LDR]..........    B-5   E            B-5       Directory: SYS$COMMON:[SYS$STARTUP]......    B-5   E            B-6       Directory: SYS$COMMON:[SYSEXE]...........    B-5   E            B-7       Directory: SYS$COMMON:[SYSHLP]...........    B-6               B-8       Directory: E                      SYS$COMMON:[SYSHLP.EXAMPLES.MSA].........    B-7   E            B-9       Directory: SYS$COMMON:[SYSLIB]...........    B-7   E            B-10      Directory: SYS$COMMON:[SYSMGR]...........    B-9   E            B-11      Directory: SYS$COMMON:[SYSMSG]...........    B-9   E            B-12      Directory: SYS$COMMON:[SYSTEST]..........   B-10   E            B-13      Directory: SYS$COMMON:[SYSTEST.ATK]......   B-10   E            B-14      Directory: SYS$COMMON:[SYSTEST.ATKGW]....   B-10                                 vi                            H         ________________________________________________________________  H                                                                  Preface               Purpose   >               The purpose of this manual is to help the systemE               administrator install PATHWORKS for OpenVMS (Macintosh) G               server software after all the network hardware components *               are installed and connected.           Audience  E               This manual is intended for the system administrator of F               PATHWORKS for OpenVMS (Macintosh). This person should beH               an experienced user of the Macintosh computer, the OpenVMS8               operating system, and knowledgeable about:  @               o  Configuring and monitoring the OpenVMS system's                  performance  D               o  Analyzing problems that might occur with an OpenVMS                  system   G               The system administrator should also be familiar with the H               hardware and software configuration of the network and the3               specific software needs of the users.                       H                                                                      vii                       Organization   C            The following list can help you find information in this             manual.  A            Chapter 1   Provides an overview of the steps involved B                        in installing and configuring PATHWORKS for+                        OpenVMS (Macintosh).   E            Chapter 2   Describes how to prepare for the installation.   =            Chapter 3   Describes how to install the software.   @            Chapter 4   Describes postinstallation tasks you needB                        to perform before you can use PATHWORKS for+                        OpenVMS (Macintosh).   D            Chapter 5   Describes how to configure other servers in a)                        VMScluster system.   D            Appendix A  Provides the script for a sample installation!                        procedure.   B            Appendix B  Lists the files installed on your system by2                        the installation procedure.  D            Appendix C  Lists the DECnet objects created by PATHWORKS/                        for OpenVMS (Macintosh).   E            Appendix D  Provides information about the XQP+ and how to "                        install it.  E            Appendix E  Describes how to install XQP+ on a VMS cluster                         system.        Related Documents  F            In addition to this book, PATHWORKS for OpenVMS (Macintosh)A            documentation includes the following online documents:   :            o  Introduction to the AppleTalk Network System  *            o  Server Administrator's Guide  5            o  Server Administrator's Reference Manual   B            At your option, these books are installed in PostScript?            format as part of the installation described in this             guide.   	      viii                  E               Information about installing and configuring the client B               software can be found in the following PATHWORKS for&               Macintosh documentation:  -               o  Client Administrator's Guide   .               o  Network Services User's Guide                                                                            H                                                                       ix                       Conventions  4            This book uses the following conventions:  E            __________________________________________________________ E            Convention____Meaning_____________________________________   B            <Return>      Press the <Return> or <Enter> key on your"                          keyboard.  B            <Ctrl/Y>      While you hold down the <Ctrl> key, press%                          the <Y> key.   B            "enter"       Type all letters, spaces, and punctuation@                          marks exactly as they are printed. ThenE                          press <Return> or <Enter>, depending on your "                          keyboard.  @            two-line      Some commands are continued on a secondB            commands      line. In OpenVMS, a continued command mayD                          be indicated by a hyphen (-)  at the end ofD                          the first line. Enter the hyphen, and pressE                          <Return>. The system displays the _$ prompt. D                          Continue entering the text that follows the2                          _$ prompt in your manual.  E            lowercase     Lowercase letters in command syntax indicate @                          variables for which you must substitute@                          a word or value. You can enter commandsA                          and parameters in uppercase or lowercase A                          letters, or in a combination of the two.   B            bold type     In examples of dialog between you and theE                          workstation, bold type indicates information @                          that you enter. For online (Bookreader)?                          versions, user input is shown in bold.   C            .             A vertical ellipsis means that not all the '            .             data is shown.             .  =            Note          Notes provide information of special $                          importance.  @            Caution       Cautions provide information to preventE            ______________damage_to_equipment_or_software.____________         x                       H                                                                        1H         ________________________________________________________________  H                                                             Introduction      $               This chapter provides:  >               o  An overview and chart of the installation and$                  configuration tasks  H               o  A brief introduction to planning the physical layout of                  a network  /         Installation and Configuration Overview   C               The installation of PATHWORKS for OpenVMS (Macintosh)                involves:   2               o  Installing software on the server  >               o  Configuring additional servers, if you have a"                  VMScluster system  C               You must also make the PATHWORKS for Macintosh client G               software available on your server and Macintosh computers D               to fully utilize the services of PATHWORKS for OpenVMS               (Macintosh).  @               The installation procedures described in this bookF               establish default values for system parameters that workF               for any network configuration. However, you may discoverE               that the needs of your site require you to make changes_E               to those default values. For information about changinguG               the network configuration, see the Server Administrator's                Guide.  E               If you want to improve the performance of the PATHWORKSoF               for OpenVMS (Macintosh) file server, you can install theC               XQP+. For information on how to install the XQP+, seed               Appendix D.i  H                                                         Introduction 1-1                 .      Planning the Physical Layout of a Network  C            PATHWORKS for OpenVMS (Macintosh) includes AppleTalk foro@            OpenVMS. AppleTalk for OpenVMS is networking softwareC            that allows a server node to participate in an AppleTalk             network.   D            Before installation, you should be familiar with concepts.            of the AppleTalk networking system.  A            If you are planning a new network, be sure to plan forlC            growth, efficiency, and high performance. Although a new B            network may be small and easy to maintain, you probably@            will connect more networks and devices in the future.  @            To help you plan the physical layout, you should drawB            a map of the network, including cables, devices such as<            printers and workstations, and network locations.  A            Before setting up a network, you should understand thet            following terms:               o  Internet              o  Primary port  (            o  Network numbers and ranges              o  AppleTalk zones               o  Routingl  D            The Introduction to the AppleTalk Network System providesA            valuable information about AppleTalk network concepts.tB            The Server Administrator's Guide provides more specificA            information about setting up and using the server noder?            in an AppleTalk internet. Refer to these manuals foryE            explanations of terms and for more information on planning             your network.                  1-2 Introduction  U  T                  H                                                                        2H         ________________________________________________________________  H                   Preparing to Install PATHWORKS for OpenVMS (Macintosh)      F               This chapter discusses the requirements and preparationsH               necessary for installing PATHWORKS for OpenVMS (Macintosh)               server software.  F               Table 2-1 is a checklist of the steps you need to follow8               to prepare for the installation procedure.  H               Table_2-1_Checklist_for_Preparing_to_Install______________  E               <   >Plan which software components you want to install 0                    and verify your kit contents.    H               <   >Make sure your system meets the hardware and softwareE                    requirements of PATHWORKS for OpenVMS (Macintosh)..  @               <   >Complete the following preinstallation tasks:  C                    <  >Log in to a fully privileged SYSTEM account..  0                    <  >Back up your system disk.  F                    <  >Make sure you have sufficient disk space avail-D                        able for installation of selected components.  G                    <  >Make sure your system meets the system parameter.H               _________requirements.____________________________________                H               Preparing to Install PATHWORKS for OpenVMS (Macintosh) 2-1 M  f            )      Planning Which Components to Install   ?            The software package consists of several components. C            Table 2-2 provides a brief description of each component 1            and specifies prerequisite components.l  E            Table_2-2_Components_of_PATHWORKS_for_OpenVMS_(Macintosh)_.  E            Component________Description_and_Dependencies_____________l  A            AppleTalk        The network transport for most of theT>            for OpenVMS,     software components that reside onA            Version 3.2      the OpenVMS server. It is used by thes@                             DECshare file and print servers, the>                             DECnet Gateway, and the DECwindowsA                             AppleTalk Data Stream Protocol (ADSP) &                             transport.  >            AppleTalk        Provides a network transport relay<            /DECnet          between the AppleTalk and DECnet%            Transport        networks.3A            Gateway          To use the AppleTalk/DECnet Transport.  D                             Gateway, you must also install AppleTalk4                             for OpenVMS Version 3.2.  D            DECshare File    Provides AppleShare-compatible Macintosh9            Server           volumes to Macintosh clients.P  @                             To use the DECshare file server, youC                             must also install AppleTalk for OpenVMS (                             Version 3.2.  C            DECshare Print   Provides printer spooling for Macintosh.@            Server           clients. The spooled printers can beA                             connected directly to the VAX server, E                             available to the VAX server over a DECnet B                             network, or available on the AppleTalk$                             network.  A                             To use the DECshare print server, youtC                             must also install AppleTalk for OpenVMSi(                             Version 3.2.  E                                              (continued on next page)   ?      2-2 Preparing to Install PATHWORKS for OpenVMS (Macintosh).                 C               Table 2-2 (Cont.) Components of PATHWORKS for OpenVMS H               __________________(Macintosh)_____________________________  H               Component________Description_and_Dependencies_____________  F               DECwindows ADSP  Provides a transport for Macintosh MacXD               Transport        servers to allow access to DECwindows,                                applications.  G                                To use the ADSP transport, you must alsoaD                                install AppleTalk for OpenVMS VersionE                                3.2 and the AppleTalk/DECnet TransportQ'                                Gateway..  F               PATHWORKS Mail   Allows access to VAXmail from Macintosh'               Server           clients..  D                                You can use the PATHWORKS Mail serverB                                with the AppleTalk/DECnet TransportC                                Gateway, if the latter is installed..  G               Online           Allows access to online PostScript filessD               PostScript       of the Server Adminsistrator's Guide,H               Documentation    Server Reference Manual, and Introduction?                                to the AppleTalk Network System..  H               __________________________________________________________  D               Your Part Listing specifies the number and contents ofD               your media. Be sure to verify the contents of your kitE               with this information. If your kit is damaged or if you E               find that parts of it are missing, contact your Digital                representative.K           What You Need   >               This section describes the hardware and software@               requirements of PATHWORKS for OpenVMS (Macintosh).  #               Prerequisite Hardwarem  D               Be sure that the network components, including cables,C               Macintosh computers, workstations, servers, and other &               hardware, are connected.  H               Preparing to Install PATHWORKS for OpenVMS (Macintosh) 2-3                              Prerequisite Software  ;            The following software must be installed on your B            OpenVMS server before you install PATHWORKS for OpenVMS             (Macintosh) software:  B            o  OpenVMS VAX Version 5.5-2 or higher or OpenVMS Alpha#               Version 6.1 or higherD  =            o  DECnet software is required if you plan to use:3  >               -  AppleTalk for OpenVMS, if you plan to turn on9                  AppleTalk routing and use DECnet tunnels   3               -  AppleTalk/DECnet Transport Gateway5  &               -  PATHWORKS Mail server  9               -  DECshare remote management (MSA$MANAGER)[  &            Component-Required Software  =            Depending on the PATHWORKS for OpenVMS (Macintosh) B            components you install, the following software products            are required:  =            o  DECprint Printing Services (DCPS) software, for.B               selected Digital PostScript and third-party printers  D            o  DECwindows/Motif(an optional part of OpenVMS), for the'               DECwindows ADSP transport               AppleTalk SoftwareS  =            Two versions of the AppleTalk network protocol areNE            currently available: AppleTalk Phase 1 and AppleTalk PhaseMD            2. PATHWORKS for OpenVMS (Macintosh) uses AppleTalk Phase
            2.   ?            If you have AppleTalk Phase 1, you need to plan your_A            migration to Phase 2. A migration utility is available A            with the AppleTalk internet router for large AppleTalkhA            internetworks that are being upgraded in steps, ratheriE            than all at once. For smaller networks, you can upgrade tor            Phase 2 in one step.a  C               ________________________Note ________________________   ?               If you previously installed AppleTalk for OpenVMSa?               Version 2.1, you cannot run it with this product..B               PATHWORKS for OpenVMS (Macintosh) includes AppleTalk  ?      2-4 Preparing to Install PATHWORKS for OpenVMS (Macintosh)n e  a            C                 for OpenVMS Version 3.2, which is incompatible with 2                 AppleTalk for OpenVMS Version 2.1.  E                 _____________________________________________________            Preinstallation Taskss  B               Before installing PATHWORKS for OpenVMS (Macintosh):  H               1. Log in to a system account with full system privileges.  )               2. Back up the system disk.   5               3. Check the disk space on your system.   A               4. Make sure your system meets the system parameterT                  requirements.  >               These steps are described in the following text.  0               Logging In to a Privileged Account  G               Install PATHWORKS for OpenVMS (Macintosh) from the SYSTEM E               account at the OpenVMS server. You must have the SETPRVh               privilege.  )               Backing Up Your System Disks  C               Digital recommends that you do a system backup beforeiE               installing any layered product on the operating system.u  E               Use the backup procedures that have been established at                your site.  1               Determining Disk Space Requirements   A               The OpenVMS server requires a larger amount of free C               disk space during installation than it requires after C               installation. Table 2-3 specifies the amount of space F               required by each component after installation on the VAX$               or the Alpha computer.  H               To determine the number of free disk blocks on the currentA               system disk, enter the following command at the DCL                prompt:l  H               Preparing to Install PATHWORKS for OpenVMS (Macintosh) 2-5                 &            $ SHOW DEVICE SYS$SYSDEVICE  C               ________________________Note ________________________s  9               All components except the online PostScriptcA               documentation files must reside on the system disk.t  C               _____________________________________________________r  E            Table_2-3_Disk_Space_Requirements_________________________o  E            Component_Blocks_Required_for___VAX______Alpha____________t  :            AppleTalk for OpenVMS            1,450    2,250  :            AppleTalk/DECnet Transport         300      450            Gateway  :            DECshare file server             2,350    4,550  :            DECshare print server            2,350    2,550  :            DECwindows ADSP transport          400      500  :            PATHWORKS Mail server              450      800  :            Online PostScript files         10,000   10,000  :            Miscellaneous files              1,200    1,200  :            Total Blocks Required After     18,300   22,100            Installation   :            Total Blocks Needed During      20,800   24,600E            Installation_______________________________________________  !            Process Account QuotasP  ;            PATHWORKS for OpenVMS (Macintosh) has no special B            requirements for process account quotas. Default SYSTEM?            process account quotas are sufficient for installing -            PATHWORKS for OpenVMS (Macintosh).p      ?      2-6 Preparing to Install PATHWORKS for OpenVMS (Macintosh)  n               '               Setting System Parameterse  G               PATHWORKS for OpenVMS (Macintosh) has required values for <               some system parameters, as shown in Table 2-4.  H               Table_2-4_System_Parameter_Values_________________________  H               Parameter_____________VAX___________Alpha_________________  ;               CHANNELCNT               256[1]        256[1]<  =               GBLPAGES               1,540 free    3,524 free   =               GBLSECTIONS               35 free       28 free   8               MAXBUF                 8,192         8,192  8               PQL_MBYTLM            16,384        16,384H               [1]This_is_the_minimum_allowable_value_if_you_are_going_to  /               install the DECshare file server. H               __________________________________________________________  8               The rest of this section describes how to:  D               o  Check the current values of other system parameters  D               o  Determine the appropriate CHANNELCNT value for your                  system   5               o  Modify other system parameter values   %               Checking Current Values   F               Use the F$GETSYI lexical function to check the number of4               free global pages and global sections:  :               $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES")               890 :               $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")               40  >               If these values are less than those specified inG               Table 2-4, increase each parameter to the number required 2               as described under Modifying Values.  C               Use the SYSGEN utility to check the current values of_&               other system parameters:  6               1. Start the SYSGEN utility by entering:  H               Preparing to Install PATHWORKS for OpenVMS (Macintosh) 2-7 t  a            %               $ RUN SYS$SYSTEM:SYSGEN                SYSGEN>i  B            2. Determine the current value of a system parameter by               entering:i  $               SYSGEN> SHOW parameter  E               For example, to determine the current value of the PQL_ -               MBYTLM system parameter, enter:o  %               SYSGEN> SHOW PQL_MBYTLMC  @               Following is an example of the information that isB               displayed. The information on your screen may differE               slightly, depending on the configuration of your servera?               node. This example shows a current value of 1700:f  I               Parameter Name Current Default Minimum Maximum Unit DynamiclI               ______________ _______ _______ _______ ____________ _______aI               PQL_MBYTLM        1700    1024      -1     -1 Bytes       Dr  E            3. Exit the SYSGEN utility and return to the DCL prompt byt               entering:n                 SYSGEN> EXIT               $r  +            Determining the CHANNELCNT Value   E            If you are going to configure the AppleTalk/DECnet gatewaydB            for a large number of sessions, you need 2 channels forD            each session plus 5 additional channels. In addition, youC            need to calculate a value of CHANNELCNT for the DECshare             file server.   A            To determine the appropriate CHANNELCNT value for your E            system, use whichever value is larger, as derived from theu"            following two formulas:              For the file server:   =            CHANNELCNT = (volumes*6) + catalog + (users*files)o%                       + managers + 25a  ?      2-8 Preparing to Install PATHWORKS for OpenVMS (Macintosh)                                 For the gateway:  =               CHANNELCNT = 2*(AppleTalk Gateway sessions) + 5.  H               __________________________________________________________H               Parameter___Description___________________________________  9               volumes     Number of volumes being served.   D               catalog     Value of the CATALOG_CACHE characteristic.  G               users       Maximum number of simultaneous user connects.p  8               files       Number of open files per user.  H               managers____Number_of_concurrent_ADMIN/MSA_connections.___  G               For example, on a 14-volume file server with 34 users and E               a default CATALOG_CACHE of 64 (estimating users with anoF               average of 4 files opened at once and only one ADMIN/MSA=               connection), the CHANNELCNT value would be 310:k  5               CHANNEL = 3 + 14*6 + 64 + 34*4 + 1 + 25   F               See Modifying Values for information on modifying system               parameter values.                  Modifying Values  8               To modify the value of a system parameter:  B               1. Using any text editor, add or edit the lines thatE                  set minimum values for your system parameters in the <                  SYS$SYSTEM:MODPARAMS.DAT file. For example:  '                  MIN_PQL_MBYTLM = 16384   F               2. Run the AUTOGEN command procedure to recalculate your)                  system parameter values:r  @                  $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT NOFEEDBACK  '                  The AUTOGEN procedure:t  6                  o  Gets new values from MODPARAMS.DAT  B                  o  Runs SYSGEN to update the new system parameter                     values  C                  o  Installs the new system parameter values on ther                     system  H               Preparing to Install PATHWORKS for OpenVMS (Macintosh) 2-9                 C               o  Reboots the system so that all of the changes take                   effectc  D               The NOFEEDBACK qualifier causes AUTOGEN to recalculate3               only the new system parameter values.T  C               ________________________Note ________________________l  @               Running AUTOGEN with the NOFEEDBACK qualifier does@               not modify system files (page file, swap file, and               dump file).   C               _____________________________________________________         Next Stepsl  =            Now you are ready to install PATHWORKS for OpenVMS<B            (Macintosh) according to the instructions in Chapter 3.                                                      @      2-10 Preparing to Install PATHWORKS for OpenVMS (Macintosh) r  e                  H                                                                        3H         ________________________________________________________________  H                             Installing PATHWORKS for OpenVMS (Macintosh)      B               VMSINSTAL is the standard installation procedure for?               OpenVMS layered products. It displays a series ofe3               questions and informational messages.   D               This chapter describes how to use VMSINSTAL to installE               PATHWORKS for OpenVMS (Macintosh). See Appendix A for a2)               sample installation script.s  G               Table 3-1 is a checklist of the steps you need to follow.   E                 ______________________ Caution ______________________   C                 Be sure you understand the information and complete C                 the tasks described in Chapter 2 before you performa7                 the installation tasks in this chapter.l  E                 _____________________________________________________w  F               Table 3-1 Checklist for Installing PATHWORKS for OpenVMSH               __________(Macintosh)_____________________________________  #               <   >Start VMSINSTAL.   5               <   >Respond to installation questions.o  ?               <   >Take appropriate action in response to error H               _____messages.____________________________________________                H                         Installing PATHWORKS for OpenVMS (Macintosh) 3-1 o  .                  Starting VMSINSTALv  /            To start the installation procedure:r  C            1. Log in to a privileged account on the server, such as !               the SYSTEM account.A  C               ________________________Note ________________________r  ;               If you are upgrading to PATHWORKS for OpenVMSnB               (Macintosh) Version 1.3, you must shut down whatever>               version of PATHWORKS for OpenVMS (Macintosh) youB               are running before you start the installation. To do:               this, from the SYS$MANAGER directory, enter:                     $ @MSA$SHUTDOWN  =               If you are installing on a VMScluster, you mustM>               do this on all nodes within the cluster that are8               running PATHWORKS for OpenVMS (Macintosh).  C               _____________________________________________________   4            2. Set the default directory by entering:  &               $ SET DEFAULT SYS$UPDATE  *            3. Start VMSINSTAL by entering:  7               $ @VMSINSTAL MSA013 device_name OPTIONS Ns  E               _______________________________________________________ E               Parameter___Description________________________________   '               MSA013      Product name.i  A               device_     Name of the device on which you plan topC               name        mount the media. For example, MTA0, MUA0,O@                           and MKA500 are device names for a tape                            drive.          5      3-2 Installing PATHWORKS for OpenVMS (Macintosh)                H                  _______________________________________________________H                  Parameter___Description________________________________  ?                  OPTIONS N   Optional parameter that causes thecG                              installation procedure to prompt you abouttF                              accessing online release notes during theE                              installation. Because the online release_D                              notes can contain important information>                              about changes to the installationC                              procedure, Digital recommends that you H                  ____________specify_OPTIONS_N._________________________  5               Interrupting the Installation Procedure   E               You can abort the installation procedure at any time byhC               pressing <Ctrl/Y>. The installation procedure deletesmG               all the files it has created and exits. You can start theH!               installation again.h  )         Responding to VMSINSTAL Questions   B               Each VMSINSTAL question you need to answer is markedE               with an asterisk (*) at the beginning of the line. SomesF               questions show a default response in brackets. FollowingB               is an example of a VMSINSTAL question with a default               answer:   4               * Do you want to continue anyway [NO]?  ;               To accept a default response, press <Return>.n  G               The following sections list the questions in the order in 8               which they appear during the installation.  F                 ________________________Note  ________________________  C                 Depending on the configuration of your OpenVMS sys- D                 tem, the dialog that occurs during your installationD                 may differ slightly from the examples that appear in                 this section.   E                 _____________________________________________________         H                         Installing PATHWORKS for OpenVMS (Macintosh) 3-3 c               &            General VMSINSTAL Questions              1. Active Processes  D               %VMSINSTAL-W-ACTIVE, The following processes are still               active:n                  .                  .                  .4               * Do you want to continue anyway [NO]?  *               Answer YES to this question.  D               The active processes and the installation procedure do,               not interfere with each other.              2. System Backuph  @               * Are you satisfied with the backup of your system               disk [YES]?   A               If you have not made a backup, or are not satisfiedv?               with the backup you made, enter NO to discontinue C               the installation. After you back up your system disk,,'               restart the installation.r  A               If you are satisfied with the backup of your systemp#               disk, press <Return>._               3. Mounting the Media  @               VMSINSTAL displays the following prompt for you to               mount the media:  @               Please mount the first volume of the set on MUA0:.               * Are you ready?  E               Answer YES after you have mounted the media on the tapee:               drive. Answer NO to cancel the installation.  D               VMSINSTAL displays messages stating that the volume isC               mounted and the installation of PATHWORKS for OpenVMS_'               (Macintosh) is beginning:k  =               %MOUNT-I-MOUNTED, MSA013 mounted on SRVR2$MUA0:n  7               The following products will be processed:f                   MSA V1.3  =                   Beginning installation of MSA V1.3 at 11:43k  5      3-4 Installing PATHWORKS for OpenVMS (Macintosh)  e  u            G                  %VMSINSTAL-I-RESTORE, Restoring product save set A ...                  4. Release Notes  @                  Release notes included with this kit are always$                  copied to SYS$HELP.  2                  Additional Release Notes Options:  -                      1. Display release notesT+                      2. Print release notes $                      3. Both 1 and 2)                      4. None of the aboves  %                  * Select option [2]:l  F                  VMSINSTAL prompts you about release notes only if you@                  specified OPTIONS N when you started VMSINSTAL.  G                  o  If you select option 1 or 3, VMSINSTAL displays the F                     release notes immediately on the console terminal.  @                     You can terminate the display at any time by&                     pressing <Ctrl/C>.  F                  o  If you select option 2 or 3, VMSINSTAL prompts youD                     for the name of the print queue that you want to                     use:  -                     * Queue name [SYS$PRINT]:   E                     Enter a queue name, or press <Return> to send thet<                     file to the default output print device.  G                  The file name for the release notes is MSA013.RELEASE_EF                  NOTES. VMSINSTAL moves the release notes to SYS$HELP,8                  whether or not you specified OPTIONS N.  :               5. Installation Verification Procedure (IVP)  K                  * Do you want to run the IVP after the installation [YES]?_  G                  o  To run the IVP automatically after the installationo.                     procedure, press <Return>.  D                  o  To run the IVP independently of the installationE                     procedure, enter NO. Instructions for running the G                     IVP independently of the installation procedure are !                     in Chapter 4.r  H                         Installing PATHWORKS for OpenVMS (Macintosh) 3-5 t               C               ________________________Note ________________________   <               If you have a version of AppleTalk for OpenVMS;               already installed on your system, the IVP may ?               not run automatically. If it does not, you should @               reboot your system and run the IVP as described in               Chapter 4.  C               _____________________________________________________               6. Purging Files   ;               * Do you want to purge files replaced by this !               installation [YES]?o  D               Purging deletes the old versions of the files replacedE               by the installation and saves disk space. If you choose A               not to have the installation procedure purge files, E               you can purge the files manually after you complete the (               installation successfully.  %            Questions About Componentso  %            1. Selection of Components-  G               Component #  Component Name                      Requires_G               ---------------------------------------------------------_/                  1        AppleTalk for OpenVMS6E                  2        AppleTalk/DECnet Gateway                [1] E                  3        DECshare File Server                    [1]8E                  4        DECshare Print Server                   [1] F                  5        DECwindows AppleTalk (ADSP) Transport  [1,2]/                  6        PATHWORKS Mail ServeroE                  7        PATHWORKS Online Documentation (PostScript)   <               * Do you wish to install all components [YES]?  =               The column on the right identifies prerequisite @               components. For example, the DECshare print serverB               component requires AppleTalk for OpenVMS Version 3.2               (component 1).  C               ________________________Note ________________________   <               The PATHWORKS for Macintosh Version 1.3 client?               software kit requires AppleTalk for OpenVMS (com-e?               ponent 1) and the DECshare file server (componentY  5      3-6 Installing PATHWORKS for OpenVMS (Macintosh)R    $            ?                 3). Refer to the PATHWORKS for Macintosh Clientv;                 Administrator's Guide for more information.-  E                 _____________________________________________________r  >                  o  To install all components, press <Return>.  G                  o  To install some, but not all, components, enter NO.   D                     When you enter NO, VMSINSTAL asks you about each)                     individual component:S  =         * Do you wish to install AppleTalk for OpenVMS [YES]?T5         * Do you wish to install the AppleTalk/DECnete           Gateway [YES]?2         * Do you wish to install the DECshare File           Server [YES]?W3         * Do you wish to install the DECshare Print            Server [YES]?P9         * Do you wish to install the DECwindows AppleTalk !           (ADSP) Transport [YES]? A         * Do you wish to install the PATHWORKS Mail Server [YES]? Q         * Do you wish to install the online documentation PostScript files [YES]?l  @                     -  If you want to install a component, press                         <Return>.  A                     -  If you do not want to install a particularn+                        component, enter NO._  +               2. Verification of Components   H                  If you chose to install only some components, VMSINSTALE                  displays the components you selected and asks you to 2                  confirm that the list is correct:  B                  The following components have been selected to be                  installed:o  *                      AppleTalk for OpenVMS-                      AppleTalk/DECnet Gatewayi)                      DECshare File Serverc1                      DECshare Print Server (ADSP)y3                      DECwindows AppleTalk TransportT*                      PATHWORKS Mail Server@                      PATHWORKS Online Documentation (PostScript)  H                         Installing PATHWORKS for OpenVMS (Macintosh) 3-7                 &               * Is this correct [YES]?  8               o  If the list is correct, press <Return>.  4               o  If the list is incorrect, enter NO.  B                  VMSINSTAL displays the series of questions again,A                  so that you can select individual components for                   installation.  5            3. System Check for Component Requirements_  C               VMSINSTAL checks the system to make sure it meets thet:               requirements of the components you selected:  B               %MSA-I-CHECKSYS, Now checking component requirements               against system...t  >               o  If all requirements are met, the installation                  proceeds.  D               o  If the system does not meet the requirements of anyD                  component, VMSINSTAL tells you what requirement was5                  not met, and the installation fails.   C                  After you correct the condition, you can start theh$                  installation again.  -            4. Verification of Product License   D               VMSINSTAL displays a list of Product Authorization KeyD               (PAK) names. The terms for use of this product require,               that you have a valid license.  ?               VMSINSTAL asks if one of these authorization keys >               is registered and loaded. If you answer YES, the;               installation continues. If you answer NO, thetD               installation also continues. However, the InstallationD               Verification Procedure is not run and you are prompted=               to load the license before starting the server.t  *            AppleTalk for OpenVMS Questions  0            1. Keeping the Existing Configuration  @               If AppleTalk for OpenVMS was previously installed,C               VMSINSTAL gives you the option of using your existingw&               configuration data file:  5      3-8 Installing PATHWORKS for OpenVMS (Macintosh)                  <                  * Do you want to use the existing AppleTalk'                    configuration [YES]?t  D                  If you answer YES, VMSINSTAL skips to the AppleTalk5                  /DECnet Transport Gateway questions.e  .               2. Choosing a Network Controller  H                  If there are multiple network controllers (Ethernet andE                  FDDI) installed on your server, VMSINSTAL lists them A                  and asks which one you want to use. For example:   Q                  The following suitable communications devices were found on your                   system:  -                                          XQA0 -                                          XQB0_  A                  * Which device do you want used as the AppleTalkr&                  primary port? [XQA0]:  E                  If you want to use AppleTalk for OpenVMS on multiple H                  network communications devices, you need to set up yourE                  system as an AppleTalk router after you complete the D                  installation procedure. For instructions on settingF                  up your system as an AppleTalk router, see the Server'                  Administrator's Guide.P  B                  If you have only one network controller installedD                  on your server, the following informational messageB                  is displayed, and VMSINSTAL continues to the next                  component:   Q                  %MSA-I-ONEETHER, Only one suitable communications controller was %                  found on this system A                  -MSA-I-ONEETHER, AppleTalk will configure device )                  ESA0 as its primary porte  G                  %MSA-I-ENDATKQ, End of AppleTalk for OpenVMS questions_            H                         Installing PATHWORKS for OpenVMS (Macintosh) 3-9                 7            AppleTalk/DECnet Transport Gateway Questions   0            1. Keeping the Existing Configuration  E               If an AppleTalk/DECnet Transport Gateway was previously E               installed, VMSINSTAL gives you the option of using your -               existing gateway configuration:_  7               * Do you want to use the existing gatewayT"               configuration [YES]?  E               If you answer YES, VMSINSTAL skips to the DECshare fileiD               server questions. If you answer NO, VMSINSTAL asks you                to name a gateway.               2. Naming the Gateway  D               * Enter the name for the gateway [DECnet on nodename]:  B               The name you enter is the name that later appears inE               the Macintosh Gateway dialog box. The default answer is E               "DECnet on nodename", where nodename is the DECnet node_*               name of your OpenVMS server.  A               The gateway name must be 32 characters or fewer and >               must be unique among DECnet gateways in the sameA               AppleTalk zone. VMSINSTAL automatically retains the B               case of the letters you use for the gateway name. Do&               not use quotation marks.  )            DECshare File Server Questions   C            If a DECshare file server has not yet been configured on 7            this system, VMSINSTAL asks these questions:               1. Server Name   <               * Enter the server name for DECshare [DECshare               on nodename]:_  B               The name you enter is the name that later appears in/               the Macintosh Chooser dialog box.t  A               The default answer is "DECshare on nodename," wheree>               nodename is the DECnet node name of your OpenVMS               server._  6      3-10 Installing PATHWORKS for OpenVMS (Macintosh) _  _            H                  The server name must be 31 characters or fewer and mustD                  be unique among AppleShare file servers in the sameD                  AppleTalk zone. VMSINSTAL automatically retains theH                  case of the letters you use for the server name. Do not%                  use quotation marks.p                 2. Guest Access   F                  * Do you want to allow guest access to DECshare [NO]?  F                  Guest access allows all Macintosh users access to theG                  DECshare file server without a user name and password.   A                  If you enable guest access, VMSINSTAL creates antE                  account named MSAF$GUEST and asks you to specify theeF                  user identification code (UIC) for the guest account:  H                  * Enter the UIC for the MSAF$GUEST account [[360,200]]:  >                  If you are reinstalling PATHWORKS for OpenVMSF                  (Macintosh), and if the MSAF$GUEST account is already9                  defined, this question is not displayed._  G                  The UIC consists of a group number and a member number G                  separated by a comma and enclosed in brackets. The UIC G                  is used to determine whether the account has access tol                  files.d  F                  Accept the default UIC unless one of the following is                  true:  F                  o  You already have [360,200] assigned to a different                     account.  F                  o  You follow a different assignment scheme for UICs.  E               If you are doing an upgrade and a guest account alreadyxE               exists for which the UAF CAPTIVE is set, VMSINSTAL asks                this question:  D               * Clear the CAPTIVE flag for account MSAF$GUEST [YES]?  B               For each account that DECshare found to be used as aE               guest account, VMSINSTAL asks whether you wish to clearlB               the CAPTIVE flag. Refer to the PATHWORKS for OpenVMSG               (Macintosh) Server Reference Manual for more information.e  H                        Installing PATHWORKS for OpenVMS (Macintosh) 3-11 n               )            DECshare Print Server Questiont  E            If you are reinstalling PATHWORKS for OpenVMS (Macintosh),_<            and if the DECshare print server has already been?            installed, VMSINSTAL does not display this question.c  E            The DECshare print server requires an account for printing )            jobs from Macintosh computers.L  =            If you chose to install the DECshare print server,eC            VMSINSTAL creates an account named MSAP$ACCOUNT and asks 2            you to specify the UIC for the account:  C            * Enter the UIC for the MSAP$ACCOUNT account [[360,210]]o  A            The UIC consists of a group number and a member number D            separated by a comma and enclosed in brackets. The UIC isE            used to determine whether the account has access to files.]  @            Accept the default UIC unless one of the following is            true:  @            o  You already have [360,210] assigned to a different               account.  @            o  You follow a different assignment scheme for UICs.  )            Online Documentation Questionst  3            o  Online Documentation PostScript Files   /               * Enter location to install files #               [SYS$COMMON:[SYSHLP]:l  D               By default, VMSINSTAL places all files associated withD               the online documentation PostScript files in a defaultD               directory [SYS$COMMON:[SYSHLP]. If you prefer to placeA               them in a different directory, you must specify thes               directory name.I  &            Completing the Installation  9            VMSINSTAL displays a series of messages as it:O  +            1. Restores the product save setb  <            2. Installs the files and images for the selected               components  !            3. Creates directorieso  6      3-12 Installing PATHWORKS for OpenVMS (Macintosh) i  n            8               4. Moves files to their target directories  E               5. Runs the IVP and starts components (if you specified-@                  that the IVP should run automatically after the(                  installation procedure)  A               If you chose to run the IVP automatically after theS@               installation procedure, the following messages are               displayed:  K               ************************************************************* K               *                                                           * K               *    Now starting Installation Verification Procedure for   *tK               *    PATHWORKS for OpenVMS (Macintosh) V1.3                 *rK               *                                                           *dK               *************************************************************r  3               Starting AppleTalk for OpenVMS IVP...p               .y               .                .lP               ******************************************************************P               *                                                                *P               *    Installation Verification Procedure for PATHWORKS           *P               *    for OpenVMS (Macintosh) V1.3 has completed successfully.    *P               *                                                                *P               ******************************************************************  F               When the installation is complete, the following message               is displayed:t  <                  Installation of MSA V1.3 completed at 12:04  2                  VMSINSTAL procedure done at 12:04  F               If you do not plan to complete postinstallation tasks at;               this time, log out of the privileged account:                  $ LOGOUT            H                        Installing PATHWORKS for OpenVMS (Macintosh) 3-13 u  n            (            Error Messages and Conditions  #            VMSINSTAL Error Messages   =            If errors occur during the installation, VMSINSTALW2            displays the following failure message:  I            %VMSINSTAL-E-INSFAIL, The installation of MSA V1.3 has failed.   A            Errors can occur during the installation if any of the '            following conditions exists:V  8            o  The operating system version is incorrect.  9            o  A prerequisite software version is missing.P  >            o  Quotas necessary for successful installation are               insufficient._  E            o  System parameter values for successful installation arey               insufficient.e  '            o  Disk space is inadequate.]  C            If you are notified that any of these conditions exists,cC            take the appropriate action as indicated by the message.oC            For example, you might need to change a system parameters2            value or install prerequisite software.  A            For more information about the error messages that can =            be generated by these conditions, see your OpenVMS A            documentation on system messages, recovery procedures, -            and OpenVMS software installation.-              IVP Error Messages-  D            If errors occur with the software during the InstallationD            Verification Procedure, it displays the following failure            message:   J            %MSA-E-IVPFAIL, IVP for PATHWORKS for OpenVMS  (Macintosh) V1.3            has failed.  ?            In most cases, you can solve the problem by manuallyP@            starting the software and running the IVP separately,D            as described in Chapter 4. See the Server Administrator'sD            Guide for more information about error messages generated            by the software.   6      3-14 Installing PATHWORKS for OpenVMS (Macintosh)                          Next Steps  C               Now that you have installed the PATHWORKS for OpenVMS @               (Macintosh) software, you are ready to perform the<               postinstallation tasks described in Chapter 4.                                                                                H                        Installing PATHWORKS for OpenVMS (Macintosh) 3-15 (  p                  H                                                                        4H         ________________________________________________________________  H                                                   Postinstallation Tasks      F               Before you can use the PATHWORKS for OpenVMS (Macintosh)E               software, you must perform some postinstallation tasks.,  F               Table 4-1 is a checklist of the steps you need to follow)               for postinstallation tasks.   H               Table_4-1_Checklist_for_Postinstallation_Tasks____________  F               <   >Modify your system startup and shutdown procedures.    D               <   >If a previous version of AppleTalk for OpenVMS is=                    installed, reboot to load the new version.i  B               <   >If you did not run the IVP during the VMSINSTALF                    procedure, start PATHWORKS for OpenVMS (Macintosh),#                    and run the IVP.a    H               <___>Determine_the_steps_you_still_need_to_complete.______                              H                                               Postinstallation Tasks 4-1 e               :      Modifying Your System Startup and Shutdown Procedures  C            You must modify your system startup command file so that D            the components of PATHWORKS for OpenVMS (Macintosh) startD            automatically whenever your system is booted. The name ofD            the file that starts PATHWORKS for OpenVMS (Macintosh) is            MSA$STARTUP.COM.t  C               ________________________Note ________________________e  A               The system startup command file for VMS Version 5.xeA               is SYSTARTUP_V5.COM; for OpenVMS Version 6.x, it is                 SYSTARTUP_VMS.COM.  C               _____________________________________________________   A            Use any text editor to edit the system startup commandRE            file, inserting the line that starts PATHWORKS for OpenVMSsD            (Macintosh) after the lines that start the queue manager,@            DECnet network, and DECprint Printing Services (DCPS))            software (if it is installed).   C               ________________________Note ________________________e  A               If you are running DCPS and are using printers overnB               AppleTalk, you need to execute MSA$STARTUP first and(               then execute DCPS$STARTUP.  C               _____________________________________________________   6             $ START/QUE/MANAGER/BUFFER_COUNT=10/ . . .               .u               .o               .c;             $ IF F$SEARCH(SYS$SYSTEM:NETACP.EXE") .NES "" - 2            _$ THEN SUBMIT SYS$MANAGER:STARTNET.COM  D            o  If you want to use a batch procedure to submit networkE               startup, edit the line that starts the batch procedure.q               For example:  ?                $ IF F$SEARCH("SYS$SYSTEM:NETACP.EXE") .NES "" - 8               _$ THEN SUBMIT SYS$MANAGER:STARTNET.COM, -(               _$ SYS$STARTUP:MSA$STARTUP        4-2 Postinstallation Tasks  s  l            G               o  If you want to start your network interactively, placeSG                  the command @SYS$STARTUP:MSA$STARTUP after the commande)                  that starts the network:e  A                   $ IF F$SEARCH("SYS$SYSTEM:NETACP.EXE") .NES ""-S.                  _$ THEN @SYS$MANAGER:STARTNET,                   $ @SYS$STARTUP:MSA$STARTUP  E               You must also modify the SYSHUTDWN.COM file so that allhD               file server volumes are properly dismounted before theD               system completely shuts down. If this is not done, allG               mounted volumes require a full verification each time the "               server is restarted.  @               Add the following line to your SYSHUTDWN.COM file:  3               $ @SYS$MANAGER:MSA$SHUTDOWN NOCONFIRM   /         Rebooting to Load AppleTalk for OpenVMSn  D               If you had a previous version of AppleTalk for OpenVMS@               installed, VMSINSTAL informed you that you need toD               reboot to load the new version. Reboot your system now/               by entering the shutdown command:   $               $ @SYS$SYSTEM:SHUTDOWN  F               If you modified your system startup procedure correctly,D               PATHWORKS for OpenVMS (Macintosh) starts automatically&               when the system reboots.  1         Starting the Software and Running the IVPs  F               You can start the network and run the IVP now if you didC               not run it before either because you chose not to runmC               it as part of the installation procedure or because a F               previous version of AppleTalk for OpenVMS already exists               on your system.                  To run the IVP:n  <               1. Log in to the SYSTEM account at the server.  @               2. Enter the following to start the components youD                  installed if you did not modify your system startupD                  procedure file to invoke MSA$STARTUP automatically:  +                  $ @SYS$STARTUP:MSA$STARTUPc  H                                               Postinstallation Tasks 4-3 T               E               Messages are displayed identifying the components being                started.  3            3. Enter the following to start the IVP:r  %               $ @SYS$TEST:MSA$IVP.COM   >               When the IVP successfully completes all tests, a2               message to that effect is displayed.        Next Stepsy  =            Depending on your system and whether this is a newu:            installation, you must do one of the following:  E            o  If you have a VMScluster system, you must configure the /               system as described in Chapter 5.   8            o  If you have a standalone system, you must:  B               1. Make changes to the default network configuration5                  established by VMSINSTAL, if needed.   C                  See Chapter 2 in the Server Administrator's Guide.f  9               2. Add volumes to the DECshare file server.   C                  See Chapter 6 in the Server Administrator's Guide.   =               3. Change the default file server configurationu5                  established by VMSINSTAL, if needed.g  C                  See Chapter 7 in the Server Administrator's Guide.h  $               4. Add print services.  C                  See Chapter 8 in the Server Administrator's Guide.   E               5. Install the PATHWORKS for Macintosh client software.   C                  See the installation instructions in the PATHWORKSu<                  for Macintosh Client Administrator's Guide.            4-4 Postinstallation Tasks  w  i                  H                                                                        5H         ________________________________________________________________  H                                          Configuring a VMScluster System      ?               If you have a VMScluster system, you must performnA               configuration tasks at each of the servers on whichaC               you want to run PATHWORKS for OpenVMS (Macintosh). In H               a VMScluster system, if you have multiple system disks andE               you want to run PATHWORKS from all systems, you need tot4               install PATHWORKS on each system disk.  F               Table 5-1 is a checklist of the steps you need to follow/               to configure a VMScluster system.e  H               Table_5-1_Checklist_for_Configuring_VMScluster_Systems____  ?               <   >Replace the DCL tables at each server on the %                    VMScluster system.d    E               <   >Run the ATK$CONFIG configuration procedure at eachWE                    server where you want to run PATHWORKS for OpenVMSs                    (Macintosh).o  @               <   >Create a DECshare file server on each server.    H               <___>Determine_the_steps_you_still_need_to_complete.______                      H                                      Configuring a VMScluster System 5-1    u                  Replacing DCL Tables.  D            To use PATHWORKS for OpenVMS (Macintosh) on other serversD            in the VMScluster system, you must replace the version ofC            the DCL tables that is installed on the other VMScluster             servers:d  7            1. Log in to the SYSTEM account on a server.L  4            2. Start the INSTALL program by entering:                 $ INSTALLe  +            3. At the INSTALL prompt, enter:C  8               INSTALL> REPLACE SYS$LIBRARY:DCLTABLES.EXE  <            4. Repeat steps 1 through 3 at each server in the                VMScluster system.  3      Running the ATK$CONFIG Configuration Procedure$  @            The VMSINSTAL procedure configures your system to runB            PATHWORKS for OpenVMS (Macintosh) at one server. If youC            have a VMScluster system, you need to run the ATK$CONFIGnA            configuration procedure at each additional server node C            where you want to run PATHWORKS for OpenVMS (Macintosh).   E            ATK$CONFIG uses as defaults the same parameter values used E            by the VMSINSTAL installation procedure. If you accept theeC            defaults displayed by the ATK$CONFIG procedure, you will "            have equivalent setups.  4            The procedure accomplishes the following:  &            o  Sets up the primary port  9            o  Assigns network ranges for the primary port   6            o  Controls whether to enable event logging  2            o  Sets up the AppleTalk/DECnet gateway  ;            The procedure does not set up AppleTalk routing.   (      5-2 Configuring a VMScluster System e  o            !               Starting ATK$CONFIGg  >               To start the ATK$CONFIG configuration procedure:  6               1. Log in to the OpenVMS SYSTEM account.  ?               2. Start the configuration procedure by entering:   *                  $ @SYS$MANAGER:ATK$CONFIG  B               The procedure leads you through a series of prompts.H               Default answers appear in brackets after the questions. To/               accept a default, press <Return>.s  D               The following sections list the questions in the order=               they appear during the configuration procedure.s  F                 ________________________Note  ________________________  <                 You can abort the configuration procedure at@                 any time by pressing <Ctrl/Y>. The configurationB                 procedure deletes all the files it has created and9                 exits. You can start the procedure again.   E                 _____________________________________________________   )               Setting Up the Primary Portt  "               1. Primary Port Name  H                  What name do you want for your primary port? [Primary]:  D                  Enter a name or use the default name, Primary, that6                  appears in brackets after the prompt.  G                  The primary port is where AppleTalk name registrations G                  occur and where AppleTalk node addresses are acquired.nB                  The primary port must always be an Ethernet port.                 2. Zone Name  B                  What zone name do you want for your primary port?  H                  Enter a valid zone name for the primary port, or use anE                  asterisk (*) to select the default zone name defined #                  by another router.   A                  If you enter an invalid zone name, AppleTalk for C                  OpenVMS uses the default zone as the primary port.   H                                      Configuring a VMScluster System 5-3 i  e            #            Assigning Network Ranges   $            1. Start of Network Range  J               What do you want for the start of the network range? [65280]  ?               Enter a valid number for the start of the network B               range, or use the default value, 65280. The start ofE               the network range must be less than or equal to the end                of the range.   B               If the primary port is a seed port on a seed router,E               the start and end of the network range must match other +               routers on the same Ethernet.*  E               Otherwise, accept the defaults for the start and end of                 the network range.  "            2. End of Network Range  H               What do you want for the end of the network range? [65534]  D               Enter a valid number for the end of the network range,.               or use the default value, 65534.  ;               If you enter a number that conflicts with the*>               established range for the network, AppleTalk forD               OpenVMS uses the network's correct range provided by a$               router on the network.  B               You can manually reconfigure the permanent database.  +            Enabling/Disabling Event Logging               1. Logging   ,               Do you want to enable logging?  =               All error messages are displayed on the consoles               screen.u  C               o  If you want to store these messages in a log file,                    press <Return>.  D               o  If you do not want to store messages in a log file,                  enter NO.              2. Name of Log File  (      5-4 Configuring a VMScluster System                 D                  If you chose to store error messages in a log file,A                  ATK$CONFIG prompts you for the name of the file.   G                  What log file do you want? [SYS$MANAGER:ATK$EVENT.LOG]   E                  Use the default file name, or enter a different file                   name.  =               Defining the AppleTalk/DECnet Transport Gateway   )               1. Start AppleTalk Gateway?V  <                  Do you want to start the AppleTalk Gateway?  E                  o  If you want a gateway on this server, answer YES.s  D                  o  If you do not want a gateway configured for this&                     server, answer NO.                 2. Gateway Nameo  /                  What gateway name do you want?   H                  Use the default name, or enter a name such as DECnet on                  BOSTON.  4               Completing the Configuration Procedure                 1. Continue?  C                  ATK$CONFIG gives you the opportunity to cancel the )                  configuration procedure.   )                  Do you want to continue?   (                  o  To cancel, enter NO.  G                  o  To complete the configuration procedure, enter YES.c  "               2. Execute Commands?  F                  If you chose to complete the configuration procedure,F                  ATK$CONFIG displays the OpenVMS commands that executeA                  the answers you entered to prompts. For example:   H                                      Configuring a VMScluster System 5-5 a  ,            D               Here are the commands necessary to set up your system.)               $DEFINE/USER SYS$OUTPUT NL:o(               $DEFINE/USER SYS$ERROR NL:)               $RUN SYS$SYSTEM:ATK$MANAGER,'                DEFINE EXECUTOR STATE ON C                DEFINE LOGGING FILE NAME "SYS$MANAGER:ATK$EVENT.LOG"e+                DEFINE LOGGING FILE STATE ON.?                DEFINE GATEWAY APPLETALK NAME "DECnet ON BOSTON"l&                DEFINE GATEWAY STATE ON?                DEFINE PORT DEVICE XQA0: NAME "Primary" STATE ON4=                DEFINE PORT NAME "Primary" PRIMARY ON ZONE "*"oC                DEFINE PORT NAME "Primary" NETWORK RANGE 65280 65534                 EXITg  8               Do you want these commands to be executed?  4               o  To execute the commands, enter YES.  >                  A message is displayed notifying you that the>                  changes to your configuration have been made.  A               o  To cancel the configuration procedure, enter NO.               3. Start AppleTalk?  ,               Do you want AppleTalk started?  A               Enter NO. AppleTalk for OpenVMS is started when you A               start PATHWORKS for OpenVMS (Macintosh) in the next                section.  /      Starting PATHWORKS for OpenVMS (Macintosh)   @            If this is an upgrade, you need to reboot your systemA            to get the latest AppleTalk features. If this is a newa>            installation, you need to start the network and theB            components of PATHWORKS for OpenVMS (Macintosh) at eachB            server you configured with the ATK$CONFIG configuration            procedure:-  9            1. Log in to the SYSTEM account at the server.   "            2. Enter the following:  (               $ @SYS$STARTUP:MSA$STARTUP  E               Messages are displayed identifying the components being                started.  (      5-6 Configuring a VMScluster System o  i            F               3. When the DCL prompt ($) is displayed, you can log out'                  of the SYSTEM account:                     $ LOGOUT   8         Creating a DECshare File Server on Other Servers  G               To balance the load on servers in a VMScluster system, it E               is a good idea to create a DECshare file server on eachi               server.a  B               To create and make available a DECshare file server:  :               1. Log in to the SYSTEM account on a server.  8               2. Start the DECshare Manager by entering:  !                  $ ADMINISTER/MSAm  8               3. Add a DECshare file server by entering:  8                  MSA$MANAGER> ADD FILE_SERVER servername  H                  _______________________________________________________H                  Parameter___Description________________________________  B                  servername  The name of the new file server as itD                              appears to AppleShare workstations. TheG                              server name must be unique and can be fromoD                              1 to 31 characters long. If you includeC                              spaces in the server name, enclose the H                  ____________server_name_in_quotation_marks_(").________  D                  For example, to add a DECshare file server with the/                  name DECshare on SRVR1, enter:   A                  MSA$MANAGER> ADD FILE_SERVER "DECshare on SRVR1"   E               4. Make an OpenVMS file directory for users by adding a                   volume:          H                                      Configuring a VMScluster System 5-7                 F               MSA$MANAGER> ADD VOLUME volumename/ROOT=disk:[directory]  E               _______________________________________________________ E               Parameter___Description________________________________f  B               volumename  The name of the volume you are adding as@                           it appears to AppleShare workstations.B                           The volume name must be unique among allB                           volumes managed by a file server and canA                           be from 1 to 27 characters long. If yousD                           include spaces in the volume name, encloseA                           the volume name in quotation marks (").a  ?               disk:[directThe]OpenVMS location of the files anda<                           folders (subdirectories) that willE               ____________constitute_the_volume._____________________T  =               For example, to add a volume with the name VOL1 @               and place the files for the volume in the MAC_VOL1(               directory on DUA0:, enter:  ?               MSA$MANAGER> ADD VOLUME VOL1/ROOT=DUA0:[MAC_VOL1]   C               ________________________Note ________________________v  A               DECshare volumes cannot be shared by servers across @               nodes in a cluster. Each volume can be served by a!               single server only.D  C               _____________________________________________________   D               For more information about adding file server volumes,3               see the Server Administrator's Guide.n  0            5. Start the file server by entering:  7               MSA$MANAGER> START FILE_SERVER servernamet  B               For example, to start the DECshare file server named'               DECshare on SRVR1, enter:c  @               MSA$MANAGER> START FILE_SERVER "DECshare on SRVR1"  <            6. Repeat steps 1 through 5 at each server in the                VMScluster system.  (      5-8 Configuring a VMScluster System h  e                     Next Steps  F               Now that you have configured your VMScluster system, you               must:   B               1. Make changes to the default network configuration5                  established by VMSINSTAL, if needed.   C                  See Chapter 2 in the Server Administrator's Guide.   G               2. Install the XQP+ software if you want to increase yourt$                  server performance.  E                  See Appendix D for information on how to install thet                  XQP+ software.l  9               3. Add volumes to the DECshare file server.@  C                  See Chapter 6 in the Server Administrator's Guide.   D               4. Change the default file server configuration estab-0                  lished by VMSINSTAL, if needed.  C                  See Chapter 7 in the Server Administrator's Guide.e  $               5. Add print services.  C                  See Chapter 8 in the Server Administrator's Guide.,  E               6. Install the PATHWORKS for Macintosh client software.y  G                  See the installation instructions in the PATHWORKS for 8                  Macintosh Client Administrator's Guide.                        H                                      Configuring a VMScluster System 5-9    C                  H                                                                        AH         ________________________________________________________________  H                                               Sample Installation Script               $ SET DEF SYS$UPDATE*         $ @VMSINSTAL MSA013 MUA0 OPTIONS N  E              OpenVMS VAX Software Product Installation Procedure V6.0G  #         It is 20-DEC-1994 at 13:32.e  7         Enter a question mark (?) at any time for help.h  L         %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account.F         %VMSINSTAL-W-ACTIVE, The following processes are still active:          in left field2         * Do you want to continue anyway [NO]? YESI         * Are you satisfied with the backup of your system disk [YES] YES   1         The following products will be processed:u             MSA V1.3  4          Beginning installation of MSA V1.3 at 13:33  >         %VMSINSTAL-I-RESTORE, Restoring product save set A ...S         %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP._  L                     +------------------------------------------------------+I                     | PATHWORKS for OpenVMS (Macintosh), V1.3           | L                     +------------------------------------------------------+                H                                           Sample Installation Script A-1 .               M             *****************************************************************oM             *                                                               *AG             *                   Copyright (C) 1990,1995 by            * M             *     Digital Equipment Corporation, Maynard, Massachusetts     * M             *                              and                              * M             *          Apple Computer, Inc., Cupertino, California          * M             *                      All rights reserved.                     * M             *                                                               *oM             *****************************************************************s  D      * Do you want to run the IVP after the installation [YES]?  YESJ      * Do you want to purge files replaced by this installation [YES]? YES  M              PATHWORKS  for  OpenVMS  (Macintosh)  is  composed  of   several M              components.   This  installation  allows  you to select which of A              these components you wish to install on your system.l  M              Note that many of these components will require  that  AppleTalklM              for  OpenVMS  be installed.  These dependencies are noted in the M              table below in parenthesis (where [1] indicates that  'AppleTalk '              for OpenVMS' is required).A  M              Component #     Component Name                          Requires O              ------------------------------------------------------------------u2                  1           AppleTalk for OpenVMSK                  2           AppleTalk/DECnet Gateway                   [1] K                  3           DECshare File Server                       [1] K                  4           DECshare Print Server                      [1] L                  5           DECwindows AppleTalk (ADSP) Transport     [1,2]2                  6           PATHWORKS Mail ServerH                  7           PATHWORKS Online Documentation (PostScript)  7      * Do you wish to install all components [YES]? YESc  K      %MSA-I-CHECKSYS, Now checking component requirements against system...   )              Product:      PWXXMACAT01.03               Producer:     DEC              Version:      V1.3s%              Release Date: 1-DEC-1994s  )              Product:      PWASMACCC01.03               Producer:     DEC              Version:      V1.3 %              Release Date: 1-DEC-1994w  #      A-2 Sample Installation Script     A            ,                 Product:      PWASXXXFP01.02!                 Producer:     DEC "                 Version:      V1.3(                 Release Date: 1-DEC-1994  G         * Is one of these authorization keys registered and loaded? YES   H                 Questions will now be asked for the selected components.  0            *************************************0            *                                   *0            *  AppleTalk for OpenVMS Questions  *0            *                                   *0            *************************************  B         %MSA-I-ATKCONFIG, Now configuring AppleTalk for OpenVMS...  ]         %MSA-I-ONEETHER, Only one suitable communications controller was found on this system_Q         -MSA-I-ONEETHER, AppleTalk will configure device ESA0 as its primary port   >         %MSA-I-ENDATKQ, End of AppleTalk for OpenVMS questions  3            ****************************************e3            *                                      *o3            *  AppleTalk/DECnet Gateway Questions  *_3            *                                      *e3            ****************************************y  P                 The AppleTalk/DECnet Gateway allows you to specify a name  whichP                 will  identify  the  gateway on the AppleTalk network.  The nameP                 you specify can be up to 32 characters long and must  be  uniqueA                 among DECnet Gateways in the same AppleTalk zone.a  <         * Enter the name for the gateway [DECnet on PICKLE]:  C         %MSA-I-ENDATKGWQ, End of AppleTalk/DECnet Gateway questions.  /            ************************************u/            *                                  *E/            *  DECshare File Server Questions  *s/            *                                  * /            ************************************n      H                                           Sample Installation Script A-3                 M              You will now be asked for the name of the DECshare File  Server. M              This  is  the  name that appears in the Macintosh Chooser dialog M              box.  It must be a unique name  (32  characters  or  less)  that M              isn't the same as any other AppleShare file server's name in the !              same AppleTalk zone.a  D      * Enter the server name for DECshare [DECshare on PICKLE]:  YES  M              The DECshare File Server will allow guest access  for  Macintosh M              users  if you wish to enable it.  Enabling guest access requireseM              creating a non-privileged account  (MSAF$GUEST)  which  will  bem0              used as the DECshare guest account.  ?      * Do you want to allow guest access to DECshare [NO]?  YESe<      * Enter the UIC for the MSAF$GUEST account [[360,200]]:Q      %VMSINSTAL-I-ACCOUNT, This installation creates an ACCOUNT named MSAF$GUEST.e2      %UAF-I-ADDMSG, user record successfully added^      %UAF-I-RDBADDMSGU, identifier MSAF$GUEST value: [000360,000200] added to rights data baseW      %UAF-I-RDBADDMSGU, identifier MSA value: [000360,177777] added to rights data base Q      %VMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named MSAF$GUEST.n+      %UAF-I-MDFYMSG, user record(s) updated Q      %VMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named MSAF$GUEST. +      %UAF-I-MDFYMSG, user record(s) updated   ;      %MSA-I-ENDMSAFQ, End of DECshare File Server questionso  -         *************************************s-         *                                   * -         *  DECshare Print Server Questions  *e-         *                                   *<-         *************************************   M              The DECshare Print Server requires an account which will be usedeM              for  printing  jobs  received  from the Macintosh.  You must now <              enter a unique non-system UIC for this account.                    #      A-4 Sample Installation Scripte                 A         * Enter the UIC for the MSAP$ACCOUNT account [[360,210]]:GV         %VMSINSTAL-I-ACCOUNT, This installation creates an ACCOUNT named MSAP$ACCOUNT.5         %UAF-I-ADDMSG, user record successfully addedCc         %UAF-I-RDBADDMSGU, identifier MSAP$ACCOUNT value: [000360,000210] added to rights data basetV         %VMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named MSAP$ACCOUNT..         %UAF-I-MDFYMSG, user record(s) updatedV         %VMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named MSAP$ACCOUNT..         %UAF-I-MDFYMSG, user record(s) updatedV         %VMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named MSAP$ACCOUNT..         %UAF-I-MDFYMSG, user record(s) updated  ?         %MSA-I-ENDMSAPQ, End of DECshare Print Server questions   9            **********************************************p9            *                                            *o9            *  PATHWORKS Online Documentation Questions  * 9            *                                            *o9            **********************************************   P                 PATHWORKS Online Documentation (in PostScript format) by defaultP                 is installed in SYS$HELP.  You may specify an alternate locationP                 to install the documentation or accept the default  location  by                 hitting RETURN.   @         * Enter location to install files [SYS$COMMON:[SYSHLP]]:  G         %MSA-I-ENDOLDQ, End of PATHWORKS Online Documentation questions   P                 After this installation procedure completes, you  will  need  toP                 edit   your   site-specific   startup   command  file  found  in6                 SYS$MANAGER to add the following line:  ?                                  $ @SYS$STARTUP:MSA$STARTUP.COM   P                 This command procedure will start all  components  of  PATHWORKSP                 for  OpenVMS  (Macintosh)  which  have  been  installed  on this                 system.P  <                                      * * *   N O T E   * * *  D                             PATHWORKS for OpenVMS (Macintosh) shouldD                             be  started  only  after  DECnet and the<                             queue manager have been started.  P                 We will now begin the installation of files and images  for  the$                 selected components.  H                                           Sample Installation Script A-5 ?               6      %MSA-I-NOMORE, No further questions will be asked  ;      %VMSINSTAL-I-RESTORE, Restoring product save set B ...t;      %VMSINSTAL-I-RESTORE, Restoring product save set C ... ;      %VMSINSTAL-I-RESTORE, Restoring product save set E ...hV      %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.MSA].C      %MSA-I-ATKFILES, Now installing AppleTalk for OpenVMS files...lE      %MSA-I-ATKIMAGES, Now installing AppleTalk for OpenVMS images...PH      %MSA-I-ATKGWFILES, Now installing AppleTalk/DECnet Gateway files...J      %MSA-I-ATKGWIMAGES, Now installing AppleTalk/DECnet Gateway images...C      %MSA-I-MSAFFILES, Now installing DECshare File Server files...h  F      %VMSINSTAL-I-SYSDIR, This product creates system directory [MSA].  M          If you intend to execute this layered product on other nodes in your L          VAXcluster, and you have the appropriate software license, you mustL          prepare the system-specific roots on the other nodes by issuing theN          following command on each node (using a suitably privileged account):  <       $ CREATE /DIRECTORY SYS$SPECIFIC:[MSA]/OWNER_UIC=[1,4]  Q      %VMSINSTAL-I-SYSDIR, This product creates system directory [MSA.MSAF$ICONS].D\      %VMSINSTAL-I-SYSDIR, This product creates system specific directory [MSA.MSAF$SERVER0].E      %MSA-I-MSAMGIMAGES, Now installing DECshare management images...cE      %MSA-I-MSAFIMAGES, Now installing DECshare File Server images...tH      %MSA-I-MSAPDELFORM, Now deleting old DECshare Print Server forms...D      %MSA-I-MSAPFILES, Now installing DECshare Print Server files...S      %VMSINSTAL-I-SYSDIR, This product creates system directory [MSA.MSAP$UTILITY]._Z      %VMSINSTAL-I-SYSDIR, This product creates system specific directory [MSA.MSAP$SPOOL].F      %MSA-I-MSAPIMAGES, Now installing DECshare Print Server images...T      %MSA-I-DECWFILES, Now installing DECwindows AppleTalk (ADSP) Transport files...V      %MSA-I-DECWIMAGES, Now installing DECwindows AppleTalk (ADSP) Transport images...F      %MSA-I-MAILIMAGES, Now installing PATHWORKS Mail Server images...M      %MSA-I-DOCSFILES, Now installing PATHWORKS Online Documentation files...t<      %MSA-I-MISCFILES, Now installing miscellaneous files...>      %MSA-I-MISCIMAGES, Now installing miscellaneous images...S      %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...1  &      Starting AppleTalk for OpenVMS...  )      Starting AppleTalk/DECnet Gateway...   %      Starting DECshare File Server... 6      %MSA-I-STARTING, "DECshare on PICKLE" is starting  &      Starting DECshare Print Server...  #      A-6 Sample Installation Script[ e  r            K         %MSAP-I-UPDATE, updating printer device control library MSAP$DEVCTL e         %LIBRAR-S-INSERTED, module MSAP$PROCSET0 inserted in SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1 e         %LIBRAR-S-INSERTED, module MSAP$PROCSET1 inserted in SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1 e         %LIBRAR-S-INSERTED, module MSAP$PROCSET2 inserted in SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1fe         %LIBRAR-S-INSERTED, module MSAP$PROCSET3 inserted in SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1 e         %LIBRAR-S-INSERTED, module MSAP$PROCSET4 inserted in SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1ae         %LIBRAR-S-INSERTED, module MSAP$PROCSET5 inserted in SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1 C         %RENAME-I-RENAMED, SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TMP_TLB;1_8          renamed to SYS$COMMON:[SYSLIB]MSAP$DEVCTL.TLB;2+         %PURGE-I-NOFILPURG, no files purgede:         %MSA-I-PRTDATNOTFOUND, printer data file not found  9         Starting DECwindows AppleTalk (ADSP) Transport...   M                 *************************************************************_M                 *                                                           *lM                 *    Now starting Installation Verification Procedure for   *hM                 *    PATHWORKS for OpenVMS (Macintosh) V1.3                 * M                 *                                                           *eM                 *************************************************************m  -         Starting AppleTalk for OpenVMS IVP...i  W         AppleTalk for OpenVMS Version 3.2 component versions as of 20-DEC-1994 14:34:21   0          Component                       Version  1          Management interface            ATK V3.2 1          PS driver                       ATK V3.2a1          Protocol stack                  ATK V3.2h1          AppleTalk ACP                   ATK V3.2s1          AppleTalk messages              ATK V3.2 1          Runtime library                 ATK V3.2 1          Printer Runtime Library         ATK V3.2s1          EV driver                       ATK V3.2M3          GW driver                       ATKGW V1.3 3          Gateway ACP                     ATKGW V1.3 3          Gateway messages                ATKGW V1.3r  B          Performing Installation Verification on AppleTalk for VMS  .                             version 03.02-0000  9          Installation Verification Completed Successfullyn  H                                           Sample Installation Script A-7 v  m            -      Starting AppleTalk/DECnet Gateway IVP...a  N      %ATKGW-S-IVPPASS, AppleTalk/DECnet Gateway IVP has completed successfully  )      Starting DECshare File Server IVP... ]      %MSA-I-CONNECTED, connection established to file server "MSAF$IVP Test Server on PICKLE"rB      %MSA-I-STARTING, "MSAF$IVP Test Server on PICKLE" is starting]      %MSA-I-CONNECTED, connection established to file server "MSAF$IVP Test Server on PICKLE"WJ      %MSA-I-STOPPING_NOW, "MSAF$IVP Test Server on PICKLE" is stopping now  M      %MSAF-S-IVPPASS, the DECshare File Server IVP has completed successfullya  *      Starting DECshare Print Server IVP...<      %MSA-I-STARTING, "MSAP$IVP PICKLE Receiver" is starting<      %MSA-I-STARTING, "MSAP$IVP PICKLE Symbiont" is starting_      Job MSAP$IVP (queue MSAP$IVP_PICKLE_SYMBIONT, entry 3) started on MSAP$IVP_PICKLE_SYMBIONT_<      %MSA-I-STOPPING, "MSAP$IVP PICKLE Symbiont" is stopping<      %MSA-I-STOPPING, "MSAP$IVP PICKLE Receiver" is stopping  N      %MSAP-S-IVPPASS, the DECshare Print Server IVP has completed successfully  :      Starting DECwindows AppleTalk (ADSP) Transport IVP...  F             AppleTalk Data Stream Protocol (ADSP) DECwindows Transport>                      Installation Verification Procedure (IVP)  C      %MSAX-I-BEGIN, beginning part one (of two) - file verificationsP      %MSAX-I-CHECKING, checking for all required DECwindows ADSP Transport files/      %MSAX-S-ALLFOUND, all required files foundt(      %MSAX-I-COMPLETE, part one complete  N      %MSAX-S-IVPPASS, DECwindows ADSP Transport IVP has completed successfully  L              ***************************************************************L              *                                                             *L              *    Installation Verification Procedure for PATHWORKS for    *L              *    OpenVMS (Macintosh) V1.3 has completed successfully.     *L              *                                                             *L              ***************************************************************  '       VMSINSTAL procedure done at 14:35          $ LOGOUT:         SYSTEM       logged out at 20-DEC-1994 14:36:13.92  #      A-8 Sample Installation Script                        H                                                                        BH         ________________________________________________________________  H                                           Files Installed on Your System      @               The PATHWORKS for OpenVMS (Macintosh) installationE               procedure installs a number of files in your SYS$COMMON                root device.  G               This appendix lists the files installed, their locations, C               and the component with which each file is associated.*  D               Files are listed by directory in the following tables:  7               SYS$COMMON:[MSA]                Table B-1   7               SYS$COMMON:[MSA.MSAF$ICONS]     Table B-2t  7               SYS$COMMON:[MSA.MSAP$UTILITY]   Table B-3c  7               SYS$COMMON:[SYS$LDR]            Table B-4t  7               SYS$COMMON:[SYS$STARTUP]        Table B-5   7               SYS$COMMON:[SYSEXE]             Table B-6t  7               SYS$COMMON:[SYSHLP]             Table B-7l  7               SYS$COMMON:[SYSHLP.EXAMPLES.MSA]Table B-8n  7               SYS$COMMON:[SYSLIB]             Table B-9   8               SYS$COMMON:[SYSMGR]             Table B-10  8               SYS$COMMON:[SYSMSG]             Table B-11  8               SYS$COMMON:[SYSTEST]            Table B-12  8               SYS$COMMON:[SYSTEST.ATK]        Table B-13  8               SYS$COMMON:[SYSTEST.ATKGW]      Table B-14  H                                       Files Installed on Your System B-1                 E            Table_B-1_Directory:_SYS$COMMON:[MSA]_____________________   E            File_Name__________________Component______________________   :            MSA$CREATE_ACCOUNTS.COM    DECshare file server  :            MSAF$CLEANUP.COM           DECshare file server  :            MSAF$COMPRESS.COM          DECshare file server  :            MSAF$DELETE_INTRUSION.COM  DECshare file server  :            MSAF$EXCLUDE.TEMPLATE      DECshare file server  :            MSAF$FILE_TYPES.TEMPLATE   DECshare file server  :            MSAF$GET_AND_HOLD_VOLUME_  DECshare file server            LOCK.EXEr  :            MSAF$ICONS.DAT             DECshare file server  :            MSAF$PROMISE_VOLUME_WAS_   DECshare file server            ONLY_MOVED.EXEr  :            MSAF$REPLACE_CONTROL_      DECshare file server            FILE.EXEa  :            MSAF$REPORT.COM            DECshare file server  :            MSAF$RUN.COM               DECshare file server  :            MSAF$SHOW_INTRUSION.COM    DECshare file server  E            MSAF$SYRUN.TEMPLATE________DECshare_file_server___________d  E            Table_B-2_Directory:_SYS$COMMON:[MSA.MSAF$ICONS]__________c  E            File_Name__________________Component______________________   :            DDIF_CDAD.DAT              DECshare file server  :            DOTS_CDAD.DAT              DECshare file server  :            DTIF_CDAD.DAT              DECshare file server  :            EXE_VMSS.DAT               DECshare file server  :            MBIN_DECM.DAT              DECshare file server  :            NOGO_MSAF.DAT              DECshare file server  :            OBJ_VMSS.DAT               DECshare file server  :            OLB_VMSS.DAT               DECshare file server  :            PICT_MDRW.DAT              DECshare file server  E                                              (continued on next page)   '      B-2 Files Installed on Your System     *            H               Table_B-2_(Cont.)_Directory:_SYS$COMMON:[MSA.MSAF$ICONS]__  H               File_Name__________________Component______________________  =               PNTG_MPNT.DAT              DECshare file server   =               TEXT_TTXT.DAT              DECshare file server   =               TEXT_VMSS.DAT              DECshare file server   =               TEXT_XCEL.DAT              DECshare file servern  =               UNKN_MSAF.DAT              DECshare file serverI  =               WDBM_MSWD.DAT              DECshare file server   H               WORD_MACA.DAT______________DECshare_file_server___________  H               Table_B-3_Directory:_SYS$COMMON:[MSA.MSAP$UTILITY]________  H               File_Name__________________Component______________________  >               APLWIIF1.PPD               DECshare print server  >               APLWIIF2.PPD               DECshare print server  >               APLWIIG1.PPD               DECshare print server  >               APLWIIG2.PPD               DECshare print server  >               APLWSEL.PPD                DECshare print server  >               APPLE380.PPD               DECshare print server  >               APPLE422.PPD               DECshare print server  >               APTOLLD1.PPD               DECshare print server  >               APTOLLW1.PPD               DECshare print server  >               DC1152F1.PPD               DECshare print server  >               DC1152_1.PPD               DECshare print server  >               DC2150P1.PPD               DECshare print server  >               DC2250P1.PPD               DECshare print server  >               DC3250_1.PPD               DECshare print server  >               DC3500_1.PPD               DECshare print server  >               DCCOLOR1.PPD               DECshare print server  >               DCL11501.PPD               DECshare print server  >               DCL21501.PPD               DECshare print server  H                                                 (continued on next page)  H                                       Files Installed on Your System B-3 C  N            E            Table_B-3_(Cont.)_Directory:_SYS$COMMON:[MSA.MSAP$UTILITY]-  E            File_Name__________________Component______________________%  ;            DCL22501.PPD               DECshare print server   ;            DCLF02F1.PPD               DECshare print server*  ;            DCLF02_1.PPD               DECshare print server   ;            DCLN03R1.PPD               DECshare print server   ;            DCLPS171.PPD               DECshare print server*  ;            DCLPS201.PPD               DECshare print serverv  ;            DCLPS321.PPD               DECshare print serverr  ;            DCLPS401.PPD               DECshare print server   ;            DCPS1721.PPD               DECshare print server   ;            DCPS1761.PPD               DECshare print server   ;            DCPS17L1.PPD               DECshare print server3  ;            DCTPS201.PPD               DECshare print servera  ;            ENGLISH.TXT                DECshare print server   ;            LWNTX470.PPD               DECshare print servere  ;            LWNTX518.PPD               DECshare print servert  ;            LWNT_470.PPD               DECshare print serverC  ;            MSAP$BUILD_FORM.COM        DECshare print server)  ;            MSAP$CONVERT_OUTPUT.EXE    DECshare print servere  ;            MSAP$DECPREP0_0.PS         DECshare print serverr  ;            MSAP$DECPREP5_0.PS         DECshare print servero  ;            MSAP$DECPREP5_1.PS         DECshare print serverG  ;            MSAP$DECPREP5_2.PS         DECshare print servers  ;            MSAP$DECPREP6_0.PS         DECshare print server*  ;            MSAP$DECPREP7_0.PS         DECshare print server   ;            MSAP$INSERT_DECPREP.COM    DECshare print servera  ;            MSAP$SET_PARAMS.PS         DECshare print server   E            MSAP$SHOW_PARAMS.PS________DECshare_print_server__________   '      B-4 Files Installed on Your Systemn i  (            H               Table_B-4_Directory:_SYS$COMMON:[SYS$LDR]_________________  H               File_Name__________________Component______________________  >               ATK$APPLETALK_PROTOCOL_    AppleTalk for OpenVMS               STACK.EXE[2]  A               ATKGW$GWDRIVER.EXE[1]      AppleTalk/DECnet Gateway   >               ATK$PSDRIVER.EXE[1]        AppleTalk for OpenVMS  >               ATK$EVDRIVER.EXE[1]        AppleTalk for OpenVMS  >               EVDRIVER.EXE[2]            AppleTalk for OpenVMS  C               GWDRIVER.EXE[2]            AppleTalk/DECnet Transport:0                                          Gateway  >               PSDRIVER.EXE[2]            AppleTalk for OpenVMSH               [1]Alpha_only_____________________________________________                 [2]VAX onlytH               __________________________________________________________  H               Table_B-5_Directory:_SYS$COMMON:[SYS$STARTUP]_____________  H               File_Name__________________Component______________________  >               ATK$STARTUP.COM            AppleTalk for OpenVMS  C               ATKGW$STARTUP.COM          AppleTalk/DECnet Transporto0                                          Gateway  7               MSA$STARTUP.COM            All components   7               MSA$SYSTARTUP.TEMPLATE     All components%  =               MSAF$STARTUP.COM           DECshare file serverA  =               MSAX$STARTUP.COM           DECshare file server-  >               MSAP$STARTUP.COM           DECshare print server  H               MSAX$STARTUP.COM___________DECwindows_ADSP_transport______  H               Table_B-6_Directory:_SYS$COMMON:[SYSEXE]__________________  H               File_Name__________________Component______________________  >               ATK$APPLETALK_ACP.EXE      AppleTalk for OpenVMS  >               ATK$MANAGER.EXE            AppleTalk for OpenVMS  H                                                 (continued on next page)  H                                       Files Installed on Your System B-5 R  h            E            Table_B-6_(Cont.)_Directory:_SYS$COMMON:[SYSEXE]__________s  E            File_Name__________________Component______________________v  @            ATKGW$APPLETALK_           AppleTalk/DECnet Transport-            GATEWAY.EXE                Gatewayi  9            MSA$MANAGER.EXE            DECshare Managementa  9            MSA$RMI_AGENT.EXE          DECshare ManagementC  4            MSA$STOP_DEVICE_           All components            OWNERS.EXEs  :            MSAF$SERVER.EXE            DECshare file server  ;            MSAP$RECEIVER.EXE          DECshare print server.  ;            MSAP$SYMBIONT.EXE          DECshare print serverm  4            MSAX$CLIENT.COM            All components  4            MSAX$ERROR.EXE             All components  ?            MSAX$MODMAP.EXE            DECwindows ADSP transportN  4            MSAX$NORESTART.EXE         All components  4            MSAX$SET_LOGICAL.EXE       All components  4            MSAX$TEST.COM              All components  4            MSAX$VERIFY.EXE            All components  ;            PCSA$MAIL_SERVER.EXE       PATHWORKS Mail servera  E            PCSA_CLAIM_NAME.EXE________PATHWORKS_Mail_server__________   E            Table_B-7_Directory:_SYS$COMMON:[SYSHLP]__________________l  E            File_Name__________________Component______________________P  B            ATK$HELP.HLB               AppleTalk for OpenVMS online*                                       help  9            MSA$MANAGER.HLB            DECshare Management   E            MSA013$ADMIN_GUIDE.PS      Online documentation PostScriptS+                                       filesh  E            MSA013$ADMIN_REF.PS        Online documentation PostScript +                                       files   E            MSA013$INSTALL_GUIDE.PS    Online documentation PostScriptP+                                       filesP  E            MSA013$INTRO_APPLETALK.PS  Online documentation PostScript E            ___________________________files__________________________D  '      B-6 Files Installed on Your SystemM $  C            H               Table_B-8_Directory:_SYS$COMMON:[SYSHLP.EXAMPLES.MSA]_____  H               File_Name__________________Component______________________  >               ATK$TERMINAL.EXE           AppleTalk for OpenVMS  >               ATK$TERMINAL_STARTUP.COM   AppleTalk for OpenVMS  >               ATKVMS_SAMPLE.BCK          AppleTalk for OpenVMS  7               BACKUP-MAC.COM             All components4  7               BROADCAST.COM              All components   7               BUILD_TALKER.COM           All componentsS  =               MSAF$COMMENT.EXE           DECshare file server,  =               MSAF$COPYPROTECT.EXE       DECshare file serverY  =               MSAF$MBIN_DUMP.C           DECshare file servero  =               MSAF$MBIN_DUMP.EXE         DECshare file servern  B               MSAX$INSCRIPTIONAL_        DECwindows ADSP transport#               EXTENDED_KEYBOARD.DAT*  B               MSAX$POSITIONAL_EXTENDED   DECwindows ADSP transport               _KEYBOARD.DAT   B               MSAX$STANDARD_EXTENDED     DECwindows ADSP transport               _KEYBOARD.DAT   7               TALKER.C                   All components)  7               TALKER.EXE                 All components   7               TALKER.H                   All components   7               ZONELIST.C                 All components*  H               ZONELIST.EXE_______________All_components_________________  H               Table_B-9_Directory:_SYS$COMMON:[SYSLIB]__________________  H               File_Name__________________Component______________________  >               ATK$API_SYMBOLS.ADA        AppleTalk for OpenVMS  >               ATK$API_SYMBOLS.FOR        AppleTalk for OpenVMS  >               ATK$API_SYMBOLS.H          AppleTalk for OpenVMS  >               ATK$API_SYMBOLS.MAR        AppleTalk for OpenVMS  >               ATK$API_SYMBOLS.PAS        AppleTalk for OpenVMS  H                                                 (continued on next page)  H                                       Files Installed on Your System B-7 A  W            E            Table_B-9_(Cont.)_Directory:_SYS$COMMON:[SYSLIB]__________   E            File_Name__________________Component______________________   ;            ATK$API_SYMBOLS.PLI        AppleTalk for OpenVMSm  ;            ATK$API_SYMBOLS.R32        AppleTalk for OpenVMS   ;            ATK$MESSAGES.ADA           AppleTalk for OpenVMSt  ;            ATK$MESSAGES.FOR           AppleTalk for OpenVMSA  ;            ATK$MESSAGES.H             AppleTalk for OpenVMSS  ;            ATK$MESSAGES.MAR           AppleTalk for OpenVMSn  ;            ATK$MESSAGES.PAS           AppleTalk for OpenVMSK  ;            ATK$MESSAGES.PLI           AppleTalk for OpenVMS   ;            ATK$MESSAGES.R32           AppleTalk for OpenVMS   ;            ATK$APPLETALK_RTL.EXE      AppleTalk for OpenVMSN  ;            ATK$PAP_RTL.EXE            AppleTalk for OpenVMSS  @            ATKGW$SSI_ROUTINES.OLB     AppleTalk/DECnet Transport-                                       Gateway.  @            ATKGW$SSI_SYMBOLS.ADA      AppleTalk/DECnet Transport-                                       Gateway   @            ATKGW$SSI_SYMBOLS.FOR      AppleTalk/DECnet Transport-                                       GatewayS  @            ATKGW$SSI_SYMBOLS.H        AppleTalk/DECnet Transport-                                       Gateway   @            ATKGW$SSI_SYMBOLS.MAR      AppleTalk/DECnet Transport-                                       Gatewaya  @            ATKGW$SSI_SYMBOLS.PAS      AppleTalk/DECnet Transport-                                       Gateway   @            ATKGW$SSI_SYMBOLS.PLI      AppleTalk/DECnet Transport-                                       Gatewayt  @            ATKGW$SSI_SYMBOLS.R32      AppleTalk/DECnet Transport-                                       Gatewayr  ?            DECW$TRANSPORT_ADSP.EXE    DECwindows ADSP transport   E                                              (continued on next page)l  '      B-8 Files Installed on Your System* *  *            H               Table_B-9_(Cont.)_Directory:_SYS$COMMON:[SYSLIB]__________  H               File_Name__________________Component______________________  =               MSAF$SYS_STB_SHR.EXE       DECshare file server1  >               MSAP$DEVCTL.TLB            DECshare print server  >               MSAP$TRANS_POSTSCRIPT.EXE  DECshare print server  >               MSAP$TRANS_TEXT.EXE        DECshare print server  >               NETBIOS.EXE                PATHWORKS Mail server  >               NETBIOSSHR.EXE             PATHWORKS Mail server  H               PCSA_MAILSHR.EXE___________PATHWORKS_Mail_server__________  H               Table_B-10_Directory:_SYS$COMMON:[SYSMGR]_________________  H               File_Name__________________Component______________________  >               ATK$CONFIG.COM             AppleTalk for OpenVMS  >               EVLOAD.COM                 AppleTalk for OpenVMS  H               MSA$SHUTDOWN.COM___________All_components_________________  H               Table_B-11_Directory:_SYS$COMMON:[SYSMSG]_________________  H               File_Name__________________Component______________________  >               ATK$MESSAGES.EXE           AppleTalk for OpenVMS  C               ATKGW$MSG.EXE              AppleTalk/DECnet Transport 0                                          Gateway  <               MSA$MI_MSG.EXE             DECshare Management  =               MSAF$MSG.EXE               DECshare file server   =               MSAF$PWL_MSG.EXE           DECshare file server   >               MSAP$MSG.EXE               DECshare print server  H               MSAX$ADSP_MSG.EXE__________DECwindows_ADSP_transport______  H                                       Files Installed on Your System B-9    l            E            Table_B-12_Directory:_SYS$COMMON:[SYSTEST]________________   E            File_Name__________________Component______________________Y  4            MSA$IVP.COM                All components  :            MSAF$IVP.COM               DECshare file server  ;            MSAP$IVP.COM               DECshare print server   E            MSAX$IVP.COM_______________DECwindows_ADSP_transport______   E            Table_B-13_Directory:_SYS$COMMON:[SYSTEST.ATK]____________   E            File_Name__________________Component______________________   E            ATK$IVP.EXE________________AppleTalk_for_OpenVMS__________U  E            Table_B-14_Directory:_SYS$COMMON:[SYSTEST.ATKGW]__________   E            File_Name__________________Component______________________e  @            ATKGW$IVP.EXE              AppleTalk/DECnet TransportE            ___________________________Gateway________________________                                           (      B-10 Files Installed on Your System                       H                                                                        CH         ________________________________________________________________  H              DECnet Objects Created by PATHWORKS for OpenVMS (Macintosh)      G               The following DECnet objects are created by PATHWORKS for                VMS (Macintosh):  H         ________________________________________________________________                       ObjectH         Object_Name___Number__Used_by..._____Description________________  C         ATK$ROUTER    85      AppleTalk for  Used by the router fornA                               OpenVMS        DECnet tunnel ports.   A         ATKGW$GWAY    0       AppleTalk      Used to make DECnet-eA                               /DECnet        to-AppleTalk gateway 9                               Transport      connections.l%                               Gateway   >         MSA$RMI       0       DECshare file  A DECshare remoteH                               and print      management interface objectG                               servers        used for remote managementvG                                              of DECshare file and print 5                                              servers.x  >         MSAX$CLIENT   0       MacX X         Used for starting>                               Window server  DECwindows client:                               (Macintosh     applications.*                               application)  ?         PCSA$MAIL     0       PATHWORKS      Used for accessing D                               Mail server    PATHWORKS Mail from theH         _____________________________________Macintosh._________________            H          DECnet Objects Created by PATHWORKS for OpenVMS (Macintosh) C-1 h                     H                                                                        DH         ________________________________________________________________  H                                                      Installing the XQP+      H               The DECshare file server supports an improved OpenVMS fileH               system (XQP+). The XQP+ is an enhanced version of the XQP,E               and helps improve the performance of your PATHWORKS forD)               OpenVMS (Macintosh) server.   A               A single separately installable kit is provided for A               OpenVMS VAX Version 5.5-2 a nd Version 6.0 systems.   H               VAX and Alpha OpenVMS Version 6.1 systems include the XQP+H               features as part of the standard system. All that needs toH               be done on Version 6.1 is to enable the appropriate SYSGENB               parameters (see the OpenVMS Version 6.1 New Features"               Manual for details).  H               For more information on the XQP+ features and installation.               on a VMScluster, see Appendix E.           Installation Steps  6               To install the XQP+, follow these steps:  H               1. Check that you are running OpenVMS VAX Version 5.5-2 or                  6.0.   ;               2. Check that you do not have an XQP image inn'                  SYS$SPECIFIC:[SYSEXE].   A                  The installation procedure aborts if it finds an ;                  F11BXQP.EXE file in SYS$SPECIFIC:[SYSEXE].   *               3. Back up your system disk.  3               4. Choose a time when you can reboot.n  H               5. Enter the following command to run VMSINSTAL to install>                  the XQP+ on OpenVMS VAX Version 5.5-2 or 6.0:  @                  $ @SYS$UPDATE:VMSINSTAL VAXPWF11X01_060 device:  H                                                  Installing the XQP+ D-1    s            @               where device: is the name of the tape drive or theC               disk and directory where the VAXPWF11X01_060.A kit is                stored.P  C               ________________________Note ________________________   =               This single installable kit (VAXPWF11X01_060.A) ;               contains versions of the XQP+ for OpenVMS VAX %               Versions 5.5-2 and 6.0.   C               _____________________________________________________P  >            6. If you are running the XQP+ in a VMScluster, set<               the XQP+ related system parameters to the same>               values on all the nodes (VMSD2 and ACP_WRITEBACKB               for OpenVMS VAX Version 5.5-2 and XQPCTLD1, XQPCTL2,A               ACP_WRITEBACK for OpenVMS VAX Version 6.x). See thePB               next section, Responding to VMSINSTAL Questions, for               more information.C  C               The installation procedure sets the system parameters E               only on the node on which you run the procedure. If youME               have a VMScluster with multiple system disks, make surePE               you run the installation procedure on each system disk.P  &      Responding to VMSINSTAL Questions  ?            Each VMSINSTAL question you need to answer is marked C            with an asterisk (*)  at the beginning of the line. Some$C            questions show a default response in square brackets. ToT.            accept the default, press <Return>.  C            The following is a list of questions that VMSINSTAL asksAA            during the installation. Depending on your system, you4?            might see additional messages and questions when you %            perform your installation:L              1. Active Processes  L               %VMSINSTAL-W-ACTIVE, The following processes are still active:               .T               .k               . 4               * Do you want to continue anyway [NO]?                 Enter YES.        D-2 Installing the XQP+ R  R                           2. System Backup  O                  * Are you satisfied with the backup of your system disk [YES]?R  D                  If you have not made a backup, or are not satisfied?                  with the backup you made, enter NO to stop the C                  installation. After you have backed up your systemA0                  disk, restart the installation.  D                  If you are satisfied with the backup of your system3                  disk, press <Return> to enter YES._  '               3. XQP+ Save Set Locationl  B                  * Where will the distribution volumes be mounted:  F                  The XQP+ installation kit is stored in the same placeF                  as the PATHWORKS for OpenVMS (Macintosh) kit. If thisF                  was a CDROM distribution, VAXPWF11X01_060.A is in theD                  same directory. If this was a magtape distribution,7                  VAXPWF11X01_060.A is on the same tape.A                 4. Product Name   O                  Enter the products to be processed from the first distributionP                  volume set.                    *    Products:P  '                  Enter VAXPWF11X01_060.   %               5. Installation Optionsi  E                  * Enter installation options you wish to use (none):O  .                  Press <Return> to enter NONE.  ,               6. Continuing the Installation  2                  * Continue the Installation? [Y]?  -                  Press <Return> to enter YES.X                 7. Purging Files  R                  * Do you want to purge files replaced by this installation [YES]?  -                  Press <Return> to enter YES.n  H                                                  Installing the XQP+ D-3 Y  O                        8. System Shutdown_  P               * Will you allow a system shutdown after this product is installed                 [YES]?  )               Press <Return> to enter NO.   C               If you enter NO, the installation procedure continuesgA               as normal, but the system does not reboot. The XQP+C<               becomes active whenever you reboot the system.  C            On some systems, the installation procedure may make thel+            following additional statements:   !            o  Location of the XQP   F      The F11BXQP.EXE image does not reside in SYS$COMMON:[SYSEXE]. TheI      installation will abort because of this. Please see the Installation        Guide for more information.  ?               This indicates that a version of the XQP may have$<               been placed in SYS$SPECIFIC:[SYSEXE]. This in-@               stallation replaces the XQP image only if it is in"               SYS$COMMON:[SYSEXE].  )            o  Special Versions of the XQP   J      The installation procedure has detected that there may be a danger ofI      omitting bugfixes to your current F11BXQP.EXE. The installation willB      now abort.$  +      Please consult the installation guide.   @               This indicates that the installation procedure has?               detected a special version of the old XQP on your >               system. Bug fixes made to the old XQP may not beC               present in the XQP+, resulting in regression. ConsultD?               the supplier of the old XQP for further guidance.                     D-4 Installing the XQP+ I  E                      XQP+ Sample Installation  A               The following is a sample XQP+ installation script:T  2                 Welcome to OpenVMS VAX Version 6.0           Username: SYSTEM         Password:   I                 Welcome to OpenVMS VAX version Version 6.0 on node JUGGLE ?             Last interactive login on Friday, 16-DEC-1994 10:30 C             Last non-interactive login on Friday, 16-DEC-1994 11:48   7         $ @SYS$UPDATE:VMSINSTAL VAXPWF11X01_060 MKA500:_  O                 OpenVMS VAX Software Product Installation Procedure Version 6.0   )               It is 16-DEC-1994 at 13:54.a  7         Enter a question mark (?) at any time for help.A  J         * Are you satisfied with the backup of your system disk [YES]? YES  1         The following products will be processed:A  "           VAXPWF11X01_ Version 6.0  K                 Beginning installation of VAXPWF11X01_ Version 6.0 at 13:54   >         %VMSINSTAL-I-RESTORE, Restoring product save set A ...S         %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.   Q               o Depending on your system, this installation procedure will changeMH                 the following system parameters to the following values:  7                   System         Parameter        ValueD7                   ------         ---------        -----D3                   Standalone or  XQPCTLD1         8.3                   XQP+ only      XQPCTL2          1i3                   VMScluster     ACP_WRITEBACK    1   3                   VMScluster     XQPCTLD1         0)3                   with XQP+ and  XQPCTL2          0o3                   original XQP   ACP_WRITEBACK    1l                   nodes   ;               o The original XQP will be saved in the file:   2                         SYS$SYSTEM:F11BXQP_OLD.EXE  H                                                  Installing the XQP+ D-5 _               G            o The following deinstallation procedure will be provided to @              allow you to back out the changes made by this kit:  3                      SYS$UPDATE:PWF11X$DEINSTAL.COM   C            o To activate the XQP+, a reboot is required. During the E              installation, a question will ask if it is convenient to C              shutdown the system. If you enter NO, the installation G              will continue as normal but will not shutdown your system.   +      * Continue the Installation?  [Y]? YES   B        The installation procedure will change the following system*        parameters to the following values:  #                Parameter      Value_#                ---------      -----A                XQPCTLD1       8l                XQPCTL2        1A                ACP_WRITEBACK  1o  4        You must add these settings to MODPARAMS.DAT.  J      * Do you want to purge files replaced by this installation [YES]? YES  H          To complete the installation of this product, you should rebootJ          the system.  If it is not convenient to reboot at this time, then,          enter NO to the following question.  C          If you enter NO, the installation procedure will continue.   G      * Will you allow a system shutdown after this product is installedP        [YES]? NOG      %VAXPWF11X01_-I-QEND, This installation procedure will not ask anyl          more questions ;      %VMSINSTAL-I-RESTORE, Restoring product save set C ... S      %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...p  H              Installation of VAXPWF11X01_ Version 6.0 completed at 13:55  .              VMSINSTAL procedure done at 13:55              D-6 Installing the XQP+                       H                                                                        EH         ________________________________________________________________  H                                                  Configuringing the XQP+      D               The OpenVMS file system is implemented by the XQP. TheG               XQP+ is an enhanced version of the XQP, and helps improveMG               the performance of your PATHWORKS for OpenVMS (Macintosh)                server.   4               This appendix discusses the following:                 o  New features   >               o  Controlling the new features on Version 5.5-2  <               o  Controlling the new features on Version 6.x  1               o  Controlling XQP+ in a VMSclusterl  E               o  Mixed OpenVMS Version 5.5-2 and Version 6.x clustersi  0               o  Controlling DECshare XQP+ usage  &               o  Deinstalling the XQP+                 o  Known problems            New Features  G               The XQP+ provides new features to improve the performanceh*               of the DECshare file server:                H                                              Configuringing the XQP+ E-1 r             E            __________________________________________________________             New_RE            Feature_____Description___________________________________E  A            MultithreadiAllows the DECshare file server to perform0A                        up to eight concurrent OpenVMS file systemi.                        operations in parallel.  @            Improved    Allows the OpenVMS file system to processB            concur-     multiple file create operations on a singleB            rency       disk in parallel. Normally in a VMScluster,E                        only one process can create files on a disk at_                        a time.  @            AsynchronousAllows the DECshare file server to return=            cache       control to the PATHWORKS client before =            writes      completing certain OpenVMS file systemrB                        operations. This improves the response time@                        for accessing files from the file server.  ?            Multiblock  Reduces the time the OpenVMS file systemS4            bitmap      spends allocating disk space.E            reads_____________________________________________________   2      Controlling the New Features on Version 5.5-2  ?            Three of the new XQP+ features are controlled by thenB            following OpenVMS Version 5.5-2 SYSGEN parameters. NoteD            that OpenVMS Version 6.x uses different SYSGEN parameters8            (see the next section for Version 6.x usage).                                       E-2 Configuringing the XQP+               H               __________________________________________________________H               Parameter_____Description_________________________________  H               VMSD2         Enables and disables multithreading. Enables>                             and disables improved concurrency.H                             ____________________________________________H                             Value_Result________________________________  B                             1     Disables multithreading. Enables7                                   improved concurrency.   A                             8     Enables multithreading. Enables_7                                   improved concurrency.   C                             32769 Disables multithreading. Disables 7                                   improved concurrency.   D                                   Note that a disk benefits from theG                                   improved concurrency only if VMSD2 isyH                             ______set_to_8_when_the_disk_is_mounted.____  C               ACP_          Enables and disables asynchronous cache:#               WRITEBACK     writes._H                             ____________________________________________H                             Value_Result________________________________  E                             0     Disables asynchronous cache writes.   H                             1_____Enables_asynchronous_cache_writes.____  H               __________________________________________________________  3         Controlling the New Features on Version 6.x   @               The new features of the XQP+ are controlled by theF               following three OpenVMS 6.x SYSGEN parameters. Note thatD               OpenVMS Version 5.5-2 uses different SYSGEN parametersA               (see the previous section for Version 5.5-2 usage).u  H               __________________________________________________________H               Parameter_Description_____________________________________  <               XQPCTLD1  Enables and disables multithreading.H                         ________________________________________________H                         Value_Result____________________________________  5                         8     Enables multithreading.   H                         0_____Disables_multithreading.__________________  H                                              Configuringing the XQP+ E-3 M  n          E            __________________________________________________________fE            Parameter_Description_____________________________________   ?            XQPCTL2   Enables and disables improved concurrency._E                      ________________________________________________ E                      Value_Result____________________________________   8                      1     Enables improved concurrency.  E                      0_____Disables_improved_concurrency.____________n  D            ACP_      Enables and disables asynchronous cache writes.E            WRITEBACK ________________________________________________ E                      Value_Result____________________________________p  =                      1     Enables asynchronous cache writes.   E                      0_____Disables_asynchronous_cache_writes._______   E            __________________________________________________________   %      Controlling XQP+ in a VMScluster   6            On each system in a VMScluster, you should:  C            o  Set each parameter to the same value. For example, if E               the installation procedure sets ACP_WRITEBACK to 1, set 0               ACP_WRITEBACK to 1 on each system.  C            o  Update the MODPARAMS.DAT file so that it reflects theh#               new parameter values.t  9      Mixed OpenVMS Version 5.5-2 and Version 6.x Clusters   D            VMSclusters Running OpenVMS Version 5.5-2 and Version 6.x  A            In a VMScluster, OpenVMS Version 5.5-2 and Version 6.xiE            systems that run their respective versions of the XQP+ canEC            coexist. Make sure, however, that all the systems in they             cluster run the XQP+.  $      Controlling DECshare XQP+ Usage  B            You can use two logical names to control multithreadingA            and asynchronous cache writes within the DECshare file             server:  )            o  MSAF$SERVER_MAX_XQP_THREADS   0            o  MSAF$SERVER_XQP_ASYNC_CACHE_WRITES         E-4 Configuringing the XQP+                 A               If you have enabled multithreading, you can use theiA               MSAF$SERVER_MAX_XQP_THREADS logical name to specify B               the maximum number of concurrent OpenVMS file system6               operations for the DECshare file server.  @               $ DEFINE/SYSTEM/EXEC MSAF$SERVER_MAX_XQP_THREADS 8  G               If the logical name is not defined, the default is 8. The_D               minimum is 0. If you specify a value of 1 or 0, multi-(               threading is switched off.  D               If you have enabled asynchronous cache writes, you canH               use the MSAF$SERVER_XQP_ASYNC_CACHE_WRITES logical name to+               switch the feature on or off:   %                $ DEFINE/SYSTEM/EXEC - 7               _$ MSAF$SERVER_XQP_ASYNC_CACHE_WRITES YESc  %                $ DEFINE/SYSTEM/EXEC -f6               _$ MSAF$SERVER_XQP_ASYNC_CACHE_WRITES NO  C               You must restart the DECshare file server for the newy$               values to take effect.  H               See the PATHWORKS for OpenVMS (Macintosh) Server ReferenceG               Manual appendix for a description of these logical names.e           Deinstalling the XQP+S  F               You need to install the XQP+ only on OpenVMS VAX VersionD               5.5-2 and Version 6.0 systems. The XQP+ is standard onD               Alpha and VAX OpenVMS Version 6.1 systems and does not#               require installation.a  E               Use the VMSINSTAL command procedure to install the XQP+h=               from the PATHWORKS for OpenVMS (Macintosh) kit.n  @               $ @SYS$UPDATE:VMSINSTAL VAXPWF11X01_060 kit_media:  E               VAXPWF11X01_060 contains XQP+ versions for both OpenVMS 0               VAX Version 5.5-2 and Version 6.0.  G               To make sure you can restore the old XQP at any time, the H               installation procedure copies the old XQP and stores it inF               SYS$SYSTEM:F11BXQP_OLD.EXE (on OpenVMS VAX Version 5.5-2,               and Version 6.0 systems only).  H                                              Configuringing the XQP+ E-5 [  ]            D            To deinstall the XQP+, follow these steps for each system0            disk on which you installed the XQP+:  /            1. Run the deinstallation procedure:h  +               $ @SYS$UPDATE:PWF11X$DEINSTALs  D               The deinstallation procedure fails if it cannot locate               the old XQP.  D            2. Reset the SYSGEN parameters to their default values on,               every node in your VMScluster:  E               _______________________________________________________eE               On_...______The_default_values_are_..._________________   3               An OpenVMS  VMSD2=0, ACP_WRITEBACK=1.                VersionM               5.5-21               system  A               An OpenVMS  XQPCTLD1=0, XQPCTL2=0, ACP_WRITEBACK=1.                Version1E               6.x_system_____________________________________________                3. Reboot the system.        Known Problemsf  )            o  Location of the current XQPe  C               If the installation procedure finds a copy of the XQP1B               in SYS$SPECIFIC:[SYSEXE], the XQP+ is installed. TheC               procedure only replaces the file F11BXQP.EXE if it is C               in SYS$COMMON:[SYSEXE], and there are no copies of it '               in SYS$SPECIFIC:[SYSEXE].n  ?            o  VMSclusters running both the XQP+ and the old XQPe  B               Under very exceptional circumstances, deadlocks haveB               occurred in VMScluster systems running both the XQP+A               and the original XQP. These deadlocks have occurred E               only under extremely heavy loads created by special XQP A               stressing software. The deadlocks have not occurreds?               under typical system loads, and do not occur withYA               VMScluster systems running the XQP+ on all systems.          E-6 Configuringing the XQP+ d               C                  To accommodate this problem, the XQP+ installation C                  procedure asks you if you are going to install the F                  XQP+ on all systems in your VMScluster. If you answerG                  No, the procedure disables multithreading and improved F                  concurrency. In this case, disable multithreading andF                  improved concurrency on all the other systems in your                  VMScluster.  H               o  To control improved concurrency and multithreading, theH                  Version 6.0 parameters XQPCTLD1 and XQPCTL2 replace the/                  Version 5.5-2 parameter VMSD2.i  ?                  The following table shows you how to set theseeF                  parameters consistently in a VMScluster that has both7                  Version 5.5-2 and Version 6.0 systems.c  H                  _______________________________________________________-                                  On a Version F                  If you want to  5.5-2 system  On a Version 6.0 systemH                  ..._____________...___________...______________________  C                  Enable          Set VMSD2 to  Set XQPCTL2 to 1 and,=                  improved con-   8.            XQPCTLD1 to 8.o                  currency andn                  multithreadinga  C                  Disable         Set VMSD2 to  Set XQPCTL2 to 0 and =                  improved con-   32769.        XQPCTLD1 to 0.t                  currency andoH                  multithreading_________________________________________  .               o  Upgrading OpenVMS VAX systems  D                  If you upgrade your OpenVMS VAX system from VersionC                  5.5-2 to Version 6.0, you must reinstall the XQP+.y                    H                                              Configuringing the XQP+ E-7    p                          E      ________________________________________________________________   E                                                                 Index       E      A__________________________          B__________________________   A      AppleTalk/DECnet Transport           Backup recommendations,F/         Gateway                             2-5n        defining, 5-5+        description of, 2-2                CTE        disk space requirements,           ___________________________L>          2-6                              CHANNELCNT parameter<        installing, 3-10                    calculating,  2-8?        naming, 3-10                        required value,  2-7t3      AppleTalk for OpenVMS                ChecklisttC        description of, 2-2                 installation tasks,  3-1-B        disk space requirements,            postinstallation tasks,1          2-6                                  4-1 A        installing, 3-8                     preinstallation tasks, 1        loading a new version,                 2-1)D          4-3                               VMScluster configuration,1        primary port and, 5-3                  5-1 9        version requirements, 2-4          Client softwarevA        zones, 5-3                          standalone system and,E1      ATK$CONFIG                               4-4 4        See Configuration                  Components?          procedure                         description of,  2-2 C      AUTOGEN command procedure             disk space requirements, 1        changing system parameter              2-5 <          values,  2-9                      location of,  2-6>                                            prerequisites,  3-6:                                            selecting,  3-67                                           ConfigurationaB                                            overview of tasks,  1-1C                                            standalone systems,  4-4aC                                            VMScluster systems,  5-1   E                                                               Index-1-                       Configuration procedureE        aborting, 5-3                      E__________________________s<        canceling, 5-5                     Error messages and=        running, 5-2                         conditions,  3-14   >      D                                    Ethernet controllersA      ___________________________           choosing for AppleTalki8      DCL tables                               port,  3-87        replacing, 5-2                     Event logging C      DECnet                                enabling/disabling,  5-4u        objects created, C-1]E        prerequisite software              F__________________________s/          for,  2-4                        Files-:        status while installing,            installed,  B-18          3-4, 5-3                          purging,  3-65        version requirements, 2-4          File server1C      DECshare file server                  See DECshare file serverd        adding volumes, 5-7        creating, 5-7E        description of, 2-2                G__________________________   1        disk space requirements,           Gateway_?          2-6                               See AppleTalk/DECnet ?        improving performance on,              Transport Gateway <          1-1                              GBLPAGES parameter9        installing, 3-10                    checking,  2-7P?        naming, 3-10                        required value,  2-7O?      DECshare print server                GBLSECTIONS parameter 9        description of, 2-2                 checking,  2-7 ?        disk space requirements,            required value,  2-7 C          2-6                              Guest access to DECshare,V0        installing, 3-12                     3-11      DECwindows ADSP transport+        description of, 2-3                HxE        disk space requirements,           ___________________________ 2          2-6                              Hardware:        prerequisite software               required before@          for,  2-4                            installation,  2-3        Disk space requirementsE        determining, 2-5                   I__________________________u  A                                           Installation checklist,_/                                             3-1 @                                           Installation procedure9                                            aborting,  3-3e<                                            completing,  3-12C                                            files installed by,  B-1p        Index-2    I                     Installation procedureG           (cont'd)                          O__________________________g  =          for the XQP+,  D-5                 Online PostScripts<          overview of,  1-1                     DocumentationB          planning,  2-2                       description of,  2-3?          running,  3-3                        installing,  3-12 3          sample script,  A-1                OpenVMS H          starting,  3-2                       version requirements,  2-4B         Installation Verification           OPTIONS N parameter toF           Procedure                            VMSINSTAL command, 3-3,2          error messages,  3-14                 3-5          running automatically,dG             3-5, 3-13                       P___________________________>          running independently,             Part Listing,  2-3A             4-3                             PATHWORKS Mail server   B         IVP                                   description of,  2-3  F          See Installation                     disk space requirements,4             Verification Procedure               2-6  C                                             Performance, improving, 7         L__________________________            1-1, D-1_  ;         Log file                            Physical layouto<          naming,  5-4                         planning,  1-2D         Logging                             Postconfiguration tasks,2          enabling/disabling,  5-4              5-9B                                             Postinstallation tasks=         M__________________________           checklist,  4-1_@         Mail server                         PQL_MBYTLM parameter<          description of,  2-3                 checking,  2-7B         MAXBUF parameter                      required value,  2-7F          checking,  2-7                     Preinstallation checklist,2          required value,  2-7                  2-1G         Miscellaneous files                 Prerequisite hardware,  2-3 G          disk space requirements,           Prerequisite software,  2-4 8             2-6                             Primary port>         MODPARAMS.DAT file                    setting up,  5-3=          editing,  2-9                        zone name,  5-3n  8                                             Print server  G         N                                     See DECshare print server_6         ___________________________         PrivilegesG         Network                               required for installationy6          assigning ranges,  5-4                  , 2-5          planning the physical             layout,  1-2  H                                                                  Index-3 o  n            <      Process account quotas               SYSHUTDWN.COM file@        required for installation           modifying to dismount;          ,  2-6                               volumes,  4-3s>      Product components                   SYSTARTUP_*.COM file=        description of, 2-2                 modifying to start =        location of, 2-6                       PATHWORKS,  4-2 5                                           System disk_<      Q__________________________           backup,  2-5, 3-4;      Quotas                               System parameters_9        required for installation           changing,  2-9e9          ,  2-6                            checking,  2-7 =                                            requirements,  2-7 C      R                                    System shutdown procedure @      ___________________________           modifying to dismount:      Release notes                            volume,  4-3B        file name, 3-5                     System startup procedure=        OPTIONS N parameter, 3-3            modifying to starts=        ways to view, 3-5                      PATHWORKS,  4-2_      Requirements_E        prerequisite hardware,             T___________________________/          2-3                              TasksaA        prerequisite software,              configuring standalonem;          2-4                                  systems,  4-4l  A      S                                     configuring VMScluster_;      ___________________________              systems,  5-1 =      Sample installation script,           installation,  3-1 B         A-1                                postconfiguration,  5-9A      Shutdown                              postinstallation,  4-1 @        AppleTalk upgrade and,              preinstallation,  2-1          4-3E        automating, 4-3                    U__________________________s1        upgrade and, 3-2                   Upgrader=      Software                              shutdown for,  3-2a<        components of product,              startup for,  5-6          2-2+        required before                    VeE          installation,  2-4               ___________________________e<      Standalone system                    VMScluster systemsD        configuring, 4-4                    checklist for configuring4      Startup                                  ,  5-1>        automating, 4-2                     installing on,  3-2=        upgrade and, 5-6                   VMSINSTAL procedures9                                            aborting,  3-3t<                                            completing,  3-12        Index-4 e  o            :         VMSINSTAL procedure                   adding,  5-7             (cont'd)G          description of,  3-1               X__________________________H  /          error messages and                 XQP_@             conditions,  3-14                 and the XQP+,  D-46          files installed by,  B-1           XQP+,  1-1G          OPTIONS N parameter,  3-3            installation script,  D-5f>          running,  3-3                        installing,  D-1          sample script,  A-1G          sample XQP+ script,  D-5           Z__________________________A1          starting,  3-2                     Zonesl;         Volumes                               See AppleTalk                                                               H                                                                  Index-5                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                