Sun Java System Instant Messaging 7 2006Q1 Release Notes

Sun Java System Instant Messaging Release Notes

These Release Notes contain important information available at the time of release of Sun Java System Instant Messaging 7 2006Q1. New features and enhancements, known issues and limitations, and other information are addressed here. Read this document before you begin using Instant Messaging 7 2006Q1.

The most up-to-date version of these release notes can be found at the Sun Java System documentation web site: http://docs.sun.com/. 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 product documentation. These release notes contain the following sections:

Third-party URLs are referenced in this document and provide additional, related information.


Note –

Sun is not responsible for the availability of third-party Web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.


About Instant Messaging 7 2006Q1

Sun Java System Instant Messaging delivers secure presence and extended real-time messaging, enabling communities of users to communicate and collaborate instantly and securely. It combines instant messaging capabilities with conferences, alerts, news, polling and file transfer to create a rich collaborative environment. It leverages an existing community, managed using LDAP, Sun JavaTM System Identity Server or Sun JavaTM System Portal Server.

What’s New in This Release

This section describes the following new features added to Instant Messaging in this release:

Multi-node Deployment Support

This release of Instant Messaging allows you to connect multiple Instant Messaging servers to provide the same service as a single server. This allows for horizontal scalability and increases availability through redundancy.

HTTP Gateway

This release includes an HTTP gateway that allows users to connect to the XMPP server over HTTP. This feature can be used to enable HTML/JavaScript Instant Messaging clients, J2ME 1.0 clients, or to traverse firewalls.

Email Archiving

You can now configure the Instant Messaging server to send a copy of an instant message or conversations via email. This provides a natural way for end users to retrieve past conversations or alerts. You can also use it for compliance and auditing purposes.

Client Enhancements

On Windows, users can configure Instant Messenger to automatically start when the system boots. Improvements to client diagnostics are also included and vcard support is now available.

XMPP Host Resolution Using DNS SRV Records

DNS resolution of Instant Messaging hosts is now supported by the API and the server. In previous releases, a Instant Messaging server used a logical domain unique to Instant Messaging instead of the DNS domain to identify itself and its users to other Instant Messaging servers. In this release, Instant Messaging server now use the fully-qualified domain name to identify itself on the network.

Additional Logging for XMPP

With this version you can now leverage the full power of log4j. This provides ways to control the format of log records, and logging destinations.

Enhanced Calendar and Access Manager Configuration

The configure utility now prompts you for information about Sun Java System Calendar Server and Sun Java System Access Manager. You no longer have to manually configure Instant Messaging to work with these servers.

Changes to Existing Functionality and Deprecated Features

The following features have changed or are not supported for this release:

Hardware and Software Requirements

This section lists the requirements for installing Instant Messaging software. Before you install, ensure you have met the minimum hardware and operating system requirements. JRE 1.4 is supported by both server and client. In addition, check for any product patches before you install.

The following hardware and software are required for this release of Instant Messaging software.

Server Operating System Requirements

This release of Sun Java System Instant Messaging supports the following platforms:

A list of recommended patches for Solaris can be found at the following location:

http://sunsolve.sun.com

Server Software Requirements

This version of Instant Messaging is compatible with the following versions of other server software:

Server Hardware Requirements

The minimum hardware requirements for installing Sun Java System Instant Messaging are as follows:

Client Operating System Requirements

This release supports the following client platforms:

Client Software Requirements

This release of Instant Messaging supports any XMPP-compliant client in addition to Instant Messenger. The jabber.org website has a full list of XMPP-compliant clients.

On Windows, you can run Instant Messenger using the browser’s Java plug-in from the following browsers:

If the client machine has Java 1.4 or a higher version installed, there are no additional requirements to use either Java Plug-in or Java Web Start. Netscape Navigator v7 as well as the recent versions of the Mozilla browser include Java v1.4 or higher. Internet Explorer does not include the latest version of Java. If you experience problems using the client with Java 1.4, upgrade to 5.0. JDK 5.0 is included with Sun Java System Instant Messaging.

If the client machine does not have Java v1.4 or a higher version installed, you need to install it. You can download and install Java v1.4. from the following location:

http://java.sun.com/j2se

HTML links can be exchanged over Instant Messenger and activated from the messenger by clicking them. When a link is activated, the messenger invokes a browser. Table 1 lists supported operating system and browser combinations.

Table 1 Supported Client OS and Browser Combinations

Operating System  

Browser  

Solaris 

Netscape Communicator 4.7x or later 

Red Hat Linux 7.x 

Netscape 4.7 

Red Hat Linux 8.0 or later 

Mozilla 1.2 or later 

Windows 98/ME/NT/2000/XP 

no restrictions 

Mac OS X 

no restrictions 

Client Hardware Requirements

Instant Messenger uses between 20 and 40 MB of memory on most platforms. You should estimate the memory requirement by including the requirements of other applications (including operating systems) used on the client machine. In most cases, at least 128 MB RAM is recommended in order to run Instant Messenger and other applications comfortably. This number becomes higher when using memory-intensive operating systems.

Accessibility Features for People with Disabilities

To obtain accessibility features that have been released since the publishing of this media, consult Section 508 product assessments available from Sun upon request to determine which versions are best suited for deploying accessible solutions. Updated versions of applications can be found on the Sun Java Enterprise System software download page.

For information on Sun's commitment to accessibility, visit Sun's Accessibility Program.

Bug Fixed in This Release

The following table describes bugs fixed in Instant Messaging 7 2006Q1 since the last release.

Table 2 Fixed Bugs in Instant Messaging 7 2006Q1

Bug Number  

Description  

5006892, 5072583 

(Windows Only) You can now configure the client to start when you boot your computer. In addition, you can now add a shortcut to the startup folder for Instant Messenger  

5077008 

User status change pop-ups now work as expected. 

5088422 

Instant Messenger now warns users of the potential risks of accepting an invalid certificate. 

5089753 

The Instant Messaging server can now create LDAPS connections. 

5105226 

You can now close a chat window by clicking the “X” icon on the chat window. 

6199743 

Previously, if you typed Japanese characters in the chat window and then copied and pasted the characters again in the chat window, you could not see the pre-edit strings in the chat window. This no longer occurs. 

6202905 

Instant Messaging now supports vcards per JEP-0054. 

6203662 

Previously on Linux, the monitoring agent was not enabled by default when you installed Instant Messaging. This no longer occurs. 

6264578 

The imadmin version command now returns the correct product version.

6269951 

The server now responds with an error when it rejects a JID that contains the at sign (@). 

6271708 

Problems using SSL in a server-to-server environment no longer occur. 

6302963 

The Instant Messaging server and API now use the stringprep standard for JID normalization and matching rules.

6303062 

The Instant Messaging server now returns a conflict error when a user attempts to use a nickname that is already in use. In addition, the server now supports changing nicknames. 

6306638 

Instant Messaging now prevents you from using imadmin start, imadmin stop, and imadmin refresh in a deployment with Sun Cluster. Use the Sun Cluster utilities to start, stop, and refresh Instant Messaging components.

6307051 

New user registration is now supported when using the XMPP/HTTP gateway. 

6316963 

Email archiving of news channels no longer fails with a null pointer exception. 

6318101 

Previously, a contact's JID was sometimes displayed in the client roster (contact list) instead of the contact's display name. This no longer occurs. 

6319820 

Session priority is no longer set before presence information is received. 

6321820 

Support has been added for muc_presencebroadcast.

6324595 

Instant Messenger no longer crashes when transferring large files in a single server deployment. 

6334537 

Previously, an inactivity loop was causing a concurrent modification exception to be thrown by the multiplexor. This no longer occurs. 

6336947 

A problem was fixed in which the redbadmin generate command would create the wrong redirect database in iim.instancevardir/db if iim.conf contained specific parameters and values. This occurred in deployments with pooled servers that use a shared file system.

6339599 

The name of the search field on the Search Room dialog has been changed from Name to ID. 

6340833 

Conference email archiving no longer fails with a null pointer exception.  

Important Information

This section contains the latest information that is not contained in the core product documentation. This section covers the following topics:

Installation and Upgrade Notes

Localization Notes

The Sun Java System Instant Messaging 7 2006Q1 Administration Guide is available only in English. This book has not been localized for this release.

Compatibility Issues

Instant Messenger 7 2006Q1 requires the 7 2006Q1 server. Server-to-server communication is compatible between 7 2005Q4 and 7 2006Q1 releases of the server. No changes are required to the server configuration (in iim.conf) and no migration of other server-related data is required. Refer also to the Sun Java Enterprise System 2005Q4 Upgrade and Migration Guide.

Performance, Scalability, and Sizing Considerations

This section describes some information useful for tuning and performance when deploying Instant Messaging in a server pooled configuration and for optimizing garbage collection in the following sections:

This information should be used with the Sun Java System Communications Services 6 2005Q4 Deployment Planning Guide.


Caution – Caution –

In a server pool deployment, you need to setup each Instant Messaging server in the server pool identically.


Tuning Instant Messaging Server Memory

Use the J2SE version 5 for running the Instant Messaging server, because it performs better and does not require command line tuning as it supports ergonomic features. More information on the use of this version of Java can be found in the following documents:

The Instant Messaging server uses the iim.jvm.maxmemorysize parameter in iim.conf to set the maximum size of the JVM heap to allocate. The default value of this parameter is 256 MB, but a large active deployment of Instant Messaging will need more memory. Determining how much memory to allocate for the Instant Messaging servers in the server pool is dependent on how many concurrent active users you need to support. Each Instant Messaging server in the server pool needs 256 MB along with 65 KB for each connected/active user with daily usage like the following:

Additional load per user, use of additional Instant Messaging services like news or file transfer, and use of features such as message filters, archiving, or SSL will consume more memory. You should perform load profiling of typical user activity before deploying Instant Messaging into a production environment. Contact Sun Support Services for more information about load profiling an Instant Messaging deployment.

Thread Pooling and Service Port Configuration

Instant Messaging provides a set of configuration options to tailor the size and behavior of thread pools used to service client to server and server to server requests. These thread pools combined with associated service ports can improve the throughput of an Instant Messaging server.

Option Name 

Description 

Default Value 

iim_server.maxthreads

Maximum number of threads for the default threadpool. 

20 

iim_server.threadpool

List of independent thread pools. 

(Everything uses the default thread pool.) 

iim_server.threadpool.capacity

Capacity(*) of the default threadpool. 

10 * maxthreads 

iim_server.threadpool.aaa.maxthreads

Maximum threads for named threadpool aaa:

maxthreads(aaa)

iim_server.threadpool.aaa.capacity

Capacity of named threadpool aaa.

10 * maxthreads(aaa) 

Table 3 Defined Thread Pools for Instant Messaging

Name 

Use 

s2s-in 

All server to server inbound communications. If the port allows server to server, this thread pool is used. 

s2s-out 

All server to server outbound communications. If the port allows server to server, this thread pool is used. 

s2s 

All server to server communications; the union of s2s-in and s2s-out. 

Defined threadpools can be specified and used with an associated server only service port, as described in Service Port Configuration.

When a threadpool's capacity is exceeded, a message is output to standard error. The Instant Messaging server will not accept any additional requests for the threadpool until the number of requests is lower than the value of the threadpool's capacity. If this condition occurs in a server pooled environment, you may need to:


Example 1 Using the Defined Threadpool to Reserve Five Threads for Server to Server Inbound Communications for Instant Messaging


!s2s thread pool
iim_server.threadpool=s2s-in
iim_server.threadpool.s2s-in.maxthreads=5

Service Port Configuration

There are a number of service port configuration options as described in this section.

Option 

Definition 

Default Value 

iim_server.useport

Open normal ports (allow for StartTLS). 

true 

iim_server.usesslport

Open SSL ports (non-negotiable TLS) 

false 

iim_server.usemuxport

Open multiplexor ports 

true 

iim_server.port

List of normal ports 

5269 

iim_server.sslport

List of SSL ports 

5270 

iim_mux.serverport

List of multiplexor ports 

45222 

iim_server.port.port.sndbuf

Socket send buffer size

none 

iim_server.port.port.rcvbuf

Socket recv buffer size

none 

iim_server.port.port.interface

List of specific network interfaces to bind to 

none (Indicates any) 

iim_server.port.port.protocol

List protocols are permitted on this port (client, server, component, peer)  

all/any 

iim_server.port.port.nodelay

Enables the Nagles algorithm 

false 

Throughput of a service port may be improved by adjusting the size of a port's send of receive buffer sizes.


Example 2 Service Ports Configuration for Instant Messaging


iim_server.port = 5269, 45269, 15222
iim_server.port.5269.protocol = server
iim_server.port.45269.protocol = peer, component
iim_server.port.45269.sndbuf= 512000
iim_server.port.45269.recvbuf= 512000
iim_server.port.15222.protocol = client 

Tuning Garbage Collection for Instant Messaging

(Issue Number: 6279277) Due to differences in the way the 1.4.2 and 1.5 versions of the JRE handle garbage collection, you may experience less than optimal performance using the default garbage collector with version 1.4.2 on the server's host. To fix this, you can either upgrade to version 1.5 of the JRE, or include the following command line option when you invoke the server:


-XX:+UseParallelGC

For more information about JRE garbage collection, see the following:

Documentation Updates for Instant Messaging 7 2006Q1

(Issue Number: 6298156) The online help incorrectly states that conference moderators can edit messages before accepting them. This is incorrect. Conference moderators cannot edit messages sent by other users.

(Issue Number: 6279307) The online help does not mention that if you remove all contacts from a contact group, then logout and back in, the contact group will be deleted.

(Issue Number: 5010947) The documentation should state that the multiplexor queries DNS directly and does not use getbyhostname. If you are not using DNS for hostname resolution, you can use IP addresses instead of hostnames in iim.conf. If you are using DNS, change hosts in nsswitch.conf as follows:


hosts: files dns

Known Issues and Limitations

This section contains a list of the more important known issues at the time of the Instant Messaging 7 2006Q1 release.

Patch updates are issued on a frequent basis. If you encounter a problem while installing or using Sun Java System Instant Messaging, contact Sun Support to enquire about the availability of a fix for this problem.

Known Issues and Limitations lists the known problems and limitations.

Table 4 Known Problems and Limitations

ID 

Summary 

4609599 

In order to use customize the font of multibyte characters, you need to type in your text first, then highlight the text and apply the font customization. 

4632723 

Idle detection is not implemented on Mac OS. 

If a user leaves an Instant Messaging session, the absence is not automatically detected. 

Workaround: 

Mac OS users need to explicitly set their presence status as AWAY, prior to leaving. 

4806791 

Alerts with embedded images are not rendered faithfully. 

When a recipient receives an alert with embedded images, the images are not centered and font information present in the accompanying text is lost. 

4841572 

Custom statuses cannot be removed. 

Workaround: 

The least used statuses are eventually removed. To remove one immediately, add five new customized statuses and the oldest one will disappear. 

4846542 

On MAC OS, trying to print from the Java Web Start client hangs Instant Messenger. 

Workaround: 

Copy the message and paste it in some other application, then print. 

4852882 

If the Calendar server alarm type is set to text/xml, that is:

caldb.serveralarms.contenttype = "text/xml"

The Reminder field in the Instant Messenger Task Due Reminder alert window is blank. 

Workaround: 

Set this field to "text/calendar".

4858320 

Confusing behavior occurs when inviting a user to a conference when that user does not have the correct permissions to join the conference. It appears as if you invited the user, when in fact, the user never received the invitation. 

4860906 

Can’t create conf_room/news using certain gb18030 characters

Since conference and news ACL file names are written using names fed from Instant Messenger, there is a problem creating ACLs when the names contain Tibetan or Arabic characters.

4871150 

Printing errors occur with Instant Messenger in some locales. 

Workaround: Cut and paste the text you want to print to another application that can print. 

4922347 

Read-only users and fully privileged users within a chat room are indistinguishable. This might be confusing if a user attempts to send a message to a user with read-only privileges. The read-only user will not receive the message. 

4929247 

Users cannot send messages when a moderator has denied presence access for the user. 

4929295 

When multiple Instant Messaging policies are applied to a user, the policies can contradict one another. For example, when the “Regular” and “Conference Room Administrator” policies are attributed to a user, the user is unable to manage conference rooms. 

Workaround: 

Edit the regular user policy by clearing the “Ability to manage conference rooms” checkbox. This will ensure that the two policies do not conflict. 

4944558 

The Web Poll tab on the Alert window doesn’t display some web pages correctly. This is a limitation of the Java HTML renderer.

Workaround: 

Send URLs using Message Creation tab instead of the Web Poll tab. 

4960933 

Windows task bar menu labels are not rendered properly in some locales with multibyte characters. The menu functionality is not affected. 

4978293 

In zh_HK locales, Instant Messenger displays English.

Workaround: 

In order to see traditional Chinese (zh_TW) messages on a machine that uses a zh_HK locale for login, you need to create a symbolic link to zh_TW. 

5004449, 5084745 

On Linux, warning messages might be displayed on screen when you run the configure utility. Typically, these warning messages begin with the following text: 


WARNING: Cannot parse rpm files
by running "/bin/rpm -qp --queryformat

Configure should still work as expected, as no error really occurs. 

5010947 

The documentation should state that the multiplexor queries DNS directly and does not use getbyhostname.

Workaround: If you are not using DNS for hostname resolution, you can use IP addresses instead of hostnames in iim.conf. If you are using DNS, change hosts in nsswitch.conf as follows:

hosts: files dns

5042884 

A problem with the archive provider enables end users to view archived data in search results. 

5050973 

News message properties are not sent with news messages. As a result, the following client capabilities might be affected: 

  • Subject is not displayed along with the news message.

  • Cannot change lines in the news message so that everything appears collapsed.

  • The formatting of the news messages might be lost.

  • Unable to send attachments.

  • Unable to send images.

5051299 

In server-to-server communications, news channel access rights might not work for end users. For example, a user whose access is set to NONE is able to have READ access.

5051369 

In server-to-server communications, an end user subscribed to a news channel on a different server is unable to chat with the message creator of the news channel. 

5051371 

In server-to-server communications, access rights for end users, such as NONE, READ, and WRITE, do not function properly in conference rooms.

5065241, 5080586 

Users are given the option to change presence status while Instant Messenger is not connected to the server. Any modifications made to status while disconnected do not take effect. 

5071025 

If you create a new contact group in Instant Messenger but do not assign any contacts to the group, then logout and log back in, the contact group no longer appears in the contact list. 

Workaround: Add a contact to the contact group before logging out of Instant Messenger. 

5082579 

User status remains online even after the network connection is lost. 

5087303 

The Instant Messenger Login dialog box does not necessarily display the server the end user last successfully logged into. This behavior is inconsistent with the behavior for username, where the last successfully used username is displayed in the Login dialog box. 

Workaround: 

  1. On the Login dialog box, click More Detail.

  2. Select the appropriate server from the Server drop-down list.

5104840 

Changes users make on the Settings dialog box Privacy tab are saved as the changes are made, not when the user clicks OK. For this reason, if you click Cancel after making changes on this tab, the changes are saved anyway. 

6186465 

An additional carriage return might be added when cutting and pasting text in Instant Messenger. 

6195180 

The title and sender might not be displayed in the News window. 

6200472 

If you intend to run the Sun Java System Instant Messaging 6 2004Q2 server with the SDK from this release, you will need to explicitly set the property of the collaboration session factory object to use the legacy protocol implementation. The SDK for this release supports the legacy protocol implementation; however, the default is to use the new protocol implementation (XMPP). To use the legacy protocol implementation, you need to use the following constructor to create a CollaborationSessionFactory in the API:


CollaborationSessionFactory factory=new
CollaborationSessionFactory("com.iplanet.im.client.api.iIMSessionFactory");

6203957 

On Linux, if the openLDAP client RPM is not installed, imServiceConfigure might fail when trying to run ldapmodify.

6205657 

If you change access permissions for users already in a conference room, the changes do not take effect until you relaunch the conference room window. 

Workaround: Close and relaunch the conference room window to update access permissions. 

6213223, 6217766 

If you post a message to a news channel then log out without viewing the message you just posted, the message appears to be lost. The messages are there, just not visible. 

Workaround: View any messages you post to news channels before logging out of Instant Messenger, or unsubscribe and resubscribe to the news channel. 

6213365 

Instant Messaging service fails to start after upgrade. 

Workaround: Remove SUNWiimdv package before upgrading.

6217627 

On a machine with less than the required memory, the configure utility might complete configuration of Instant Messaging, but also throw exceptions. 

Workaround: Ensure that your system meets the minimum memory requirements before installing or running the configure utility. If you still encounter this problem, run the following:

Solaris: /opt/SUNWiim/lib/imServiceConfigure

Linux: /opt/sun/im/lib/imServiceConfigure

6244099 

The Administration Guide contains confusing information for enabling the Instant Messenger Archive Control component for the Java Plug-in. This component is not present in this release. 

6279277 

Memory performance degradation occurs with default garbage collection used by JRE 1.4.2 on the server's host. 

Workaround: See Performance, Scalability, and Sizing Considerations for instructions.

6279307 

The online help does not mention that if you remove all contacts from a contact group, then logout and back in, the contact group will be deleted. 

6282401 

Sun Java System Instant Messaging 6 2004Q2 is not compatible with the shared components that ship with this release. 

Workaround: If you must upgrade the shared components, then upgrade all Instant Messaging components to the current version. 

6282887 

On Windows 2000, in localized versions of Instant Messenger, the first item in the folder pop-up menu does not display correctly. The text should say “Collapse.” 

6286776, 6288533 

Problems running Instant Messenger in a server-to-server environment. 

Workaround: Download the product patch from SunSolve Online.

6291159 

Instant Messenger disconnects from the server after a time period different from the value set for the iim_server.clienttimeout parameter in iim.conf.

Workaround: Specify the following system property using the -D option:


com.sun.im.service.xmpp.session.keepaliveinterval

Set the value to the number of seconds after which you want Instant Messenger to start sending bytes to the server. These bytes are only used to prevent the time out and subsequent disconnect. 

6292212 

If a client connected over SSL becomes disconnected and attempts to reconnect, the user will be prompted to accept the certificate again. 

6298156 

The online help incorrectly states that conference moderators can edit messages before accepting them. Conference moderators cannot edit messages. 

6302273 

In deployments with Sun Java System Access Manager, if Sun Java System Access Manager times out, Instant Messenger disconnects and cannot reconnect until the Instant Messaging server is restarted. 

Workaround: Download the product patch from SunSolve Online.

6302312 

If Instant Messenger becomes disconnected from the server, it may not function properly when it reconnects. For example, presence information may not be displayed correctly, and conference rooms will not work. 

Workaround: To join a conference room after a disconnect occurs, click the chat icon instead of double-clicking the conference on the Conferences tab. In addition, you can download the product patch from SunSolve Online.

6303248 

If the server is configured to use text/xml format for Calendar pop-ups, task pop-ups received by users do not contain the expected reminder message. Reminder messages are received as expected when using text/calendar format.

6308822 

(Linux Only) The location for Java may be incorrectly recorded in redeployApp after upgrade.

Workaround: Manually modify the path for Java in /opt/sun/im/html/redeployApp.

6323224 

The XMPP/HTTP Gateway only supports StartTLS for secure communications. If the multiplexor is configured to use SSL, you need to ensure that the gateway connects directly to the server over StartTLS.  

6324997 

(Linux Only) When you apply the patch to upgrade to this release, the client resources will be undeployed from the web container.  

Workaround: To avoid this problem, do one of the following: 

  • Run the following command when applying the patch:


    "rpm -F --nopreun sun-im-client*"
  • Manually redeploy the client resources after applying the patch:


    /opt/sun/im/html/redeploy

6325488 

(Linux Only) In a deployment with Sun Java System Application Server, you must accept the default URI when prompted when you run configure.

6336462 

In a deployment with a pool of servers, if you move a contact from one contact group to another, the privacy profile for that group does not take effect on the recently moved contact. 

Workaround: Sign off and back on to Instant Messenger after making changes. 

6336994 

A ConnectException may appear after redeploying the XMPP/HTTP Gateway. The exception can be ignored.

6338846 

When Instant Messaging is the only component installed on a system, the file ldajpjdk.jar may not be present in /usr/share/lib (Solaris) or /opt/sun/share/lib (Linux). In this case, if you choose to store user properties in LDAP when you run the configure utility, you will receive an exception.

Workaround: On the command-line, go to the following location: 


product_name/shared_components/Packages

Add the ljdk package manually using one of the following commands: 

Solaris: 


pkgadd SUNWljdk

Linux: 


rpm -i sun-ljdk-4.18-4.i386.rpm

Run the configure utility again.

6339952 

(Linux Only) If you want to upgrade from Sun Java System Instant Messaging 7 2005Q4 to this release, and you are using a file to store user properties in the default location (iim.userprops.store = "file"), you will need to copy the user data from /var/opt/sun/im/db to /var/opt/sun/im/default/db before you upgrade.

6340797 

If you configure a proxy, but disable SSL in iim.conf, you can still log in through the proxy. In addition, the console will show that Instant Messenger is securely logged in when it is not.

6350870 

An additional invalid character may be appended to the contents in email archive messages that contain multibyte characters. 

6354184 

You cannot enter the same conference room from multiple concurrent Instant Messaging sessions. 

6354757 

On Solaris, if you choose to use a location for logs other than the default, or if you are running on Linux, regardless of the path you choose, you need to modify the location of the default log file for the XMPP/HTTP gateway in httpbind_log4j.conf.

In httpbind_log4j.conf, set the value of the log4.appender.appender_ID.file parameter to the location where log files are stored. By default, on Linux, this value is /var/opt/sun/im/default/log. If you chose another location for log files when you ran configure, enter that path as the value for the parameter.

6357162 

By default, the Instant Messaging new user registration facility does not enable users for other Sun Java Enterprise System components, such as email or calendar. As a result, a user entry which has been provisioned using the Instant Messaging new user registration facility does not contain objectclasses and attributes required for these other services and will, therefore, not receive archive emails or calendar pop-ups. You can manually modify the user entries or registration.ldif to provide this additional information for the user entries added through the new user registration facility.

6360162 

If you deploy the XMPP/HTTP gateway, you need to set the iim_agent.httpbind.enable parameter in iim.conf to true. By default, this parameter is set to false.

6361796 

If you perform a patchrm on the Instant Messaging installation, all customizations to the client resources will be lost.

Workaround: Back up client resources before performing this action. 

6361888 

After upgrading, in a deployment with Sun Java System Access Manager, where user properties are stored in LDAP, existing multibyte news channel names may appear as %-encoded. 

Workaround: Edit each %-encoded name through the edit news channel windows in Instant Messenger. 

6365694 

If you will be storing user properties in LDAP, you must install the Sun Java System Access Manager SDK before you run the configure utility.

6366757 

In a deployment where Instant Messaging conference information is stored in LDAP, and there are over 1,000 conferences stored, the server may not start after performing an upgrade. This is because at initial startup, the server checks to see if a migration has been performed. If none has, for example when upgrading from Sun Java System Instant Messaging 7 2005Q4 or 2005Q1 it isn't required, the server will not start. You need to manually add a flag to indicate that migration has been completed before starting the server. 

Workaround: After upgrading, change to im_runtime_base and type the following commands at the command line to manually add a flag that indicates that migration has been completed:


touch db/muc/.ids_migrated_muc
touch db/muc/.ids_migrated

6367592 

If you import a contact list that contains entries from multiple domains, only those entries in your domain are imported. 

6370446 

Instant Messenger may throw an exception if timeouts, for example httpbind.polling, are set too high.

6375370 

The Sun Java Enterprise System 2005Q4 Upgrade and Migration Guide incorrectly instructs you to use the deployHTML script to redeploy Instant Messaging resources. Instead, you need to use redeploy. See Redeploying Resource Files in Sun Java System Instant Messaging 7 2006Q1 Administration Guide for instructions.

Redistributable Files

Sun Java System Instant Messaging 7 2006Q1 does not contain any files which you can redistribute.

How to Report Problems and Provide Feedback

If you have problems with Sun Java System Instant Messaging, contact Sun customer support using one of the following mechanisms:

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

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions.

To provide feedback for this release, go to the Sun Feedback Programs Portal.

To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the title of this document is Sun Java System Instant Messaging 7 2006Q1 Release Notes, and the part number is 819-2504.

Additional Sun Resources

Useful Sun Java System information can be found at the following Internet locations: