administration af Jira-applikationer Support

Posted on

Definer eller rediger SMTP-mailserveren

  1. vælg Administration ( ) > System.
  2. vælg Mail > udgående Mail for at åbne siden SMTP mailserver.
    (info) hvis der ikke er defineret en SMTP-mailserver, vises en Konfigurer ny SMTP-mailserverknap på siden. Hvis en allerede er defineret, vises SMTP-mailserverens detaljer på siden sammen med et sæt operationslinks til højre.

  3. Klik enten på knappen Konfigurer ny SMTP-mailserver for at definere en ny SMTP-mailserver eller på linket Rediger til højre for at redigere den eksisterende SMTP-mailserver, som åbner siden Tilføj/Opdater SMTP-mailserver.

  4. udfyld det øverste afsnit på denne side som følger:

    navn

    Angiv et vilkårligt navn for at identificere denne SMTP-mailserverkonfiguration.

    varebeskrivelse

    (Valgfrit) Angiv en vilkårlig beskrivelse, der beskriver SMTP-mailserveren. Denne beskrivelse vises under navnet på SMTP-mailserveren på konfigurationssiden for SMTP-mailserveren.

    fra adresse

    Angiv den e-mail-adresse, der bruges i feltet ‘afsenderadresse’ (eller ‘fra’) i meddelelsesmeddelelser sendt af Jira, medmindre det tilsidesættes i en projektkonfiguration.
    (info)angiv kun en e-mailadresse for dette felt (f.eks. [email protected]). Jira vil bruge denne værdi til at konstruere den fulde ‘fra’ header baseret på den aktuelle bruger ("Joe Bloggs (Jira) <[email protected]>").
    for at ændre overskriften ‘ Fra ‘ skal du gå til Administration > System > generel konfiguration og (under Indstillinger) redigere feltet E-mail fra.

    e-mail-præfiks

    Angiv emnet for e-mails sendt fra denne server vil bruge denne streng som et præfiks. Dette er nyttigt for dine brugere, så de kan filtrere e-mail-meddelelser fra Jira baseret på dette præfiks.

    skærmbillede: Tilføj (eller Opdater) SMTP Mail Server

    Tilføj SMTP Mail Server side.

Angiv et værtsnavn eller en JNDI-placering for din SMTP-mailserver

den anden del af siden Tilføj/Opdater SMTP-mailserver angiver serveroplysningerne for den SMTP-mailserver, som Jira sender mail til. Der er to måder, du kan gøre dette på. Enten:

  • Angiv SMTP-værtsoplysningerne for din SMTP-mailserver;
    eller:
  • Angiv JNDI — placeringen af et javax.mail.Session objekt-det vil sige, brug JNDI til at slå en SMTP-mailserver op, som du har forudkonfigureret i din applikationsserver. Dette har følgende fordele:
    • bedre sikkerhed: mailoplysningerne er ikke tilgængelige for Jira-administratorer via Jira-administrationsgrænsefladen og gemmes ikke i Jira-Sikkerhedskopifiler.
    • flere SMTP-indstillinger: for eksempel kan du skifte til RSET i stedet for NOOP til testforbindelser ved at indstille egenskaben mail.smtp.userset.
    • centraliseret forvaltning: mailoplysninger er konfigureret på samme sted som databasedetaljer og kan konfigureres via dine applikationsserveradministrationsværktøjer.

Angiv SMTP-værtsoplysningerne

de fleste konfigurerer Jiras SMTP-mailserver ved at angive SMTP-værtsoplysningerne for denne mailserver direkte i Jira.

  1. udfyld følgende formularfelter i afsnittet SMTP-vært på siden Tilføj/Opdater SMTP-mailserver (ovenfor):

    tjenesteudbyder
    (ikke tilgængelig ved opdatering af en eksisterende SMTP-mailserver)

    Vælg mellem at bruge din egen SMTP-mailserver (dvs. Brugerdefineret) eller enten Gmail (dvs. Google Apps Mail / Gmail) eller Yahoo! (dvs. Yahoo! Mail Plus) som tjenesteudbyder til din SMTP-mailserver.
    (info) hvis du vælger enten Gmail eller Yahoo! indstillinger og skift derefter tilbage til brugerdefineret, nogle af nøglefelterne i dette afsnit udfyldes automatisk med de relevante SMTP-mailserverindstillinger for disse tjenesteudbydere.
    protokol

    Vælg mellem, om din SMTP-mailserver er en standard (dvs.SMTP) eller en sikker (dvs. SECURE_SMTP ) en.

    værtsnavn

    Angiv værtsnavnet eller IP-adressen på din SMTP-mailserver. Fx. smtp.yourcompany.com

    SMTP Port

    (Valgfrit) SMTP-portnummeret, normalt 25 for SMTP eller 465 for SMTPS, hvoraf begge antages, hvis dette felt er tomt.

    Timeout

    (Valgfrit) Angiv timeoutperioden i millisekunder, der behandles som 10000, hvis dette felt er tomt. Angivelse af 0 eller en negativ værdi her vil resultere i Jira venter på ubestemt tid for SMTP-serveren til at reagere.

    TLS

    (Valgfrit) Marker dette afkrydsningsfelt, hvis din SMTP-vært bruger protokollen Transport Layer Security (TLS).

    brugernavn

    (valgfrit) hvis din SMTP-vært kræver godkendelse, skal du angive brugernavnet på disse godkendelsesoplysninger her. (De fleste virksomhedsservere kræver godkendelse for at videresende mail til ikke-lokale brugere.)

    adgangskode

    (Valgfrit) igen, hvis din SMTP-vært kræver godkendelse, skal du angive adgangskoden, der er knyttet til det brugernavn, du har angivet ovenfor.
    (info) når du redigerer en eksisterende SMTP-mailserver, skal du markere afkrydsningsfeltet Skift adgangskode for at få adgang til og ændre dette felt.

    (advarsel) Bemærk venligst:

    • hvis din servers opstartsskript bruger systemegenskaberne -Dmail (f.eks. mail.smtp.host eller mail.smtp.port), tilsidesætter de indstillinger, du angiver i ovenstående formular. Derudover kan du om nødvendigt manuelt angive værtsnavnet, som Jira rapporterer om SMTP-serveren ved at indstille -Dmail.smtp.localhost

    • SMTP ‘ en skal understøtte multipart-indholdstypen. Uden denne mails vil ikke være i stand til at sende.
  2. (Valgfrit) Klik på knappen testforbindelse for at kontrollere, at Jira kan kommunikere med den SMTP-mailserver, du lige har konfigureret.
  3. Klik på knappen Tilføj (eller Opdater) for at gemme Jiras SMTP-mailserverkonfiguration.

Angiv en ‘JNDI-placering’

som et alternativ til at specificere SMTP-værtsoplysninger direkte i Jira kan du konfigurere dem på din applikationsserver og derefter slå en forudkonfigureret mailsession op via JNDI.

i afsnittet JNDI-placering på siden Tilføj/Opdater SMTP-mailserver (ovenfor) skal du angive placeringen af et javax.mail.Session – objekt, der skal bruges, når du sender e-mail, i feltet JNDI-placering. Dette begynder med præfikset java:comp/env/

konfiguration af en JNDI-placering

den JNDI-placering, du angiver i Jira, afhænger af Jiras applikationsserver og konfiguration. JNDI-placeringer konfigureres typisk i applikationsserveren, der kører Jira. Derfor skal Jira genstartes efter konfiguration af en JNDI-placering for at denne konfiguration skal være tilgængelig i Jira.

for eksempel i Tomcat 6 (applikationsserveren bundtet med ‘anbefalede’ distributioner af Jira), ville din JNDI-placering være java:comp/env/mail/JiraMailServer, og du ville tilføje følgende afsnit til conf/server.xml i din Jira-applikationsinstallationsmappe, inde i <Context/> node:

<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 hvis du ikke har brug for godkendelse (f. eks. hvis du sender via localhost, eller kun internt i virksomheden):

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

hvis du tilfældigvis kører Jira på en anden applikationsserver end Apache Tomcat (som ikke er en understøttet Jira-konfiguration), skal en lignende metode til konfiguration af en JNDI-placering til din SMTP-mailserver gælde for den pågældende applikationsserver.

hvis du har problemer med at oprette forbindelse, skal du tilføje en mail.debug="true" parameter til <Resource/> elementet (ovenfor), som giver dig mulighed for at se SMTP-niveau ‘debugging’ detaljer, når du tester forbindelsen.

Flyt JavaMail-klasserne

du skal også sikre dig, at JavaMail-klasserne (typisk i JAR-biblioteksfiler) er til stede i din applikationsservers classpath, og at disse ikke er i konflikt med Jiras JAR-biblioteksfiler. Dette er nødvendigt, fordi applikationsserveren selv (ikke Jira) etablerer SMTP-forbindelsen, og som sådan kan applikationsserveren ikke se JAR library-filerne i Jiras classloader.

nogle operativsystemer kan samle JavaMail-klasserne med applikationsservere (f.eks. Dette kan være i konflikt med Jiras kopi af JavaMail-klasserne, hvilket resulterer i fejl som:

java.lang.NoClassDefFoundError: javax/mail/Authenticator

eller:

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

lettere applikationsservere som Apache Tomcat (inklusive den, der er indarbejdet i de ‘anbefalede’ distributioner af Jira), leveres ikke altid med JavaMail.

for at undgå konflikter, Tjek din applikationsservers lib/ mappe:

  • hvis applikationsserveren allerede indeholder mail-1.4.1.jar og activation-1.1.1.jar, skal du bare fjerne mail-1.4.1.jar og activation-1.1.1.jar fra undermappen <jira-application-dir>/WEB-INF/lib/ i Jira-applikationsinstallationsmappen.
  • hvis applikationsserveren ikke indeholder mail-1.4.1.jar og activation-1.1.1.jar, skal du flytte mail-1.4.1.jar og activation-1.1.1.jar fra undermappen <jira-application-dir>/WEB-INF/lib/ i undermappen lib/ i Jira-installationsmappen (for ‘anbefalede’ distributioner af Jira) eller undermappen lib/ for den applikationsserver, der kører Jira.

SMTP over SSL

du kan kryptere e-mailkommunikation mellem Jira og din mailserver via SSL, forudsat at din mailserver understøtter SSL.

for det første skal du importere SMTP-servercertifikatet til en Java keystore. Processen er beskrevet på siden konfiguration af en SSL-forbindelse til Active Directory.

(advarsel) vigtig Note: uden at importere certifikatet kan Jira ikke kommunikere med din mailserver.

for det andet skal du redigere dine mailserverforbindelsesegenskaber og angive starttlsog SSLSocketFactory. Fra {$Jira_INSTALL}/conf/server.xml( dette eksempel bruger 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"/>

fejlfinding

et nyttigt tip til fejlfinding af mailrelaterede problemer i Jira er at indstille egenskaben -Dmail.debug=true ved opstart. Dette vil medføre, at detaljer på protokolniveau om Jiras e-mail-interaktioner logges. Derudover vises jiras logniveau, når tjenesten kører, og hvordan mails behandles.

almindelige problemer

  • hvis Jira ikke ser ud til at oprette eller sende e-mails eller oprette problemer og kommentarer fra e-mail, kan din Jira-installation opleve fejl i hukommelsen. Tjek venligst dine logfiler for OutOfMemory fejl. Hvis der er OutOfMemory fejl, skal du genstarte Jira og undersøge fejlene.
  • hvis du finder nogle indgående e-mails simpelthen forsvinder, skal du kontrollere, at du ikke ved et uheld har startet en anden kopi af Jira (f.eks. i en iscenesættelse miljø), som henter og sletter e-mails. Se siden Gendannelse af data for flag, du skal indstille for at forhindre, at mail behandles.
  • hvis du modtager ‘Mail Relay’ fejl, skal du sørge for at have angivet brugernavn og adgangskode i SMTP Host sektionen på Jiras SMTP Mail Server configuration side.

få hjælp

hvis du ikke selv kan løse et problem, skal du oprette en supportsag i ‘Jira’ – projektet, så hjælper vi.

Skriv et svar

Din e-mailadresse vil ikke blive publiceret.