Menu ▾ ▴

Installation 1.3

Andreas Kretschmer
Attachments
EMFClient1.3.jpg (92569 bytes)
EMFStore1.3.jpg (88902 bytes)
Metamodel.jpg (59672 bytes)
SVNLibrary.jpg (92863 bytes)
Subversive.jpg (71082 bytes)
TestFailer.jpg (127624 bytes)
Zest.jpg (84036 bytes)
buildfehler1.jpg (104599 bytes)
cam.png (688 bytes)
configClientMain.jpg (93178 bytes)
configClientPlugin.jpg (110006 bytes)
configStoreMain.jpg (91926 bytes)
configStorePlugin.jpg (108849 bytes)
plugin1.jpg (34927 bytes)
plugin2.jpg (51126 bytes)
plugin3.jpg (48216 bytes)

EMFTrace with Eclipse Kepler SR1, EMFStore 1.3.x, ECP 1.3.x

  1. Download and install Java SE Development Kit 7 (JDK or JRE):
  2. Download and install Eclipse Kepler Modeling Tools SR1:
  3. Update Eclipse to latest version: (optional)
    • Help -> Check for Updates
  4. Install EMFStore 1.3.x: (see hint 3)
  5. Install EMF Client Platform 1.3.x (RC):
    • Use Help -> Eclipse Marketplasce -> search for "EMF Client Platform"
    • or like before
    • Help -> Install New Software
    • Enter update site under "Work with"
    • Install following features:
      • EMF Client Platform (all)
      • Be sure that the features "EMFStore Integration" and "SDK" are selected as well
      • the e4 features will be ignored
  6. Install Zest 1.5.1:
  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:
  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 "Plug-ins and Fragments to Import" choose "Select from all plug-ins ..."
    • For "Import As" select "Projects with source folder" -> next
    • add all four plugins for import
    • (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) (if not nee hint 6)
  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" two times
      • 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.emftrace.core
        • org.emftrace.metamodel
        • org.emftrace.metamodel.edit
        • org.emftrace.ui
    • Search for "emf.ecp", be sure that all features are selected except these:
      * org.eclipse.emf.ecp.cdo.core
      * org.eclipse.emf.ecp.cdo.ui
    • Select "Add Required Plug-ins" two times and "Validate Plugins-Ins"
    • 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.
  6. After step 11 there are still errors in the UI plugin? Then the MANIFEST.MF file ist not syncron with your bundels. Change the bundle number from "2.10.0" to "2.9.0" and the error should be dissolved after saving.

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.

Related

Wiki: Home

MongoDB Logo MongoDB