NAME

       catalog_server - start a catalog server

SYNOPSIS

       catalog_server [options]

DESCRIPTION

       A  catalog  server  provides  naming  and  discovery for multiple components of the Cooperative Computing
       Tools, particularly  the  Chirp  distributed  filesystem  and  the  Work  Queue  distributed  programming
       framework.   Services  that wish to be known on the network periodically publish their information to the
       catalog server via a short UDP packet.  Clients wishing to  discover  services  by  name  may  query  the
       catalog  by  issuing  an  HTTP request to the catalog server and will receive back a listing of all known
       services.

       To   view   the   complete   contents   of   the   catalog,   users   can   direct   their   browser   to
       http://catalog.cse.nd.edu:9097.   Command  line tools work_queue_status and chirp_status present the same
       data in a form most useful for Work Queue and Chirp, respectively.  Large sites  are  encouraged  to  run
       their  own  catalog  server  and  set  the  CATALOG_HOST and CATALOG_PORT environment variables to direct
       clients to their server.

       The catalog server is a discovery service, not  an  authentication  service,  so  services  are  free  to
       advertise  whatever  names  and  properties  they please.  However, the catalog does update each incoming
       record with the actual IP address and port from which it came, thus preventing a malicious  service  from
       overwriting another service's record.

OPTIONS

        -b, --background
              Run as a daemon.

       -B, --pid-file=<file>
              Write process identifier (PID) to file.

       -d, --debug=<flag>
              Enable debugging for this subsystem

        -h, --help
              Show this help screen

       -H, --history=<directory>
               Store  catalog history in this directory.  Enables fast data recovery after a failure or restart,
              and enables historical queries via deltadb_query.

       -I, --interface=<addr>
              Listen only on this network interface.

       -l, --lifetime=<secs>
              Lifetime of data, in seconds (default is 1800)

       -L, --update-log=<file>
              Log new updates to this file.

       -m, --max-jobs=<n>
              Maximum number of child processes.  (default is 50)

       -M, --server-size=<size>
              Maximum size of a server to be believed.  (default is any)

       -n, --name=<name>
              Set the preferred hostname of this server.

       -o, --debug-file=<file>
              Write debugging output to this file. By default, debugging is sent to stderr (":stderr"). You  may
              specify  logs  be  sent to stdout (":stdout"), to the system syslog (":syslog"), or to the systemd
              journal (":journal").

       -O, --debug-rotate-max=<bytes>
              Rotate debug file once it reaches this size (default 10M, 0 disables).

       -p, --=<port>
              Port number to listen on (default is 9097)

        -S, --single
              Single process mode; do not fork on queries.

       -T, --timeout=<time>
              Maximum time to allow a query process to run.  (default is 60s)

       -u, --update-host=<host>
              Send status updates to this host. (default is catalog.cse.nd.edu,backup-catalog.cse.nd.edu)

       -U, --update-interval=<time>
              Send status updates at this interval. (default is 5m)

        -v, --version
              Show version string

       -Z, --port-file=<file>
              Select port at random and write it to this file.  (default is disabled)

ENVIRONMENT VARIABLES

       •   CATALOG_HOST Hostname of catalog server (same as -u).

       •   CATALOG_PORT Port number of catalog server to be contacted.

       •   TCP_LOW_PORT Inclusive low port in range used with -Z.

       •   TCP_HIGH_PORT Inclusive high port in range used with -Z.

EXIT STATUS

       On success, returns zero.  On failure, returns non-zero.

COPYRIGHT

       The Cooperative Computing Tools are Copyright (C) 2003-2004 Douglas Thain and Copyright (C) 2005-2015 The
       University  of  Notre  Dame.  This software is distributed under the GNU General Public License.  See the
       file COPYING for details.

SEE ALSO

       •   Cooperative Computing Tools Documentation

       •   catalog_server(1)    catalog_update(1)    catalog_query(1)    chirp_status(1)    work_queue_status(1)
           deltadb_query(1)