Jiraアプリケーションサポートの管理

Posted on

SMTPメールサーバーの定義または編集

  1. 管理()>システムを選択します。
  2. Mail>Outgoing Mailを選択してSMTPメールサーバーページを開きます。
    (情報)SMTPメールサーバーが定義されていない場合、新しいSMTPメールサーバーの設定ボタンがページに表示されます。 すでに定義されている場合は、SMTPメールサーバーの詳細がページに表示され、右側に一連の操作リンクが表示されます。

  3. 新しいSMTPメールサーバーの設定ボタンをクリックして新しいSMTPメールサーバーを定義するか、右側の編集リンクをクリックして既存のSMTPメールサーバーを編集し、SMTPメー

  4. このページの一番上のセクションを次のように完了します:

    名前

    このSMTPメールサーバー構成を識別するための任意の名前を指定します。

    説明

    (省略可能)SMTPメールサーバーを説明する任意の説明を指定します。 この説明は、”SMTPメールサーバーの構成”ページのSMTPメールサーバーの名前の下に表示されます。

    Fromアドレス

    プロジェクト設定で上書きされない限り、Jiraが送信する通知メッセージの「送信者アドレス」(または「送信者」)フィールドで使用するメールアドレスを指定します。
    (info)このフィールドのメールアドレスのみを指定します(例:[email protected])。 Jiraはこの値を使用して、現在のユーザー("Joe Bloggs (Jira) <[email protected]>")に基づいて完全な’from’ヘッダーを構築します。
    ‘from’ヘッダーを変更するには、管理>システム>一般設定に移動し、（設定の下で）電子メールからフィールドを編集します。

    電子メールの接頭辞

    このサーバーから送信される電子メールの件名を指定すると、この文字列が接頭辞として使用されます。 これは、ユーザーがこの接頭辞に基づいてJiraからのメール通知をフィルタリングできるようにするのに便利です。

    スクリーンショット: SMTPメールサーバーの追加(または更新)ページ。

SMTPメールサーバーのホスト名またはJNDIの場所の指定

SMTPメールサーバーの追加/更新ページの2番目の部分では、Jiraがメールを送信するSMTPメールサーバーのサーバー詳細を指定し これを行うには2つの方法があります。 どちらか:

  • SMTPメールサーバーのSMTPホストの詳細を指定します。
    または:
  • javax.mail.SessionオブジェクトのJNDIの場所を指定します。 これには次の利点があります。

    • セキュリティの向上:メールの詳細は、Jira管理インターフェイスを介してJira管理者には利用できず、Jiraバックアップファイルに保存されません。たとえば、mail.smtp.usersetプロパティを設定することで、接続をテストするためにNOOPの代わりにRSETに切り替えることができます。
    • : メールの詳細は、データベースの詳細と同じ場所で構成され、アプリケーションサーバー管理ツールを使用して構成できます。

SMTPホストの詳細を指定する

ほとんどの人は、このメールサーバーのSMTPホストの詳細をJiraで直接指定することによって、JiraのSMTPメールサーバーを設定します。

  1. SMTPメールサーバーの追加/更新ページ(上記)のSMTPホストセクションで、次のフォームフィールドに入力します:

    サービスプロバイダー
    (既存のSMTPメールサーバーを更新する場合は使用できません)

    独自のSMTPメールサーバー（カスタム）を使用するか、Gmail（Google Apps Mail/Gmail）またはYahoo！ （Yahoo! Mail Plus)SMTPメールサーバーのサービスプロバイダーとして。
    (情報)GmailまたはYahoo! このセクションのいくつかのキーフィールドには、これらのサービスプロバイダーの関連するSMTPメールサーバー設定が自動的に入力されます。
    プロトコル

    SMTPメールサーバーが標準(SMTPなど)か安全な(SECURE_SMTPなど)かを選択します。

    ホスト名

    SMTPメールサーバーのホスト名またはIPアドレスを指定します。 例えば… smtp.yourcompany.com

    SMTPポート

    (SMTPポート番号通常はSMTPの場合は25、SMTPの場合は465で、このフィールドが空白のままの場合はどちらかが想定されます。

    タイムアウト

    (省略可能)タイムアウト期間をミリ秒単位で指定します。このフィールドを空白のままにすると、10000として扱われます。 ここで0または負の値を指定すると、JiraはSMTPサーバーが応答するまで無期限に待機します。

    TLS

    (省略可能)SMTPホストがTRANSPORT Layer Security(TLS)プロトコルを使用している場合は、このチェックボックスをオンにします。

    ユーザー名

    (省略可能)SMTPホストが認証を必要とする場合は、ここでこれらの認証資格情報のユーザー名を指定します。 (ほとんどの会社のサーバーでは、ローカル以外のユーザーにメールを中継するために認証が必要です。)

    パスワード

    (省略可能)SMTPホストが認証を必要とする場合は、上記で指定したユーザー名に関連付けられたパスワードをspcifyします。
    (情報)既存のSMTPメールサーバーを編集するときは、パスワードの変更チェックボックスを選択して、このフィールドにアクセスして変更します。

    (警告）ご注意ください:

    • サーバーのスタートアップスクリプトが-Dmailシステムプロパティ(mail.smtp.hostやmail.smtp.portなど)を使用している場合、上記の形式で指定した設定が上書きされます。 また、必要に応じて、JiraがSMTPサーバーに対して報告するホスト名を手動で指定することもできます。-Dmail.smtp.localhost

    • SMTPはマルチパートコンテンツタイプをサポートしている必要があります。 このメールがなければ、送信することはできません。
  2. (オプション)[接続のテスト]ボタンをクリックして、Jiraが設定したSMTPメールサーバーと通信できることを確認します。
  3. 追加（または更新）ボタンをクリックして、JiraのSMTPメールサーバー設定を保存します。

‘JNDIの場所’の指定

JIRAでSMTPホストの詳細を直接指定する代わりに、アプリケーションサーバーでそれらを設定し、jndiを介して事前設定されたメールセッ

SMTPメールサーバーの追加/更新ページ(上記)の「JNDIの場所」セクションで、電子メールの送信時に使用するjavax.mail.Sessionオブジェクトの場所を「JNDIの場所」フィールドに指定します。 これは接頭辞java:comp/env/

で始まりますJNDIの場所の設定

Jiraで指定したJNDIの場所は、Jiraのアプリケーションサーバーと設定によって異なります。 JNDIの場所は、通常、Jiraを実行するアプリケーションサーバーで構成されます。 そのため、Jiraで使用できるように設定するには、JNDIの場所を設定した後にJiraを再起動する必要があります。

たとえば、Tomcat6(Jiraの”推奨”ディストリビューションにバンドルされているアプリケーションサーバー)では、JNDIの場所はjava:comp/env/mail/JiraMailServerになり、Jiraアプリケーションインストールディレク:

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

または、認証を必要としない場合（たとえば、localhost経由で送信している場合、または社内でのみ送信している場合）:

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

Apache Tomcat以外のアプリケーションサーバーでJiraを実行している場合（サポートされているJira設定ではありません）、SMTPメールサーバーにJNDIの場所を設定するための同様の方法

接続に問題がある場合は、mail.debug="true"パラメータを<Resource/>要素（上記）に追加します。また、JavaMailクラス(通常はJARライブラリファイル内)がアプリケーションサーバーのクラスパスに存在し、JiraのJARライブラリファイルと競合しないようにする必 これは、アプリケーションサーバー自体（Jiraではない）がSMTP接続を確立しているため、アプリケーションサーバーがJiraのクラスローダー内のJARライブラリファイルを

一部のオペレーティングシステムでは、JavaMailクラスをアプリケーションサーバーにバンドルすることがあります(Red Hat Enterprise LinuxのTomcatなど)。 これは、JiraのJavaMailクラスのコピーと競合し、次のようなエラーが発生する可能性があります:

java.lang.NoClassDefFoundError: javax/mail/Authenticator

または:

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

Apache Tomcatのような軽量のアプリケーションサーバー（Jiraの「推奨」ディストリビューションに組み込まれているものを含む）は、常にJavaMailに付属しているとは限りません。

競合を防ぐには、アプリケーションサーバーのlib/ディレクトリを確認します:

  • アプリケーションサーバーにmail-1.4.1.jarとactivation-1.1.1.jarが既に含まれている場合は、Jiraアプリケーションインストールディレクトリの<jira-application-dir>/WEB-INF/lib/サブディレクトリからmail-1.4.1.jarとactivation-1.1.1.jarを削除します。
  • アプリケーションサーバーにmail-1.4.1.jarおよびactivation-1.1.1.jarが含まれていない場合は、mail-1.4.1.jarおよびactivation-1.1.1.jarをJiraアプリケーションインストールディレクトリの<jira-application-dir>/WEB-INF/lib/サブディレクトリからJiraインストールディレクトリのlib/サブディレクトリ(Jiraの”推奨”ディストリビューションの場合)またはJiraを実行しているアプリケーションサーバーのlib/サブディレクトリに移動します。

SMTP over SSL

メールサーバーがSSLをサポートしていれば、JIRAとメールサーバー間のメール通信をSSL経由で暗号化できます。

まず、SMTPサーバー証明書をJavaキーストアにインポートする必要があります。 このプロセスについては、”Active DirectoryへのSSL接続の構成”ページで説明しています。

(警告)重要な注意:証明書をインポートしないと、Jiraはメールサーバーと通信できません。

次に、メールサーバーの接続プロパティを編集し、starttlsとSSLSocketFactoryを指定します。 From{$Jira_INSTALL}/conf/server.xml(この例では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"/>

トラブルシューティング

Jiraでメール関連の問題をデバッグするための便利なヒントは、起動時に-Dmail.debug=trueプロパティを設定することです。 これにより、Jiraのeメールのやり取りのプロトコルレベルの詳細が記録されます。 さらに、JIRAのログレベルを上げると、サービスが実行されているときとメールの処理方法が表示されます。

一般的な問題

  • Jiraが電子メールを作成または送信していないか、電子メールから問題やコメントを作成しているように見えない場合、JiraインストールでOutOfMemoryエラーが発生している可能性があります。 OutOfMemoryエラーのログファイルを確認してください。 OutOfMemoryエラーがある場合は、Jiraを再起動してエラーを調査してください。
  • いくつかの受信メールが消えてしまった場合は、誤ってJiraの第二のコピーを開始していないことを確認してください（例：Jiraの第二のコピーを開始していないことを確認してください）。 ステージング環境では）電子メールメッセージをダウンロードおよび削除しています。 メールが処理されないように設定する必要があるフラグについては、データの復元ページを参照してください。
  • “メールリレー”エラーが発生した場合は、JiraのSMTPメールサーバー設定ページのSMTPホストセクションでユーザー名とパスワードを指定していることを確認してください。

ヘルプの取得

問題を自分で解決できない場合は、”Jira”プロジェクトでサポートケースを作成してください。

コメントを残す

メールアドレスが公開されることはありません。