Oracle® Communication and Mobility Server Release Notes 10.1.3.3.0 Part Number E05365-02 |
|
View PDF |
Release Notes
10.1.3.3.0
E05365-02
June 2007
This document contains important information that was not included in the product release.
This document may be updated after it is released. To check for updates to this document and to view other Oracle documentation, refer to the Documentation section on the Oracle Technology Network (OTN) Web site:
http://www.oracle.com/technology/documentation/
This document contains the following topics:
This release of Oracle Communication and Mobility Server includes bug fixes and new features. To find out about these changes, see OCMS on OTN.
Note:
On AIX 5L Based Systems (64-Bit) and Solaris Operating System (SPARC 64-Bit), Oracle Communication and Mobility Server Service Creation Environment (OCMS SCE), Oracle Communicator, Diameter Libraries and JBoss Application Server 4.0.5GA are not supported in this release.On HP-UX PA-RISC (64-Bit), Oracle Communication and Mobility Server Service Creation Environment (OCMS SCE), Oracle Communicator, and JBoss Application Server 4.0.5GA are not supported in this release.
Review the following sections for information about issues that affect installation, configuration, and upgrade:
On some low-powered (or low-memory) CPU systems, when OCMS 10.1.3.3 is successfully installed onto an existing Oracle Application Server (10.1.3.2) using the Silent Install option, the OC4J:OCMS process/application/server may not be started automatically at the end of installation. In that case OC4J:OCMS process/application/server can be started manually, using the steps in the OCMS Installation and Administration Guides.
Before installing OCMS 10.1.3.3 in Oracle Application Server mode, Oracle Application Server must be installed through Oracle WebCenter Suite 10g (10.1.3.2). During the installation of Oracle WebCenter Suite, select Option 1 (Oracle WebCenter Framework with Oracle HTTP Server) or Option 3 (Oracle WebCenter Framework) after selecting the Advanced install option.
The Custom Install option includes SCE Eclipse Plugin as one of the components. This component should not be checked; please uncheck it and continue with the installation.
Slow installation times have been reported on computers running the Japanese version of the AIX 5L Based Systems (64-Bit). To avoid this problem, ensure the locale is first set to English:
export LANG=en_US
export LC_ALL=en_US
The CurrentRegDevices is a read-only attribute that displays the number of currently registered devices.
The SipRegAllowThirdParty attribute is a read-only attribute that is always set to false.
The SipRegMaxUsers is a read-only attribute.
Technically, overload protection is always activated. When you tune the system, you can prevent overload actions from executing by doing either of the following:
Disabling all of the rules by setting all of the trigger values to zero (0).
Setting the AppQueueMaxSize, StackQueueMaxSize, and SipSessionTableMaxSize attributes to high numbers.
OutOfMemoryException may be thrown because of a bug in JDK 5, Update 6 which is bundled with Oracle Application Server 10.1.3.2.0. If you experience this error, you should update your JDK to JDK, Update 10. If you do not get the error, updating the JDK is not necessary.
Follow these instructions to complete a silent installation for a Custom Install:
On Windows:
setupwin32.exe -V IS_SELECTED_INSTALLATION_TYPE="custom" -silent -options <path-to-options-file>
On windows, this command returns immediately, but the install completes successfully in the background. The only indication that the install is done is when the browser comes up at the end. If you want to monitor progress, see Silent Install on Windows Does Not Show Install Progress below.
On Linux:
./setupLinux-10132-565.bin -V IS_SELECTED_INSTALLATION_TYPE="custom" -silent -options ocms-oas-custom.txt
On HP-UX PA-RISC (64-Bit):
./setupHPUX.bin-V IS_SELECTED_INSTALLATION_TYPE="custom" -silent -options ocms-oas-custom.txt
On AIX 5L Based Systems (64-Bit):
./setupAIX.bin-V IS_SELECTED_INSTALLATION_TYPE="custom" -silent -options ocms-oas-custom.txt
On Solaris Operating System (SPARC 64-Bit):
./setupSolaris.bin-V IS_SELECTED_INSTALLATION_TYPE="custom" -silent -options ocms-oas-custom.txt
When the silent install command is executed from the command prompt, the user immediately sees the command prompt reappear instead of seeing installation progress.
If you are performing a silent install on Windows, you must provide the -is:javaconsole command line parameter:
setupwin32.exe -is:javaconsole -silent -options <HOMEDIR>\ocms-<mode>-typical.txt
An accessibility issue has been reported when installing Oracle Communication and Mobility Server. When installing the product using the Installation Wizard, some of the screen elements do not meet accessibility requirements. To work around this issue, run the Installer in silent mode:
On Windows:
setupwin32.exe -silent -options <HOMEDIR>\ocms-<mode>-typical.txt
On Linux:
setupLinux.bin -silent -options <HOMEDIR>/ocms-<mode>-typical.txt
On HP-UX PA-RISC (64-Bit):
setupHPUX.bin -silent -options <HOMEDIR>/ocms-<mode>-typical.txt
On AIX 5L Based Systems (64-Bit):
./setupAIX.bin -silent -options <HOMEDIR>/ocms-<mode>-typical.txt
On Solaris Operating System (SPARC 64-Bit):
./setupSolaris.bin -silent -options <HOMEDIR>/ocms-<mode>-typical.txt
By default silent installer is set for StandAlone mode. To run the installer for Integrated Application Server mode, set the following:
-V OCMS_MODE_SA="false" -V OCMS_MODE_INTEGJBOSS="false" -V OCMS_MODE_INTEGOAS="true" -V OCMS_OAS_ADMINUSER="oc4jadmin" -V OCMS_OAS_ADMINPASSWD="xxxxxx"
To run SILENT Installer in Debug Mode:
$JAVA_HOME\bin\java -cp setup.jar run -silent -options <HOMEDIR>\silentinstall.txt
Some of the Preferences settings are not completely accessible. As a workaround to this bug, configuration of the preferences can be accomplished by modifying an xml file. The default xml file (on a Microsoft Windows installation) is:
c:\Documents and Settings\<windows account>\Application Data\Oracle Communicator\Accounts\<CommunicatorAccountName>.xml
where <windows account> and <CommunicatorAccountName> are your account names.
For example, if you created an account with the name "John Smith" and you log into windows with the username "jsmith" your account information will be stored in the file.
c:\Documents and Settings\jsmith\Application Data\Oracle Communicator\Accounts\John Smith.xml
There is a companion <communicator account>.dat file which contains information on your contacts, stored in VCard format.The following sections will provide documentation on which parts of the XML file can be modified by a user using the Communicator user interface. The notation provides the XML element names in a hierarchy. These elements all appear under the root "Account" element.Note that the elements are not necessarily presented in the order in which they appear in the account xml file.Changes to these files should only be made when Communicator is closed. If Communicator is open, any changes to these files may be removed.
The Account tab gives you access to the Account settings.
(string) A textual description for this account.
Unlike the other properties in the preferences dialog, the "Run this program when system starts" and "Automatically sign in with this account" modify the Accounts.xml file in the Application Data\Oracle Communicator directory (which holds a list of all of the accounts created on this instance of Oracle Communicator). Whichever account you wish to be the default should be enclosed in a DefaultAccount element. If you wish to automatically sign in with an account, the AutoLogin attribute should be set to "1". For example:
<Accounts> <DefaultAccount AutoLogin="1">John Smith</DefaultAccount> <Account>Jane Smith</Account> </Accounts>
The Presence tab give you access to the Presence settings.
(string) The textual description of the device sent to other users; by default this is "PC".
The Appearance tab give you access to the Appearance settings.
(string) The visual theme to use. Options included are OC, Classic, Jazz and SteelCan.
(complex) The Sounds element represents the different sounds that are played on different events. Each Sound element represents one of the sounds.
Sound/Event: can be IncomingMessage, UserOnline, UserOffline or VoiceMessageAvailable
Sound/File: the .wav file to be played when the event occurs
Sound/Mute: 1 if the sound should not be played, 0 if the sound should be played
(int) 0 if false, 1 if true. Shows the main window on top of other windows if true.
(int) 0 if false, 1 if true. When the user clicks the "X" in the upper right corner of the window, Communicator will be minimized to the system tray instead of closed if this is true.
(int) 0 if false, 1 if true. When the user presses Enter, the message will be sent if this is true. If this is false, then pressing Enter will move to a new line.
(int) 0 if false, 1 if true. Smilies (emoticons) will show as images if this is true.
(complex) Indicates which sound should be used as the ring sound. The default sound will be used if this is empty. A single RingSignals/DefaultSignal element may be defined, with the value of that element either being the full path to a .wav sound file or one of the built in files is present, it can either point to a .wav file or one of these: Dallas, Houston, Office, News Desk, Reception, Beep Beep, Tune 1, Tune 2, Metallic, Mobile 1, Mobile 2.
The Security tab give you access to the Security settings.
(complex) There may be 0 or more Credentials/Credential elements. The contents of the Credential element will be filled automatically if the user chooses to save the username/password when logging in. The user should not edit this field directly, but the user may remove a Credentials/Credential element to remove a username/password from storage.
The Network tab give you access to the Network settings. The proxy, XDMS, LDAP and STUN settings are all configured by an administrator, and should not be changed by the end user. These are fully documented in the administrator's guide regarding customization.
The Audio tab give you access to the Audio settings. Many of the audio and video settings are stored in the system registry.
(int) 0 if disabled, 1 if enabled. Uses silence suppression in the audio if enabled.
(int) 0 if disabled, 1 if enabled. Uses echo cancellation if enabled. This is typically useful if you are using a microphone and speakers. When using a headset, you may want to disable this.
The Video tab give you access to the Video settings.
The Other tab give you access to the Other settings. Contacts and Groups (internal note: according to Adam JAWS users are able to add contacts and IM, but they cannot delete contacts, which is why I am providing this information here).In order to delete a contact, you must edit the .dat file in the same location as the account .xml file. Each contact is represented in VCard format, such as:
BEGIN:VCARD VERSION:3.0 UID:badf5dee-3848-4443-acc5-8ab0bf19069e ADR;WORK:;;;;;;US EMAIL;PREF;INTERNET:john.smith@example.com FN: N:SMITH,JOHN TEL;WORK;VOICE:@w650 555 1212URL;WORK:X-ORACLE-SIPURI:sip:john.smith@example.com X-ORACLE-GROUPS:20000 REV:20070205T130513Z END:VCARD
In order to delete a contact, find the contact VCARD entry and delete everything from and including BEGIN:VCARD to END:VCARD.
The following issues have been reported:
If SCE does not start when you double-click on the shortcut (on Windows), ensure that JAVA_HOME is set and configured correctly, and that java.exe is in the path as mentioned in the documentation.
When changing the values for DistributableVia and Via in the SipServletContainer MBean, and specifying a transport parameter (as default installation does), the following error message appears:
Attribute has not been updated. The data entered has not been accepted by the server.
If you do not specify a transport parameter the value is accepted. No workaround exists for the transport parameter.
In a typical load balancer setup, sticky UDP datagram transportation between source IP/port (for example, Oracle Communicator) and destination IP/port (for example, EdgeProxy) is set. The stickiness presents a problem for high availability failover tests of EdgeProxies. To avoid this problem, ensure that there is no stickiness for UDP datagrams for load balancing. For example, in F5 BipIP
, you can check Enable Connection Rebind to guarantee stickiness is removed.
If an OCMS server is deployed on a DHCP based machine (such as a laptop), and the IP address is changed after the initial installation, OCMS can no longer start itself because of SIP binding errors. There are two possible workarounds for this:
Edit occurrences of the IP address in the SipContainer.xml file in the sdp/conf directory.
Reinstall OCMS.
Upon first start up, you may receive an error message regarding XSLT Stylesheets. There is no performance impact connected to this error, and you may safely ignore it.
If one of the callers unplugs their webcam during a video call, the call fails.
It has been reported that Oracle Communicator sometimes crashes if the recipient of a video call hangs up immediately after accepting a video call. To avoid this possibility, do not accept and hang up immediately.
The JMX-console (in JBoss 4.0.5.GA), without modification, does not support UTF-8 encoding.
The following documentation issues have been noted:
On page 8-7 of the Oracle Communication and Mobility Server Administrator's Guide, a code sample (Enabling High Availability in SIP Servlet Applications) has incorrect formatting and a missing slash. The correct sample should be:
<?xml version="1.0" encoding="UTF-8"?> <sip-app> <display-name>proxyregistrarssr</display-name> <distributable/> <!--Servlets--> <servlet> <servlet-name>Registrar</servlet-name> <servlet-class>oracle.sdp.registrar.VoipRegistrarServlet</servlet-class> <init-param> <param-name>LocationService</param-name> <param-value>oracle.sdp.locationdbservice.LocationDbServiceBD </param-value> </init-param> </servlet> </sip-app>
Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at
http://www.oracle.com/accessibility/
Accessibility of Code Examples in Documentation
Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.
Accessibility of Links to External Web Sites in Documentation
This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.
TTY Access to Oracle Support Services
Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, seven days a week. For TTY support, call 800.446.2398.
Oracle Communication and Mobility Server Release Notes, 10.1.3.3.0
E05365-02
Copyright © 2007, Oracle. All rights reserved.
The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited.
The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose.
If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software—Restricted Rights (June 1987). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs.
Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.
The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.