Difference between revisions of "OS.bee Software Factory Installation Luna"

From OS.bee documentation
Jump to: navigation, search
(Installation)
Line 2: Line 2:
 
=== Java Version ===
 
=== Java Version ===
  
To be able to use the OS.bee Softwarefactory you need to install the right Java version.
+
To be able to use the OS.bee Software Factory you need to install the right Java version.
  
 
On Windows, this is '''Java JDK 8 64bit''' [http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html#javasejdk Java SE Downloads].
 
On Windows, this is '''Java JDK 8 64bit''' [http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html#javasejdk Java SE Downloads].
Line 11: Line 11:
 
=== Eclipse Version ===
 
=== Eclipse Version ===
  
To be able to use the OS.bee Softwarefactory you need to start with the right Eclipse version.
+
To be able to use the OS.bee Software Factory you need to start with the right Eclipse version.
 
You can use this one [http://download.osbee.org/downloads/eclipse-dsl-luna-SR2-win32-x86_64.zip Eclipse Luna DSL Developers SR2].
 
You can use this one [http://download.osbee.org/downloads/eclipse-dsl-luna-SR2-win32-x86_64.zip Eclipse Luna DSL Developers SR2].
 
Download and extract it to a place you like.
 
Download and extract it to a place you like.
Line 63: Line 63:
 
==== Installation ====
 
==== Installation ====
  
- Start the new Eclipse installation and select or define a workspace. Here too, it is important that each Eclipse installation is assigned its own workspace.
+
* Start the new Eclipse installation and select or define a workspace. Here too, it is important that each Eclipse installation is assigned its own workspace.<br>[[File:Workspace1.png]]<br>
 
+
* Go to the menu bar and select Help -> Install New Software ...<br>
  [[File:Workspace1.png]]
+
* Copy the appropriate link to the repository into '''Work with:'''<br>[[File:Setup.png]]<br>
 
+
* Select the "OS.bee Software Factory", confirm the upcoming dialogues and wait for the installation to be finished.<br>
- Go to the menu bar and select Help -> Install New Software ...
+
* confirm the "software to be installed" dialog<br>
- Copy the appropriate link to the repository into '''Work with:'''
+
* accept the terms of the license aggreement after you read them carefully and confirm the "Review licenses" dialog by pushing the "Finish" button:<br>[[File:eclipse_installation_agree_to_licenses.png]]<br>
 
+
* confirm the "Security Warning" dialog<br>[[File:install_unsigned_code_warning.png]]<br>
  [[File:Setup.png]]
+
* You will then be prompted to '''restart''' Eclipse. Please do so!<br>
 
+
- Select the "OS.bee Software Factory", confirm the upcoming dialogues and wait for the installation to be finished.
+
 
+
- confirm the "software to be installed" dialog
+
 
+
 
+
accept the terms of the license aggreement after you read them carefully and confirm the "Review licenses" dialog by pushing the "Finish" button:
+
 
+
  [[File:eclipse_installation_agree_to_licenses.png]]
+
 
+
- confirm the "Security Warning" dialog
+
 
+
  [[File:install_unsigned_code_warning.png]]
+
 
+
- You will then be prompted to '''restart''' Eclipse. Please do so!
+
  
 
=== Set Targetplatform for the OS.bee Software Factory===
 
=== Set Targetplatform for the OS.bee Software Factory===
  
- Check the workspace you are using - is it the one you want to use for the further processing? If not, open the right one.
+
* Check the workspace you are using - is it the one you want to use for the further processing? If not, open the right one.<br>  You can add the parameter <code>-data <path/to/workspace></code> to a shortcut you use to start Eclipse. This will help using the right workspace in the future. It also removes the question about the workspace on Eclipse startup. <br>
  You can add the parameter <code>-data <path/to/workspace></code> to a shortcut you use to start Eclipse. This will help using the right workspace in the future. It also removes the question about the workspace on Eclipse startup.  
+
* Then set the targetplatform here: Menu -> Window -> Preferences -> Plug-in Development -> Target Platform<br>[[File:targetplatform.png]]<br>
 
+
* Add a new Target Definition or edit the existing entry.<br>[[File:addnewtarget.png]]<br>
- Then set the targetplatform here: Menu -> Window -> Preferences -> Plug-in Development -> Target Platform
+
* Then add content, software site.<br>[[File:addcontent.png]]<br>
 
+
* Use the same link as above for the softwaresite.<br>
[[File:targetplatform.png]]
+
* Select '''OS.bee Software Factory Targetplatform (DON'T INSTALL...)'''<br>and '''uncheck''' the '''include required software''' checkbox.<br>[[File:addcontent2.png]]<br>
 
+
* Change in register '''Content''' and deactivate the following bundles in the resulting target definition.<br><br><code>javax.annotation version 1.2<br>javax.servlet    version 3.1  (may not be present)</code><br><br>[[File:addcontent3.png]]<br>
- Add a new Target Definition or edit the existing entry.
+
* '''Do not forget to activate your new created target definition! '''<br>
 
+
* Restart Eclipse<br><br>... Finish<br>
[[File:addnewtarget.png]]
+
 
+
- Then add content, software site.
+
 
+
[[File:addcontent.png]]
+
 
+
- Use the same link as above for the softwaresite.
+
- Select '''OS.bee Software Factory Targetplatform (DON'T INSTALL...)'''
+
  and '''uncheck''' the '''include required software''' checkbox.
+
 
+
  [[File:addcontent2.png]]
+
 
+
- Change in regsiter '''Content''' and deactivate the following bundles in the resulting target definition.
+
  {{{
+
  javax.annotation version 1.2
+
  javax.servlet    version 3.1  (may not be present)
+
  }}}
+
 
+
[[File:addcontent3.png]]
+
 
+
 
+
'''Do not forget to activate your new created target definition! '''
+
 
+
  ... Finish
+
 
+
- Restart Eclipse
+
  
 
HEUREKA!
 
HEUREKA!

Revision as of 14:31, 4 August 2016

General information

Java Version

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

On Windows, this is Java JDK 8 64bit Java SE Downloads.

In case you need to use several Java versions on your system, see additional information in [#InstalltheOS.Additional Information Java versions]


Eclipse Version

To be able to use the OS.bee Software Factory you need to start with the right Eclipse version. You can use this one Eclipse Luna DSL Developers SR2. Download and extract it to a place you like.

Installation of the Software Factory

Install the OS.bee Software Factory

before you start

The following change in the eclipse.ini might help to avoid timeout problems with servers that respond slowly.

-Dorg.eclipse.ecf.provider.filetransfer.retrieve.closeTimeout=3000
-Dorg.eclipse.ecf.provider.filetransfer.retrieve.readTimeout=3000

And it will help to give the Eclipse a little more memory:

-Xmx4096m


A resulting eclipse.ini for a Windows installation might look like:

-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
-Dosgi.requiredJavaVersion=1.6
-Dorg.eclipse.ecf.provider.filetransfer.retrieve.closeTimeout=3000
-Dorg.eclipse.ecf.provider.filetransfer.retrieve.readTimeout=3000
-Xms128m
-Xmx4096m

Links to the repositories

The links to the repositpries are available on the download page.

Installation

  • Start the new Eclipse installation and select or define a workspace. Here too, it is important that each Eclipse installation is assigned its own workspace.
    Workspace1.png
  • Go to the menu bar and select Help -> Install New Software ...
  • Copy the appropriate link to the repository into Work with:
    Setup.png
  • Select the "OS.bee Software Factory", confirm the upcoming dialogues and wait for the installation to be finished.
  • confirm the "software to be installed" dialog
  • accept the terms of the license aggreement after you read them carefully and confirm the "Review licenses" dialog by pushing the "Finish" button:
    Eclipse installation agree to licenses.png
  • confirm the "Security Warning" dialog
    File:Install unsigned code warning.png
  • You will then be prompted to restart Eclipse. Please do so!

Set Targetplatform for the OS.bee Software Factory

  • Check the workspace you are using - is it the one you want to use for the further processing? If not, open the right one.
    You can add the parameter -data <path/to/workspace> to a shortcut you use to start Eclipse. This will help using the right workspace in the future. It also removes the question about the workspace on Eclipse startup.
  • Then set the targetplatform here: Menu -> Window -> Preferences -> Plug-in Development -> Target Platform
    Targetplatform.png
  • Add a new Target Definition or edit the existing entry.
    Addnewtarget.png
  • Then add content, software site.
    Addcontent.png
  • Use the same link as above for the softwaresite.
  • Select OS.bee Software Factory Targetplatform (DON'T INSTALL...)
    and uncheck the include required software checkbox.
    Addcontent2.png
  • Change in register Content and deactivate the following bundles in the resulting target definition.

    javax.annotation version 1.2
    javax.servlet version 3.1 (may not be present)


    Addcontent3.png
  • Do not forget to activate your new created target definition!
  • Restart Eclipse

    ... Finish

HEUREKA!