NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

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

...

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.

Info
titleServer Components in NBIA 6.4.3

CTP is installed and configured as part of the NBIA 7.0 GA installation. You do not need to do anything further to download or install the CTP server.

You can also pick and choose the components to install by commenting out or un-commenting the property in the install.properties file. exclude.<component name> For example, if there is no need to install the CTP server, just remove the "#" in front of the default setting "#exclude.ctp=true".

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. 

...

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:

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

  3. From the command line, navigate to <installer_directory> (Example: cd C:/NBIA_7_0_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.

...