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.

           The field name is intended to give a human-readable name to a service or  application  which  accepts
           incoming connections at port.

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) 2005-2019 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

       •   catalog_server(1)    catalog_update(1)    catalog_query(1)    chirp_status(1)    work_queue_status(1)
           deltadb_query(1)

CCTools 8.0.0 DEVELOPMENT                                                                      catalog_update(1)