G. Building the Tutorial Code Tree

The file tutorial-src-0.7.1-0.tar.gz (or a mode recent version) at http://www.cca-forum.org/tutorials/#sources has the full code for all of the components discussed in this Guide. If you're part of an organized tutorial, there will be a copy of the source code on the system you're using, so you can just copy it instead of downloading it over the network.

Note In this release of the tutorial source code, we're experimenting with a new approach to organizing and building the code. It is likely there are some rough edges, so please don't hesitate to contact us at cca-tutorial@cca-forum.org if you're having problems building it.

1. Make sure you have installed the CCA tools, and configured your environment according to Appendix E. This critical, since the build for the tutorial source tree keys off of the environment variables setup in Appendix E.4.

2. $	cd $WORKDIR

3. Download or copy the tutorial-src-0.7.1-0.tar.gz tarball to your $WORKDIR.

4. Unpack the tarball:

   $	tar zxf tutorial-src-0.7.1-0.tar.gz

5. $	cd tutorial-src

6. To build the ``PDE'' portion of the code tree, type

   $	./pde-make all

   The build will take some time.

   Caution After the build is complete, it tries to perform several basic tests on the components. Some of these tests are currently written to launch the Ccaffeine GUI, which may not work if you don't have an X11 connection to the machine you're building on. This is not a problem as long as the main build process completed successfully (scroll back through the make output a bit to check.) If you have problems, as for assistance (from tutorial instructors or at cca-tutorial@cca-forum.org). We're working on improving this.

7. To build the ``ODE'' portion of the code tree, type

   $	./ode-make all

   The build will take some time.

   Caution After the build is complete, it tries to perform several basic tests on the components. Some of these tests are currently written to launch the Ccaffeine GUI, which may not work if you don't have an X11 connection to the machine you're building on. This is not a problem as long as the main build process completed successfully (scroll back through the make output a bit to check.) If you have problems, as for assistance (from tutorial instructors or at cca-tutorial@cca-forum.org). We're working on improving this.

If (a) you're part of an organized tutorial, and (b) you use the provided shell configuration fragments to setup your environment, and (c) you follow the directions above as to where to unpack and build the tutorial code tree, you should find that the environment variables $STUDENT_SRC and $PDE_STUDENT_SRC are already pointing to the tops of the Bocca project trees, in the directories obj/ode and obj/pde below the build directory (which should be you current directory).

If you're working through this Guide on your own, you should be sure to add to your environment the appropriate variable definitions: $TUTORIAL_SRC (interchangable with $STUDENT_SRC in this case) and $PDE_SRC (interchangable with $PDE_STUDENT_SRC in this case).

Note If you want to do a clean build of either code tree, you can use (Substitute ``ode'' for ``pde'' as appropriate):  ./pde-make clean and then  ./pde-make all. The ``clean'' operation actually copies the obj/pde tree to a backup copy with a time-stamped directory name. If you're running out of disk space, you might need to clean up some of these backups.