BIRCH - Set paths

Create $BIRCH/local

If this is a FIRST TIME installation of BIRCH, you need to create a $BIRCH/local directory by renaming the $BIRCH/local-generic directory. If you were updating an existing BIRCH system, this step would overwrite all your local settings.

mv local-generic local

Set $BIRCH variable

cd local/admin
ls -l

total 26
-rw-r--r--   1 psgendb psgendb      437 Feb 5 13:00 Login_Message
-rw-r--r--   1 psgendb psgendb       14 Dec 29 21:02 birchdir.param
-rw-rw-rw-   1 psgendb psgendb        0 Dec 13 12:46 gde.log
-rw-r--r--   1 psgendb psgendb     1565 Feb 5 12:34 local.cshrc.source
-rw-r--r--   1 psgendb psgendb      332 Feb 5 12:35 local.login.source
-rw-r--r--   1 psgendb psgendb      383 Feb 5 12:54 local.profile.login.source
-rw-r--r--   1 psgendb psgendb     1543 Feb 5 12:56 local.profile.source
-rw-rw-rw-   1 psgendb psgendb        0 Dec 13 12:47 logins.log
-rw-r--r--   1 psgendb psgendb      146 Jan 4 21:39 newstr.param
-rw-r--r--   1 psgendb psgendb     1560 Feb 3 21:29 platform.profile.source
-rw-r--r--   1 psgendb psgendb     1690 Feb 5 12:31 platform.source

Just about everything in BIRCH depends on the $BIRCH environment variable, which lists the location of the BIRCH home directory. This is set in $BIRCH/local/admin/birchdir.param. This file contains a single line:

/home/psgendb

Change this line to the location of the BIRCH home directory, for example

/home/birch

birchdir.param will be read by the script birchhome.csh.

Run birchhome.csh

cd ../../install-birch
ls -l

-rw-r--r--   1 psgendb  psgendb      983 Jan  3 15:43 UNINSTALL-birch.csh
-rwxr--r--   1 psgendb  psgendb     1066 Jan 29 13:09 birchhome.csh*
-rw-r--r--   1 psgendb  psgendb     3690 Jan  6 18:02 customdoc.py
-rw-r--r--   1 psgendb  psgendb       58 Jan  2 14:27 htmldir.param
-rw-r--r--   1 psgendb  psgendb     1044 Dec 26 20:17 installation.readme
lrwxrwxrwx   1 psgendb  psgendb       27 Jan  2 22:56 newstr.param -> ../local/admin/newstr.param
-rw-r--r--   1 psgendb  psgendb      183 Jan  3 16:48 oldstr.param

./birchhome.csh

birchhome.csh will change /home/psgendb to the directory contained in birchdir.param, in the following files, found in $BIRCH/local/admin:

cshrc.source
add_to_cshrc
add_to_login
add_to_profile
newuser

As well, birchhome.csh will also perform the same changes on configuration files for some BIRCH programs, which may change from release to release.

Note: If you are upgrading from BIRCH release A1.7 or earlier : The environment variable BIRCH_PLATFORM is set in local/admin/platform.source and local/admin/platform.profile.source. For releases after A1.7, 'solaris-sparc' will be used for systems running Solaris on the Sparc architecture. The value 'sun' for this variable is deprecated, and support for 'sun' will be removed in later releases.

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