Page History

In this part, we present the procedure of running the mechanism for notifying about errors of the dLibra server by email.

It ought to be remembered that the mechanism will not only inform about errors on the server but also about errors which will occur in the Editor/Administrator Applications which use the server.

In order to run the error notification emails sent by the dLibra server, the user should:

1. Uncomment the line with the name of the file containing the SMTP server configuration in 

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 Complete the content of the 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.  file, which contains parameters related to the SMPT server, such as the address of the server or authentication settings for sending error notifications.
5. Updating the dLibra Server
6. In file W pliku dlibra-server/conf/log4j.properties:
   1. Włączyć mechanizm wysyłania powiadomień o błędachwitch on the mechanism for sending error notifications:

      • WpisEntry

        Code Block
        log4j.rootLogger=info, stdout, RAll, RError

        należy rozszerzyć do postaci:

        Code Block
        log4j.rootLogger=info, stdout, RAll, RError, RMailError

        
        

      • WpisEntry

        Code Block
        log4j.logger.pl.psnc.dlibra.content.server.performContentConsistencyCheck=info, RConsistencyCheck

        należy rozszerzyć do postacishould be extended to the following form:

        Code Block
        log4j.logger.pl.psnc.dlibra.content.server.performContentConsistencyCheck=info, RConsistencyCheck, RMailError

        
        

   2. Set the basic parameters for the notifications to be sent:
      

      • The sample email address in line:

      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.

        should be replaced with the real address to which the notifications are to be sent.

      • In need, the message title can be changed so that it contains error messagesJeż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. Define the minimum threshold of the sent errors:
      

      • In the standard configuration, all notifications logged at the WARN level (minor problems), ERROR level (serious problems, which can lead to data loss), and FATAL errors (which make it impossible for the server to continue operation and can lead to data loss) are sent to the administrator. In order to limit the number of notifications sent to the administrator, the user can enter ERROR instead of WARN in line

      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

        
        

7. Uruchomić serwer dLibry - przy starcie wczyta on nowe ustawieniaRun the dLibra server; on startup, it will load the new settings.