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
-----------------
Philip Carns's avatar
Philip Carns committed
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"