Verwalten von Jira Applications Support

Posted on

Definieren oder bearbeiten Sie den SMTP-Mailserver

  1. Wählen Sie Administration ( ) > System.
  2. Wählen Sie E-Mail > Ausgehende E-Mail aus, um die Seite SMTP-Mailserver zu öffnen.
    (info) Wenn kein SMTP-Mailserver definiert wurde, wird auf der Seite die Schaltfläche Neuen SMTP-Mailserver konfigurieren angezeigt. Wenn bereits eine definiert wurde, werden die Details des SMTP-Mailservers auf der Seite zusammen mit einer Reihe von Operationslinks rechts angezeigt.

  3. Klicken Sie entweder auf die Schaltfläche Neuen SMTP-Mailserver konfigurieren, um einen neuen SMTP-Mailserver zu definieren, oder auf den Link Bearbeiten rechts, um den vorhandenen SMTP-Mailserver zu bearbeiten.

  4. Füllen Sie den oberen Abschnitt dieser Seite wie folgt aus:

    Bezeichnung

    Geben Sie einen beliebigen Namen an, um diese SMTP-Mailserver-Konfiguration zu identifizieren.

    Beschreibung

    ( Optional) Geben Sie eine beliebige Beschreibung an, die den SMTP-Mailserver beschreibt. Diese Beschreibung wird unter dem Namen des SMTP-Mailservers auf der Seite SMTP-Mailserver-Konfiguration angezeigt.

    Von Adresse

    Geben Sie die E-Mail-Adresse an, die im Feld ‚Absenderadresse‘ (oder ‚von‘) von Benachrichtigungen verwendet wird, die von Jira gesendet werden, sofern dies nicht in einer Projektkonfiguration überschrieben wird.
    (info) Geben Sie nur eine E-Mail-Adresse für dieses Feld an (z. B. [email protected]). Jira verwendet diesen Wert, um den vollständigen ‚from‘-Header basierend auf dem aktuellen Benutzer ("Joe Bloggs (Jira) <[email protected]>") zu erstellen.
    Um den Header ‚von‘ zu ändern, gehen Sie zu Administration > System > Allgemeine Konfiguration und bearbeiten Sie (unter Einstellungen) das Feld E-Mail von.

    E-Mail-Präfix

    Geben Sie den Betreff von E-Mails an, die von diesem Server gesendet werden. Dies ist für Ihre Benutzer nützlich, damit sie E-Mail-Benachrichtigungen von Jira basierend auf diesem Präfix filtern können.

    Bildschirmfoto: SMTP-Mailserver hinzufügen (oder aktualisieren)

    Seite SMTP-Mailserver hinzufügen.

Geben Sie einen Hostnamen oder einen JNDI-Speicherort für Ihren SMTP-Mailserver an

Im zweiten Teil der Seite SMTP-Mailserver hinzufügen/aktualisieren werden die Serverdetails des SMTP-Mailservers angegeben, an den Jira E-Mails sendet. Es gibt zwei Möglichkeiten, dies zu tun. Entweder:

  • geben Sie die SMTP-Hostdetails Ihres SMTP-Mailservers an;
    oder:
  • Geben Sie den JNDI—Speicherort eines javax.mail.Session-Objekts an, d. h. verwenden Sie JNDI, um einen SMTP-Mailserver nachzuschlagen, den Sie in Ihrem Anwendungsserver vorkonfiguriert haben. Dies hat folgende Vorteile:
    • Bessere Sicherheit: Die Maildetails stehen Jira-Administratoren nicht über die Jira-Administrationsoberfläche zur Verfügung und werden nicht in Jira-Sicherungsdateien gespeichert.
    • Weitere SMTP-Optionen: Sie können beispielsweise zum Testen von Verbindungen zu RSET anstelle von NOOP wechseln, indem Sie die Eigenschaft mail.smtp.userset festlegen.
    • Zentrale Verwaltung: E-Mail-Details werden an derselben Stelle wie Datenbankdetails konfiguriert und können über Ihre Anwendungsserver-Verwaltungstools konfiguriert werden.

Geben Sie die SMTP-Hostdetails an

Die meisten Benutzer konfigurieren den SMTP-Mailserver von Jira, indem Sie die SMTP-Hostdetails dieses Mailservers direkt in Jira angeben.

  1. Füllen Sie im Abschnitt SMTP-Host auf der Seite SMTP-Mailserver hinzufügen/aktualisieren (oben) die folgenden Formularfelder aus:

    Dienstanbieter
    (nicht verfügbar beim Aktualisieren eines vorhandenen SMTP-Mailservers)

    Wählen Sie zwischen Ihrem eigenen SMTP-Mailserver (z. B. benutzerdefiniert) oder Google Mail (z. B. Google Apps Mail / Gmail) oder Yahoo! (z.B. Yahoo! Mail Plus) als Dienstanbieter für Ihren SMTP-Mailserver.
    (info) Wenn Sie entweder Gmail oder Yahoo! einige der Schlüsselfelder in diesem Abschnitt werden automatisch mit den relevanten SMTP-Mailservereinstellungen für diese Dienstanbieter gefüllt.
    Protokoll

    Wählen Sie aus, ob Ihr SMTP-Mailserver ein Standard- (z. B. SMTP) oder ein sicherer (z. B. SECURE_SMTP) Mailserver ist.

    Hostname

    Geben Sie den Hostnamen oder die IP-Adresse Ihres SMTP-Mailservers an. Z. smtp.yourcompany.com

    SMTP-Port

    ( Optional) Die SMTP-Portnummer, normalerweise 25 für SMTP oder 465 für SMTPS, die beide angenommen werden, wenn dieses Feld leer gelassen wird.

    Timeout

    ( Optional) Geben Sie den Timeout-Zeitraum in Millisekunden an, der als 10000 behandelt wird, wenn dieses Feld leer gelassen wird. Wenn Sie hier 0 oder einen negativen Wert angeben, wartet Jira unbegrenzt auf die Antwort des SMTP-Servers.

    TLS

    ( Optional) Aktivieren Sie dieses Kontrollkästchen, wenn Ihr SMTP-Host das TLS-Protokoll (Transport Layer Security) verwendet.

    Benutzername

    ( Optional) Wenn Ihr SMTP-Host eine Authentifizierung erfordert, geben Sie hier den Benutzernamen dieser Authentifizierungsanmeldeinformationen an. (Die meisten Unternehmensserver erfordern eine Authentifizierung, um E-Mails an nicht lokale Benutzer weiterzuleiten.)

    Passwort

    ( Optional) Wenn Ihr SMTP-Host eine Authentifizierung erfordert, bestätigen Sie erneut das Kennwort, das mit dem oben angegebenen Benutzernamen verknüpft ist.
    (info) Aktivieren Sie beim Bearbeiten eines vorhandenen SMTP-Mailservers das Kontrollkästchen Kennwort ändern, um auf dieses Feld zuzugreifen und es zu ändern.

    ( warnung) Bitte beachten sie:

    • Wenn das Startskript Ihres Servers die Systemeigenschaften -Dmail verwendet (z. B. mail.smtp.host oder mail.smtp.port), überschreiben sie die Einstellungen, die Sie im obigen Formular angegeben haben. Darüber hinaus können Sie bei Bedarf den Hostnamen, den Jira selbst an den SMTP-Server meldet, manuell angeben, indem Sie Folgendes festlegen -Dmail.smtp.localhost

    • Das SMTP muss den Multipart-Inhaltstyp unterstützen. Ohne diese E-Mails werden nicht in der Lage sein zu senden.
  2. ( Optional) Klicken Sie auf die Schaltfläche Verbindung testen, um zu überprüfen, ob Jira mit dem soeben konfigurierten SMTP-Mailserver kommunizieren kann.
  3. Klicken Sie auf die Schaltfläche Hinzufügen (oder Aktualisieren), um die SMTP-Mailserver-Konfiguration von Jira zu speichern.

Geben Sie einen ‚JNDI-Speicherort‘ an

Alternativ zur Angabe von SMTP-Hostdetails direkt in Jira können Sie diese in Ihrem Anwendungsserver konfigurieren und dann eine vorkonfigurierte E-Mail-Sitzung über JNDI nachschlagen.

Geben Sie im Abschnitt JNDI-Speicherort auf der Seite SMTP-Mailserver hinzufügen/aktualisieren (oben) im Feld JNDI-Speicherort den Speicherort eines javax.mail.Session -Objekts an, das beim Senden von E-Mails verwendet werden soll. Dies beginnt mit dem Präfix java:comp/env/

Konfigurieren eines JNDI-Speicherorts

Der JNDI-Speicherort, den Sie in Jira angeben, hängt vom Anwendungsserver und der Konfiguration von Jira ab. JNDI-Speicherorte werden normalerweise auf dem Anwendungsserver konfiguriert, auf dem Jira ausgeführt wird. Daher muss Jira nach der Konfiguration eines JNDI-Speicherorts neu gestartet werden, damit diese Konfiguration in Jira verfügbar ist.

In Tomcat 6 (dem Anwendungsserver, der mit ‚empfohlenen‘ Jira-Distributionen gebündelt ist) lautet Ihr JNDI-Speicherort beispielsweise java:comp/env/mail/JiraMailServer, und Sie würden den folgenden Abschnitt zum conf/server.xml Ihres Jira-Anwendungsinstallationsverzeichnisses innerhalb des <Context/> -Knotens hinzufügen:

<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>

Oder wenn Sie keine Authentifizierung benötigen (z. B. wenn Sie über localhost senden oder nur intern innerhalb des Unternehmens):

<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>

Wenn Sie Jira auf einem anderen Anwendungsserver als Apache Tomcat ausführen (der keine unterstützte Jira-Konfiguration ist), sollte eine ähnliche Methode zum Konfigurieren eines JNDI-Speicherorts für Ihren SMTP-Mailserver für diesen Anwendungsserver gelten.

Wenn Sie Probleme beim Verbinden haben, fügen Sie dem <Resource/> -Element (oben) einen mail.debug="true" -Parameter hinzu, mit dem Sie beim Testen der Verbindung Details zum Debuggen auf SMTP-Ebene sehen können.

Verschieben der JavaMail-Klassen

Sie müssen auch sicherstellen, dass die JavaMail-Klassen (normalerweise in JAR-Bibliotheksdateien) im Klassenpfad Ihres Anwendungsservers vorhanden sind und nicht mit den JAR-Bibliotheksdateien von Jira in Konflikt stehen. Dies ist notwendig, da der Anwendungsserver selbst (nicht Jira) die SMTP-Verbindung herstellt und der Anwendungsserver daher die JAR-Bibliotheksdateien im Klassenlader von Jira nicht sehen kann.

Einige Betriebssysteme bündeln die JavaMail-Klassen möglicherweise mit Anwendungsservern (z. B. Tomcat in Red Hat Enterprise Linux). Dies kann zu Konflikten mit Jiras Kopie der JavaMail-Klassen führen, was zu folgenden Fehlern führt:

java.lang.NoClassDefFoundError: javax/mail/Authenticator

oder:

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

Leichtere Anwendungsserver wie Apache Tomcat (einschließlich des in den ‚empfohlenen‘ Distributionen von Jira enthaltenen) werden nicht immer mit JavaMail geliefert.

Überprüfen Sie das lib/ -Verzeichnis Ihres Anwendungsservers, um Konflikte zu vermeiden:

  • Wenn der Anwendungsserver bereits mail-1.4.1.jar und activation-1.1.1.jar enthält, entfernen Sie einfach mail-1.4.1.jar und activation-1.1.1.jar aus dem Unterverzeichnis <jira-application-dir>/WEB-INF/lib/ des Jira-Anwendungsinstallationsverzeichnisses.
  • Wenn der Anwendungsserver keine mail-1.4.1.jar und activation-1.1.1.jar enthält, verschieben Sie die mail-1.4.1.jar und activation-1.1.1.jar aus dem <jira-application-dir>/WEB-INF/lib/ -Unterverzeichnis des Jira-Anwendungsinstallationsverzeichnisses in das lib/ -Unterverzeichnis des Jira-Installationsverzeichnisses (für ‚empfohlene‘ Jira-Distributionen) oder in das lib/ -Unterverzeichnis des Anwendungsservers, auf dem Jira ausgeführt wird.

SMTP über SSL

Sie können die E-Mail-Kommunikation zwischen Jira und Ihrem Mailserver über SSL verschlüsseln, sofern Ihr Mailserver SSL unterstützt.

Zunächst müssen Sie das SMTP-Serverzertifikat in einen Java-Keystore importieren. Der Vorgang wird auf der Seite Konfigurieren einer SSL-Verbindung zu Active Directory beschrieben.

( warnung) Wichtiger Hinweis: Ohne den Import des Zertifikats kann Jira nicht mit Ihrem Mailserver kommunizieren.

Bearbeiten Sie zweitens Ihre Mailserver-Verbindungseigenschaften und geben Sie starttls und SSLSocketFactory an. Von {$Jira_INSTALL}/conf/server.xml (in diesem Beispiel wird der Google Mail-Server verwendet):

<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"/>

Fehlerbehebung

Ein nützlicher Tipp zum Debuggen von E-Mail-Problemen in Jira ist das Festlegen der Eigenschaft -Dmail.debug=true beim Start. Dadurch werden Details auf Protokollebene zu den E-Mail-Interaktionen von Jira protokolliert. Wenn Sie außerdem die Protokollebene von JIRA aktivieren, wird angezeigt, wann der Dienst ausgeführt wird und wie E-Mails verarbeitet werden.

Häufige Probleme

  • Wenn Jira anscheinend keine E-Mails erstellt oder sendet oder Probleme und Kommentare aus E-Mails erstellt, können in Ihrer Jira-Installation OutOfMemory-Fehler auftreten. Bitte überprüfen Sie Ihre Log-Dateien auf OutOfMemory-Fehler. Wenn OutOfMemory-Fehler auftreten, starten Sie Jira neu und untersuchen Sie die Fehler.
  • Wenn Sie feststellen, dass einige eingehende E-Mails einfach verschwinden, überprüfen Sie, ob Sie nicht versehentlich eine zweite Kopie von Jira gestartet haben (z. b. in einer Staging-Umgebung), die E-Mail-Nachrichten herunterlädt und löscht. Auf der Seite Daten wiederherstellen finden Sie Flags, die Sie festlegen sollten, um die Verarbeitung von E-Mails zu verhindern.
  • Wenn Sie ‚Mail Relay‘-Fehler erhalten, stellen Sie sicher, dass Sie den Benutzernamen und das Kennwort im Abschnitt SMTP-Host auf der Konfigurationsseite des SMTP-Mailservers von Jira angegeben haben.

Hilfe erhalten

Wenn Sie ein Problem nicht selbst lösen können, erstellen Sie bitte einen Supportfall im ‚Jira‘-Projekt.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht.