Exceed®

Release Notes V9.0


Contents

New Features

General
Windows Server 2003 Support
Improved Multi-Language Support
Metering
File Converter
Hummingbird Connectivity Security

Exceed
Windows XP Tablet PC Edition Support
Support for Microsoft Active Accessibility
Support for VPN and NAT Devices
Improved X Security
Enhanced Xconfig Console
New Xsession Console
Improved Xconfig
Mandatory Settings Application
Improved Xstart Password Encryption
Improved Local X Application Support
IPv6 and Full Winsock2 Support
Password Aging
New Xstart Macro
Enhanced SSH Support
Improved Font Handling
Multiple Display Support
Improved Multiple-Monitor Support
Hummingbird Connectivity Kerberos Integration
Windows Scripting Framework
Spaceball and 7-button Mouse Support
Multiple Adapters Support
Smart Card Support
New Command Line Flag
Configuration Options
Slovenian Keyboard
Improved Stdappdb.txt

Exceed XDK
Add-on Product of Exceed
Microsoft Visual Studio .NET Support
Motif 2.2.1 Support
IPv6 Ready
Internationalization of MWM
Sample XDK Applications
New Xrender Library and X Local Client
Improved Porting Ability and Output Redirection
Xaw3D Support
Standalone Xpm Library

Exceed 3D
GLX 1.3 Support

Directory Services Applications
Configuring hclnfsd/pcnfsd Authentication
Forcing AUTH_SYS Authentication Using hclnfsd/pcnfsd
Cluster Awareness in Hummingbird Directory Services
Locating Servers Using DHCP
SASL Protocol Support
Name Mapping Server Query Order
New User Interface in Hummingbird Directory Services
Performance Improvements for Directory Services

HostExplorer
Batch IND$File for TN3270
AS/400 Data Transfer Shell Integration
XLS Support for AS/400 Data Transfer
FTP for Windows Explorer Web Package
Auto-Highlight Field
Full Screen Mode
Terminal in Windows Explorer
FTP for Windows Explorer Support
HTTP/HTTPS Proxy Support
HTTPS Support
HTTP Authentication Support

Host Access Services
Hummingbird Deployment Wizard
HostExplorer HTTP/HTTPS Proxy
HostExplorer Print Services


Known Issues

Windows Installer
Installing a Product without Advertised Shortcuts
Disabling Migration
Files Used During Upgrade
Netscape 4.8 Not Supported for Installation Documentation

Exceed
Migration of Toolbar Settings
Space Ball and Space Mouse Drivers

Exceed 3D
Direct Rendering Not Supported by NVIDIA Products

HostExplorer
Profile Browser Does Not Show Deployed Profiles if HostExplorer is Installed
Deployed Session Does Not Work with Netscape
Recording Quick Scripts with SSL/TLS Enabled
5250 Data Transfer Wizard Requires DES Encryption
Different Behavior Between MIT Kerberos Client VersionsRegarding Tickets
Support of MIT Kerberos Tickets on Windows XP
OpenSSL
VT Profile/Secure Shell Connection Settings Help

Host Access Services
Complete Installation of HostExplorer Before Installing Hummingbird Deployment Wizard
Deployed Profile Shortcut Not Supported by Netscape
Moved Deployed Profiles May Not Launch

Hummingbird Deployment Wizard
Component Deployment Installer Runs in Language of Initial Installation
Language Setting Selected in First Deployment Cannot be Changed
Launch Language Chooser from Windows Explorer
Installation Interrupted if Default Language of Client is Not Included in Deployed Project
Uninstalling Hummingbird Component Deployment Does Not Remove Netscape Plugin
Deployed Session Cannot Co-Exist with HostExplorer Version 7.x
Running Multiple Versions of Deployed HostExplorer Sessions
Avoid Naming Conflicts
No Spaces Allowed in Project Names When Using Netscape
Metering Values Affect Registry
Uninstalling Web Deployment
Hide Browse Toolbar Option Not Available in Netscape
Index Page Options Not Supported by Netscape

HostExplorer Print Services
Print Services Does Not Use Windows Default Printer
PeSRV Running as a Com Server Not Supported for Win98 and ME

Certificate and Key Manager
Certificate Authorities Not Automatically Trusted
Importing Keys in .pem Format

Directory Services Applications
Binding to an LDAP Server Under SSL
Enabling NTLM Security Services in Windows 98/Me


Documentation

Documentation Updates
HostExplorer Programming Guide
Hummingbird Basic Language Documentation

Documentation Set
Release Notes
Manuals
Help


Third Party Software

Adobe Acrobat Reader

Sun Java 2 Runtime Environment

MIT Kerberos


Contacting Hummingbird


New Features

This section describes the new features available for Exceed 9.0 products. For information on the features added in previous releases, contact your Hummingbird sales representative.


General


Windows Server 2003 Support

Hummingbird Connectivity V9.0 products support Windows Server 2003.


Improved Multi-Language Support

During Hummingbird Connectivity product installation, you can now select and install multiple user interface languages. If you do so, Hummingbird Connectivity Language Chooser lists the installed languages and lets you change the language of the user interface. The language you select will be applied to Connectivity menus and dialog boxes. Language Chooser is available only if you install multiple languages.


Metering

Hummingbird Connectivity products are now equipped with license metering capabilities. Hummingbird Metering Server lets administrators track the number of Hummingbird licenses deployed in their organizations. The metering client sends update information to the Metering Server and informs the server when a Hummingbird Connectivity product is installed or in use on a workstation machine.


File Converter

File Converter is now available in all Hummingbird Connectivity products. File Converter lets you convert text files from DOS format to UNIX format and vice versa. The conversion translates end-of-line character sequences.


Hummingbird Connectivity Security

Three Hummingbird Connectivity security products are now available for use with some Connectivity V9.0 products:


Connectivity Secure Shell

This implementation of the Secure Shell (SSH) protocol secures connections between machines in an unsecured network by authenticating and encrypting communication. With Connectivity Secure Shell, users of Hummingbird products and components including Exceed, HostExplorer, Xstart, FTP for Windows Explorer and Classic FTP can do the following over secured network connections:

For more information on this product, contact your Hummingbird sales representative.


Connectivity Kerberos

Connectivity Kerberos lets you manage your Kerberos password and obtain Kerberos tickets for use with a number of Hummingbird products. Connectivity Kerberos combines the functionality of the KINIT, KLIST, KDESTROY, PASSWD and KPASSWD commands in one user interface. You can download this free application from the Hummingbird web site in the Connectivity product pages:

http://www.hummingbird.com/products/nc/kerberos/request.html

Connectivity SSL

Connectivity SSL enables Hummingbird Connectivity products to provide Secure Socket Layer (SSL) encryption, authentication, and privacy to network communication over Telnet. Connectivity SSL contains the necessary cryptographic libraries for SSL/TLS. You can download this free application from the Hummingbird web site in the Connectivity product pages:

http://www.hummingbird.com/products/nc/ssl/request.html

Exceed


Windows XP Tablet PC Edition Support

All Exceed products support Windows XP Tablet PC Edition. Exceed is optimized for related devices and technology:


Support for Microsoft Active Accessibility

Exceed supports Microsoft Active Accessibility 2.0 (MSAA), a COM-based technology. This technology provides accessibility aids and reliable methods for working with Windows applications. For example, users can read information and understand the Motif application using a Windows-based MSAA-compliant screen reader, such as Microsoft Narrator or Freedom Scientific Jaws For Windows.


Support for VPN and NAT Devices

Exceed supports network connections that feature a VPN or NAT device where the "last remote translated" IP address for the client PC is not the same as the unique IP address assigned to that PC.


Improved X Security

Exceed can automatically synchronize the Xauthority file on the PC with the file on the UNIX host. This ensures that user-level security on the PC is always up to date.


Enhanced Xconfig Console

Xconfig Console is a snap-in that lets you modify Exceed X server properties through Microsoft Management Console.


New Xsession Console

Xsession Console is a snap-in that lets you modify Xsession options, open and save Xsessions, create Xstart nodes, and export lists through Microsoft Management Console.


Improved Xconfig

The Xconfig file (.xcfg) is now configurable outside of Xconfig. Users can programmatically access and modify option values. Users and administrators can still password-protect portions of the Exceed configuration.

Xconfig changes are not enabled until the configuration is saved. If users exit Xconfig before saving changes, they are prompted whether to save or discard the configuration changes.

Users can create a shortcut and specify a shortcut icon on the desktop, and in the All Users or Current User's program group. If the user performs this action before the new configuration is saved, Xconfig prompts whether to save or discard the configuration changes.


Support for Mandatory Settings.xcfg File

Xconfig now supports the mandatory settings.xcfg file.


Default settings

Xconfig now loads the default settings used when Restore to Default Settings is pressed from the global default.xcfg file. This allows users to change the standard settings to which individual users can revert.


Mandatory Settings Application

Using the new mandatory settings application, Administrators can now force specific settings to be used by all users of a machine. The Mandatory Settings application can be used to control which .xcfg file settings are mandatory. Exceed reads the mandatory settings.xcfg file first before reading the current .xcfg file. Any settings found in this new .xcfg file are used instead of the current .xcfg file.

The mandatory settings application is run from Xconfig's Security - System Administration dialog box.


Improved Xstart Password Encryption

An Xstart startup file can contain the user name and password of a UNIX account. The file is stored on the user's PC. For better security, Xstart now supports RC5 encryption and decryption for passwords.


Improved Local X Application Support

Xstart can now launch local X applications without requesting user name and password information provided that the host is local.


IPv6 and Full Winsock2 Support

Exceed supports Internet Protocol Version 6 and Windows Sockets 2.


Password Aging

Xstart can detect specific UNIX prompts. When Xstart encounters a prompt, it assumes that the UNIX password has expired and that the UNIX host is asking the user to change the password. Xstart opens a change dialog box that lets users batch update the login information for Xstart setting files in a particular directory. This Password Aging feature works only with Telnet, Rlogin, and Secure Shell start methods.


New Xstart Macro

Xstart supports a new %w macro that represents the current Windows user name.


Enhanced SSH Support

SSH is now easier to use. Xstart makes use of Hummingbird Connectivity Secure Shell (CSS) which relies on .csp files that contain the necessary configuration settings related to a secure shell (SSH) tunnel. The CSS engine reads the information contained in the profile and establishes a connection to a server using SSH.

New Xstart features let users locate and specify a CSS profile for the X window session. Users can launch a CSS management console to create a new CSS profile or modify an existing one. This means that each X window session can now use a different .csp file.


Improved Font Handling

Exceed features the following font handling improvements:


Multiple Display Support

The X Client Wizard lets users select the screen or display for launching the X application. By default, Exceed launches the X application in screen 0, but users can select another screen from a drop-down list box. Users can create Xstart startup files that launch X applications in specific screens.


Improved Multiple-Monitor Support

Exceed supports up to 256 monitors.


Hummingbird Connectivity Kerberos Integration

Exceed supports Hummingbird Connectivity Kerberos integration.


Windows Scripting Framework

Exceed provides Windows scripting framework for automation. This framework allows for the automated update of Xconfig and Xstart profiles, and the launching of Exceed. Users can query or change Xconfig settings programmatically using any COM Automation compatible scripting language (e.g. Hummingbird Basic, VB Scripting, etc.).


Spaceball and 7-button Mouse Support

Exceed supports the Spaceball input device and also supports up to 7 mouse buttons.


Multiple Adapters Support

The Multiple Adapter information is now stored in the Xconfig configuration file.


Smart Card Support

Xstart can authenticate a user with the remote host using an ActivCard smart card.


New Command Line Flag

Exceed has a new command line flag -c. Using this flag, you can override Xconfig options. Flags are boolean, strings, or integers. To determine the value for an option, specify the settings you want in Xconfig and then read exceed.xcfg using a text editor.


Examples

To disable the warning that is displayed when Exceed is closed, use the following:

exceed -c Screens.CommonSettings.CloseWarn=0

To force TrueColor and use custom.txt for your color lookup table, use the following:

exceed -c Video.szRgbFile=custom.txt -c Screens.Screen0.ServerVisual=4

Configuration Options


Slovenian Keyboard

Exceed V9.0 supports the Slovenian keyboard file.


Improved Stdappdb.txt

Stdappdb.txt is modified and improved:


Exceed XDK


Add-on Product of Exceed

Exceed XDK (X Development Kit) is now packaged as an add-on similar to Exceed 3D, rather than as a superset of Exceed.


Microsoft Visual Studio .NET Support

Exceed XDK V9.0 can now use VC++ 7.0 and 7.1 as a development environment. An Exceed XDK Application Wizard is provided for both versions.


Motif 2.2.1 Support

Exceed XDK V9.0 provides the include and library files for the latest version of Motif, 2.2.1 as well as Motif 1.2.4, Motif 2.0.3 and Motif 2.1.30 (CTL). Both Microsoft VC++ and Cygwin-compatible Motif libraries are included.


IPv6 Ready

Exceed XDK V9.0 offers newest X Windows version available - X11R6.6 with IPv6 patch applied. It is now possible to specify display parameters for local applications in Internet Protocol Version 6 format.


Internationalization of MWM

Exceed officially supports six languages, including double-byte and multi-byte character sets. It is now possible to make Exceed work in any language by translating the mwmrc file and placing it in a sub folder beneath the Exceed User folder. Name the sub folder after the language and set the LANG environment variable to the name of the sub folder.


Sample XDK Applications

Exceed XDK features two new sample applications and source files to demonstrate the usage of extensions such as XRENDER, Anti-aliasing, xaw3d, and other new extensions included in this version. The sample applications are:


New Xrender Library and X Local Client

Exceed XDK features a new X application to demonstrate the usage of XRENDER extension as well as supporting .dlls and libraries. The sample Xrender application's source code is provided.


Improved Porting Ability and Output Redirection

Now Exceed XDK V9.0 users can use the same set of X/Motif libraries that are used on UNIX systems. XDK-specific libraries like xlibgui.lib and xlibcon.lib are no longer used. Output functions that use SYSOUT and SYSERR system files are redirected to print in the local X console and Xlib log file. Now functions like fprintf or perror will work for Windows applications without modification.


Xaw3D Support

This Xaw3D library can be used instead of the regular Xaw library to provide a 3D-like appearance for some Athena widgets.


Standalone Xpm Library

This library is provided only at the customer's request. Note that Motif 2.x provides Xpm functions.


Exceed 3D


GLX 1.3 Support

Exceed supports GLX 1.3 source code.


Directory Services Applications

New features for Directory Services Explorer and Hummingbird Directory Services are described below.


Configuring hclnfsd/pcnfsd Authentication

If you have installed NFS Maestro Client/Solo on your system, you can now use Hummingbird Directory Services to configure default servers for hcnfsd/pcnfsd authentication. When hcnfsd and pcnfsd daemons are not available for authentication, NFS Maestro Client automatically queries the default servers you have configured with Hummingbird Directory Services. You can specify the order in which NFS Maestro Client queries these authentication agents.


Forcing AUTH_SYS Authentication Using hclnfsd/pcnfsd

In addition to configuring hclnfsd/pcfnsd authentication with Hummingbird Directory Services, you can force NFS Maestro Client to use hclnfsd or pcnfsd for AUTH_SYS authentication, regardless of the selected directory service. This option is available only if you have installed NFS Maestro Client on your machine and selected NIS, NIS+, or LDAP as the current directory service. If you select this option, NFS Maestro Client uses the AUTH_SYS authentication agent you have specified in the HCLNFSD/PCNFSD Properties dialog box. All other directory service queries target the current service.


Cluster Awareness in Hummingbird Directory Services

Hummingbird Directory Services now supports Windows Clustering technology. If you configure the system profile for a directory service on one node in a cluster, other Hummingbird Connectivity applications running in the cluster target the configured service. If the node subsequently fails or is taken offline for maintenance, the cluster software transfers the configuration information to an available node in the cluster, with little or no interruption in service to applications using the directory service.


Locating Servers Using DHCP

If your network has a Dynamic Host Configuration Protocol (DHCP) server that stores configuration information for directory service, name mapping, and authentication servers, Hummingbird Directory Services can query the DHCP server to retrieve the configuration information. Using a DHCP server to retrieve configuration information is usually quicker than scanning the network. Also, if DHCP Relay Agents are installed on other subnets, you can retrieve configuration information for servers outside your immediate subnet.

Before you can retrieve server information from a DHCP server, either or both of the scope or server options on the DHCP server must be configured correctly. For more information, see Hummingbird Directory Services Help.


SASL Protocol Support

Hummingbird Directory Services and Directory Services Explorer now support the Simple Authentication and Security Layer (SASL) protocol for authentication to an Active Directory LDAP domain. This protocol effectively adds a security layer to the existing communications protocol in operation between the client and server. Hummingbird Directory Services and Directory Services Explorer support SASL using the Generic Security Service Application Program Interface (GSSAPI) mechanism.

To use SASL authentication, you must meet the following requirements:

If you are running Windows 98/Me, you must also enable NTLM security services. For more information, see Enabling NTLM Security Services in Windows 98/Me.


Name Mapping Server Query Order

If multiple instances of NFS Maestro Name Mapping Server are available on your network, you can use Hummingbird Directory Services to specify which servers to query for name mapping information. You can specify up to two servers: applications target the primary server first, if it is available; otherwise, applications target the secondary server.


New User Interface in Hummingbird Directory Services

The Hummingbird Directory Services Properties dialog box now contains two pages:

In addition to this change, Hummingbird Directory Services includes the following new components, which are available only if you have installed NFS Maestro Client on your machine:

HCLNFSD/PCNFSD Properties Dialog Box      Lets you specify the agents you want to use for hclnfsd/pcnfsd authentication and the order in which the agents are contacted.

Find HCLNFSD/PCNFSD Server Dialog Box      Lets you browse for and select the server you want to use as the default authentication server.


Performance Improvements for Directory Services

Hummingbird Directory Services and Directory Services Explorer have been redesigned to improve performance for NIS, NIS+, and LDAP operations.


HostExplorer


Batch IND$File for TN3270

Batch file transfer allows you to create a list of several files to download/upload. Once the list is created, you can use HostExplorer to execute the work. The list can also be saved in the HostExplorer user folder for later use.


AS/400 Data Transfer Shell Integration

5250 data transfer functionality allows you to transfer one or more files by dragging and dropping the files between the remote host and the local file system.

You define a 5250 connection by configuring and saving a data transfer profile, which is then displayed in Hummingbird Neighborhood. These profiles also let you set options for directories, downloading and uploading.


XLS Support for AS/400 Data Transfer

One of the particularities of the AS/400 file system is that it is structured like a database and contains mainly data. When transferring these data to the local file system, HostExplorer now offers the ability to store them into a native Excel spreadsheet format (.xls) in addition to the CSV previously supported. This feature is also available during the upload process, so that HostExplorer can read an Excel spreadsheet and store the data accordingly into the AS/400 database.


FTP for Windows Explorer Web Package

Using Hummingbird Deployment Wizard, you can now deploy FTP for Windows Explorer as a web component.


Auto-Highlight Field

Auto-highlight indicates the location of the cursor on the screen by changing the color of the field in which the cursor is located. The auto-highlight color is defined on the Color page of 3270 or 5250 HostExplorer profiles. If the auto-highlight color is set to Black on Black, the feature is disabled.


Full Screen Mode

In previous versions, the ability to display the terminal in full screen mode was accessible only through a keyboard shortcut. You can now enable this feature from the View menu.


Terminal in Windows Explorer

HostExplorer terminals can now be displayed and used directly from within the Windows Explorer interface. HostExplorer does not require the user to launch a separate application to work on legacy system applications (although this option is still available). From within Hummingbird Neighborhood in Windows Explorer, users can browse and click on connection profiles to launch a terminal window.


FTP for Windows Explorer Support

FTP for Windows Explorer can now be packaged using Hummingbird Deployment Wizard and deployed using a web browser.


HTTP/HTTPS Proxy Support

HostExplorer version 9.0 can encapsulate TN3270, TN5250, and VT data in an HTTP/HTTPS data stream that is sent to the remote host through the HTTP/HTTPS Proxy. The HTTP/HTTPS Proxy is installed on a web server in between the HostExplorer client and the remote destination host.


HTTPS Support

Web-to-Host sessions of HostExplorer can now be deployed over an HTTPS connection in addition to the HTTP protocol. This feature gives the administrator increased security during the deployment of HostExplorer through a browser as well as easier integration with existing security rules within a company.


HTTP Authentication Support

Web-to-Host sessions of HostExplorer that are deployed through Hummingbird Deployment Wizard can now be stored in secured directories on the web server. Web authentication (with user login) through corporate directories, such as LDAP or Active Directory, will be managed by the browser and Hummingbird Deployment Wizard.


Host Access Services


Hummingbird Deployment Wizard

Hummingbird Deployment Wizard provides a central place and method for deployment and administration. It saves time for administrators and lets them provide faster deployment than traditional methods.

HostExplorer Deployment Wizard has been renamed Hummingbird Deployment Wizard.


HostExplorer HTTP/HTTPS Proxy

HostExplorer now includes an integrated HTTP/HTTPS proxy, which can be used to secure external connections (by using HTTPS). Once installed on a server, the HTTP/HTTPS proxy acts as an HTTP gateway between HostExplorer and the host. External traffic (such as web page traffic) is transmitted via HTTP/HTTPS while internal traffic is transmitted through the regular network protocol (TN3270, TN5250, or Telnet).


HostExplorer Print Services

HostExplorer Print Services lets Mainframe and AS/400 administrators consolidate their print queues on a single Windows server instead of managing multiple desktop print queues. HostExplorer Print Services can handle several thousand print queues on a single machine that can be remotely managed.


Known Issues

This section describes issues that Hummingbird is aware of at the time of release.


Windows Installer

The following are known Windows Installer issues:

An error message indicates "Another instance of Hummingbird product - Hummingbird Setup Wizard is running". Only one Hummingbird installation can take place at a time. Click No to prevent the new instance from continuing. Click Yes if you are sure that no other instance is running and you want this new instance to continue.

HumSettings.exe REFRESH=ALL

For more information, see "Updating the Personal User Directory for All Users" in "Chapter 3: Advanced Installation" of the product manual.

Installing a Product without Advertised Shortcuts


Option 1

For each installation, run Setup using the following syntax:

setup /v"DISABLEADVTSHORTCUTS=1"

Option 2

For multiple installations or in the case of a multi-user rollout:

  1. Run Sconfig.exe.

If Sconfig is not installed, run the English version directly from the CD or from a network image. To launch Sconfig, browse to the folder:

Program Files\Hummingbird\Connectivity\9.00\Accessories
  1. Select the product .msi from the CD or network image.
  2. In the Properties dialog box, add the property DISABLEADVTSHORTCUTS. Set the value of this property to 1.
  3. Create the transform file in a location where you have write access.
  4. When you install the product, apply the transform you have just saved. This transform forces Windows Installer to create non-Advertised shortcuts.

Disabling Migration

To preserve an existing product version and install the new version 9.0 side-by-side, you may want to disable migration.

To disable migration of user profiles from version 6.2 to 9.0, run:

setup /v"ALLOWMIGRATE="

To disable migration of user profiles from version 7.0 to 9.0, run:

setup /v"DISABLEMAJORUPGRADE=1"

Warning: 
  Side-by-side installation is not advised. It may cause incompatabilities (especially with the NFS Maestro product line).

Note: 
  Side-by-side installation is not possible for all version 9.0 products (that is, version 9.0 products cannot co-exist with most other version 9.0 products).


Files Used During Upgrade

During the upgrade of Exceed PowerSuite to version 9.0, the Files In Use dialog box opens. This may indicate that the setup process is using certain files. Close the dialog box by clicking Ignore.


Netscape 4.8 Not Supported for Installation Documentation

The How to Install document, which you can access from the Msetup screen during product installation, cannot be viewed with Netscape 4.8 or lower. You can view this installation information in the product manual (PDF) provided on the CD.


Exceed


Migration of Toolbar Settings

There is limitation to the migration of toolbar settings which is related to the way toolbar settings are read and written to exceed.tb. If the previous installation language differs from the currently selected installation language, then toolbar descriptions appear in the language of the previous installation. For example, if the language of a previous installation was French, but for version 9.0 the selected installation language is English, then all settings are migrated from the old exceed.tb to a new exceed.ENG.tb. However, toolbar description text will be in French.


Space Ball and Space Mouse Drivers

Running Exceed after Space Ball or Space Mouse drivers are installed results in a general protection fault (GPF) error. When installing Space Ball or Space Mouse drivers, select the option "Start driver when Windows starts". The driver must be started before Exceed starts.


Exceed 3D


Direct Rendering Not Supported by NVIDIA Products

NVIDIA products (for example, GeForce and Quadro series video cards) do not currently support Exceed 3D Direct Rendering mode.


HostExplorer


Profile Browser Does Not Show Deployed Profiles if HostExplorer is Installed

If you deploy a profile on a machine that has HostExplorer (Not Deployed) installed, the profile browser does not show the deployed profile because it is downloaded to one of the following locations:

<path>\Hummingbird\Connectivity\Web Deployment\Hummingbird\Profile\<profile>.HFS

<path>\Hummingbird\Connectivity\Web Deployment\Hummingbird\Profile\<profile>.HFS

where <path> is the path of the application data and <profile> is the name of the profile.


Deployed Session Does Not Work with Netscape

When you launch a deployed session from the Index page, you may receive a Netscape error message. To fix the error, you need to manually remove a file created by Netscape.

To download a deployed session in Netscape:

In the Windows or Winnt folder, do one of the following:


Recording Quick Scripts with SSL/TLS Enabled

If you want to run a Quick Script with SSL/TLS enabled, make sure that the script includes a Connect command at the beginning; that is, the Quick Script is recorded prior to the connection. Otherwise, it will appear that the Quick Script has started before the connection to the host has been established.

As a result of the high overhead of public key cryptography and SSL/TLS handshaking, there is a delay between the black screen and the host logo. Often, the script will run ahead and attempt to issue a command before the connection is established, thus breaking the protocol.


5250 Data Transfer Wizard Requires DES Encryption

The 5250 Data Transfer Wizard and Hummingbird Neighborhood integrated 5250 Data Transfer require DES encryption. To get the necessary support for DES encryption, install either Connectivity Secure Shell or Connectivity SSL. For more information, see Connectivity SSL.


Different Behavior Between MIT Kerberos Client VersionsRegarding Tickets

During FTP sessions, MIT Kerberos for Windows V2.0 client does not store service tickets in the MIT Kerberos cache. However, MIT Kerberos for Windows V2.1 and V2.1.1 clients place service tickets in the cache. Therefore, any new connection to the host will result in new tickets being generated. For example, if there are lengthy FTP sessions running with connections to numerous hosts, there could be cache sizes of 1,000 tickets, resulting in performance problems. This is a known issue with the MIT Kerberos for Windows client software.

For V9.0 Connectivity products, we recommend Hummingbird Connectivity Kerberos.


Support of MIT Kerberos Tickets on Windows XP

MIT Kerberos Client 2.1 (Leash32) does not support MIT Kerberos version 4 tickets on Windows XP. To enable support of MIT Kerberos version 4 tickets, browse to the leash32.exe file. Right-click the file and click Properties. On the Compatibility page, select Windows 98/Windows Me compatibility.

Note: 
  Windows XP supports only the MIT Kerberos for Windows 2.1.1 client.


OpenSSL

HostExplorer interfaces to the OpenSSL Project for SSL/TLS support and requires the following DLLs: ssleay32.dll and libeay32.dll. You have the option of building your own DLLs using the OpenSSL source code, or you can obtain the DLLs supplied by Hummingbird in the Connectivity SSL add-on or Connectivity Secure Shell product. If you build your own OpenSSL DLLs, you must build them directly and completely from the OpenSSL release for them to work properly with HostExplorer. Do not attempt to remove routines from these libraries for any reason (for example, to reduce library sizes); otherwise, a General Protection Fault (GPF) might result with libraries that are not complete. If you encounter system problems, use the DLLs provided in the Connectivity SSL add-on. The add-on is available on the product CD or at the following Hummingbird web site:

http://www.hummingbird.com

Once the OpenSSL DLLs are built, you need to copy the DLLs to the security folder. The default location is:

Program Files/Hummingbird/Connectivity/9.00/Security

To build OpenSSL DLLs:

  1. Obtain the latest distribution of the OpenSSL Project at the following web site:

http://www.openssl.org/

Note: 
  Before building the OpenSSL DLLs, make sure that Perl is already installed.

  1. Read the file install.w32, which provides detailed build information for Windows and follow the configuration steps.
  2. In the command line, type the following

cd InstalledPath\OpenSSL

where InstalledPath is the path where OpenSSL is installed.
  1. Enter the following command, as described in the install.w32 document:

nmake -f ms\ntdll.mak
  1. To test the build, enter the following commands:

cd out32dll

..\ms\test

Take note of the following:

perl Configure VC-WIN32

ms\do_ms

Therefore, the assembly languages were not used. To configure the makefiles for those language files, you should run either the ms\do_masm or ms\do_nasm tool. You do not need to execute the Perl Configure script again.

LINK=c:\Program Files\Microsoft Visual Studio\VC98\Bin\link.exe

VT Profile/Secure Shell Connection Settings Help

The help topic for the Secure Shell connection settings for VT profiles is not available.


Host Access Services


Complete Installation of HostExplorer Before Installing Hummingbird Deployment Wizard

If a complete installation of HostExplorer is not performed, the Hummingbird Deployment Wizard is not visible in the feature section tree and cannot be installed. Deployment Wizard requires all six languages to be available and all three HostExplorer emulations (3270, 5250, and Telnet) installed on the machine before it can be installed. A complete installation of HostExplorer ensures that all requirements are met.


Deployed Profile Shortcut Not Supported by Netscape

If Netscape is set as the default web browser, you may encounter runtime errors when launching a deployed profile from the following:

To open profile shortcuts, set Internet Explorer as your default web browser.


Moved Deployed Profiles May Not Launch

If you move or delete deployed profiles, they may not continue to work.


Hummingbird Deployment Wizard


Component Deployment Installer Runs in Language of Initial Installation

The Hummingbird Component Deployment installer always runs using the language specified in the initial installation, regardless of subsequent changes made in Language Chooser.

Language Chooser affects the language for all deployed or installed products on the same PC.


Language Setting Selected in First Deployment Cannot be Changed

The language setting that you selected in the first deployment made to a client will now be set. If you make the first deployment available for all languages, all other deployments will be made with all languages available. For example, if the first deployment is English only, the client will not be able to select another language on subsequent deployments.


Launch Language Chooser from Windows Explorer

There is no shortcut for Language Chooser to launch it on the client machine. To access Language Chooser, you need to launch it manually from Windows Explorer.

To launch Language Chooser, navigate to the deployed Accessories folder and click HCDTLanguageChooser.exe.


Installation Interrupted if Default Language of Client is Not Included in Deployed Project

If the default language of HostExplorer is not included in the deployed project, you may encounter errors when downloading files.


Uninstalling Hummingbird Component Deployment Does Not Remove Netscape Plugin

If you uninstall Hummingbird Component Deployment, the entry for the deployment plugin is not removed from Netscape's plugins database, which prevents Netscape from downloading further deployments after an uninstall. To resolve this, you need to uninstall HostExplorer (Web Deployed) and delete a file in the Windows or Winnt folder.

To run a deployment after an uninstall:

  1. Uninstall HostExplorer (Web Deployed).
  2. Uninstall Hummingbird Component Deployment.
  3. In the Windows or Winnt folder, do one of the following:

Deleting mozver.dat or nsreg.dat deletes all references to third party plugins that have been previously downloaded. The next time you visit a website that requires these plugins, Netscape will download them again.
  1. Use your browser to download the deployment project.

Deployed Session Cannot Co-Exist with HostExplorer Version 7.x

You cannot access a deployed HostExplorer session if version 7.x of HostExplorer is already installed on the same machine. However, you can access a deployed session if version 6.2 or 8.0 of HostExplorer is already installed on your machine.

Note: 
  While Internet Explorer warns you about the lack of co-existence with version 7.x of HostExplorer, the Netscape browser does not.


Running Multiple Versions of Deployed HostExplorer Sessions

You cannot simultaneously run multiple versions (that is, versions 7.x and 8.x) of deployed HostExplorer sessions on the same machine. If you want to run different versions of the deployed sessions, make sure that you uninstall Hummingbird HostExplorer Web Deployment (version 8.x) or Hummingbird HostExplorer ActiveX (version 7.x) before running the other version of the deployed session.


Avoid Naming Conflicts

When creating deployed projects, use the following naming guidelines:


No Spaces Allowed in Project Names When Using Netscape

If you are launching a web-deployed HostExplorer session in the Netscape web browser, make sure that the Deployment Project name contains no spaces.


Metering Values Affect Registry

If you enable Metering on the Metering page of the wizard, the values you specify will replace existing values in the client machine's registry. This can cause unwanted results if not used with care. For example, if you enable metering and leave the URL box blank, then, upon deploying this project, the client machine will stop participating in license reporting (metering).


Uninstalling Web Deployment

If you run a deployed HostExplorer session on a machine that does not have HostExplorer installed, but later want to install HostExplorer, you must first uninstall HostExplorer (web deployed). If required, you can run a deployed HostExplorer session again after the HostExplorer installation is completed.

If you have HostExplorer and Deployment Wizard installed on the same machine and you launch a deployed session from that machine, you must uninstall HostExplorer (web deployed) before you uninstall HostExplorer.

If you run a deployed HostExplorer session on a PC that has a version of Internet Explorer that is less than V4.01 (with Service Pack 2), and you want to uninstall HostExplorer (web deployed), you must install the 50comupd.exe update from Microsoft. This is especially important for machines running on Windows NT 4.0. You can download the file from Microsoft at the following URL, and click the link Download 50comupd.exe (x86):

http://download.microsoft.com/download/platformsdk/Comctl32/5.80.2614.3600/W9XNT4/EN-US/50comupd.exe

Alternatively, the administrator can create a deployment package that contains the 50comupd.exe file and deploy it so that the end users can access it. For information on deploying packages, refer to the Deployment Packager Help and Hummingbird Deployment Wizard Help.


Hide Browse Toolbar Option Not Available in Netscape

The Hide Browse Toolbar option on the Auxiliary Files And Deployment Settings page applies to Internet Explorer only. Netscape does not display browser toolbars.


Index Page Options Not Supported by Netscape

For Index Page Wizard, Netscape does not support any of the Index page options, such as Open Browser In New Window.


HostExplorer Print Services


Print Services Does Not Use Windows Default Printer

To ensure that a printer profile connects, users have to select a specific printer when creating a printer session profile. HostExplorer Print Services cannot utilize the Windows default printer.

When creating a profile on a service in the HEPS Console, you may encounter a Printer Not Found message when connecting to a session. If you receive this error, the session is not connected because the Windows default printer is not recognized by Print Services.

To resolve the connection, select a user-specific printer. This setting remains in effect until the printer is removed. Each time the printer is changed, this setting must be manually changed in order to update the printer destination.


PeSRV Running as a Com Server Not Supported for Win98 and ME

Print Services does not support PeSRV running as a Com Server under Win98 and ME.


Certificate and Key Manager


Certificate Authorities Not Automatically Trusted

PKCS12 certificates can contain matched certificates and keys, as well as Certificate Authority certificates (which are not matched with keys). If, when you import the PKCS12 file, you want to automatically trust the CA certificates in it (that is, you want them placed in the Root certificate store), you must add the following lines to the userdir\security\css.ini file:

[CSS Settings]
Automatically Add CA Certificates to Trusted Root=On

Importing Keys in .pem Format

If you import keys in .pem format, application behavior will differ depending on the key store you are viewing:


Directory Services Applications

The following issues apply to Directory Services Explorer and Hummingbird Directory Services.


Binding to an LDAP Server Under SSL

Before you can bind to an LDAP server under Secure Socket Layer (SSL) authentication, you must install a CA certificate using Microsoft Internet Explorer. The CA certificate must come from the same root Certificate Authority that supplies certificates for the server. The version of Internet Explorer that you use must support SSL.

If you are using Windows 2000/XP, you must update your system before you install the certificate. For more information, see articles Q314864 and Q286158 in the Microsoft Product Support Services web site:

http://support.microsoft.com

Directory Services Explorer and Hummingbird Directory Services support SSL connections to the following LDAP servers:

Sun One Directory Server      Supported on Windows 98/Me/NT/2000/XP/Server 2003, provided your operating system has the latest version of the wldap32.dll system file. To determine what version of this file is on your system, and what products and service packs contain the latest version, see the Microsoft Product Support Services web site.

Microsoft Active Directory Server      Supported on Windows 98/Me/NT/Server 2003. In certain cases, Windows XP/2000 does not support SSL connections to Active Directory servers.


Enabling NTLM Security Services in Windows 98/Me

If you bind as a registered user to an Active Directory LDAP domain and authenticate yourself using SASL, Hummingbird Directory Services and Directory Services Explorer by default use your Windows account credentials for authentication to the LDAP server. However, if you are running Windows 98/Me, you need to enable NTLM security services before SASL authentication can work.

To enable NTLM security services:

  1. In the Windows Control Panel, open the Network application, and then click the Access Control tab.
  2. On the Access Control page, select User-level Access Control, and then type the name of the Active Directory LDAP domain in the Obtain List of Users and Groups From box.

Documentation

The following topics provide information about the documentation included with your Hummingbird product.


Documentation Updates

This section amends errors and omissions in the documentation.


HostExplorer Programming Guide

A draft version of the HostExplorer Programming Guide is available in WinHelp and PDF format. For the most recent version of the documentation, visit the Hummingbird web site or contact Hummingbird Technical Support.


Hummingbird Basic Language Documentation

The Hummingbird Basic Language documentation incorrectly describes how to start a Telnet session using OLE automation. All examples of this process should refer to the WyseTerm object rather than the Telnet object. For example, if a Telnet session already exists, use the following code:

Dim tn As Object
Set tn = GetObject(, "Hummingbird.WyseTerm")

If a Telnet session does not already exist, use the following code:

Dim tn As Object
Set tn = GetObject("Hummingbird.WyseTerm")

Once you have set the object, you can use it for all other Telnet operations (for example, tn.SendStringToTerminal("Hello World")).

This error also occurs in the WyseTerm documentation in the HostExplorer Programming Guide. For more information on starting Telnet sessions using OLE automation, contact Hummingbird Technical Support.


Documentation Set

The following documentation is provided with your Hummingbird product.


Release Notes

Release Notes are available in print and HTML format. The HTML version is automatically installed when you install the product.


Manuals

Hummingbird manuals include the following:

All manuals are available in print and PDF. The PDF versions are installed only if you perform a Complete installation. Otherwise, you can locate them on the product CD in the following path:

cddrive:\Manuals

For a list of manuals that come with your product, see page iii of your Hummingbird product manual.


Help

Help provides context-sensitive information regarding your Hummingbird product. It contains conceptual and reference information, and detailed, step-by-step procedures to assist you in completing your tasks.


Third Party Software

The following software is required for some components. You can install all third party software from Hummingbird Master Setup (msetup.exe).


Adobe Acrobat Reader

Online manuals are available in Adobe Acrobat PDF format. You can use the supplied Adobe Acrobat Reader version to view, navigate, and print these manuals.

The Reader for Windows is located on the CD in the following path:

cddrive:\3rdParty\Acrobat

Sun Java 2 Runtime Environment

This software is required by Xdis. We recommend you install the Sun Java 2 Runtime Environment before you install the Hummingbird product containing these features.

The Sun Java 2 Runtime Environment is located on the product CD in the following path:

cddrive:\3rdParty\SunJRE

MIT Kerberos

Kerberos is a network authentication protocol that provides the necessary network tools to secure information systems across an enterprise. Based on client/server identification, Kerberos uses a key-distribution model and a secure password to restrict access to classified accounts.

To use Kerberos support for HostExplorer, NFS Maestro Client, NFS Maestro Solo, or NFS Maestro Server, you must install the Kerberos software from MIT. To download the latest version of Kerberos, go to the following web site:

http://web.mit.edu/network/kerberos-form.html

For information about Kerberos security, go to the following web site:

http://web.mit.edu/kerberos/www/

For V9.0 Connectivity products, we recommend Hummingbird Connectivity Kerberos.


Contacting Hummingbird

You can contact the Hummingbird Technical Support department Monday to Friday between 8:00 a.m. and 8:00 p.m. Eastern Time.

Hummingbird Ltd.

1 Sparks Avenue, North York, Ontario, Canada M2H 2W1

 

Canada and the USA

International

Technical Support:

1-800-486-0095

+1-416-496-2200

General Enquiry:

1-877-FLY-HUMM

+1-416-496-2200

Main:

+1-416-496-2200

Fax:

+1-416-496-2207

E-mail:

support@hummingbird.com

FTP:

ftp.hummingbird.com

Web Support:

support.hummingbird.com/customer

Web site:

www.hummingbird.com