Version

    Supported filesystems and protocols

    Local filesystem

    The user may specify a path to the directory which the listener shall observe. The listener doesn't read the directory content recursively. The directory must exist.

    If the listener can run concurrently on more nodes, the directory must be shared among all these nodes and the directory must exist on all these nodes. In a Cluster environment, the directory must exist on each Cluster node where the listener may run.

    It is recommended to use placeholders to unify the configuration on all nodes. The recommended placeholders are: CloverDX Server config property ${sandboxes.home} and JVM system property ${java.io.tmpdir}. It is possible to use any JVM system property or Environment variable.

    File available on local file system

    Figure 38.7. File available on local file system


    Remote filesystem

    The user may specify a URL to the directory which the listener shall observe. The supported protocols are: FTP, S3, SFTP and SMB. Different protocols may use different authentication methods: none, username+password and keystore. The listener doesn't read the directory content recursively. The directory must exist.

    File available on remote location

    Figure 38.8. File available on remote location


    Currently the subset of the protocols allowed by file-operations is supported:

    • FTP - File Transfer Protocol (no authentication or username + password authentication) URL example:

      ftp://host:23/observed/path/
    • SFTP (SSH/FTP) - SSH File Transfer Protocol (username + password authentication) URL example:

      sftp://host:23/observed/path/

      It is recommended to use placeholders to unify the path configuration on all nodes. The recommended placeholders are: CloverDX Server config property ${sandboxes.home}, JVM system property ${user.home}. It is possible to use any JVM system property or Environment variable.

    • S3 - Amazon S3 Storage (AWS Access Key ID + Secret Access Key authentication) URL example:

      s3://s3.amazonaws.com/bucketname/path/

      Please specify the AWS Access Key ID as a username and Secret Access Key as a password.

    • Microsoft SMB/CIFS Protocol (username + password authentication) URL example:

      smb://host/path/
    • Microsoft SMBv2/v3 Protocol (username + password authentication) URL example:

      smb2://host/path/