| Oracle® Collaboration Suite Release Notes Release 2 (9.0.4.1.1) for Windows Part Number B12240-02 |
|
|
View PDF |
| Oracle® Collaboration Suite Release Notes Release 2 (9.0.4.1.1) for Windows Part Number B12240-02 |
|
|
View PDF |
This chapter summarizes release note issues associated with Oracle Email.
The following sections are included in the chapter:
Release 2 of the Oracle Collaboration Suite e-mail product ships with restricted use licenses for the Oracle9i Application Server 9.0.2.3 and the Oracle9i Database 9.2.0.3. Several enhancements have been made to all components of the mail solution to improve performance and functionality. New features include:
Improved virus scanning and protection, including an administration tool for quarantining messages suspected of virus infection in large stores; hands-off scanning of mail stores by third party anti-virus knowledge bases; and better virus scanning control for inbound and outbound mail.
Per-user mail store backup and recovery, allowing backup and restoration of individual users' mail folders, private address book entries, and server-side rules
Network News Transfer Protocol (NNTP) server for news articles that can be used out of the box, accessed and posted through standard clients, and used to archive Oracle Email public distribution lists
Migration Tool support for Novell GroupWise, version 6.0, and Samsung Contact, version 7.1 (formerly HP OpenMail)
Additional features for the Oracle Connector for Outlook, including:
Delegated management of mail, allowing a user to assign someone else to temporarily manage one's mail
Additional server-side rules, including the popular "out of office" assistant
Support for message annotation
Flashback recovery of mail, allowing users to quickly recover deleted mail messages
Oracle Email Anti-Spam parameters can be configured through the Oracle Webmail client Administration page or Oracle Enterprise Manager. In the current release, there are two known issues:
The labeling of the anti-spam parameters in the Oracle Webmail client Administration page does not match those found in Oracle Enterprise Manager. However, these parameters are indeed the same. (3228008)
Not all of the anti-spam parameters are available for configuration through Oracle Enterprise Manager
As stated in the Oracle Email Administrator's Guide, configure Oracle Email Anti-Spam parameters through the Policy web page within the Oracle Webmail client Administration page.
|
See Also: Oracle Collaboration Suite Anti-Spam Quick Reference Guide on the Oracle Technology Network (OTN) |
Oracle Corporation recommends using JDK 1.4.1 for IMAP to IMAP migration, using the Oracle Email Migration Tool.
JDK 1.4.1 or higher must be used with WebMail to support GB18030 (Simplified Chinese PRC standard) encoding.
|
Note: To runcatalog.sh on Windows, you must use one of the following UNIX emulator utilities:
|
If the ORACLE_HOME environment variable begins with \r, the catalog.sh script stops working. For example, if the ORACLE_HOME is c:\release2, then catalog.sh fails. In Windows, the \r command is a control character that causes catalog.sh to fail when using ORACLE_HOME to creating intermediate files and scripts.
Workaround:
Using shell script, enter sh on the command prompt.
Set ORACLE_HOME to c:/release2 (forward slash).
Execute the catalog.sh script.
The targetdn attribute must be cataloged manually. If this attribute is not cataloged, the user rename operation fails.Workaround:Enter the following command:
%ORACLE_HOME%\ldap\bin\catalog.sh -connect infrastructure_connectstr -add -attr targetdn
|
See Also: Bug number 3049817 for more information |
The text index for e-mail body searching is created with the Oracle Text BASIC_LEXER, which supports English and most western European languages that use white space delimited words. For other languages that are not supported by Oracle Text BASIC_LEXER, e-mail body search does not work.
Workaround:
Enter the following SQL prompt:
alter table es_imt_msgbody add (cset VARCHAR2(20) default 'JAAUTO');
Choose a lexer for e-mail indexing.
Supported lexers are:
CHINESE_VGRAM_LEXER
CHINESE_LEXER
JAPANESE_VGRAM_LEXER
JAPANESE_LEXER, KOREAN_LEXER
KOREAN_MORPH_LEXER
As database user es_mail, drop the existing index es_ot_ix_search file. This unindexes previously indexed e-mails.
Recreate the index es_ot_ix_search file with the lexer chosen in step 2. This causes all previously indexed e-mails to be re-indexed using the new lexer.
Determine whether tablespace esoratext exists.
Run the following SQL command as database user es_mail to recreate the index:
@ execute
CTX_DDL.CREATE_PREFERENCE('my_lexer','LEXER_NAME');
Create charset filter preference
@ execute
CTX_DDL.CREATE_PREFERENCE('my_charset_preference','CHARSET_FILTER');
@ execute
CTX_DDL.SET_ATTRIBUTE('my_charset_preference','charset','chosen_charset');
chosen_charset : Globalization support name of source character set.
DROP INDEX es_ot_ix_search;
CREATE INDEX es_ot_ix_search ON es_imt_msgbody(text)
indextype IS ctxsys.context
parameters ('DATASTORE es_search_dspref
FILTER my_charset_preference
SECTION GROUP es_search_sec_group
STORAGE oratextstore
LEXER my_lexer
CHARSET COLUMN cset') ;
Replace the following entries:
my_lexer with a unique name
LEXER_NAME with the name of the chosen lexer
my_charset_preference with a unique name
chosen_charset with the name of the source character set
Indexing is limited to one lexer
Indexing is limited to one character set
|
See Also: Bug number 2981864 for more information |
This section describes Oracle Email known bugs.
Table 4-1 Administration Known Bugs
| Bug No. | Description |
|---|---|
| 3264429 | On-line help within the Administration tab is not fully displayed |
| 3099032 | Users must use Internet Explorer 6.0 to view translated on-line help |
| 3236819 | The parameter value labels for the Prevent Service Denial Attack parameter in the Anti-Spam Policy page are mislabeled. The parameter value currently labeled connection(s) refers to Spam Flood Interval, which is a time interval in minutes. The parameter value currently labeled message(s) refers to Spam Maximum Flood Count, which is a value that represents the message count plus connection count. The equivalent parameters accessed through Enterprise Manager SMTP_IN anti-spam settings are correctly labeled. |
| 3265330 | Oracle Email servers running on Windows NT may report following error when performing database operations:
ORA-04031: unable to allocate 4016 bytes of shared memory
("large pool","unknown object","session heap","frame segment")
Workaround: Change the mail store database initialization See Also: Oracle9i Database Administrator's Guide Release 2 for instructions changing initialization parameter values |
| 3221096 | The oesbkp utility does not work unless the command line parameters are enclosed in quotation marks.
Workaround: All Example: oesbkp "task=backup" "user=john@acme.com" "password=welcome1" "admindn=cn=orcladmin" "ldaphost=ldap.acme.com" "ldapport=4032" "backupdir=c:\backup" |
| 2918730 | Backup and restore can be performed on inactive users |
| 3153905 | Errors occur when running the umconfig.bat script on the middle tier |
| 3117825 | OESCTL command displays a message.
The following message displays when performing the
This message can be ignored. |
| 3029078 | Administrator online help is missing. |
| 2978639 | If the mail store configuration for first mail store fails, the orclguest user is not provisioned for e-mail.
Wordaround: To provision the %ORACLE_HOME%\oes\bin\createEmailAccount.bat domain_name where:
|
| 2882795 | System rules for message delivery can be invoked more than once for a message, if the message delivery fails during the first delivery attempt and delivery is tried again |
| 2349530 | You cannot install more than one e-mail middle tier on one machine |
| 2883242 | When enabling the distribution list synchronization option from administration pages, the list of objectclass names must contain the groupofuniquenames or groupofnames explicitly, even if the definitions objectclasses are inherited. |
Table 4-2 Migration Tool Known Bugs
| Bug No. | Description |
|---|---|
| 2598308 | The index is not available in the Help system. Keyword searches for help are not possible. Help content is available. |
| 2841542 | Migration tool throws OutofMemoryException while migrating users.
Workaround:
|
Table 4-3 Microsoft Exchange Plug-in Known Bugs
| Bug No. | Description |
|---|---|
| 2775294 | After migration, contents of multi-part or signed messages are shown as a text attachment |
| 2775252 | Messages with a MIME-type of multi-part or mixed that include multi-part or digest message parts are not migrated |
| 2760551 | After migration, multi-part and parallel messages are broken |
| 2516725 | The Microsoft plug-in does not extract a shared folder from the Microsoft Exchange server if the shared folder does not have an owner, or if the default permission for that folder is not defined.
Workaround: Verify that all folders have owners and the default permission defined before migrating them into the Oracle Email (see bug 2516792). |
| 2558661 | The Microsoft plug-in fails to extract messages with embedded OLE objects |
Table 4-4 Lotus Domino R5 Plug-in Known Bugs
| Bug No. | Description |
|---|---|
| 2632809 | Unable to open some attachments using Netscape 4.x after MBOX based migration with globalization support messages.
Workaround: View using Netscape 7.0 or Outlook Express. |
| 2558661, 2827041 | Embedded images and Notes Rich Text Format are not migrated from Lotus (for Interpersonal messages only) |
| 2775294, 2760551 | Format information is lost for multi-part and parallel and multi-part and signed message types |
| 2991346 | A few Traditional Chinese messages where the original character set is UTF-8 are not migrated properly |
| 2926772 | During mailbox extraction, a "No Message File for Product=OES" message is logged |
Table 4-5 Novell GroupWise Plug-in Known Bugs
| Bug No. | Description |
|---|---|
| 2938463 | Remainder note mail items are not extracted from the mailbox |
| 8469032 | Creation Date is extracted instead of the Received Date |
| 2950698 | Multibyte attachment names are not correct after migration (for interpersonal message types) |
| 2801219 | The GroupWise plug-in does not extract Korean attachment names properly |
| 2794199 | HTML body parts are not migrated properly for interpersonal message types |
Table 4-6 Samsung Plug-in Known Bugs
| Bug No. | Description |
|---|---|
| 2950501 | Messages composed using non-standard clients may have corrupted headers |
| 2921831, 2921810, 2921793, 2921763, 2921608 | A few migrated messages are not properly displayed using Netscape 4.7x.
Workaround: View the messages using Netscape 7.0 or Outlook Express. |
| 2850889 | Interserver messages after migration appear as extra attachments in Outlook Express.
Workaround: Set If |
Table 4-7 IMAP Server Known Bugs
| Bug No. | Description |
|---|---|
| 3316081 | The oesctl command does not shutdown the IMAP processes
Workaround: Use Oracle Enterprise Manager to startup and shutdown IMAP |
| 2990674 | The IMAP sort command does not work correctly on wireless profile folders |
Table 4-8 List Server Known Bugs
| Bug No. | Description |
|---|---|
| 2977691 | Messages sent to the parent of nested external distribution lists are not archived for the child external list |
| 2675017 | Data returned by a PL/SQL function for a mail-merge tab is not translated into the character set of the e-mail into which the data is inserted |
| 2637279 | If an alias is made a member of a mailing list and an e-mail with mail-merge tags is sent to such a list, then the mail-merge will be incorrect for the alias recipient. All other normal users are unaffected. |
Table 4-9 NNTP Server Known Bugs
| Bug No. | Description |
|---|---|
| 3130827 | NNTP inbound server core dumps if the orclmailnntpallowfeed parameter value is not set in Oracle Internet Directory.
Workaround: Set the |
| 2992003 | The es.nntp.in.clients.total statistic is not being collected |
| 3023652 | The outbound server core dumps when an NNTP peer does not respond with a 200 response code during the initial connection |
| 3028400 | Message expiration for newsgroups and archived messages does not occur |
| 2988909 | The anti-spam parameter Reject Connections from Host Domain(s) is not recognized by the NNTP Inbound server |
| 2991982 | Articles containing a Distribution header value set for rejection are accepted. Only messages containing a Distribution header are affected. |
| 2982508 | The oespr utility does not allow multiple outbound peers for a group to be set. The peer name is replaced with the new value instead of appending the new value, so that a newsgroup can be fed to one peer only. |
Table 4-10 Virus Scrubber Known Bugs
| Bug No. | Description |
|---|---|
| 3276803 | Symantec scanner logs are written to C:temp directory |
| 2990786 | External filter names cannot contain spaces |
| 2988901 | The anti-virus pre-scan filter for the virus scrubber remains inactive when applied through the WebMail client administration pages.
Workaround
|
Table 4-11 Oracle Webmail Known Bugs
| Bug No. | Description |
|---|---|
| 3725525 | Messages in shared folders cannot be deleted |
| 3210748 | Users cannot add or delete members from the address book list |
| 3210733 | Sub folders cannot be moved under top level folders |
| 3032404 | Oracle Webmail does not display Arabic folder names properly |
| 3118921, 3064349, 3039842, 3034705, 302786, 3027902 | English appears in Oracle Webmail when reading some languages |
| 3118633, 2435583 | Sorting in Oracle Webmail is according to ASCII character set |
| 3118765, 2958984 | Oracle Webmail may have issues when dealing with certain character set encoding (KO18-U and HZ-GB-22312) |
| 2468357, 2468378 | Oracle Webmail may have issues when dealing with UTF-7 encoded messages |
| 2478206 | Oracle Email users cannot log in to Oracle Webmail if the users have multibyte characters in their user IDs |
| 2759549 | European characters are not displayed correctly |
| 3119310 | The invite command does not work if it is executed after other list commands.
Workaround: After logging in to Oracle Webmail, execute the |
| 3041649 | Runtime error occurs in French.
Workaround:
|
| 3027912 | The message date does not display in the Message List view if the middle tier is installed in ZH locale (Simplified Chinese) |
| 3093934 | The Oracle Email portlet fails if OJMA encryption is set to True.
Workaround: Set the value |
| 3101018 | Selecting a folder from the drop down list in the Message List page does not work. On Linux only. |
This section describes documentation issues in the following documents:
This section contains document errata found in the Oracle Email Administrator's Guide.
This parameter specifies the e-mail quota of a mail user in megabytes.
Range: 0 mb to 1048576 mb
Table 4-12 IMAP Statistics
| Statistic | Description |
|---|---|
.um.admin.os_pid |
Operating system process ID |
.um.admin.uptime |
Amount of time the server has been up |
.ES_SPS.socket.currload |
Current number of client connections |
.ES_SPS.socket.sockmax |
Maximum number of client connections allowed |
.ES_SPS.thread.currthreads |
Number of threads the server is currently using |
.ES_SPS.thread.thrmax |
Maximum number of threads the server creates |
All server process instances have a description parameter. The following parameter shows a sample set of configuration options:
-sslenable=yes
Where sslenable has two possible values: yes or no.
|
See Also: Oracle Internet Directory Administrator's Guide for more information regarding Oracle Internet Directory SSL |
This section contains document errata found in the Oracle Email Migration Tool Guide.
The Oracle Collaboration Suite Configuration Handbook has been renamed to the Oracle Collaboration Suite Quick Installation Guide.
For references to the Oracle Collaboration Suite Configuration and Planning Guide, see the Oracle Collaboration Suite Installation and Configuration Guide.
Preparing for a Novell GroupWise Migration:
Novell Client Version 4.81 or higher should be installed on the machine where the Migration Tool is installed.
Choosing the Migration Option:
Microsoft Exchange 5.0 and Microsoft Exchange 5.5 does not support Public Alias Migration from this Version.
Preparing for a Microsoft Exchange Migration
Create a profile.
Check whether the Outlook Client is installed in Corporate or Work Group Mode.
To check the mode in which the Outlook Client is installed:
Open Microsoft Outlook.
Click About Outlook under the Help option.
If it is in Corporate or Working group, change nothing.
If it is in Internet Mail Only Option, change the configuration from IMO to Corporate or Working Group Mode.
To change the configuration of Microsoft Outlook from IMO to Corporate or Work Group mode:
Click Tools on the Microsoft Outlook menu bar.
Select Options > Mail Format > Reconfigure.
Follow the wizard and select the Corporate or Working Mode radio button and finish.
|
Note: Explicitly install the Microsoft Outlook 2000 client in Corporate Mode option if there are failures. |
After installation:
Click Start > Control Panel > Mail.
Click Show profiles.
Click Add.
Enter the appropriate information.
Check whether the primary Windows NT account (used profile creation) has the Service Admin or Admin role on the Exchange Server Machine. If not, add the NT user to the service admin accounts list using the Microsoft Exchange Administrator program.
Stop and start the Exchange services to make permissions given take effect.
Check if the Exchange Administrator program is installed on the machine.
If a forward slash (/) is present in a folder name, the Migration Tool replaces it with an underscore (_) and prefixes the folder with Renamed_.
For example, if the original folder is named Sales/March, the name becomes Renamed_Sales_March.
To install the Migration Tool:
ORACLE_HOME can be any directory on the machine from which the migration tool runs. It need not be a proper Oracle installed directory.
Create a directory oes/migration under the set ORACLE_HOME.
Migrating Distribution Lists:
Distribution lists are only created as SMTP distribution lists on Oracle. These can be converted to list server lists using the Webmail client administration pages.
|
See Also: Oracle Email Administrator's Guide for more information on SMTP distribution lists and list server lists |
Userlistgen generates the users.xml file for IMAP-based migration where the passwords are protected. This file is used by the Migration Tool for loading users.
Run userlistgen.sh (for Solaris) and userlistgen.cmd (for Windows) from $ORACLE_HOME/oes/migration/bin.
./userlistgen.cmd
The Migration Tool reads the following parameters from Standard input. To terminate, press ENTER twice.
For example:
sourceimapuserid=test1 sourceimappasswd=welcome1 targetimapuserid=test1 targetimapuserpasswd=welcome1 quota=50 sourceimapuserid=...
Once this is complete, the users.xml file has to be copied to the required directory from where the Migration Tool will read it.
./userlistgen.sh file=file_name
The Migration Tool reads the file (in the users.xml format supported by the Migration Tool) and the output file is generated in the same directory with the passwords in the users.xml file protected.
The following is an input file example:
userlist user sourceimapuserid="test1" sourceimappasswd="welcome1" targetimapuserid="test1" targetimappasswd="welcome1" quota="10" / /userlist
This section contains document errata found in the Oracle Email Administrator's Guide.
Before a caller can access any of the directory components, the caller must authenticate with the LDAP directory using the oracle.mail.OESContext class. Once authenticated, the instance of oracle.mail.OESContext representing a trusted session must be passed to all of the directory APIs. There are two ways of authenticating: in the middle tier ORACLE_HOME and by providing the user credentials.
In this authentication model, the application must be deployed on a middle tier host.
The $ORACLE_HOME/oes/jazn/jazn-data.xml file must be modified as described in the following. $ORACLE_HOME is the Oracle home path in the middle tier host
Back up the original $ORACLE_HOME/oes/jazn/jazn-data.xml file.
Open $ORACLE_HOME/oes/jazn/jazn-data.xml.
Go to the end of the file.
Before the </jazn-policy> tag, add the following lines:
<grant>
<grantee>
<codesource>
<url>file:%JARFILE_NAME%</url>
</codesource>
</grantee>
<permissions>
<permission>
<class>oracle.security.jazn.JAZNPermission</class>
<name>logon</name>
</permission>
</permissions>
</grant>
where:
%JARFILE_NAME% is the absolute path of the application jar file.
An example of authenticating as an application with the debug option turned off follows:
OESContext oesctx = new OESContext(DirectoryConstants.DS_CALLERTYPE_APP, false); //Authenticate to the directory oesctx.authenticate(null, oracle_home); //oracle_home is the oracle home path on the middle tier host
In this authentication model, the application must provide Oracle Internet Directory super user credentials (credential of cn=orcladmin or cn=umadmin,cn=EmailServerContainer,cn=Products, cn=OracleContext).
An example of authenticating as an application passing super user credentials with the debug option turned off follows:
OESContext oesctx = new OESContext(DirectoryConstants.DS_CALLERTYPE_APP, false); //Authenticate to the directory oesctx.authenticate(username, password, ldaphost, ldapport); //username - super user dn, password - super user password, ldaphost - OID host name, ldapport - OID port number
To run these examples, the CLASSPATH environment variable must include the following:
jndi.jar, ldap.jar, providerutil.jar, classes12.zip, $ORACLE_HOME/jlib /repository.jar, $ORACLE_HOME/jlib/esldap.jar, $ORACLE_HOME/jlib/escommon.jar, $ORACLE_HOME/jlib/ojmisc.jar, $ORACLE_HOME/j2ee/home/jazn.jar
The $ORACLE_HOME/oes/jazn/jazn-data.xml file must be edited.
