Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel

Table of Contents

Is

...

NBIA Data Retriever

...

open source?

Yes! The NBIA Data Retriever, like the backend server it talks to, is licensed under the 3-clause BSD license, sometimes referred to as the 'new' or 'modified' BSD license. The BSD license is very permissive, business-friendly, and approved by the Open Source Initiative. The source code is available from GitHub in the CBIIT/NBIA-TCIA repository, specifically in the software/nbia-download-manager subdirectory. Developers are free to review or fork to create derivative works. Of course, we would appreciate, but do not require, pull requests back to the repository if you have created nice new features or bug fixes that others might benefit from. They would be reviewed by the NBIA development team for inclusion, possibly after some tweaks, back into the main repository.

...

Where are the installation files for the current version of the NBIA Data Retriever?

Include Page
Version 4.04
Version 4.04

How do I know which version of the NBIA Data Retriever I am running?

...

NBIA Data Retriever Version

Manifest v1.0

Manifest v2.0

Manifest v3.0

1.0

Working

Working with public data requests*

Not working

2.0

Working with public data requests

Working

Auto Upgrade and Manual Upgrade are working.

Remind Me Later does nothing.

3.0

Working with public data requests

Working

Working

4.0

Working with public data requests

Working

Working

4.1

Working with public data requests

Working

Working

...

On CentOS or Red Hat Linux, use the command sudo yum -v -y remove NBIADataRetriever-4.3.6-1.x86_64.rpm;sudo yum -y install NBIADataRetriever-4.04-1.x86_64.rpm  to   to install the NBIA Data Retriever. This command pulls and installs all missing dependent libraries when the NBIA Data Retriever is installed. If you install another way, you may not install all of the dependent libraries. Also, note that the NBIA Data Retriever always takes a manifest file as a parameter. In a GUI desktop environment, start the NBIA Data Retriever by clicking a manifest file.

How do I run the NBIA Data Retriever from the command line on RedHat/CentOS Linux?

The NBIA Data Retriever has two variants for Linux: the Graphical User Interface (GUI) app and a command-line interface.  The command-line interface is available for the NBIA Data Retriever starting with version 4.1 and documentation is available at NBIA Data Retriever Command-Line Interface Guide

The GUI app can also be started on the command line but needs the support of a desktop environment. For NBIA Data Retriever 3.2 and later, you can start the NBIA Data Retriever this way by entering the following command at the command prompt:

sudo /opt/NBIADataRetriever/NBIADataRetriever  <full path of manifest file including the file name>

This command assumes that Assuming the NBIA Data Retriever is installed on /opt/Downloader (this , which is the location that the NBIA Data Retriever is it is installed at when it is installed with the command sudo yum -v -y remove NBIADataRetriever-4.3.6-1.x86_64.rpm;sudo yum -y install NBIADataRetriever-4.04-1.x86_64.rpm).  To run the NBIA Data Retriever from the command line, assuming you are running the NBIA Data Retriever 3.2, type the command:sudo /opt/NBIADataRetriever/NBIADataRetriever  <full path of manifest file including the file name>

The NBIA Data Retriever always needs to run with a manifest file. Although the application can be invoked from command line, it works best in a desktop environment such as Gnome, KDE, and so on. Once the NBIA Data Retriever is installed on the desktop, you can click any manifest file with the extension .tcia to invoke the app.

The NBIA Data Retriever requires a manifest file to run. You can create a manifest file in the TCIA Radiology Portal and with an API.

Failed to find library: jvm.dll

I clicked a manifest file and received the error “Failed to find library: jvm.dll” on Windows 10. How can I fix it?

Anchor
jvm-dll
jvm-dll

This is a Java bug that displays the following error message:

Image Removed

. This issue has a workaround. You must uninstall the NBIA Data Retriever and download the free community version of Visual Studio 2017. Install Visual Studio 2017 and then reinstall the NBIA Data Retriever.

How do I resolve the "xdg-desktop-menu: not found" error in the Ubuntu installation of the NBIA Data Retriever?

If the Ubuntu server does not have a desktop environment installed, it will not have the “xdg-utils” package. To solve this problem, run the following command.

Code Block
$cd /tmp

$wget https://cbiit-download.nci.nih.gov/nbia/releases/ForTCIA/NBIADataRetriever_4.1/nbia-data-retriever-4.1.deb

$sudo apt install xdg-utils

$sudo -S dpkg -r nbia-data-retriever-4.0.1.deb;sudo -S dpkg -i nbia-data-retriever-4.1.deb

How do resolve the “xdg-desktop-menu: No writable system menu directory found” error in the Ubuntu installation of the NBIA Data Retriever?

Ubuntu has a bug that results in this error. To solve this problem, run the following command, then run the installation command again.

Code Block
sudo mkdir /usr/share/desktop-directories/