NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

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

Include Page
5 - Installing the NBIA Application 7.0
5 - Installing the NBIA Application 7.0

To newly install the NBIA 7.0 GA application and services, follow these steps.

Table of Contents

Note
titleBefore you begin!
  • You must install NBIA into a pre-installed Tomcat application server. The installation of NBIA will configure the Tomcat for running NBIA Portal and optional NBIA REST Service.
  • You must install NBIA into a pre-existing MySQL database using a connection username/password.

Downloading NBIA 7.0 GA Files

The installation file for NBIA 7.0 GA is over 255MB. The file 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.0 GA.zip. Remember the download location, as you will be using this file to run the installation in the steps that follow.

...

titleServer Components in NBIA 6.4.3

...

Installing NBIA 7.0 GA

Command-Line Method of Installation

About Properties

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

When you perform a command-line installation of NBIA 7.0 GA for the first time, you work with the install.properties file that is included in NBIA_install_7.0 GA.zip. You can refer to the sample install.properties file, install.properties, on this wiki. To upgrade from NBIA 6.0 to NBIA 7.0 GA, a fresh deployment of NBIA 7.0 GA is required with a database upgrade using the command-line installer. For more information, see Upgrading NBIA to 7.0 GA.

In several instances in this section, property values must be modified. Note the following points about changing or entering variables.

Tip
titleTips for working with property files
  • The paths in the .properties files should use forward slashes. For example, you would use application.base.path.window=C:/apps/NBIA, not application.base.path.window=C:\apps\NBIA. If you use backslashes, you will experience undesirable results.
  • You should not put any spaces in the property values of *.properties files (for example, install.properties). In Windows, note that the C:\Documents and Settings{ }<username> path contains spaces and the installation will likely fail. If you are using Windows, use a path such as C:/apps/NBIA.
  • In the install.properties file, any property value marked with uppercase REPLACE_* must be manually updated with the appropriate value.
  • In each .properties file, any property value marked with lowercase replace_* be optionally updated with the appropriate value.
  • In many of the steps below, there is a reference to a database.system.user for your MySQL server. To determine which users have full privileges to create and manage other databases, type show grants from a MySQL prompt to determine the correct level of privileges.
  • After installing NBIA 7.0 GA, a second properties file, nbia.properties, is created in the lib directory of Tomcat. To edit those properties, shut down Tomcat, edit the file, and then restart Tomcat.
Info
titleNBIA port values

Verify that default port values defined in the install.properties file are not in use on your system by running netstat --a from the command line. If the ports are in use prior to installation, you will likely experience problems with your installation.

Installing NBIA Using the Command-line Method

To install a new instance of NBIA 7.0 GA using the command-line, follow these steps:

...

From the directory where you downloaded NBIA_install_7_0.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_0_installer.

Info
titleProperty values are important!

Setting the property values is an important step in the installation process. Before you complete steps 2 and 3, review 5 - Installing the NBIA Application 7.1 GA (Copy). 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.0 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 for NBIA 7.0 GA.

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
titleDefault 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.

...

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. 

...

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

...