==================================================================

                         EMSRV 7.1a

                        RELEASE NOTES        


                    
==================================================================

9 July 2001



==================================================================
CONTENTS
================================================================== 
  
1.   Overview
2.   Supported Platforms
3.   Distribution Contents
4.   EMSRV for NetWare
5.   EMSRV for Windows NT/2000
6.   EMSRV for OS/2
7.   EMSRV for Solaris
8.   EMSRV for HP-UX
9.   Migration from EMSRV 6.x
10.  Known Problems
11.  For More Information
12.  Notices


==================================================================
1.  Overview
==================================================================

This document describes specific information about EMSRV 7.1a.
Use the EMSRV Installation User's Guide with this release for
information on installing and using EMSRV.

1.1     New with EMSRV 7.1a

The major enhancements in EMSRV 7.1a since EMSRV 6.23 are:
 
    Support for Windows 2000 / XP
    Support for OS/2 Warp Server for e-business
    Support for NetWare 6.0
    Support for Solaris 8.0
    Support for HP-UX 11.0
    Support for AIX 4.3.2
    Support for Linux

The major enhancements in EMSRV 7.1a since EMSRV 6.24 are:

    Support for stored resources used by VisualAge for Java 3.5
    Support for FAT32 volumes on Windows 2000
    Support for PAM authentication on Linux and Solaris platforms
    Support for DCE authentication on AIX platforms
    Support for NetWare 5.1
    Support for Red Hat Linux 6.1 and 6.2
    Support for AIX 4.3.3
    Support for non-English platforms
    Support for authentication using Active Directory Services
    Support for cross-domain authentication on Windows NT

Changes made to EMSRV 7.1a since EMSRV 7.1 are limited only to bug
fixes.  The specific changes are listed below:

a) Fixed bug in EMADMIN (this release includes EMADMIN 7.0a) where
a copy of a library would fail with an error if the size of the
library in bytes was exactly divisible by 32768.

b) Fixed bug in EMSRV where in extremely rare conditions,
connections with locks might be incorrectly terminated by the
"EMSRV inactivity monitor".  Such terminations would be
accompanied by a warning message in the log but since the default
behavior of EMSRV is only to report errors, these messages were
not often seen.

Changes made to EMSRV 7.1a since EMSRV 7.0 are limited only to bug
fixes and minor enhancements for the purpose of making EMSRV usage
more consistent across all platforms. The specific changes are
listed below:

a) Fixed bug where a directory tree could not be deleted on UNIX
platforms. This was causing problems when releasing resources or
versioning projects with VisualAge for Java 3.5.

b) Removed -n option to disable tracking of statistics. Statistics
are now always tracked.

c) Removed -w option to track locks. Locks are now always tracked.

d) Removed -rd option on PC platforms to disable authentication.
Authentication is disabled by default.

e) Changed -v option on UNIX platforms to -rn for consistency with
PC platforms.

f) Changed -r option on UNIX platforms to -rp for consistency with
PC platforms.

g) Removed -lt option on UNIX platforms.

h) Changed default free space threshold on UNIX platforms to 10000
KB for consistency with PC platforms.

i) Fixed incorrect reporting of installed memory on NetWare and
Windows NT/2000.

j) Fixed bug where errors were not being logged on UNIX platforms.

k) Fixed bug on NetWare where memory for an SMP machine is
incorrectly reported.

l) Added back -a option on PC platforms to change the timeout for
killing connections that are inactive with a lock.

m) Changed default for inactivity timeout from 360 seconds to 30
seconds.

n) Removed -lp option on UNIX platforms to set timeout for killing
connections that are inactive with a lock.

o) Changed default number of connections from 256 to 512.

p) Fixed bug on Windows NT/2000 platforms, where changing the
current working directory for one connection would cause the
current working directory to be changed for all connections. If a
user was browsing the filesystem managed by EMSRV or querying or
loading managed resources with VisualAge for Java 3.5, other users
would sometimes experience failures when attempting to perform any
operation that supplied a relative pathname to EMSRV.

q) Removed support for Windows NT/2000 SMP hardware.

Changes made to EMSRV 7.1a since EMSRV 7.0a are as follows:

a) Added copy resource operation to improve performance of
resource management for VisualAge for Java 3.5

b) For UNIX platforms, removed all code associated with device
numbers rendering both the -xd and -xn options invalid. EMSRV will
now check the filesystem type and reject any path residing on a
filesystem of type "nfs" (for AIX, HP-UX, and Solaris) or type
0x6969 (NFS_SUPER_MAGIC) (for Linux).

c) Added ability to run EMSRV for Windows NT/2000 on SMP hardware
with -mp option.

==================================================================
2.  Supported Platforms
==================================================================

The following platforms are supported for this release. The
supported platforms may change over time as new releases of
servers are tested and patches are received from vendors to fix
existing problems. Only English platforms are listed below. See
Section 12 for information on non-English platforms.
        
2.1     Servers

The various EMSRV implementations have been tested and certified
for the following operating systems:

    NetWare 4.2, 5.1, 6.0
    OS/2 Warp 4.0, OS/2 Warp Server for e-business
    Windows NT Server 4.0, with Service Pack 5
    Windows NT Workstation 4.0, with Service Pack 5
    Windows 2000 Professional
    Windows 2000 Server
    Windows 2000 Advanced Server
    Windows XP Professional
    Solaris 2.6 with Patch 106257-05, 7.0, 8.0
    HP-UX 10.20, 11.0
    AIX 4.3.2, 4.3.3
    Red Hat Linux 6.1, 6.2


2.2     Clients

With the EMADMIN command utility, you can communicate with EMSRV
from a workstation.  The following operating systems have been
tested and certified for this release of the EMADMIN and EMDEVNUM
utilities:

    OS/2 Warp 4.0, OS/2 Warp Server for e-business
    Windows 95, 98, and 98 (Second Edition)
    Windows NT Server 4.0 (with Service Pack 5)
    Windows NT Workstation 4.0 (with Service Pack 5)
    Windows 2000 Professional
    Windows 2000 Server
    Windows 2000 Advanced Server
    Solaris 2.6, 7.0
    HP-UX 10.20, 11.0
    AIX 4.3.2, 4.3.3
    Red Hat Linux 6.1, 6.2

EMSRV and EMSRV utilities may work with older and newer versions
of supported operating systems and/or with patches or service
packs supplied by the operating system vendors.  However at the
time of this product release, OTI has not tested on any platforms
other than those listed above.

Operating system releases or patches that modify filesystem,
network, or authentication behavior may produce unexpected
results. If there is any doubt as to whether a given configuration
is supported by OTI, contact OTI or IBM Technical Support.


2.3	    Filesystems

The various EMSRV implementations have been tested and certified
with the following filesystems:

    NetWare
        NWFS (NetWare File System) with DOS namespace
        NWFS with OS/2 or LONG namespace
        NSS (Novell Storage Services) with DOS namespace
        NSS with OS/2 or LONG namespace

    OS/2
        HPFS (High-Performance File System)
        FAT

    Windows NT/2000
        NTFS (New Technology File System)
        FAT32
        FAT

    Solaris
        UFS (UNIX File System)

    HP-UX
        VxFS (Veritas File System)

    AIX
        JFS (Journaled File System)

    Linux
        EXT2FS (Second Extended File System)

Many operating systems support installable filesystems and there
are a great many such filesystems available, particularly for UNIX
platforms. Using EMSRV with filesystems that have not been tested
and certified by OTI may produce unexpected results, possibly
leading to repository corruptions.

In particular, EMSRV only supports locally-mounted filesystems.
Remotely-mounted filesystems accessed using network requestors,
redirectors, or other similar software, cannot always guarantee
the integrity of the repository. Where possible, EMSRV will
restrict the use of filesystems to locally mounted volumes. OTI
strongly cautions against circumventing these restrictions.

Many filesystems support optional compression and encryption.
Unless these features are provided by default, OTI has not tested
nor certified them and cautions against their use if not for any
other reason than their impact on performance.

        
2.4     Authentication

The various EMSRV implementations have been tested and certified
with the following authentication methods:

    NetWare
        passwd.dat
        NDS (Novell Directory Services) accounts

    OS/2
        passwd.dat

    Windows NT/2000
        passwd.dat
        NT 4.0 SAM-based domain accounts
        NT 4.0 local SAM database
        ADS (Active Directory Services) accounts

    Solaris
        passwd.dat
        Local account database
        Local account database with shadowed passwords

    HP-UX
        passwd.dat
        Local account database
        Local account database with shadowed passwords

    AIX
        passwd.dat
        Local account database
        Local account database with shadowed passwords
        DCE (Distributed Computing Environment)

    Linux
        passwd.dat
        Local account database
        Local account database with shadowed passwords
        Local account database with MD5 passwords


==================================================================
3.  Distribution Contents
==================================================================

EMSRV 7.1a is shipped on a CD-ROM that contains the program 
executable and utilities for each of the supported platforms. In
this way, customers can change platforms easily without needing to
exchange media or licenses; however, single-user license
restrictions still apply. The installation CD-ROM contains the
following directory structure and released files. Following are
the files shipped with this release.


        README.TXT              This file
        EMSRV_71.PDF            Documentation in Adobe Acrobat
                                format
        passwd.dat              A sample password file
                                for simple file-based
                                authentication


3.1     EMSRV 7.1a for NetWare (NDS) May 28 2002 14:14:28 (EST)

        EMSRV.NLM               EMSRV NLM (NetWare Loadable 
                                Module)


3.2     EMSRV 7.1a for Windows NT/2000  May 10 2002 15:05:17 (EST)

        EMSRV.EXE               Main EMSRV program
        EMSRVMSG.DLL            EMSRV NT language support
                                DLL
        EMADMIN.EXE             EMSRV administration
                                program

3.3     EMSRV 7.1a for OS/2 May 28 2002 15:15:09 (EST)

        EMSRV.EXE               Main EMSRV program
        EMCLIENT.MOD            Client connection program.
                                One instance of this module is
                                run by EMSRV.EXE for each
                                client connection that is made.
        EMADMIN.EXE             EMSRV administration
                                program

3.4     EMSRV 7.1a for Solaris (SPARC) May 28 2002 14:32:29 (EST)

        emsrv                   EMSRV binary
        emadmin                 EMSRV administration
                                program
        pam.conf                Sample PAM configuration file


3.5     EMSRV 7.1a for HP-UX May 28 2002 14:34:52 (EST)

        emsrv                   EMSRV binary
        emsrv.shadow            EMSRV binary for shadowed
                                password accounts
        emadmin                 EMSRV administration
                                program


3.6     EMSRV 7.1a for AIX May 28 2002 14:22:14 (EST)

        emsrv                   EMSRV binary
        emadmin                 EMSRV administration
                                program


3.7     EMSRV 7.1a for Linux (Intel) May 28 2002 15:14:50 (EST)

        emsrv                   EMSRV binary
        emadmin                 EMSRV administration
                                program
        PAM/emsrv               Sample PAM configuration file
                                (as it is delivered on the 
                                installation media)


==================================================================
4.  EMSRV for NetWare 
==================================================================
       
4.1     Introduction

It is recommended that the NetWare Minimum Patch List be applied
to the server running EMSRV for NetWare. The various files may be
obtained from Novell's website at
http://support.novell.com/misc/patlst.htm. 

EMSRV for NetWare requires that the NetWare TCP/IP stack
(TCPIP.NLM) be loaded and configured on the server. When EMSRV for
NetWare is started, TCPIP.NLM will be loaded automatically if it
is not already loaded. EMSRV for NetWare will also automatically
load the NWSNUT.NLM which is required by the EMSRV for NetWare
user interface.

4.2     Support for repositories greater than 4 GB in size

Although NSS volumes can support files greater than 4 GB in size,
Novell has yet to provide an API to permit programs to do this
other than using direct-sector I/O.

4.3     Loading the NLM on NetWare 4.11 and NetWare 5.0

EMSRV no longer supports NetWare 4.11 or NetWare 5.0, but EMSRV
can be run on those platforms if additional steps are taken.
CLIBAUX.NLM must be loaded before the EMSRV NLM is loaded.
CLIBAUX.NLM is included with Novell's NetWare 4.11/4.2 Support
Pack 8a, but is also available separately from Novell in the file
CLIBAUX1.EXE, which can be found at the following location:

     http://support.novell.com/cgi-bin/search/download?/pub/
     updates/nw/nw42/clibaux1.exe

4.4     Files not needed in this release

In previous releases of EMSRV for NetWare, two additional files -
EMSRV.HLP and EMSRV.MSG were required along with the NLM.  These
files are no longer needed as they have been bound into the NLM.


==================================================================
5.  EMSRV for Windows NT/2000
==================================================================

5.1     Introduction

EMSRV now supports Windows 2000 in addition to Windows NT 4.0.
When using Windows NT 4.0, it is highly recommended that Service
Pack 5 or later be applied to a machine running EMSRV for Windows
NT/2000. Note that support for Windows NT 3.51 has been dropped in
this release.

EMSRV for Windows NT/2000 will run on the following platforms:

     Windows NT Workstation
     Windows NT Server
     Windows 2000 Professional
     Windows 2000 Server
     Windows 2000 Advanced Server

OTI recommends running EMSRV on a server-class machine. The 
remote drive restrictions mentioned above will disallow any access
to libraries residing on a drive that is not located on a Windows
NT workstation running EMSRV.

5.2     Withdrawal of support for SMP hardware

IMPORTANT NOTE: Running any release of EMSRV for Windows NT/2000
on a machine with more than one processor, may lead to
repositories becoming corrupt.

As of this release, EMSRV will no longer run on SMP hardware
(machines with more than one processor). The decision to remove
support for SMP hardware is due to the increasing number of
reports concerning repository corruptions with Windows NT Servers
and machines with two or more processors.

This restriction may be lifted in the future if suspected Windows
NT/2000 filesystem bugs are confirmed and fixed. EMSRV continues
to support SMP hardware for all other platforms.

If EMSRV 7.1a detects more than one installed processor, it will
be unloaded and will report the following to the console
or if EMSRV is running as a service, to the Application Log
(viewable with the Windows Event Viewer):

WARNING: Running EMSRV for Windows NT/2000 on multiprocessor
         hardware is not supported due to suspected operating
         system bugs that may result in repository corruptions.
         Install and run EMSRV on a machine with a single
         processor or start EMSRV with the -mp option to bypass
         this check.
         
The check for SMP hardware can be bypassed by starting EMSRV
with the -mp option.  By doing this, you will be running EMSRV
on an unsupported platform and must assume full responsibility
if repositories become subsequently corrupted.  When started with
the -mp option, EMSRV will still report a warning to the console
or if EMSRV is running as a service, to the Application Log
(viewable with the Windows Event Viewer):

WARNING: Running EMSRV for Windows NT/2000 on multiprocessor
         hardware is not supported due to suspected operating
         system bugs that may result in repository corruptions.
         You have chosen to start EMSRV with the -mp option to
         bypass a check that normally restricts EMSRV from running
         on multiprocessor hardware.  This may cause repositories
         to become corrupted.


==================================================================
6.  EMSRV for OS/2
==================================================================

6.1     Introduction

EMSRV for OS/2 now supports OS/2 Warp Server for e-business in
addition to OS/2 Warp 4.0. Support for OS/2 Warp 3.0 has been
dropped in this release.

EMSRV for OS/2 uses one process per client connection with one
thread per process. The EMSRV connection limit is therefore bound
by the number of threads which is set in the CONFIG.SYS. Warp 4.0
sets the thread limit at 1024, which should be more than enough
for most installations.

6.2     Support for JFS volumes

IMPORTANT NOTE: Although this release of EMSRV for OS/2 is aware
of the Journaled File System (JFS) available on OS/2 Warp Server
for e-business, JFS is NOT currently supported. At the time
of release, there are bugs in the JFS implementation of file
locking that prevent EMSRV from working correctly.  If
repositories are accessed on JFS volumes, clients may experience
failures and repositories may become corrupted.  To find out the
latest status of support for JFS volumes on OS/2 Warp Server for
e-business, contact OTI or IBM Technical Support.


==================================================================
7.  EMSRV for Solaris
==================================================================

7.1     Authentication

Authentication for EMSRV for Solaris is implemented using PAM.
This allows both shadowed and non-shadowed passwords to be
supported with one EMSRV executable.

There is a bug in the Solaris 2.6 implementation of PAM that
prevents EMSRV from working correctly. The patch 106257-05 must be
applied when using EMSRV with Solaris 2.6. The patch is available
at:

http://sunsolve.sun.com/pub-cgi/retrieve.pl?doc=fpatches%2F106257&zone_32=PAM

The specific bug that this patch fixes is:

4092227 pam_conv appdata_ptr member is not passed thru to conv()
function as documented

The patch is not required for Solaris 7.0.


==================================================================
8.  EMSRV for HP-UX
==================================================================

8.1     Authentication

EMSRV for HP-UX continues to implement authentication using two
separate EMSRV executables. Although HP-UX 11.0 supports PAM,
there is a bug in the implementation that is identical to the bug
in the Solaris 2.6 implementation of PAM, as described above. To
date, Hewlett-Packard does not have a patch to correct this
problem.


==================================================================
9.  Migration from EMSRV 6.x
==================================================================

To move from EMSRV 6.x to EMSRV 7.1a, simply perform the normal
backups, shut down your EMSRV 6.x, install EMSRV 7.1a, and start up
EMSRV 7.1a. 

EMSRV 7.1a is completely compatible with EMSRV 6.x. For example, if
you are running VisualAge for Java 3.02 or older or VisualAge
Smalltalk, you can connect to a repository running under EMSRV
7.0. You will see no difference, and migration does not require
any special steps.


==================================================================
10.  Known Problems
==================================================================

10.1    Interchanging Different Versions of EMSRV and EMSRV
        Utilities

        You must use EMADMIN 7.0 with EMSRV 7.1a.  EMADMIN 7.0
        will not work correctly with releases of EMSRV before 7.0.

10.2    EMSRV is Not Supported on 800-Class HP Architectures

        HP-UX is supported on 700-class workstation machines only.
        It has been tested on an HP-UX 9000/715/60 machine and an
        HP-UX 9000/782/200+ machine. EMSRV is not supported on
        800-class machines because 800-class (server) machines
        have a different architecture and require different
        binaries.
        
10.3    Passwords Containing Non-ASCII Characters Cannot be Used
        to Authenticate With EMSRV When Entered in Response to
        a Prompt From EMADMIN on Non-English Windows Platforms
        
        Due to a bug in the Microsoft C run-time libraries, any
        password containing non-ASCII characters and entered in
        response to the prompt:
        
        'Enter the password of the user who started EMSRV'
        
        will not be correctly interpreted.  The workaround is
        to supply the password with the -p option when running
        EMADMIN.
        
10.4    Menus and Windows Appear With Garbage Characters When
        Running on Japanese NetWare
        
        The EMSRV for NetWare NLM uses Novell's NLM User Interface
        Developer Components (NWSNUT).  When running on Japanese
        NetWare, graphics characters used in the NWSNUT menus and
        windows are not available and will appear as 'garbage'
        characters.  This is not a bug in the EMSRV NLM nor in
        NetWare, but rather it is a limitation of the Shift-JIS
        code page (932).  See TID 1001298 in the Novell
        Knowledgebase for more information.
        
10.5    EMADMIN 7.0 Does Not Copy Stored Resources Directory

        When EMADMIN 7.0 is used to copy a VisualAge for Java 3.5
        repository, it does not copy the corresponding stored
        project resources directory.  This feature will be
        implemented in EMADMIN 7.1.  Contact OTI or IBM Technical
        Support for availability of EMADMIN 7.1
        
10.6    When Running EMSRV as a Windows NT/2000 Service on SMP
        Hardware Without -mp Option, EMSRV Will Fail to Run and
        Report Error 2140
        
        If you attempt to run EMSRV for Windows NT/2000 as a
        service without using the -mp option to bypass the check
        for SMP hardware, the service will not start and a dialog
        will appear will the following text:
        
            Could not start the EMSRV service on \\MACHINENAME
            Error 2140: An internal Windows NT error occurred.

        The Application Log (viewable with the Windows Event
        Viewer) will contain a detailed message describing why
        EMSRV did not run.  A side-effect of this behaviour is
        that if you again attempt to install EMSRV as service
        (e.g. to add the -mp option), the service will install
        successfully but you will receive the following error:
        
            Message file emsrvmsg.dll, could not be copied
            to C:\WINNT\System32\emsrvmsg.dll
             --- OS error 1224: The requested operation could not
             be performed on a file with a user mapped section
             open.
        
            Make sure the DLL is in the same directory as
            EMSRV.EXE.
            
        The error can be ignored as the DLL will already have
        been installed when the service was previously installed.

10.7    EMSRV May Report Errors on NetWare 6.0 when ConsoleOne is
        open.
        
        If you start EMSRV as a non-administrator user after
	ConsoleOne has been started on the server as an
	administrator user, EMSRV will report errors like the
	following:
        
        11:44:54 on Tue Jul 09, 2002 ERROR basicGetVolumeFreeSpace
        NWGetExtendedVolumeInfo returned 35323
        11:44:54 on Tue Jul 09, 2002 ERROR CheckFreeDiskSpaceThreshHold
        free space could not be determined, rc=-1

        EMSRV will not run when ConsoleOne is opened on the server
        by an administrator user. Shut down ConsoleOne on the server
        and do administration from a client, or log into ConsoleOne
        as another user.

        
==================================================================
11.  For More Informaion
==================================================================

For more information on PAM, please refer to the following URLs.

    Linux PAM:

http://www.kernel.org/pub/linux/libs/pam/

    PAM on Red Hat Linux:

http://www.redhat.com/support/manuals/RHL-6.0-Manual/
install-guide/manual/doc089.html

    PAM on Solaris:

http://www.sun.com/software/solaris/pam/


==================================================================
12.  Notices
==================================================================

Copyrights
        (c) 1990, 2002 Object Technology International Inc. (OTI).

        Object Technology International Inc. (OTI) is a wholly
        owned subsidiary of IBM Canada, Ltd.

Trademarks
        ENVY is a registered trademark of Object Technology
        International Inc. (OTI).

        Other product names may be trademarks of their respective
        companies.
