2.7. Installing the Engine

The EVMS Engine consists of the user-space plug-ins and interfaces as well as a stand-alone library, dlist, that the Engine uses for linked-list management.

2.7.1. Installing from source

  1. To build and install the Engine from source, first type the following command to change to the /usr/src/evms-2.0.0 directory:

    cd /usr/src/evms-2.0.0
  2. Select the appropriate options for your configuration.

    NoteNOTE
     

    A list of options can be found by typing:

    ./configure -h
  3. Configure your engine:

    ./configure [--options]

  4. Type the following commands:

    make
    make install
    ldconfig
    

    Unless you specified other directories when you configured the engine, the following list describes where files will be installed on your system:

    • The core Engine library is installed in /lib.

    • The core dlist library is installed in /lib.

    • All plug-in libraries is installed in /lib/evms.

    • All user interface binaries are installed in /sbin.

    • All header files are installed in /usr/include/evms.

    • All manual pages are installed in /usr/man.

    • Add the Engine library path to your LD_LIBRARY_PATH environment variable, or to your /etc/ld.so.conf file. Do not add the plug-in library path because the Engine dynamically loads these libraries directly.

  5. Examine the EVMS configuration file (evms.conf). This file contains settings to control how EVMS operates. For example, the logging level, the location of the engine log, and the list of disk devices to examine can all be controlled through settings in the configuration file. The sample file is well commented and advises you of appropriate values for each setting.

    The evms.conf file is normally installed in /etc/evms.conf. However, if you already have a configuration file, it is installed as /etc/evms.conf.sample. Examine the new sample to see if your existing file should be updated.

You can now begin using EVMS by typing evmsgui to start the GUI, evmsn to start the Ncurses UI, or evms to start the command line interpreter.

2.7.2. Installing the EVMS Debian packages

Debian packages of EVMS are maintained by Matt Zimmerman at the Debian website. You can download these packages for the Woody (testing) release, or for the Sid (unstable) release.

For the Debian package, patch and recompile your kernel in order to use EVMS. Debian has a packaged version of the EVMS kernel patches that includes instructions for patching and building your kernel.

2.7.3. Installing from CVS

If you would like to use the most recently developed version of EVMS, you can get the code directly from the CVS tree.

  1. To download the code, type the following commands:

    mkdir /usr/src/evms_cvs
    cd /usr/src/evms_cvs
    cvs -d:pserver:[email protected]:/cvsroot/evms login
            (press Enter when prompted for a password)
    cvs -z3 -d:pserver:[email protected]:/cvsroot/evms co engine2
  2. Alternatively, if you already have a copy of the CVS code checked out, you can update to the latest code with the following commands:

    cd /usr/src/evms_cvs/engine2
    cvs update -d -P
  3. The EVMS Engine can be built directly into the CVS tree. To start, change directory to /usr/src/evms_cvs/engine2:

    cd /usr/src/evms_cvs/engine2
    autoconf

    NoteNOTE
     

    The autoconf command is necessary only for code taken directly from CVS.

  4. Select the appropriate options for your configuration.

    NoteNOTE
     

    You can find the list of options by typing:

    ./configure -h

  5. Configure your engine:

    ./configure [--options]
  6. Type the following commands:

    make
    make install
    ldconfig

    Unless you specified other directories in Step 5, the following list describes where files are installed on your system:

    • The core Engine library is installed in /lib.

    • The core dlist library is installed in /lib.

    • All plug-in libraries is installed in /lib/evms.

    • All user interface binaries are installed in /sbin.

    • All header files are installed in /usr/include/evms.

    • All manual pages are installed in /usr/man.

  7. Add the Engine library path to your LD_LIBRARY_PATH environment variable, or to your /etc/ld.so.conf file. Do not add the plug-in library path because the Engine dynamically loads these libraries directly.