administrera Jira applications Support

publicerat den

definiera eller redigera SMTP-e-postservern

  1. välj Administration ( ) > System.
  2. välj E-post > utgående e-post för att öppna sidan SMTP-e-postserver.
    (info) om ingen SMTP-e-postserver har definierats visas en knappen Konfigurera ny SMTP-e-postserver på sidan. Om en redan har definierats kommer SMTP-postserverns detaljer att visas på sidan, tillsammans med en uppsättning operationslänkar till höger.

  3. klicka antingen på knappen Konfigurera ny SMTP-e-postserver för att definiera en ny SMTP-e-postserver eller på länken Redigera till höger för att redigera den befintliga SMTP-e-postservern, som öppnar sidan Lägg till/uppdatera SMTP-e-postserver.

  4. fyll i det övre avsnittet på denna sida enligt följande:

    namn

    ange ett godtyckligt namn för att identifiera denna SMTP-postserverkonfiguration.

    beskrivning

    (valfritt) ange en godtycklig beskrivning som beskriver SMTP-e-postservern. Den här beskrivningen visas under namnet på SMTP-e-postservern på sidan Konfiguration av SMTP-e-postserver.

    från adress

    ange den e-postadress som används i fältet ’avsändaradress’ (eller ’från’) i aviseringsmeddelanden som skickas av Jira, såvida den inte åsidosätts i en projektkonfiguration.
    (info) ange bara en e-postadress för detta fält (t.ex. [email protected]). Jira använder detta värde för att konstruera hela’ från ’ – rubriken baserat på den aktuella användaren ("Joe Bloggs (Jira) <[email protected]>").
    om du vill ändra rubriken ’Från’ går du till Administration > System > allmän konfiguration och (under Inställningar) redigerar du fältet E-post från.

    e-postprefix

    ange ämnet för e-postmeddelanden som skickas från den här servern kommer att använda den här strängen som ett prefix. Detta är användbart för dina användare så att de kan filtrera e-postmeddelanden från Jira baserat på detta prefix.

    skärmbild: Lägg till (eller uppdatera) SMTP-e-postserver

    Lägg till SMTP-e-Postserversida.

ange ett värdnamn eller en JNDI-plats för din SMTP-e-postserver

den andra delen av sidan Lägg till/uppdatera SMTP-e-postserver anger serverinformationen för den SMTP-e-postserver som Jira skickar e-post till. Det finns två sätt att göra detta. Antingen:

  • ange SMTP-värdinformationen för din SMTP-e-postserver;
    eller:
  • ange JNDI-platsen för ett javax.mail.Session — objekt-det vill säga använd JNDI för att leta upp en SMTP-e-postserver som du har förkonfigurerat i din applikationsserver. Detta har följande fördelar:
    • bättre säkerhet: e-postinformationen är inte tillgänglig för Jira-administratörer via Jira – administrationsgränssnittet och lagras inte i Jira-Backupfiler.
    • fler SMTP-alternativ: du kan till exempel byta till RSET istället för NOOP för att testa anslutningar genom att ställa in egenskapen mail.smtp.userset.
    • centraliserad förvaltning: e-postinformation konfigureras på samma plats som databasinformation och kan konfigureras via administrationsverktygen för applikationsserver.

ange SMTP-värdinformation

de flesta konfigurerar Jiras SMTP-e-postserver genom att ange SMTP-värdinformation för den här e-postservern direkt i Jira.

  1. i avsnittet SMTP-värd på sidan Lägg till/uppdatera SMTP-e-postserver (ovan) fyller du i följande formulärfält:

    tjänsteleverantör
    (inte tillgänglig när du uppdaterar en befintlig SMTP-e-postserver)

    Välj mellan att använda din egen SMTP-postserver (dvs. anpassad), eller antingen Gmail (dvs. Google Apps Mail / Gmail) eller Yahoo! (dvs Yahoo! Mail Plus) som tjänsteleverantör för din SMTP-e-postserver.
    (info) om du väljer antingen Gmail eller Yahoo! alternativ och sedan växla tillbaka till anpassad, några av nyckelfälten i det här avsnittet fylls automatiskt med relevanta SMTP-e – postserverinställningar för dessa tjänsteleverantörer.
    protokoll

    Välj mellan om din SMTP-e-postserver är en standard (dvs. SMTP) eller en säker (dvs. SECURE_SMTP).

    värdnamn

    ange värdnamn eller IP-adress för din SMTP-e-postserver. T. ex. smtp.yourcompany.com

    SMTP-Port

    (valfritt) SMTP – portnumret, vanligtvis 25 för SMTP eller 465 för SMTPS, varav endera antas om detta fält lämnas tomt.

    Timeout

    (valfritt) ange timeout-perioden i millisekunder, som behandlas som 10000 om det här fältet lämnas tomt. Ange 0 eller ett negativt värde här kommer att resultera i Jira väntar på obestämd tid för SMTP-servern att svara.

    TLS

    (valfritt) markera den här kryssrutan om SMTP-värden använder protokollet Transport Layer Security (TLS).

    användarnamn

    (valfritt) om din SMTP-värd kräver autentisering anger du användarnamnet för dessa autentiseringsuppgifter här. (De flesta företagsservrar kräver autentisering för att vidarebefordra e-post till icke-lokala användare.)

    lösenord

    (valfritt) återigen, om din SMTP-värd kräver autentisering, spcify lösenordet som är associerat med användarnamnet du angav ovan.
    (info) när du redigerar en befintlig SMTP-e-postserver markerar du kryssrutan Ändra lösenord för att komma åt och ändra det här fältet.

    (varning) observera:

    • om serverns startskript använder systemegenskaperna -Dmail (t.ex. mail.smtp.host eller mail.smtp.port) åsidosätter de inställningar som du anger i formuläret ovan. Dessutom kan du vid behov manuellt ange värdnamnet som Jira rapporterar sig själv till SMTP-servern genom att ställa in -Dmail.smtp.localhost

    • SMTP måste stödja innehållstypen för flera delar. Utan denna post kommer inte att kunna skicka.
  2. (valfritt) klicka på knappen Test Connection för att kontrollera att Jira kan kommunicera med SMTP-e-postservern du just konfigurerat.
  3. klicka på knappen Lägg till (eller uppdatera) för att spara Jiras SMTP-postserverkonfiguration.

ange en ’JNDI-plats’

som ett alternativ till att ange SMTP-värdinformation direkt i Jira kan du konfigurera dem i din applikationsserver och sedan slå upp en förkonfigurerad e-postsession via JNDI.

i avsnittet JNDI-plats på sidan Lägg till/uppdatera SMTP-e-postserver (ovan) anger du platsen för ett javax.mail.Session – objekt som ska användas när du skickar e-post i fältet JNDI-plats. Detta börjar med prefixet java:comp/env/

konfigurera en JNDI-plats

den JNDI-plats som du anger i Jira beror på Jiras applikationsserver och konfiguration. JNDI-platser konfigureras vanligtvis i applikationsservern som kör Jira. Därför måste Jira startas om efter att ha konfigurerat en JNDI-plats för att konfigurationen ska vara tillgänglig i Jira.

till exempel i Tomcat 6 (applikationsservern som medföljer ’rekommenderade’ distributioner av Jira) skulle din JNDI-plats vara java:comp/env/mail/JiraMailServer och du skulle lägga till följande avsnitt i conf/server.xml i din Jira-programinstallationskatalog, inuti noden <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>

eller om du inte behöver autentisering (t. ex. om du skickar via localhost eller bara internt inom företaget):

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

om du råkar köra Jira på en annan applikationsserver än Apache Tomcat (som inte är en JIRA-konfiguration som stöds), bör en liknande metod för att konfigurera en JNDI-plats till din SMTP-e-postserver gälla för den applikationsservern.

om du har problem med att ansluta, Lägg till en mail.debug="true" parameter till <Resource/> elementet (ovan), som låter dig se SMTP-nivå ’felsökning’ detaljer när du testar anslutningen.

flytta JavaMail-klasserna

du måste också se till att JavaMail-klasserna (vanligtvis i Jar-biblioteksfiler) finns i programserverns klassväg och att dessa inte strider mot Jiras jar-biblioteksfiler. Detta är nödvändigt eftersom applikationsservern själv (inte Jira) etablerar SMTP-anslutningen och som sådan kan applikationsservern inte se JAR-biblioteksfilerna i Jiras classloader.

vissa operativsystem kan kombinera JavaMail-klasserna med applikationsservrar (t.ex. Tomcat i Red Hat Enterprise Linux). Detta kan komma i konflikt med Jiras kopia av JavaMail-klasserna, vilket resulterar i fel som:

java.lang.NoClassDefFoundError: javax/mail/Authenticator

eller:

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

lättare applikationsservrar som Apache Tomcat (inklusive den som ingår i de rekommenderade distributionerna av Jira), kommer inte alltid med JavaMail.

för att förhindra eventuella konflikter, kontrollera programserverns lib/ katalog:

  • om applikationsservern redan innehåller mail-1.4.1.jar och activation-1.1.1.jar, ta bara bort mail-1.4.1.jar och activation-1.1.1.jar från underkatalogen <jira-application-dir>/WEB-INF/lib/ i Jira-programinstallationskatalogen.
  • om programservern inte innehåller mail-1.4.1.jar och activation-1.1.1.jar flyttar du mail-1.4.1.jar och activation-1.1.1.jar från underkatalogen <jira-application-dir>/WEB-INF/lib/ i Jira programinstallationskatalogen till underkatalogen lib/ i Jira installationskatalogen (för distributioner av JIRA som rekommenderas) eller lib/ i programservern som kör Jira.

SMTP över SSL

du kan kryptera e-postkommunikation mellan Jira och din e-postserver via SSL, förutsatt att din e-postserver stöder SSL.

för det första måste du importera SMTP-servercertifikatet till en Java keystore. Processen beskrivs på sidan Konfigurera en SSL-anslutning till Active Directory.

(varning) viktig anmärkning: utan att importera certifikatet kommer Jira inte att kunna kommunicera med din e-postserver.

för det andra, redigera dina e-postserveranslutningsegenskaper och ange starttls och SSLSocketFactory. Från {$Jira_INSTALL}/conf/server.xml (det här exemplet använder Gmails server):

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

felsökning

ett användbart tips för felsökning av e-postrelaterade problem i Jira är att ställa in egenskapen -Dmail.debug=true vid start. Detta kommer att leda till att protokollnivåinformation om Jiras e-postinteraktioner loggas. Dessutom visar jiras loggnivå när tjänsten körs och hur e-postmeddelanden behandlas.

vanliga problem

  • om Jira inte verkar skapa eller skicka e-post eller skapa problem och kommentarer från e-post kan din Jira-installation uppleva OutOfMemory-fel. Kontrollera dina loggfiler för OutOfMemory fel. Om det finns OutOfMemory-fel, starta om Jira och undersök felen.
  • om du hittar några inkommande e-postmeddelanden helt enkelt försvinner, kontrollera att du inte av misstag har startat en andra kopia av Jira (t.ex. i en staging miljö) som hämtar och tar bort e-postmeddelanden. Se sidan återställa data för flaggor som du bör ställa in för att förhindra att e-post behandlas.
  • om du får ’Mail Relay’ fel, se till att du har angett användarnamn och lösenord i SMTP värd avsnitt av Jira s SMTP Mail Server konfigurationssida.

få hjälp

om du inte kan lösa ett problem själv, skapa ett supportärende i Jira-projektet så hjälper vi dig.

Lämna ett svar

Din e-postadress kommer inte publiceras.