Date Created: Wed 22-Sep-2010

Related Document Categories:

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 http://www.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`