Home

 

Sending mail from a dedicated mail server

Configure Lotus Connections notifications to be sent from a specific SMTP server that is managed by WebSphere Application Server. If the designated mail server is unavailable, then notification e-mails fail to be delivered.


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 Lotus 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.


To configure mail to be sent from a dedicated server...

  1. Log into the IBM Websphere Application Server Integrated Solutions Console.

  2. Click Resources > Mail > Mail Sessions.

  3. Select Cell scope, and then create a new session.

  4. Specify values for the following fields:

      Name

      Specify

      Lotus 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 to use.

  5. 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=120000

    The time interval is specified in milliseconds. A value of 120,000 is two minutes.

  6. Optional: If the SMTP server requires authentication, then provide values for the following fields:

      Mail Transport user ID

      User ID used to connect to the SMTP server.

      Mail Transport password

      Password associated with the user ID used to connect to the SMTP server.

    In addition, add the following custom property: 

      mail.smtp.auth=true

  7. If the SMTP server requires traffic to be sent over SSL, then add the following customer properties, and then specify values for them:

      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 a Boolean value of 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

  8. Click OK, and then save your changes.

  9. Update the notification configuration file to use a mail session managed by WebSphere Application Server by completing the following steps:

    1. Open a command window, and then start the wsadmin command line tool. See Starting wsadmin for more details.

    2. Access the Lotus Connections configuration files:

      • Single server: 

          execfile("connectionsConfig.py")

    3. Cluster: 

        execfile("WAS_HOME/profiles/Dmgr01/config/bin_lc_admin/
 "connectionsConfig.py")

    4. Check out the notification-config.xml file... 

        LCConfigService.checkOutNotificationConfig("<temp_dir>","cell_name")

      where <temp_dir> is a temporary and cell_name is the WebSphere Application Server cell to which you installed the feature for which you are enabling mail.

      To enable mail for all of the features and if you installed Lotus Connections into multiple WebSphere Application Server profiles, for example: Activities is installed on AppSrv01, Blogs is installed on AppSrv02, and so on), then there is a notification-config.xml file for each component. If you used this type of deployment, perform these steps to edit the notification-config.xml file associated with each WebSphere Application Server profile.

    5. From the temporary to which you checked out the notification-config.xml file, open it in a text editor.

    6. Search for the <emailChannelConfig> element, and then uncomment the following line of XML markup if it is commented out: 

        <useJavaMailProvider>true</useJavaMailProvider>

    7. Comment out the <smtpJNDILookup> element if it is not already. 

        <!--smtpJNDILookup>
...
</smtpJNDILookup-->

    8. Save and close the notification-config.xml file.

      Check out and edit the same file in the procedure described in Enabling e-mail notifications. If you plan to complete that procedure next, keep the notification-config.xml file open and checked out.

    9. Check in the configuration files... 

        LCConfigService.checkInNotificationConfig("<temp_dir>","<cell-name>")

    10. Stop and restart Lotus Connections.


Complete the steps described in Enabling e-mail notifications before users can send and receive e-mail notifications.


Configure notifications

 

Related tasks

Enable e-mail notifications

+

Search Tips   |   Advanced Search