WildFly Full 26 Model Reference

  1. home
  2. subsystem=undertow
  3. configuration=handler
  4. reverse-proxy

A reverse proxy handler

Children (1)

  • host A host that the reverse proxy will forward requests to

Provided capabilities(1)

Attributes (8)

  • cached-connections-per-thread The number of connections that will be kept alive indefinitely
    • Attribute Value
    Default Value 5
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • connection-idle-timeout The amount of time a connection can be idle before it will be closed. Connections will not time out once the pool size is down to the configured minimum (as configured by cached-connections-per-thread)
    • Attribute Value
    Default Value 60000
    Type INT
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • connections-per-thread The number of connections that will be maintained to backend servers, per IO thread.
    • Attribute Value
    Default Value 40
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • max-request-time The maximum time that a proxy request can be active for, before being killed
    • Attribute Value
    Default Value -1
    Type INT
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • max-retries The number of times to attempt to retry a request if it fails. Note that if a request is not considered idempotent then it will only be retried if the proxy can be sure it was not sent to the backend server).
    • Attribute Value
    Default Value 1
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • problem-server-retry Time in seconds to wait before attempting to reconnect to a server that is down
    • Attribute Value
    Default Value 30
    Type INT
    Nillable true
    Expressions Allowed true
    Unit SECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • request-queue-size The number of requests that can be queued if the connection pool is full before requests are rejected with a 503
    • Attribute Value
    Default Value 10
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • session-cookie-names Comma separated list of session cookie names. Generally this will just be JSESSIONID.

Operations (2)

  • add Adds a reverse proxy handler
    Request Parameter Type Required Expressions Allowed Default value Description
    cached-connections-per-thread INT false true 5 The number of connections that will be kept alive indefinitely
    connection-idle-timeout INT false true 60000 The amount of time a connection can be idle before it will be closed. Connections will not time out once the pool size is down to the configured minimum (as configured by cached-connections-per-thread)
    connections-per-thread INT false true 40 The number of connections that will be maintained to backend servers, per IO thread.
    max-request-time INT false true -1 The maximum time that a proxy request can be active for, before being killed
    max-retries INT false true 1 The number of times to attempt to retry a request if it fails. Note that if a request is not considered idempotent then it will only be retried if the proxy can be sure it was not sent to the backend server).
    problem-server-retry INT false true 30 Time in seconds to wait before attempting to reconnect to a server that is down
    request-queue-size INT false true 10 The number of requests that can be queued if the connection pool is full before requests are rejected with a 503
    session-cookie-names STRING false true JSESSIONID Comma separated list of session cookie names. Generally this will just be JSESSIONID.
  • remove Removes a reverse proxy handler