Updating the Senzing API configuration and schema from 1.15.x to 2.0

Before you begin

You must update your Senzing project(s) with the new Senzing release.

Configuration Changes

This release contains configuration updates.  If you are upgrading between multiple versions, you must run every configuration update script in consecutive order from your current version to the latest version. 

From your Senzing project directory,  first source setupEnv, then run the G2ConfigTool.py utility to apply these changes:

• source setupEnv
• python3 python/G2ConfigTool.py -f /<Senzing_project_dir>/resources/config/g2core-config-upgrade-1.15-to-2.0.gtc

If you do not apply this update you will get an error on start-up that your configuration needs to be version 9. 

Schema changes

• Addition of the MATCH_LEVELS column to the RES_RELATE table.

Option 1: Automatically

Use the g2dbupgrade utility to update your database.

From your Senzing project directory, first source setupEnv, then run the g2dbupgrade utility:

• source setupEnv
• ./bin/g2dbupgrade -c /<Senzing_project_dir>/etc/G2Module.ini -a

Option 2: Manually

If you want to verify the upgrade script before applying it, use the g2dbupgrade utility to generate a single SQL script to update your database.

From your Senzing project directory, first source setupEnv, then run the g2dbupgrade utility:

• source setupEnv
• ./bin/g2dbupgrade -c /<Senzing_project_dir>/etc/G2Module.ini -o /<Senzing_project_dir>
• Apply the generated /<Senzing_project_dir>/g2-database-upgrade-<DB Type>.sql file to your database