NAME
catalog_update - send update to catalog server
SYNOPSIS
FCcatalog_update [options] [name=value] ..FT
DESCRIPTION
The FCcatalog_updateFT tool allows users to manually send an update to a catalog server via TCP or UDP.
OPTIONS
- -c,--catalog=<host>
-
Send update to this catalog host.
- -f,--file=<json-file>
-
Send additional JSON attributes in this file.
- -d,--debug=<flags>
-
Enable debug flags.
- -o,--debug-file=<file>
-
Send debug output to this file.
- -v <version>
-
Show software version.
- -h <help>
-
Show all options.
The FCcatalog_updateFT tool sends a custom message to the catalog server in the from of a JSON object with various properties describing the host. By default, the FCcatalog_updateFT tool includes the following fields in the update:
- •
-
FCtypeFT This describes the node type (default is "node").
- •
-
FCversionFT This is the version of CCTools.
- •
-
FCcpuFT This is CPU architecture of the machine.
- •
-
FCopsysFT This is operating system of the machine.
- •
-
FCopsysversionFT This is operating system version of the machine.
- •
-
FCload1FT This is 1-minute load of the machine.
- •
-
FCload5FT This is 5-minute load of the machine.
- •
-
FCload15FT This is 15-minute load of the machine.
- •
-
FCmemory_totalFT This is total amount of memory on the machine
- •
-
FCmemory_availFT This is amount of available memory on the machine
- •
-
FCcpusFT This is number of detected CPUs on the machine.
- •
-
FCuptimeFT This how long the machine has been running.
- •
-
FCownerFT This is user who sent the update.
The field FCnameFT is intended to give a human-readable name to a service or application which accepts incoming connections at FCportFT.
ENVIRONMENT VARIABLES
- •
-
FCCATALOG_HOSTFT Hostname of catalog server (same as FC-cFT).
EXIT STATUS
On success, returns zero. On failure, returns non-zero.
EXAMPLES
The following example sends an update to the catalog server located at FCcatalog.cse.nd.eduFT with three custom fields.
-
% cat > test.json << EOF {
"type" : "node",
"has_java" : true,
"mode" : 3 } EOF % catalog_update -c catalog.cse.nd.edu -f test.json
COPYRIGHT
The Cooperative Computing Tools are Copyright (C) 2022 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