Page History
...
Table of Contents | ||
---|---|---|
|
This section describes upgrading upgrading from NBIA 6.3 4 to 6.5.3.1. You can perform an upgrade to NBIA 6.5 .3.1 using the command-line installation. A GUI upgrade is not an option for this release.
Upgrading NBIA from 6.4 to 6.5
...
Info | ||
---|---|---|
| ||
If you have a version of NBIA earlier than 6.4 and want to upgrade, see the upgrade directions instructions in Upgrading NBIA to 6.4. |
Info | ||
---|---|---|
| ||
|
If you are performing a new installation, go directly to the installation of version 6.5.3.1.
Info | ||
---|---|---|
| ||
The directions in this section presume that you have a valid and functioning NBIA 6.4. Please see above section if you want to upgrade previous versions of NBIA. NBIA 6.5.3.1 is running on a an upgraded infrastructure, so please upgrade the infrastructure first. That includes the operating system for Linux system, Java SDK, Apache Ant, and the database as described at the beginning of in this document. The upgrade to a given version of NBIA may add new constraints to the data model. This is typically done in order to stop erroneous submissions from happening. If such submissions have already occurred, there may already be duplicate or corrupt data in the database. The upgrade will fail in such a case, and the corrupt data needs to be cleaned out before the upgrade can be successful. |
Info | ||
---|---|---|
| ||
If you are using an existing Tomcat installation make sure there are no files or directories in the |
Overview of Properties Files
When you installed the previous version of NBIA, you configured the install.properties
. To complete the upgrade to the desired NBIA version, you may need to use values in the previous install.properties file
to configure values in the install.properties
file for for the NBIA command-line installer.
Info | ||
---|---|---|
| ||
To make the upgraded NBIA automatically connect with an existing database after the installation, the property |
To perform an upgrade to NBIA 6.5 .3.1 using the command line, follow these steps.
- Download the installation zip file described in Downloading NBIA 6.5 .3.1 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_4_35_installer 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 6.5.3.1<installer <installer_directory>
.Tip title Duplicate attributes Where there are duplicate attributes, the values must be the same in both files.
In the NBIA 6.5 .3.1
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 6.5 .3.1 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.Copy each entry you modified in the NBIA 6.5.3
install.
1install.properties
file and paste it in the corresponding location in theinstall.properties
file for NBIA 6.5.3.1, replacing the default text, as appropriate. There are new properties for 6.5 .3.1 that did not exist in 6.34. Consult NBIA 6.5 .3.1 Properties of this guide for more background on the meaning of the properties. Be sure to use the correct database properties.Record these property values.
Tip title Default 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.From the command line, navigate to
<
(Example:installer_directory
cd C:\NBIA_6_45_3_installer
), and typeant
. 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 6.5 .3.1 portal, CTP server, and NBIA REST service for the NBIA application.Update the database schema.
Anchor DatabaseUpgrade DatabaseUpgrade Tip title Database 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
- In the
<
, comment outinstaller_directory
>/install.propertiesexclude.database=true
, that is, put#
in front ofexclude.database=true
- From the command line, navigate to
<installer_directory>
(Example:cd C:\NBIA_6_4_35_installer
), and type ant build:db:update .
The installer upgrades your existing NBIA database on your MySQL server.
Please note because of an incompatibility issue of Liquibase script with MySQL 5.5, the script for custom.series.list.tables.creation record has to be modified. Consequently this results in the change of the check sum value to the
custom.series.list.tables.creation
record. A one-time-only modification on MD5SUM field will be needed on thedatabasechangelog
table for the record that has the ID "4.4.custom.series.list.tables.creation". Here are the steps:- When theant build:db:update fails and reports an error message like the following screen, note the value of the new MD5SUM.
- Update the value of MD5SUM for 4.4.custom.series.list.tables.creation record of databasechangelog table using the following SQL script:
update databasechangelog set MD5SUM='5732cf3e71eb85633c1c7bda7cf485f' where ID='4.4.custom.series.list.tables.creation'
If the value of MD5SUM reported in the error message is different from'5732cf3e71eb85633c1c7bda7cf485f'
, replace it with the MD5SUM value reported in error message. - Type ant build:db:update again to complete the database upgrade.
- In the
- 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 enternciadevtest
as the user andchangeme
as the password.