見出し画像

TWSNMP FCのデータストア内のファイルと玄人向け拡張方法(プライベートMIB対応など)

TWSNMP FCのデータストアフォルダに関する説明です。データストア内にあるファイルと特定のファイルを追加することで機能拡張できます。

データベースファイル

twsnmpfc.dbです。bboltのバイナリなので見ることはできません。停止状態でコピーすれば、バックアップできます。別のマシンにコピーできます。

バックアップフォルダ

backupです。データストアのバックアップ設定

すれば、定期的にバックアップファイルをこのフォルダに保存します。

サーバー証明書と秘密鍵

cert.pem とkey.pemです。TWSNMP FCのWeb画面をHTTPSでアクセスするためのサーバー証明書と秘密鍵です。データストアに保存しておけば、指定のファイルを利用します。存在しない状態でHTTPSモードで起動すれば自動で自己署名の証明書を作成します。

MIBファイル

mib.txtというファイルをデータストアに保存すれば、組み込まれているmib.txtを置き換えます。あまり必要はないと思います。
組み込まれているファイルは、

です。
mib.txtの作り方は

を見てください。

拡張MIBフォルダ

extmibsです。はじめは存在しないので必要なら作成してください。
このフォルダにASN.1形式のMIBファイルをコピーすれば、TWSNMP FCの起動時に読み込みます。エラーがあって読み込まない場合はコンソールのログに表示されます。
正しく読み込めた場合は

2022-07-28T05:56:12.049 load ext mib path=tmp/extmibs/jema-mib_file.txt
2022-07-28T05:56:12.066 module jemaUpsMIB=jema.1

のようにファイル名と認識したモジュール名が表示されます。
エラーがある場合は、

2022-07-28T06:00:52.624 load ext mib path=tmp/extmibs/jema-mib_file.txt
2022-07-28T06:00:52.637 21:21: unexpected "010207" (expected <extutctime> ...)

のようなエラーが表示されます。
正しく読み込めれば、

のようにMIBブラウザーのMIBツリーから確認できます。

サービスファイル

services.txtです。ポート番号とプロトコル名のデータベースファイルです。
組み込まれているのは

です。変更する必要はないと思います。

MACアドレスとベンダー名データベース

mac-vendors-export.csvです。MACアドレスのベンダーコードからベンダーの名前を探すデータベースファイルです。
組み込んでいるのは、

です。オリジナルは

です。

休日定義ファイル

yasumi.txtです。AI分析の時に休みの日を判定するために使うファイルです。
組み込まれているのは、

です。2022年分まであります。会社の休みに合わせて追加するとAIが賢くなるかもしれません。

TLSの暗号名定義ファイル

tlsparams.csvです。TLS通信の暗号スイートの名前を定義したファイルです。組み込まれているのは

です。変更する必要はないと思います。

IP位置情報データベース

geoip.mmdbです。IPアドレスから位置情報を検索するためのデータベースファイルです。Web画面からアップロードできます。

ポーリング定義

polling.jsonです。ポーリングの定義ファイルです。
デフォルトで組み込んでいるのは、

です。置き換えではなく追加できます。

ポーリングコマンドフォルダ

cmdです。コマンド実行のポーリング用のコマンドを保存するフォルダです。安全のためにパスを指定して実行できないようにするためにフォルダを固定しています。

通知メールのテンプレート

mail_test.html,mail_notify.html,mail_report.htmです。
通知メールのテンプレートです。変更すれば通知メールの中身をカスタマイズできます。
組み込まれているのは、
テストメール

通知メール

定期レポートメール

です。
テンプレートは

の記法です。

開発のための諸経費(機材、Appleの開発者、サーバー運用)に利用します。 ソフトウェアのマニュアルをnoteの記事で提供しています。 サポートによりnoteの運営にも貢献できるのでよろしくお願います。