Repository tools command to update URL links between artifacts

Use the modifyLinkURIs command to modify the URI links in the repository.

Purpose

The modifyLinkURIs command can be used to update URL links between artifacts in the repository. For more information and samples, see Tip: Migrating Work Item URL Links.

Note: When using this command to modify any URL link, the URL link must match the friend entry that was used to set up the cross-server communication on the Jazz Team Server. Otherwise, hovering over the links in Engineering Workflow Management does not provide any information.

Remember: This command requires that the server is shut down beforehand.

Parameters

Attribute	Description	Required	Default
linkTypeId	The ID of the type of link to modify. For example, "com.ibm.team.workitem.linktype.relatedChangeManagement".	Yes	N/A
find	A string inside of a URI to find. For example, https://<ewm-server>:<port>/ccm/oslc/cqrest/.	Yes	N/A
replace	The new string to replace the existing string. For example, http(s)://<cq-server>:<port>/cqweb/oslc/.	Yes	N/A

Example

For Windows
operating system Open a command prompt and enter this command:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-ccm.bat -modifyLinkURIs linkTypeId="com.ibm.team.workitem.linktype.relatedChangeManagement" find=https://ewm-server:port/ccm/oslc/cqrest/ replace=http://cq-server:port/cqweb/oslc/

For Unix
operating systems Open a command line and enter this command:

cd opt/IBM/JazzTeamServer/server/
./repotools-ccm.sh -modifyLinkURIs linkTypeId="com.ibm.team.workitem.linktype.relatedChangeManagement" find=https://ewm-server:port/ccm/oslc/cqrest/ replace=http://cq-server:port/cqweb/oslc/