PlatformService and UI Migration / Installation

With Insights v10.0, we are moving away from using Apache Tomcat to serve the application. Going forward, PlatformService will use embedded tomcat and run as a JAR application and UI will be run as Node.js application using ExpressJS. Follow the below steps to Migrate to Insights v10.0.

For fresh installation skip STEP 1 and start from STEP 2.

STEP 1:

Disabling Apache Tomcat:

RHEL/CentOS/Amazon Linux:

cd /etc/init.d/
service [Tomcat servicename] stop
rm [Tomcat servicename]

Windows

Stop the Apache Tomcat Service
sc delete [Tomcat servicename]

Ubuntu

systemctl stop [Tomcat servicename]
systemctl disable [Tomcat servicename]

STEP 2:

Installing & Running PlatformService & UI:

UI will now be accessible on port 8081. Follow the below steps to run the PlatformService and UI:

RHEL 8:

Download and run the insights_UI_Service.sh file from GitHub repository [insights_UI_Service.sh]

RHEL 7:

Download and run the insights_UI_Service.sh file from GitHub repository [insights_UI_Service.sh]

UBUNTU:

Download and run the insights_UI_Service.sh file from GitHub repository [insights_UI_Service.sh]

WINDOWS:

PlatformService:

Inside Insights_Windows/Server2 folder create a new folder named PlatformService.
Download the PlatformService.jar file from the GitHub repository [PlatformService-10.0.jar]
Rename PlatformService-[VERSION].jar to PlatformService.jar.
Open a command prompt from this folder and run “java -jar PlatformService.jar”.

UI:

Visit Nodejs.org/en/download and download and install node.js [14.20.x or 16.13.x or 18.10.x]
Download and extract the contents of PlatformUI4-[VERSION].zip.
Copy the UI folder into the Insights_Windows/Server2/Configs/ folder.
Open a command prompt from the UI folder and run “npm install”.
Download the InsightsUISetup.bat file from the GitHub repository [InsightsUISetup.bat]
Run the “InsightsUISetup.bat” file to setup UI as a windows service.
Start the InsightsUI service.

Starting / Restarting / Stopping PlatformService:

RHEL 8:

service Insights_Service { start | restart | stop }

RHEL 7:

service Insights_Service { start | restart | stop }

Starting / Restarting / Stopping UI:

RHEL 8:

service Insights_UI  { start | restart | stop }

RHEL 7:

service Insights_UI { start | restart | stop }