documentation/_setup.html

<div id="midcolumn">
<h2>How to set up and run the EMF Store</h2>
<p> 
Follow the steps below to install the EMF Store. 
</p>

<b>Step 1: Get Eclipse</b>
<p>
To install the EMF Store, you need a running Eclipse. The easiest way to get started is to use <a href="http://eclipse.org/downloads/packages/eclipse-modeling-tools/indigor">the latest modeling edition.</a>
</p>

<b>Step 2: Installation using the update site</b>
<p>
In Eclipse, go to <em>"Help >> Install New Software..."</em> and add the EMF Store update site by clicking on the <em>Add...</em> button in the upper right corner. Enter an arbitrary name and get the URL from our <a href="../download.php">downloads page</a>.
	<p><img  src="images/emfstore-update-site.png" ></p>
</p>

<p>
Select all packages  under <i>EMFStore Core Features</i> for installation.
	<p><img  src="images/emfstore-required-packages.png" ></p>
</p>
<p>
Proceed in the installation wizard by repeatedly clicking <em>Next</em> until the installation starts. Midway through, you will get a warning message. Click OK to proceed.
	<p><img src="images/emfstore-security-warning.png"></p>
When the installation has finished you are required to restart Eclipse. At this point, the EMF Store is already fully installed into your Eclipse environment.
</p>


<b>Step 3: Importing the Example Model</b>
<p>
In order to see the EMF Store in action, it is necessary to have a model to work with. If you already have your own model, you can skip this step. Otherwise, you can download this<a href="exampleModel.zip"> example model </a> and add it to your workspace by importing the two model plug-ins contained in the zip file.
To do that, select the wizard "Existing Projects into Workspace" in the Import dialog and use the option "Select archive file".
</p>


<b>Step 4: Running the EMF Store</b>
<p>
Now you can start the EMF Store by running a default Eclipse Application in the debug configurations.
	<p><img src="images/emfstore-debug-config.png"></p>
</p>
<p>
In order to create an instance of the example model, which can be version with the EMF Store, you can use the EMF Client Platform (ECP). The EMF Client platform is contained in the "EMFStoreClientUI" Feature which is already installed. See Step 4 in the <a href="../../emfclient/documentation/setup.php">ECP documentation</a> to learn how to create a project and a model.
</p>

<b>Step 5: Share Project</b>
<p>When you are finished with the project, you can share it from within the Navigator view, which will check-in the project into the EMF Store repository. Right-Click on the project and select <em>Share Project</em></p>
<p><img width=700 src="images/share_project.png" alt="Share project"/></p>
<p>Now, a dialog pops-up asking to select the user session. Select the session and your project will be committed to the repository.</p> 
<p><img width=700 src="images/share_project_select_usersession_dialog.png" alt="Select Usersession"/></p>

<b>Alternative to Step 5: Share project using the EmfStore Browser</b>
<p>
Alternatively to creating a project and sharing it, you can also create new projects in the repository directly. 
</p>
<p>
In the ECP runtime instance, add a new View by navigating to <em>"Window >> Show View >> Other..."</em>, then select the view <em>EmfStore Browser</em> in the folder <em>ECP</em>.
	<p><img src="images/emfstore-repository-browser.png"></p>
</p>

<p>
You need to login in the EmfStore Browser view, using <em>"right click on localhost [Localhost Server]>> Login"</em> and then typing in the default password "super".
	<p><img src="images/emfstore-login-context-menu.png"></p>
	<p><img src="images/emfstore-login-with-super.png"></p>

</p>

<p>
Now, you can create a new project by using <em>"right click on localhost [Localhost Server]>> Create new project..."</em>.
	<p><img src="images/emfstore-browser-view.png"></p>
Finally you can checkout a new project from the server using <em>"right click >> Checkout"</em>.
	<p><img src="images/emfstore-checkout-project.png"></p>
</p>
 
</div>