IBM Support

IBM Content Navigator: Configuring Send Mail in a container environment

How To


Summary

You set up a mail server in Liberty to enable Send Mail for your container environment users.

Objective

You can configure a Navigator desktop to make the Send Email context menu option available to end users. As an administrator, in the desktop General settings, under Email settings, you select Use the HTML-based email service.

Before you can use this function, you must configure a mail session in your application server. In a container environment, you set up this configuration for Liberty by adding an XML file with the settings for your environment to the configDropins/overrides directory.

Restriction: Users cannot specify any email address that includes an underscore (_) as the Sendmail From address. Underscores in the email address cause the Send Mail function to fail.

Procedure

To set up a mail session for your Liberty application server:

  1. Create a file called icn_mail.xml with the following contents: 
    <server>
	<mailSession mailSessionID="CNMailSession"
	 	jndiName="mail/CNMailSession"
		description="ICN Mail Session"
		storeProtocol="imap"
		transportProtocol="smtp"
		host="server.domain.com"
		user="MailAdmin@domain.com"
		password="password"
		from="MailAdmin@domain.com">
	</mailSession>
</server>Copy

    Different environments might require additional parameters. For example, the following icn_mail.xml file might be appropriate for environments that use SSL:
    <server>
    <mailSession mailSessionID="CNMailSession"
 	jndiName="mail/CNMailSession"
	description="ICN Mail Session"
	storeProtocol="imap"
	transportProtocol="smtp"
	host="smtp.sendgrid.net"
	user="mailadmin"
	password="password"
	from="MailAdmin@domain.com">
        <property name="mail.smtp.host" value="smtp.sendgrid.net" />
        <property name="mail.smtp.port" value="465" />
        <property name="mail.smtp.auth" value="true" />
        <property name="mail.smtp.ssl.enable" value="true" />
    </mailSession>
</server>Copy
  2. Update the values in your icn_mail.xml file to reflect your environment:
    • For the user, enter a user that has access to the email server to log on.
    • For the password parameter, use 64 bit encoding for your value.
    • For storeProtocol, specify the Store Protocol used by the Mail Session instance. The default Store Protocol is imap.
    • For transportProtocol, specify the Transport Protocol used by the Mail Session instance. The default transport protocol is smtp.
    • For host, specify the host of the mail session.
  3. Save your edited icn_mail.xml file to the configDropins/overrides directory for your Navigator deployment.

Document Location

Worldwide


[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSEUEX","label":"IBM Content Navigator"},"Component":"","Platform":[{"code":"PF040","label":"RedHat OpenShift"}],"Version":"3.0.7 iFix 002","Edition":"","Line of Business":{"code":"LOB18","label":"Miscellaneous LOB"}}]

Document Information

More support for:
IBM Content Navigator

Software version:
3.0.7 iFix 002

Operating system(s):
RedHat OpenShift

Document number:
6118270

Modified date:
14 October 2020

UID

ibm16118270

Manage My Notification Subscriptions

Page Feedback