Skip Headers

Oracle® Collaboration Suite Release Notes
Release 2 (9.0.4.1.1) for Windows

Part Number B12240-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Feedback

Go to previous page
Previous
View PDF

9 Oracle9iAS Wireless

This chapter contains important information about Oracle Wireless and Voice. Topics include:

9.1 What's New in This Release?

This release of Wireless includes many new and enhanced features; here are some of the highlights:


Real-time Browser Access From Any Mobile Device

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:

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.


Ubiquitous Voice Access

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.


Instant Access Through Async from SMS or E-mail

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.


Multi-Channel Alerts and Notifications

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.


Presence and Availability Management

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.

9.2 Oracle Hosted Voice Gateway

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.

9.3 Known Limitations

This section discusses known limitations of Oracle9iAS Wireless.

9.3.1 Wireless Email Changing Timeout Parameter

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:

  1. Start the Wireless Webtool.

  2. Go to Content Manager.

  3. Go to Mail.

  4. Go to Service Input Parameters.

  5. Change the timeout value from 2000 to 10000.

  6. Restart OC4J_Wireless.

9.3.2 Return-to-Portal URL Configuration

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

9.3.3 Oracle Calendar


Calendar Server

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

Creating New Calendar Entries through Voice

In this release, users cannot create new Oracle Calendar entries through the voice interface.

9.3.4 Wireless Status Displayed as Down

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.

9.3.5 Multi-byte Characters and Wireless Notifications

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.

9.3.6 Registering Oracle Portal Provider for Wireless Web tool and Wireless Customization Fails

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.

9.3.7 Generic Single Sign-On Errors If Using Microsoft Internet Explorer

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).

9.3.8 Oracle Wireless Process Status Unavailable for Multiple ORACLE_HOMEs with External Repository

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.

9.3.9 Multi-byte Usernames in Jabber Not Supported

Jabber, which is the backend we use with Instant Messaging does not support multi-byte usernames, thus the Instant Messaging module consequently also does not support multi-byte usernames.

9.4 Using Wireless and Voice

This section discusses using Wireless and Voice.

9.4.1 Access Information

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

9.4.2 ASK Commands to Access Collaboration Suite from SMS, E-mail, or 2-way Pager

The following commands are available for accessing Oracle Collaboration Suite components.

9.4.2.1 Calendar

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"

9.4.2.2 Address Book

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

9.4.2.3 Mail

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

9.4.2.4 Fax

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

9.4.2.5 Directory

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.

9.4.2.6 Short Messaging

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

9.4.2.7 Instant Messaging

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

9.4.2.8 Files

To browse the contents of a given directory:

files [<directory>]

Example

files /Private

If left empty, the home directory is assumed.

9.5 Document Errata

This section discusses documentat errata.

9.5.1 Configuring Oracle Wireless to Enable Messaging

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.

9.5.2 Online Help Display

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.

9.5.3 Wireless Configuration Assistant Failure


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:

  1. 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:

    1. Start the OID management tool.

    2. Select your OID server (for example, ias-pc2.us.oracle.com, port 389)

    3. Login as orcladmin/welcome1.

    4. Follow this path to get the Wireless password:

      Entry Management-> cn=OracleContext-> cn=Products-> cn=IAS-> cn=IAS 
      Infrastructure-> orclReferenceName=ias..-> orclResourceName=WIRELESS
      
      
    5. Click the resource, and you will see the password attribute.

  2. 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');