Programmable Voice

  1. Home
  2. Docs
  3. Programmable Voice
  4. Configuration
  5. Server General Application Behavior

Server General Application Behavior

You can configure the behavior of your Voice Elements Server’s application level behavior by editing the settings in the VoiceElementsServer.exe.config file. This file is located in the root directory of the server installation. The default is C:\Program Files\Inventive Labs\Voice Elements Server\.

These settings are in XML format, only change the value between the <value>&</value> tags. Changing any other part of the file will break your server. To be safe, always back up the file before editing.

Settings that Determine Where the Server Listens for Client Connections & Authentication

These settings allow you to change the server’s listening for incoming connections

Listening IP

<setting name="ServerListeningIp" serializeAs="String">
     <value>192.168.0.1</value>
</setting>

Set this as the string value of the IP on which the server will listen for incoming client connections. Client applications will need to be coded or configured to request a connection on this IP.

Listening Port

<setting name="ServerListeningPort" serializeAs="String">
     <value>54331</value>
</setting>

Set this as the string value of the IP port on which the server will listen for incoming client connections. Client applications will need to be coded or configured to request a connection on this port.

Connection String

<setting name="ServerConnectionString" serializeAs="String">
     <value>gtcp://192.168.1.65:54331</value>
</setting>

This setting should reflect the IP and Port set above. Set this to the string “gtcp://” + ServerListeningIp + “:” + ServerListeningPort.

Telephony – High Level Telephony Settings

Settings in the section of the configuration file affect the call control functionality of the server.  These include the default destination IP address and port for calls, the default source SIP user name and display name, and the default source IP address and port.  The application is able to override the values provided here.

All of the “Source” settings in the section affect the SIP From: header in outgoing messages.  The From: header is sent in the general form “From: Display Name <username@host:port>”.
Default Destination Host

<setting name="HmpDefaultDestinationHost" serializeAs="String">
     <value>10.10.0.30</value>
</setting>

This setting controls the destination to which SIP calls are sent by default; the value can be specified as an IP address or FQDN.

Default Destination Port

<setting name="HmpDefaultDestinationPort" serializeAs="String">
     <value>5060</value>
</setting>

This setting controls the UDP port to which SIP messages are sent.

Default Source Host

<setting name="HmpDefaultSourceHost" serializeAs="String">
     <value>203.0.113.2</value>
</setting>

This setting determines the source address used for SIP calls; the value specified here appears in From: header in any outgoing SIP messages from the server.  It can be specified as an IP address or FQDN.

Default Source Port

<setting name="HmpDefaultSourcePort" serializeAs="String">
     <value>5060</value>
</setting>

This value specifies the port used in the From: header in outgoing SIP messages.

Default Source Display Name

<setting name="HmpDefaultSourceDisplayName" serializeAs="String">
     <value>Inventive Labs</value>
</setting>

The value specified here will be used as the display name in outgoing SIP messages (caller ID name). This is the string before the user name in the From: header.

Default Source User Name

<setting name="HmpDefaultSourceUser" serializeAs="String">
     <value>866-923-5290</value>
</setting>

This value determines the user which is sent in the From: header of outgoing SIP messages (caller ID number).

Low Level and Legacy Telephony Configuration

Low Level and Legacy Telephony Configuration

Call Analysis – Call Progress and Analysis Settings

Call Analysis Features

Call Progress Results

HMP Elements Server Low-Level Configuration

There is a second configuration file, HmpElementsServer.exe.config, which configures the operation of the HMP Elements server.  HMP Elements is the underlying telephony engine that provides the SIP stack and other low-level functions of the system.  More information can be found in HMP Elements Server Config File.  

Summary

Changes to any of the settings above require the Voice Elements Server to be restarted.  After doing so, these values will be used for any calls where they are not specifically set by the application.  

Note that some of these settings can also be set by invoking the configuration Wizard in the Tools menu of the Elements Dashboard application.  For more information on all the configuration settings available in the VoiceElementsServer.exe.config file, see Voice Elements Server Config File. 

 

Do you still need help?  If so, please contact Inventive Labs technical support.

Was this article helpful to you? Yes 15 No