Specifying an FTP/FTPS Port Range

Keep the following operational considerations in mind when setting a port range for FTP and FTPS ports:

If the watt.net.ftpPassivePort.min and watt.net.ftpPassivePort.max parameters are not present or undefined, FTP/FTPS listeners continue the previous behavior of listening on any free port.

If the value specified for watt.net.ftpPassivePort.min is less than 1, a default value of 1 is used. If the value specified for watt.net.ftpPassivePort.max is greater than 65534, a default value of 65534 is used. When both of these conditions exist simultaneously, FTP/FTPS listeners continue the previous behavior of listening on any free port.

An error message is returned to the FTP/FTPS client on the command channel when the specified values do not fall within the expected range. For example, if one of the properties is not defined, if the watt.net.ftpPassivePort.min value is larger than the watt.net.ftpPassivePort.max value, or if one of the properties is not a valid number.

An error message is also returned when all the ports in the specified port range are in use.

Specific details of the error messages are available in the serverYYYYMMDD.log file.

You can modify the port range properties in Integration Server Administrator at any time.

Complete the following steps to specify a port range for FTP and FTPS port listeners.

1. Start Integration Server and log on to Integration Server Administrator.

2. In Integration Server Administrator, select Extended in the Settings area of the Navigation panel.

3. If the watt.net.ftpPassivePort.min and watt.net.ftpPassivePort.max parameters do not appear the Extended Settings list, do the following:

b. Select the check boxes next to watt.net.ftpPassivePort.min and watt.net.ftpPassivePort.max.

4. On the Settings > Extended page, click Edit Extended Settings.

5. Do the following:

For this extended setting...	Enter this value...
watt.net.ftpPassivePort.min	Minimum_Port_Number
watt.net.ftpPassivePort.max	Maximum_Port_Number

6. Values for Minimum_Port_Number and Maximum_Port_Number are port numbers from 1 to 65534. When a port range is specified with these properties, only the ports within the specified minimum and maximum port range (inclusive) are used as the listening ports for incoming FTP/FTPS client data connections. You must specify both a minimum and maximum setting.