GenericPLC4XConnectionPool

Description:

Common service to maintain a set of communication channels to an industrial PLC device. Includes no drivers, user needs to supply their own set, via the respective configuration options.

Additional Details...

Tags:

plc4x, service, generic, custom, driver

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, and whether a property supports the NiFi Expression Language.

Display NameAPI NameDefault ValueAllowable ValuesDescription
Drivers Location(s)drivers-locationsComma-separated list of files/folders and/or URLs containing the driver JAR, and its dependencies (if any). For example '/var/tmp/plc4j-driver-example-0.10.0.jar'

This property expects a comma-separated list of resources. Each of the resources may be of any of the following types: directory, file, URL.

Supports Expression Language: true (will be evaluated using Environment variables only)
Protocol Codeprotocol-codeProtocol driver to be used, to create connections to the PLC device. Not necessary to set, if there is only one protocol driver in the classpath.
Transport Codetransport-codeTransport driver to be used, to create connections to the PLC device. If unset, the protocol driver's default transport will be used.
Transport Locationtransport-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.