Move IBM Rational ClearCase server to a new domain in Windows
Change host names and domains of the IBM Rational ClearCase server
Administrators who want to change host names and domain names for IBM® Rational® ClearCase® server are faced with a dilemma: Uninstall and reinstall the product from scratch or live with the existing names. In an environment with multiple servers, reinstallation can be a time-consuming process.
This article describes how to move a Rational ClearCase server from one domain to another without reinstalling the product. If you have not created any data after installation of the product, you can use the server in the new domain immediately after you finish the steps in this article. If you have data, you might need additional steps for the migration. These steps are outlined in the product documentation.
The steps in this article are tested on a Microsoft Windows 2008 R2 Server machine with the following Rational ClearCase 188.8.131.52 features:
- Dynamic views
- Local views and versioned object bases (VOBs)
- VOB server
- View server
- Rational ClearCase Remote Client (CCRC) WAN server
In addition to these features, the server machine is running IBM® WebSphere® Application Server 8.5.0 and IBM HTTP Server 8.5.0 components, which are required for the CCRC WAN Server.
The examples in this article use the parameter settings shown in Table 1.
Table 1. Parameters used in this article
|Old parameters||New parameters|
|Fully qualified hostname|
Overview of the steps
To move the Rational ClearCase server from one domain to another, follow these steps:
- Change the host name and add the machine to the new domain.
- Change settings for Rational ClearCase.
- Change settings for WebSphere Application Server.
- Change settings for IBM HTTP Server.
Step 1. Change computer settings
The first step is to update your computer settings with a new host name and domain name, depending on your network configuration. You might need to change the DNS server address and the DNS suffix to get connected to a new domain controller.
To change the computer name and domain, go to your system properties, as shown in Figure 1. After you update the fields, restart the machine.
Figure 1. Change computer name and domain
After the machine is restarted, log in as the domain administrator.
Step 2. Change Rational ClearCase settings
Change the Rational ClearCase settings to use the Rational ClearCase
clearcase_albd in the new domain.
Verify that the user account and the group are correctly set up in the new
domain. If this machine is set up as a Rational ClearCase registry server,
change the registry server's host name so that it points to the new fully
To change the
clearcase_albd account, edit the logon account
of the Windows service Atria Location Broker.
- Click the Windows Start button and click Administrative Tools>Services.
- Double-click Atria Location Broker service to open the properties.
- Click the Log On tab.
- Replace the old account information (
DOM01\ccalbd) with the new account (
DOM02\ccalbd), as shown in Figure 2.
Figure 2. Atria Location Broker's Log On account
To change the Rational ClearCase administrators group to belong to the
clearcase_albd account, edit the Microsoft Windows registry
ClearCaseGroupName. Create a backup of the
registry and use the Registry Editor (regedit) to edit the registry key.
The location of the registry key depends on the operating system:
Replace the old group (
DOM01\ccadms) with the new group
DOM02\ccadms), as shown in Figure 3.
Figure 3. ClearCaseGroupName
The Rational ClearCase administrators group needs to have full control
permission to the Rational ClearCase var folder. The folder is located in
folder. Add full control permission to the new group by using the
- Right-click the var folder and open var Properties.
- Click the Security tab.
- Click Edit and open the Permissions for var window shown in Figure 4.
- Click Add and specify the new group name.
- Click OK and go back to the Permission for var window.
- Select the new group in the top box and select the Allow checkbox for Full control.
- Remove the old group in the row for SID because the SID of DOM01\ccadms cannot be resolved in the new domain, DOM02. Click Remove.
- Click OK.
- If the
Error Applying Securitymessage appears, click Continue.
- Click OK to close the var Properties.
Figure 4. Permissions for var folder
If this machine is the Rational ClearCase registry server, you have already
changed the host name when you updated the computer
settings in an earlier step. In this case, you must change the
Windows registry key entry value of the registry server's host name. To
change the host name, edit the Microsoft Windows registry key entry,
AtriaRegy. Create a backup of the registry and use regedit to
edit the registry key. The location of the registry key depends on the
- 32-bit host:
- 64-bit host:
Replace the old host name (
oldhost.dom01.local) with the new
host name (
newhost.dom02.local), as shown in Figure 5.
Figure 5. Value data for AtriaRegy
Step 3. Change WebSphere Application Server settings
WebSphere Application Server must be installed before you install the CCRC
WAN server feature. To use the CCRC WAN server with the new host name,
change the host name of WebSphere Application Server. Use the
wsadmin command line tool to change the hostname using the
following steps, as shown in Figure 6.
- Go to the command prompt and as shown in the following command, go to
the bin folder under WebSphere Application Server folder, for example,
- Run the
wsadmintool using Jython using the following command:
>wsadmin -lang jython
- Set the new host name to your node, as shown in the following command.
The default node is
wsadmin>AdminTask.changeHostName('-hostName newhost.dom02.local -nodeName dfltNode')
- Save the configuration using the following
- End the
wsadmintool, as shown in the following command.
- Close the command prompt.
Figure 6. Sample output of wsadmin
WebSphere Application Server has host name settings in the web server
plugin configuration file, plugin-cfg.xml. This file is located in
webserver1 represents your web server definition
As shown in Listing 1, open the plugin-cfg.xml file to find the old host
oldhost.dom01.local) and replace them with the new
host names (
Listing 1. Change host names in WebSphere Application Server plugin configuration file
<Transport Hostname="oldhost.dom01.local" Port="9080" Protocol="http"/> <Transport Hostname="oldhost.dom01.local" Port="9443" Protocol="https"> <Transport Hostname="oldhost.dom01.local" Port="9080" Protocol="http"/> <Transport Hostname="oldhost.dom01.local" Port="9443" Protocol="https">
The response file,
also has host names. Although this file does not need to be changed, it is
better to avoid future risk by updating it, as shown in Listing 2.
Listing 2. Change host names in WebSphere Application Server response file
Step 4. Change IBM HTTP Server settings
Update two IBM HTTP Server files, admin.conf and httpd.conf, with the new
host names and domains. Replace the old host names
oldhost.dom01.local) with the new host names
newhost.dom02.local) in the respective files.
- In the file
install folder>\IBM\HTTPServer\conf\admin.conf make the following change:
- In the file
install folder>\IBM\HTTPServer\conf\httpd.conf make the following change:
Restart the machine to complete the steps.
Using the server in the new domain
After you have finished the modifications, you are ready to use the server
in the new domain. Check your IBM Rational ClearCase installation with
ClearCase Doctor and resolve each error, if any occur. Check your CCRC WAN
server's availability by pointing your web browser to
hostname/ccrc using your web browser. If you can see
IBM Rational CCRC WAN Server message, the server is up
- For more information about Rational ClearCase, check the product overview page.
- Build your next app with IBM Cloud Lite. No time limit. No credit card required. Start for free
- Download a free trial version of Rational software.
- See the technote "Recovering ClearCase functionality after users and groups moved to a new domain" for more information about moving data.