[ftp://ftp.tik.ee.ethz.ch/pub/projects/dic/INSTALL 1997/02/05 18:30 GMT] -*- text -*-

INSTALL FILE for client-v5, dic project

see README for general information

STEP BY STEP INSTALLATION
=========================

CHOOSING THE RIGHT BINARY. There is a wide collecting of very
optimised binaries available under binaries/. The files are named
client-<maj.min version>-<OS>-<OS version>-<arch>-<CPU>. Type "uname -rms"
on your local system and try to find the best match. If you have
difficulties, read the accompanying .txt files or see the SYSTEMS
section later.

DOWNLOADING. Enter the following commands: 
> ftp ftp.tik.ee.ethz.ch
...
Name: ftp
Password: (your email)
...
ftp> cd /pub/projects/dic   (you probably have done that by now)
...
ftp> bin
...
ftp> cd binaries
...
ftp> ls
...(lots of choices)
ftp> get client-<your choice>
... OK
ftp> quit
The file is no archive, all you have to do is to flag it as executable:
"chmod a+x client-*".

INVOCATION. Start it: "./client-<your choice> -e kom30.ethz.ch". (If
you have a multiprocessor machine, add the number of processors at the
end.) The client will first check its integrity and performance. Then
it should detach from the console and starts processing keys. Check
with "ps -ef|grep client" or "top": the process should use all spare
CPU time but little memory.

PROBLEMS? 
 * Try without the -e option, so the client doesn't detach. 
 * Check the file size ("ls -l") against the size of the file on the
   ftp-server--it has to be exactly the same.
 * Try another binary.
 * Use common sense.
 * Report the problem to me (ths@rz.tu-ilmenau.de) or to the
   developers mailing list (challenge@list.ee.ethz.ch, see README).
   Please state if you are not on this list.

FURTHER INFORMATION
===================

OPTIONS. Parameters are the server name and the number of processors
(optional, default=1). See the man-page in the source distribution for
more information.
  -m        performance test
  -t min    changes the length of the allocated job to min minutes.
            use this if you have a dialup connect (e.g. -t 600
            overnight)
  -e        detach from console and put into the background
  -l        lock against multiple processes of the same client


HINTS FOR CERTAIN SYSTEMS.
 * Linux on x86 architecture: Use one of the binaries provided, they
   are very fast. *-a.out-static should be fastest and run on any
   system, the *-ELF is smaller, about as fast and a good choice for
   an elf system. Your millage may vary slightly.
 * FreeBSD on x86: ditto except a.out only. We have no pgcc-2.7.2p
   available--if you have, please try -mpentium optimisation and mail
   the results.
 * Windows NT: You won't have the UNIX environment for with this guide
   is written, use the corresponding tools. The source code needs
   quite some work, but there should be a binary soon. You can't
   detach the client.
 * SunOS: Your millage may vary depending on the type of processor and
   the optimisation (-msupersparc or not). Please try to find the
   fastest client, using the -m option.

COMPILING THE SOURCES. 
"make" without parameters will show you a list of target systems. If
you have to use generic, try to add appropriate optimisation--the
binary may be very slow otherwise. You will probably need the GNU C
compiler gcc, native cc may or may not work. See the section above and
the *.txt files in ./binaries for further hints. You may be interested
in joining the developers mailing list challenge@list.ee.ethz.ch.

-- 
written and maintained by Thomas Steffen, ths@rz.tu-ilmenau.de






