JBuddyTM CF README
Welcome to Zion Software's JBuddy-CF Instant Messaging Event Gateway Plugin for ColdFusion. 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 Microsoft Office Communications Server (OCS) 2007, Microsoft Live Communication Server (LCS 2005), and Zion's own Enterprise IM server, JBuddy Message Server.
Installation Notes
*** You should stop ColdFusion before proceeding with this installation ***
- JRE/JVM 1.3+
- Installed ColdFusion with IM Event Gateway Services Enabled
- Internet Firewall with outgoing ports open for underlying IM protocols or a SOCKS 4, SOCKS 5, or HTTP/HTTPS Proxy available
- Screen Name and Password configured for AIM, MSN, Yahoo Messenger, ICQ, Microsoft OCS, Microsoft LCS, 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:\ColdFusion8
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)
- lib\bcprov.jar
- lib\hsqldb.jar
- lib\jain-sip.jar
- lib\nist-sip.jar
- lib\smackx.jar
- lib\jbuddy.lic
- lib\LicenseAgreement.txt
- lib\Jive_License.txt
- lib\BouncyCastle_License.txt
- gateway\lib\JBuddy-CF.jar
Event Gateway Default Properties:
- gateway\lib\AIM.properties
- gateway\lib\ICQ.properties
- gateway\lib\MSN.properties
- gateway\lib\YIM.properties
- gateway\lib\LCS.properties (configuration required)
- gateway\lib\JSC.properties (configuration required)
Event Gateway Config Instances:
You will have one cfg file for each Gateway Instance you create in the ColdFusion 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\lcs.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)
- ** Shutdown ColdFusion **
- 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 direct all JBuddy-CF support questions to jbuddycf-support@zion.com
*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 and Live Communications Server are registered trademarks of Microsoft Corporation. Yahoo Messenger is a registered trademark of Yahoo! Inc. All other trademarks are the property of their respective owners.