Sending mail from a dedicated mail server
Configure IBM Connections notifications to be sent from a specific SMTP server that is managed by WAS. If the designated mail server is unavailable, then notification emails fail to be delivered.
Before starting
Mail is configured as part of the installation process. Only perform this procedure if you did not enable mail during the installation or you want to change the mail configuration.You can choose to configure notifications to be sent from a single SMTP or have IBM Connections perform a lookup of multiple SMTP server to find one that is available to send the message. If you are interested in the latter configuration, see Sending mail from any available mail server.
Procedure
- Log into the IBM websphere Application Server Integrated Solutions Console.
- Click Resources -> Mail -> Mail Sessions.
- Select Cell scope, and then create a new session.
- Specify values for the following fields:
Name
Specify IBM Connections Notification or another descriptive string.
JNDI name
Specify mail/notification as the value of the JNDI name.
Mail transport host
Specify the fully qualified host name or IP address of the SMTP server that you want to use.
- Specify the following custom properties to define time outs that will prevent resources from being consumed in the event that the SMTP server is unavailable:
mail.smtp.timeout=120000 mail.smtp.connectiontimeout=120000The time interval is specified in milliseconds. A value of 120,000 is two minutes.
- Optional: If the SMTP server requires authentication, then provide values for the following fields in the Outgoing Mail Properties section:
User
User ID used to connect to the SMTP server.
Password
Password associated with the user ID used to connect to the SMTP server.
Verify Password
Repeat the password specified in the previous field.
- If the SMTP server requires traffic to be sent over SSL, then add the following customer properties, and then specify values for them by clicking the Custom properties link, and then clicking New:
mail.smtp.port
Specifies the SMTP port number, which is often 465.
mail.smtp.socketfactory.port
Specifies the SMTP port number, which is often 465.
mail.smtp.socketfactory.class
Specifies the SSL socket factory class.
mail.smtp.socketFactory.fallback
Specifies whether an unsecure connection can be made if SSL is not available. This property accepts the following values: true or false.
For example:
mail.smtp.port=465 mail.smtp.socketfactory.port=465 mail.smtp.socketfactory.class=javax.net.ssl.SSLSocketFactory mail.smtp.socketFactory.fallback=false
Click OK, and then save your changes. Start the wsadmin client from the following directory of the system on which you installed the deployment manager:
app_server_root>\profiles\<dm_profile_root>\bin
Note: You must start the client from this directory or subsequent commands that you try to run will not execute properly. See Starting the wsadmin client for more details.
Update the notification configuration file to indicate that you want to use a mail session managed by WAS.
- Access the IBM Connections configuration files:
execfile("connectionsConfig.py")
If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.
- Check out the notification-config.xml file using the following command:
LCConfigService.checkOutNotificationConfig("<temp_dir>","<cell_name>")where <temp_dir> is a temporary directory and <cell_name> is the WAS cell to which you installed the application for which you are enabling mail. When you specify a path to the temporary directory on a system running Microsoft Windows, use a forward slash for the directory. For example: "C:/temp".
Note: AIX and Linux only: The temporary directory must grant write permissions or the command will not run successfully.
- From the temporary directory to which you checked out the notification-config.xml file, open it in a text editor.
- Search for the <emailChannelConfig> element, and then uncomment the following line of XML markup if it is commented out:
<useJavaMailProvider>true</useJavaMailProvider>
- Comment out the <smtpJNDILookup> element if it is not already.
<!--smtpJNDILookup> ... </smtpJNDILookup-->
- Save and close the notification-config.xml file.
Note: Check out and edit the same file in the procedure described in Enable email notifications. If you plan to complete that procedure next, keep the notification-config.xml file open and checked out.
- Check in the configuration files using the following command:
LCConfigService.checkInNotificationConfig("<temp_dir>","<cell-name>")
- Stop and restart IBM Connections.
What to do next
You must complete the steps described in Enable email notifications before users can send and receive email notifications.
Parent topic
Configure notifications
Related tasks
Starting the wsadmin client
Enable email notifications