UNIX-Connect Release V2.2.0.8
=============================

Compatibility
~~~~~~~~~~~~~
This release is compatible with Reality 15.1 and above. After installation
Reality MUST be rebuilt and Reality 15.1 requires fix 15.1.0.0293 before this
is done.


Installing from the Reality CDROM or ISO
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

cd into the the cdrom base directory then type

$ setup

A menu will be presented to enable easy selection of UNIX-Connect
components to install or remove.

IMPORTANT. If you have a previous release installed then you should remove
that release using the menu option before installing the new release.


Installing from the UNIX-Connect tar image
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Log in as root, if there is an active session manager shut it down:

# /usr/RCS/rcs stop

Enter the UNIX-Connect setup menu:

# su - rosi
$ ksh
$ cd /tmp
$ tar -xvf UXC.V2.2.0.8.tar
$ cd /tmp/uxc
$ ./setup

A menu will be presented to enable easy selection of UNIX-Connect
components to install or remove.

IMPORTANT. Any existing installation should be removed before installing
this release. This can be done with the setup command just described.

Release Notes - 2.2.0.8
~~~~~~~~~~~~~~~~~~~~~~~
(91688) While installing Unix Connect on the latest Linux OS version, 
        multiple library-related failures were encountered. The installation
        scripts have been updated to correct the required library links and
        eliminate the need for manual intervention during the setup process. 

(91690)	The issue encountered while attempting to clear logs in Netadmin 
        has been resolved

(91689) While installing Unix Connect on the latest Linux OS version, we
        encountered an issue with the stime() function, which is no longer
        supported in newer GCC versions (above GCC 10.5). The code has been
        updated to replace the use of stime() and ensure compatibility with 
        the latest GCC versions

Release Notes - 2.2.0.7
~~~~~~~~~~~~~~~~~~~~~~~

(85959)	Additional code to handle npu hanging waiting for the LPR daemon to
	send an acknowledge to an LPR command. Npu waits up to NpuDelay,
	seconds, as specified in the Reality config file, for incoming data
	from the LPR daemon. On failure it will perform the normal
	re-connection retry loop.

Release Notes - 2.2.0.6
~~~~~~~~~~~~~~~~~~~~~~~

(91528)	Fix npu hanging when failing to connect to an LPR printer which is
	powered off or offline. A number of other issues have also been fixed:

	An anomaly with fstat on Linux could result in job data getting lost.

	A timeout on data from the despooler was being treated as a valid end
	of job when using signal synchronisation with possible data loss.

	The npu was not detecting when the printer was closing the connection
	before all the print data had been processed. Resulting in lost print
	jobs not being reported.

Release Notes - 2.2.0.5
~~~~~~~~~~~~~~~~~~~~~~~

Interim baseline. Superseded by 2.2.0.6.

Release Notes - 2.2.0.4
~~~~~~~~~~~~~~~~~~~~~~~

(#)	Add README (this file) to the installation directory.

(85947)	Remove the extra screen output from remlog during connect which was
	introduced in V2.2.0.2.

Release Notes - 2.2.0.3
~~~~~~~~~~~~~~~~~~~~~~~

(#)	Fix issue introduced in 2.2.0.2 where the LBS telnet daemon generates
	the incorrect PLID.

Release Notes - 2.2.0.2
~~~~~~~~~~~~~~~~~~~~~~~

(#)	The UNIX-Connect devices, formerly created in /dev/rcs, are now
	created	in /usr/RCS/dev. Oracle have been making it increasingly
	difficult for third party vendors to create devices in /dev/.
	Installation will continue to attempt to create a soft-link to
	/usr/RCS/dev as /dev/rcs, just so that the the ps command is able to
	display sensible information about the TTY devices.

(#)	Debug tracing has been enhanced to include timestamps to a microsecond
	resolution. This helped in measuring peformance.

(#)	Improve file open performance. Some simple tests opening remote files
	from multiple Reality processes indicate an improvement in performance
	of roughly double. This was largely achieved by changing the mechanism
	used to	pass the network connection from session manager to Reality to
	use the	'domain socket' model. These improvements were specifically
	made for Solaris.

85903	Fix user authentication when the UNIX user ID is used rather than the
	UNIX-Connect USERS-FILE. Encrypted UNIX passwords up to 256 characters
	are now supported.

91475	Avoid causing a dirty Reality database on AIX when large number of
	opens are occuring near simultaneously for the same file with the same
	user credentials.

85791	Enable npu scripts to be patched.

85783	Install now prompts user to remove previous installations if present.

85690	Entering commands at the remlog prompt are now correctly interpreted.

85667	The LBS telnet daemon now uses the client's TERM type.

91500	The librs_64 library is now supplied as a shared object (librcs_64.so)
	on Linux. This was necessary to fix issues with the UNIX ODBC driver.

The following were also supplied as fixes for 2.1.

91352	Reality was logging off on receipt of a SIGPIPE signal when a
	DataBasic SEND was attempted on connnection which had been
	DISCONNECT'ed at the remote end. This problem was noticed
	specifically on Centos but was a problem with the 'SOCKET' network
	type as opposed to the 'TLI' type.

85902	The LBS telnet daemon can core dump when /etc/telnetd.msg, the logon
	banner message file is too large. This has been known to occur at
	around 900 bytes but it was sometimes larger.

91449	Remlog/NET-LOGON broken on Centos 7, this was caused by a tightening
	up on the use of the grantpt function in Centos 7.

91435	ROSFS connections can fail with user reported as unknown, specifically
	on AIX.
