Jira-Sovellusten hallinnointi tuki

Posted on

Määrittele tai muokkaa SMTP-sähköpostipalvelinta

  1. valitse hallinto ( ) > järjestelmä.
  2. valitse Posti > lähtevä posti avataksesi SMTP-sähköpostipalvelimen sivun.
    (info) Jos SMTP-sähköpostipalvelinta ei ole määritelty, sivulla näytetään uuden SMTP-sähköpostipalvelimen Configure-painike. Jos sellainen on jo määritelty, niin SMTP-sähköpostipalvelimen tiedot näkyvät sivulla, sekä joukko toimintalinkkejä oikealla.

  3. napsauta joko Configure new SMTP mail server-painiketta määrittääksesi uuden SMTP mail server-palvelimen tai Muokkaa-linkkiä oikeassa kohdassa muokataksesi olemassa olevaa SMTP mail server-palvelinta, joka avaa Lisää/Päivitä SMTP-sähköpostipalvelin-sivun.

  4. täytä sivun yläosa seuraavasti:

    nimi

    määritä mielivaltainen nimi tunnistaaksesi tämän SMTP-sähköpostipalvelimen kokoonpanon.

    tavaran kuvaus

    (valinnainen) Määritä mielivaltainen kuvaus, joka kuvaa SMTP-sähköpostipalvelinta. Tämä kuvaus näkyy SMTP-sähköpostipalvelimen nimen alla SMTP-sähköpostipalvelimen määrityssivulla.

    osoitteesta

    määritä sähköpostiosoite, jota käytetään Jiran lähettämien ilmoitusviestien kentässä ”lähettäjäosoite” (tai ”lähettäjäosoite”), ellei sitä ohiteta projektikokoonpanossa.
    (info) määritä vain tämän kentän sähköpostiosoite (esim. [email protected]). Jira käyttää tätä arvoa muodostaakseen koko ”from” – otsikon nykyisen käyttäjän perusteella ("Joe Bloggs (Jira) <[email protected]>").
    jos haluat vaihtaa ”from” – otsikon, siirry kohtaan ”Administration > System > General Configuration” ja (asetukset), Muokkaa sähköpostia kentästä.

    sähköpostin etuliite

    Määritä tältä palvelimelta lähetettyjen sähköpostien aihe käyttää tätä merkkijonoa etuliitteenä. Tämä on hyödyllinen käyttäjille, jotta he voivat suodattaa Jiran sähköposti-ilmoituksia tämän etuliitteen perusteella.

    kuvakaappaus: Lisää (tai Päivitä) SMTP-sähköpostipalvelin

    lisää SMTP-sähköpostipalvelin sivu.

Määritä isäntänimi tai JNDI-sijainti SMTP-sähköpostipalvelimellesi

Lisää / Päivitä SMTP-sähköpostipalvelin-sivun toinen osa määrittää sen SMTP-sähköpostipalvelimen Palvelintiedot, jolle Jira lähettää sähköpostia. Voit tehdä tämän kahdella tavalla. Joko:

  • määritä SMTP-sähköpostipalvelimesi SMTP-palvelimen tiedot;
    tai:
  • määritä javax.mail.Session objektin JNDI — sijainti-eli käytä JNDI: tä hakeaksesi SMTP-sähköpostipalvelimen, jonka olet määrittänyt sovelluspalvelimessasi. Tällä on seuraavat edut:
    • parempi tietoturva: sähköpostin tiedot eivät ole Jiran ylläpitäjien saatavilla Jiran hallintaliittymän kautta, eivätkä ne tallennu Jiran varmuuskopiotiedostoihin.
    • lisää SMTP-vaihtoehtoja:esimerkiksi, voit vaihtaa RSET: iin noopin sijaan yhteyksien testaamiseksi asettamalla mail.smtp.userset – ominaisuuden.
    • keskitetty hallinto: sähköpostin tiedot on määritetty samassa paikassa kuin tietokannan tiedot, ja ne voidaan määrittää sovelluspalvelimen hallintatyökalujen kautta.

Määritä SMTP-palvelimen tiedot

useimmat ihmiset määrittävät Jiran SMTP-sähköpostipalvelimen määrittämällä tämän sähköpostipalvelimen SMTP-palvelimen tiedot suoraan Jirassa.

  1. täytä seuraavat lomakekentät Lisää/Päivitä SMTP-sähköpostipalvelin-sivun SMTP-isäntä-osiossa (yllä):

    palveluntarjoaja
    (ei saatavilla päivitettäessä olemassa olevaa SMTP-sähköpostipalvelinta)

    valitse, käytätkö omaa SMTP-sähköpostipalvelinta (eli mukautettua) vai joko Gmailia (eli Google Apps Mail / Gmail) tai Yahoo! (ts. Yahoo! Mail Plus) palveluntarjoajana SMTP-sähköpostipalvelimellesi.
    (info) jos valitset joko Gmailin tai Yahoo! asetukset ja sitten siirtyä takaisin Custom, joitakin keskeisiä kenttiä tässä osiossa automaattisesti asutetaan asiaankuuluvat SMTP sähköpostipalvelin asetukset näille palveluntarjoajille.
    protokolla

    Valitse, onko SMTP-sähköpostipalvelimesi standardi (eli SMTP ) vai turvallinen (eli SECURE_SMTP).

    palvelimen nimi

    Määritä SMTP-sähköpostipalvelimesi palvelimen nimi tai IP-osoite. Esim. smtp.yourcompany.com

    SMTP-portti

    (valinnainen) SMTP-portin numero, yleensä 25 SMTP: lle tai 465 SMTPS: lle, joista jompikumpi oletetaan, jos tämä kenttä jätetään tyhjäksi.

    aikalisä

    (valinnainen) ilmoitetaan millisekunteina ilmaistu aika, joka on 10000, jos tämä kenttä jätetään tyhjäksi. 0: n tai negatiivisen arvon määrittäminen tässä johtaa siihen, että JIRA odottaa loputtomiin SMTP-palvelimen vastausta.

    TLS

    (valinnainen) Valitse tämä valintaruutu, jos SMTP-isäntäsi käyttää Transport Layer Security (TLS) – protokollaa.

    käyttäjätunnus

    (valinnainen) Jos SMTP-palvelimesi vaatii todennuksen, määritä näiden tunnistustietojen käyttäjätunnus tässä. (Useimmat yrityksen palvelimet vaativat todennuksen, jotta posti välittyy muille kuin paikallisille käyttäjille.)

    salasana

    (valinnainen) jälleen, Jos SMTP isäntä vaatii todennus, spcify salasana liittyy käyttäjätunnuksen määritit edellä.
    (info) kun muokkaat olemassa olevaa SMTP-sähköpostipalvelinta, valitse Salasanan vaihtaminen-valintaruutu ja muuta tätä kenttää.

    (varoitus) huomaa:

    • jos palvelimesi käynnistyskomentosarja käyttää -Dmail järjestelmän ominaisuuksia (esim. mail.smtp.host tai mail.smtp.port), ne ohittavat yllä olevassa muodossa määrittämäsi asetukset. Lisäksi voit tarvittaessa määrittää manuaalisesti palvelimen nimen, jonka JIRA ilmoittaa itse SMTP-palvelimelle asettamalla -Dmail.smtp.localhost

    • SMTP: n on tuettava multipart-sisältötyyppiä. Ilman tätä sähköpostit eivät voi lähettää.
  2. (valinnainen) klikkaa Test Connection-painiketta tarkistaaksesi, että Jira voi kommunikoida juuri määrittämäsi SMTP-sähköpostipalvelimen kanssa.
  3. Tallenna Jiran SMTP-sähköpostipalvelimen asetukset napsauttamalla Lisää (tai Päivitä) – painiketta.

Määritä ”JNDI Location”

vaihtoehtona SMTP-palvelimen tietojen määrittämiselle suoraan Jirassa, voit määrittää ne sovelluspalvelimessasi ja etsiä sitten ennalta määritetyn sähköpostisession JNDI: n kautta.

määritä JNDI-Sijaintiosiossa Lisää/Päivitä SMTP-sähköpostipalvelin-sivulla (yllä) javax.mail.Session käytettävän objektin sijainti sähköpostin lähettämisessä JNDI-Sijaintikentässä. Tämä alkaa etuliitteellä java:comp/env/

JNDI-sijainnin määrittäminen

jirassa määrittämäsi JNDI-sijainti riippuu Jiran sovelluspalvelimesta ja asetuksista. JNDI-sijainnit määritetään tyypillisesti sovelluspalvelimessa, joka käyttää jiraa. Näin ollen Jira on käynnistettävä uudelleen JNDI-sijainnin määrittämisen jälkeen, jotta kyseinen kokoonpano olisi käytettävissä Jirassa.

esimerkiksi Tomcat 6 :ssa (sovelluspalvelin nipussa jiran ”suositeltujen” jakeluiden kanssa) JNDI-sijaintisi olisi java:comp/env/mail/JiraMailServer ja lisäisit seuraavan osion jira-sovelluksen asennushakemiston conf/server.xml <Context/> – solmun sisään:

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

tai jos et vaadi tunnistautumista (esim. Jos lähetät localhostin kautta tai vain yrityksen sisällä):

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

jos käytät jiraa muulla sovelluspalvelimella kuin Apache Tomcatilla (joka ei ole tuettu Jira-määritys), samaa menetelmää JNDI-sijainnin määrittämiseen SMTP-sähköpostipalvelimelle olisi sovellettava kyseiseen sovelluspalvelimeen.

jos sinulla on ongelmia yhteyden muodostamisessa, lisää mail.debug="true" parametri <Resource/> elementtiin (yllä), jolloin näet SMTP-tason ”virheenkorjaus” – yksityiskohdat liittymää testattaessa.

siirrä Javamail-luokkia

sinun on myös varmistettava, että javamail-luokat (tyypillisesti JAR-kirjastotiedostoissa) ovat sovelluspalvelimen hakutietokannassa ja että ne eivät ole ristiriidassa Jiran JAR-kirjastotiedostojen kanssa. Tämä on tarpeen, koska sovelluspalvelin itse (ei Jira) muodostaa SMTP-yhteyden ja sellaisena sovelluspalvelin ei näe JAR-kirjastotiedostoja Jiran classloaderissa.

jotkin käyttöjärjestelmät saattavat niputtaa JavaMail-luokat sovelluspalvelimiin (esimerkiksi Tomcat Red Hat Enterprise Linuxissa). Tämä voi olla ristiriidassa Jiran javamail-luokkien kopion kanssa, mikä johtaa virheisiin, kuten:

java.lang.NoClassDefFoundError: javax/mail/Authenticator

tai:

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

kevyemmät sovelluspalvelimet, kuten Apache Tomcat (mukaan lukien se, joka sisältyy Jiran ”suositeltuihin” jakeluihin), eivät aina tule Javamailin mukana.

ristiriitojen estämiseksi tarkista sovelluspalvelimen lib/ Hakemisto:

  • jos sovelluspalvelin sisältää jo mail-1.4.1.jar ja activation-1.1.1.jar, poista mail-1.4.1.jar ja activation-1.1.1.jar jira-sovelluksen asennushakemiston <jira-application-dir>/WEB-INF/lib/ alihakemistosta.
  • jos sovelluspalvelin ei sisällä mail-1.4.1.jar ja activation-1.1.1.jar, siirrä mail-1.4.1.jar ja activation-1.1.1.jar jira application installation Directoryn <jira-application-dir>/WEB-INF/lib/ alihakemistosta jira-asennushakemiston lib/ alihakemistoon (Jiran ”suositellut” jakelut) tai jiraa ajavan sovelluspalvelimen lib/ alihakemistoon.

SMTP over SSL

voit salata Jiran ja sähköpostipalvelimesi välisen sähköpostiyhteyden SSL: n kautta edellyttäen, että sähköpostipalvelimesi tukee SSL: ää.

ensin sinun on tuotava SMTP-palvelinvarmenne Java-näppäinyhdistelmään. Prosessi kuvataan SSL-yhteyden määrittämisessä Active Directory-sivulle.

(varoitus) Tärkeä huomautus: ilman varmenteen tuomista Jira ei pysty kommunikoimaan sähköpostipalvelimesi kanssa.

toiseksi muokkaa sähköpostipalvelinyhteyden ominaisuuksia ja määritä starttls ja SSLSocketFactory. Alkaen {$Jira_INSTALL}/conf/server.xml (tässä esimerkissä käytetään Gmailin palvelinta):

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

Vianetsintä

hyödyllinen vinkki sähköpostiin liittyvien ongelmien vianetsintään Jirassa on asettaa -Dmail.debug=true ominaisuus käynnistettäessä. Tämä aiheuttaa protokollatason tiedot Jiran sähköpostien vuorovaikutuksesta kirjautumisen. Lisäksi Jiran lokitason nostaminen näyttää, milloin palvelu on käynnissä ja miten sähköpostit käsitellään.

yleiset ongelmat

  • jos Jira ei näytä olevan luomassa tai lähettämässä sähköposteja tai luomassa ongelmia ja kommentteja sähköpostista, Jira-asennuksessasi voi olla ylimääräisiä virheitä. Tarkista lokitiedostoistasi, ettei virhettä ole. Jos on OutOfMemory virheitä, Käynnistä jira ja tutkia virheitä.
  • jos huomaat joidenkin saapuvien sähköpostien yksinkertaisesti katoavan, tarkista, ettet ole vahingossa aloittanut toista jira-kopiota (esim. lavastusympäristössä), joka lataa ja poistaa sähköpostiviestejä. Katso palauttaminen tiedot sivun liput sinun pitäisi asettaa estää postin käsittelyn.
  • jos saat ”Mail Relay” – virheitä, varmista, että olet määrittänyt käyttäjätunnuksen ja salasanan Jiran SMTP-sähköpostipalvelimen määrityssivun SMTP-Isäntäosiossa.

Avun saaminen

jos et voi ratkaista ongelmaa itse, luo tukitapaus ”Jira” – projektiin ja me autamme.

Vastaa

Sähköpostiosoitettasi ei julkaista.