Configuring application.properties

Edit online

To configure property files that control system-wide Connect:Direct Web Services properties follow the steps given below:
  1. Navigate to the following directory:
    % cd $Installation_Directory/mftws/BOOT-INF/classes
  2. Modify application.properties and save after making necessary changes.
    Configuration Items Description
    accessKey.connectionTimeInactivityLimit Configure access token inactivity time in minutes

    Default: 60 min
    accessKey.connectionTimeMaxLimit Configure access token maximum timeout in minutes

    Default: 1440 min
    accessKey.maxConnectionNumber Configure maximum number of Connect:Direct node connections

    Default value is 100
    cdserver.http.enabled By default a HTTPS connection is enabled. Set this to TRUE to enable a HTTP connection.

    Default: False
    cdserver.http.port To configure HTTP Port

    Default: 9090
    certificate.finger.print A unique identifier to identify a certificate in a user-friendly manner.

    Default: null
    enable.certificate.based.authentication

    To enable or disable certificate based authentication from browser or rest client.

    To enable certificate based authentication set to true.

    To disable certificate based authentication set to false.

    Default: true

    Note: This property is available starting from Connect:Direct Web Services 6.3.0.9 release.
    server.ssl.enabled-protocols To enable TLS protocol. Possible values for protocols is TLSv1.2 and TLSv1.3

    Default: TLSv1.2
    server.ssl.key-alias Alias that identifies the key in the Keystore

    Default: ibmconnectdirectwebservices
    server.port Port on which Connect:Direct Web Services is running.

    Default value: 9443

    Default value: 1368 (for Integrated Web Services)

    This is a Web Server secure port.
    statistics.limit Maximum statistics records to be displayed.

    The default value is 50000. This value can be changed based on heap memory configuration.
    statistics.search.limit

    This property limits the number of transfer statistics results that are displayed in Web Console>Statistics view when a user applies any filters.

    Search limits improve overall server performance by limiting how many entries are returned when a user attempts a filtered search through the transfer statistics.

    This property is set to a default of 2000.
    thread.pool.max.size Defines the maximum tasks of threads that can ever be created.

    Default: 100
    thread.pool.core.size Minimum number of tasks to keep alive without timing out.

    Default: 100
    thread.pool.queue.size Number of tasks that are queued while all other threads are in use.

    Default: 100
    process.library.limit

    Limits the number of process library records fetched from Connect:Direct node.

    If process.library.limit is not defined, then default 50 records are fetched for REST API response.

    Default: 50
    watch.directory.limit

    Limits the number of watch directories fetched from Connect:Direct File Agent.

    If watch.directory.limit is not defined, then default 500 watch directories records are fetched.

    Default: 500

    lockout.time

    Lockout time for Admin/CD user in seconds.

    Default- 180

    lockout.maxAttempt

    Maximum attempt before lockout for Admin/CD user.

    Default- 3

    max.locked.users

    CDWS Login will be blocked once the following number of users have been locked out.

    Default- 100

    invalidate.first.login.failure.after

    Consider login attempt as first, once following seconds has passed since last attempt

    Default- 180

    server.ssl.ciphers-include

    Overwrites the default CipherSuites list

    Accepts a comma separated list

    The default Cipher Suites are:
    • TLS_AES_256_GCM_SHA384TLS_AES_128_GCM_SHA256
    • SSL_ECDHE_RSA_WITH_AES_256_GCM_SHA384
    • SSL_ECDHE_RSA_WITH_AES_128_GCM_SHA256

    server.ssl.ciphers-exclude

    Exclude list of Cipher Suites. Accepts a comma separated list.
    control.center.url To configure IBM® Connect:Direct® Web Service to communicate with Control Center HTTP Server running on a given port.
    Note: For a secure HTTPS connection, user must add appropriate certificates in IBM Connect:Direct Web Service's truststore.
    enable.control.center To enable/disable the Control Center, boolean can be used. Set this to TRUE to enable this feature.
    Note: This switch takes the highest precedence. The Control Center enable/disable switch present at IBM Connect:Direct Web Service-UI shall not work if this is disabled.
    Attention: Users cannot change the Web Services IP Address unlike server.port.
    Note: Users can also edit application.properties and .hidden file from User Interface (UI). To do this, log in with the admin function and the files can be modified under the Configuration tab.
  3. Issue the following commands depending on environment type.
    • In Windows environment, stop and start MFTWebservices from Task manager for changes to take effect.
    • In UNIX environment, issue the following command to stop and start MFTWebServices:
    % ./$CDWS_INSTALLATION_DIR$/bin/stopWebservice.sh
                            % ./$CDWS_INSTALLATION_DIR$/bin/startWebservice.sh