---
name: "globus-rls-admin"
section: "8"
platform: "linux"
package: "globus-rls-server"
version: "4.9-11"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/globus-rls-admin"
---

# globus-rls-admin(8)

Replica Location Service Administration

## 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)](/globus-rls-server/8.md)).

## 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)](/fnmatch/3.md) or [sh(1)](/sh/1.md)).

- **-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)](/fnmatch/3.md) or [sh(1)](/sh/1.md)).

- **-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-server/8.md), globus\_rls\_client man pages