.TH "catalog_server" 1 "" "CCTools 7.1.2 FINAL" "Cooperative Computing Tools"

.SH NAME
.LP
\fBcatalog_server\fP - start a catalog server

.SH SYNOPSIS
.LP
\FC\fBcatalog_server [options]\fP\FT

.SH DESCRIPTION
.LP

.PP
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.

.PP
To view the complete contents of the catalog, users can direct
their browser to \FChttp://catalog.cse.nd.edu:9097\FT.  Command line tools
\FCwork_queue_status\FT and \FCchirp_status\FT 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 \FCCATALOG_HOST\FT
and \FCCATALOG_PORT\FT environment variables to direct clients to their server.

.PP
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.

.SH OPTIONS
.LP

.LP
.TP
.B \ -b, --background
.
Run as a daemon.
.TP
\fB-B\fP, \fB-\-pid-file\fP=\fI<file>\fP
.
Write process identifier (PID) to file.
.TP
\fB-d\fP, \fB-\-debug\fP=\fI<flag>\fP
.
Enable debugging for this subsystem
.TP
.B \ -h, --help
.
Show this help screen
.TP
\fB-H\fP, \fB-\-history\fP=\fI<directory>\fP
.
 Store catalog history in this directory.  Enables fast data recovery after a failure or restart, and enables historical queries via deltadb_query.
.TP
\fB-I\fP, \fB-\-interface\fP=\fI<addr>\fP
.
Listen only on this network interface.
.TP
\fB-l\fP, \fB-\-lifetime\fP=\fI<secs>\fP
.
Lifetime of data, in seconds (default is 1800)
.TP
\fB-L\fP, \fB-\-update-log\fP=\fI<file>\fP
.
Log new updates to this file.
.TP
\fB-m\fP, \fB-\-max-jobs\fP=\fI<n>\fP
.
Maximum number of child processes.  (default is 50)
.TP
\fB-M\fP, \fB-\-server-size\fP=\fI<size>\fP
.
Maximum size of a server to be believed.  (default is any)
.TP
\fB-n\fP, \fB-\-name\fP=\fI<name>\fP
.
Set the preferred hostname of this server.
.TP
\fB-o\fP, \fB-\-debug-file\fP=\fI<file>\fP
.
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").
.TP
\fB-O\fP, \fB-\-debug-rotate-max\fP=\fI<bytes>\fP
.
Rotate debug file once it reaches this size (default 10M, 0 disables).
.TP
\fB-p\fP, \fB-\-\fP=\fI<port>\fP
.
Port number to listen on (default is 9097)
.TP
.B \ -S, --single
.
Single process mode; do not fork on queries.
.TP
\fB-T\fP, \fB-\-timeout\fP=\fI<time>\fP
.
Maximum time to allow a query process to run.  (default is 60s)
.TP
\fB-u\fP, \fB-\-update-host\fP=\fI<host>\fP
.
Send status updates to this host. (default is catalog.cse.nd.edu,backup-catalog.cse.nd.edu)
.TP
\fB-U\fP, \fB-\-update-interval\fP=\fI<time>\fP
.
Send status updates at this interval. (default is 5m)
.TP
.B \ -v, --version
.
Show version string
.TP
\fB-Z\fP, \fB-\-port-file\fP=\fI<file>\fP
.
Select port at random and write it to this file.  (default is disabled)


.SH ENVIRONMENT VARIABLES
.LP


.IP \(bu 4
\FC\fBCATALOG_HOST\fP\FT Hostname of catalog server (same as \FC-u\FT).
.IP \(bu 4
\FC\fBCATALOG_PORT\fP\FT Port number of catalog server to be contacted.
.IP \(bu 4
\FC\fBTCP_LOW_PORT\fP\FT Inclusive low port in range used with \FC-Z\FT.
.IP \(bu 4
\FC\fBTCP_HIGH_PORT\fP\FT Inclusive high port in range used with \FC-Z\FT.


.SH EXIT STATUS
.LP
On success, returns zero.  On failure, returns non-zero.

.SH COPYRIGHT
.LP
The Cooperative Computing Tools are Copyright (C) 2005-2019 The University of Notre Dame.  This software is distributed under the GNU General Public License.  See the file COPYING for details.

.SH SEE ALSO
.LP

.IP \(bu 4
\fBCooperative Computing Tools Documentation\fP
.IP \(bu 4
\fBcatalog_server(1)\fP  \fBcatalog_update(1)\fP  \fBcatalog_query(1)\fP  \fBchirp_status(1)\fP  \fBwork_queue_status(1)\fP   \fBdeltadb_query(1)\fP