Remoting WildFly Subsystem Configuration: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
No edit summary
 
(34 intermediate revisions by the same user not shown)
Line 1: Line 1:
=External=
* https://access.redhat.com/documentation/en-US/JBoss_Enterprise_Application_Platform/6.4/html/Administration_and_Configuration_Guide/sect-Remoting.html#Configure_the_Remoting_Subsystem
=Internal=
=Internal=


* [[WildFly Configuration#Subjects|WildFly Configuration]]
* [[WildFly Configuration#Subjects|WildFly Configuration]]
* [[Remoting WildFly Subsystem#Subjects|Remoting Subsystem]]


=Overview=
=Overview=
The default port the remoting connector listens on is 4447.
==EAP7, WildFly 9==
<pre>
<subsystem xmlns="urn:jboss:domain:remoting:3.0">
    <endpoint worker="default"/>
    <http-connector name="http-remoting-connector" connector-ref="default" security-realm="ApplicationRealm"/>
</subsystem>
</pre>
==EAP 6.4==


<pre>
<pre>
        <subsystem xmlns="urn:jboss:domain:remoting:3.0">
<subsystem xmlns="urn:jboss:domain:remoting:1.2">
            <endpoint/>
    <connector name="remoting-connector" socket-binding="remoting" security-realm="ApplicationRealm"/>
            <http-connector name="http-remoting-connector" connector-ref="default" security-realm="ApplicationRealm"/>
</subsystem>
        </subsystem>
 
<socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:0}">
    ...
    <socket-binding name="remoting" port="4447"/>
    ...
</socket-binding-group>
</pre>
</pre>
=Schema=
<blockquote style="background-color: AliceBlue; border: solid thin LightSteelBlue;">
:<br>https://github.com/wildfly/?<br><br>
</blockquote>
<font color=red>TODO: Link to .xsd.</font>


=Configuration Elements=
=Configuration Elements=


==endpoint==
==<tt><worker-thread-pool></tt>==
 
<pre>
<subsystem xmlns="urn:jboss:domain:remoting:1.1">
    <worker-thread-pool read-threads="1" task-keepalive="60" task-max-threads="16" task-core-thread="4" task-limit="16384" write-threads="1" />
    ...
</subsystem>
</pre>
 
For more details on the remoting worker thread pool see [[Remoting WildFly Subsystem Concepts#Threading_Model|Remoting Threading Model]].
 
==<tt><endpoint></tt>==
 
The Remoting endpoint uses the XNIO Worker declared and configured by the [[io WildFly Subsystem|io subsystem]]. The XNIO worker's configuration is described here: [[io WildFly Subsystem Configuration|io subsystem worker configuration]].
 
==<tt><connector></tt>==
 
===<tt>name</tt>===
 
===<tt>socket-binding</tt>===
 
===<tt>security-realm</tt>===
 
The presence of the '<tt>security-realm</tt>' attribute in the remoting connector configuration triggers enabling of authentication within the remoting service. For more details about remoting security see [[Remoting_WildFly_Subsystem_Concepts#Security|Remoting Subsystem Concepts - Security]].
 
==<tt><http-connector></tt>==
 
The <tt>connector-ref</tt> is the name of the [[Undertow WildFly Subsystem Configuration#http-listener|Undertow <tt>http-listener</tt>]], so if the name of that connector changes, the Remoting reference should also change.
 
=Disabling Remoting Authentication=
 
EAP 6.4
 
Remove "security-realm" configuration attribute from the connector configuration element.


==http-connector==
=Configuring Remoting Subsystem to Support Deployed EJB Client Contexts=


The <tt>connector-ref</tt> is the name of the [[Undertow WildFly Subsystem Configuration#http-listener|Undertow HTTP Listener]], so if the name of that connector changes, the Remoting reference should also change.
{{Internal|JBoss_Instance_Configuration_to_Support_Deployed_EJB_Client_Contexts#Remoting_Subsystem_Configuration|JBoss Instance Configuration to Support Deployed EJB Client Contexts}}

Latest revision as of 20:31, 24 March 2017

External

Internal

Overview

The default port the remoting connector listens on is 4447.

EAP7, WildFly 9

<subsystem xmlns="urn:jboss:domain:remoting:3.0">
    <endpoint worker="default"/>
    <http-connector name="http-remoting-connector" connector-ref="default" security-realm="ApplicationRealm"/>
</subsystem>

EAP 6.4

<subsystem xmlns="urn:jboss:domain:remoting:1.2">
    <connector name="remoting-connector" socket-binding="remoting" security-realm="ApplicationRealm"/>
</subsystem>

<socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:0}">
    ...
    <socket-binding name="remoting" port="4447"/>
    ...
</socket-binding-group>

Schema


https://github.com/wildfly/?

TODO: Link to .xsd.

Configuration Elements

<worker-thread-pool>

<subsystem xmlns="urn:jboss:domain:remoting:1.1">
    <worker-thread-pool read-threads="1" task-keepalive="60" task-max-threads="16" task-core-thread="4" task-limit="16384" write-threads="1" />
    ...
</subsystem>

For more details on the remoting worker thread pool see Remoting Threading Model.

<endpoint>

The Remoting endpoint uses the XNIO Worker declared and configured by the io subsystem. The XNIO worker's configuration is described here: io subsystem worker configuration.

<connector>

name

socket-binding

security-realm

The presence of the 'security-realm' attribute in the remoting connector configuration triggers enabling of authentication within the remoting service. For more details about remoting security see Remoting Subsystem Concepts - Security.

<http-connector>

The connector-ref is the name of the Undertow http-listener, so if the name of that connector changes, the Remoting reference should also change.

Disabling Remoting Authentication

EAP 6.4

Remove "security-realm" configuration attribute from the connector configuration element.

Configuring Remoting Subsystem to Support Deployed EJB Client Contexts

JBoss Instance Configuration to Support Deployed EJB Client Contexts