VOMS Software

How to get VOMS

VOMS is part of gLite, the software distribution of the EGEE project and can be downloaded here.

gLite CVS access

The VOMS source code can be checked out through anonymous access with the following command:

cvs -d:pserver:anonymous@jra1mw.cvs.cern.ch:/cvs/jra1mw co org.glite.security.voms

Development Subversion access

The VOMS source code can be checked out through anonymous access with the following command:

svn co https://svn.forge.cnaf.infn.it/svn/voms/voms/branches/voms-1-7-series

Requirements

Hardware requirements

VOMS has been tested and is known to work under the following hardware/OS combinations:

i386/Linux (all versions) ia64/Linux (all versions) i386/BSD */SunOS */Solaris */AIX

Please note that we do not have the resources to actually test our software on all these hardware/OS combination, so some of this come from reports we received from other people. If you should find the case that this is not true, please do not hesitate in contacting us.

Software requirements

The following packages are required to build VOMS:

Globus toolkit version 2.2 or later. expat 1.95.6 or later. either MySQL libraries version 4 or later, or Oracle libraries version 9 or later.

To run the services, the requirements are the same with the addition of access to a running instance of the database.

Build and install

More informations can be found in the documentations distributed with the software.

To compile the software, follow this instructions:

cd org.glite.security.voms
./configure --prefix=/your/prefix
make
make install
cd ..

cd org.glite.security.voms-oracle
./configure --prefix=/your/prefix
make
make install
cd ..

Please note that with some releases of the oracle libraries you need to add the --with-oracl-incdir= and --with-oracle-libdir= to this latest call to configure.

Configure and run

More informations can be found in the documentations distributed with the software.

To configure the software, you must have properly installed it by executing the above instructions, and then you must execute the script /your/prefix/libexec/voms_install_db with the following syntax

voms-install-db --voms <voname>  --dbtype=<dbtype> --dbpwd=<db pwd> --dbuser=<user> --port=<port>

is the name of your VO. is either mysql or oracle. is the password needed to access the db. is the db account associated to the above password. is the port number where the new server will listen.

This procedure may be repeated any number of times if you want to install several servers for several VOs. Just remember to change the and fields.

voms-install-db allows other parameters to be specified. See the distributed man pages for details.

Finally to run the server, use /your/prefix/etc/init.d/voms start . If is omitted, then all VOs will be started.

Similarly /your/prefix/etc/init.d/voms stop will stop the VO server.

-- AndreaCeccanti - 29 May 2006