Registering Mail Servers Using Fusion Middleware Control

17-12 Oracle Fusion Middleware Administrators Guide for Oracle WebCenter

10. Click OK to save this connection.

11. To start using the new active connection you must restart the managed server on which the WebCenter application is deployed. For more information, see Section 8.2, Starting and Stopping Managed Servers for WebCenter Application Deployments.

17.4.2 Registering Mail Servers Using WLST

Use the WLST command createMailConnection to create a mail server connection. For command syntax and examples, see the section, createMailConnection in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. To configure the Mail service to use the new mail server connection as its default connection, set default=true. For more information, see Section 17.5.2, Choosing the Active or Default Mail Server Connection Using WLST. For information on how to run WLST commands, see Section 1.13.3.1, Running Oracle WebLogic Scripting Tool WLST Commands.

17.5 Choosing the Active or Default Mail Server Connection

You can register multiple mail server connections with a WebCenter application but only one connection can be designated as the default connection. The default connection becomes the back-end mail server for: ■ Mail task flows ■ Space distribution lists ■ Anywhere there is a Send Mail icon This section includes the following subsections: Table 17–8 Mail Connection - Additional Properties Field Description Add Click Add to specify an additional connection parameter: ■ Name -Enter the name of the connection property. ■ Value - Enter the default value for the property. ■ Is Property Secured - Indicate whether encryption is required. When selected, the property value is stored securely using encryption. For example, select this option to secure the admin.password property where the value is the actual password. Delete Click Delete to remove a selected property. Select the correct row before clicking Delete. Note: Deleted rows appear disabled until you click OK. Note: To start using new connections you must restart the managed server on which the WebCenter application is deployed. For more information, see the section, Starting and Stopping WebLogic Managed Servers Using the Command Line in Oracle Fusion Middleware Administrators Guide. Managing the Mail Service 17-13 ■ Section 17.5.1, Choosing the Active or Default Mail Server Connection Using Fusion Middleware Control ■ Section 17.5.2, Choosing the Active or Default Mail Server Connection Using WLST

17.5.1 Choosing the Active or Default Mail Server Connection Using Fusion Middleware Control

To change the default connection: 1. Log in to Fusion Middleware Control and navigate to the home page for the WebCenter application. For more information, see: ■ Section 6.2, Navigating to the Home Page for WebCenter Spaces ■ Section 6.3, Navigating to the Home Page for WebCenter Portal Applications 2. Do one of the following: ■ For WebCenter Spaces - From the WebCenter menu, choose Settings Service Configuration . ■ For WebCenter Portal applications - From the Application Deployment menu, choose WebCenter Service Configuration. 3. From the list of services on the WebCenter Services Configuration page, select Mail Server . The Manage Mail Server Connections table indicates the current active connection if any. 4. Select the connection you want to make the active or default connection, and then click Edit.

5. Select the Active Connection checkbox.

6. Click OK to update the connection.

7. To start using the new default connection you must restart the managed server on which the WebCenter application is deployed. For more information, see Section 8.2, Starting and Stopping Managed Servers for WebCenter Application Deployments.

17.5.2 Choosing the Active or Default Mail Server Connection Using WLST

Use the WLST command setMailConnection with default=true to make an existing mail server connection the default connection for the Mail service. For command syntax and examples, see the section, setMailConnection in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. A connection does not cease to be the default connection for the Mail service if you change the default argument from true to false. To disable a mail connection, either delete it, make another connection the active connection, or use the removeMailServiceProperty command: removeMailServicePropertyappName=webcenter, property=selected.connection Using this command, connection details are retained but the connection is no longer named as an active connection. For more information, see the section, removeMailServiceProperty in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. 17-14 Oracle Fusion Middleware Administrators Guide for Oracle WebCenter For information on how to run WLST commands, see Section 1.13.3.1, Running Oracle WebLogic Scripting Tool WLST Commands.

17.6 Modifying Mail Server Connection Details

You can modify mail server connection details at any time. To start using updated mail connections you must restart the managed server on which the WebCenter application is deployed. This section includes the following subsections: ■ Section 17.6.1, Modifying Mail Server Connection Details Using Fusion Middleware Control ■ Section 17.6.2, Modifying Mail Server Connection Details Using WLST

17.6.1 Modifying Mail Server Connection Details Using Fusion Middleware Control

To update mail server connection details:

1. Log in to Fusion Middleware Control and navigate to the home page for the

WebCenter application. For more information, see: ■ Section 6.2, Navigating to the Home Page for WebCenter Spaces ■ Section 6.3, Navigating to the Home Page for WebCenter Portal Applications

2. Do one of the following:

■ For WebCenter Spaces - From the WebCenter menu, choose Settings Service Configuration . ■ For WebCenter Portal applications - From the Application Deployment menu, choose WebCenter Service Configuration.

3. From the list of services on the WebCenter Service Configuration page, select Mail

Server

4. Select the connection name, and click Edit.

5. Edit connection details, as required. For detailed parameter information, see

Table 17–4, Mail Server Connection Parameters .

6. Click OK to save your changes.

7. To start using updated connection details you must restart the managed server on

which the WebCenter application is deployed. For more information, see Section 8.2, Starting and Stopping Managed Servers for WebCenter Application Deployments.

17.6.2 Modifying Mail Server Connection Details Using WLST

Use the WLST command setMailConnection to edit existing mail server connection details. For command syntax and examples, see the section, Note: To start using the active connection you must restart the managed server on which the WebCenter application is deployed. For more information, see the section, Starting and Stopping WebLogic Managed Servers Using the Command Line in Oracle Fusion Middleware Administrators Guide. Managing the Mail Service 17-15 setMailConnection in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. If additional parameters are required to connect to your mail server, use the setMailConnectionProperty command. For more information, see the section, setMailConnectionProperty in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. For information on how to run WLST commands, see Section 1.13.3.1, Running Oracle WebLogic Scripting Tool WLST Commands.

17.7 Deleting Mail Server Connections

You can delete mail server connections at any time but take care when deleting the active or default connection. If you delete the active connection, Mail task flows do not work, as they all require a back-end mail server. When you delete a connection, consider deleting the external application associated with the mail server connection if the applications sole purpose was to support this connection. For more information, see Section 25.5, Deleting External Application Connections. This section includes the following subsections: ■ Section 17.7.1, Deleting a Mail Connection Using Fusion Middleware Control ■ Section 17.7.2, Deleting a Mail Connection Using WLST

17.7.1 Deleting a Mail Connection Using Fusion Middleware Control

To delete a mail server connection:

1. Log in to Fusion Middleware Control and navigate to the home page for the

WebCenter application. For more information, see: ■ Section 6.2, Navigating to the Home Page for WebCenter Spaces ■ Section 6.3, Navigating to the Home Page for WebCenter Portal Applications

2. Do one of the following:

■ For WebCenter Spaces - From the WebCenter menu, choose Settings Service Configuration . ■ For WebCenter Portal applications - From the Application Deployment menu, choose WebCenter Service Configuration.

3. From the list of services on the WebCenter Services Configuration page, select

Mail Server .

4. Select the connection name, and click Delete.

5. To effect this change you must restart the managed server on which the

WebCenter application is deployed. For more information, see Section 8.2, Starting and Stopping Managed Servers for WebCenter Application Deployments. Note: To start using the updated connections you must restart the managed server on which the WebCenter application is deployed. For more information, see the section, Starting and Stopping WebLogic Managed Servers Using the Command Line in Oracle Fusion Middleware Administrators Guide. 17-16 Oracle Fusion Middleware Administrators Guide for Oracle WebCenter

17.7.2 Deleting a Mail Connection Using WLST

Use the WLST command deleteConnection to remove a mail server connection. For command syntax and examples, see the section, deleteConnection in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. For information on how to run WLST commands, see Section 1.13.3.1, Running Oracle WebLogic Scripting Tool WLST Commands.

17.8 Setting Up Mail Service Defaults

Use the WLST command setMailServiceProperty to set defaults for the Mail service: ■ address.delimiter: Defines the delimiter that is used to separate multiple mail addresses. A comma is used by default. Some mail servers require mail addresses in the form lastname, firstname and, in such cases, a semicolon is required. ■ mail.emailgateway.polling.frequency: Frequency, in seconds, that Space distribution lists are checked for new incoming mails. The default is 1800 seconds 30 minutes. Email communication through Space distribution lists can be published as discussion forum posts on a discussions server. For details, see Publishing Space Mail in a Discussion Forum in Oracle Fusion Middleware Users Guide for Oracle WebCenter. ■ mail.messages.fetch.size: Maximum number of messages displayed in mail inboxes ■ resolve.email.address.to.name: Determines whether user email addresses are resolved to WebCenter user names when LDAP is configured. Valid values are 1 true and 0 false. The default value is 0. When set to 1, WebCenter user names display instead of email addresses in Mail task flows. Set this property to 1 if the Instant Messaging and Presence service requires user names to obtain presence status because presence information cannot be obtained when the Mail service provides email addresses. Setting this value to 1 does impact application performance so you must take this into consideration when setting this property. For command syntax and examples, see the section, setMailServiceProperty in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. For information on how to run WLST commands, see Section 1.13.3.1, Running Oracle WebLogic Scripting Tool WLST Commands.

17.9 Testing Mail Server Connections

Confirm that the mail server is up by connecting to the server using any client, such as Thunderbird or Outlook. Note: Before restarting the managed server, mark another connection as active; otherwise, the service is disabled.