****************************** XiFusion v1.4 ********************************

I.  Introduction
II.  Installation
III.  Testing
IV.  What's New
V.  Credits
VI.  Conclusion


I.  Introduction
  XiFusion is a tiny wrapper application for Xitami to make it work properly
with ColdFusion (hence the name XiFusion).  The program is designed to make
it easy to set up ColdFusion to work with the Xitami server.  XiFusion has
only been tested with ColdFusion Server Express v4.0.  Further testing will
be performed over the next couple months.  XiFusion is way too cool to keep
as part of the Shining Light Productions' Intranet...so, enjoy!


II.  Installation
  XiFusion installation is a snap.  First install Xitami (preferrably as a
Windows NT service since ColdFusion runs well under NT).  Then install
ColdFusion.  During the installation, Xitami will not be detected (this is to
be expected, hence the need for XiFusion).  At that point continue on even
though the ColdFusion installer complains.  When the main web page directory
dialog comes up, locate your Xitami directory where web pages are stored
(usually C:\Program Files\Xitami\webpages).  Finish the installation of
ColdFusion and reboot.

  When NT (or 95/98) comes back up, locate the ColdFusion binary directory
(usually C:\CFUSION\BIN) and copy XiFusion.exe into that directory.  Now go
to the Xitami directory (usually C:\Program Files\Xitami) and edit the
Xitami.cfg file.  Look for the [Filter] section.  Add a new filter with a
line that looks like the following:

  .cfm=c:\cfusion\bin\XiFusion c:\cfusion\bin\cfml.exe

  Filters are executables that run when the server sees a particular
extension.  The XiFusion executable is tied to the .cfm file.  The text
following XiFusion is an argument that tells XiFusion where the ColdFusion
parser is.  XiFusion wraps cfml.exe with the necessary data to run and then
executes the program.


III.  Testing
  This one is easy.  First, before testing the XiFusion wrapper, the Xitami
service needs to be restarted to recognize the changes.  This can be done
from Control Panel->Xitami->Suspend...wait a second...->Start.

  Now locate the ColdFusion group in the Start Menu.  Launch the ColdFusion
Administrator.  If everything worked fine so far (no broken images), enter
the password entered during the installation and click submit.  If the
password is correct and a menu appears at the left, then the ultimate test
has arrived.  (To correct the broken images copy all of the files in the
'c:\Program Files\Xitami\webpages\CFIDE\Administrator\images' directory to
'c:\Program Files\Xitami\webpages\CFIDE\images').

  Click on the 'ODBC' option.  A few datasources should appear.  Click the
'Verify All' button.  If a dialog box pops up saying something about a DLL
not loading, then that means the Access 97 ODBC database drivers haven't been
installed (install Office 97 to correct the problem).  More than likely,
though, the datasources should test just fine (except for the MQIS SQL Server
datasource).  If the Access driver based databases work, then that means
everything should work.


IV.  What's New
Version 1.4:
  Fixed a multi-threading problem.  Two copies of XiFusion executing at the
    exact same time on the server caused pages to not be returned.
  Fixed a problem with one type of absolute URL.  Version 1.0 supported
    'http://' links, v1.3's relative link handler took away that support.
    The relative link handler now handles all absolute and relative URLs
    properly.

Version 1.3:
  XiFusion is a few kilobytes larger this time since it was re-written
    (64,000 bytes).
  Fixed the <CFLOCATION> tag bug with relative links.  In XiFusion v1.0,
    relative links would cause something to "hang" (probably the web
    browser) and the browser would time out on pages.

Version 1.0:
  Original version


V.  Credits
  Name                                 E-mail Address
-----------------------------------------------------------------------------
  Thomas J. Hruska                     shinelight@crosswinds.net


VI.  Conclusion
  XiFusion brings together the best of both worlds:  Fast and Free.  With the
powerful combination of Xitami, XiFusion, and ColdFusion Express, dynamic web
page design is only a couple tags away!  Enjoy this product because it is
being released as Freeware!  XiFusion is just one more way that Shining Light
Productions is "Meeting the Needs of Fellow Programmers!"

Signed,
Thomas J. Hruska

Shining Light Productions
"Meeting the Needs of Fellow Programmers"
