Jira-Alkalmazások kezelése támogatás

az SMTP-levelezőszerver

1. válassza az Adminisztráció ( ) > rendszert.
2. válassza a Mail > kimenő levelek lehetőséget az SMTP levelezőkiszolgáló oldal megnyitásához.
   ha nincs megadva SMTP levelezőszerver, akkor az új SMTP levelezőszerver konfigurálása gomb jelenik meg az oldalon. Ha az egyik már meg van határozva, akkor az SMTP levelezőszerver adatai megjelennek az oldalon, a jobb oldalon található műveleti linkekkel együtt.

3. kattintson az új SMTP-levelezőkiszolgáló konfigurálása gombra egy új SMTP-levelezőkiszolgáló megadásához, vagy a jobb oldalon található Szerkesztés hivatkozásra a meglévő SMTP-levelezőkiszolgáló szerkesztéséhez, amely megnyitja az SMTP-levelezőkiszolgáló Hozzáadása/frissítése oldalt.

4. töltse ki az oldal felső részét az alábbiak szerint:

   név	adjon meg egy tetszőleges nevet az SMTP levelezőkiszolgáló konfigurációjának azonosításához.
   leírás	(választható) adjon meg egy tetszőleges leírást, amely leírja az SMTP-levelezőkiszolgálót. Ez a leírás az SMTP-levelezőkiszolgáló neve alatt jelenik meg az SMTP-levelezőkiszolgáló konfigurációs oldalán.
   címről	adja meg a Jira által küldött értesítési üzenetek ‘feladó címe’ (vagy ‘feladó’) mezőjében használt e-mail címet, kivéve, ha a projektkonfiguráció felülírja. csak e-mail címet adjon meg ehhez a mezőhöz (pl. [email protected]). A Jira ezt az értéket használja a teljes ‘from’ fejléc összeállításához az aktuális felhasználó alapján ("Joe Bloggs (Jira) <[email protected]>"). a ‘feladó’ fejléc módosításához lépjen az Administration > System > General Configuration (adminisztráció > rendszer > General Configuration (Általános konfiguráció) pontra, és (a Beállítások alatt) szerkessze az e-mail feladó mezőt.
   e-mail előtag	adja meg a szerverről küldött e-mailek tárgyát, amely ezt a karakterláncot előtagként használja. Ez hasznos a felhasználók számára, hogy ezen előtag alapján szűrhessék a Jira e-mail értesítéseit.

   képernyőkép: SMTP levelezőszerver hozzáadása (vagy frissítése)

   

adjon meg egy állomásnevet vagy JNDI-helyet az SMTP-levelezőkiszolgálóhoz

az SMTP-levelezőkiszolgáló hozzáadása/frissítése oldal második része meghatározza annak az SMTP-levelezőkiszolgálónak a kiszolgálói adatait, amelyre a Jira elküldi a leveleket. Két módja van, hogy ezt. Vagy:

• adja meg az SMTP-kiszolgáló SMTP-gazdagépének adatait;
  vagy:
• adja meg a javax.mail.Session objektum JNDI helyét — vagyis a JNDI segítségével keresse meg az alkalmazáskiszolgálón előre konfigurált SMTP-levelezőszervert. Ennek a következő előnyei vannak:
  • jobb biztonság: a levelezési adatok nem érhetők el a Jira adminisztrátorai számára a Jira adminisztrációs felületén keresztül, és nem tárolódnak a Jira biztonsági mentési fájljaiban.
  • további SMTP lehetőségek: például a mail.smtp.userset tulajdonság beállításával válthat az RSET-re a noop helyett a kapcsolatok teszteléséhez.
  • központi irányítás: a levelezési adatok az adatbázis adataival azonos helyen vannak konfigurálva, és az alkalmazáskiszolgáló felügyeleti eszközein keresztül konfigurálhatók.

adja meg az SMTP-gazdagép adatait

a Jira SMTP-levelezőszerverét a legtöbb ember úgy konfigurálja, hogy közvetlenül a Jira-ban adja meg ennek a levelezőszervernek az SMTP-gazdagép adatait.

1. az SMTP-levelezőkiszolgáló Hozzáadása/frissítése lap SMTP-gazdagép szakaszában (fent) töltse ki a következő űrlapmezőket:

   Szolgáltató (nem érhető el meglévő SMTP-levelezőszerver frissítésekor)	válasszon a saját SMTP levelezőszerver (azaz egyéni), vagy a Gmail (azaz a Google Apps Mail / Gmail) vagy a Yahoo! (azaz a Yahoo! Mail Plus), mint az SMTP-levelezőszerver szolgáltatója. ha a Gmailt vagy a Yahoo-t választja! Beállítások, majd váltson vissza az egyéni, néhány kulcsfontosságú mezők ebben a szakaszban automatikusan kitölti a vonatkozó SMTP-mail szerver beállításait ezeket a szolgáltatókat.
   protokoll	válassza ki, hogy az SMTP levelezőszerver szabványos (azaz SMTP) vagy biztonságos (azaz SECURE_SMTP).
   állomás neve	adja meg az SMTP-levelezőszerver gazdagépnevét vagy IP-címét. Eg. smtp.yourcompany.com
   SMTP Port	(nem kötelező) az SMTP-port száma, általában 25 az SMTP-hez vagy 465 az SMTPS-hez, amelyek bármelyikét feltételezzük, ha ezt a mezőt üresen hagyjuk.
   időtúllépés	(nem kötelező) adja meg az időtúllépési időszakot ezredmásodpercben, amelyet 10000-ként kezel, ha ezt a mezőt üresen hagyja. 0 vagy negatív érték megadása itt azt eredményezi, hogy a Jira határozatlan ideig vár az SMTP-kiszolgáló válaszára.
   TLS	(választható) jelölje be ezt a jelölőnégyzetet, ha az SMTP-gazdagép a Transport Layer Security (TLS) protokollt használja.
   felhasználónév	(nem kötelező) ha az SMTP-gazdagép hitelesítést igényel, itt adja meg a hitelesítési hitelesítő adatok felhasználónevét. (A legtöbb vállalati szerver hitelesítést igényel a levelek nem helyi felhasználóknak történő továbbításához.)
   jelszó	(opcionális) ismét, Ha az SMTP-gazdagép hitelesítést igényel, spcify a fent megadott felhasználónévhez társított jelszó. meglévő SMTP-levelezőszerver szerkesztésekor jelölje be a Jelszó módosítása jelölőnégyzetet a mező eléréséhez és módosításához.

   kérjük, vegye figyelembe:

   • ha a kiszolgáló indítási parancsfájlja a -Dmail rendszertulajdonságokat használja (például mail.smtp.host vagy mail.smtp.port), akkor azok felülírják a fenti űrlapon megadott beállításokat. Ezenkívül szükség esetén manuálisan is megadhatja azt a gazdagépnevet, amelyet a Jira jelent az SMTP-kiszolgálónak a beállításokkal -Dmail.smtp.localhost

   • az SMTP-nek támogatnia kell a többrészes tartalomtípust. E nélkül a levelek nem tudnak küldeni.
2. (opcionális) kattintson a kapcsolat tesztelése gombra annak ellenőrzéséhez, hogy a Jira képes-e kommunikálni az imént konfigurált SMTP levelezőszerverrel.
3. kattintson a Hozzáadás (vagy Frissítés) gombra a Jira SMTP levelezőszerver konfigurációjának mentéséhez.

adjon meg egy ‘JNDI helyet’

az SMTP-gazdagép adatainak a Jira-ban való közvetlen megadásának alternatívájaként konfigurálhatja azokat az alkalmazáskiszolgálón, majd megkereshet egy előre konfigurált e-mail munkamenetet a JNDI-n keresztül.

az SMTP-levelezőszerver Hozzáadása/frissítése oldal JNDI-hely szakaszában (fent) adja meg az e-mail küldésekor használni kívánt javax.mail.Session objektum helyét a JNDI-Hely mezőben. Ez a java:comp/env/

JNDI hely konfigurálása

a Jirában megadott JNDI hely a Jira alkalmazáskiszolgálójától és konfigurációjától függ. A JNDI-helyek általában a Jira-t futtató alkalmazáskiszolgálón vannak konfigurálva. Ezért a Jira-t újra kell indítani egy JNDI-hely konfigurálása után, hogy ez a konfiguráció elérhető legyen a Jira-ban.

például a Tomcat 6-ban (az alkalmazáskiszolgáló a Jira ‘ajánlott’ disztribúcióival együtt) a JNDI helye java:comp/env/mail/JiraMailServer lenne, és a következő részt hozzáadná a Jira alkalmazás telepítési könyvtárának conf/server.xml – jához, a <Context/> csomóponton belül:

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

vagy ha nem igényel hitelesítést (például ha localhoston keresztül küld, vagy csak a vállalaton belül):

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

ha a Jira-t az Apache Tomcat-tól eltérő alkalmazáskiszolgálón futtatja (amely nem támogatott Jira-konfiguráció), akkor a JNDI-hely SMTP-levelezőszerverre történő konfigurálásához hasonló módszert kell alkalmazni az adott alkalmazáskiszolgálóra.

ha problémái vannak a csatlakozással, adjon hozzá egy mail.debug="true" paramétert a <Resource/> elemhez (fent), amely lehetővé teszi az SMTP szintű hibakeresés részleteit a kapcsolat tesztelésekor.

a JavaMail osztályok áthelyezése

azt is meg kell győződnie arról, hogy a JavaMail osztályok (jellemzően a JAR könyvtár fájljaiban) megtalálhatók az alkalmazáskiszolgáló osztályútvonalában, és hogy ezek nem ütköznek a Jira JAR könyvtár fájljaival. Erre azért van szükség, mert maga az alkalmazáskiszolgáló (nem a Jira) hozza létre az SMTP kapcsolatot, és mint ilyen, az alkalmazáskiszolgáló nem látja a jar könyvtár fájljait a Jira classloaderében.

egyes operációs rendszerek a JavaMail osztályokat alkalmazáskiszolgálókkal köthetik össze(pl. Ez ütközhet a Jira JavaMail osztályok példányával, ami olyan hibákat eredményez, mint:

java.lang.NoClassDefFoundError: javax/mail/Authenticator

vagy:

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

a könnyebb alkalmazáskiszolgálók, mint például az Apache Tomcat (beleértve a Jira ‘ajánlott’ disztribúcióiba beépítetteket is), nem mindig jönnek a JavaMail-hez.

az ütközések elkerülése érdekében ellenőrizze az alkalmazáskiszolgáló lib/ könyvtárát:

• ha az alkalmazáskiszolgáló már tartalmaz mail-1.4.1.jar és activation-1.1.1.jar fájlokat, akkor egyszerűen távolítsa el az mail-1.4.1.jar és activation-1.1.1.jar fájlokat a Jira alkalmazás telepítési könyvtárának <jira-application-dir>/WEB-INF/lib/ alkönyvtárából.
• ha az alkalmazáskiszolgáló nem tartalmaz mail-1.4.1.jar és activation-1.1.1.jar fájlokat, akkor helyezze át a mail-1.4.1.jar és activation-1.1.1.jar könyvtárakat a Jira alkalmazástelepítési könyvtárának <jira-application-dir>/WEB-INF/lib/ alkönyvtárából a Jira telepítési könyvtárának lib/ alkönyvtárába (a Jira ‘ajánlott’ disztribúciói esetén) vagy a Jira-t futtató alkalmazáskiszolgáló lib/ alkönyvtárába.

SMTP SSL-en keresztül

titkosíthatja a Jira és a levelezőszerver közötti E-mail kommunikációt SSL-en keresztül, feltéve, hogy a levelezőszerver támogatja az SSL-t.

először is importálnia kell az SMTP szerver tanúsítványt egy Java kulcstárba. A folyamat leírása az SSL-kapcsolat konfigurálása az Active Directory-hoz oldalon található.

fontos megjegyzés: a tanúsítvány importálása nélkül a Jira nem tud kommunikálni a levelezőszerverrel.

másodszor, szerkessze a levelezőszerver kapcsolat tulajdonságait, és adja meg a starttls és SSLSocketFactoryértéket. From {$Jira_INSTALL}/conf/server.xml (ez a példa a Gmail szerverét használja):

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

hibaelhárítás

a Jira levelekkel kapcsolatos problémáinak hibakereséséhez hasznos tipp a -Dmail.debug=true tulajdonság beállítása indításkor. Ez a Jira e-mail interakcióinak protokollszintű részleteit fogja naplózni. Ezenkívül a Jira naplószintjének felfordítása megmutatja, hogy a szolgáltatás mikor fut, és hogyan dolgozzák fel az e-maileket.

gyakori problémák

• ha úgy tűnik, hogy a Jira nem hoz létre vagy küld e-maileket, vagy nem hoz létre problémákat és megjegyzéseket az e-mailekből, akkor a Jira telepítésekor memórián kívüli hibák tapasztalhatók. Kérjük, ellenőrizze a naplófájlok OutOfMemory hibák. Ha vannak OutOfMemory hibák, indítsa újra a Jira-t, és vizsgálja meg a hibákat.
• ha úgy találja, hogy néhány bejövő e-mail egyszerűen eltűnik, ellenőrizze, hogy nem véletlenül indította el a Jira második példányát (pl. staging környezetben), amely az e-mail üzenetek letöltését és törlését jelenti. Tekintse meg az adatok visszaállítása oldalon azokat a jelzőket, amelyeket be kell állítania a levelek feldolgozásának megakadályozására.
• ha ‘Mail Relay’ hibát kap, győződjön meg róla, hogy megadta a felhasználónevet és a jelszót a JIRA SMTP Mail Server konfigurációs oldalának SMTP Host szakaszában.

segítségkérés

ha nem tudja megoldani a problémát, kérjük, hozzon létre egy támogatási esetet a ‘Jira’ projektben, és mi segítünk.