Changing the public URL by using server rename

This section discusses strategies and instructions for changing the public URL for Rational® solution for Collaborative Lifecycle Management (CLM) version 4.0.1 and later applications by using server rename.
Important: Server rename operations change the public URLs of referenced artifacts in a Collaborative Lifecycle Management (CLM) deployment and might affect external links. For example, URL changes can invalidate external references such as those in email notifications, or external Open Services for Lifecycle Collaboration (OSLC) references from tools that do not support server rename. If you perform a server rename in a production environment, these changes might disrupt users. However, the server rename operation is useful for routine administrative tasks, such as refreshing data in a staging environment by using a snapshot of the production environment.

To perform a server rename, you must obtain a feature key file from IBM Software Support. When you contact IBM Support, mention that you are requesting a "server rename feature key file". The key file is named ImportURLMappings.activate. Copy the file to the JazzInstallDir/server/conf directory for the applications that you will rename. The key is only needed to execute the repotools importURLMappings command.

For advanced or deployment-specific information about server rename including best practices and limitations and workarounds, see the Server rename section of the Jazz.net Deployment wiki.


video icon Watch videos

CLM playlist
Jazz.net channel
User Education channel

learn icon Learn more

CLM learning circle
Agile learning circle
Learning circles

ask icon Ask questions

Jazz.net forum
developerWorks forums

support icon Get support

Support Portal
Deployment wiki
Support blog