...

Downloading NBIA

...

Code

The installation file for NBIA 7.1 GA can be downloaded from the NBIA distribution folder, which contains the installers and latest release notes. For a command-line installer, download nbia_install_7.1 GA.zip. Remember the download location, as you will be using this file to run the installation in the steps that followNBIA download package is a ZIP package that includes the NBIA application, supporting libraries, the RSNA MIRC application (with NBIA modifications), documentation, and a sample NBIA database. The system utilizes a Java server that provides REST services to independent applications such as the Angular-based graphical user interfaces. It also includes a Solr server that indexes all tags in the DICOM headers and allows rapid retrieval based on any of the information in the tags. The applications are loosely coupled, enabling independent upgrades, speeding the delivery of features to users.

Install NBIA from the latest code at https://github.com/CBIIT/NBIA-TCIA.

Building and Installing NBIA

1. Install the required software.
   • Java 1.8.x
   • Ant 1.8.x
2. Use git to download the project.
3. Navigate to /software/build.
4. Type ant dist.
   This creates the install package in /target/dist.

Integrating with Eclipse

1. Select File > Import.
2. Select Existing Projects into Workspace.
3. Select the software directory within the working copy and click Finish.
4. Define a classpath variable, NBIA_BASE, to point to the /software directory.

Installing NBIA

...

Command-Line Method of Installation

...

An important component of NBIA 7.1 GA command-line installation is configuring properties. 

When you perform a command-line installation of NBIA 7.1 GA for the first time, you work with the the install.properties file that is included in NBIA_install_7.1 GA.zip. You can refer Refer to the sample install.properties file , install.properties, on this wikias well as more explanation of each property in the NBIA 7.1 Configuration Properties. To upgrade from NBIA 6.0 to NBIA 7.1 GA, a fresh deployment of NBIA 7.1 GA is required with a database upgrade using the command-line installer. For more information, see Upgrading NBIA to 7.1 GA.

...

1. From the directory where you downloaded NBIA_install_7_1.zip, unzip the files into a fresh directory. In this documentation, this location is referred to as the <installer_directory>.
   Example: <installer directory> = C:\NBIA_7_1_installer.

   Info
   title Property values are important!
   Setting the property values is an important step in the installation process. Before you complete steps 2 and 3, review About Properties. Follow steps 2 and 3 carefully.

2. Open <installer_directory>/install.properties, modify the values for your environment, and save the file.
   For detailed information on all of the properties, refer to NBIA 7.1 GA properties documentation.
   At a minimum, you will likely need to modify the values for the following properties: 

   System user and password and database name, user, and password should be the same for UPT and NBIA install.properties. For more information, see 4 - Installing and Configuring Software.

   Code Block

   database.type database.system.userdatabase.system.password database.server database.port database.name database.user database.password authentication.type mail.smtp.server ctp.server.admin.password ctp.client.admin.password tomcat.server.port gov.nih.nci.ncia.tomcat.home  gov.nih.nci.NBIA.jboss.public.url gov.nih.nci.NBIA.admin.email gov.nih.nci.NBIA.grid.local.node.name gov.nih.nci.NBIA.imaging.server.url jar-signing.keystore.location=${user.home}/testdownload jar-signing.keystore.password=testdownload jar-signing.keystore.alias=testdownload jar-signing.execution.time=install jar-signing.generate-selfsigned=true

   Tip
   title Default values
   You should not need to modify the other default values as the application uses unique ports to reduce the risk of other applications using the same values. However, be sure to verify that the ports in this file are not being used by other applications.

3. From the command line, navigate to <installer_directory> (Example: cd C:/NBIA_7_1_installer), and type ant. This initiates the installation process. The anticipated duration is anywhere from 5-20 minutes, depending on your system's speed, power, and memory. The installer installs the NBIA schema in the specified pre-existing database in your database server. It configures and starts the Tomcat server for the web application and it installs and starts the CTP server.

4. To verify NBIA installation, do the following:

   1. Open your web browser to http://<tomcat.server.hostname>:8080/ncia

   2. Refer to the installer_directory;/install.properties file for the correct values.

   3. Log in with ncidevtest as the user and changeme as the password. 

5. After successfully installing NBIA, make a backup of the <installer_directory>/install.properties file in a different directory for future reference.

6. Start NBIA.