FXHB1012 Maintenance Update for HPUX eBP File Transfer running on eBP 3.1
         or CandleNet Application Services Pac.

Problem Description:
    Remove 3500Kbyte maximum message size limit from File Transfer.
    See notes at end of file to enable increased message size.

Release Level:
Candle Products - April 2001 GA (RFV100G1)

Corequisite fixes:
FXW41007 - eBP Administrator fixpack

Users Affected:
CandleNet eBP 3.1 or CandleNet Application Services Pac installations on
all platforms.

Resolution:
Apply this maintenance patch

Operating System Version that Fix Applies to:
HP-UX 11.0 (H3)

Modules Replaced:

New and Replaced Modules:

    ldap/cfg:
        4799 Sep 13 2001  kfx.ldf
         542 Aug 23 2001  kfxmsgd.ldf

    toolkit/bin:
      282624 Jul 19 02:35 kfxxfer

    toolkit/lib:
      913408 Jul 19 02:35 libkfxplgro.sl
       12288 Jul 19 02:31 libkfxpmsg.sl

Creation date:
19 July 2002 


Installation steps for CandleNet Application Services Pac:

	This section describes the installation steps for sites that have
installed CandleNet Application Services Pac.  This includes sites that have
installed eBP 3.1 on top of CandleNet Application Services Pac.
(See the section, "Installation steps for eBP 3.1 ", below for installation
steps for sites that have NOT installed CandleNet Application Services Pac).

1. Stop all eBP File Transfer connectors using kucstop.

2. Make backup copies of all of the files listed under the heading
   "New and Replaced Modules."

3. Copy the fix patch, fxhb1012.tar.Z, to the $CANDLE_ROMA_HOME directory.

4. Type the command "uncompress fxhb1012.tar.Z".

5. Type the command "tar xvf fxhb1012.tar"

6. Add Message Descriptor kfxMsg00000002 to the LDAP.  This can be done in one
   of two ways:
   (1) (recommended) use the eBP Installation Configuration Tool to load the
   kfxmsgd.ldf seed file or
   (2) use eBP Directory Administrator to add the message descriptor,
   kfxMsg00000002, setting the message type to "binary" in the "Options" tab.

7. Restart the File Transfer connectors.


Fix Removal Steps:

1. Stop all eBP File Transfer connectors using kucstop.

2. Copy the replaced modules from the backup directory created in
   step 2 of installation instructions to the locations indicated
   in the New and Replaced Modules section above.

3. Restart the File Transfer connectors.





Installation steps for eBP 3.1:

	This section describes the installation steps for sites that have
installed eBP 3.1 but have NOT installed CandleNet Application Services Pac.


   The fixpack will install the new version of eBP File Transfer in
subdirectories of $CANDLE_ROMA_HOME/toolkit.  The previous version of File
Transfer was installed in subdirectories of $CANDLE_ROMA_HOME/apps/connectors.

Consequently there are several differences in eBP File Transfer operations:

	A.  The special instructions for starting and stopping File Transfer
connectors that were supplied in Section 10 of the README file on the eBP 3.1
CD no longer apply and can be ignored after applying this fixpack.
	B.  Any scripts (bat files, etc.) designed to start, stop, or control
File Transfer connectors may need to be altered to account for this directory
change.


1. Stop all eBP File Transfer connectors using kucstop.

2. Make backup copies of all of the files in subdirectories of
   $CANDLE_ROMA_HOME/apps/connectors, if these have not been removed previously.
   The simplest way to do this is with the
   "cp -r apps/connectors <target directory>" command.

3. Copy the fix patch, fxhb1012.tar.Z, to the $CANDLE_ROMA_HOME directory.

4. Type the command "uncompress fxhb1012.tar.Z".

5. Type the command "tar xvf fxhb1012.tar"

6. Add Message Descriptor kfxMsg00000002 to the LDAP.  This can be done in one
   of two ways:
   (1) (recommended) use the eBP Installation Configuration Tool to load the
   kfxmsgd.ldf seed file or
   (2) use eBP Directory Administrator (formerly called Roma Object Manager) to
   add the message descriptor, kfxMsg00000002, setting the message type
   to "binary" in the "Options" tab.

7. Remove the apps/connectors directory and all of its subdirectories,
   if not already removed:  cd to
   $CANDLE_ROMA_HOME and issue the command "rm -r apps/connectors".

8. Restart the File Transfer connectors.


Fix Removal Steps:

1. Stop all eBP File Transfer connectors using kucstop.

2. Recreate the $CANDLE_ROMA_HOME/apps/connectors directory tree and copy the
   saved modules from the backup directory created in step 2 of installation
   instructions.

3. Restart the File Transfer connectors.


Notes
-----

Maximum message size limits:

  This update increases the maximum message size that the File Transfer
  Connector will permit. Some restrictions are still in place. The 
  limits of the underlying transport mean that transfers may fail if the
  Connector exceeds those limits. An appropriate error message will be 
  generated.

  For Unix platforms, the process heap limit will apply (ulimit -d).
  File Transfer will honour that limit - if you increase the
  MaxDataMessageSize attribute beyond 25% of the process heap limit FT
  will reduce the MaxDataMessageSize to 25% of the limit. If this is too small
  then you should increase the processes heap limit using the ulimit command.
  You will need root privileges if you need to exceed the hard limit for
  the system.


