Contents


Move IBM Rational ClearCase server to a new domain in Windows

Change host names and domains of the IBM Rational ClearCase server

Comments

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 8.0.1.4 features:

  • Dynamic views
  • Local views and versioned object bases (VOBs)
  • VOB server
  • View server
  • Rational ClearCase Remote Client (CCRC) WAN server
  • Multisite

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 parametersNew parameters
Fully qualified hostnameoldhost.dom01.localnewhost.dom01.local
Windows domainDOM01DOM02
clearcase_albd accountDOM01\ccalbdDOM02\ccalbd
Administrators groupDOM01\ccadmsDOM02\ccadms

Overview of the steps

To move the Rational ClearCase server from one domain to another, follow these steps:

  1. Change the host name and add the machine to the new domain.
  2. Change settings for Rational ClearCase.
  3. Change settings for WebSphere Application Server.
  4. 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
Computer name is newhost. Member of domain dom02local

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 administrator account 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 qualified hostname.

To change the clearcase_albd account, edit the logon account of the Windows service Atria Location Broker.

  1. Click the Windows Start button and click Administrative Tools>Services.
  2. Double-click Atria Location Broker service to open the properties.
  3. Click the Log On tab.
  4. 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
Type account name DOM02\ccalbd and password
Type account name DOM02\ccalbd and password

To change the Rational ClearCase administrators group to belong to the clearcase_albd account, edit the Microsoft Windows registry key entry, 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:

  • 32-bit host:
    HKEY_LOCAL_MACHINE\Software\Atria\ClearCase\CurrentVersion\ClearCaseGroupName
  • 64-bit host:
    HKEY_LOCAL_MACHINE\Software\WOW6432Node\Atria\ClearCase\CurrentVersion\ClearCaseGroupName

Replace the old group (DOM01\ccadms) with the new group (DOM02\ccadms), as shown in Figure 3.

Figure 3. ClearCaseGroupName
Registry key ClearCaseGroupName is DOM02\ccadms
Registry key ClearCaseGroupName is DOM02\ccadms

The Rational ClearCase administrators group needs to have full control permission to the Rational ClearCase var folder. The folder is located in the <install folder>\IBM\RationalSDLC\ClearCase\var folder. Add full control permission to the new group by using the following steps.

  1. Right-click the var folder and open var Properties.
  2. Click the Security tab.
  3. Click Edit and open the Permissions for var window shown in Figure 4.
  4. Click Add and specify the new group name.
  5. Click OK and go back to the Permission for var window.
  6. Select the new group in the top box and select the Allow checkbox for Full control.
  7. 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.
  8. Click OK.
  9. If the Error Applying Security message appears, click Continue.
  10. Click OK to close the var Properties.
Figure 4. Permissions for var folder
Security window: Select ccadms and allow full control
Security window: Select ccadms and allow full control

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 operating system:

  • 32-bit host:
    HKEY_LOCAL_MACHINE\Software\Atria\ClearCase\CurrentVersion\AtriaRegy
  • 64-bit host:
    HKEY_LOCAL_MACHINE\Software\WOW6432Node\Atria\ClearCase\CurrentVersion\AtriaRegy

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
Value for AtriaRegy is newhost.dom02.local
Value for AtriaRegy is newhost.dom02.local

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.

  1. Go to the command prompt and as shown in the following command, go to the bin folder under WebSphere Application Server folder, for example, <install folder>IBM\WebSphere\AppServer\bin.
    >cd C:\IBM\WebSphere\AppServer\bin
  2. Run the wsadmin tool using Jython using the following command:
    >wsadmin -lang jython
  3. Set the new host name to your node, as shown in the following command. The default node is dfltNode.
    wsadmin>AdminTask.changeHostName('-hostName newhost.dom02.local -nodeName dfltNode')
  4. Save the configuration using the following command:
    wsadmin>AdminConfig.save()
  5. End the wsadmin tool, as shown in the following command.
    wsadmin>exit
  6. Close the command prompt.
Figure 6. Sample output of wsadmin
Screen capture of command output of wsadmin
Screen capture of command 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 <install folder>\IBM\WebSphere\Plugins\config\webserver1\plugin-cfg.xml, where webserver1 represents your web server definition name.

As shown in Listing 1, open the plugin-cfg.xml file to find the old host names (oldhost.dom01.local) and replace them with the new host names (newhost.dom02.local).

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, <install folder>\IBM\WebSphere\Plugins\config\webserver1\webserver1.responseFile 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
wasMachineHostName=oldhost.dom01.local
webServerHostName=oldhost.dom01.local

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:
    ServerName oldhost.dom01.local:@@AdminPort@@
  • In the file <install folder>\IBM\HTTPServer\conf\httpd.conf make the following change:
    ServerName oldhost.dom01.local:80

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 http://hostname/ccrc using your web browser. If you can see the IBM Rational CCRC WAN Server message, the server is up and running.


Downloadable resources


Related topics


Comments

Sign in or register to add and subscribe to comments.

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Rational
ArticleID=980458
ArticleTitle=Move IBM Rational ClearCase server to a new domain in Windows
publish-date=08292014