SCC-SCOM2Nagios Connector

Lizenz: 

Copyright (C) 2009 Markus Bker
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; 
either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; 
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, see <http://www.gnu.org/licenses/>.



Der Connector luft als Dienst auf dem OpsMgr Server.

Um ihn dort zu installieren, kopiert man den Release Ordner in einen lokalen Ordner
auf dem Server.
Der Dienst wird durch den .Net Installer installiert:

--------------------------------------------------------------------------------------------
"%systemroot%\Microsoft.NET\Framework\v2.0.50727\InstallUtil.exe" Nagios-SCOMConnector.exe

Microsoft (R) .NET Framework-Installationsprogramm, Version 2.0.50727.1433
Copyright (c) Microsoft Corporation. Alle Rechte vorbehalten.


Eine transaktive Installation wird ausgefhrt.
[...]
Die transaktive Installation ist abgeschlossen.
--------------------------------------------------------------------------------------------


Unter Dienste in der Computerverwaltung sollte jetzt ein neuer Dienst mit dem Namen
"KIT Nagios Connector" auftauchen.

Zustzlich muss der Connector im OpsMgr registriert werden. Dazu ruft man das Programm mit dem
Parameter InstallConnector auf. (Gro/Kleinschreibung beachten!)

--------------------------------------------------------------------------------------------
Nagios-SCOMConnector.exe InstallConnector

Created Nagios Connector with ID: {038F2550-B6F3-11DD-BBCC-4EF555D89593}
--------------------------------------------------------------------------------------------

Als nchstes mssen die Parameter fr Nagios konfiguriert werden. Dazu bearbeiteten man die 
Nagios-SCOMConnector.exe.config Datei mit einem beliebigen Editor (z.B. Notepad)

Der Zentrale Block sieht so aus:
--------------------------------------------------------------------------------------------
      <setting name="NagiosHost" serializeAs="String">
Hier Nagios.host.de durch den korrekten DNS (oder IP-Adresse) des nagios Hosts ersetzen
        <value>Nagios.host.de</value>
      </setting>
      <setting name="NagiosPort" serializeAs="String">
Bitte den Port durch den Zielport fr ncsa Nachrichten ersetzen
        <value>5667</value>
      </setting>
      <setting name="ncsaPath" serializeAs="String">
Hier muss der vollstndige Pfad zur send_ncsa.exe hinterlegt werden. Dieser muss den Dateinamen der Exe mit
einschliessen, d.h. c:\send_ncsa\send_ncsa.exe
        <value>undef</value>
      </setting>
      <setting name="ncsaConfigFile" serializeAs="String">
Ebenfalls muss der Pfad zur send_ncsa Config Datei hinterlegt werden (inkl. Name der Datei)
        <value>undef.config</value>
      </setting>
      <setting name="NagiosHost1" serializeAs="String">
Es besteht die Mglichkeit alle Alarme auch gleichzeitig an einen zweiten Nagios Host zu schicken.
Die send_ncsa Konfiguration muss aber identisch sein.
        <value />
      </setting>
      <setting name="NagiosPort1" serializeAs="String">
        <value>5667</value>
      </setting>
      <setting name="NagiosSCOMService" serializeAs="String">
Mit diesem Parameter wird festgelegt, wie der Passive Check bei den im Nagios hinterlegten Systemen heit
        <value>p_scom</value>
      </setting>
--------------------------------------------------------------------------------------------
Mit dem ebenfalls in der Config Datei angebbaren Debug Level kann man die Debugausgabe erhhen. Alle
Debuginformationen werden im All User Profil unter Applicationdata abgelegt.

Ebenfalls muss die send_ncsa.cfg Datei angepasst werden (oder beide send_ncsa Dateien durch eine Alternative Version
ausgetauscht werden). Je nach bertragungsmethode muss das Passwort und die Verschlsselungsmethode ersetzt werden.

Jetzt sind alle Einstellungen so vorbereitet, dass der Dienst gestartet werden kann. Sinnvoll ist es den Dienst mit 
Recovery Einstellungen zu versehen, da er sich im Fehlerfall im Allgemeinen selbst beendet und neu gestartet werden
muss.

Damit der Connector berhaupt Werte erhlt, mssen Regeln im OpsMgr hinterlegt werden. Dazu kann man beliebige Filter
unter Administration hinterlegen. Ebenso ist es mglich einzelne Alarme zu Testzwecke an den Connector zu schicken, indem
man auf den Alarm einen Rechten Mausklick und dann Send to auswhlt.
