8.1 How the Integration Works

Using an existing methodology, launching an Action script based on an event, the integration of AppManager and Vivinet Diagnostics involves two Action scripts — Action_DiagnoseVoIPQuality and Action_DiagnoseNortelIPT — that trigger Vivinet Diagnostics to diagnose the problem for events raised by the following Knowledge Scripts.

When you run one of the applicable monitoring Knowledge Scripts, Vivinet Diagnostics can diagnose the problem when any VoIP or call quality metric exceeds or fails to meet its threshold. AppManager uses Action scripts to invoke Vivinet Diagnostics. For more information, see Section 8.3, Knowledge Scripts that Trigger Diagnoses.

These Action scripts use an interface to Vivinet Diagnostics to define the parameters of the Diagnosis, run the Diagnosis, and then save the results. The parameters used to define the Diagnosis are taken from the Knowledge Script that raised the event. The thresholds in the scripts correspond to the Marginal/Poor threshold in Vivinet Diagnostics. Results are saved in Diagnosis files, which have a file extension of .DGV.

Upon completion of the Diagnosis, AppManager raises an event that contains the results of the Diagnosis. An event for an unsuccessful Diagnosis contains an error message explaining why the Diagnosis was unsuccessful. In an event for a successful Diagnosis, the Message tab contains either the full path to the location of the output file or a URL to an HTML report. An HTML report is created only if the AppManager Report agent is installed on the computer on which the Diagnosis ran. The HTML report contains hyperlinks to the Diagnosis file.

For more information about interpreting a Diagnosis file, see Section 5.0, Understanding Results.

NOTE:

  • If the AppManager Report agent is installed on the computer on which the Action scripts are run, you can use the Report agent settings to allow the Diagnosis results to be integrated with the AppManager Report Binder. For more information, see the Control Center User Guide for AppManager.

  • When the Report agent is being used, you can see all completed diagnoses by launching the AppManager Report Binder, which you access from the Extensions menu of the Operator Console.

  • When you open a Diagnosis from the Report Binder, Internet Explorer makes a copy of the file in your \temp folder. If you click Save in Vivinet Diagnostics, this copy is updated. If you modify the Diagnosis parameters or rerun the Diagnosis, use Save as to save the file in a different folder.