IBM Support

MVFS not loading after kernel upgrade or is missing after installation on Linux

Troubleshooting


Problem

This technote explains how to resolve an issue that can occur when using IBM Rational ClearCase where the Multi-version File System (MVFS) is missing after an installation or it fails to load after a kernel upgrade.

Symptom

Possible Symptoms:

  1. MVFS is not installed after the installation.
  2. After a Kernel upgrade the MVFS will not load.

Cause


For Symptom 1

The path /lib/modules/<current-kernel>/build may not exist.
The required packages (to compiling) are not installed.


For Symptom 2

Since the previous MVFS module was compiled for the old Kernel, there is no MVFS for the new Kernel.

Environment

Linux machines with ClearCase 7.1.1.x or 7.1.2.x

Diagnosing The Problem

The commands below will not return successful:

lsmod | grep mvfs

modprobe -l mvfs

ls /lib/modules/`uname -r`/kernel/fs/mvfs/mvfs.ko

Resolving The Problem

Manually compile the MVFS module.

  1. Be sure the required packages to compiling software are installed:

    kernel-devel-<current-kernel>
    kernel-headers-<current-kernel>
    gcc
    make  


    Note: If your machine is a 64-bit, you must install 32-bit compat libraries as well.
  2. After all dependencies are resolved follow the steps below:
    1. cd /var/adm/rational/clearcase/mvfs/mvfs_src
    2. Optional - Since "make" command on item 3 will recreate the mvfs_param.mk.config file.

      Change the file mvfs_param.mk.config to fit your case

      RATL_EXTRAFLAGS := -DRATL_REDHAT -DRATL_VENDOR_VER=500  
      -DRATL_EXTRA_VER=0 -DRATL_COMPAT32  
      LINUX_KERNEL_DIR=/lib/modules/<current-kernel>/build
      CONFIG_MVFS=m


      Note: Change <current-kernel> to your current Kernel.
  3. Then stop ClearCase and run:

    make clean
    make
    make install


  4. Finally start ClearCase.           

Reference: /var/adm/rational/clearcase/mvfs/mvfs_src/README.txt

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"MVFS","Platform":[{"code":"PF016","label":"Linux"}],"Version":"9.0;8.0.1;8.0;7.1.2;7.1.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21577253