IBM Support

IBM Rational ClearCase cleartool mkstg, mkview and mkvob fail to derive accessibility information on Red Hat Enterprise Linux 7

Troubleshooting


Problem

When you specify a path storage for the commands "cleartool mkstg", "cleartool mkview" or "cleartool mkvob", IBM Rational ClearCase heuristically derives the accessibility information from the storage path name. A change in the "/etc/mtab" file prevents ClearCase to correctly derive the host and host local path from the storage path name.

Symptom

The creation of storage locations, views or VOB on RHEL7 systems may not work as expected.

Cause

The file "/etc/mtab" was replaced by a symlink to "/proc/self/mounts", which has different information for auto-mounted mount points, especially for bind mounts.

Environment

Red Hat Enterprise Linux 7, any supported architecture, ClearCase before version 8.0.1.9.

Diagnosing The Problem

This is only applicable for ClearCase before version 8.0.1.9.
Create a storage location on the same machine cleartool is running, informing only the storage path name. For example, supposing your test machine name is "myserver" and that the directory "/tmp" is exported:

% cleartool mkstg -vob mystgloc /net/myserver/tmp/mystgloc

If the command succeeds, you will see an output like this:

Created and advertised Server Storage Location.
Host-local path: myserver:/net/myserver/tmp/mystgloc
Global path: /net/myserver/net/myserver/tmp/mystgloc

However, even if the result of the Cleartool command was successful, the "Global Path" line may show an invalid path. If that is the case, it means ClearCase was unable to derive the correct accessibility information from the path storage.

Resolving The Problem

This problem is fixed since ClearCase 8.0.1.9.

When creating a view, a VOB or a storage location, you must explicitly set all registry information, i.e. -host -hpath -gpath. For the following examples, let's suppose your machine name is "myserver" with the directory "/tmp" exported.

mkstg example:



% cleartool mkstg -vob -host myserver -hpath /tmp/mystgloc -gpath /net/myserver/tmp/mystgloc mystgloc /tmp/mystgloc
Advertised existing Server Storage Location.
Host-local path: myserver:/tmp/mystgloc
Global path: /net/myserver/tmp/mystgloc

For more information about the mkstg command, consult the ClearCase manual:


% cleartool man mkstg




mkview example:

% cleartool mkview -tag myview -host myserver -hpath /tmp/myview.vws -gpath /net/myserver/tmp/myview.vws /tmp/myview.vws

For more information about the mkview command, consult the ClearCase manual:


% cleartool man mkview




mkvob example:

% cleartool mkvob -tag /tmp/myvob -host myserver -hpath /tmp/myvob.vbs -gpath /net/myserver/tmp/myvob.vbs /tmp/myvob.vbs

For more information about the mkvob command, consult the ClearCase manual:


% cleartool man mkvob


[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Cleartool","Platform":[{"code":"PF016","label":"Linux"}],"Version":"8.0.1.5;8.0.1.6;8.0.1.7;8.0.1.8","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21683161