eG Administration
 

ITSM/COLLABORATION INTEGRATION

This page appears when you click the Common Settings option on the ITSM/COLLABORATION INTEGRATION node of the MANAGER SETTINGS tree that appears when you follow the menu sequence: Admin -> Settings -> Manager. Before attempting the TT integration, you need to indicate the following:

  • What alarms should be forwarded to the TT system?

  • Should detailed diagnostics be sent to the TT system?

  • Should normal alerts be routed to the TT system?

  • Should logging be enabled? If so, what should be the maximum size of the log file?

To configure the above, follow the steps outlined below:

  • Select the type of alarms that the eG manager should send to the TT system after the integration. For this, select the Critical, Major, and/or Minor check boxes against Alarm preferences in the Common Settings section.

  • To ensure that detailed diagnostics, if available, are sent along with alarm information to the TT system, turn ON the enabled detail dignosys slider.

    Note

    Even if this slider is turned ON, the eG manager will send detailed diagnostics to the TT system, only if the following conditions are fulfilled:

    • The Detailed Diagnosis capability should be enabled in the eG license.

    • In case of a redundant manager configuration again, all the eG managers that are part of the cluster should have the detailed diagnosis capability enabled in their respective licenses.

    • Both the normal and abnormal frequencies configured globally or at the test-level for collecting detailed measures should not be 0.

    • The DETAILED DIAGNOSIS slider at the test-level, should be turned ON.

    • The eG manager should integrate with the TT system via the TT mail interface or the TT CLI only.

  • Next, if you want the eG manager to track the alarms routed to the TT system and the errors, successes, and failures in the process, you can optionally configure the eG manager to maintain logs of the same. To trigger log generation, turn ON the Enable logging slider.

    Note

    • Regardless of the status of this flag, logs will not be generated if eG alarms are transmitted to the TT system via the TT mail interface.

    • Where the eG manager integrates with a TT system via the TT CLI, setting this flag to Yes will result in the automatic creation of a ttexec.log file in the <EG_INSTALL_DIR>\manager\logs directory. By default, these log files capture both the errors and the standard output of the specified Command. A sample log is provided below, where both standard output and errors have been logged.

      03/11/2009 18:25:03 INFO AlarmId “192.168.10.133_1257252903826” -DATE “Nov 03, 2009” –TIME “18:25:02” -Priority “Critical” -ComponentType “Generic” -ComponentName “gen133:NULL” -Layer “Application Processes” -Desc “-|Processes|Process not running{cmd}|gen133” -Service “-“#AlarmId “192.168.10.133_1257252903842” -DATE “Nov 03, 2009” -TIME “18:25:02” -Priority “Major” -ComponentType “Generic” -ComponentName “gen133:NULL” -Layer “Application Processes” -Desc “-|Processes|Process not running{notepad}|gen133” -Service “-” 03/11/2009 18:36:12 ERROR Executing command - ech AlarmId “192.168.10.133_1257253386239” -DATE “Nov 03, 2009” -TIME “18:32:37” -Priority “Normal” -ComponentType “Generic” -ComponentName “gen133:NULL” -Layer “Application Processes” -Desc “-|Processes|Process not running{cmd}|gen133” -Service “-“#AlarmId “192.168.10.133_1257253386255“ –DATE “Nov 03, 2009” –TIME “18:32:38” –Priority “Normal” -ComponentType “Generic” -ComponentName “gen133:NULL” -Layer “Application Processes” -Desc “-|Processes|Process not running{notepad}|gen133” -Service “-” 03/11/2009 18:36:12 ERROR ‘ech’ is not recognized as an internal or external command,

    • Where the eG manager integrates with a TT system via a web services framework, setting this flag to Yes will result in the automatic creation of <TT_System_Name>_log file in the <EG_INSTALL_DIR>\manager\logs directory. By default, these log files capture both the errors and the standard output.

    • This flag cannot be used to enable logging of SNMP trap transmissions to SNMP managers. Where TT integration is enabled over SNMP traps, logging should be enabled. Refer to the Section 3.2 of the eG Integration with Trouble Ticketing Systems document for enabling logging of SNMP Trap Transmissions.

  • Once the Enable Logging slider is turned ON, you will be allowed to indicate the maximum size (in MB) up to which the log file should be allowed to grow. The default size is 2 MB.

    Note

    • Where the eG manager uses the TT CLI to integrate with a TT system, if the ttexec.log file grows beyond the size limit configured in the Log file maximum size text box, the details originally logged in the ttexec.log file will be moved to another log file named ttexec.log.1, and the newer information will be logged in the ttexec.log file. This log roll over mechanism helps ensure that the log file does not grow beyond control.

    • Where the eG manager uses the web services framework to integrate with a TT system, if the <TT_System_Name>_log file grows beyond the size limit configured in the Log file maximum size text box, the details originally logged in the <TT_System_Name>_log file will be moved to another log file named <TT_System_Name>_log.1, and the newer information will be logged in the <TT_System_Name>_log file. This roll over will continue until a maximum of 10 log files are created - i.e., until a log file named <TT_System_Name>_log.9 is created. After this point, the eG manager will automatically delete the <TT_System_Name>_log.9 file, as it contains the oldest logs.

  • Finally, click the the Update button to save the settings