In general, the Navixy platform update consists of three parts:
- Updating the database.
- Updating java services files.
- Updating web services files.
Before installing, make sure that the pre-requisites are met.
- Java Development Kit 17 (since version 11 is deprecated for the platform starting from April 2022);
- 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
Inside the unpacked archiveind "navixy-package" directory, containing all the platform files in it. You can move it anywhere else for the installation paths to be shorter.
Hereinafter this will be the main directory of the distribution.
Before the update, it is strongly recommended to stop Navixy java services in "Services" menu.
For Windows on-premise instances, there is no automated update scripts. All the update is performed manually.
Update process
Step 1: Database update
Open the command prompt and switch to ...navixy-package\db folder. Likely:
cd C:\Users\Administrator\Downloads\navixy-package\db
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.
del updates.sql
del google.sql
Make sure these files are removed, and then execute all the other sql files.
type *.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 C:\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 C:\nginx\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.
Windows services configuration
If you switch from Java 11 to 17 during the update, you need to reinstall Navixy services. Wrapper app of the previous version will not work with Java 17.
To do this, take Wrapper folder from the installation package and perform the same actions as for the initial installation.
Adding Windows services for the platform
The services do not need to be deleted, the batch file will just update their settings.
Final steps
Restart Navixy java services in "Services" menu.
Check that the services are restarted successfully and are running for at least a minute.
At this point the update is complete.