Centralized Software Distribution Manager/2 (CSDM/2)
====================================================

This README file contains a general overview of the CSDM/2 structure and
describes the procedure to enable CSDM/2 on an existing CID Code Server.

For information in how to build a CID Code Server from diskettes, please
refer to IBM Network Transport Service/2 Redirected Installation and
Configuration Guide (S96F-8488).

For information in how to install a CID Code Server from CD-ROM that
comes with IBM Netdoor/2, please refer to the CSDM/2 Administrator's Guide.

The CID Code Server is assumed to contain the following directory
structure:

   CID Directory Structure
   -----------------------

   Drive x:  (x = remote drive or CD-ROM drive)
      ³
      ÃÄÄ CID
      ³    ³
      ³    ÃÄ CSDM2             * CSDM/2 directory
      ³    ³   ³ À ...
      ³    ³
      ³    ÃÄ DLL               * Dynamic link libraries required by CID
      ³    ³   À ...
      ³    ³
      ³    ÃÄ EXE               * Executable programs required by CID
      ³    ³   À ...
      ³    ³
      ³    ÃÄ IMG               * Product images
      ³    ³   ³
      ³    ³   ÃÄ OS2V2x        *  OS/2 version 2.x
      ³    ³   ³   À ...
      ³    ³   ³
      ³    ³   ÃÄ IBMLSA        *  Lan Services 3.0
      ³    ³   ³   À ...
      ³    ³   ³
      ³    ³   ÃÄ CM2V101       *  Communication Manager/2 1.01
      ³    ³   ³   À ...
      ³    ³   ³
      ³    ³   ÃÄ TCPIP20       *  TCP/IP 2.0
      ³    ³   ³   À ...
      ³    ³   ³
      ³    ³   ÃÄ NTS2          *  LAN Adapter and Protocol Support (LAPS)
      ³    ³   ³   À ...
      ³    ³   ³
      ³    ³   ÃÄ LCU           *  LAN CID Utility (LCU)
      ³    ³   ³   À ...
      ³    ³   ³
      ³    ³   ÀÄ NETDOOR       * IBM NetDoor/2
      ³    ³       À ...
      ³    ³
      ³    ³
      ³    ÃÄ RSP               * Response files
      ³    ³   ³
      ³    ³   ÃÄ OS2V2x        * OS/2 version 2.x
      ³    ³   ³   À ...
      ³    ³   ³
      ³    ³   ÃÄ IBMLSA        * Lan Services 3.0
      ³    ³   ³   À ...
      ³    ³   ³
      ³    ³   ÃÄ CM2V101       * Communication Manager 1.01
      ³    ³   ³   À ...
      ³    ³   ³
      ³    ³   ÃÄ TCPIP20       *  TCP/IP 2.0
      ³    ³   ³   À ...
      ³    ³   ³
      ³    ³   ÃÄ NTS2          * LAN Adapter and Protocol Support
      ³    ³   ³   À ...
      ³    ³   ³
      ³    ³   ÃÄ LCU           * LAN CID Utility
      ³    ³   ³   À ...
      ³    ³   ³
      ³    ³   ÃÄ NETDOOR       * IBM NetDoor/2
                   À ...


To enable CSDM/2, an additional directory structure is added to the
CID Code Server.  The recommended CSDM/2 directory structure is listed
below.  The profiles that are included in the CSDM/2 diskettes are
built based on this structure.


  CSDM/2 directory
  ----------------
    ÃÄ CSDM2   * CSDM/2 program directory
    ³   ³ À CASBASE.FIL     CASPREP.CMD     CDDEL.EXE
    ³   ³   CDINST.EXE      CLEANUP.EXE     CSDM2.EXE
    ³   ³   CSDM2ADM.EXE    CSDM2ADM.HLP    CSDM2LCU.PRO
    ³   ³   CSDM2SRV.EXE    CSDM2SRV.HLP    CSDM2SRV.PRO
    ³   ³   CSDMAGNT.EXE    DISK.LAB        FDISK.COM
    ³   ³   FORMAT.COM      LABEL.COM       LOADDSKF.EXE
    ³   ³   MAKEDSKS.EXE    MAKEDSKS.HLP    MAKEDSKS.PRO
    ³   ³   MOVERSP.EXE     SAVEDSKF.EXE
    ³   ³
    ³   ÃÄ SRVIFS       * CSDM/2 Resource Directory for SRVIFS Transport
    ³   ³   ÃÄ CLIENT        * Client installation
    ³   ³   ³     À  CSDM2.PRO    GENERAL.FIL  VARS.FIL      CSDM2.HLP
    ³   ³   ³        NETBIOS.RSP  IEEE802.RSP  IBMTOK16.RSP  IBMTRBM.RSP ....
    ³   ³   ÀÄ SERVER        * Server installation
    ³   ³        À  ... ...
    ³   ÃÄ NFS          * CSDM/2 Resource Directory for NFS Transport
    ³   ³   ÃÄ CLIENT        * Client installation
    ³   ³   ³     À  CSDM2.PRO   GENERAL.FIL   VARS.FIL      CSDM2.HLP
    ³   ³   ³        TCPIP.RSP   IBMTOK16.RSP  IBMTRBM.RSP   .......
    ³   ³   ÀÄ SERVER        * Server installation
    ³   ³        À  ... ...
    ³   ³
    ³   ÃÄ THINTCP      * A thin TCP/IP to support TCP/IP Transport
    ³   ³    À NFSRFI.CMD     PKUNZIP2.EXE      PKZIP2.EXE
    ³   ³      RESOLV         THINTCP.EXE       THINTCP.ZIP
    ³   ³      TCPMOUNT.EXE   TCPDEL.EXE        WAIT.EXE
    ³   ³
    ³   ÃÄ DSKIMGS      * Disk images for the Make Disk Utility Program
    ³   ³    À DISK0.DSK      DISK1.DSK
    ³   ³
    ³   ÃÄ DRIVERS      * Contains all the supported SCSI and CD-ROM drivers.
    ³   ³    À AHA152X.ADD     AHA154X.ADD     AHA164X.ADD     AHA174X.ADD
    ³   ³      DPT20XX.ADD     FD16-700.ADD    FD7000EX.ADD    FD8XX.ADD
    ³   ³      HITCDS1.FLT     IBM2SCSI.ADD    NECCDS1.FLT     OS2SCSI.DMD 
    ³   ³      SONYCDS1.FLT    TOSHCDS1.FLT
    ³   ³
    ³   ÃÄ CDFILES      * Contains files to support CD-ROM installation.
    ³   ³    À CDFS.IFS        CDINST.PRO      DEV002.MSG      OS2CDROM.DMD
    ³   ³      OS2DASD.DMD     RUNCDROM.EXE    SRVREXX.EXE     UCDFS.MSG
    ³   ³      REXXINIT.DLL


CSDM/2 supports both the SRVIFS and NFS transports.  Installation can
also be done directly from CD-ROM.  The CID Code Server can support
installations via SRVIFS and NFS transports at the same time.

CSDM/2 Program Directory
------------------------
  This directory contains all the executable programs and data files
  required by CSDM/2.

  The following files are shipped with CSDM/2:
    CDDEL.EXE     - [CDROM]   Removes CD-ROM support after the installation.
    CDINST.EXE    - [CDROM]   Installs CD-ROM support on the client workstation.
    CLEANUP.EXE   - [ALL]     Clean up files and directories after the installation.
    CSDM2.EXE     - [ALL]     Main program
    CSDM2ADM.EXE  - [ALL]     A menu to allow the administrator to select different
                              CSDM/2 functions.
    CSDM2ADM.HLP  -           Help file for the CSDM2ADM program.
    CSDM2LCU.PRO  -           Master Control profile to allow the administrator
                              to define default CSDM2 parameters.
    CSDM2SRV.EXE  -           Build CID Code Server from CD-ROM
    CSDM2SRV.HLP  -           Help file for the CSDM2SRV program.
    CSDM2SRV.PRO  -           Profile to customize CSDM2SRV.
    CSDMAGNT.EXE  - [ALL]     Installs LAN CID Utility on the client workstation
                              during the first phase of the installation.
    DISK.LAB      -           Uses by CSDM/2 to support the format function.
    LOADDSKF.EXE  -           Utility uses by MAKEDSKS program to down load
                              diskette image.
    MAKEDSKS.EXE  -           Build installation diskettes
    MAKEDSKS.HLP  -           Help file for the MAKEDSKS program.
    MAKEDSKS.PRO  -           Profile to customize MAKEDSKS utility.
    MOVERSP.EXE   - [ALL]     Utility to relocate files from diskette to fixed disk
                              during the first phase of  the installation.
    SAVEDSKF.EXE  -           Utility to build the base diskette images

  CSDM/2 also requires the following files either in CSDM/2 Program
  Directory or in a directory defined in the PATH environment:
    The following files can be obtained from the OS/2 Operating System:
      FDISK.COM    -      Fixed disk partition program uses by CSDM/2.
      FORMAT.COM   -      Disk format program uses by CSDM/2.
      LABEL.COM    -      Disk Labeling program uses by CSDM/2.
    The following files can be obtained from NTS/2
      CASBASE.FIL  -      Basic input file uses by CASPREP utility.
      CASPREP.CMD  -      Utility uses by CSDM/2 to generate the REXX LCU
                          command file.
  CASBASE.FIL and CASPREP.CMD must be resided in the same directory.

CSDM/2 Resource Directory
-------------------------
   The resource directory contains a collection of data files needed to
   customize for a particular type of installation.   The local administrators
   can modify the files in the resource directories or build their own
   resource directories.
   A resource directory is consisted of the following data files:
    CSDM2.PRO   -       Profile to customize CSDM/2 dialog screens
    GENERAL.FIL -       Product definition file uses by CASPREP utility.
    VARS.FIL    -       Variable definition file uses by CASPREP utility.
    CSDM2.HLP   -       Help file for the CSDM2 program.
    NETBIOS.RSP -       LAPS response file for NetBios.
    IEEE802.RSP -       LAPS response file for IEEE 802.2.
    TCPIP.RSP   -       LAPS response file for TCP/IP.
    <adapter>.rsp -     LAPS response file for LAN adapter.


THINTCP Directory
-----------------
  Contains program files to support NFS transport.  This directory can
  be removed if NFS transport is not supported.

    CRENVVAR.EXE -           Prompt user input and create environment variables
    NFSRFI.CMD   -           Batch file to prepare a TCP/IP environment.
    PKUNZIP2.EXE -           Files unpack utility uses by the THINTCP program.
    PKZIP2.EXE   -           Utility to pack files into a ZIP file.
    RESOLV       -           RESOLV file uses by the THINTCP program.
    THINTCP.EXE  - [TCPIP]   Installs a minimum TCP/IP system onto the diskette
                             or fixed disk.
    TCPMOUNT.EXE - [TCPIP]   Utility to add MOUNT statement to NFSRFI.CMD
    TCPDEL.EXE   - [TCPIP]   Remove minimum TCP/IP system at the end of the
                             installation.
    WAIT.EXE     - [TCPIP]   Timer delay program used by NFSRFI.CMD
 THINTCP.ZIP contains files required to setup the minimum TCP/IP system.
 The ZIP file is not included in the CSDM/2 diskette.  You need to build
 the ZIP file from an existing workstation that has the same version of
 TCP/IP installed.  CRENVVAR.EXE is shipped with CSDM/2.  All other files
 are part of the TCP/IP product.  Use the PKZIP2 program to build the ZIP
 file.

 THINTCP.ZIP contains the following files:
     ARP.EXE        CNTRL.EXE        CRENVVAR.EXE
     IFCONFIG.EXE   MOUNT.EXE        NFS200.IFS
     NFSBIOD.EXE    NFSCTL.EXE       ROUTE.EXE
     RPCDLL.DLL     TCPIPDLL.DLL     WAIT.EXE
     NFSWAIT.EXE


DSKIMGS Directory
-----------------
  Contains the base diskette images use by the MAKEDSKS program.
    DISK0.DSK   -    OS/2 2.x  boot diskette    (for 3.5" drive)
    DISK1.DSK   -    OS/2 2.x  base diskette 1  (for 3.5" drive)
  The base diskette images are not included in the CSDM/2 diskette.
  You need to the create the diskette images from the CID Code Server
  that contains the version of OS/2 image that you are supporting


DRIVERS Directory
-----------------
  Contains the SCSI and CD-ROM drivers to support installation via
  CD-ROM.  The drivers are not included in the CSDM/2 diskette.
  You need to obtain the drivers from the CID Code Server that
  contains the version of OS/2 image that you are supporting.
  The administrator may include additional drivers in this
  directory.

  For OS/2 version 2.1.
    - The SCSI drivers are packed in a file called SCSIADDS in Disk 3.
      Use the UNPACK program that ship with OS/2 2.1 to unpack the
      drivers.
    - The CD-ROM drivers are packaged in a file called CDROMFLT in Disk
      10.  Use the UNPACK program that ship with OS/2 2.1 to unpack the
      drivers.
    - All other files can be obtained from Disk 1.


CDFILES Directory
-----------------
  Contains the essential files required to install CD-ROM support
  on a diskette.
    RUNCDROM.EXE - [CDROM]   Find the CD-ROM drive and setup the
                             PATH, DPATH environment.
    CDINST.PRO   -           Profile to tell the CDINST program
                             which files to copy and the information to
                             update in CONFIG.SYS.
  In addition, the following files are required but are not shipped
  with CSDM/2:
     CDFS.IFS       DEV002.MSG     OS2CDROM.DMD
     UCDFS.MSG      UCDFS.DLL
  For OS/2 Version 2.1, the files are packed in a file called CDROMREQ
  in Disk 10.  Use the UNPACK program that ship with OS/2 2.1 to unpack
  the files.
  Note:  The files listed above are for OS/2 2.1 only.  The files
         required by OS/2 2.0 are different.

  You also need the following files to support Rexx:
     SRVREXX.EXE     REXXINIT.DLL
  The files can be obtained from NTS/2 Utility diskette.


Installing CSDM/2
=================
 ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
 ³ Note: The INSTALL program is not yet available.  Please perform   ³
 ³       the installation steps manually.                            ³
 ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
 The INSTALL program helps you to install Centralized Software Distribution
 Manager/2 (CSDM/2) on an existing CID Code Server.   The program will install
 CSDM/2 with a default set of profiles.  You may customize the profiles after
 CSDM/2 is installed.
  INSTALL for CSDM/2 will:
    - Install the CSDM/2 directory onto the CID Code Server
    - Copy required executables from the OS/2 images
    - Copy required DLLs from the OS/2 images
    - Build THINTCP.ZIP and store it in \CSDM2\THINTCP directory
    - Copy SCSI drivers and CD-ROM drivers to \CSDM2\DRIVERS directory
    - Copy CD-ROM support files from the OS/2 images to \CSDM2\CDFILES directory
    - Copy REXX support files from NTS/2 directory to \CSDM2\CDFILES directory
    - Build the two base diskette images and store them in \CSDM2\DISKIMGS
      directory.

  Step 1:  Create the CSDM/2 directory structure
     - Insert the CSDM/2 diskette into drive A:
     - XCOPY A:\*.* D:\CID\CSDM2\*.* /S /E
     Note: D:\CID is the root directory of the CID Code Server.
  Step 2:  Obtain OS/2 executables
     - COPY D:\CID\IMG\OS2V21\DISK_1\FDISK.COM D:\CID\CSDM2
     - COPY D:\CID\IMG\OS2V21\DISK_2\LABEL.COM D:\CID\CSDM2
     - D:\CID\IMG\OS2V21\DISK_2\UNPACK D:\CID\IMG\OS2V21\DISK_15\LABEL
       D:\CID\CSDM2 /N:LABEL.COM
     Note: The executables can also be placed in a directory that
           is defined in the PATH environment (i.e D:\CID\EXE).
  Step 3:  Obtain DLLs
     - COPY D:\CID\IMG\OS2V21\DISK_1\NAMEPIPES.DLL D:\CID\DLL
     - D:\CID\IMG\OS2V21\DISK_2\UNPACK D:\CID\IMG\OS2V21\DISK_3\BUNDLE
       D:\CID\DLL /N:PMGPI.DLL
     - D:\CID\IMG\OS2V21\DISK_2\UNPACK D:\CID\IMG\OS2V21\DISK_3\BUNDLE
       D:\CID\DLL /N:PMGRE.DLL
     - D:\CID\IMG\OS2V21\DISK_2\UNPACK D:\CID\IMG\OS2V21\DISK_3\BUNDLE
       D:\CID\DLL /N:PMSHAPI.DLL
     - D:\CID\IMG\OS2V21\DISK_2\UNPACK D:\CID\IMG\OS2V21\DISK_0\BUNDLE
       D:\CID\DLL /N:PMSHLTKT.DLL
     - D:\CID\IMG\OS2V21\DISK_2\UNPACK D:\CID\IMG\OS2V21\DISK_0\BUNDLE
       D:\CID\DLL /N:PMSPL.DLL
     - D:\CID\IMG\OS2V21\DISK_2\UNPACK D:\CID\IMG\OS2V21\DISK_4\BUNDLE
       D:\CID\DLL /N:PMWIN.DLL
     - D:\CID\IMG\OS2V21\DISK_2\UNPACK D:\CID\IMG\OS2V21\DISK_5\BUNDLE
       D:\CID\DLL /N:SPL1B.DLL
  Step 4:  Build THINTCP.ZIP
     - MD D:\CID\CSDM2\THINTCP\TEMP
     - COPY D:\CID\CSDM2\THINTCP\WAIT.EXE D:\CID\CSDM2\THINTCP\TEMP
     - COPY D:\CID\CSDM2\THINTCP\CRENVVAR.EXE D:\CID\CSDM2\THINTCP\TEMP
     - D:\CID\IMG\TCPIP20\PKUNZIP2 -d D:\CID\IMG\TCPIP20\BASE3.ZIP
       D:\CID\CSDM2\THINTCP\TEMP RPCDLL.DLL
     - D:\CID\IMG\TCPIP20\PKUNZIP2 -d D:\CID\IMG\TCPIP20\BASE4.ZIP
       D:\CID\CSDM2\THINTCP\TEMP ARP.EXE
     - D:\CID\IMG\TCPIP20\PKUNZIP2 -d D:\CID\IMG\TCPIP20\BASE4.ZIP
       D:\CID\CSDM2\THINTCP\TEMP CNTRL.EXE
     - D:\CID\IMG\TCPIP20\PKUNZIP2 -d D:\CID\IMG\TCPIP20\BASE4.ZIP
       D:\CID\CSDM2\THINTCP\TEMP IFCONFIG.EXE
     - D:\CID\IMG\TCPIP20\PKUNZIP2 -d D:\CID\IMG\TCPIP20\BASE4.ZIP
       D:\CID\CSDM2\THINTCP\TEMP ROUTE.EXE
     - D:\CID\IMG\TCPIP20\PKUNZIP2 -d D:\CID\IMG\TCPIP20\BASE4.ZIP
       D:\CID\CSDM2\THINTCP\TEMP TCPIPDLL.DLL
     - D:\CID\IMG\TCPIP20\PKUNZIP2 -d D:\CID\IMG\TCPIP20\NFS1.ZIP
       D:\CID\CSDM2\THINTCP\TEMP MOUNT.EXE
     - D:\CID\IMG\TCPIP20\PKUNZIP2 -d D:\CID\IMG\TCPIP20\NFS1.ZIP
       D:\CID\CSDM2\THINTCP\TEMP NFS200.IFS
     - D:\CID\IMG\TCPIP20\PKUNZIP2 -d D:\CID\IMG\TCPIP20\NFS1.ZIP
       D:\CID\CSDM2\THINTCP\TEMP NFSBIOD.EXE
     - D:\CID\IMG\TCPIP20\PKUNZIP2 -d D:\CID\IMG\TCPIP20\NFS1.ZIP
       D:\CID\CSDM2\THINTCP\TEMP NFSCTL.EXE
     - D:\CID\IMG\TCPIP20\PKUNZIP2 -d D:\CID\IMG\TCPIP20\NFS1.ZIP
       D:\CID\CSDM2\THINTCP\TEMP NFSWAIT.EXE
     - COPY D:\CID\CSDM2\THINTCP\TEMP\DLL\*.* D:\CID\CSDM2\THINTCP\TEMP
     - ERASE D:\CID\CSDM2\THINTCP\TEMP\DLL\*.*
     - RMDIR D:\CID\CSDM2\THINTCP\TEMP\DLL
     - COPY D:\CID\CSDM2\THINTCP\TEMP\BIN\*.* D:\CID\CSDM2\THINTCP\TEMP
     - ERASE D:\CID\CSDM2\THINTCP\TEMP\BIN\*.*
     - RMDIR D:\CID\CSDM2\THINTCP\TEMP\BIN
     - D:\CID\CSDM2\THINTCP\PKZIP2 *.* D:\CID\CSDM2\THINTCP\THINTCP.ZIP
     - ERASE D:\CID\CSDM2\THINTCP\TEMP\*.*
     - RMDIR D:\CID\CSDM2\THINTCP\TEMP
  Step 5:  Obtain SCSI and CD-ROM drivers
     - MD D:\CID\CSDM2\DRIVERS
     - D:\CID\IMG\OS2V21\DISK_2\UNPACK D:\CID\IMG\OS2V21\DISK_3\SCSIADDS
       D:\CID\CSDM2\DRIVERS
     - D:\CID\IMG\OS2V21\DISK_2\UNPACK D:\CID\IMG\OS2V21\DISK_10\CDROMFLT
       D:\CID\CSDM2\DRIVERS
     - COPY D:\CID\IMG\OS2V21\DISK_1\OS2SCSI.DMD D:\CID\CSDM2\DRIVERS
     - COPY D:\CID\IMG\OS2V21\DISK_1\IBM2SCSI.ADD D:\CID\CSDM2\DRIVERS
  Step 6: Obtain CD-ROM support files
     - D:\CID\IMG\OS2V21\DISK_2\UNPACK D:\CID\IMG\OS2V21\DISK_10\CDROMREQ
       D:\CID\CSDM2\CDFILES
  Step 7: Obtain REXX support files
     - COPY D:\CID\IMG\LCU\REXXINIT.DLL D:\CID\CSDM2\CDFILES
     - COPY D:\CID\IMG\LCU\SRVREXX.EXE D:\CID\CSDM2\CDFILES
  Step 8: Build base diskette images
     - Insert a formatted diskette into drive A:
     - D:\CID\EXE\SEDISK /S:D:\CID\IMG\OS2V21 /T:A:
     - When prompt, remove the diskette from drive A: and
       label it DISK 0.
     - Insert another formatted diskette into drive A: and
       press ENTER
     - When completed, remove the diskette from drive A: and
       label it DISK 1.
     - Insert DISK 0 into drive A:
     - MD D:\CID\CSDM2\DISKIMGS
     - D:\CID\CSDM2\SAVEDSKF A: D:\CID\CSDM2\DISKIMGS\DISK0.DSK
     - When completed, remove the diskette from drive A: and
       insert DISK 1 into drive A:
     - D:\CID\CSDM2\SAVEDSKF A: D:\CID\CSDM2\DISKIMGS\DISK1.DSK
