NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

Versions Compared

Old Version 5

changes.mady.by.user Klinger, Carolyn (NIH/NCI) [C]

Saved on

compared with

New Version 6

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

Saved on

Key

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

...

  1. Download the installation zip file described in Downloading NBIA 7.0 GA Files to a directory of your choice. Unzip the files into a fresh directory. This documentation refers to this location as the <installer_directory> .
    Example: <installer_directory> = C:\NBIA_6_5_installer.

  2. Edit the default properties in the <installer_directory>/install.properties file. To do so, open both properties files, the one you configured originally, and the one at NBIA 7.0 GA <installer_directory>.

    Tip
    titleDuplicate attributes

    Where there are duplicate attributes, the values must be the same in both files.

    In the NBIA 7.0 GA install.properties file, make sure to set the exclude database to be "true", exclude.database=true.  If the database type is MySQL, set database.re-create=false. The 7.0 GA installer configures the Tomcat application server and installs NBIA applications. For the database upgrade, it must be done in a separate process. See the database upgrade tip below for details.

  3. Copy each entry you modified in the NBIA 7.0 GA install.properties file and paste it in the corresponding location in the install.properties file for NBIA 7.0 GA, replacing the default text, as appropriate. There are new properties for 7.0 GA that did not exist in 6.4. Consult NBIA 7.0 GA Properties of this guide for more background on the meaning of the properties. Be sure to use the correct database properties.

  4. Record these property values.

    Tip
    titleDefault values

    If you chose not to use the default ports on the Tomcat application server, make sure the ports in the install.properties file match what you chose to use in Tomcat. Be sure to verify that other applications are not using the ports in this file.

  5. From the command line, navigate to < installer_directory >/ (Example:cd C:\NBIA_6_5_installer), and type ant. This initiates the upgrade process, which should take 7 to 15 minutes depending on your system's speed, power, and memory.
    The installer configures pre-installed Tomcat application server, installs the NBIA 7.0 GA portal, CTP server, and NBIA REST service for the NBIA application.

  6. Update the database schema.

    Anchor
    DatabaseUpgrade
    DatabaseUpgrade

    Tip
    titleDatabase upgrade

    The database upgrade needs to be performed after the NBIA installation completes. Once an initial installation of NBIA is complete each database upgrade must be made from the same directory due to the way Liquibase determines the uniqueness of each change element. This directory can be determined by inspecting databasechangelog in the database. In the below example all database upgrades should occur from the C:\a\install\working\db\db-upgrade\db-upgrade.xml directory

    Example.


    1. In the <installer_directory>/install.properties, comment out exclude.database=true, that is, put # in front of exclude.database=true.
       
    2. From the command line, navigate to <installer_directory> (Example: cd C:\NBIA_6_5_installer), and type ant build:db:update .
      The installer upgrades your existing NBIA database on your MySQL  server.


  7. To verify that NBIA upgraded successfully, start up the Tomcat server and open your web browser to [ http://tomcat.server.hostname>:<tomcat.server.port>/ncia ]
    (example: [ http://hostname.com:8080/ncia ]) and enter nciadevtest as the user and changeme as the password.

Upgrading the Solr Index

For this release the Solr Index needs to be upgraded to enable the Fielded Search feature, during the process the text search feature will no be available.  To upgrade the index on a single instance:

  1. Shut server down
  2. Delete the existing Solr index directory in SOLR_HOME 
  3. Start server
  4. Indexing will begin immediately
  5. Don’t shut sever down in the meantime
  6. The progress can be monitored in catalina.out
  7. The log will give the progress, i.e. “Updated patient-1.3.6.1.4.1.9328.50.12.0128 Solr Update request made, this is the 4057 patient updated out of 6067”
  8. When indexing is finished restart Tomcat to refresh the caches.

To upgrade the index with minimal impacting current operations.

  1. Create a new instance of NBIA on a separate machine that shares the same database and image file storage as with the production instance of NBIA
  2. Make sure that the new instance does not share the same SOLR_HOME as the production instance and is a new installation.

  3. Start server

  4. Indexing will begin immediately
  5. Don’t shut sever down in the meantime
  6. The progress can be monitored in catalina.out
  7. The log will give the progress, i.e. “Updated patient-1.3.6.1.4.1.9328.50.12.0128 Solr Update request made, this is the 4057 patient updated out of 6067”
  8. Shut down the server
  9. Shut down the production server
  10. Copy the index from the new servers SOLR_HOME to the production server's  SOLR_HOME
  11. Start the production server