_____________________________________________________________
         |                                                           |
         | OpenUH Installation Instructions for Itanium architecture |
         |___________________________________________________________|

Notes: You do NOT need superuser permission to install OpenUH compiler.
There are two ways to install OpenUH on Itanium platforms: 
using prebuilt binaries or the source codes.

========
Method 1: Using prebuilt binaries
========

If your system is one of the following, you do not need to build the compiler 
from the source: Intel Itanium 1 or 2 with Red Hat Enterprise Linux AS 
release 3 and gcc 3.x. 

I. The following is the steps to install the prebuilt binaries for IA-64.

 1.  Download OpenUH Compiler binary for Itanium from                
    http://www.cs.uh.edu/~openuh/download

    After a simple registration, get openuh-alpha.itanium.tar.gz,
    where alpha is the current version number.

 2. untar it to your preferred directory. 
     For example let's assume you will install it into your local directory,  
     $HOME/opt/.
	    mv openuh-alpha.itanium.tar.gz ~/opt
            cd ~/opt
            tar xzvf openuh-alpha.itanium.tar.gz

 3. Set up environment variables.
    Adding the following lines into your .bash_profile.

   export TOOLROOT=$HOME/opt/openuh
   export PATH=$PATH:$TOOLROOT/usr/bin
   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$TOOLROOT/usr/lib/gcc-lib/ia64-orc-linux/2.1
   export NLSPATH=$NLSPATH:$TOOLROOT/usr/lib/gcc-lib/ia64-orc-linux/2.1/cf90.cat

 4. Update environment variables. Assume you are using bash again:

       source ~/.bash_profile

 5. Test the compiler using

      uhcc yourprogram.c          or        uhCC youprogram.CC
      uhf90 yourprogram.f

You are done now. Please type uhcc or uhf90 for command line help or read the user's guide.


========
Method 2: Installing from source
========

II. To build and Install OpenUH from source. There is something tricky because 
OpenUH needs a Fortran 90 compiler to compile its FORTRAN 90 libraries. 
So, we enclosed a modified ORC 2.1 compiler inside the source package and it is 
used to compile the OpenUH compiler. It takes two or more hours to finish the 
whole compilation phase depending on your machine. So please be prepared. 

First, download the source package openuh-alpha.src.tar.gz from 
http://www.cs.uh.edu/~openuh and untar it. 

         tar xzvf openuh-alpha.src.tar.gz

A new directory named openuh will appear.

---------------------------
Using the install.sh script
---------------------------

It is recommended to use our script install.sh for the whole process. You only 
need to change the first line of install.sh to some path you like. The default 
installation path is $(HOME)/opt.

         cd openuh
         ./install.sh

After it is done (it takes around 2 hours depending on your machine). 
Set the environment variables and then it is ready to use.

For example, if you are using bash:

       export TOOLROOT=$HOME/opt
       export PATH=$PATH:$TOOLROOT/usr/bin
       export LD_LIBRARY_PATH=$TOOLROOT/usr/lib/gcc-lib/ia64-orc-linux/2.1
       export NLSPATH=$TOOLROOT/usr/lib/gcc-lib/ia64-orc-linux/2.1/cf90.cat

---------------------------
Complete all steps manually
---------------------------

The complete instructions are following, which is exactly what is happening in the install.sh script.


1. Install and test the prebuilt ORC 2.1 compiler 
      cd openuh/bin
      tar xzvf orc-2.1-bin.tar.gz

   Change your environment variables in your .bash_profile

      export TOOLROOT=openuh/bin/orc-2.1-bin
      PATH=$PATH:$TOOLROOT/usr/bin
      export PATH
      export LD_LIBRARY_PATH=$TOOLROOT/usr/lib/gcc-lib/ia64-orc-linux/2.1
      export NLSPATH=$TOOLROOT/usr/lib/gcc-lib/ia64-orc-linux/2.1/cf90.cat

   Use this command to update the environment variables:
      source .bash_profile

   Test the compiler using sequential code 
   (No OpenMP supported for this prebuilt compiler for simplicity.)
      orcc yourprogram.c or
      orf90 yourprogram.f

2. Build the OpenUH compiler

     2.1  Change directory to the subdirectory you choose
             cd openuh/src
             gmake -f Make.NUE.lib build
             gmake -f Make.native

      2.2  To compile a debug version add BUILD_OPTIMIZE=DEBUG:

             gmake -f Make.native BUILD_OPTMIZE=DEBUG

      2.3  You may choose to uninstall the prebuilt orc2.1 compiler 
             by deleting the whole directory of it.
         
             rm .fr  openuh/bin/orc-2.1-bin

3. Once you compiled OpenUH, you need to specify 
    where you would like to install it. Redefine the environment variable:

             TOOLROOT =<Mydir>  
      <Mydir> is where you want to install OpenUH , 
       for example, to your local directory.s opt directory: TOOLROOT = $HOME/opt

4. Install the OpenUH binaries and libraries.

         ./INSTALL.native

5. Set the environment variables and you are ready to use open90/uhCC/uhCC for 
   Fortran90/C/C++. 

   For example, add the following lines to your .bash_profile:

       export TOOLROOT=$HOME/opt
       export PATH=$PATH:$TOOLROOT/usr/bin
       export LD_LIBRARY_PATH=$TOOLROOT/usr/lib/gcc-lib/ia64-orc-linux/2.1
       export NLSPATH=$TOOLROOT/usr/lib/gcc-lib/ia64-orc-linux/2.1/cf90.cat

   And type:
       source ~/.bash_profile

   To test, use the following command:
       uhf90 [-mp (for openmp)] <source filename>

   same with uhCC/uhc++


6.  Clean the compiler.
    Clean the installed binaries: 
       rm -rf $HOME/opt 

    Clean the built objects in the source tree:  
       gmake -f Make.native clobber
       gmake -f Make.NUE.lib clobber

Note: you can add the flag to gmake -j<# of processors> to do parallel make
when working on a single targia64_ia64.. directory. Do not use this for
Make.native or Make.NUE.lib