-
I've looked over documentation of STUN component generated as a part of Tigase XMPP Server documentation and I've found an error there.
In documentation which you prepared it is stated:
Below is an example configuration for STUN component. Note that the 4
stun-primary
settings are required, where secondaries are not.While at Tigase STUN component wiki it is stated that following is required
stun/stun-primary-ip=10.0.0.1 stun/stun-primary-port[I]=3478 stun/stun-secondary-ip=10.0.0.2 stun/stun-secondary-port[I]=7001
and following is optional:
stun/stun-primary-external-ip=172.16.0.22 stun/stun-primary-external-port[I]=3479 stun/stun-secondary-external-ip=172.16.0.23 stun/stun-secondary-external-port[I]=7002
As STUN component requires 2 external IP addresses to work properly, it required both (primary and secondary) IP/port configuration.
Only properties with
-external-
are optional as they are used to specify external IP/port pairs is our STUN server is behind a firewall which forwards traffic but at the same time maps ip address to internal one.To sum up, looking at an example from documnetation which you added:
stun (class: tigase.stun.StunComponent) { 'stun-primary-external-ip' = '172.16.0.22' 'stun-primary-external-port' = 3479 'stun-primary-ip' = '10.0.0.1' 'stun-primary-port' = 3478 'stun-secondary-external-ip' = '172.16.0.23' 'stun-secondary-external-port' = 7002 'stun-secondary-ip' = '10.0.0.2' 'stun-secondary-port' = 7001 }
it should be stated that following properties are required:
'stun-primary-ip' = '10.0.0.1' 'stun-primary-port' = 3478 'stun-secondary-ip' = '10.0.0.2' 'stun-secondary-port' = 7001
and following are optional:
'stun-primary-external-ip' = '172.16.0.22' 'stun-primary-external-port' = 3479 'stun-secondary-external-ip' = '172.16.0.23' 'stun-secondary-external-port' = 7002
Type |
Task
|
Priority |
Normal
|
Assignee | |
RedmineID |
6091
|
Add Stun configuration documentation to component and then to overall documentation.