Jira-Toepassingen beheren ondersteuning

Gepubliceerd op

definieer of bewerk de SMTP-mailserver

  1. kies Beheer () > systeem.
  2. selecteer Mail > uitgaande e-Mail om de pagina SMTP-mailserver te openen.
    (info) als er geen SMTP-mailserver is gedefinieerd, wordt op de pagina een knop Nieuwe SMTP-mailserver configureren weergegeven. Als er al een is gedefinieerd, worden de details van de SMTP-mailserver op de pagina weergegeven, samen met een set operation links aan de rechterkant.

  3. klik op de knop Nieuwe SMTP-mailserver configureren om een nieuwe SMTP-mailserver te definiëren, of op de link Bewerken rechts om de bestaande SMTP-mailserver te bewerken, waarmee de pagina SMTP-mailserver toevoegen/bijwerken wordt geopend.

  4. vul het bovenste gedeelte van deze pagina als volgt in:

    naam

    Geef een willekeurige naam op om deze SMTP-mailserverconfiguratie te identificeren.

    omschrijving

    (optioneel) Geef een willekeurige beschrijving op die de SMTP-mailserver beschrijft. Deze beschrijving staat onder de naam van de SMTP-mailserver op de configuratiepagina van de SMTP-mailserver.

    van adres

    geef het e-mailadres op dat wordt gebruikt in het veld ‘afzenderadres’ (of ‘van’) van de door Jira verzonden notificatieberichten, tenzij deze in een projectconfiguratie zijn overschreven.
    (info) geef alleen een e-mailadres op voor dit veld (bijv. [email protected]). Jira zal deze waarde gebruiken om de volledige ‘from’ header te construeren op basis van de huidige gebruiker ("Joe Bloggs (Jira) <[email protected]>").
    om de ‘Van’ header te wijzigen, ga naar Administratie > systeem > algemene configuratie en (onder Instellingen), bewerk het e-mail van veld.

    Email prefix

    geef het onderwerp van e-mails verzonden vanaf deze server zal deze tekenreeks gebruiken als een voorvoegsel. Dit is handig voor uw gebruikers, zodat ze e-mailmeldingen van Jira kunnen filteren op basis van dit voorvoegsel.

    schermafdruk: SMTP-mailserver

    toevoegen Pagina SMTP-mailserver toevoegen.

Geef een hostnaam of JNDI-locatie op voor uw SMTP-mailserver

het tweede deel van de pagina SMTP-mailserver toevoegen/bijwerken specificeert de Serverdetails van de SMTP-mailserver waarnaar Jira e-mail zal verzenden. Je kunt dit op twee manieren doen. Hetzij:

  • geef de SMTP-hostdetails op van uw SMTP-mailserver;
    of:
  • specificeer de JNDI-locatie van een javax.mail.Session object-dat wil zeggen, gebruik JNDI om een SMTP-mailserver op te zoeken die u vooraf hebt geconfigureerd in uw toepassingsserver. Dit heeft de volgende voordelen:
    • betere beveiliging: de e-mailgegevens zijn niet beschikbaar voor JIRA-beheerders via de Jira-beheerinterface en worden niet opgeslagen in JIRA-back-upbestanden.
    • meer SMTP-opties: u kunt bijvoorbeeld overschakelen naar RSET in plaats van NOOP voor het testen van verbindingen door de eigenschap mail.smtp.userset in te stellen.
    • gecentraliseerd beheer: e-mailgegevens worden op dezelfde plaats geconfigureerd als databasegegevens en kunnen worden geconfigureerd via de hulpprogramma ‘ s voor het beheren van de toepassingsserver.

specificeer de SMTP host details

de meeste mensen configureren Jira ‘ s SMTP mailserver door de SMTP host details van deze mailserver direct in Jira op te geven.

  1. in de sectie SMTP-host van de pagina SMTP-mailserver toevoegen/bijwerken (hierboven), vult u de volgende formuliervelden in:

    serviceprovider
    (niet beschikbaar bij het bijwerken van een bestaande SMTP-mailserver)

    Kies tussen het gebruik van uw eigen SMTP-mailserver (dwz Custom), of Gmail (DWZ Google Apps Mail / Gmail) of Yahoo! (dat wil zeggen Yahoo! Mail Plus) als serviceprovider voor uw SMTP-mailserver.
    (info) als u Gmail of Yahoo!kiest opties en schakel vervolgens terug naar Aangepast, zullen sommige van de sleutelvelden in deze sectie automatisch worden gevuld met de relevante SMTP-mailserverinstellingen voor deze serviceproviders.
    Protocol

    kies of uw SMTP-mailserver een standaard (d.w.z. SMTP) of een secure (d.w.z. SECURE_SMTP ) is.

    hostnaam:

    Geef de hostnaam of het IP-adres van uw SMTP-mailserver op. Bijvoorbeeld. smtp.yourcompany.com

    SMTP-poort

    (optioneel) het SMTP-poortnummer, meestal 25 voor SMTP of 465 voor SMTPS, die beide worden aangenomen als dit veld leeg wordt gelaten.

    tijdslimiet

    (optioneel) specificeer de time-outperiode in milliseconden, die wordt behandeld als 10000 als dit veld leeg wordt gelaten. Het opgeven van 0 of een negatieve waarde hier zal resulteren in Jira wachten voor onbepaalde tijd op de SMTP-server om te reageren.

    TLS

    (optioneel) Schakel dit selectievakje in als uw SMTP-host het TLS-protocol (Transport Layer Security) gebruikt.

    gebruikersnaam

    (optioneel) als je SMTP host authenticatie vereist, geef je hier de gebruikersnaam van deze authenticatie referenties op. (De meeste bedrijfsservers vereisen authenticatie om mail door te sturen naar niet-lokale gebruikers.)

    wachtwoord

    (optioneel) nogmaals, als je SMTP host authenticatie vereist, spcify het wachtwoord dat is gekoppeld aan de gebruikersnaam die je hierboven hebt opgegeven.
    (info) schakel bij het bewerken van een bestaande SMTP-mailserver het selectievakje Wachtwoord wijzigen in om dit veld te openen en te wijzigen.

    (waarschuwing) let op:

    • als het opstartscript van uw server de systeemeigenschappen -Dmail gebruikt (bijvoorbeeld mail.smtp.host of mail.smtp.port), zullen zij de instellingen overschrijven die u in het bovenstaande formulier opgeeft. Bovendien kunt u, indien nodig, handmatig de hostnaam opgeven die Jira zelf rapporteert aan de SMTP-server door het instellen van -Dmail.smtp.localhost

    • de SMTP moet het multipart-inhoudstype ondersteunen. Zonder deze e-mails zullen niet in staat zijn om te verzenden.
  2. (optioneel) klik op de knop Verbinding testen om te controleren of Jira kan communiceren met de SMTP-mailserver die u zojuist hebt geconfigureerd.
  3. klik op de knop Toevoegen (of bijwerken) om Jira ‘ s SMTP-mailserverconfiguratie op te slaan.

Geef een ‘JNDI-locatie’

als alternatief voor het opgeven van SMTP-hostdetails direct in Jira, kunt u deze configureren in uw Toepassingsserver en vervolgens een vooraf geconfigureerde e-mailsessie opzoeken via JNDI.

geef in het gedeelte JNDI-locatie van de pagina SMTP-mailserver toevoegen/bijwerken (hierboven) de locatie op van een javax.mail.Session – object dat moet worden gebruikt bij het verzenden van e-mail, in het veld JNDI-locatie. Dit begint met het voorvoegsel java:comp/env/

het instellen van een JNDI locatie

de JNDI locatie die u opgeeft in Jira zal afhangen van Jira ‘ s Toepassingsserver en configuratie. JNDI-locaties worden meestal geconfigureerd in de toepassingsserver die Jira uitvoert. Vandaar dat Jira opnieuw gestart moet worden na het configureren van een JNDI locatie om die configuratie beschikbaar te maken in Jira.

bijvoorbeeld, in Tomcat 6 (de toepassingsserver gebundeld met ‘aanbevolen’ distributies van Jira), zou uw JNDI-locatie java:comp/env/mail/JiraMailServer zijn en zou u de volgende sectie toevoegen aan de conf/server.xml van uw JIRA-toepassingsinstallatiemap, binnen het <Context/> knooppunt:

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

of als u geen authenticatie nodig heeft (bijvoorbeeld als u via localhost verzendt, of alleen intern binnen het bedrijf):

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

als je toevallig Jira draait op een andere toepassingsserver dan Apache Tomcat (wat geen ondersteunde JIRA configuratie is), zou een vergelijkbare methodologie voor het configureren van een JNDI locatie op je SMTP mailserver van toepassing moeten zijn op die toepassingsserver.

als u problemen hebt met het verbinden, voeg dan een mail.debug="true" parameter toe aan het <Resource/> element (hierboven), waarmee u SMTP-niveau ‘debugging’ details kunt zien bij het testen van de verbinding.

Verplaats de JavaMail-klassen

u moet er ook voor zorgen dat de JavaMail-klassen (meestal in Jar-bibliotheekbestanden) aanwezig zijn in classpath van uw Toepassingsserver en dat deze niet conflicteren met Jira ‘ s JAR-bibliotheekbestanden. Dit is nodig omdat de applicatieserver zelf (niet Jira) de SMTP verbinding tot stand brengt en als zodanig de applicatieserver de JAR library bestanden in Jira ‘ s classloader niet kan zien.

sommige besturingssystemen kunnen de JavaMail klassen bundelen met applicatieservers (bijvoorbeeld Tomcat in Red Hat Enterprise Linux). Dit kan conflicteren met Jira ’s kopie van de JavaMail klassen, resulterend in fouten zoals:

java.lang.NoClassDefFoundError: javax/mail/Authenticator

of:

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

lichtere applicatieservers zoals Apache Tomcat (inclusief degene die is opgenomen in de’ aanbevolen ‘ distributies van Jira), komen niet altijd met JavaMail.

controleer de map lib/ van uw toepassingsserver om conflicten te voorkomen:

  • als de toepassingsserver al mail-1.4.1.jar en activation-1.1.1.jar bevat, verwijder dan gewoon mail-1.4.1.jar en activation-1.1.1.jar uit de <jira-application-dir>/WEB-INF/lib/ submap van de Jira toepassing installatie map.
  • als de toepassingsserver niet mail-1.4.1.jar en activation-1.1.1.jar bevat, verplaats dan de mail-1.4.1.jar en activation-1.1.1.jar van de <jira-application-dir>/WEB-INF/lib/ submap van de Jira-toepassingsinstallatiemap naar de lib/ submap van de Jira-installatiemap (voor ‘Aanbevolen’ distributies van Jira) of de lib/ submap van de toepassingsserver waarop Jira wordt uitgevoerd.

SMTP over SSL

u kunt e-mailcommunicatie tussen Jira en uw mailserver versleutelen via SSL, op voorwaarde dat uw mailserver SSL ondersteunt.

eerst moet u het SMTP-servercertificaat importeren in een Java-keystore. Het proces wordt beschreven op de pagina een SSL-verbinding met Active Directory configureren.

(waarschuwing) belangrijke opmerking: zonder het certificaat te importeren, kan Jira niet communiceren met uw mailserver.

ten tweede, bewerk de verbindingseigenschappen van uw mailserver en specificeer starttls en SSLSocketFactory. Vanaf {$Jira_INSTALL}/conf/server.xml (dit voorbeeld gebruikt de server van Gmail):

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

problemen oplossen

een handige tip voor het debuggen van mail-gerelateerde problemen in Jira is om de eigenschap -Dmail.debug=true in te stellen bij het opstarten. Dit zal ervoor zorgen protocol-niveau details van Jira ‘ s e-mail interacties worden gelogd. Bovendien, het draaien van Jira ‘ s log niveau zal laten zien wanneer de service wordt uitgevoerd en hoe e-mails worden verwerkt.

veel voorkomende problemen

  • als Jira geen e-mails lijkt te maken of te verzenden of problemen en opmerkingen van e-mail lijkt te maken, kan uw JIRA installatie foutieve herinneringen ervaren. Controleer uw logbestanden voor OutOfMemory fouten. Als er OutOfMemory fouten zijn, herstart Jira en onderzoek de fouten.
  • als u merkt dat sommige inkomende e-mails gewoon verdwijnen, controleer dan of u niet per ongeluk een tweede kopie van Jira bent gestart (bijv. in een staging omgeving) die e-mailberichten downloadt en verwijdert. Zie de pagina Gegevens herstellen voor vlaggen die u moet instellen om te voorkomen dat e-mail wordt verwerkt.
  • als u ‘Mail Relay’ – fouten ontvangt, zorg er dan voor dat u de gebruikersnaam en het wachtwoord hebt opgegeven in de sectie SMTP-Host van Jira ‘ s SMTP-mailserverconfiguratiepagina.

hulp ophalen

als u een probleem niet zelf kunt oplossen, maak dan een ondersteuningscase aan in het ‘Jira’ – project en wij zullen u helpen.

Geef een antwoord

Het e-mailadres wordt niet gepubliceerd.