Specified host is not a registry server

Problem(Abstract)
This technote explains why running any IBM® Rational® ClearCase® cleartool command yields the error message Trouble contacting registry on host specified host is not a registry server on Microsoft® Windows®, Linux® and UNIX®.
Symptom

The following error is reported when running various cleartool commands:

Trouble contacting registry on host specified host is not a registry server


On the UNIX / Linux server, you may also get this error after installing ClearCase or updating
a ClearCase patch when at the [What is the registry server hostname?] prompt during the installation,


Cause
  • The error may be caused by an incorrect registry hostname being set on the ClearCase client or the registry file on the registry server may be missing or corrupted.

  • During the ClearCase installation the incorrect hostname may have been entered. For example if you enter myhost when the actual hostname is myhost.lex.ibm.com which is the output of a uname -a on the registry server.

Resolving the problem

Note: When following the instructions below keep in mind that on Unix and Linux hosts running ClearCase version 7.0.1 and later the registry files are located in /var/adm/rational/clearcase/config

Refer to technote 1265395 ClearCase 7.0.1 registry files on UNIX and Linux moved from 'rgy' to 'config' for further information about this change.

UNIX/LINUX CLIENT

  • Make sure that the correct registry server name is specified in the rgy_hosts.conf file on the client host from which the cleartool command has been executed:

    cd /var/adm/atria/rgy
    cat rgy_hosts.conf


UNIX/LINUX SERVER
  • Nonexistent or corrupted rgy_svr.conf file on the registry server host itself.

    The rgy_svr.conf file on the registry host is what informs ClearCase that it is a registry host. The file should exist in the /var/adm/atria/rgy (/var/adm/rational/clearcase/config in version 7.0.1 or later) on the registry host, and it should contain the word master.
    • If this file does not exist, create it.
    • If the file exists but does not contain the word master, edit the file and add the keyword master.

  • Stop and restart ClearCase
    1. /opt/rational/clearcase/etc/atria_start stop
    2. /opt/rational/clearcase/etc/atria_start start

WINDOWS CLIENT

  • Make sure that the correct registry server name is specified in the ClearCase Control Panel on the client from which the cleartool command has been executed. The "Use registry server on host" radio button ought to be selected with a valid host name in the box.


WINDOWS SERVER

  • Make sure that the registry server points to itself in the ClearCase Control Panel by selecting the "Use local host as registry server" radio button.

No comments:

Post a Comment