COMMAND_RCMDMGNT_PLUGINS

Return HOME or USAGE

Name

rcmdmgnt - Parallel Remote Command Configuration Manager

Plugin_Command

Plugins was created to provide a automatic upload/syncronize process an
external control list of nodes and users tags.

By default no plugins is available, however, it is possible create
external programs to autoload nodes and users tags on the database.

Each plugin will be executed by system call (using 'sh' command) and
your stdout will be taken as input data for syncronize process.

The Plugin must be configured into the Config File, using the format:

 plugin {manual|dynamic} [plugin-name] [plugin-script] [plugin-args]

*   manual or dynamic (mandatory)

    Manual: The plugin must be iteractive used to upload the static
    database.

    Dynamic: The plugin will be used on load of 'rcmd' command. The list
    of nodes is dynamic, no saved on database.

*   plugin-name (mandatory)

    Consists of a unique name in the configuration file to identify the
    plugin name.

*   plugin-script (mandatory)

    The script that will be executed.

*   plugin-args (optional)

    Parameters shared with the plugin-script as argument.

What means Manual Plugin?

    The manual plugin is not load by 'rcmd' commnad. These plugins can
    be used to upload and syncronize the database with the plugins
    stdout.

What means Dynamic Plugin?

    The Dynamic plugin create a temporary database in memory to search
    and run the commands. After end of 'rcmd' command the database is
    destroyed.

BECARFUL for Dynamic Plugin: The 'rcmd' command will wait for the plugin
to complete before starting the process. (if the plugin requires lot of
time, you still will wait until end of plugin)

How to import the Plugin STDOUT in the database?

    The plugin must shown into STDOUT using the following format:

     %RCMD% OK node [nodename] [tag1] [tag2] ... %ENDED%
     or
     %RCMD% OK tags [tagname] [node1] [node2] ... %ENDED%
     or
     %RCMD% INFO [info-message] %ENDED%
     or
     %RCMD% ERROR [error-message] %ENDED%

    The card OK sets that no errors found. The card INFO is used to
    write text in STDOUT. The card ERROR is used to write text in
    STDERR.

    The nodes and tags will be autoload (inserted and assigned) by the
    process.

The syncronize must be executed by the command:

 # rcmdmgnt -plugin [plugin1] [plugin2] ...
 or 
 # rcmdmgnt -plugin -show-plugin

For each node the user's tag "plugin-[pluginid]' will be automatically
assigned.

REMEMBE: All new node must be manually enabled.

 # rcmdmgnt -enable -tag [plugin-pluginid]

Plugin_Options

 showplugin

Generic_Options

 config, debug, non-interactive, noheards, notitle

ENDED