Oracle® Collaboration Suite Release Notes Release 2 (9.0.4.1.0) for hp-ux PA-RISC (64-bit) and Linux x86 Part Number B12156-05 |
|
|
View PDF |
This chapter summarizes release note issues associated with the OracleAS Wireless component of Oracle Collaboration Suite. It contains the following sections:
This patch (the Wireless component release number of this patch is 9.0.3.2.0) can be applied to either Oracle Collaboration Suite Release 2 (9.0.4.0.0) or Oracle Collaboration Suite Release 2 (9.0.4.1.0). The corresponding Wireless versions in those releases are 9.0.3.0.0 and 9.0.3.1.0 respectively.
For information about bugs fixed in this release and other important information, see Oracle Collaboration Suite Readme Release 2 Patch Set 1 (9.0.4.2.0).
The following sections describe the new features in this release.
OTA is a newly supported feature in this patch set. It can be enabled or disabled by configuring the system.properties
file. By default, the feature is disabled.
Enable OTA and configure the required carrier and device information as follows:
Use a text editor to modify the system.properties
file located in the $ORACLE_HOME/wireless/server/classes/oracle/panama/core/admin
directory. Set the value of useOTA to true.
Modify the carriers.xml
and devices.xml
files located in the $ORACLE_HOME/j2ee/OC4J_Portal/applications/ \ marconi/marconi-web/WEB-INF
directory to configure the information for carriers and devices according to the examples contained in each XML file.
Modify the default values for the following settings in the owi.properties
file:
bookmarks
MMSC
syncML
WAP
Note: The bookmarks setting has two default values: Google and Yahoo!. For OTA provisioning, you must change both the bookmarks setting name and the URL values to those for Oracle Collaboration Suite.If you want only one bookmark, you must comment out both the bookmark.1.name and bookmark.1.URL values (which are used for the Yahoo! bookmark). Online Help for the OTA feature is not included in this release; it will be included in the next release. |
Restart the middle tier to apply the changes.
Oracle Wireless and Voice provides highly-optimized wireless access to collaboration information from any mobile device with browser capabilities. Here are some of the tasks employees can perform from a browser on a mobile device:
Access, reply, or forward their email and voicemail
View, modify, cancel, or change status of their appointments
Perform lookups in corporate directory or personal address book
Browse Oracle Files and select a file to fax
Oracle Collaboration Suite wireless applications are highly optimized for mobile browsers of varying capabilities and devices of different form factors allowing most effective and user-friendly experience. For example, the Mobile Inbox feature provides faster, personalized access to mail by allowing users to create a virtual inbox to receive only urgent mail, mail from the last 24 hours, only voicemails, only fax messages, or mail from selected senders.
Employees can now retrieve and reply to Oracle Email, manage appointments, or call someone from their address book through voice from any phone. To get voice access to Oracle Collaboration Suite, employees call a Voice Gateway from the phone and interact with a spoken interface. The Oracle Collaboration Suite voice-enabled applications respond to both voice and touch tone commands, and run on any VoiceXML gateway (that works with Oracle) with speaker-independent speech recognition.
In this release, employees can also access Oracle Collaboration Suite through Async from SMS, 2-way pager, or any e-mail client. Employees can send simple Async commands through SMS or e-mail to pull in their appointments for the day, to modify or cancel a meeting, to look up employee information in a corporate directory or personal address book, or browse a files catalog to select a file to fax or send by email.
For example, a user can send an Async command "cal" through SMS to pull in all appointments for the day, or "search joe harris" to look up Joe Harris in the corporate directory.
Oracle Collaboration Suite keeps your employees notified—when they receive specific Email or voice-mail, when important events are added or updated in their calendar, when they are invited to a web conference, or as a reminder for important meetings and web conferences. A unique benefit to employees is the freedom to specify which channel they want to receive these notifications: SMS, MMS, Email, voice alert, 2-way pager, or Fax.
Oracle Collaboration Suite availability management capabilities puts users in control by allowing them to create their own profiles that define where they are during the day and how they want to be notified at this location. Employee availability information is published through the corporate directory so that anyone with appropriate privileges can determine the best method to contact an employee at any given moment in time.
The as-is applications and custom-built voice applications can immediately be accessed through voice devices after Oracle Collaboration Suite Wireless installation and configuration by using the Oracle hosted voice gateway. For detailed instructions, refer to the following Web site:
mservice.oracle.com
This section lists Known Limitations to this release.
A problem has been reported regarding Wireless SMS Notification (bug #3314271). If you are experiencing this problem, you must apply a one-off patch available from OracleMetaLink (ARU number is 5790915).
The Contact Rule Switcher Portlet fails when the Web Client and Wireless middle tiers are installed on different systems. There are two ways to fix this problem:
Install both the Web Client and Wireless on the same middle tier.
OR
save the webclient.properties.template
file as webclient.properties
and correctly configure the entries for Wireless.
To avoid intermittent login failures due to timeout errors, increase the value of the timeout parameter. To increase the timeout value, follow these steps:
Start the Wireless Webtool.
Go to Content Manager.
Go to Mail.
Go to Service Input Parameters.
Change the timeout value from 2000 to 10000.
Restart OC4J_Wireless.
As reported in bug #3174307, upgrading (or patching) your Oracle Collaboration Suite R1 instance might cause the following problems:
After upgrade, users might no longer see the old rules they have set on the Wireless & Voice setting for receiving notifications (that is, voicemails, urgent messages, messages from certain people, and so on), but these rules might still be in effect. As they are no longer shown in the list in the interface, there is no way to modify or remove these old rules.
Users might start receiving multiple copies of notifications after upgrade. Duplicate notifications can occur if after the Oracle Collaboration Suite instance upgrade, users create new sets of rules which are the same as their old rules (which are no longer shown). In this case, the system ends up with two sets of rules being effective for users, resulting in multiple notifications received by users.
To fix this, go to the Wireless & Voice Setting page on the Oracle Collaboration Suite homepage after upgrading (patching). Visiting the Wireless & Voice page automatically turns off and removes the old set of rules belonging to the user.
If you plan to have your users access the Oracle Wireless & Voice setup wizard directly, without going through the Oracle Collaboration Suite Portal home page first, you must explicitly specify where users should navigate when they have completed the Oracle Wireless & Voice wizard. By default, if you access the wizard from Portal, you are returned to the Portal home page. If you do not access the wizard from Portal, you must specify the return-to URL of your choice in the $ORACLE_HOME
/webclient/classes/oracle/collabsuite/webclient/resources/webclient.properties
file.
For example: portal=http://my.company.com/homepage
The default value is set to:portal=http://portal_host:portal_port/pls/portal/PORTAL.wwsec_app_priv.login
In this release, users cannot create new Wireless Calendar entries through the voice interface.
Oracle Enterprise Manager displays all of the processes that can be managed for a middle tier system. When accessing the EM page and clicking on a middle tier system, Wireless shows a red down arrow. The reason for this is that the Wireless Server has not been started. To start the Wireless Server, point your browser to:
:@ http://machine_name:port/ptg/rm
This automatically starts the Wireless Server.
You can receive a wireless notification for a message received by Oracle Email. If either the subject or the sender's ID in the original message contains multibyte characters, then these multibyte characters are not displayed correctly in the notification.
If both the infrastructure and middle tiers are installed on the same system, and the Enterprise Manager daemon running on that system is referring to the infrastructure home, then the Register Oracle Portal Provider for Wireless Webtool and Register Oracle Portal Provider for Wireless Customization from the Wireless site returns java.lang.NoClassDefFoundError
errors.In the orion-web.xml
file of the infrastructure installation, pdkjava.jar
and ptlshare.jar
should refer the middle tier installation location.For example, if the infrastructure is installed in /private/ias20_infra/
and the middle tier is installed in /private/ias20_midtier/
then replace the following entries in the Enterprise Manager daemon orion-web.xml
:
<classpath path="/private/ias20_infra/portal/jlib/pdkjava.jar"/>
<classpath path="/private/ias20_infra/portal/jlib/ptlshare.jar"/>
with:
<classpath path="/private/ias20_midtier/portal/jlib/pdkjava.jar"/>
<classpath path="/private/ias20_midtier/portal/jlib/ptlshare.jar"/>
Restart the opmn
process for the changes to take effect.
There is a generic error that affects some Oracle9iAS components, including Oracle Wireless. This error occurs when you use Microsoft Internet Explorer to access the Webtool on a system that has both infrastructure and a middle tier installed on it. You might encounter the following errors:
When you log on to the Webtool by entering the user name and password and clicking the Login button, an SSO warning (error) appears. Click the Refresh button on your browser to continue.
From the Oracle Wireless User Manager, clicking the Create button causes an SSO warning (error) to appear. You must click the Back button in Microsoft Internet Explorer to proceed (clicking the Refresh button will not enable you to continue as it does in the previous situation above).
When installing both middle and infrastructure tiers on the same system and changing the Wireless schema from the Enterprise Manager console to point to a schema other than the one available as part of the infrastructure installation, the Wireless process status changes are not displayed on the Enterprise Manager console. This problem occurs on all platforms.To workaround this problem: from the Oracle home directory of the middle tier for which the schema has been changed, copy the following fragment from the <middle tier ORACLE_HOME>/config/iasschema.xml
file and paste it over (overwrite) the corresponding entry in the infrastructure Oracle home directory file:
<infrastructure ORACLE_HOME>/config/iasschema.xml <SchemaConfigData> <ComponentName>Wireless</ComponentName> <BaseName>WIRELESS</BaseName> <Override>true</Override> <SchemaName>the new schema name</SchemaName> <DBConnect>the new DB connect string</DBConnect> <Password>the new DB password (encrypted)</Password> </SchemaConfigData>
Then restart Enterprise Manager.
This section contains information to help you use Wireless and Voice.
Two Quick Reference Cards are available to help users with ASK/SMS and Voice Access. They are available on Oracle Technology Network at the following locations:
ASK/SMS Access
http://otn.oracle.com/products/owireless/wv_refcard_sms.pdf
Voice Access
http://otn.oracle.com/products/owireless/wv_refcard_voice.pdf
The following commands are available for accessing Oracle Collaboration Suite components.
To view your appointments, use the following syntax:
cal [day|week] [date]
For example, to list today's appointments, enter the following:
cal
To list appointments for August 21 of this year, enter the following:
cal day 8/21
To list appointments for the week of August 21, 2004, enter the following command:
cal week 8/21/2004
To make an appointment, use the following syntax:
cal new title date start-time duration [location] [notes]
The date in "MM/dd/yyyy" format - year can be omitted for example, 6/29.
Enter the start-time in the format "hh:mma" format - for example, 1:30pm, 9:20am.
Enter the duration minutes, for example 90.
Example:
cal new test 9/24 1:00pm 90 HQ "bring lunch"
The Find searches on phone numbers, names (partial string search) or division. Note that a Directory lookup is performed only if the contact is not found in the personal Address Book.To find contacts in your personal address book or corporate directory, enter the following:
find string
Where
string
is a comma-separated list of names, such as: John,Jack,Smith)
You can specify either first or last name.
Search is case-insensitive.
Example:
find John,Jack,Smith
The following commands are supported for Oracle Email:
send—returns help message
send help—returns help message
send recipients documents|text:text—sends documents or text messages to a list of recipients
Examples:
send jacob "text:This is a test message." send user@oracle.com /private/documents/roadmap30.ppt
The following fax commands are supported:
fax /help
fax -help
fax -h
fax recipient_fax_number
"text:fax message"
Examples:
fax 16505067222 "text:hello world" fax recipient_fax_number fileURL[,filePathInFilesOnline] fax 16505067222 http://www.yahoo.com fax 16505067222 http://www.yahoo.com,/private/john/mydoc/test.html,/private/john/mydoc/Spec.html
To find contacts in your corporate directory, use the following:
search string
Where
string
is a comma-separated list of names (first or last); someone's global ID with no extension, email address, or phone number.
Use the sm
command to send short messaging over any channel. Supported channels are:
sm <channel> <recipient> <subject> <message>
Examples:
sm voice 16505551212 Meeting Let's meet at 2:00pm—Sent as voice message. sm email john.smith@oracle.com "Simple Subject" This is my message—Sent as an email. sm sms 5551212 Meeting Let's meet at 2:00pm—Sent as an SMS message. sm fax 16505067000 "Urgent Meeting" This is important—Sent as fax.
Supported channels are voice, email, sms and fax.Subjects containing multiple words must be quoted.
Usage:
im command [param1 param2 param3 ... paramN]
Example:
im send my friend "Hi, how are you doing?"
Enclose (in double quotes) parameters containing spaces.Available Commands:
help
—shows the list of available im
commands.
connect
—connects the user to the im
service.
disconnect
—disconnects the user from the im
service.
groups
—retrieves the user's groups.
addgroup
'name'—adds a group to the user's groups.
delgroup
'name'—removes the group specified from the user's groups.
mvgroup
'oldname' 'newname'—renames the group specified by 'oldname' to 'newname'.
online
'name'—shows the list of online friends in the group specified by 'name'.
offline
'name'—shows the list of offline friends in the group specified by 'name'.
add
'friend' 'group' [Yahoo|MSN]— adds a friend to the group specified - remote Yahoo or MSN friends can be specified.
del
'friend' 'group'—removes a friend from the group specified.
mv
'friend' 'oldgroup' 'newgroup'—moves a friend from 'oldgroup' to 'newgroup'.
statuses
—shows the list of the main status groups.
statuses
'statusgroup'—shows the list of statuses within a group of statuses.
status
'statusID'—Sets the user's current status to the status specified.
msgs
—shows all the unread messages on the server for the user.
arch
—shows all the archived messages on the server for the user.
msg
'msgID'—shows the message specified by 'msgID'.
send
'friend' 'text'—sends a message to the 'friend' specified with the 'text' specified.
psts
—shows the list of the user's preset messages.
addpst
'text'—adds a message to the user's preset messages.
delpst
'presetID'—removes the preset message specified from the user's preset messages.
sendpst
'friend' 'presetID'—sends a message to the 'friend' specified with the preset message specified.
account
'username' 'password' [Yahoo|MSN]—updates the local, Yahoo or MSN account information.
autologin
on|off—sets the auto-login option for the local account to on or off.
The following documentation items have changed since the last release.
This paragraph replaces the information in Section 4.3 of Oracle9iAS Wireless Administrator's Guide concerning valid values. In Oracle Collaboration Suite mode, enter the name and port of the Oracle Collaboration Suite Calendar server. Separate both these entries with a colon (:). To determine the port for Calendar server access, go to http://mid-tier:port
. Click the Ports tab. In the table listing the ports, look for Oracle Calendar server.The port for the Oracle Calendar server can also be found by running the following command on the Oracle Calendar middle tier:
$ORACLE_HOME/ocal/bin/profilget -s ENG -k port
Perform this workaround on the infrastructure database before beginning the Wireless middle tier installation.
Bug 3232042 is caused by Wireless not determining the version of the Wireless schema and data. The workaround for this problem is to set the Wireless version before running the Wireless Configuration Assistant. This is done by executing the Wireless version number PL/SQL procedures in the infrastructure database. Follow these steps:
Obtain the Wireless password.
As these procedures are part of the Wireless schema, you must first get the Wireless password from OID. Do this as follows:
Start the OID management tool.
Select your OID server (for example, ias-pc2.us.oracle.com
, port 389)
Login as orcladmin
using the password welcome1
.
Follow this path to get the Wireless password:
Entry Management-> cn=OracleContext-> cn=Products-> cn=IAS-> cn=IAS Infrastructure-> orclReferenceName=ias..-> orclResourceName=WIRELESS
Click the resource, and you will see the password attribute.
Fix the infrastructure database.
To set the versions correctly, connect to the infrastructure database as the WIRELESS
user and enter the following commands:
exec PTG_UPGRADE_PKG.add_schema_version('9.0.2.8.0');exec PTG_UPGRADE_PKG.add_data_version('9.0.2.8.0');
In the Enabling Messaging section of Oracle9iAS Wireless Administrator's Guide, Oracle hosted service is introduced and described.
You can use the messenger service hosted by Oracle for evaluating the messaging and notifications capabilities of the Oracle9iAS Wireless. The Wireless instance is, on installation, equipped to use this hosted instance without any additional configuration. However, after the evaluation period, customers must set up their own messaging infrastructure.
Online help pages are empty when accessed from the Customization Portal.
To fix this issue, install the patch available on OracleMetaLink (www.metalink.oracle.com
); the OracleMetaLink (ARU) number is 4908103.