catalog_update(1)
NAME
catalog_update - send update to catalog server
SYNOPSIS
catalog_update [options] [name=value] ..
DESCRIPTION
The catalog_update tool allows users to manually send an update to a
catalog server via a short UDP packet.
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 catalog_update 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 catalog_update tool includes the following
fields in the update:
- type This describes the node type (default is "node").
- version This is the version of CCTools.
- cpu This is CPU architecture of the machine.
- opsys This is operating system of the machine.
- opsysversion This is operating system version of the machine.
- load1 This is 1-minute load of the machine.
- load5 This is 5-minute load of the machine.
- load15 This is 15-minute load of the machine.
- memory_total This is total amount of memory on the machine
- memory_avail This is amount of available memory on the machine
- cpus This is number of detected CPUs on the machine.
- uptime This how long the machine has been running.
- owner This is user who sent the update.
|
ENVIRONMENT VARIABLES
- CATALOG_HOST Hostname of catalog server (same as -c).
EXIT STATUS
On success, returns zero. On failure, returns non-zero.
EXAMPLES
The following example sends an update to the catalog server located at
catalog.cse.nd.edu 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) 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
CCTools 7.0.9 FINAL from source released on