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)