The meshIQ Platform requires a version 11 license. Contact your meshIQ sales representative for details.
These instructions pertain to upgrading from XRay 1.6 to meshIQ Platform Track 11. For new installations, please see the corresponding documentation.
PREREQUISITES
You must have the meshIQ Platform SU01 (AP11_SU01.pkg) and AIM (AP_AIM-11.0.1.pkg) plugins installed.
File locations
Go to the meshIQ Software repository located at https://data.meshiq.com/AP6/meshiq_platform/11.0.x/. A username and password are required.
From the /data_services directory:
- DATA_SERVICE-11.0.1.pkg
- ds-api-11.0.1.tar.gz
- ds-dbapi-solr-11.0.1.tar.gz
From the /track directory:
- track-ui-11.0.1.tar.gz
Installation steps
To apply the latest fix pack, do the following:
- Download the following packages from the download center:
-
- data_services/DATA_SERVICE-11.0.1.pkg
- data_services/ds-dbapi-solr-11.0.1.tar.gz
- data_services/ds-api-11.0.1.tar.gz
- track/track-ui-11.0.1.tar.gz
- Stop Web, CEP, and Domain services.
- Place and untar ds-dbapi-solr-11.0.1-tar.gz into the /opt/nastel/misc/jkool-dbapi directory.
- Unlink current.
- Update the link ‘current’ to latest db-api solr package using the command:
ln -s jkool-dbapi-solr-11.x.x current
- Go to [AUTOPILOT_HOME]/bin directory and enter the following:
./pkgman ../updates/DATA_SERVICE-11.0.1.pkg
Note: Start and stop the Domain service for each package install to update the libraries properly.
- Untar track-ui-11.0.1.tar.gz and ds-api-11.0.1.tar.gz in the [AUTOPILOT_HOME]/updates directory and move it to the [AUTOPILOT_HOME]/apache-tomcat/webapps directory.
- Delete the folders jkool-service and xray, along with their war files.
- Go to [AUTOPILOT_HOME]/apache-tomcat/config directory and make changes to server.xml file:
- Change jkool-service.war to ds-api.war. Change xray.war to track.war.
- Change jkool-service to ds-api. Change xray to track.
- Delete the cache from the Apache-tomcat temp directory: [AUTOPILOT_HOME]/apache-tomcat/temp.
- Upgrade the database. Go to /opt/nastel/misc/jkool-dbapi/current/bin and run ./jkool-db-upgrade.sh. Provide the Solr credentials.
- Recreate Kafka topics by going to /opt/nastel/AutoPilotM6/jkool/scripts and running ./create-kafka-topics.sh.
The recreate topics script requires a local Kafka installation, even if the broker is remote. If there is no local Kafka installation, then copy the script to any location on the server that is running the broker.
- Start the Domain, CEP and Web servers again.
- Log into meshIQ Track using http://<localhost>:8080/track and check the current version of the UI to make sure that it has been updated properly.