Installation

EMFTrace with Eclipse Kepler SR1, EMFStore 1.1.x, ECP 1.2.x

1. Download and install Java SE Development Kit 7 (JDK or JRE):
   • Java version 8 is not compatible with EMFTrace yet!
   • http://www.oracle.com/technetwork/java/javase/downloads/index.html
2. Download and install Eclipse Kepler Modeling Tools SR1:
   • http://www.eclipse.org/downloads/packages/eclipse-modeling-tools/keplersr1
3. Update Eclipse to latest version: (optional)
   • Help -> Check for Updates
4. Install EMFStore 1.1.x: (see hint 3)
   • Help -> Install New Software
   • Enter update site under "Work with"
     • Update site: http://download.eclipse.org/emf-store/releases_11
   • Install following features:
     • EMFStore Core Features (all)
     • EMFStore SDK
     • EMFStore Transaction Support
5. Install EMF Client Platform 1.2.x (RC):
   • Use Help -> Eclipse Marketplasce -> search for "EMF Client Platform"
   • or like before
   • Help -> Install New Software
   • Enter update site under "Work with"
     • Update site: http://download.eclipse.org/ecp/releases/releases_12
   • Install following features:
     • EMF Client Platform (all)
     • Be sure that the features "EMFStore Integration" and "SDK" are selected as well
6. Install Zest 1.5.1:
   • Update site: http://download.eclipse.org/tools/gef/updates/releases/
   • Install following features:
     • Ztest Visualisation Toolkit
     • Ztest Visualisation Toolkit SDK
7. Install MoDisco: (optional, hint 5)
   • Update site: http://download.eclipse.org/modeling/mdt/modisco/updates/release/
   • Install following features: (hint 4)
     • MoDisco Java Feature 0.11.x (not 0.9.2!)
   • Back to Eclipse Package Explorer -> right-click
   • Open Import entry -> Plug-in Development -> Plug-ins and Fragments -> next
   • For "Import From" select "The active target platform"
   • For "Import As" select "Projects with source folder" -> next
   • Add "org.eclipse.gmt.modisco.java" to your list and import the plugin
   • Select plugin in your workspace and open the "java.genmodel" under model folder
   • Rigth-click on the element in the editor and execute "Generate Model Code" and "Generate Edit Code" one after another
8. Checkout the SVN repositories:
   • Use an external SVN client (see hint 1)
   • http://svn.code.sf.net/p/emftrace/code/trunk/EMFTrace_EMFStoreECP_1.x.x/org.emftrace.ui
   • http://svn.code.sf.net/p/emftrace/code/trunk/EMFTrace_EMFStoreECP_1.x.x/org.emftrace.core
   • http://svn.code.sf.net/p/emftrace/code/trunk/EMFTrace_EMFStoreECP_1.x.x/org.emftrace.metamodel
   • http://svn.code.sf.net/p/emftrace/code/trunk/EMFTrace_EMFStoreECP_1.x.x/org.emftrace.metamodel.edit
9. Import Plug-ins
   • Eclipse -> File -> Import
   • Plug-in-Development -> Plug-ins and Fragments
   • For "Import From" select "Directory" and navigate to the plugin location from step 8
   • For "Import As" select "Projects with source folder" -> next
   • (ATTENTION! Compilation errors will disappear after step 11)
10. Generate the mode and edit code
    • Select "org.emftrace.metamodel" plugin and open the file "MetaModel.genmodel" under the model folder
    • Rigth-click on "MetaModel" in the editor
    • Execute "Generate Model Code" and "Gernate Edit Code" one after another
11. Build the plugin-projects with Eclipse
    • Code will be automatically compiled normally
    • If not: Project -> Build All
    • (Now the errors should be disappear)
12. Create a Debug/Run Configurations for EMFStore Server
    • Eclipse -> Run -> Run (or Debug) Configurations
    • Right-click on "Eclipse Application" -> New
    • Name the new element: "EMFStore Server"
    • Main-tab
      • Select "Run a Product" and enter "org.eclipse.emf.emfstore.server.server"
    • Plug-ins tab
      • For "Launch with" select "plugins selected below only"
      • Add the following plugins: (deselect all first)
        • org.emftrace.metamodel
        • org.emftrace.metamodel.edit
      • Select "Add Required Plug-ins"
      • Then "Validate Plugins-Ins" and "Apply"
13. Add Debug/Run Configurations for EMFTrace Client
    • Eclipse -> Run -> Run (or Debug) Configurations
    • Rigth-click on "Eclipse Application" -> New
    • Name the new element: "EMFTrace Client"
    • Main tab
      • Select ''Run as Product'' and enter "org.eclipse.emf.ecp.application.e3.product"
    • Plug-ins tab
      • For "Launch with" select "plug-ins selected below only"
      • Add the following plugins:
        • org.eclipse.gmt.modisco.java
        • org.eclipse.gmt.modisco.java.edit
        • org.emftrace.core
        • org.emftrace.metamodel
        • org.emftrace.metamodel.edit
        • org.emftrace.ui
    • Select "Add Required Plug-ins" and "Validate Plugins-Ins"
      • Search for "emf.ecp", be sure that these features are not selected:
        • org.eclipse.emf.ecp.ui.e4
        • org.eclipse.emf.ecp.application.e4
        • org.eclipse.emf.ecp.cdo.core
        • org.eclipse.emf.ecp.cdo.ui
    • Select "Arguments" tab
      • Add "-EMFStoreHome=${workspace_loc}" to the arguments
    • Press "Apply"
14. Run JUnit Plug-in Tests
    • Open the "org.emftrace.core" plugin -> src -> "org.emftrace.core.test"
    • Select "AllTests.java"
    • Right-click -> Run As -> JUnit Plug-in Tests
    • Make sure all tests run successfully (if not see hint 2)

---

Hints and pitfalls

1. You can also use a SVN client like Subversive to check out the repositories. But make sure the repositories are configured as Plugins-Projects within Eclipse. In some cases they will not be recognized as Plug-in Projects. We recommend to import the plug-ins like in step 9, then you can use Subversive to update the project. You do not need an external SVN plugin as well. How to check out and import with Subversive see the instructions below the hints.
2. If you get an error of "FileNotFoundExceptions" or "ClassNotFoundException" please check the class path setting "Bundle-ClassPath" in your MANIFEST.MF files and just use a dot "." here. This error is induced by automatic generation of eclipse plugin project.
3. A restart is only necessary right before step 8. This makes the installation be done faster. Except you install MoDisco in step 7, then this restart is necessary as well.
4. Use the filter function to reach the necessary features directly.
5. MoDisco is a tool to gernate a model out of your source code, but for the actual funktion of EMFTrace is not important to install it.

SVN with Subversive

1. Install the plugin from the Eclipse Marketplace
2. Create a new Java project and name it as you will
3. then Eclipse -> File -> Import -> SVN -> Project from SVN
4. (at the first use you will be asked to install a SVN connector library)
5. Enter the URL from the repostory and "check out as a folder into existing project" when prompted
6. Do the same import for the other projects as well
7. Now continue with step 9
8. After import, you can delete the checked-out projects.