catalog_update1

Usage

Overview

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

•

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