Skip to main content
Version: 4.3.0

Routing Adapter

[Core]-Section

HttpServerPort

Required: No

Default = 9080

Range = 1024-65535

Description = Port of the status HTTP web server. Data type: int.

HttpAllowedHosts

Required: No

Default = localhost

Range = Full: ".*"

Description = Regex rule to analyze ip-address

TelnetServerPort

Required: Yes

Default: 9012

Range: 1024-65535

Description: Port of the telnet remote console, Data type: int

TelnetAllowedHosts

Required: No

Default: Only localhost: “(127\.[\d.]+\|[0:]+1\|localhost)”

Range: Full:”.*”

Description: Regex rule to analyze ip-address

LogMask

Required: Yes

Default: 0x00000015

Range: 0x0-0xffffffff

Description: Defines the log mask, Data type: int

CollectedLogMask

Required: No

Default: 0xfffffff3

Range: 0x0-0xffffffff

Description: Defines the collected log mask, Data type: int

WindowsEventLogLevel

Required: No

Default: FATAL

Range NONE, FATAL, ERROR, WARN, INFO, DEBUG

Description: Minimum log level to write into Windows Event Log

LogFile

Required: No

Default: C:\ProgramData\BucherSuter\logfiles\ConnectsHarmony\HarmonyRoutingAdapter.log

Range: String, Path to the logfile

Description: Path to the log file. Data type: String

MaxLogFileCount

Required: No

Default: 10

Range: 1-200

Description: Max archived log files, Data type: int

MaxLogFileSize

Required: No

Default: 10000KB

Range: 1KB-500MB

Description: Max size of one log file, Data type: String (with unit KB, MB or GB)

CertificateThumbprint

Required: Yes

Default: -

Range: String Thumbprint, e.g. a909502dd82ae41433e6f83886b00d4277a32a7b

Description: Thumbprint to identify certificate for encrypted services (in mri, reroute and harmony gate)

[Gate_mri]-Section

IsEncrypted

Required: No

Default: false

Range false, true

Description: Allows an encrypted MRI connection from PIM. UCCE >= 12.0 If IsEncrypted is set to “true” the MR PIM has to be set to secure as well.

MaxAllowedTaskBeforeOverflow

Required: No

Default: 100000

Range 1 - 100000 needs to be higher than MaxQueuedTasks

Description: Maximum of tasks inside Harmony Routing Adapter before additional tasks are sent to the OVERFLOW label.

MaxQueuedTasks

Required: No

Default: 5000

Range 1 - 5000

Description: Maximum of tasks that can be in the queue simultaneously (including priority queue).

MaxQueuedTasksPrioReservation

Required: No

Default: 500

Range: 1-5000 must be smaller than MaxQueuedTasks

Description: This value reserved place space for higher priority tasks.

OverflowDefaultTimeInSec

Required: No

Default: 600

Range: 1-3600

Description: Waittime to reroute a task with reason overflow (label overflow from script).

PriorityVariable

Required: No

Default: “”

Range: String, e.g. pv1 or ecc1

Description: Defines the Peripheral- or ECC variable where RoutingAdapter writes the priority value of the request. (Chats have priority the 1, Mails have the priority 0)

RouteMessageSendRate

Required: Yes

Default: 5

Range: 1-20

Description: Number of route request per second. This value is controlled by concestion control. Please get an exception by cisco before setting this value higher.

RoutingReasonVariable

Required: No

Default: “”

Range: String, e.g. pv1 or ecc1

Description: Defines the Peripheral- or ECC variable where RoutingAdapter in case of RONA or REJECT writes this reason. If you need this information in routing script, configure here the variable.

TcpPortNumber

Required: Yes

Default: 7021

Range: 1024-65535

Description: The TCP/IP port number where RoutingAdapter is accepting a conection from Cisco MediaRouting PG

[Gate_reroute]-Section

ServerUri

Reqiured: No

Default: http://0.0.0.0:8095

Range: String e.g. http://192.168.1.30

Description: The URI (Uniform Resource Identifier) where RoutingAdapter is accepting http REST route requests from AgentAdapter in case of RONA or reject. The connection is unencrypted when the URI starts with http://. The connection is encrypted when the URI starts with https://. If the address in ServerUri is 0.0.0.0, requests are accepted on all network cards/addresses. If a specific address is set in ServerUri, only requests on that specific network card/adresse are accepted. This ServerUri must match to the parameters RoutingHostPort and RoutingHostHttps in HarmonyAgentAdapter configuration section [Gate_fin\MediaReroute]. If connection is encrypted (https://) the thumbprint from a valid certificate is needed in the parameter CertificateThumbprint in the [Core] section

[Gate_harmony]-Section

LocalWebservice

Required: No

Default: net.tcp://localhost:8092/HarmonyRoutingAdapter

Range: String e.g. net.tcp://192.168.1.40:8092/HarmonyRoutingAdapter

Description: Service address on which the Harmony RoutingAdapter is accepting the connection from MediaRoutingPlugin used by the QueueAdapter.

IsEncrypted

Required: Yes

Default: false

Range: false, true

Description True, if the service allows only encrypted connection from QueueAdapter. False, if the service allows only not encrypted connection from QueueAdapter. If set to “True” the IsEncrypted in Configuration Pair of Harmony QueueAdapter has to be set to true as well (see chapter, 3.4 Configuring Harmony QueueAdapter)