Accessing the UPM throws a java.net.UnknownHostException
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
When attempting to use the UPM, a java.net.UnknownHostException is thrown, as in the screenshot below:
Diagnosis
The error occurred in JIRA 4.4.5, using the Universal Plugin Manager v1.4.1. It will likely be present in other versions of JIRA and also the UPM.
Cause
The Universal Plugin Manager is unable to establish an outbound connection to the Atlassian Marketplace. The most likely cause for this is the JIRA instance does not have an outbound connection to the Information Superhighway or is using an internal DNS that does not have plugins.atlassian.com in it.
Solution
This can be resolved with any of the following:
Disable network access to the Marketplace, as in Problems Connecting to the Atlassian Marketplace.
Set up JIRA to use an outbound proxy as per our Configure an outbound proxy for use in Jira server KB article.
Update the UPM to the latest version manually, downloading the appropriate version of the UPM from the Atlassian Marketplace.
ℹ️ Later versions of the UPM handle this use case better and allow for network access to be disabled through the plugin itself.
Was this helpful?