B. Quick BigSim Tutorial

This is a step-by-step quick tutorial for simple usage of BigSim simulation framework and visualizing its Projections output logs. For more information, please refer to BigSim and Projections manuals.

1. download latest version of Charm from website or git repository:
   cd $\sim$
   git clone git://charm.cs.uiuc.edu/charm.git
   

2. build charm (and AMPI) with bigemulator and bigsim (replace ``linux" with ``darwin" for mac):
   cd charm
   ./build charm++ net-linux-x86_64 bigemulator bigsim
   ./build AMPI net-linux-x86_64 bigemulator bigsim
   

3. compile your code using charm or AMPI compilers located in ``net-linux-x86_64-bigemulator-bigsim/bin", for example:
   cd tests/ampi/jacobi3d; make
   

4. run your application emulating the target machine, for example:
   ./charmrun +p1 jacobi 4 4 2 5 +vp32 +x32 +y1 +z1 +cth1 +wth1 +bglog
   

5. download BigSim's simulator
   cd $\sim$
   git clone git://charm.cs.uiuc.edu/BigFastSim
   

6. build BigFastSim:
   cd BigFastSim/Release
   vim makefile #change CHARMPATH=$(HOME)/charm/net-linux-x86_64-bigemulator-bigsim/
   make
   

7. copy simulator to trace files' directory:
   cd $\sim$/charm/tests/ampi/jacobi3d
   cp $\sim$/BigFastSim/Release/seqSimulator .
   

8. run the simulator with projections output: (to see other options such as changing latency and bandwidth run ``./seqSimulator -help")
   ./seqSimulator -tproj
   

9. download and make Projections:
   git clone git://charm.cs.uiuc.edu/projections.git
   cd projections
   ant
   

10. run Projections:
    ./bin/projections64 #open tproj.sts file
    

After opeing the symbol file (file/open tproj.sts), you can use different features of Projections such as tools/Timelines.