Date Created: Wed 22-Sep-2010

Related Document Categories:

Get my WebSphere Application Server course here >> http://www.themiddlewareshop.com/products/



Error in MVFS during ClearCase installation on RHEL5

This document is part of a complete set-up of installing and configuring a Windows interop environment with Linux on RHEL 5. There is not another set of detailed documents anywhere on the internet out side of our site. If this article does not contain enough information, search the rest of my site and you will find many mini articles on Linux and Windows interop and MVFS/Samba support. Also feel free to browse https://webspheretools.com if you require ClearCase consulting and support.

It is recommended that you read through this entire article before you start the solution so you can understand what we are doing.

Problem as reported by the installer:

>> Executing main customizations for component CC_client
Updated: /etc/exports.mvfs
Updated: /sbin/mount.mvfs
Building mvfs module in /var/adm/rational/clearcase/mvfs using exported
kernel symbols from /lib/modules/2.6.18-8.el5/build
(this may take a while).
WARNING: The following command was executed, but returned an error:

cd /var/adm/rational/clearcase/mvfs/mvfs_src && /usr/bin/make cleano all install >/var/tmp/ATRIA.run_cmd_output 2>&1

The following is the command output:
----
rm -rf *.o *.kobj *.obj *.ko *.mod.? .*.cmd .tmp_versions
/usr/bin/make -C /lib/modules/2.6.18-8.el5/build SUBDIRS=`pwd`
make[1]: Entering directory `/usr/src/kernels/2.6.18-8.el5-i686'
LD /var/adm/rational/clearcase/mvfs/mvfs_src/built-in.o
CC [M] /var/adm/rational/clearcase/mvfs/mvfs_src/mvfs_vfsops.o
In file included from /var/adm/rational/clearcase/mvfs/mvfs_src/vnode_linux.h:23,
from /var/adm/rational/clearcase/mvfs/mvfs_src/mvfs_mdep_linux.h:69,
from /var/adm/rational/clearcase/mvfs/mvfs_src/mvfs_systm.h:35,
from /var/adm/rational/clearcase/mvfs/mvfs_src/mvfs_vfsops.c:25:
include/linux/config.h:6:2: error: #warning Including config.h is deprecated.
make[2]: *** [/var/adm/rational/clearcase/mvfs/mvfs_src/mvfs_vfsops.o] Error 1
make[1]: *** [_module_/var/adm/rational/clearcase/mvfs/mvfs_src] Error 2
make[1]: Leaving directory `/usr/src/kernels/2.6.18-8.el5-i686'
make: *** [all] Error 2

----
End of command output.

WARNING: Rebuilding of mvfs module with your kernel's symbol exports
failed. You must rebuild the mvfs module by hand in directory
"/var/adm/rational/clearcase/mvfs" (see README.txt in that directory)
and run 'make install'.
MVFS viewroot handling


===============================

When the installation as finished the following comment is reported:

WARNING:
**** Something went wrong when we tried to start your servers and
**** possibly load the MVFS into your kernel. Please review the above
**** output from the "/opt/rational/clearcase/etc/clearcase" script for information on the problem,
**** then refer to the product Release Notes for details on how to
**** correct the problem.

=================================

Solution:

view the README.txt in the /var/adm/rational/clearcase/mvfs/mvfs_src folder

=================================
Section of the README.txt which we are interested in:

REBUILD INSTRUCTIONS for ClearCase 7.0 on 2.6 series Linux kernels
(SLES9, RHEL4)

After you install ClearCase, boot the kernel you want to use and become
the superuser. Then build the mvfs module for your 2.6 series
Linux kernel as follows:

1) Stop ClearCase

# /opt/rational/clearcase/etc/clearcase stop

2) Verify that you have the required files installed to allow building
kernel modules:

For distribution-supplied kernels, check that you have loaded the
proper packages:

# rpm -q -f /lib/modules/`uname -r`/build/Makefile
RESULT: kernel-devel-2.6.18-8.el5
# rpm -q -f /lib/modules/`uname -r`/build/Module.symvers
RESULT: kernel-devel-2.6.18-8.el5

The standard kernels provide packages with names of the form
kernel-devel-* on RedHat and kernel-source-* and kernel-syms-*,
respectively, on SUSE.

If you have rebuilt the kernel yourself, the standard kernel build
and install tools should have set up the correct environment
(including the symbolic link) for rebuilding the mvfs module.

3) Change directory to the MVFS build directory:

# cd /var/adm/rational/clearcase/mvfs/mvfs_src

4) Build and install the mvfs module by doing the following:

4a) Clean up from previous builds:

# make clean

RESULT:

rm -rf *.o *.kobj *.obj *.ko *.mod.? .*.cmd .tmp_versions
rm -f mvfs_param.mk.config

4b) Set options for the current running kernel, choose the linux source
directory (the default should be correct):

# make mvfs_param.mk.config

RESULT:
[root@localhost mvfs_src]# make mvfs_param.mk.config
Makefile:75: mvfs_param.mk.config: No such file or directory
cd . && /opt/rational/clearcase/install/kernel_guess
WARNING: Unable to find prebuilt mvfs module for Distribution: RedHat
Release: 4 Kernel: 2.6.18-8.el5
You will need to rebuild your mvfs module.

Enter path to your toplevel kernel source directory.
Default is [/lib/modules/2.6.18-8.el5/build]:

User specified:Linux source directory: /lib/modules/2.6.18-8.el5/build

make: `mvfs_param.mk.config' is up to date.

4c) If the previous step fails, create the mvfs_param.mk.config file
manually. Set the following values in the file:

CONFIG_MVFS=m
RATL_EXTRAFLAGS := <appropriate value>
LINUX_KERNEL_DIR=<root of kernel source tree>

RATL_EXTRAFLAGS is needed to distinguish between certain variants of
kernel sources that cannot be differentiated based solely on the
3-part kernel version (for example, 2.6.9).

To see which flags might be needed for your kernel, look at the
RATL_EXTRAFLAGS array in /opt/rational/clearcase/install/Kernel.pl.
Set your RATL_EXTRAFLAGS variable appropriately.

4d) Build and install the modules:

# make

RESULT:

[root@localhost mvfs_src]# make
make -C /lib/modules/2.6.18-8.el5/build SUBDIRS=`pwd`
make[1]: Entering directory `/usr/src/kernels/2.6.18-8.el5-i686'
LD /var/adm/rational/clearcase/mvfs/mvfs_src/built-in.o
CC [M] /var/adm/rational/clearcase/mvfs/mvfs_src/mvfs_vfsops.o
In file included from /var/adm/rational/clearcase/mvfs/mvfs_src/vnode_linux.h:23,
from /var/adm/rational/clearcase/mvfs/mvfs_src/mvfs_mdep_linux.h:69,
from /var/adm/rational/clearcase/mvfs/mvfs_src/mvfs_systm.h:35,
from /var/adm/rational/clearcase/mvfs/mvfs_src/mvfs_vfsops.c:25:
include/linux/config.h:6:2: error: #warning Including config.h is deprecated.
make[2]: *** [/var/adm/rational/clearcase/mvfs/mvfs_src/mvfs_vfsops.o] Error 1
make[1]: *** [_module_/var/adm/rational/clearcase/mvfs/mvfs_src] Error 2
make[1]: Leaving directory `/usr/src/kernels/2.6.18-8.el5-i686'
make: *** [all] Error 2

REASON:

By reading the documentation below,

http://www-01.ibm.com/support/docview.wss?rs=984&uid=swg24016718
http://www-01.ibm.com/support/docview.wss?uid=swg24022039

RHEL5 has problems,

=============================================================

One the patch was applied (using instruction from another article on this website...search for it)
The result was still the same.

The link helped me see that others had this problem too.
https://www.ibm.com/developerworks/forums/thread.jspa?messageID=14173193#

So I then tried to apply the 7.0.1.5 patch.
http://www-01.ibm.com/support/docview.wss?rs=984&uid=swg24023087

What you do after applying the patch to the release area (your installation set), is to de-install the CC 7.0.1.x install, then re-install again now the patch is in place. The next time you install you make sure you set build MVFS as part of the install and it will now work.
You can then skip the following MFVS steps, they are only for reference.


==============================================================

/usr/src/kernels/2.6.18-8.el5-i686

# make install

You should not see any errors like the following:

Makefile:438: .config: No such file or directory

Such errors mean that the LINUX_KERNEL_DIR argument you specified
was not a properly configured kernel build directory. You must
either have the correct packages installed for the kernel you are
running, or you must use the standard kernel build and install tools
to rebuild the kernel.

If a module compilation fails with errors about undefined functions
or structure members, the script may have guessed the wrong kernel
variant. Look for code that is conditional on RATL_REDHAT,
RATL_SUSE, RATL_VENDOR_VER, or RATL_EXTRA_VER, and check to see
which settings turn on code that is compatible with your kernel.
Then edit mvfs_param.mk.config to set these flags in
RATL_EXTRAFLAGS, and rebuild the modules as follows:

# make cleano
# make
# make install

5) Restart ClearCase:

# /opt/rational/clearcase/etc/clearcase start

Possible errors:

If you get a failure when loading a module about mismatched version
magic strings, you may need to rebuild the module with a compiler
version that matches your kernel's compiler.

Possible warnings:

If you get warnings when loading the modules about mismatched kernel
versions or about loading GCC-2 compiled modules in a GCC-3 kernel,
you can safely ignore them if the modules load successfully.

Get my WebSphere Application Server course here >> http://www.themiddlewareshop.com/products/


Steve Robinson - IBM Champion 2013

About Me

Steve Robinson has been working in IT for over 20 years and has provided solutions for many large-enterprise corporate companies across the world. Steve specialises in Java and Middleware.

In January 2013, I was awarded the prestigous 'IBM Champion' accolade.


  • Linked In
  • Twitter
  • About Me
  • My Blog
  • Contact Me

Read my books?

IBM WebSphere Application Server 8.0 Administration Guide

IBM WebSphere Application Server 8.0 Administration Guide

WebSphere Application Server 7.0 Administration Guide

WebSphere Application Server 7.0 Administration Guide

WebSphere Categories

Other Categories