IBM Support

About the MAGIC_PATH variable

Question & Answer


Is there documentation that explains how to configure IBM® Rational® ClearCase® to use a single magic file on Windows® Linux® and UNIX®?


Environment Variable

Set the MAGIC_PATH environmental variable on all clients to point to a central shared location.

Review IBM Rational ClearCase Information Center on the topic of cc.magic,default.magic for more information.

Also refer to technote 1122471 About the ClearCase Magic file for additional information.

Note: A reboot of the server (where the magic file is located) and clients is not necessary.

Windows Example:

Set the MAGIC_PATH environmental variable on all clients to point to a UNC location.

Command line:
set MAGIC_PATH=\\machine\share\magic


UNIX/Linux Example:

Set the MAGIC_PATH environmental variable on all clients to point to an exported location.

setenv MAGIC_PATH=/net/host/export

Windows and UNIX/Linux:

In the event there is a network outage or if that share is not available, you may want to have the MAGIC_PATH environmental variable also set to an alternate path and even the default path on the local systems so that ClearCase can still work.

For example:

MAGIC_PATH=<share-path>; <alt-share-path>; <local-path>

A semi-colon separated list of paths is all that is required.

Note: Be aware if modifications have been made to one magic file (global one) on the primary share and that share becomes unavailable, the new definitions in the global magic file will not be available in the other magic files until a version of the global magic file is copied to all necessary hosts.

Refer to technote 1219216 Evaluating multiple magic files for additional information.

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Magic File","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.1;7.1;7.1.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Magic File","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
29 September 2018