IBM Support

ClearCase GUIs fail on Linux and Solaris operating system

Technote (troubleshooting)


Problem(Abstract)

Attempts to use IBM Rational ClearCase GUIs on 32 and 64 bit Linux and Solaris operating systems results in a failure to launch the graphical user interfaces (GUIs).

Symptom

The following symptoms may be observed:

  • Opening ClearCase Project Explorer results in the following error:


    clearprojexp: error while loading shared libraries: libMrm.so.3: cannot open shared object file: No such file or directory


  • Running xclearcase on RHEL results in the following error:

    /opt/rational/clearcase/bin/xclearcase: error while loading shared libraries: libMrm.so.3: cannot open shared object file: No such file or directory


  • Running cleartool diff -g on Solaris results in the following error:


    ./ld.so.1: /opt/rational/clearcase/lib/mgrs/directory/xcompare: fatal:
    relocation error: file /opt/rational/clearcase/sun5/shlib/libatriafxds.
    so: symbol __1c2n6FIpv_0_: referenced symbol not found
    bash: ./ld.so.1:: No such file or directory
    bash-2.05b$ cleartool: Error: Child process aborted with signal 9
    bash: cleartool:: command not found
    bash-2.05b$ cleartool: Error: Unable to invoke operation "xcompare" for manager "directory": -1
    bash: cleartool:: command not found
    bash-2.05b$ cleartool: Error: (Operation pathname was:
    "/opt/rational/clearcase/lib/mgrs/directory/xcompare")

  • Starting xclearcase results in the following error:


    Warning: locale not supported by Xlib, locale set to C
    Warning: X locale modifiers not supported, using default
    Warning: Cannot convert string "-*-*-medium-r-normal--14-*-*-*-*-*-gbk-*" to type FontSet
    Warning: Unable to load any usable fontset
    Warning:
    Name: FONTLIST_DEFAULT_TAG_STRING
    Class: XmRendition
    Conversion failed. Cannot load font.

    Warning:Cannot convert string "-*-fixed-medium-r-normal--14-*-*-*-*-*-big5-*" to type FontSet
    Warning:Unable to load any usable fontset
    Warning:
    Name: FONTLIST_DEFAULT_TAG_STRING
    Class: XmRendition
    Conversion failed. Cannot load font.
    ...

  • Opening any xclearcase GUI interface in RHEL5 results in the following error:


    [vob]# /usr/atria/bin/xclearcase
    /usr/atria/bin/xclearcase: error while loading shared libraries: libMrm.so.3: cannot open shared object file: No such file or directory

For SLES 11 on s390x and PPC, we recently discovered that the openmotif libraries are not in the regular distributions, but they are in the "extras" kit.

For example, something like this:
suse/catalogs/ SLES11-Extras/sle-11-s390x/rpm/s390x/openmotif22-libs-32bit-2.2.4-139.1.s390x.rpm

suse/catalogs/SLES11-Extras/sle-11-ppc64/rpm/ppc64/openmotif22-libs-2.2.4-139.1.ppc64.rpm 


For x86, SLED 11 has the libraries in the regular distribution, but SLES 11 has them in the extras kit.


Cause

This problem occurs because you do not have the 32-bit lib x11 libraries installed, only the 64-bit libraries are installed. The ClearCase GUIs run in 32-bit mode and, therefore, require the 32-bit libraries.


Note: ClearCase 7.x and 8.0 require the 32 bit libraries of Open Motif package on 64bit Linux hosts.


Diagnosing the problem

SOLARIS


On Solaris, you can verify that all necessary GUI libraries are installed by running ldd against the xclearcase executable.

    Example:

    # ldd /usr/atria/bin/xclearcase
    libatriamotif.so =>      /opt/rational/clearcase/sun5/shlib/libatriamotif.so
    libatriaui.so =>         /opt/rational/clearcase/sun5/shlib/libatriaui.so
    libMrm.so.4 =>   /usr/lib/libMrm.so.4
    libXm.so.4 =>    /usr/lib/libXm.so.4
    libXt.so.4 =>    /usr/openwin/lib/libXt.so.4
    libSM.so.6 =>    /usr/openwin/lib/libSM.so.6
    libICE.so.6 =>   /usr/openwin/lib/libICE.so.6
    libXp.so.1 =>    /usr/openwin/lib/libXp.so.1
    libXext.so.0 =>  /usr/openwin/lib/libXext.so.0
    libX11.so.4 =>   /usr/openwin/lib/libX11.so.4

LINUX

On Linux verify that all necessary GUI libraries are installed by running ldd against the xclearcase executable.

[vob]# ldd /usr/atria/bin/xclearcase
        linux-gate.so.1 =>  (0x006db000)
        libatriami.so => /opt/rational/clearcase/shlib/libatriami.so (0x00db3000)
        libatriaabl.so => /opt/rational/clearcase/shlib/libatriaabl.so (0x00448000)
        libatriamotif.so => /opt/rational/clearcase/shlib/libatriamotif.so (0x00b19000)
        libatriaui.so => /opt/rational/clearcase/shlib/libatriaui.so (0x00cff000)
        libatriauc.so => /opt/rational/clearcase/shlib/libatriauc.so (0x007ef000)
        libatriauo.so => /opt/rational/clearcase/shlib/libatriauo.so (0x004eb000)
        libatriagutl.so => /opt/rational/clearcase/shlib/libatriagutl.so (0x00ad3000)
        libatriagu.so => /opt/rational/clearcase/shlib/libatriagu.so (0x001f7000)
        libatriacmdsyn.so => /opt/rational/clearcase/shlib/libatriacmdsyn.so (0x00110000)
        libatriacmd.so => /opt/rational/clearcase/shlib/libatriacmd.so (0x00e3a000)
        libatriamsadm.so => /opt/rational/clearcase/shlib/libatriamsadm.so (0x00a08000)
        libatriamsinfobase.so => /opt/rational/clearcase/shlib/libatriamsinfobase.so (0x009b2000)
        libatriasumcmd.so => /opt/rational/clearcase/shlib/libatriasumcmd.so (0x00176000)
        libatriasum.so => /opt/rational/clearcase/shlib/libatriasum.so (0x00f7c000)
        libatriasquidad.so => /opt/rational/clearcase/shlib/libatriasquidad.so (0x00260000)
        libatriasquidcore.so => /opt/rational/clearcase/shlib/libatriasquidcore.so (0x002ad000)
        libatriaadm.so => /opt/rational/clearcase/shlib/libatriaadm.so (0x001fb000)
        libatriasplit.so => /opt/rational/clearcase/shlib/libatriasplit.so (0x00e08000)
        libatriamntrpc.so => /opt/rational/clearcase/shlib/libatriamntrpc.so (0x00a9d000)
        libatriavob.so => /opt/rational/clearcase/shlib/libatriavob.so (0x072e0000)
        libatriaview.so => /opt/rational/clearcase/shlib/libatriaview.so (0x00319000)
        libatriaccfs.so => /opt/rational/clearcase/shlib/libatriaccfs.so (0x001ca000)
        libatriacm.so => /opt/rational/clearcase/shlib/libatriacm.so (0x00513000)
        libatriadbrpc.so => /opt/rational/clearcase/shlib/libatriadbrpc.so (0x00d56000)
        libatriaXbae.so => /opt/rational/clearcase/shlib/libatriaXbae.so (0x00b76000)
        libatriaclient_meters.so => /opt/rational/clearcase/shlib/libatriaclient_meters.so (0x00d28000)
        libMrm.so.3 => not found
        libXm.so.3 => not found
        libXt.so.6 => /usr/lib/libXt.so.6 (0x00c81000)
        libSM.so.6 => /usr/lib/libSM.so.6 (0x001d7000)
        libICE.so.6 => /usr/lib/libICE.so.6 (0x00c34000)
        libXp.so.6 => /usr/lib/libXp.so.6 (0x0095a000)
        libXext.so.6 => /usr/lib/libXext.so.6 (0x00bf9000)
        libX11.so.6 => /usr/lib/libX11.so.6 (0x00581000)
        libm.so.6 => /lib/libm.so.6 (0x003a7000)
        libatriaxdr.so => /opt/rational/clearcase/shlib/libatriaxdr.so (0x006dc000)
        libatriacredmap.so => /opt/rational/clearcase/shlib/libatriacredmap.so (0x001e0000)
        libatriatbs.so => /opt/rational/clearcase/shlib/libatriatbs.so (0x0036e000)
        libatriaks.so => /opt/rational/clearcase/shlib/libatriaks.so (0x00878000)
        libatriamvfs.so => /opt/rational/clearcase/shlib/libatriamvfs.so (0x001ef000)
        libezrpc.so => /opt/rational/clearcase/shlib/libezrpc.so (0x00bd3000)
        libncurses.so.5 => /usr/lib/libncurses.so.5 (0x06dbe000)
        libcrypt.so.1 => /lib/libcrypt.so.1 (0x06d8e000)
        libnsl.so.1 => /lib/libnsl.so.1 (0x0022a000)
        libdl.so.2 => /lib/libdl.so.2 (0x003a1000)
        libstdc++.so.5 => /usr/lib/libstdc++.so.5 (0x02d12000)
        libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00c0b000)
        libc.so.6 => /lib/libc.so.6 (0x066da000)
        libXau.so.6 => /usr/lib/libXau.so.6 (0x0050a000)
        libXdmcp.so.6 => /usr/lib/libXdmcp.so.6 (0x00398000)
        /lib/ld-linux.so.2 (0x00245000)
    You can also list which GUI libraries are missing by running ldd against the xclearcase executable as follows:

    Example:
    [vob]# ldd /usr/atria/bin/xclearcase | grep not # note that this will display libraries file that are required but are not available.
            libMrm.so.3 => not found
            libXm.so.3 => not found

Resolving the problem

LINUX

  • For ClearCase 7.x, OpenMotif 2.2 is required.
    • RHEL3 and RHEL4:

      Verify if 32-bit library files are installed on the client system.

      If missing, install the proper 32-bit libraries (such as openmotif-2.2.3-5.RHEL3.2 or later) in order to use the ClearCase GUIs.
    • RHEL 5 and 6 and SUSE 10 and 11:

      Install OpenMotif package:

      rpm -i openmotif22-2.2.3-18.i386.rpm
    • Novell SUSE SLES or SLED 10

      SUSE 10 ships with open motif 2.2. Although ClearCase 8.x is specifying 2.3 libraries, it is able to function
      if the following links are added.

      #cd /opt/rational/clearcase/shlib
      #ln -s /usr/X11R6/lib/libMrm.so.3 libMrm.so.4    
      #ln -s /usr/X11R6/lib/libXm.so.3 libXm.so.4  

    • Novell SUSE SLES 11 SUSE 11 ships with Open Motif 2.3.
  • For ClearCase 8.0.0.x, OpenMotif 2.3 is required. Contact your Linux vendor to obtain the package.
  • For ClearCase 8.0.1, OpenMotif 2.3 is required.
  • Linux/s390x and Linux/ppc use OpenMotif 2.2 on 8.0.0.x and 8.0.1.x

  • Install the 32-bit OpenMotif package provided by the Linux vendor.

  • For SLES 11 on s390x and PPC, we recently discovered that the openmotif libraries are not in the regular distributions, but they are in the "extras" kit. For example, something like this:

    suse/catalogs/SLES11-Extras/sle-11-s390x/rpm/s390x/openmotif22-libs-32bit-2.2.4-139.1.s390x.rpm
    suse/catalogs/SLES11-Extras/sle-11-ppc64/rpm/ppc64/openmotif22-libs-2.2.4-139.1.ppc64.rpm

  • For x86, SLED 11 has the libraries in the regular distribution, but SLES 11 has them in the extras kit.



SOLARIS

Open a command prompt in /usr/lib directory and search for library files.

Example:

%>pwd
/usr/lib

%>file /usr/lib/*X11*

/usr/lib/libX11.so:     ELF 32-bit MSB dynamic lib SPARC Version 1, dynamically linked, not stripped, no debugging information available

/usr/lib/libX11.so.4:   ELF 32-bit MSB dynamic lib SPARC Version 1, dynamically linked, not stripped, no debugging information available

/usr/lib/libX11.so.5:   ELF 32-bit MSB dynamic lib SPARC Version 1, dynamically linked, not stripped, no debugging information available

These libraries are installed by default on Solaris. If these libraries are missing, the system administrator must reinstall them.

Use the ldd command to examine the libraries that clearprojexp is trying to load.


root> ldd /usr/atria/bin/clearprojexp


If the libraries are missing, the system administrator must reinstall them.



UBUNTU 10.04

If you are trying to do this on 32 or 64 bit UBUNTU (or anything else debian-based) the above instructions will not work.

For 32-bit systems:
" apt-get install libmotif3" should install the 32-bit libraries...



For 64 bit systems:
"apt-get install libmotif3" will install the 64-bit libraries, which will not work.


You need to do the following:

  1. Log in as root
  2. Run wget http://hr.archive.ubuntu.com/ubuntu/pool/multiverse/o/openmotif/libmotif3_2.2.3-4_i386.deb
  3. Run dpkg -x ./libmotif3_2.2.3-4_i386.deb .
  4. cd into /usr/lib
  5. Run "mv lib* /usr/lib32"

Disclaimer

Any wiki or blog references in this document are being provided for reference purposes only and any opinions posted are provided by the individual authors and do not represent the positions or policies of IBM. IBM is not providing services of any kind for the information provided therein and provides no warranty of any kind. IBM WILL NOT BE LIABLE FOR ANY ACTUAL, DIRECT, SPECIAL, INCIDENTAL, OR INDIRECT DAMAGES, OR FOR ANY ECONOMIC CONSEQUENTIAL DAMAGES (INCLUDING LOST PROFITS OR SAVINGS), EVEN IF IBM, OR ITS RESELLER, HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.



Reference: http://forums.citrix.com/thread.jspa?threadID=245645&tstart=0


Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational ClearCase GUI: xclearcase

Document information

More support for: Rational ClearCase
GUI

Software version: 7.1, 7.1.1, 7.1.2, 8.0, 8.0.1

Operating system(s): Linux, Solaris

Reference #: 1247644

Modified date: 08 February 2016