NIH | National Cancer Institute | NCI Wiki  

The most convenient method of downloading NBIA data is by using the Downloader. You must install the Downloader before you begin downloading data.

However, if you cannot download the application, the alternative is to use the Temporary Downloader, a Java Network Launch Protocol (JNLPfile previously called the NBIA Download Manager.

The Temporary Downloader allows you to replicate items in your Data Basket, downloading them to your local machine. It is a Java program and requires that you install a Java Runtime Environment (JRETM) on your machine to run it. You can download the JRE Exit Disclaimer logo . The Temporary Downloader does not limit the total size of the download.

JRE

You must have version 8 or higher of the Java Runtime Environment (JRE) installed to be able to open the Download Manager.

  • If JRE 8 is installed, the Temporary Downloader attempts to start. To run the application, you must click Run in the Warning dialog box indicating the application's digital signature cannot be verified. Before doing so, you can select the More Information... link at the bottom of the dialog to view a more detailed report of any security issues. Then you can evaluate whether you want to run the application.
  • If JRE is installed but the version is older than version 6, the browser automatically attempts to upgrade the JRE to version 8.
  • If the JRE is not installed, when you click the Download Manager button, the browser prompts you for what it should do with the JNLP file. The My Data Basket page includes a link to a page where you can download the JRE.

  • If the Temporary Downloader fails to work properly, this could be a JRE version issue. The Temporary Downloader has been tested successfully with Version 8 Update 101.

Java Security settings

Java Security may block the installation of the Temporary Downloader. You may see a window like the following.

Application blocked by Java Security due to a certificate problem

To resolve this issue, do the following.

  1. Select Start menu > Configure Java.
    The Java Control Panel appears.
  2. Select the Security tab.
  3. Click Edit Site List and then enter https://imaging.nci.nih.gov as the location.
    Java Control Panel, Security tab
  4. Click OK.
  5. Click the JNLP file to run the Temporary Downloader again.
    A message window appears, asking you if you want to run this application.
  6. Select I accept the risk and want to run this application. 
    Security Warning dialog box that asks if you want to run this application
  7. Click Run.
    The Temporary Downloader successfully launches.

    NBIA Download Manager

Removing items

The Temporary Downloader initially lists everything in your data basket. You can remove items from the Downloads list in the Temporary Downloader that you do not want to download. When you remove an item from the list, it remains in the data basket. You just do not download it.

To download objects using the Temporary Downloader

Mac OS X

The following instructions apply to Windows PCs but you can also use the Temporary Downloader on Mac OS X Exit Disclaimer logo .

  1. At the top of the My Data Basket page, click the Download Manager link. You are prompted to open or save the temporary Downloader. Open it in the JRETM you installed. If you have any issues opening the Temporary Downloader, see the note about Java Security settings.

    The page lists all items you selected in the data basket. You can hover your mouse over the Patient ID, Study Instance, and Series Instance columns to reveal the complete corresponding IDs. You can also resize a column by selecting and dragging the column border.

  2. Click Browse to navigate to the destination where you want the images/annotations to be downloaded.
  3. Click Start to begin the download. You can monitor the download in the Progress column. The Status column indicates when the download for each item is complete.

    At any point in the process, you can click the Pause and Resume buttons to temporarily stop and restart the process.

    NBIA Download Manager, Downloads Complete

    Note that files downloaded this way are not compressed. The downloaded files are stored in a child folder under the destination folder such as Collection name/patient id/study instance UID/series instance UID/image SOP instance UID.

Removing items

The Temporary Downloader initially lists everything in your data basket. You can remove items from the Downloads list in the Temporary Downloader that you do not want to download. When you remove an item from the Downloads list, it remains in the data basket. You just do not download it.

Network error?

If network errors occur during large downloads, the Temporary Downloader retries the download the number of times that your administrator configured.
  • No labels