src/libuafs/afsload/README

   1 afsload Prerequisites:
   2
   3 - Text::ParseWords
   4 - Number::Format
   5 - Parallel::MPI::Simple (0.03)
   6 - AFS::ukernel
   7
   8 Text::ParseWords
   9 --
  10
  11 This comes with Perl on most systems I've tried. But if it's not on yours,
  12 you can get with from CPAN.
  13
  14 Number::Format
  15 --
  16
  17 This can be obtained from CPAN; nothing special required.
  18
  19 Parallel::MPI::Simple
  20 --
  21
  22 Before you install this, you must have some MPI implementation installed. Note
  23 that you must compile Parallel::MPI::Simple against the same MPI implementation
  24 that you run 'afsload' against.
  25
  26 For OpenMPI, this involves installing the packages openmpi, openmpi-devel, and
  27 openmpi-libs on RHEL5. For Debian Lenny, install openmpi-bin, openmpi-common,
  28 libopenmpi1, libopenmpi-dev, and openmpi-doc if you want it.
  29
  30 Now, Parallel::MPI::Simple itself you can get from CPAN, but the build process
  31 requires some massaging. Download and unpack the source tarball manually, and
  32 build like so.
  33
  34 On RHEL5 with OpenMPI:
  35
  36 $ perl Makefile.PL CCFLAGS=-I/usr/lib64/openmpi/1.4-gcc/include/ LIBS='-L/usr/lib64/openmpi/1.4-gcc/lib -Wl,-R/usr/lib64/openmpi/1.4-gcc/lib -lmpi'
  37
  38 On Debian:
  39
  40 $ perl Makefile.PL CCFLAGS=-I/usr/include/mpi
  41
  42 then just 'make'/'make install' as normal.
  43
  44 AFS::ukernel
  45 --
  46
  47 To get this, you need to build OpenAFS on a machine that has SWiG
  48 installed. If you build as normal when SWiG is installed, the module
  49 will show up in $sysname/dest/root.perf/lib/perl for transarc paths. You
  50 just need to put that somewhere in perl's @INC so perl can find it. (A
  51 couple examples are /usr/lib/perl5/site_perl/5.8.8/ on RHEL5 and
  52 /usr/local/lib/perl/5.10.0/ on Debian Lenny).
  53
  54 afsload itself
  55 --
  56
  57 Copy the contents of lib/ to /usr/local/lib/afsload/perl/. The files
  58 afsload_run.pl and afsload_check.pl should go in /usr/local/lib/afsload/. The
  59 'afsload' script can be copied to somewhere in your PATH.
  60
  61 Running afsload may require setting the MPIRUN and LIBMPI environment
  62 variables. On RHEL5 with OpenMPI, you probably want to run with the following
  63 environment variables set:
  64
  65 MPIRUN=/usr/lib64/openmpi/1.4-gcc/bin/mpirun
  66 LIBMPI=/usr/lib64/openmpi/1.4-gcc/lib/libmpi.so.0
  67
  68 or configure the box such that running 'mpirun' runs that mpirun, and
  69 /usr/lib/libmpi.so points to that libmpi.so.0.