ProxyPLC4XConnectionPool

Description:

Common service to maintain a set of communication channels to an industrial PLC device. Provides easy configuration of PLC4X Proxy connection, which enables connecting to PLC devices using a jump host.

Additional Details...

Tags:

plc4x, service, proxy

Properties:

In the list below, the names of required properties appear in bold. Any other properties (not in bold) are considered optional. The table also indicates any default values.

Display NameAPI NameDefault ValueAllowable ValuesDescription
PLC4X Proxy Hostplc4x-proxy-hostIP address or hostname of the server, which hosts the PLC4X Proxy application.
PLC4X Proxy Portplc4x-proxy-portPort number of the PLC4X Proxy application.
Remote Protocol Coderemote-protocol-codeRemote protocol driver to be used, to create connections to the PLC device.
Remote Transport Coderemote-transport-codeRemote transport driver to be used, to create connections to the PLC device. If unset, the protocol driver's default transport will be used.
Remote Transport Locationremote-transport-locationLocation or address of the PLC device. This is sometimes an IP:port kind of address, sometimes a file path, sometimes a hardware port name. Please check the transport driver's documentation for details. If you wish, you can enter the full connection URI here.
Authentication Strategyauthentication-strategyNo Authentication
  • No Authentication Do not use out-of-band authentication when connecting to the PLC device. This setting must also be used in cases, when the driver expects authentication credentials as connection parameters (ie. in the connection string).
  • Password Authentication Authenticate with a pair of username and password kind of credentials.
Strategy to be used during out-of-band authentication. Only effective for a limited set of drivers, as some of them require authentication data to be specified as connection parameters. Please check the driver documentation.
UsernameusernameUsername to be used during authentication with the PLC device.

This Property is only considered if the [Authentication Strategy] Property has a value of "Password Authentication".
PasswordpasswordPassword to be used during authentication with the PLC device. Leave it blank, if the user has no password.
Sensitive Property: true

This Property is only considered if the [Authentication Strategy] Property has a value of "Password Authentication".
Max Wait Timemax-wait-time15 secondsThe maximum amount of time, that the pool will wait before failing, when there are no available connections to be returned.
Max Total Connectionsmax-total-connections8The maximum number of active connections, that can be allocated from this pool at the same time. Unset it for no limit.
Time Between Eviction Runstime-between-eviction-runsThe number of milliseconds to sleep between runs of the idle connection eviction thread. When unset, idle connections will not be evicted.
Min Evictable Idle Timemin-evictable-idle-time30 minutesThe minimum amount of time, a connection may sit idle in the pool, before it is eligible for eviction.

This Property is only considered if the [Time Between Eviction Runs] Property has a value specified.

State management:

This component does not store state.

Restricted:

This component is not restricted.

System Resource Considerations:

None specified.