OMTracker_HowToUseAsEndUser - tsgrp/OpenMigrate GitHub Wiki

Static HTML/CSS/JS File Location

All source files are located in om-tracker/src folder. And builded and minified version are located in om-tracker/dist folder. For build process, please contact TSG admin for further information.

Deployable WAR (contains the web application) File Location

omtracker.war is located in om-tracker/WAR folder. It can be deployed on any servlet/jsp container.

Executable File (exe) Location

After you check out the OM trunk code, you should be able to find a folder called - om-tracker. Inside that, it contains all the source codes and executable files for OMTracker. For end-user, please go to om-tracker/release, you would be able to find all zip files there.

For example, for version 1.0.1 (64 bit), please download the zip file in om-tracker/release/1.0.1/omtracker-1.0.1-win32-x64.zip.

After you download the zip file, please put it into the folder that you would like the application to be sit in, e.g. You can move the zip file inside the C:\Program Files. After, you can unzip the zip file by using software such as 7-Zip. When it's done, open up C:\Program Files\omtracker-1.0.1-win32-x64, you would be able to find an exe file that named omtracker-1.0.1.exe. Simply double click on it, the OMTracker application would open up immediately.

App Basics

If authentication is enabled for the application, the first section is Login. This section displays a login form for the end user to enter credentials into. The main page/section is Dashboard, it displays the current OM migration process and some others useful information via different widgets. The 2nd one is Memory Usage, it shows the migration memory usage and its history over time. The 3rd one is Database, it shows log messages in a table from database. Finally, the last section is Setting. End users can change basic setting for the app such as OM endpoints URL and refresh rate timing.

How it communicates with OM

When OMTracker is running, it keeps eyes on the local OM APIs endpoints for migration process data to come in then displays it on screen for users. The default URL is http://localhost:8778/jolokia/read. If you would like to change it, you can do it in the application by going to Setting --> OM Endpoint. Enter your OM Endpoint URL there then click on the yellow save-button to save the setting. Somehow, if you mess its setting up, you can always get back the default setting by clicking the red default-button, then click on save-button to apply the setting.

Tips

  • Please make sure to start the OM migration process before running/opening the OMTracker application.
  • If OMTracker application is not getting data while OM is running in the background, please make sure the OM Endpoint setting is correct, then reload or restart the OMTracker application.