Oracle® Fusion Middleware Release Notes 11g Release 1 (11.1.1) for Microsoft Windows x64 E14774-11 |
|
![]() Previous |
![]() Next |
This chapter describes issues associated with Oracle User Messaging Service. It includes the following topics:
This section describes general issue and workarounds. It includes the following topic:
Section 26.1.1, "XML File Handle Left Open after Upload Fails"
Section 26.1.4, "User Preferences User Interface Renders Improperly"
If an error occurs when uploading a user messaging preferences XML file using the WLST manageUserMessagingPrefs
command, the XML file handle is left open. On the Microsoft Windows platform, this file cannot be deleted until you exit the WLST shell.
When no metric data is found, for example when no messages have been sent or received after server setup, the Metrics Performance page will display Unavailable. This is not a problem with the software, and the Performance reporting is operating properly. As soon as Send and Receive traffic exists, the Performance page will display results normally.
Upon restarting the UMS server (usermessagingserver) from Oracle Enterprise Manager Fusion Middleware Control or through Oracle WebLogic Console, you may get an error: Error 503--Service Unavailable
when attempting to access any URLs served by the UMS server, such as the User Preferences UI (/sdpmessaging/userprefs-ui) or the various Web Services endpoints. This error occurs intermittently in cases when the Oracle WebLogic Server is heavily loaded (such as with a SOA instance). To work around this issue:
Restart the UMS server again (two or more restarts may be required).
If multiple UMS server restarts are not sufficient, then restart the entire Oracle WebLogic Server instance.
Intermittent UI rendering errors have been reported in some languages, due to the generation of a corrupted .css file. If you experience problems, follow these steps to work around the issue:
Delete the cached, auto-generated .css file for the affected locale (or simply, all locales) on the server located at DOMAIN_HOME/servers/<server_name>/tmp/_WL_user/usermessagingserver/<random_name>/public/adf/styles/cache
and restart the usermessagingserver application using Oracle Enterprise Manager Fusion Middleware Control. Have all users clear their browser caches.
The next time the UI is accessed from a browser, a new .css file will be generated for the desired locale, and it is very likely that it will be a valid .css file. If not, repeat this process a couple of times.
If the previous solution does not work, disable content compression in the web.xml
file of the User Preferences Web Module located at DOMAIN_HOME/servers/<server_name>/tmp/_WL_user/usermessagingserver/<random_name>/sdpmessaginguserprefs-ui-web.war
. In particular, extract web.xml
, add the following <context-param/>
to it:
<context-param> <param-name>org.apache.myfaces.trinidad.DISABLE_CONTENT_COMPRESSION</param-name> <param-value>true</param-value> </context-param>
Then, re-archive it to the war module.
Finally, restart the usermessagingserver application using Oracle Enterprise Manager Fusion Middleware Control.
This section describes configuration issues and their workarounds. It includes the following topics:
Section 26.2.1, "Use Correct SSL Trust Store When Configuring Drivers"
Section 26.2.2, "deployUserMessagingDriver Default Staging Mode Change"
Section 26.2.3, "Configure VoiceXML Driver Receive URLs Correctly"
Section 26.2.4, "UMS Driver Configuration Changes Not Immediately Effective"
Before configuring any User Messaging Service Driver (such as the Email Driver) to connect to a remote gateway using SSL, ensure that the correct SSL Trust Store is used:
Update the value of the JVM system property (javax.net.ssl.trustStore) set in $DOMAIN_HOME/bin/setDomainEnv.sh
(or Windows equivalent).
In this release, the default staging mode used by this WLST command is nostage
(previously it was stage
).
In a clustered (high-availability) environment with Oracle HTTP Server (OHS) configured, do not use the OHS port to configure the VoiceXML Driver Receive URLs. Using the OHS port to configure the VoiceXML Driver Receive URLs will cause a conflict with the drivers.
Each Voice XML Driver must be configured with its own WLS server's port (as described in the parameters' documentation).
When you change a driver's configuration and then restart the driver, the changes will not take effect until all managed connections in the pool are destroyed (900 seconds [15 minutes] by default). Take one of these actions to ensure that the connections are destroyed:
When performing driver configuration changes, stop the driver application and wait for 15 minutes. Then re-start the driver application.
Note: If you follow this recommendation and the wait time of 900 seconds (15 minutes) is too long, you can reduce the time using the Oracle WebLogic Server Administration Console as follows:
Remember that if Shrink Frequency is reduced to a short interval, it may eventually have a negative impact on the performance of the driver as idle connections will be recycled frequently. |
OR
Restart the entire Oracle WebLogic Server after performing driver configuration changes. The new changes will take effect immediately upon server re-start.
Instructions for notification configuration include setting your outgoing server parameters. Please note that if you do not change the parameters (that is, if you leave the default setting unchanged), notifications may still be sent. This is expected behavior, but you should not rely on the default settings without verifying them. You should set your parameters to ensure that they are correct.
This section describes documentation errata. It includes the following topic:
Section 26.3.1, "Test-to-Production Scenario with LDAP Configuration"
Section 26.3.2, "Additional UMS Information for Patch Assistant Document (E16154-01)"
While moving Oracle User Messaging Service to an existing production environment configured against an LDAP Store, only use the Userprefs-UI option to change User Preferences.
Note: Using the WLST command (manageUserMessagingPrefs ) is not recommended as it may not correctly migrate identity-store backed device preferences that have been removed from the test instance. |
In Section 3.3.8.2: "Migrating Configuration for User Messaging Service Worklist Driver", the text has been expanded for clarity as follows:
If your Oracle Fusion Middleware 11g Release 1 (11.1.1.1.0) domain has the User Messaging Service Worklist Driver installed and configured, the configuration of the Worklist Driver is automatically migrated by the Patch Assistant. But the tool does not install this additional driver. You must re-install it in the Oracle Fusion Middleware 11g Release 1 (11.1.1.2.0) domain. For more information, see "Install the Worklist Driver" section in the Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite.
The User Messaging Service documentation (in both the Developer's and Administrator's guides) did not list the location of the User Messaging Preferences UI. The standalone user interface is available at:
http://<host>:<port>/sdpmessaging/userprefs-ui
The User Messaging Preferences UI is also embedded in the SOA Worklist application. You can access it from the Worklist application by choosing Preferences > Notification.