Oracle® Collaboration Suite Release Notes Release 2 (9.0.4.1.1) for Windows Part Number B12240-02 |
|
|
View PDF |
This chapter contains important information about Oracle Wireless and Voice. Topics include:
This release of Wireless includes many new and enhanced features; here are some of the highlights:
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 an employee can perform from a browser on his mobile device:
Access, reply, or forward their e-mail and voice mail
View, modify, cancel, or change status of their appointments
Lookup in corporate directory or personal address book
Browse Oracle Files and select a file to fax
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 Email, manage appointments, or call someone from their address book through voice from any phone. To get voice access to Collaboration Suite, employees call a Voice Gateway from the phone and interact with a spoken interface. The Collaboration Suite voice-enabled applications respond to both voice and touch tone commands, and run on any Oracle-accepted VoiceXML gateway with speaker-independent speech recognition.
In this release, employees can also access 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 e-mail.
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 E-mail 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, e-mail, 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 included out-of-the-box 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. Visit mservice.oracle.com
for detailed instructions.
This section discusses known limitations of Oracle9iAS Wireless.
The Wireless Email application is changing the timeout parameter, causing a login failure when connecting using the ESMAIL
mail protocol to connect to the Oracle Collaboration Suite Unified Messaging UM backend.
To correct this issue:
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.
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 once 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
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 Calendar server can also be found by running the following command on the calendar middle tier:
%ORACLE_HOME%\ocal\bin\profilget -s ENG -k port
In this release, users cannot create new Oracle Calendar entries through the voice interface.
Oracle Enterprise Manager displays all of the processes that can be managed for a middle-tier machine. When accessing the EM page and clicking on a middle-tier machine, Wireless will show a red down arrow. The reason for this is that the Wireless Server has not been started. To start the Wireless Server, from your browser, point to:
http:\\machine_name:port\ptg\rm
This will automatically start 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 multi-byte characters, then these multi-byte characters are not displayed correctly in the notification.
If both the infrastructure and middle tiers are installed on the same machine, and the Enterprise Manager daemon running on that computer 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 will throw java.lang.NoClassDefFoundError
errors.
In the orion-web.xml
file of the infrastructure install, 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 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"\>
should be replaced 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 errors occur when you use Microsoft Internet Explorer to access the Web tool on a machine that has both infrastructure and a middle tier installed on it. You may encounter the following errors:
When you log onto the Webtool (entering username 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).
When installing both middle and infrastructure tiers on the same machine 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 install, the Wireless process status changes are not displayed on the Enterprise Manager console. This problem occurs on all platforms.
Workaround:
From the ORACLE_HOME
of the middle-tier for which the schema has been changed, copy the following fragment from the file:
<middle-tier ORACLE_HOME>\config\iasschema.xml
and paste it over (overwrite) the corresponding entry in the infrastructure ORACLE_HOME
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>
Restart Enterprise Manager after this is done.
This section discusses using 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:
cal [day|week] [<date>]
Examples:
To list today's appointments:
cal
To list appointments for the day of August 21 of this year:
cal day 8/21
To list appointments for the week of August 21, 2003:
cal week 8/21/2003:
To make an appointment:
cal new <title> <date> <start-time> <duration> [<location>] [<notes>] <date> in "MM/dd/yyyy" format - year can be omitted e.g. 6/29 <start-time> in "hh:mma" format - e.g. 1:30pm, 9:20am <duration> in minutes - e.g. 90
Example:
cal new test 9/24 1:00pm 90 HQ "bring lunch"
Find searches on phone numbers, names (partial string search) or division. Note that Directory lookup will only be performed if the contact is not found in the personal Address Book.
To find contacts in your personal address book or corporate directory:
find <string>
<string>
is a comma-separated list of names (for example: John,Jack,Smith).
You may specify either first or last name
Search is case-insensitive
There should not be spaces between each entry
Example:
find John,Jack,Smith
The following commands are supported for e-mail:
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.acme.com fax 16505067222 http:\\www.acme.com,\private\john\mydoc\test.html,\private\john\mydoc\FunSpec.html
To find contacts in your corporate directory:
search <string>
<string>
is a comma-separated list of names (first or last), someone's global ID with no extension, e-mail address, or phone number.
Use to send short messaging over any channel:
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 e-mail
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, e-mail, 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 use 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
This section discusses documentat errata.
In the Enabling Messaging section of Oracle9iAS Wireless Administrator's Guide, Oracle hosted service is introduced and described.
You may use the messenger service hosted by Oracle for evaluating the messaging and notifications capabilities of the Oracle9iAS Wireless. The Wireless instance is, upon 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 (Bug #3215131).
To fix this issue, install the patch available on OracleMetaLink (http://www.metalink.oracle.com
); the OracleMetaLink (ARU) number is: 4908103.
Note: 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 prior to running the Wireless Configuration Assistant. This is done by executing the Wireless version number PLSQL procedures in the infrastructure database. Follow these steps:
Obtain the Wireless password.
Since these procedures are part of the Wireless schema, you must first obtain the Wireless password from OID. This can be accomplished as follows:
Start the OID management tool.
Select your OID server (for example, ias-pc2.us.oracle.com, port 389
)
Login as orcladmin/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 user WIRELESS
and execute 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');