Release Notes for iPlanet™ Portal Server: Mobile Access Pack

Version 3.0

Updated January 29, 2003

These release notes contain important information available at the time of the version 3.0 release of iPlanet™ Portal Server: Mobile Access Pack software. Known problems and other late-breaking issues are addressed here. Read this document before you begin using the iPlanet Portal Server: Mobile Access Pack product.

An electronic version of these release notes can be found at the following documentation web site: http://docs.sun.com/prod/s1portalsrv. Check the web site prior to installing and setting up your software and then periodically thereafter to view the most up-to-date release notes and manuals.

These release notes contain the following sections:

The iPlanet Portal Server: Mobile Access Pack, Version 3.0 Software
Software Recommendations
Known Problems and Limitations
How to Report Problems
For More Information

The iPlanet Portal Server: Mobile Access Pack, Version 3.0 Software

The iPlanet Portal Server: Mobile Access Pack software extends the broad services and content aggregation platform provided by the iPlanet™ Portal Server product to mobile devices. By default, the iPlanet Portal Server: Mobile Access Pack server includes support for the following clients:

Netscape 4.06 with JavaScript™ technology or Microsoft Internet Explorer 4.0 with Secure Sockets Layer (SSL) 3.0 for HTML clients

Openwave browsers using WML

DoCoMo phones using cHTML

Nokia 7110 phone using WML

Siemens S35 phone using WML

Panasonic P503i phone using cHTML

Refer to the iPlanet Portal Server: Mobile Access Pack Administration Guide 3.0 for information on extending support for other mobile devices.

Software Recommendations

The following software is certified to run with iPlanet Portal Server: Mobile Access Pack server:

For the Mobile Access Pack Server

The Solaris™ 8 Operating Environment, the Solaris™ 7 Operating Environment, or the Solaris™ 2.6 Operating Environment

iPlanet Portal Server 3.0 Service Pack 3a software

iPlanet™ Messaging Server 5.1 software

iPlanet™ Calendar Server 5.0p3 software

iPlanet Calendar Server 5.0p4 software

Sun™ ONE Calendar Server 5.1.1 software

For Nokia 7110

V 04.84

07-04-00 (April 07, 2000)

NSE-5

To display the current version of the software on the Nokia phone, enter *#0000#

For Siemens S35

V 05

To display the current version of the software on the Siemens phone, enter *#06# and then press the left soft key.

Known Problems and Limitations

The following is a list of known problems in the server:

The iPlanet Portal Server: Mobile Access Pack product does not read language properties files (4530612)

Only English language text is available, because the iwtWirelessBookmarkProvidercHTML_LANG.properties file and the iwtWirelessBookmarkProviderWML_LANG.properties file are not picked up properly.

Workaround

The value of the resource bundle attribute for iwtWirelessBookmarkProvidercHTML and iwtWirelessBookmarkProviderWML must be changed. To do so, complete the following steps:

Use the ipsadmin command to change the value of the attributes with this code:

iwt:Att name="iwtWirelessBookmarkProvidermarkup-resourceBundle"
   type="string"
   idx="a100"
   userConfigurable="false"

<Val>iwtWirelessBookmarkProvidermarkup</Val>
   <Rperm>ADMIN</Rperm>
   <Rperm>OWNER</Rperm>
</iwt:Att>

Replace markup with cHTML or WML.

Restart the server.

Detached channels in HTML desktop creates errors on WML desktop (4479802)

If the user logs in to the desktop from an HTML client, detaches a channel (such as the Calendar channel) common to HTML and WML clients on the HTML desktop, logs out, and accesses the desktop via a WML (UP4.1) client, the server reports a compile error.

Workaround

Instruct the user to not detach channels that will be accessed from a mobile device.

In the calendar, line breaks in the event description text area are not retained (4496606)

In the calendar, the line breaks entered in the event description text area are not retained. The calendar server converts newlines to spaces.

In the calendar, sometimes, the user cannot remove description of a repeating event (4496628)

When the user logs in to the home page from the phone and connects to the calendar server, via the calendar channel, and deletes the description of a repeating event, sometimes the event's description value does not appear modified when the user views the event from the phone.

Sometimes, the Content option on the Home page of the Nokia 7110 phone freezes the phone (4499280)

After logging in, if the user changes the content from the Options->Content menu on the phone, the phone freezes. Sometimes the display flashes, disconnects the call, and returns the user to the main display of the phone. The user must turn off the phone and clear the cache before trying to reconnect to the portal home. Otherwise, errors will be displayed and the phone may freeze again.

Workaround

Change the maxSize in iwtClient-clientType for Nokia 7110 to be 1500 or fewer characters. However, only one channel will be visible on the phone with this recommended configuration.

The user must frequently clear the cache on the Nokia.

The server does not display the authentication menu on Nokia 7110 after session timeout (4502998)

If the user's session times out, the following error message is displayed on the user's phone:

Session Times Out. Your session has timed out.

Although the link to relogin is available, the authentication menu is not displayed for the user to relogin. This is because, on most error pages generated by the LoginServlet class, an error file is loaded with relative links to /login. The Nokia phone does not handle the relative links and does not contact the server.

Workaround

Replace /login in the following files at /etc/opt/SUNWips/auth/default/wml with the fully qualified URL to the server:

invalid_domain.wml

login_denied.wml

login_license_fail.wml

login_prompt.wml

module_denied.wml

noLoginWorker.wml

privilige_failure.wml

session_invalid.wml

session_timeout.wml

For example, modify the files to include the following:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">

<wml>
   <head>
         <meta http-equiv="Cache-Control" content="max-age=0"/>
   </head>
   <card id="logout" title="Session Timed Out">
         <p>
            Your session has timed out.
            <do type="accept" label="Menu">
                  <go href="http://<servername.domain>/login"/>
            </do>
         </p>
   </card>
</wml>

An error is displayed if address book is not configured correctly (4503071)

When composing or forwarding a mail, the user will encounter a server error if the address book is not properly configured.

Workaround

Ensure that the address book is configured correctly.

All day events in the calendar are not calculated into the summary of events for certain time zones (4504049)

All day events are not calculated into the summary of the number of events for a day. The all day events added via the phone are added to the summary of the day prior to the actual event day. This behavior can be noticed in countries in GMT+12, GMT+13, GMT+14, and GMT-12 timezones only.

All day events entered in the calendar from a web browser are displayed in the middle of the events list (4505843)

If the user enters an all day event from Calendar Express and has regular events scheduled before noon and after noon, the all day event is displayed between regular events. However, all day events entered from the phone are displayed at the beginning of the events list.

When composing a mail from the phone, selecting the more button throws an error (4506619)

When composing an email, if the user selects the more button to add entries from the address book, an error will be displayed on the phone. This happens only when the address book collection (on a single page) that the address book server fetches contain no email address for the entries.

Workaround

Instead of displaying the email address of the addressee, display the firstname and lastname of the addressee. Modify the following files:

<iPS_install_base>/SUNWips/public_html/default/jsp/mail/wml/UP/pickaddr.jsp

<iPS_install_base>/SUNWips/public_html/default/jsp/mail/wml/Nokia/pickaddr.jsp

To modify:

Change directories and edit the pickaddr.jsp files as follows:

Replace the following original code: %><ab:entries name="ablist" iterate="true"><% %><ab:entry><% %><util:if property="em"><% %><util:link tagstart="<option" tagend=">"><% %><util:attr attr="value"><ab:get property="em" edit="emsg1"/></util:attr><% %></util:link><ab:get property="em" edit="emsg1"/></option><% %></util:if><% %></ab:entry><% %></ab:entries><%
With the following new code: %><ab:entries name="ablist" iterate="true"><% %><ab:entry><% %><util:link tagstart="<option" tagend=">"><% %><util:attr attr="value"><ab:get property="em" edit="emsg1"/></util:attr><% %></util:link><% %><util:if property="fn"><% %><ab:get property="fn" edit="edit1"/> <% %></util:if><% %><ab:get property="ln" edit="emsg1"/></option><% %></ab:entry><% %></ab:entries><%

The user is not able to send mail if SMTP server name is not specified (4506646)

The user may not be able to compose a mail, or forward, or reply to an email if the SMTP server name is not explicitly specified. By default, the server uses the IMAP server as the SMTP server when no SMTP server is specified explicitly.

Workaround

Specify the SMTP server either for each user or per domain (see Chapter 7 of the iPlanet Portal Server: Mobile Access Pack Administration Guide 3.0 for information on configuring the mail channel).

The Subject field is empty when replying to a mail (4507377)

From the Siemens S35 phone, when the user replies to an email (sent from Netscape 4.x) with a subject that is longer than 30 characters, the subject will appear blank in the reply.

Workaround

Either instruct the user to restrict the characters in the subject field to 30 or instruct the user to enter the subject manually when responding to a mail.

The phone does not return to the email inbox (4509110)

The bug only occurs when using SSL and when the user connects to the address book and selects an address book entry to send email to. After composing and sending an email, the phone does not return the user to the email inbox (which it should).

Workaround

When using SSL, the user must compose email messages from the mail application. That is, the user must use the mail application instead of the address book application in order to send email.

The server does not use the specified number of characters when displaying the event location description on a mobile device (4509554)

The number of characters from the location (of the event) field to be displayed on a mobile device can be customized from the administration console and from the command line (by modifying the iwtCalendarProvider-jspLocationLength attribute). However, the server is using the number of characters specified for displaying the event summary (specified in the iwtCalendarProvider-jspSummaryLength attribute) when displaying the event location.

Workaround

Modify the following files:

<ips_install_base>/public_html/jsp/default/cal/wml/event.jsp

<ips_install_base>/public_html/jsp/default/cal/chtml/event.jsp

To modify:

Change directories and edit the event.jsp files as follows:

Create a new edit tag in the file:

<util:edit id="edit3">
   <util:set property="truncation"
   value="$/iwtCalendarProvider:jspLocationLength:25/"/>
   <util:set property="escape" value="true"/>
</util:edit>

Replace the following line:
   <util:msg name="i18n" key="location"/>: <cal:get
      property="location" edit="edit1"/><br/>

With the following line:
   <util:msg name="i18n" key="location"/>: <cal:get
      property="location" edit="edit3"/><br/>

Save and close the files.

Note

The number of characters specified from the administration console or by modifying the iwtCalendarProvider-jspLocationLength attribute overwrites the number of characters specified in the edit tag. However, if no value is specified from the administration console or in the iwtCalendarProvider-jspLocationLength attribute, the number of characters specified in the edit tag is used.

The server does not use the specified number of characters when displaying the from header on a mobile device (4509555)

The number of characters from the from header (of a message) to be displayed on a mobile device can be customized from the administration console and from the command line (by modifying the iwtMailProvider-jspFromLength attribute). However, the server is using the number of characters specified for displaying the subject summary (specified in the iwtMailProvider-jspSubjectLength attribute) when displaying the from header.

Workaround

Modify the following files:

<ips_install_base>/public_html/jsp/default/mail/wml/UP/inbox.jsp

<ips_install_base>/public_html/jsp/default/mail/wml/Nokia/inbox.jsp

<ips_install_base>/public_html/jsp/default/mail/chtml/inbox.jsp

To modify:

Change directories and edit the inbox.jsp files as follows:

Create a new edit tag in the file:

<util:edit id="emsg2">
   <util:set property="truncation"
   value="$/iwtMailProvider:jspFromLength:23/"/>
   <util:set property="escape" value="true"/>
</util:edit>

Replace the following line:
<mail:get property="from" edit="emsg1"/>:

With the following line:
<mail:get property="from" edit="emsg2"/>:

Save and close the files.

Note

The number of characters specified from the administration console or by modifying the iwtMailProvider-jspFromLength attribute overwrites the number of characters specified in the edit tag. However, if no value is specified from the administration console or in the iwtMailProvider-jspFromLength attribute, the number of characters specified in the edit tag is used.

The uninstaller cannot remove Mobile Access Pack packages after portal server upgrade to iPlanet Portal Server 3.0 Service Pack 4 software (4766763)

This bug is introduced by upgrading iPlanet Portal Server 3.0 Service Pack 3 software to iPlanet Portal Server Service Pack 4 software.

Install script fails when installing the Chinese localized version of MAP 3.0 in Chinese localization of Solaris 8 Operating Environment (4768594)

The Chinese localization of the Solaris 8 Operating Environment translates the variable word "VERSION" to Chinese, causing the install script to fail.

Workaround

After the Chinese localization of the iPlanet Portal Server 3.0 product has been successfully installed, do the following:

Run the mapinstall script in the C locale.
1. Log in as root.
2. Type:
  
  # LANG=C
3. Type:
  
  # export LANG
4. Type:
  
  # ./mapinstall
Use the pkgadd command to manually add the Chinese locale Mobile Access Pack packages.
1. Go to directory that contains the Chinese locale Mobile Access Pack packages. Type:
  
  # cd MAP/locales/zh/server
  
  # ls
The following directories are displayed:

SUNWcwcct/ SUNWcwcwt/ SUNWcwde/ SUNWcwpct/ SUNWcwpwt/

SUNWcwcht/ SUNWcwda/ SUNWcwp/ SUNWcwpht/
1. Manually add each package from SUNWcwcct to SUNWcwpht. For example:
  
  # pkgadd SUNWcwcct
Restart server in zh locale.
1. Type:
  
  # LANG=zh
2. Type:
  
  # export LANG
3. Go to the installation directory and type:
  
  # /opt/bin/ipsserver start

How to Report Problems

If you have problems with iPlanet Portal Server: Mobile Access Pack server, contact customer support using one of the following mechanisms:

Sun ONE online support web site at http://www.sun.com/service/sunone/software/

From this location, the CaseTracker and CaseView tools are available for logging problems.
The telephone dispatch number associated with your maintenance contract

So that we can best assist you in resolving problems, please have the following information available when you contact support:

Description of the problem, including the situation where the problem occurs and its impact on your operation
Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem
Detailed steps on the methods you have used to reproduce the problem
Any error logs or core dumps

For More Information

Useful product information can be found at the following Internet locations:

Release notes and other documentation — http://docs.sun.com/prod/s1portalsrv
Product status — http://www.sun.com/service/sunone/software/
Professional Services information — http://www.sun.com/service/sunps/sunone/
Developer information — http://developer.iplanet.com/
Learning solutions — http://wwws.sun.com/software/training/
Product data sheets — http://wwws.sun.com/software/

Sun, Sun Microsystems, the Sun logo, Sun ONE, the Sun ONE logo, iPlanet, the iPlanet logo, JavaScript, and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Netscape and the Netscape N logo are registered trademarks of Netscape Communications Corporation in the U.S. and other countries. Other Netscape logos, product names, and service names are also trademarks of Netscape Communications Corporation, which may be registered in other countries.
Sun, Sun Microsystems, le logo Sun, Sun ONE, le logo Sun ONE, iPlanet, le logo iPlanet, JavaScript, et Solaris sont des marques déposées ou enregistrées de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays. Netscape et le logo Netscape N sont des marques déposées de Netscape Communications Corporation aux Etats-Unis et d'autre pays. Les autres logos, les noms de produit, et les noms de service de Netscape sont des marques déposées de Netscape Communications Corporation dans certains autres pays.

Last Updated January 29, 2003