(27 Jul 2008) Following are notes for installing and configuring Openfire's IM Gateway plugin.
Installation of the IM Gateway plugin
1) Log into the Openfire Management Console by pointing a browswer at http://localhost:9090 (or whatever the IP address of your server is)
2) Click on the "Plugins" tab, and then click on the link for "Available Plugins", just above the list of installed plugins.
Attach:openfireimgw1.jpg Δ
3) Scroll down...
Attach:openfireimgw2.jpg Δ
4) ... until you see "IM Gateway". Click on the round green button on the right. The round green button will turn into a spinner and the entry for "IM Gateway" will disappear once it's installed.
Attach:openfireimgw3.jpg Δ
5) Click on the server tab and notice that there's now a "Gateways" tab on the second row of tabs. Click on "Gateways". From here, you can configure the individual services.
Attach:openfireimgw4.jpg Δ
Adding IRC access
1) Click on the checkbox to the left of the IRC entry.
Attach:openfireimgw5.jpg Δ
2) Then click on "Options" and fill in the IRC server information. Clicking on "Allow MUC room list" will allow the Spark user to list the public rooms on the IRC server. <font color=red><b>WARNING!</b></font> Enabling this on freenode.net is not recommended as the list will be quite large.
Attach:openfireimgw6.jpg Δ
3) Click "Save options". Then click on "Tests" and "Test Connection".
Attach:openfireimgw7.jpg Δ
4) If you plan on allowing users on this server who you don't want to access this service, you can specify who can use this service by clicking on "Permissions".
Attach:openfireimgw8.jpg Δ
5) Next click on "Registrations" in the left-hand menu. Then click on "Add a new registration."
Attach:openfireimgw9.jpg Δ
6) Fill in the required information. The JID is the Openfire username. "Username" and "password" the login info for the IRC server and "nickname" is the nick to use on the server. Click on "Add" so save the registration.
Attach:openfireimgw10.jpg Δ
7) When you log into Spark (you'll need to install this too), you'll see the IRC gateway has been added to the tool bar. You can then add contacts by clicking on the little logo on the left in the toolbar, filling in the information. If the "IRC" is grayed out (as in the following picture), then Sparks hasn't yet successfully connected to the IRC server.
Attach:openfireimgw12.jpg Δ
This is what it looks like when it has successfully connected. You'll get a few pop-up windows to go with it also.
Attach:openfireimgw13.jpg Δ
8) To add a contact, click on the left-most icon in the tool bar (the little guy with a green "+" on his shoulder). Then fill out the form. If you're watching for someone in IRC, be sure to click the appropriate box. (Note: Sparks has nothing to do with the program Spark. That's just a coincidence.)
Attach:openfireimgw14.jpg Δ
Here's what it looks like when you have a contact added and he/she is online. You can now send messages to him/her without having to track them down in whatever IRC channel they happen to be in.
Attach:openfireimgw15.jpg Δ
9) You can join the conversation in IRC channels by clicking on the "Conferences", at the bottom of the Spark window, right-clicking on "conference.irc.whatever" and clicking on "Browse Service"
Attach:openfireimgw16.jpg Δ
This will give you a list of the publicly available channels.
Attach:openfireimgw17.jpg Δ
Click on one of the channels and then click on "Join Selected Room". Viola!
Attach:openfireimgw18.jpg Δ
