Skip to content

CAUTION: This site hosts draft documentation for the next release. For published content of the latest release, visit


(Linux® x86, Linux on POWER® (Little Endian), Linux on AArch64, and Linux on IBM Z® only)

This option specifies whether the VM ignores any unrecognized options at the time of restore.

Restrictions: This option takes effect only when -XX:+EnableCRIUSupport is enabled. This option can be used only on restore.


Setting Effect Default
-XX:+IgnoreUnrecognizedRestoreOptions Enable
-XX:-IgnoreUnrecognizedRestoreOptions Disable yes


When you restore a checkpoint image, you can specify additional command-line options by using the CRIUSupport.registerRestoreOptionsFile API. You can also use the OPENJ9_RESTORE_JAVA_OPTIONS environment variable (CRIUSupport.registerRestoreEnvVariables API) to add the VM options on restore. If you specify options that do not exist, or are unsupported, the VM, by default, fails to start and throws a JVMRestoreException error. The -XX:+IgnoreUnrecognizedRestoreOptions option disables the failure and allows the VM to continue even if some options are not used.

See also