JBuddyTM CF README
Welcome to Zion Software's JBuddy-CF Instant Messaging Event Gateway Plugin for ColdFusion MX 7 Enterprise or ColdFusion 8. JBuddy-CF adds to the built-in IM protocols available within ColdFusion Event Gateways and brings support for popular public IM protocols including AIM, MSN, Yahoo, and ICQ as well as Zion's own Enterprise IM server, JBuddy Message Server.
Installation Notes
*** You should stop your ColdFusion server before proceeding with this installation ***
- JRE/JVM 1.3+
- Installed ColdFusion MX 7 Enterprise or ColdFusion 8 with IM Event Gateway Services Enabled
- Internet Firewall with outgoing ports open for underlying IM protocols or a SOCKS 4 or SOCKS 5 Proxy available
- Screen Name and Password configured for AIM or MSN, or Yahoo Messenger or ICQ or JSC on Zion's Enterprise IM solution, JBuddy Message Server
You must specify the Installation Target Location to be your ColdFusion home location {cf.root} as JBuddy-CF-Installer will install files into this location. For example, on Windows, the default location would be C:\CFusionMX7 (ColdFusion MX7)
NOTE Uninstalling Steps below.
JBuddy-CF installs the following files off the {cf.root} location:
Core classes:
- lib\im.jar (updated)
- lib\smack.jar (updated)
- lib\STComm.jar (updated)
- lib\JBuddy.properties (updated)
- lib\im.jar.orig (backup of im.jar)
- lib\smack.jar.orig (backup of smack.jar)
- lib\STComm.jar.orig (backup of STComm.jar)
- lib\JBuddy.properties.orig (backup of JBuddy.properties)
- gateway\lib\JBuddy-CF.jar
Event Gateway Default Properties:
- lib\AIM.properties
- lib\ICQ.properties
- lib\MSN.properties
- lib\YIM.properties
- lib\JSC.properties
Event Gateway Config Instances:
You will have one cfg file for each Gateway Instance you create in the CFusion Administrator. You need to supply a screen name and password:
- gateway\config\register_jbuddy_cf_gatewaytypes.cfm (see GettingStartedGuide.html)
- gateway\config\aim.cfg
- gateway\config\icq.cfg
- gateway\config\msn.cfg
- gateway\config\yim.cfg
- gateway\config\jsc.cfg
JBuddy-CF Documentation:
JBuddy-CF Examples:
- gateway\cfc\JBuddy-CF\echo.cfc
- gateway\cfc\JBuddy-CF\tempconverter.cfc
- gateway\cfc\JBuddy-CF\menu\main.cfc
Misc:
- bin\JBuddyCF-RestoreOriginalFiles.*
- Uninstaller\uninstall.jar (uninstaller executable)
- lib\.licenseJBuddyCF (license directory)
- ** Shutdown ColdFusion MX 7 Enterprise or ColdFusion 8 server **
- Double click on {cf.root}\Uninstaller\uninstaller.jar and DO NOT check the Box to Force deletion of {cf.root}
- Restart ColdFusion Server
- Manually remove the Event Gateways created with JBuddy-CF
Please reply to the email address you received your JBuddy-CF software from.
*The JSC event gateway type allows ColdFusion to work with Zion's Enterprise Instant Messaging solution, JBuddy Message Server and is available as a separate product from Zion Software.
JBuddy, JBuddy-CF, JBuddy Message Server are trademarks of Zion Software, LLC. AIM, ICQ and AOL Instant Messenger Service are service marks of America Online, Inc. MSN Messenger is a registered trademark of Microsoft Corporation. Yahoo Messenger is a registered trademark of Yahoo! Inc. All other trademarks are the property of their respective owners.