IBM Support

Specified host is not a registry server

Troubleshooting


Problem

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 <hostname> 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.

    Note: Both the rgy_svr.conf file and rgy_hosts.conf file are required even if it is a server.
  • 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.




    [{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ClearCase Registry","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"2003.06.00;2003.06.16;7.0;7.0.0.1;7.0.0.2;7.0.0.3;7.0.0.4;7.0.1;7.0.1.1;7.0.1.2;7.0.1.3;7.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

    Document Information

    Modified date:
    16 June 2018

    UID

    swg21135962

    Page Feedback