mmtk · wks · Dec 11, 2021 · Dec 14, 2021 · Dec 23, 2021 · Jan 6, 2022
diff --git a/.github/configs/base.yml b/.github/configs/base.yml
@@ -2,13 +2,16 @@ includes:
   - "$RUNNING_NG_PACKAGE_DATA/base/runbms.yml"
 
 suites:
-  dacapo-23.9-RC3-chopin-ci:
+  # We use the same suites name "dacapochopin" as defined in "running-ng/src/running/config/base/dacapo.yml".
+  # This will combine this definition with the existing "dacapochopin".
+  # This will also allow us to use modifiers such as "dacapochopin_jdk21" which expect the suites name "dacapochopin".
+  dacapochopin:
     type: DaCapo
-    # Need running-ng to support 23.9
-    release: evaluation
-    path: "DACAPO_PATH/dacapo-23.9-RC3-chopin.jar"
+    release: "23.11"
+    path: "DACAPO_PATH/dacapo-23.11-MR2-chopin.jar"
     minheap: mmtk-openjdk-11-MarkCompact
     # Min heap values are from dacapo-evaluation-git-04132797
+    # TODO: Use the values provided by the released version, and use G1 instead of MarkCompact.
     minheap_values:
       mmtk-openjdk-11-MarkCompact:
         avrora: 8
@@ -83,19 +86,19 @@ plugins:
       - "scratch/stderr.log"
 
 runtimes:
-  jdk11-master:
+  jdk21-master:
     type: OpenJDK
-    release: 11
+    release: 21
     home: "/home/runner/work/mmtk-openjdk/mmtk-openjdk/bundles/jdk"
 
 configs:
-  - "jdk11-master|ms|s|fail_on_oom|tph|preserve|mmtk_gc-SemiSpace"
-  - "jdk11-master|ms|s|fail_on_oom|tph|preserve|mmtk_gc-GenCopy"
-  - "jdk11-master|ms|s|fail_on_oom|tph|preserve|mmtk_gc-Immix"
-  - "jdk11-master|ms|s|fail_on_oom|tph|preserve|mmtk_gc-GenImmix"
-  - "jdk11-master|ms|s|fail_on_oom|tph|preserve|mmtk_gc-StickyImmix"
-  - "jdk11-master|ms|s|fail_on_oom|tph|preserve|mmtk_gc-MarkSweep"
-  - "jdk11-master|ms|s|fail_on_oom|tph|preserve|mmtk_gc-MarkCompact"
+  - "jdk21-master|dacapochopin_jdk21|ms|s|fail_on_oom|tph|preserve|mmtk_gc-SemiSpace"
+  - "jdk21-master|dacapochopin_jdk21|ms|s|fail_on_oom|tph|preserve|mmtk_gc-GenCopy"
+  - "jdk21-master|dacapochopin_jdk21|ms|s|fail_on_oom|tph|preserve|mmtk_gc-Immix"
+  - "jdk21-master|dacapochopin_jdk21|ms|s|fail_on_oom|tph|preserve|mmtk_gc-GenImmix"
+  - "jdk21-master|dacapochopin_jdk21|ms|s|fail_on_oom|tph|preserve|mmtk_gc-StickyImmix"
+  - "jdk21-master|dacapochopin_jdk21|ms|s|fail_on_oom|tph|preserve|mmtk_gc-MarkSweep"
+  - "jdk21-master|dacapochopin_jdk21|ms|s|fail_on_oom|tph|preserve|mmtk_gc-MarkCompact"
 
 benchmarks:
-  dacapo-23.9-RC3-chopin-ci:
+  dacapochopin:
diff --git a/.github/scripts/ci-build.sh b/.github/scripts/ci-build.sh
@@ -13,4 +13,4 @@ build_target=$1
 # Build product bundle
 cd $OPENJDK_PATH
 sh configure --disable-warnings-as-errors --with-debug-level=$DEBUG_LEVEL
-make CONF=linux-x86_64-normal-server-$DEBUG_LEVEL THIRD_PARTY_HEAP=$BINDING_PATH/openjdk $OPENJDK_BUILD_TARGET
+make CONF=linux-x86_64-server-$DEBUG_LEVEL THIRD_PARTY_HEAP=$BINDING_PATH/openjdk $OPENJDK_BUILD_TARGET
diff --git a/.github/scripts/ci-checkout.sh b/.github/scripts/ci-checkout.sh
@@ -1,14 +1,10 @@
-# ci-checkout.sh
 set -ex
 
 . $(dirname "$0")/common.sh
 
 OPENJDK_URL=`cargo read-manifest --manifest-path=$BINDING_PATH/mmtk/Cargo.toml | python3 -c 'import json,sys; print(json.load(sys.stdin)["metadata"]["openjdk"]["openjdk_repo"])'`
 OPENJDK_VERSION=`cargo read-manifest --manifest-path=$BINDING_PATH/mmtk/Cargo.toml | python3 -c 'import json,sys; print(json.load(sys.stdin)["metadata"]["openjdk"]["openjdk_version"])'`
 
-# Use default openjdk path if it is not set (this is only need when MMTk core calls the script)
-OPENJDK_PATH=${OPENJDK_PATH:="$BINDING_PATH/repos/openjdk"}
-
 rm -rf $OPENJDK_PATH
 git clone $OPENJDK_URL $OPENJDK_PATH
 git -C $OPENJDK_PATH checkout $OPENJDK_VERSION
diff --git a/.github/scripts/ci-setup.sh b/.github/scripts/ci-setup.sh
@@ -2,7 +2,7 @@ set -xe
 
 . $(dirname "$0")/common.sh
 
-# Install nightly rust
+# Install the appropriate Rust toolchain
 rustup toolchain install $RUSTUP_TOOLCHAIN
 rustup target add i686-unknown-linux-gnu --toolchain $RUSTUP_TOOLCHAIN
 rustup component add clippy --toolchain $RUSTUP_TOOLCHAIN

diff --git a/.github/scripts/ci-test-extended.sh b/.github/scripts/ci-test-extended.sh
@@ -1,21 +1,10 @@
 set -ex
 
-. $(dirname "$0")/common.sh
-cur=$BINDING_PATH/.github/scripts
-
-# This script is only used by MMTk core.
-# OPENJDK_PATH is the default path set in ci-checkout.sh
-export OPENJDK_PATH=$BINDING_PATH/repos/openjdk
-export DEBUG_LEVEL=fastdebug
-export TEST_JAVA_BIN=$OPENJDK_PATH/build/linux-x86_64-normal-server-$DEBUG_LEVEL/jdk/bin/java
-
-# Download dacapo
-export DACAPO_PATH=$BINDING_PATH/dacapo
-mkdir -p $DACAPO_PATH
-wget https://downloads.sourceforge.net/project/dacapobench/archive/2006-10-MR2/dacapo-2006-10-MR2.jar -O $DACAPO_PATH/dacapo-2006-10-MR2.jar
+. $(dirname "$0")/common-binding-test.sh
 
 # Normal build
 $cur/ci-build.sh
+
 # Test
 $cur/ci-test-only-normal.sh
 $cur/ci-test-only-normal-no-compressed-oops.sh

diff --git a/.github/scripts/ci-test-minimal.sh b/.github/scripts/ci-test-minimal.sh
@@ -1,21 +1,10 @@
 set -ex
 
-. $(dirname "$0")/common.sh
-cur=$BINDING_PATH/.github/scripts
-
-# This script is only used by MMTk core.
-# OPENJDK_PATH is the default path set in ci-checkout.sh
-export OPENJDK_PATH=$BINDING_PATH/repos/openjdk
-export DEBUG_LEVEL=fastdebug
-export TEST_JAVA_BIN=$OPENJDK_PATH/build/linux-x86_64-normal-server-$DEBUG_LEVEL/jdk/bin/java
-
-# Download dacapo
-export DACAPO_PATH=$BINDING_PATH/dacapo
-mkdir -p $DACAPO_PATH
-wget https://downloads.sourceforge.net/project/dacapobench/archive/2006-10-MR2/dacapo-2006-10-MR2.jar -O $DACAPO_PATH/dacapo-2006-10-MR2.jar
+. $(dirname "$0")/common-binding-test.sh
 
 # Normal build
 $cur/ci-build.sh
+
 # Test
 MMTK_PLAN=SemiSpace runbms_dacapo2006_with_heap_multiplier fop 4
 MMTK_PLAN=Immix runbms_dacapo2006_with_heap_multiplier fop 4

diff --git a/.github/scripts/ci-test-only-normal-no-compressed-oops.sh b/.github/scripts/ci-test-only-normal-no-compressed-oops.sh
@@ -4,6 +4,10 @@ set -xe
 
 unset JAVA_TOOL_OPTIONS
 
+# This script runs against a specific pre-built java binary, not OpenJDK source code.
+ensure_env TEST_JAVA_BIN
+unset OPENJDK_PATH
+
 run_all_no_compressed_oop() {
     heap_multiplier=$1
 

diff --git a/.github/scripts/ci-test-only-normal.sh b/.github/scripts/ci-test-only-normal.sh
@@ -4,6 +4,10 @@ set -xe
 
 unset JAVA_TOOL_OPTIONS
 
+# This script runs against a specific pre-built java binary, not OpenJDK source code.
+ensure_env TEST_JAVA_BIN
+unset OPENJDK_PATH
+
 run_all() {
     heap_multiplier=$1
 

diff --git a/.github/scripts/ci-test-only-weak-ref.sh b/.github/scripts/ci-test-only-weak-ref.sh
@@ -3,7 +3,10 @@ set -xe
 . $(dirname "$0")/common.sh
 
 unset JAVA_TOOL_OPTIONS
-cd $OPENJDK_PATH
+
+# This script runs against a specific pre-built java binary, not OpenJDK source code.
+ensure_env TEST_JAVA_BIN
+unset OPENJDK_PATH
 
 export MMTK_NO_REFERENCE_TYPES=false
 # Just test Immix and MarkCompact

diff --git a/.github/scripts/common-binding-test.sh b/.github/scripts/common-binding-test.sh
@@ -0,0 +1,19 @@
+# This is the common part of binding tests (minimal and extended) invoked from mmtk-core.
+
+set -xe
+
+. $(dirname "$0")/common.sh
+cur=$BINDING_PATH/.github/scripts
+
+# Use fastdebug for binding tests
+export DEBUG_LEVEL=fastdebug
+
+# We build OpenJDK with the "default" target, and this is the location of the Java binary.
+# It's equivalent to invoking "make" without an explicit target, but it's better to be explicit.
+export OPENJDK_BUILD_TARGET=default
+export TEST_JAVA_BIN=$OPENJDK_PATH/build/linux-x86_64-server-$DEBUG_LEVEL/jdk/bin/java
+
+# Download dacapo
+export DACAPO_PATH=$BINDING_PATH/dacapo
+mkdir -p $DACAPO_PATH
+wget https://downloads.sourceforge.net/project/dacapobench/archive/2006-10-MR2/dacapo-2006-10-MR2.jar -O $DACAPO_PATH/dacapo-2006-10-MR2.jar
diff --git a/.github/scripts/common.sh b/.github/scripts/common.sh
@@ -1,6 +1,10 @@
 BINDING_PATH=$(realpath $(dirname "$0"))/../..
 RUSTUP_TOOLCHAIN=`cat $BINDING_PATH/mmtk/rust-toolchain`
 
+# build.yml specifies the OPENJDK_PATH env var when calling ci-build.sh
+# But other scripts expect a default path for OpenJDK.
+OPENJDK_PATH=${OPENJDK_PATH:="$BINDING_PATH/repos/jdk"}
+
 # dacapo2006 min heap for mark compact
 MINHEAP_ANTLR=5
 MINHEAP_FOP=13

diff --git a/.github/scripts/pgo-build.sh b/.github/scripts/pgo-build.sh
@@ -11,13 +11,13 @@ cargo clean
 popd
 
 # Compile with profiling support
-RUSTFLAGS="-Cprofile-generate=/tmp/$USER/pgo-data" make CONF=linux-x86_64-normal-server-release THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk images
+RUSTFLAGS="-Cprofile-generate=/tmp/$USER/pgo-data" make CONF=linux-x86_64-server-release THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk images
 
 # Remove extraneous profiling data
 rm -rf /tmp/$USER/pgo-data/*
 
 # Profile using fop
-MMTK_PLAN=GenImmix MMTK_STRESS_FACTOR=16777216 MMTK_PRECISE_STRESS=false ./build/linux-x86_64-normal-server-release/images/jdk/bin/java -XX:MetaspaceSize=500M -XX:+DisableExplicitGC -XX:-TieredCompilation -Xcomp -XX:+UseThirdPartyHeap -Xms60M -Xmx60M -jar /usr/share/benchmarks/dacapo/dacapo-23.9-RC3-chopin.jar -n 5 fop
+MMTK_PLAN=GenImmix MMTK_STRESS_FACTOR=16777216 MMTK_PRECISE_STRESS=false ./build/linux-x86_64-server-release/images/jdk/bin/java -XX:MetaspaceSize=500M -XX:+DisableExplicitGC -XX:-TieredCompilation -Xcomp -XX:+UseThirdPartyHeap -Xms60M -Xmx60M -jar /usr/share/benchmarks/dacapo/dacapo-23.9-RC3-chopin.jar -n 5 fop
 
 # Merge profiling data
 /opt/rust/toolchains/1.71.1-x86_64-unknown-linux-gnu/lib/rustlib/x86_64-unknown-linux-gnu/bin/llvm-profdata merge -o /tmp/$USER/pgo-data/merged.profdata /tmp/$USER/pgo-data
@@ -27,4 +27,4 @@ cargo clean
 popd
 
 # Compile using profiling data
-RUSTFLAGS="-Cprofile-use=/tmp/$USER/pgo-data/merged.profdata -Cllvm-args=-pgo-warn-missing-function" make CONF=linux-x86_64-normal-server-release THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk images
+RUSTFLAGS="-Cprofile-use=/tmp/$USER/pgo-data/merged.profdata -Cllvm-args=-pgo-warn-missing-function" make CONF=linux-x86_64-server-release THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk images
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -20,24 +20,19 @@ jobs:
   build-linux-x64:
     name: linux-x64
     runs-on: ubuntu-22.04
+    env:
+      # This overrides OPENJDK_PATH in ci-common.sh
+      # Note: We cannot use default environment variables (GITHUB_*) in the "env" context.  Use github.* instead.
+      # See: https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/store-information-in-variables#default-environment-variables
+      OPENJDK_PATH: ${{ github.workspace }}/git/openjdk
     steps:
     - name: Checkout MMTk OpenJDK binding
       uses: actions/checkout@v4
       with:
         path: ./git/mmtk-openjdk
-    - name: Extract OpenJDK revision
-      id: extract-openjdk-revision
-      run: |
-        OPENJDK_VERSION=`sed -n 's/^openjdk_version.=."\(.*\)"$/\1/p' < git/mmtk-openjdk/mmtk/Cargo.toml`
-        echo "openjdk-revision=$OPENJDK_VERSION" >> $GITHUB_OUTPUT
     - name: Checkout OpenJDK
-      uses: actions/checkout@v4
-      with:
-        repository: mmtk/openjdk
-        path: ./git/openjdk
-        ref: ${{ steps.extract-openjdk-revision.outputs.openjdk-revision }}
-    # Patch mmtk-core version if needed
-    - name: Patch mmtk-core version
+      run: ./git/mmtk-openjdk/.github/scripts/ci-checkout.sh
+    - name: Patch mmtk-core version if needed
       if: ${{ inputs.mmtk-core-repo != '' || inputs.mmtk-core-ref != '' }}
       run: |
         pip3 install tomlkit
@@ -60,14 +55,16 @@ jobs:
           echo "BUILD_SUFFIX=$escaped_build" >> $GITHUB_ENV
         fi
     - name: Build MMTk OpenJDK ${{ inputs.debug-level }}
-      run: |
-        OPENJDK_PATH=$GITHUB_WORKSPACE/git/openjdk DEBUG_LEVEL=${{ inputs.debug-level }} OPENJDK_BUILD_TARGET=product-bundles ./.github/scripts/ci-build.sh
+      env:
+        DEBUG_LEVEL: ${{ inputs.debug-level }}
+        OPENJDK_BUILD_TARGET: product-bundles
+      run: ./.github/scripts/ci-build.sh
       working-directory: ./git/mmtk-openjdk
     - name: Upload bundles
       uses: actions/upload-artifact@v4
       with:
         name: linux-x86_64-server-${{ inputs.debug-level }}-bundles-${{ env.BUILD_SUFFIX }}
         path: |
-          ./git/openjdk/build/linux-x86_64-normal-server-${{ inputs.debug-level }}/bundles/*_bin.tar.gz
-          ./git/openjdk/build/linux-x86_64-normal-server-${{ inputs.debug-level }}/bundles/*_bin-debug.tar.gz
+          ./git/openjdk/build/linux-x86_64-server-${{ inputs.debug-level }}/bundles/*_bin.tar.gz
+          ./git/openjdk/build/linux-x86_64-server-${{ inputs.debug-level }}/bundles/*_bin-debug.tar.gz
         retention-days: 2
diff --git a/.github/workflows/run-dacapo-chopin.yml b/.github/workflows/run-dacapo-chopin.yml
@@ -4,9 +4,9 @@ on:
   workflow_call:
 
 env:
-  DACAPO_VERSION: dacapo-23.9-RC3-chopin
-  DACAPO_FILE: dacapo-23.9-RC3-chopin.zip
-  DACAPO_DOWNLOAD_URL: https://download.dacapobench.org/chopin/dacapo-23.9-RC3-chopin.zip
+  DACAPO_VERSION: dacapo-23.11-MR2-chopin
+  DACAPO_FILE: dacapo-23.11-MR2-chopin.zip
+  DACAPO_DOWNLOAD_URL: https://download.dacapobench.org/chopin/dacapo-23.11-MR2-chopin.zip
 
 jobs:
   cache-dacapo:

diff --git a/README.md b/README.md
@@ -56,7 +56,7 @@ You would need our OpenJDK fork which includes the support for a third party hea
 
 Assuming your current working directory is the parent folder of `mmtk-openjdk`, you can checkout out OpenJDK and the correct version using:
 ```console
-$ git clone https://github.com/mmtk/openjdk.git
+$ git clone https://github.com/mmtk/jdk.git
 $ git -C openjdk checkout `sed -n 's/^openjdk_version.=."\(.*\)"$/\1/p' < mmtk-openjdk/mmtk/Cargo.toml`
 ```
 
@@ -113,17 +113,17 @@ $ sh configure --disable-warnings-as-errors --with-debug-level=$DEBUG_LEVEL
 Then build OpenJDK (this will build MMTk as well):
 
 ```console
-$ make CONF=linux-x86_64-normal-server-release THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk images
+$ make CONF=linux-x86_64-server-release THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk images
 ```
 
-The output jdk is then found at `./build/linux-x86_64-normal-server-release/images/jdk`.
+The output jdk is then found at `./build/linux-x86_64-server-release/images/jdk`.
 
 > **Note:** The above `make` command will build the `images` target, which is a proper release build of OpenJDK. It is **essential** that you use this target if you are planning on evaluating your build (e.g. measuring performance, gathering minimum heap values, etc). However, if you are simply developing and building incremental changes often, you may want to use the [`default` target or "exploded image"](https://github.com/openjdk/jdk11u/blob/master/doc/building.md#Running-make), which has a marginally shorter build time. However, be wary, as the exploded image is the (roughly) minimal set of outputs required to run the built JDK and is not guaranteed to run all benchmarks. It may have bloated minimum heap values as well.
 > 
-> The exploded image can be built as follows. The output jdk can be found at `./build/linux-x86_64-normal-server-$DEBUG_LEVEL/jdk`.
+> The exploded image can be built as follows. The output jdk can be found at `./build/linux-x86_64-server-$DEBUG_LEVEL/jdk`.
 >
 > ```console
-> $ make CONF=linux-x86_64-normal-server-$DEBUG_LEVEL THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk
+> $ make CONF=linux-x86_64-server-$DEBUG_LEVEL THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk
 > ```
 >
 > Again: **do not use the exploded image for performance analysis**.
@@ -151,7 +151,7 @@ stress factor of 4 MB in order to trigger more GC events.
 First we compile MMTk with profiling support:
 
 ```console
-$ RUSTFLAGS="-Cprofile-generate=/tmp/$USER/pgo-data" make CONF=linux-x86_64-normal-server-release THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk images
+$ RUSTFLAGS="-Cprofile-generate=/tmp/$USER/pgo-data" make CONF=linux-x86_64-server-release THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk images
 $ rm -rf /tmp/$USER/pgo-data/*
 ```
 We clear the `/tmp/$USER/pgo-data` directory as during compilation, the JVM we
@@ -162,7 +162,7 @@ We then run `fop` in order to get some profiling data. Note that your location
 for the DaCapo benchmarks may be different:
 
 ```bash
-MMTK_PLAN=GenImmix MMTK_STRESS_FACTOR=4194304 MMTK_PRECISE_STRESS=false ./build/linux-x86_64-normal-server-release/images/jdk/bin/java -XX:MetaspaceSize=500M -XX:+DisableExplicitGC -XX:-TieredCompilation -Xcomp -XX:+UseThirdPartyHeap -Xms60M -Xmx60M -jar /usr/share/benchmarks/dacapo/dacapo-evaluation-git-6e411f33.jar -n 5 fop
+MMTK_PLAN=GenImmix MMTK_STRESS_FACTOR=4194304 MMTK_PRECISE_STRESS=false ./build/linux-x86_64-server-release/images/jdk/bin/java -XX:MetaspaceSize=500M -XX:+DisableExplicitGC -XX:-TieredCompilation -Xcomp -XX:+UseThirdPartyHeap -Xms60M -Xmx60M -jar /usr/share/benchmarks/dacapo/dacapo-evaluation-git-6e411f33.jar -n 5 fop
 ```
 
 We have to merge the profiling data into something we can feed into the Rust
@@ -179,11 +179,11 @@ your Rust version.*
 Finally, we build a new image using the profiling data as an input:
 
 ```console
-$ RUSTFLAGS="-Cprofile-use=/tmp/$USER/pgo-data/merged.profdata -Cllvm-args=-pgo-warn-missing-function" make CONF=linux-x86_64-normal-server-release THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk images
+$ RUSTFLAGS="-Cprofile-use=/tmp/$USER/pgo-data/merged.profdata -Cllvm-args=-pgo-warn-missing-function" make CONF=linux-x86_64-server-release THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk images
 ```
 
 We now have an OpenJDK build under
-`./build/linux-x86_64-normal-server-release/images/jdk` with MMTk that has been
+`./build/linux-x86_64-server-release/images/jdk` with MMTk that has been
 optimized using PGO.
 
 For ease of use, we have provided an example script which does the above in
@@ -197,7 +197,7 @@ metadata), but by setting the environment variable `MMTK_MARK_IN_HEADER=1` while
 building OpenJDK, we can change its location to be in the object's header:
 
 ```console
-$ MMTK_MARK_IN_HEADER=1 make CONF=linux-x86_64-normal-server-$DEBUG_LEVEL THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk
+$ MMTK_MARK_IN_HEADER=1 make CONF=linux-x86_64-server-$DEBUG_LEVEL THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk
 ```
 
 ### Valid object bit
@@ -207,7 +207,7 @@ environment variable `MMTK_VO_BIT=1` when building OpenJDK. This will set the fe
 for mmtk-core, as well as compiling the fastpath for the VO bit.
 
 ```console
-$ MMTK_VO_BIT=1 make CONF=linux-x86_64-normal-server-$DEBUG_LEVEL THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk
+$ MMTK_VO_BIT=1 make CONF=linux-x86_64-server-$DEBUG_LEVEL THIRD_PARTY_HEAP=$PWD/../mmtk-openjdk/openjdk
 ```
 
 ## Test
@@ -221,8 +221,8 @@ class HelloWorld {
         System.out.println("Hello World!");
     }
 }
-$ ./build/linux-x86_64-normal-server-$DEBUG_LEVEL/jdk/bin/javac HelloWorld.java
-$ ./build/linux-x86_64-normal-server-$DEBUG_LEVEL/jdk/bin/java HelloWorld
+$ ./build/linux-x86_64-server-$DEBUG_LEVEL/jdk/bin/javac HelloWorld.java
+$ ./build/linux-x86_64-server-$DEBUG_LEVEL/jdk/bin/java HelloWorld
 Hello World!
 ```
 
@@ -231,7 +231,7 @@ Hello World!
 Pass `-XX:+UseThirdPartyHeap` as java command line arguments to enable MMTk.
 
 ```
-$ ./build/linux-x86_64-normal-server-$DEBUG_LEVEL/jdk/bin/java -XX:+UseThirdPartyHeap HelloWorld
+$ ./build/linux-x86_64-server-$DEBUG_LEVEL/jdk/bin/java -XX:+UseThirdPartyHeap HelloWorld
 ```
 
 If `DEBUG_LEVEL` is `release`, you should just see
@@ -266,7 +266,7 @@ $ wget https://sourceforge.net/projects/dacapobench/files/9.12-bach-MR1/dacapo-9
 Run a DaCapo benchmark (e.g. `lusearch`):
 
 ```console
-$ ./build/linux-x86_64-normal-server-$DEBUG_LEVEL/jdk/bin/java -XX:+UseThirdPartyHeap -Xms512M -Xmx512M -jar ./dacapo-9.12-MR1-bach.jar lusearch
+$ ./build/linux-x86_64-server-$DEBUG_LEVEL/jdk/bin/java -XX:+UseThirdPartyHeap -Xms512M -Xmx512M -jar ./dacapo-9.12-MR1-bach.jar lusearch
 Using scaled threading model. 24 processors detected, 24 threads used to drive the workload, in a possible range of [1,64]
 ===== DaCapo 9.12-MR1 lusearch starting =====
 4 query batches completed