Release Notes

Ipswitch, Inc.
http://www.ipswitch.com

In This File

• What's new in this version?
• Special Notes
• Known Issues
• Product Description
• Installing Ipswitch Instant Messaging Server Manager and Ipswitch Instant Messaging Client
• Uninstalling
• For More Information

For more information about Ipswitch components, click in the list below to read the release notes:

• IMail Server Release Notes
• WorkGroupShare Release Notes
• AntiVirus Release Notes (only if installed)



What's new in version 2.07?^

• Instant Messaging Client: Corrected the time displayed when sending messages to account for DST.
• Instant Messaging client: The IMail-Premium-2006.2.exe install file did not include the icons for the Instant Messaging client. The install file has been updated with these icons.
• IM Server: The IMail Server 2006.2 install program placed imserver.exe in the wrong path, which generated an "system cannot find the specified file" error. The 2006.21 installation places imserver.exe in the appropriate path.
• IM Server: Addressed the following security vulnerability (identified by iDefense Labs) - [IDEF2390] Overwritten Destructor causes IM Server to crash without authentication.

What's new in version 2.06?^

Ipswitch Instant Messaging now allows users to export conversations to RTF files, thus making them available for archiving and searching.

The new Instant Messaging Server 2.06 will require customers to reactivate with new license keys. To obtain a new license key, call Customer Service at 781-676-5700 or, via email, at http://www.ipswitch.com/support/email_service.asp .

What's new in version 2.05? ^

Ipswitch Instant Messaging integrates with Microsoft® Office XP products by using Smart Tags. IIM Smart tags are person's names or email addresses that are associated with an IIM contact. Microsoft Office automatically recognizes smart tags in any Office document.

To implement Smart Tags register the imclientst.dll (regsvr32 imclientst.dll).

An essential part of deploying smart tag add-ins is registering DLLs correctly. Smart tag recognizer and handler DLLs register with Office by writing their locations in the registry. On a per-machine basis (which means for all users of a particular computer), register smart tag recognizers and action handlers in the following directories:

HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Common\Smart Tag\Actions\{6B173677-3FB3-4166-A9CA-713C15758B00}

Add the string value IMClientST.StAction with no value.

and

HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Common\Smart Tag\Recognizers\{05879876-CA61-4A0C-8D3B-95013E7B1DC5}

Add the string value IMClientST.StRecognizer with no value.

What's new in version 2.04? ^

• User can no longer close Recent Conversations window while messages are sorting. Closing Recent Conversations window while sorting previously caused IM Client to crash.
• Added the handling of %xx to specify the hexadecimal value for characters in paths.
• IM Client now supports Japanese language.
• Made changes throughout the IM Client and IM Server Manager to properly display Japanese characters.

What's new in version 2.03 HF-1? ^

The following vulnerabilities were discovered by and resolved with the help of iDEFENSE, Inc. For more information, see http://idefense.com.

• IM Server: Fixed potential crash due to TCP/IP attack

What's new in version 2.03? ^

• Fixed a condition that would allow 'Maximum Allowed Conversation Users' to be bypassed when adding users after conversation is started.
  

What's new in version 2.02? ^

• Updated support for updated IMail datatypes.

What's new in version 2.01? ^

• Added 'Message window always on top' functionality to the IIM client.
• Fixed a defect where the connection to server is being lost by the client but the client never attempts to reconnect to notify the user.

What's new in version 2.0? ^

• Added the ability to specify an LDAP database as an authentication type.
• Added the ability to control various user options from the server.
• Added spell checking to the client.
• Added printing capabilities to the client.
• Added the ability to save conversations as an RTF file.
• Added the ability for the client to access recent conversations.



Special Notes ^

When upgrading the IM Server to a new version, all IM Clients MUST be updated to that version, too. In other words, when you upgrade the server, you MUST upgrade the client, too.

NT Database users:
When using the IM Server with Windows NT authentication database and specifying an NT domain other than the local computer, the local computer MUST be in the specified domain.

If you need to go through a firewall, Ipswitch Instant Messaging (IIM) accepts connections only on TCP Port 5177. IIM Clients receive messages on TCP Port 5178.



Known Issues ^

• Default user options cannot be overridden if you are not using Ipswitch IM user database.



Product Description ^

Ipswitch Instant Messaging is a network-based Instant Messaging Client/Server system. All instant messaging network traffic passes through the local server which has the ability to send and receive traffic from other servers through the Internet.

Ipswitch Instant Messaging provides standard instant messaging functionality. It allows you to:

• send and receive messages between people or groups of people;
• send and receive online presence information;
• send and receive files (attachments);
• view entire conversations in which the user was included while he or she was offline.

Ipswitch Instant Messaging is targeted at business use. It meets the needs of businesses by providing local control of instant messaging, the ability to log instant message conversations (optionally), and secure network traffic.

Ipswitch Instant Messaging provides its own user management system or can be used with Ipswitch IMail Server, Windows NT and LDAP user databases.



Installing ^

To begin using Ipswitch Instant Messaging, you must install both the server and the client applications.

1. Install the Server on a PC that is connected to your Local Area Network.

   Installing Ipswitch's Instant Messaging Server is a fairly typical installation, and the entire process can be completed in less than ten minutes.

   Note: The server must be administered locally. The Ipswitch IM Server must not be installed on a network remote drive.

   Things to Know

   • If you must go through a firewall, Ipswitch IM accepts connections only on TCP Port 5177.
   • When using the Ipswitch IM Server with Windows NT authentication database and specifying an NT domain other than the local computer, the local computer MUST be in the specified domain.

   Server Installation

   Before you install the Server, note the following:

   • You must log on to Windows NT/2000/XP/2003 as a system administrator to install the software.
   • Windows NT/2000/XP/2003 are supported.
   • During installation you will select a user database to use:
     • Ipswitch Instant Messaging database
     • Windows NT user database
     • Ipswitch IMail Server database
     • Any LDAP database

   If you select the Ipswitch IM database, Windows NT database or an LDAP database, Ipswitch IM will use your PC's official hostname (from the DNS entry) as the messaging address.

   So, for example: if the hostname is pc.domain.com and you add a user named fred, Fred's messaging address will be fred@pc.domain.com.

   If you select the Ipswitch IMail Server database, the messaging address will be the same name as the mail domain address.

   Install Ipswitch Instant Messaging server by launching the Ipswitch Instant Messaging Server executable file and following the on-screen prompts.

   Step-by-step instructions

   To install the server, complete the following steps:

   1. Click the Ipswitch IM Server executable file. The installation wizard process begins. The Welcome screen displays. Click Next.
   2. Select or enter the Destination folder. (This is where the application will be loaded.) Click Next.
   3. Select or type the Program Group. (This is how it will be listed in your Windows Start Menu.) Click Next.
   4. Select a Database type:
      

      Choose Ipswitch IMail Server, Windows NT, LDAP, or use Ipswitch Instant Messaging for user authentication and administration. Enter the required information and Click Next.

      Note: Ipswitch IMail Server is not available if Ipswitch IMail Server is not installed on the local computer.

   5. The Set up Complete screen displays. Click Finish.
   6. The Ipswitch Instant Messaging Server starts.

   Note: Once the installation process is completed, the Ipswitch Instant Messaging Server is started.

2. Set up a User Account on the Ipswitch IM Server. If you are using Ipswitch IM's built-in user database, this is accomplished via the Users pane of the Ipswitch IM Server Manager. Otherwise, this task is completed through the user management utility of the Ipswitch IMail Server, Windows NT, or LDAP user database.
3. Install Ipswitch IM Client on the user's PC. The client portion of Ipswitch's Instant Messaging application can be installed from CD or downloaded from a central network location.

Note: During the initial installation of the Ipswitch IM Server, the client executable is stored in the server's root folder.

Preparing for Client Installation

• Before you can begin installing the IM Client on your users' computers, you must assign or arrange for each user to logon, and you must decide how you will do the actual installation.
• Create a user logon ID and Password. (Or, ensure a user ID has been created or you've pointed to another user authentication database.)
• Determine how you will handle the installation.
  • E-mail: Send the user his or her logon ID and password information, and tell him or her where and how to download the application.
  • From the user's workstation: Install from a central network location or from the CD. Supply the user with his or her logon ID and password.
  • Silent Install: Automated batch file installation process.

Client Installation

Windows 98SE/ME/NT/2000/XP are supported.

Step-by-step instructions for standard installation

To install the client, complete the following steps:

1. Click the Ipswitch IM Client executable. The installation wizard process begins. The Welcome screen displays. Click Next.
2. Select or enter the Destination folder. (This is where the application will be loaded.) Click Next.
3. Select or enter the Program Group. (This is how it will be listed in your Windows Start Menu.) Click Next.
4. The Set up Complete screen displays. Click Finish.
5. The Ipswitch Instant Messaging application launches. The IM Client's Logon screen displays.

4. Log on to the server using the user account information from Step 2.
5. Repeat steps 2,3, and 4 for any user that you want to have Ipswitch Instant Messaging capability.

Alternate Silent Installation

You may, if you choose to take advantage of an available silent installation process, automate the execution of the IM Client installation by creating a batch installation file. This process runs the IM Client set-up without end-user input.

The IM Client will be installed to the default locations:

Target Directory Folder: C:\Program Files\Ipswitch\IM Client
Program Folder Folder: Start > Programs > Ipswitch IM

How to run the IM Client install with no user input:

• This example assumes you have a shared network drive I.
• In this example the client install is named imclient.exe.

From a DOS prompt, launch the IIM Client executable:

I:\imclient.exe -s



Uninstalling ^

Ipswitch IM follows standard uninstall procedures. Use uninstall Wizard or Add/Remove programs in the Windows control panel.



For More Information ^

For information on setting up and using Ipswitch Messaging to distribute files on your network, refer to the following:

• Ipswitch Instant Messaging Server help system—Press F1—provides how to and context-sensitive help information.
• Ipswitch Instant Messaging Client help system—Press F1—provides how to and context-sensitive help information.
• For technical help and solutions, visit our Support Center at http://support.ipswitch.com, featuring a knowledge base, user guides, discussion lists, patches, upgrades, and live technical support options.