1) Install the BIRCH framework

• Make the BIRCH home directory world-readable and world-searchable eg.
   
  chmod a+rx /home/birch
  cd /home/birch
  
  (The BIRCH home directory could be anywhere you choose. It doesn't have to be /home/birch.)
  
  
• Go to BIRCH download page to get the BIRCH framework file
  
  
• Unzip the framework file eg.
  gunzip framework.tar.gz
  mv framework.tar.gz /home/birch
  
  
• Recreate the BIRCH directory structure eg.
  cd /home/birch
  tar xvpf framework.tar

=======> IMPORTANT NOTES:
1) The 'p' option is essential for this tar command to make sure that file permissions are preserved as in the original directory hierarchy!
2) If you are installing as root, also include the "o" option (ie. tar xvopf). Normally, tar sets the user and owner of a file to match the user running tar. However, when the user is root, tar will instead try to set the user and owner to those from the original tar file. The o option will force tar to set the user and owner to 'root'.


The BIRCH home directory should look something like this:

{malcolm:/home/birch}ls -l
total 52
drwxr-xr-x    2 birch    users        4096 Nov 24 20:00 admin
drwxr-xr-x   28 birch    users        4096 Jul 22 11:38 dat
drwxr-xr-x   42 birch    users        4096 Nov 17 21:58 doc
drwxr-xr-x   12 birch    users        4096 Nov 23 16:02 install
drwx------    2 birch    users        4096 Oct 25 19:43 install-birch
drwxr-xr-x    8 birch    users        4096 Oct 25 17:53 java
drwxr-xr-x   13 birch    users        4096 Oct 25 18:46 local-generic
drwxr-xr-x    2 birch    users        4096 Jul 22  2001 manl
drwxr-xr-x    9 birch    users        4096 Nov 23 15:47 ncbi
drwxr-xr-x    2 birch    users        4096 Nov 22 22:05 PIR
drwxr-xr-x   24 birch    users        4096 Nov  9 13:44 public_html
drwxr-xr-x    2 birch    users        4096 Nov 23 12:31 script

2) Install the binaries specific for your operating system

• Go to BIRCH download page to get the appropriate binary file(s) specific for your operating system
  
  
• Unzip the file  eg.
   gunzip file.tar.gz
• Recreate the bin directory eg.
    tar xvpf bin-solaris-sparc.tar
  
  
  =======>IMPORTANT NOTES:
  1) The 'p' option is essential for this tar command to make sure that file permissions are preserved as in the original directory hierarchy!
  2) If you are installing as root, also include the "o" option (ie. tar xvopf). Normally, tar sets the user and owner of a file to match the user running tar. However, when the user is root, tar will instead try to set the user and owner to those from the original tar file. The o option will force tar to set the user and owner to 'root'.
  
  
• Move the bin directory to the BIRCH home directory eg.
      mv bin-solaris-sparc /home/birch.