How to bind the Digital Fax service to a specific IP and/or port

Description:

This article describes how to configure the Digital Fax service to use a specific IP and/or port for network communications. This is useful when you need:

to bind the fax server to a specific IP address in case of multihomed servers, that is, having multiple IP addresses;
to make the fax server listening on a port different from the default one (SIP 5060).

How-to:

Since the binding settings are node-speciifc parameters and since the Stonefax.ini file is replicated as-is across an Imagicle cluster, node-specific sections must be defined in the Stonefax.ini file:

Retrieve the Node ID of the node from the support page.

Edit the file StonevoiceAS\Apps\Stonefax\Server\System\Stonefax.ini and add the following section and parameters:

CODE

[Node:<Node Id>]
ListenInterface=<IP address>
ListenPort=<Port number H.323>   <<<< For H.323 configurations only 
ListenPortSIP=<Port number SIP>  <<<< For SIP configurations only

Save the file and restart the Digital fax service on the specified node

In case of cluster configurations wait the Stonefax.ini changes are replicated across the cluster and repeat the same procedure for all the nodes.

Examples

Single node with multiple IP addresses, set a specific IP address:

CODE

[Node:UCIMGFAX]
ListenInterface=172.45.1.23

Single node, change only SIP port:

CODE

[Node:UCIMGFAX]
ListenPortSIP=5080

Single node, change only H.323 port:

CODE

[Node:UCIMGFAX]
ListenPort=1724

Cluster - set a specific IP address on each node:

CODE

[Node:UCIMGFAX-DA]
ListenInterface=172.45.1.23

[Node:UCIMGFAX-SF]
ListenInterface=172.45.2.23

Cluster - set a specific IP address and SIP port on each node:

CODE

[Node:UCIMGFAX-DA]
ListenInterface=172.45.1.23
ListenPortSIP=5080

[Node:UCIMGFAX-SF]
ListenInterface=172.45.2.23
ListenPortSIP=5080