


RAPD(8)                                                   RAPD(8)


NNAAMMEE
       rapd  - Resource Administration Platform (RAP) server dae-
       mon

       rapxfer - RAP resource directory manual area transfer

SSYYNNOOPPSSIISS
       rraappdd [ --dd ] [ --ll _l_o_g_f_i_l_e ]

       rraappxxffeerr [ --ddnnvv ] [ --aa _a_r_e_a ] [ _r_a_p_h_o_s_t ]

DDEESSCCRRIIPPTTIIOONN
       The rraappdd command is normally run from a shell script  dur-
       ing  system  start-up, to perform appropriate RAP services
       (these kind of commands  are  often  called  daemons,  and
       their  names  end  with  the  letter ``d'').  The //vvaarr//rraapp
       directory is used to store the resource  information,  and
       this directory is created if it does not exist.

       The  rraappdd  program  implements the resource directory, the
       location function of the RAP package, so it should be  run
       on  every  machine that wants to use the location function
       of RAP as either a client or a server.

       When starting  (and  periodically  afterward),  rraappdd  will
       broadcast to find existing resource directory servers, and
       become a server itself if there are fewer than the  target
       number  per  subnet.  The default target number of servers
       per subnet, four, is adequate for normal use.  The  target
       value  can be changed by updating the value of the sseerrvveerrss
       ppeerr ssuubbnneett attribute on the RRAAPP llooccaall aaggeenntt resource,  for
       situations  like  testing  laboratories, when machines are
       turned off and on often.  Increase  the  target  value  on
       stable machines that you wish to force to be servers.  For
       example, you can manually select the machines on each sub-
       net  to  be  RAP servers, and set their sseerrvveerrss ppeerr ssuubbnneett
       value to five, while the other machines  remain  at  four.
       Lower  the target on desktop or experimental machines that
       you wish to never become servers.  A target value  of  one
       will mean that rraappdd will only become a server if no exist-
       ing servers at all are found.

       The --dd option turns on  some  debugging  printouts.   This
       option  will  use  the current directory instead of always
       using //vvaarr//rraapp and also avoids the fork that runs the com-
       mand  in the background.  Therefore, be sure to use a com-
       mand like:

              cd /var/rap; rapd -d &

       to change to the proper directory and  run  in  the  back-
       ground unless you wish to override this behavior.

       The   --ll  option  allows  a  log  file  to  be  specified.



UNRELEASED                March 08, 2000                        1





RAPD(8)                                                   RAPD(8)


       Otherwise, the file file sseerrvv..lloogg in the default directory
       is  used  if it exists.  Some typical messages seen in the
       log file:

              Becoming server, opening database file _<_a_r_e_a_>

       The _<_a_r_e_a_>..ddbb file indicated will contain a  copy  of  the
       resource directory database.

              Bound to server _n_a_m_e at _a_d_d_r_e_s_s on _d_a_t_e

       The  given  server name is used to synchronize the server,
       or, if this rraappdd is not a server, requests  will  be  for-
       warded to that remote server.

              Total of _r resources, _c checked in _s seconds

       On  RAP  servers,  the  server of each resource is checked
       periodically to make sure it still exists.  These messages
       indicate how many resources are in the directory.

              need to rebind: Unable to receive; errno = Connection reset by peer

       The server that was previous being used has been rebooted,
       so the connection must be re-established.

              No response from server _n_a_m_e

       The  indicated  server  is  temporarily  down.  Operations
       should still proceed with the servers that remain.

       The  rraappxxffeerr  program  copies  an entire area from another
       server to the file named _<_a_r_e_a_>..ddbb in the  current  direc-
       tory.  It is normally not needed during routine operation,
       since the rraappdd(8) program will eventually synchronize each
       copy of the resource directory.  The exception is when you
       wish to have servers sharing the  same  information  (that
       is, be in the same RRAAPP aarreeaa) that cannot hear each others'
       broadcasts because  they  are  not  on  a  common  subnet.
       Before  installing the second server, but after installing
       the first server, a single invocation of the rraappxxffeerr  com-
       mand  running  on the new server, with the name of the old
       server as the argument, will cause the two servers to know
       about each other.

       The  --aa option of rraappxxffeerr allows the area to be specified.
       If not specified, the default area will be used.

       The --dd option of rraappxxffeerr turns on  some  debugging  print-
       outs.

       The --nn option causes it to go through the motions, but not
       actually transfer any data.




UNRELEASED                March 08, 2000                        2





RAPD(8)                                                   RAPD(8)


       The --vv option turns on more verbose printouts.

       In previous releases, some of the  functionality  of  rraappdd
       was  implemented  in  separate  programs  called  rraappsseerrvv,
       rraappcchheecckk, and rraappllaa.

FFIILLEESS
       //vvaarr//rraapp//sseerrvv..rreess
              Resource file for the  resource  directory  service
              program rraappdd.

       //vvaarr//rraapp//_<_a_r_e_a_>..ddbb
              The actual common resource database file (this is a
              binary format file).

SSEEEE AALLSSOO
       rraapp(8), rraappcchheecckk(8).








































UNRELEASED                March 08, 2000                        3


