Recent changes to Installation 1.3

Installation 1.3 modified by Andreas Kretschmer

Andreas Kretschmer — Wed, 03 Dec 2014 14:15:46 -0000

--- v3
+++ v4
@@ -111,7 +111,7 @@
 * 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.
 * Use the filter function to reach the necessary features directly.
 * 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.
-* After step 11 there are still errors in the UI plugin? [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/buildfehler1.jpg "Screenshot") Then the MANIFEST.MF file ist not syncron with your bundels. Delete the wrong dependency [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/buildfehler2.jpg "Screenshot") and add the correct one. [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/buildfehler3.jpg "Screenshot")
+* After step 11 there are still errors in the UI plugin? [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/buildfehler1.jpg "Screenshot") 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
 ------------------

Installation 1.3 modified by Andreas Kretschmer

Andreas Kretschmer — Tue, 02 Dec 2014 16:21:45 -0000

--- v2
+++ v3
@@ -10,7 +10,7 @@
     * Help -> Check for Updates
 * Install EMFStore 1.3.x:     (see hint 3)   
     * Help -> Install New Software
-    * Enter update site under "Work with" 
+    * Enter update site under "Work with" [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/EMFStore1.3.jpg "Screenshot")
         * Update site: http://download.eclipse.org/emf-store/releases_13
     * Install following features:
         * EMFStore Core Features (all)
@@ -20,12 +20,13 @@
     * Use Help -> Eclipse Marketplasce -> search for "EMF Client Platform"
     * or like before    
     * Help -> Install New Software
-    * Enter update site under "Work with" 
+    * Enter update site under "Work with" [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/EMFClient1.3.jpg "Screenshot")
         * Update site: http://download.eclipse.org/ecp/releases/releases_13 
     * Install following features:
         * EMF Client Platform (all)
         * Be sure that the features "EMFStore Integration" and "SDK" are selected as well
-* Install Zest 1.5.1: 
+        * the e4 features will be ignored [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/EMFClient1.3e4exclution.jpg "Screenshot")
+* Install Zest 1.5.1: [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/Zest.jpg "Screenshot")
     * Update site: http://download.eclipse.org/tools/gef/updates/releases/ 
     * Install following features:
         * Ztest Visualisation Toolkit
@@ -49,25 +50,27 @@
     * http://svn.code.sf.net/p/emftrace/code/trunk/EMFTrace_EMFStoreECP_1.x.x/org.emftrace.metamodel.edit
 * Import Plug-ins
     * Eclipse -> File -> Import
-    * Plug-in-Development -> Plug-ins and Fragments
+    * Plug-in-Development -> Plug-ins and Fragments [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/plugin1.jpg "Screenshot")
     * For "Import From" select "Directory" and navigate to the plugin location from step 8
-    * For "Import As" select "Projects with source folder" -> next 
+    * For "Plug-ins and Fragments to Import" choose "Select from all plug-ins ..."
+    * For "Import As" select "Projects with source folder" -> next [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/plugin2.jpg "Screenshot")
+    * add all four plugins for import [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/plugin3.jpg "Screenshot")
     * (ATTENTION! Compilation errors will disappear after step 11)
 * 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 
+    * Execute "Generate Model Code" and "Gernate Edit Code" one after another [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/Metamodel.jpg "Screenshot")
 * Build the plugin-projects with Eclipse
     * Code will be automatically compiled normally
     * If not: Project -> Build All
-    * (Now the errors should be disappear)
+    * (Now the errors should be disappear) (if not nee hint 6)
 * 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 
+    * Main-tab [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/configStoreMain.jpg "Screenshot")
         * Select "Run a Product" and enter "org.eclipse.emf.emfstore.server.server"
-    * Plug-ins tab 
+    * Plug-ins tab [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/configStorePlugin.jpg "Screenshot")
         * For "Launch with" select "plugins selected below only" 
         * Add the following plugins:    (deselect all first)
             * org.emftrace.metamodel
@@ -78,19 +81,19 @@
     * Eclipse -> Run -> Run (or Debug) Configurations
     * Rigth-click on "Eclipse Application" -> New
     * Name the new element: "EMFTrace Client"
-    * Main tab 
+    * Main tab [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/configClientMain.jpg "Screenshot")
         * Select ''Run as Product'' and enter "org.eclipse.emf.ecp.application.e3.product"
-    * Plug-ins tab 
+    * Plug-ins tab [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/configClientPlugin.jpg "Screenshot")
         * 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
-    * Select "Add Required Plug-ins" two times and "Validate Plugins-Ins" 
-        * Search for "emf.ecp", be sure that all features are selected except these:            
+    * 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"
@@ -104,17 +107,18 @@
 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.
-* 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.
+* 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. [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/TestFailer.jpg "Screenshot") This error is induced by automatic generation of eclipse plugin project.
 * 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.
 * Use the filter function to reach the necessary features directly.
 * 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.
+* After step 11 there are still errors in the UI plugin? [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/buildfehler1.jpg "Screenshot") Then the MANIFEST.MF file ist not syncron with your bundels. Delete the wrong dependency [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/buildfehler2.jpg "Screenshot") and add the correct one. [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/buildfehler3.jpg "Screenshot")

 SVN with Subversive
 ------------------
-1. Install the plugin from the Eclipse Marketplace
+1. Install the plugin from the Eclipse Marketplace [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/Subversive.jpg "Screenshot")
 * Create a new Java project and name it as you will
 * then Eclipse -> File -> Import -> SVN -> Project from SVN 
-* (at the first use you will be asked to install a SVN connector library)
+* (at the first use you will be asked to install a SVN connector library) [[[img src=cam.png]]](https://sourceforge.net/p/emftrace/wiki/Installation%201.3/attachment/SVNLibrary.jpg "Screenshot")
 * Enter the URL from the repostory and "check out as a folder into existing project" when prompted  
 * Do the same import for the other projects as well
 * Now continue with step 9

Installation 1.3 modified by Andreas Kretschmer

Andreas Kretschmer — Wed, 26 Nov 2014 21:52:25 -0000

--- v1
+++ v2
@@ -16,7 +16,7 @@
         * EMFStore Core Features (all)
         * EMFStore SDK
         * EMFStore Transaction Support
-* Install EMF Client Platform 1.2.x (RC):
+* Install EMF Client Platform 1.3.x (RC):
     * Use Help -> Eclipse Marketplasce -> search for "EMF Client Platform"
     * or like before    
     * Help -> Install New Software

Installation 1.3 modified by Andreas Kretschmer

Andreas Kretschmer — Wed, 26 Nov 2014 20:50:05 -0000

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

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
Download and install Eclipse Kepler Modeling Tools SR1:
- http://www.eclipse.org/downloads/packages/eclipse-modeling-tools/keplersr1
Update Eclipse to latest version: (optional)
- Help -> Check for Updates
Install EMFStore 1.3.x: (see hint 3)
- Help -> Install New Software
- Enter update site under "Work with"
  - Update site: http://download.eclipse.org/emf-store/releases_13
- Install following features:
  - EMFStore Core Features (all)
  - EMFStore SDK
  - EMFStore Transaction Support
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_13
- Install following features:
  - EMF Client Platform (all)
  - Be sure that the features "EMFStore Integration" and "SDK" are selected as well
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
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
Checkout the SVN repositories:
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)
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
Build the plugin-projects with Eclipse
- Code will be automatically compiled normally
- If not: Project -> Build All
- (Now the errors should be disappear)
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"
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
- Select "Add Required Plug-ins" two times and "Validate Plugins-Ins"
  - 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 "Arguments" tab
  - Add "-EMFStoreHome=${workspace_loc}" to the arguments
- Press "Apply"
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

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.
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.
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.
Use the filter function to reach the necessary features directly.
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

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