doc/testing.md

rev 54452 : 8221894: Add notes for docker tests in the test doc
Reviewed-by: erikj, dholmes

*** 371,380 ****
--- 371,394 ----
  Additional VM arguments to provide to forked off VMs. Same as `-jvmArgs <args>`
  
  #### OPTIONS
  Additional arguments to send to JMH.
  
+ ## Notes for Specific Tests
+ 
+ ### Docker Tests
+ 
+ Docker tests with default parameters may fail on OS versions newer than oraclelinux 7.6.
+ For example, they pass on Ubuntu 16.04 but fail on Ubuntu 18.04 if run like this:
+ 
+     $ make test TEST="jtreg:test/hotspot/jtreg/runtime/containers/docker"
+ 
+ To run these tests correctly, additional parameters for the correct docker image are
+ required on Ubuntu 18.04 by using `JAVA_OPTIONS`.
+ 
+     $ make test TEST="jtreg:test/hotspot/jtreg/runtime/containers/docker" JTREG="JAVA_OPTIONS=-Djdk.test.docker.image.name=ubuntu -Djdk.test.docker.image.version=latest"
+ 
  ---
  # Override some definitions in the global css file that are not optimal for
  # this document.
  header-includes:
   - '<style type="text/css">pre, code, tt { color: #1d6ae5; }</style>'