redView

riena emf dynamic views

EMFStore Server

Info how to download and configure the EMFStore Server for your own applications and also to use the redView example projects.

Installing YOUR EmfStore is really simple.

You have to do 5 steps:

  1. Download the proper EMFStoreServer for your operating system.
  2. Install it.
  3. Create the EMFStore working directory. <EMFSTORE_HOME>
  4. Adjust the EMFStore properties.
  5. Test the EMFStore.

And you are finshed.

1. Download EMFStore Server

Please visit out SourceForge Site at https://sourceforge.net/projects/redview/files/

There your can find the proper EMFStore server which is a headless eclipse product.

Acutally we are providing the server for the following OS.

  • Win32
  • Win64
  • OSX32
  • OSX64
  • Linux GTK32
  • Linux GTK64

2. Install the EMFStore server

Choose a folder in your file system, where you would like to locate the server.

I choosed “C:\DEV\emfStore” on a win system. Further this location will be called <EMFSTORE_DIR>

Copy the downloaded .zip file into that folder and extract it. So you will have an eclipse folder directly located in your<EMFSTORE_DIR>.

That’s it and would be enough to run the emfStore server. But do not do so yet!

3. Create the <EMFSTORE_HOME> working directory

EMFStoreHome program argument:

By default the EMFStore would use <USER_HOME> as its default working directory (<EMFSTORE_HOME>), where all files to run are located.

Mostly you would like to adjust it and set your own <EMFSTORE_HOME>.

This can be done by passing the -EMFStoreHome program parameter on startup. Attention: It is not an -vmarg so ensure that this parameter is located before your -vmargs.

In my case (win) the application link looks like this:

C:\DEV\emfStore\eclipse\eclipse.exe -EMFStoreHome=C:\DEV\eCon2010\emfstore -console

The -console argument ensures, that the osgi application will show a console which allows you to superwise the EMFStore server.

Folder structure

Now you have to create the folder structure which is required to run the EMFStore proper. The easiest way to do so is to start the EMFStore server. If you have specified the EMFStoreHome argument the folder structure will be built directly in this folder.

So lets start the server by the configured application link.

These are the created files inside the emfstore folder.

4. Adjust the EMFStore properties

First, stop the EMFStore server again by closing the outline.

At least we have to configure the EMFStore server. Therefore we are using the es.properties file from https://sourceforge.net/projects/redview/files/.

es.properties:

This file is configured to run redviews EMFStore examples. It launches on port 8080 and uses the rmi backchannel implementation to update all listening project if changes become commited.

Additionally it allows you to use unicase test certificate to connect to the server.

conf folder:

The es.properties has to be located in a folder called conf inside the <EMFSTORE_HOME>. So create a folder conf and copy the es.properties inside.

And start the server again.

5. Test the EMFStore

To test the emfStore open your IDE with imported redview examples. See Example Installation.

And open one of the EMFStore example views.

If the following message appears, the EMFStore is not running proper.

For more details how to continue see Working with EMFStore.

%d bloggers like this: