Install from RPM packages

We describe here two ways of installing ELFI:

Using apt-get

This is the easiest method; it should work on any Scientific Linux CERN 3.0.x box, but might work on any other Linux distribution which uses the APT4RPM tools.

Manual install RPMs

These are generic installation instructions that should work on any RPM-based distribution.

Recompiling the FUSE kernel module

This section will tell you how to compile and install the FUSE kernel module, in case you cannot find a precompiled package that matches your running kernel.

1. cd to the directory at the top of the the RPM packages build hierarchy. This is directory /usr/src/redhat on Scientific Linux CERN 3.0.x ; but you can use any other directory, by following the directions at http://dag.wieers.com/howto/bits/rpm-build-user.php

   # you will need to be ``root`` to compile here
   cd /usr/src/redhat
   

2. Download the source RPM from the EGRID RPM repository

   The following commands (you may need root privileges) will download the fuse-*.src.rpm file in the current directory:

   # add the EGRID RPM repository to system pkg list
   echo 'rpm http://www.egrid.it/download/rpm . egrid' \
                  > /etc/apt-sources.list.d/egrid.list
   
   # update package availability list
   apt-get update
   
   # download the source RPM package
   apt-get source fuse
   

3. Rebuild the binary package:

   rpmbuild --rebuild -bb fuse*.src.rpm
   

   The command above will put the binary RPM package in /usr/src/redhat/RPMS/fuse*.rpm.

   Note

   Note:

   If your running kernel sources are not located under /usr/src/, then you will need to pass the location to the rpmbuild command as follows:

   rpmbuild --define='kernelsrc PATH' --rebuild -bb fuse*.src.rpm
   

4. Install the generated RPM package:

   rpm --nodeps -Uvh /usr/src/RPMS/*/kernel-module-fuse-`uname -r`*.rpm
   

How to build ELFI from source

ELFI can be compiled on a gLite User Interface: You will need to have the commands svn, rpm2cpio, and wget installed.

0. Unfortunately, the ELFI Makefile triggers a bug in GNU make 3.79, which is the make provided in Scientific Linux CERN 3, so you will need to install make-3.80 or later. We used the following on our SLC3 machines:

   rpm -Uvh ftp://rpmfind.net/linux/fedora/core/3/i386/os/Fedora/RPMS/make-3.80-5.i386.rpm
   

1. Download the ELFI source code:

   svn co http://www.egrid.it/srv/svn/products/elfi/current elfi-src
   

   This will check out a copy of the latest sources of ELFI into a directory elfi-src.

2. Install build-time dependencies, step 1. Some packages are already provided from the OS vendor: you should install the following packages with apt-get install (choose the package name according to your distribution):

   SLC3	Debian (etch) [#1]
   libacl-devel libattr-devel glib2-devel openldap-devel fuse [#2]	libacl1-dev libattr1-dev libglib2.0-dev libldap2-dev libfuse-dev

   [3]	You may also compile and use ELFI on Debian sarge (current stable distro), but the FUSE version distributed with sarge is too old: you will need to download and install the FUSE development libraries from another source.

   [4]	Available from the EGRID RPM repository at http://www.egrid.it/download/rpm/RPMS.egrid/

   Thus on Scientific Linux CERN 3 you would use:

   # add the EGRID RPM repository to the APT sources list
   # (for the FUSE package)
   echo 'rpm http://egrid-doc.egrid.it/download/rpm  . egrid' \
        > /etc/apt/sources.list.d/egrid.list
   
   # update package availability
   apt-get update
   
   # on Scientific Linux CERN 3
   apt-get install \
           libacl-devel \
           libattr-devel \
           fuse \
           glib2-devel \
           openldap-devel
   

   Whereas on Debian (etch) you would use the following commands instead:

   # on Debian (etch)
   apt-get install \
           libacl1-dev \
           libattr1-dev \
           libfuse-dev \
           libglib2.0-dev \
           libldap2-dev
   

3. Install other build-time dependencies. The provided Makefile will download the other dependencies for you with the make needed target:

   cd elfi-src/
   make needed
   

4. Compile and install ELFI:

   make -e
   make install
   

   By default, ELFI is installed under the /opt/egrid directory hierarchy; to install in a different location, use:

   make install prefix=/path/to/wanted/location

Configuring ELFI

ELFI needs no configuration files; only the system executable search path (environment variable PATH) and the library search path (environment variable LD_LIBRARY_PATH) need to be adjusted to match the location in which you installed ELFI.

1. The elfi program will look for the helper application elfi-bdii-cache in the system executable search path (environment variable PATH).

   So, to run ELFI you must add to the PATH environment variable the directory containing the elfi-bdii-cache executables, which by default is /opt/egrid/bin. You can do this for just the current session by typing the following command in your shell:

   export PATH=$PATH:/opt/egrid/bin
   

   If you have installed ELFI in a location different from the default one, you will need to replace path /opt/egrid/bin (in the above line) with the directory where you copied the elfi-bdii-cache program.

   To set the executable search path for all users and all sessions, you can run the following commands (as root user):

   # create a file that will be loaded at every login
   echo 'export PATH=$PATH:/opt/egrid/bin' \
     > /etc/profile.d/elfi.sh
   

   (The above recipe will work in RedHat-like distros, for instance in Scientific Linux CERN; if you use ELFI on other systems, you might have to add the "export ..." line to file /etc/profile.)

2. ELFI will look for the libelfi_*.so libraries in the system library search path (environment variable LD_LIBRARY_PATH).

   To set the LD_LIBRARY_PATH environment variable for just the current session, type the following command in your shell:

   export LD_LIBRARY_PATH=/opt/egrid/lib:$LD_LIBRARY_PATH
   

   If you have installed ELFI in a location different from the default one, you will need to replace path /opt/egrid/lib (in the above line) with the directory where you copied the libelfi_*.so libraries.

   To set the library load path for all users and all sessions, you can run the following commands (as root user):

   # add ELFI library dir to system library path
   # (mind the '>>' below!)
   echo /opt/egrid/lib >> /etc/ld.so.conf
   
   # update system library index
   ldconfig
   

Getting support