Digital X.500 Directory                                      Synchronizer                                      Installing on a Digital UNIX                                      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_Digital_X.500_Directory_Synchronizer______          2.1    Overview..............................................2-1          2.2    Starting the Installation.............................2-1          2.3    After the Installation................................2-2          Appendix A  Sample Digital X.500 Directory Synchronizer          ____________Installation_Log____________________________________          Appendix B  Location of Digital X.500 Directory Synchronizer          ____________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 a Digital UNIX             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 Digital UNIX 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 root account and be familiar with the Digital             UNIX Installation procedure (setld).          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 a Digital UNIX system.             Synchronizer-500 must be installed on a system 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             XDSU V1.4-2 for Digital UNIX requires the following             prerequisite software:             o  Digital UNIX V3.2 or later             o  DECnet/OSI V3.2A or later             o  Digital X.500 Directory Service Version 2.0A 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 preparations must be performed before you             install Digital X.500 Directory Synchronizer:             1. The location of the installation kit is needed. This is                either a device name or a mount point.             2. Backup the system disk.             3. Ensure that there are 2 Mbytes of free disk space.          1-2  Preparing to Install Digital X.500 Directory Synchronizer           Chapter__2______________________________________________________          Installing Digital X.500 Directory Synchronizer             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             Use the command setld to install Synchronizer-500. Installing             Synchronizer-500 should take about 1-5 minutes depending on             CPU type and system workload.          2.2 Starting the Installation             Invoke setld as follows:             Log in with superuser privileges on the system where             Synchronizer-500 is to be installed. Make sure you are in             the root directory.             Type the following command to start the installation:                      # /usr/sbin/setld -l source             where source is either a mount point directory or the device-             specific file name of the installation kit. The installation             procedure displays a menu. Select the components that                      Installing Digital X.500 Directory Synchronizer  2-1              you want to install, and follow the instructions that the             procedure displays.          2.3 After the Installation             Release Notes - The release notes for Synchronizer-500             are moved to /usr/doc and to Synchronizer-500's examples             directory in the file xdsu014-2.release_notes. Please read             the release notes since they contain important information             about the utility.             Verifying the Installation  - To verify that all installed             files are in the correct locations and have the correct             protections, type:                      # /usr/sbin/setld -v DS5SYNCH142             The command displays messages telling you whether verifica-             tion has succeeded or failed.             Configuration of Synchronizer-500 - Synchronizer-500 must             be configured before it can be used. Please read 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, if any.          2-2  Installing Digital X.500 Directory Synchronizer           Appendix__A_____________________________________________________          Sample Digital X.500 Directory Synchronizer Installation Log               # su               Password:               # cd /               # tar x   # execute this if tar file on a tape               # ls DS5142.tar               DS5142.tar               # mkdir DS5142               # cd DS5142               # tar xf /DS5142.tar               # cd /               # /usr/sbin/setld -l DS5142               *** Enter subset selections ***               The following subsets are mandatory and will be installed automatically               unless you choose to exit without installing any subsets:                     * X.500 Directory Synchronizer               You may choose one of the following options:                    1) ALL of the above                    2) CANCEL selections and redisplay menus                    3) EXIT without installing any subsets               Enter your choices or press RETURN to redisplay menus.               Choices (for example, 1 2 4-6): 1               You are installing the following mandatory subsets:                       X.500 Directory Synchronizer               You are installing the following optional subsets:         Sample Digital X.500 Directory Synchronizer Installation Log  A-1                Is this correct? (y/n): y               X.500 Directory Synchronizer                  Copying from DS5142 (disk)                  Verifying               Configuring "X.500 Directory Synchronizer" (DS5SYNCH142)               #               # /usr/sbin/setld -v DS5SYNCH142               X.500 Directory Synchronizer (DS5SYNCH142)               #               # rm -R DS5142               # rm DS5142.tar          A-2  Sample Digital X.500 Directory Synchronizer Installation Log           Appendix__B_____________________________________________________          Location of Digital X.500 Directory Synchronizer Files             Upon successful installation of Synchronizer-500, the             Synchronizer-500 root directory will have been created             (/var/dxd/xdsu).             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                            /usr/sbin   Synchronizer-500                                                         image             xdsu012-1.release_notes         /usr/doc    Release Notes             xdsu013-2.release_notes         /usr/doc    Release Notes             xdsu014-2.release_notes         /usr/doc    Release Notes             do_archive                      XDSU root   script file to                                                         archive files             do_change                       XDSU root   CHANGES mode                                                         script file             do_change1                      XDSU root   alternate CHANGES                                                         mode script file               Location of Digital X.500 Directory Synchronizer Files  B-1              Table_B-1_(Cont.):__File_Locations___________________________             Files___________________________Location____Function_________             do_export                       XDSU root   EXPORT mode                                                         script file             do_export1                      XDSU root   EXPORT mode                                                         script file             do_import                       XDSU root   IMPORT mode                                                         script file             do_send_mail                    XDSU root   script file to                                                         send mail             do_trans                        XDSU root   TRANSACTION mode                                                         script file             do_xdsu                         XDSU root   script file to                                                         run XDSU             email.sc                        XDSU root   email auxiliary                                                         class schema file             xdsu_config.changes_template    XDSU root   Changes                                                         Configuration                                                         File template             xdsu_config.export_template     XDSU root   Export Config-                                                         uration File                                                         template             xdsu_config.import_template     XDSU root   Import Config-                                                         uration File                                                         template          B-2  Location of Digital X.500 Directory Synchronizer Files              Table_B-1_(Cont.):__File_Locations___________________________             Files___________________________Location____Function_________             xdsu_config.transaction_        XDSU root   Transaction             template                                    Configuration                                                         File template             xdsu_config_instance            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              examples    Sample DDS export                                                         RDF file for use                                                         with DSU             dsu_config.dat_export_dds       examples    Sample DDS export                                                         configurtion file                                                         for use with DSU             genexprt.rdf                    examples    generic Export                                                         RDF             genimprt.rdf                    examples    generic Import                                                         RDF               Location of Digital X.500 Directory Synchronizer Files  B-3              Table_B-1_(Cont.):__File_Locations___________________________             Files___________________________Location____Function_________             xdsu_changes_microsoft.com      examples    Sample Microsoft                                                         changes end-                                                         of-run command                                                         file             xdsu_changes_microsoft_add.rdf  examples    Sample Microsoft                                                         changes add RDF                                                         file             xdsu_changes_microsoft_         examples    Sample Microsoft             delete.rdf                                  changes delete                                                         RDF file             xdsu_config.dat_changes_        examples    Sample Microsoft             microsoft                                   changes                                                         configuration                                                         file             xdsu_config.dat_export_         examples    Sample Microsoft             microsoft                                   export configura-                                                         tion file             xdsu_config.dat_export_profs    examples    Sample PROFS                                                         export configura-                                                         tion file             xdsu_config.dat_export_smtp     examples    Sample SMTP ex-                                                         port configura-                                                         tion file          B-4  Location of Digital X.500 Directory Synchronizer Files              Table_B-1_(Cont.):__File_Locations___________________________             Files___________________________Location____Function_________             xdsu_config.dat_import_dds      examples    Sample DDS import                                                         configuration                                                         file             xdsu_config.dat_import_         examples    Sample Microsoft             microsoft                                   import configura-                                                         tion file             xdsu_config.dat_import_profs    examples    Sample PROFS                                                         import configura-                                                         tion file             xdsu_export_microsoft.com       examples    Sample Microsoft                                                         export end-of-run                                                         command file             xdsu_export_microsoft.rdf       examples    Sample Microsoft                                                         export RDF file             xdsu_export_profs.rdf           examples    Sample PROFS                                                         export RDF file             xdsu_export_smtp.com            examples    Sample SMTP                                                         export end-of-run                                                         command file             xdsu_export_smtp.rdf            examples    Sample SMTP                                                         export RDF file             xdsu_import_dds.rdf             examples    Sample DDS import                                                         RDF file               Location of Digital X.500 Directory Synchronizer Files  B-5              Table_B-1_(Cont.):__File_Locations___________________________             Files___________________________Location____Function_________             xdsu_import_microsoft.com       examples    Sample Microsoft                                                         import end-of-run                                                         command file             xdsu_import_microsoft.rdf       examples    Sample Microsoft                                                         import RDF file             xdsu_import_microsoft.txt       examples    Sample Microsoft                                                         import data file             xdsu_import_profs.com           examples    Sample PROFS                                                         import end-of-run                                                         command file             xdsu_import_profs.rdf           examples    Sample PROFS                                                         import RDF file             xdsu_import_profs.txt           examples    Sample PROFS                                                         import data file             xdsu014-2.release_notes         examples    XDSU Release             ____________________________________________Notes____________          B-6  Location of Digital X.500 Directory Synchronizer Files