NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Old Version 11

changes.mady.by.user Unknown User (gustafss)

Saved on

compared with

New Version 12

changes.mady.by.user Unknown User (gustafss)

Saved on

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.
  • To upgrade from NBIA 6.0 to NBIA 6.5.3.1, you must perform a fresh deployment of NBIA 6.5.3.1, described on this page, and perform an upgrade on the database using the command line installer. For more information, see Upgrading NBIA to 6.5.3.1.

Downloading NBIA 6.5

...

Files

The installation file for NBIA 6.5.3.1 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_6.5.3.1.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 6.4.3 5 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 6.5

...

You can perform a new installation of NBIA 6.5 .3.1 using the command-line. For instructions, see Command-Line Method of Installation.

...

An important component of NBIA 6.5 .3.1 command-line installation is configuring properties. 

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

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

...

  1. From the directory where you downloaded NBIA_install_6_5_3_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_6_5_3_1_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 6.5 .3.1 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 6.5.)

    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


    Warning
    titleWarning

    Version 6.4 5 is missing an important property application.context.name. Add it to line 198 as shown below.

    #######################################
    # Application Context used in CSM/UPT #
    #######################################
    protection_element_prefix=NCIA.
    csm_application_name=NCIA
    application.context.name=NCIA


    Warning
    titleWarning

    Make sure to create the physical locations for the gov.nih.nci.ncia.zip.location and gov.nih.nci.ncia.ftp.location properties in the server. If this is not done, the Download all items link in the View My Basket window does not work.

    Record these property values!

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

...