Digital X.500 Directory                                      Synchronizer                                      Installing on an OpenVMS System                 Software Version:  V1.4-2                 Date:  January 1998                 Digital Equipment Corporation                 Maynard, Massachusetts              -------------------------             The information in this document is subject to change             without notice and should not be construed as a commitment by             Digital Equipment Corporation. Digital Equipment Corporation             assumes no responsibility for any errors that appear in this             document.             The software described in this document is furnished under             a license and may be used or copied only in accordance with             terms of such license.             No responsibility is assumed for the use or reliability             of equipment that is not supplied by Digital Equipment             Corporation or its affiliated companies.             Restricted Rights: Use, duplication, or disclosure by the             U.S. Government is subject to restrictions as set forth in             subparagraph (c)(1)(ii) of the Rights in Technical Data and             Computer Software clause at DFARS 252.227-7013."             -------------------------             Copyright ©1998 by Digital Equipment Corporation.             All rights reserved.             Printed in U.S.A.             -------------------------          Trademarks             The following are trademarks of Digital Equipment Corpora-             tion: AXP, DEC, DECnet, Digital, OpenVMS, VAX, VMS and the             DIGITAL logo.             The following are trademarks of other companies: OSI is             a registered trademark of CA Management, Inc. UNIX is a             registered trademark in the United States and other contries             licensed exclusively through X/Open Company Ltd.          ii           Contents________________________________________________________          Preface________________________________________________________v          Chapter 1  Preparing to Install Digital X.500 Directory          ___________Synchronizer_________________________________________          1.1    Introduction..........................................1-1          1.2    Preparation Checklist.................................1-1          1.3    Prerequisite Software.................................1-2          1.4    Preparing the System for Installation.................1-2          Chapter_2__Installing_Synchronizer-500__________________________          2.1    Overview..............................................2-1          2.2    Starting the Installation.............................2-1          2.3    After the Installation................................2-6          Appendix_A__Sample_Synchronizer-500_Installation_Log____________          Appendix_B__Location_of_Synchronizer-500_Files__________________                                         iii           Tables__________________________________________________________                 B-1    File Locations.................................B-1                                         iv           Preface_________________________________________________________          Purpose of this Guide             This guide describes how to install Digital X.500 Directory             Synchronizer (Synchronizer-500 or XDSU) on an OpenVMS VAX or             OpenVMS Alpha operating system. You should review the entire             guide before starting the installation.             After Synchronizer-500 has been installed, it must be             configured before it can be used. Please see the Digital             X.500 Directory Synchronizer Configuration and Management             Guide for further information.          Intended Audience             This guide is primarily intended for the OpenVMS system             manager or others responsible for installing system software.             To install Synchronizer-500, you must be familiar with the             Digital X.500 Directory Service product. You must also have             access to the SYSTEM account and be familiar with the OpenVMS             Installation procedure (VMSINSTAL.COM).          Structure of this Guide             This guide has two chapters.             o  Chapter 1 lists pre-installation activities.             o  Chapter 2 explains how to install Synchronizer-500.                                          v           Chapter__1______________________________________________________          Preparing to Install Digital X.500 Directory Synchronizer          1.1 Introduction             This chapter describes the procedures necessary to prepare             for the installation of Digital X.500 Directory Synchronizer             (Synchronizer-500) on an OpenVMS system.             Synchronizer-500 must be installed on a node where the             Digital X.500 Directory Service is installed and where a             Directory System Agent (DSA) has been configured. Please see             the Digital X.500 Directory Service Installing on an OpenVMS             System and the Digital X.500 Directory Service Management             guides for more information.          1.2 Preparation Checklist             Prepare for the installation as follows:             1. Ensure that your system has the prerequisite software. See                Section 1.3.             2. Ensure that the Product Authorization Key (PAK) for XDSU                is registered and loaded.             3. Prepare the system for installation. See Section 1.4.            Preparing to Install Digital X.500 Directory Synchronizer  1-1           1.3 Prerequisite Software             A Synchronizer-500 kit is available on either OpenVMS VAX or             OpenVMS Alpha.             Synchronizer-500 for OpenVMS VAX requires the following             prerequisite software:             o  OpenVMS VAX V5.5-2 or later             o  DECnet/OSI V5.6A or later             o  Digital X.500 Directory Service V2.0 or later             Synchronizer-500 for OpenVMS Alpha requires the following             prerequisite software:             o  OpenVMS Alpha V6.1 or later             o  DECnet/OSI V6.0 or later             o  Digital X.500 Directory Service V2.0 or later             The Digital X.500 Directory Service product must be installed             prior to the installation of Synchronizer-500.             Synchronizer-500 checks for the existence of the XDSU Product             Authorization Key (PAK) during installation. Please ensure             that it is loaded prior to running the installation. The             version must be XDSU V1.4 or later.          1.4 Preparing the System for Installation             The following procedure must be performed prior to invoking             VMSINSTAL:             1. Log into the SYSTEM account.             2. Backup the System disk.             3. Ensure that there are 2000 blocks available on the system                disk.          1-2  Preparing to Install Digital X.500 Directory Synchronizer           Chapter__2______________________________________________________          Installing Synchronizer-500             This chapter explains how to install Synchronizer-500. The             preparations described in Chapter 1 must be made before             installing Synchronizer-500. At the end of the installation,             follow the instructions in the Digital X.500 Directory             Synchronizer Configuration and Management Guide to enable             Synchronizer-500 for use.          2.1 Overview             VMSINSTAL is used to install Synchronizer-500. VMSINSTAL is             a DCL command procedure that can be used to install optional             software products on the OpenVMS operating system. VMSINSTAL             invokes a command procedure on the distribution media which             controls the remainder of the installation.             Installing Synchronizer-500 should take about 1-5 minutes             depending on CPU type and system workload.          2.2 Starting the Installation             1. Invoke VMSINSTAL as follows:                Log into the System account on the node where                Synchronizer-500 is to be installed. Type the following                command to start the installation:                         @SYS$UPDATE:VMSINSTAL                                          Installing Synchronizer-500  2-1              2. Two questions appear about active processes and the backup                of the system disk. The first question is:                         *Do you want to continue anyway [NO]?                Processes on the system will not affect this installation.                Type YES, to continue the installation.                The second question is:                         *Are you satisfied with the backup of your system                         disk [YES]?                If you are satisfied with the backup of your system disk,                type YES, or press RETURN, to continue the installation.             3. VMSINSTAL needs to know where the distribution media is                located. The following question is displayed:                         * Where will the distribution volumes be mounted:                Type the name of the device (and directory if necessary)                where the distribution media is to be mounted.             4. VMSINSTAL needs to know what the product saveset name is.                The following question is displayed:                         Enter the products to be processed from the first                         distribution volume set. *Products:                Type the product identifier for this software product:                DS5_VAX014-002 if installing on OpenVMS VAX, DS5_ALPHA014-                002 if installing on OpenVMS Alpha.             5. * Enter installation options you wish to choose (none):                No options are needed. Simply enter a carriage return.          2-2  Installing Synchronizer-500              6. Before VMSINSTAL can begin installation, it asks you to                mount the first volume of the distribution medium.                For example:                         Please mount the first volume of the set on MUA0:                (Where MUA0: is the device you specified.)                VMSINSTAL then prompts:                         * Are you ready?                Type YES, and press RETURN when you have mounted the                volume. VMSINSTAL tries to mount the distribution media.                If it succeeds, a message displays, for example:                         %MOUNT-I-MOUNTED, DS5 mounted on _MUA0:                         The following products will be processed:                         DS5_VAX014- V0.2                         Beginning installation of DS5_VAX014- V0.2 at                         hh:mm                         %VMSINSTAL-I-RESTORE, Restoring product saveset                         A...                                          Installing Synchronizer-500  2-3                          %VMSINSTAL-I-RELMOVED, Product's release notes                         have been moved to SYS$HELP                         Installing Digital X.500 Directory Synchronizer                         V1.4-2             7. * Directory name for XDSU root [ disk:[DXD$SERVER.XDSU$ROOT]                ]:                This question determines the device and directory where                Synchronizer-500 is installed. By default, Synchronizer                will install its root directory ([.XDSU$ROOT]) in                the Digital X.500 Directory Service root directory                (DXD$DIRECTORY). If you do not wish to have Synchronizer-                500 installed in this location, enter the device and                directory where you would like Synchronizer-500 installed.                                             Note                     If the DXD$DIRECTORY logical is currently not                     defined (Digital X.500 Directory Service is not                     running), the default given for this question                     will be SYS$SYSDEVICE:[XDSU$ROOT].             8. * Do you want to purge files replaced by this installation                [YES]?                Answer YES.             9. * Do you want to run the IVP after the installation [YES]?                Answer YES if you want to run the Installation Verifica-                tion Procedure (IVP).          2-4  Installing Synchronizer-500              10.All questions have been asked, the installation will now                proceed. It should take approximately 1-5 minutes.                                          Installing Synchronizer-500  2-5           2.3 After the Installation             Release Notes - The release notes for Synchronizer-500 are             moved to SYS$HELP and Synchronizer-500's root directory in             the file XDSU014-2.RELEASE_NOTES. Please read the release             notes since they contain important information about the             utility.             Installation Verification Procedure - Synchronizer-500's             Installation Verification Procedure (IVP) XDSU$IVP.COM, is             moved the the directory SYS$TEST. The IVP can be executed at             any time. To run the IVP, type:                      @SYS$TEST:XDSU$IVP.COM             Configuration of Synchronizer-500 - Synchronizer-500 must             be configured before it can be used. Please see the Digital             X.500 Directory Synchronizer Configuration and Management             Guide for further information.             Upgrade Considerations - If this is an upgrade of a previous             Synchronizer-500 version, three files - EMAIL.SC, XDSU_             LAYOUT.DAT, and XDSU_LAYOUT_MTS.DAT - are not overwritten.             The latest release version of these files are stored as             EMAIL_SC.NEW, XDSU_LAYOUT_DAT.NEW, and XDSU_LAYOUT_MTS_             DAT.NEW in the XDSU root directory. These files should be             examined to see if any changes should be made to the old             versions of these files. See the release notes for details on             what changes were made to these files.          2-6  Installing Synchronizer-500           Appendix__A_____________________________________________________          Sample Synchronizer-500 Installation Log               $ set def sys$update               $ @vmsinstal                       VAX/VMS Software Product Installation Procedure V5.5-2               Enter a question mark (?) at any time for help.               * Are you satisfied with the backup of your system disk [YES]?               * Where will the distribution volumes be mounted: SYS$KITS:[XDSU]               Enter the products to be processed from the first distribution volume set.               * Products: DS5_VAX014-002               * Enter installation options you wish to use (none):               The following products will be processed:                 DS5_VAX014- V0.2                Beginning installation of DS5_VAX014- V0.2 at 11:15               %VMSINSTAL-I-RESTORE, Restoring product save set A ...               %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.                Installing Digital X.500 Directory Synchronization Utility V1.4-2               * Directory name for XDSU root [DXD$DEVICE:[DXD$SERVER.XDSU$ROOT]]:               * Do you want to purge files replaced by this installation [YES]?               * Do you want to run the IVP after the installation [YES]?                   All questions have been asked, the installation will now proceed.                   It should take approximately 1-5 minutes.               %VMSINSTAL-I-SYSDIR, This product creates system disk directory DXD$DEVICE:[DXD$               SERVER.XDSU$ROOT]                             Sample Synchronizer-500 Installation Log  A-1                    The following files will be added to the system disk as a result of                   this installation:                     sys$system:xdsu$main.exe                     sys$test:xdsu$ivp.com                  The following files will be put in DXD$DEVICE:[DXD$SERVER.XDSU$ROOT]:                     email.sc                     xdsu_config.changes_template                     xdsu_config.export_template                     xdsu_config.import_template                     xdsu_config.transaction_template                     xdsu_config_instance.com                     xdsu_layout.dat                     xdsu_layout_mts.dat                  The following example files will be put in DXD$DEVICE:[DXD$SERVER.XDSU$ROOT]:                     dsu_config.dat_export_dds                     dsu_export_dds.rdf                     genexprt.rdf                     genimprt.rdf                     xdsu_changes_microsoft.com                     xdsu_changes_microsoft_add.rdf                     xdsu_changes_microsoft_delete.rdf                     xdsu_config.dat_changes_microsoft                     xdsu_config.dat_export_microsoft                     xdsu_config.dat_export_profs                     xdsu_config.dat_export_smtp                     xdsu_config.dat_import_dds                     xdsu_config.dat_import_microsoft                     xdsu_config.dat_import_profs                     xdsu_export_microsoft.com                     xdsu_export_microsoft.rdf                     xdsu_export_profs.rdf                     xdsu_export_smtp.com                     xdsu_export_smtp.rdf                     xdsu_import_dds.rdf                     xdsu_import_microsoft.com          A-2  Sample Synchronizer-500 Installation Log                      xdsu_import_microsoft.rdf                     xdsu_import_microsoft.txt                     xdsu_import_profs.com                     xdsu_import_profs.rdf                     xdsu_import_profs.txt                     xdsu012-1.release_notes                     xdsu013-2.release_notes                     xdsu014-2.release_notes               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...               The Installation Verification Procedure is now being run...                                                This is the                                  X.500 Directory Synchronization Utility                                    Installation Verification Procedure                                            The IVP is starting.                                            The IVP has successfully completed.                       Installation of DS5_VAX014- V0.2 completed at 11:19               Enter the products to be processed from the next distribution volume set.               * Products:  ^Z                       VMSINSTAL procedure done at 11:19               $                             Sample Synchronizer-500 Installation Log  A-3           Appendix__B_____________________________________________________          Location of Synchronizer-500 Files             Upon successful installation of Synchronizer-500, the             Synchronizer-500 root directory will have been created.             The location of the Synchronizer-500 root directory is             determined at installation time. By default, unless overriden             at installation time, is DXD$DEVICE:[DXD$SERVER.XDSU$ROOT].             This directory is referred to as the XDSU root directory.             The table below lists the files used by Synchronizer-500 and             their location.             Table_B-1:__File_Locations___________________________________             Files___________________________Location____Function_________             XDSU$MAIN.EXE                   SYS$SYSTEM  Synchronizer-500                                                         image             XDSU$IVP.COM                    SYS$TEST    Synchronizer-                                                         500 Installation                                                         Verification                                                         Procedure             XDSU014-2.RELEASE_NOTES         SYS$HELP    Release Notes             EMAIL.SC                        XDSU root   email auxiliary                                                         class schema file             XDSU_CONFIG.CHANGES_TEMPLATE    XDSU root   Changes                                                         Configuration                                                         File template                                   Location of Synchronizer-500 Files  B-1              Table_B-1_(Cont.):__File_Locations___________________________             Files___________________________Location____Function_________             XDSU_CONFIG.EXPORT_TEMPLATE     XDSU root   Export Config-                                                         uration File                                                         template             XDSU_CONFIG.IMPORT_TEMPLATE     XDSU root   Import Config-                                                         uration File                                                         template             XDSU_CONFIG.TRANSACTION_        XDSU root   Transaction             TEMPLATE                                    Configuration                                                         File template             XDSU_CONFIG_INSTANCE.COM        XDSU root   Create instance                                                         subdirectory                                                         procedure             XDSU_LAYOUT.DAT                 XDSU root   Synchronizer-500                                                         X.500 layout file             XDSU_LAYOUT_MTS.DAT             XDSU root   Example                                                         Synchronizer-                                                         500 layout file                                                         for using MTS                                                         distribution                                                         lists             DSU_EXPORT_DDS.RDF              XDSU root   Sample DDS export                                                         RDF file for use                                                         with DSU          B-2  Location of Synchronizer-500 Files              Table_B-1_(Cont.):__File_Locations___________________________             Files___________________________Location____Function_________             DSU_CONFIG.DAT_EXPORT_DDS       XDSU root   Sample DDS export                                                         configurtion file                                                         for use with DSU             GENEXPRT.RDF                    XDSU root   generic Export                                                         RDF             GENIMPRT.RDF                    XDSU root   generic Import                                                         RDF             XDSU_CHANGES_MICROSOFT.COM      XDSU root   Sample Microsoft                                                         changes end-                                                         of-run command                                                         file             XDSU_CHANGES_MICROSOFT_ADD.RDF  XDSU root   Sample Microsoft                                                         changes add RDF                                                         file             XDSU_CHANGES_MICROSOFT_         XDSU root   Sample Microsoft             DELETE.RDF                                  changes delete                                                         RDF file             XDSU_CONFIG.DAT_CHANGES_        XDSU root   Sample Microsoft             MICROSOFT                                   changes                                                         configuration                                                         file             XDSU_CONFIG.DAT_EXPORT_         XDSU root   Sample Microsoft             MICROSOFT                                   export configura-                                                         tion file                                   Location of Synchronizer-500 Files  B-3              Table_B-1_(Cont.):__File_Locations___________________________             Files___________________________Location____Function_________             XDSU_CONFIG.DAT_EXPORT_PROFS    XDSU root   Sample PROFS                                                         export configura-                                                         tion file             XDSU_CONFIG.DAT_EXPORT_SMTP     XDSU root   Sample SMTP ex-                                                         port configura-                                                         tion file             XDSU_CONFIG.DAT_IMPORT_DDS      XDSU root   Sample DDS import                                                         configuration                                                         file             XDSU_CONFIG.DAT_IMPORT_         XDSU root   Sample Microsoft             MICROSOFT                                   import configura-                                                         tion file             XDSU_CONFIG.DAT_IMPORT_PROFS    XDSU root   Sample PROFS                                                         import configura-                                                         tion file             XDSU_EXPORT_MICROSOFT.COM       XDSU root   Sample Microsoft                                                         export end-of-run                                                         command file             XDSU_EXPORT_MICROSOFT.RDF       XDSU root   Sample Microsoft                                                         export RDF file             XDSU_EXPORT_PROFS.RDF           XDSU root   Sample PROFS                                                         export RDF file          B-4  Location of Synchronizer-500 Files              Table_B-1_(Cont.):__File_Locations___________________________             Files___________________________Location____Function_________             XDSU_EXPORT_SMTP.COM            XDSU root   Sample SMTP                                                         export end-of-run                                                         command file             XDSU_EXPORT_SMTP.RDF            XDSU root   Sample SMTP                                                         export RDF file             XDSU_IMPORT_DDS.RDF             XDSU root   Sample DDS import                                                         RDF file             XDSU_IMPORT_MICROSOFT.COM       XDSU root   Sample Microsoft                                                         import end-of-run                                                         command file             XDSU_IMPORT_MICROSOFT.RDF       XDSU root   Sample Microsoft                                                         import RDF file             XDSU_IMPORT_MICROSOFT.TXT       XDSU root   Sample Microsoft                                                         import data file             XDSU_IMPORT_PROFS.COM           XDSU root   Sample PROFS                                                         import end-of-run                                                         command file             XDSU_IMPORT_PROFS.RDF           XDSU root   Sample PROFS                                                         import RDF file             XDSU_IMPORT_PROFS.TXT           XDSU root   Sample PROFS                                                         import data file             XDSU014-2.RELEASE_NOTES         XDSU root   XDSU Release             ____________________________________________Notes____________                                   Location of Synchronizer-500 Files  B-5