Post on 23-Feb-2016
description
IBM Rational Services
© 2013 IBM Corporation
Software Configuration Management Using the RTC Eclipse Client
Bruce Besch(Version 1.0)
IBM Rational Services
© 2013 IBM Corporation
Table of Contents
2
Opening RTC the first time The Eclipse Workspace Team Invitation Accepting a Team Invitation Understanding Eclipse Perspectives Configure Instant Messaging RTC Source Control Concepts Refresher Developer Workflow Create an RTC Workspace The RTC Workspace RTC in the Development Perspective Check-In Changes Editing Change Set Comments Deliver Changes Team Advisor Associate an existing Work Item
Associate a new Work Item Accepting an Incoming Change Set Suspending and Resuming a Change set Discarding and Completing a Change Set Reversing a Change Set Conflicts and Merging Compare Editor Completing the Merge Creating a Baseline Viewing History of a File or Folder Comparing versions of Files or Folders Sharing an Eclipse project
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Opening RTC the first time
Introductory Information Links to Join a project
Online Help
Link to Jazz.net
3
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Opening RTC the first time
Links to Tutorials
Information on this release of RTC
4
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Opening RTC the first time
Main Buttons on the Welcome Page
Navigation Buttons on top of page
5
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Opening RTC the first time – Opening the Workbench
To open the workbench either double click the “Welcome tab” or click the “go to workbench” icon
6
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
The Eclipse Workspace
Team Artifacts View
Work Items View
Tip: Click on the “X” to close a view
7
Tip: In RTC “workspace” is an overloaded term. There are two completely different types of workspace: 1. An Eclipse Workspace,
which we are discussing on this page.
2. An RTC Workspace which we discuss later.
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
The Eclipse Workspace - Views
1. Select “Window / Show View” to display the available Eclipse views.
Tip: Click on the “+” to expand each folder
RTC SCM Views
8
Views support editors and provide alternative presentations as well as ways to navigate the information in Eclipse. For example, the Team Artifacts and other navigation views display projects and other resources that you are working with.Views also have their own menus. To open the menu for a view, click the icon at the left end of the view's title bar. Some views also have their own toolbars. The actions represented by buttons on view toolbars only affect the items within that view.
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
The Eclipse Workspace – Online HelpThe “Help View” displays the available Help topics
Use “F2” to display the description of selected views
9
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
The Eclipse Workspace – Online Help
1. Select “Contents” to display all available help topics
10
RTC detailed usage information is available in “Contents”
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Team Invitation
URL for the Web Client
This is the Repository information to copy onto your clipboard ready for setup of the Eclipse client. (instructions on following slides)
11
You will receive a Team Invitation email that looks similar to the example below. It contains the URL for the RTC web client and the repository information for the Eclipse client.
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Accepting a Team Invitation
Option 2. 1. Select “Accept Team Invitation…” in the “File” menu
Option 1. 1. Click on “Accept Team Invitation” in the initial “Team Artifacts” view. Note: The “Team Artifacts” view will only look like this the first time you access it.
12
You can accept a team invitation in the Eclipse client by either:
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Accepting a Team Invitation (continued)The “Accept Team Invitation” window will now be displayed Repository connection information
from the Team invitation Email
2. “Copy” and “Paste” the Repository Connection information from the team invitation Email into this area
Tip: Many windows that pop up have this icon on them. Click this Icon for Help on the window
3. After you have pasted the connection information into the window, click on “Finish”
13
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Accepting a Team Invitation (continued)
4. Enter your password and check the “Save Password” and “Automatically Log in” check boxes. Then press the “OK” button.
The “Repository Connection Certificate Problem” window may be displayed once or a number of times. 6. Select the “Accept this certificate temporarily for the remainder of this session” radio button and press “OK” This is because the RTC server is using self signed certificate and can be safely ignored.
The “Log in Required” window will now be displayed
5. Press “OK”
14
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Accepting a Team Invitation (continued)The Workbench “Work Items” Perspective will now be displayed showing you the new team connection. A Perspective is a collection of views to enable the user to perform tasks in Eclipse. For example, the Work Item Perspective is the main perspective for performing RTC tasks. The Java Perspective is used for Java development.
One or many Repository Connections
Your Team Project Information. Tip, click on the “+” icon to expand the folders
Project Area View. This contains configuration details of your project area.
15
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Understanding Eclipse PerspectivesThe “Open Perspective” windows displays all available perspectives. The number of Perspectives displayed depends on the Eclipse based product you are using. For example, RSA has many more perspectives than this example which is the basic RTC client.
You will find that as you work the Eclipse perspective can become untidy and difficult to find the views you want to use. In this case the “Reset Perspective” function will restore the perspective you are working in to its default layout.
16
Each Eclipse window contains one or more perspectives. A perspective defines the initial set and layout of views in the Eclipse window. Within the window, each perspective shares the same set of editors. Each perspective provides a set of functionality aimed at accomplishing a specific type of task or works with specific types of resources. For example, the Java perspective combines views that you would commonly use while editing Java source files. As you work in Eclipse, you will probably switch perspectives frequently.
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Configure Instant Messaging
You need to ensure that the Instant Messaging client is configured for RTC
1. Open the Eclipse “Preferences” window
3. Press the “Add” button to add your Sametime account details
4. Select “Sametime/Notes 8” as the providerNote: This assumes that RTC is installed on the IBM network
5. Enter your IBM Intranet ID
6. Press “OK”Note the Help
17
2. Select “Instant Messaging” Tab
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Configure Instant Messaging (continued)
7. Press “Connect”
8. Finally press “OK” to save
18
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation19
RTC Source Control Concepts Refresher
Sandbox
Team Stream 1
Team Area 1
Project Area
Team MembersTeam Processes Team Area 2
Jazz Server
Team Stream 2
Workspace Repository
Workspace Repository
Sandbox
Workstation
Deliver Change Sets
Accept Change Sets
Deliver Change Sets
The project area is the top level of project organisation
The project area contains one or many team areas
Team areas have one or many streams of development activity contained in them
Workspaces are the users sandbox used to perform work. They are replicated between the Server (Repository Workspace) and Workstations Sandbox.
Changes are checked into a change set. The change set records the before and after states of each file. Content is stored separately and is delta-compressed
You Check-in changes from the Sandbox to the Repository Workspace. This also places the changes in a change set
You deliver change sets from Repository Workspace to Team Stream
You accept change sets from the team stream into your workspace and hence your Sandbox
Workstation
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Developer Workflow - Overview
Accept Team Invitation
Create Workspace
Accept Changes
Check In Changes
Make Changes
Deliver Changes
Join a Project
Changes are delivered into the team shared ‘stream’
Accepting changes from the shared ‘stream’ into your workspace and Sandbox
Changes are checked-in to your repository workspace and assigned to a ‘change set’
20
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Create an RTC Workspace
2. Select “New” then “Repository Workspace”
3. The “New Repository Workspace” windows will be displayed
4. Select the “Flow with a stream” radio button
5. Select the stream you have been instructed to join
6. Press “Next” to continue to the next step
Click the “help” icon to access on line help for the windows
1. Right click on “Source Control”
21
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Create an RTC Workspace (continued)7. Enter a Unique repository name. It is recommended that you prefix the repository name with your name so the owner is easily identifiable
8. Enter a Description of the repository
9. Press “Next”
12. Select the “Scoped” radio button
13. Select the Project you are joining
14. Press “Next”
22
10. Select the “Use Current Repository” radio button
11. Press “Next”
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Create an RTC Workspace (continued)
15. Select the components in the Stream that you wish to load. There may be one or many components available to select.
17. Ensure the load repository check box is selected so that the repository is loaded
16. Press “Finish” to continue to the next step
18. The “Load Repository Workspace” Window will then be displayed
19. Select “Find and load Eclipse projects” to load existing projects into your workspace
For information on the other load options use the online help
20. Press “Next” to continue to the next step
23
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Create an RTC Workspace (continued)21. Select the Eclipse projects that you wish to load. There may be one or many projects available to select.
Note: From a performance point for view we recommend only loading only the minimum set of Eclipse projects into the workspace.
If possible when working on multiple Eclipse projects create independent workspaces for each project.
22. Press “Finish” to start the loading of the workspace.
The “Loading Repository Items” windows will be displayed as your local repository is loaded.Depending on the size of the workspace you are loading and the speed of the network connection, this may take a while.
Note the Help Icon
24
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
The RTC Workspace – Sample Project
Your available workspaces are now shown in the Team Artifacts view
When a component looks like this it means it is not loaded in a workspace
When a component looks like this it means it is loaded in a workspace
Other RTC functions are available here. They are beyond the scope of this training module
25
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
RTC in the Development PerspectiveIf you change to a development perspective, Java in this example, you will see the Eclipse project you have loaded
Note that this icon on a file or directory means that it is stored in Jazz
If you “right click” on a file or folder in a development perspective you can access RTC functions under the “Team” menu.
26
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Check-In Changes
To Check-In and Deliver changes you need to open the “Pending Changes” view in your development perspective (Java in this example)
1. Right click on any file or directory in your development perspective.Then select “Show Pending Changes” in the Team menu.
2. The “No Changes to Show” window may be displayed. Just press “OK” to continue
3. The Pending Changes view will now be displayed.Tip: Expand the folders in the view by clicking on the “+” icon to drill down to the files or Folders being delivered
27
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Check-In Changes (continued)
1. Right Click on “Unresolved” to check in all change sets
If this is the first time you check-in you will need a new change set
2. Select “Check-in” then “New Change Set”
If you have checked in previous files you can select existing change sets
1. Right click on “Unresolved” to check in all change sets
2. Select an existing change set
You can also check-in individual files
1. Right Click on the file to be checked in
2. Select a new or existing change set
28
Unresolved changes have not been checked into a change set
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Editing Change Set Comments
1. Right click on the Change Set
2. Select “Edit Comment”
29
It is important to give change sets a useful comment so that they can be easily identified.
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Deliver ChangesYou can deliver all changes in the workspace
1. Right click on the workspace to deliver from
2. Select ”Deliver”
You can deliver all changes in a selected component
1. Right click on the component to deliver from
You can deliver individual change sets
1. Right click on the change set to deliver
2. Select ”Deliver”
Tip: Note the keyboard shortcuts
2. Select ”Deliver”
30
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Team AdvisorRational Team Concert has the facility to enforce team process. A commonly enforced team process is that delivered change sets must be associated with a Rational Team Concert work item. If you try and perform a deliver of a change set that is not associated with a work item, then Rational Team Concert will open up the Team Advisor to assist you in resolving the problem.
Suggested solutions for the problem RTC has identified
There are also shortcut buttons on the toolbar of the view
31
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Associate an existing Work ItemIf you select “Associate Existing Work Items” from the “Team Advisor” view
The “Select Work Items” search Windows will be displayed enabling you to search for and assign existing work items
You can also associate a work item to a change set in the “Pending Changes” view
1. Right Click on the Change Set you wish to associate to a work item
2. Select ”Associate Work Item” to open the “Select Work Items” windows
3. When you have finished associating a work item to the change set press the “Try Again” button on the Team Advisor” view
32
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Associate a new Work ItemYou can create a new work item from the “Create Work Items” windows
The “Create Work Item” windows will be displayed
Remember the online help
3. When you have finished associating a work item to the change set press the “Try Again” button on the Team Advisor” view
33
1.Select “Create work item…”
2. Populate the fields as required then select “OK”
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Accepting an Incoming Change SetIncoming change sets are the changes delivered by your team members to the current flow target of your repository workspace. This is usually your team stream. The incoming change sets are displayed in the Incoming folder of the Pending Changes tool window.
1. Open the “Pending Changes” view to see any incoming change sets
Incoming change sets
1. Right click on “Incoming” to accept all incoming change sets
2. Select ”Accept”
1. Right click on a change set to accept individual incoming change sets
2. Select ”Accept”
The incoming change set should now be loaded in your workspace
Accepting all incoming change sets
Accepting individual incoming change sets
34
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Suspending and Resuming a Change SetSuspending a change set enables you to suspend work on the current change set and resume the work later. Typically this could happen when a high priority task is assigned to you such as fixing a urgent defect.Suspending removes the change set from the repository workspace and unloads it from the local work space but preserves it in the stream
1. Right click on the Change Set you wish to Suspend
3. The change set will now appear in your list of suspended change sets
1. To resume a suspended change set, Right Click on the Change Set you wish to resume
2. Select Suspend”
2. Select “Resume”
Suspend Resume
35
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Discarding and Completing a Change SetIf you think that the change set is invalid or could cause problem to the project code, you can discard it. You can discard either a outgoing change set or an accepted change set.
1. Right click on the Change Set you wish to Discard
2. Select ”Discard”
3. The Discarding Change Set Window will be displayed
4. Select ”OK” to discard the change set
After you make all the changes to the change set, you can mark it complete. A change set marked complete is no longer active. You can not add new changes or remove any changes from it.
1. Right click on the Change Set you wish to Complete
2. Select ”Complete”
36
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Reversing a Change SetReversing a change set removes the changes captured in a change set. The reverse operation on a change set creates a patch. When you merge the patch into your workspace, the changes made to the selected change set are removed and a new change set is created. You can now deliver this change set to reverse the changes in the workspace flow target.
1. Right click on the Component containing the change set you wish to reverse
5. Select ”Reverse”
3. The “History” View will be displayed
4. Right click on the change set you wish to reverse
2. Select ”History”
6. The “Patch Added to Pending Changes” window will be displayed. Press “OK”
37
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Reversing a Change Set (continued)
6. Right click the Patch to Merge
7. Select ”Merge into Workspace”
8. Select ”OK” to confirm the merge
Warning: You may get merge errors indicating conflicts that you will need to manually resolve. Please see the next few slides on how to do this
9. Finally you will need to Check-in and deliver the change set the merge has created
Note: You should complete or suspend any open change sets before merging
38
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Conflicts and MergingConflicts arise when two or more team members modify the same file or folder. Conflicts can also arise when you suspend a change set, modify a file it contains, and then resume the change set.
Conflicts
In Rational Team Concert this icon indicates a conflict
In this example you have accepted a change set that has caused a conflict. The conflict is displayed in the “Pending Changes” view
The first step is to open one of the conflicting files:
1. Right click on one of the conflicting files.
2. Select ”Open in Compare Editor”
Tip: You can also use an external compare tool
39
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Compare EditorThe Compare Editor will then open. The compare editor is based on the Eclipse compare editor Editor Navigation Buttons
Incoming Changes Local Workspace
40
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Compare Editor (continued)1. Attempt an Auto-merge
2. If the “Conflicts detected” Window is displayed, you will need to manually resolved all conflicting merges
3. When you have completed the merge click the “Resolve as Merged” button to complete the merge
4. The “ Resolve with Mine” window will be displayed. Click “Resolve with mine” to confirm the merge is complete
41
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Completing the Merge
Completing the merge will result in a merged change set being generated. It is shown in the Pending Changes view. You will need to deliver this change set to complete the merge
42
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Creating a Baseline
1. Right click on the Component in your workspace that you wish to make a baseline on
2. Click on “Baseline”
A baseline records the current configuration of a component in a repository workspace or stream. They enable you to revert to a previous component configuration or compare two configurations
3. Enter a baseline name
4. Press “OK” to create the baseline
The baseline will now appear as a outgoing change in the pending changes view. You will need to deliver this change to the stream
Tip: It is good practice to create baselines frequently so you can easily go back to earlier configurations
Tip: It is important for projects to have good naming standards in place for baselines
43
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Viewing History of a File or Folder
1. Right click on the file or folder that you wish to display the history
2. Select “Team-> Show History” to open the History View
The History view is now displayed for the selected file or folder
44
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Comparing versions of Files or Folders
1. Right click on the version of the file or folder you wish to compare
2. Select “Compare with Previous
The Compare Editor will then be opened displaying the difference between the version of files.Note how having good change set comments makes identifying points in the history of the file or folder much easier!
45
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Sharing an Eclipse ProjectSharing an Eclipse project in an Eclipse based tool is how to save the project in the SCM tool and make it available to other people.
Example: A new unshared java project. Note the different folder Icon compared to the Search project which has been shared
1. Right click on the project that you wish to share
2. Select “Team” then “Share Project”
3. The “Share Project” windows will now be displayed.
4. Select “Jazz Source Control”
5. Press “Next” to continue
Remember the online help
Tip: Always have only one person create a project and share it for others to use
46
Tip: Eclipse Project and RTC Projects are not related
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Sharing an Eclipse Project (continued)You can now select the component you wish to save the project in. You can also create new components or new folders in existing components or folders to save the new project in.
6. Select the component or folder you wish to save the project in.
In this example we are going to save the project in the “HelloGalaxy” folder in the search component. “to add” means it is a new folder we have just created
You can use the “New Component” button to create a new component
You can use the “New Folder” button to create a new folder
Tip: You should never save an Eclipse project directly under the component. You should always create a folder and save the project inside it.This is because you cannot save Eclipse projects inside existing Eclipse projects, so creating the folder prevents problems if you wish to add more projects later.
7. Press “Next” to continue
47
IBM Rational Services
© 2011 IBM Corporation© 2013 IBM Corporation
Sharing an Eclipse Project (continued)You now have the option to exclude particular files from being saved in the repository. For example this could include build artifacts.
8. Press “Finish ” to share the project
9. The “Sharing Projects” window will be displayed as the project is shared
10. When “Sharing Projects” has completed, a “Share project” change set will be created that you need to deliver to complete the sharing of the project
48