Jira Data Center fails to connect to LDAP server with UnknownHostException
プラットフォームについて: Data Center - この記事は、Data Center プラットフォームのアトラシアン製品に適用されます。
このナレッジベース記事は製品の Data Center バージョン用に作成されています。Data Center 固有ではない機能の Data Center ナレッジベースは、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。サーバー*製品のサポートは 2024 年 2 月 15 日に終了しました。サーバー製品を利用している場合は、アトラシアンのサーバー製品のサポート終了のお知らせページにて移行オプションをご確認ください。
*Fisheye および Crucible は除く
症状
JIRA is unable to connect to the LDAP server.
atlassian-jira.log に次のエラーが返される。
Caused by: org.springframework.transaction.CannotCreateTransactionException: Could not create DirContext instance for transaction; nested exception is org.springframework.ldap.CommunicationException: ldap.atlassian.com; nested exception is javax.naming.CommunicationException: ldap.atlassian.com [Root exception is java.net.UnknownHostException: ldap.atlassian.com]
環境
Jira Data Center on any version
原因
Jira could not resolve the connection to the LDAP server. This is commonly caused by an incorrectly configured DNS or hostname.
ソリューション
- Update the DNS records to include the appropriate server name & IP used in the LDAP configuration.
If updating of the DNS server used is not possible, this can be achieved by manually adding the following entry, replacing the IP & server name as appropriate to the below file on the server hosting JIRA.
Linux:/etc/hostsWindows:C:\Windows\System32\drivers\etc\hosts<IP of server> <host name of server> 192.168.1.123 ldap.atlassian.comYou need to have local administrator rights on the machine hosting JIRA to make these changes.
- Alternatively, you can use the IP of the server in the LDAP configuration, as in Connecting to an LDAP Directory.
We also have some additional steps for LDAP troubleshooting, please review these if you're still experiencing problems.