Concord/NhModifyElements

nhModifyElements

nhModifyElements changes selected attributes for one or more elements
maintained by eHealth. You can use three methods to specify elements: use
standard input (stdin), use the -inFile argument, or redirect the output of
the nhListElements command as input.

CAUTION: Improper use of this command can result in failure to poll or
         incorrect report data.  Use this command only if you are an
         advanced user and are familiar with the effects of this command.

nhModifyElements [ -h ] [ -rev ] -fieldName <fieldName> [ -value <value> ]
    [ -inFile <fileName> ] [ -verify ]

-h   (Optional) Displays this command usage.

-rev (Optional) Displays the eHealth software revision.

-fieldName <fieldName>
    (Required) Specifies one of the following element fields to update:
    alias, name, poll, pollRate, speed, speedIn, speedOut, includeLanWan
    or nmsState. You can update only one field at a time. For specific
    information and requirements concerning the values of each of these
    field names, refer to the eHealth Administration Reference.

-value <value>
    (Optional) Modifies a property for a set of elements without requiring
    you to generate an input file where the data format is name,value.
    Specify -value with the following fieldName values: poll (yes, no),
    pollRate (fast, normal, slow), speed|speedIn|speedOut (speed in bits
    per second), includeLanWan (yes, no).
    NOTE: You cannot use the -value parameter with the name or alias fields

-inFile <filename>
    (Optional) Specifies the name of the file that contains the list of
    modifications. Use -inFile to specify unique values for each element,
    not the same value for all elements; or, create a list and use -value
    to specify the same value for all elements in the list. If you do not
    specify an input file, eHealth reads input from standard input. Input
    has the following format:

    name[,value]
    name[,value]
    ...
    name[,value]

    If you do not use the -value argument, you must specify a value for
    each element in the list.

-verify
    (Optional) Processes the input and produces a DCI file, but does not
    modify the elements in the eHealth configuration.

The following example changes the poll rate of all elements in the file
subnet5Routers to normal:

nhModifyElements -fieldName pollRate -value normal -inFile subnet5Routers

The following command finds all elements that have not collected data for
four hours and turns off polling for them:

nhListElements -noDbDataFor 4 | nhModifyElements -fieldName poll -value off

The following command lists all elements that have a speed of 9600 bps and
changes them to a speed of 19200 bps:

nhListElements -where "speed = 9600" | nhModifyElements -fieldName speed
-value 19200

For more information, refer to the eHealth Administration Reference.

Back to Concord Index