Setup




Home

Presentations

Documentation


Download

Setup

Contact - Troubleshooting













Using the Vanilla distribution

The vanilla distribution is just a tarball containing a snapshot of a CVS tag considered stable.
The first step to perform, hence, is to untar it in some user's directory. A subdirectory xrootd/ will be created and filled with the source code.

After this step, we need to configure, compile, and eventually install (see below) the software.
Here you have to choose which build kind you prefer, i.e. the "classic" build or the "autotools" build.

Classic build

In the xrootd subdirectory, just run

./configure.classic --help

to see a list of the configuration options. Typically no special options are required, hence you can just run

./configure.classic

and then

make

After the compilation has finished, your server is ready to start using the start/stop scripts in xrootd/etc
The default configuration, however, is minimalistic, and you typically need to put your configuration files.

Autotools build

In the xrootd subdirectory, just run

./bootstrap.sh

Then, you can use

./configure --help

to see a list of the configuration options. Typically no special options are required, hence you can just run

./configure
make

If you run

make install

The software will be installed in the prefix directory specified during the configure step.
The setup is finished, however, this kind of build is supposed to be customised and tailored to your specific situation.
A very good example of integration of the Autotools build in a more generic structure is given by xrd-installer, discussed below.

Installing a server with xrd-installer

This kind of setup is intended for end users wishing to set a server up in a more encapsulated way. The basic
idea is that all what is needed to do is just to launch a setup script with some options, and the download, compilation, installation and setup steps are
performed in an automatic way for all the packages which compose the setup. The Scalla/XrootD package, in this case, is just one item in the list.

This kind of setup is particularily effective when setting up clusters which have to interact, belonging to a common global namespace. In this case,
all the difficulties and technicalities are hidden by the automatic configuration scripts.

xrd-installer syntax

xrd-installer [--install] [-h] [-l] [n] [-p packagename] [--prefix install-prefix] [--version version] [--compiledir compile-directory] [--noclean]


where the meaning of the switches is:

-l : list packages
-p name : select package
-n : don't install autotools
--noclean : don't cleanup the compilation directory
--install : install all packages or the selected packages with -p option
--prefix : set the installation prefix (default /home/alientest/xrdserver)
--version : select the version to install (default is PRO)
--compiledir

The list of the versions to install will grow, in order to keep track of the various possible flavors. Right now, the default value of 'PRO' refers to a plain Xrootd installation,
with the security libraries embedded. The aim is to give here an exhaustive list of the distribution flavors usable to set up an xrootd storage.
Alice system administrators should refer to the Alien site for setting up an Xrootd SE.




27 May 2010
Published the version 1.8 of the xrd-installer bundle
Major fix release in the base package v20100510-1509 (see the changelog for details)
Most relevant: better fault tolerance, introduction of the ftsofs plugin, fix for the proliferation of ApMon processes

19 January 2010
Published the version 1.7 of the xrd-installer bundle
Major fix release in the base package v20100115.1117 (see the changelog for details)
Most relevant: introduction of the data management functions "query space", "ls" and "recursive ls"
If the Monalisa monitoring is enabled, the space and version parameters are automatically sent
Several refinements of the Virtual Mass Storage System behavior

19 March 2009
Published the version vmss-1.5b of the xrd-installer bundle
Various improvements on the client and server side, dealing with very high load.
Now the startup scripts check also
for the existence of a sufficient number of file descriptors in the machine.

14 July 2009
Published the version 1.6b of the xrd-installer bundle
Various improvements on the client and server side, also dealing with the correctness
of the vMSS choices in complicated circumstances.



Last update: 05-May-2008 - Fabrizio Furano
Document made with Nvu