Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Download Jikes RVM version 3.0.2 or later (or use hg tip)
  2. Ensure you can Build and Run the RVM.
  3. Ensure you can build and run the BaseBaseNoGC configuration (build with: bin/buildit localhost BaseBaseNoGC, run with something like:

    Code Blocknoformat
    
    dist/BaseBaseNoGC_ia32-linux/rvm HelloWorld
    

    Note that this configuration does not perform garbage collection so can only run small benchmarks which do not exhaust available memory. This configuration will be used as the basis for the tutorial.

  4. Ensure that your source is successfully imported (and editable) within an IDE such as Eclipse.
  5. Set up an Eclipse Run configuration for the NoGC plan using the MMTk Test Harness.

...

  1. Copy the org.mmtk.plan.nogc package to org.mmtk.plan.tutorial (copy and paste the package in Eclipse).
  2. Rename the constituent classes from NoGC* to Tutorial* (use Refactor->Rename on each class within the org.mmtk.plan.tutorial package in Eclipse).
  3. Modify your MMTk Harness Eclipse Run Configuration to use the new Plan, and click 'Run' to run it.
  4. Create a new configuration file, build/configs/BaseBaseTutorial.properties, with a single line: config.mmtk.plan=org.mmtk.plan.tutorial.Tutorial
  5. Build and run the resulting collector:
    • build with something like:

      Code Blocknoformat
      
      bin/buildit localhost BaseBaseTutorial
      
    • run with something like:

      Code Blocknoformat
      
      dist/BaseBaseTutorial_ia32-linux/rvm HelloWorld
      
      Info
      titleCheckpoint

      This zip file captures all of the above steps with respect to Jikes RVM 3.0.2. You can use the files within the archive to verify you've completed the above steps correctly.