JBuddyTM XMPP Gateway README
Welcome to Zion Software's JBuddy XMPP Gateway product. JBuddy XMPP Gateway adds public IM (AIM, ICQ, MSN, Yahoo) and Enterprise IM (Lotus Sametime and Microsoft LCS/OCS) connectivity to XEP-0114 compatible XMPP and Jabber servers.
FREE License Limits
JBuddy XMPP Gateway comes with a FREE limited-use license. This FREE license intentionally limits the
functionality of the product and is intended for small workgroups or pilot evaluation only.
For the purposes of this product and license, a chat session is defined as an IM conversation between
two IM clients with less than 15 minutes of inactivity during the exchange of messages between them.
The following limits are built into the FREE limited-use license:
- Up to 15 concurrently connected public IM clients
- Up to to 20 concurrent chats across all connected public IM clients
- Up to 4 concurrent chats for a single connected public IM client
Installation Notes
- Java JRE/JVM 1.5+
- XMPP Server supporting XEP 0114
- XMPP Client supporting XEP 0100 (for example Psi)
- Internet Firewall with outgoing ports open for underlying IM protocols or a SOCKS 4, SOCKS 5, or HTTP/HTTPS Proxy available
- DNS SRV records to support the XMPP Gateways (see below)
; --------------------------------------------------------------------------
; used for xmpp gateways (xmpp transports)
; --------------------------------------------------------------------------
_xmpp-server._tcp.aim.your.com. 86400 IN SRV 0 5 5269 xmppserver.your.com.
_xmpp-server._tcp.icq.your.com. 86400 IN SRV 0 5 5269 xmppserver.your.com.
_xmpp-server._tcp.msn.your.com. 86400 IN SRV 0 5 5269 xmppserver.your.com.
_xmpp-server._tcp.yahoo.your.com. 86400 IN SRV 0 5 5269 xmppserver.your.com.
_xmpp-server._tcp.sametime.your.com. 86400 IN SRV 0 5 5269 xmppserver.your.com.
_xmpp-server._tcp.lcs.your.com. 86400 IN SRV 0 5 5269 xmppserver.your.com.
; ==========================================================================
xmppserver.your.com is the fully qualified domain name of your xmpp server.
your.com is your domain for your xmpp server.
Using the above DNS SRV records, your XMPP server would advertise your xmpp gateways as aim.your.com, icq.your.com, msn.your.com, yahoo.your.com, sametime.your.com, and lcs.your.com.
JBuddy XMPP Gateways can be installed on any Java 1.5+ enbaled server that can connect directly to the internet or through a SOCKS 4 or 5 proxy or HTTP/S proxy. Additionaly the server which hosts the JBuddy XMPP Gateways must be able to connect to the XEP 0114 enabled XMPP server on the specified gateway port
NOTE Uninstalling Steps below.
JBuddy XMPP Gateway installs the following files:
Core classes and property files:
- lib\AIM.properties
- lib\ICQ.properties
- lib\MSN.properties
- lib\YIM.properties
- lib\SAMETIME.properties
- lib\LCS.properties
- lib\JBUDDY.properties
- lib\XMPPGateway.jar
- lib\jso.jar
- lib\STComm.jar
- lib\nist-sip.jar
- lib\jain-sip.jar
- lib\bcprov.jar
- lib\wrapper.jar
- lib\license.lic
- lib\jso-licenses\*
- lib\LicenseAgreement.txt
- lib\resources\*
XMPP Gateway Config files:
- conf\config.properties (main config file)
- conf\config-aim.properties
- conf\config-icq.properties
- conf\config-msn.properties
- conf\config-yahoo.properties
- conf\config-lcs.properties - must be edited to point to your LCS/OCS server
- conf\config-sametime.properties - must be edited to point to your Lotus Sametime Server
JBuddy XMPP Gateway Documentation:
Javadocs XMPP Gateway API:
Executables:
- bin\ (platform specific start/stop scripts)
- Uninstaller\uninstall.jar (uninstaller executable)
On Windows, be sure to stop the XMPPGateway service, then proceed with instructions.
On *nix environments, stop the XMPP Gateway process using the start/stop script and then proceed with instructions.
Double click the executable uninstall.jar or from a command shell, type java -jar Uninstaller\uninstall.jar
Please direct all JBuddy XMPP Gateway support questions to jbuddy-support@zion.com
JBuddy is a trademark 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.