Lab 9: Global Configurations

Lab 9: Global Configurations Objectives After completing this lab, you will be able to: Connect to an AM Stream that is under Global Configuration Management (the UK variant) Create a new US variant based on the original UK variant using the Global Configuration Manager Make some changes to the US variant and then push those changes back to the UK variant Scenario The server has already been setup with a UK stream which includes Requirements, Models and Tests. You will first create a new repository workspace for Dan to work in that stream. You will see how Rhapsody selects a Global Configuration context in which to create / display links. You will then use the Global Configuration tool to create a new US variant of the project first creating a baseline and then creating new streams for RM, QM and AM. You will then create a new repository workspace for Dan to work in the US stream. You will modify the model and deliver the changes to the US stream. You will then deliver those changes to the UK stream by changing the flow target of the US stream. It is assumed you are still working in Dans workspace from the previous lab Task 1: Connect to a Project and Create a New Repository Workspace In this task, you will connect to an Architecture Management project that is opted-in to Global Configuration Management. You will create a new repository workspace and load the model that has already been created. 1. Connect to the Architecture Management project: a. In the Team Artifacts panel, right-click the dan@rmm repository connection and select Manage Connected Project Areas: Copyright IBM Corp. 2018 9-1

Rhapsody Model Manager Tech Jam b. Select the RMM-GC-Models project area: c. Click Finish 2. Create a Repository Workspace: a. Expand the RMM-GC-Models project area: 9-2 Copyright IBM Corp. 2018

Lab 7 Streams and Components b. Expand the Source Control section c. Expand the All Streams section d. Right-click the RMM-GC-Models-UK Stream and select New Repository Workspace: e. In the Repository Workspace Name field, add Dan to the end of the current text: f. Click Next g. Select Use current repository: Copyright IBM Corp. 2018 9-3

Rhapsody Model Manager Tech Jam h. Click Next i. In the Read Access Permission window, select Project Area and then select RMM-GC-Models: j. Click Next k. In the Components to Add window, select the RMM-GC-Models-System (it should be already selected) l. Click Finish m. In the Load Repository Workspace window, select Browse the components to select the folders to be loaded: 9-4 Copyright IBM Corp. 2018

Lab 7 Streams and Components n. Click Next o. In the Repository folders to load window, clear the RMM-GC-Models-System selection and then re-select it: TIP: This selection starts out filled in rather than selected. In which case the folder structure will not be created correctly on the hard drive. Selecting the RMM-GC-Models-System component ensures that a folder is created for it. p. Expand the Advanced Options section q. Select Load component files into sandbox subfolder r. Select Load the selected folders but do not create Eclipse projects: Copyright IBM Corp. 2018 9-5

Rhapsody Model Manager Tech Jam s. Click Finish t. If you get a confirm dialog, click OK: Task 2: Open the System Model In this task, you will open the model that you just loaded from the team workspace. 1. Open the Rhapsody Model: a. Switch to the Rhapsody client b. From the menu, select File Open c. Navigate to C:\Workspaces\dan\RMM-GC-Models-UK Workspace Dan\RMM-GC-Models- System\ADAS d. Double-click the ADAS_5.rpyx file e. Click OK: 9-6 Copyright IBM Corp. 2018

Lab 7 Streams and Components 2. Select a Global Configuration a. Click the Global Configuration toolbar selector and click <<Select>> b. If you receive a security alert, click Yes: c. If prompted to login, login as dan/dan d. In the Project area field, select RMM-GC e. In the Search field, type * f. Select the RMM-GC-System-UK Global Stream: Copyright IBM Corp. 2018 9-7

Rhapsody Model Manager Tech Jam g. Click OK Task 3: Load Collections and Observe Connected Requirements and Tests In this task you will connect to the RM and QM projects associated with this AM project. You will load a collection of requirements and also create a link to a test case. 1. Load a Requirement Collection a. In the browser, expand the Remote Artifact Packages category b. Right-click the RM Project and select Login to Server: c. Click Yes: d. In the tree, select the root (RMM-GC-Requirements) 9-8 Copyright IBM Corp. 2018

Lab 7 Streams and Components e. In the Select artifact panel, select View: Requirements Only: f. Click OK g. In the Rhapsody browser, expand the tree and note the list of Requirements: 2. Create a link to Requirements a. Expand the Remote Requirements Tables category and double-click the Requirements Only table to open it: Copyright IBM Corp. 2018 9-9

Rhapsody Model Manager Tech Jam b. Right-click in the Link Type cell in the first row and select Add New Satisfies: c. In the browser, expand Packages d. In the mini-browser, expand Packages and select the A_ItemDefinition Package: e. Click OK TIP: In this lab we don t care where links are being made only that we can see and link to the artifacts that are relevant for this specific stream or variant. 9-10 Copyright IBM Corp. 2018

Lab 7 Streams and Components 3. Create a link to RQM a. Right-click the QM Project Remote Artifact Package and select Login to Server b. In the browser, right-click the A_ItemDefinition package and select Add New OSLC Link c. In the sidebar, select OSLC Picker: d. In the Link Type field, select Validated By e. In the Project field, select RMM-GC-Testing f. Note that the Global Configuration field indicates the context in which this new link will be made: g. In the Type field, select Select Test Case h. In the Link To field, click Select: Copyright IBM Corp. 2018 9-11

Rhapsody Model Manager Tech Jam i. Note that there is only a single Test Case called Test Subsystem A j. Select the Test Case and click OK k. Click OK to close the Add Link dialog and create the new link 4. Deliver the Changes: a. Save the model b. Right-click the root of the browser and select Rational Team Concert Deliver 5. Close the model: a. From the menu, select File Close Task 4: Create a New Global Configuration In this task you will switch to the Global Configuration application and create a new US variant from the UK variant you have been working with so far. 1. Create a Global Baseline a. In the web browser, open the Global Configuration Management application: 9-12 Copyright IBM Corp. 2018

Lab 7 Streams and Components TIP: IMPORTANT make sure you are logged in as ibm the other roles may not have sufficient permissions b. Click the RMM-GC project to open it: c. Click Browse and create components d. Click the RMM-GC-System component: e. Click the RMM-GC-System-UK Stream: Copyright IBM Corp. 2018 9-13

Rhapsody Model Manager Tech Jam f. Note the Stream has contributions (configurations) from RM, QM and AM: 2. Stage a Baseline a. Click the menu button next to the RMM-GC-System UK global stream and select Stage Baseline: b. In the Name Suffix field, type V1 9-14 Copyright IBM Corp. 2018

Lab 7 Streams and Components c. Click OK d. In the toolbar, click Commit Baseline: TIP: This operation is available from the main toolbar or from the context menu of the global stream Click Commit: Note that Baselines are created automatically for RM, QM and AM (but only if you have the correct permissions QM in particularly starts with no permissions not even the project admin can create baselines if you have not configured this then the commit will fail) Copyright IBM Corp. 2018 9-15

Rhapsody Model Manager Tech Jam 3. Create a New Stream a. Select the menu button next to the new RMM-GC-System UK V1 Baseline and select Create Stream: b. In the Name Suffix field, type US c. Click OK d. Select all of the Configurations under the new Stream (and clear the checkbox next to the stream): 9-16 Copyright IBM Corp. 2018

Lab 7 Streams and Components e. Click the menu button for one of them and select Create Stream: f. Note that at the time of writing AM does not support this automation feature: g. Click Cancel h. Clear the RMM-GC-Models-UK V1 checkbox i. Try the operation again from the RMM-GC-Testing-UK V1 menu: Copyright IBM Corp. 2018 9-17

Rhapsody Model Manager Tech Jam j. Click OK: k. Note that the RM and QM contributions have been replaced with new streams but the AM contribution is still a snapshot/baseline: 4. Create the new AM Stream Manually: a. Switch back to the RTC Eclipse client b. In the Team Artifacts panel, right-click the RMM-GC-Models-UK stream and select Show Snapshots: 9-18 Copyright IBM Corp. 2018

Lab 7 Streams and Components c. Double-click the RMM-GC-Models-UK V1 Snapshot d. In the Links panel, click Create a new stream: e. Rename the new Stream RMM-GC-Models-US f. In the Owned By field, click Browse and select the RMM-GC-Models (RMM) Project: Copyright IBM Corp. 2018 9-19

Rhapsody Model Manager Tech Jam g. Click Save 5. Modify the Global Configuration: a. Return to the web browser b. Click the menu button next to the RMM-GC-Models-UK V1 snapshot and select Remove: TIP: Replace is not supported for either CCM or AM configurations and so the old component must be removed first c. Click Remove: d. Click Add Configurations: 9-20 Copyright IBM Corp. 2018

Lab 7 Streams and Components e. In the header field, select Architecture Management f. In the Project Area field, select RMM-GC-Models g. In the Type field, select Stream h. In the Stream Name field, type * i. Select the RMM-GC-Models-US Stream: j. Click OK Task 5: Modify Requirements and Tests In this task you will modify the Requirements and Tests in the new US Global Configuration 1. Remove Requirements: Copyright IBM Corp. 2018 9-21

Rhapsody Model Manager Tech Jam a. In the Global Configuration tree, right-click the Requirements Management project and select Open in New Window: TIP: This is a quick and easy way to open the RM project in the correct context in this case the US Global Configuration b. Confirm the current context is the RMM-GC-System US Global Configuration: c. Open the System Requirements module d. Select the headings 2, 3 and 4: 9-22 Copyright IBM Corp. 2018

Lab 7 Streams and Components e. Click the menu button for one of the selections and select Remove 3 Artifacts: Copyright IBM Corp. 2018 9-23

Rhapsody Model Manager Tech Jam f. Click Remove: g. Apply the Requirements Only view and note that there are now far fewer requirements: 9-24 Copyright IBM Corp. 2018

Lab 7 Streams and Components TIP: This is just a simple change to demonstrate the principle of course in real systems the existing requirements would be modified, and new ones would be added. h. Close the browser tab and return to the Global Configurations tab. 2. Modify the Test Data: a. Click the RMM-GC-Testing US stream: b. From the menu, click Construction Browse Test Cases c. Note there is a single Test Case d. From the menu, click Construction Create Test Case Copyright IBM Corp. 2018 9-25

Rhapsody Model Manager Tech Jam e. Name the new Test Case Test Subsystem B: f. Click Save TIP: Again, this is a simple change to illustrate the principle - in the UK variant there is only one Test Case but in the US Variant there are two. Task 6: Switch Global Configurations In this task you will load the US variant into Dan s sandbox and open the US Variant model after first creating a repository workspace for that stream. You will then select the correct Global Configuration for that stream in Rhapsody. 1. Create a Repository Workspace: a. Switch to the RTC client b. In the Team Artifacts panel, right-click the RMM-GC-Models-US Stream and select New Repository Workspace c. Add Dan to the end of the name: 9-26 Copyright IBM Corp. 2018

Lab 7 Streams and Components d. Click Next e. Select Use current repository f. Click Next g. Select Private: h. Click Next i. Note the Component is already selected: Copyright IBM Corp. 2018 9-27

Rhapsody Model Manager Tech Jam j. Click Finish k. In the Load Repository Workspace window, select Browse the components to select the folders to be loaded: l. Click Next m. In the Repository folders to load window, clear, then select the RMM-GC-Models-System Component: TIP: IMPORTANT this selection starts as filled in rather than selected make sure you clear the box and then select it again so that a tick appears otherwise the correct file structure will not be created. n. Expand the Advanced Options section o. Select Load component files into sandbox subfolder 9-28 Copyright IBM Corp. 2018

Lab 7 Streams and Components p. Select Load the selected folders but do not create Eclipse projects: q. Click Finish r. If you get a confirm dialog, click OK: 2. Note the Incoming Baseline: a. Note that in the Pending Changes view there is an Incoming Baseline to the UK stream: TIP: This is just simple housekeeping by RTC. Accepting the Baseline will not impact any current work. 3. Accept the Baseline: Copyright IBM Corp. 2018 9-29

Rhapsody Model Manager Tech Jam a. Right-click the incoming Baseline and select Accept 4. Open the model and switch to the US Stream: a. Switch to the Rhapsody client b. Click File Open c. Browse to C:\Workspaces\dan\RMM-GC-Models-US Workspace Dan\RMM-GC-Models- System\ADAS TIP: Note that you are browsing to the newly created folder for the US variant d. Double-click the ADAS_5.rpyx file e. Note that Rhapsody still has the UK Global Configuration selected and so displays a warning: f. Click OK 5. Select a Global Configuration a. Click the Global Configuration toolbar selector and click <<Select>> b. If you receive a security alert, click Yes: 9-30 Copyright IBM Corp. 2018

Lab 7 Streams and Components c. If prompted to login, login as dan/dan d. In the Project area field, select RMM-GC e. In the Search field, type * f. Select the RMM-GC-System-US Global Stream: g. Click OK 6. Load Requirements: a. Expand the Remote Artifact Packages category b. Right-click the RM Project and select Login to Server: Copyright IBM Corp. 2018 9-31

Rhapsody Model Manager Tech Jam c. Expand the RM project d. Note that the project has a Collection but it starts off unloaded: TIP: Since one of the requirements has a link to an element in this model the requirement is automatically displayed. e. Right-click the View: Requirements Only collection and select Populate With All Artifacts: f. Note that the collection of Requirements has changed showing only those requirements that are part of the linked RM project in this new context and the requirement that has a link is shown outside that collection: 9-32 Copyright IBM Corp. 2018

Lab 7 Streams and Components Task 7: Deliver Changes Between Streams In this task you will make some changes to the model in the US Stream and then deliver those changes to the UK Stream. To achieve this, you will change the flow target, accept the incoming changes and then return the flow target to its original position. 1. Change the model a. In the Browser, right-click the Packages category and select Add New Package: b. Name the new Package F_Documentation: Copyright IBM Corp. 2018 9-33

Rhapsody Model Manager Tech Jam 2. Deliver the Changes to the US Stream: a. Save the model b. Right-click the root of the browser and select Rational Team Concert Deliver 3. Change the US Flow Target: a. Switch to the RTC client b. In the Pending Changes view, right-click the RMM-GC-Models-US Workspace and select Change Flow Target: c. In the search field, type *UK d. Select the RMM-GC-Models-UK Stream: 9-34 Copyright IBM Corp. 2018

Lab 7 Streams and Components e. Click OK f. Note the new outgoing changes and the new outgoing flow target 4. Create a Flow diagram: a. Right-click the RMM-GC-Models-US Workspace and select New Flow Diagram: b. In the new diagram, click the Show Flow Targets button in Dans workspace: c. Note that the diagram indicates the default flow is the US Stream but the current outgoing flow is the UK Stream: Copyright IBM Corp. 2018 9-35

Rhapsody Model Manager Tech Jam d. Close the Flow Diagram and don t save it 5. Deliver the Changes: a. Right-click the Outgoing Change Set and select Deliver b. Click OK: 6. Restore the Flow: a. Right-click the US Workspace and select Change Flow Target b. Click Select Default Outgoing c. Click OK d. Note that the US Workspace has returned to the default flow direction: e. Note that Dan now has an incoming change set in the UK Workspace: 9-36 Copyright IBM Corp. 2018

Lab 7 Streams and Components TIP: The changes were delivered into the UK Stream but Dan has not yet accepted those changes into his own workspace for that Stream 7. Accept the Changes: a. Right-click the change set and select Accept Copyright IBM Corp. 2018 9-37