IBM Software Exercise
Developing Software with 
IBM Rational Team Concert
Exercise 1: Overview of Rational Team Concert
Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
...
Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
...
Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
...
Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
...
Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
...
Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
...
Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
...
Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
...
Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
...
Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
...
Student Exercises
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
...
Upcoming SlideShare
Loading in...5
×

Lab1 RTC Overview

706

Published on

Published in: Software, Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
706
On Slideshare
0
From Embeds
0
Number of Embeds
2
Actions
Shares
0
Downloads
55
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Transcript of "Lab1 RTC Overview"

  1. 1. IBM Software Exercise Developing Software with  IBM Rational Team Concert Exercise 1: Overview of Rational Team Concert
  2. 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. 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. 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. 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. 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. 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. 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. 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. 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. 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. 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

×