2009-05-13T02:14:40Z
Fixed refs to NetBeans 6.7 beta
1635
IMChat
42
7
[[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]].
<span id="chatroomicon"></span>
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. If you click the chat icon, the Kenai chat client opens.
[[image:chat-projectlisting.png]]
In addition to the Project Kenai chat client, you can use NetBeans 6.7, 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/>
__TOC__
==Using the Project Kenai Chat Client==
# To open the Project Kenai chat client, go to the project list in My Page and click either Launch Chat at the top left or the chat client icon [[image:chaticon.gif]] for one of your projects.<br/><br/>[[image:chat-openchatclient.png]]
#When the chat client opens, enter your Project Kenai password and click Connect..<br/><br/>[[image:chat-kenaiclient.png]]
#You see the Password field change to a droplist showing all your project chatrooms.<br/><br/>[[image:chat-kenaiclient-chatlist.png]]<br/>
# Click the droplist and choose a chat room. You can open more than one at a time. Each chat room opens in its own tab.<br/><br/>[[image:chat-kenaiclient-multi-chatwin.png]]
# Click the tab for the room you want to see.
# Enter text in the box below the chat room messages.<br/>[[image:chat-kenaiclient-entermessage.png]]
==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:
[[image:adiumcertmsg.jpg]]
<p><a href='<?url_for_page Home?>' class='internal'>» Project Kenai Documentation and Training</a> <a href='<?url_for_page Howdoi?>' class='internal'>» How Do I ...</a>
</p><p><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 <a href='<?url_for_page ManageProject?>#Project_Chat_Room' class='internal'>Managing a Project: Project Chat Room</a>.
</p><p><span id="chatroomicon" />
If a project has IM chat set up for it, you see the chat icon <?link_for_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. If you click the chat icon, the Kenai chat client opens.
</p><p><?link_for_image chat-projectlisting.png?>
</p><p>In addition to the Project Kenai chat client, you can use NetBeans 6.7, or any client that supports the Jabber or XMPP protocol, such as <a class='external' href="http://pidgin.im/about">Pidgin</a> for Microsoft Windows and Linux or <a class='external' href="http://adium.im">Adium</a> and <a class='external' href="http://www.apple.com/macosx/what-is-macosx/ichat.html">iChat</a> for Macintosh systems.<br /><br />
</p><div id='toc' class='toc'>
<div id='toctitle' class='toc-title'>
<span>Contents</span>
</div>
<div id='toccontents' class='toc-contents'><ul><ul><li>1 <a href='#Using_the_Project_Kenai_Chat_Client'>Using the Project Kenai Chat Client</a></li>
<li>2 <a href='#Using_the_NetBeans_Chat_Client'>Using the NetBeans Chat Client</a></li>
<ul><ul><ul><li>2.1 <a href='#Accessing_the_Chat_Room'>Accessing the Chat Room</a></li>
<li>2.2 <a href='#Using_NetBeans_Chat_Controls'>Using NetBeans Chat Controls</a></li>
</ul></ul></ul><li>3 <a href='#Setting_Up_Your_Own_Chat_Client'>Setting Up Your Own Chat Client</a></li>
<ul><li>3.1 <a href='#Setting_Up_a_Pidgin_Chat_Client'>Setting Up a Pidgin Chat Client</a></li>
<ul><ul><li>3.1.1 <a href='#Set_Up_an_XMPP_Account'>Set Up an XMPP Account</a></li>
<li>3.1.2 <a href='#Add_the_Chat_Room'>Add the Chat Room</a></li>
</ul></ul><li>3.2 <a href='#Setting_Up_an_Adium_Chat_Client'>Setting Up an Adium Chat Client</a></li>
<ul><ul><li>3.2.1 <a href='#Set_up_a_Jabber_Account'> Set up a Jabber Account </a></li>
<li>3.2.2 <a href='#Connect_to_the_Chat_Room'>Connect to the Chat Room</a></li>
<li>3.2.3 <a href='#Setting_Up_Auto_Start_for_the_Chat_Room'>Setting Up Auto Start for the Chat Room</a></li>
<li>3.2.4 <a href='#Ignore_the_Adium_Verify_Certificate_Message'>Ignore the Adium Verify Certificate Message</a></li>
</ul></ul></ul></ul></ul></div>
</div><h2><a name='Using_the_Project_Kenai_Chat_Client'></a>Using the Project Kenai Chat Client</h2>
<ol><li> To open the Project Kenai chat client, go to the project list in My Page and click either Launch Chat at the top left or the chat client icon <?link_for_image chaticon.gif?> for one of your projects.<br /><br /><?link_for_image chat-openchatclient.png?></li><li>When the chat client opens, enter your Project Kenai password and click Connect..<br /><br /><?link_for_image chat-kenaiclient.png?></li><li>You see the Password field change to a droplist showing all your project chatrooms.<br /><br /><?link_for_image chat-kenaiclient-chatlist.png?><br /></li><li> Click the droplist and choose a chat room. You can open more than one at a time. Each chat room opens in its own tab.<br /><br /><?link_for_image chat-kenaiclient-multi-chatwin.png?></li><li> Click the tab for the room you want to see.
</li><li> Enter text in the box below the chat room messages.<br /><?link_for_image chat-kenaiclient-entermessage.png?></li></ol><h2><a name='Using_the_NetBeans_Chat_Client'></a>Using the NetBeans Chat Client</h2>
<p>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 <a class='external' href="http://www.netbeans.org/">http://www.netbeans.org/</a>.
</p><h5><a name='Accessing_the_Chat_Room'></a>Accessing the Chat Room</h5>
<ol><li> Choose Window > Kenai Dashboard.
</li><li> Click the Plus button <?link_for_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 /><?link_for_image chat-nb-bluebird.png?></li><li> Click the <i>messages</i> link to open the chat window.
</li></ol><h5><a name='Using_NetBeans_Chat_Controls'></a>Using NetBeans Chat Controls</h5>
<ul><li> 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 /><?link_for_image chat-nbwindowmain.png?></li><li> In the Chat window, you can open other project chat rooms directly. Click the chat folder icon <?link_for_image chat-pickprojecticon.gif?> and choose the project whose chat room you want to open.<br /><?link_for_image chat-nbwindowwchatrooms.png?></li><li> There are two icons related to chat rooms in the status line at the bottom right of the NetBeans window, the chat room icon <?link_for_image chaticoninstatusbar.gif?> and, if you have any recent chat messages, the mail icon <?link_for_image chat-mailicon.png?>.<br /><?link_for_image chat-nbstatusbaricons.png?>.
<ul><li> At any time, you can mouse over the chat room icon <?link_for_image chaticoninstatusbar.gif?> in the NetBeans status line to see who is in all your chat rooms. <br /><?link_for_image chat-nbmouseovrchaticon.png?></li><li> If you've received any messages, the mail icon <?link_for_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 /><?link_for_image chat-nbmouseovrmailicon.png?></li><li> If you click the mail icon, you get a list of all chat rooms with recent messages. You can click <i>read it</i> to open a chat room.<br /><?link_for_image chat-nbclickrmailicon.png?></li></ul></li></ul><h2><a name='Setting_Up_Your_Own_Chat_Client'></a>Setting Up Your Own Chat Client</h2>
<p>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:
</p><ul><li> <b>Protocol:</b> xmpp or jabber
</li><li> <b>Username:</b> <i>your kenai username</i></li><li> <b>Password:</b> <i>your kenai password</i></li><li> <b>Domain:</b> <tt>kenai.com</tt></li><li> <b>Server:</b> <tt>muc.kenai.com</tt></li><li> <b>Chat room name:</b> <i>your project name from the Kenai project URL</i><br />For example, for the Bluebird project the URL would be <tt>http://kenai.com/projects/bluebird</tt>, so the chat room name is <tt>bluebird</tt>.
</li></ul><h3><a name='Setting_Up_a_Pidgin_Chat_Client'></a>Setting Up a Pidgin Chat Client</h3>
<p>To add the Bluebird chat room, here's what you would do in Pidgin.
</p><h5><a name='Set_Up_an_XMPP_Account'></a>Set Up an XMPP Account</h5>
<p>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:
</p><ol><li> Click Accounts > Manage Accounts.
</li><li> Cick the Add button at the bottom of the Accounts window.
</li><li> For Login Options, choose XMPP as the protocol and fill out the following fields:
<ul><li> <b>Username:</b> <i>Enter your Project Kenai username.</i><br /><b>Note:</b> 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 /></li><li> <b>Domain:</b> <tt>kenai.com</tt></li><li> <b>Resource:</b> <tt>Home</tt></li><li> <b>Password:</b> <i>Enter your Project Kenai password.</i></li></ul></li><li> Check the <b>Remember Password</b> checkbox.
</li><li> <b>Local alias:</b> Enter something you'll recognize, like <tt>Kenai</tt>.
</li><li> Click the Advanced tab and check <b>Require SSL/TLS</b>.
</li><li> Click the Basic tab, then click Add to add the new account.
</li><li> In the Accounts window, check the Enabled box for the new account, then click Close.
</li></ol><h5><a name='Add_the_Chat_Room'></a>Add the Chat Room</h5>
<p>You would add the Bluebird project's chat room as follows:
</p><ol><li> Choose Buddies > Add Chat.
</li><li> In the Add Chat window, choose the XMPP Kenai account you set up above.
<ul><li> <b>Room:</b> 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>http://kenai.com/projects/bluebird</tt>.
</li><li> <b>Server:</b> should already say <tt>muc.kenai.com</tt>.
</li><li> <b>Handle:</b> should already show your Project Kenai username.
</li><li> <b>Password:</b> Not needed, since you already entered it for your account.
</li><li> <b>Alias:</b> should be something you'll recognize, like <tt>Bluebird Chatroom</tt>.
</li><li> <b>Group:</b> is where you want to put the new chat room item in the Pidgin list.
</li></ul></li><li> Click Add to add the new chat room.
</li><li> 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.
</li></ol><h3><a name='Setting_Up_an_Adium_Chat_Client'></a>Setting Up an Adium Chat Client</h3>
<p>To add the Bluebird chat room, here's what you would do in Adium.
</p><h5><a name='Set_up_a_Jabber_Account'></a> Set up a Jabber Account </h5>
<p>The first time you add a Kenai project chat room, you need to set up a Jabber account as follows:
</p><ol><li>Click File > Add Account > Jabber.
</li><li>Fill out the following info:
<ul><li><b>Jabber ID:</b> Enter [<i>your-kenai-username</i>]<tt>@kenai.com</tt><br /><b>Note:</b> 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 /></li><li><b>Password:</b> <i>Enter your Project Kenai password.</i></li></ul></li><li> Click the Options tab so you can enter the server information, <tt>muc.kenai.com</tt>.
</li><li> Click the <i>OK</i> button.
</li></ol><h5><a name='Connect_to_the_Chat_Room'></a>Connect to the Chat Room</h5>
<p>You would connect to the Bluebird project's chat room as follows:
</p><ol><li> Click File > Join Group Chat.
</li><li> Select your kenai account from the droplist.
</li><li> <b>Chat Room Name:</b> 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>http://kenai.com/projects/bluebird</tt>.
</li><li> <b>Server:</b> Enter <tt>muc.kenai.com</tt>
</li><li> Click the Join button.
</li></ol><h5><a name='Setting_Up_Auto_Start_for_the_Chat_Room'></a>Setting Up Auto Start for the Chat Room</h5>
<ol><li> Join the chat room as described above and keep that tab active.
</li><li> Click Contact > Add Group Chat Bookmark.
</li></ol><h5><a name='Ignore_the_Adium_Verify_Certificate_Message'></a>Ignore the Adium Verify Certificate Message</h5>
<p>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.
</p><p>Here's how the message window looks:
</p><p><?link_for_image adiumcertmsg.jpg?>
</p>
2009-09-23T20:02:19Z
34