Java Virtual Machine Parameters

This topic describes variables that ReadyAPI passes to the Java virtual machine to prepare the environment.

-XX:MinHeapFreeRatio=<value>

Specifies the minimum percentage of free heap space after the garbage collector event to avoid shrinking.

Example:

-XX:MinHeapFreeRatio=20

-XX:MaxHeapFreeRatio=<value>

Specifies the maximum percentage of free heap space after the garbage collector event to avoid shrinking.

Example:

-XX:MaxHeapFreeRatio=40

-XX:MaxPermSize=<value>

Specifies the size of the permanent generation to avoid PermGen errors.

Append k or K to specify the value in kilobytes, and m or M to specify the value in megabytes.

Example:

-XX:MaxPermSize=256m

-Xms<value>

Specifies the initial size of the heap (memory) in bytes.

Append k or K to specify the value in kilobytes, and m or M to specify the value in megabytes.

Example:

-Xms128m

-Xmx<value>

Specifies the maximum size of the heap (memory) to be used in bytes. Default value: 4000m.

Append k or K to specify the value in kilobytes, and m or M to specify the value in megabytes.

Example:

-Xmx1000m

-Dmail.mime.parameters.strict=<value>

Allows/Disallows parameter values to contain whitespace and other special characters without being quoted. If set to true (the default), parameter values must conform to the MIME specification and be quoted if they contain whitespace or special characters.

Example:

-Dmail.mime.parameters.strict=false-Xmx1000m

-Djetty.header.size=<value>

Sets RequestHeaderSize and ResponseHeaderSize to a given value.

Example:

-Djetty.header.size=32768

-Dsoapui.properties=<value>

Specifies the file that contains global properties that correspond to the Preferences > Global Properties and Preferences > JDBC drivers.

Example:

-Dsoapui.properties=C:\Work\Properties.txt

-Dsoapui.ext.libraries=<value>

Specifies the path to the external .jar files that ReadyAPI should load (for example, JDBC drivers).

Example:

-Dsoapui.ext.libraries=C:\Program Files\SmartBear\ReadyAPI-2.x.x/bin/ext

-Dsoapui.ext.listeners=<value>

Specifies the location where the old-style plugin listeners are stored.

Example:

-Dsoapui.ext.listeners=C:\Program Files\SmartBear\ReadyAPI-2.x.x/bin/listeners

-Dsoapui.ext.actions=<value>

Specifies the location where the old-style plugin actions are stored.

Example:

-Dsoapui.ext.actions=C:\Program Files\SmartBear\ReadyAPI-2.x.x/bin/actions

-Dreadyapi.enable.ai.features=<value>

Controls whether SmartBear AI features appear in ReadyAPI.

ReadyAPI disables AI features in the UI by default. You can enable them in Preferences, under Integrations, by selecting the AI option.

If you deploy ReadyAPI as part of a managed image, use this parameter to disable AI at startup and remove AI options from the UI.

Example:

-Dreadyapi.enable.ai.features=false

-Dsoapui.ssl.keystore.location=<value>

The path to the keystore that ReadyAPI uses to connect to the server.

Notes:

-Dsoapui.ssl.keystore.password=<value>

The keystore password.

Notes:

-Dsoapui.send.zero.content.length=<value>

Removes the Content.Length: 0 header from the request.

Example:

-Dsoapui.send.zero.content.length=false

-Dsuppress.api.request.validation.message=<value>

Specifies whether to suppress the pop-up that appears when viewing encrypted request content in the Project save/load scripts. Setting the value to true suppresses the pop-up, allowing the encrypted content to remain intact; false displays the pop-up by default, potentially replacing the content with default values.

Example:

-Dsuppress.api.request.validation.message=true

-Dwsi.dir=<value>

Specifies the location of wsi-test-tools, if not the default.

Example:

-Dwsi.dir=C:\Program Files\
SmartBear\ReadyAPI-2.x.x/wsi-test-tools

-Dtest.history.disabled=<value>

Disables the test history in ReadyAPI Test. Same as the Test History disabled option.

Example:

-Dtest.history.disabled=true

-Dloadui.charts.maxpoints=<value>

Sets the maximum number of points to draw ReadyAPI charts on the Load and Statistics pages. When ReadyAPI reaches the specified number of points, it removes the oldest point from the memory, so the beginning of the charts is not drawn. See Memory Management.

-Dsoapui.mock.connector.headerBufferSize=<value>

Sets the Jetty connector properties.

Example:

-Dsoapui.mock.connector.headerBufferSize=8192

-Djavax.security.auth.useSubjectCredsOnly=<value>

Controls the process of getting credentials from a request. See SPNEGO/Kerberos Authentication.

Example:

-Djavax.security.auth.useSubjectCredsOnly=false

-Djava.security.auth.login.config=<value>

Specifies the path to the Kerberos configuration file. See SPNEGO/Kerberos Authentication.

Example:

-Djava.security.auth.login.config=C:/kerberos/login.conf

-Djava.security.krb5.conf=<value>

Specifies the path to the configuration file for the Kerberos login module. See SPNEGO/Kerberos Authentication.

Example:

-Djava.security.krb5.conf=C:/kerberos/krb5.conf

-Dhttpclient.spnego.usecanonicalname=<value> -Dhttpclient.kerberos.usecanonicalname=<value>

Specifies if SPNEGO/Kerberos should perform a reverse DNS lookup. See SPNEGO/Kerberos Authentication

Example:

-Dhttpclient.spnego.usecanonicalname=false

-DallowWeakCiphers=<value>

Controls whether ReadyAPI allows connections that use weak ciphers.

ReadyAPI 3.64.0 introduces strict enforcement against weak cipher usage. When this setting is active, ReadyAPI blocks connections from client endpoints that rely on weak ciphers. This includes environments such as SLM On-Premise when it is configured with HTTP and uses insufficiently secure cipher settings.

To restore behavior from earlier versions and allow weak ciphers, set this parameter to true in ReadyAPI.vmoptions.

Example:

-DallowWeakCiphers=true

-Dsun.java2d.dpiaware=<value>

Commands Windows to scale the application window. This can be useful for high-resolution monitors. If the value is true, the UI is scaled to fit the screen DPI. The default value is false.

Example:

-Dsun.java2d.dpiaware=true

-Djxbrowser.chromium.dir=<value>

Specifies the path to the folder where JxBrowser will write information.

Example:

-Djxbrowser.chromium.dir=C:\Work\JxBrowserFiles

-DupdatesCheckDisable=<value>

Disables automatic product updates, product update notifications, and the option to check for updates.

Example:

-DupdatesCheckDisable=true

-Ddisable.jxbrowser.basic.auth=<value>

Disables basic auth for Auth Profile verification.

Example:

-Ddisable.jxbrowser.basic.auth=true

-Dmax.virt.resultset.size

Sets the maximum number of rows in a JDBC virtual response. Default value: 10000.

-Doauth2.access.token.retrieval.timeout=<value>

Sets the timeout for automatic input of credentials when running the OAuth token retrieval script (in milliseconds). It can be useful if the process of getting a new access token takes more than 5 seconds. Default value: 5000.

-virtserver.oidc.login.timeout=value

Value to be added in milliseconds

Example:

-Dvirtserver.oidc.login.timeout=30000
for setting timeout as 30 seconds.