In general, the Navixy platform update consists of three parts:
- Updating the database.
- Updating java services files.
- Updating web services files.
Beginning of the update
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.
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.