Sun Java System Instant Messaging Release Notes for HP-UX

Sun Java™ System Instant Messaging Release Notes for HP-UX

Version 7 2005Q4

Part Number 819-4253-10

These Release Notes contain important information available at the time of release of Sun Java System Instant Messaging 7 2005Q4 for HP-UX. Known issues and limitations, and other information are addressed here. Read this document before you begin using Instant Messaging 7.

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/app/docs/prod/entsys.05q4. 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.



Release Notes Revision History

Table 1  Revision History 

Date

Description of Changes

February 2006

Revenue release.

November 2005

Beta release.


About Instant Messaging 7 2005Q4

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 Java™ System Identity Server or Sun Java™ System Portal Server.

This section includes:

What’s New in This Release

The Instant Messaging 7 include the following topics:

Installation

The Instant Messaging Installation Guide has been discontinued. If you are installing Instant Messaging 7 2005Q4 for the first time, see the Sun Java™ Enterprise System Installation Guide for installation instructions. Upgrade is not supported in this beta release.

If you are using Access Manager with Instant Messaging you need to install the “Compatible (version 6.x style)” Access Manager using the Java Enterprise System installer. This version of Instant Messaging is not compatible with the “Enhanced (version 7.x style)” Access Manager.

If you are upgrading from a previous release of Instant Messaging, see the Sun Java™ Enterprise System Upgrade and Migration Guide for instructions.

New Features

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

Hardware and Software Requirements

This section lists the requirements for installing Instant Messaging software. Before you install, ensure that you have met the minimum hardware and operating system requirements. JRE 1.4 is supported by both the server and the client.

For the current list of required patches for Sun Java System Instant Messaging go to SunSolve Online (http://sunsolve.sun.com) and select either “Patches” or “Patch Portal”. Follow the Sun Java System Instant Messaging links. As system patch requirements change and patches to Java Enterprise System components become available, updates will be made available on SunSolve, initially in the form of recommended patch clusters.

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

This section Includes:

Server Operating System Requirements

This release of Sun Java System Instant Messaging requires the following platform:

HP-UX 11i v1

Server Software Requirements

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

Server Hardware Requirements

Instant Messaging requires approximately 5 Kbytes of disk space for each user. Though 256 Mbytes of RAM is specified, the amount of RAM needed depends on the number of concurrent client connections, and whether the server and multiplexor are deployed on the same host.

The following are the minimum server hardware and software requirements for installing Sun Java System Instant Messaging:

Table 2  Hardware and Software Requirements 

Component

Requirement

Supported Platforms

HP-UX PA-RISC

Operating system

HP-UX11i v1

RAM

256 Mbytes

Disk space

300 Mbytes

Client Operating System Requirements

This release supports the following client platform:

Client Software Requirements

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 and the recent versions of the Mozilla browser include Java v1.4 or higher but Internet Explorer does not.

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

http://java.sun.com/j2se.

You can download and install Java Web Start from the following location:

http://www.java.sun.com/products/javawebstart.

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. The following table lists supported operating system and browser combinations:

Table 3  Supported Client OS and Browser Combinations

Operating System

Browser

Solaris

Red Hat Linux 7.x,

Red Hat Linux 8.0 or later

Windows 98/ME/NT/2000/XP

Mac OS X

Netscape Communicator 4.7x or later

Netscape 4.7

Mozilla 1.2 or later

no restrictions

no restrictions

Client Hardware Requirements

Instant Messenger uses between 20 to 40 Mbytes 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 Mbytes RAM is recommended in order to run Instant Messenger and other applications comfortably. This number becomes higher when using memory-intensive operating systems such as Windows XP.

The following are the minimum client hardware and software requirements for installing Sun Java System Instant Messaging:

Table 4  Hardware and Software Requirements 

Component

Requirement

Supported Platforms

Windows 98/ME/NT/2000/XP, Solaris (PA-RISC or Intel)

Operating system

Solaris 8 and 9, Microsoft Windows 98 or later (ME, NT (SP 6a), 2000, XP)

RAM

128 Mbytes

Disk space

40 Mbytes


Bugs Fixed in This Release

The table below describes the bugs fixed in Instant Messaging 7:

Table 5  Fixed Bugs in Instant Messaging 7 2005Q4

Bug Number

Description

6319927

IM Server gives exception and fails to start.


Important Information

This section covers the following topics:

Installation Notes

If you choose to use Sun Java System Identity Server to store policies when configuring Instant Messaging, policies like the following are created:

For information about patch requirements and installation, see the following section:

Patch Requirement Information

The following table gives the numbers and minimum versions for the alignment patches. All patches referred to in this section are the minimum version number required for upgrade. It is possible that a new version of the patch has been issued since this document was published. A newer version is indicated by a different version number at the end of the patch. For example: 123456-04 is a newer version of 123456-02 but they are the same patch ID. Refer to the README file for each patch listed for special instructions.

To access the patches, go to http://sunsolve.sun.com.

Table 6  Instant Messaging 7 2005Q4 Alignment Patches Required for HP-UX

Patch Number

Patch Description

121514-01

HP-UX 11.11: Sun Java™ System Application Server 8.1 2005Q2

121934-01

HP-UX 11.11: Sun Java™ System Application Server 8.1 2005Q2 (Localization Patch)

121510-01

HP-UX 11.11: Sun Java™ System Web Server 6.1 2005Q4

121935-01

HP-UX 11.11: Sun Java™ System Web Server 6.1 2005Q4 (Localization Patch)

121937-01

HP-UX 11.11: Lockhart Localization patch

121516-01

HP-UX 11.11: Sun Java™ System Instant Messaging 7 2005Q4

121892-01

HP-UX 11.11: Sun Java™ System Instant Messaging 7 2005Q4 (Localization Patch)

For detailed information about Upgrade procedure of the Instant Messaging from JES3 to JES4 refer Sun Java Enterprise System 2005Q4 Upgrade Guide for HP-UX located at http://docs.sun.com/app/docs/doc/819-4460.

Compatibility Issues

The following table lists the known incompatibilities between Instant Messaging 7 2005Q4 and earlier versions.

Table 7  Instant Messaging 7 2005Q4 Compatibility Issues

Incompatibility

Impact

Comments

Instant Messaging 7 is incompatible with the 7.x (2005Q4) versions of Access Manager.

When installing Access Manager, select “Compatible (version 6.x style)” instead of “Enhanced (version 7.x style)” on the Java Enterprise System installer.

 

Instant Messaging 7 is incompatible with the 2004Q2 versions of Portal Server and Messaging Server.

Upgrade Portal Server and Messaging Server when upgrading Instant Messaging 7.

 

Due to a protocol change the Instant Messaging 7 2005Q4 server is not able to communicate with a server of an older version in federated deployments.

Instant Messaging federated deployment sites will need to upgrade all the servers. The existing deployments who do not wish to upgrade the server will have to explicitly set the property of collaboration session factory object to use the legacy protocol implementation.

You should coordinate the upgrade to limit the length of time

during which servers will be unable to communicate with each other.

Client - Server Communication

Due to the protocol change the older versions of the client will not be able to communicate with the newer versions of the server and vice versa.

The sites will need to upgrade both the client and server at the same time.

The Instant Messaging SDK implementation of the Legacy InstantMessaging/Presenceprotocol is now bundled.

By default, the Instant Messaging SDK APIs use the implementation based on the XMPP protocol. Applications will have to explicitly set the property of collaboration session factory object to use the Legacy protocol implementation.

 

The SDK component includes additional jar files:

The Instant Messaging SDK uses the JSO (JABBER Stream Objects) libraries.

In order to take advantage of XMPP, you will need to modify the classpath for older applications using the Instant Messaging SDK.

 

Documentation Updates for Instant Messaging 7 2005Q4

The following documents have been deprecated. The information they contain has been incorporated into the Sun Java System Communications Services 6 2005Q1 Deployment Planning Guide:

In addition, the Sun Java System Instant Messaging 6 2004Q2 Installation Guide material has been deprecated. The information previously found in that book is now available from the following sources:

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 at http://sun.com/software/javaenterprisesystem/get.html.

For information on Sun’s commitment to accessibility, visit http://sun.com/access.

Online Help

These features are not described in either the product online help or the quick reference.

Emoticons

(Bug: 6182662) Some new emoticons are not documented in the online help. The following table describes the missing emoticons and their corresponding keyboard shortcuts.

Table 8  Instant Messaging Emoticons 

Name

Shortcut Characters

Alarm clock

((O))

Balloons

88=

Birthday Cake

~[

Calendar

[#]

Can of Worms

&]

Clown

:O)

Flowers

@=

Gift

@[

Gold Star

(*)

Knife

-->>

Life Preserver

o=

Lightning

\\\

Drink

)-|

Money

$$

Mug of Beer

@]

Music

~~

Rat Hole

<O~

Sun Shining

=O=

Phone

(~)

Violin

~\~

In addition, the online help mistakenly calls the Happy emoticon “Smiley” and the Sleep emoticon “Sleeping”.


Known Issues and Limitations

This section describes the known issues and limitations of Instant Messaging 7 2005Q4 for HP-UX.

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. Alternatively, you may consult the Sun web site for patches:

http://sunsolve.sun.com.

This section covers the following topics:

Configure Utility or IM

Running the Instant Messaging Configure is not working in CLI Mode (6233608)

Trying to launch the Instant Messaging Configure from the CLI mode fails

Workaround

Run the configure in the GUI mode.

When Instant Messaging L10N depots are installed many soft links are not created (6369077)

Workaround

After Instant Messaging installation, create the softlinks manually as described below:

  1. In /opt/sun/im/html: that is in <your installed location>/im/html
  2. de_DE -> /opt/sun/im/html/de

    en_US -> /opt/sun/im/html/en

    es_ES -> /opt/sun/im/html/es

    fr_FR -> /opt/sun/im/html/fr

    ja_JP -> /opt/sun/im/html/ja

    ko_KR -> /opt/sun/im/html/ko

    zh_CN -> /opt/sun/im/html/zh

  3. In /opt/sun/im/lib: that is in <your installed location>/im/lib
  4. CfgResources_de_DE.properties -> /opt/sun/im/lib/CfgResources_de.properties

    CfgResources_es_ES.properties -> /opt/sun/im/lib/CfgResources_es.properties

    CfgResources_fr_FR.properties -> /opt/sun/im/lib/CfgResources_fr.properties

    CfgResources_ja_JP.properties -> /opt/sun/im/lib/CfgResources_ja.properties

    CfgResources_ko_KR.properties -> /opt/sun/im/lib/CfgResources_ko.properties

    CfgResources_zh_CN.properties -> /opt/sun/im/lib/CfgResources_zh.properties

    imService_de_DE.properties -> /opt/sun/im/lib/imService_de.properties

    imService_es_ES.properties -> /opt/sun/im/lib/imService_es.properties

    imService_fr_FR.properties -> /opt/sun/im/lib/imService_fr.properties

    imService_ja_JP.properties -> /opt/sun/im/lib/imService_ja.properties

    imService_ko_KR.properties -> /opt/sun/im/lib/imService_ko.properties

    imService_zh_CN.properties -> /opt/sun/im/lib/imService_zh.properties

Instant Messaging configurator crashes on any.utf8 EMEA locales (6370601)

Workaround

Instant Messaging configurator sometimes fails to start on non-English locales with a message like 'Invalid character'. This happens due to presence of mutability characters in the script header.

To resolve follow the below mentioned steps:

  1. Open the configure script with vi.
  2. # vi /opt/sun/im/configure

  3. Save without editing and restart.
  4. :w!

    # /opt/sun/I/configure

Configuring Instant Messaging for the first time throws an IO exception (6376725)

Workaround

Run the following script:

or

Run Instant Messaging configurator script again:


Redistributable Files

Sun Java System Instant Messaging 7 2005Q4 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 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 guide or at the top of the document.


Additional Sun Resources

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


Copyright � 2006 Sun Microsystems, Inc. All rights reserved.

Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and in other countries.

SUN PROPRIETARY/CONFIDENTIAL.

U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements.

Use is subject to license terms.

This distribution may include materials developed by third parties.

Portions may be derived from Berkeley BSD systems, licensed from U. of CA.

Sun, Sun Microsystems, the Sun logo, Java and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries.


Copyright � 2006 Sun Microsystems, Inc. Tous droits r�serv�s.

Sun Microsystems, Inc. d�tient les droits de propri�t� intellectuels relatifs � la technologie incorpor�e dans le produit qui est d�crit dans ce document. En particulier, et ce sans limitation, ces droits de propri�t� intellectuelle peuvent inclure un ou plus des brevets am�ricains list�s � l'adresse http://www.sun.com/patents et un ou les brevets suppl�mentaires ou les applications de brevet en attente aux Etats - Unis et dans les autres pays.

Propri�t� de SUN/CONFIDENTIEL.

L'utilisation est soumise aux termes du contrat de licence.

Cette distribution peut comprendre des composants d�velopp�s par des tierces parties.

Des parties de ce produit pourront �tre d�riv�es des syst�mes Berkeley BSD licenci�s par l'Universit� de Californie.

Sun, Sun Microsystems, le logo Sun, Java et Solaris sont des marques de fabrique ou des marques d�pos�es de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.

Toutes les marques SPARC sont utilis�es sous licence et sont des marques de fabrique ou des marques d�pos�es de SPARC International, Inc. aux Etats-Unis et dans d'autres pays.