menu

Update (Linux)

In general, the Navixy platform update consists of three parts:

  1. Updating the database.
  2. Updating java services files.
  3. Updating web services files.

Before installing, make sure that the pre-requisites are met.

  1. Java Development Kit 17 (since version 11 is deprecated for the platform starting from April 2022);
  2. MySQL 8.0 (however, MySQL 5.7 remains compatible and does not need to be updated).

The update will not go through on lower versions of MySQL and will end with an error.

Beginning of the update

Extract a platform distribution package received from Navixy, typically it is a .tar.gz file.

tar -zxvf $PACKAGENAME

(where $PACKAGENAME is the name of tar.gz file)

It will be extracted to "navixy-package" directory, containing all the platform files in it.

Hereinafter this will be the main directory of the distribution.

Before the update, it is strongly recommended to stop Navixy java services.

Automated update on Linux

For instances hosted on one Linux server, it is recommended to use the update.sh script. It performs a step-by-step update of the database and application files. You do not need to update anything manually. Just run the update.sh script from the navixy-package directory.

Please note! If your instance is hosted on more than one server (e.g. the database is hosted separately), this script will not be executed correctly and will end with an error.
In this case you need to perform the update manually according to the instructions below.

However, you can still use the script on the database server. It will update the database successfully and then crash on trying to update the app files. After this, you can proceed to manual update step 2.

Manual update

Step 1: Database update

Open navixy-package/db directory and execute updates.sql file with the following command:

mysql -uroot -p$ROOTPASSWORD google < updates.sql

(where $ROOTPASSWORD is MySQL root password)

Delete updates.sql and google.sql from db folder. This must be done not to override the database on the next step.


rm updates.sql
rm google.sql

Make sure these files are removed, and then execute all the other sql files.

cat *.sql | mysql -uroot -p$ROOTPASSWORD google

Step 2: Java services update

Updating the Java services simply means replacing the files in the service directories under /home/java. These directories are api-server, sms-server and tcp-server.

Find the corresponding directories in navixy-package. You need to replace all the files except config.properties and db.properties in the conf folders.

Compare the existing config.properties files with the ones from new distributive. If you see any new parameters - add them to the existing config.

Step 3: Web services update

Proceed to /var/www directory.

Replace all files in panel-v2 and pro-ui directories with files from the corresponding directories of the distribution package. This will not currupt any settings, as the configuration files in the package are named as example, and will not overwrite the existing ones.

Compare these files:

  • panel-v2/Config.js,
  • pro-ui/PConfig.js
  • pro-ui/static/app_config.js

with the examples in distribution package. If you see any new parameters, add them.

Final steps

Restart Navixy java services. Typically this is done by this command:

restart-navixy

Check that the services are restarted successfully and are running for at least a minute.

At this point the update is complete.

Video Telematics NEW
Open
Video Telematics NEW
Review incidents
Determine liability
Coach drivers
Learn more >
Open

This website uses cookies.
See our Privacy Policy to learn more.