Container server reconnect properties

If a container server becomes disconnected from the data grid, WebSphere® eXtreme Scale attempts to reconnect those container servers. By setting system properties, you can control how the container reconnects. You can set these properties when you start a container server. Some properties are applicable to WebSphere eXtreme Scale in a stand-alone environment, while others are only applicable in an integrated WebSphere Application Server environment. For example, when a container server is started in a stand-alone environment, you can set these properties as an option from a command console:

startOgServer.sh server01 -objectgridFile objectgrid.xml -deploymentPolicyFile deployment.xml -Dcom.ibm.websphere.objectgrid.container.reconnect.restart=false

startXsServer.sh server01 -objectgridFile objectgrid.xml -deploymentPolicyFile deployment.xml -Dcom.ibm.websphere.objectgrid.container.reconnect.restart=false

For more information, see Starting and stopping stand-alone servers. If you want to set the appropriate property for WebSphere eXtreme Scale for WebSphere Application Server, you can use the WebSphere Integrated Solutions Console tool. This tool is a graphical user interface that is accessible from the WebSphere Application Server environment, and is installed as an extension to the WebSphere ISC.

com.ibm.websphere.objectgrid.container.reconnect.block.reconnect.time

Defines the amount of time (in milliseconds) to block another container reconnect call. Only valid when a container server is started for the product offering:WebSphere eXtreme Scale for WebSphere Application Server.

Default: 30000 milliseconds

com.ibm.websphere.objectgrid.container.reconnect.min.successful.heartbeats

Defines the minimum number of successful heartbeats before a container can be stopped. Only valid when a container server is started for the product offering: WebSphere eXtreme Scale for WebSphere Application Server.

Default: 10

com.ibm.websphere.objectgrid.container.reconnect.restart

Defines whether container reconnect can restart the JVM. Only valid when a container server is started for WebSphere eXtreme Scale in a stand-alone environment.

Default: true

com.ibm.websphere.objectgrid.container.reconnect.restart.command

Defines the command that is used to restart the container. This command overrides the dynamically generated command if this property is not specified. Each argument in the command is delimited by the value that is defined in the property 'com.ibm.websphere.objectgrid.container.reconnect.restart.delimiter'. Only for use with OSGi container servers. The following is an example of a valid command that uses the ',' as a delimiter.

Default: " " An empty string identifies not to restart a container server on OSGi.

Example: /usr/bin/java,-Dprop=value,SomeClass,arg1,arg2

You must specify this property if you want OSGi containers to restart when the conditions for container restart be met. Otherwise, the container server is stopped and the JVM continues to run, including any other OSGi services within that JVM.

com.ibm.websphere.objectgrid.container.reconnect.restart.delimiter

Defines the delimiter that is used for tokenizing the command that is specified in the property 'com.ibm.websphere.objectgrid.container.reconnect.restart.command'. A blank space is not to be used as a delimiter as parsing issues can result. Only for use with OSGi container servers.

Default: "," A comma is the default delimiter.

com.ibm.websphere.objectgrid.container.reconnect.restart.delay

Defines the time (in milliseconds) to delay before you proceed with the startup on the newly created child container when the JVM is restarted. Only valid when a container server is started for the product offering: WebSphere eXtreme Scale in a stand-alone environment.

Default: 2000 milliseconds

com.ibm.websphere.objectgrid.container.reconnect.restart.parent.timeout

Defines the time (in milliseconds) for the newly created child container to wait for its parent to disconnect before timing out when the JVM is restarted. Only valid when a container server is started for the product offering: WebSphere eXtreme Scale in a stand-alone environment.

Default: 180000 milliseconds

com.ibm.websphere.objectgrid.container.reconnect.retry.forever

Defines whether the container attempts to reconnect to the container server forever. Only valid when a container server is started for the product offering:WebSphere eXtreme Scale for WebSphere Application Server.

Default: false