IBM BPM version 8.6.0 cumulative fix 2018.03

Specifying a port number for an SMTP server

In the 100Custom.xml files for Process Server and Process Center, you can set a configuration setting to specify a port number for a Simple Mail Transfer Protocol (SMTP) server.

About this task

In the past, a default port number of 25 was used for the SMTP server in all scenarios. However, using the new mail-smtp-port setting, you can now specify any port number for an SMTP server.

If you want to change the value for the setting, you can override the value by adding or updating the setting in your 100Custom.xml files. For example, to add the setting to a 100Custom.xml file, you would add the following elements under the <properties> element and modify the value as needed:

<server>
   <email merge="mergeChildren">
      <mail-smtp-port merge="replace">465</mail-smtp-port>
   </email>
</server>

For information about the individual 100Custom.xml files that need to be updated and their locations, see the topic Location of 100Custom configuration files.

However, to consistently and reliably change the value of the setting in all of the 100Custom.xml files in your IBM® BPM deployment environment, it is recommended that you use the updateBPMConfig command as described in the following procedure:

Procedure

Stop the servers for Process Server and Process Center.
Start the scripting client in disconnected mode as described in the topic updateBPMConfig command.

Run the following commands to simultaneously update all affected servers:

wsadmin> AdminTask.updateBPMConfig( [ '-create', '/server' ] )
wsadmin> AdminTask.updateBPMConfig( [ '-create', '/server/email' ] )
wsadmin> AdminTask.updateBPMConfig( [ '-create', '/server/email/mail-smtp-port', '-xNodeValue', setting_value ] )
wsadmin> AdminConfig.save()

Replace the setting_value variable with a port number.

Restart the servers.

Results

The recommended way of updating the 100Custom.xml files is by running the updateBPMConfig command. However, if the updates are unsuccessful, you can manually update the files by following the steps in the topic Creating a 100Custom.xml configuration file.