Configuration parameter

The following configuration parameters are necessary:

Parameter

Description

Protocol (AMQP|HTTP|KAFKA|SOLACE|IOTHUB)

The protocol or mode with which the Notification Service (AMQP/HTTP/KAFKA/SOLACE/IOTHUB) is used

  • Default setting: AMQP

AMQP version (V0.9|V1.0)

The AMQP protocol version required to reach the target point

  • Default setting: V0.9 (RabbitMQ)
  • Default setting: V1.0 (Universal Messaging)

Host name (for AMQP/KAFKA mode)

The host name of the RabbitMQ broker/Universal Messaging Realm/Kafka broker

Port (for AMQP mode only)

The connection to the RabbitMQ broker/Universal Messaging Realm

  • Default setting: 5672
  • Default setting: 90021 (Universal Messaging)

Exchange (for AMQP V0.9 only)

Name of the RabbitMQ Exchange

  • Default setting: OpCon.DDL.RequestNotifications

Queue name (for AMQP V1.0 only)

Name of the Universal Messaging Queue

  • Default setting: DDLQueue

REST service URL (for HTTP mode only)

The URL of the REST service

  • Default: http://mdpstageeventintegration.apps.bosch-iot-cloud.com/api/v1/streams/bme/events

Proxy server (for HTTP/IOTHUB mode only)

The URL of the proxy server used to access the REST service or the Azure IoT Hub

  • Default: http://rb-proxy-de.bosch.com:8080

Content type (for HTTP mode only)

Describes the content type that must be used to report the message to a REST service.

  • Default setting: application/JSON

Header name
(for HTTP mode only)

The name of the header for which the user wants to add a value can be user-defined or set to default.

  • Default setting: Authorization

Header value
(for HTTP mode only)

Header value that the user wants to share.

Username (AMQP/HTTP/SOLACE)

The user name of the endpoint that is reached when authentication is required

  • Default setting: user

Use the default value if no authentication is required (because this parameter cannot be left blank in OSS).

Password (AMQP/HTTP/SOLACE)

Password for the endpoint to be used for mandatory authentication

  • Default setting: user

Use the default value if no authentication is required (because this value cannot be left blank in OSS).

Instance

Name of the DirectDataLink instance

  • Is required for cluster and multi-instance operation.
  • Default setting: DirectDataLink

Enabled

Determines whether the Notification Service is available at runtime.

  • Values: true/false

maxQueueSize

Maximum size of the internal queue

maxRetryTime (in s)

Maximum waiting time before restart in seconds

KAFKA security

The security protocol used for authentication

  • Default setting: ssl

kafka TOPIC Name

The name of the Kafka topic for which the DDL messages must be generated

Max KAFKA message size in MB (for KAFKA mode only)

Maximum size of the message to be sent to the broker, in megabytes

Location of private key (for KAFKA mode only)

The file path to the private key for authenticating the client.

This field must only be filled if SSL is used as the security protocol.

Private key password (for KAFKA mode only)

The password used to decrypt the private key

This field must only be filled if SSL is used as the security protocol.

Location of the client certificate (for Kafka mode only)

The file path to the certificate issued to the client from RB TrustCenter

This field must only be filled if SSL is used as the security protocol.

Location of the CA certificate (for Kafka mode only)

The file path to the internal CA-SSL certificates that were issued to the client

This field must only be filled if SSL is used as the security protocol.

Path to store the unsent messages (for KAFKA mode only)

The path to the file that stores all messages not sent to the Kafka broker (if the broker was unavailable)

This field must only be filled if SSL is used as the security protocol.

Retry interval to resend messages in minutes (for KAFKA mode only)

The time interval (in minutes) after which the producer attempts to send unsent messages to the broker again

  • Default setting: 60

Re-send message factor

The number of messages that the producer sends simultaneously when attempting to deliver again

  • Default setting: 50

Backup message size in KB (for KAFKA mode only)

obsolete

(Obsolete, no longer used as of DirectDataLink 5.8)

The maximum size in KB per message that must be allocated for each message

  • Default setting: 5000

 

SOLACE broker or broker list (for SOLACE mode only)

The name of the broker or the list of Solace brokers

When entering the broker list, use "tcps://" before each broker. Example: tcps://broker1:port, tcps://broker2:port, etc.

SOLACE name of the SOLACE VPN (for SOLACE mode only)

The name of the Solace VPN

SOLACE SSL trust store directory

The local directory where the standard RB Trust Center certificates are stored.

Solace Enable 64-bit encoding (for SOLACE mode only)

This parameter must be set to "true" if the sent messages have to be encoded in 64 bits

SOLACE max. message size in bytes (for SOLACE mode only)

Messages larger than this parameter are discarded by the Notification Service.

  • Default value: 10000000
  • Data type: Int32

Enable raw format for request and response

This parameter must be set to "true" if the raw messages (XML or DAT) have to be sent together with the standard Notification Service JSON messages.

IoT Hub device connection string (for IOTHUB mode only)

The primary connection string of the Azure IoT device used by the notification service to send messages to the Azure IoT Hub.

This parameter must be set if the notification service is used in IOTHUB mode.

IoT Hub transport type

The communication protocol used by the Notification Service to send messages to the Azure IoT Hub.

  • Possible values: AMQP, MQTT, HTTP
  • Default setting: AMQP

Backup of Unsent Messages Enabled (only for Kafka Mode)

This parameter should be set to "false" to deactivate the data backup of unsent messages.

  • Default: True