INSTALL 2.14 KB
Newer Older
1 2 3
NOTE: see bottom of this file for suggested configurations on particular ANL
machines.

4 5 6
0 - Checkout, build, and install the trunk version of ROSS. At the time of
release (0.3.0), ROSS's latest commit hash was c04babe, so this revision is
"safe" in the unlikely case incompatible changes come along in the future.
7

8
    git clone http://github.com/carothersc/ROSS.git
9
    # optional: git checkout c04babe
10
    cd ROSS
11 12
    mkdir build
    cd build
13 14
	# note: other options for ARCH include i386 (for 32 bit machines),
	# bgp, and bgq (for Blue Gene systems)
15
    ARCH=x86_64 CC=mpicc CXX=mpicxx cmake -DCMAKE_INSTALL_PREFIX=../install ../
16 17 18
    make -j 3
    make install

19 20
    <the result should be that the latest version of ROSS is installed in the 
    ROSS/install/ directory>
21

22
1 - If you are building codes-base directly from the repository, run
23 24 25

    ./prepare.sh

26 27 28
2 - Configure codes-base. This can be done in the source directory or in a
    dedicated build directory if you prefer out-of-tree builds.  The CC
    environment variable must refer to an MPI compiler.
29

30 31 32
    mkdir build
    cd build
    ../configure --with-ross=/path/to/ross/install --prefix=/path/to/codes-base/install CC=mpicc
33

34
3 - Build and install codes-base
35

36
    make && make install
37

38 39
4 - (optional) run test programs

40
    make tests && make check
41

42 43 44 45
5 - codes-base uses flex and bison (or lex and yacc) to generate several
    parsers. These tools auto-generate C source files. To get around versioning
    issues, we've distributed the auto-generated sources directly. To remove
    all of the autogenerated files for these parsers, execute
46 47 48 49 50 51 52 53 54 55 56 57 58

    make maintainer-clean-local


Machine-specific configurations:
----------------
- Fusion (ANL): add the following keys to your ~/.soft file and run "resoft"
  prior to following the steps described in this file:

  +python-2.7.3
  +autoconf-2.68
  +git
  +cmake
Rob Ross's avatar
test  
Rob Ross committed
59

60 61
Notes on using the clang static analyzer
-----------------
62 63 64
- follow steps 0-2 as shown above, with one exception:
  - add the following argument to configure:
    CFLAGS=-I<path_to_your_mpi_include_directory>
65 66 67
- edit Makefile, and delete the "CC = mpicc" (or similar) line
- run "scan-build --use-cc=mpicc make"