Oracle® Collaboration Suite Release Notes Release 2 (9.0.4) for AIX Based Systems Part Number B12116-01 |
|
|
View PDF |
This chapter provides information about issues associated with Oracle9iAS Wireless release. It includes the following sections:
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 users access the wizard from Portal, they will be returned to the Portal home page. If users do not access the wizard from Portal, you must specify the return-to URL of your choice in the OracleHome/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
The following sections provide information on Oracle Calendar.
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, view the $ORACLE_HOME/ocal/misc/unison.ini
file in the Oracle Collaboration Suite middle-tier. Look for the "port" entry in the "[ENG]" section.
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 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, from your browser, point 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 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 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 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. The orion-web.xml
file is located at:
$ORACLE_HOME/sysman/j2ee/application-deployments/em/emd/orion-web.xml
For example, if the infrastructure is installed in:
/private/ias20_infra/
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 system that has both infrastructure and a middle-tier installed on it. You might encounter the following errors:
SimpleImage supports an alt attribute which provides alternate text for display devices, and an alternate.wav
file for the voice deviceclass devices. For example:
<SimpleBind> <SimpleMatch> </SimpleMatch> <SimpleTask> </SimpleTask> <SimpleDisplay> <SimpleTextItem deviceclass="voice"> <SimpleAudio src="http://somehost/audio.wav"/> </SimpleTextItem> <SimpleTextItem deviceclass="pda, microbrowser"> Hello welcome </SimpleTextItem> </SimpleDisplay> </SimpleBind>
The Web Component Developer is a java-based GUI tool that allows you to create Web Components that can be delivered by the Web Component Provider, as Wireless Services. There is a known issue of the Web Component Developer in the generation of Web Component Definition files. This renders the developing of composite Web Components not possible. This known bug is scheduled to be fixed and delivered to customers via the Automated Release Updates.
In Oracle Wireless, applications cannot be clustered using the Oracle9iAS clustering mechanism. However, it is still possible to configure Oracle9iAS such that a high availability deployment can be achieved. Complete the following steps for high availability deployment.
$ORACLE_HOME/dcm/bin/dcmctl stop
$ORACLE_HOME/bin/emctl stop
$ORACLE_HOME/opmn/conf/ons.conf
file on each of the middle-tiers and on the infrastructure contains IP address entries for all the other tiers. If not, file and add missing IP-address entries.ORACLE_HOME/opmn/conf/opmn.xml
.
See Also:
Oracle9iAS Containers for J2EE documentation for details and concepts of OC4J instance and islands. |
For instance, if you modify opmn.xml
, a typical entry to start four OC4J processes in the default island would be of the form:
<oc4j maxRetry="3" instanceName="OC4J_Wireless" gid="OC4J_Wireless" numProcs="4">
mod_oc4j
configuration file for each middle-tier (that is: $ORACLE_HOME/Apache/Apache/conf/mod_oc4j.conf
), modify the mount point entries for the Wireless runtime. If two middle-tiers (M1 and M2) are used, the entries should be of the form:
Oc4jMount /ptg instance://m1.c1.mysite.com:OC4J_Wireless,m2.c2.se4637-u-sr006.us.oracle.com :OC4J_Wireless and Oc4jMount /ptg/* instance://m1.c1.mysite.com:OC4J_Wireless,m2.c2.se4637-u-sr006.us.oracle.com :OC 4J_Wireless
where c1 and c2 are the respective Oracle9iAS instance names and can be determined by running the command:
ORACLE_HOME/dcm/bin/dcmctl whichInstance
These entries should be exactly the same for all middle-tier machines.
$ORACLE_HOME/dcm/bin/dcmctl
updateConfig
to update the DCM repository with the configuration file changes.
On slow systems, it is likely that a DCM error (timeout) of the form ADMN-906005 is displayed. If this occurs, run the
$ORACLE_HOME/dcm/bin/dcmctl getReturnStatus
command and wait until the command exits. This confirms that the changes have been propagated to the DCM repository.
<cluster-config/>
under the <orion-web-app>
tag in the following file:
ORACLE_HOME/j2ee/OC4J_ wireless/application-deployments/ptg/ptg-web/orion-web.xml
$ORACLE_HOME/dcm/bin/dcmctl start
ORACLE_HOME
of the active EM installation:
$ORACLE_HOME/bin/emctl start
Currently, high availability support is only available for the core server runtime (by default mapped to the URI /ptg/rm
).
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 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 directory 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.
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:
For information on ASK/SMS Access, refer to the following Web site:
http://otn.oracle.com/products/owireless/wv_refcard_sms.pdf
For information on Voice Access, refer to the following Web site:
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>]
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
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)
Example:
find John,Jack,Smith
Mail Async supports the following commands:
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/FunSpec.h tml
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 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 myfriend "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.To browse the contents of a given directory:
files [<directory>]
Example:
files /Private
(If left empty, the home directory is assumed)
Follow the steps below to configure Oracle Files.
In this file:
$ORACLE_HOME/j2ee/OC4J_Wireless/config/application.xml
After this line:
<library path="%ORACLE_HOME%/wireless/lib/wireless.jar"/>
Add the following line:
<library path="%ORACLE_HOME%/wireless/lib/mod_pim_webdav_httpclient.jar"/>
Replace %ORACLE_HOME% with the absolute path for the middle tier Oracle home location. Then restart the instance for this change to take effect.
If the wireless PIM Module of Oracle Files is used in a multi-byte character set environment, the default character set for Oracle Files must be Unicode (UTF-8). This preference is set at the subscriber level and can be overridden at the user level.
Jabber, which is the backend we use with Instant Messaging does not support multibyte usernames, thus the Instant Messaging module consequently also does not support multibyte user names.