Last updated November 07, 2012 23:38, by nvause
[[Home|» Project Kenai Documentation and Training]] [[Howdoi|» How Do I ...]]
<h1>About Instant Messaging (IM) Chat</h1>
A project can have a single single chat room where project members can have discussions using IM. A project administrator can add a chat room to a project and manage it, as described at [[ManageProject#Project_Chat_Room|Managing a Project: Project Chat Room]].
If a project has IM chat set up for it, you see the chat icon [[image:chaticon.gif]] next to the project name in project lists, like the list on your My Page or the list of projects on the Projects page.
You can use NetBeans 6.7 or higher, or any client that supports the Jabber or XMPP protocol, such as [http://pidgin.im/about Pidgin] for Microsoft Windows and Linux or [http://adium.im Adium] and [http://www.apple.com/macosx/what-is-macosx/ichat.html iChat] for Macintosh systems.<br/><br/>
==Using the NetBeans Chat Client==
NetBeans version 6.7 and higher use Project Kenai APIs to enable you to sign into kenai.com and access your projects. You can create new projects, access projects you already belong to, check out code, file bugs, and more. Now that chat rooms are available in Project Kenai, you can also use NetBeans version 6.7 and higher as a chat client for your projects that have chat rooms enabled. You can get NetBeans at [http://www.netbeans.org/].
=====Accessing the Chat Room=====
# Choose Window > Kenai Dashboard.
# Click the Plus button [[image:plusbtn.png]] to expand the project whose chat room you want to see.<br/>If the project has a chat room, you'll see text under the project title saying how many members are online and, in parentheses, some clickable text saying how many messages there are.<br/>[[image:chat-nb-bluebird.png]]
# Click the ''messages'' link to open the chat window.
=====Using NetBeans Chat Controls=====
* The chat window has a text box at the bottom where you enter your text and press Enter to send it. There's an indicator of how many people are in the chat room at the top right. You can rest the cursor on it to see who's online.<br/>[[image:chat-nbwindowmain.png]]
* In the Chat window, you can open other project chat rooms directly. Click the chat folder icon [[image:chat-pickprojecticon.gif]] and choose the project whose chat room you want to open.<br/>[[image:chat-nbwindowwchatrooms.png]]
* There are two icons related to chat rooms in the status line at the bottom right of the NetBeans window, the chat room icon [[image:chaticoninstatusbar.gif]] and, if you have any recent chat messages, the mail icon [[image:chat-mailicon.png]].<br/>[[image:chat-nbstatusbaricons.png]].
** At any time, you can mouse over the chat room icon [[image:chaticoninstatusbar.gif]] in the NetBeans status line to see who is in all your chat rooms. <br/>[[image:chat-nbmouseovrchaticon.png]]
** If you've received any messages, the mail icon [[image:chat-mailicon.png]] appears next to the chat room icon, and when you mouse over it, you can see which project chat room has the most recent new messages. <br/>[[image:chat-nbmouseovrmailicon.png]]
** If you click the mail icon, you get a list of all chat rooms with recent messages. You can click ''read it'' to open a chat room.<br/>[[image:chat-nbclickrmailicon.png]]
==Setting Up Your Own Chat Client==
If you prefer to use your own chat client, you can download the client and install it, and then set it up. If you use Pidgin or Adium, see the instructions in the sections below. If not, set up your client by using the following information:
* '''Protocol:''' xmpp or jabber
* '''Username:''' ''your kenai username''
* '''Password:''' ''your kenai password''
* '''Domain:''' <tt>kenai.com</tt>
* '''Server:''' <tt>muc.kenai.com</tt>
* '''Chat room name:''' ''your project name from the Kenai project URL''<br/>For example, for the Bluebird project the URL would be <tt><nowiki>http://kenai.com/projects/bluebird</nowiki></tt>, so the chat room name is <tt>bluebird</tt>.
===Setting Up a Pidgin Chat Client===
To add the Bluebird chat room, here's what you would do in Pidgin.
=====Set Up an XMPP Account=====
The first time you add a Kenai project chat room, you need to set up an XMPP account for the kenai.com domain, as follows:
# Click Accounts > Manage Accounts.
# Cick the Add button at the bottom of the Accounts window.
# For Login Options, choose XMPP as the protocol and fill out the following fields:
#* '''Username:''' ''Enter your Project Kenai username.''<br/>'''Note:''' We currently have an issue with mixed case in a user name used to connect to the chat room. We are working on a fix right now. Sorry for the inconvenience.<br/>
#* '''Domain:''' <tt>kenai.com</tt>
#* '''Resource:''' <tt>Home</tt>
#* '''Password:''' ''Enter your Project Kenai password.''
# Check the '''Remember Password''' checkbox.
# '''Local alias:''' Enter something you'll recognize, like <tt>Kenai</tt>.
# Click the Advanced tab and check '''Require SSL/TLS'''.
# Click the Basic tab, then click Add to add the new account.
# In the Accounts window, check the Enabled box for the new account, then click Close.
=====Add the Chat Room=====
You would add the Bluebird project's chat room as follows:
# Choose Buddies > Add Chat.
# In the Add Chat window, choose the XMPP Kenai account you set up above.
#* '''Room:''' Enter <tt>bluebird</tt><br/>Get the chat room name from the name for your project in the Kenai project URL. For example, for the Bluebird project the URL would be <tt><nowiki>http://kenai.com/projects/bluebird</nowiki></tt>.
#* '''Server:''' should already say <tt>muc.kenai.com</tt>.
#* '''Handle:''' should already show your Project Kenai username.
#* '''Password:''' Not needed, since you already entered it for your account.
#* '''Alias:''' should be something you'll recognize, like <tt>Bluebird Chatroom</tt>.
#* '''Group:''' is where you want to put the new chat room item in the Pidgin list.
# Click Add to add the new chat room.
# As with any Pidgin chat room, double-click the name to open it. If any members of your project are also logged into the chat room, you'll see them listed, and you can chat right away.
===Setting Up an Adium Chat Client===
To add the Bluebird chat room, here's what you would do in Adium.
===== Set up a Jabber Account =====
The first time you add a Kenai project chat room, you need to set up a Jabber account as follows:
#Click File > Add Account > Jabber.
#Fill out the following info:
#*'''Jabber ID:''' Enter <nowiki>[</nowiki>''your-kenai-username''<nowiki>]</nowiki><tt>@kenai.com</tt><br/>'''Note:''' We currently have an issue with mixed case in a user name used to connect to the chat room. We are working on a fix right now. Sorry for the inconvenience.<br/>
#*'''Password:''' ''Enter your Project Kenai password.''
# Click the Options tab so you can enter the server information, <tt>muc.kenai.com</tt>.
# Click the ''OK'' button.
=====Connect to the Chat Room=====
You would connect to the Bluebird project's chat room as follows:
# Click File > Join Group Chat.
# Select your kenai account from the droplist.
# '''Chat Room Name:''' Enter <tt>bluebird</tt><br/>Get the chat room name from the name for your project in the Kenai project URL. For example, for the Bluebird project the URL would be <tt><nowiki>http://kenai.com/projects/bluebird</nowiki></tt>.
# '''Server:''' Enter <tt>muc.kenai.com</tt>
# Click the Join button.
=====Setting Up Auto Start for the Chat Room=====
# Join the chat room as described above and keep that tab active.
# Click Contact > Add Group Chat Bookmark.
=====Ignore the Adium Verify Certificate Message=====
When you connect to a Project Kenai chat room using Adium, you see a Verify Certificate message window. You can safely ignore this warning and click Continue. It's an issue with OSX, which doesn't have our certificate on its list of root certificates.
Here's how the message window looks: