                                 H                     DECdfs_for_OpenVMS__________________________________&                     Installation Guide                          January 2005  G                     This document contains installation information for 3                     DECdfs Version 2.4 for OpenVMS.               H                     Software Version:             DECdfs Version 2.4 for9                                                   OpenVMS   G                     Operating System and Version: OpenVMS Alpha Version 5                                                   8.2 I                                                   OpenVMS I64 Version 8.2                         +                     Hewlett-Packard Company )                     Palo Alto, California                  J           ________________________________________________________________  D            Copyright 2005 Hewlett-Packard Development Company, L.P.  ?           Confidential computer software. Valid license from HP B           required for possession, use or copying. Consistent with>           FAR 12.211 and 12.212, Commercial Computer Software,A           Computer Software Documentation, and Technical Data for D           Commercial Items are licensed to the U.S. Government under/           vendor's standard commercial license.   ?           The information contained herein is subject to change A           without notice. The only warranties for HP products and C           services are set forth in the express warranty statements A           accompanying such products and services. Nothing herein E           should be construed as constituting an additional warranty. E           HP shall not be liable for technical or editorial errors or %           omissions contained herein.   C           Intel and Itanium are trademarks or registered trademarks @           of Intel Corporation or its subsidiaries in the United%           States and other countries.              Printed in the US   E                                                                ZK6547   B           The HP OpenVMS documentation set is available on CD-ROM.                                 C   _________________________________________________________________   C                                                            Contents       C   Preface...................................................    vii      1  Installation Prerequisites   C         1.1   Contents of the Kit...........................    1-1 C         1.2   Required Hardware.............................    1-2 C         1.3   Required Software.............................    1-2 C         1.4   License Registration (PAK)....................    1-2 C         1.5   Required Disk Space...........................    1-3 8         1.6   Installing Over Earlier Versions of DECdfsC               Software......................................    1-4 C         1.7   SYSGEN Parameters.............................    1-5 C         1.7.1     Increasing the Nonpaged Pool Size.........    1-5 <         1.7.2     Increasing the System Interrupt Stack SizeC                   (VAX Systems Only)........................    1-6 4         1.7.3     Increasing Global Pages and GlobalC                   Sections..................................    1-6 C         1.7.4     Increasing the Channel Count..............    1-7 C         1.8   Account and Quota Requirements................    1-8 C         1.9   Installation Time.............................    1-8 C         1.10  Configuration Planning........................    1-9 C         1.10.1    Configuration Questions...................    1-9 5         1.10.2    The DECdns Distributed Name Service C                   (DECdns)..................................   1-10 C         1.10.2.1    Access Points...........................   1-10 C         1.10.2.2    DECdns Clerk............................   1-11 C         1.10.2.3    DECdns Logical Name Table...............   1-11 6         1.10.3    Installing DECdfs on OpenVMS ClusterC                   Systems...................................   1-12 C         1.11  Reviewing the DECdfs Installation Procedure...   1-13 <         1.11.1    Rebooting an Existing DECdfs System BeforeC                   or After the Installation.................   1-14 C         1.11.2    Renaming Existing DFS*.EXE Files..........   1-14   C                                                                 iii                    E           1.11.3    Processing Existing DFS*.COM Files........   1-15 E           1.12  Maintenance Updates...........................   1-15   $     2  Installation and Verification  E           2.1   Preliminary Information.......................    2-1 E           2.2   Installation Procedure........................    2-2 E           2.3   Additional DECdfs Messages....................   2-13 E           2.3.1     Renaming Files Message....................   2-13 E           2.3.2     Deleting Old Driver Files Message.........   2-15 E           2.3.3     DECdfs License PAK Message................   2-15 E           2.3.4     DECdfs Startup Messages...................   2-15   "     3  Postinstallation Procedures  5           3.1   Running the Installation Verification E                 Procedure.....................................    3-1 8           3.2   Editing the Local System Startup CommandE                 File..........................................    3-3 E           3.3   Using DECdfs Command Files....................    3-4 4           3.4   Setting Additional DECnet and SystemE                 Parameters....................................    3-6 E           3.5   Creating OpenVMS Proxy Accounts...............    3-6 E           3.6   Reinstalling DECdfs...........................    3-8 E           3.7   Changing DECdfs Configurations................    3-8 9           3.8   Deleting Server Software from Client-Only E                 Systems.......................................    3-9 6           3.9   Checking OpenVMS Cluster Systems AfterE                 Installing DECdfs.............................   3-10 E           3.10  Error Handling................................   3-10 E           3.11  Problem Reporting.............................   3-10   ,     A  Files Affected by DECdfs Installation    /     B  Sample Installations for OpenVMS Systems   >           B.1   Server Installation on OpenVMS I64 Version 8.2E                 with DECnet Phase IV..........................    B-1                  iv                   
         Index                                                                                         I                                                                         v                              I         _________________________________________________________________   I                                                                   Preface                Intended Audience   G               This guide is intended for the person who installs DECdfs &               for OpenVMS Version 2.4.           Associated Documents  H               The DECdfs documentation set consists of this installationE               guide, the DECdfs for OpenVMS Management Guide, and the I               release notes document. You can find related information in &               the following documents:  G               o  The OpenVMS installation and operations guide for your                   system.  3               o  HP OpenVMS System Manager's Manual   5               o  DECnet for OpenVMS Networking Manual   4               o  HP OpenVMS Guide to System Security  =               o  HP OpenVMS License Management Utility Manual   <               o  HP OpenVMS System Services Reference Manual  ;               o  DECnet-Plus for OpenVMS Network Management   .               o  DECnet-Plus DECdns Management           Reader's Comments   C               HP welcomes your comments on this manual. Please send <               comments to either of the following addresses:  +               Internet    openvmsdoc@hp.com   I                                                                       vii                      -           Postal      Hewlett-Packard Company :           Mail        OSSG Documentation Group, ZKO3-4/U08(                       110 Spit Brook Rd.+                       Nashua, NH 03062-2698   )     How to Order Additional Documentation   7           For information about how to order additional D           documentation, visit the following World Wide Web address:  0           http://www.hp.com/go/openvms/doc/order  %     Conventions Used in This Document   <           The following graphic conventions are used in this           document.   ?           Special type  This special type in examples indicates 4                         system output or user input.  C           Bold type     Bold type in examples indicates user input.   C           [ ]           Brackets in command lines indicate that the B                         enclosed values are optional. (Do not type&                         the brackets.)  C           UPPERCASE     Uppercase letters in command lines indicate D                         keywords that must be entered. You can enter>                         them in either uppercase or lowercase.B                         You can abbreviate command keywords to the4                         minimum unique abbreviation.  ?           lowercase     Lowercase letters (often hyphenated) in E           letters       command syntax or examples indicate variables ?                         that the user replaces with appropriate                          values.   B           The Return key, which you must press in order to execute3           commands, is assumed in command examples.                viii                         I                                                                         1 I         _________________________________________________________________   I                                                Installation Prerequisites     I               This chapter describes the prerequisites for installing the H               DECdfs software on an OpenVMS I64 or OpenVMS Alpha system.-               It covers the following topics:   $               o  Contents of the kit  3               o  Hardware and software requirements   %               o  License registration   (               o  Disk space requirements  8               o  Installing over earlier DECdfs versions  6               o  System Generation (SYSGEN) parameters  /               o  Account and quota requirements   "               o  Installation time  '               o  Configuration planning   5               o  Reviewing the installation procedure   $               o  Maintenance updates           1.1 Contents of the Kit   @               DECdfs software is available on compact disc read-@               only memory (CD-ROM). Contact your Hewlett-PackardF               support representative if any components of the software+               distribution kit are missing.   H               The DECdfs documentation set consists of this installationE               guide, the DECdfs for OpenVMS Management Guide, and the E               DECdfs for OpenVMS Release Notes. Keep the installation D               guide with your distribution kit for future reference.H               You can use this guide to install maintenance updates (see=               Section 1.12) or reinstall the DECdfs software.   I                                            Installation Prerequisites 1-1                 Installation Prerequisites     1.1 Contents of the Kit     >           The DECdfs release notes are available on line. ReadA           steps 2 and 6 in Section 2.2 for instructions on how to B           access them. After you install DECdfs, the release notes>           file (HP-VMS-DECDFS024.RELEASE_NOTES) resides in theA           SYS$HELP directory. Hewlett-Packard recommends that you B           read the release notes and the installation guide before           you install DECdfs.        1.2 Required Hardware   >           The only required hardware is the DECnet Phase IV orB           DECnet Phase V network hardware. For a list of supportedD           hardware and configurations, refer to the Software ProductE           Description (SPD) for DECdfs for OpenVMS Version 2.4 and to D           the SPD for the version of the OpenVMS operating system on'           which you plan to run DECdfs.        1.3 Required Software   @           You must be running DECnet for OpenVMS, DECnet/OSI, orB           DECnet-Plus for OpenVMS on your OpenVMS operating system$           before you install DECdfs.  A           In the DECdfs documentation, DECnet Phase IV is used to A           refer to DECnet for OpenVMS, and DECnet Phase V is used C           to refer to either or both DECnet/OSI and DECnet-Plus for            OpenVMS.  ?           The software required to run DECdfs Version 2.4 is as            follows:  E           o  OpenVMS Alpha Version 8.2 with DECnet Phase IV or DECnet               Phase V  C           o  OpenVMS I64 Version 8.2 with DECnet Phase IV or DECnet               Phase V  "     1.4 License Registration (PAK)  ?           You must register and load the DECdfs license Product ?           Authorization Key (PAK) before you can run the DECdfs E           software and the Installation Verification Procedure (IVP).       "     1-2 Installation Prerequisites           I                                                Installation Prerequisites I                                            1.4 License Registration (PAK)     F               Use the License Management utility (LICENSE) to registerH               and load the DECdfs license PAK in the LMF database beforeF               or after installing the DECdfs software. Use the LicenseH               Management utility (LICENSE) documentation to learn how to.               register and load a license PAK.  G               When you register the license PAK before you install, the D               IVP runs automatically (if selected) and DECdfs startsC               automatically at the end of the installation. Neither H               happens if you do not register the license PAK until after               the installation.   F               See the HP OpenVMS License Management Utility Manual forI               more information about registering and loading licenses for '               OpenVMS layered products.            1.5 Required Disk Space   B               To install DECdfs, there must be a minimum amount ofC               free disk space (peak block count) on the system disk E               (SYS$SYSDEVICE:). After DECdfs is installed, the DECdfs G               files require less disk space (net block count). Required G               space depends on the processor, as shown in the following                table:  I               ___________________________________________________________ I               Processor_____Peak_Blocks___Net_Blocks_____________________   .               Alpha         3525          3250  I               I64___________6500__________6000___________________________   G               To display the number of free blocks, enter the following                DCL command:  *               $ SHOW DEVICES SYS$SYSDEVICE  I               The number of free blocks is displayed on your screen under 2               the Free Blocks heading, as follows:  A               Device   Device   Error   Volume  Free   Trans  Mnt A               Name     Status   Count   Label   Blocks Count  Cnt ?               DUA0:    Mounted     0    DAISY   31625    82   1   D               If the system disk does not contain enough free space,G               you must purge files, remove unused files (log files, for F               example), or remove some applications or user files. You3               can then install the DECdfs software.   I                                            Installation Prerequisites 1-3                 Installation Prerequisites;     1.6 Installing Over Earlier Versions of DECdfs Software     ;     1.6 Installing Over Earlier Versions of DECdfs Software   B           As of DECdfs Version 1.3, several tuning parameters wereE           removed to ease performance management tasks. Consequently, @           the following command qualifiers and logical names are           obsolete:   B           o  /SESSIONS_MAXIMUM and /CONNECTIONS_MAXIMUM qualifiers  D              In the Communication Entity, both the /SESSIONS_MAXIMUMB              and /CONNECTIONS_MAXIMUM qualifiers have been removed>              from the SET COMMUNICATION and SHOW COMMUNICATIONE              commands. DECdfs now automatically allocates session and D              communication blocks to accommodate increased requests.  %           o  /FILES_MAXIMUM qualifier   D              In the server, the /FILES_MAXIMUM qualifier for the SETE              SERVER and SHOW SERVER commands has been removed. DECdfs B              now automatically allocates blocks that correspond to              open files.  @           o  /PERSONA_CACHE=BLOCKS_THRESHOLD qualifier and value  E              As part of persona cache autosizing in the server entity D              of DECdfs, the BLOCKS_THRESHOLD value for the /PERSONA_>              CACHE qualifier of the SET SERVER and SHOW SERVERA              commands has been disabled. DECdfs now automatically 6              recalculates this threshold periodically.  :           o  DFS$PQL_FILLM and DFS$PQL_BYTLM logical names  C              The two logical names DFS$PQL_FILLM and DFS$PQL_BYTLM, E              which were defined in file DFS$CONFIG.COM in versions of E              DECdfs prior to Version 1.3, are no longer necessary and B              will be ignored if they exist in the file. DECdfs nowC              automatically computes values for these server process =              quotas based on the SYSGEN parameter CHANNELCNT.   ?           If you are installing DECdfs over a version of DECdfs B           earlier than Version 1.3 and the existing DFS$CONFIG.COMB           contains any of the qualifiers or logical names shown inA           the above list, you should either rename DFS$CONFIG.COM @           to disable it or edit the file and remove the obsolete>           qualifiers or logical names. DECdfs issues a warningB           message if it finds obsolete qualifiers or logical names           during startup.   "     1-4 Installation Prerequisites           I                                                Installation Prerequisites I                                                     1.7 SYSGEN Parameters              1.7 SYSGEN Parameters   E               The following sections describe how to check and modify G               the System Generation (SYSGEN) parameters that are needed E               to run DECdfs. After modifying any SYSGEN parameters in H               the MODPARAMS.DAT file, invoke the OpenVMS AUTOGEN commandG               procedure to automatically adjust the values of the other D               system parameters and reboot the system to set the newI               parameter values. For information about AUTOGEN, see the HP .               OpenVMS System Manager's Manual.  C               To run DECdfs, you might need to modify the following                 SYSGEN parameters:  6               o  NPAGEDYN (nonpaged dynamic pool size)  :               o  INTSTKPAGES (system interrupt stack size)  @               o  GBLPAGES (global pages) and GLBSECTIONS (global                  sections)  /         1.7.1 Increasing the Nonpaged Pool Size   E               To use DECdfs, you may need to increase the size of the D               nonpaged dynamic pool (the SYSGEN parameter NPAGEDYN).  I               For a client-only node, add 100,000 bytes of nonpaged pool. I               For a server node, Hewlett-Packard recommends an additional F               250,000 bytes of nonpaged pool. The additional bytes areG               usually sufficient for the normal use of approximately 10 *               to 20 DECdfs client devices.  H               To increase the nonpaged pool size, edit the MODPARAMS.DATG               file in the SYS$SYSTEM directory. Add the statements that D               increase the value of the SYSGEN parameter NPAGEDYN as               follows:  F               o  For a client-only node, add the following comment and2                  statement at the end of the file:  ;                  ! Add some nonpaged pool for DECdfs client                   !$                  ADD_NPAGEDYN=100000    I                                            Installation Prerequisites 1-5                 Installation Prerequisites     1.7 SYSGEN Parameters     =           o  For a server node, add the following comment and .              statement at the end of the file:  7              ! Add some nonpaged pool for DECdfs server               !               ADD_NPAGEDYN=250000  E           If you decide to increase the data cache size on the server E           node, increase the server node's nonpaged pool size further 8           (see the DECdfs for OpenVMS Management Guide).  A     1.7.2 Increasing the System Interrupt Stack Size (VAX Systems            Only)   B           To use DECdfs, increase the size of the system interrupt9           stack four pages more than your current use. To <           increase the size of the interrupt stack, edit the?           SYS$SYSTEM:MODPARAMS.DAT file to add a statement that C           increments the value of the SYSGEN parameter INTSTKPAGES.   C           For a server node, add the following statement at the end $           of the MODPARAMS.DAT file:  C           ! Increase the size of the interrupt stack for the DECdfs            ! server.            ADD_INTSTKPAGES=4   C           By increasing the size of the system interrupt stack, you D           can prevent the DECdfs server from experiencing occasionalE           system halts. An interrupt stack pointer error (ISP ERR) or C           similar hardware error message is displayed when the size A           of the interrupt stack is too small. The specific error D           message that is displayed depends on the VAX model you are           using.  5     1.7.3 Increasing Global Pages and Global Sections   ?           To use DECdfs, you may need to increase the number of A           global pages and global sections (the SYSGEN parameters @           GBLPAGES and GBLSECTIONS). If the current settings forA           these parameters are inadequate, VMSINSTAL cannot start $           DECdfs after installation.  D           The following table shows how many additional global pages?           and global sections you need for a DECdfs server node .           running on a VAX or Alpha processor:  "     1-6 Installation Prerequisites           I                                                Installation Prerequisites I                                                     1.7 SYSGEN Parameters   I               ___________________________________________________________ I               Processor_____Global_Pages______Global_Sections____________   0               Alpha         1312              10  I               I64___________1312______________10_________________________   F               For a client-only node, DECdfs requires about 60 percentH               of the global page values shown in the previous table; the7               global section requirements are the same.   F               To check the number of available global pages and globalG               sections, use the WRITE command with the F$GETSYI lexical I               function to find the number of free global pages and global C               sections. The following example shows how to get this F               information at your terminal or workstation (the default*               destination for SYS$OUTPUT):  :               $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES")                 15848 :               $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")                 24  =               If the number of unused global pages and global >               sections is insufficient to run DECdfs, edit theF               SYS$SYSTEM:MODPARAMS.DAT file and insert statements thatD               raise the values of the SYSGEN parameters GBLPAGES and               GBLSECTIONS.  F               To increase the values for GBLPAGES and GBLSECTIONS, addF               the following statements at the end of the MODPARAMS.DATH               file. The variables nnn and mmm represent numbers that youE               add to the current setting for these SYSGEN parameters.                  ADD_GBLPAGES=nnn!               ADD_GBLSECTIONS=mmm   *         1.7.4 Increasing the Channel Count  @               Your system's channel count parameter, CHANNELCNT,D               specifies the maximum number of files that any processE               on the system can open concurrently. Each file requires H               one channel, and the DECdfs server process opens all localF               files that users at DECdfs clients access. If the serverE               is your system's most active file user, you may need to C               increase the channel count to accommodate the server.   I                                            Installation Prerequisites 1-7                 Installation Prerequisites     1.7 SYSGEN Parameters     ;           Determine the appropriate CHANNELCNT parameter by D           estimating the maximum number of simultaneously open filesB           you expect on the server. Add 15 to this number to allowD           for some additional channels for the server's own use. ForE           example, if you expect 250 files to be open simultaneously, E           set the CHANNELCNT parameter to 265 channels before running            DECdfs.   D           Insert the following line in the MODPARAMS.DAT file in theC           SYS$SYSTEM directory, and then run the AUTOGEN procedure:              ADD_CHANNELCNT = 265  ?           For information on AUTOGEN, see the HP OpenVMS System A           Management Utilities Reference Manual. You can read the C           online help information about the CHANNELCNT parameter by 5           entering the following SYSGEN HELP command:   !           $ RUN SYS$SYSTEM:SYSGEN ;           SYSGEN> HELP PARAMETERS SPECIAL_PARAMS CHANNELCNT   &     1.8 Account and Quota Requirements  C           To run VMSINSTAL, you must have the following privileges: ?           SYSPRV, SYSNAM, OPER, NETMBX, TMPMBX, CMKRNL, DETACH, B           ALTPRI, ACNT, PRMMBX, PSWAPM, and PHY_IO. Use the system9           manager account to install the DECdfs software.   A           The default values for the system quotas are sufficient ?           to install DECdfs. See the HP OpenVMS System Services D           Reference Manual for more information about system quotas.       1.9 Installation Time   D           The DECdfs software installation takes less than 5 minutes?           when installed from CD-ROM. The time that it takes to B           install DECdfs client or server software is similar, butB           can vary depending on the processor, distribution media,B           and system load. The installation verification procedure/           (IVP) takes approximately 30 seconds.           "     1-8 Installation Prerequisites           I                                                Installation Prerequisites I                                               1.10 Configuration Planning     #         1.10 Configuration Planning   F               Before you install any DECdfs software, you need to planC               your configuration. Decide which nodes will be DECdfs F               server nodes (those with active DECdfs server and clientI               software) and which will be DECdfs client-only nodes (those I               with active DECdfs client software only). You must consider B               how many servers and client-only nodes exist in yourF               network, as well as their locations. This information is;               important in deciding where to place servers.   F               A DECdfs server allows users at DECdfs clients to accessG               server disks and directories. These disks and directories A               appear to be local to the DECdfs client system. For D               information on DECdfs server and client functions, see6               the DECdfs for OpenVMS Management Guide.  F               When you install DECdfs software without specifying thatG               you want a client-only node, the software for clients and E               servers is loaded and the node becomes a DECdfs server. G               When you specify client-only, then only the DECdfs client D               software starts up on the client-only node. The serverD               software is present but inactive on client-only nodes.  B               See Section 1.10.3 or Section 3.7 for information onE               changing the configuration of client systems and server                systems.  &         1.10.1 Configuration Questions  D               As you plan your configuration, consider the following               criteria:   G               o  The nodes on which you will install DECdfs client-only                   software.  B               o  The nodes on which you will install DECdfs server                  software.  G               o  The namespace naming conventions used on your network. >                  See Section 1.10.2 for information on DECdns.  ?               o  Whether the DECdfs and DECnet license PAKs are F                  registered and loaded on systems that will be clients                  and servers.   F               o  Whether each node in a cluster environment has DECdfs)                  and DECnet license PAKs.   I                                            Installation Prerequisites 1-9                 Installation Prerequisites     1.10 Configuration Planning     7     1.10.2 The DECdns Distributed Name Service (DECdns)   C           On all DECnet Phase V systems, and on VAX systems running C           DECnet Phase IV, DECdfs uses the facilities of the DECdns B           Distributed Name Service to identify file services. ThisC           allows clients to access file services without explicitly D           knowing the name or location of the node that provides theC           service. On Alpha systems running DECnet Phase IV, DECdns @           is not available, and consequently, DECdfs operationalE           procedures are adjusted to include specifying the node name .           of the server in appropriate places.  A           The following stated requirements here and elsewhere in B           this guide regarding DECdns do not apply to DECnet PhaseC           IV Alpha systems. However, you should refer to the DECdfs E           for OpenVMS Management Guide for information concerning the B           interaction between nodes that do and do not use DECdns.  =           DECdns provides a database (called a namespace) for C           storing and managing the names and addresses of resources @           that are distributed throughout a network. This scheme?           permits users and applications throughout the network A           to locate a particular resource by its name rather than @           its address. Thus, network resources can move to a newB           location without affecting users or applications seekingC           them. If someone moves a resource, that person writes the C           new address information into the namespace. The next user D           or application seeking that resource by name automaticallyB           gets the updated address information from the namespace.       1.10.2.1 Access Points  D           DECdfs servers store address information for access pointsA           in the DECdns namespace. An access point represents the B           file resources that a DECdfs server makes available to aE           DECdfs client. Each access point name resides in the DECdns E           namespace and provides the address information for a DECdfs ;           server that offers that particular file resource.   C           Ask your network's DECdns manager to help you perform the            following tasks:  C           o  Identify a node that has the DECdns server software. A E              DECdns server must be installed, running, and accessible C              before you can use the DECdfs software or run the IVP.   #     1-10 Installation Prerequisites            I                                                Installation Prerequisites I                                               1.10 Configuration Planning     F               o  Create access point names that comply with the DECdns9                  naming conventions used on your network.   C               The DECdns manager must also provide access rights tofE               DECdfs server accounts and client accounts, as follows:   I               o  The account from which you operate a DECdfs server needs H                  read and write access rights in any DECdns directory in7                  which you plan to store access points.   G               o  The account from which you plan to run a DECdfs client I                  installation and verification procedure (IVP) needs read_E                  access rights in the DECdns directory containing any %                  DECdfs access point.y           1.10.2.2 DECdns Clerkc  E               DECdfs Version 2.4 should be installed on nodes runningoG               OpenVMS Version 5.5-2 or a higher version. These versionse@               of OpenVMS include the DECdns clerk, so the DECdfsC               installation no longer supplies the DECdns clerk. Theo@               installation, however, still attempts to start theD               DECdns clerk if it has not already been started and ifE               file DNS$DEFAULT_FILE.DAT exists. If this file does not F               exist, the installation reminds you to execute procedureI               SYS$STARTUP:DNS$CHANGE_DEF_FILE.COM before you try to start H               DECdfs. This procedure copies file DNS$DEFAULT_FILE.DAT to4               your node and starts the DECdns clerk.  F               On systems running DECnet Phase V, the file DNS$DEFAULT_D               FILE.DAT is no longer used. The DECdns clerk is always>               installed and running on DECnet Phase V systems.  *         1.10.2.3 DECdns Logical Name Table  H               DECdns uses its own logical name table for DECdns objects.G               You must supply the name of this table, DNS$SYSTEM_TABLE,.B               to any DEFINE command that applies to related DECdnsG               objects. For example, suppose you want to define a system G               logical name in your DFS$SYSTARTUP.COM procedure for your.F               namespace name or directory. Supply the DEFINE statementB               with the qualifier that specifies the DECdns logicalF               name table, DNS$SYSTEM_TABLE. To create the logical name@               EXAMPLE_DIR, you could include the following line:  O               $ DEFINE/TABLE=DNS$SYSTEM_TABLE EXAMPLE_DIR -"THIS.IS.AN.EXAMPLE"   I                                           Installation Prerequisites 1-11  n  l           Installation Prerequisites     1.10 Configuration Planning.    @           Keep this OpenVMS and DECdns change in mind if you areD           upgrading to DECdfs Version 2.4 from an earlier version of           DECdfs..  7     1.10.3 Installing DECdfs on OpenVMS Cluster Systemse  @           In an OpenVMS Cluster environment with only one systemB           disk, you need to install DECdfs server software on onlyB           one cluster member. VMSINSTAL places all DECdfs files inB           the SYS$COMMON directory. This provides identical DECdfsE           environments for each cluster member; for example, mounting C           the same access points and serving the same access points >           added by using the ADD ACCESS_POINT command with the           /CLUSTER qualifier.   C              ________________________ Note ________________________h  A              All nodes in an OpenVMS Cluster system that will run.C              DECdfs need a registered and loaded DECdfs license PAK.*              before DECdfs can be started.  C              ______________________________________________________.  ?           You can create a different DECdfs environment on each :           node in an OpenVMS Cluster system by copying theC           DFS$SYSTARTUP.COM and DFS$CONFIG.COM files to each node's1C           SYS$SPECIFIC:[SYS$STARTUP] directory and modifying it for1'           that specific cluster member.   C           If you want to run some cluster members as DECdfs client-1=           only nodes and others as DECdfs server nodes, copy:.  5           o  The DFS$CONFIG.COM file to each member's C              SYS$SPECIFIC:[SYS$STARTUP] directory and modify it forr*              that specific cluster member.  8           o  The DFS$SYSTARTUP.COM file to each member'sC              SYS$SPECIFIC:[SYSMGR] directory and modify it for that %              specific cluster member..  6           o  The DFS$STARTUP.COM file to each member's>              SYS$SPECIFIC:[SYS$STARTUP] directory and edit the              following lines:.    #     1-12 Installation PrerequisitesF s  s      I                                                Installation PrerequisiteseI                                               1.10 Configuration Planning.    5                  $! Installation specific parameters:a                  $!.-                  $ START_CLIENT_FLAG = "TRUE" -                  $ START_SERVER_FLAG = "TRUE"f                  $!                   $!.+                  $! Title = DFS$STARTUP.COM   D               The flag START_SERVER_FLAG = "TRUE" indicates that theA               DECdfs server software can be started on this node.sD               Edit the DFS$STARTUP.COM file only when you change theB               configuration of the node. Make one of the following               changes:  I               o  When you change from a server to a client-only node, you.F                  must change the flag START_SERVER_FLAG from "TRUE" to                  "FALSE."   I               o  When you change from a client-only to a server node, youiG                  must change the flag START_SERVER_FLAG from "FALSE" to.                  "TRUE."  F               To run DECdfs on a heterogeneous OpenVMS Cluster system,C               on a mixed architecture OpenVMS Cluster system, or on E               a homogeneous OpenVMS Cluster system that uses multiple G               system disks, install DECdfs on each of the system disks. E               Each node and system disk needs a registered and loaded D               license PAK before DECdfs can be started on that node.  8         1.11 Reviewing the DECdfs Installation Procedure  E               Before installing DECdfs, assemble the information that C               you must provide to VMSINSTAL during the installation D               procedure. To determine the context in which VMSINSTAL@               requires this information, review the installation6               procedure (as described in Section 2.2).  A               Read the DECdfs release notes before continuing the H               installation procedure. Use the OPTIONS N parameter in theI               command line to gain access to the release notes. After you I               complete the installation, you can access the release notes G               in SYS$HELP:HP-VMS-DECDFS024.RELEASE_NOTES. See Chapter 2 D               for more information about the installation procedure.  B               If DECdfs files exist on your system from a previous>               installation, read the following three sections.  I                                           Installation Prerequisites 1-13                 Installation Prerequisites4     1.11 Reviewing the DECdfs Installation Procedure    B     1.11.1 Rebooting an Existing DECdfs System Before or After the            Installation   B           DECdfs uses OpenVMS drivers that, once loaded, cannot be@           unloaded without rebooting the system. Therefore, if aE           previous version of DECdfs is running on the target system,e9           one of the following two actions must be taken:o  C           o  Reboot the system without starting DECdfs before doingt              the installation.  C           o  Do the installation and promptly reboot the system. In E              this case, once you complete the installation and before @              the system is rebooted, you will not be able to runE              DFS$CONTROL because of version incompatibilities between C              drivers, installed images, and new files. Furthermore, ;              you cannot run the IVP until after the reboot.   ?           Hewlett-Packard recommends that you reboot the system,9           without starting DECdfs before you perform thist<           installation. If you choose to do the installation@           first, reboot the system as soon as possible after theE           installation is complete. Do not attempt to run DFS$CONTROLe@           or the IVP, or restart DECdfs, until after the reboot.  E           If you reboot first, you will not need to reboot again wheniC           the installation completes. To avoid starting DECdfs, youeD           must edit your SYS$SYSTARTUP file or otherwise temporarily0           eliminate the call to DFS$STARTUP.COM.  +     1.11.2 Renaming Existing DFS*.EXE Filese  @           The installation checks whether any DFS*.EXE files are>           in the SYS$SPECIFIC:[SYSEXE], SYS$SPECIFIC:[SYSLIB],:           SYS$SPECIFIC:[SYS$LDR], or SYS$SPECIFIC:[SYSMSG]B           directories. If you moved DFS*.EXE files to any of theseC           directories, VMSINSTAL asks you if you want to rename allt@           DFS*.EXE files to DFS*.OLD (see Section 2.3.1). If youB           answer YES, the installation procedure renames the filesE           and continues. Otherwise, the installation procedure aborts (           and displays an error message.  @           If you want to conserve disk space, remember to delete>           all the previous versions of the DFS*.EXE files from;           the SYS$SPECIFIC:[SYSEXE], SYS$SPECIFIC:[SYSLIB], ;           SYS$SPECIFIC:[SYS$LDR], and SYS$SPECIFIC:[SYSMSG]_  #     1-14 Installation Prerequisites            I                                                Installation PrerequisitesdI                          1.11 Reviewing the DECdfs Installation Procedurer    H               directories before you install DECdfs. If DECdfs runs on aH               cluster system, delete these files on all cluster members.  1         1.11.3 Processing Existing DFS*.COM Files   C               As part of its installation, DECdfs Version 2.4 looks E               for existing DFS$CONFIG.COM and DFS$SYSTARTUP.COM files D               in directories SYS$STARTUP and SYS$MANAGER. If it doesE               not find these files, the installation procedure places C               a default version of the missing file in SYS$MANAGER.iA               If it finds these files, the installation procedure G               places the respective template files (DFS$CONFIG.TEMPLATEbC               and DFS$SYSTARTUP.TEMPLATE) in SYS$MANAGER. Note that C               if you have previously moved either DFS$CONFIG.COM orp@               DFS$SYSTARTUP.COM to SYS$SPECIFIC directories, theG               installation proceeds as if these two files do not exist.aH               DECdfs uses the DFS$SYSTARTUP.COM and DFS$CONFIG.COM filesD               for adding or mounting access points (or both) and for%               configuration purposes.t  B               The installation procedure always renames previously               existingI               DFS$STARTUP.COM files to DFS$STARTUP.OLD and provides a newe4               startup file in directory SYS$STARTUP.            1.12 Maintenance Updates  I               Hewlett-Packard may periodically issue a maintenance update I               release of the DECdfs software. If you are upgrading from a H               previous version of DECdfs, your software installation kitI               will not include new documentation if the documentation has4H               not been revised. In this case, use the installation guideC               for the previous version to install the new software.s  C               The release notes included with each software releaserB               describe new and changed software features. Hewlett-G               Packard recommends that you read the release notes beforeoI               installing the software to ensure that you are aware of any =               special installation or operating requirements.a  I               For more information about reading, printing, and accessing @               the release notes before you install the software,D               follow steps 1 through 6 of the installation procedureE               in Section 2.2. You can stop the installation procedure E               during step 6 by answering the "Do you want to continuetC               the installation [NO]?" prompt with NO. You can read,n  I                                           Installation Prerequisites 1-15/                Installation Prerequisites     1.12 Maintenance Updates    D           display, or print the release notes after the installationC           by specifying the SYS$HELP:HP-VMS-DECDFS024.RELEASE_NOTES            file.                                                                                     #     1-16 Installation Prerequisites)                         I                                                                         2 I         _________________________________________________________________i  I                                             Installation and Verification     I               This chapter contains general information about the OpenVMS G               installation procedure (VMSINSTAL) and explains each stepKF               of the procedure. This chapter also describes additionalI               DECdfs installation messages that you may receive during ane               installation.i  #         2.1 Preliminary InformationL  C               Hewlett-Packard recommends that you read Section 1.11rB               and this section before you install DECdfs. Hewlett-I               Packard also recommends that you back up your system before )               beginning the installation.d  G               Use the installation procedure, VMSINSTAL, to install the H               DECdfs software on an OpenVMS system. The sample procedureH               in Section 2.2 installs both client and server software onI               a node. If you are establishing a client-only node, you canaI               delete the files that are used by only the server after therG               DECdfs installation is complete. See Section 3.8 for moreD6               information about reclaiming disk space.  E               VMSINSTAL asks a series of questions, to which you mustSE               provide appropriate responses. Default responses appeareB               in brackets ([]). Press Return to accept the defaultA               response. For help while installing DECdfs, enter a 1               question mark (?) after the prompt._  D               To abort the installation procedure, press Ctrl/Y. TheI               installation procedure deletes all DECdfs files that it has I               created up to that point and returns to the DCL prompt ($)._G               If you want to retry the installation procedure after yousG               press Ctrl/Y, you must invoke VMSINSTAL again. See Step 2W8               in Section 2.2 for additional information.      I                                         Installation and Verification 2-1,    l      !     Installation and Verificationr     2.1 Preliminary Information     D           To save a copy of the VMSINSTAL session on disk for futureD           reference, use the SET HOST 0 /LOG command before invokingE           VMSINSTAL. Node 0 represents the local node. See Appendix B #           for sample installations.e  1           Before you install DECdfs, ensure that:r  >           o  Your system is running the required software (see5              Section 1.3 for additional information).   <           o  Your system has the required free disk space on<              the system disk (see Section 1.5 for additional              information).  ?           o  You modified the SYSGEN parameters as described inw              Section 1.7.d  ?           o  Your DECnet Phase IV or DECnet Phase V software iso#              installed and running.o  B           o  At least one DECdfs server is installed, running, andC              accessible and at least one registered access point is/A              available if you wish to create a DECdfs client-only @              configuration and run the Installation Verification              Procedure (IVP).m  C           o  If you are running DECnet Phase IV on a VAX processor, >              the DECdns Distributed Name Service is running onB              the network and is accessible (see Section 1.10.2 for%              additional information).u  C           o  If you are running DECnet Phase IV on a VAX processor,rB              the file SYS$SYSTEM:DNS$DEFAULT_FILE.DAT is necessaryE              for DECdns to work properly. If this file does not existe@              on your system, execute SYS$STARTUP:DNS$CHANGE_DEF_D              FILE.COM to obtain a copy of this file from your DECdnsA              server. The file is not necessary if you are runninghE              DECnet Phase V. DECdns is not available on Alpha systemsr%              running DECnet Phase IV.        2.2 Installation Procedure  B           This section presents the steps of a sample installationE           procedure for installing DECdfs client and server software.n=           To install the DECdfs software, follow these steps:S  %     2-2 Installation and Verificationi    f      I                                             Installation and Verification I                                                2.2 Installation Procedure     ;               Step 1. Log in to the system manager account.t  H               The system manager account has the necessary privileges to               run VMSINSTAL.  '               Step 2. Invoke VMSINSTAL.f  D               To invoke VMSINSTAL, enter the following command line:  F               $ @SYS$UPDATE:VMSINSTAL HP-VMS-DECDFS024 ddcu: OPTIONS N  E               The value ddcu: represents the name of the device whereoE               you mounted the distribution media. For example, if theeG               DECdfs kit is in a subdirectory on a user disk, you mightdH               construct the device name MY_SYS$DUA1:[MY_DIRECTORY]. WhenI               you invoke VMSINSTAL and include the OPTIONS N parameter in G               the command line, you can view or print the release notes G               automatically. If you omit OPTIONS N in the command line,rH               you cannot print or read the release notes until after the1               installation procedure is complete.E  ?               The following message is displayed on the screen:m  J                       OpenVMS Software Product Installation Procedure Vn.n  )               It is dd-mmm-yyyy at hh:mm.   =               Enter a question mark (?) at any time for help.   F                 ________________________ Note ________________________  ?                 The real version number, date, and time will be C                 substituted for the variables shown in italic type.D  F                 ______________________________________________________  3               Step 3. Check the system environment.o  G               VMSINSTAL checks your system environment and notifies you F               of any running processes. For example, your system might,               display the following message:  L               %VMSINSTAL-W-ACTIVE, The following processes are still active:                        MAIL_38503  4               * Do you want to continue anyway [NO]?  D               This message is informational only. Enter NO (or pressC               Return) to end the installation and return to the DCLaB               prompt ($). Enter YES to continue installing DECdfs.  I                                         Installation and Verification 2-3i e  1      !     Installation and Verificationi     2.2 Installation Procedure               Step 4. Check backup.D  B           The following message reminds you to back up your system*           disk before installing software:  H           * Are you satisfied with the backup of your system disk [YES]?  B           Enter YES to continue installing DECdfs. Enter NO to end<           the installation and return to the DCL prompt ($).  4           Step 5. Mount the installation kit volume.  C           If the device you provided in step 2 for the distribution B           media is not mounted, VMSINSTAL prompts you to mount theC           installation kit volume. Mount the volume and ensure that ?           the device is in the READY state. Enter YES and press @           Return when you are ready. A message confirms that the%           media is mounted and ready:   ;           Please mount the first volume of the set on ddcu:y             * Are you ready? YES?           %MOUNT-I-MOUNTED, HP-VMS-DECDFS024 mounted on _ddcu:.s  )           Step 6. Start the installation.t  @           After you mount the installation kit volume, VMSINSTAL*           displays the following messages:  3           The following products will be processed:h               HP-VMS-DECDFS V2.4  G                   Beginning installation of HP-VMS-DECDFS V2.4 at hh:mme  @           %VMSINSTAL-I-RESTORE, Restoring product save set A ...  C           Release notes included with this kit are always copied toeA           SYS$HELP. If you included OPTIONS N in the command linedA           in step 2, the Additional Release Notes Options menu isAA           displayed. You can select one of the following options:k  +           Additional Release Notes Options:   +                   1.  Display release notes )                   2.  Print release notes "                   3.  Both 1 and 2'                   4.  None of the above               * Select option [2]: 2  @           If you choose option 1, VMSINSTAL displays the release!           notes at your terminal.   %     2-4 Installation and Verification. e  e      I                                             Installation and VerificationeI                                                2.2 Installation Procedure     F               If you choose option 2, VMSINSTAL prompts you to enter a*               print queue name as follows:  %               Queue name [SYS$PRINT]:G  I               Type a print queue name or press Return. VMSINSTAL queues aeG               copy of the release notes to print and displays a message $               such as the following:  L               Job HP-VMS-DECDFS024 (queue queue, entry nnn) started on queue  D               If you select option 3, VMSINSTAL displays the releaseD               notes on your screen and prompts you for a print queue               name.I  C               If you select option 4, VMSINSTAL does not display or I               print the release notes at any time during the installation_               procedure.  I               After you select any of the options, VMSINSTAL displays the_                following message:  >               * Do you want to continue the installation [NO]?  D               One way to read the release notes now is to respond NOG               and locate them in SYS$HELP. A NO response terminates thelE               installation and requires you to start again at step 1.iE               Regardless of your response, the procedure displays thee                following message:  J               %VMSINSTAL-I-RELMOVED, The product's release notes have been-               successfully moved to SYS$HELP.g  B               Step 7. Run the Installation Verification Procedure.  E               VMSINSTAL asks whether you want to run the Installation F               Verification Procedure (IVP) as part of the installationG               procedure. If you enter YES, you need to supply an access E               point name in step 13. If you enter NO, VMSINSTAL skips                steps 13 and 14.  H               * Do you want to run the IVP after the installation [YES]?  &               Step 8. Purge old files.  E               VMSINSTAL asks whether you want to purge files that areaI               replaced during the installation process. To retain the oldIG               copies, enter NO; otherwise, enter YES (or press Return).,  O               * Do you want to purge files replaced by this installation [YES]?   I                                         Installation and Verification 2-5            !     Installation and Verificationa     2.2 Installation Procedure    @           If VMSINSTAL finds DFS*.EXE files in any SYS$SPECIFIC:C           directory, the procedure lists the files and asks whether C           you want to rename them. See Section 2.3.1 for the dialog !           and possible responses.   ?           If VMSINSTAL finds DECdfs driver files in SYS$SYSTEM, A           the procedure asks whether you want to delete them. See >           Section 2.3.2 for the dialog and possible responses.  +           Step 9. Verify the configuration.e  D           VMSINSTAL asks whether the stated configuration is correct           or not.e             DECnet Phase IV:  6            Current configuration:   OpenVMS/xxx Vn.n -     DECnet Phase IVl  I           * Install the DFS files that support this configuration? [YES]?              DECnet Phase V:t  B            Current configuration:   OpenVMS/xxx Vn.n - DECnet-Plus  I           * Install the DFS files that support this configuration? [YES]?   >           In the previous examples, the variables can have the           following values:x  8           o  xxx can be either an Alpha or I64 processor  D           o  Vn.n can be Version 8.2 for Alpha processors or Version$              8.2 for I64 processors.  A           To use the configuration displayed, enter YES (or press ?           Return). If this configuration does not represent the=>           system, enter NO. If you enter NO, you are given the>           opportunity to choose one of the following alternate           configurations:i  #            Possible configurations:T8                       1. OpenVMS I64 V8.2  - DECnet Plus  <                       2. OpenVMS I64 V8.2  - DECnet Phase IV  9                       3. OpenVMS Alpha V8.2 - DECnet Plusc  =                       4. OpenVMS Alpha V8.2 - DECnet Phase IVu  *                       0. Stop installation  %     2-6 Installation and VerificationR    A      I                                             Installation and Verification I                                                2.2 Installation Procedure                     * Enter number [4]  H               If you want to stop the installation, enter 0. The defaultF               is the stated configuration. If you prefer the alternateC               configuration, enter one of the other numbers. If younB               choose an alternate configuration, a difference willC               exist between the stated configuration and the chosenoI               configuration, and a warning message and question thereforer                will be displayed.  A                %DECDFS_-VRMISM-E, Architecture type, VMS version,eE                -DECDFS_-VRMISM-E, or DECnet version mismatch detectedt  E               * Do you wish to continue with this configuration? [NO]t  I               If you answer NO, the installation ends. If you answer YES,u               it continues.   8               Step 10. Install the Help Message Utility.  G               If you are installing on a system that is running OpenVMSnH               Version 6.2 or later, the following question is displayed:  4               * Install DFS Help Message file? [YES]  H               If you answer YES, the installation procedure displays the                following message:  I                 Add SYS$HELP:DFS.MSGHLP$DATA to the searchlist defined byiK                 MSGHLP$LIBRARY in order to include the DFS messages in youroG                 HELP/MESSAGE search. Please refer to the OpenVMS SYSTEM B                 MANAGER'S MANUAL: ESSENTIALS for more information.  9               Step 11. Install client or server software.i  C               Indicate whether you want to install client or servermG               software on this node at this VMSINSTAL prompt. Enter YESsI               to install both the client and server software. Enter NO to +               establish a client-only node.i  \               * Do you want to install the DECDFS03 V2.4 SERVER software on this node [YES]?  F               After you answer these questions, VMSINSTAL displays the                following message:  (                       Product:       DFS(                       Producer:      DEC(                       Version:       2.00                       Release Date:  20-JUN-1994  I                                         Installation and Verification 2-7n g  e      !     Installation and Verificatione     2.2 Installation Procedure    :           The Product name DFS indicates a server software?           installation; the Product name DFS-CLIENT indicates ar@           client software installation. The Product name is also:           the PAK name, which is checked in the next step.  @           Step 12. Check for a License Product Authorization Key           (PAK).  E           VMSINSTAL checks for a registered and loaded DECdfs license            PAK.  N           * Does this product have an authorization key registered and loaded?  ?           Enter YES or press Return to indicate that the DECdfsd@           license PAK is installed. Enter NO and press Return if2           the DECdfs license PAK is not installed.  D           If you are installing DECdfs client software (you answeredD           NO in step 11), the installation procedure looks for a PAKB           named DFS-CLIENT, which includes only the client. If youD           are installing DECdfs server software (you answered YES inD           step 11), the installation procedure looks for a PAK named5           DFS, which includes both server and client.c  C           You can continue to install DECdfs without a license, butfD           the IVP cannot run and DECdfs cannot be started as part ofC           the installation or when the installation finishes. AftereE           using the License Management Facility (LMF) to register andPD           load the license PAK, you can start DECdfs or run the IVP.  /           Step 13. Read informational messages.i  B           VMSINSTAL displays the following informational messages:  O                    Installation will be complete in approximately 1 - 5 minutes 5                    depending upon your configuration.n  P                    There are no more questions unless you choose to run the IVP.3                    Installing DECdfs software . . .n  @           %VMSINSTAL-I-RESTORE, Restoring product save set B ...  ?           The following table shows the save sets installed forsD           each possible operating system/processor/network transport           combination:  %     2-8 Installation and VerificationT    e      I                                             Installation and VerificationoI                                                2.2 Installation Procedures  I               ___________________________________________________________cI               ______________________DECnet_Phase_IV______________________u  I               Operating_System___________Save_Sets_______________________s  ,               OpenVMS I64 Version 8.2    A,C  ,               OpenVMS Alpha Version 8.2  A,E  I               ___________________________________________________________1I               ______________________DECnet_Phase_V_______________________c  I               Operating_System___________Save_Sets_______________________   ,               OpenVMS I64 Version 8.2    A,B  I               OpenVMS_Alpha_Version_8.2__A,D_____________________________   8               Step 14. Complete the DECdfs installation.  H               If the installation has proceeded without errors on a nodeG               that does not have DECdfs running, VMSINSTAL displays theeH               following text as it completes the installation of DECdfs:                 DECnet Phase IV:  R                       The following line should be added to your SYSTARTUP commandM                       file to automatically start DFS at system startup time:t  /                  "@SYS$STARTUP:DFS$STARTUP.COM"   Q                       Put DFS$STARTUP after the statement that invokes the DECnet N                       startup command file (STARTNET.COM). The DECnet softwareA                       must be started before the DECdfs software.                  %VMSINSTAL-I-k:         MOVEFILES, Files will now be moved to their target               directories...                 DECnet Phase V:   R                       The following line should be added to your SYSTARTUP commandM                       file to automatically start DFS at system startup time:e/                  "@SYS$STARTUP:DFS$STARTUP.COM"e               %VMSINSTAL-I- :         MOVEFILES, Files will now be moved to their target               directories...  F                 ________________________ Note ________________________  D                 Additional text may appear in the preceding display.B                 See Section 2.3.4 for information about this text.  F                 ______________________________________________________  I                                         Installation and Verification 2-9V i  u      !     Installation and Verification      2.2 Installation Procedure    E           Step 15. Run the Installation Verification Procedure (IVP).a  B           If you answered NO to the question in step 7, proceed to           step 15c.   B           If you previously specified that you want to run the IVPB           after the installation and no errors occurred, VMSINSTAL;           starts DECdfs and displays the following message:e  N               The Installation Verification Procedure will now be run.  PleaseQ               review preceding messages and take note of postinstallation actionsnM               that may be required (such as editing the SYSTARTUP procedure).i  %           Begin the DECdfs IVP? [YES]a  ?           Enter YES to start the IVP; enter NO to skip the IVP. D           VMSINSTAL displays a message that is specific for either aE           client-only (step 15a) or a server (step 15b) installation.uC           The IVP prompts you for an access point name. Section 3.1oA           describes how to run the IVP and Appendix B includes anb           example of the IVP.   $           Step 15a. Client-Only IVP.  C           If you are verifying a client-only software installation, D           the IVP displays the following message and prompts you forC           an existing access point name (a DECdns name that you can C           get from the system manager of a DECdfs server node). The B           IVP uses an access point name to test a DECdfs mount and           dismount operation.A  C              ________________________ Note ________________________   C              The account you use to run the DECdfs client IVP needsaA              read-access rights to the DECdns directory where the "              access point resides.  C              ______________________________________________________a              &     2-10 Installation and Verification l         I                                             Installation and Verification I                                                2.2 Installation Proceduret    G                  This system will run as a DECdfs Client. To verify the O                  installation, an Access Point must exist on a Server Node. You P                  must have already ADDed this Access Point on one of your ServerS                  Nodes. To do this, use the DFS$CONTROL command ADD ACCESS_POINT onC                  a Server Node.   B                * Enter an Access Point name [] ? access_point_name  F                 ________________________ Note ________________________  =                 On Alpha systems running DECnet Phase IV, the /                 following message is displayed:E  W                    DNS is not available on this system. Therefore, the name of the node.U                    which serves this access point must also be entered. Note that for V                    normal operation, the /NODE qualifier must be supplied on DFS MOUNT+                    commands on this system.C  E                  * Enter the node which serves this access point [] :l  F                 ______________________________________________________  E               The IVP verifies that the DECdfs client can communicateyH               with the DECdfs server and at least one DECdns server. The2               IVP displays the following messages:  :               $ DFSCP MOUNT access_point_name DFS$IVP_DISKP               %MOUNT-I-MOUNTED, access_point_name mounted on _DFSC1001: (40FORD)+               $ DFSCP DISMOUNT DFS$IVP_DISK H               %DFS-S-DISMNT_SUCCESS, Dismount was successfully performed  #               Step 15b. Server IVP.:  F               If you are verifying a server software installation, theF               IVP displays the following message and prompts you for aG               unique name to use as a temporary access point. This name F               must follow the DECdns naming conventions in use in yourI               namespace. Ask the DECdns manager about your network naming C               conventions. The IVP uses this name to add the accessED               point, mount and dismount the access point, and removeH               the access point. The IVP can then verify whether there isG               communication among the DECdfs clients and the DECdfs andc               DECdns servers.     I                                        Installation and Verification 2-11  o  g      !     Installation and Verificationo     2.2 Installation Procedure    C              ________________________ Note ________________________.  C              The account you use to run the DECdfs server IVP needsoA              read and write access rights in the DECdns directoryo>              where you plan to add the temporary access point.  C              ______________________________________________________E  B            This system will run as a DECdfs Server.  To verify theE            installation, an Access Point must be ADDed on the Server.rK            This procedure creates an Access Point for its own use. You must J            supply a name for this Access Point that does not already existP            and is consistent with the DECdns naming policy used in your network.  =           * Enter an Access Point name [] ? access_point_name   C              ________________________ Note ________________________o  :              On Alpha systems running DECnet Phase IV, theA              following additional message is displayed before the !              access point prompt:   I                 Be sure to use the namespace prefix (e.g., DEC:.nam.nam).h  C              ______________________________________________________   =           The IVP now executes while displaying the followingh           messages:t  K           $ DFSCP ADD ACCESS_POINT access_point_name SYS$SYSDEVICE:[000000]i6           $ DFSCP MOUNT access_point_name DFS$IVP_DISKC           %MOUNT-I-MOUNTED, access_point_name mounted on _DFSC1001:               .              .              .'           $ DFSCP DISMOUNT DFS$IVP_DISK D           %DFS-S-DISMNT_SUCCESS, Dismount was successfully performed7           $ DFSCP REMOVE ACCESS_POINT access_point_name               Step 15c. End the IVP.  E           After the specific client or server IVP in step 15a or steptA           15b, VMSINSTAL displays a message verifying that eitheruC           the DECdfs software was installed successfully or the IVP C           failed. If you receive any error messages during the IVP, C           see the explanations in the DECdfs for OpenVMS Managemente           Guide.  &     2-12 Installation and Verification s  .      I                                             Installation and VerificationyI                                                2.2 Installation Procedure     P               ******************************************************************4                           DECdfs V2.4 IVP SuccessfulP               ******************************************************************  A               You can run the IVP at any time to check the DECdfseD               software. See Section 3.1 for more information and forI               instructions on how to run the IVP after installing DECdfs.h  6               Step 16. End the installation procedure.  H               After the installation of the DECdfs software is complete,7               VMSINSTAL displays the following message:m  E                Installation of HP-VMS-DECDFS V2.4 completed at hh:mm.   A               The following message then indicates that VMSINSTAL E               successfully completed installation and verification of "               the DECdfs software:  0                VMSINSTAL procedure done at hh:mm  E               If VMSINSTAL reports a failure, review the installationmD               prerequisites. If you removed console media before youF               installed the software, replace the media in the console               drive.  &         2.3 Additional DECdfs Messages  A               You may receive additional messages during a DECdfs H               installation. The following sections describe those DECdfs>               messages and the conditions that can cause them.  $         2.3.1 Renaming Files Message  =               If VMSINSTAL finds existing DECdfs files in anynD               SYS$SPECIFIC: directory, the following message appears*               after step 8 in Section 2.2:                I                                        Installation and Verification 2-13p e  e      !     Installation and Verification "     2.3 Additional DECdfs Messages    L                   Previous versions of the following files were found in theO                   SYS$SPECIFIC directories. In order for DECdfs to be installed]I                   properly, the files must be renamed so that they do not4M                   interfere with the installation.  You may continue with the L                   installation by answering "YES" to the following question;>                   otherwise, the installation will be aborted.  I                   Also, as part of a cluster, please delete or rename thet@                   following files on ALL members of the cluster.  5                   SYS$SPECIFIC:[SYSEXE]DFSCDRIVER.EXEr6                   SYS$SPECIFIC:[SYSEXE]DFSRRDRIVER.EXE6                   SYS$SPECIFIC:[SYSEXE]DFS$COM_ACP.EXE5                   SYS$SPECIFIC:[SYSEXE]DFSSDRIVER.EXES9                   SYS$SPECIFIC:[SYSEXE]DFS$SERVER_ACP.EXE 9                   SYS$SPECIFIC:[SYSEXE]DFS$COM_LOGGER.EXE 6                   SYS$SPECIFIC:[SYSEXE]DFS$CONTROL.EXE  6                   SYS$SPECIFIC:[SYS$LDR]DFSCDRIVER.EXE7                   SYS$SPECIFIC:[SYS$LDR]DFSRRDRIVER.EXEO6                   SYS$SPECIFIC:[SYS$LDR]DFSSDRIVER.EXE  6                   SYS$SPECIFIC:[SYSLIB]DFS$MESSAGE.EXE7                   SYS$SPECIFIC:[SYSLIB]DFS$MNGT_SHR.EXEF8                   SYS$SPECIFIC:[SYSLIB]DFS$MOUNT_SHR.EXE  N           * Do you want to rename all SYS$SPECIFIC DECdfs files to .OLD [YES]?  A           If you enter YES, VMSINSTAL renames the listed DFS*.EXE ?           files to DFS*.OLD and continues with the installation            procedure.  >           If you enter NO, VMSINSTAL ends the installation and/           displays the following error message:   P           %VMSINSTAL-E-INSFAIL, The installation of DECdfs V2.4 has successfully           failed.   C           If you are installing the software on a cluster, you mustt?           delete the listed files or rename them on all cluster D           members before retrying the DECdfs installation procedure.        &     2-14 Installation and Verification    t      I                                             Installation and VerificationoI                                            2.3 Additional DECdfs Messagesg    /         2.3.2 Deleting Old Driver Files Messagel  F               VMSINSTAL displays the following message after step 8 inI               Section 2.2 if you chose to purge files and if it finds olds>               DECdfs driver files in the SYS$SYSTEM directory:  U               * Do you want to delete old DECdfs driver images from SYS$SYSTEM [YES]?o  E               If you enter YES, VMSINSTAL deletes the obsolete DECdfs I               driver files. If you enter NO, DECdfs operates successfully @               but the obsolete DECdfs driver files remain in the#               SYS$SYSTEM directory.6  (         2.3.3 DECdfs License PAK Message  F               VMSINSTAL displays the following message after step 9 inE               Section 2.2 if the DECdfs license PAK is not installed:   O                    The startup file will not be executed after installation and S                    the IVP will not run.  Install the DECdfs license PAK before youe0                    start DECdfs and run the IVP.  %         2.3.4 DECdfs Startup Messagesf  G               The following is a list of all the possible messages that.I               can be displayed before step 12 in Section 2.2 if VMSINSTAL 1               cannot start DECdfs or run the IVP:I  /                    Before starting DECdfs . . .   =                    * You must install the DECdfs license PAK.   9                    * You must increase your GLOBAL PAGES._  <                    * You must increase your GLOBAL SECTIONS.  +                    * You must start DECnet.   J                    * You must execute SYS$STARTUP:DNS$CHANGE_DEF_FILE.COM.  F                    * You must increase the size of your nonpaged pool.B                      See the DECdfs for OpenVMS Installation Guide  D                    * You must reboot your system because you already0                      have DECdfs drivers loaded.  I                                        Installation and Verification 2-15e S  i      !     Installation and Verificationb"     2.3 Additional DECdfs Messages    <                Since DECdfs is not being started, you cannotA                run the Installation Verification Procedure (IVP). @                A copy of the DFS$IVP.COM file is in the SYS$TESTH                directory, so you can run the IVP after you start DECdfs.  1           The message about executing the commandv7           procedure SYS$STARTUP:DNS$CHANGE_DEF_FILE.COMhA           appears if the installation procedure did not find filea<           SYS$SYSTEM:DNS$DEFAULT_FILE.DAT on your node. This7           file defines the default DECdns namespace for 9           your node. Executing this procedure copies file @           SYS$SYSTEM:DNS$DEFAULT_FILE.DAT from the DECdns serverB           node (whose name you provide). Then DECdns can start and           DECdfs can run.t  @           VMSINSTAL displays the following message after step 12A           in Section 2.2 if you need to increase the size of yourm           interrupt stack:  C           You should also increase the size of your Interrupt Stack =           before starting the DECdfs server software. See theh/           DECdfs for OpenVMS Installation Guidet           for more information.)                                            &     2-16 Installation and Verification                         I                                                                         3dI         _________________________________________________________________a  I                                               Postinstallation Procedures     I               This chapter describes the procedures that can be performed 2               after installing DECdfs on a system:  F               o  Running the Installation Verification Procedure (IVP)  >               o  Editing the local system startup command file  +               o  Using DECdfs command filesD  @               o  Setting additional DECnet and system parameters  6               o  Using DECdfs security (OpenVMS proxy)  $               o  Reinstalling DECdfs  ,               o  Changing clients to servers  ,               o  Changing servers to clients  B               o  Deleting server software from client-only systems  I               o  Checking OpenVMS Cluster systems after installing DECdfsY                  softwaree  ;         3.1 Running the Installation Verification Procedure   E               The DECdfs software distribution kit contains a command B               procedure that verifies the correct installation andD               operation of DECdfs. The installation procedure placesI               the procedure file, DFS$IVP.COM, in the SYS$TEST directory.oI               The Installation Verification Procedure (IVP) tests whetherpF               the major components of DECdfs were installed correctly.H               Successful completion of the IVP indicates that the DECdfs)               software operates properly.   F               You can run the IVP when you install the DECdfs softwareH               (as shown in steps 7 and 13 in Section 2.2) or at any timeI               after the software is installed and running. If you want tooH               run the IVP during the installation, VMSINSTAL invokes theG               IVP after the DECdfs components are moved to their target   I                                           Postinstallation Procedures 3-1n a  l           Postinstallation Proceduresn7     3.1 Running the Installation Verification Procedure     @           directories. The procedure displays a message that theC           IVP is running. You then enter information that VMSINSTALnB           needs to complete the IVP. To the IVP independent of the>           installation procedure, supply the same information.  C           To verify a client-only software installation, supply the A           name of an access point that was previously added on an B           accessible DECdfs server. The IVP uses this access pointE           name to test a DECdfs mount and dismount operation. The IVP @           can then verify that the DECdfs client can communicate=           successfully with the DECdfs server and the Digitalo0           Distributed Name Service (DNS) server.  D           To verify a server software installation, supply a unique,B           temporary access point name (a DECdns name, as discussedA           with the DECdns manager). The IVP uses this name to adddD           the access point, mount and dismount the access point, andA           remove the access point from the DECdns namespace. This D           verifies successful communication among the DECdfs clients2           and the DECdfs server and DECdns server.  A           To run the IVP, you need the account privileges SYSNAM,NC           OPER, NETMBX, and TMPMBX, or the privilege SETPRV (allowslD           all privileges to be set). On a DECdfs client, read accessA           to the DECdns namespace directory that stores an access =           point name for that client is sufficient to run theaB           IVP. You need read and write access rights in the DECdnsE           namespace directory to run the IVP on a DECdfs server. Your E           DECdns manager grants these access rights. The IVP fails if 8           you do not have the appropriate access rights.  A           You need the read and write access rights for your user A           name on a specific DECnet node for the DECdns namespace_?           directory that you plan to use. You need access to attA           least one DECdns directory (usually the directory wheret?           you plan to add access points) to perform an IVP on ayB           DECdfs server. For example, if the DECdns manager grants@           the access rights to the SALES.WEST directory, you canC           add a unique access point name to that directory, such asw            SALES.WEST.DFSIVPTEST.  <           To run the IVP independently from the installation1           procedure, enter the following command:n             $ @SYS$TEST:DFS$IVP   #     3-2 Postinstallation Procedurest i  D      I                                               Postinstallation Procedures-I                       3.1 Running the Installation Verification ProcedureP    C               You can delete the DFS$IVP.COM file without adversely G               affecting any DECdfs operations. However, Hewlett-PackardiI               recommends that you not delete this file as you may want tom                run the IVP later.  9         3.2 Editing the Local System Startup Command Fileh  H               Edit your system startup command file if you want to start#               DECdfs automatically.   >               For VAX/VMS Version 5.5-2 systems running DECnet:               Phase IV, the system startup command file is+               SYS$STARTUP:SYSTARTUP_V5.COM.t  H               For other OpenVMS systems, the system startup command file/               is SYS$STARTUP:SYSTARTUP_VMS.COM.   I               Edit the file so that it invokes the DECdfs startup command H               file, SYS$STARTUP:DFS$STARTUP.COM, by adding the following               line:   *               @SYS$STARTUP:DFS$STARTUP.COM  E               For DECnet Phase IV systems, insert this line after the E               statement that invokes the DECnet startup command file:i                 STARTNET.COM.   E               For DECnet Phase V systems, the network startup commandV>               file does not appear in the system startup file.  I               DECnet software must be started before the DECdfs software.cH               If you use a batch job to start the DECnet software, startC               the DECdfs software later in the same batch stream tocE               ensure that the DECdfs software starts after the DECnet                software.a  I               The following sample portion of a system startup file showslI               the statement that invokes the DECdfs startup command file. G               This statement executes the DFS$STARTUP command procedure G               in your SYS$STARTUP directory. The sample applies to both:9               DECnet Phase IV and DECnet Phase V systems.t      I                                           Postinstallation Procedures 3-3c o              Postinstallation Procedures 5     3.2 Editing the Local System Startup Command File                                   .1           $ !Command procedure to start up DECnet 
           $ !p;           $ IF F$SEARCH("SYS$SYSTEM:NETACP.EXE") .NES. "" - 0                   THEN @SYS$STARTUP:STARTNET.COM                              .                              .                              .1           $ !Command procedure to start up DECdfsd
           $ !gA           $ IF F$SEARCH("SYS$STARTUP:DFS$STARTUP.COM") .NES. "" -S3                   THEN @SYS$STARTUP:DFS$STARTUP.COM                               .                              .                              .  "     3.3 Using DECdfs Command Files  <           The DECdfs startup command procedure (DFS$STARTUP)?           executes two DECdfs command files: DFS$CONFIG.COM andeD           DFS$SYSTARTUP.COM. Modify these files to suit your network           environment.  >           When DECdfs starts, the DFS$STARTUP.COM file invokes=           SYS$MANAGER:DFS$CONFIG.COM. This configuration filei=           sets configuration parameters. To change the static ?           DECdfs parameters, you must change the values for the E           parameters in the DFS$CONFIG.COM file. A related file namedaD           DFS$CONFIG.TEMPLATE contains the default settings for each           parameter.  /           The DFS$STARTUP.COM file also invokessA           SYS$STARTUP:DFS$SYSTARTUP.COM, which adds access pointsnD           to the DECdfs server and mounts DECdfs client devices that+           are shared throughout the system.c  D           If you have files DFS$CONFIG.COM or DFS$SYSTARTUP.COM fromD           earlier versions (prior to Version 2.4) of DECdfs, you mayC           wish to process them as follows, because they can containn           obsolete commands:  ;           1. Rename existing versions of DFS$CONFIG.COM andp:              DFS$SYSTARTUP.COM files to DFS$CONFIG.OLD and-              DFS$SYSTARTUP.OLD, respectively.S  #     3-4 Postinstallation Proceduresi .         I                                               Postinstallation Procedures I                                            3.3 Using DECdfs Command Files     I               2. Create new DFS$*.COM files by copying the DECdfs Version G                  2.4 DFS$CONFIG.TEMPLATE file to DFS$CONFIG.COM and the /                  DFS$SYSTARTUP.TEMPLATE file toa@                  DFS$SYSTARTUP.COM in the SYS$MANAGER directory.  @               3. Copy any changed configuration and access pointF                  information from DFS$CONFIG.OLD and DFS$SYSTARTUP.OLDD                  files into the new command files in the SYS$MANAGER                  directory.d  B                  Do not copy any values for the following obsolete@                  parameters from old versions of DFS$CONFIG.COM:  !                     DFS$PQL_BYTLM !                     DFS$PQL_FILLMh9                     SET COMMUNICATION/CONNECTIONS_MAXIMUMy6                     SET COMMUNICATION/SESSIONS_MAXIMUM,                     SET SERVER/FILES_MAXIMUMC                     SET SERVER/PERSONA_CACHE=(BLOCKS_THRESHOLD=xxx)u  E                  If you decide to use older DFS$*.COM files, Hewlett- I                  Packard recommends that you move them to the SYS$MANAGERPI                  directory if possible. Then edit the DFS$CONFIG.COM filel/                  to remove the following lines:o  4                     DEFINE/SYSTEM DFS$PQL_FILLM "nn"4                     DEFINE/SYSTEM DFS$PQL_BYTLM "nn"<                     SET COMMUNICATION/CONNECTIONS_MAXIMUM=nn9                     SET COMMUNICATION/SESSIONS_MAXIMUM=nnA/                     SET SERVER/FILES_MAXIMUM=nnIB                     SET SERVER/PERSONA_CACHE=(BLOCKS_THRESHOLD=nn)                     DECnet Phase V:  >                  On DECnet Phase V systems, do not copy any of>                  the following parameters from old versions of#                  DFS$SYSTARTUP.COM:t  2                     SET/DEFINE EXECUTOR ALIAS NODEA                     SET OBJECT DFS$COM_ACP ALIAS OUTGOING ENABLEDD  H                  Edit the DFS$SYSTARTUP.COM file to remove the following>                  NCP commands if they are present in the file:  E                     SET/DEFINE EXECUTOR ALIAS NODE cluster-alias-name   I                                           Postinstallation Procedures 3-5                 Postinstallation Procedures "     3.3 Using DECdfs Command Files    =                 SET OBJECT DFS$COM_ACP ALIAS OUTGOING ENABLEDo  C              ________________________ Note ________________________y  ?              Failure to remove the obsolete commands from older :              DFS$CONFIG.COM and DFS$SYSTARTUP.COM files as?              recommended in this section does not affect DECdfso;              operation. However, any values entered for thee@              preceding list of obsolete commands are meaningless>              and will not be displayed in response to the SHOW3              COMMUNICATION or SHOW SERVER commands.a  C              ______________________________________________________n  C           If your system is in a cluster, see Section 1.10.3 beforee-           you edit any startup command files.i  E           For more information, see the DECdfs for OpenVMS Managementl           Guide.  7     3.4 Setting Additional DECnet and System Parameters   A           The DECdfs for OpenVMS software was designed to provideaC           excellent performance using the default DECnet parameterssA           and default RMS parameters. In some cases, however, you B           might enhance performance by setting several parameters.C           See Appendix C in the DECdfs for OpenVMS Management GuidelC           for information about setting network and RMS parameters.   '     3.5 Creating OpenVMS Proxy AccountsH  ?           You must create OpenVMS proxy accounts, a DFS$DEFAULT C           account, or both, on DECdfs server systems to ensure that =           users on client systems can access a DECdfs server.   ?           To create proxy accounts, run AUTHORIZE on the server D           system and use the ADD/PROXY command to equate an end userD           on a DECdfs client system to a local user with appropriate            rights and privileges.  @           The following example assumes that the client end userE           already has an account (WPINE) on the server and an account            on node WRKSTN:s    #     3-6 Postinstallation Proceduresn r  e      I                                               Postinstallation Procedures I                                       3.5 Creating OpenVMS Proxy Accounts     &               $ SET DEFAULT SYS$SYSTEM               $ RUN AUTHORIZEe8               UAF> ADD/PROXY WRKSTN::WPINE WPINE/DEFAULT               UAF> EXITt               $   I               Note that OpenVMS VAX Version 6.2 and later systems running C               DECnet Phase V provide long name support in the proxy I               database. On these systems, refer to the following example:f  &               $ SET DEFAULT SYS$SYSTEM               $ RUN AUTHORIZEcA               UAF> ADD/PROXY FOO:.NET.WRKSTN::WPINE WPINE/DEFAULTc               UAF> EXITn               $P  H               To provide access to your DECdfs server to users on clientE               systems without explicit proxy, create a default DECdfsoC               account (DFS$DEFAULT). To make this account availableoE               for use by DECdfs only (and not for logging in), createOG               DFS$DEFAULT as a restricted account following the example D               in the HP OpenVMS System Manager's Manual. You can useD               the DFS$DEFAULT account as an example of how to createE               proxy accounts that can only be used for DECdfs access. G               Make sure you choose a user identification code (UIC) for G               the DFS$DEFAULT account that does not match the UIC of an                existing user.  F                 ________________________ Note ________________________  @                 When creating the DFS$DEFAULT account or a proxyF                 account on a server, note the authorized privileges asA                 well as the default privileges of the DFS$DEFAULT >                 account and the proxy accounts. The authorizedD                 privileges can become effective for users, dependingC                 on the current privileges on the DECdfs client whena&                 the file was accessed.  F                 ______________________________________________________  E               For more information about the DFS$DEFAULT account, seeeC               the DECdfs for OpenVMS Management Guide. For detailednC               information about creating proxy accounts, see the HP F               OpenVMS Guide to System Security and the DECnet-Plus for)               OpenVMS Network Management.   I                                           Postinstallation Procedures 3-7- n  l           Postinstallation Procedures '     3.5 Creating OpenVMS Proxy Accounts     C              ________________________ Note ________________________   <              Make sure you set up the proxy accounts so thatB              DECdfs users have the necessary rights and privileges=              they need to gain access to files. If there is a C              DFS$DEFAULT account (and its DISUSER and CAPTIVE flagssA              are not set), all the users who do not have explicitp>              proxy in the proxy database file (NETPROXY.DAT onB              systems running DECnet Phase IV and NET$PROXY.DAT forC              DECnet Phase V) have only the rights and privileges ofp%              the DFS$DEFAULT account._  C              ______________________________________________________        3.6 Reinstalling DECdfso  E           Although it is not usually necessary, you can reinstall thetC           DECdfs software on your system at any time. Note that yourD           must reinstall DECdfs if you change versions of OpenVMS orC           DECnet software. After you reinstall the DECdfs software, E           you need to reboot the system to use the DECdfs software ifI0           DECdfs drivers were previously loaded.  >           When you reinstall DECdfs software, the installation6           procedure copies new DFS$CONFIG.TEMPLATE andD           DFS$SYSTARTUP.TEMPLATE files to the SYS$MANAGER directory.6           These files contain default DECdfs settings.  &     3.7 Changing DECdfs Configurations  =           With DECdfs Version 2.4, there are now two types of ?           license: a full license called DFS, and a client-only ?           license called DFS-CLIENT. To change a DECdfs client-i@           only system to a server system may require loading andB           registering the full DFS license PAK, if that PAK is not           already loaded.   B           To change a DECdfs system from client-only to server (orA           server to client-only), edit the following lines in the +           SYS$STARTUP:DFS$STARTUP.COM file:w          #     3-8 Postinstallation Procedures  e  r      I                                               Postinstallation Procedures I                                        3.7 Changing DECdfs Configurations     2               $! Installation specific parameters:               $!*               $ START_CLIENT_FLAG = "TRUE"+               $ START_SERVER_FLAG = "FALSE"                $!               $!(               $! Title = DFS$STARTUP.COM  D               The START_CLIENT_FLAG = "TRUE" flag indicates that theH               DECdfs client software can be started on this system. WhenG               you convert from a client-only system to a server system,cE               you must change the value of the flag START_SERVER_FLAGPD               from "FALSE" to "TRUE." When you convert from a serverG               system to a client-only system, you must change the value C               of the flag START_SERVER_FLAG from "TRUE" to "FALSE."   F                 ________________________ Note ________________________  B                 The two flags, START_CLIENT_FLAG and START_SERVER_D                 FLAG, are the only two lines that you should edit in)                 the DFS$STARTUP.COM file.   F                 ______________________________________________________  =         3.8 Deleting Server Software from Client-Only Systemsb  H               The DECdfs installation procedure always copies all of theF               DECdfs software to your disk, whether you are installingD               server software or client-only software. If you do notD               want to install the server software, VMSINSTAL changesE               SYS$STARTUP:DFS$STARTUP.COM to prevent it from startingsI               the server. To free disk space, delete the following servera0               software from client-only systems:  A               o  DFS$SERVER_ACP.EXE (in the SYS$SYSTEM directory)s  F               o  DFSSDRIVER.EXE (in the SYS$LOADABLE_IMAGES directory)  H               You can also save these files so that a client-only systemA               can regain its server capability in the future. SeecE               Section 3.7 if you want to convert a client-only systemn!               to a server system._      I                                           Postinstallation Procedures 3-9o n  e           Postinstallation Procedures @     3.9 Checking OpenVMS Cluster Systems After Installing DECdfs    @     3.9 Checking OpenVMS Cluster Systems After Installing DECdfs  ?           If you are installing DECdfs on a system in a clustervC           that uses a system-specific system disk, you must install B           DECdfs on each system disk on the cluster before you can@           run DECdfs in the cluster. See Section 1.10.3 for more4           information about OpenVMS Cluster systems.  A           If you install DECdfs on an OpenVMS Cluster system thate?           uses a common system disk, you do not need to install_@           DECdfs on any other cluster members. However, you mustD           install the appropriate licenses before running the IVP or)           running DECdfs in your cluster.        3.10 Error Handlingt  @           When you encounter a problem while installing or using>           the DECdfs for OpenVMS, running the installation andC           verification procedure (IVP), or installing the DECdfs orpD           DECnet license Product Authorization Keys (PAKs), an errorE           message appears on the screen. Appendix A in the DECdfs for C           OpenVMS Management Guide lists the DECdfs error messages._  D           When you encounter problems while using the license PAK orB           the License Management Utility (LMF), see the HP OpenVMS?           License Management Utility Manual for a list of error E           messages. Determine which software issued the error message ?           by its standard format (%facility-l-ident, text). For)A           example, all DECdfs error messages begin with the %DFS-S           facility prefix.  D           For additional problem-solving information, see Appendix B5           in the DECdfs for OpenVMS Management Guide.l       3.11 Problem Reporting  E           If you encounter an error while using DECdfs and you cannoteA           determine the cause, or if you believe that an error is @           caused by a problem in the DECdfs software, report theC           problem to Hewlett-Packard Company according to the terms +           of your product support contract.m  C           You can report a problem if an operation gives unexpectedsB           results or when you get undocumented or unknown failures@           using DECdfs commands. Gather all information possible9           about a problem and submit it with your report.e  $     3-10 Postinstallation Procedures           I                                               Postinstallation ProcedurestI                                                    3.11 Problem Reporting_    F                 ________________________ Note ________________________  F                 Many problem reports do not contain enough informationB                 to duplicate or identify the problem. Complete andE                 concise information will help Hewlett-Packard provide_B                 accurate service and a timely response to software                 problems.   F                 ______________________________________________________  B               When you prepare to report a problem, please use the#               following guidelines:c  G               1. To ensure a timely response, describe one problem onlyh                   in each report.  D               2. Describe as accurately as possible the state of theF                  system (such as specifying whether the system failed)E                  and the situation when the problem occurred. In this D                  description, include the version numbers of OpenVMSH                  and DECdfs software for both the client and the server.G                  Indicate the version number for each client and server_D                  in a cluster. To determine these numbers, enter theE                  DFS$CONTROL command SHOW VERSION. If you cannot gainDG                  access to the DFS$CONTROL program, enter the followingCB                  command at the DCL prompt to determine the DECdfs,                  version number for clients:  C                  $ ANALYZE/IMAGE SYS$LOADABLE_IMAGES:DFSCDRIVER.EXED  D                  To determine the DECdfs version number for servers,-                  enter the following command:N  C                  $ ANALYZE/IMAGE SYS$LOADABLE_IMAGES:DFSSDRIVER.EXEf  G                  The version numbers appear in the Image IdentificationVI                  Information section, in the same line as the text "Imagef&                  File Identification."  F               3. Pinpoint or narrow down the problem, if possible. Use                  examples.  H               4. Make suggestions that can help to isolate your problem.  F               5. Remember to include listings of any command files and+                  other relevant data files.   I               6. If possible, provide a listing of the user programs that 8                  were running when the problem occurred.  I                                          Postinstallation Procedures 3-11                 Postinstallation Procedures*     3.11 Problem Reporting    D           7. Send the following files from the SYS$MANAGER directory              if possible:e                o  DFS$CONFIG.COM                o  DFS$ERROR.LOGo  !              o  DFS$SYSTARTUP.COMl  C           8. Include source files or data files on machine-readable B              media (floppy diskette or magnetic tape) if possible.B              All media will be returned to you when your report is              answered.  D           9. If you have questions, state them as simply as possibleB              and include all pertinent information so that a clear0              and correct answer can be provided.  >          10. If you report a severe error (the system hangs orA              fails), include a description of the events that ledeE              to the problem, any messages received at the console, or (              other specific information.  B          11. When a system fails, include a copy of the crash dump+              file (SYS$SYSTEM:SYSDUMP.DMP).g                                        $     3-12 Postinstallation Procedures                         I                                                                         AnI         _________________________________________________________________   I                                     Files Affected by DECdfs Installation$    E               This appendix lists the files produced or changed afterp5               installing DECdfs on an OpenVMS system.   I               ___________________________________________________________tI               SYS$SYSTEM_Files_________Function__________________________   8               DECDFSDEF.STB            Symbol table file  =               DFS$CONTROL.EXE          DECdfs control programr  H               DFS$COM_ACP.EXE          Ancillary control process for theB                                        DECdfs communication driver  F               DFS$SERVER_ACP.EXE       DECdfs server ancillary control.                                        process  B               DFS$COM_LOGGER.EXE       DECdfs maintenance file forI               _________________________logging_communication_transactions   I               ___________________________________________________________YI               SYS$HELP_Files___________Function__________________________D  ;               DECDFS023.RELEASE_NOTES  DECdfs release notesA  F               DFS$HELP.HLB             Help library for DECdfs control.                                        program  G               HELPLIB.HLB              DCL DECdfs help text is modified =                                        by DECdfs installationY  G               SYS$HELP:DFS.MSGHLP$DATA DECdfs Help Message database (on]I               _________________________OpenVMS_Version_6.2_and_later)____   I               ___________________________________________________________$I               SYS$LIBRARY_Files________Function__________________________D  ;               DFS$MOUNT_SHR.EXE        DECdfs mount libraryP  I               DFS$MNGT_SHR.EXE_________DECdfs_management_system_services_e  I                                 Files Affected by DECdfs Installation A-1e s  l      )     Files Affected by DECdfs Installatione    E           ___________________________________________________________i           SYS$LOADABLE_IMAGES E           Files____________________Function__________________________   >           DFSCDRIVER.EXE           DECdfs client device driver  >           DFSRRDRIVER.EXE          DECdfs communication driver  E           DFSSDRIVER.EXE___________DECdfs_server_driver______________s  E           ___________________________________________________________ E           SYS$STARTUP_Files________Function__________________________V  E           DFS$STARTUP.COM__________DECdfs_startup_command_file_______E  E           ___________________________________________________________ E           SYS$MANAGER_Files________Function__________________________   =           DFS$CONFIG.COM           DECdfs command file to setd;                                    configuration parametersi  D           DFS$CONFIG.TEMPLATE      DECdfs command file template withC                                    default configuration parametersA  E           DFS$SYSTARTUP.COM        DECdfs setup command file to mountN8                                    and add access points  E           DFS$SYSTARTUP.TEMPLATE   DECdfs setup command file templateoE           _________________________with_default_settings_____________S  E           ___________________________________________________________ E           SYS$MESSAGE_File_________Function__________________________T  E           DFS$MESSAGE.EXE__________DECdfs_error_message_file_________   E           ___________________________________________________________ E           SYS$TEST_File____________Function__________________________s  <           DFS$IVP.COM              Installation VerificationE           _________________________Procedure_command_file____________t            -     A-2 Files Affected by DECdfs Installationa D  f                    I                                                                         BYI         _________________________________________________________________n  I                                  Sample Installations for OpenVMS SystemsB    G               This appendix shows a sample installation of DECdfs V2.4.   F         B.1 Server Installation on OpenVMS I64 Version 8.2 with DECnet             Phase IV  H               The following sample dialogue shows a typical installationG               of DECdfs server software on OpenVMS I64 Version 8.2 withu               DECnet Phase IV.  %               $ @SYS$UPDATE:VMSINSTALa  K                       OpenVMS  Software Product Installation Procedure V8.21  )               It is 21-OCT-2004 at 09:17.c  =               Enter a question mark (?) at any time for help.n  L               * Are you satisfied with the backup of your system disk [YES]?W               * Where will the distribution volumes be mounted: SYS$SYSDEVICE:[DFSTEST]Y  X               Enter the products to be processed from the first distribution volume set.*               * Products: HP-VMS-DECDFS024B               * Enter installation options you wish to use (none):  7               The following products will be processed:   "                 HP-VMS-DECDFS V2.4  K                       Beginning installation of HP-VMS-DECDFS V2.4 at 09:17   D               %VMSINSTAL-I-RESTORE, Restoring product save set A ...Y               %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.eH               * Do you want to run the IVP after the installation [YES]?O               * Do you want to purge files replaced by this installation [YES]?o  K                Current configuration:    OpenVMS I64 V8.2 - DECnet Phase IVo  M               * Install the DFS files that support this configuration? [YES]?n4               * Install DFS Help Message file [YES]?  I                              Sample Installations for OpenVMS Systems B-1            ,     Sample Installations for OpenVMS SystemsK     B.1 Server Installation on OpenVMS I64 Version 8.2 with DECnet Phase IV     G               Add SYS$HELP:DFS.MSGHLP$DATA to the searchlist defined by_I               MSGHLP$LIBRARY in order to include the DFS messages in your E               HELP/MESSAGE search. Please refer to the OpenVMS SYSTEMr@               MANAGER'S MANUAL: ESSENTIALS for more information.  ]           * Do you want to install the HP-VMS-DECDFS V2.4 SERVER software on this node [YES]?e  #                   Product:      DFSt#                   Producer:     DEC #                   Version:      2.0n+                   Release Date: 20-JUN-1994a  R           * Does this product have an authorization key registered and loaded? YES  O                    Installation will be complete in approximately 1 - 5 minutess5                    depending upon your configuration.   O                    There are no more questions unless you chose to run the IVP. 3                    Installing DECdfs software . . .g  @           %VMSINSTAL-I-RESTORE, Restoring product save set C ...  N                   The following line should be added to your SYSTARTUP commandI                   file to automatically start DFS at system startup time: 9                            "@SYS$STARTUP:DFS$STARTUP.COM"s  M                   Put DFS$STARTUP after the statement that invokes the DECnet K                   start-up command file (STARTNET.COM). The DECnet softwareI=                   must be started before the DECdfs software.s  X           %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...!           % DECdfs starting up...e<           %DFS-I-STARTUP: DNS not present; will not be used.%           % DECdfs startup completed.   N               The Installation Verification Procedure will now be run.  PleaseR               review preceding messages and take note of post-installation actionsM               that may be required (such as editing the SYSTARTUP procedure).d  %           Begin the DECdfs IVP? [YES]           0     B-2 Sample Installations for OpenVMS Systems o  u      I                                  Sample Installations for OpenVMS SystemstI   B.1 Server Installation on OpenVMS I64 Version 8.2 with DECnet Phase IVd    Z                ***************************************************************************Z                ***                                                                     ***Z                ***                            DECdfs V2.4                              ***Z                ***                                                                     ***Z                ***                      Distributed  File  Service                     ***Z                ***                                                                     ***Z                ***                  Installation Verification Procedure                ***Z                ***                                                                     ***Z                ***************************************************************************Z                *                                                                         *Z                *  Copyright 1987 - 2004 Hewlett-Packard Development Company, L.P.       *Z                *                                                                         *Z                * Confidential computer software.  Valid license from HP and/or           *Z                * its subsidiaries required for possession, use, or copying.              *Z                *                                                                         *Z                * Consistent with FAR 12.211 and 12.212, Commercial Computer Software,    *Z                * Computer Software Documentation, and Technical Data for Commercial      *Z                * Items are licensed to the U.S. Government under vendor's standard       *Z                * commercial license.                                                     *Z                *                                                                         *Z                * Neither HP nor any of its subsidiaries shall be liable for technical    *Z                * or editorial errors or omissions contained herein.  The information     *Z                * in this document is provided "as is" without warranty of any kind and   *Z                * is subject to change without notice.  The warranties for HP products    *Z                * are set forth in the express limited warranty statements accompanying   *Z                * such products.  Nothing herein should be construed as constituting an   *Z                * additional warranty.                                                    *Z                *                                                                         *Z                ***************************************************************************  G                  This system will run as a DECdfs Server. To verify theCK                  installation, an Access Point must be ADDed on the Server.wQ                  This procedure creates an Access Point for its own use. You mustoP                  supply a name for this Access Point that does not already existV                  and is consistent with the DECdns naming policy used in your network.  I                  Be sure to specify a namespace prefix (e.g. NS:.APNAME).A:                * Enter an Access Point name [] ? DFS:.TEST  N               $ DFSCP ADD ACCESS_POINT DFS:.TEST SYS$SYSDEVICE:[000000] /LOCAL?               $ DFSCP MOUNT DFS:.TEST /NODE=XQPIA1 DFS$IVP_DISKr?               %MOUNT-I-MOUNTED, DFS:.TEST mounted on _DFSC1001:   -               Directory DFS$IVP_DISK:[000000]s  I                              Sample Installations for OpenVMS Systems B-3,    i      ,     Sample Installations for OpenVMS SystemsK     B.1 Server Installation on OpenVMS I64 Version 8.2 with DECnet Phase IV,    R           000000.DIR;1        ALPHA_TOOLS.DIR;1   BACKUP.SYS;1        BADBLK.SYS;1R           BADLOG.SYS;1        BITMAP.SYS;1        CONTIN.SYS;1        CORIMG.SYS;1R           DFSTEST.DIR;1       GPT.SYS;1           I64E82.BCK;1        I64E82.ZIP;1S           I64E82LP.BCK;1      I64E82LP.ZIP;1      I64XADH.BCK;2       I64XADH.BCK;1tR           I64XAFX.BCK;1       I64XAHS.BCK;1       I64XAJ4.BCK;1       INDEXF.SYS;1V           SECURITY.SYS;1      SYS0.DIR;1          TCPIP$TELNET.DIR;1  UNZIP_IA64.EXE;1@           VMS$COMMON.DIR;1    VOLSET.SYS;1        ZIP_IA64.EXE;1             Total of 27 files.,           % Directory access was successful.'           $ DFSCP DISMOUNT DFS$IVP_DISKhD           %DFS-S-DISMNT_SUCCESS, Dismount was successfully performed5           $ DFSCP REMOVE ACCESS_POINT DFS:.TEST/LOCAL   Z           ********************************************************************************>                                     DECdfs V2.4 IVP SuccessfulZ           ********************************************************************************  G                   Installation of HP-VMS-DECDFS V2.4 completed at 09:18   H               Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY  Y               Creating installation data file: VMI$ROOT:[SYSUPD]HP-VMS-DECDFS024.VMI_DATA   S           Enter the products to be processed from the next distribution volume set.            * Products: EXIT  3                   VMSINSTAL procedure done at 09:18p             $                               0     B-4 Sample Installations for OpenVMS Systems                                 F      _________________________________________________________________  F                                                                  Index      F      A______________________________   D______________________________  <      Access point,  1-10, 2-10, 2-12   DECdfs drivers,  2-169      Access point name,  2-12, 3-2     DECdfs license PAKk8      Access rights for using DECdns      See License PAK9         , 1-11                         DECdns,  1-9, 1-10$F      AUTOGEN command procedure           access rights for servers and9         (AUTOGEN), 1-5                      clients, 1-11y  <      B                                   client,  1-11, 2-10B      _______________________________     logical name table,  1-118      Backup of system disk,  2-4         namespace,  3-26                                          server,  1-10>      C______________________________   DECdns Distributed Name  1      Channel count,  1-7                  ServiceE  3      CHANNELCNT parameter,  1-7          See DECdnsuD      Client                            DECnet license PAK,  1-2, 1-9;        deleting server files, 3-9      DECnet network,  1-2n8        IVP, 2-10                       DECnet node,  3-2C        license PAK, 1-2                DECnet software,  2-2, 2-16, -      Client installation,  2-7            3-3NC      Command files                     DECnet startup command file,a-        DFS$CONFIG.COM, 3-4                3-3y<        DFS$STARTUP.COM, 3-4            DEFINE command,  1-11<        DFS$SYSTARTUP.COM, 3-4          Deleting files during<      Configuration,  3-4                  installation,  2-5E        client to server, 3-8           DFS$DEFAULT account,  3-6, 3-7 =        file, 3-4                       DFS$IVP.COM file,  3-1.A        planning, 1-9                   DFS$STARTUP.COM file,  3-3A7        server to client, 3-8           Disk space,  1-3M  ?                                        Distributed Name Service   3                                          See DECdnsa  F                                                                Index-1 h  e              <     Distribution kit,  1-1             Installation (cont'd)  B     DNS                                 rebooting before or after,/       See DECdns                           1-14.;     DNS$CHANGE_DEF_FILE.COM file,       time required,  1-8 ;        1-11, 2-16                       verification,  2-10C  @     DNS$DEFAULT_FILE.DAT file,         Installation Verification2        1-11, 2-16                        Procedure/     DNS$SYSTEM_TABLE logical name       See IVPSA        table, 1-11                     Interrupt stack size, 2-16$A     Driver file                        INTSTKPAGES parameter, 1-6uB       deletion messages,  2-15         IVP, 2-5, 2-10 to 2-13, 3-1;                                         access rights,  3-2e9     E______________________________     client-only,  3-2SA     Environment                         during installation,  2-5Y4       before installation,  2-2         server,  3-2  (       during installation,  2-3        LF     Error messages,  3-10              _______________________________B                                        License Management Facility/     F______________________________     See LMF   C     Files, installed or modified,      License PAK, 1-9, 1-13, 2-8, -        A-1                               2-16i:     Flags                               installation,  1-24       START_CLIENT_FLAG,  1-13          loaded,  2-87       START_SERVER_FLAG,  1-13          messages,  2-15 8                                         registered,  2-8/     G______________________________    LMF, 2-8e:     GBLPAGES parameter,  1-6            installation,  1-2>     GBLSECTIONS parameter,  1-6        Local startup file, 3-3  (     Global pages                       MF       increasing,  1-7                 _______________________________E     Global sections                    Maintenance updates, 1-1, 1-15S7       increasing,  1-7                 Media, 2-3, 2-13_/                                        MessagesF5     I______________________________     DECnet,  2-15 C     Installation                        driver file deletion,  2-15r:       aborting,  2-1                    error,  2-14, 3-10;       informational messages,  2-8,     installation,  2-13 C                                         interrupt stack size,  2-16 2          2-13                           IVP,  2-15:       invoking,  2-3                    license PAK,  2-154       mount kit,  2-4                   patch,  2-15:       on OpenVMS Cluster systems,       purge files,  2-136          1-12                           startup,  2-15@       over previous versions,  1-4      SYSGEN parameters,  2-15       Index-2g n                 G         Mount installation kit volume,    Requirements for installation 5           2-4                                (cont'd)d  9                                             hardware, 1-2p;         N______________________________     privileges, 1-8e  6         Nonpaged pool                       quota, 1-89          increasing size,  1-5              security, 3-6 9         NPAGEDYN parameter, 1-5             software, 1-2t  I         _______________________________   S______________________________o  8         Online release notes              Security,  3-60          See Release notes                Server5         OpenVMS Cluster systems, 1-12       IVP, 2-11r<          postinstallation,  3-10            license PAK, 1-2C          preinstallation,  1-12           Server installation,  2-7tB                                             example of OpenVMS I64E         P                                     Version 8.2 with DECneth<         _______________________________       Phase IV,  B-1A         PAK, 1-2                          Software version,  3-11oD         Prerequisites                     Startup command file,  3-4A          hardware,  1-2                   Startup messages,  2-15 A          software,  1-2                   SYSGEN parameters,  1-5 ;         Problems                            CHANNELCNT, 1-7 9          reporting,  3-10                   GBLPAGES, 1-6U<         Proxy account, OpenVMS, 3-6         GBLSECTIONS, 1-6<         Purging files during                INTSTKPAGES, 1-6:           installation,  2-5, 2-13          modifying, 1-5  9                                             NPAGEDYN, 1-5o<         R______________________________   SYSTARTUP.COM file8         Rebooting                           editing, 3-3?          an existing DECdfs system,       SYSTARTUP_V5.COM file>8             1-14                            editing, 3-3@         Reconfiguring DECdfs, 3-8         SYSTARTUP_VMS.COM file8         Reinstalling DECdfs software,       editing, 3-3@           3-8                             System interrupt stack@         Release notes, 1-2, 1-13, 1-15      increasing size, 1-6  @          copying to SYS$HELP,  2-4        System interrupt stack6          online,  2-3, 2-5                   parameter  E          options menu,  2-4                 See INTSTKPAGES parametera         Renaming files duringh           installation,  2-5          Reporting problems, 3-10%         Requirements for installationd          account,  1-8          disk space,  1-3h  I                                                                   Index-3o    t                #     T______________________________g       /TABLE qualifier,  1-11_  #     V_______________________________  "     VMSINSTAL procedure,  2-1, 2-2                                                                               Index-4u