Upgrades and Patches

1. Passport Updates and Patches

Periodically, Inversoft releases updates for the Passport. You might also require a patch if you are running into problems and have contacted Inversoft Support for assistance. In these cases, you will need to update the application.

To download or check on the latest updates, please visit your Inversoft Account and find the Download link for your license.

1.1. Linux

Updating your application is easy if you installed using the RPM or Debian packages. All you need to do is to issue an update command to the dpkg or rpm program and specify the new package file. Here is an example:

Running the update script will shut down the Passport service if they have not yet been stopped The service will need to be restarted after the update is finished.

Shutdown Passport
$ sudo service passport-backend stop
$ sudo service passport-search-engine stop
Upgrade Passport
# Using dpkg on a Debian based system
$ sudo dpkg -i passport-search-engine-<version>.deb
$ sudo dpkg -i passport-backend-<version>.deb

# Using rpm on a Red Hat based system
$ sudo rpm -U passport-search-engine-<version>.rpm
$ sudo rpm -U passport-backend-<version>.rpm
Start Passport
$ sudo service passport-search-engine start
$ sudo service passport-backend start

1.2. Windows

For this example, we’ll assume you have previously installed Passport in C:\inversoft. this will be referred to PASSPORT_HOME.

Example filesystem layout
Shutdown and Uninstall Passport
# Stop Services
C:\> net stop PassportBackend
C:\> net stop PassportSearchEngine

# Uninstall Services
C:\inversoft\passport-backend\apache-tomcat\bin>PassportBackend.exe /uninstall
C:\inversoft\passport-search-engine\elasticsearch\bin>PassportSearchEngine.exe /uninstall

# Delete or move existing installation
C:\inversoft> move passport-backend passport-backend-old
C:\inversoft> move passport-search-engine passport-search-engine-old

Extract the new zips and place in PASSPORT_HOME.

Install and Start Passport
# Install Windows Services
C:\inversoft\passport-backend\apache-tomcat\bin>PassportBackend.exe /install
C:\inversoft\passport-search-engine\elasticsearch\bin>PassportSearchEngine.exe /install

# Startup Services
C:\> net start PassportSearchEngine
C:\> net start PassportBackend

1.3. Database

In most cases, you will not need to upgrade you database manually using the information below. Passport ships with a system called Maintenance Mode. When you restart Passport after installing a new bundle using the steps above, Passport will automatically upgrade your database.

You should always backup your database prior to using Maintenance Mode.

Depending on your current version and the new version you will be updating to you might need to execute one or more SQL scripts to update your database. These scripts are located in the migrations folder inside the Database Schema ZIP file. This file can be downloaded by logging into your account at www.inversoft.com.

When upgrading your database from a previous version, be sure to only run the scripts located in the migrations folder, the base files mysql.sql and postgresql.sql should only be used during a clean installation when no database schema is present.

Inside of the database schema zip file, you will find the following Passport migrations, run in this order, starting with the first migration that is greater than the version you are coming from, and ending with the version that is less than or equal to the target version.

    mysql | postgresql
      |- 1.1.0.sql
      |- 1.3.0.sql
      |- 1.4.0.sql
      |- 1.5.0.sql
      |- 1.6.0.sql
      |- 1.6.1.sql
      |- 1.6.2.sql
      |- 1.7.0.sql
      |- 1.8.0.sql
      |- 1.9.0.sql
      |- 1.10.0.sql
      |- 1.11.0.sql
      |- 1.13.0.sql
      |- 1.13.2.sql
      |- 1.14.0.sql
      |- 1.16.0.sql
      |- 1.17.0.sql
      |- 1.19.0.sql
      |- 1.20.0.sql
      |- 1.21.0.sql
      |- 1.21.3.sql
      |- 1.22.0.sql