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 birch birch      437 Feb 5 13:00 Login_Message
-rw-r--r--   1 birch birch       14 Dec 29 21:02 birchdir.param
-rw-rw-rw-   1 birch birch        0 Dec 13 12:46 gde.log
-rw-r--r--   1 birch birch     1565 Feb 5 12:34 local.cshrc.source
-rw-r--r--   1 birch birch      332 Feb 5 12:35 local.login.source
-rw-r--r--   1 birch birch      383 Feb 5 12:54 local.profile.login.source
-rw-r--r--   1 birch birch     1543 Feb 5 12:56 local.profile.source
-rw-rw-rw-   1 birch birch        0 Dec 13 12:47 logins.log
-rw-r--r--   1 birch birch      146 Jan 4 21:39 newstr.param
-rw-r--r--   1 birch birch     1560 Feb 3 21:29 platform.profile.source
-rw-r--r--   1 birch birch     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/birch

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

./birchhome.csh

birchhome.csh will change /home/birch 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 frist@cc.umanitoba.ca