IBM Support

Unable to create or use automatic views with the CCRC installation on Linux for ClearTeam Explorer, rcleartool, and CM API applications

Troubleshooting


Problem

The mvfs_agent executable, which resides in the ClearCase installation directory, is expected to be accessible via the user's PATH environment variable. However, that directory is not added to the PATH on Linux.

Symptom

  • The Automatic View option is unavailable in the Create View dialog.
  • The same issue occurs in the Join Project wizard.

  • Creating or starting automatic views with rcleartool or a custom CM API application fails.

 

Cause

The mvfs_agent executable is located inside the IBM Rational ClearCase installation directory (typically /opt/rational/clearcase/bin).

However, the ClearCase binary path is not included in the system PATH environment variable. As a result, the system cannot locate the command when the application tries to execute mvfs_agent.

Resolving The Problem

The environment variable PATH must be provided before launching the application.
Example: Run the command in a Bourne shell or terminal, and launch the application from the same session.

export PATH=$PATH:/opt/rational/clearcase/bin

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSX33QT","label":"IBM DevOps Code ClearCase"},"ARM Category":[{"code":"a8m50000000L0i5AAC","label":"ClearCase"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"}],"Version":"and future releases;11.0.0"},{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSSH27","label":"IBM Rational ClearCase"},"ARM Category":[{"code":"a8m50000000L0i5AAC","label":"ClearCase"}],"Platform":[{"code":"PF016","label":"Linux"}],"Version":"and future releases;10.0.1"}]

Document Information

Modified date:
10 March 2026

UID

ibm17263062

Page Feedback