Rational Team Concert

Rational Team Concert
Guide for Configuring a New Account in the Jazz Hub
Contents
1. Introduction ............................................................................................................................ 2
2. Create a user account for Jazz................................................................................................. 3
3. Create a New Project .............................................................................................................. 6
4. Manage Access to the Project ................................................................................................. 9
5. Access the Project through web interface ............................................................................ 12
6. Configure an Eclipse Client .................................................................................................... 13
1. Introduction
Jazz is IBM’s initiative for improving collaboration and lifecycle tool integration. In order to
evaluate and explore Rational Team Concert, a hub is provided free of charge for university
students.
This document explains how a project for Rational Team Concert can be created in the Jazz hub.
To support team collaboration across multiple platforms and technologies, Rational Team
Concert provides users with an Eclipse-based client interface, a Microsoft Visual Studio client
interface, and a web interface. This document includes the Eclipse and web interfaces only, for
more information on how to install the Microsoft Visual Studio client interface visit
https://jazz.net/projects/rational-team-concert/features/vsclient.
Every member of the team shall create an account in Jazz.net (see section 2). Only the team
lead needs to create a new project (see section 3) and provide access for the rest of the team (see
section 4). The rest of the team can access the project just by logging in to Jazz.net (see section 5).
To configure the Eclipse client see section 6.
If you have comments or questions regarding this document, Jazz or Rational Team Concert,
please contact [email protected]
2. Create a user account for Jazz
1. Go to https://jazz.net/
2. Click on Register.
3. Complete the required information and click on the “I agree” button. The information in
the image is only an example, please use your own data (if you are a student in FIUPM,
you can use the contact information provided in the example, but use your own user id,
name and e-mail)
4. After viewing the successful registration message, go to your e-mail account.
5. Click on the link provided in the e-mail and set a new password:
3. Create a New Project
1. Go to https://hub.jazz.net/
2. Click on Create a Project.
3. Log in using your Jazz.net user name and password.
4. Select the template for the project. If you are using the hub for a class project, ask your
professor which template you should use.
5. Write a name for the project. The name of your university and the e-mail from your
sponsor (should be provided to you by your professor).
6. Agree with the terms of use and click Create Project.
4. Manage Access to the Project
1. In the Members area, click Add to add the other project members
2. Type the name/last name they used to register in Jazz (not the user ID) and click Add.
3. Click Save. In the new window, select all team members and click OK. All members will
receive invitation e-mails.
5. Access the Project through web interface
The Web client is better suited for casual or occasional users than a client IDE because it does
not require installing any special software on the client machine; all that's needed is a Web
browser. Each Jazz Team Server has a main web page where the user can select a project area and
log in. Once logged in, the user can interact with the Jazz Team Server and browse information in
the Jazz repository, including reading about recent events, entering and updating work items, and
downloading builds.
1. Once the project leader has added you to the project, follow steps 1-2 from section 3
2. Click on the name of your project.
6. Configure an Eclipse Client
Rational Team Concert has built-in support for Eclipse providing developers with a rich,
integrated development environment for building and delivering software artifacts. The Eclipsebased client user interface contributes UI elements to the Eclipse workbench, including views,
editors and status line trims.
1. In the https://jazz.net web site, go to Downloads and click Rational Team Concert
2. Click the version used in the Sandbox where you created your project
3. Download the Web Installer
4. Run the Web Installer and click Rational Team Concert – Client for Eclipse IDE
5. Make sure the version is the same as the one in your Sandbox and click Next
6. Accept license agreements and click Next
7. Choose a location for the installation if you wish and click Next
8. If you do not have Eclipse installed in your computer yet, click Next and Eclipse will be
installed together with the client. If you have Eclipse installed, check Extend an existing
Eclipse, select the location of the Eclipse installation in the Browse button and click
Next.
9. Select the translations to install and click Next
10. In the next windows, keep the default configuration
11. When the Summary window is reached, click Install. The files will be downloaded and
then installed so it is normal if it takes some time depending on your connexion speed.
12. Once the packages are installed, open Eclipse.
13. Go to Window> Open Perspective>Other
14. Select Work Items and click OK
15. To connect to the Sandbox:
a. If you created the project:
i. In the Work Items tab, click Connect to Project Area
ii. Select Create a New Repository Connection and click Next
iii. In the e-mail you received when you created your project, there is a
“For CCM” section. Copy the “teamRepository” address to the URI field,
select Username and Password as Authentication Type and click Next.
iv. A master password will be created, specify two security questions and
answers to recover it.
v. Type your Jazz.net user ID and password, click OK
vi. Select the name of your Project and click Finish
b. If you did not create the project and already received a Welcome e-mail.
i. In Eclipse, go to File and click Accept Team Invitation
ii. Copy the text of the e-mail you received and click Finish.