OMTracker_Basic - tsgrp/OpenMigrate GitHub Wiki

What is it?

A data tracking tool (Dashboard) that demonstrates OpenMigrate's migration process via OM's Restful APIs endpoints. It's built by Angular(4) JavaScript framework and wrapped with Electron as a desktop application.

Supported Platforms

  • Application Current version: 1.1.1
  • Desktop Electron App - Windows: 10 & 7 - Both 64 and 32 bit. Mac & Linux: Coming soon.
  • Web App - Static HTML/CSS/JS (Angular).

Basic Application Architecture

  • Electron (Desktop Application Wrapper)
  • Angular 4 (Main JavaScript Application Framework)
  • Angular CLI 1.1.0 (Code Scaffolding)
  • Webpack (Module Bundler)
  • LiveReload on Development Server (Auto detect changes and reload application)
  • Karma, Jasmine and Protractor (Testing frameworks)
  • bootstrap 3 (Main CSS Framework)
  • ng2-charts (Interactive Angular charts library based on Chart.js)

Basic Folder Structure

OMTracker is part of the main core OM code. After you check out the main OM trunk code, you would be able to see a folder called "om-tracker" which contains all source codes for OMTracker.

PreBuild files SVN Revision Numbers

EXE (Zip)

  • 1.1.1 - SVN Revision #13403
  • 1.0.1 - SVN Revision #13066
  • 1.0.0 - SVN Revision #13066

WAR

  • 1.1.1 - SVN Revision #13403

Configuring your project to run with the OMTracker

core-tracker-enabled.xml

  • Edit the core-tracker-enabled.xml file inside of the <OM_HOME>/config directory
  • Make sure the MigrationTracker bean has the following properties:
    • sleepMilliseconds Set to 3000
    • trackerTerminationMethod Set to ENTER (this is what extra command the OMTracker will wait for until the migration finishes) (if you prefer to not block the migration thread, you can instead specify SLEEP)

om.sh / om.bat

  • Edit your om.sh or om.bat file inside your OpenMigrate project directory
  • Make sure the following properties are set
    • OM_TRACKER_ENABLED Set to true
    • OM_TRACKER_REMOTE_ENABLED Set to true when you're running the OMTracker remotely, false otherwise
    • OM_TRACKER_PORT Set to whatever port you'll be using to ping OM server over (only relevant when running the OMTracker remotely)

app-ctx.xml

  • Edit your app-ctx.xml file inside your project's config directory
  • Add the following line: <import resource="core-tracker-enabled.xml" />
  • Get rid of the following line (if it's there): <import resource="core-tracker-disabled.xml" />

Configuring the OMTracker to run with your project

  • Run the omtracker-.exe program
  • Open the Settings tab and modify the following properties
    • Main OM Endpoint: If using the OMTracker remotely, use the Jolokia API example and fill in your OM server/port number from your om.sh/om.bat
    • Dashboard Endpoint: If using the OMTracker remotely, use the Jolokia API example
    • Memory Usage Endpoint: If using the OMTracker remotely, use the Jolokia API example
  • Make sure you hit the check mark at the bottom right corner of the settings page
  • The application will reload and the OMTracker will attempt to connect to your OpenMigrate project
⚠️ **GitHub.com Fallback** ⚠️