Oracle® Mail Administrator's Guide 10g Release 1 (10.1.1) Part Number B14491-03 |
|
|
View PDF |
This chapter discusses the Oracle Collaboration Suite 10g WebMail (Oracle WebMail) client and how it is managed.
This chapter includes the following topics:
The Oracle WebMail client is a thin client that gives users a simple and fast means to access messages and other self-service features through a Web browser. A user points his browser to a predetermined URL to log in to his e-mail account and sees the inbox rendered dynamically.
All programs execute in the Oracle Application Server, including the logic to render a user's folders, messages, public directory and personal address book. There is no processing or data storage on the desktop. The browser acts merely as a keyboard and screen.
Oracle WebMail provides a standard, out of the box Web mail solution, along with a tool kit that can extend and modify this standard solution.
The Oracle WebMail client runs on the Oracle Collaboration Suite Applications Tier. The user does not have to download any information or software, as they do when using fat clients, such as Microsoft Outlook or Netscape Messenger. Other than entering a URL in a browser (which can be bookmarked), no configuration of the user's local computer is necessary.
Oracle WebMail is designed to provide a number of ways to customize the application to fit specific needs, from changing the look-and-feel using modifications to the UIX pages, to changing application page flow.
State File
The state file contains XML defining the navigation behavior of the Oracle WebMail client. This file facilitates defining state transitions in the client (when the user moves from one state to another) and managing the end state to present to the user.
The location of the state file for the Oracle WebMail client is determined by the toolkit.statefile
property:
toolkit.statefile=%ORACLE_HOME%/um/client/config/statefile.xml
Note:
Percent symbols (%
) in the oc4j.properties
file are substituted to reflect the real directory path during installation.The toolkit.statefile
property is set in the $ORACLE_HOME/j2ee/OC4J_OCSClient/config/oc4j.properties
file.
This section includes the following topics:
Table 4-1 describes the Oracle WebMail client properties in alphabetical order. Values given for the properties indicated for database and LDAP connection pooling while using OJMA, and for database connection pool parameters, are just examples and should actually be determined based on the number of users, and system load.
To edit these properties, change their values in the $ORACLE_HOME/j2ee/OC4J_OCSClient/config/oc4j.properties
file.
Note:
Oracle WebMail client properties can also be edited in the$ORACLE_HOME/opmn/config/opmn.xml
file.Table 4-1 Oracle WebMail Client Properties
Property | Description | Acceptable Values | Default Value |
---|---|---|---|
client.corporate.url |
Link to the corporate logo that displays in the application. |
Any URL that points to a corporate logo |
|
client.faxsubtab |
Configure to show a subtab for fax messages on the message list page. |
|
|
client.image.corporate |
Path to image to customize Oracle WebMail with corporate logo. |
Any URL that points to an image |
|
client.image.product |
Path to location of the product logo in Oracle WebMail. |
Any URL that points to an image |
|
client.ldapsearch.maxresult |
Maximum number of results returned from a search of Oracle Internet Directory from Oracle WebMail. End users whose searches return more matches than this are notified that additional results exist, but that only this maximum number are shown. |
Any integer |
|
client.mail.attachment.downloadlongfilename client.mail.attachment.downloadmaxencodedlen |
These parameters are used in the |
|
|
client.mail.attachment.defaultname |
Filename to be used when attachment has no associated filename. |
A file name using the 27.3 naming convention |
UnnamedAttachment.txt |
client.mail.enforcenestedHTMLfonts |
If true, original fonts are to be used for HTML. |
|
|
client.mail.messagetransport |
If SMTP, messages are sent through the SMTP server; database uses direct database interaction. |
|
|
client.mail.sharedfoldercacherefresh |
Configure to refresh the shared folder cache. Enter |
|
|
client.mail.showsharedfoldersinlists |
Configure to show shared folders in drop-down boxes. Enter |
|
|
client.mail.translate.INBOX |
If true, the INBOX folder is automatically translated to the user's locale. If false, the Inbox is displayed in English. |
|
|
client.message.charset.default |
Default character set to use for outgoing messages. |
Any valid character set |
|
client.message.charset.default.iana |
Default character set to use when sending a message. For backward compatibility, the non-IANA property |
|
N/A |
client.message.view.charset.default.iana |
Default character set to use when viewing a message if Oracle WebMail is unable to determine the character set. For backward compatibility, the non-IANA property |
|
N/A |
client.privacystatement.url |
Link to the privacy statement |
Any valid URL |
|
client.voicesubtab |
Configure to show a subtab for voice messages on the message list page. |
|
|
jdbc.connection.debug |
If true, enables debugging JDBC connections. |
|
|
jvm.command.line.option |
Set the JVM heap size See Also: Sun Java System Application Server Enterprise Edition 8.1 2005Q1 Performance Tuning Guide for more information about setting JVM heap size |
|
|
mail.debug |
If true, enables debugging OJMA API for Oracle Mail. |
|
|
MaxTelephonePinDigits |
Maximum number of digits in voice mail PINs |
Any integer |
|
MinTelephonePinDigits |
Minimum number of digits in voice mail PINs |
Any integer |
|
oracle.mail.admin.ldapDebug |
Enables debugging for the administration ESDS API |
|
|
oracle.mail.admin.policy.indexoldmessages |
This parameter controls whether existing user messages are indexed or not. If true, text indexing of existing messages is enabled. Use this parameter in conjunction with the Text Indexing user parameter set in Oracle WebMail. See Also: "Modifying E-mail User Attributes" for more information about the Text Indexing parameter |
|
|
oracle.mail.admin.ui.ojmaDebug |
Enables debugging for the administration OJMA API |
|
|
oracle.mail.charset.jis.default |
Specifies the default variant of the ISO-2022-JP character set when Japanese users log into Oracle WebMail. This property optimizes compatibility with Japanese mail exchange and helps prevent characters from showing in Oracle WebMail as garbled. A valid value is one of the following:
Note: This property must be added to the |
ISO2022-JP-OUTLOOK ISO2022-JP-OUTLOOK-HWKANA ISO2022-JP |
|
oracle.mail.client.prefs.autoreply |
Enables access to auto reply features and options. If true, enables auto reply functions for end users. |
|
|
oracle.mail.client.prefs.autoreply.echo |
Every incoming message receives an auto reply with the original message copied. Requires |
|
|
oracle.mail.client.prefs.autoreply.reject |
Enables the user to select the reject option in Oracle WebMail. With this option enabled, the server rejects all incoming messages. Requires |
|
|
oracle.mail.client.prefs.autoreply.reply |
Enables the reply option in Oracle WebMail. With this option enabled, every sender receives one auto reply regardless of the amount of messages sent by that sender. Requires |
|
|
oracle.mail.client.prefs.autoreply.vacation |
Enables the vacation option in Oracle WebMail. With this option enabled, every incoming message receives an auto reply with the original message copied. Requires |
|
|
oracle.mail.client.prefs.autoreplymimesizelimit |
Limits the size of auto reply MIME messages |
Any integer
|
|
oracle.mail.client.prefs.maxattachmentsize |
Set the maximum size limit in bytes of an e-mail attachment |
Any integer |
|
oracle.mail.client.prefs.maxMessagesShown |
Sets the maximum number of messages shown in Oracle WebMail |
Any integer |
|
oracle.mail.client.prefs.readreceipt.response |
Sets the read-receipt options when a user receives a message that requests a read-receipt notification.
|
|
|
oracle.mail.sdk.esmail.cache_inactivity_timeout |
Number of seconds to wait for a connection before the ESDS client connection pool times out. |
Any integer values OJMA connection pool settings |
|
oracle.mail.sdk.esmail.connpool_max_limit |
Maximum number of connections in the |
Any integer values OJMA connection pool settings |
|
oracle.mail.sdk.esmail.connpool_min_limit |
Determines the initial or minimum number of connections created in the connection pool. Oracle recommends keeping this limit as low as possible to avoid holding on to unused database connections. |
Depends on factors, such as the number of users and system load |
|
oracle.mail.sdk.esmail.db_timing |
Set to true to get database timing information. By enabling this property, you can view the Active count (total number of active connections) and Cache count (total number of connections) in the database connection pool. |
|
|
oracle.mail.sdk.esmail.driver_type |
Determines the type of JDBC driver to be used for the database connection poo.l |
|
|
oracle.mail.sdk.esmail.encryption |
Disables password encryption, which is mandatory in Oracle Collaboration Suite. Can be disabled for more performance. |
|
|
oracle.mail.sdk.esmail.ldap_debug |
If true, enables debugging OJMA API for Oracle Internet Directory. |
|
|
oracle.mail.sdk.esmail.ojma_debug |
Controls the debug output from the OJMA layer |
|
|
oracle.mail.sdk.esmail.timing |
Set to true to get timing information for various e-mail operations, such as listing folders, opening a folder, and copying messages |
|
|
toolkit.clientdir |
Directory under Default value should not be changed. |
Any valid path under |
|
toolkit.controller.type |
Parameter used by the application controller. Default value should not be changed. |
|
|
toolkit.controller.URL |
URL for accessing the client framework controller |
A valid URL that accesses the client framework controller |
|
toolkit.debugmode |
Whether to debug the OESContext. |
|
|
toolkit.helpdir |
Relative URL path to the online help files. |
Any valid path to directories containing the associated files |
|
toolkit.imagedir |
Relative URL path to the images files. |
Any valid path to directories containing the associated files |
|
toolkit.jslibdir |
Relative URL path to the javascript files. |
Any valid path to directories containing the associated files |
|
toolkit.logdirectory |
Path to the directory containing the Oracle WebMail client log files. |
A valid file path containing the log files |
|
toolkit.logfilecount |
Number of log files to rotate. |
|
20 |
toolkit.logfilename |
Name of the Oracle WebMail client log file. |
|
|
toolkit.logfilesize |
Maximum size of the log file in bytes before rotation. |
|
|
toolkit.loghostclient |
Name for the Oracle WebMail Client host. |
|
|
toolkit.loglevel |
Logging level of the Oracle WebMail client, from the five choices shown. |
|
|
toolkit.mail.listsubscribedfoldersonly |
If true, only subscribed folders are displayed. Otherwise, all existing folders are displayed. |
|
|
toolkit.mailstore |
Protocol used to connect to the Oracle Collaboration Suite Database. |
ESMAIL is the only supported protocol. |
|
toolkit.pagesuffix |
Type of suffix to append when going to targets in |
|
|
toolkit.servlet.version |
Differentiates how the servlet is forwarded to the UIX pages: should be set to Default value should not be changed. |
Any servlet version |
|
toolkit.statefile |
Location and name of the statefile:
|
Any valid file path to a file that contains the statefile definitions |
|
Oracle WebMail relies on Oracle Internet Directory for authentication, through Oracle Application Server Single Sign-On, to look up users in the directory, and to access the user's address book. The connection between Oracle WebMail and Oracle Internet Directory can be secured by configuring Secure Sockets Layer (SSL).
To configure SSL for the connection between Oracle WebMail and Oracle Internet Directory, add the following properties to the oc4j.properties
file:
oracle.mail.ldap.connectssl=true oracle.mail.ldap.sslport=4031
Table 4-2 provides the Oracle WebMail client log files location.
Table 4-2 Oracle WebMail Client Log Files Location
UNIX | Windows |
---|---|
Default: Oracle WebMail logging is configured by properties in Where:
|
N/A |
Oracle Mail Portlet API is provided for OracleAS Portal to access e-mail user information. A user can log in to OracleAS Portal and get unread e-mail and voice mail message counts, as well as header information of the most recently received e-mails from the Inbox. A user can also customize the mail portlet to prioritize messages and set up filters. The portlet also provides links to the Oracle WebMail client to view messages in detail.
All programs execute in the Oracle Application Server, including the logic to render a user's Inbox folder and message headers. There is no processing or data storage on the desktop. The portlet acts merely as a screen.
Oracle Mail Portlet API runs on the Oracle Collaboration Suite Applications Tier. The user does not have to download any information or software. It can be accessed only through OracleAS Portal with server to server authentication. No configuration of the user's local computer is necessary.
Table 4-3 describes the Oracle Mail Portlet API properties.
To edit these properties, change their values in the $ORACLE_HOME/j2ee/OC4J_Mail/config/oc4j.properties
file.
Note:
Values given for the properties indicated for database and LDAP connection pooling while using OJMA, and for database connection pool parameters, are just examples and should actually be determined based on the number of users, and system load.Table 4-3 Oracle Mail Portlet API Properties
Property | Description | Acceptable Values | Default Value |
---|---|---|---|
oracle.cabo.image.laf.browser.lightAccentColorOffset |
Renders the color of the Oracle WebMail and should not be modified |
|
|
oracle.mail.portlet.debug |
|
|
|
oracle.mail.portlet.httpsToWebmail |
Indicates whether the Oracle WebMail title link is |
|
|
oracle.mail.sdk.esmail.cache_inactivity_timeout |
Number of seconds to wait for a connection before the |
Any integer values OJMA connection pool settings |
|
client.mail.spellcheck.dictionaries |
Path to the directory containing spell checker dictionaries |
Path to any valid spell checker dictionary |
|
|
If |
|
|
oracle.ocsclient.directory.cache.enable |
If true, Directory Cache is enabled and periodically updated. If false, Directory Cache remains in pass-through mode. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
oracle.ocs.ldappool.minsize |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
oracle.um.ctf.sesstracker.reportinterval |
Set Session Tracker attributes |
|
|
Note:
Changes made to theoc4j.properties
file will also affect the Oracle Web Access Client.Oracle Mail Display Web Services log files are located in the $ORACLE_HOME/opmn/logs
directory.