NAME

       globus-rls-admin - Replica Location Service Administration

SYNOPSIS

       globus-rls-admin  -A|-a|-C option value|-c option|-D|-d|-e|-p|-q|-r|-S|-s|-t timeout|-u|-v
       [ rli ] [ pattern ] [ server ]

DESCRIPTION

       The program globus-rls-admin performs administrative  operations  on  a  RLS  server  (see
       globus-rls-server(8)).

OPTIONS

       -A     Add  rli to list of RLI servers updated by an LRC server using Bloom filters.  Note
              that partitions are not supported with Bloom filters, the LRC server maintains  one
              Bloom  filter  for  all  LFNs  in  its  database,  which is sent to all RLI servers
              configured to receive Bloom filter updates with this option.

       -a     Add rli and optionally pattern to the list of RLI servers that the LRC server sends
              updates to (using a list of LFNs).  If pattern is specified then only LFNs matching
              it will be sent to rli.  If rli is added with no patterns,  then  it  is  sent  all
              updates.   Pattern  matching  is  done  using  standard  Unix  file  globbing  (see
              fnmatch(3) or sh(1)).

       -C option value
              Set server option to value.  Note this does not update the configuration file,  the
              next time the server is restarted the configuration change will be lost.

       -c option
              Retrieve  configuration value for specified option from server.  If option is "all"
              then all options are retrieved.

       -D     Remove rli and pattern from list of RLI servers that the RLI server  sends  updates
              to.  If pattern is not specified then all entries for rli are removed.  Note if all
              patterns are removed separately then rli is sent all updates.  To stop any  updates
              from being sent to rli do not specify pattern

       -d     Remove  rli  and pattern from list of RLI servers that the LRC server sends updates
              to.  If pattern is not specified then all entries for rli are removed.  Note if all
              patterns  are removed separately then rli is sent all updates.  To stop any updates
              from being sent to rli do not specify pattern

       -e     Clear LRC database.  Removes all lfn,pfn mappings.

       -p     Verifies that the server is responding.

       -q     Cause RLS server to exit.

       -r     Add rli and optionally pattern to the list of RLI servers that the RLI server sends
              updates  to.   If  pattern  is specified then only LFNs matching it will be sent to
              rli.  If rli is added with no patterns, then  it  is  sent  all  updates.   Pattern
              matching is done using standard Unix file globbing (see fnmatch(3) or sh(1)).

       -S     Show statistics and other information gathered by RLS server.  Intended to be input
              into GRIS.

       -s     Show list of RLI servers and patterns being sent updates by the LRC server.  If rli
              or pattern are not specified they are considered wildcards.

       -t timeout
              Set timeout (in seconds) for RLS server requests.  Default is 30 seconds.

       -u     Cause  LRC  server  to  immediately start full softstate updates to any RLI servers
              previously added with the -a option.

       -v     Show version and exit.

SEE ALSO

       globus-rls-server(8), globus_rls_client man pages

                                            23 Apr 02                         globus-rls-admin(8)