Sancho ramp up - SanchoGGP/ggp-base GitHub Wiki

If you're new to Sancho, there are a few things that you should do to begin.

  • Install Java 8. (You'll need a 64-bit version to be able to address enough memory for Sancho to work.)
  • Install and configure Eclipse.
  • Install and configure Perl.
  • Install a Git client (we recommend SmartGit if you don't have one already).
  • Read the design doc (in the docs directory).
  • Browse the code.
  • Read the to-do doc and identify some tasks that you think you could help with.

Debugging

For Java debugging, you might find the following tools useful. Make sure you install the 64-bit version (because they need to match your Java version).

  • Visual VM - with many plugins for monitoring the state of Java processes (threads, heap, memory pools, GC, CPU usage, profiling, etc.). When running, make sure that you're using the same JVM as used to run Sancho. You can specify the JVM using e.g. --jdkhome "C:\Program Files\java\jdk1.8.0_45".
  • Eclipse Memory Analyzer (MAT) - a heap analysis tool. When running, make sure that you're using the same JVM as used to run Sancho. You can specify the JVM using e.g. -vm "C:\Program Files\Java\jdk1.8.0_45\bin" (noting that \bin is required here but not for VisualVM).