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/

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki