Poniżej przedstawiono procedurę uruchomienia mechanizmu mailowego powiadamiania o błędach serwera dLibry.
Należy pamiętać, że oprócz błędów które wystąpią w serwerze, mechanizm ten będzie również przekazywał informacje nt. błędów które wystąpią w wykorzystujących serwer aplikacjach redaktora/administratora.
Aby uruchomić mailowe notyfikacje o błędach wysyłane przez serwer dLibry należy:
W dlibra-server-4.0/conf/server.xml odkomentować linijkę z nazwą pliku w którym znajduje się konfiguracja serwera SMTP:
Code Block <smtpConfigurationFile>smtp.properties</smtpConfigurationFile>
- Uzupełnić zawartość pliku dlibra-server/conf/smtp.properties - znajdują się tam parametry związane z serwerem SMTP, takie jak adres serwera czy ustawienia uwierzytelniania przy wysyłaniu powiadomień o błędach.
- Wyłączyć serwer dLibry.
- W pliku dlibra-server/conf/log4j.properties:
- Włączyć mechanizm wysyłania powiadomień o błędach:
Wpis
Code Block log4j.rootLogger=info, stdout, RAll, RError
należy rozszerzyć do postaci:
Code Block log4j.rootLogger=info, stdout, RAll, RError, RMailError
Wpis
Code Block log4j.logger.pl.psnc.dlibra.content.server.performContentConsistencyCheck=info, RConsistencyCheck
należy rozszerzyć do postaci:
Code Block log4j.logger.pl.psnc.dlibra.content.server.performContentConsistencyCheck=info, RConsistencyCheck, RMailError
- Ustawić podstawowe parametry wysyłanych powiadomień:
Przykładowy adres email w linijce
Code Block log4j.appender.RMailError.To=example@email.com
należy zastąpić prawdziwym adresem na który mają być wysyłane notyfikacje.
Jeżeli zachodzi taka potrzeba można zmienić tytuł wiadomości, która będzie zawierała komunikaty o błędach:
Code Block log4j.appender.RMailError.Subject=[dlibra-server] Exception occured!
- Określić minimalną ważność przesyłanych błędów:
W standardowej konfiguracji do administratora będą trafiały wszystkie komunikaty, które zostaną zalogowane na poziomach WARN (drobne problemy), ERROR (poważne problemy, mogą doprowadzić do straty informacji), FATAL (uniemożliwiające dalszą prace serwera, mogą doprowadzić do straty informacji). Aby ograniczyć liczbę komunikatów przesyłanych do administratora można wpisać ERROR zamiast WARN w linii:
Code Block log4j.appender.RMailError.Threshold=WARN
- Włączyć mechanizm wysyłania powiadomień o błędach:
- Uruchomić serwer dLibry - przy starcie wczyta on nowe ustawienia.