
DynaText 4.1 Browser Standalone Edition (English) for UNIX 
Installation Instructions

September 30, 1998



Inso Corporation
Providence, Rhode Island 02908-5720

==========================================================

Copyright (c) 1998 Inso Corporation. All Rights Reserved. DynaText, 
DynaTag, DynaWeb, DynaBase, InStEd, Inso, and the Inso logo are either 
trademarks or registered trademarks of Inso Corporation in the United 
States and/or other countries. All other company and product names are 
trademarks or registered trademarks of their respective owners.

=====================================================
CONTENTS

1   Introduction
2   Setting up and Running The Installation Program
2.1   Architecture-Specific Files and Directories
2.2   Setting Up Your DynaText Root Directory
2.3   Installing from the CD Distribution
2.4   Installing From The FTP Distribution
3   Information Requested by The Installation Program
4   Setting Up Your .ebtrc File

=====================================================
1   Introduction

    This file contains information you need to install DynaText 4.1 
    Browser Standalone Edition (English) for UNIX.

    Important:  For the system requirements and additional information 
    about this release, see the DynaText 4.1 "Release Notes" (relnotes.txt\.htm).

=====================================================
2   Setting up and Running the Installation Program

-----------------------------------------------------
2.1   Architecture-Specific Files and Directories

    For each supported UNIX architecture (see "Release Notes"), this
    release includes architecture-specific distribution files and 
    binary and library directories.  Each of these possess 
    an architecture-specific name; for example: 

    o  b<architecture>.Z 
    o  <architecture>/

    Where <architecture> is one of the following:

    o  For Sun Solaris 2.5.1/2.6  ---   sunos5s
    o  For SGI IRIX 6.2 ---   irix6m
    o  For HP 10.2      ---   hpuxpa

    For example:  bsunos5s.Z
             sunos5s/

------------------------------------------------------------
2.2   Setting Up Your DynaText Root Directory

    In these installation notes, the directory in which you install 
    your DynaText 4.1 software is called your DynaText root directory.

    TIP: To permit any user to point to your DynaText 4.1 
    installation, place your DynaText root in a directory that is
    reachable from any machine on your network.

    To create your DynaText Root Directory (<DynaTextRoot>):

    1. Log in as root.

    2. Create <DynaTextRoot>; for example:  mkdir /usr/dtext41

       In this example, the <DynaTextRoot> is /usr/dtext41.

------------------------------------------------------------

2.3   Installing from the CD Distribution

      1. While logged in as root, insert the DynaText 4.1 UNIX CD in 
         your CD-ROM drive.

      2. Change to the CD-ROM source directory (...cdrom/unix/browser);
       for example:      cd /cdrom/unix/browser

       The top level of the installation directory structure includes
       the following:

       o Information about this release: install.txt (this document) ,
         relnotes.txt and relnotes.htm

       o The installation program:  install.dt

       o Text files used by the installation program: 

         copyrght.txt, files.txt, version.txt, and sum.txt

       o Compressed files containing the DynaText directories installed by
         the installation program:  bin.z, data.z, b<architecture>.z,
          ebtdocs.z, ebtrc.z, l<architecture>.z, qe.z

       The <architecture> identifiers are listed in Section 2.1.

    
    3. Run the installation program using the following command:
     
               ./install.dt -u <DynaTextRoot>

       where <DynaTextRoot> indicates the full path of your DynaText 
       root directory.
     
       For example:  ./install.dt -u /usr/dtext41
     
       This example installs DynaText into the directory /usr/dtext41.

    
    For information about the installation program, see Section 3. 

------------------------------------------------------------
2.4   Installing From The FTP Distribution

    1. While logged in as root, change to your <DynaTextRoot> directory;
       for example:  cd /usr/dtext41

    2. Download all the files.

    3. Run the installation program using the following command:

           chmod +x ./install.dt
           ./install.dt

       TIP: Consider making a backup copy of the distribution. This is
       recommended because after completing an installation, the install
       program normally removes itself and the distribution files.

       Command-Line Options:

       o  To install the software into the DynaText root from another
          directory, use the -u option to specify the DynaText root:

              ./install.dt -u <DynaTextRoot>

          This installs DynaText in the specified <DynaTextRoot> directory; 
          for example:  install.dt -u /usr/dtext41

       o  To disable deletion of the .Z files use the -n option:

              ./install.dt -n

       For information about the installation program, see Section 3.

============================================================
3   Information Requested by The Installation Program

    After displaying introductory information, the installation program
    prompts you for preferences, showing the default responses within
    brackets.

    Briefly, the requested information includes:

    o  A name for the installation log file (default: install.log)

    o  Whether to install the binaries and libraries for each 
       architecture (default: y). 

    o  Do you wish to install the Query Enhancement feature?
       You may select the Stemming and Thesaurus options.

    o  Do you wish to install the Stemming related Query Enhancement for 	 
   		English ?
	   	French  ?
   		Italian ?
	   	German  ?
   		Spanish ?
         Japanese?
    
     o  Do you wish to install the Thesaurus related Query Enhancement for
	   	English ?
   		French  ?
   		Italian ?
	   	German  ?
   		Spanish ?
		
      For each architecture, DynaText requires binary and library
      directories that reside together in an architecture-specific 
      directory (whose name is the appropriate <architecture> identifier 
      among those documented in Section 2.1:

       -  <architecture>/bin/ contains binary executables, including the 
           Browser executable (dtext).

       -  <architecture>/lib/ contains library files.
     
       IMPORTANT:  Inso strongly recommends that you retain the
       installation names and locations for the platform-specific
       binary and library directories. Changing these default names
       causes the Inso-supplied configuration scripts to fail.

    o  Names for the common directories of DynaText 4.1.  Inso 
       strongly recommends that you use the default names.
    	
       CAUTION: Changing these default names will cause Inso-supplied
       configuration scripts to fail.

       Default Names of Common Directories:

       bin/    		[Scripts that set LD_LIBRARY_PATH] 

       data/   		[Data directories used by DynaText]

       ebtdocs/ 		[DynaText 4.1 documentation collections
                 		 for the Browser Standalone Edition (English)]

       ebtrc/  		[Default .ebtrc file]

       include/ 		[Header files] 

       tmp/    		[Working directory for the installation program] 

   o  Enter the number from the above list which represents the 
   defaults display type for your site [default: 1] 
   		[1] cde
	   	[2] aix
   		[3] aixcde
   		[4] color
   		[5] mono
   		[6] gray
                [7] openwin

   o Do you want to delete the assembly files? [default: n]
     Note: If you say "y" or "Y" to this question, script will remove the 
        assembly files.

============================================================
4   Setting Up Your .ebtrc File

    A default .ebtrc file is installed at <DynaTextRoot>/ebtrc/.ebtrc.
    The installation program updates this with the path of your 
    site-specific DynaText root directory.  To add other site-specific
    information, such as collections, edit this default file or a copy
    of it. 

    To set up an .ebtrc file for your account either:

    o  Set your EBTRC environment variable to point to the default .ebtrc file:

           setenv EBTRC <DynaTextRoot>/ebtrc/.ebtrc

       This approach enables dynamic management of a central .ebtrc file.

	Or

    o  Copy <DynaTextRoot>/ebtrc/.ebtrc to your home directory.

       This approach enables personal customization of a private .ebtrc.

============================================================
[End of DynaText 4.1 Browser Standalone Edition (English) install.txt]

