This file contains a list of installation instructions for rplay.  Please read
this file very carefully and don't skip any steps unless you think you know
what you are doing.  If you haven't read the README file, please do so before
going any further.  If you get confused at any time during the installation
please read the manual pages in the doc directory.  

Feel free to send e-mail to boyns@sdsu.edu if you have any problems.

* Edit Makefile.config to choose the correct compiler, compiler options,
  and installation pathnames.  The Makefile.config contains comments which
  suggest what options should be used for various systems.

* If you are using HP-UX you will also have to edit librplay/Makefile to
  comment some lines and uncomment others. 

* Edit include/conf.h to change rplay configuration parameters.

* This step is optional.  Execute "make depend" to create dependencies in the 
  Makefiles.

* Execute "make".  This will compile the rplay library and programs.
  If rplay does not compile successfully then you might need to change either
  the Makefile.conf or include/conf.h.

* When rplay successfully compiles execute "make world".  This will verify that
  rplay has been compiled successfully, install rplay, and then ask you if
  you would like to send me an e-mail message.  I would appreciate an e-mail
  message because I would like to get a feel for exactly how many people are
  using rplay.

* Read the man pages.

* Create your rplay.conf file.  I run a cron job that creates my rplay.conf
  every hour.  "find *.au" or "find / -name *.au -print" can used to find all
  the sound files that are available.

* Create your rplay.hosts file if AUTH was defined in include/conf.h.
  AUTH is defined by default.

* Create your rplay.servers file.  You might want to use sounds.sdsu.edu
  port 55556 as an RPTP server.

* If you plan on using inetd to invoke rplayd become root and add the 
  following to /etc/services:

        rplay 55555/udp

  and this to inetd.conf (you make need to change the pathname):

        rplay dgram udp wait nobody /usr/local/bin/rplayd rplayd

  If you are running NIS or YP you will need to update the services map.
  "cd /var/yp; make" will probably do the trick for SunOS 4.1.x users.
  The NIS update must be done on the NIS server.  You can type "ypwhich"
  to locate your NIS server.

  Now you need to restart inetd.
        > ps aux | grep inetd
        (result will be something like this)
        root       174  0.0  0.0   48    0 ?  IW   13:25   0:04 inetd
        > kill -1 174

  Check /var/adm/messages for any errors.

* If you do not plan on using inetd you need to start rplayd by hand whenever
  you want to use it.  Try "rplayd -n" or "rplayd -n -t0".  Read the rplayd
  man page and try "rplayd -h" for more information.

* Now see if rplay works.  Execute "rplay soundname", where soundname is the
  name of a sound in the rplay.conf.  If soundname is played then rplay is 
  working.  However, if a sound is not played then I recommend you run rplayd 
  in debug mode to see exactly what is wrong.
  
  When using rplayd in debug mode you must remove the rplayd entry from the
  inetd.conf file and kill any old rplayds that might be running.

  Try running "rplayd -n -d -t0" and then "rplay soundname".
  You should see output like:

  rplayd: play sound=bogus.au volume=127 from 130.191.224.8
  rplayd: opening /dev/audio
  rplayd: closing /dev/audio

  If you still don't hear any sound check the following things:

     * Is the volume of the audio device very low or zero?
       Sun users can use audiotool to change the volume easily.

     * Is another program is using the audio device?
       There are several programs around that hog the audio device.
       These programs include soundtool, audiotool, play, x_soundtool,
       any many others.  Note that rplay is audio device friendly and will
       close the audio device when it is not being used.
     
     * Are you running another audio server like Aserver?  rplay does not
       work with Aserver and probably won't work with other servers.
       If you want to use rplay make sure other audio servers are not running.

     * If you see errors like "/dev/audio open: Device busy" then another
       program is using the audio device.

  If you are still having problems send e-mail to boyns@sdsu.edu and I will do
  my best to help you out.

* You are done installing rplay.  You now might want to browse through the 
  contrib directory.  Have fun!

