Optional: Configuring Send Mail for Navigator

You configure the Liberty server mail session to enable the Send Mail desktop option for Navigator.

About this task

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.
Note: Use the java_mail settings in the custom resource YAML file to configure Send Mail functionality. For more information, see Configuring Navigator.

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

    You can get a sample of this icn_mail.xml file from the /BAN/configuration/ICN/configDropins/overrides folder in the Git Hub location for your release.

  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.
  4. After deployment, configure the SMTP Subsystem in Administration Console for Content Platform Engine (ACCE).
    Note: