Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • a System Monitor Command that specifies the parameterization of the Plugin and
  • a System Monitor Service that is the visible point of control in the System Monitor console.

...

JS7 Controller Plugin

Sample Configuration

Code Block
languagebash
titleSample JS7 Controller Plugin Command configuration
# 'check_js7_controller' command definition
define command {
    command_name                check_js7_controller
    command_line                /opt/plugins/check_js7_controller.pl -j $ARG1$ -i $ARG2$ -a $ARG3$ -t $ARG4$
}

...

  • JOC Cockpit installation since 2.0.0 is required.
  • Perl > 5.8 is required and some Perl packages are required. You can download and install Perl packages from e.g. http://www.cpan.

    • HTTP::Request

    • LWP::UserAgent

    • LWP::Protocol::https (if HTTPS is used to connect to JOC Cockpit)
    • JSON
    • MIME::Base64

...

JS7 Agent Plugin

A service Command has to be declared before configuring the System Monitor Service that makes use of this Command.

...

  • check_js7_agent.pl calls an optional script report_js7_agent.pl per Agent.
  • This script does not connect to JOC Cockpit or perform any checks but simply serves to create individual notifications per Agent to the System Monitor.
  • The script is executed if it is available from the same directory as the calling script and has to be executable.
  • The script is parameterized to transfer the message type and notification to the System Monitor.
    • report_js7_agent.pl <joc-cockpit-url> <controller-id> <agent-url> <agent-status>
    • <joc-cockpit-url> is the URL that has been specified as a parameter to the script check_js7_agent.pl
    • <scheduler<controller-id> is the JobScheduler Master Controller ID that has been specified as a parameter to the script check_js7_agent.pl
    • <agent-url> is the URL identifying the Agent
    • <agent-status> is one of "RUNNINGCOUPLED" , "RESETTING", "UNREACHABLERESET", "TERMINATINGCOUPLINGFAILED", "UNKNOWN_AGENT"

      Code Block
      languageperl
      titleExample report_js7_agent.pl
      #!/usr/bin/env perl
      use strict;
      use warnings;
       
      my ($jocUrl, $controllerId, $agentUrl, $agentStateText) = @ARGV;
      # do something with $jocUrl, $controllerId, $agentUrl, $agentStateText

...