Chatting Through IM Gateways in ColdFusion MX 7
Installing Exodus
The other Jabber component you need to install is a Jabber client. I recommend Exodus because it’s free, easy to install, and works extremely well, but any Jabber client will work. To test my Jive Messenger installation, I also installed the Pandion client so that I could register on the server as a different user and talk to myself between the two clients. (Go ahead and have a laugh at my expense by picturing me talking to myself. I don’t mind.) Some Jabber clients allow for multiple log-ons from the same client, which can also work well for testing purposes.
Once you have installed Exodus, you need to log on as each of the users you created to ensure that you created the accounts successfully. In Exodus, you can do this by creating a profile for each account, in which you enter a Jabber ID, password, and point your connection to your local Jive Messenger Server. Use the following steps to set up Exodus.
- Download and install Exodus. Go to the Stable Releases option and select the most recent stable release.
- Start Exodus, which will ask you to define a default account. At this point you’ll configure your personal account; we’ll create another profile for the ColdFusion server in a moment. If Exodus doesn’t prompt you to define a default account, select the Click to Sign On link in the main Exodus window and it will open the login screen.
- Click Profile.
- Click Create new profile or you can just click the Details button on the right to edit the Default Profile. The profile details window opens.
- Click the Account Details tab.
- For the Jabber ID, enter the Jabber ID for the personal account you created above, but to this you’re going to append @127.0.0.1. For example, since I gave my account the name matt above, my Jabber ID is matt@127.0.0.1.
- Enter the password for this account. Make sure to deselect the “This is a new account” option at the bottom of the tab.
- Click the Connection tab. Deselect the “Automatically discover host and port” option. Enter 127.0.0.1 in the Host field. The port should be 5222, but if it is not, enter 5222 for the Port. Click OK.
- After clicking OK you may see a message that reads “Message logging is now performed by plugins. Please enable a logging plugin to regain this functionality.” This message is related to the logging capabilities of Exodus and doesn’t mean you’ve done anything wrong. You can safely ignore this message.
-
Sign into the account to make sure the server accepts your login. Exodus displays "Available" in the bottom left corner and the buddy list will be blank after you sign in. If no error messages appear at this point, you configured the account correctly. If an error message occurs, ensure that your Exodus Username is identical to the first part of the Jabber ID (before the @127.0.0.1).
Figure 2. Exodus Account Details Configuration
The other reason I like Exodus is because you can work with multiple profiles easily. After you create and test your personal profile, you must test the ColdFusion server account as well.
- If you already logged on with the user you just created, log out by selecting Exodus > Sign On/Off or press F9.
-
Select Exodus > Sign On/Off again or select "Click to sign on." A login dialog box appears.Click the Profile link on the left side of the dialog box and a context menu appears. Select Create new Profile.
Figure 3. The Connection tab when editing or creating a new profile
- Give your new profile a name (I got really creative and called mine ColdFusion). Click OK. The Account Details panel appears.
- Repeat steps 6-9 above, but enter information for the ColdFusion user account as follows.
- Enter the ColdFusion server’s Jabber ID that you created in the Jive Messenger administrator, and again append @127.0.0.1 to the end. Since I called my account cfserver, for example, the Jabber ID I would enter in Exodus is cfserver@127.0.0.1.
- Enter the password, for the account. Deselect the "This is a new account" option.
- Click the Connection tab. Deselect the "Automatically discover host and port" option. Enter 127.0.0.1 in the Host field. The Port should be 5222, but if it is not, enter 5222 for the Port. Click OK.
- Log on as the ColdFusion user. The account was created successfully if you log on and then Exodus indicates Available in the bottom left corner of the Exodus console.
Another way to check the status of the two users you created is to log on to the Jive Messenger administrator. Click the User/Groups link in the top menu bar. The users that you created display in a list. The active users display with a green icon next to them (see Figure 5). Later, when the ColdFusion server logs on automatically, you may want to check this screen to see the status of the accounts.
Figure 4. Users/Groups in Jive administrator
Figure 5. You can edit the settings for each user in the User Properties page