Edit
Attach
P
rintable
r14 - 2020-03-12 - 12:16:39 -
PaulEllis
You are here:
TWiki
>
Deployment Web
>
DeploymentMigratingAndEvolving
>
MovingAComponentToANewServer
<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%"> ---+!! Moving an Engineering Workflow Management (EWM) SCM component to a new EWM SCM server <img src="https://jazz.net/wiki/pub/Deployment/WebPreferences/new.png" alt="new.png" width="50" height="50" align="right"> %DKGRAY% Authors: Main.ArunSriramaiah Main.PaulEllis Main.SheejaVijayan<br> Build basis: Engineering Workflow Management 6.0.6.1 %ENDCOLOR%</div></sticky> <!-- Page contents top of page on right hand side in box --> <sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;"> %TOC{title="Page contents"}% </div></sticky> <sticky><div style="margin:15px;"></sticky> This article relates to Engineering Workflow Management (EWM) Source Control Management (SCM) components. EWM was formerly known as Rational Team Concert. The products were renamed during the ELM 6.0.6.1/7.0 timeframe. For more information, see Renaming the IBM Continuous Engineering Portfolio. Newly introduced in the ELM 6.0.6.1 release, there are now two repotool commands to refactor your components across different server repositories. ---++ Introduction New capabilities were introduced in the 6.0.6.1 release of EWM. This document explains about the uses of these new capabilities and their importance. *Component Export\Import* The repotools-ccm command for the CCM server now supports * Exporting a component and the contained SCM information into an export file. * Importing a component and the contained SCM information from an export file. These new capabilities can be used to migrate a component from one server to another with history references without the need to use distributed SCM. The scmExportComponent command exports the contents of source-control management (SCM) components to a .tar file. The scmImportComponent command imports the contents of an exported .tar file. The EWM SCM CLI functions that are described here must be run by a user with administrative privileges. This section outlines the process of migrating an ELM SCM component to a new server. It provides step-by-step instructions. *Supported Use Cases* The new capabilities supports the following use cases: * Populating a new server with an EWM SCM components content and history * Migrating SCM data to another server, for example: * Database reduction: migrate SCM content to a new server and remove it from the original server to rebalance database sizes * Refactoring: Separate the SCM data to a different server due to product closure or geographical repositioning * Creating a pre-production Jazz environment with real data * Setting up a second CCM server only for SCM/Build *Important considerations* * The initial replication can be very long-running <need something factual here and then guidance on what that means. Should be run in quiet time (resource-intensive etc etc) Dimensions of your data are important... * Issues running export\import commands with derby database, It might support derby in a network mode. * This document was tested by using DB2 11 enterprise database. * This document is applicable to all supported databases <see link ( *https://jazz.net/wiki/bin/view/Deployment/CLMSystemRequirements6061*) to system requirements> and works when you export from one database vendor to another. ---++ Part 1 - Export the component (Server-A) The scmExportComponent command exports the contents of a database, scoped to a set of SCM components, to a .tar file. The exported .tar file only contains data that is only a part of the specified SCM components and is not a full database export. You can import the .tar file onto a different server. [[https://www.ibm.com/support/knowledgecenter/SSYMRC_6.0.6.1/com.ibm.jazz.install.doc/topics/r_scmExportComponent.html][ Use the scmExportComponent command ]] to export the contents of SCM components to a .tar file. <br> Before you import components, ensure that they do not exist on the server already. All components in the archive are imported together. The following data is included in an exported component archive: * Component, * Contained baselines * History * Change-sets. * Files and folders that are modified by change-sets in the component, and the content that is associated with these files. * Version identifiers, item permissions, and custom attributes for any files and folders that are part of the export. * Contributor information for all users who create or modify any exported item. The following data is not included in an exported component archive: * The current state of the component in the workspace or stream, and the history of operations done in a stream or workspace. Before you export, create baselines to record the current state of any notable streams or workspaces. * Snapshots are not included, but the individual baselines under the component are included. * Baseline hierarchies are not included, but the individual baselines that make up the hierarchy under the component are included. *UseCase* Repository tools command to export SCM components https://www.ibm.com/support/knowledgecenter/SSYMRC_6.0.6.1/com.ibm.jazz.install.doc/topics/r_scmExportComponent.html The export command requires a component UUID. To determine the UUID of the component use the RTC web browser or use the RTC SCM Command Line command. Recommended IBM Usage is Use "command prompt" for Windows operating systems. For multiple operating systems or for operating systems that are not Windows, use "command line." *Example* Open a command prompt and enter the following command: cd C:\Program Files\IBM\JazzTeamServer\server\ *repotools-ccm.bat -scmExportComponent components=_iIfDAEKSEd2A5aJWEO8dbA,_pN8RYPi-Ed2J16MAqQXG5g toFile=exportComponents.tar* Open a command prompt and enter the following command: cd /opt/IBM/JazzTeamServer/server/ *./repotools-ccm.sh -scmExportComponent components=_iIfDAEKSEd2A5aJWEO8dbA,_pN8RYPi-Ed2J16MAqQXG5g toFile=./exportComponents.tar* The command can also be used for multiple components. Example: <img src="https://jazz.net/wiki/pub/Deployment/MovingAComponentToANewServer/2ExportCommand.png" alt="2ExportCommand.png" width="550" height="150" /> %BR% *Export Command Output:* <img src="https://jazz.net/wiki/pub/Deployment/MovingAComponentToANewServer/3ExportOutput.png" alt="3ExportOutput.png" width="750" height="250" /> %BR% ---++ Additional fix in 7.0 & prechecklist for Import command * Component import with new contributors does not work with OIDC SSO, fixed in EWM 7.0 version. If scm component import contains new contributors and the server is configured to use OIDC single sign on, then the import will fail while attempting to create the contributors in the JTS https://jazz.net/jazz/web/projects/Rational%20Team%20Concert#action=com.ibm.team.workitem.viewWorkItem&id=489373 * Component import with new contributors does not work if the JTS is offline ( Ensure that JTS is online) , fixed in EWM 7.0 version. When performing an offline component import, if we have new contributors then we will fail to make calls to the JTS to create the users and import will fail. https://jazz.net/jazz/web/projects/Rational%20Team%20Concert#action=com.ibm.team.workitem.viewWorkItem&id=489374 *Note: Check latest ifix for the 6061 version, if it's back-ported.* ---++ Part 2 - Import the component (Server-B) [[https://www.ibm.com/support/knowledgecenter/SSYMRC_6.0.6.1/com.ibm.jazz.install.doc/topics/r_scmImportComponent.html][Use the scmImportComponent command to import the contents of an exported source-control management (SCM) component .tar file into a database]] <br> All data in the previously exported SCM component .tar file is imported together. Components being imported must not previously exist on the server. * Imported components are initially owned by the default Admin user and are in an archived state. An administrator must unarchive the component and set the owner to an appropriate process area or contributor before users can access it. * Imported files and folders with permissions set to a context that does not exist on the server are reassigned to the Admin user. When you import components onto a new server, the permission context (that is, project area) might not exist. * Custom attributes are controlled by the project area that owns the component. * Custom attributes of the component that is imported to a new server are retained. But users cannot set new attributes unless they are configured in the project area that owns the component. *Command Example:* Open a command prompt and enter the following command: cd C:\Program Files\IBM\JazzTeamServer\server\ *repotools-ccm.bat -scmImportComponent fromFile=exportComponents.tar* Open a command prompt and enter the following command: cd /opt/IBM/JazzTeamServer/server/ *./repotools-ccm.sh -scmImportComponent fromFile=./exportComponents.tar* *Import Command Output:* <img src="https://jazz.net/wiki/pub/Deployment/MovingAComponentToANewServer/2ImportOutput.png" alt="2ImportOutput.png" width="750" height="250" /> %BR% ---++ Part 3 - Set the migrated component into the project Scope in (Server-B) Imported components are initially owned by the default Admin user and are in an archived state. An administrator must unarchive the component and set the owner to an appropriate process area or contributor before users can access it. * 1) Explicitly list archived components by using the SCM list components command. Lists the components that are associated with a workspace, stream, or repository. https://jazz.net/help-dev/clm/index.jsp?re=1&topic=/com.ibm.team.scm.doc/topics/list_components.html&scope=null Example: *code* is a component that is migrated from Server-A to Server-B C:\IBM\RTCEE42\scmtools\eclipse> *scm.exe list components -r https://RTC6061:9443/ccm -u Admin -j --visibility archived* <img src="https://jazz.net/wiki/pub/Deployment/MovingAComponentToANewServer/ArchivedComp.png" alt="ArchivedComp.png" width="750" height="250" /> %BR% * 2) Change the visibility scope of the component For example, : Private or Public, depending on what you want to set as visibility. *Note: If the alias is not working, use the components UUID in the command executions.* Set the attributes of items. https://jazz.net/help-dev/clm/index.jsp?topic=%2Fcom.ibm.team.scm.doc%2Ftopics%2Fset_attributes.html C:\IBM\RTCEE42\scmtools\eclipses *scm.exe set attribute --component _4_gg0ON8EemgH41uLVD-BQ --visibility public -r https://db2:9443/ccm -u Admin* Password (Admin @ https://db2:9443/ccm): The component property was set. <img src="https://jazz.net/wiki/pub/Deployment/MovingAComponentToANewServer/VisblityComp.png" alt="VisblityComp.png" width="650" height="100" /> %BR% * 3) Change the owner scope for the component For Example,..: Project Area or Team Area, depending on what you want to set as owner). Note: If the alias is not working, use the components UUID in the command executions.. Set the attributes of items https://jazz.net/help-dev/clm/index.jsp?topic=%2Fcom.ibm.team.scm.doc%2Ftopics%2Fset_attributes.html C:\IBM\RTCEE42\scmtools\eclipse> *scm.exe set attribute --component _4_gg0ON8EemgH41uLVD-BQ --ownedby Demo -r https://db2:9443/ccm -u Admin* Password (Admin @ https://db2:9443/ccm/): The component property was set. <img src="https://jazz.net/wiki/pub/Deployment/MovingAComponentToANewServer/ChangeOwner.png" alt="ChangeOwner.png" width="650" height="100" /> %BR% ---++ Post Checklist: * 1) Check that the imported component is under project scope. *Note: Imported component can be listed using the following command. * C:\IBM\RTCEE42\scmtools\eclipse> *scm.exe list components -r https://db2:9443/ccm -u Admin -j* Password (Admin @ https://db2:9443/ccm): <img src="https://jazz.net/wiki/pub/Deployment/MovingAComponentToANewServer/CompList.png" alt="CompList.png" width="750" height="250" /> %BR% * 2) Add the component into the stream and verify the following details. * Component, * Contained baselines * History * Change-sets. * Files and folders that are modified by change-sets in the component, and the content that is associated with these files. * Version identifiers, item permissions, and custom attributes for any files and folders that are part of the export. * Contributor information for all users who create or modify any exported item. <img src="https://jazz.net/wiki/pub/Deployment/MovingAComponentToANewServer/EclipseClient.png" alt="EclipseClient.png" width="750" height="250" /> %BR% ---+++ Cleaning up and reclaiming space In [[https://jazz.net/wiki/bin/view/Deployment/DatabaseGrowth][Database Growth - Strategies for minimizing the growth of repository databases]], Main.RosaNaranjo describes how to perform the final step. In Engineering Workflow Management (EWM), the following items contribute greatly to database growth if not kept in check: *  Build results *  Work item attachments *  Binary content in SCM as versioned content You can refer the following articles and presentations that are written on this topic: * [[https://trfeeney.wordpress.com/2014/12/09/help-my-rtc-database-is-getting-big/][Help! My EWM Database is getting big!]] * [[https://trfeeney.wordpress.com/2019/10/08/follow-up-to-help-my-rtc-database-is-getting-big/][Follow-up to Help! My EWM Database is getting big!]] * [[DataDeletionRTC][Deleting data in Engineering Workflow Management]] * [[https://jazz.net/library/article/1459][Reducing the size of the Engineering Workflow Management repository database]] * [[https://jazz.net/library/article/1006][Deleting content in EWM]] ---+++++!! Related topics: [[DatabaseGrowth][Database Growth]], [[DataDeletionRTC][Deleting data in Engineering Workflow Management]] ---+++++!! External links: * [[https://www.ibm.com][IBM]] ---+++++!! Additional contributors: Main.PaulEllis, Main.RosaNaranjo <sticky></div></sticky>
Edit
|
Attach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
:
r23
|
r16
<
r15
<
r14
<
r13
|
More topic actions...
Deployment
Deployment web
Planning and design
Installing and upgrading
Migrating and evolving
Integrating
Administering
Monitoring
Troubleshooting
Community information and contribution guidelines
Create new topic
Topic list
Search
Advanced search
Notify
RSS
Atom
Changes
Statistics
Web preferences
NOTE: Please use the Sandbox web for testing
Status icon key:
To do
Under construction
New
Updated
Constant change
None - stable page
Smaller versions of status icons for inline text:
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our
Terms of Use.
Please read the following
disclaimer
.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more
here
.