The meshIQ Platform requires a version 11 license. Contact your meshIQ sales representative for details.
These instructions pertain to upgrading to meshIQ Platform Track 11.0.3 from XRay 1.5. For instructions on upgrading from meshIQ Platform Track 11.0.2, see meshIQ Platform Track release notes: v11.0.3.
The meshIQ platform core services are leveraged by all modules in the meshIQ platform for run time services. You must install the core services before installing any related modules.
1. Stop Web, CEP and Domain.
2. The Java version needs to be upgraded from version 11.0.2 to version 11.0.19
3. Place the file jdk-11.0.19_linux-x64_bin.tar.gz file under /opt/nastel/java folder.
4. Untar the file using the command : tar -zxvf jdk-11.0.19_linux-x64_bin.tar.gz
5. Unlink the old version using the command:
unlink current
unlink jre
6. Link the newer version using the command:
ln -s jdk-11.0.19 current
ln -s jdk-11.0.19 jre
7. Place ds-dbapi-solr-11.0.3.tar.gz file in /opt/nastel/misc/jkool-dbapi folder
8. Untar it using the command : tar -zxvf ds-dbapi-solr-11.0.3.tar.gz
9. Unlink the current version using the command : Unlink current.
10. Link the folder using the command : ln -s ds-dbapi-solr-11.0.3 current
11. Now, in AutoPilotM6/updates folder place the following files:
AP60_SU34.pkg
JOB_SCHEDULER-0.1.16.pkg
AP11_SU03.pkg
AP_AIM-11.0.3.pkg
JOB_SCHEDULER-11.0.1.pkg
DATA_SERVICE-11.0.3.pkg
ds-api-11.0.3.tar.pkg
track-ui-11.0.3.tar.pkg
12. Here, as we are upgrading from 1.5 to 11.0 the Service Update versions are varied, as we cannot upgrade from AP60_SU33.0.2 to AP11_SU03 directly, we need to upgrade to AP60_SU34 first and then to AP11_SU03.
13. Similarly, Job Scheduler shall be upgraded from 0.1.15.2 to 0.1.16 and then to 11.0.1 version.
14. Go to /opt/nastel/AutoPilotM6/bin and run the following commands:
./pkgman ../updates/AP60_SU34.pkg
./pkgman ../updates/JOB_SCHEDULER-0.1.16.pkg
./pkgman ../updates/AP11_SU03.pkg
./pkgman ../updates/AP_AIM-11.0.3.pkg
./pkgman ../updates/JOB_SCHEDULER-11.0.1.pkg
./pkgman ../updates/DATA_SERVICE-11.0.3.pkg
Note: After running each command above the domain service needs to be started and stopped. For that go to /opt/nastel/sbin and run the following :
./start.sh domain
./stop.sh domain
15. Then, please navigate to /opt/nastel/AutoPilotM6/updates, untar the API and UI files and place them in the apache-tomcat/webapps folder.
16. For that first please go to /opt/nastel/AutoPilotM6/updates and run the following commands:
tar -zxvf ds-api-11.0.3.tar.pkg
tar -zxvf track-ui-11.0.3.tar.pkg
17. The ds-api.war and track.war files will be extracted. Move these two files to /opt/nastel/AutoPilotM6/apache-tomcat/webapps using the command:
mv ds-api.war track.war /opt/nastel/AutoPilotM6/apache-tomcat/webapps
18. Then go to the same location:
cd /opt/nastel/AutoPilotM6/apache-tomcat/webapps
19. Delete the older folders with names: jkool-service.war and xray.war files.
20. Again navigate to the conf folder:
cd /opt/nastel/AutoPilotM6/apache-tomcat/conf
21. Open the server.xml file: vi server.xml.
22. File names should be changed in two different places within the server.xml file, as shown below:
Change the name from xray to track
Change the name from xray.war to track.war
Change the name from jkool-service to ds-api
Change the name from jkool-service.war to ds-api.war
23. Save the file.
24. Then start the services one by one: Domain, CEP and Web.
25. As we update to version 11, the license also needs to be updated. Please update the license to version 11.
26. Since it is a major upgrade, components such as Kafka, ActiveMQ, and Log4j files in Solr need to be upgraded as well.
27. For the Solr database update, please go to /opt/nastel/misc/jkool-dbapi/current/bin and run the following by giving the right parameters:
./jkool-db-upgrade.sh -pwd <jkql-admin-pwd> [-solr <solr-home>] [-sh <solr-host>] [-sp <solr-port>] [-zh <zookeeper-host>] [-zp <zookeeper-port>] [-zr <zookeeper-root>]
28. After this, navigate to /opt/nastel/misc/jkool-dbapi/current/schemas and run the command: ./reload-cores.sh
29. Later, go to /opt/nastel/AutoPilotM6/jkool/scripts and run the command: ./create-kafka-topics.sh
30. All the topics will be recreated.
31. Now, connect to the UI using the URL http://localhost:8080/track>