 








              OpenVMS Enterprise Directory

              Installing

              Revision/Update Information:  Version 5.3

              This kit also contains HP Administrator for Enterprise
              Directory for V2.1.

              Checklist:

              1. Read the Read Before Installing document

              2. Check prerequisite software and diskspace

              3. Install Version 5.3 of the Directory

                 Print the release notes and run the IVP during the
                 installation

              4. Edit SYSTARTUP_VMS.COM to submit the directory startup
                 procedure during system startup

              5. If upgrading or reinstalling, recustomize any
                 customized files, specifically:

                 The schema files (recompile the schema if you customize
                 it)
                 DXD$DSA_STARTUP.NCL
                 DXD$TEMPLATE_STARTUP.NCL
                 DXD$DSA_STARTUP.COM
                 DXD$DSA_SHUTDOWN.NCL

                 Other files that might have been customized in a
                 previous version are saved during installation. See
                 Saving Files on Reinstallation.

              6. Start the Directory

 






     Prerequisite Software

           Before you install the OpenVMS Enterprise Directory make
           sure you have the following installed and working on your
           system:

           o  OpenVMS for Alpha V7.3, or later.

           o  Optionally:

              1. For X.500 protocols over an OSI network, DECnet-
                 Plus V7.3 for OpenVMS Alpha or later. Additionally
                 the OSI Applications Kernel (OSAK) needs to be
                 installed, instructions for which are in the DECnet-
                 Plus for OpenVMS Applications Installation and
                 Advanced Configuration manual. If you have installed
                 DECnet-Plus then you must also install OSAK.

              2. For LDAP or other X.500 protocols that use RFC1006
                 connections, HP TCP/IP Services for OpenVMS V5.1 or
                 later.

              3. For LDAPv3 over SSL you also require HP SSL Version
                 1.1 for OpenVMS or later.

     Information Required

           Before installing, make sure you have the following
           information:

           o  The name of the device where the installation media
              will be loaded.

           o  The UIC to be assigned to the DXD$SERVER account.

           o  The name of the disk where the DXD$SERVER directory is
              to be created.

           o  For clusters, the server node name. See Installing on
              Clusters.

           If this is an upgrade installation, the installation
           procedure will find the information from the current
           system.

     2

 






        Disk Space, Resource, and Time Requirements

              You need 40000 free blocks on the system device or
              Alternate Working Device that you use for the installa-
              tion. If you are installing either the HP AED Windows kit
              or the HP AED Utility, you need an additional 130000 free
              blocks on this disk. After installation, the components
              require disk space permanently on both the system disk and
              the disk where the DXD$SERVER directory is to be created.
              Some components need global pages and sections. These
              requirements are cumulative.

              __________________________________________________________
                                    System     DXD$SERVER
                                    Disk       Disk       Global     Global
              Component_____________space______space______Pages______Sections

              Base (mandatory       8000       1000       3200       8
              component)

              Server                18000      -          -          -

              Admin[1]              7000       -          3200       4

              API                   1000       -          -          -

              LUC                   5000       -          -          -

              HP AED[2] Windows     -          70000      -          -
              kit

              HP AED Utility        -          60000      -          -

              [1]_______________________________________________________

              This is not the HP Administrator for Enterprise Directory;
              it is the Admin component.

              [2]
              This is the HP Administrator for Enterprise Directory; it
              is the Windows GUI for managing the Directory.

              __________________________________________________________

              Before installing, ensure that the system resources allow
              for all of the components you install, remembering that
              the Base component is mandatory.

              You are recommended to back up your system disk before
              you begin the installation. Installation of all components
              takes approximately 15 minutes.

                                                                       3

 






     Release Notes and Read Before Installing Document

           Read the release notes before installing the software. Use
           VMSINSTAL OPTIONS N to print the release notes.

           The product documentation includes a Read Before
           Installing document, which you must also read.

     Installing the OpenVMS Enterprise Directory

           Log in to an account with SETPRV and type:

           $ @SYS$UPDATE:VMSINSTAL DXDA053 device OPTIONS N

           The installation procedure displays a menu. Select the
           components that you want to install, and follow the
           instructions.

           The Base component is mandatory on all systems on which
           you want to run directory applications. It is installed
           automatically when you select any other component.

           Note that components you do not specify are deinstalled if
           present. You must specify all components that you want on
           the system, including any that are already present.

     HP Administrator for Enterprise Directory

           If you want to use HP Administrator for Enterprise
           Directory+ for management of your directory, you should
           first install the components "hp Administrator for
           Enterprise Directory-Windows" and "hp Administrator for
           Enterprise Directory-Utility". When the installation is
           complete, set DXD$DIRECTORY to be your default directory,
           and copy the file [.CAED_WIN32]DIRECTORYADMINISTRATOR.EXE
           to your PC. This file is an executable program that when
           run on a PC will install HP Administrator for Enterprise
           Directory.

           You can also check for a later version of the pro-
           gram that can be downloaded directly onto a PC from
           http://www.openvms.compaq.com/commercial/edir/edir_mgt_
           gui_download.html .

           ___________________
           +   See the file ReadMe.txt in the HP Administrator for

               Enterprise Directory kit for details.

     4

 






        Handling Errors

              If an error occurs during installation, check the
              prerequisites, and refer to OpenVMS Enterprise Directory -
              Problem Solving for details of installation problems.

        Verifying the Installation

              To verify the installation, run SYS$TEST:DXD$IVP.COM.

        Tasks After Installation

              Edit SYS$STARTUP:SYSTARTUP_VMS.COM to include the
              following command line:

              $ SUBMIT SYS$STARTUP:DXD$COMMON_STARTUP.COM

              You also need to run that Directory Service startup file
              before configuring the product as described in OpenVMS
              Enterprise Directory - Management.

              If you are reinstalling or upgrading, then you might
              have old copies of customized schema files. You need to
              incorporate your customizations into the newly installed
              schema files, and recompile the schema before starting the
              DSA. The Read Before Installing document provides further
              information about upgrading.

        Saving Files on Reinstallation

              The installation procedure saves copies of the following
              files if you reinstall the Directory.

                 SYS$COMMON:[SYS$STARTUP]DXD$DSA_STARTUP.NCL
                 SYS$COMMON:[SYS$STARTUP]DXD$DSA_STARTUP.COM
                 SYS$COMMON:[SYS$STARTUP]DXD$DSA_SHUTDOWN.NCL
                 SYS$COMMON:[SYS$STARTUP]DXD$TEMPLATE_STARTUP.NCL
                 DXD$DIRECTORY:DXD$ACI_TEMPLATE.DXIM

              Each file is renamed by inserting _SAVn into the file
              name, where n is a number.

              If the installation procedure finds schema files, these
              are moved to a subdirectory called SAVn, for example,
              DXD$DIRECTORY:[DXD$SERVER.SAV1]. The procedure only moves
              schema files that were installed by the Directory product.
              Any schema files created by the customer are unaffected.

                                                                       5

 






     Installing on Clusters

           Only one node in a cluster can run the server. The
           installation prompts you for the server node name, and
           edits DXD$LOGICALS_STARTUP.COM to define a logical based
           on your answer.

           On a cluster that has multiple system disks (including
           mixed architecture clusters), you must repeat the
           installation for each system disk. All system disks must
           run V5.3 of the Directory Service. You must install the
           same components and specify the same server node during
           each installation.

           The installation registers the DXIM command. To make the
           command available to all cluster nodes, use the following
           command on each node:

           $ INSTALL SYS$SHARE:DCLTABLES /REPLACE

           If you prefer, you can use the SYSMAN utility for this
           task.

     No AutoAnswer Support in Installation

           AutoAnswer files can only be used on installations that
           follow the pattern of previous installations. AutoAnswer
           files created during a first-time installation (that
           is, installation on a system that had no Directory
           previously), are not available during an upgrade.
           AutoAnswer files created during an upgrade will be
           available at the time of the next upgrade and any
           subsequent upgrade.

     Further Information

           OpenVMS Enterprise Directory - Problem Solving contains
           a list of the files installed on your system, their
           locations and approximate sizes. The guide also lists
           errors that you might see during installation and
           verification and explains what to do if they occur.

      Copyright 2001-2003 Hewlett-Packard
     Development Company, LP

     6
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         