View source for OS.bee Software Factory Installation Luna

== General information ==
=== Copyright Notice ===
{{Copyright Notice}}

=== License information ===

{{License information}}

== Installation of the Software Factory ==

=== Before you start ===

==== Java Version ====

To be able to use the OS.bee Software Factory, you need to have the right Java version installed.

On Windows, this is '''Java JDK 8 64bit''' [http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html#javasejdk Java SE Downloads].  If you have Java installed, there is generally a Java icon on the control panel which will enable you to find out the current version.

==== Eclipse Version ====

To be able to use the OS.bee Software Factory, you need to have the correct Eclipse version installed.
You can use [https://eclipse.org/downloads/packages/eclipse-ide-java-and-dsl-developers/lunasr2 Eclipse Luna DSL Developers SR2].
Download and extract it to a folder location of your choosing. On Windows, we recommend '''C:\'''. This results in the installation folder '''C:\eclipse'''. This will be the assumed Eclipse installation folder for the rest of this document.

To be able to launch Eclipse easily, create a shortcut to the program '''C:\eclipse\eclipse.exe''' on the computer's desktop . Be sure to add the parameter <code>-data /path/to/your/workspace</code> to the shortcut's invocation of Eclipse in order to start in the correct workspace in the future.  Otherwise, you will be prompted to specify a workspace each time you start Eclipse. <br>

Make the following additions / changes to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Dosgi.requiredJavaVersion=1.8<br>
-Xmx4096m<br>
-Dorg.eclipse.ecf.provider.filetransfer.retrieve.closeTimeout=3000<br>
-Dorg.eclipse.ecf.provider.filetransfer.retrieve.readTimeout=3000<br>
</blockquote>

The first line ensures that the required Java version is used.  The second allocates extra memory for Eclipse to use and the last two help to avoid timeout problems with servers that respond slowly.

A resulting '''eclipse.ini''' file for a Windows installation might look like this:<br>
 -startup plugins/org.eclipse.equinox.launcher_1.3.0.v20140415-2008.jar
 --launcher.library
 plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.1.200.v20150204-1316
 -product org.eclipse.epp.package.dsl.product
 --launcher.defaultAction
 openFile
 --launcher.XXMaxPermSize
 256M
 -showsplash
 org.eclipse.platform
 --launcher.XXMaxPermSize
 256m
 --launcher.defaultAction
 openFile
 --launcher.appendVmargs
 -vmargs
 -Dorg.eclipse.ecf.provider.filetransfer.retrieve.closeTimeout=3000
 -Dorg.eclipse.ecf.provider.filetransfer.retrieve.readTimeout=3000
 -Dosgi.requiredJavaVersion=1.8
 -Xms128m
 -Xmx4096m

==== OS.bee P2 Repository ====

You will need the link to the P2 repository later in the installation process.

The link to the repository is available on the [http://www.osbee.org/free-download/ download page].

On the download page, click the checkbox to accept the "Terms of Service and Use".  This will activate the download buttons for the software versions available.  You then click on the button for the version you wish to use. <br> [[File:DownloadAcceptedConditions.PNG]] <br>
 
Finally, click on "Copy link to clipboard" to copy the URL for the P2 repository to the clipboard.<br> [[File:DownloadCopytoClipboard.PNG|600px]] <br>

This URL will be needed during the installation of the OS.bee Software Factory.

=== Installation of the OS.bee Software Factory ===

# Start the new Eclipse installation and select or define a workspace. It is important that each Eclipse installation is assigned to its own workspace.<br><br>[[File:Workspace1.png|600px]]<br><br>
# Go to the menu bar and select Help -> Install New Software....<br><br>[[File:MenuHelpInstallNewSoftware.PNG|600px]]<br><br>
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], as described above, and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make Eclipse load the content of the repository.<br> <br>[[File:Install0.PNG|600px]] <br><br>
# Open the "OS.bee Software Factory" group, select the "OS.bee Software Factory" and click on '''Next'''.<br><br>[[File:Install1.PNG|600px]] <br><br>
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''.<br><br>[[File:Install2.PNG|600px]] <br><br>
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''.<br><br>[[File:eclipse_installation_agree_to_licenses.png|600px]]<br><br>
# The installation will now start. This may take a while, depending on your internet connection speed.<br><br>[[File:Install3.PNG|600px]] <br><br>
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''.<br><br>[[File:InstallUnsignedCodeWarning.png|600px]]<br><br>
# You will then be prompted to '''restart''' Eclipse. Please do so.<br><br>[[File:InstallRestart.PNG|600px]]<br><br>

=== Set the Target Platform for the OS.bee Software Factory===

# Check if the workspace you are using is the one you selected above when first opening Eclipse. If not, open the right one.<br><br>
# Set the target platform here: Menu -> Window -> Preferences -> Plug-in Development -> Target Platform.<br><br>
# Click on '''Add...''' to add a new target definition.<br><br>[[File:targetplatform.png|600px]]<br><br>
# Select "Default: ..." and click on '''Next'''.<br><br>[[File:addnewtarget.png|600px]]<br><br>
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''.<br><br>[[File:addcontent.png|600px]]<br><br>
# Use the same URL previously saved to the clipboard for the Software Site.<br><br>
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''',<br>'''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''.<br><br>[[File:addcontent2.png|600px]]<br><br>
# Change to register '''Content''', enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition:<br><br><code>javax.annotation version 1.2<br>javax.annotation.source version 1.2</code><br><br>[[File:addcontent3.png]]<br><br>
# '''Do not forget to activate your newly created target definition! '''<br><br>
# Restart Eclipse. You can use Menu -> File -> Restart to do so.<br><br>


You can now continue with [[OS.bee Software Factory Samples]]