Správa podpory aplikací Jira

Definujte nebo upravte poštovní server SMTP

1. zvolte Správa () > systém.
2. volbou Pošta > Odchozí pošta otevřete stránku poštovního serveru SMTP.
   pokud nebyl definován Žádný poštovní server SMTP, zobrazí se na stránce tlačítko Konfigurovat nový poštovní server SMTP. Pokud již byla definována, zobrazí se na stránce Podrobnosti poštovního serveru SMTP spolu se sadou provozních odkazů vpravo.

3. klikněte buď na tlačítko Konfigurovat nový poštovní server SMTP pro definování nového poštovního serveru SMTP, nebo na odkaz Upravit vpravo pro úpravu stávajícího poštovního serveru SMTP, který otevře stránku Přidat / aktualizovat poštovní Server SMTP.

4. vyplňte horní část této stránky následujícím způsobem:

   Název	Určete libovolný název pro identifikaci této konfigurace poštovního serveru SMTP.
   popis	(Volitelné) zadejte libovolný popis, který popisuje poštovní server SMTP. Tento popis se zobrazí pod názvem poštovního serveru SMTP na konfigurační stránce poštovního serveru SMTP.
   z adresy	uveďte e-mailovou adresu použitou v poli „adresa odesílatele“ (nebo „od“) oznamovacích zpráv odeslaných společností Jira, pokud není přepsána v konfiguraci projektu. zadejte pouze e-mailovou adresu pro toto pole (např. [email protected]). Jira použije tuto hodnotu k vytvoření úplné hlavičky ‚from‘ na základě aktuálního uživatele ("Joe Bloggs (Jira) <[email protected]>"). Chcete-li změnit hlavičku‘ z‘, přejděte do administrace > systém > Obecná konfigurace a (v části Nastavení) upravte e-mail z pole.
   předpona e-mailu	Určete předmět e-mailů odeslaných z tohoto Serveru bude tento řetězec používat jako předponu. To je užitečné pro vaše uživatele, aby mohli filtrovat e-mailová oznámení od Jira na základě této předpony.

   Screenshot: Přidat (nebo aktualizovat) poštovní server SMTP

   

zadejte název hostitele nebo umístění JNDI pro váš poštovní server SMTP

druhá část stránky Přidat / aktualizovat poštovní Server SMTP určuje podrobnosti serveru poštovního serveru SMTP, na který bude Jira odesílat poštu. Existují dva způsoby, jak to udělat. Buď:

• zadejte podrobnosti hostitele SMTP vašeho poštovního serveru SMTP;
  nebo:
• zadejte JNDI umístění objektu javax.mail.Session – to znamená, že pomocí JNDI vyhledejte poštovní server SMTP, který jste předkonfigurovali na aplikačním serveru. To má následující výhody:
  • lepší zabezpečení: e-mailové údaje nejsou k dispozici správcům Jira prostřednictvím administračního rozhraní Jira a nejsou uloženy v záložních souborech Jira.
  • další možnosti SMTP: můžete například přepnout na RSET místo NOOP pro testování připojení nastavením vlastnosti mail.smtp.userset.
  • centralizované řízení: poštovní údaje jsou konfigurovány na stejném místě jako údaje o databázi a mohou být konfigurovány pomocí nástrojů pro správu aplikačního serveru.

zadejte podrobnosti hostitele SMTP

většina lidí nakonfiguruje poštovní server SMTP Jira zadáním podrobností hostitele SMTP tohoto poštovního serveru přímo v Jira.

1. v části hostitele SMTP na stránce Přidat / aktualizovat poštovní Server SMTP (výše) vyplňte následující pole formuláře:

   poskytovatel služeb (není k dispozici při aktualizaci existujícího poštovního serveru SMTP)	vlastní), nebo buď Gmail (tj. Google Apps Mail / Gmail) nebo Yahoo! (tj. Yahoo! Mail Plus) jako poskytovatel služeb pro váš poštovní server SMTP. pokud zvolíte Gmail nebo Yahoo! možnosti a poté přepněte zpět na vlastní, některá klíčová pole v této části budou automaticky vyplněna příslušným nastavením poštovního serveru SMTP pro tyto poskytovatele služeb.
   protokol	Vyberte si mezi tím, zda je váš poštovní server SMTP standardní (tj.
   název hostitele	zadejte název hostitele nebo IP adresu poštovního serveru SMTP. Ego. smtp.yourcompany.com
   SMTP Port	(volitelné) číslo portu SMTP, obvykle 25 pro SMTP nebo 465 pro SMTP, které se předpokládá, pokud toto pole zůstane prázdné.
   Timeout	(Volitelné) zadejte časový limit v milisekundách, který je považován za 10000, pokud toto pole zůstane prázdné. Zadání 0 nebo záporné hodnoty zde bude mít za následek, že Jira čeká na odpověď serveru SMTP na neurčito.
   TLS	(Volitelné) zaškrtněte toto políčko, pokud váš hostitel SMTP používá protokol TLS (Transport Layer Security).
   uživatelské jméno	(volitelné) pokud váš hostitel SMTP vyžaduje ověření, zadejte zde uživatelské jméno těchto přihlašovacích údajů. (Většina firemních serverů vyžaduje autentizaci pro přenos pošty ne-lokálním uživatelům.)
   heslo	(Volitelné) Opět platí, že pokud váš hostitel SMTP vyžaduje ověření, spcify heslo spojené s uživatelským jménem, které jste zadali výše. při úpravách existujícího poštovního serveru SMTP zaškrtněte políčko Změnit heslo pro přístup a změňte toto pole.

   :

   • pokud spouštěcí skript vašeho serveru používá -Dmail systémové vlastnosti (např. mail.smtp.host nebo mail.smtp.port), přepíše nastavení, která zadáte ve výše uvedeném formuláři. V případě potřeby můžete také ručně zadat název hostitele, který Jira sama hlásí serveru SMTP nastavením -Dmail.smtp.localhost

   • SMTP musí podporovat vícedílný typ obsahu. Bez tohoto e-maily nebudou moci posílat.
2. (Volitelné) klepnutím na tlačítko testovací připojení zkontrolujte, zda Jira může komunikovat s právě nakonfigurovaným poštovním serverem SMTP.
3. klepnutím na tlačítko Přidat (nebo aktualizovat) uložte konfiguraci poštovního serveru SMTP společnosti Jira.

zadejte „umístění JNDI“

jako alternativu k zadání podrobností hostitele SMTP přímo v Jira je můžete nakonfigurovat na aplikačním serveru a poté vyhledat předkonfigurovanou relaci pošty přes JNDI.

v části Umístění JNDI na stránce Přidat/aktualizovat poštovní Server SMTP (výše) zadejte umístění objektu javax.mail.Session, který chcete použít při odesílání e-mailů, do pole Umístění JNDI. Toto začne předponou java:comp/env/

konfigurace umístění JNDI

umístění JNDI, které zadáte v Jira, bude záviset na aplikačním serveru a konfiguraci Jira. Umístění JNDI se obvykle konfigurují na aplikačním serveru, na kterém běží Jira. Proto bude nutné restartovat Jira po konfiguraci umístění JNDI, aby byla tato konfigurace k dispozici v Jira.

například v Tomcat 6 (aplikační server dodávaný s „doporučenými“ distribucemi Jira) by vaše umístění JNDI bylo java:comp/env/mail/JiraMailServer a následující část byste přidali do conf/server.xml instalačního adresáře aplikace Jira uvnitř uzlu <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>

nebo pokud nevyžadujete ověření (např. pokud odesíláte prostřednictvím localhost, nebo pouze interně v rámci společnosti):

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

pokud používáte Jira na jiném aplikačním serveru než Apache Tomcat (což není podporovaná konfigurace Jira), měla by se na tento aplikační server použít podobná metodika pro konfiguraci umístění JNDI na váš poštovní server SMTP.

pokud máte problémy s připojením, přidejte parametr mail.debug="true" k prvku <Resource/> (výše), který vám umožní při testování připojení zobrazit podrobnosti „ladění“ na úrovni SMTP.

přesuňte třídy JavaMail

budete také muset zajistit, aby třídy JavaMail (obvykle v souborech knihovny jar) byly přítomny v cestě třídy vašeho aplikačního serveru a aby nebyly v rozporu se soubory knihovny Jira. To je nutné, protože samotný aplikační server (nikoli Jira) navazuje připojení SMTP a jako takový aplikační server nevidí soubory knihovny JAR v Jira classloader.

některé operační systémy mohou sdružovat třídy JavaMail s aplikačními servery (např. To může být v rozporu s Jiřinou kopií tříd JavaMail, což má za následek chyby jako:

java.lang.NoClassDefFoundError: javax/mail/Authenticator

nebo:

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

lehčí aplikační servery, jako je Apache Tomcat (včetně těch, které jsou začleněny do „doporučených“ distribucí Jira), ne vždy přicházejí s JavaMail.

Chcete-li zabránit konfliktům, zkontrolujte adresář lib/ vašeho aplikačního serveru:

• pokud aplikační server již obsahuje mail-1.4.1.jar a activation-1.1.1.jar, stačí odebrat mail-1.4.1.jar a activation-1.1.1.jar z podadresáře <jira-application-dir>/WEB-INF/lib/ instalačního adresáře aplikace Jira.
• pokud aplikační server neobsahuje mail-1.4.1.jar a activation-1.1.1.jar, přesuňte mail-1.4.1.jar a activation-1.1.1.jar z podadresáře <jira-application-dir>/WEB-INF/lib/ instalačního adresáře aplikace Jira do podadresáře lib/ instalačního adresáře Jira (pro „doporučené“ distribuce Jira) nebo lib/ podadresáře aplikačního serveru se systémem Jira.

SMTP přes SSL

můžete zašifrovat e-mailovou komunikaci mezi Jira a poštovním serverem pomocí SSL za předpokladu, že váš poštovní server podporuje SSL.

nejprve budete muset importovat certifikát serveru SMTP do úložiště klíčů Java. Proces je popsán na stránce Konfigurace připojení SSL ke službě Active Directory.

Důležitá poznámka: bez importu certifikátu nebude Jira schopna komunikovat s vaším poštovním serverem.

za druhé upravte vlastnosti připojení poštovního serveru a zadejte starttls a SSLSocketFactory. Od {$Jira_INSTALL}/conf/server.xml (tento příklad používá server Gmailu):

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

odstraňování problémů

užitečným tipem pro ladění problémů souvisejících s poštou v Jira je nastavení vlastnosti -Dmail.debug=true při spuštění. To způsobí protokolování podrobností o e-mailových interakcích Jira na úrovni protokolu. Navíc se objeví úroveň protokolu JIRA, kdy je služba spuštěna a jak jsou zpracovávány e-maily.

časté problémy

• pokud se nezdá, že by Jira vytvářela nebo odesílala e-maily nebo vytvářela problémy a komentáře z e-mailu, vaše instalace Jira může mít chyby OutOfMemory. Zkontrolujte soubory protokolu pro chyby OutOfMemory. Pokud se vyskytnou chyby OutOfMemory, restartujte Jira a prozkoumejte chyby.
• pokud zjistíte, že některé příchozí e-maily jednoduše zmizí, zkontrolujte, zda jste náhodou nezačali druhou kopii Jira (např. staging prostředí), který je stahování a mazání e-mailových zpráv. Na stránce obnovení dat najdete příznaky, které byste měli nastavit, abyste zabránili zpracování pošty.
• pokud se zobrazí chyby „Mail Relay“, ujistěte se, že jste zadali uživatelské jméno a heslo v části hostitele SMTP na konfigurační stránce poštovního serveru SMTP společnosti Jira.

Získání nápovědy

pokud nemůžete problém vyřešit sami, vytvořte prosím případ podpory v projektu „Jira“ a my vám pomůžeme.