Modifying JVM Properties of a Host Through the CLI

    Procedure
  1. Navigate to admin sample folder of CONFIG_HOME or TIBCO_HOME.
  2. Add the details of the Host to be modified in host_data.xml.
  3. Add the attribute jvmArgs to the <Host> tag of host_data.xml. This attribute is case-sensitive. Provide all the JVM-specific or user-specific properties within quotes as shown in the below example.
  4. Add the attribute options="mergeJvmArgs" to the update target of host_build.xml to merge the specified JVM properties with the existing properties.

Example: Host_build.xml

<target name="update">
         <AMXAdminTask
            remote="true"
            propsFile="${instanceProperties}"
            action="edit"
            dataFile="${dataFile}"
            objectSelector="Host"
            overwrite="true"
            merge="true"
            createIfNotExists="true"
            force="true"
            options="mergeJvmArgs"
            failOnError="false"/>
</target>

Example: host_data.xml

<Host xsi:type="amxdata:Host"
         name="SecondHost"
         description="Description for SecondHost"
         hostType="TibcoHost"
         sourceHost="SystemHost"
         windowsService="true"
         jvmArgs="-Xmx512m -Xms128m -XX:+HeapDumpOnOutOfMemoryError -Dprop1=value1"
         managementUrl="service:jmx:jmxmp://localhost:36923" assignToEnvs="ALL">

Starting with ActiveMatrix Service Grid Hotfix 05, node JVM arguments can be merged using update target of node_build.xml file with the option mergeJvmArgs. If this option is provided JVM arguments in the data file are merged with the existing arguments and if option is not provided it replaces the provided arguments with existing arguments.

Procedure

  1. Navigate to admin sample folder of CONFIG_HOME or TIBCO_HOME.
  2. Add the details of the Node to be modified in node_data.xml.
  3. Add the attribute jvmArg to the <Node> tag of node_data.xml. This attribute is case-sensitive. Provide all the JVM-specific or user-specific properties within quotes as shown in the following example.
  4. Add the attribute options="mergeJvmArgs" to the update target of node_build.xml to merge the specified JVM properties with the existing properties.

Example: node_build.xml

<target name="update">
<AMXAdminTask
remote="true"
propsFile="${instanceProperties}"
action="edit"
dataFile="${dataFile}"
objectSelector="Environment/Node"
overwrite="true"
merge="false"
createIfNotExists="true"
force="true"
failOnError="false"
options="mergeJvmArgs"/>
</target>

Example: node_data.xml

<Node name="DevNode" 
description="Development node" 
contact="TIBCO Software Inc." 
hostName="SystemHost" 
portNumber="6038" 
jvmArg="-Dcom.tibco.soapbt.spline.soapfaulttransformer.suppressstacktraceinsoapfault=
true" startupMode="Automatic" nodeTypeVersion="3.4.3" xsi:type="typ:Node">