WildFly System Properties: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
No edit summary
Line 3: Line 3:
* [[WildFly#Subjects|WildFly]]
* [[WildFly#Subjects|WildFly]]


=jboss.qualified.host.name=
=System Properties in WildFly Configuration Files=
 
System property references can be specified in such a way that a default value is provided. The default value is provided if the system property is not defined.
 
<pre>
  ...
  <backup>${jboss.messaging.hornetq.backup:false}</backup>
  ...
</pre>
 
=Standard System Properties=
 
==jboss.qualified.host.name==


Relevance: WildFly 9
Relevance: WildFly 9
Line 11: Line 23:
The value of the first segment of this system property will override the <tt><host></tt> element <tt>name</tt> attribute in <tt>host.xml</tt>. For more details see [[host.xml#Host_Name|host.xml <host> name]].
The value of the first segment of this system property will override the <tt><host></tt> element <tt>name</tt> attribute in <tt>host.xml</tt>. For more details see [[host.xml#Host_Name|host.xml <host> name]].


=jboss.host.name=
==jboss.host.name==


Relevance: WildFly 9
Relevance: WildFly 9
Line 19: Line 31:
The value of this system property will override the <tt><host></tt> element <tt>name</tt> attribute in <tt>host.xml</tt>. For more details see [[host.xml#Host_Name|host.xml <host> name]].
The value of this system property will override the <tt><host></tt> element <tt>name</tt> attribute in <tt>host.xml</tt>. For more details see [[host.xml#Host_Name|host.xml <host> name]].


=jboss.server.name=
==jboss.server.name==


Relevance: WildFly 9
Relevance: WildFly 9
Line 25: Line 37:
For a host named "ap1.modcluster.local" it is set to "ap1"
For a host named "ap1.modcluster.local" it is set to "ap1"


=jboss.node.name=
==jboss.node.name==


Relevance: WildFly 9
Relevance: WildFly 9


jboss.node.name
 


Set externally with <tt>-Djboss.node.name</tt> in the startup script.
Set externally with <tt>-Djboss.node.name</tt> in the startup script.
Line 39: Line 51:
* [[WildFly_Transaction_Subsystem_Configuration#Set_Unique_Node_Identifier|Transaction Subsystem Configuration - Unique Node Identifier]]
* [[WildFly_Transaction_Subsystem_Configuration#Set_Unique_Node_Identifier|Transaction Subsystem Configuration - Unique Node Identifier]]


=jboss.server.config.dir=
==jboss.server.config.dir==


Used by:
Used by:
* [[WildFly Management API Configuration#Management_Realm_Configuration_Files|Management API Configuration]]
* [[WildFly Management API Configuration#Management_Realm_Configuration_Files|Management API Configuration]]


=jboss.bind.address=
==jboss.bind.address==


Represents the value of the instance's public interface. The default value is 127.0.0.1.
Represents the value of the instance's public interface. The default value is 127.0.0.1.


==jboss.bind.address for Standalone Node==
===jboss.bind.address for Standalone Node===


One common method of externalizing this operationally is to define it as a system property at the bottom of <tt>$JBOSS_HOME/bin/standalone.conf</tt>:
One common method of externalizing this operationally is to define it as a system property at the bottom of <tt>$JBOSS_HOME/bin/standalone.conf</tt>:
Line 63: Line 75:
</pre>
</pre>


==jboss.bind.address for Host Controller==
===jboss.bind.address for Host Controller===


One common method to externalize the value operationally for host controllers is to define it as a system property at the bottom of <tt>$JBOSS_HOME/bin/domain.conf</tt> as follows:
One common method to externalize the value operationally for host controllers is to define it as a system property at the bottom of <tt>$JBOSS_HOME/bin/domain.conf</tt> as follows:
Line 82: Line 94:
In consequence, servers bind their HTTP connectors to that address.
In consequence, servers bind their HTTP connectors to that address.


=jboss.bind.address.management=
==jboss.bind.address.management==


The value of the instance's management interface bind address. The default value is 127.0.0.1.
The value of the instance's management interface bind address. The default value is 127.0.0.1.


==jboss.bind.address.management for Standalone Node==
===jboss.bind.address.management for Standalone Node===


One common method of externalizing this operationally is to define it as a system property at the bottom of <tt>$JBOSS_HOME/bin/standalone.conf</tt>:
One common method of externalizing this operationally is to define it as a system property at the bottom of <tt>$JBOSS_HOME/bin/standalone.conf</tt>:
Line 101: Line 113:
</pre>
</pre>


==jboss.bind.address.management for Host and Domain Controller==
===jboss.bind.address.management for Host and Domain Controller===


One common method to externalize the value operationally for host and domain controllers is to define it as a system property at the bottom of <tt>$JBOSS_HOME/bin/domain.conf</tt> as follows:
One common method to externalize the value operationally for host and domain controllers is to define it as a system property at the bottom of <tt>$JBOSS_HOME/bin/domain.conf</tt> as follows:
Line 110: Line 122:
</pre>
</pre>


=jboss.bind.address.unsecure=
==jboss.bind.address.unsecure==


The value to bind the "unsecure" interface to. By default 127.0.0.1.
The value to bind the "unsecure" interface to. By default 127.0.0.1.


=jboss.domain.master.address=
==jboss.domain.master.address==


The hostname of the domain controller.
The hostname of the domain controller.
Line 124: Line 136:
</blockquote>
</blockquote>


=jboss.domain.master.port=
==jboss.domain.master.port==


The port of the domain controller process.
The port of the domain controller process.

Revision as of 16:43, 28 February 2016

Internal

System Properties in WildFly Configuration Files

System property references can be specified in such a way that a default value is provided. The default value is provided if the system property is not defined.

  ...
  <backup>${jboss.messaging.hornetq.backup:false}</backup>
  ...

Standard System Properties

jboss.qualified.host.name

Relevance: WildFly 9

For a host named "ap1.modcluster.local" it is set to "ap1.modcluster.local"

The value of the first segment of this system property will override the <host> element name attribute in host.xml. For more details see host.xml <host> name.

jboss.host.name

Relevance: WildFly 9

For a host named "ap1.modcluster.local" it is set to "ap1".

The value of this system property will override the <host> element name attribute in host.xml. For more details see host.xml <host> name.

jboss.server.name

Relevance: WildFly 9

For a host named "ap1.modcluster.local" it is set to "ap1"

jboss.node.name

Relevance: WildFly 9


Set externally with -Djboss.node.name in the startup script.

Related:

jboss.server.config.dir

Used by:

jboss.bind.address

Represents the value of the instance's public interface. The default value is 127.0.0.1.

jboss.bind.address for Standalone Node

One common method of externalizing this operationally is to define it as a system property at the bottom of $JBOSS_HOME/bin/standalone.conf:

...
JAVA_HOME="${JAVA_HOME} -Djboss.bind.address=192.168.1.15"

The same result can be achieved by specifying the system property as a -D argument for the start script:

./standalone.sh -Djboss.bind.address=192.168.1.10

jboss.bind.address for Host Controller

One common method to externalize the value operationally for host controllers is to define it as a system property at the bottom of $JBOSS_HOME/bin/domain.conf as follows:

...
HOST_CONTROLLER_JAVA_OPTS="${HOST_CONTROLLER_JAVA_OPTS} -Djboss.bind.address=1.2.3.4"

The value propagates as system property to the process controller, host controller and servers:

eap 13556 13457 java -D[Process Controller] ... -Djboss.bind.address=1.2.3.4 ...
eap 13595 13556 java -D[Host Controller] ... -Djboss.bind.address=1.2.3.4 ...
eap 13750 13556 /usr/lib/jvm/java-1.7.0-openjdk-1.7.0.79.x86_64/jre/bin/java -D[Server:ri2] ... -Djboss.bind.address=1.2.3.4 ...

In consequence, servers bind their HTTP connectors to that address.

jboss.bind.address.management

The value of the instance's management interface bind address. The default value is 127.0.0.1.

jboss.bind.address.management for Standalone Node

One common method of externalizing this operationally is to define it as a system property at the bottom of $JBOSS_HOME/bin/standalone.conf:

...
JAVA_HOME="${JAVA_HOME} -Djboss.bind.address.management=192.168.1.15"

The same result can be achieved by specifying the system property as a -D argument for the start script:

./standalone.sh -Djboss.bind.address.management=192.168.1.10

jboss.bind.address.management for Host and Domain Controller

One common method to externalize the value operationally for host and domain controllers is to define it as a system property at the bottom of $JBOSS_HOME/bin/domain.conf as follows:

...
HOST_CONTROLLER_JAVA_OPTS="${HOST_CONTROLLER_JAVA_OPTS} -Djboss.bind.address.management=1.2.3.4"

jboss.bind.address.unsecure

The value to bind the "unsecure" interface to. By default 127.0.0.1.

jboss.domain.master.address

The hostname of the domain controller.

It is actually not a good idea to externalize the master domain controller address as a system property. For more explanations see:

Subordinate Host Controller Post-Install

jboss.domain.master.port

The port of the domain controller process.