More Related Content
Similar to Lab1 RTC Overview
Similar to Lab1 RTC Overview (20)
More from IBM Rational software
More from IBM Rational software (11)
Lab1 RTC Overview
- 2. Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2008, 2013 Exercise 1. Overview of Rational Team Concert 1-1
V9.0
EXempty
Exercise 1. Overview of Rational Team Concert
What this exercise is about
The purpose of this exercise is to become familiar with the main capabilities
of IBM® Rational Team Concert™:
• Joining a project team
• Querying for work items
• Interacting with Jazz™ source control to change a Java™ application
What you should be able to do
At the end of this exercise, you should be able to:
• Join the JKE Banking project.
• Review your user profile.
• Query for work items, and select a work item for implementation.
• Create a workspace for your development work, and populate the
workspace with the latest code from the shared stream for the project.
• Make a code change to a file that is stored in Jazz source control to
resolve the selected work item, and associate the change set to the work
item.
• Run the Java program to ensure that your change was successful.
• Check in your changes to Rational Team Concert source control.
Requirements
To complete the lab exercises, you use a VMware image that acts as both a
server and client. This setup gives you a private environment for completing
the lab exercises. Some instructors prefer using a shared server. Ask your
instructor about any custom configurations in the classroom lab environment.
• Use these Windows® logon credentials for the VMware image:
User name: ibmuser Password: passw0rd (the 0 is a zero)
• Enter these Rational Team Concert user account credentials as
instructed:
User IDs: john, deb, rebecca
Passwords: passw0rd (the 0 is a zero)
• Use this Rational Team Concert web client URL:
https://rtc:9443/ccm/web
- 3. Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
1-2 Developing Software with IBM Rational Team Concert, V4.0.4 © Copyright IBM Corp. 2008, 2013
• If you are running the Jazz Team Server locally, you may have to
manually start the server. In Administrative Tools click on Services and
ensure DB2 – DBCOPY1 – DB2-0, IBM WebSphere Application
Server V8.0 – rtcNode01, IBM WebSphere Application Server V8.0 –
IBMRationalReporting are all started in that order.
If you are not using the VMware image for these exercises, discrepancies
might exist between the user IDs, host names, and other information in the
printed material and your lab environment. Your instructor can provide
assistance.
- 4. Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2008, 2013 Exercise 1. Overview of Rational Team Concert 1-3
V9.0
EXempty 1.1. Join a project team in Rational Team Concert
Scenario
In this exercise, you assume the role of John, a new project team member who is ready to join a
project. You start the Rational Team Concert Eclipse client, connect to the Jazz repository, and then
join a project. You review and optionally update your profile information including your photo,
contact information, work hours, and scheduled absences.
__ 1. Ensure that Jazz Team Server is running. For assistance, ask your instructor.
__ 2. Start the Rational Team Concert Eclipse client by clicking the Rational Team Concert icon
on your desktop or the quick launch toolbar.
Help. Alternatively, you can start the product by clicking Start > All Programs >
IBM Rational Team Concert Client >
IBM Rational Team Concert.
__ 3. In the Workspace Launcher window, browse to select C:workspacesJohn; then click OK.
Help. This workspace is your local Eclipse workspace and your local sandbox for Rational
Team Concert source control. If the directory C:workspacesJohn does not exist, create it.
__ 4. Rational Team Concert initially displays a Welcome tab. If you see this tab, close it.
Help. This tab contains an overview of Rational Team Concert, tutorials, first steps, and
other items.
__ 5. If the Work Items perspective is not already open, switch to that perspective by clicking
Window > Open Perspective > Work Items.
__ 6. If you are using the VMware image for the labs, complete these steps:
• Click File > Accept Team Invitation.
• On your Windows desktop, open the RS843 folder.
• Open the invite.txt file. Copy the last five lines from this file.
• Paste the last 4 lines into the Accept Team Invitation window.
• Click Finish.
• When you are prompted, enter your ID, john and password password. Select the check
boxes to save your password and automatically login, and then click OK.
• Click Cancel to Secure Storage dialog. The JKE Banking (Change Management)
project folder is now in the Team Artifacts view.
Help: If you are not using the VMware image for the labs, your instructor will specify how to
connect to Jazz Team Server and join the project area.
- 5. Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
1-4 Developing Software with IBM Rational Team Concert, V4.0.4 © Copyright IBM Corp. 2008, 2013
Important: The first time you connect to Jazz Team Server, you might see messages about
a repository connection certificate problem. For all such messages, select Accept this
certificate permanently.
- 6. Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2008, 2013 Exercise 1. Overview of Rational Team Concert 1-5
V9.0
EXempty 1.2. Configure your user profile
Scenario
You review your user ID information for John, add a photo to your profile, and review your
work schedule.
b
__ 1. Click Window > Show View > Team Organization.
__ 2. Expand JKE Banking (Change Management) > Business Recovery Matters [Main
Development].
Help. If you do not see a list of users, make sure that the Show Users menu item is
selected.
__ 3. In the list, double-click John. The User Profile editor opens.
__ 4. On the Overview tab, explore the configurable items.
• In the Details section, note that you can change your user ID, email address, and
password.
• In the Photo section, you can add a photo to associate with your profile.
Help. Do not change any of these values now. A stock photo is available. To browse to the
photo, click Desktop > RS843 > photo.png.
__ 5. Explore the Work Environment tab.
• In the Work Location section, adjust the Time Zone and Regional Settings to match your
location.
• In the Work Days section, adjust the weekly calendar to reflect your working schedule.
__ 6. Explore the Scheduled Absences tab.
• Practice adding, editing, and removing absences from your schedule.
Help. Use this section to manage your scheduled time away from work, such as holidays,
vacations, and personal time.
__ 7. If you changed the user profile data in this exercise, click Save in the upper-right corner of
the User Profile editor.
- 7. Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
1-6 Developing Software with IBM Rational Team Concert, V4.0.4 © Copyright IBM Corp. 2008, 2013
__ 8. Close the User Profile editor and exit Rational Team Concert.
- 8. Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2008, 2013 Exercise 1. Overview of Rational Team Concert 1-7
V9.0
EXempty 1.3. Review work items in Rational Team Concert
Scenario
In this exercise, you use a work-item query in Rational Team Concert to find work that is
assigned to you. Then, you select a task to start working on. Before you complete this
exercise and the remaining exercises, log on as the user Deb.
__ 1. Start Rational Team Concert.
__ 2. In the Workspace Launcher window, select C:workspacesdeb; then click OK.
Help. This workspace is your local Eclipse workspace and your local sandbox for Rational
Team Concert source control.
__ 3. From the Team Artifacts view, expand JKE Banking (Change Management) [jazz-server]
> Work Items > Shared Queries > Predefined to view predefined queries.
__ 4. In the list of queries, double-click Open assigned to me. A list of work items is displayed.
__ 5. In the Work Items view, double-click Change Username to Customer Name. The Work
Item editor opens. You can review the details of the work item.
__ 6. This work item is currently in the "New" state. Because you are listed as the owner of this
work item, accept ownership, and start working on it:
• Verify that your user ID is listed in the Owned By field.
• From the State list, which is next to the Summary field, select Start Working.
• Click Save.
• Click the arrow that is next to the Task ID, and then click Set as Current Work Item.
Help. The work-item changes from the New state to the In Progress state, and this work
item is set as your current work. The work item number and headline are displayed in the
lower status bar of the Rational Team Concert window. By default, changes that you make
to files under version control are associated with this work item.
- 9. Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
1-8 Developing Software with IBM Rational Team Concert, V4.0.4 © Copyright IBM Corp. 2008, 2013
1.4. Manage software changes by using Jazz source control
Scenario
You identified a work item that you need to resolve. To complete this task, you need to
change a Java source file that is stored in Jazz source control. You load a personal
repository workspace with the latest files from the shared stream for the project. Next, you
make the required change, validate your work, and check in your change.
__ 1. In the Team Artifacts view, expand My Repository Workspaces > Deb BRM Stream
Workspace to view the team stream.
__ 2. Right-click Deb BRM Stream Workspace, and then click Load.
Help. This workspace is your personal repository workspace on the Jazz server.
__ 3. In the Load Repository Workspace window, select Find and load Eclipse projects; then
click Finish.
Help. You have several options to specify which files and folders to load into your
workspaces. For this exercise, you use the default options. Modules 2 and 3 include a more
detailed exploration of workspace management.
__ 4. Switch to the Java perspective.
Help. Click Window > Open Perspective > Java. This perspective shows a different set of
views that are optimized for Java source code development. The most notable view is the
Package Explorer view, which provides a hierarchical navigation tree of the loaded Eclipse
projects.
__ 5. In the Package Explorer view, expand JKEJavaUI > src > com.jke.ui.
__ 6. Double-click JKEBanking.java to open this file in an editor view.
__ 7. In the JKEBanking.java editor view, find this line:
fUsernameLabel.setText("Username:");
Change the line as follows:
fUsernameLabel.setText("Customer Name:");
Help. Click Edit > Find/Replace to search the code for a string. Notice that an asterisk is
displayed next to the file name in the tab, indicating that the file has changed
(*JKEBanking.java).
__ 8. Save your changes to the file by clicking File > Save or clicking the Save icon on the
toolbar. Your changes are saved to your local Eclipse workspace.
- 10. Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2008, 2013 Exercise 1. Overview of Rational Team Concert 1-9
V9.0
EXempty Help. After your changes are saved, the asterisk is not displayed.
__ 9. Test your changes by running the Java program. To run the server component, open
JKEServer:
• Right-click JKE Banking Server.launch, and then click Run As > JKE Banking
Server.
• Return to the JKEJavaUI package.
• Right-click JKE Banking Client (win-64).launch, and then click Run As > JKE
Banking Client (win-64).
Help. Confirm that you see your change in the JKE Banking user interface.
__ 10. When you are satisfied that your program runs correctly, check in your changes:
• Switch to the Work Items perspective.
• In the Pending Changes view, expand Deb BRM Stream Workspace > Java UI.
• Right-click the Unresolved change set, and then click Check-in All.
Help. Click Window > Open Perspective > Work Items. When files are checked in, the
Unresolved change set tag is replaced by an Outgoing folder. The unresolved change set
represents the changes that you made in your local Eclipse workspace that have not been
checked in yet to your personal repository workspace. By clicking Check-in All, you are
checking in your work to your personal repository workspace. Your changes become part of
an outgoing change set that is associated with the current work item.
STOP. Ask your instructor to see whether to proceed to
Exercise 1.5.
- 11. Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
1-10 Developing Software with IBM Rational Team Concert, V4.0.4 © Copyright IBM Corp. 2008, 2013
1.5. Optional: Deliver work to the shared stream for the project
Scenario
Now that your personal work is completed and tested, you are ready to share this change
with the rest of your team. However, while you were making your change to the
JKEBanking.java file in your personal workspace, your teammates were changing the
same file in their personal workspaces. If several of you are working on the same project on
a shared server, conflicts are likely to occur when you try to combine individual changes into
a single version of the file. You must resolve these conflicts before you can deliver your
change set to the shared stream for the project.
__ 1. In the Pending Changes view, expand Deb BRM Stream Workspace > Java UI.
Help. You might see both Incoming and Outgoing folders in the Pending Changes view.
The Outgoing folder represents the changes that you made in your personal repository
workspace that are ready to deliver to the shared project stream. The Incoming folder
represents the changes that your fellow students delivered to the shared project stream. In
this case, you see the Outgoing folder only. You will see the Incoming folder when you
switch to a different users workspace.
__ 2. Expand Outgoing > Change Username to Customer name.
Help. Your change to the JKEBanking.java file is associated with this work item.
__ 3. In the Pending Changes view, right-click the Outgoing folder, and then click Deliver.
Help. An error is displayed because of the incoming change that you have not accepted and
that must be merged into the current work item.
__ 4. In the Pending Changes view, expand the Outgoing folder and subfolders. Right-click the
JKEBanking.java file, and then click Open in Compare Editor.
__ 5. To merge the files, in the Pending Changes view, right-click the Incoming folder, and then
click Accept. The Auto-Resolve window opens. Click Auto-Resolve. When the conflicts are
resolved, the Incoming folder is removed, and the entire change moves to your Outgoing
change set folder.
Help. You can check the merge by right-clicking the JKEBanking.java file in the Merges
change set, and then clicking Open in Compare Editor
__ 6. In the Pending Changes view, right-click the Outgoing folder, and then click Deliver.
- 12. Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2008, 2013 Exercise 1. Overview of Rational Team Concert 1-11
V9.0
EXempty Help. The changes in your personal repository workspace are delivered to the shared
project stream. The Outgoing folder is removed because you no longer have pending
changes to deliver.
__ 7. Mark the work item as resolved:
• Open the work item called “Change Username to Customer Name.” in the Work Item
editor.
• From the work item state list, select Complete; then click Save.
Tip. Double-click the current work item that is displayed at the bottom of the workbench.
End of exercise