                README.install: UNIX MATLAB Installation Companion
                --------------------------------------------------

0. Table of Contents
   -----------------

   1. Things you should know
   2. Version
   3. Licensing terminology
   4. How is MATLAB distributed
   5. Updating
   6. Encryption of toolboxes 
   7. Boot installation versus later installations
   8. Interactive versus batch
   9. Running the installation script
  10. Getting the hostid before installation
  11. Creating a license file before installation
  12. Checking your TMW_Archive feature line before installation
  13. (ftp install) Generating the list of files to download
  14. Sample installation walkthrough - custom media
  15. Sample installation walkthrough - collective media
  16. Sample installation walkthrough - ftp
  17. Installing additional toolboxes
  18. Installing as non-root user
  19. Minimal installation

1. Things you should know
   ----------------------

   "$MATLAB" means the path of the MATLAB root directory in the discussion
   below.

2. Version
   -------

   For MATLAB 4.2c and later.

3. Licensing Terminology
   ---------------------
                          
   Before you start the installation program, it would be helpful to know
   the type of license you have purchased for MATLAB.  Here is a description
   of the terminology which will appear in the installation process:
        
   Node-locked license
   -------------------

        A limited number of MATLAB sessions (or keys) which will run
        on the CPU of the designated MATLAB server.  This type of
        license requires that you run the license manager.

   Multiuser node-locked license
   -----------------------------

        Unlimited number of keys for MATLAB which will run on the CPU
        of the designated MATLAB server. This type of license does not
        require that you run the license manager, although you do need
        to set up the license.dat file properly.
        
   Floating license
   ----------------

        A limited number of MATLAB sessions in which other networked
        machines can access and run MATLAB locally.  This type of
        license requires that you run the license manager.
                          
   Demo license
   ------------

        A temporary floating license with unlimited keys. This type of
        license does not require that you run the license manager,
        although you do need to set up the license.dat file properly.
        
   You need to decide which system will be the MATLAB server and which
   system will be the license server. The MATLAB server has the local
   disk where the MATLAB files are stored. The license server is the
   system where the license manager runs. The license files should be
   on a local disk attached to the license server, but this is not an
   absolute requirement. Commonly, the MATLAB server and the license
   server are the same. If you need to separate them do a complete
   installation using the MATLAB server and then copy the $MATLAB/etc
   subdirectory intact to the license server.

4. How is MATLAB distributed
   -------------------------

   There are four ways in which MATLAB is distributed:

   . custom media      - Just the products you are licensed for on
                         magnetic media.
   . collective media  - All products for a set of platforms on magnetic
                         tape.
   . CD-ROM            - All products for all platforms. The official
                         installation guide, distributed in PostScript
                         form as install.ps.Z, describes this installation
                         in more detail.
   . FTP               - All products for all platforms.

5. Updating
   --------

   MATLAB is packaged in pieces mainly by products so that updating
   can be done easier. The update area is $MATLAB/update.

   After a successful installation you may inspect the file
   $MATLAB/update/pe2ver for update information.

   For example, after installing MATLAB, SIMULINK, Signal Toolbox,
   Real-Time Workshop (includes Simulink C Code Generator), and Symbolic
   Toolbox from magnetic media you might see in pe2ver (excluding the
   column definitions):

Piece#  Piece Name              Base Version    Revision Version
-----------------------------------------------------------------------------
0.0.0   install                         4.2     4.2u2.0.1
0.2.2   info/technote                   4.2a    :
1.0     matlab                          4.2     4.2c
1.1     matlab/sun4                     4.2     4.2c
2.0.0   lm                              4.2     4.2u2
2.0.0.1 lm/scripts                      4.2     4.2u2
2.0.1   lm/sun4                         2.4c    :
2.1.0   gs                              2.5.2   :
2.1.1   gs/sun4                         2.5.2   :
3.0     toolbox/matlab                  4.2     4.2a
3.0.1   toolbox/matlab/doc              4.2a    4.2a.u2
3.0.2   toolbox/matlab/andrew           4.0     :
3.1     toolbox/matlab/sun4             4.2     4.2a
4.0     toolbox/simulink                1.3     1.3c
4.1     toolbox/simulink/sun4           1.3     1.3c
10.0    toolbox/signal                  3.0b    :
10.1    toolbox/signal/sun4             3.0b    :
15.0    toolbox/codegen                 1.1     1.1b
15.1    toolbox/codegen/sun4            1.1     1.1b
16.0    toolbox/symbolic                1.0a    :
16.0.2  toolbox/symbolic/lib            5.2     :
16.1    toolbox/symbolic/sun4           1.0a    :
-----------------------------------------------------------------------------

6. Encryption of toolboxes
   -----------------------

   All toolboxes except on 'custom media' come encrypted. An extra FLEXlm
   FEATURE line called TMW_Archive is generated automatically with each
   passcode file you receive from The Mathworks. Visually, this line looks
   like:

  FEATURE TMW_Archive  MLM 4 01-apr-1996   0 0123456789ABCDEFGHIJ "e083" DEMO

   The vendor string "e083" is an encoding of the toolboxes you are allowed
   to decrypt. Running the command:

       install_matlab -f

   will analyze your TMW_Archive line in your license file,
   $MATLAB/etc/license.dat, and tell you whether it it valid and which
   toolboxes you are allowed to decrypt.

   There can be multiple TMW_Archive lines in the file.
                          
7. Boot installation versus later installations
   --------------------------------------------

   When you install for the first time the installation script needs among
   other things to uncompress and detar various files to be able to do the
   complete installation. This is called the boot installation. The only
   difference you will see is some extra output at the beginning of the
   install like:

                      Booting up install for MATLAB
                      -----------------------------

Working . . .

Please hit return to continue . . . >

   For an FTP installation there may be additional messages such as:
   
Detarring ftp files . . . . . . . . . . . [please wait]
Moving boot.ftp file to $MATLAB/ftp . . .
Moving ftp files to $MATLAB/ftp . . . . . [please wait]

8. Interactive versus batch
   ------------------------

   Provided with the distribution is the file $MATLAB/batch.boot. This
   is a Bourne Shell script to allow you to run a complete installation in
   batch. You simply fill out the assignment statements in the file and
   run the script. 

        batch.boot

   See the script for more details.

   Do not use it for a 'collective media' installation or to generate
   the list of files to download for ftp.

9. Running the installation script
   -------------------------------

   To start the installation script, go into $MATLAB and run: 

        install_matlab

   To see the command options run:

        install_matlab -h

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

    Usage: install_matlab -h | -l | -o license_file | -f | -r | -e |
                          -E | -w | [-t] [-s] [-b|-m] [1] [-u] -x |
                                    [-t] [-s] [-b|-m] [1] [-u] -X |
                                    [-t] [-s] [-b|-m] [-u] [type]

      -h   Help. Show command usage.

      -b   Batch mode. Ignore all queries to continue. Cannot
           be specified with -m option.

      -e   (Tape Only) Extract files from 'collective tape' and
           delete 'collective tape' boot directory only.

      -E   (Tape Only) Extract files from 'collective tape' only.

      -f   Analyze TMW_Archive FEATURE Lines in license.dat file
           for validity.

      -l   Output hostname and lmhostid for this host only.

      -m   Minimal install. Do not allow changes to anything
           outside the MATLAB root directory. Cannot be specified
           with -b option.

      -o   Place a template license file in the path given by
           license_file. It will never replace an existing file.

      -r   (Tape Only) Remove the collective tape boot directory.

      -s   Skip welcome messages.

      -t   Terse mode. Print critical screens only.

      -u   User mode. Ignore checking for root and network root.

      -w   (FTP Only) Generate list of FTP files to download.

      -x   Extract files only, i.e. do updating only.

      -X   Extract files and update scripts only.

      type Type of installation:
           1 - normal      3 - client with license manager
           2 - client      4 - license manager only

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

10. Getting the hostid before installation
    --------------------------------------

    To get the lmhostid of the current host run:

        install_matlab -l

    You will get a screen like: (with your computer's hostname and lmhostid)

                     Preparing Your 'license.dat' File
--------------------------------------------------------------------------------
| A 'license.dat' file is required to run MATLAB and in some cases to decrypt  |
| toolbox files during installation. This file contains license server         |
| information and FEATURE lines with passcodes. A passcode file containing the |
| FEATURE lines is generated by The MathWorks using a string called the        |
| 'lmhostid' or license server hostid.                                         |
            The 'lmhostid' for this host (gerbil) is:     7260d091
| If your license server is another host. login to that host and in the MATLAB |
| root directory repeat the command, './install_matlab -l'.                    |
|                                                                              |
| The passcode file needs to be merged into an existing 'license.dat' file.    |
| First time users may place a copy of the passcode file in $MATLAB and it     |
| will be merged in automatically with a skeleton 'license.dat' file created   |
| during installation. Existing users should manually merge the most recent    |
| passcode file with your existing 'license.dat' file,                         |
| $MATLAB/etc/license.dat. If you need a passcode file PLEASE contact:         |
|                                                                              |
|           The MathWorks, Inc.           (508) 653-1415                       |
|    email: service@mathworks.com     FAX (508) 653-2997                       |
|                                                                              |
| See the MATLAB installation guide for the structure of the license file.     |
--------------------------------------------------------------------------------


11. Creating a license file for the first time before installation
    --------------------------------------------------------------

    For all distributions except 'custom media' a license file with a 
    valid TMW_Archive FEATURE line is required for a successful installation.
    This FEATURE line is contained in your license passcode file obtained
    from the MathWorks. All FEATURE lines in that passcode file need to
    be made a part of your license file for later use by the license manager.

    If you received the passcode file via e-mail paste the relevant lines
    into the new file, $MATLAB/license.dat. If you received the passcode
    information via paper or fax first execute the command:

                install_matlab -o license.dat

    in $MATLAB to create a skeleton license file, $MATLAB/license.dat.
    Edit the file and make the FEATURE lines match the lines on the paper.
    Delete any unused FEATURE lines.

    To create the final license file execute the command:

                install_matlab -o etc/license.dat

    which creates the file, $MATLAB/etc/license.dat

    You should see the screen:

    -----------------------------------------------------------
        Created template license file in . . .

            file = etc/license.dat

        Merged in 'license.dat' file found in $MATLAB . . .
    -----------------------------------------------------------

    Inspect the 'final' license file, $MATLAB/etc/license.dat for any
    typographical errors. The lmhostid field in the SERVER line should
    correspond to the lmhostid provided by you to the MathWorks for
    your passcode generation.

    NOTE: An existing license.dat file is NEVER overwritten. If you are
          updating MATLAB you should manually merge in the FEATURE lines
          from the passcode file with those in your current license file,
          normally $MATLAB/etc/license.dat.

12. Checking your TMW_Archive feature line before installation
    ----------------------------------------------------------

    For all distributions except 'custom media' you can check the validity
    of your TMW_Archive line before installation. Run the command:

        install_matlab -f

    It tells you whether the line is valid or not and why. It also lists
    the toolboxes that a valid line can decrypt.

    The screen for a valid line looks like:

                         TMW_Archive FEATURE Line Summary
-------------------------------------------------------------------------------
1. FEATURE TMW_Archive MLM 4 01-apr-1996 0 0123456789ABCDEFGHIJ "e083" DEMO

   Valid . . .
   Can decrypt: tbx.matlab tbx.simulink tbx.signal tbx.codegen
                tbx.symbolic

-------------------------------------------------------------------------------
-> Only toolboxes listed under valid TMW_Archive FEATURE lines will be
-> decrypted.
-------------------------------------------------------------------------------


    The screen for an invalid line looks like:

                         TMW_Archive FEATURE Line Summary
-------------------------------------------------------------------------------
1. FEATURE TMW_Archive MLM 4 01-jan-1994 0 0123456789ABCDEFGHIJ "81" 7260d091

   Error: License checkout failed.
          Software Expired.
   Cannot decrypt: tbx.matlab tbx.signal

-------------------------------------------------------------------------------
-> Only toolboxes listed under valid TMW_Archive FEATURE lines will be
-> decrypted.
-------------------------------------------------------------------------------


    It will handle multiple TMW_Archive lines.

13. (ftp install) Generating the list of files to download
    ------------------------------------------------------

    We assume:

    1. You have downloaded and detarred the FTP boot file, boot.ftp, in the
       $MATLAB directory once.
    2. You have placed the passcode file in $MATLAB/license.dat if you are
       a first time user or you have merged in any new passcode file with an
       existing license file, $MATLAB/etc/license.dat.
    3. You are running as root user.
   
    After a possible boot screen discussed in section 7 you will get the
    the screen:

                  Generate List of FTP Files to Download
  ----------------------------------------------------------------------------
  | To install MATLAB using FTP requires you to select and download          |
  | component files for the various MATLAB products you are licensed for.    |
  | This interface allows you select those products and to have the list of  |
  | component files generated automatically for you.                         |
  |                                                                          |
  | All toolboxes are encrypted. You need a 'license.dat' file,              |
  | $MATLAB/etc/license.dat, with the correct 'TMW_Archive' FEATURE line to  |
  | decrypt your toolboxes during installation.                              |
  |                                                                          |
  | Creating skeleton 'license.dat' file . . . . . . . . [please wait]       |
  | Merging in 'license.dat' file found in $MATLAB . . . [please wait]       |
  | Checking TMW_Archive FEATURE line. . . . . . . . . . [valid]             | 
  |                                                                          |
    MATLAB =  /tmp_mnt/rel/test42/dist.work/README.install/u2/ftp/matlab
  |                                                                          |
  ----------------------------------------------------------------------------
Please press <return> to continue: 

    Note on screen information:
    --------------------------

    It will always create a license file if one does not exist.
    If a passcode file exists it will merge it into a newly created
    skeleton license file. Otherwise, the existing license file is
    used.

                         TMW_Archive FEATURE Line Summary
--------------------------------------------------------------------------------
1. FEATURE TMW_Archive MLM 4 01-apr-1996 0 0123456789ABCDEFGHIJ "e083" DEMO

   Valid . . .
   Can decrypt: tbx.matlab tbx.simulink tbx.signal tbx.codegen
                tbx.symbolic

--------------------------------------------------------------------------------
-> Only toolboxes listed under valid TMW_Archive FEATURE lines will appear
-> selected in the screens that follow.
--------------------------------------------------------------------------------
Please press <return> to continue: 

    Note on screen information:
    --------------------------

    This gives you precise information about the TMW_Archive FEATURE lines.
    Valid TMW_Archive lines are used to determine the initial product
    selection only. On the selection screens that follow, you may choose to 
    deselect any of the initial product selection and choose any other
    products.

                 Select MATLAB Products [screen 1 of 2]
------------------------------------------------------------------------------
    1    * - arch.sun4              14     - tbx.robust (2.0b)    
    2      - arch.hp700             15     - tbx.optim (1.0d)     
    3      - arch.sgi               16     - tbx.splines (1.1a)   
    4      - arch.ibm_rs            17  *  - tbx.signal (3.0b)    
    5      - arch.dec_risc          18     - tbx.mmle3 (1.0a)     
    6      - arch.hp300             19     - tbx.mutools (2.0)    
    7      - arch.sol2              20     - tbx.chem (2.0a)      
    8      - arch.alpha             21     - tbx.nnet (2.0b)      
                                    22  *  - tbx.codegen (1.1b)   
    9    * - matlab (4.2c)          23  *  - tbx.symbolic (1.0a)  
                                    24     - tbx.images (1.0b)    
    10   * - tbx.matlab (4.2a)      25     - tbx.ncd (1.0a)       
    11   * - tbx.simulink (1.3c)    26     - tbx.stats (1.0)      
    12     - tbx.control (3.0b)     27     - tbx.hispec (1.6)     
    13     - tbx.ident (3.0a)       [next screen]                 
------------------------------------------------------------------------------
To select a product:    type the item number, a '*' appears next to it
To deselect a product:  type minus the item number, and the '*' disappears
For help:               type h
For the next screen:    press <return>
------------------------------------------------------------------------------
> 

    Note on screen information:
    --------------------------

    The initial '*' items are the defaults based on the TMW_Archive
    information. If the TMW_Archive line is invalid there will be no
    "*' items. Make any changes as required. There are three help
    screens available initially by typing h for more complete information.
    You can specify several selections and/or deselections on one line
    of input as long as they are separated by whitespace and make
    sense.


                 Select MATLAB Products [screen 2 of 2]
------------------------------------------------------------------------------
    28     - tbx.fdident (2.0)                                    
    29     - tbx.mpc (1.0)                                        
                                                                  
    30     - lm.sun4 (2.4c)                                       
    31     - lm.hp700 (2.4c)                                      
    32     - lm.sgi (2.4c)                                        
    33     - lm.ibm_rs (2.4c)                                     
    34     - lm.dec_risc (2.4c)                                   
    35     - lm.hp300 (2.4c)                                      
    36     - lm.sol2 (2.4c)                                       
    37     - lm.alpha (2.4c)                                      
------------------------------------------------------------------------------
To select a product:    type the item number, a '*' appears next to it
To deselect a product:  type minus the item number, and the '*' disappears
For help:               type h
For the next screen:    press <return>
------------------------------------------------------------------------------
> 

                 Select MATLAB Products [Summary]
----------------------------------------------------------------------------
arches:   sun4 
products: matlab tbx.matlab tbx.simulink tbx.signal tbx.codegen 
          tbx.symbolic 
----------------------------------------------------------------------------
'*' means product cannot be decrypted without an appropriate TMW_Archive
    feature line in your 'license.dat' file.

diskspace:

   FTP files:           20.977 megabytes  (required and recovered if deleted)
   installed files:     44.004 megabytes* (less if installed over an old MATLAB)

'*' assumes all extracted toolboxes have been decrypted.

----------------------------------------------------------------------------
Creating list of FTP files in $MATLAB/files.ftp . . .

    MATLAB =  /tmp_mnt/rel/test42/dist.work/README.install/u2/ftp/matlab
----------------------------------------------------------------------------

    Note on screen information:
    --------------------------

    The 'FTP files' mean all the files from the list '$MATLAB/files.ftp',
    if they downloaded by you. These files are detarred and moved to
    $MATLAB/ftp as part of an installation.  The list $MATLAB/files.ftp,
    contains the list of pathnames for the selected products. Each is
    relative to the 'root' directory of the 'update' account on The
    MathWorks' FTP server, ftp.mathworks.com (144.212.100.10). There are
    informative comments off to the right of certain pathnames.

14. Sample installation walkthrough - custom media
    ----------------------------------------------

    In $MATLAB invoke: 

        install_matlab

    After a possible boot screen discussed in section 7 you will get the
    the screen:
                          
                          Welcome to MATLAB 4.2 Install
   ---------------------------------------------------------------------------
   |(c) Copyright 1984-94 The MathWorks, Inc.                                |
   |    All Rights Reserved                                                  |
   |    MATLAB and SIMULINK are registered trademarks of The MathWorks, Inc. |
   ---------------------------------------------------------------------------
   |Notice to U.S. GOVERNMENT users:                                         |
   |   If Licensee is acquiring the software on behalf of any unit or agency |
   |   of the U.S. Government, the following shall apply:                    |
   |   (a) For units of the Department of Defense:                           |
   |       RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the  |
   |       Government is subject to restrictions as set forth in             |
   |       subparagraph (c)(1)(ii) of the Rights in Technical Data Clause at |
   |       DFARS 252.227-7013.                                               |
   |   (b) For any other unit or agency:                                     |
   |       NOTICE - Notwithstanding any other lease or license agreement     |
   |       that may pertain to, or accompany the delivery of, the computer   |
   |       software and accompanying documentation the rights of the         |
   |       Government regarding its use, reproduction and disclosure are as  |
   |       set forth in Clause 52.227-19(c)(2) of the FAR.                   |
   |Manufacturer is:                                                         |
   |   The MathWorks, Inc., 24 Prime Park Way, Natick, MA 01760.             |
   ---------------------------------------------------------------------------
Continue? ([y]/n)


    Note on choice selection:
    ------------------------

    Whenever you choose "n" to a "Continue?" prompt, you will abort the
    installation and see a message

                 install_matlab stopped prematurely . . .

    A choice of "y" will continue onto the next screen.  Here are the next few
    screen prompts which contain useful environment information.
                          
      -----------------------------------------------------------------
      | 1. Use a screen or window that supports a MINIMUM of 24 text  |
      |    lines and 80 characters per line.                          |
      |                                                               |
      | 2. All steps can be performed if root user. A non-root user   |
      |    can install a working MATLAB. Root means 'network' root if |
      |    the MATLAB root directory is not on a local disk.          |
      |----------------------------------------------------------------
>>>>>>>>> USAGE NOTE: '$MATLAB' means the MATLAB root directory path <<<<<<<<<
      |---------------------------------------------------------------|
      | 3. You may run this program repeatedly without harmful side   |
      |    effects.                                                   |
      |                                                               |
      | 4. This install program may be run in BATCH. See the README   |
      !    file in the $MATLAB/install directory.                     |
      |                                                               |
      | 5. The -h option displays the command usage.                  |
      |----------------------------------------------------------------

      Pressing <return> at any prompt selects the default response
                        shown in square brackets.

Continue? ([y]/n)

Please select ONE type of install:
    -------------------------------------------------------------------
    | 1. NORMAL -                                                     |
    |                                                                 |
    |    Install everything.                                          |
    |                                                                 |
    | 2. CLIENT -                                                     |
    |                                                                 |
    |    Install symbolic links to scripts in $MATLAB/bin directory   |
    |    and copy MATLAB man pages only.                              |
    |                                                                 |
    | 3. CLIENT WITH LICENSE MANAGER -                                |
    |                                                                 |
    |    Same as 2, but also install the license manager.             |
    |                                                                 |
    | 4. LICENSE MANAGER ONLY -                                       |
    |                                                                 |
    -------------------------------------------------------------------
Which one? ([1]) 

    Note on choice selection:
    ------------------------

    The basic strategy for installation is as follows:

    1. Do a NORMAL install on the MATLAB server including installing
       the license manager.

       Note: You can now install the license manager on ANY MATLAB
             supported platform using ANY OTHER MATLAB supported
             platform. You may still need the correct license manager
             binaries for your architecture.

       If you have centralized your license manager services you can either: 

       . copy the directory $MATLAB/etc intact to the central location
         and use the MATLAB supplied scripts to start and stop the
         license manager. You will have to modify the license.dat
         file to be sure that the path to the vendor daemon is correct.

       . copy the license file $MATLAB/etc/license.dat and the license
         manager binaries in $MATLAB/etc/arch (arch is sun4, etc) to your
         central location and use the binaries directly to start and
         stop the license manager. 

       If your computer is standalone it is still required to have network
       (TCP/IP) services running in order to run the license manager.  
       An exception to this rule is if all FEATURES are multiuser
       node-locked or DEMO.

    2. Do a CLIENT install on any computer which will be running MATLAB
       but is not the MATLAB server.

    3. You can use the LICENSE MANAGER ONLY install to shortcut the NORMAL
       install and go directly to installing the license manager again.
       For example, if you did not install the license manager during
       a NORMAL install because you had a DEMO license then you can use
       this form of the install to do the job.

       The CLIENT WITH LICENSE MANAGER install provides logical closure.


    The next screen prompt will display a list of all the tasks the
    installation program can accomplish. Here is the display from
    the NORMAL choice. It gives the full list of installation
    tasks.

                     Welcome to MATLAB 4.2 NORMAL Install

Be prepared to provide MATLAB system configuration information for the tasks:
    ---------------------------------------------------------------------
    |   ALWAYS DONE -                                                   |
    |  A1. Create scripts in $MATLAB/bin directory                      |
    |  A2. Rename M-files in $MATLAB/toolbox/local directory            |
    |  A3. Customize siteid M-file in $MATLAB/toolbox/local directory   |
    |                                                                   |
    |   OPTIONAL (asked first) -                                        |
    |  B1. Create symbolic links to scripts in $MATLAB/bin directory    |
    |  B2. Copy MATLAB man pages                                        |
    |  B3. Install the FLEXlm Network License Manager                   |
    |                                                                   |
    |   ALWAYS DONE (if license manager is installed) -                 |
    |  C1. Create scripts in $MATLAB/etc directory                      |
    |  C3. Create template license.dat file in $MATLAB/etc directory    |
    |                                                                   |
    |   OPTIONAL (asked first if license manager is installed) -        |
    |  C2. Build symbolic link from /etc/lmboot -> $MATLAB/etc/lmboot   |
    ---------------------------------------------------------------------


    The CLIENT choice includes tasks B1 and B2 only.
    The CLIENT WITH LICENSE MANAGER choice includes tasks B1, B2,
    B3 (C1, C2 and C3) only.
    The LICENSE MANAGER ONLY choice includes tasks B3 (C1, C2 and C3) only.


                    Verify MATLAB root directory pathname
                    -------------------------------------

    ------------------------------------------------------------------------
    | The MATLAB root directory pathname has been determined to be:        |

        $MATLAB = /usr/local/matlab

    | This path affects filesystem changes made in the following steps:    |
    |                                                                      |
    |  A1. Create scripts in $MATLAB/bin directory                         |
    |  B1. Create symbolic links to scripts in $MATLAB/bin directory       |
    |  C2. Build symbolic link from /etc/lmboot -> $MATLAB/etc/lmboot      |
    |  C3. Create template license.dat file in $MATLAB/etc directory       |
    |                                                                      |
    | Check the MATLAB root directory path carefully! If it is part of:    |
    |      1. AUTOMOUNTED filesystem - the path must force a mount         |
    |      2. AFS filesystem         - the path must be read-write         |
    | Press <return> if OK. Otherwise, provide the correct pathname below. |
    ------------------------------------------------------------------------

MATLAB root directory? ([/usr/local/matlab])

--------------------->


    Note on $MATLAB: 
    ---------------

    $MATLAB is an important environment variable defining where the physical
    MATLAB files reside.  The default for $MATLAB is /usr/local/matlab. If
    you want to change this path, do so at the long arrow prompt.


                          Update MATLAB
                          -------------

Working . . .

Extracting files, pre-clean MATLAB directory first (please wait) . . .

    matlab/sun4: tar.Z 
    matlab: tar.Z 
    toolbox/matlab/andrew: tar.Z 
    toolbox/matlab/doc: tar.Z 
    toolbox/matlab/sun4: tar.Z 
    toolbox/matlab: tar.Z 
    toolbox/signal/sun4: tar.Z 
    toolbox/signal: tar.Z 
    toolbox/simulink/sun4: tar.Z 
    toolbox/simulink: tar.Z 
    toolbox/codegen/sun4: tar.Z 
    toolbox/codegen: tar.Z 
    toolbox/symbolic/sun4: tar.Z 
    toolbox/symbolic/lib: tar.Z 
    toolbox/symbolic: tar.Z 
    gs/sun4: tar.Z 
    gs: tar.Z 
    info/technote: tar.Z 
    lm/scripts: tar.Z 

Remove any obsolete files from MATLAB directory . . .

    matlab - done
Note: Extra toolbox local files saved in ./toolbox/local/tar.extra
    matlab/sun4 - done
    install - done
    toolbox/matlab - done
    toolbox/matlab/andrew - done
    toolbox/matlab/doc - done
    toolbox/matlab/sun4 - done
    toolbox/signal - done
    toolbox/signal/sun4 - done
    toolbox/simulink - done
    toolbox/simulink/sun4 - done
    toolbox/codegen - done
    toolbox/codegen/sun4 - done
    toolbox/symbolic - done
    toolbox/symbolic/sun4 - done
    toolbox/symbolic/lib - done
    gs - done
    gs/sun4 - done
    info/technote - done
    lm - done
    lm/scripts - done
    lm/sun4 - done

Continue? ([y]/n) 


              A1. Create scripts in $MATLAB/bin directory
              -------------------------------------------

Checking for MATLAB toolboxes . . .

    fixing path for: codegen local matlab signal simulink
                     symbolic 

Creating $MATLAB/bin scripts . . .

    ./bin/cmex : (initial copy)
    ./bin/fmex : (initial copy)
    ./bin/matlab : (initial copy)
    ./bin/.matlabrc.sh : (initial copy)

$MATLAB/bin/.mexrc.sh.MW renamed to $MATLAB/bin/.mexrc.sh

Continue? ([y]/n) 


    Note on scripts:
    ---------------

    These scripts are used for running MATLAB. They are dependent on the
    definition of $MATLAB from the previous screen.

    cmex          A Bourne Shell script which compiles programs for MATLAB C
                  language MEX files.
 
    fmex          A Bourne Shell script which compiles programs for MATLAB
                  Fortran language MEX files.

    .mexrc.sh     A Bourne Shell script which is sourced by cmex and fmex
                  scripts to obtain certain site/user dependent information.
                  The following environment variables are defined within this
                  script:
                
             cmex and fmex:
             -------------
             MATLAB                  (MATLAB root directory)
             CC                      (C compiler)
             CFLAGS                  (C compiler options)
             FC                      (Fortran 77 compiler)
             FFLAGS                  (Fortran 77 options)
             LD_FCLIBS               (Libraries for ld(1) that include
                                      Fortran 77 objects)

             cmex only:
             ---------
             LD_CCLIBS               (Libraries for ld(1) with C objects
                                      only)


    matlab        A Bourne Shell script which sets MATLAB environment
                  variables, determines the machine architecture, and starts
                  the appropriate executable. 
     
    .matlabrc.sh  A Bourne Shell script which is sourced by the matlab
                  script to obtain certain site/user dependent information.  
                  The following environment variables are defined within this
                  script:
             
             MATLAB                  MATLAB root directory
             AUTOMOUNT_MAP           Path prefix map for automounting
             DISPLAY                 DISPLAY variable for X Window System
             ARCH                    machine architecture
             LM_LICENSE_FILE         FLEXlm license file
             TOOLBOX                 toolbox path
             MATLABPATH              matlab search path
             XAPPLRESDIR             X Application Resource Directory
             XKEYSYMDB               X keysym Database file
             SHELL                   which shell to use for "!" in MATLAB



          A2. Rename M-files in $MATLAB/toolbox/local directory
          -----------------------------------------------------

Rename M-files in toolbox/local from .m.MW to .m extension . . .

    Files created:      buildopt.m  docopt.m  matlabrc.m  printopt.m

Continue? ([y]/n)


    Note on toolbox/local:
    ---------------------

    This directory contains M-files which are modifiable by the user so
    that they may customize their MATLAB environment. The unedited
    files all end in .m.MW. The install script will NEVER replace a .m file
    by a new .m.MW file. You must merge any changes manually.

    buildopt.m  (only with Real-Time Workship) An M-file that can be
                edited to indicate the default options for building
                both real-time and nonreal_time programs.

    docopt.m    An M-file that can be edited to indicate how to access
                Mosaic to view the online documentation.

    matlabrc.m  The master startup M-file which is automatically executed
                by MATLAB during startup. It establishes the MATLAB path,
                sets the default figure size, and sets a few uicontrol
                defaults.
 
                On multiuser or networked systems, the system manager can
                put any messages or definitions that apply to all users
                here.

    printopt.m  An M-file that can be edited to indicate the default printer
                type and destination.


    A3. Customize siteid M-file in $MATLAB/toolbox/local directory
    --------------------------------------------------------------

Create siteid.m in toolbox/local . . .

    Please enter your MATLAB site ID . . .

    This should be a number available on your tape media or other
    documentation. If none is available or if you do not know
    what this is simply type a string appropriate to the situation.
    For example, common strings are:

        trial      demo      unknown

    NOTE: This ID allows The MathWorks to internally reference
          your account when you call for technical support or other
          service. The MATLAB 'siteid' command displays its value.

    If you need to fix the value at a later time simply reinstall
    or edit the file $MATLAB/toolbox/local/siteid.m

MATLAB Site ID= [...] 12345

    siteid.m created . . .

Continue? ([y]/n)


    Note on site ID:
    ---------------

    This should be a number available on your tape media or other
    documentation. If none is available or if you do not know
    what this is simply type a string appropriate to the situation.
    For example, common strings are:

        trial      demo      unknown

    NOTE: This ID allows The MathWorks to internally reference
          your account when you call for technical support or other
          service. The MATLAB 'siteid' command displays its value.

    If you need to fix the value at a later time simply reinstall
    using a NORMAL install and type n to stop at the end of the A3
    screen. Another way is to edit the file,

                 $MATLAB/toolbox/local/siteid.m



       B1. Create symbolic links to scripts in $MATLAB/bin directory
       -------------------------------------------------------------

    ------------------------------------------------------------------------
    | To make 'matlab', 'cmex', and 'fmex' valid commands on your system,  |
    | you have a choice of:                                                |
    |                                                                      |
    | [a] Creating symbolic links to the $MATLAB/bin scripts in a          |
    |     directory of your choice that is already on your UNIX search     |
    |     path.                                                            |
    |                                                                      |
    | [b] Adding the $MATLAB/bin directory to your UNIX search path.       |
    ------------------------------------------------------------------------

Do you want to create symbolic links to $MATLAB/bin scripts? ([y]/n)


    Note on choices:
    ---------------

    If you want to create links to the MATLAB scripts, then choose the default
    "y". If you do not want to automatically setup links to the MATLAB scripts,
    then choose "n" as a response to the prompt and manually include
    $MATLAB/bin on your UNIX search path.


    ------------------------------------------------------------------------
    ! Please specify the full pathname of the ACCESS directory for MATLAB. |
    |                                                                      |
    | Choose a directory that exists and is appropriate to your needs.     |
    | Common examples are:  /usr/local/bin /usr/bin                        |
    |                                                                      |
    | The ACCESS directory will contain the following links to scripts     |
    | built by step A1:                                                    |
    |                                                                      |
    |     matlab  -> $MATLAB/bin/matlab                                    |
    |     cmex    -> $MATLAB/bin/cmex                                      |
    |     fmex    -> $MATLAB/bin/fmex                                      |
    |                                                                      |
    ------------------------------------------------------------------------

    Here $MATLAB  = /usr/local/matlab

MATLAB access directory? ([/usr/local/bin])


    Note on the ACCESS directory:
    ----------------------------

    The ACCESS directory is a common area which already exists on your UNIX 
    search path and contains links to user applications. Historically, the
    common area is /usr/local/bin or /usr/bin. This part of the installation
    will create links in the designated ACCESS directory to the $MATLAB/bin
    scripts.


        B2. Copy MATLAB man pages  [root access maybe required]
        -------------------------------------------------------

Copy the MATLAB man pages to a standard place? ([y]/n) y

Enter the top level directory for man pages . . .

    Man pages root directory [/usr/local/man] /tmp

    Directory '/tmp/man1' is missing . . .

    Do you wish to create it? ([y]/n) y

        cmex.1          ------>    /tmp/man1
        fmex.1          ------>    /tmp/man1
        lmboot.1        ------>    /tmp/man1
        lmdown.1        ------>    /tmp/man1
        lmhostid.1      ------>    /tmp/man1
        lmremove.1      ------>    /tmp/man1
        lmreread.1      ------>    /tmp/man1
        lmstart.1       ------>    /tmp/man1
        lmstat.1        ------>    /tmp/man1
        matlab.1        ------>    /tmp/man1

Continue? ([y]/n)


    Note on choices:
    ---------------

    If you wish to copy man pages, answer "y" to the first prompt. The second
    prompt allows you to specify the top level man directory. Within that
    directory the files are usually copied into a subdirectory called man1. If
    it doesn't exist it will prompt you to create it.


    Note on license.dat:
    -------------------

    The license.dat file in $MATLAB/etc contains license information necessary
    for running the FLEXlm license manager.  The following example screen shows
    that the installation program will read any existing license.dat file and 
    will not overwrite it.


             B3. Install the FLEXlm Network License Manager
             ----------------------------------------------

    ----------------------------------------------------------------------
    | NOTE: A pre-existing license file (license.dat) in the $MATLAB/etc |
    |       directory will be PRESERVED by this installation.            |
    |                                                                    |
    |       If you need to install the license manager at a later time   |
    |       or on another host run this install program again selecting  |
    |       the 'LICENSE MANAGER ONLY' install option.                   |
    ----------------------------------------------------------------------

    There is a EXISTING license.dat file and it appears to be a
    DEMO license with expiration date:

                          01-jul-1994

    You are NOT required to install the license manager for a DEMO
    license.

Install the MATLAB FLEXlm License Manager? ([y]/n)

  

                C1. Create scripts in $MATLAB/etc directory
                -------------------------------------------

Creating $MATLAB/etc scripts . . .  lm_matlab  lmboot  lmcksum  lmdlog
                                    lmdown  lmgrd  lmhostid  lmremove
                                    lmreread  lmstart  lmstat  lmver

Continue? ([y]/n)


    Note on $MATLAB/etc scripts:
    ---------------------------

    These files are necessary for running and diagnosing the license manager.
     
    lm_matlab  This is the vendor daemon, which is started by the main daemon
               program, lmgrd, and communicates with the MATLAB process.  It's
               function is to keep track of how many MATLAB sessions are
               running at any one time.
     
    lmboot     A script file for starting the FLEXlm License Manager at
               boot time.
     
    lmcksum    A script file which determines checksums for parts of the
               license file which are are not changeable by the user.
     
    lmdlog     A script file used by MATLAB for starting up a diagnostic log
               file.
     
    lmdown     A script file for gracefully shutting down the FLEXlm License 
               Manager. 
             
    lmgrd      This is the main daemon program for FLEXlm, commonly referred
               to as the "license manager daemon" or "license daemon".  It 
               starts and shuts down vendor deamons and routes connection
               information from the MATLAB process to the MATLAB vendor
               daemon, lm_matlab.
             
    lmhostid   This script is used for obtaining the host ID of your license
               server. The hostid is used by the MathWorks to generate
               passcodes for the license.dat file.
             
    lmremove   A script file for returning licenses to the license pool.
               This script is used primarily when a node crashes and a license 
               remains unusable.

    lmreread   A script file for rereading FLEXlm License Manager license
               file. Lmreread allows you to read in a new license file without
               bringing down the license manager daemon.
             
    lmstart    A script file for starting the FLEXlm License Manager. lmstart
               shuts down any currently running license daemons using lmdown
               and starts (or restarts) the license manager and vendor daemons
               using lmboot.
     
    lmstat     A utility script which displays network licensing activities. 
               To list all information, use "lmstat -a".
          
    lmver      A script file for reporting the FLEXlm version.


       C2. Build symbolic link from /etc/lmboot -> $MATLAB/etc/lmboot
       --------------------------------------------------------------

    ------------------------------------------------------------------------
    | If you want to be able to reboot your machine and have the license   |
    | manager running after the reboot you need to create a link file      |
    | called /etc/lmboot that points to the $MATLAB/etc/lmboot file. This  |
    | link file is OUTSIDE the MATLAB root directory and REQUIRES root     |
    | privilege to create.                                                 |
    | You have the choice of creating the symbolic link:                   |
    |      [a] Now.                                                        |
    |      [b] After the install is finished.                              |
    ------------------------------------------------------------------------

Do you want to create the symbolic link now? ([y]/n) 


    Note on choices:
    ---------------

    Choosing "y" creates a link in /etc which will point to the lmboot script
    located in $MATLAB/etc.  This link is needed if you want to startup
    the license manager at machine boot time. Also you must modify the
    appropriate system boot file(s) manually after install_matlab finishes.
    If you choose "n" you will get the additional lines:


    ------------------------------------------------------------------------
    |  To create the link after the install is finished, execute the       |
    |  the following UNIX command as root user:                            |
    |                         $MATLAB/etc/lmboot -s                        |
      $MATLAB = ...
    ------------------------------------------------------------------------
Continue? ([y]/n) 

    For complete details see the Installation Guide.

               C3. Create license.dat file in $MATLAB/etc directory
               ----------------------------------------------------
    Created skeleton 'license.dat' file . . .
  ----------------------------------------------------------------------------
  | After completing this install program edit the $MATLAB/etc/license.dat   |
  | file and make it match the relevant parts of the license passcode file   |
  | sent to you via E-mail or FAX. Skip this step if you were able to do it  |
  | earlier. If you did not receive this license passcode file or you think  |
  | you need more recent license passcode data PLEASE contact:               |
  |                                                                          |
  |           The MathWorks, Inc.           (508) 653-1415                   |
  |    email: service@mathworks.com     FAX (508) 653-2997                   |
  |                                                                          |
  | Have available the 'lmhostid' string for your license server.            |
              The 'lmhostid' for this host(gerbil) is :   7260d091
  | If your license server is another host, login to that host and in the    |
  | MATLAB root directory run the command, './install_matlab -l'             |
  |                                                                          |
  | See the MATLAB installation guide for the structure of the license file. |
  ----------------------------------------------------------------------------


Continue? ([y]/n)

    Note on screen information:
    --------------------------

    If you have placed the passcode file in $MATLAB/license.dat then you will
    get the additional message:

        Merged in 'license.dat' file found in $MATLAB . . .    

    If the license.dat file already exists then you will get the following
    two lines instead:

        Did not create skeleton 'license.dat' file . . .
        One already exists . . .

    The value of lmhostid is required by The MathWorks to generate your
    license file passcodes. The license file with your passcodes can be
    sent to you via E-mail or fax.

    To get your license file contact:

       The MathWorks, Inc. Customer Service:
 
           Phone: 508-653-1415   (ask for a Customer advocte)
           FAX:   508-653-2997
           Email: service@mathworks.com
   
    Be able to provide your name, company or school name, phone number,
    lmhostid, and hostname. If you are an existing customer, also provide
    your site ID.

    If you are updating your MATLAB version, new passcodes may not be
    necessary.


                   Starting/Stopping the License Manager
   ----------------------------------------------------------------------
   | If you license file requires you run the license manager then at   |
   | the UNIX prompt, login to your license manager host. Change your   |
   | directory to $MATLAB/etc and execute the command:                  |
   |                                                                    |
   | (as root user)                                                     |
   |                                                                    |
   |         lmstart                  (to start the license manager)    |
   |         lmdown                   (to stop the license manager)     |
   |                                                                    |
   | (as non-root user)                                                 |
   |                                                                    |
   |         lmstart -l logfile       (to start the license manager)    |
   |         lmdown  -l logfile       (to stop the license manager)     |
   |                                                                    |
   | where logfile is the name of the logfile writeable by the non-root |
   | user. The same user that executed 'lmstart' should ALWAYS execute  |
   | 'lmdown'.                                                          |
    ---------------------------------------------------------------------

Continue? ([y]/n)


    Note on choice:
    --------------

    Selecting "y" will not invoke the lmstart command.  You will need to
    do this manually from the UNIX prompt in the $MATLAB/etc directory. 
    If you have a multiuser node-locked license, then you do not need to
    execute lmstart.

    ---------------------------------------------------------------------
    | Finished! This completes the:                                     |
    |                                                                   |
    |                  NORMAL install                                   |
    |                                                                   |
    |           for this host.                                          |
    ---------------------------------------------------------------------


15. Sample installation walkthrough - collective media
    --------------------------------------------------

    We assume:

    1. You are running as root user.
    2. You have placed the passcode file in $MATLAB/license.dat if you are
       a first time user or you have merged in any new passcode file with an
       existing license file, $MATLAB/etc/license.dat.
    3. You have tarred off the contents of the first file on the media
       into $MATLAB.

    We present only the screens that are different than those mentioned
    under "Sample installation walkthrough - custom media":

    In $MATLAB invoke:

        install_matlab

    Two welcome screens - see "Sample installation walkthrough - custom media"

    Then:

  ----------------------------------------------------------------------------
  | This install program has two parts:                                      |
  |                                                                          |
  |     *  MATLAB Product Selection and File Extraction                      |
  |     *  MATLAB Installation                                               |
  |                                                                          |
  | You may select and extract any product. However, all toolboxes are       |
  | encrypted and require a further decryption step during MATLAB            |
  | Installation. You need a 'license.dat' file, $MATLAB/etc/license.dat,    |
  | with the correct 'TMW_Archive' FEATURE line to decrypt your toolboxes.   |
  |                                                                          |
  | Creating skeleton 'license.dat' file . . . . . . . . [please wait]       |
  | Merging in 'license.dat' file found in $MATLAB . . . [please wait]       |
  | Checking TMW_Archive FEATURE line. . . . . . . . . . [valid]             | 
  |                                                                          |
    MATLAB =  ...
  |                                                                          |
  ----------------------------------------------------------------------------
Please press <return> to continue: 


    Note on screen information:
    --------------------------

    It will always create a license file if one does not exist.
    If a passcode file exists it will merge it into a newly created
    skeleton license file. Otherwise, the existing license file is
    used.

                         TMW_Archive FEATURE Line Summary
--------------------------------------------------------------------------------
1. FEATURE TMW_Archive MLM 4 01-apr-1996 0 0123456789ABCDEFGHIJ "e083" DEMO

   Valid . . .
   Can decrypt: tbx.matlab tbx.simulink tbx.signal tbx.codegen
                tbx.symbolic

--------------------------------------------------------------------------------
-> Only toolboxes listed under valid TMW_Archive FEATURE lines will be
-> decrypted. To make changes type 'n' at the prompt and follow the directions
-> on the next screen.
--------------------------------------------------------------------------------
Continue? ([y]/n) 

    Note on screen information:
    --------------------------

    You should check to be sure that the TMW_Archive FEATURE line is correct.
    It is recommended that you to stop at this point by typing 'n' if the
    TMW_Archive feature line is invalid or if there are toolboxes that you
    are licensed for and yet do not appear on the decrypt list. Even if
    something is incorrect you can still continue and offload any product.
    However, you will have to fix the license file and run install_matlab
    again. If you extracted all the files on the first install, the second
    install can be done without using the media.


                 MATLAB Product Selection and File Extraction
 
Perform the following tasks to select and extract files.
 
    -------------------------------------------------------------------------
    | T1. Specify Tape Device and Position Tape to MATLAB Product Files     |
    | T2. Select MATLAB Products                                            |
    | T3. Extract Files from Tape and Prepare Them for Installation         |
    | T4. Cleanup                                                           |
    -------------------------------------------------------------------------
 
Continue? ([y]/n) 



    T1. Specify Tape Device and Position Tape to MATLAB Product Files

The MATLAB product files are located in the second tar file on the
distribution tape. We need to move the tape to the start of this file.

Please specify the tape device that was used to read the MATLAB
distribution tape initially.

    Device? ([/dev/rst0]) 

Looking for analogous 'no rewind' device to use . . .

Found it:  /dev/nrst0

    Please load the MATLAB distribution tape and press <return> 

Attempting to move tape to start of second file . . . (please wait) 


    Note on screen information:
    --------------------------

    You will asked to specify the device that you used to read in the
    'boot' files initially. You are not expected to know about 'no rewind'
    devices. It will try to figure things out. It is pretty smart, but
    not full proof.


                 T2: Select MATLAB Products [screen 1 of 2]
------------------------------------------------------------------------------
    1    * - arch.sun4              14     - tbx.mutools (2.0)    
    2      - arch.hp700             15     - tbx.chem (2.0a)      
    3      - arch.sol2              16     - tbx.nnet (2.0b)      
                                    17  *  - tbx.codegen (1.1b)   
    4    * - matlab (4.2c)          18  *  - tbx.symbolic (1.0a)  
                                    19     - tbx.images (1.0b)    
    5    * - tbx.matlab (4.2a)      20     - tbx.ncd (1.0a)       
    6    * - tbx.simulink (1.3c)    21     - tbx.stats (1.0)      
    7      - tbx.control (3.0b)     22     - tbx.hispec (1.6)     
    8      - tbx.ident (3.0a)       23     - tbx.fdident (2.0)    
    9      - tbx.robust (2.0b)      24     - tbx.mpc (1.0)        
    10     - tbx.optim (1.0d)                                     
    11     - tbx.splines (1.1a)     25     - lm.sun4 (2.4c)       
    12   * - tbx.signal (3.0b)      26     - lm.hp700 (2.4c)      
    13     - tbx.mmle3 (1.0a)       [next screen]                 
------------------------------------------------------------------------------
To select a product:    type the item number, a '*' appears next to it
To deselect a product:  type minus the item number, and the '*' disappears
For help:               type h
For the next screen:    press <return>
------------------------------------------------------------------------------
> 

    Note on screen information:
    --------------------------

    The initial '*' items are the defaults based on the TMW_Archive
    information. If the TMW_Archive line is invalid there will be no
    "*' items. Make any changes as required. There are three help
    screens available initially by typing h for more complete information.
    You can specify several selections and/or deselections on one line
    of input as long as they are separated by whitespace and make
    sense.


                 T2: Select MATLAB Products [screen 2 of 2]
------------------------------------------------------------------------------
    27     - lm.sgi (2.4c)                                        
    28     - lm.ibm_rs (2.4c)                                     
    29     - lm.dec_risc (2.4c)                                   
    30     - lm.hp300 (2.4c)                                      
    31     - lm.sol2 (2.4c)                                       
    32     - lm.alpha (2.4c)                                      
                                                                  
    33     - decrypt.sun4                                         
    34     - decrypt.hp700                                        
    35     - decrypt.sgi                                          
    36     - decrypt.ibm_rs                                       
    37     - decrypt.dec_risc                                     
    38     - decrypt.hp300                                        
    39     - decrypt.sol2                                         
    40     - decrypt.alpha                                        
------------------------------------------------------------------------------
To select a product:    type the item number, a '*' appears next to it
To deselect a product:  type minus the item number, and the '*' disappears
For help:               type h
For the next screen:    press <return>
------------------------------------------------------------------------------
> 


                 T2: Select MATLAB Products [Summary]
----------------------------------------------------------------------------
arches:   sun4 
products: matlab tbx.matlab tbx.simulink tbx.signal tbx.codegen 
          tbx.symbolic 
----------------------------------------------------------------------------
'*' means product cannot be decrypted without an appropriate TMW_Archive
    feature line in your 'license.dat' file.

diskspace:       45.129 megabytes* (less if installed over an old MATLAB)

   boot files:           3.250 megabytes  (required and recovered)
   extracted files:     21.672 megabytes  (required and recovered)
   installed files:     45.129 megabytes* (less if installed over an old MATLAB)

'*' assumes all extracted toolboxes have been decrypted.

Ready to extract product files from tape? ([y]/n) 


    Note on screen information:
    --------------------------

    The 'boot files' refer again to the collection of files that were
    offloaded from the first tar file on the media before running
    install_matlab. The 'extracted files' are those that will be taken 
    from the second tar file on the media. They are detarred and placed
    in the update tree, $MATLAB/update/pd, in step T3. The actual
    install process works on the files in the update tree. Any product file
    that cannot be decrypted will be left in the update tree for a
    later install with the correct TMW_Archive line.


    T3. Extract Files from Tape and Prepare Them for Installation

Extracting product files from tape. This may take a while . . . (please wait) 

Prepare product files:

    matlab.common   matlab.sun4   tbx.matlab.common   
    andrew.mat   tbx.matlab.sun4   tbx.simulink.common   
    tbx.simulink.sun4   tbx.signal.common   tbx.signal.sun4   
    tbx.codegen.common   tbx.codegen.sun4   tbx.symbolic.common   
    tbx.symbolic.lib   tbx.symbolic.sun4   

Continue? ([y]/n) 


                           T4. Cleanup

Rewinding tape . . . (please wait) 

You may now remove the tape . . .

REMEMBER: ALWAYS tar the contents of the first file on the MATLAB
          distribution tape into $MATLAB if you wish to extract
          additional products at a later time.

Removing $MATLAB/update/tape directory . . . (please wait) 

Now proceed to the 'MATLAB Installation'

Continue? ([y]/n) 

working . . .


    After waiting a short time while the boot process for the final install
    is done, you then see the screen:
        

Please select ONE type of install:
    -------------------------------------------------------------------
    | 1. NORMAL -                                                     |
    |                                                                 |
    |    Install everything.                                          |
    |                                                                 |
    | 2. CLIENT -                                                     |
    |                                                                 |
    |    Install symbolic links to scripts in $MATLAB/bin directory   |
    |    and copy MATLAB man pages only.                              |
    |                                                                 |
    | 3. CLIENT WITH LICENSE MANAGER -                                |
    |                                                                 |
    |    Same as 2, but also install the license manager.             |
    |                                                                 |
    | 4. LICENSE MANAGER ONLY -                                       |
    |                                                                 |
    -------------------------------------------------------------------
Which one? ([1]) 

    At this point the install looks like the 'custom media' installation.
    See the "Sample installation walkthrough - custom media" section for
    complete details. The exception is the 'Update MATLAB' screen which
    shows decryption. Here is some sample output.


                                Update MATLAB
                                -------------

Working . . .

Found encrypted product files. Start decryption (please wait) . . .

    toolbox/matlab: tar.enc -> tar.Z
    toolbox/matlab/sun4: tar.enc -> tar.Z
    toolbox/simulink: tar.enc -> tar.Z
    toolbox/simulink/sun4: tar.enc -> tar.Z
    toolbox/signal: tar.enc -> tar.Z
    toolbox/signal/sun4: tar.enc -> tar.Z
    toolbox/codegen: tar.enc -> tar.Z
    toolbox/codegen/sun4: tar.enc -> tar.Z
    toolbox/symbolic: tar.enc -> tar.Z
    toolbox/symbolic/lib: tar.enc -> tar.Z
    toolbox/symbolic/sun4: tar.enc -> tar.Z

Extracting files, pre-clean MATLAB directory first (please wait) . . .

    info/technote: tar.Z 
    matlab/sun4: tar.Z 
    matlab: tar.Z 
    lm/scripts: tar.Z 
    gs/sun4: tar.Z 
    gs: tar.Z 
    toolbox/matlab/doc: tar.Z 
    toolbox/matlab/andrew: tar.Z 
    toolbox/matlab/sun4: tar.Z 
    toolbox/matlab: tar.Z 
    toolbox/simulink/sun4: tar.Z 
    toolbox/simulink: tar.Z 
    toolbox/signal/sun4: tar.Z 
    toolbox/signal: tar.Z 
    toolbox/codegen/sun4: tar.Z 
    toolbox/codegen: tar.Z 
    toolbox/symbolic/lib: tar.Z 
    toolbox/symbolic/sun4: tar.Z 
    toolbox/symbolic: tar.Z 

Remove any obsolete files from MATLAB directory . . .

    install - done
    update - done
    update/sun4 - done
    info/technote - done
    matlab - done
Note: Extra toolbox local files saved in ./toolbox/local/tar.extra
    matlab/sun4 - done
    lm - done
    lm/scripts - done
    lm/sun4 - done
    gs - done
    gs/sun4 - done
    toolbox/matlab - done
    toolbox/matlab/doc - done
    toolbox/matlab/andrew - done
    toolbox/matlab/sun4 - done
    toolbox/simulink - done
    toolbox/simulink/sun4 - done
    toolbox/signal - done
    toolbox/signal/sun4 - done
    toolbox/codegen - done
    toolbox/codegen/sun4 - done
    toolbox/symbolic - done
    toolbox/symbolic/lib - done
    toolbox/symbolic/sun4 - done

Continue? ([y]/n) 



16. Sample installation walkthrough - ftp
    -------------------------------------

    We assume:

    1. You are running as root user.
    2. You have an initial license file in $MATLAB/license.dat if you are
       a first time user or you have merged in any new passcode file with an
       existing license file, $MATLAB/etc/license.dat.
    3. You have downloaded the FTP boot file, boot.ftp, to $MATLAB and
       invoked the command in $MATLAB: 

           tar -xvf boot.ftp 

    4. You have downloaded all the product files you are licensed for.
       If you are not sure which files to download see the section,
       "Generating the list of files to download."

    We present only the screens that are different than those mentioned
    under section, "Sample installation walkthrough - custom media":

    In $MATLAB invoke:

        install_matlab


                      Booting up install for MATLAB
                      -----------------------------

Detarring ftp files . . . . . . . . . . . [please wait]
Moving boot.ftp file to $MATLAB/ftp . . .
Moving ftp files to $MATLAB/ftp . . . . . [please wait]

Working . . .

Please press <return> to continue . . . >

    Note on screen information:
    --------------------------
    All download files placed in $MATLAB are detarred (except boot.ftp), and
    then moved to $MATLAB/ftp.


    Two welcome screens - see "Sample installation walkthrough - custom media".

    Then:

                       Checking Your 'license.dat' File
  ----------------------------------------------------------------------------
  | All toolboxes are encrypted. You need a 'license.dat' file,              |
  | $MATLAB/etc/license.dat, with the correct 'TMW_Archive' FEATURE line to  |
  | decrypt your toolboxes during installation.                              |
  |                                                                          |
  | Creating skeleton 'license.dat' file . . . . . . . . [please wait]       |
  | Merging in 'license.dat' file found in $MATLAB . . . [please wait]       |
  | Checking TMW_Archive FEATURE line. . . . . . . . . . [valid]             | 
  |                                                                          |
    MATLAB =  /tmp_mnt/rel/test42/dist.work/README.install/u2/ftp/matlab
  |                                                                          |
  ----------------------------------------------------------------------------
Please press <return> to continue: 


    Note on screen information:
    --------------------------

    This and the next screen appear only if there are downloaded toolbox
    files (those that start with tbx) initially in $MATLAB.

    It will always create a license file if one does not exist.
    If a passcode file exists it will merge it into a newly created
    skeleton license file. Otherwise, the existing license file is
    used.


                         TMW_Archive FEATURE Line Summary
--------------------------------------------------------------------------------
1. FEATURE TMW_Archive MLM 4 01-apr-1996 0 0123456789ABCDEFGHIJ "e083" DEMO
 
   Valid . . .
   Can decrypt: tbx.matlab tbx.simulink tbx.signal tbx.codegen
                tbx.symbolic
 
--------------------------------------------------------------------------------
-> Only toolboxes listed under valid TMW_Archive FEATURE lines will be
-> decrypted. To make changes type 'n' at the prompt and follow the directions
-> on the next screen.
--------------------------------------------------------------------------------
Continue? ([y]/n) 

    Note on screen information:
    --------------------------

    You should check to be sure that the TMW_Archive FEATURE line is correct.
    It is recommended that you to stop at this point by typing 'n' if the
    TMW_Archive feature line is invalid or if there are toolboxes that you
    are licensed for and yet do not appear on the decrypt list. Even if
    something is incorrect you can still continue, but some toolbox files 
    will not be decrypted in a later step. You should fix the license file
    and run install_matlab again. See the section, "Checking your TMW_Archive
    feature line before installation" for more details.
 
Please select ONE type of install:
    -------------------------------------------------------------------
    | 1. NORMAL -                                                     |
    |                                                                 |
    |    Install everything.                                          |
    |                                                                 |
    | 2. CLIENT -                                                     |
    |                                                                 |
    |    Install symbolic links to scripts in $MATLAB/bin directory   |
    |    and copy MATLAB man pages only.                              |
    |                                                                 |
    | 3. CLIENT WITH LICENSE MANAGER -                                |
    |                                                                 |
    |    Same as 2, but also install the license manager.             |
    |                                                                 |
    | 4. LICENSE MANAGER ONLY -                                       |
    |                                                                 |
    -------------------------------------------------------------------
Which one? ([1]) 

    At this point the install looks like the 'custom media' installation.
    See the section, "Sample installation walkthrough - custom media", for
    complete details. The exception is the 'Update MATLAB' screen which
    shows decryption. Here is some sample output.

                                Update MATLAB
                                -------------
 
Working . . .
 
Found encrypted product files. Start decryption (please wait) . . .
 
    toolbox/matlab: tar.enc -> tar.Z
    toolbox/matlab/sun4: tar.enc -> tar.Z
    toolbox/simulink: tar.enc -> tar.Z
    toolbox/simulink/sun4: tar.enc -> tar.Z
    toolbox/signal: tar.enc -> tar.Z
    toolbox/signal/sun4: tar.enc -> tar.Z
    toolbox/codegen: tar.enc -> tar.Z
    toolbox/codegen/sun4: tar.enc -> tar.Z
    toolbox/symbolic: tar.enc -> tar.Z
    toolbox/symbolic/lib: tar.enc -> tar.Z
    toolbox/symbolic/sun4: tar.enc -> tar.Z
 
Extracting files, pre-clean MATLAB directory first (please wait) . . .
 
    info/technote: tar.Z 
    matlab/sun4: tar.Z 
    matlab: tar.Z 
    lm/scripts: tar.Z 
    gs/sun4: tar.Z 
    gs: tar.Z 
    toolbox/matlab/doc: tar.Z 
    toolbox/matlab/andrew: tar.Z 
    toolbox/matlab/sun4: tar.Z 
    toolbox/matlab: tar.Z 
    toolbox/simulink/sun4: tar.Z 
    toolbox/simulink: tar.Z 
    toolbox/signal/sun4: tar.Z 
    toolbox/signal: tar.Z 
    toolbox/codegen/sun4: tar.Z 
    toolbox/codegen: tar.Z 
    toolbox/symbolic/lib: tar.Z 
    toolbox/symbolic/sun4: tar.Z 
    toolbox/symbolic: tar.Z 
 
Remove any obsolete files from MATLAB directory . . .
 
    install - done
    info/technote - done
    matlab - done
Note: Extra toolbox local files saved in ./toolbox/local/tar.extra
    matlab/sun4 - done
    lm - done
    lm/scripts - done
    lm/sun4 - done
    gs - done
    gs/sun4 - done
    toolbox/matlab - done
    toolbox/matlab/doc - done
    toolbox/matlab/andrew - done
    toolbox/matlab/sun4 - done
    toolbox/simulink - done
    toolbox/simulink/sun4 - done
    toolbox/signal - done
    toolbox/signal/sun4 - done
    toolbox/codegen - done
    toolbox/codegen/sun4 - done
    toolbox/symbolic - done
    toolbox/symbolic/lib - done
    toolbox/symbolic/sun4 - done
    update - done
    update/sun4 - done
 
Continue? ([y]/n) 


17. Installing additional toolboxes
    -------------------------------

   . custom media

     Since the media contains only the products you are licensed for any
     additional toolboxes would mean obtaining completely new media and
     installing the complete media again. If possible, always 
     get your software via 'collective media', CD-ROM, or FTP.
     
   . collective media

     We assume that:

     1. You have requested and received the new passcode file from The
        MathWorks with the new passcode information for the additional
        toolboxes.
     2. You have merged in the new passcode file with your existing license
        file, $MATLAB/etc/license.dat.
     3. You have tarred off the contents of the first file on the media
        into $MATLAB.

     Execute the command

         install_matlab -X

     The -X option simply tells the install procedure to stop automatically
     after step "A1. Create scripts in $MATLAB/bin directory".

     You will go through the same type of install as described in section,
     "Sample installation walkthrough - collective media". Be sure in
     screens, "T2: Select MATLAB Products . . .", that you clean out the
     defaults first by using the deselection item '-' and then add only
     the new toolbox item numbers or range of numbers.

     Please note that the extraction process is slow no matter how many
     files you extract since it has to search down the second tar file 
     at least half the way on the average. This tar file can be many
     megabytes.
     
   . FTP
    
     We assume:

     1. You have downloaded the appropriate toolbox files and placed them
        in the $MATLAB directory. If you do not know what files to download
        see the section, "Generating the list of files to download.", for
        more details.
     2. You have merged in the new passcode file with your existing license
        file, $MATLAB/etc/license.dat.

     Execute the command

         install_matlab -X

     The -X option simply tells the install procedure to stop automatically
     after step "A1. Create scripts in $MATLAB/bin directory".

     You will go through the same type of install as described in section
     "Sample installation walkthrough - ftp".

18. Installing as non-root user
    ---------------------------

    If you attempt to install as non-root user the following screen will
    appear at some point in the installation process.

--------------------------------------------------------------------------------
    You are not root user . . .

    You can still install a working MATLAB.

    However, you may not have permission to complete any of the following
    steps if you encounter them during installation:

        B1. Create symbolic links to scripts in $MATLAB/bin directory.
        B2. Copy MATLAB man pages.

    Also, the following step is skipped:

        C2. Build symbolic link from /etc/lmboot -> $MATLAB/etc/lmboot.

    Use the '-m' option with 'install_matlab' to automatically skip
    any of these steps.

    Use the '-u' option with 'install_matlab' to automatically skip
    this check for root user.

    $MATLAB/etc/license.dat file should be owned by root.
--------------------------------------------------------------------------------
Continue? ([y]/n) 

    If it seems OK to continue press <return>. In batch mode it will
    automatically continue.
    
    Tips for the non-root user: 

    . The user who offloaded the files should always do the installation.
    . Any reinstallation should be done by the same non-root user.

    It is highly recommended for security reasons to have root own the
    license file, $MATLAB/etc/license.dat.

19. Minimal installation
    --------------------

    To install a working MATLAB that changes files ONLY within the
    $MATLAB directory execute the command:

        install_matlab -m

---------------------------------------------------------------------------
Copyright (c) 1992-94 by The MathWorks, Inc.
$Revision: 1.9 $  $Date: 1994/12/21 15:24:50 $
---------------------------------------------------------------------------
