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.

The catalog_update tool also accepts a list of name/value pairs that will be sent to the catalog server as field entries. By default, the catalog_update tool includes the following field entries in its update packet:

  • 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

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 the fields type set to "node", name set to "testnode00", and has_java set to "yes". These fields can be queried from the catalog server by clients using chirp_status.

catalog_update -c catalog.cse.nd.edu type=node name=testnode00 has_java=yes

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 5.1.0 [FINAL:4d00b642] released on