About clearmake and port assignments in environments using both IPv4 and IPv6

Technote (FAQ)


Question

How does IBM Rational ClearCase clearmake handle port assignments in environments using both Internet Protocol version 4 (IPv4) and IPv6?

Cause

As of ClearCase 7.1.1.5, clearmake uses the same port for IPv4 and IPv6.

Previous versions of ClearCase that support both IPv4 and IPv6 will use different ports for each family.


Answer

By setting the ClearCase environment variable TRACE_VERBOSITY to the value 4, you can identify the ports used for Clearmake. Refer to technote 1149150: Tracing IBM Rational ClearCase build tools for information about tracing ClearCase build tools.


Here is a build output example displaying the ports being used by clearmake:

Successfully allocated socket.

Socket info: family = AF_INET6, fd = 568, port = 49260, protocol = TCP.

Successfully allocated socket.

Socket info: family = AF_INET, fd = 548, port = 49260, protocol = TCP.

Note: AF_INET6 is IPv6 and AF_INET is IPv4

If both IPv4 and IPv6 are enabled on a build machine, and parallel builds are attempted, the builds may not complete successfully with the following errors:

(build_machine) vob % clearmake -J 6
clearmake: Warning: abe(1, pid=13050, "build_machine") failed to startup in the time allotted.
(The current timeout is 30 seconds; use the variable CCASE_ABE_START_TIMEOUT to change this.)
Targets scheduled to use this abe will be reassigned.
clearmake: Warning: abe(2, pid=13051, "build_machine") failed to startup in the time allotted.
(The current timeout is 30 seconds; use the variable CCASE_ABE_START_TIMEOUT to change this.)
Targets scheduled to use this abe will be reassigned.

This problem can be resolved by setting the Environment Variable on the build clients.

CCASE_IP_VERSION=4


This variable will tell clearmake to always use IPv4 for communication.

This is the same situation as documented in technote 1446079: Clearmake parallel builds fail on Windows reporting abe warnings: failed to startup in the time allotted for Windows.


Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational ClearCase
Clearmake - Clearaudit - Omake

Software version:

7.1.1.5, 7.1.1.6, 7.1.1.7, 7.1.1.8, 7.1.1.9, 7.1.2.2, 7.1.2.3, 7.1.2.4, 7.1.2.5, 7.1.2.6, 7.1.2.7, 7.1.2.8, 7.1.2.9, 7.1.2.10

Operating system(s):

AIX, HP-UX, Linux, Solaris, Windows

Reference #:

1460866

Modified date:

2013-03-27

Translate my page

Machine Translation

Content navigation