Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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:

  1. 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>
  2. 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.
  3. Wyłączyć serwer dLibry.
  4. W pliku dlibra-server/conf/log4j.properties:
    1. 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
    2. 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!
    3. 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
  5. Uruchomić serwer dLibry - przy starcie wczyta on nowe ustawienia.