Getting started with BRAT on NT
  1. BRAT runs under ROOT. If ROOT is not running, it must be installed. See instructions and download procedures at http://root.cern.ch
    1. ROOTSYS must be set to c:\\users\\root. The double slash is necessary for working with BRAT. In principle a single unix slash should work also, but that has not been tested.
  2. The Cygnus Development Kit (cdk) needs to be installed. If it is already installed, you may skip the next several steps.
    1. These steps assume you are downloading the beta-19 version. The steps should be similar if you are downloading a later version.
    2. Download the cdk using the following steps
      1. Activate your favorite browser
      2. Go to www.cygnus.com/misc/gnu-win32
      3. pick the ftp mirror site nearest your institution
      4. download cdkb19.exe to your machine
    3. Make a MS-DOS window
    4. Change directory to the one where cdkb19.exe was downloaded to
    5. execute cdkb19.exe
      1. During the procedure it will ask where to put the software. I have found that the only way the software will work properly is if you put it into \Cygnus\B19
    6. Once the procedure is completed, the following needs to be added to your path
      1. C:\Cygnus\b19\H-i386-cygwin32\bin
        1. C:\Cygnus\b19
    7. Now to activate cygnus software, just type in Cygnus at the DOS prompt. Then you will have many UNIX commands. Also, once you get out of cygnus (using exit), many of the commands will remain activated. To have these commands activated, it is only necessary to get into Cygnus once per DOS session.
  3. Continuing with BRAT with the assumption that Cygnus is installed.
  4. Obtain a BRAT tar file. This should come from the BRAHMS CVS repository. To do that, execute the following steps
    1. logon to the RCF
    2. get an AFS tolken (klog; then type in your afs password)
    3. cd to the place where you want to temporarily store brat, eg brat_cvs
    4. cvs checkout brat
    5. cvs release brat
    6. tar -cvf brat.tar brat
    7. transfer brat.tar in binary format to your NT machine.
    8. tar -xvf brat.tar
  5. Set BRATSYS and BRATHOME variables to the directory root where BRAT will reside. The difference between BRATSYS and BRATHOME is that BRATSYS is for system wide BRAT and BRATHOME is detector specific. This enables to develop parts of the system independently (BRATHOME) with the rest of the system being in some type of semi-permanent repository (BRATSYS). The following example assumes you are working with the whole system and that BRAT resides in D:\users\brat\brat.
    1. BRATSYS = //D/users/brat/brat
    2. BRATHOME = //D/users/brat/brat
  6. Be sure MSVCC is installed.
  7. Be sure C:\MSDEV\bin is included in your path. The installation procedure does not do that for you.
  8. Set the include and lib variables to have the MSVCC stuff plus pointers to ROOT
    1. include=c:\msdev\include;c:\msdev\mfc\include;%rootsys%\include
    2. lib=c:\msdev\lib;c:\msdev\mfc\lib;c:\users\brat\brat\lib\WinNT. Using BRATSYS or BRATHOME here will not work because BRATSYS and BRATHOME are Unix style and NT (DOS) style is needed here. It should be noted that if BRATSYS and BRATHOME are not the same, both pointers must be put into the lib variable.
  9. One must be sure that BRAT is being compiled using the same compiler that ROOT was compiled with. Strange errors occur if that is not the case. If your compiler is not the same as the one ROOT was compiled with and it is not feasible to get the same compiler, it is necessary to recompile ROOT. That requires the following steps.
    1. Download root.cmz for the version of ROOT you wish to compile.
    2. Download CMZ from Cernlib
    3. Get the proper CMZLOGON.kumac file to setup for ROOT
    4. Get into CMZ
    5. type Install
  10. If BRAT does not reside on drive D on your machine, you must edit two lines near the top of mkconfig.WinNT to indicate which drive it resides on. This will be made more automatic as soon as possible.
  11. Compile BRAT using make (from Cygnus)