*****************************************************************
*            Building/Compiling the ICE Option Tree             *
*                                                               *
*     Browser formatted documentation is in htm/index.html      *
*                                                               *
*****************************************************************

To insure proper operation, complete the following steps: 

0) It is assumed that you already have a C compiler installed on your machine, 
   which will be used to build the ICE drivers.  If you are on a Windows machine 
   and need instructions for installing a C compiler, see readme.egcs.

1) Define an environment variable ICEROOT pointing to the unpacked software tree,
   and an alias pointing to the ICE utilities script. For example:

   > cd /midas/opt/
   > unzip ice361.zip
   > setenv ICEROOT /midas/opt/ice361
   > alias ice $ICEROOT/jre/ice

2) Build and install the PCI driver for your Operating System.
   See the section in $ICEROOT/hlp/drivers.hlp for your OS.

3) Detect current cards. This also builds the shared object libraries.
   > ice detect

4) Run stand-alone test and check output.
   > ice test all PIC1
   > ice test all PIC2 

5) Define an environment variable JAVAHOME pointing to an installed Java Runtime 
   Environment to run the rest of the ICE utility functions. 
   > ice explain

6) For optional XMidas install, see readme.xm

7) For optional NeXtMidas install, see readme.nxm




To install a new version of ICE on a system that has already been setup:

1) Move to the directory containing the ICE tree.

  > cd /opt/ice/pkg

2) Unzip the new tree.

  > unzip ~/ice398-23.zip

3) Change the current version link to the new tree.

  > ln -sfn ice398-23 icexxx

4) User the ICE script to rebuild and install the new tree.

  > ice reinstall

That should do it.


