BIRCH - Download

1) Download the BIRCH framework and binary files

Go to BIRCH download page to get the BIRCH framework and binary files specific for your system

For example, on a 64-bit Linux system, you would download (x.x refers to the version number):

framework_x.x.tar.gz
bin-linux-x86_64_x.x.tar.gz

Remember, these files must be saved in your BIRCH folder!

Next, go to your BIRCH folder. For example, in a single-user install, it might be something like

cd $HOME/birch

or for a multiuser install,

cd /home/birch

2) Install the BIRCH framework

The BIRCH framework contains all scripts, datafiles, documentation files and folders needed for a BIRCH system, except for the binary executables, which are downloaded separately.

Recreate the BIRCH directory structure

Example:

gunzip framework_2.6.tar.gz

Unzip the framework file

tar xvpf framework_2.6.tar

Un-tar the archive to recreate the BIRCH folders.

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'.

3) Install the binaries specific for your operating system

Recreate the bin directory

Example:

gunzip bin-linux-x86_64_2.6.tar.gz

Unzip the file

Example:

tar xvpf bin-linux-x86_64_2.6.tar

Untar the tar archive

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 folder should look something like this:

drwxrwxr-x  2 birch birch      4096 2010-03-15 16:28 admin
drwxr-xr-x  2 birch birch      4096 2003-07-07 21:10 admin.uninstall
drwxrwxr-x  2 birch birch      4096 2010-03-14 16:15 bin
drwxr-xr-x  2 birch birch      4096 2010-03-30 19:18 bin-linux-x86_64
-rw-rw-r--  1 birch birch 132190720 2010-02-28 14:42 bin-linux-x86_64_2.6.tar
-rw-r--r--  1 birch birch       447 2005-10-08 14:20 birchconfig.homedir.target.html
drwxr-xr-x 27 birch birch      4096 2009-08-10 17:03 dat
drwxr-xr-x 43 birch birch      4096 2010-03-15 13:15 doc
-rw-rw-r--  1 birch birch 251807744 2010-03-15 16:23 framework_2.6.tar
drwxrwxr-x  2 birch birch      4096 2010-03-15 16:26 GenBank
drwxrwxr-x  2 birch birch      4096 2010-03-15 16:26 GenPept
drwxr-xr-x  6 birch birch      4096 2010-03-11 17:01 install-birch
drwxr-xr-x 13 birch birch      4096 2010-03-15 12:53 java
drwxr-xr-x  7 birch birch      4096 2004-01-20 14:23 labace
drwxr-xr-x  5 birch birch      4096 2010-02-28 13:47 lib-linux-intel
drwxr-xr-x 22 birch birch      4096 2009-08-23 09:00 local-generic
drwxr-xr-x  2 birch birch      4096 2010-03-11 13:27 manl
drwxrwxr-x  5 birch birch      4096 2010-03-15 16:26 pkg
drwxr-xr-x 25 birch birch      4096 2010-03-15 16:28 public_html
drwxr-xr-x  2 birch birch     12288 2010-03-15 12:54 script
lrwxrwxrwx  1 birch birch        21 2010-03-15 16:26 tutorials -> public_html/tutorials

Please send suggestions of comments regarding this page to psgendb@cc.umanitoba.ca