Skip to main content
This revision made November 07, 2012 23:38, by nvause
« earlier revision revert to this « later revision

» Project Kenai Documentation and Training    » How Do I ...

About Instant Messaging (IM) Chat

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 Managing a Project: Project Chat Room.

If a project has IM chat set up for it, you see the chat icon 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 Pidgin for Microsoft Windows and Linux or Adium and iChat for Macintosh systems.

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
  1. Choose Window > Kenai Dashboard.
  2. Click the Plus button to expand the project whose chat room you want to see.
    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.
  3. 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.
  • In the Chat window, you can open other project chat rooms directly. Click the chat folder icon and choose the project whose chat room you want to open.
  • There are two icons related to chat rooms in the status line at the bottom right of the NetBeans window, the chat room icon and, if you have any recent chat messages, the mail icon .
    .
    • At any time, you can mouse over the chat room icon in the NetBeans status line to see who is in all your chat rooms.
    • If you've received any messages, the mail icon 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.
    • 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.

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: kenai.com
  • Server: muc.kenai.com
  • Chat room name: your project name from the Kenai project URL
    For example, for the Bluebird project the URL would be http://kenai.com/projects/bluebird, so the chat room name is bluebird.

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:

  1. Click Accounts > Manage Accounts.
  2. Cick the Add button at the bottom of the Accounts window.
  3. For Login Options, choose XMPP as the protocol and fill out the following fields:
    • Username: Enter your Project Kenai username.
      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.
    • Domain: kenai.com
    • Resource: Home
    • Password: Enter your Project Kenai password.
  4. Check the Remember Password checkbox.
  5. Local alias: Enter something you'll recognize, like Kenai.
  6. Click the Advanced tab and check Require SSL/TLS.
  7. Click the Basic tab, then click Add to add the new account.
  8. 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:

  1. Choose Buddies > Add Chat.
  2. In the Add Chat window, choose the XMPP Kenai account you set up above.
    • Room: Enter bluebird
      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 http://kenai.com/projects/bluebird.
    • Server: should already say muc.kenai.com.
    • 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 Bluebird Chatroom.
    • Group: is where you want to put the new chat room item in the Pidgin list.
  3. Click Add to add the new chat room.
  4. 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:

  1. Click File > Add Account > Jabber.
  2. Fill out the following info:
    • Jabber ID: Enter [your-kenai-username]@kenai.com
      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.
    • Password: Enter your Project Kenai password.
  3. Click the Options tab so you can enter the server information, muc.kenai.com.
  4. Click the OK button.
Connect to the Chat Room

You would connect to the Bluebird project's chat room as follows:

  1. Click File > Join Group Chat.
  2. Select your kenai account from the droplist.
  3. Chat Room Name: Enter bluebird
    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 http://kenai.com/projects/bluebird.
  4. Server: Enter muc.kenai.com
  5. Click the Join button.
Setting Up Auto Start for the Chat Room
  1. Join the chat room as described above and keep that tab active.
  2. 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:

Difference compared to previous revision
<span>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.<span style="text-decoration:line-through;color:red"> If you click the chat icon, the Kenai chat client opens.</span> [[image:chat-projectlisting.png]] <span style="text-decoration:line-through;color:red">In additi</span>[[Home|&raquo; Project Kenai Documentation and Training]] &nbsp;&nbsp; [[Howdoi|&raquo; 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. [[image:chat-projectlisting.png]]<span style="text-decoration:underline;color:green">Y</span>o<span style="text-decoration:line-through;color:red">n to the Project Kenai chat client, yo</span>ou can use NetBeans 6.7<span style="text-decoration:underline;color:green"> or higher</span>u 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 <span style="text-decoration:line-through;color:red">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 </span>NetBeans Chat Client== NetBeans version 6.7 and higher use Project Kenai APIs to enable you to sign into <span style="text-decoration:line-through;color:red">j</span>, 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 NetBeans Chat Client== NetBeans version 6.7 and higher use Project Kenai APIs to enable you to sign into <span style="text-decoration:underline;color:green">ken</span>a<span style="text-decoration:line-through;color:red">va</span><span style="text-decoration:underline;color:green">i</span>.<span style="text-decoration:line-through;color:red">net</span><span style="text-decoration:underline;color:green">com</span> 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. ... * '''Protocol:''' xmpp or jabber * '''Username:''' ''your kenai username'' * '''Password:''' ''your kenai password'' * '''Domain:''' <tt><span style="text-decoration:line-through;color:red">j</span><span style="text-decoration:underline;color:green">ken</span>a<span style="text-decoration:line-through;color:red">va</span><span style="text-decoration:underline;color:green">i</span>.<span style="text-decoration:line-through;color:red">net</span><span style="text-decoration:underline;color:green">com</span></tt> * '''Server:''' <tt>muc.<span style="text-decoration:line-through;color:red">j</span><span style="text-decoration:underline;color:green">ken</span>a<span style="text-decoration:line-through;color:red">va</span><span style="text-decoration:underline;color:green">i</span>.<span style="text-decoration:line-through;color:red">net</span><span style="text-decoration:underline;color:green">com</span></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://<span style="text-decoration:line-through;color:red">j</span><span style="text-decoration:underline;color:green">ken</span>a<span style="text-decoration:line-through;color:red">va</span><span style="text-decoration:underline;color:green">i</span>.<span style="text-decoration:line-through;color:red">net</span><span style="text-decoration:underline;color:green">com</span>/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. ... 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 <span style="text-decoration:line-through;color:red">j</span><span style="text-decoration:underline;color:green">ken</span>a<span style="text-decoration:line-through;color:red">va</span><span style="text-decoration:underline;color:green">i</span>.<span style="text-decoration:line-through;color:red">net</span><span style="text-decoration:underline;color:green">com</span> 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><span style="text-decoration:line-through;color:red">j</span><span style="text-decoration:underline;color:green">ken</span>a<span style="text-decoration:line-through;color:red">va</span><span style="text-decoration:underline;color:green">i</span>.<span style="text-decoration:line-through;color:red">net</span><span style="text-decoration:underline;color:green">com</span></tt> #* '''Resource:''' <tt>Home</tt> #* '''Password:''' ''Enter your Project Kenai password.'' # Check the '''Remember Password''' checkbox. ... 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://<span style="text-decoration:line-through;color:red">j</span><span style="text-decoration:underline;color:green">ken</span>a<span style="text-decoration:line-through;color:red">va</span><span style="text-decoration:underline;color:green">i</span>.<span style="text-decoration:line-through;color:red">net</span><span style="text-decoration:underline;color:green">com</span>/projects/bluebird</nowiki></tt>. #* '''Server:''' should already say <tt>muc.<span style="text-decoration:line-through;color:red">j</span><span style="text-decoration:underline;color:green">ken</span>a<span style="text-decoration:line-through;color:red">va</span><span style="text-decoration:underline;color:green">i</span>.<span style="text-decoration:line-through;color:red">net</span><span style="text-decoration:underline;color:green">com</span></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>. ... 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>@<span style="text-decoration:line-through;color:red">j</span><span style="text-decoration:underline;color:green">ken</span>a<span style="text-decoration:line-through;color:red">va</span><span style="text-decoration:underline;color:green">i</span>.<span style="text-decoration:line-through;color:red">net</span><span style="text-decoration:underline;color:green">com</span></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.<span style="text-decoration:line-through;color:red">j</span><span style="text-decoration:underline;color:green">ken</span>a<span style="text-decoration:line-through;color:red">va</span><span style="text-decoration:underline;color:green">i</span>.<span style="text-decoration:line-through;color:red">net</span><span style="text-decoration:underline;color:green">com</span></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://<span style="text-decoration:line-through;color:red">j</span><span style="text-decoration:underline;color:green">ken</span>a<span style="text-decoration:line-through;color:red">va</span><span style="text-decoration:underline;color:green">i</span>.<span style="text-decoration:line-through;color:red">net</span><span style="text-decoration:underline;color:green">com</span>/projects/bluebird</nowiki></tt>. # '''Server:''' Enter <tt>muc.<span style="text-decoration:line-through;color:red">j</span><span style="text-decoration:underline;color:green">ken</span>a<span style="text-decoration:line-through;color:red">va</span><span style="text-decoration:underline;color:green">i</span>.<span style="text-decoration:line-through;color:red">net</span><span style="text-decoration:underline;color:green">com</span></tt> # Click the Join button. =====Setting Up Auto Start for the Chat Room=====<span>
 
 
Close
loading
Please Confirm
Close