Rational Team Concert

Guide for Configuring a New Account in the Jazz Sandbox

Contents

1. Introduction ............................................................................................................................ 2

2. Create a user account for Jazz ................................................................................................. 3

3. Create a New Project .............................................................................................................. 6

4. Manage Access to the Project ................................................................................................. 8

5. Access the Project through web interface ............................................................................ 11

6. Configure an Eclipse Client .................................................................................................... 12

1. Introduction Jazz is IBM’s initiative for improving collaboration and lifecycle tool integration. In order to

evaluate and explore some IBM’s product, a sandbox is provided free of charge for any user, including the following software:

Rational Team Concert (Change and Configuration Management)

Rational Quality Manager (Quality Management)

Rational Requirements Composer (Requirements Management) This document explains how a project for Rational Team Concert can be created in the Jazz

sandbox, which uses the Scrum template. 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 catedra.ibm.fiupm@gmail.com

2. Create a user account for Jazz

1. Go to https://jazz.net/

2. Click on “Register Now!”

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://jazz.net/development/sandbox/

2. Choose the Sandbox which best fits your needs considering the version of the software it runs and its expiration date. If you are working on a class exercise normally your professor will let you know which Sandbox will be used.

3. Choose a name for your project and the tools you want to use, options are:

Rational Team Concert

Rational Quality Manager

Rational Requirements Composer

4. After a few minutes, a “Success” message will appear and you will receive an e-mail containing direct links for your 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 Eclipse-based 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.