How do I prepare for Integration Test #1?

---

---

1. Log on to any Linux machine as monctrl.

2. Clone Source:

$ cd /home/gbt1/integration
$ for d in ygor gb gbt
> do
> git clone /home/gbt2/git/integration-bare/$d $d
> done
$ 

Note: The cloned source trees will have the master branch checked out, which is correct because we are testing the latest change sets on the master branch from the integration-bare repositories. The release branch has not been merged with the master at this point.

3. Set-up your build environment.

$ export YGOR_ROOT=/home/gbt1/integration/ygor
$ export GB_ROOT=/home/gbt1/integration/gb
$ export YGOR_INSTALL=/home/gbtversions/integration
$ source $YGOR_ROOT/ygor.bash

4. Build the integration source tree.

• TIP: In order to guarantee that there are no errors or warnings during any of the steps in the build and install process you would have to either stare at the output during the entire procedure, or pipe stdout & stderr to a file and look for errors there. When piping, however, the output disappears from your shell and you can't see what is going on. You can have it both ways by combining stdout and stderr and using the 'tee' utility: make 2>&1 | tee make.out

$ cd /home/gbt1/integration
$ for d in ygor gb gbt
> do
> cd $d
> touch .depend
> make 2>&1 | tee make.out 
> make depend
> cd ..
> done

5. Inspect the output of the builds to guarantee the release is clean and complete. Errors must be resolved before continuing. Warnings should be forwarded to the responsible programmer.

6. Install the executables generated by the build.

$ cd /home/gbt1/integration
$ for d in ygor gb gbt
> do
> cd $d
> make install
> cd ..
> done
$

7. There are a few executables which must be setuid and owned by root. The setFileModes script run on gbtdata as root will set the proper modes and ownership and display a list of the files so changed. A successful run produces output similar to the following (files shown here may differ from the output of the current version of the script).

$ ssh gbtdata
$ cd /home/gbt
$ sudo /home/gbt/setFileModes /home/gbtversions/integration
-rwsr-xr-x   1 root     monctrl  8690247 Sep 19 10:28 /home/gbtversions/integration/exec/sparc-solaris/antennaMgr.muacu
-rwsr-xr-x   1 root     monctrl  8690247 Sep 19 10:28 /home/gbtversions/integration/exec/sparc-solaris/antennaMgr.virgo
-rwsr-xr-x   1 root     monctrl  9564815 Sep 19 10:28 /home/gbtversions/integration/exec/i386-linux/antennaMgr.prima
-rwsr-xr-x   1 root     monctrl  9564815 Sep 19 10:28 /home/gbtversions/integration/exec/i386-linux/antennaMgr.virgo
-rwsrwxr-x   1 root     monctrl  1274684 Sep 19 10:15 /home/gbtversions/integration/exec/sparc-solaris/dataCollect
-rwsrwxr-x   1 root     monctrl   167056 Sep 19 10:17 /home/gbtversions/integration/bin/i386-linux/get_spigot_data
-rwsrwxr-x   1 root     monctrl   196059 Sep 19 10:17 /home/gbtversions/integration/bin/i386-linux/spigot_takedata
Done.
$

8. If the Linux Sampler kernel module has changed, follow the procedure for installing the samplerdrv driver.

9. If the DCR kernel driver has changed, follow the procedure for installing the DCR kernel driver.

-- MarkWhitehead - 2009-11-19