To newly install the NBIA 7.1 GA application and services, follow these steps.
|
The NBIA 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.
ant dist
.CTP is installed and configured as part of the NBIA installation. You do not need to do anything further to download or install the CTP server. |
An important component of NBIA command-line installation is configuring properties.
When you perform a command-line installation of NBIA for the first time, you work with the install.properties
file that is included in NBIA_install_7.1 GA.zip
. Refer to the sample install.properties
file as 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.
In several instances in this section, property values must be modified. Note the following points about changing or entering variables.
|
Verify that default port values defined in the |
To install a new instance of NBIA 7.1 GA using the command-line, follow these steps:
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.
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. |
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.
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 |
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. |
<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.To verify NBIA installation, do the following:
Open your web browser to http://<tomcat.server.hostname>:8080/ncia
Refer to the installer_directory;/install.properties
file for the correct values.
Log in with ncidevtest as the user and changeme as the password.
After successfully installing NBIA, make a backup of the <installer_directory>/install.properties
file in a different directory for future reference.