20 WebLogic Server Mail Sessions

This chapter describes the tasks you can perform to create, monitor, and configure mail sessions. Mail sessions facilitate the process of using the JavaMail APIs, which provide applications and other Java EE modules with access to Internet Message Access Protocol (IMAP)- and Simple Mail Transfer Protocol (SMTP)-capable mail servers on your network or the Internet.

Note:

If you are logged into a domain partition, navigate from the Domain Partition menu. Note that WebLogic Server Multitenant domain partitions, resource groups, resource group templates, and virtual targets are deprecated in WebLogic Server 12.2.1.4.0 and will be removed in the next release.

This chapter includes the following sections:

• Create mail sessions

• Monitor mail sessions

• Configure mail sessions

Create mail sessions

To create a new mail session:

1. From the WebLogic Domain menu, select Other Services, then select Mail Sessions.

   The Mail Sessions table displays information about the mail sessions that have been configured in the current WebLogic Server domain.

2. Click Create.
3. Define the configuration settings for your new mail session on each of the following pages:

   • General Configuration

   • Targets

   • Review

4. Click Create.

General Configuration

On the General Configuration page, you can define general configuration settings for your new mail session:

• Name: enter the desired name for your new mail session.

• Scope: select the scope for this mail session (Global, Resource Group Template, or domain resource group Partition)

• JNDI Name: enter a unique JNDI name for this new mail session.

• Session Username: enter the desired username credentials for this new mail session.

• Session Password/Confirm Session Password: enter and confirm the desired password credentials for this new mail session.

• Java Mail Properties: click Add to add properties to this new mail session and specify information for connecting to an existing mail server. Express each property as a name=value pair.

For more information about these fields, see Configuration Options.

Targets

On the Targets page, select the servers and clusters on which you want to target this new mail session to.

See Configuration Options.

Review

On the Review page, review the configuration for this mail session.

See Configuration Options.

Monitor mail sessions

To monitor the mail sessions configure in a domain:

1. From the WebLogic Domain menu, select Other Services, then select Mail Sessions.

   The Mail Sessions table displays information about the mail sessions that have been configured in the current WebLogic Server domain, such as:

   • Name

   • JNDI Name

   • Scope

   • Resource Group/Template

   • Domain Partition

   For more information about these fields, see Configuration Options.

Optionally, select View to access the following table options:

• Columns: add or remove the columns displayed in the table

• Detach: detach the table (viewing option)

• Sort: sort the columns in ascending or descending order

• Query by Example

Configure mail sessions

The section describes how to configure mail sessions.

This section includes the following tasks:

• Configure mail session general settings

• Target mail sessions

• Configure mail session tags

• Create mail session notes

Configure mail session general settings

To configure general settings for a mail session:

1. From the WebLogic Domain menu, select Other Services, then select Mail Sessions.

   The Mail Sessions table displays information about the mail sessions that have been configured in the current WebLogic Server domain.

2. In the Mail Sessions table, select the mail session you want to configure.
3. Select the General page.

   On the General page, you can view and define general configuration settings for the mail session, such as:

   • Name

   • Scope

   • JNDI Name

   • Session Username

   • Session Password

   In the Java Mail Properties section, click Add and enter a Name and Value to add a new Java mail property to the mail session.

4. Click Apply.

For more information on these fields, see Configuration Options.

Target mail sessions

After you create a mail session, you assign (target) it to one or more server instances or clusters.

To specify the targets for a mail session:

1. From the WebLogic Domain menu, select Other Services, then select Mail Sessions.

   The Mail Sessions table displays information about the mail sessions that have been configured in the current WebLogic Server domain.

2. In the Mail Sessions table, select the mail session you want to configure.
3. Select the Targets page.

   On the Targets page, you can select the servers and clusters you want to target the mail session to. Select the checkbox next to the target name to specify the desired targets for this mail session.

4. Click Save.

See Configuration Options.

Configure mail session tags

To configure tags associated with a mail session:

1. From the WebLogic Domain menu, select Other Services, then select Mail Sessions.

   The Mail Sessions table displays information about the mail sessions that have been configured in the current WebLogic Server domain.

2. In the Mail Sessions table, select the mail session you want to configure.
3. Select the Tags page.

   On the Tags page, you can select tags for this mail session by moving them from the Available column to the Chosen column. Additionally, you can enter a new tag in the Add new tag field.

4. Click Apply.

See Configuration Options.

Create mail session notes

To create notes for a mail session:

1. From the WebLogic Domain menu, select Other Services, then select Mail Sessions.

   The Mail Sessions table displays information about the mail sessions that have been configured in the current WebLogic Server domain.

2. In the Mail Sessions table, select the mail session you want to configure.
3. Select the Notes page.

   On the Notes page, enter your notes.

4. Click Save.

See Configuration Options.