Administrowanie aplikacjami Jira Support

Posted on

Zdefiniuj lub edytuj serwer poczty SMTP

  1. wybierz opcję Administracja ( ) > System.
  2. wybierz opcję Poczta > Poczta wychodząca, aby otworzyć stronę serwera poczty SMTP.
    (info) jeśli nie zdefiniowano serwera SMTP, na stronie pojawi się przycisk Konfiguruj nowy serwer SMTP. Jeśli został już zdefiniowany, dane serwera pocztowego SMTP zostaną wyświetlone na stronie wraz z zestawem linków operacyjnych po prawej stronie.

  3. kliknij przycisk Konfiguruj nowy serwer pocztowy SMTP, aby zdefiniować nowy serwer pocztowy SMTP, lub link Edytuj po prawej stronie, aby edytować istniejący serwer pocztowy SMTP, który otworzy stronę Dodaj/zaktualizuj serwer pocztowy SMTP.

  4. wypełnij górną część tej strony w następujący sposób:

    Nazwa

    podaj dowolną nazwę, aby zidentyfikować konfigurację serwera pocztowego SMTP.

    opis

    (opcjonalne) określa dowolny opis, który opisuje serwer pocztowy SMTP. Opis ten znajduje się pod nazwą serwera pocztowego SMTP na stronie konfiguracji serwera pocztowego SMTP.

    z adresu

    Określ adres e-mail używany w polu „adres nadawcy” (lub „od”) wiadomości powiadomień wysyłanych przez Jira, chyba że zostanie nadpisany w konfiguracji projektu.
    (info) podaj tylko adres e-mail dla tego pola (np. [email protected]). Jira użyje tej wartości do skonstruowania pełnego nagłówka 'from’ na podstawie bieżącego użytkownika ("Joe Bloggs (Jira) <[email protected]>").
    aby zmienić nagłówek „od”, przejdź do Administracja > System > ogólna konfiguracja i (w Ustawieniach) edytuj e-mail z pola.

    prefiks e-mail

    Określ temat wiadomości e-mail wysyłanych z tego serwera użyje tego ciągu jako prefiksu. Jest to przydatne dla użytkowników, którzy mogą filtrować powiadomienia e-mail z Jira na podstawie tego prefiksu.

    zrzut ekranu: Dodaj (lub zaktualizuj) serwer pocztowy SMTP

    Dodaj stronę serwera pocztowego SMTP.

Określ nazwę hosta lub lokalizację JNDI dla serwera poczty SMTP

druga część strony Dodaj / zaktualizuj serwer poczty SMTP określa szczegóły serwera poczty SMTP, do którego Jira będzie wysyłać pocztę. Można to zrobić na dwa sposoby. Albo:

  • określ szczegóły hosta SMTP serwera poczty SMTP;
    lub:
  • określ lokalizację JNDI obiektu javax.mail.Session — to znaczy użyj JNDI, aby wyszukać serwer poczty SMTP wstępnie skonfigurowany na serwerze aplikacji. Ma to następujące zalety:
    • lepsze bezpieczeństwo: szczegóły poczty nie są dostępne dla administratorów Jira za pośrednictwem interfejsu administracyjnego Jira i nie są przechowywane w plikach kopii zapasowych Jira.
    • więcej opcji SMTP: na przykład, możesz przełączyć się na RSET zamiast NOOP do testowania połączeń, ustawiając właściwość mail.smtp.userset.
    • scentralizowane zarządzanie: szczegóły poczty są konfigurowane w tym samym miejscu Co szczegóły bazy danych i mogą być konfigurowane za pomocą narzędzi administracyjnych serwera aplikacji.

określ szczegóły hosta SMTP

większość osób konfiguruje serwer poczty SMTP Jira, podając szczegóły hosta SMTP tego serwera poczty bezpośrednio w Jira.

  1. w sekcji host SMTP na stronie Dodaj/zaktualizuj serwer pocztowy SMTP (powyżej) wypełnij następujące pola formularza:

    Usługodawca
    (niedostępny podczas aktualizacji istniejącego serwera poczty SMTP)

    Wybierz pomiędzy używaniem własnego serwera pocztowego SMTP (np. niestandardowego) lub Gmaila (np. Google Apps Mail / Gmail) lub Yahoo! (np. Yahoo! Mail Plus) jako dostawca usług dla serwera poczty SMTP.
    (info) jeśli wybierzesz Gmail lub Yahoo! opcje, a następnie przełącz się z powrotem na niestandardowe, niektóre z kluczowych pól w tej sekcji zostaną automatycznie wypełnione odpowiednimi ustawieniami serwera pocztowego SMTP dla tych dostawców usług.
    protokół

    Wybierz pomiędzy serwerem pocztowym SMTP standardowym (np. SMTP) lub bezpiecznym (np. SECURE_SMTP).

    Nazwa hosta

    Określ nazwę hosta lub adres IP serwera poczty SMTP. Np. smtp.yourcompany.com

    Port SMTP

    (Opcjonalnie) numer portu SMTP, zwykle 25 dla SMTP lub 465 dla SMTPS, z których każdy przyjmuje się, jeśli to pole jest puste.

    Timeout

    (opcjonalne) określa okres timeout w milisekundach, który jest traktowany jako 10000, jeśli to pole jest puste. Podanie tutaj wartości 0 lub ujemnej spowoduje, że Jira będzie czekać w nieskończoność na odpowiedź serwera SMTP.

    TLS

    (Opcjonalnie) Zaznacz to pole wyboru, jeśli twój host SMTP używa protokołu TLS (Transport Layer Security).

    nazwa użytkownika

    (opcjonalnie) jeśli twój host SMTP wymaga uwierzytelnienia, podaj tutaj nazwę Użytkownika tych poświadczeń uwierzytelniania. (Większość serwerów firmowych wymaga uwierzytelniania w celu przekazywania poczty do użytkowników spoza regionu.)

    hasło

    (Opcjonalnie) ponownie, jeśli twój host SMTP wymaga uwierzytelnienia, spyfikuj Hasło powiązane z nazwą użytkownika podaną powyżej.
    (info) podczas edycji istniejącego serwera poczty SMTP zaznacz pole wyboru Zmień hasło, aby uzyskać dostęp I zmienić to pole.

    (Uwaga) :

    • jeśli skrypt startowy serwera korzysta z właściwości systemu -Dmail (np. mail.smtp.host lub mail.smtp.port), nadpisują One ustawienia określone w powyższym formularzu. Dodatkowo w razie potrzeby można ręcznie określić nazwę hosta, którą Jira zgłasza do serwera SMTP, ustawiając -Dmail.smtp.localhost

    • SMTP musi obsługiwać typ zawartości wieloczęściowej. Bez tego maile nie będą w stanie wysłać.
  2. (Opcjonalnie) kliknij przycisk Testuj połączenie, aby sprawdzić, czy Jira może komunikować się z skonfigurowanym serwerem pocztowym SMTP.
  3. kliknij przycisk Dodaj (lub zaktualizuj), aby zapisać konfigurację serwera pocztowego Jira SMTP.

określ „lokalizację JNDI”

jako alternatywę dla określania szczegółów hosta SMTP bezpośrednio w Jira, możesz skonfigurować je na serwerze aplikacji, a następnie wyszukać wstępnie skonfigurowaną sesję poczty za pośrednictwem JNDI.

w sekcji Lokalizacja JNDI na stronie Dodaj/zaktualizuj serwer poczty SMTP (powyżej) określ lokalizację obiektu javax.mail.Session używanego podczas wysyłania wiadomości e-mail w polu Lokalizacja JNDI. Zaczyna się od prefiksu java:comp/env/

Konfigurowanie lokalizacji JNDI

lokalizacja JNDI określona w Jira będzie zależeć od serwera aplikacji i konfiguracji Jira. Lokalizacje JNDI są zazwyczaj konfigurowane na serwerze aplikacji, na którym działa Jira. Dlatego po skonfigurowaniu lokalizacji JNDI konieczne będzie ponowne uruchomienie Jira, aby ta konfiguracja była dostępna w Jira.

na przykład w Tomcat 6 (serwerze aplikacji w pakiecie z „zalecanymi” dystrybucjami Jira) lokalizacja JNDI wynosiłaby java:comp/env/mail/JiraMailServer i dodałbyś następującą sekcję do conf/server.xml katalogu instalacyjnego aplikacji Jira, wewnątrz węzła <Context/> :

<Context path="" docBase="${catalina.home}/atlassian-jira" reloadable="false"> ... <Resource name="mail/JiraMailServer" auth="Container" type="javax.mail.Session" mail.smtp.host="mail.yourcompany.com" mail.smtp.port="25" mail.transport.protocol="smtp" mail.smtp.auth="true" mail.smtp.user="jirauser" password="mypassword" /> ...</Context>

lub jeśli nie potrzebujesz uwierzytelnienia (np. jeśli wysyłasz za pośrednictwem localhost lub tylko wewnętrznie w firmie):

<Context path="" docBase="${catalina.home}/atlassian-jira" reloadable="false"> ... <Resource name="mail/JiraMailServer" auth="Container" type="javax.mail.Session" mail.smtp.host="localhost" mail.smtp.port="25" mail.transport.protocol="smtp" /> ...</Context>

Jeśli korzystasz z Jira na serwerze aplikacji innym niż Apache Tomcat (który nie jest obsługiwaną konfiguracją Jira), podobna metodologia konfiguracji lokalizacji JNDI na serwerze poczty SMTP powinna mieć zastosowanie do tego serwera aplikacji.

jeśli masz problemy z połączeniem, Dodaj parametr mail.debug="true" do elementu <Resource/> (powyżej), który pozwoli Ci zobaczyć szczegóły „debugowania” na poziomie SMTP podczas testowania połączenia.

przenoszenie klas JavaMail

należy również upewnić się, że klasy JavaMail (zwykle w plikach biblioteki JAR) są obecne w ścieżce klas serwera aplikacji i nie powodują one konfliktu z plikami Biblioteki Jar Jira. Jest to konieczne, ponieważ sam serwer aplikacji (nie Jira) ustanawia połączenie SMTP i dlatego serwer aplikacji nie widzi plików biblioteki JAR w programie classloader Jira.

niektóre systemy operacyjne mogą łączyć klasy JavaMail z serwerami aplikacji (np. Tomcat w Red Hat Enterprise Linux). Może to być sprzeczne z kopią klas JavaMail Jira, co może powodować błędy, takie jak:

java.lang.NoClassDefFoundError: javax/mail/Authenticator

lub:

java.lang.IllegalArgumentException: Mail server at location is not of required type javax.mail.Session.

lżejsze serwery aplikacji, takie jak Apache Tomcat (w tym ten włączony do „zalecanych” dystrybucji Jira), nie zawsze są dostarczane z JavaMail.

aby zapobiec konfliktom, sprawdź katalog serwera aplikacji lib/ :

  • jeśli serwer aplikacji zawiera już mail-1.4.1.jar i activation-1.1.1.jar, po prostu usuń mail-1.4.1.jar i activation-1.1.1.jar z podkatalogu <jira-application-dir>/WEB-INF/lib/ katalogu instalacyjnego aplikacji Jira.
  • jeśli serwer aplikacji nie zawiera mail-1.4.1.jar i activation-1.1.1.jar, przenieś mail-1.4.1.jar i activation-1.1.1.jar z podkatalogu <jira-application-dir>/WEB-INF/lib/ katalogu instalacyjnego aplikacji Jira do podkatalogu lib/ katalogu instalacyjnego Jira (dla „zalecanych” dystrybucji Jira) lub podkatalogu lib/ serwera aplikacji, na którym działa Jira.

SMTP przez SSL

możesz szyfrować komunikację e-mail między Jira a serwerem pocztowym za pomocą protokołu SSL, pod warunkiem, że twój serwer pocztowy obsługuje protokół SSL.

najpierw musisz zaimportować certyfikat serwera SMTP do magazynu kluczy Java. Proces ten opisano na stronie Konfigurowanie połączenia SSL z Active Directory.

(Uwaga: Bez zaimportowania certyfikatu Jira nie będzie w stanie komunikować się z Twoim serwerem pocztowym.

po drugie, Edytuj Właściwości połączenia serwera pocztowego i określ starttlsi SSLSocketFactory. Z {$Jira_INSTALL}/conf/server.xml (ten przykład wykorzystuje serwer Gmaila):

<Resource name="mail/GmailSmtpServer" auth="Container" type="javax.mail.Session" mail.smtp.host="smtp.gmail.com" mail.smtp.port="465" mail.smtp.auth="true" mail.smtp.user="[email protected]" password="mypassword" mail.smtp.starttls.enable="true" mail.smtp.socketFactory.class="javax.net.ssl.SSLSocketFactory"/>

Rozwiązywanie problemów

przydatną wskazówką do debugowania problemów związanych z pocztą w Jira jest ustawienie właściwości -Dmail.debug=true podczas uruchamiania. Spowoduje to rejestrowanie szczegółów interakcji poczty elektronicznej Jira na poziomie protokołu. Dodatkowo, włączenie poziomu dziennika JIRA pokaże, kiedy usługa jest uruchomiona i jak wiadomości są przetwarzane.

typowe problemy

  • jeśli Jira nie tworzy, nie wysyła wiadomości e-mail ani nie tworzy problemów i komentarzy z wiadomości e-mail, w instalacji Jira mogą występować błędy OutOfMemory. Sprawdź pliki dziennika pod kątem błędów OutOfMemory. Jeśli występują błędy OutOfMemory, uruchom ponownie Jira i zbadaj błędy.
  • jeśli zauważysz, że niektóre przychodzące wiadomości e-mail po prostu znikają, sprawdź, czy przypadkowo nie uruchomiłeś drugiej kopii Jira(np. w środowisku postoju), który jest pobieranie i usuwanie wiadomości e-mail. Zobacz stronę przywracanie danych dla flag, które należy ustawić, aby zapobiec przetwarzaniu poczty.
  • jeśli pojawią się błędy przekazywania poczty, upewnij się, że podałeś nazwę Użytkownika i hasło w sekcji Host SMTP na stronie konfiguracji serwera poczty SMTP Jira.

Uzyskiwanie pomocy

jeśli nie możesz samodzielnie rozwiązać problemu, utwórz zgłoszenie pomocy technicznej w projekcie „Jira”, a my pomożemy.

Dodaj komentarz

Twój adres e-mail nie zostanie opublikowany.