Genotrance

Icon

Random thoughts, ideas and experiences

Clearaxis

NOTE: Check out ClearMerge recently written by Michael McTernan. It integrates both diff and merge into ClearCase and is a really small C application. ClearAxis is no longer maintained since I don’t have Araxis Merge or ClearCase on Windows anymore.

Clearaxis is a simple application that integrates the Araxis Merge diff tool into ClearCase. Compare.exe that ships with Araxis works for dynamic views but fails on snapshot views. Clearaxis just converts the command line arguments from ClearCase into something that Compare.exe can use.

How this works is already documented on Araxis.com. Clearaxis only solves the problem of packaging a tool that anybody can easily download and install.

Clearaxis is written in Python. It is packaged using Py2Exe and installed using NSIS.

Download

Installation

The Windows installer copies the executable files, source code and the README to a directory of your choice. It then modifies the ClearCase map file to point to Clearaxis for the file types selected during install.

The installer does not create any start menu shortcuts since Clearaxis is to be invoked within ClearCase.

Clearaxis requires that both ClearCase and Araxis are installed on the system in order to work.

Uninstallation

Clearaxis can be uninstalled from “Add or Remove Programs” in the Control Panel.

License

Clearaxis is being released under the GPL. The source code is included in the installer.

Links

Credits

Feedback

I’ll be happy to hear about your experiences with Clearaxis. If you have any ideas or recommendations, please feel free to send them my way. I also welcome patches. You can contact me at: ganeshjgd AT gmail DOT com.

9 Responses

  1. Andrew Lindsey says:

    Hi mate – does this work with ClearCase Remote Client? I’m trying to get it to work, but with limited (no) success.

    You can reach me at andrew.l…@m….com

    Much appreciated,

    -Andrew.

  2. genotrance says:

    Hello Andrew,
    Clearaxis does not support the ClearCase Remote Client, which is an Eclipse based frontend. Perhaps if there’s sufficient demand, I’ll add support, if it is possible.

    Thanks.

  3. prashanth sharma says:

    Hi,

    I tried to use your utility to do a merge, but Araxis complained saying that the merge source file could not be read.

    Specifically,
    ‘ Failed to open “z:\projectvob\application\radio\-base” for reading or writing. The system cannot find the file specified. (0x80070002)’

    Any idea whats wrong ?

    Thanks,
    Prashanth

  4. genotrance says:

    Hello Prashanth, as of now, Clearaxis only supports diff but not merges.

  5. Andrew says:

    My software project is considering using Araxis Merge in place of ClearCase’s default merge utility. The project involves two separate streams each with their own snapshot views. In one stream (stream A) files have been moved to different locations within the stream’s view (view A) without modifying their content. In the other stream (stream B) the files’ content has been modified but their location remains the same.

    If our project used the merge utility included with ClearCase, when merging stream B to stream A, the merge utility would be aware of the new location in stream A for files common to both streams. It would merge modified files from stream B to their correct location in stream A.

    My question is if we use Araxis Merge, will this same behavior occur? We don’t want to end up with duplicate files, where one file contains updated content at an old location for a file and the location where the file should have ended up being merged to contains old content.

    I hope this is clear and that someone can clarify their experience in this matter.

  6. genotrance says:

    Hello Andrew,
    Clearaxis only supports using Araxis Merge as your diff tool, not for merges. ClearCase merges tend to get complicated, as is your use case, so I end up using its native tool instead of externals that may not understand the full picture.

    If you’d like to get more information on using the merge functionality as well, check out http://blog.swidzinski.com/2005/06/08/integrating-araxis-merge-clearcase.html which provides these details.

    Hope that helps.

  7. Andrew says:

    Thank you for your comment. I appreciate it.

  8. I tried to use your utility with CC7 and Araxis 6.
    Installer did not modify the CC map file for some reason.
    Can you please provide the syntax for the entries that must be made in the map file?

    Thanks,

    -Jonathan

    • genotrance says:

      What is the location of the map file for CC7? Perhaps ClearAxis can’t find it. I can spin a new build to accommodate the new path.

      The lines to change in the map file are:

      text_file_delta xcompare
      _html xcompare
      _html2 xcompare
      _xml xcompare
      _xml2 xcompare

      Change the .EXE paths to the ClearAxis binary.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

Twitter Updates

%d bloggers like this: